DOCS

Douanemanifest voorbereiden

StartpaginaVoor logistieke dienstverleners Carriers & resellers Douanemanifest voorbereiden

Douanemanifest voorbereiden voor VS-zendingen.

Lever Zonos gegevens over binnenkomende postzendingen.

Zonos bereidt uitgebreide douanemanifesten voor met alle benodigde informatie voor postzendingen naar de VS.

Het verzoek voorbereiden 

Een manifest aanmaken vereist dat u zendingdata in de juiste structuur organiseert. De API gebruikt een hiërarchische aanpak: eerst het manifest aanmaken, daarna manifestregels met individuele zendingdetails toevoegen.

Elk onderdeel heeft specifieke verplichte velden voor douanecompliance en nauwkeurige documentatie. Hieronder staan de essentiële datastructuur en verplichte invoer.

Belangrijke invoertypes

De manifest-API gebruikt verschillende invoertypes om zendingdata te organiseren:

  • ManifestInput: High-level zendinginformatie, waaronder luchthavens, type vrachtbrief en vluchtgegevens
  • ManifestLineInput: Individuele zendingdetails gekoppeld aan een manifest
  • ManifestLineItemInput: Productinformatie voor douaneclassificatie
  • CreatePartyInput: Partij- en locatiegegevens voor herkomst en bestemming

Bekijk de volledige velddefinities en opties in onze GraphQL API-referentie.

Manifest aanmaken via API 

Zodra u uw zendingdata hebt georganiseerd, stuurt u de GraphQL-mutatie om het manifest aan te maken.

Stap 1: Manifestheader aanmaken

1mutation ManifestCreate($input: ManifestInput!) {
2 manifestCreate(input: $input) {
3 id
4 amount
5 arrivalDate
6 awbNumber
7 awbPrefix
8 carrierCode
9 createdAt
10 createdBy
11 destinationCode
12 operatorDestination
13 operatorOrigin
14 originCode
15 postalOperatorCode
16 serviceNumber
17 source
18 transportationMode
19 updatedAt
20 updatedBy
21 weight
22 weightUnit
23 statusTransitions {
24 createdAt
25 createdBy
26 note
27 source
28 }
29 lines(first: 5) {
30 totalCount
31 edges {
32 cursor
33 node {
34 id
35 trackingNumber
36 endUse
37 currencyCode
38 createdAt
39 createdBy
40 updatedAt
41 updatedBy
42 landedCost {
43 id
44 }
45 }
46 }
47 }
48 }
49}

RESPONSE

json

{
  "data": {
    "manifestCreate": {
      "id": "manifest_abc123def456",
      "amount": "0",
      "arrivalDate": "2026-03-15T14:30:00.000Z",
      "awbNumber": "1234",
      "awbPrefix": "001",
      "carrierCode": "AA",
      "createdAt": "2026-01-06T12:00:00.000Z",
      "createdBy": "organization_xyz789",
      "destinationCode": "JFK",
      "operatorDestination": "US",
      "originCode": "LHR",
      "postalOperatorCode": "J1CGBA",
      "serviceNumber": "1234",
      "source": "API",
      "transportationMode": "AIR",
      "updatedAt": "2026-01-06T12:00:00.000Z",
      "updatedBy": "organization_xyz789",
      "weight": "0",
      "weightUnit": "KILOGRAM",
      "statusTransitions": [],
      "lines": {
        "totalCount": 0,
        "edges": []
      }
    }
  }
}

Stap 2: Manifestregels toevoegen

Met de ID uit de manifestCreate-mutatie kunt u individuele zendingen aan het manifest koppelen.

1mutation ManifestLineCreate($manifestId: ID!, $input: ManifestLineInput!) {
2 manifestLineCreate(manifestId: $manifestId, input: $input) {
3 id
4 manifestId
5 trackingNumber
6 endUse
7 currencyCode
8 referenceNumber
9 arrivalDate
10 createdAt
11 createdBy
12 updatedAt
13 updatedBy
14 landedCost {
15 id
16 }
17 }
18}

RESPONSE

json

