Hur kontonycklar fungerar
Zonos-organisationer med kontonycklar kan dynamiskt generera deklarations-ID:n under etikett skapande, vilket skapar en sömlös fraktupplevelse samtidigt som efterlevnad av avgiftsbetalning säkerställs.
Organisationer kan få kontonycklar genom Zonos Dashboard baserat på deras specifika användningsfall och relation med Zonos.
Generera deklarations-ID:n med din kontonyckel
Organisationer med kontonycklar kan dynamiskt generera individuella deklarations-ID:n för försändelser genom Zonos API. Denna process möjliggör automatiserad avgiftsinsamling utan att användarna behöver ange deklarations-ID:n manuellt.
Använd följande GraphQL-mutation för att generera deklarations-ID:n för en försändelse utan detaljer om själva försändelsen.
Begäran
GraphQL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
declarationCreate(input: $input) {
id
status
paymentStatus
source
organizationId
parties {
id
}
items {
id
}
landedCost {
id
currencyCode
}
}
}
Variabler
JSON
1
2
3
4
5
{
"input": {
"source": "POST"
}
}
Svar
JSON
1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
"data": {
"declarationCreate": {
"id": "0mm32wfyrn5es",
"status": "OPEN",
"paymentStatus": "OPEN",
"source": "POST",
"organizationId": "organization_test",
"parties": [],
"items": [],
"landedCost": null
}
}
}
Skapa kontonycklar
Skapa deklarations-ID:n genom kontonycklar för postoperatörer och fraktplattformar
En kontonyckel är en unik auktoriseringscredential (liknande en API-nyckel) som tillåter godkända organisationer att collect avgifter å sina användares vägnar utan att kräva individuella deklarations-ID:n för varje försändelse. Kontonycklar eliminerar behovet av manuell avgiftsinsamling samtidigt som de möjliggör automatiserad fakturering och efterlevnad av postens DDP-krav.
En kontonyckel representerar den slutliga parten som är ansvarig för betalningen av avgifter. Till exempel, om en fraktplattform vill skaffa sin egen kontonyckel, kan de använda denna nyckel för att generera deklarations-ID:n å sina användares vägnar. I detta fall skulle fraktplattformen collect avgifterna från användaren och Zonos skulle fakturera fraktplattformen för avgifterna baserat på de deklarations-ID:n som genererats från deras kontonyckel.