Kontokonfiguration

Skapa ert verifierade konto, lägg till en betalningsmetod och anslut er integration.

Steg 1 — Skapa ert verifierade konto

Registrera er för ett verifierat Zonos-konto via Česká poštas registreringslänk. Fyll i er företagsadress och faktureringsinställningar.

Steg 2 — Lägg till en betalningsmetod

Lägg till en betalningsmetod på ert Zonos-konto för att finansiera tullinbetalning för sändningar till USA.

Steg 3 — Hämta er API-nyckel

Logga in på er Zonos Dashboard och gå till Konto → Integrationer. Tabellen visar två nycklar:

Namn i Dashboard↕	Syfte↕	Använda till API?↕
Account key	Identifierare för koppling till postoperatören	❌ NEJ
API key	Autentiseringsnyckel för anrop till Zonos API	✅ JA — använd den här

Kopiera token i raden API key. Den börjar med credential_live_. Ni behöver den här nyckeln för båda integrationsmetoderna.

Håll er API-nyckel säker. Committa den inte till källkontroll och dela den inte offentligt. Om ni tror att den har komprometterats, regenerera den från samma sida Konto → Integrationer.

Steg 4 (valfritt) — Uppskatta tullkostnader med Item Quoter

Verktyget Item Quoter i er Zonos Dashboard låter er slå upp uppskattade tullkostnader för era produkter innan ni skickar — praktiskt för att kontrollera priser och planera utan att generera ett Declaration ID.

Integrationsmetoder

Välj den metod som passar er tekniska uppsättning. Båda metoderna genererar Declaration ID:n som ni sedan laddar upp till Česká poštas fraktsystem.

För tekniska kunder och utvecklare som anropar Zonos direkt från sitt eget system.

Endpoint

URL: https://api.zonos.com/graphql
Method: POST
Content-Type: application/json

Authentication

Skicka er API-nyckel i headern credentialToken: credentialToken: credential_live_xxxxxxxxxxxxxxxxxx

API-exempel

Logga in på ert Česká pošta-konto för det fullständiga API-exemplet, inklusive hela begäran och svar.

Efter att Declaration ID:n har genererats

Skicka Declaration ID till Česká pošta tillsammans med era sändningsuppgifter. Česká pošta kopplar Declaration ID till sändningen och returnerar ett spårningsnummer. Zonos utfärdar inte spårningsnummer.

Felhantering

Fel / symptom↕	Trolig orsak och åtgärd↕
Security requirement failed	Er API-nyckel är ogiltig eller skickad i fel header. Se till att ni använder API Key (inte Account Key) och att headernamnet är exakt `credentialToken`.
HTTP 401 Unauthorized	API-nyckeln saknas i begärans headers. Bekräfta att `credentialToken` ingår.
`errors`-array i svaret	Mutation returnerade ett GraphQL-fel. Kontrollera fältet `message` i errors-arrayen för detaljer.
Oväntad svarform	Svaret innehöll inte `data.declarationCreate.id`. Logga hela svarskroppen och kontrollera att mutationstexten matchar exemplet exakt.

Boka en demo