Integre su sistema de cumplimiento con la API GraphQL de Zonos para crear etiquetas de Japan Post con aranceles prepagados.
Esta sección es para equipos de ingeniería que construyen un flujo de etiquetas de Japan Post programático que utilizará Verified Accounts. Si es un remitente pequeño o mediano sin recursos de desarrollo, consulte Crear etiquetas en Dashboard en su lugar.
Los comerciantes con Japan Post Verified Account llaman directamente a Zonos. Zonos usa sus propias credenciales con Japan Post e incluye su Later Pay Number en cada etiqueta para que el franqueo se facture a su cuenta.
En una sola solicitud GraphQL, Zonos:
Valida su Verified Account y sus Later Pay Numbers.
Llama a la Japan Post Label API (código 52) en su nombre para generar la etiqueta y el número de seguimiento.
Crea un Declaration ID para el prepago de aranceles de EE. UU.
Vincula el Declaration ID al número de seguimiento mediante declarationShipmentCreate.
Le devuelve la etiqueta, el número de seguimiento y el registro del envío.
No necesita sus propias credenciales de API de Japan Post (CTID / contraseña CT). Sí necesita sus Later Pay Numbers de Japan Post (後納お客様番号) conectados a su Zonos Verified Account.
Todos llaman a Zonos para crear tanto la etiqueta como el manifiesto, por lo que nunca proporciona sus propias credenciales de Japan Post (CTID / contraseña CT). Lo que cambia según la configuración son los encabezados de API de Zonos que envía; encuentre su fila a continuación y luego use la pestaña correspondiente en la sección Endpoint y autenticación de cada flujo.
↕
Comerciante de comercio electrónico↕
Plataforma de envío (BYOA)↕
3PL / socio logístico / revendedor↕
Quién es usted
Una marca que envía sus propios pedidos
Una plataforma por la que muchos comerciantes crean etiquetas
Un socio que envía en nombre de muchos clientes comerciantes
Verified Account que configura
Una Verified Account (la suya)
Cada comerciante configura la suya; usted envía en su nombre
Una Verified Account usada para todos sus remitentes
Encabezados de API de Zonos a enviar
Solo credentialToken (el suyo)
credentialToken (el suyo) + accountKey (de cada comerciante)
Solo credentialToken (el suyo)
A quién se factura el franqueo
El suyo
El de cada comerciante
El suyo
A quién Zonos factura los aranceles
A usted
A cada comerciante
A usted
BYOA (Bring Your Own Account): cada comerciante tiene su propia Japan Post Verified Account, y la plataforma crea etiquetas en nombre de ese comerciante pasando la clave de cuenta del comerciante, en lugar de enviar bajo la cuenta propia de la plataforma.
Hay dos patrones de integración según cómo despache los paquetes.
Crear un envío individual
La cadena fundamental. Una solicitud GraphQL lleva un envío desde los datos de entrada (partes, artículos, embalaje) hasta una etiqueta imprimible de Japan Post. Úselo si envía paquetes individualmente a medida que llegan los pedidos.
El flujo de lote con pago diferido. Abra una consolidación por la mañana, adjunte envíos a lo largo del día usando la cadena de envío individual y luego cierre la consolidación al final del día para obtener un comprobante de despacho de Japan Post que cubra todo el lote. Úselo si liquida el franqueo de Japan Post en una sola transacción al final del día en lugar de paquete por paquete.
Si actualmente crea etiquetas con la Japan Post My Page API (ctCode=52), puede mantener esa integración y agregar Zonos para etiquetas de EE. UU. con aranceles prepagados. Consulte Uso de Zonos con la My Page API para un mapeo campo por campo y una lista de verificación.
Crear etiquetas mediante API
Crear etiquetas mediante API
Integre su sistema de cumplimiento con la API GraphQL de Zonos para crear etiquetas de Japan Post con aranceles prepagados.
Esta sección es para equipos de ingeniería que construyen un flujo de etiquetas de Japan Post programático que utilizará Verified Accounts. Si es un remitente pequeño o mediano sin recursos de desarrollo, consulte Crear etiquetas en Dashboard en su lugar.
Cómo funciona el modelo de API de Zonos + Japan Post
Los comerciantes con Japan Post Verified Account llaman directamente a Zonos. Zonos usa sus propias credenciales con Japan Post e incluye su Later Pay Number en cada etiqueta para que el franqueo se facture a su cuenta.
En una sola solicitud GraphQL, Zonos:
declarationShipmentCreate.No necesita sus propias credenciales de API de Japan Post (CTID / contraseña CT). Sí necesita sus Later Pay Numbers de Japan Post (後納お客様番号) conectados a su Zonos Verified Account.
¿Cuál es su configuración?
Todos llaman a Zonos para crear tanto la etiqueta como el manifiesto, por lo que nunca proporciona sus propias credenciales de Japan Post (CTID / contraseña CT). Lo que cambia según la configuración son los encabezados de API de Zonos que envía; encuentre su fila a continuación y luego use la pestaña correspondiente en la sección Endpoint y autenticación de cada flujo.
credentialToken(el suyo)credentialToken(el suyo) +accountKey(de cada comerciante)credentialToken(el suyo)BYOA (Bring Your Own Account): cada comerciante tiene su propia Japan Post Verified Account, y la plataforma crea etiquetas en nombre de ese comerciante pasando la clave de cuenta del comerciante, en lugar de enviar bajo la cuenta propia de la plataforma.
Dos flujos de API
Hay dos patrones de integración según cómo despache los paquetes.
Crear un envío individual
La cadena fundamental. Una solicitud GraphQL lleva un envío desde los datos de entrada (partes, artículos, embalaje) hasta una etiqueta imprimible de Japan Post. Úselo si envía paquetes individualmente a medida que llegan los pedidos.
Crear un envío individual →
Despacho por lotes (consolidación)
El flujo de lote con pago diferido. Abra una consolidación por la mañana, adjunte envíos a lo largo del día usando la cadena de envío individual y luego cierre la consolidación al final del día para obtener un comprobante de despacho de Japan Post que cubra todo el lote. Úselo si liquida el franqueo de Japan Post en una sola transacción al final del día en lugar de paquete por paquete.
Despacho por lotes (consolidación) →
¿Ya usa la Japan Post My Page API?
Si actualmente crea etiquetas con la Japan Post My Page API (
ctCode=52), puede mantener esa integración y agregar Zonos para etiquetas de EE. UU. con aranceles prepagados. Consulte Uso de Zonos con la My Page API para un mapeo campo por campo y una lista de verificación.¿Fue útil esta página?