DOCS

Bereid douane manifest voor

Bereid een douane manifest voor voor zendingen naar de VS.

Geef Zonos de gegevens van inkomende postzendingen.

Zonos zal uitgebreide douane manifesten voorbereiden die alle noodzakelijke informatie voor postzendingen naar de VS bevatten.

Bereid de aanvraag voor 

Het creëren van een manifest vereist het organiseren van uw zendinggegevens in de juiste structuur. De API gebruikt een hiërarchische benadering waarbij u eerst het manifest aanmaakt, vervolgens de receptakels toevoegt, en ten slotte elke receptakel vult met manifestregels die de zendingdetails bevatten.

Elke component heeft specifieke vereiste velden om te zorgen voor douane-naleving en nauwkeurige documentatie. Hieronder hebben we de essentiële datastructuur en vereiste invoer uiteengezet.

Belangrijke invoertypen

De manifest API gebruikt verschillende invoertypen om zendinggegevens te organiseren:

  • ManifestInput: Hoog-niveau zendinginformatie inclusief luchthavens, waybill-type en vluchtgegevens
  • ManifestLineInput: Individuele zendingdetails binnen een receptakel
  • ManifestLineItemInput: Productinformatie voor douanecategorisering
  • CreatePartyInput: Gegevens van partijen en locaties voor oorsprong en bestemming

Bekijk de complete velddefinities en opties in onze GraphQL API referentie.

Maak een manifest via API 

Zodra u uw zendinggegevens heeft georganiseerd, verstuur de GraphQL-mutatie om het manifest te creëren.

Stap 1: Maak de manifestkop

MUTATIE

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
mutation ManifestCreate {
  manifestCreate(
    input: {
      arrivalDate: "2025-09-11T16:16:49.262Z"
      postalOperatorCode: J1CMDA
      carrierCode: "AA"
      destinationCode: "JFK"
      serviceNumber: "11"
    }
  ) {
    amount
    createdAt
    createdBy
    id
    postalOperatorCode
    transportationMode
    updatedAt
    updatedBy
    weight
    weightUnit
    lines(first: 5) {
      totalCount
      edges {
        cursor
        node {
          createdAt
          createdBy
          id
          updatedAt
          updatedBy
          landedCost {
            id
          }
        }
      }
    }
    arrivalDate
    awbPrefix
    carrierCode
    destinationCode
    originCode
    operatorDestination
    statusTransitions {
      note
      source
      createdAt
      createdBy
    }
    operatorOrigin
    serviceNumber
    source
  }
}

Stap 2: Voeg manifestregels toe

Met de ID die is teruggegeven door de manifestCreate mutatie, kunt u nu individuele zendingen aan het manifest koppelen.

MUTATIE

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
mutation ManifestLineCreate {
  manifestLineCreate(
    manifestId: "A-AA137-J1CGBA-(2025-09-12)"
    input: {
      endUse: NOT_FOR_RESALE
      trackingNumber: "1Z08134599"
      referenceNumber: "test"
      items: { amount: "453", quantity: 2, countryOfOrigin: CN }
      parties: [
        { type: ORIGIN, location: { countryCode: GB } }
        { type: DESTINATION, location: { countryCode: US } }
      ]
      currencyCode: USD
    }
  ) {
    createdAt
    createdBy
    endUse
    id
    manifestId
    trackingNumber
    updatedAt
    updatedBy
  }
}

Stap 3: Update manifest

In het geval dat vluchtgegevens zijn gewijzigd, kunt u de manifestgegevens bijwerken met behulp van de volgende mutatie.

MUTATIE

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
mutation ManifestUpdate {
  manifestUpdate(
    id: "manifest_0my2erm8c14z3"
    input: {
      source: RESDIT
      carrierCode: "JFK"
      arrivalDate: "2025-09-12T16:16:49.262Z"
      serviceNumber: "79824513"
      note: "Update from RESDIT"
    }
  ) {
    amount
    arrivalDate
    awbNumber
    awbPrefix
    carrierCode
    createdAt
    createdBy
    destinationCode
    id
    operatorDestination
    operatorOrigin
    originCode
    postalOperatorCode
    serviceNumber
    source
    transportationMode
    updatedAt
    updatedBy
    weight
    statusTransitions {
      note
      source
      createdAt
    }
  }
}

Was deze pagina nuttig?