Bereid de aanvraag voor
Het creëren van een manifest vereist het organiseren van uw zendinggegevens in de juiste structuur. De API gebruikt een hiërarchische benadering waarbij u eerst het manifest aanmaakt, vervolgens de receptakels toevoegt, en ten slotte elke receptakel vult met manifestregels die de zendingdetails bevatten.
Elke component heeft specifieke vereiste velden om te zorgen voor douane-naleving en nauwkeurige documentatie. Hieronder hebben we de essentiële datastructuur en vereiste invoer uiteengezet.
Belangrijke invoertypen
De manifest API gebruikt verschillende invoertypen om zendinggegevens te organiseren:
ManifestInput: Hoog-niveau zendinginformatie inclusief luchthavens, waybill-type en vluchtgegevensManifestLineInput: Individuele zendingdetails binnen een receptakelManifestLineItemInput: Productinformatie voor douanecategoriseringCreatePartyInput: Gegevens van partijen en locaties voor oorsprong en bestemming
Bekijk de complete velddefinities en opties in onze GraphQL API referentie.
Maak een manifest via API
Zodra u uw zendinggegevens heeft georganiseerd, verstuur de GraphQL-mutatie om het manifest te creëren.
Stap 1: Maak de manifestkop
MUTATIE
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
}
}
Stap 2: Voeg manifestregels toe
Met de ID die is teruggegeven door de manifestCreate mutatie, kunt u nu individuele zendingen aan het manifest koppelen.
MUTATIE
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
}
}
Stap 3: Update manifest
In het geval dat vluchtgegevens zijn gewijzigd, kunt u de manifestgegevens bijwerken met behulp van de volgende mutatie.
MUTATIE
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
}
}
}
Bereid een douane manifest voor voor zendingen naar de VS.
Geef Zonos de gegevens van inkomende postzendingen.Zonos zal uitgebreide douane manifesten voorbereiden die alle noodzakelijke informatie voor postzendingen naar de VS bevatten.