DOCS

Skapa kontonycklar

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.

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

Var den här sidan till hjälp?