DOCS

Rating object

/
DomReferencja API API Oceny REST Obiekt oceny

Obiekt oceny

Zbadaj możliwości i funkcje obiektu oceny.

Obiekt oceny dostarczy wyceny wysyłki według poziomu usługi z podziałem na dopłaty, opłaty i negocjowane rate zniżki, które składają się na wycenę.

Atrybuty 

PoleUwagi
id STRINGUnikalny identyfikator obiektu. Id dla obiektu oceny zawsze będzie poprzedzone ship.
currency HASHHash zawierający informacje o podstawowej walucie wysłanej w żądaniu i podanej w odpowiedzi.
currency.id STRINGUnikalny identyfikator obiektu waluty.
currency.base STRINGPodstawowa waluta wysłana w żądaniu oceny, reprezentowana przez trzyznakowy kod ISO. Wszystkie kwoty w obiekcie oceny są podane w podstawowej walucie.
currency.date TIMESTAMPData, w której waluta rate została pobrana, w formacie ISO 8601 YYYY-MM-DDTHH:mm:ss.sssZ.
currency.rates HASHHash zawierający waluty i kursy wymiany potrzebne do konwersji z podstawowej waluty.
errors HASHHash zawierający szczegóły wszelkich błędów w żądaniu.
errors.type STRINGŹródło błędu. Możliwe wartości to fedex_api ups_api dhl_api usps_api internal_error zonos_configuration.
errors.message STRINGOpisowy powód błędu od odpowiedniego przewoźnika.
errors.details HASHHash zawierający szczegóły dotyczące poziomu usługi, który zwrócił błąd.
errors.details.id STRINGUnikalny identyfikator poziomu usługi.
errors.details.service_level STRINGPoziom usługi u przewoźnika, np. standard.
errors.details.display_name STRINGNazwa wyświetlana dla poziomu usługi.
quotes LISTLista ofert wysyłkowych według poziomu usługi.
quotes.id STRINGUnikalny identyfikator obiektu. Id dla obiektu ofert zawsze będzie poprzedzone rtqt.
quotes.amount_subtotal DECIMALCałkowity obliczony koszt wysyłki dla poziomu usługi.
quotes.weight HASHHash zawierający informacje o wadze użytej do obliczenia kosztu wysyłki.
quotes.weight.billable DECIMALWaga do obliczenia kosztu wysyłki paczki.
quotes.weight.unit STRINGJednostka miary dla wagi. Możliwe wartości to pound, ounce, kilogram i null. Gdy null, używana będzie pound.
quotes.mode HASHHash zawierający szczegółowe informacje o poziomie usługi.
quotes.mode.service_level STRINGPoziom usługi u przewoźnika, np. standard. Typowe przykłady to: 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 oraz fedex_international_ground. Zobacz dokumentację przewoźników dla pełnej listy dostępnych poziomów usług według przewoźnika.
quotes.mode.display_name STRINGNazwa wyświetlana dla poziomu usługi.
quotes.mode.delivery_date_estimate TIMESTAMPSzacowana data dostawy dla poziomu usługi, w formacie ISO 8601 YYYY-MM-DDTHH:mm:ss.sssZ. Zostanie to zwrócone, jeśli jest dostępne z API przewoźnika.
quotes.mode.transit_business_days INTEGERSzacowana liczba dni tranzytowych dla poziomu usługi, licząc tylko dni robocze jako dni tranzytowe. Zostanie to zwrócone, jeśli jest dostępne z API przewoźnika.
quotes.mode.transit_days INTEGERSzacowana liczba dni tranzytowych dla poziomu usługi. Zostanie to zwrócone, jeśli jest dostępne z API przewoźnika.
quotes.mode.rates HASHHash zawierający szczegółowe informacje na temat podziału kwoty za wysyłkę rate.
quotes.mode.rates.amount DECIMALKwota konkretnego elementu rate.
quotes.mode.rates.note STRINGDodatkowe szczegóły dotyczące tego, co reprezentuje kwota elementu rate.
quotes.mode.rates.type STRINGTyp elementu rate. Możliwe wartości to retail_shipping fuel_surcharge carrier_fee negotiated_discount.
quotes.packages LISTLista szczegółów dotyczących paczek, które są wysyłane.
quotes.packages.id STRINGUnikalny identyfikator obiektu paczek.
quotes.packages.weight HASHHash zawierający szczegóły dotyczące wagi paczki.
quotes.packages.weight.billable DECIMALWaga do obliczenia kosztów paczki.
quotes.packages.weight.dimensional DECIMALWaga wymiarowa paczki.
quotes.packages.weight.factor INTEGERMiędzynarodowy współczynnik wagi używany do obliczenia wagi wymiarowej paczki.
quotes.packages.weight.weight_unit STRINGCiąg z jednostką miary dla wagi. Możliwe wartości to pound ounce kilogram null. Gdy null, używana będzie pound.

Przykładowa odpowiedź

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

Czy ta strona była pomocna?

Zobacz Zonos

polityki i umowy
© 2024 Zonoszonos.com
Na tej stronie:
  • Obiekt oceny
  • Atrybuty