Siapkan permintaan
Membuat manifest memerlukan pengorganisasian data pengiriman Anda ke dalam struktur yang tepat. API menggunakan pendekatan hierarkis di mana Anda pertama-tama membuat manifest, kemudian menambahkan wadah, dan akhirnya mengisi setiap wadah dengan baris manifest yang berisi detail pengiriman.
Setiap komponen memiliki bidang yang diperlukan untuk memastikan kepatuhan bea cukai dan dokumentasi yang akurat. Di bawah ini kami telah menguraikan struktur data penting dan input yang diperlukan.
Jenis input kunci
API manifest menggunakan beberapa jenis input untuk mengorganisir data pengiriman:
ManifestInput: Informasi pengiriman tingkat tinggi termasuk bandara, jenis waybill, dan detail penerbanganManifestLineInput: Detail pengiriman individu dalam sebuah wadahManifestLineItemInput: Informasi produk untuk klasifikasi bea cukaiCreatePartyInput: Detail pihak dan lokasi untuk asal dan tujuan
Lihat definisi dan opsi bidang lengkap dalam referensi API GraphQL kami.
Buat manifest melalui API
Setelah Anda mengorganisir data pengiriman Anda, kirim mutasi GraphQL untuk membuat manifest.
Langkah 1: Buat header manifest
MUTASI
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
}
}
Langkah 2: Tambahkan baris manifest
Menggunakan ID yang dikembalikan dari mutasi manifestCreate, Anda sekarang dapat menghubungkan pengiriman individu ke manifest.
MUTASI
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
}
}
Langkah 3: Perbarui manifest
Jika rincian penerbangan telah berubah, Anda dapat memperbarui rincian manifest menggunakan mutasi berikut.
MUTASI
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
}
}
}
Siapkan manifest bea cukai untuk pengiriman ke AS.
Berikan Zonos data pengiriman pos masuk.Zonos akan menyiapkan manifest bea cukai yang komprehensif yang mencakup semua informasi yang diperlukan untuk pengiriman pos ke AS.