Create a Shipment
This endpoint is used for two purposes:
1. Generating standard Arta shipments
All standard shipments are actively facilitated by Arta. Working in tandem with our extensive logistics carrier network, Arta fulfills shipments with Premium
, Select
, and Parcel
quote types from scheduling collection, to coordinating packing, through delivery. For shipments with the Self Ship
quote type, Arta will generate labels on your behalf with commercial carriers such as FedEx, UPS, and DHL.
To book a standard Arta shipment, you must first create a shipping quote request. You can then use a quote_id
returned by the quote request endpoint to create the shipment.
2. Generating Track shipments
Track shipments provide a similar customer tracking and notification experience as standard Arta shipments but for shipments you have booked with commercial carriers outside of the Arta platform.
To create a Track shipment, you provide the carrier
and tracking_number
purchased externally and the Arta platform provides status automation, tracking pages, and customer notifications. You may optionally provide additional supplementary information such as origin, destination, and package details for Track shipments.
Note that Track shipments are a beta feature. Please contact your account manager or hello@arta.io to request access for your organization.
curl \
-X POST https://api.arta.io/shipments \
-H "Content-Type: application/json" \
-H "Authorization: ARTA_APIKey s0e1t2e3c4a5s6t7r8o9n10o11m12y" \
-d '{"shipment":{"internal_reference":"Purchase Order: 2801","public_reference":"Order #1437","quote_id":"12345","shipping_notes":"New customer","tags":["vip"]}}'
# Headers
Authorization: ARTA_APIKey s0e1t2e3c4a5s6t7r8o9n10o11m12y
# Payload
{
"shipment": {
"internal_reference": "Purchase Order: 2801",
"public_reference": "Order #1437",
"quote_id": "12345",
"shipping_notes": "New customer",
"tags": [
"vip"
]
}
}
# Headers
Authorization: ARTA_APIKey s0e1t2e3c4a5s6t7r8o9n10o11m12y
# Payload
{
"shipment": {
"destination": {
"access_restrictions": [
"string"
],
"address_line_1": "87 Richardson St",
"address_line_2": "string",
"address_line_3": "string",
"city": "Brooklyn",
"contacts": [
{
"email_address": "docs@arta.io",
"name": "Contact Name",
"phone_number": "646 828 7333"
}
],
"country": "US",
"postal_code": "11211",
"region": "NY",
"title": "Gallery"
},
"internal_reference": "Purchase Order: 2801",
"origin": {
"access_restrictions": [
"string"
],
"address_line_1": "87 Richardson St",
"address_line_2": "string",
"address_line_3": "string",
"city": "Brooklyn",
"contacts": [
{
"email_address": "docs@arta.io",
"name": "Contact Name",
"phone_number": "646 828 7333"
}
],
"country": "US",
"postal_code": "11211",
"region": "NY",
"title": "Gallery"
},
"packages": [
{
"depth": "3",
"height": "32",
"objects": [
{
"current_packing": [
"no_packing"
],
"depth": "3",
"details": {
"creation_date": "1980",
"creator": "Bob Smithson",
"is_cites": false,
"is_fragile": false,
"materials": [
"canvas"
],
"notes": "Artist signature in the lower left corner",
"title": "Black Rectangle"
},
"height": "32",
"images": [
"http://example.com/image.jpg"
],
"internal_reference": "Accession ID: 823",
"public_reference": "Round Smithson work",
"subtype": "painting_unframed",
"unit_of_measurement": "in",
"value": "2500.00",
"value_currency": "USD",
"weight": "3.0",
"weight_unit": "lb",
"width": "15"
}
],
"packing_materials": [
"cardboard"
],
"unit_of_measurement": "in",
"weight": "3.0",
"weight_unit": "lb",
"width": "15"
}
],
"public_reference": "Order #1437",
"shipping_notes": "New customer",
"tags": [
"vip"
],
"tracking": [
{
"carrier": "ups",
"tracking_number": "1ZXXXXXXXXXXXXXXXX",
"url": "string"
}
]
}
}
{
"id": "6b12c76a-5217-4cd6-82d8-7aa5265ebaad",
"url": "https://connect.shiparta.com/shipments/6b12c76a-5217-4cd6-82d8-7aa5265egood/5xTRnCvYkdMFdcFFMWUZaCmXz",
"tags": [],
"total": "4",
"origin": {
"city": "New York",
"title": "Warehouse",
"region": "NY",
"country": "US",
"contacts": [
{
"name": "Mary Quinn Sullivan",
"phone_number": "(333) 333-3333",
"email_address": "mary@example.com"
}
],
"postal_code": "10019",
"address_line_1": "11 W 53rd St",
"address_line_2": null,
"address_line_3": null,
"access_restrictions": []
},
"status": "pending",
"packages": [
{
"id": 131,
"eta": "05/09/2022",
"depth": "6.0",
"width": "14.0",
"height": "14.5",
"status": "pending",
"weight": "3.5",
"objects": [
{
"id": 620,
"type": "art",
"depth": "2",
"value": "1500",
"width": "10",
"height": "10.5",
"images": [],
"weight": "3.5",
"details": {
"title": "All That Jazz",
"creator": "Robert Irwin",
"is_cites": false,
"materials": [],
"is_fragile": false,
"creation_date": null
},
"subtype": "painting_unframed",
"weight_unit": "lb",
"value_currency": "USD",
"current_packing": [],
"public_reference": null,
"internal_reference": null,
"unit_of_measurement": "in"
}
],
"weight_unit": "lb",
"handle_with_care": false,
"packing_materials": [
"strongbox"
],
"is_sufficiently_packed": false
}
],
"schedule": {
"pickup_end": null,
"delivery_end": null,
"pickup_start": null,
"delivery_start": null,
"pickup_window_modifier": "",
"delivery_window_modifier": ""
},
"services": [
{
"name": "UPS Next Day Air",
"type": "transport",
"amount": "1",
"subtype": "parcel",
"is_required": true,
"sub_subtype": "parcel",
"is_requested": false,
"amount_currency": "USD",
"included_services": []
},
{
"name": "Strongbox",
"type": "packing",
"amount": "1",
"subtype": "packing_materials",
"is_required": true,
"sub_subtype": "strongbox",
"is_requested": false,
"amount_currency": "USD",
"included_services": []
},
{
"name": "Collection",
"type": "location",
"amount": "1",
"subtype": "collection",
"is_required": true,
"sub_subtype": "collection",
"is_requested": false,
"amount_currency": "USD",
"included_services": []
},
{
"name": "Fuel Surcharge",
"type": "taxes_duties_fees",
"amount": "1",
"subtype": "fees",
"is_required": true,
"sub_subtype": "fuel_surcharge",
"is_requested": false,
"amount_currency": "USD",
"included_services": []
}
],
"tracking": [],
"emissions": "0.03",
"shortcode": "MA-452144",
"created_at": "2021-01-21T21:00:58.403150",
"exceptions": [],
"quote_type": "parcel",
"updated_at": "2021-01-21T21:00:58.579870",
"destination": {
"city": "New York",
"title": "Home",
"region": "NY",
"country": "US",
"contacts": [
{
"name": "Alfred Barr",
"phone_number": "(222) 222-2222",
"email_address": "al@example.com"
}
],
"postal_code": "11249",
"address_line_1": "87 Richardson St",
"address_line_2": null,
"address_line_3": null,
"access_restrictions": []
},
"eei_form_url": null,
"object_count": 1,
"package_count": 1,
"emissions_unit": "kg_co2e",
"shipping_notes": null,
"total_currency": "USD",
"eei_form_status": null,
"payment_process": "invoicing",
"insurance_policy": null,
"public_reference": null,
"internal_reference": null
}
# Headers
content-type: application/json
x-arta-request-id: FkBjuxbwLLTx4RoAARkx
# Payload
{
"errors": {
"detail": "string"
}
}
# Headers
content-type: application/json
x-arta-request-id: FkBjuxbwLLTx4RoAARkx
# Payload
{
"errors": {
"detail": "string"
}
}
{
"errors": {
"detail": "string"
}
}