DOCS
HemFör logistikleverantörer Transportörer och återförsäljare Förbered tullmanifest

Förbered ett tullmanifest för sändningar till USA.

Ge Zonos data om inkommande postsändningar.

Zonos förbereder kompletta tullmanifest som inkluderar all nödvändig information för postsändningar till USA.

Förbered begäran 

Att skapa ett manifest kräver att ni organiserar er sändningsdata i rätt struktur. API:et använder ett hierarkiskt tillvägagångssätt där ni först skapar manifestet och sedan lägger till manifestrader med individuella sändningsuppgifter.

Varje komponent har specifika obligatoriska fält för att säkerställa tullefterlevnad och korrekt dokumentation. Nedan har vi beskrivit den väsentliga datastrukturen och obligatoriska indata.

Viktiga indatatyper

Manifest-API:et använder flera indatatyper för att organisera sändningsdata:

  • ManifestInput: Övergripande sändningsinformation inklusive flygplatser, typ av fraktsedel och flygdetaljer
  • ManifestLineInput: Individuella sändningsuppgifter kopplade till ett manifest
  • ManifestLineItemInput: Produktinformation för tullklassificering
  • CreatePartyInput: Part- och platsuppgifter för ursprung och destination

Visa kompletta fältdefinitioner och alternativ i vår GraphQL API-referens.

Skapa ett manifest via API 

När ni har organiserat er sändningsdata skickar ni GraphQL-mutationen för att skapa manifestet.

Steg 1: Skapa manifesthuvudet

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

Steg 2: Lägg till manifestrader

Med ID:t som returneras från mutationen manifestCreate kan ni nu koppla individuella sändningar till 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
    }
  }
}

Steg 3: Lägg till flera manifestrader (batch)

För effektivitet kan ni lägga till flera manifestrader i en enda begäran med mutationen manifestLinesCreate. Varje rad kräver sin egen parties-array för att definiera sändningens ursprung och 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"
      }
    ]
  }
}

Steg 4: Uppdatera manifest

Om flygdetaljer har ändrats kan ni uppdatera manifestdetaljer med följande mutation. Fältet source är obligatoriskt och anger datakällan för uppdateringen.

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

Värden för datakälla

Fältet source i ManifestUpdateInput accepterar följande värden:

Värde↕Beskrivning↕
CARDITDatautbyte med transportör
PRECONFörhandsavisering om sändning
PREDESFörhandsavisering om avsändning
RESDITSvar på avsändning

Var den här sidan till hjälp?

Få support·Juridiska dokument·© 2026 Zonos
På den här sidan:
  • Förbered ett tullmanifest för sändningar till USA.
  • Förbered begäran
  • Skapa ett manifest via API