DOCS

Request a shipment rating

/

Permintaan penilaian pengiriman

Jelajahi pasangan kunci/nilai dalam permintaan penilaian pengiriman.

Permintaan tarif pengiriman internasional untuk berbagai penyedia pengiriman yang dikonfigurasi dalam pengaturan toko Anda di dalam Zonos.

Atribut 

Pasangan kunci/nilai JSON dalam badan permintaan

POST | https://api.zonos.com/v1/shipment_rating

HEADER zonos-version: 2020-03-04

Header di atas adalah input yang diperlukan agar permintaan penilaian ini dapat diselesaikan dengan sukses.

FieldNotes
currency REQUIREDString mata uang dasar, yang diwakili oleh kode ISO tiga huruf.
items_amount REQUIREDDesimal dengan jumlah item.
packages REQUIREDDaftar jumlah dan dimensi untuk paket yang dikirim. hash
packages.id REQUIREDPengidentifikasi paket unik untuk pedagang atau eksportir.
packages.dimensions REQUIREDDimensi untuk paket. hash
packages.dimensions.height REQUIREDDesimal untuk tinggi kotak pengiriman.
packages.dimensions.length REQUIREDDesimal untuk panjang kotak pengiriman.
packages.dimensions.unit REQUIREDSatuan pengukuran untuk dimensi kotak pengiriman. Nilai yang mungkin adalah inch centimeter millimeter null. Ketika null, inch akan digunakan.
packages.dimensions.width REQUIREDDesimal yang berisi lebar kotak pengiriman.
packages.insured_amount OPTIONALDesimal dengan jumlah asuransi.
packages.type OPTIONALString untuk menentukan jenis kotak pengangkut tertentu yang akan digunakan untuk perhitungan pengiriman. Nilai yang mungkin termasuk FEDEX_BOX
packages.weight REQUIREDDesimal yang berisi berat paket.
packages.weight_unit REQUIREDString dengan satuan pengukuran untuk berat. Nilai yang mungkin adalah pound ounce kilogram null. Ketika null, pound akan digunakan.
pickup_date REQUIREDTanggal penjemputan yang diminta untuk paket, dalam format ISO 8601 YYYY-MM-DDTHH:mm:ss.sssZ. UTC dianggap ketika tidak ada informasi zona waktu yang diberikan.
service_level OPTIONALTingkat layanan dengan pengangkut, misalnya standard. hash Contoh umum termasuk: ups_express, ups_express_saver, ups_expedited, ups_economy, ups_standard, ups_mail_innovations_economy, ups_mail_innovations_priority, dhl_express, dhl_ecommerce_parcel_direct, fedex_priority, fedex_economy, usps_first_class_mail_international, usps_priority_mail_international, landmark_parcel, apc_parcel, point2point_standard, point2point_direct, point2point_packet, dan fedex_international_ground Lihat dokumentasi pengangkut untuk daftar lengkap tingkat layanan yang tersedia berdasarkan pengangkut.
ship_from REQUIREDAlamat asal. hash
ship_from.cityString untuk kota alamat, kota, distrik, pinggiran kota, atau desa dari alamat asal.
ship_from.country REQUIREDString negara asal, yang diwakili oleh kode ISO dua huruf.
ship_from.postal_code REQUIREDString untuk kode pos alamat asal.
ship_from.state_code REQUIREDString untuk alamat asal jika tersedia. Hanya diperlukan di Kanada dan Brasil.
ship_to REQUIREDAlamat tujuan. hash
ship_to.city REQUIREDString untuk kota alamat, kota, distrik, pinggiran kota, atau desa dari pelanggan.
ship_to.country REQUIREDString untuk negara tujuan, yang diwakili oleh kode ISO dua huruf.
ship_to.postal_code DIWAJIBKANSebuah string untuk kode pos tujuan. Opsional tergantung pada negara impor.
ship_to.state_code DIWAJIBKANSebuah string untuk kode negara bagian tujuan jika tersedia. Hanya diwajibkan di Kanada dan Brasil.
ship_to.type DIWAJIBKANJenis alamat tujuan. Nilai yang mungkin termasuk residential commercial.

