Alcohol Shipments
Shippo supports creating labels for shipping alcohol by specifying options in the extras
field of the Shipment object.
Creating an Alcohol Shipment
To create a label for a shipment that will contain alcohol, you will need to specify options in the Shipment extra
field.
In the response you’ll get your usual Shipment object with all of the available rates for your alcohol shipment.
{
"address_from": {
"city": "San Francisco",
"company": "",
"country": "US",
"is_complete": false,
"is_residential": null,
"name": "Mr Hippo",
"object_id": "b631001acb534e2bbf7cea94adfd2d00",
"phone": "4151234567",
"state": "CA",
"street1": "965 Mission St",
"street2": "APT 572",
"street3": "",
"street_no": "",
"test": true,
"validation_results": [],
"zip": "94103"
},
"address_return": {
"city": "San Francisco",
"company": "",
"country": "US",
"is_complete": false,
"is_residential": null,
"name": "Mr Hippo",
"object_id": "b631001acb534e2bbf7cea94adfd2d00",
"phone": "4151234567",
"state": "CA",
"street1": "965 Mission St",
"street2": "APT 572",
"street3": "",
"street_no": "",
"test": true,
"validation_results": [],
"zip": "94103"
},
"address_to": {
"city": "Brooklyn",
"company": "",
"country": "US",
"is_complete": false,
"is_residential": null,
"name": "Billy Bob",
"object_id": "13d8b016de1c4befbdff900cd05ad2da",
"phone": "4151234567",
"state": "NY",
"street1": "206 1ST ST",
"street2": "STE 202",
"street3": "",
"street_no": "",
"test": true,
"validation_results": [],
"zip": "11232"
},
"carrier_accounts": [
"078870331023437cb917f5187429b093"
],
"customs_declaration": null,
"extra": {
"alcohol": {
"contains_alcohol": true,
"recipient_type": "licensee"
}
},
"messages": [],
"metadata": "",
"object_created": "2017-08-03T17:54:54.006Z",
"object_id": "5e40ead7cffe4cc1ad45108696162e42",
"object_owner": "shippotle@goshippo.com",
"object_updated": "2017-08-03T17:54:54.006Z",
"parcels": [
{
"distance_unit": "in",
"extra": [],
"height": "3.0000",
"length": "10.0000",
"line_items": [],
"mass_unit": "lb",
"metadata": "",
"object_created": "2017-08-03T17:54:53.976Z",
"object_id": "6fb5951a0900439b8770bc1814ee5528",
"object_owner": "shippotle@goshippo.com",
"object_state": "VALID",
"object_updated": "2017-08-03T17:54:54.024Z",
"template": null,
"test": true,
"value_amount": null,
"value_currency": null,
"weight": "1.0000",
"width": "3.0000"
}
],
"rates": [
{
"amount": "14.16",
"amount_local": "14.16",
"arrives_by": null,
"attributes": [
"BESTVALUE",
"CHEAPEST",
"FASTEST"
],
"carrier_account": "078870331023437cb917f5187429b093",
"currency": "USD",
"currency_local": "USD",
"duration_terms": "",
"estimated_days": 5,
"messages": [],
"object_created": "2017-08-03T17:54:56.057Z",
"object_id": "d870ae7efc7c45eabf097986d45d4f09",
"object_owner": "shippotle@goshippo.com",
"provider": "FedEx",
"provider_image_200": "https://shippo-static.s3.amazonaws.com/providers/200/FedEx.png",
"provider_image_75": "https://shippo-static.s3.amazonaws.com/providers/75/FedEx.png",
"servicelevel": {
"name": "Ground",
"terms": "",
"token": "fedex_ground"
},
"shipment": "6781b0124d2d4f8cbdd24bd589c61460",
"test": true,
"zone": "8"
}
],
"shipment_date": "2017-08-03T17:54:53.975Z",
"status": "SUCCESS"
}
Create an Alcohol Shipment Label
You can then use any rate object_id
that was returned to create a transaction and get your shipping label:
Your transaction response will look the same as any other shipment:
{
"commercial_invoice_url": null,
"eta": null,
"label_url": "https://shippo-delivery-east.s3.amazonaws.com/fe52964dbfe449efb6210f0caa9fdee8.pdf?Signature=aF9ujJ%2BOV5pJc24XoTuKeBmfJCQ%3D&Expires=1385930652&AWSAccessKeyId=AKIAJTHP3LLFMYAWALIA",
"messages": [],
"metadata": "",
"object_created": "2017-08-03T17:55:44.347Z",
"object_id": "fe52964dbfe449efb6210f0caa9fdee8",
"object_owner": "shippotle@goshippo.com",
"object_state": "VALID",
"object_updated": "2017-08-03T17:55:46.086Z",
"order": null,
"parcel": "6fb5951a0900439b8770bc1814ee5528",
"rate": "d870ae7efc7c45eabf097986d45d4f09",
"status": "SUCCESS",
"test": false,
"tracking_number": "794609767977",
"tracking_status": "UNKNOWN",
"tracking_url_provider": "https://www.fedex.com/apps/fedextrack/?action=track&cntry_code=us&trackingnumber=794609767977"
}
Supported Carriers & Services
The following carriers services are supported for alcohol shipments.
FedEx
- Ground
- Home Delivery
- Express Saver
- 2 Day
- 2 Day A.M.
- Standard Overnight
- Priority Overnight
- First Overnight