{
  "data": {
    "manifestLineCreate": {
      "id": "manifest_line_def456ghi789",
      "manifestId": "manifest_abc123def456",
      "trackingNumber": "LX123456789GB",
      "endUse": "NOT_FOR_RESALE",
      "currencyCode": "USD",
      "referenceNumber": "ORDER-2026-001",
      "arrivalDate": "2026-03-15T14:30:00.000Z",
      "createdAt": "2026-01-06T12:05:00.000Z",
      "createdBy": "organization_xyz789",
      "updatedAt": "2026-01-06T12:05:00.000Z",
      "updatedBy": "organization_xyz789",
      "landedCost": null
    }
  }
}

Stap 3: Meerdere manifestregels toevoegen (batch)

Voor efficiëntie kunt u meerdere manifestregels in één verzoek toevoegen met de manifestLinesCreate-mutatie. Elke regel vereist een eigen parties-array om de herkomst en bestemming van de zending te definiëren.

1mutation ManifestLinesCreate($manifestId: ID!, $input: [ManifestLineInput!]!) {
2 manifestLinesCreate(manifestId: $manifestId, input: $input) {
3 id
4 manifestId
5 trackingNumber
6 endUse
7 currencyCode
8 createdAt
9 }
10}

RESPONSE

json

{
  "data": {
    "manifestLinesCreate": [
      {
        "id": "manifest_line_aaa111bbb222",
        "manifestId": "manifest_abc123def456",
        "trackingNumber": "LX123456789GB",
        "endUse": "NOT_FOR_RESALE",
        "currencyCode": "USD",
        "createdAt": "2026-01-06T12:10:00.000Z"
      },
      {
        "id": "manifest_line_ccc333ddd444",
        "manifestId": "manifest_abc123def456",
        "trackingNumber": "LX987654321GB",
        "endUse": "GIFT",
        "currencyCode": "USD",
        "createdAt": "2026-01-06T12:10:00.000Z"
      }
    ]
  }
}

Stap 4: Manifest bijwerken

Als vluchtgegevens zijn gewijzigd, kunt u manifestdetails bijwerken met de volgende mutatie. Het veld source is verplicht en geeft de databron voor de update aan.

1mutation ManifestUpdate($id: ID!, $input: ManifestUpdateInput!) {
2 manifestUpdate(id: $id, input: $input) {
3 id
4 amount
5 arrivalDate
6 awbNumber
7 awbPrefix
8 carrierCode
9 createdAt
10 createdBy
11 destinationCode
12 operatorDestination
13 operatorOrigin
14 originCode
15 postalOperatorCode
16 serviceNumber
17 source
18 transportationMode
19 updatedAt
20 updatedBy
21 weight
22 weightUnit
23 statusTransitions {
24 createdAt
25 createdBy
26 note
27 source
28 }
29 }
30}

RESPONSE

json

{
  "data": {
    "manifestUpdate": {
      "id": "manifest_abc123def456",
      "amount": "150.50",
      "arrivalDate": "2026-03-16T10:00:00.000Z",
      "awbNumber": "5678",
      "awbPrefix": "001",
      "carrierCode": "BA",
      "createdAt": "2026-01-06T12:00:00.000Z",
      "createdBy": "organization_xyz789",
      "destinationCode": "JFK",
      "operatorDestination": "US",
      "originCode": "LHR",
      "postalOperatorCode": "J1CGBA",
      "serviceNumber": "5678",
      "source": "RESDIT",
      "transportationMode": "AIR",
      "updatedAt": "2026-01-06T14:30:00.000Z",
      "updatedBy": "organization_xyz789",
      "weight": "25.5",
      "weightUnit": "KILOGRAM",
      "statusTransitions": [
        {
          "createdAt": "2026-01-06T14:30:00.000Z",
          "createdBy": "organization_xyz789",
          "note": "Flight rescheduled due to weather",
          "source": "RESDIT"
        }
      ]
    }
  }
}

Waarden voor databron

Het veld source in ManifestUpdateInput accepteert de volgende waarden:

Waarde↕Beschrijving↕
CARDITCarrier data interchange
PRECONPre-consignment advice
PREDESPre-despatch advice
RESDITResponse to despatch
Boek een demo

Was deze pagina nuttig?

Krijg ondersteuning·Juridische documenten·© 2026 Zonos
Op deze pagina:
  • Douanemanifest voorbereiden voor VS-zendingen.
  • Het verzoek voorbereiden
  • Manifest aanmaken via API