Bereiten Sie die Anfrage vor
Die Erstellung eines Manifests erfordert die Organisation Ihrer Versanddaten in die richtige Struktur. Die API verwendet einen hierarchischen Ansatz, bei dem Sie zuerst das Manifest erstellen, dann Behälter hinzufügen und schließlich jeden Behälter mit Manifestzeilen füllen, die Versanddetails enthalten.
Jede Komponente hat spezifische erforderliche Felder, um die Zollkonformität und die genaue Dokumentation sicherzustellen. Im Folgenden haben wir die wesentliche Datenstruktur und die erforderlichen Eingaben skizziert.
Wichtige Eingabetypen
Die Manifest-API verwendet mehrere Eingabetypen, um Versanddaten zu organisieren:
ManifestInput: Hochrangige Versandinformationen einschließlich Flughäfen, Frachtbrieftyp und FlugdatenManifestLineInput: Einzelne Versanddetails innerhalb eines BehältersManifestLineItemInput: Produktinformationen zur ZollklassifizierungCreatePartyInput: Parteien- und Standortdetails für Ursprung und Ziel
Sehen Sie sich die vollständigen Felddefinitionen und Optionen in unserem GraphQL-API Referenz an.
Erstellen Sie ein Manifest über die API
Sobald Sie Ihre Versanddaten organisiert haben, senden Sie die GraphQL-Mutation, um das Manifest zu erstellen.
Schritt 1: Erstellen Sie den Manifestkopf
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
}
}
Schritt 2: Manifestzeilen hinzufügen
Mit der ID, die von der manifestCreate-Mutation zurückgegeben wird, können Sie nun einzelne Sendungen mit dem Manifest verknüpfen.
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
}
}
Schritt 3: Manifest aktualisieren
Falls sich die Flugdaten geändert haben, können Sie die Manifestdetails mit der folgenden Mutation aktualisieren.
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
}
}
}
Bereiten Sie ein Zollmanifest für US-Sendungen vor.
Stellen Sie Zonos die Daten zu eingehenden Postsendungen zur Verfügung.
Zonos wird umfassende Zollmanifesten erstellen, die alle notwendigen Informationen für Postsendungen in die USA enthalten.