DOCS
BerandaUntuk penyedia logistik Pembawa & penjual kembali Siapkan manifes bea cukai

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.

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 penerbangan
  • ManifestLineInput: Detail pengiriman individu yang terkait dengan manifes
  • ManifestLineItemInput: Informasi produk untuk klasifikasi bea cukai
  • CreatePartyInput: 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

1mutation ManifestCreate($input: ManifestInput!) {
2 manifestCreate(input: $input) {
3 id
4 amount
5 arrivalDate
6 awbNumber
7 awbPrefix
8 carrierCode
9 createdAt
10 createdBy
11 destinationCode
12 operatorDestination
13 operatorOrigin
14 originCode
15 postalOperatorCode
16 serviceNumber
17 source
18 transportationMode
19 updatedAt
20 updatedBy
21 weight
22 weightUnit
23 statusTransitions {
24 createdAt
25 createdBy
26 note
27 source
28 }
29 lines(first: 5) {
30 totalCount
31 edges {
32 cursor
33 node {
34 id
35 trackingNumber
36 endUse
37 currencyCode
38 createdAt
39 createdBy
40 updatedAt
41 updatedBy
42 landedCost {
43 id
44 }
45 }
46 }
47 }
48 }
49}

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.

1mutation ManifestLineCreate($manifestId: ID!, $input: ManifestLineInput!) {
2 manifestLineCreate(manifestId: $manifestId, input: $input) {
3 id
4 manifestId
5 trackingNumber
6 endUse
7 currencyCode
8 referenceNumber
9 arrivalDate
10 createdAt
11 createdBy
12 updatedAt
13 updatedBy
14 landedCost {
15 id
16 }
17 }
18}

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.

1mutation ManifestLinesCreate($manifestId: ID!, $input: [ManifestLineInput!]!) {
2 manifestLinesCreate(manifestId: $manifestId, input: $input) {
3 id
4 manifestId
5 trackingNumber
6 endUse
7 currencyCode
8 createdAt
9 }
10}

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.

1mutation ManifestUpdate($id: ID!, $input: ManifestUpdateInput!) {
2 manifestUpdate(id: $id, input: $input) {
3 id
4 amount
5 arrivalDate
6 awbNumber
7 awbPrefix
8 carrierCode
9 createdAt
10 createdBy
11 destinationCode
12 operatorDestination
13 operatorOrigin
14 originCode
15 postalOperatorCode
16 serviceNumber
17 source
18 transportationMode
19 updatedAt
20 updatedBy
21 weight
22 weightUnit
23 statusTransitions {
24 createdAt
25 createdBy
26 note
27 source
28 }
29 }
30}

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↕
CARDITPertukaran data pembawa
PRECONPemberitahuan pra-konsinyasi
PREDESPemberitahuan pra-pengiriman
RESDITRespons terhadap pengiriman

Apakah halaman ini bermanfaat?

Dapatkan dukungan·Dokumen hukum·© 2026 Zonos
Di halaman ini:
  • Siapkan manifes bea cukai untuk pengiriman AS.
  • Siapkan permintaan
  • Buat manifes melalui API