DOCS

Zollmanifest vorbereiten

StartseiteFür Logistikdienstleister Carrier & Reseller Zollmanifest vorbereiten

Zollmanifest für US-Sendungen vorbereiten

Übermitteln Sie Zonos Daten zu eingehenden Postsendungen.

Zonos erstellt umfassende Zollmanifeste, die alle erforderlichen Informationen für Postsendungen in die USA enthalten.

Anfrage vorbereiten 

Zum Erstellen eines Manifests müssen Sie Ihre Sendungsdaten in die richtige Struktur bringen. Die API verwendet einen hierarchischen Ansatz: Zuerst erstellen Sie das Manifest, anschließend fügen Sie Manifestzeilen mit den einzelnen Sendungsdetails hinzu.

Jede Komponente hat spezifische Pflichtfelder, um die Zollkonformität und eine korrekte Dokumentation sicherzustellen. Nachfolgend finden Sie die wesentliche Datenstruktur und die erforderlichen Eingaben.

Wichtige Eingabetypen

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

  • ManifestInput: Übergreifende Sendungsinformationen einschließlich Flughäfen, Frachtbrieftyp und Flugdetails
  • ManifestLineInput: Einzelne Sendungsdetails, die mit einem Manifest verknüpft sind
  • ManifestLineItemInput: Produktinformationen für die Zollklassifizierung
  • CreatePartyInput: Partei- und Standortdetails für Ursprung und Ziel

Die vollständigen Felddefinitionen und Optionen finden Sie in unserer GraphQL-API-Referenz.

Manifest über die API erstellen 

Sobald Sie Ihre Sendungsdaten organisiert haben, senden Sie die GraphQL-Mutation zum Erstellen des Manifests.

Schritt 1: Manifest-Kopf erstellen

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}

Antwort

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": []
      }
    }
  }
}

Schritt 2: Manifestzeilen hinzufügen

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

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}

Antwort

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

Schritt 3: Mehrere Manifestzeilen hinzufügen (Batch)

Zur Effizienzsteigerung können Sie mehrere Manifestzeilen in einer einzigen Anfrage mit der manifestLinesCreate-Mutation hinzufügen. Jede Zeile erfordert ein eigenes parties-Array, um Ursprung und Ziel der Sendung zu definieren.

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}

Antwort

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

Schritt 4: Manifest aktualisieren

Falls sich Flugdetails geändert haben, können Sie Manifestdetails mit der folgenden Mutation aktualisieren. Das Feld source ist erforderlich und gibt die Datenquelle für die Aktualisierung an.

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}

Antwort

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

Datenquellenwerte

Das Feld source in ManifestUpdateInput akzeptiert die folgenden Werte:

Wert↕Beschreibung↕
CARDITDatenaustausch mit Spediteur
PRECONVorab-Sendungsanmeldung
PREDESVorab-Versandanmeldung
RESDITAntwort auf Versandanmeldung
Buchen Sie eine Demo

War diese Seite hilfreich?

Holen Sie sich Unterstützung·Rechtsdokumente·© 2026 Zonos
Auf dieser Seite:
  • Zollmanifest für US-Sendungen vorbereiten
  • Anfrage vorbereiten
  • Manifest über die API erstellen