StartpaginaVoor logistieke dienstverleners Declaration ID valideren

Verzendlabels | Declaration ID valideren

Haal status van een Declaration ID op en vul automatisch douanedocumentatie in

Als u postlabels aanmaakt, kunt u Zonos aanroepen om volledige douane-declaratiedetails op te halen wanneer een gebruiker een Declaration ID opgeeft. Zo hoeven gebruikers geen douanedocumentatie meer handmatig in te vullen, wat een naadloze verzendervaring creëert waarbij duties prepaid zijn en douaneformulieren automatisch worden ingevuld.

Douane-declaraties automatisch invullen

Volg de stappen hieronder om automatisch invullen van douane-declaraties in te schakelen met Declaration ID's van uw platform.

1. Declaration ID-veld inschakelen in labelcreatie-flow

Voeg een Declaration ID-veld toe aan uw postlabel-interface. Wanneer gebruikers een geldige Declaration ID invoeren, kan uw platform de douane-declaratie automatisch invullen, waardoor handmatige gegevensinvoer niet meer nodig is.

2. Declaration ID-status en douane-declaratiedetails queryen

Gebruik de volgende query om volledige douane-declaratiedata op te halen met de Declaration ID. Dit retourneert validatiestatus plus itemdetails, waarden, HS-codes en ontvangergegevens indien beschikbaar

1query DeclarationQuery($id: ID!) {

2 declaration(id: $id) {

3 id

4 status

5 paymentStatus

6 landedCost {

7 id

8 method

9 landedCostGuaranteeCode

10 amountSubtotals {

11 duties

12 taxes

13 fees

14 landedCostTotal

15 }

16 }

17 items {

18 id

19 sku

20 productId

21 amount

22 currencyCode

23 name

24 hsCode

25 description

26 hsCodeSource

27 countryOfOrigin

28 quantity

29 measurements {

30 type

31 value

32 unitOfMeasure

33 }

34 }

35 parties {

36 id

37 type

38 person {

39 firstName

40 lastName

41 email

42 phone

43 }

44 location {

45 id

46 line1

47 line2

48 countryCode

49 postalCode

50 }

51 }

52 }

53}

3. Response afhandelen en douane-declaratie automatisch invullen

De API-response bevat validatiestatus en douanegegevens. Gebruik status om te bepalen of de Declaration ID geldig is en vul daarna beschikbare douanegegevens in of vraag handmatige invoer.

Voorbeeldresponses

Geldige Declaration ID met volledige douanegegevens:

{
  "data": {
    "declaration": {
      "id": "0mm1993s0mdcn",
      "status": "OPEN",
      "paymentStatus": "OPEN",
      "landedCost": {
        "id": "landed_cost_eabb13ab-df23-45df-9ce8-96dd29d396d1",
        "method": "DAP",
        "landedCostGuaranteeCode": "NOT_APPLICABLE",
        "amountSubtotals": {
          "duties": 0.0,
          "taxes": 0.0,
          "fees": 2.62,
          "landedCostTotal": 2.62
        }
      },
      "items": [
        {
          "id": "item_0mm199388v57g",
          "sku": "item_1",
          "productId": "item_1",
          "amount": 70.0,
          "currencyCode": "USD",
          "name": "Item 1",
          "hsCode": "9504.90.4000",
          "description": "This is the description for Item 1",
          "hsCodeSource": "TARIFF_COMPLETED",
          "countryOfOrigin": "CN",
          "quantity": 2,
          "measurements": [
            {
              "type": "WEIGHT",
              "value": 1,
              "unitOfMeasure": "POUND"
            }
          ]
        }
      ],
      "parties": [
        {
          "id": "party_0kesb32rw5hfa",
          "type": "DESTINATION",
          "person": {
            "firstName": "test",
            "lastName": "origin",
            "email": null,
            "phone": "1234567890"
          },
          "location": {
            "id": "location_c7882546-652e-49cb-81a4-98962a54c49f",
            "line1": "123 Test Street",
            "line2": "",
            "countryCode": "US",
            "postalCode": "84790"
          }
        },
        {
          "id": "party_0mjfz59bgg175",
          "type": "ORIGIN",
          "person": {
            "firstName": "test",
            "lastName": "destination",
            "email": null,
            "phone": "1234567890"
          },
          "location": {
            "id": "location_0mdzb9vk8bp7c",
            "line1": "998 Ridgehaven",
            "line2": null,
            "countryCode": "CA",
            "postalCode": "N0N 0N0"
          }
        }
      ]
    }
  }
}

4. Maak de zending aan

Verwerk labelcreatie met automatisch ingevulde data van een Declaration ID of handmatig ingevoerde declaratie-informatie.

5. Koppel trackingnummer aan Declaration ID

Na labelcreatie gebruikt u de declarationShipmentCreate-mutatie om het trackingnummer aan de Declaration ID te koppelen voor duty-validatie en zendingtracking.

1mutation DeclarationShipmentCreate($input: DeclarationShipmentCreateInput!) {

2 declarationShipmentCreate(input: $input)

3}

U maakt een zending gekoppeld aan een Declaration ID door een array van trackingNumbers en de declarationID voor de zending door te geven.

U kunt ook een zending aanmaken door declarationID door te geven met carton- en itemdetails in shipmentCarton samen met het trackingNumber voor dat carton.

GraphQL API ReferenceTypes, inputs, and operations used in this guide

INPUTS

DeclarationShipmentCreateInput

MUTATIONS

declarationShipmentCreate

Boek een demo