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:
- 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.
¿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 and authentication 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.
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.
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.
¿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.
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.