DOCS

Buat pengiriman

Landed Cost•
BerandaUntuk penyedia logistik Landed Cost Buat pengiriman

Buat pengiriman untuk pesanan yang ada

Buat pengiriman dan label dengan API Zonos setelah menghitung biaya yang ditanggung dan membuat pesanan.

GraphQL

Panduan ini dirancang untuk pengguna yang sudah terintegrasi dengan API Zonos dan perlu membuat pengiriman untuk pesanan yang ada dalam sistem mereka. Jika Anda adalah platform pengiriman dan ingin menawarkan pembuatan pengiriman Zonos kepada pelanggan Anda, lihat Panduan API Pengiriman.

Jika Anda terintegrasi dengan API Zonos dan disetujui untuk mengirim di luar Dashboard, gunakan mutasi shipmentCreateWorkflow untuk membuat pengiriman dan memberikan informasi pelacakan. Mutasi ini juga memungkinkan Anda untuk memberi tahu Zonos tentang pengiriman domestik ke fasilitas cross-docking.

Catatan: Jika Anda menggunakan aplikasi Duty and Tax dengan platform yang secara otomatis menyinkronkan nomor pelacakan ke Zonos, atau jika Anda mengirim langsung melalui Dashboard, mutasi ini tidak diperlukan.

Buat pengiriman melalui API 

Setelah menghitung Landed Cost dan membuat pesanan, Anda dapat mengirim nomor pelacakan dan detail pengiriman lainnya ke Zonos melalui API.

Gunakan alur kerja ini ketika Anda membuat pengiriman untuk pesanan yang ada dan tidak perlu memodifikasi detail item atau pihak. Ini mendukung nomor pelacakan opsional, pusat pemenuhan, pemilihan tingkat layanan, dan asuransi nilai yang dinyatakan.

Mutasi

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {
  shipmentCreateWorkflow(input: $input) {
    id
    status
    trackingDetails {
      number
    }
    serviceLevel {
      id
      name
      carrier {
        id
        name
      }
    }
    shipmentCartons {
      id
      carton {
        id
        width
        length
        height
        weight
        items {
          item {
            id
            amount
            description
          }
        }
      }
      label {
        url
        trackingNumber
        id
        documentFiling
      }
    }
  }
}

Variabel Dasar

1
2
3
4
5
6
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789abc"
  }
}

Dengan Pusat Pemenuhan

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789def",
    "fulfillmentCenter": "fulfillment_center_12345"
  }
}

Dengan Pelacakan Kustom

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": false,
    "orderId": "order_12345678-1234-1234-1234-123456789ghi",
    "trackingNumbers": ["tracking_example_1", "tracking_example_2"]
  }
}

Dengan Tingkat Layanan

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789jkl",
    "serviceLevel": "dhl.express_example"
  }
}

Dengan asuransi nilai yang dinyatakan

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789mno",
    "isDeclaredValue": true
  }
}

Nilai yang Dinyatakan

Set "isDeclaredValue": true untuk mengaktifkan perlindungan nilai yang dinyatakan untuk semua item dalam pengiriman Anda. Zonos secara otomatis mengklaim nilai penuh dari semua item yang diajukan dalam pesanan; pedagang tidak dapat mengubah jumlah ini. Ini menetapkan tanggung jawab maksimum yang akan diterima oleh pengangkut dalam hal kehilangan, kerusakan, atau pencurian selama pengiriman. Fitur ini hanya didukung untuk pengiriman UPS, FedEx, dan DHL. Zonos secara otomatis menangani implementasi spesifik pengangkut ketika Anda mengaktifkan nilai yang dinyatakan, termasuk parameter yang sesuai dalam panggilan API kami ke pengangkut ini, sehingga Anda tidak perlu mengelola persyaratan pengangkut yang berbeda.

Batasan UPS: UPS hanya mencakup nilai antara 100-50.000 USD dan memproses nilai yang dinyatakan di tingkat karton. Untuk pengiriman multi-karton, pedagang harus membagi pengiriman untuk menetapkan perlindungan per karton. UPS juga menghasilkan formulir asuransi tambahan yang harus dicetak bersama dengan label.

FedEx dan DHL: Memproses nilai yang dinyatakan di tingkat pengiriman tanpa batasan tambahan.

Batalkan pengiriman 

Untuk membatalkan label yang telah dibuat, gunakan mutasi berikut untuk membatalkan pengiriman. Label yang terkait juga akan dibatalkan secara otomatis. Perhatikan bahwa setelah pengiriman dibatalkan, pengiriman tersebut tidak dapat diperbarui atau dipulihkan.

Mutasi

1
2
3
4
5
6
7
8
9
10
11
12
mutation {
  shipmentStatusUpdate(
    input: {
      shipment: "shipment_12345678-1234-1234-1234-123456789stu"
      status: VOIDED
      note: "Voiding shipment"
    }
  ) {
    id
    status
  }
}

Apakah halaman ini bermanfaat?

Pesan demo
© 2025 Zonoszonos.com
Di halaman ini:
  • Buat pengiriman untuk pesanan yang ada
  • Buat pengiriman melalui API
  • Batalkan pengiriman