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 flygdetaljerManifestLineInput: Individuella sändningsuppgifter kopplade till ett manifestManifestLineItemInput: Produktinformation för tullklassificeringCreatePartyInput: 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
mutation ManifestCreate($input: ManifestInput!) { manifestCreate(input: $input) { id amount arrivalDate awbNumber awbPrefix carrierCode createdAt createdBy destinationCode operatorDestination operatorOrigin originCode postalOperatorCode serviceNumber source transportationMode updatedAt updatedBy weight weightUnit statusTransitions { createdAt createdBy note source } lines(first: 5) { totalCount edges { cursor node { id trackingNumber endUse currencyCode createdAt createdBy updatedAt updatedBy landedCost { id } } } } }}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.
mutation ManifestLineCreate($manifestId: ID!, $input: ManifestLineInput!) { manifestLineCreate(manifestId: $manifestId, input: $input) { id manifestId trackingNumber endUse currencyCode referenceNumber arrivalDate createdAt createdBy updatedAt updatedBy landedCost { id } }}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.
mutation ManifestLinesCreate($manifestId: ID!, $input: [ManifestLineInput!]!) { manifestLinesCreate(manifestId: $manifestId, input: $input) { id manifestId trackingNumber endUse currencyCode createdAt }}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.
mutation ManifestUpdate($id: ID!, $input: ManifestUpdateInput!) { manifestUpdate(id: $id, input: $input) { id amount arrivalDate awbNumber awbPrefix carrierCode createdAt createdBy destinationCode operatorDestination operatorOrigin originCode postalOperatorCode serviceNumber source transportationMode updatedAt updatedBy weight weightUnit statusTransitions { createdAt createdBy note source } }}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↕ |
|---|---|
CARDIT | Datautbyte med transportör |
PRECON | Förhandsavisering om sändning |
PREDES | Förhandsavisering om avsändning |
RESDIT | Svar på avsändning |
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.