Contoh permintaan

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
{
  "currency": "USD",
  "items_amount": 168.99,
  "packages": [
    {
      "id": "1",
      "dimensions": {
        "height": 19.0,
        "length": 15.0,
        "unit": "inch",
        "width": 15.0
      },
      "insured_amount": 33.22,
      "type": null,
      "weight": 32.0,
      "weight_unit": "pound"
    }
  ],
  "pickup_date": "2020-07-06T18:47:04.629+0000",
  "service_level": null,
  "ship_from": {
    "city": "St George",
    "country": "US",
    "postal_code": "84770",
    "state_code": "UT"
  },
  "ship_to": {
    "city": "Campinas",
    "country": "BR",
    "postal_code": "75828-000",
    "state_code": "SP",
    "type": "residential"
  }
}

Contoh respons

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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
{
  "id": "ship_5p67angIDnS91CyfpW55YZ",
  "currency": {
    "id": "curr_1Rp9lhXSRXvEWVs97k2PHE",
    "base": "USD",
    "date": "2020-02-04T18:47:04.629+0000",
    "rates": []
  },
  "errors": [
    {
      "details": {
        "id": "rtqt_7cz80Ny8dToSqoWlHTJJnP",
        "service_level": "FEDEX_EXPRESS_SAVER",
        "display_name": "FedEx Express Saver"
      },
      "message": "[868] Service is not allowed.  ",
      "type": "fedex_api"
    }
  ],
  "quotes": [
    {
      "id": "rtqt_4BUyxLEUeoU6zDdprCRoUV",
      "amount_subtotal": 943.18,
      "mode": {
        "delivery_date_estimate": null,
        "display_name": "UPS Expedited ",
        "rates": [
          {
            "amount": 848.31,
            "note": "UPS api: standard rate",
            "type": "retail_shipping"
          },
          {
            "amount": 64.4,
            "note": "UPS api: fuel surcharge",
            "type": "fuel_surcharge"
          },
          {
            "amount": 40.0,
            "note": "UPS api: extended area",
            "type": "carrier_fee"
          },
          {
            "amount": -9.53,
            "note": "UPS negotiated discount",
            "type": "negotiated_discount"
          }
        ],
        "service_level": "UPS_WORLDWIDE_EXPEDITED",
        "transit_business_days": null,
        "transit_days": null
      },
      "packages": [
        {
          "id": "1",
          "weight": {
            "billable": 32.0,
            "dimensional": 30.7554,
            "factor": 139,
            "weight_unit": "pound"
          }
        }
      ],
      "weight": {
        "billable": 32.0,
        "unit": "pound"
      }
    },
    {
      "id": "rtqt_1jyuPdiE5uIBcYzhO54DAb",
      "amount_subtotal": 1058.86,
      "weight": {
        "billable": 32.0,
        "unit": "pound"
      },
      "mode": {
        "delivery_date_estimate": null,
        "display_name": "UPS Saver ",
        "rates": [
          {
            "amount": 957.26,
            "note": "UPS api: standard rate",
            "type": "retail_shipping"
          },
          {
            "amount": 72.3,
            "note": "UPS api: fuel surcharge",
            "type": "fuel_surcharge"
          },
          {
            "amount": 40.0,
            "note": "UPS api: extended area",
            "type": "carrier_fee"
          },
          {
            "amount": -10.7,
            "note": "UPS negotiated discount",
            "type": "negotiated_discount"
          }
        ],
        "service_level": "UPS_SAVER",
        "transit_business_days": null,
        "transit_days": null
      },
      "packages": [
        {
          "id": "1",
          "weight": {
            "billable": 32.0,
            "dimensional": 30.7554,
            "factor": 139,
            "weight_unit": "pound"
          }
        }
      ]
    }
  ]
}

Apakah halaman ini membantu?