Å 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 flydetaljer
ManifestLineInput: Individuelle forsendelsesdetaljer knyttet til en deklarasjon
ManifestLineItemInput: Produktinformasjon for tollklassifisering
CreatePartyInput: Part- og stedsinformasjon for opprinnelse og bestemmelsessted
Se de komplette feltdefinisjonene og alternativene i vår GraphQL API-referanse.
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.
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.
{"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:
Forbered tolldeklarasjon
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.
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 bestemmelsesstedSe 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) {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": [] } } } }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) {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 } } }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 egetparties-array for å definere forsendelsens opprinnelse og bestemmelsessted.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" } ] } }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) {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" } ] } } }Datakildeverdier
source-feltet iManifestUpdateInputgodtar følgende verdier:CARDITPRECONPREDESRESDITVar denne siden nyttig?