DOCS

Request a shipment rating

/

Be om en fraktvurdering

Utforsk nøkkel/verdi-parene i en fraktvurderingsforespørsel.

Be om internasjonale fraktpriser for ulike fraktleverandører som er konfigurert i innstillingene til butikken din innen Zonos.

Attributter 

JSON nøkkel/verdi-par i forespørselens kropp

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

HEADER zonos-version: 2020-03-04

Headeren ovenfor er et obligatorisk input for at denne vurderingsforespørselen skal fullføres med suksess.

FeltNotater
currency PÅKREVDBasisvaluta-strengen, representert med en tre-bokstavers ISO-kode.
items_amount PÅKREVDEt desimaltall med antall varer.
packages PÅKREVDEn liste over antall og dimensjoner for pakkene som sendes. hash
packages.id PÅKREVDDen unike pakkeidentifikatoren for selgeren eller eksportøren.
packages.dimensions PÅKREVDDimensjonene for pakken. hash
packages.dimensions.height PÅKREVDEt desimaltall for høyden på fraktboksen.
packages.dimensions.length PÅKREVDEt desimaltall for lengden på fraktboksen.
packages.dimensions.unit PÅKREVDMåleenheten for dimensjonene til fraktboksen. Mulige verdier er inch centimeter millimeter null. Når null, vil inch bli brukt.
packages.dimensions.width PÅKREVDEt desimaltall som inneholder bredden på fraktboksen.
packages.insured_amount VALGFRIEt desimaltall med forsikringsbeløpet.
packages.type VALGFRIEn streng for å spesifisere en spesifikk transportørboks type som skal brukes for fraktberegningen. Mulige verdier inkluderer FEDEX_BOX
packages.weight PÅKREVDEt desimaltall som inneholder vekten av pakken.
packages.weight_unit PÅKREVDEn streng med måleenheten for vekten. Mulige verdier er pound ounce kilogram null. Når null, vil pound bli brukt.
pickup_date PÅKREVDDen forespurte hentedatoen for pakken, i ISO 8601-formatet YYYY-MM-DDTHH:mm:ss.sssZ. UTC antas når ingen tidssoneinformasjon er gitt.
service_level VALGFRIService nivået med transportøren, f.eks. standard. hash Vanlige eksempler inkluderer: 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, og fedex_international_ground. Se transportørdokumentene for den fullstendige listen over tilgjengelige service nivåer per transportør.
ship_from PÅKREVDAvsenderadresse. hash
ship_from.cityEn streng for by, tettsted, distrikt, forstad eller landsby for avsenderadressen.
ship_from.country PÅKREVDAvsenderlandet, representert med en to-bokstavers ISO-kode.
ship_from.postal_code PÅKREVDEn streng for postnummeret til avsenderadressen.
ship_from.state_code PÅKREVDEn streng for avsenderadressen når tilgjengelig. Kun påkrevd i Canada og Brasil.
ship_to PÅKREVDMottaksadresse. hash
ship_to.city PÅKREVDEn streng for by, tettsted, distrikt, forstad eller landsby for kunden.
ship_to.country PÅKREVDEn streng for destinasjonslandet, representert med en to-bokstavers ISO-kode.
ship_to.postal_code PÅKREVETEn streng for destinasjons postnummer. Valgfritt avhengig av importlandet.
ship_to.state_code PÅKREVETEn streng for destinasjons statskode når tilgjengelig. Kun påkrevd i Canada og Brasil.
ship_to.type PÅKREVETTypen av destinasjonsadressen. Mulige verdier inkluderer residential commercial.

Eksempel på forespørsel

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

Eksempelrespons

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 denne siden nyttig?