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 flydetaljerManifestLineInput: Individuelle forsendelsesdetaljer inden for en beholderManifestLineItemInput: Produktinformation til toldklassifikationCreatePartyInput: 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
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
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
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
}
}
}
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.