Een manifest aanmaken vereist dat u zendingdata in de juiste structuur organiseert. De API gebruikt een hiërarchische aanpak: eerst het manifest aanmaken, daarna manifestregels met individuele zendingdetails toevoegen.
Elk onderdeel heeft specifieke verplichte velden voor douanecompliance en nauwkeurige documentatie. Hieronder staan de essentiële datastructuur en verplichte invoer.
Belangrijke invoertypes
De manifest-API gebruikt verschillende invoertypes om zendingdata te organiseren:
ManifestInput: High-level zendinginformatie, waaronder luchthavens, type vrachtbrief en vluchtgegevens
ManifestLineInput: Individuele zendingdetails gekoppeld aan een manifest
ManifestLineItemInput: Productinformatie voor douaneclassificatie
CreatePartyInput: Partij- en locatiegegevens voor herkomst en bestemming
Bekijk de volledige velddefinities en opties in onze GraphQL API-referentie.
Voor efficiëntie kunt u meerdere manifestregels in één verzoek toevoegen met de manifestLinesCreate-mutatie. Elke regel vereist een eigen parties-array om de herkomst en bestemming van de zending te definiëren.
Als vluchtgegevens zijn gewijzigd, kunt u manifestdetails bijwerken met de volgende mutatie. Het veld source is verplicht en geeft de databron voor de update aan.
{"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"}]}}}
Waarden voor databron
Het veld source in ManifestUpdateInput accepteert de volgende waarden:
Douanemanifest voorbereiden
Douanemanifest voorbereiden voor VS-zendingen.
Lever Zonos gegevens over binnenkomende postzendingen.Zonos bereidt uitgebreide douanemanifesten voor met alle benodigde informatie voor postzendingen naar de VS.
Het verzoek voorbereiden
Een manifest aanmaken vereist dat u zendingdata in de juiste structuur organiseert. De API gebruikt een hiërarchische aanpak: eerst het manifest aanmaken, daarna manifestregels met individuele zendingdetails toevoegen.
Elk onderdeel heeft specifieke verplichte velden voor douanecompliance en nauwkeurige documentatie. Hieronder staan de essentiële datastructuur en verplichte invoer.
Belangrijke invoertypes
De manifest-API gebruikt verschillende invoertypes om zendingdata te organiseren:
ManifestInput: High-level zendinginformatie, waaronder luchthavens, type vrachtbrief en vluchtgegevensManifestLineInput: Individuele zendingdetails gekoppeld aan een manifestManifestLineItemInput: Productinformatie voor douaneclassificatieCreatePartyInput: Partij- en locatiegegevens voor herkomst en bestemmingBekijk de volledige velddefinities en opties in onze GraphQL API-referentie.
Manifest aanmaken via API
Zodra u uw zendingdata hebt georganiseerd, stuurt u de GraphQL-mutatie om het manifest aan te maken.
Stap 1: Manifestheader aanmaken
mutation ManifestCreate($input: ManifestInput!) {manifestCreate(input: $input) {idamountarrivalDateawbNumberawbPrefixcarrierCodecreatedAtcreatedBydestinationCodeoperatorDestinationoperatorOriginoriginCodepostalOperatorCodeserviceNumbersourcetransportationModeupdatedAtupdatedByweightweightUnitstatusTransitions {createdAtcreatedBynotesource}lines(first: 5) {totalCountedges {cursornode {idtrackingNumberendUsecurrencyCodecreatedAtcreatedByupdatedAtupdatedBylandedCost {id}}}}}}RESPONSE
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": [] } } } }Stap 2: Manifestregels toevoegen
Met de ID uit de
manifestCreate-mutatie kunt u individuele zendingen aan het manifest koppelen.mutation ManifestLineCreate($manifestId: ID!, $input: ManifestLineInput!) {manifestLineCreate(manifestId: $manifestId, input: $input) {idmanifestIdtrackingNumberendUsecurrencyCodereferenceNumberarrivalDatecreatedAtcreatedByupdatedAtupdatedBylandedCost {id}}}RESPONSE
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 } } }Stap 3: Meerdere manifestregels toevoegen (batch)
Voor efficiëntie kunt u meerdere manifestregels in één verzoek toevoegen met de
manifestLinesCreate-mutatie. Elke regel vereist een eigenparties-array om de herkomst en bestemming van de zending te definiëren.mutation ManifestLinesCreate($manifestId: ID!, $input: [ManifestLineInput!]!) {manifestLinesCreate(manifestId: $manifestId, input: $input) {idmanifestIdtrackingNumberendUsecurrencyCodecreatedAt}}RESPONSE
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" } ] } }Stap 4: Manifest bijwerken
Als vluchtgegevens zijn gewijzigd, kunt u manifestdetails bijwerken met de volgende mutatie. Het veld
sourceis verplicht en geeft de databron voor de update aan.mutation ManifestUpdate($id: ID!, $input: ManifestUpdateInput!) {manifestUpdate(id: $id, input: $input) {idamountarrivalDateawbNumberawbPrefixcarrierCodecreatedAtcreatedBydestinationCodeoperatorDestinationoperatorOriginoriginCodepostalOperatorCodeserviceNumbersourcetransportationModeupdatedAtupdatedByweightweightUnitstatusTransitions {createdAtcreatedBynotesource}}}RESPONSE
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" } ] } } }Waarden voor databron
Het veld
sourceinManifestUpdateInputaccepteert de volgende waarden:CARDITPRECONPREDESRESDITWas deze pagina nuttig?