DOCS

Vorbereitung des Zollmanifestes

Bereiten Sie ein Zollmanifest für US-Sendungen vor.

Stellen Sie Zonos die Daten zu eingehenden Postsendungen zur Verfügung.

Zonos wird umfassende Zollmanifesten erstellen, die alle notwendigen Informationen für Postsendungen in die USA enthalten.

Bereiten Sie die Anfrage vor 

Die Erstellung eines Manifests erfordert die Organisation Ihrer Versanddaten in die richtige Struktur. Die API verwendet einen hierarchischen Ansatz, bei dem Sie zuerst das Manifest erstellen, dann Behälter hinzufügen und schließlich jeden Behälter mit Manifestzeilen füllen, die Versanddetails enthalten.

Jede Komponente hat spezifische erforderliche Felder, um die Zollkonformität und die genaue Dokumentation sicherzustellen. Im Folgenden haben wir die wesentliche Datenstruktur und die erforderlichen Eingaben skizziert.

Wichtige Eingabetypen

Die Manifest-API verwendet mehrere Eingabetypen, um Versanddaten zu organisieren:

  • ManifestInput: Hochrangige Versandinformationen einschließlich Flughäfen, Frachtbrieftyp und Flugdaten
  • ManifestLineInput: Einzelne Versanddetails innerhalb eines Behälters
  • ManifestLineItemInput: Produktinformationen zur Zollklassifizierung
  • CreatePartyInput: Parteien- und Standortdetails für Ursprung und Ziel

Sehen Sie sich die vollständigen Felddefinitionen und Optionen in unserem GraphQL-API Referenz an.

Erstellen Sie ein Manifest über die API 

Sobald Sie Ihre Versanddaten organisiert haben, senden Sie die GraphQL-Mutation, um das Manifest zu erstellen.

Schritt 1: Erstellen Sie den Manifestkopf

MUTATION

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

Schritt 2: Manifestzeilen hinzufügen

Mit der ID, die von der manifestCreate-Mutation zurückgegeben wird, können Sie nun einzelne Sendungen mit dem Manifest verknüpfen.

MUTATION

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

Schritt 3: Manifest aktualisieren

Falls sich die Flugdaten geändert haben, können Sie die Manifestdetails mit der folgenden Mutation aktualisieren.

MUTATION

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

War diese Seite hilfreich?