DOCS

Request a shipment rating

/

Anmod om en forsendelsesvurdering

Udforsk nøgle/værdi-par i en forsendelsesvurderingsanmodning.

Anmod om internationale forsendelsespriser for forskellige forsendelsesudbydere, der er konfigureret i din butiks indstillinger inden for Zonos.

Attributter 

JSON nøgle/værdi-par i anmodningskroppen

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

HEADER zonos-version: 2020-03-04

Headeren ovenfor er et påkrævet input for at denne vurderingsanmodning kan gennemføres med succes.

FeltNoter
currency PÅKRÆVETDen grundlæggende valuta-streng, repræsenteret ved en tre-bogstavs ISO kode.
items_amount PÅKRÆVETEt decimal med et antal varer.
packages PÅKRÆVETEn liste over antallet og dimensionerne for de pakker, der sendes. hash
packages.id PÅKRÆVETDen unikke pakkeidentifikator for forhandleren eller eksportøren.
packages.dimensions PÅKRÆVETDimensionerne for pakken. hash
packages.dimensions.height PÅKRÆVETEt decimal for højden af forsendelsesboksen.
packages.dimensions.length PÅKRÆVETEt decimal for længden af forsendelsesboksen.
packages.dimensions.unit PÅKRÆVETMåleenheden for dimensionerne af forsendelsesboksen. Mulige værdier er inch centimeter millimeter null. Når null, vil inch blive brugt.
packages.dimensions.width PÅKRÆVETEt decimal, der indeholder bredden af forsendelsesboksen.
packages.insured_amount VALGFRITEt decimal med forsikringsbeløbet.
packages.type VALGFRITEn streng til at specificere en bestemt transportørboks type, der skal bruges til forsendelsesberegningen. Mulige værdier inkluderer FEDEX_BOX
packages.weight PÅKRÆVETEt decimal, der indeholder vægten af pakken.
packages.weight_unit PÅKRÆVETEn streng med måleenheden for vægten. Mulige værdier er pound ounce kilogram null. Når null, vil pound blive brugt.
pickup_date PÅKRÆVETDen ønskede afhentningsdato for pakken, i ISO 8601 formatet YYYY-MM-DDTHH:mm:ss.sssZ. UTC antages, når der ikke gives tidszoneinformation.
service_level VALGFRITService niveauet med transportøren, f.eks. standard. hash Almindelige 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ørdokumenterne for den fulde liste over tilgængelige service niveauer pr. transportør.
ship_from PÅKRÆVETAfsendelsesadressen. hash
ship_from.cityEn streng for by, by, distrikt, forstad eller landsby i afsendelsesadressen.
ship_from.country PÅKRÆVETDen oprindelige landsstreng, repræsenteret ved en to-bogstavs ISO kode.
ship_from.postal_code PÅKRÆVETEn streng for postnummeret i afsendelsesadressen.
ship_from.state_code PÅKRÆVETEn streng for afsendelsesadressen, når det er tilgængeligt. Kun påkrævet i Canada og Brasilien.
ship_to PÅKRÆVETModtageradressen. hash
ship_to.city PÅKRÆVETEn streng for by, by, distrikt, forstad eller landsby for kunden.
ship_to.country PÅKRÆVETEn streng for destinationslandet, repræsenteret ved en to-bogstavs ISO kode.
ship_to.postal_code PÅKRÆVETEn streng for destinations postnummer. Valgfrit afhængigt af importlandet.
ship_to.state_code PÅKRÆVETEn streng for destinations statskode når tilgængelig. Kun påkrævet i Canada og Brasilien.
ship_to.type PÅKRÆVETTypen af destinationsadressen. Mulige værdier inkluderer residential commercial.

Eksempel anmodning

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

Eksempel 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 denne side nyttig?