DOCS

Opret konto nøgler

Opret konto nøgler

Opret deklarations-ID'er gennem konto nøgler til postoperatører og forsendelsesplatforme

En konto nøgle er en unik autorisationslegitimation (lignende en API-nøgle), der giver godkendte organisationer mulighed for at collect afgifter på vegne af deres brugere uden at kræve individuelle deklarations-ID'er for hver forsendelse. Konto nøgler fjerner behovet for manuel opkrævning af afgifter, samtidig med at de muliggør automatiseret fakturering og overholdelse af post DDP-krav.

En konto nøgle repræsenterer den endelige part, der er ansvarlig for betalingen af afgifter. For eksempel, hvis en forsendelsesplatform ønsker at opnå deres egen konto nøgle, kan de bruge denne nøgle til at generere deklarations-ID'er på vegne af deres brugere. I dette tilfælde ville forsendelsesplatformen collect afgifterne fra brugeren, og Zonos ville fakturere forsendelsesplatformen for afgifterne baseret på de deklarations-ID'er, der er genereret fra deres konto nøgle.

Hvordan konto nøgler fungerer 

Zonos organisationer med konto nøgler kan dynamisk generere deklarations-ID'er under oprettelse af labels, hvilket skaber en problemfri forsendelsesoplevelse, samtidig med at overholdelse af betalingsforpligtelser sikres.

Organisationer kan opnå konto nøgler gennem Zonos Dashboard baseret på deres specifikke anvendelsestilfælde og forhold til Zonos.

Generer deklarations-ID'er ved hjælp af din konto nøgle 

Organisationer med konto nøgler kan dynamisk generere individuelle deklarations-ID'er for forsendelser gennem Zonos API'en. Denne proces muliggør automatiseret opkrævning af afgifter uden at kræve, at brugerne manuelt indtaster deklarations-ID'er.

Brug følgende GraphQL mutation til at generere deklarations-ID'er for en forsendelse uden detaljer om selve forsendelsen.

Anmodning

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
    }
  }
}

Var denne side nyttig?