DOCS

Valideer een Declaratie-ID

StartpaginaVoor logistieke dienstverleners Valideer een Declaratie-ID

Verzendlabels | Valideer een Declaratie-ID

Haal de status van een Declaratie-ID op en vul de douanedocumentatie automatisch in

Als je postlabels aanmaakt, kun je Zonos aanroepen om volledige details van de douaneaangifte op te halen wanneer een gebruiker een Declaratie-ID opgeeft. Dit elimineert de noodzaak voor gebruikers om douanedocumentatie handmatig in te vullen, waardoor een naadloze verzendervaring ontstaat waarbij invoerrechten vooraf zijn betaald en douaneformulieren automatisch worden ingevuld.

Automatisch invullen van douaneaangiften 

Volg de onderstaande stappen om automatische invulling van douaneaangiften mogelijk te maken met behulp van Declaratie-ID's van jouw platform.

1. Schakel het Declaratie-ID-veld in de labelcreatieflow in

Voeg een Declaratie-ID-veld toe aan je interface voor het aanmaken van postlabels. Wanneer gebruikers een geldige Declaratie-ID invoeren, kan jouw platform de douaneaangifte automatisch invullen, waardoor handmatige gegevensinvoer wordt geëlimineerd.

2. Vraag de status van de Declaratie-ID en de details van de douaneaangifte op

Gebruik de volgende query om volledige gegevens van de douaneaangifte op te halen met behulp van de Declaratie-ID. Dit retourneert de validatiestatus samen met itemdetails, waarden, HS-codes en ontvangerinformatie wanneer beschikbaar.

Query

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
query DeclarationQuery($id: ID!) {
  declaration(id: $id) {
    id
    status
    paymentStatus
    landedCost {
      id
      method
      landedCostGuaranteeCode
      amountSubtotals {
        duties
        taxes
        fees
        landedCostTotal
      }
    }
    items {
      id
      sku
      productId
      amount
      currencyCode
      name
      hsCode
      description
      hsCodeSource
      countryOfOrigin
      quantity
      measurements {
        type
        value
        unitOfMeasure
      }
    }
    parties {
      id
      type
      person {
        firstName
        lastName
        email
        phone
      }
      location {
        id
        line1
        line2
        countryCode
        postalCode
      }
    }
  }
}

Variabelen

GraphQL

1
2
  "id": "0mm1993s0mdcn"
}

3. Behandel reactie en vul douaneaangifte automatisch in

De API-reactie bevat validatiestatus en douanegegevens. Gebruik de status informatie om te bepalen of de Declaratie-ID geldig is, en vul vervolgens beschikbare douanegegevens automatisch in of vraag om handmatige invoer.

Voorbeeldreacties

Geldige Declaratie-ID met complete douanegegevens:

Reactie

JSON

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
{
  "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 de labelcreatie met behulp van automatisch ingevulde gegevens van een Declaratie-ID of handmatig ingevoerde declaratie-informatie.

5. Koppel het trackingnummer aan de Declaratie-ID

Na de labelcreatie, gebruik de declarationShipmentCreate mutatie om het trackingnummer te koppelen aan de Declaratie-ID, zodat een juiste validatie van de douanerechten en zendingtracking wordt gegarandeerd.

Maak zending aan

GraphQL

1
2
3
mutation DeclarationShipmentCreate($input: DeclarationShipmentCreateInput!) {
  declarationShipmentCreate(input: $input)
}

U kunt een zending maken die is gekoppeld aan een Declaratie-ID door een array van trackingNumbers en de declarationID die voor de zending is gebruikt door te geven.

Variabelen zonder kartondetails

GraphQL

1
2
3
4
5
6
{
  "input": {
    "declarationId": "0mm32wfyrn5es",
    "trackingNumbers": ["test_tracking_1", "test_tracking_2"]
  }
}

U kunt een zending aanmaken door de declarationID te gebruiken die voor de zending is gebruikt. Als u details heeft over de kartons en de items binnen de kartons, kunt u deze doorgeven in de shipmentCarton samen met het trackingNumber voor dat karton.

Variabelen met karton details

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
  "input": {
    "declarationId": "0mm32wfyrn5es",
    "shipmentCartons": [
      {
        "dimensionalUnit": "INCH",
        "length": 8,
        "width": 4,
        "height": 2,
        "trackingNumber": "1234567890",
        "weight": 5,
        "weightUnit": "POUND",
        "items": [
          {
            "itemReference": "item_1",
            "quantity": 3,
            "hsCode": "1234.56.7890"
          }
        ]
      }
    ]
  }
}

Was deze pagina nuttig?

Boek een demo
© 2025 Zonoszonos.com
Op deze pagina:
  • Verzendlabels | Valideer een Declaratie-ID
  • Automatisch invullen van douaneaangiften