DOCS

Forbered toldmanifest

Forbered et toldmanifest for forsendelser til USA.

Giv Zonos data om indgående postforsendelser.

Zonos vil forberede omfattende toldmanifest, der inkluderer alle nødvendige oplysninger for postforsendelser til USA.

Forbered anmodningen 

At oprette et manifest kræver, at du organiserer dine forsendelsesdata i den rette struktur. API'en bruger en hierarkisk tilgang, hvor du først opretter manifestet, derefter tilføjer beholdere, og til sidst fylder hver beholder med manifestlinjer, der indeholder forsendelsesdetaljer.

Hver komponent har specifikke obligatoriske felter for at sikre toldoverholdelse og nøjagtig dokumentation. Nedenfor har vi skitseret den essentielle datastruktur og de nødvendige input.

Nøgle inputtyper

Manifest API'en bruger flere inputtyper til at organisere forsendelsesdata:

  • ManifestInput: Høj-niveau forsendelsesoplysninger inklusive lufthavne, waybill-type og flydetaljer
  • ManifestLineInput: Individuelle forsendelsesdetaljer inden for en beholder
  • ManifestLineItemInput: Produktinformation til toldklassifikation
  • CreatePartyInput: Part og lokalitetsoplysninger for oprindelse og destination

Se de komplette feltdefinitioner og muligheder i vores GraphQL API reference.

Opret et manifest via API 

Når du har organiseret dine forsendelsesdata, send GraphQL mutation for at oprette manifestet.

Trin 1: Opret manifestoverskriften

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

Trin 2: Tilføj manifestlinjer

Ved at bruge ID'et, der returneres fra manifestCreate mutation, kan du nu linke individuelle forsendelser til 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
  }
}

Trin 3: Opdater manifest

I tilfælde af at flyoplysningerne er ændret, kan du opdatere manifestoplysningerne ved hjælp af følgende 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 denne side nyttig?