Regístrese para una Verified Account de Zonos usando el
enlace de registro de Česká pošta.
Complete la dirección comercial y la configuración de facturación.
Inicie sesión en su Zonos Dashboard y vaya a Account →
Integrations. La tabla muestra dos claves:
Nombre en Dashboard↕
Propósito↕
¿Usar para la API?↕
Account key
Identificador para vincular con el operador postal
❌ NO
API key
Clave de autenticación para llamar a la API de Zonos
✅ SÍ — use esta clave
Copie el token en la fila API key. Comienza con credential_live_. Necesitará esta
clave para ambos métodos de integración.
Mantenga su clave de API segura. No la incluya en el control de versiones ni la comparta públicamente. Si
cree que se ha visto comprometida, regenérela desde la misma página Account → Integrations.
La herramienta Item Quoter en su
Zonos Dashboard le permite consultar costos estimados de aranceles para sus productos antes de enviar, útil
para comprobar tasas y planificar con antelación sin generar un Declaration ID.
Elija el método que se adapte a su configuración técnica. Ambos métodos producen Declaration IDs que luego
carga en el sistema de envío de Česká pošta.
Para clientes técnicos y desarrolladores que llaman a Zonos directamente desde su propio sistema.
Endpoint
URL: https://api.zonos.com/graphql
Método: POST
Content-Type: application/json
Autenticación
Pase su clave de API en el encabezado credentialToken:
credentialToken: credential_live_xxxxxxxxxxxxxxxxxx
Ejemplo de API
Inicie sesión en su cuenta de Česká pošta para ver el ejemplo completo de API, incluida la solicitud y la
respuesta completas.
Después de generar Declaration IDs
Envíe el Declaration ID a Česká pošta junto con los detalles de su envío. Česká pošta vincula
el Declaration ID al envío y devuelve un número de seguimiento. Zonos no emite números de
seguimiento.
Manejo de errores
Error / Síntoma↕
Causa probable y solución↕
Security requirement failed
Su clave de API no es válida o se pasó en el encabezado incorrecto. Asegúrese de usar la API Key (no la Account Key) y que el nombre del encabezado sea exactamente credentialToken.
HTTP 401 Unauthorized
Falta la clave de API en los encabezados de la solicitud. Confirme que credentialToken está incluido.
Array errors en la respuesta
La mutación devolvió un error GraphQL. Consulte el campo message en el array de errores para más detalles.
Forma de respuesta inesperada
La respuesta no incluyó data.declarationCreate.id. Registre el cuerpo completo de la respuesta y verifique que el texto de la mutación coincida exactamente con el ejemplo.
Configuración de la cuenta
Configuración de la cuenta
Cree su Verified Account, agregue un método de pago y conecte su integración.
Paso 1 — Cree su Verified Account
Regístrese para una Verified Account de Zonos usando el enlace de registro de Česká pošta. Complete la dirección comercial y la configuración de facturación.
Paso 2 — Agregue un método de pago
Agregue un método de pago a su cuenta de Zonos para financiar la remisión de aranceles de envíos con destino a EE. UU.
Paso 3 — Obtenga su clave de API
Inicie sesión en su Zonos Dashboard y vaya a Account → Integrations. La tabla muestra dos claves:
Copie el token en la fila API key. Comienza con
credential_live_. Necesitará esta clave para ambos métodos de integración.Mantenga su clave de API segura. No la incluya en el control de versiones ni la comparta públicamente. Si cree que se ha visto comprometida, regenérela desde la misma página Account → Integrations.
Paso 4 (opcional) — Estime costos de aranceles con Item Quoter
La herramienta Item Quoter en su Zonos Dashboard le permite consultar costos estimados de aranceles para sus productos antes de enviar, útil para comprobar tasas y planificar con antelación sin generar un Declaration ID.
Métodos de integración
Elija el método que se adapte a su configuración técnica. Ambos métodos producen Declaration IDs que luego carga en el sistema de envío de Česká pošta.
Para clientes técnicos y desarrolladores que llaman a Zonos directamente desde su propio sistema.
Endpoint
https://api.zonos.com/graphqlapplication/jsonAutenticación
Pase su clave de API en el encabezado
credentialToken:credentialToken: credential_live_xxxxxxxxxxxxxxxxxxEjemplo de API
Inicie sesión en su cuenta de Česká pošta para ver el ejemplo completo de API, incluida la solicitud y la respuesta completas.
Después de generar Declaration IDs
Envíe el Declaration ID a Česká pošta junto con los detalles de su envío. Česká pošta vincula el Declaration ID al envío y devuelve un número de seguimiento. Zonos no emite números de seguimiento.
Manejo de errores
credentialToken.credentialTokenestá incluido.errorsen la respuestamessageen el array de errores para más detalles.data.declarationCreate.id. Registre el cuerpo completo de la respuesta y verifique que el texto de la mutación coincida exactamente con el ejemplo.¿Fue útil esta página?