DOCS

Request a shipment rating

/

Begär en fraktbedömning

Utforska nyckel/värde-par i en fraktbedömningsbegäran.

Begär internationella fraktpriser för olika fraktleverantörer som är konfigurerade i din butiks inställningar inom Zonos.

Attribut 

JSON nyckel/värde-par i begärningskroppen

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

HEADER zonos-version: 2020-03-04

Headern ovan är en obligatorisk inmatning för att denna bedömningsbegäran ska slutföras framgångsrikt.

FältAnteckningar
currency KRÄVSBasvaluta som sträng, representerad av en tre-bokstavs ISO-kod.
items_amount KRÄVSEtt decimaltal med ett antal artiklar.
packages KRÄVSEn lista över antalet och dimensionerna för de paket som skickas. hash
packages.id KRÄVSDen unika paketidentifieraren för handlaren eller exportören.
packages.dimensions KRÄVSDimensionerna för paketet. hash
packages.dimensions.height KRÄVSEtt decimaltal för höjden på fraktlådan.
packages.dimensions.length KRÄVSEtt decimaltal för längden på fraktlådan.
packages.dimensions.unit KRÄVSEnheten för mått på fraktlådans dimensioner. Möjliga värden är inch centimeter millimeter null. När null, kommer inch att användas.
packages.dimensions.width KRÄVSEtt decimaltal som innehåller bredden på fraktlådan.
packages.insured_amount VALFRIEtt decimaltal med försäkringsbeloppet.
packages.type VALFRIEn sträng för att specificera en specifik transportörs lådtyp som ska användas för fraktberäkningen. Möjliga värden inkluderar FEDEX_BOX
packages.weight KRÄVSEtt decimaltal som innehåller vikten på paketet.
packages.weight_unit KRÄVSEn sträng med enheten för vikt. Möjliga värden är pound ounce kilogram null. När null, kommer pound att användas.
pickup_date KRÄVSDet begärda upphämtningsdatumet för paketet, i ISO 8601-formatet YYYY-MM-DDTHH:mm:ss.sssZ. UTC antas när ingen tidszonsinformation anges.
service_level VALFRIServicenivån med transportören, t.ex. standard. hash Vanliga exempel inkluderar: 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, och fedex_international_ground Se transportörens dokumentation för hela listan över tillgängliga servicenivåer per transportör.
ship_from KRÄVSAvsändaradressen. hash
ship_from.cityEn sträng för adressens stad, ort, distrikt, förort eller by för avsändaradressen.
ship_from.country KRÄVSAvsändarlandets sträng, representerad av en två-bokstavs ISO-kod.
ship_from.postal_code KRÄVSEn sträng för avsändaradressens postnummer.
ship_from.state_code KRÄVSEn sträng för avsändaradressen när det är tillgängligt. Endast krävs i Kanada och Brasilien.
ship_to KRÄVSLeveransadressen. hash
ship_to.city KRÄVSEn sträng för adressens stad, ort, distrikt, förort eller by för kunden.
ship_to.country KRÄVSEn sträng för destinationslandet, representerad av en två-bokstavs ISO-kod.
ship_to.postal_code KRÄVSEn sträng för destinationspostnumret. Valfritt beroende på importlandet.
ship_to.state_code KRÄVSEn sträng för destinationsstatkoden när den finns tillgänglig. Endast krävs i Kanada och Brasilien.
ship_to.type KRÄVSTypen av destinationsadressen. Möjliga värden inkluderar residential commercial.

Exempel på begäran

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

Exempel på svar

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

Var den här sidan hjälpsam?