DOCS

Request a shipment rating

/
ДомойСправочник API API оценки REST Запрос оценки отправки

Запрос оценки отправки

Изучите пары ключ/значение в запросе на оценку отправки.

Запросите международные тарифы на доставку от различных поставщиков доставки, которые настроены в параметрах вашего магазина в Zonos.

Атрибуты 

Пары ключ/значение JSON в теле запроса

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

HEADER zonos-version: 2020-03-04

Заголовок выше является обязательным для успешного завершения этого запроса на оценку.

ПолеЗаметки
currency ОБЯЗАТЕЛЬНОСтрока базовой валюты, представленная трехбуквенным ISO кодом.
items_amount ОБЯЗАТЕЛЬНОДесятичное число с количеством предметов.
packages ОБЯЗАТЕЛЬНОСписок количества и размеров отправляемых пакетов. hash
packages.id ОБЯЗАТЕЛЬНОУникальный идентификатор пакета для продавца или экспортера.
packages.dimensions ОБЯЗАТЕЛЬНОРазмеры пакета. hash
packages.dimensions.height ОБЯЗАТЕЛЬНОДесятичное число для высоты коробки для отправки.
packages.dimensions.length ОБЯЗАТЕЛЬНОДесятичное число для длины коробки для отправки.
packages.dimensions.unit ОБЯЗАТЕЛЬНОЕдиница измерения для размеров коробки для отправки. Возможные значения: дюйм сантиметр миллиметр null. При null будет использоваться дюйм.
packages.dimensions.width ОБЯЗАТЕЛЬНОДесятичное число, содержащее ширину коробки для отправки.
packages.insured_amount НЕОБЯЗАТЕЛЬНОДесятичное число с суммой страховки.
packages.type НЕОБЯЗАТЕЛЬНОСтрока для указания конкретного типа коробки перевозчика, который будет использоваться для расчета доставки. Возможные значения включают FEDEX_BOX
packages.weight ОБЯЗАТЕЛЬНОДесятичное число, содержащее вес пакета.
packages.weight_unit ОБЯЗАТЕЛЬНОСтрока с единицей измерения для веса. Возможные значения: фунт унция килограмм null. При null будет использоваться фунт.
pickup_date ОБЯЗАТЕЛЬНОЗапрашиваемая дата забора пакета в формате ISO 8601 YYYY-MM-DDTHH:mm:ss.sssZ. Предполагается UTC, если информация о временной зоне не передана.
service_level НЕОБЯЗАТЕЛЬНОУровень сервиса с перевозчиком, например, стандартный. hash Общие примеры включают: 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, и fedex_international_ground. См. документацию перевозчика для полного списка доступных уровней сервиса по перевозчику.
ship_from ОБЯЗАТЕЛЬНОАдрес отправления. hash
ship_from.cityСтрока для города, населенного пункта, района, пригородного района или деревни адреса отправления.
ship_from.country ОБЯЗАТЕЛЬНОСтрока страны отправления, представленная двухбуквенным ISO кодом.
ship_from.postal_code ОБЯЗАТЕЛЬНОСтрока для почтового кода адреса отправления.
ship_from.state_code ОБЯЗАТЕЛЬНОСтрока для адреса отправления, если доступно. Требуется только в Канаде и Бразилии.
ship_to ОБЯЗАТЕЛЬНОАдрес назначения. hash
ship_to.city ОБЯЗАТЕЛЬНОСтрока для города, населенного пункта, района, пригородного района или деревни клиента.
ship_to.country ОБЯЗАТЕЛЬНОСтрока для страны назначения, представленная двухбуквенным ISO кодом.
ship_to.postal_code ОБЯЗАТЕЛЬНОСтрока для почтового кода назначения. Необязательно в зависимости от страны импорта.
ship_to.state_code ОБЯЗАТЕЛЬНОСтрока для кода штата назначения, если он доступен. Обязательно только в Канаде и Бразилии.
ship_to.type ОБЯЗАТЕЛЬНОТип адреса назначения. Возможные значения включают residential commercial.

Пример запроса

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

Пример ответа

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

Была ли эта страница полезной?

© 2024 Zonoszonos.com
На этой странице: