Szczegóły techniczne dla osoby, która będzie odbierać wdrożenie.
Połączenie z Allegro
Integracja używa oficjalnego Allegro REST API i autoryzacji OAuth 2.0: właściciel konta Allegro raz zatwierdza dostęp, a integracja odświeża token sama. Każde konto Allegro autoryzuje się osobno, dlatego kilka kont może działać z jednym sklepem. Testy idą na środowisku testowym Allegro (sandbox), które ma te same limity co produkcja. Główny limit to 9000 zapytań na minutę na Client ID, a niektóre zasoby mają niższe limity. Przy przekroczeniu Allegro wydłuża odpowiedzi albo zwraca 429 Too Many Requests, więc wszystkie operacje idą przez kolejkę z limitem tempa.
Oferty i katalog produktów
Integracja szuka produktu z Shopify w katalogu Allegro po EAN (GET /sale/products). Oferta powstaje przez POST /sale/product-offers z odwołaniem do produktu z katalogu, ceną, stanem, cennikiem dostawy, warunkami zwrotów i reklamacji. Wymagane parametry kategorii przychodzą z GET /sale/categories/{categoryId}/parameters, a wartości z pól i metapól produktu w Shopify. Każdy wariant w Shopify to osobna oferta na Allegro, a warianty łączymy w grupę wariantów, jeśli kategoria na to pozwala.
Zmiany stanu (inventory_levels/update) i ceny (products/update) z Shopify trafiają do ofert, przy wielu ofertach naraz przez komendy grupowe zmiany ilości i ceny. Stan wysyłany na Allegro może być pomniejszony o bufor bezpieczeństwa albo liczony tylko z wybranych lokalizacji Shopify.
Zamówienia z Allegro w Shopify
Nowe zamówienia są odczytywane z dziennika zdarzeń GET /order/events, zaczynając od ostatniego przetworzonego zdarzenia. Allegro trzyma tam zdarzenia z ostatnich 60 dni, a dokumentacja zaleca dziennik zamiast listy zamówień, bo lista jest sortowana po dacie zakupu, nie po dacie płatności. Zamówienie trafia do Shopify po zdarzeniu READY_FOR_PROCESSING, czyli po opłaceniu (lub wybraniu płatności przy odbiorze). Pełne dane przychodzą z GET /order/checkout-forms/{id}, a zamówienie w Shopify powstaje przez Admin API, z tagiem kanału, identyfikatorem zamówienia Allegro w metapolu i bez powiadomień dla kupującego. Anulowanie (BUYER_CANCELLED, AUTO_CANCELLED) anuluje zamówienie w Shopify i przywraca stan.
Wysyłka i faktury
Realizacja zamówienia w Shopify wysyła do Allegro numer przesyłki i przewoźnika (POST /order/checkout-forms/{id}/shipments) i ustawia status wysłane (PUT /order/checkout-forms/{id}/fulfillment). Przy Wysyłam z Allegro przesyłka i etykieta powstają przez zasoby /shipment-management. Faktura w PDF trafia do zamówienia przez POST /order/checkout-forms/{id}/invoices i przesłanie pliku (do 3 MB, najwyżej 10 faktur na zamówienie). Osobno ustawiamy zestawy, zamówienia z kilkoma przesyłkami, zwroty i dopłaty. Każda operacja jest zapisana w logu.