Forbered forespørselen
Å opprette en deklarasjon krever at du organiserer forsendelsesdataene dine i riktig struktur. API-en bruker en hierarkisk tilnærming der du først oppretter deklarasjonen, deretter legger til deklarasjonslinjer som inneholder individuelle forsendelsesdetaljer.
Hver komponent har spesifikke påkrevde felt for å sikre tolloverholdelse og nøyaktig dokumentasjon. Nedenfor har vi skissert den essensielle datastrukturen og påkrevde inndata.
Nøkkelinputtyper
Deklarasjons-API-en bruker flere inndatatyper for å organisere forsendelsesdata:
ManifestInput: Informasjon på høyt nivå om forsendelse, inkludert flyplasser, fraktbrevtype og flydetaljerManifestLineInput: Individuelle forsendelsesdetaljer knyttet til en deklarasjonManifestLineItemInput: Produktinformasjon for tollklassifiseringCreatePartyInput: Part- og stedsinformasjon for opprinnelse og bestemmelsessted
Se de komplette feltdefinisjonene og alternativene i vår GraphQL API-referanse.
Opprett en deklarasjon via API
Når du har organisert forsendelsesdataene dine, sender du GraphQL-mutasjonen for å opprette deklarasjonen.
Trinn 1: Opprett deklarasjonshode
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 } } } } }}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": []
}
}
}
}
Trinn 2: Legg til deklarasjonslinjer
Ved å bruke ID-en returnert fra manifestCreate-mutasjonen, kan du nå lenke individuelle forsendelser til deklarasjonen.
mutation ManifestLineCreate($manifestId: ID!, $input: ManifestLineInput!) { manifestLineCreate(manifestId: $manifestId, input: $input) { id manifestId trackingNumber endUse currencyCode referenceNumber arrivalDate createdAt createdBy updatedAt updatedBy landedCost { 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
}
}
}
Trinn 3: Legg til flere deklarasjonslinjer (batch)
For effektivitet kan du legge til flere deklarasjonslinjer i en enkelt forespørsel ved hjelp av manifestLinesCreate-mutasjonen. Hver linje krever sitt eget parties-array for å definere forsendelsens opprinnelse og bestemmelsessted.
mutation ManifestLinesCreate($manifestId: ID!, $input: [ManifestLineInput!]!) { manifestLinesCreate(manifestId: $manifestId, input: $input) { id manifestId trackingNumber endUse currencyCode createdAt }}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"
}
]
}
}
Trinn 4: Oppdater deklarasjon
I tilfelle flydetaljer har endret seg, kan du oppdatere deklarasjonsdetaljer ved hjelp av følgende mutasjon. source-feltet er påkrevd og angir datakilden for oppdateringen.
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 } }}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"
}
]
}
}
}
Datakildeverdier
source-feltet i ManifestUpdateInput godtar følgende verdier:
| Verdi↕ | Beskrivelse↕ |
|---|---|
CARDIT | Datautveksling med transportør |
PRECON | Forhåndsmelding om forsendelse |
PREDES | Forhåndsmelding om avsending |
RESDIT | Svar på avsending |
Forbered en tolldeklarasjon for USA-forsendelser.
Gi Zonos informasjon om innkommende postforsendelser.Zonos vil forberede omfattende tolldeklarasjoner som inkluderer all nødvendig informasjon for postforsendelser til USA.