DOCS
HjemTil logistikudbydere Carriers og resellers Forbered toldmanifest

Forbered et toldmanifest for USA-forsendelser.

Giv Zonos data om indgående postforsendelser.

Zonos forbereder omfattende toldmanifester, der indeholder alle nødvendige oplysninger for postforsendelser til USA.

Forbered anmodningen 

Oprettelse af et manifest kræver, at du organiserer dine forsendelsesdata i den korrekte struktur. API'en bruger en hierarkisk tilgang, hvor du først opretter manifestet og derefter tilføjer manifestlinjer med individuelle forsendelsesdetaljer.

Hver komponent har specifikke påkrævede felter for at sikre toldcompliance og korrekt dokumentation. Nedenfor har vi skitseret den væsentlige datastruktur og de påkrævede input.

Vigtige inputtyper

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

  • ManifestInput: Overordnede forsendelsesoplysninger, herunder lufthavne, waybill-type og flydetaljer
  • ManifestLineInput: Individuelle forsendelsesdetaljer knyttet til et manifest
  • ManifestLineItemInput: Produktoplysninger til toldklassificering
  • CreatePartyInput: Part- og lokationsdetaljer for oprindelse og destination

Se de fulde feltdefinitioner og muligheder i vores GraphQL API-reference.

Opret et manifest via API 

Når du har organiseret dine forsendelsesdata, skal du sende GraphQL-mutationen for at oprette manifestet.

Trin 1: Opret manifestheaderen

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}

Svar

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

Trin 2: Tilføj manifestlinjer

Med det ID, der returneres fra manifestCreate-mutationen, kan du nu knytte individuelle forsendelser til manifestet.

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}

Svar

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

Trin 3: Tilføj flere manifestlinjer (batch)

For effektivitet kan du tilføje flere manifestlinjer i en enkelt anmodning ved hjælp af manifestLinesCreate-mutationen. Hver linje kræver sit eget parties-array for at definere forsendelsens oprindelse og destination.

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}

Svar

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

Trin 4: Opdater manifest

Hvis flydetaljerne er ændret, kan du opdatere manifestdetaljer ved hjælp af følgende mutation. Feltet source er påkrævet og angiver datakilden for opdateringen.

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}

Svar

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

Datakildeværdier

Feltet source i ManifestUpdateInput accepterer følgende værdier:

Værdi↕Beskrivelse↕
CARDITUdveksling af transportørdata
PRECONRådgivning før forsendelse
PREDESRådgivning før afsendelse
RESDITSvar på afsendelse

Var denne side nyttig?

Få support·Juridiske dokumenter·© 2026 Zonos
På denne side:
  • Forbered et toldmanifest for USA-forsendelser.
  • Forbered anmodningen
  • Opret et manifest via API