DOCS

Request a shipment rating

/

Bir gönderim derecelendirmesi isteyin

Bir gönderim derecelendirme isteğindeki anahtar/değer çiftlerini keşfedin.

Farklı nakliye sağlayıcıları için uluslararası nakliye ücretlerini isteyin, bunlar mağazanızın ayarlarında Zonos içinde yapılandırılmıştır.

Özellikler 

İstek gövdesindeki JSON anahtar/değer çiftleri

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

HEADER zonos-version: 2020-03-04

Yukarıdaki başlık, bu derecelendirme isteğinin başarılı bir şekilde tamamlanması için gerekli bir girdi.

AlanNotlar
currency GEREKENTemel para birimi dizesi, üç harfli ISO kodu ile temsil edilir.
items_amount GEREKENBir öğe miktarı ile ondalık.
packages GEREKENGönderilen paketlerin sayısı ve boyutları için bir liste. hash
packages.id GEREKENTüccar veya ihracatçı için benzersiz paket tanımlayıcısı.
packages.dimensions GEREKENPaketin boyutları. hash
packages.dimensions.height GEREKENGönderim kutusunun yüksekliği için bir ondalık.
packages.dimensions.length GEREKENGönderim kutusunun uzunluğu için bir ondalık.
packages.dimensions.unit GEREKENGönderim kutusu boyutları için ölçü birimi. Olası değerler inch centimeter millimeter null. null olduğunda, inch kullanılacaktır.
packages.dimensions.width GEREKENGönderim kutusunun genişliğini içeren bir ondalık.
packages.insured_amount İSTEĞE BAĞLISigorta miktarı ile ondalık.
packages.type İSTEĞE BAĞLIGönderim hesaplaması için kullanılacak belirli bir taşıyıcı kutu türünü belirtmek için bir dize. Olası değerler arasında FEDEX_BOX bulunmaktadır.
packages.weight GEREKENPaketin ağırlığını içeren bir ondalık.
packages.weight_unit GEREKENAğırlık için ölçü birimi ile bir dize. Olası değerler pound ounce kilogram null. null olduğunda, pound kullanılacaktır.
pickup_date GEREKENPaketin alınması için talep edilen tarih, ISO 8601 formatında YYYY-MM-DDTHH:mm:ss.sssZ. Zaman dilimi bilgisi verilmediğinde UTC varsayılmaktadır.
service_level İSTEĞE BAĞLITaşıyıcı ile hizmet seviyesi, örneğin standard. hash Yaygın örnekler arasında: 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, ve fedex_international_ground bulunmaktadır. Taşıyıcıya göre mevcut hizmet seviyelerinin tam listesi için taşıyıcı belgelerine bakın.
ship_from GEREKENGönderim adresi. hash
ship_from.cityKaynak adresinin şehir, kasaba, ilçe, banliyö veya köyü için bir dize.
ship_from.country GEREKENKaynak ülke dizesi, iki harfli ISO kodu ile temsil edilir.
ship_from.postal_code GEREKENKaynak adresinin posta kodu için bir dize.
ship_from.state_code GEREKENMümkünse kaynak adresi için bir dize. Sadece Kanada ve Brezilya'da gereklidir.
ship_to GEREKENVarış adresi. hash
ship_to.city GEREKENMüşterinin adresinin şehir, kasaba, ilçe, banliyö veya köyü için bir dize.
ship_to.country GEREKENVarış ülkesinin dizesi, iki harfli ISO kodu ile temsil edilir.
ship_to.postal_code GEREKENHedef posta kodu için bir dize. İthalat ülkesine bağlı olarak isteğe bağlıdır.
ship_to.state_code GEREKENMevcut olduğunda hedef eyalet kodu için bir dize. Sadece Kanada ve Brezilya'da gereklidir.
ship_to.type GEREKENHedef adresin türü. Olası değerler arasında residential commercial bulunmaktadır.

Örnek istek

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"
  }
}

Örnek yanıt

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"
          }
        }
      ]
    }
  ]
}

Bu sayfa yardımcı oldu mu?