Szczegóły techniczne dla osoby, która będzie odbierać wdrożenie.
Co robi standardowa integracja Base
Sklep Shopify łączy się z Base w dziale „Sklepy internetowe”. Integracja pobiera zamówienia z ustawioną częstotliwością, mapuje statusy Base na statusy Shopify (np. przejście do wybranego statusu oznacza zamówienie jako zrealizowane), przekazuje numery przesyłek i status płatności oraz importuje zwroty. Stany i ceny synchronizuje w wybranym kierunku (Base albo Shopify jako źródło) co 5 minut do 24 godzin, z opcją sumowania stanów z kilku magazynów Base. Produkty można importować z Shopify do katalogu Base i wystawiać z magazynu Base do Shopify, łącznie z metapolami produktów. Dodatek nie powiela żadnej z tych funkcji.
Jak działa dodatek
Po stronie Shopify dodatek jest aplikacją niestandardową z webhookami orders/create i orders/updated. Z zamówienia czyta to, czego standardowa integracja nie przenosi: atrybuty koszyka (note_attributes), metapola zamówienia, dane firmy i lokalizacji z Shopify B2B oraz tagi. Następnie czeka, aż Base pobierze zamówienie, i odnajduje je w Base API po numerze zamówienia ze sklepu (getOrders). Jeśli zamówienia jeszcze nie ma, zadanie wraca do kolejki z opóźnieniem.
Dane do faktury (invoice_company, invoice_nip, want_invoice) i pola dodatkowe zamówienia zapisuje przez setOrderFields, a identyfikatory pól dodatkowych odczytuje z getOrderExtraFields. Status ustawia setOrderStatus według reguł, które razem spisujemy. NIP jest sprawdzany sumą kontrolną, a opcjonalnie w Białej liście VAT.
Co wraca do Shopify
Zmiany po stronie Base dodatek odczytuje z dziennika zdarzeń (getJournalList): zmianę statusu, wystawienie faktury, utworzenie zwrotu. Numer faktury lub status zwrotu zapisuje w metapolu albo tagu zamówienia w Shopify, więc obsługa klienta widzi go bez logowania do Base. Te same zdarzenia mogą trafiać do CRM lub programu księgowego.
Limity i przypadki brzegowe
Base API przyjmuje do 100 zapytań na minutę na token, wspólnie dla wszystkich narzędzi, które go używają. Dodatek ma własny token i kolejkę z limitem tempa, żeby nie zabierać zapytań innym integracjom. Osobno obsługuję zamówienia edytowane po złożeniu, zamówienia anulowane przed pobraniem do Base, kilka sklepów Shopify w jednym koncie Base i zamówienia bez NIP-u, które według reguł powinny go mieć. Każda operacja jest zapisana w logu.