Registrati per un account verificato Zonos utilizzando il
Link per la registrazione a Česká pošta.
Completa l'indirizzo aziendale e la configurazione della fatturazione.
Accedi al tuo Zonos Dashboard e vai su Account →
Integrazioni. La tabella mostra due chiavi:
Nome in Dashboard↕
Scopo↕
Utilizzare per API?↕
Chiave account
Identificatore per il collegamento con l'operatore postale
❌NO
Chiave API
Chiave di autenticazione per chiamare l'API di Zonos
✅ SÌ: usa questa
Copia il token nella riga Chiave API. Inizia con credential_live_. Avrai bisogno di questa
chiave per entrambi i metodi di integrazione.
Mantieni la tua chiave API al sicuro. Non includerla nel sistema di controllo di versione né condividerla pubblicamente. Se
ritieni che sia stata compromessa, rigenerala dalla stessa pagina Account → Integrazioni.
Lo strumento Item Quoter nel tuo
Zonos Dashboard ti consente di verificare i costi di dazio stimati per i tuoi prodotti prima della spedizione — utile
per controllare le tariffe e pianificare in anticipo senza generare un ID dichiarazione.
Scegli il metodo adatto alla tua configurazione tecnica. Entrambi i metodi generano ID dichiarazione che
in seguito carichi nel sistema di spedizione di Česká pošta.
Per clienti tecnici e sviluppatori che chiamano Zonos direttamente dal proprio sistema.
Endpoint
URL: https://api.zonos.com/graphql
Metodo: POST
Tipo di contenuto: application/json
Autenticazione
Passa la tua chiave API nell'intestazione credentialToken:
credentialToken: credential_live_xxxxxxxxxxxxxxxxxx
Esempio API
Accedi al tuo account Česká pošta per l'esempio API completo, comprese la richiesta e la risposta
complete.
Dopo aver generato gli ID dichiarazione
Invia l'ID dichiarazione a Česká pošta insieme ai dettagli della spedizione. Česká pošta collega
l'ID dichiarazione alla spedizione e restituisce un numero di tracciamento. Zonos non emette
numeri di tracciamento.
Error handling
Errore/sintomo↕
Probabile causa e soluzione↕
Il requisito di sicurezza non è riuscito
La tua chiave API non è valida o è stata inserita nell'intestazione sbagliata. Assicurati di utilizzare la chiave API (non la chiave account) e che il nome dell'intestazione sia esattamente credentialToken.
HTTP 401 non autorizzato
La chiave API manca dalle intestazioni della richiesta. Verifica che credentialToken sia incluso.
errors array in risposta
La mutazione ha restituito un errore GraphQL. Controlla il campo message nell'array degli errori per i dettagli.
Forma di risposta inaspettata
La risposta non includeva data.declarationCreate.id. Registra il corpo completo della risposta e verifica che il testo della mutazione corrisponda esattamente all'esempio.
Configurazione dell'account
Configurazione dell'account
Crea il tuo account verificato, aggiungi un metodo di pagamento e collega la tua integrazione.
Passaggio 1: crea il tuo account verificato
Registrati per un account verificato Zonos utilizzando il Link per la registrazione a Česká pošta. Completa l'indirizzo aziendale e la configurazione della fatturazione.
Passaggio 2: aggiungi un metodo di pagamento
Aggiungi un metodo di pagamento al tuo account Zonos per finanziare le rimesse dei dazi per le spedizioni destinate agli Stati Uniti.
Passaggio 3: ottieni la chiave API
Accedi al tuo Zonos Dashboard e vai su Account → Integrazioni. La tabella mostra due chiavi:
Copia il token nella riga Chiave API. Inizia con
credential_live_. Avrai bisogno di questa chiave per entrambi i metodi di integrazione.Mantieni la tua chiave API al sicuro. Non includerla nel sistema di controllo di versione né condividerla pubblicamente. Se ritieni che sia stata compromessa, rigenerala dalla stessa pagina Account → Integrazioni.
Passaggio 4 (facoltativo): stimare i costi dei dazi con Item Quoter
Lo strumento Item Quoter nel tuo Zonos Dashboard ti consente di verificare i costi di dazio stimati per i tuoi prodotti prima della spedizione — utile per controllare le tariffe e pianificare in anticipo senza generare un ID dichiarazione.
Metodi di integrazione
Scegli il metodo adatto alla tua configurazione tecnica. Entrambi i metodi generano ID dichiarazione che in seguito carichi nel sistema di spedizione di Česká pošta.
Per clienti tecnici e sviluppatori che chiamano Zonos direttamente dal proprio sistema.
Endpoint
https://api.zonos.com/graphqlapplication/jsonAutenticazione
Passa la tua chiave API nell'intestazione
credentialToken:credentialToken: credential_live_xxxxxxxxxxxxxxxxxxEsempio API
Accedi al tuo account Česká pošta per l'esempio API completo, comprese la richiesta e la risposta complete.
Dopo aver generato gli ID dichiarazione
Invia l'ID dichiarazione a Česká pošta insieme ai dettagli della spedizione. Česká pošta collega l'ID dichiarazione alla spedizione e restituisce un numero di tracciamento. Zonos non emette numeri di tracciamento.
Error handling
credentialToken.credentialTokensia incluso.errorsarray in rispostamessagenell'array degli errori per i dettagli.data.declarationCreate.id. Registra il corpo completo della risposta e verifica che il testo della mutazione corrisponda esattamente all'esempio.Questa pagina è stata utile?