DOCS

Catalog API

Buduj katalog zweryfikowanego konta programowo, bezpośrednio z własnego systemu.

Catalog API to jeden z trzech sposobów budowania katalogu zweryfikowanego konta i jest to opcja dla nadawców, którzy dysponują zasobami programistycznymi oraz systemem przechowującym już dane ich produktów—ERP, WMS, PIM lub platformą do wysyłek. Ten system pozostaje źródłem prawdy i zapisuje produkty bezpośrednio w Zonos, zamiast synchronizować je z integracji z kanałem sprzedaży lub przesyłać plik CSV. Jeśli sprzedajesz przez obsługiwany kanał lub wolisz nie pisać kodu, te dwie opcje pozwalają zbudować ten sam katalog mniejszym nakładem pracy.

Pozycje utworzone przez API są traktowane dokładnie tak samo jak pozycje z każdego innego źródła—gdy pozycja trafi do katalogu, dla Zonos nie ma znaczenia, w jaki sposób się tam znalazła. Każda z nich jest klasyfikowana na potrzeby celne, jeśli nie podano kodu HS, sprawdzana pod kątem wymogów amerykańskich agencji rządowych (Partner Government Agency, PGA) i wykorzystywana do obliczania ceł i podatków od przesyłek, w których się pojawia.

Jeden element tego procesu pozostaje poza API. Gdy kontrola PGA oznaczy pozycję jako Needs attention, kwestionariusz zgodności powiązany z tym oznaczeniem trzeba wypełnić i potwierdzić w Dashboard—nie ma do tego API, a Zonos wstępnie uzupełnia wszystko, co może, więc większość pracy polega na przejrzeniu i potwierdzeniu odpowiedzi. Osoba budująca tę integrację zwykle nie jest tą samą osobą, która obsługuje te oznaczenia, dlatego zaplanuj, że ktoś w Twojej organizacji zajmie się nimi w Dashboard po załadowaniu katalogu. Oznaczone pozycje nie są blokowane przed wysyłką, ale ich wyjaśnienie przed nadaniem przesyłki zapobiega jej zatrzymaniu na granicy USA.

Jak to działa 

  1. Utwórz pozycję katalogu dla każdego wysyłanego produktu.

  2. Upewnij się, że każda pozycja zawiera identyfikator, który Twój przewoźnik pocztowy przekaże dalej.

  3. Gdy dane Twojej przesyłki trafią do Zonos, każda linia zostaje dopasowana do odpowiedniej pozycji katalogu, a dane produktu z tej pozycji są uwzględniane w obliczeniach.

GraphQL API ReferenceTypes, inputs, and operations used in this guide

Czy ta strona była pomocna?