Jak działa model API Zonos + Japan Post
Handlowcy z Zweryfikowanymi Kontami Japan Post bezpośrednio wołają Zonos. Zonos korzysta ze swoich własnych poświadczeń w Japan Post i umieszcza Twój numer Later Pay na każdej etykiecie, tak aby porto było naliczane na Twoje konto.
W pojedynczym żądaniu GraphQL Zonos:
- Weryfikuje Twoje Zweryfikowane Konto i numery Later Pay.
- Wołuje API Etykiet Japan Post (kod 52) w Twoim imieniu, aby wygenerować etykietę i numer śledzenia.
- Tworzy identyfikator oświadczenia do wstępnej opłaty cła do USA.
- Łączy identyfikator oświadczenia z numerem śledzenia za pośrednictwem
declarationShipmentCreate. - Zwraca etykietę, numer śledzenia i rekord wysyłki z powrotem do Ciebie.
Nie potrzebujesz własnych poświadczeń interfejsu API Japan Post (CTID / hasło CT). Potrzebujesz numerów Later Pay Numbers Japan Post (後納お客様番号) podłączonych do Twojego Zweryfikowanego Konta Zonos.
Jaka jest Twoja konfiguracja?
Wszyscy wołają Zonos, aby tworzyć zarówno etykietę, jak i manifest, więc nigdy nie podajesz swoich własnych poświadczeń Japan Post (CTID / hasło CT). To, co się zmienia w zależności od konfiguracji, to które nagłówki interfejsu API Zonos przesyłasz — znajdź swój wiersz poniżej, a następnie użyj pasującej karty w sekcji Endpoint i uwierzytelnianie każdego przepływu.
| ↕ | Handlowiec e-commerce↕ | Platforma wysyłkowa (BYOA)↕ | 3PL / Partner Logistyczny / Sprzedawca↕ |
|---|---|---|---|
| Kim jesteś | Marka wysyłająca własne zamówienia | Platforma, poprzez którą wielu handlowców tworzy etykiety | Partner wysyłający w imieniu wielu klientów będących handlowcami |
| Zweryfikowane Konto, które konfigurujesz | Jedno Zweryfikowane Konto (własne) | Każdy handlowiec konfiguruje swoje; wysyłasz w ich imieniu | Jedno Zweryfikowane Konto używane dla wszystkich Twoich wysyłających |
| Nagłówki interfejsu API Zonos do przesłania | credentialToken (Twój) tylko | credentialToken (Twój) + accountKey (każdego handlowca) | credentialToken (Twój) tylko |
| Czyjego numeru Later Pay naliczane jest porto | Twoje | Każdego handlowca | Twoje |
| Komu Zonos fakturuje cła | Tobie | Każdemu handlowcowi | Tobie |
BYOA (Bring Your Own Account): każdy handlowiec posiada własne Zweryfikowane Konto Japan Post, a platforma tworzy etykiety w imieniu handlowca, przesyłając klucz konta handlowca, zamiast wysyłania na mocy własnego konta platformy.
Dwa przepływy interfejsu API
Istnieją dwa wzorce integracji w zależności od sposobu, w jaki wysyłasz paczki.
Tworzenie pojedynczej wysyłki
Łańcuch fundamentalny. Jedno żądanie GraphQL przenosi wysyłkę od surowych danych wejściowych (strony, przedmioty, opakowanie) aż do drukowanej etykiety Japan Post. Użyj tego, jeśli wysyłasz paczki indywidualnie, gdy pojawiają się zamówienia.
Tworzenie pojedynczej wysyłki →
Wysyłka zbiorcza (konsolidacja)
Przepływ wsadowy z opóźnionym płatności. Otwórz konsolidację rano, dołączaj wysyłki do niej przez cały dzień, korzystając z łańcucha pojedynczej wysyłki, a następnie zamknij konsolidację pod koniec dnia, aby otrzymać jeden poślizg wysyłki Japan Post obejmujący całą partię. Użyj tego, jeśli rozliczasz porto Japan Post w jednej transakcji pod koniec dnia, a nie parcel-by-parcel.
Już używasz interfejsu API Japan Post My Page?
Jeśli aktualnie tworzysz etykiety za pomocą interfejsu API My Page Japan Post (ctCode=52), możesz zachować tę integrację i dodać Zonos dla etykiet US ze wstępnie opłaconymi cłami. Przejdź do Używanie Zonos z interfejsem API My Page, aby uzyskać mapowanie pole-po-pole i listę kontrolną weryfikacji.
Tworzenie etykiet za pośrednictwem API
Zintegruj swój system spełniania zamówień z interfejsem API GraphQL Zonos, aby tworzyć etykiety Japan Post ze wstępnie opłaconymi cłami.
Ta sekcja jest przeznaczona dla zespołów inżynieryjnych, które budują programowy przepływ pracy tworzenia etykiet Japan Post, który będzie korzystać z Zweryfikowanych Kont. Jeśli jesteś małą lub średnią firmą zajmującą się wysyłką bez zasobów programistycznych, zobacz Tworzenie etykiet w Panelu Sterowania zamiast tego.