Siapkan permintaan
Membuat manifes memerlukan pengorganisasian data pengiriman Anda ke dalam struktur yang tepat. API menggunakan pendekatan hierarki di mana Anda terlebih dahulu membuat manifes, kemudian menambahkan baris manifes yang berisi detail pengiriman individu.
Setiap komponen memiliki bidang yang diperlukan secara khusus untuk memastikan kepatuhan bea cukai dan dokumentasi yang akurat. Di bawah ini kami telah menguraikan struktur data penting dan input yang diperlukan.
Tipe input kunci
API manifes menggunakan beberapa tipe input untuk mengorganisir data pengiriman:
ManifestInput: Informasi pengiriman tingkat tinggi termasuk bandara, jenis waybill, dan detail penerbanganManifestLineInput: Detail pengiriman individu yang terkait dengan manifesManifestLineItemInput: Informasi produk untuk klasifikasi bea cukaiCreatePartyInput: Detail pihak dan lokasi untuk asal dan tujuan
Lihat definisi bidang lengkap dan opsi di referensi API GraphQL kami.
Buat manifes melalui API
Setelah Anda mengorganisir data pengiriman Anda, kirim mutasi GraphQL untuk membuat manifes.
Langkah 1: Buat header manifes
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": []
}
}
}
}
Langkah 2: Tambahkan baris manifes
Menggunakan ID yang dikembalikan dari mutasi manifestCreate, Anda sekarang dapat menghubungkan pengiriman individu ke manifes.
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
}
}
}
Langkah 3: Tambahkan beberapa baris manifes (batch)
Untuk efisiensi, Anda dapat menambahkan beberapa baris manifes dalam satu permintaan menggunakan mutasi manifestLinesCreate. Setiap baris memerlukan array parties sendiri untuk menentukan asal dan tujuan pengiriman.
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"
}
]
}
}
Langkah 4: Perbarui manifes
Jika detail penerbangan telah berubah, Anda dapat memperbarui detail manifes menggunakan mutasi berikut. Bidang source diperlukan dan menunjukkan sumber data untuk pembaruan.
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"
}
]
}
}
}
Nilai sumber data
Bidang source dalam ManifestUpdateInput menerima nilai berikut:
| Nilai↕ | Deskripsi↕ |
|---|---|
CARDIT | Pertukaran data pembawa |
PRECON | Pemberitahuan pra-konsinyasi |
PREDES | Pemberitahuan pra-pengiriman |
RESDIT | Respons terhadap pengiriman |
Siapkan manifes bea cukai untuk pengiriman AS.
Berikan data pengiriman pos masuk kepada Zonos.Zonos akan menyiapkan manifes bea cukai komprehensif yang mencakup semua informasi yang diperlukan untuk pengiriman pos ke AS.