DOCS

Rating object

/

Đối tượng Đánh giá

Khám phá các khả năng và chức năng của đối tượng Đánh giá.

Đối tượng Đánh giá sẽ cung cấp báo giá vận chuyển theo cấp độ dịch vụ với sự phân tích các khoản phụ phí, phí và các khoản giảm giá rate đã thương lượng tạo nên báo giá.

Thuộc tính 

TrườngGhi chú
id STRINGĐịnh danh duy nhất cho đối tượng. Id cho đối tượng đánh giá sẽ luôn được tiền tố bằng ship.
currency HASHHash cung cấp thông tin về loại tiền tệ cơ sở được gửi trong yêu cầu và được cung cấp cho phản hồi.
currency.id STRINGĐịnh danh duy nhất cho đối tượng tiền tệ.
currency.base STRINGLoại tiền tệ cơ sở như đã gửi trong yêu cầu đánh giá, được đại diện bởi một mã ISO ba chữ cái. Tất cả các khoản tiền trong đối tượng đánh giá được liệt kê bằng loại tiền tệ cơ sở.
currency.date TIMESTAMPNgày mà tiền tệ rate được lấy, theo định dạng ISO 8601 YYYY-MM-DDTHH:mm:ss.sssZ.
currency.rates HASHHash chứa các loại tiền tệ và tỷ giá hối đoái cần thiết để chuyển đổi từ loại tiền tệ cơ sở.
errors HASHHash chứa chi tiết về bất kỳ lỗi nào trong yêu cầu.
errors.type STRINGNguồn gốc của lỗi. Các giá trị có thể bao gồm fedex_api ups_api dhl_api usps_api internal_error zonos_configuration.
errors.message STRINGLý do mô tả cho lỗi từ nhà vận chuyển tương ứng.
errors.details HASHHash chứa chi tiết về cấp dịch vụ đã trả về lỗi.
errors.details.id STRINGĐịnh danh duy nhất cho cấp dịch vụ.
errors.details.service_level STRINGCấp dịch vụ với nhà vận chuyển, ví dụ: standard.
errors.details.display_name STRINGTên hiển thị cho cấp dịch vụ.
quotes LISTDanh sách các báo giá vận chuyển theo cấp dịch vụ.
quotes.id STRINGĐịnh danh duy nhất cho đối tượng. Id cho đối tượng báo giá sẽ luôn được tiền tố bằng rtqt.
quotes.amount_subtotal DECIMALTổng chi phí vận chuyển được tính toán cho cấp dịch vụ.
quotes.weight HASHHash cung cấp thông tin về trọng lượng được sử dụng cho chi phí vận chuyển đã báo giá.
quotes.weight.billable DECIMALTrọng lượng tính phí của gói hàng được sử dụng cho báo giá vận chuyển.
quotes.weight.unit STRINGĐơn vị đo lường cho trọng lượng. Các giá trị có thể là pound, ounce, kilogram, và null. Khi null, pound sẽ được sử dụng.
quotes.mode HASHHash chứa thông tin chi tiết về cấp dịch vụ.
quotes.mode.service_level STRINGCấp dịch vụ với nhà vận chuyển, ví dụ: standard. Các ví dụ phổ biến bao gồm: 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, và fedex_international_ground. Xem tài liệu nhà vận chuyển để biết danh sách đầy đủ các cấp dịch vụ có sẵn theo nhà vận chuyển.
quotes.mode.display_name STRINGTên hiển thị cho cấp dịch vụ.
quotes.mode.delivery_date_estimate TIMESTAMPNgày ước lượng giao hàng cho cấp độ dịch vụ, trong định dạng ISO 8601 YYYY-MM-DDTHH:mm:ss.sssZ. Sẽ được trả về nếu có sẵn từ API của nhà vận chuyển.
quotes.mode.transit_business_days INTEGERSố ngày vận chuyển ước lượng cho cấp độ dịch vụ chỉ tính các ngày làm việc làm ngày vận chuyển. Sẽ được trả về nếu có sẵn từ API của nhà vận chuyển.
quotes.mode.transit_days INTEGERSố ngày vận chuyển ước lượng cho cấp độ dịch vụ. Sẽ được trả về nếu có sẵn từ API của nhà vận chuyển.
quotes.mode.rates HASHHash chứa thông tin chi tiết về phân tích cấp độ vận chuyển rate.
quotes.mode.rates.amount DECIMALSố tiền của mục cụ thể rate.
quotes.mode.rates.note STRINGChi tiết bổ sung về mục rate đại diện số tiền.
quotes.mode.rates.type STRINGLoại mục rate. Các giá trị có thể bao gồm retail_shipping fuel_surcharge carrier_fee negotiated_discount.
quotes.packages LISTMột danh sách chi tiết về các gói hàng đang được vận chuyển.
quotes.packages.id STRINGBộ nhận dạng duy nhất cho đối tượng gói hàng.
quotes.packages.weight HASHHash chứa chi tiết về trọng lượng cho gói hàng.
quotes.packages.weight.billable DEMICALTrọng lượng có thể tính của gói hàng.
quotes.packages.weight.dimensional DECIMALTrọng lượng kích thước của gói hàng.
quotes.packages.weight.factor INTEGERHệ số trọng lượng quốc tế được sử dụng để tính toán trọng lượng kích thước cho gói hàng.
quotes.packages.weight.weight_unit STRINGMột chuỗi với đơn vị đo lường cho trọng lượng. Các giá trị có thể là pound ounce kilogram null. Khi null, pound sẽ được sử dụng.

Ví dụ phản hồi

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",
        "display_name": "FedEx Express Saver",
        "service_level": "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,
      "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"
          }
        }
      ],
      "weight": {
        "billable": 32.0,
        "unit": "pound"
      }
    }
  ]
}

Trang này có hữu ích không?