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 Dashboard zamiast tego.
Handlowcy z Zweryfikowanymi Kontami Japan Post bezpośrednio wywołują 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.
Wywoł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 Japan Post (後納お客様番号) podłączonych do Twojego Zweryfikowanego Konta Zonos.
Wszyscy wywołują 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
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łki na własnym koncie platformy.
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.
Przepływ wsadowy z opóźnioną 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 dokument nadania Japan Post obejmujący całą partię. Użyj tego, jeśli rozliczasz porto Japan Post w jednej transakcji pod koniec dnia, a nie paczka po paczce.
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
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 Dashboard zamiast tego.
Jak działa model API Zonos + Japan Post
Handlowcy z Zweryfikowanymi Kontami Japan Post bezpośrednio wywołują 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:
declarationShipmentCreate.Nie potrzebujesz własnych poświadczeń interfejsu API Japan Post (CTID / hasło CT). Potrzebujesz numerów Later Pay Japan Post (後納お客様番号) podłączonych do Twojego Zweryfikowanego Konta Zonos.
Jaka jest Twoja konfiguracja?
Wszyscy wywołują 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.
credentialToken(Twój) tylkocredentialToken(Twój) +accountKey(każdego handlowca)credentialToken(Twój) tylkoBYOA (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łki na własnym koncie 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óźnioną 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 dokument nadania Japan Post obejmujący całą partię. Użyj tego, jeśli rozliczasz porto Japan Post w jednej transakcji pod koniec dnia, a nie paczka po paczce.
Wysyłka zbiorcza (konsolidacja) →
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.Czy ta strona była pomocna?