Używanie Zonos z Japan Post My Page API

Ten przewodnik jest przeznaczony dla zespołów, które już integrują się z Japan Post My Page Web API w celu tworzenia etykiet (operacja ctCode=52). W przypadku przesyłek do USA, które teraz wymagają przedpłaty cła, etykieta jest tworzona za pośrednictwem Zonos. Zonos jest rozszerzeniem przepływu pracy My Page: wywołuje interfejs API etykiet My Page (ctCode=52) w Twoim imieniu, dodaje identyfikator deklaracji cła USA i oznaczenie DDP, a następnie zwraca etykietę My Page i numer śledzenia. Japan Post nadal produkuje etykietę i rozlicza Twoją opłatę pocztową za pośrednictwem Twojego numeru Later Pay Number.

Krótko mówiąc: kontynuujesz budowanie na My Page, a Zonos obsługuje warstwę cła dla USA dla przesyłek przeznaczonych do Stanów Zjednoczonych.

Jeśli integrujesz się po raz pierwszy, zacznij od Tworzenia pojedynczej przesyłki.

Jak Zonos się wpisuje 

W przypadku przesyłki do USA wysyłasz przesyłkę do przepływu pracy Zonos CreateDeclarationShipment GraphQL zamiast wywoływać My Page bezpośrednio. W tym pojedynczym żądaniu Zonos:

1. Wywołuje interfejs API etykiet Japan Post (ctCode=52) w Twoim imieniu, używając numerów Later Pay Numbers Twojego Zweryfikowanego Konta, aby opłata pocztowa była nadal rozliczana na Twoim koncie Japan Post.
2. Tworzy identyfikator deklaracji cła USA i łączy go z numerem śledzenia.
3. Dodaje oznaczenie DDP do etykiety.
4. Zwraca etykietę Japan Post i numer śledzenia.

CreateDeclarationShipment obejmuje siedem kroków połączonych w łańcuch. Te same dane, które już zebrałeś dla żądania ctCode=52, są rozdzielone między nie:

• Nadawca/odbiorca → strony ORIGIN i DESTINATION przepływu pracy partyCreateWorkflow.
• Przedmioty → itemCreateWorkflow (pozycje wierszy wewnątrz shipmentCartons).
• Opakowanie i waga → cartonsCreateWorkflow.
• Usługa, obsługa i flagi celne → shipmentCreateWorkflow.

Jak Twoje pola My Page mapują się na Zonos 

Każda tabela pokazuje, gdzie parametr Japan Post My Page ctCode=52 trafia do przepływu pracy Zonos. Aby uzyskać pełne szczegóły pola, typy i które pola są wymagane, zobacz Tworzenie pojedynczej przesyłki.

Usługa i obsługa → shipmentCreateWorkflow

Nadawca → partyCreateWorkflow (strona ORIGIN)

Odbiorcy → partyCreateWorkflow (strona DESTINATION)

Parametry odbiorcy to_* mapują się do strony DESTINATION w taki sam sposób jak pola nadawcy.

Przedmioty → itemCreateWorkflow

Konwersje do poznania 

Oto transformacje, które najczęściej wymagają uwagi:

• Poziom usługi zastępuje sendType + transType. Wybierz pojedynczy poziom usługi Zonos japan_post.*, który odpowiada usłudze pocztowej i transportowi, które wysyłasz dziś jako dwa oddzielne parametry.
• Wartość ubezpieczona (declaredValue) musi być JPY, całe jen. Inne waluty lub ułamkowe jen zostaną odrzucone.
• Waga jest wysyłana do Japan Post w gramach. Podaj weight + weightUnit na kartonie; Zonos konwertuje.
• Opisy niestandardowe przedmiotu są ograniczone do 85 znaków pół-szerokości.
• Wszystkie pola adresu muszą być w znakach angielskich (Romans).

Weryfikuj swoje etykiety dla USA 

Gdy tworzysz etykietę dla USA za pośrednictwem Zonos, potwierdź, że działa end-to-end:

1. Przepływ pracy zwraca numer śledzenia i etykietę. Sprawdź shipmentCreateWorkflow.trackingDetails.number i shipmentCartons[].label.url w odpowiedzi.
2. Identyfikator deklaracji został utworzony i powiązany. Cło przesyłki jest przedpłacone tylko wtedy, gdy identyfikator deklaracji jest powiązany z numerem śledzenia — Zonos robi to wewnątrz tego samego żądania.
3. DDP jest drukowane na etykiecie. Otwórz zwróconą etykietę i potwierdź, że oznaczenie DDP jest obecne.
4. Przesyłka pojawia się na Twoim pulpicie nawigacyjnym Zonos w ramach Twojego Zweryfikowanego Konta.
5. W przypadku wysyłki wsadowej potwierdź, że konsolidacja zamyka się i zwraca kwit nadania Japan Post (Kod 61). Zobacz Wysyłka wsadowa (konsolidacja).
6. Porównaj z etykietą My Page. Utwórz tę samą przesyłkę na oba sposoby i potwierdź, że poziom usługi, waga, zadeklarowana wartość i szczegóły przedmiotu odpowiadają drukowanej etykiecie.

Powiązane 

• Tworzenie pojedynczej przesyłki — pełne odniesienie pola dla przepływu pracy CreateDeclarationShipment.
• Wysyłka wsadowa (konsolidacja) — połącz przesyłki dnia w jeden kwit nadania Japan Post.