Alcohol Shipments

Shippo supports creating labels for shipping alcohol by specifying options in the extras field of the Shipment object.

Only currently supported using FedEx. Your FedEx account must be authorized for alcohol shipping in order to use this functionality.

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.

cURL 
                curl https://api.goshippo.com/shipments/ \
    -H "Authorization: ShippoToken shippo_test_831a7a042784f523b95db65444e6e084b636764b" \
    -d address_from="d799c2679e644279b59fe661ac8fa488" \
    -d address_to="42236bcf36214f62bcc6d7f12f02a849" \
    -d parcels=["7df2ecf8b4224763ab7c71fae7ec8274"] \
    -d extra='{"alcohol": {"contains_alcohol": true, "recipient_type": "consumer"}}' \
    -d async=false

In the response you’ll get your usual Shipment object with all of the available rates for your alcohol shipment.

{"carrier_accounts":["078870331023437cb917f5187429b093"],"object_created":"2017-08-03T17:54:54.006Z","object_updated":"2017-08-03T17:54:54.006Z","object_id":"5e40ead7cffe4cc1ad45108696162e42","object_owner":"shippotle@goshippo.com","status":"SUCCESS","address_from":{"object_id":"b631001acb534e2bbf7cea94adfd2d00","is_complete":false,"name":"Mr Hippo","company":"","street_no":"","street1":"965 Mission St","validation_results":[],"street2":"APT 572","street3":"","city":"San Francisco","state":"CA","zip":"94103","country":"US","phone":"4151234567","is_residential":null,"test":true},"address_to":{"object_id":"13d8b016de1c4befbdff900cd05ad2da","is_complete":false,"name":"Billy Bob","company":"","street_no":"","street1":"206 1ST ST","validation_results":[],"street2":"STE 202","street3":"","city":"Brooklyn","state":"NY","zip":"11232","country":"US","phone":"4151234567","is_residential":null,"test":true},"parcels":[{"object_state":"VALID","object_created":"2017-08-03T17:54:53.976Z","object_updated":"2017-08-03T17:54:54.024Z","object_id":"6fb5951a0900439b8770bc1814ee5528","object_owner":"shippotle@goshippo.com","template":null,"extra":[],"length":"10.0000","width":"3.0000","height":"3.0000","distance_unit":"in","weight":"1.0000","mass_unit":"lb","value_amount":null,"value_currency":null,"metadata":"","line_items":[],"test":true}],"shipment_date":"2017-08-03T17:54:53.975Z","address_return":{"object_id":"b631001acb534e2bbf7cea94adfd2d00","is_complete":false,"name":"Mr Hippo","company":"","street_no":"","street1":"965 Mission St","validation_results":[],"street2":"APT 572","street3":"","city":"San Francisco","state":"CA","zip":"94103","country":"US","phone":"4151234567","is_residential":null,"test":true},"customs_declaration":null,"extra":{"alcohol":{"contains_alcohol":true,"recipient_type":"licensee"}},"rates":[{"object_created":"2017-08-03T17:54:56.057Z","object_id":"d870ae7efc7c45eabf097986d45d4f09","object_owner":"shippotle@goshippo.com","shipment":"6781b0124d2d4f8cbdd24bd589c61460","attributes":["BESTVALUE","CHEAPEST","FASTEST"],"amount":"14.16","currency":"USD","amount_local":"14.16","currency_local":"USD","provider":"FedEx","provider_image_75":"https:\/\/shippo-static.s3.amazonaws.com\/providers\/75\/FedEx.png","provider_image_200":"https:\/\/shippo-static.s3.amazonaws.com\/providers\/200\/FedEx.png","servicelevel":{"name":"Ground","token":"fedex_ground","terms":""},"estimated_days":5,"arrives_by":null,"duration_terms":"","messages":[],"carrier_account":"078870331023437cb917f5187429b093","test":true,"zone":"8"}],"messages":[],"metadata":""}

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:

cURL 
                curl https://api.goshippo.com/transactions \
    -H "Authorization: ShippoToken shippo_test_831a7a042784f523b95db65444e6e084b636764b" \
    -d rate="cf6fea899f1848b494d9568e8266e076"
    -d label_file_type="PDF"
    -d async=false

FedEx returns two labels that both need to be placed on the shipment. You will only receive one label_url that is two pages long in the transaction object.

Your transaction response will look the same as any other shipment:

{"object_state":"VALID","status":"SUCCESS","object_created":"2017-08-03T17:55:44.347Z","object_updated":"2017-08-03T17:55:46.086Z","object_id":"fe52964dbfe449efb6210f0caa9fdee8","object_owner":"shippotle@goshippo.com","test":false,"rate":"d870ae7efc7c45eabf097986d45d4f09","tracking_number":"794609767977","tracking_status":"UNKNOWN","eta":null,"tracking_url_provider":"https:\/\/www.fedex.com\/apps\/fedextrack\/?action=track&cntry_code=us&trackingnumber=794609767977","label_url":"https:\/\/shippo-delivery-east.s3.amazonaws.com\/fe52964dbfe449efb6210f0caa9fdee8.pdf?Signature=aF9ujJ%2BOV5pJc24XoTuKeBmfJCQ%3D&Expires=1385930652&AWSAccessKeyId=AKIAJTHP3LLFMYAWALIA","commercial_invoice_url":null,"messages":[],"order":null,"metadata":"","parcel":"6fb5951a0900439b8770bc1814ee5528"}

The following service levels support alcohol shipping:

  Ground
Home Delivery
Express Saver
2 Day
2 Day A.M.
Standard Overnight
Priority Overnight
First Overnight

Get Started Today for Free!

Kick the tires on the best-in-class shipping platform with a free Shippo account.

Create a Free Account