DOCS

Request a shipment rating

/

Vraag een verzendbeoordeling aan

Verken de sleutel/waarde paren in een verzendbeoordeling aanvraag.

Vraag internationale verzendtarieven aan voor verschillende verzendproviders die zijn geconfigureerd in de instellingen van uw winkel binnen Zonos.

Attributen 

JSON sleutel/waarde paren in de aanvraagbody

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

HEADER zonos-version: 2020-03-04

De bovenstaande header is een vereiste invoer voor deze beoordelingsaanvraag om succesvol te voltooien.

VeldNotities
currency VERPLICHTDe basisvaluta string, weergegeven door een drieletterige ISO-code.
items_amount VERPLICHTEen decimaal met een aantal artikelen.
packages VERPLICHTEen lijst van het aantal en de afmetingen van de pakketten die worden verzonden. hash
packages.id VERPLICHTDe unieke pakketidentificatie voor de handelaar of exporteur.
packages.dimensions VERPLICHTDe afmetingen van het pakket. hash
packages.dimensions.height VERPLICHTEen decimaal voor de hoogte van de verzenddoos.
packages.dimensions.length VERPLICHTEen decimaal voor de lengte van de verzenddoos.
packages.dimensions.unit VERPLICHTDe eenheid van meting voor de afmetingen van de verzenddoos. Mogelijke waarden zijn inch centimeter millimeter null. Wanneer null, wordt inch gebruikt.
packages.dimensions.width VERPLICHTEen decimaal met de breedte van de verzenddoos.
packages.insured_amount OPTIONEELEen decimaal met het verzekeringsbedrag.
packages.type OPTIONEELEen string om een specifiek type vervoersdoos te specificeren dat moet worden gebruikt voor de verzendberekening. Mogelijke waarden zijn FEDEX_BOX
packages.weight VERPLICHTEen decimaal met het gewicht van het pakket.
packages.weight_unit VERPLICHTEen string met de eenheid van meting voor het gewicht. Mogelijke waarden zijn pound ounce kilogram null. Wanneer null, wordt pound gebruikt.
pickup_date VERPLICHTDe gevraagde ophaaldatum voor het pakket, in het ISO 8601-formaat YYYY-MM-DDTHH:mm:ss.sssZ. UTC wordt aangenomen wanneer er geen tijdzone-informatie wordt doorgegeven.
service_level OPTIONEELHet service_level met de vervoerder, bijv. standard. hash Veelvoorkomende voorbeelden zijn: 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, en fedex_international_ground. Zie de vervoerdersdocumentatie voor de volledige lijst van beschikbare serviceniveaus per vervoerder.
ship_from VERPLICHTHet verzendadres. hash
ship_from.cityEen string voor de stad, het dorp, het district, de buitenwijk of het dorp van het verzendadres.
ship_from.country VERPLICHTDe landstring van de oorsprong, weergegeven door een tweeletterige ISO-code.
ship_from.postal_code VERPLICHTEen string voor de postcode van het verzendadres.
ship_from.state_code VERPLICHTEen string voor het verzendadres wanneer beschikbaar. Alleen vereist in Canada en Brazilië.
ship_to VERPLICHTHet bestemmingsadres. hash
ship_to.city VERPLICHTEen string voor de stad, het dorp, het district, de buitenwijk of het dorp van de klant.
ship_to.country VERPLICHTEen string voor het bestemmingsland, weergegeven door een tweeletterige ISO-code.
ship_to.postal_code VERPLICHTEen string voor de bestemmingspostcode. Optioneel, afhankelijk van het importland.
ship_to.state_code VERPLICHTEen string voor de bestemmingsstaatcode wanneer beschikbaar. Alleen vereist in Canada en Brazilië.
ship_to.type VERPLICHTHet type van het bestemmingsadres. Mogelijke waarden zijn residential commercial.

Voorbeeldverzoek

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

Voorbeeldreactie

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

Was deze pagina nuttig?