DOCS

Förbered tullmanifest

Förbered ett tullmanifest för försändelser till USA.

Ge Zonos data om inkommande postförsändelser.

Zonos kommer att förbereda omfattande tullmanifest som inkluderar all nödvändig information för postförsändelser till USA.

Förbered begäran 

Att skapa ett manifest kräver att du organiserar din försändelsedata i rätt struktur. API:et använder en hierarkisk metod där du först skapar manifestet, sedan lägger till behållare, och slutligen fyller varje behållare med manifestlinjer som innehåller försändelsedetaljer.

Varje komponent har specifika obligatoriska fält för att säkerställa tullöverensstämmelse och korrekt dokumentation. Nedan har vi skisserat den väsentliga datastrukturen och nödvändiga indata.

Viktiga inmatningstyper

Manifest-API:et använder flera inmatningstyper för att organisera försändelsedata:

  • ManifestInput: Hög nivå av försändelseinformation inklusive flygplatser, fraktsedels typ och flygdetaljer
  • ManifestLineInput: Individuella försändelsedetaljer inom en behållare
  • ManifestLineItemInput: Produktinformation för tullklassificering
  • CreatePartyInput: Part och platsdetaljer för ursprung och destination

Se de kompletta fältdelarna och alternativen i vår GraphQL API referens.

Skapa ett manifest via API 

När du har organiserat din försändelsedata, skicka GraphQL-mutation för att skapa manifestet.

Steg 1: Skapa manifesthuvudet

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

Steg 2: Lägg till manifestlinjer

Med hjälp av ID:t som returnerades från manifestCreate-mutation kan du nu koppla individuella försändelser till manifestet.

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

Steg 3: Uppdatera manifest

Om flyginformationen har ändrats kan du uppdatera manifestdetaljer med hjälp av följande mutation.

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

Var den här sidan till hjälp?