RyderShip
API docs by Redocly

Rydership API (2.0)

Download OpenAPI specification:

Rydership Development Team: tech@whiplash.com URL: https://www.getwhiplash.com

The Rydership V2 API is open by invite only. Fill out request form here.
V2 documentation
V2.1 documentation

bundle_items

Bundle Items are components that make up a bundle, defining the quantity and relationship of items within product bundles.

Retrieve a bundle item

Get a bundle item

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
No sample

Update a bundle item's quantity

Update a bundle item for a bundle

path Parameters
id
required
integer
Request Body schema: application/json
required
quantity
integer <int32>

the bundle item quantity

Responses

Request samples

Content type
application/json
{
  • "quantity": 0
}

Response samples

Content type
application/json
No sample

Destroy a bundle item

Destroy a bundle item for a bundle

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

carrier_aliases

Alternative names and mappings for shipping carriers.

List all carrier_aliases

Get a list of carrier_aliases

query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

fields
string

Comma-separated list of fields to include in the response

sort
string

A list of sort options (ex: name asc,created_at desc)

page
integer <int32>

Page of results to fetch

per_page
integer <int32>

Number of results to return per page

page_total
boolean

Include total count of results

page_links
boolean

Include prev/next links in response headers

Responses

Response samples

Content type
application/json
No sample

consumer_returns

A ConsumerReturn represents goods coming back from an end consumer. It is a special form of Shipnotice, and is processed in much the same way.

List all consumer returns

Get all consumer returns

query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

fields
string

Comma-separated list of fields to include in the response

sort
string

A list of sort options (ex: name asc,created_at desc)

page
integer <int32>

Page of results to fetch

per_page
integer <int32>

Number of results to return per page

page_total
boolean

Include total count of results

page_links
boolean

Include prev/next links in response headers

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    }
]

Create a consumer return

Create a consumer return

Request Body schema: application/json
required
order_id
integer <int32>

The whiplash id of the order from which an item is being returned

customer_id
integer <int32>

the consumer return customer id

warehouse_id
integer <int32>

The ID of the whiplash warehouse this return should be delivered to

sender
string

the consumer return sender

eta
string <date-time>

the consumer return estimated arrival date

status
integer <int32>

status of the consumer return

received_by
string

the name of the person who received the consumer return

notes_by_whiplash
string

notes by whiplash

notes_by_customer
string

notes by customer

total_boxes
integer <int32>

total number of boxes in the consumer return

created_at
string <date-time>

the consumer return creation date and time

updated_at
string <date-time>

the consumer return last update date and time

arrived_at
string <date-time>

the consumer return arrival date and time

skip_images
boolean

allow skipping of images for this consumer return?

easypostable_id
string

the ID of the easypost shipment or tracker

easypostable_type
string

the type of the easypost object (shipment or tracker)

shipping_label_url
string

url of the shipping label

ship_actual_cost
number <float>

the consumer return actual cost of shipping

shipping_method_text
string

the method of shipping for the consumer return

carrier
string

shipping carrier

tracking
string

the tracking number of the consumer return

type
string

consumer return type (Shipnotice, ConsumerReturn)

postage_billed
boolean

was postage billed?

handling_billed
boolean

was handling billed?

ship_3rdparty_cost
number <float>

the consumer return actual cost of shipping

requires_label
boolean

does this consumer return require a label?

completed_at
string <date-time>

the consumer return completion date and time

ship_actual_currency
string

currency used for this consumer return

delivered_at
string <date-time>

date when was the consumer return delivered

due_at
string <date-time>

date when the consumer return is due to be delivered

reference
string

purchase order number or other human readable token to another system

Array of objects
object
object

Hash of key value pairs (must conform to available meta keys)

exchange_items
Array of integers <int32> [ items <int32 > ]

List of whiplash item ids to be added to an exchange order

Responses

Request samples

Content type
application/json
{
  • "order_id": 0,
  • "customer_id": 0,
  • "warehouse_id": 0,
  • "sender": "string",
  • "eta": "2019-08-24T14:15:22Z",
  • "status": 0,
  • "received_by": "string",
  • "notes_by_whiplash": "string",
  • "notes_by_customer": "string",
  • "total_boxes": 0,
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "arrived_at": "2019-08-24T14:15:22Z",
  • "skip_images": true,
  • "easypostable_id": "string",
  • "easypostable_type": "string",
  • "shipping_label_url": "string",
  • "ship_actual_cost": 0.1,
  • "shipping_method_text": "string",
  • "carrier": "string",
  • "tracking": "string",
  • "type": "string",
  • "postage_billed": true,
  • "handling_billed": true,
  • "ship_3rdparty_cost": 0.1,
  • "requires_label": true,
  • "completed_at": "2019-08-24T14:15:22Z",
  • "ship_actual_currency": "string",
  • "delivered_at": "2019-08-24T14:15:22Z",
  • "due_at": "2019-08-24T14:15:22Z",
  • "reference": "string",
  • "shipnotice_items_attributes": [
    ],
  • "originator_attributes": {
    },
  • "meta_fields": {
    },
  • "exchange_items": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 181660,
  • "order_id": 2650031,
  • "customer_id": 3545,
  • "warehouse_id": 1,
  • "sender": "Joanne Mraz",
  • "eta": "2020-09-30T17:03:31.000-04:00",
  • "status": 100,
  • "status_name": "In Transit",
  • "received_by": null,
  • "notes_by_whiplash": null,
  • "notes_by_customer": null,
  • "total_boxes": 1,
  • "created_at": "2020-09-16T17:03:31.000-04:00",
  • "updated_at": "2020-09-16T17:03:31.000-04:00",
  • "arrived_at": null,
  • "skip_images": null,
  • "easypostable_id": null,
  • "easypostable_type": "Shipment",
  • "shipping_label_url": null,
  • "ship_actual_cost": null,
  • "shipping_method_text": null,
  • "carrier": null,
  • "tracking": null,
  • "type": "ConsumerReturn",
  • "postage_billed": null,
  • "handling_billed": null,
  • "ship_3rdparty_cost": null,
  • "requires_label": true,
  • "completed_at": null,
  • "ship_actual_currency": null,
  • "delivered_at": null,
  • "due_at": null,
  • "reference": null,
  • "customer": {
    },
  • "warehouse": {
    },
  • "originator": {
    },
  • "return_items": [
    ],
  • "exchange_order": {
    },
  • "order": {
    }
}

Create consumer_returns in bulk

Create consumer_returns in bulk

Request Body schema: application/json
required
Array of objects

An array of consumer_return objects to create in bulk

Responses

Request samples

Content type
application/json
{
  • "resources": [
    ]
}

Response samples

Content type
application/json
No sample

Count consumer returns

Returns count of consumer returns

query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

Responses

Response samples

Content type
application/json
No sample

Retrieve a consumer return

Get a consumer return

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "id": 181660,
  • "order_id": 2650031,
  • "customer_id": 3545,
  • "warehouse_id": 1,
  • "sender": "Joanne Mraz",
  • "eta": "2020-09-30T17:03:31.000-04:00",
  • "status": 100,
  • "status_name": "In Transit",
  • "received_by": null,
  • "notes_by_whiplash": null,
  • "notes_by_customer": null,
  • "total_boxes": 1,
  • "created_at": "2020-09-16T17:03:31.000-04:00",
  • "updated_at": "2020-09-16T17:03:31.000-04:00",
  • "arrived_at": null,
  • "skip_images": null,
  • "easypostable_id": null,
  • "easypostable_type": "Shipment",
  • "shipping_label_url": null,
  • "ship_actual_cost": null,
  • "shipping_method_text": null,
  • "carrier": null,
  • "tracking": null,
  • "type": "ConsumerReturn",
  • "postage_billed": null,
  • "handling_billed": null,
  • "ship_3rdparty_cost": null,
  • "requires_label": true,
  • "completed_at": null,
  • "ship_actual_currency": null,
  • "delivered_at": null,
  • "due_at": null,
  • "reference": null,
  • "customer": {
    },
  • "warehouse": {
    },
  • "originator": {
    },
  • "return_items": [
    ],
  • "exchange_order": {
    },
  • "order": {
    }
}

Update a consumer return

Update a consumer return

path Parameters
id
required
integer
Request Body schema: application/json
required
sender
string

the consumer return sender

eta
string <date-time>

the consumer return estimated arrival date

tracking
string

the tracking number of the consumer return

notes_by_customer
string

notes by customer

shipping_label_url
string

url of the shipping label

total_boxes
integer <int32>

total number of boxes in the consumer return

shipping_method_text
string

the method of shipping for the consumer return

carrier
string

shipping carrier

requires_label
boolean

does this consumer return require a label?

ship_3rdparty_cost
number <float>

3rd party cost for the consumer return

reference
string

purchase order number or other human readable token to another system

Responses

Request samples

Content type
application/json
{
  • "sender": "string",
  • "eta": "2019-08-24T14:15:22Z",
  • "tracking": "string",
  • "notes_by_customer": "string",
  • "shipping_label_url": "string",
  • "total_boxes": 0,
  • "shipping_method_text": "string",
  • "carrier": "string",
  • "requires_label": true,
  • "ship_3rdparty_cost": 0.1,
  • "reference": "string"
}

Response samples

Content type
application/json
{
  • "id": 181660,
  • "order_id": 2650031,
  • "customer_id": 3545,
  • "warehouse_id": 1,
  • "sender": "Joanne Mraz",
  • "eta": "2020-09-30T17:03:31.000-04:00",
  • "status": 100,
  • "status_name": "In Transit",
  • "received_by": null,
  • "notes_by_whiplash": null,
  • "notes_by_customer": null,
  • "total_boxes": 1,
  • "created_at": "2020-09-16T17:03:31.000-04:00",
  • "updated_at": "2020-09-16T17:03:31.000-04:00",
  • "arrived_at": null,
  • "skip_images": null,
  • "easypostable_id": null,
  • "easypostable_type": "Shipment",
  • "shipping_label_url": null,
  • "ship_actual_cost": null,
  • "shipping_method_text": null,
  • "carrier": null,
  • "tracking": null,
  • "type": "ConsumerReturn",
  • "postage_billed": null,
  • "handling_billed": null,
  • "ship_3rdparty_cost": null,
  • "requires_label": true,
  • "completed_at": null,
  • "ship_actual_currency": null,
  • "delivered_at": null,
  • "due_at": null,
  • "reference": null,
  • "customer": {
    },
  • "warehouse": {
    },
  • "originator": {
    },
  • "return_items": [
    ],
  • "exchange_order": {
    },
  • "order": {
    }
}

Destroy a consumer return

Destroy a consumer return

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

List meta fields

Get the meta fields for a(n) ConsumerReturn

path Parameters
id
required
integer
query Parameters
associations
Array of strings

Include meta fields for associations

Responses

Response samples

Content type
application/json
No sample

Set meta fields

Update ConsumerReturn meta fields

path Parameters
id
required
integer
Request Body schema: application/json
required
fields
object

Hash of key/value pairs

association_fields
object

Included meta fields for associations

Responses

Request samples

Content type
application/json
{
  • "fields": { },
  • "association_fields": { }
}

Response samples

Content type
application/json
{
  • "message": "string"
}

customers

Customers are Whiplash clients, not the End Consumer. Most Whiplash resources are owned by a Customer (or belong to resources that are).

List all customers

Get all customers

query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

fields
string

Comma-separated list of fields to include in the response

sort
string

A list of sort options (ex: name asc,created_at desc)

page
integer <int32>

Page of results to fetch

per_page
integer <int32>

Number of results to return per page

page_total
boolean

Include total count of results

page_links
boolean

Include prev/next links in response headers

Responses

Response samples

Content type
application/json
No sample

List actions you can perform

Get resource actions

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

Count customers

Count of all customers

query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

Responses

Response samples

Content type
application/json
No sample

Retrieve a customer

Get a customer

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
No sample

Update a customer

Update a customer

path Parameters
id
required
integer
Request Body schema: application/json
required
workday_uuid
string
partner_id
integer <int32>

Customer partner id. (admins only)

billing_contact_name
string

Customer billing contact name.

name
string

Customer name.

active
boolean

Customer active?

auto_merge_gestation
integer <int32>

Customer auto merge gestation.

default_warehouse_id
integer <int32>

Customer default warehouse id.

eori_number
string

Customer EORI number.

estimated_monthly_volume
string

Customer estimated monthly volume.

fedex_account
string

Customer FedEx account.

from_email
string

Customer from email.

instructions
string

Customer instructions.

item_scanning_preference
boolean

Customer has item scanning preference?

label_format
string

Customer label format.

notes
string

Customer notes.

notify_originator
boolean

notify originator?

notify_originator_inventory
integer <int32>

Customer notify originator inventory.

originator_permissions
boolean

originator permissions?

packing_slip_msg
string

Customer packing slip message.

packingslip_template
string

Customer packing slip template.

request_serial_numbers
boolean

request serial numbers?

ship_method_preference
integer <int32>

Customer shipping method preference.

shipping_name
string

Customer shipping name.

ups_account
string

Customer UPS account.

vat_number
string

Customer VAT number.

ein
string

Customer EIN / Tax ID

gs1_company_prefix
string

GS1 company prefix for barcodes

warehouse_fallback
integer <int32>

Customer warehouse fallback.

payment_hold
boolean

is this account on hold pending a valid payment method?

primary_contact
string

The Customers designated primary contact.

exit_notice
boolean

is this account flagged for exit notice? (admins only)

data_mapping_string
string

Data mapping string for this customer. (admins only)

allowed_warehouse_ids
Array of integers <int32> [ items <int32 > ]

IDs of warehouses this customer may ship from

account_level
integer <int32>

Account level

auto_merge_skus
boolean

auto merge SKUs?

billing_email
string

Customer billing email.

billing_company
string

Customer billing company.

billing_phone1
string

Customer phone 1.

billing_phone2
string

Customer phone 2.

billing_address1
string

Customer billing address line 1.

billing_address2
string

Customer billing address line 2.

billing_address3
string

Customer billing address line 3.

billing_city
string

Customer billing city.

billing_state
string

Customer billing state.

billing_zip
string

Customer billing zip.

billing_country
string

Customer billing country.

billing_residential
boolean

Customer billing residential?

items_returnable
boolean

items returnable by default?

allow_international_returns
boolean

Allow International returns?

items_exchangeable
boolean

items exchangeable by default?

return_time_limit
integer <int32>

Return time limit.

return_label_expires_in
integer <int32>

Return label expiration time limit.

return_price_restricted
boolean

limit exchange to same value or less?

return_sku_match
string

Exchange SKU match policy.

rma_display_logo
boolean

display customer logo on returns page?

rma_footer_content
string

Return page footer content.

return_name
string

Customer return name.

return_company
string

Customer return company.

return_email
string

Customer return email.

return_phone
string

Customer return phone.

return_address_1
string

Customer return address line 1.

return_address_2
string

Customer return address line 2.

return_city
string

Customer return city.

return_state
string

Customer return state.

return_zip
string

Customer return zip.

return_country
string

Customer return country.

supports_return_labels
boolean

does the customer support return labels?

logo_content_type
string

Customer logo content type.

logo_file_name
string

Customer logo file name.

logo_file_size
integer <int32>

Customer logo file size.

logo_updated_at
string <date-time>

Customer logo updated at.

full_logo_url
string

Customer full logo url.

email_confirmation_from
string

Customer email confirmation from.

email_confirmation_name
string

Customer email confirmation name.

email_confirmation_msg
string

Customer email confirmation message.

email_confirmation_preference
integer <int32>

Customer email confirmation preference.

email_confirmation_template
string

Customer email confirmation template.

low_inventory_threshold
integer <int32>

Quantity where an item in inventory would be considered having low inventory

lot_control
boolean

do items for this customer require lot control?

expiration_period
integer <int32>

items that are this many days from expiration will not be allowed to ship

ship_strategy
integer <int32>

which locations to pick first: Default, FIFO, FEFO

items_unavailable_on_sellout
integer <int32>

Process Orders setting: Whiplash will automatically turn on Process Orders when an item is received, and turn it off when an item sells. Whiplash will not manage Process Orders. Whiplash will automatically turn on Process Orders only the first time an Item is received. Whiplash will automatically turn on Process Orders when an item is received or adjusted in, and turn it off when an Item sells out.

replenishment_min
number <float>

Minimum number of days worth of stock to keep in forward pick locations

replenishment_target
number <float>

Target number of days stock to replenish forward pick locations

allow_b_stock_receiving
boolean

Allow "b stock" role for receiving

location_default_return_role
string

Default role (i.e. Pickable, Damaged) for returned items

location_enable_pending_returns
boolean

Allow "pending" role for returned items

location_enable_receiving_into_reserved
boolean

Allow "reserved" role for receiving items

receiving_fields
Array of objects

JSON array of required and optional receiving fields in the form: {"label": "cases", "required": true}

project_task_labels
Array of strings

JSON array of allowed labels for customer's project tasks

dashboard_enable_domo
string

Enable Domo dashboard for this customer

dashboard_enable_parcel_insights
string

Enable Parcel Insights for this customer

billing_core
boolean

if false, disables hardcoded billing logic (staff only)

Responses

Request samples

Content type
application/json
{
  • "workday_uuid": "string",
  • "partner_id": 0,
  • "billing_contact_name": "string",
  • "name": "string",
  • "active": true,
  • "auto_merge_gestation": 0,
  • "default_warehouse_id": 0,
  • "eori_number": "string",
  • "estimated_monthly_volume": "string",
  • "fedex_account": "string",
  • "from_email": "string",
  • "instructions": "string",
  • "item_scanning_preference": true,
  • "label_format": "string",
  • "notes": "string",
  • "notify_originator": true,
  • "notify_originator_inventory": 0,
  • "originator_permissions": true,
  • "packing_slip_msg": "string",
  • "packingslip_template": "string",
  • "request_serial_numbers": true,
  • "ship_method_preference": 0,
  • "shipping_name": "string",
  • "ups_account": "string",
  • "vat_number": "string",
  • "ein": "string",
  • "gs1_company_prefix": "string",
  • "warehouse_fallback": 0,
  • "payment_hold": true,
  • "primary_contact": "string",
  • "exit_notice": true,
  • "data_mapping_string": "string",
  • "allowed_warehouse_ids": [
    ],
  • "account_level": 0,
  • "auto_merge_skus": true,
  • "billing_email": "string",
  • "billing_company": "string",
  • "billing_phone1": "string",
  • "billing_phone2": "string",
  • "billing_address1": "string",
  • "billing_address2": "string",
  • "billing_address3": "string",
  • "billing_city": "string",
  • "billing_state": "string",
  • "billing_zip": "string",
  • "billing_country": "string",
  • "billing_residential": true,
  • "items_returnable": true,
  • "allow_international_returns": true,
  • "items_exchangeable": true,
  • "return_time_limit": 0,
  • "return_label_expires_in": 0,
  • "return_price_restricted": true,
  • "return_sku_match": "string",
  • "rma_display_logo": true,
  • "rma_footer_content": "string",
  • "return_name": "string",
  • "return_company": "string",
  • "return_email": "string",
  • "return_phone": "string",
  • "return_address_1": "string",
  • "return_address_2": "string",
  • "return_city": "string",
  • "return_state": "string",
  • "return_zip": "string",
  • "return_country": "string",
  • "supports_return_labels": true,
  • "logo_content_type": "string",
  • "logo_file_name": "string",
  • "logo_file_size": 0,
  • "logo_updated_at": "2019-08-24T14:15:22Z",
  • "full_logo_url": "string",
  • "email_confirmation_from": "string",
  • "email_confirmation_name": "string",
  • "email_confirmation_msg": "string",
  • "email_confirmation_preference": 0,
  • "email_confirmation_template": "string",
  • "low_inventory_threshold": 0,
  • "lot_control": true,
  • "expiration_period": 0,
  • "ship_strategy": 0,
  • "items_unavailable_on_sellout": 0,
  • "replenishment_min": 0.1,
  • "replenishment_target": 0.1,
  • "allow_b_stock_receiving": true,
  • "location_default_return_role": "string",
  • "location_enable_pending_returns": true,
  • "location_enable_receiving_into_reserved": true,
  • "receiving_fields": [
    ],
  • "project_task_labels": [
    ],
  • "dashboard_enable_domo": "string",
  • "dashboard_enable_parcel_insights": "string",
  • "billing_core": true
}

Response samples

Content type
application/json
No sample

documents

Documents are imported files and exported reports. We store a record in your account of every file you import, as well as every report you've run, so they're easy to search and access.

List all documents

Get all documents

query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

fields
string

Comma-separated list of fields to include in the response

sort
string

A list of sort options (ex: name asc,created_at desc)

tagged_with
string

A comma separated list of tags to search on (ex: "account transaction,AccountExporters::Invoice").

Responses

Response samples

Content type
application/json
No sample

Create a document

Create a document

Request Body schema: application/json
required
url
string

the document file url

file_name
string

the document name

partner_id
integer <int32>

the document partner id

owner_id
integer <int32>

the document owners id

owner_type
string

the document owner type

customer_name
string

associated customer name

partner_name
string

associated partner name

user_name
string

associated user name

signed_url
string

the document pre-signed url

keyword_list
string

Comma separated list of keyword tags

message_list
string

Comma separated list of message tags

context_list
string

Comma separated list of context tags

resource_type_list
string

Comma separated list resource_type tags

Responses

Request samples

Content type
application/json
{
  • "url": "string",
  • "file_name": "string",
  • "partner_id": 0,
  • "owner_id": 0,
  • "owner_type": "string",
  • "customer_name": "string",
  • "partner_name": "string",
  • "user_name": "string",
  • "signed_url": "string",
  • "keyword_list": "string",
  • "message_list": "string",
  • "context_list": "string",
  • "resource_type_list": "string"
}

Response samples

Content type
application/json
No sample

List actions you can perform

Get resource actions

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

Retrieve a document

Get a document

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
No sample

Destroy an document

Destroy an document

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

items

Items are probably the most fundamental entity in the Whiplash system. An item is simply a 'shippable unit'. So, it's not a Whiplash T-Shirt; it's a Small Whiplash T-Shirt, for instance. Most commerce platforms model Products. Typically, however, a Product (e.g. a T-Shirt) has variations (named variously, Variants, ProductOptions, OptionSets, etc). An Item maps to the Variant/Option, not the Product.

List all items

Get a list of items

query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

fields
string

Comma-separated list of fields to include in the response

sort
string

A list of sort options (ex: name asc,created_at desc)

page
integer <int32>

Page of results to fetch

per_page
integer <int32>

Number of results to return per page

page_total
boolean

Include total count of results

page_links
boolean

Include prev/next links in response headers

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create an item

Create an item

Request Body schema: application/json
required
sku
string

the item SKU number

title
string

the item title

description
string

the item description

customer_id
integer <int32>

the id of the customer the item belongs to

weight
number <float>

the weight of the item (in pounds)

available
boolean

is the item available?

image_originator_url
string

the originator url for the item image

vendor
string

the item vendor

scancode
string

the item scancode

price
number <float>

the item price

media_mail
boolean

is the item eligible for media mail?

packaging
boolean

is the item packaging?

length
number <float>

the item length (in inches)

width
number <float>

the item width (in inches)

height
number <float>

the item height (in inches)

active
boolean

is the item active?

wholesale_cost
number <float>

the wholesale cost of the item

is_bundle
boolean

is the item a bundle?

packaging_type
string
Enum: "WhiplashBag" "WhiplashBox" "WhiplashBubbleMailer" "WhiplashFill" "WhiplashFlat" "WhiplashTube" "WhiplashNoPackaging" "WhiplashPallet" "Card" "Letter" "Flat" "Parcel" "LargeParcel" "IrregularParcel" "FlatRateEnvelope" "FlatRateLegalEnvelope" "FlatRatePaddedEnvelope" "FlatRateGiftCardEnvelope" "FlatRateWindowEnvelope" "FlatRateCardboardEnvelope" "SmallFlatRateEnvelope" "SmallFlatRateBox" "MediumFlatRateBox" "LargeFlatRateBox" "RegionalRateBoxA" "RegionalRateBoxB" "RegionalRateBoxC" "LargeFlatRateBoardGameBox" "UPSLetter" "UPSExpressBox" "UPS25kgBox" "UPS10kgBox" "Tube" "Pak" "Pallet" "SmallExpressBox" "MediumExpressBox" "LargeExpressBox" "FedExEnvelope" "FedExBox" "FedExPak" "FedExTube" "FedEx10kgBox" "FedEx25kgBox" "BPM" "LargeLetter" "SmallParcel" "MediumParcel"

the item packaging type

promo
boolean

is the item a promo?

street_date
string <date-time>

the item street date

category
string

the item category

include_inbound_in_published
boolean

include inbound items in published?

returnable
boolean

is the item returnable?

return_sku_match
string

the item return SKU match

return_price_restricted
boolean

is the item return price restricted?

request_serial_number
boolean

does the item require a serial number when shipping?

currency
string

the item currency

tariff_number
string

the item harmonized tariff number (for international shipping)

notify_originator_inventory
integer <int32>

notify originator inventory?

nmfc_code
string

the item National Motor Freight Classification code,

nmfc_class
string

the item National Motor Freight Classification class code

commodity_description
string

the item commodity description

hazmat
boolean

(deprecated) is the item hazmat?

hazmat_type
string
Enum: "ormd" "lithium" "lighters" "ORMD" "LITHIUM" "LIGHTERS"

hazmat class

misc
string

miscellaneous information about the item

ean
string

the EAN number for the item

lot_control
boolean

does this item require lot control?

expiration_period
integer <int32>

items that are this many days from expiration will not be allowed to ship

ship_strategy
integer <int32>

which locations to pick first: Default, FIFO, FEFO

velocity
integer <int32>

Average number of units expected to sell in a day

case_quantity
integer <int32>

How many of this item to a case?

carton_quantity
integer <int32>

How many CASES to a carton?

origin_country
string
Enum: "AF" "AX" "AL" "DZ" "AS" "AD" "AO" "AI" "AQ" "AG" "AR" "AM" "AW" "AU" "AT" "AZ" "BS" "BH" "BD" "BB" "BY" "BE" "BZ" "BJ" "BM" "BT" "BO" "BQ" "BA" "BW" "BV" "BR" "IO" "BN" "BG" "BF" "BI" "KH" "CM" "CA" "CV" "KY" "CF" "TD" "CL" "CN" "CX" "CC" "CO" "KM" "CG" "CD" "CK" "CR" "CI" "HR" "CU" "CW" "CY" "CZ" "DK" "DJ" "DM" "DO" "EC" "EG" "SV" "GQ" "ER" "EE" "ET" "FK" "FO" "FJ" "FI" "FR" "GF" "PF" "TF" "GA" "GM" "GE" "DE" "GH" "GI" "GR" "GL" "GD" "GP" "GU" "GT" "GG" "GN" "GW" "GY" "HT" "HM" "VA" "HN" "HK" "HU" "IS" "IN" "ID" "IR" "IQ" "IE" "IM" "IL" "IT" "JM" "JP" "JE" "JO" "KZ" "KE" "KI" "KP" "KR" "XK" "KW" "KG" "LA" "LV" "LB" "LS" "LR" "LY" "LI" "LT" "LU" "MO" "MK" "MG" "MW" "MY" "MV" "ML" "MT" "MH" "MQ" "MR" "MU" "YT" "MX" "FM" "MD" "MC" "MN" "ME" "MS" "MA" "MZ" "MM" "NA" "NR" "NP" "NL" "NC" "NZ" "NI" "NE" "NG" "NU" "NF" "MP" "NO" "PS" "OM" "PK" "PW" "PA" "PG" "PY" "PE" "PH" "PN" "PL" "PT" "PR" "QA" "RE" "RO" "RU" "RW" "BL" "SH" "KN" "LC" "MF" "PM" "VC" "WS" "SM" "ST" "SA" "SN" "RS" "SC" "SL" "SG" "SX" "SK" "SI" "SB" "SO" "ZA" "GS" "SS" "ES" "LK" "SD" "SR" "SJ" "SZ" "SE" "CH" "SY" "TW" "TJ" "TZ" "TH" "TL" "TG" "TK" "TO" "TT" "TN" "TR" "TM" "TC" "TV" "UG" "UA" "AE" "GB" "US" "UM" "UY" "UZ" "VU" "VE" "VN" "VG" "VI" "WF" "EH" "YE" "ZM" "ZW"

The country of origin for this item (as an iso2 country code)

alcohol
boolean

Does this order contain alcohol?

shippable_container
boolean

Is this item a shippable container?

goh
boolean

Garment on hanger?

label_format
string
Enum: "default" "whiplash_mini"

label format

replenishment_min
number <float>

Minimum number of days worth of stock to keep in forward pick locations

replenishment_target
number <float>

Target number of days stock to replenish forward pick locations

low_inventory_threshold
integer <int32>

the item quantity where this item would be considered having low inventory

Array of objects
object

Hash of key value pairs (must conform to available meta keys)

Responses

Request samples

Content type
application/json
{
  • "sku": "string",
  • "title": "string",
  • "description": "string",
  • "customer_id": 0,
  • "weight": 0.1,
  • "available": true,
  • "image_originator_url": "string",
  • "vendor": "string",
  • "scancode": "string",
  • "price": 0.1,
  • "media_mail": true,
  • "packaging": true,
  • "length": 0.1,
  • "width": 0.1,
  • "height": 0.1,
  • "active": true,
  • "wholesale_cost": 0.1,
  • "is_bundle": true,
  • "packaging_type": "WhiplashBag",
  • "promo": true,
  • "street_date": "2019-08-24T14:15:22Z",
  • "category": "string",
  • "include_inbound_in_published": true,
  • "returnable": true,
  • "return_sku_match": "string",
  • "return_price_restricted": true,
  • "request_serial_number": true,
  • "currency": "string",
  • "tariff_number": "string",
  • "notify_originator_inventory": 0,
  • "nmfc_code": "string",
  • "nmfc_class": "string",
  • "commodity_description": "string",
  • "hazmat": true,
  • "hazmat_type": "ormd",
  • "misc": "string",
  • "ean": "string",
  • "lot_control": true,
  • "expiration_period": 0,
  • "ship_strategy": 0,
  • "velocity": 0,
  • "case_quantity": 0,
  • "carton_quantity": 0,
  • "origin_country": "AF",
  • "alcohol": true,
  • "shippable_container": true,
  • "goh": true,
  • "label_format": "default",
  • "replenishment_min": 0.1,
  • "replenishment_target": 0.1,
  • "low_inventory_threshold": 0,
  • "originators_attributes": [
    ],
  • "meta_fields": {
    }
}

Response samples

Content type
application/json
{
  • "id": 1244292,
  • "sku": "ST-0004",
  • "title": "Simple Twill",
  • "description": "Size 4",
  • "full_description": "Simple Twill, Size 4",
  • "original_location": null,
  • "created_at": "2020-09-16T17:03:15.000-04:00",
  • "updated_at": "2020-09-16T17:03:19.000-04:00",
  • "customer_id": 3545,
  • "quantity": 9,
  • "weight": "4.6",
  • "available": false,
  • "image_originator_url": null,
  • "vendor": null,
  • "scancode": "00ST0004",
  • "price": "0.0",
  • "media_mail": false,
  • "packaging": false,
  • "length": "20.0",
  • "width": "14.5",
  • "height": "11.0",
  • "active": true,
  • "wholesale_cost": null,
  • "is_bundle": false,
  • "packaging_type": null,
  • "promo": false,
  • "street_date": null,
  • "category": null,
  • "include_inbound_in_published": false,
  • "returnable": null,
  • "return_sku_match": null,
  • "return_price_restricted": null,
  • "request_serial_number": null,
  • "currency": "USD",
  • "tariff_number": null,
  • "label_format": null,
  • "notify_originator_inventory": 0,
  • "name": "Simple Twill, Size 4",
  • "image_url": null,
  • "hazmat": false,
  • "hazmat_type": null,
  • "misc": null,
  • "ean": null,
  • "lot_control": false,
  • "expiration_period": null,
  • "ship_strategy": 0,
  • "velocity": 0,
  • "case_quantity": null,
  • "carton_quantity": null,
  • "origin_country": null,
  • "alcohol": false,
  • "replenishment_min": null,
  • "replenishment_target": null,
  • "low_inventory_threshold": null,
  • "published_quantity": 9
}

List actions you can perform

Get resource actions

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

Count items

Returns count of items

query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

Responses

Response samples

Content type
application/json
No sample

Retrieve an item

Get an item

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "id": 1244292,
  • "sku": "ST-0004",
  • "title": "Simple Twill",
  • "description": "Size 4",
  • "full_description": "Simple Twill, Size 4",
  • "original_location": null,
  • "created_at": "2020-09-16T17:03:15.000-04:00",
  • "updated_at": "2020-09-16T17:03:19.000-04:00",
  • "customer_id": 3545,
  • "quantity": 9,
  • "weight": "4.6",
  • "available": false,
  • "image_originator_url": null,
  • "vendor": null,
  • "scancode": "00ST0004",
  • "price": "0.0",
  • "media_mail": false,
  • "packaging": false,
  • "length": "20.0",
  • "width": "14.5",
  • "height": "11.0",
  • "active": true,
  • "wholesale_cost": null,
  • "is_bundle": false,
  • "packaging_type": null,
  • "promo": false,
  • "street_date": null,
  • "category": null,
  • "include_inbound_in_published": false,
  • "returnable": null,
  • "return_sku_match": null,
  • "return_price_restricted": null,
  • "request_serial_number": null,
  • "currency": "USD",
  • "tariff_number": null,
  • "label_format": null,
  • "notify_originator_inventory": 0,
  • "name": "Simple Twill, Size 4",
  • "image_url": null,
  • "hazmat": false,
  • "hazmat_type": null,
  • "misc": null,
  • "ean": null,
  • "lot_control": false,
  • "expiration_period": null,
  • "ship_strategy": 0,
  • "velocity": 0,
  • "case_quantity": null,
  • "carton_quantity": null,
  • "origin_country": null,
  • "alcohol": false,
  • "replenishment_min": null,
  • "replenishment_target": null,
  • "low_inventory_threshold": null,
  • "published_quantity": 9
}

Update an item

Update an item

path Parameters
id
required
integer
Request Body schema: application/json
required
sku
string

the item SKU number

title
string

the item title

description
string

the item description

customer_id
integer <int32>

the id of the customer the item belongs to

weight
number <float>

the weight of the item (in pounds)

available
boolean

is the item available?

image_originator_url
string

the originator url for the item image

vendor
string

the item vendor

scancode
string

the item scancode

price
number <float>

the item price

media_mail
boolean

is the item eligible for media mail?

packaging
boolean

is the item packaging?

length
number <float>

the item length (in inches)

width
number <float>

the item width (in inches)

height
number <float>

the item height (in inches)

active
boolean

is the item active?

wholesale_cost
number <float>

the wholesale cost of the item

is_bundle
boolean

is the item a bundle?

packaging_type
string
Enum: "WhiplashBag" "WhiplashBox" "WhiplashBubbleMailer" "WhiplashFill" "WhiplashFlat" "WhiplashTube" "WhiplashNoPackaging" "WhiplashPallet" "Card" "Letter" "Flat" "Parcel" "LargeParcel" "IrregularParcel" "FlatRateEnvelope" "FlatRateLegalEnvelope" "FlatRatePaddedEnvelope" "FlatRateGiftCardEnvelope" "FlatRateWindowEnvelope" "FlatRateCardboardEnvelope" "SmallFlatRateEnvelope" "SmallFlatRateBox" "MediumFlatRateBox" "LargeFlatRateBox" "RegionalRateBoxA" "RegionalRateBoxB" "RegionalRateBoxC" "LargeFlatRateBoardGameBox" "UPSLetter" "UPSExpressBox" "UPS25kgBox" "UPS10kgBox" "Tube" "Pak" "Pallet" "SmallExpressBox" "MediumExpressBox" "LargeExpressBox" "FedExEnvelope" "FedExBox" "FedExPak" "FedExTube" "FedEx10kgBox" "FedEx25kgBox" "BPM" "LargeLetter" "SmallParcel" "MediumParcel"

the item packaging type

promo
boolean

is the item a promo?

street_date
string <date-time>

the item street date

category
string

the item category

include_inbound_in_published
boolean

include inbound items in published?

returnable
boolean

is the item returnable?

return_sku_match
string

the item return SKU match

return_price_restricted
boolean

is the item return price restricted?

request_serial_number
boolean

does the item require a serial number when shipping?

currency
string

the item currency

tariff_number
string

the item harmonized tariff number (for international shipping)

notify_originator_inventory
integer <int32>

notify originator inventory?

nmfc_code
string

the item National Motor Freight Classification code,

nmfc_class
string

the item National Motor Freight Classification class code

commodity_description
string

the item commodity description

hazmat
boolean

(deprecated) is the item hazmat?

misc
string

miscellaneous information about the item

ean
string

the EAN number for the item

lot_control
boolean

does this item require lot control?

expiration_period
integer <int32>

items that are this many days from expiration will not be allowed to ship

ship_strategy
integer <int32>

which locations to pick first: Default, FIFO, FEFO

velocity
integer <int32>

Average number of units expected to sell in a day

case_quantity
integer <int32>

How many of this item to a case?

carton_quantity
integer <int32>

How many CASES to a carton?

origin_country
string
Enum: "AF" "AX" "AL" "DZ" "AS" "AD" "AO" "AI" "AQ" "AG" "AR" "AM" "AW" "AU" "AT" "AZ" "BS" "BH" "BD" "BB" "BY" "BE" "BZ" "BJ" "BM" "BT" "BO" "BQ" "BA" "BW" "BV" "BR" "IO" "BN" "BG" "BF" "BI" "KH" "CM" "CA" "CV" "KY" "CF" "TD" "CL" "CN" "CX" "CC" "CO" "KM" "CG" "CD" "CK" "CR" "CI" "HR" "CU" "CW" "CY" "CZ" "DK" "DJ" "DM" "DO" "EC" "EG" "SV" "GQ" "ER" "EE" "ET" "FK" "FO" "FJ" "FI" "FR" "GF" "PF" "TF" "GA" "GM" "GE" "DE" "GH" "GI" "GR" "GL" "GD" "GP" "GU" "GT" "GG" "GN" "GW" "GY" "HT" "HM" "VA" "HN" "HK" "HU" "IS" "IN" "ID" "IR" "IQ" "IE" "IM" "IL" "IT" "JM" "JP" "JE" "JO" "KZ" "KE" "KI" "KP" "KR" "XK" "KW" "KG" "LA" "LV" "LB" "LS" "LR" "LY" "LI" "LT" "LU" "MO" "MK" "MG" "MW" "MY" "MV" "ML" "MT" "MH" "MQ" "MR" "MU" "YT" "MX" "FM" "MD" "MC" "MN" "ME" "MS" "MA" "MZ" "MM" "NA" "NR" "NP" "NL" "NC" "NZ" "NI" "NE" "NG" "NU" "NF" "MP" "NO" "PS" "OM" "PK" "PW" "PA" "PG" "PY" "PE" "PH" "PN" "PL" "PT" "PR" "QA" "RE" "RO" "RU" "RW" "BL" "SH" "KN" "LC" "MF" "PM" "VC" "WS" "SM" "ST" "SA" "SN" "RS" "SC" "SL" "SG" "SX" "SK" "SI" "SB" "SO" "ZA" "GS" "SS" "ES" "LK" "SD" "SR" "SJ" "SZ" "SE" "CH" "SY" "TW" "TJ" "TZ" "TH" "TL" "TG" "TK" "TO" "TT" "TN" "TR" "TM" "TC" "TV" "UG" "UA" "AE" "GB" "US" "UM" "UY" "UZ" "VU" "VE" "VN" "VG" "VI" "WF" "EH" "YE" "ZM" "ZW"

The country of origin for this item (as an iso2 country code)

alcohol
boolean

Does this order contain alcohol?

shippable_container
boolean

Is this item a shippable container?

goh
boolean

Garment on hanger?

label_format
string
Enum: "default" "whiplash_mini"

label format

replenishment_min
number <float>

Minimum number of days worth of stock to keep in forward pick locations

replenishment_target
number <float>

Target number of days stock to replenish forward pick locations

low_inventory_threshold
integer <int32>

the item quantity where this item would be considered having low inventory

hazmat_type
string
Enum: "ormd" "lithium" "lighters" "ORMD" "LITHIUM" "LIGHTERS"

hazmat class

Responses

Request samples

Content type
application/json
{
  • "sku": "string",
  • "title": "string",
  • "description": "string",
  • "customer_id": 0,
  • "weight": 0.1,
  • "available": true,
  • "image_originator_url": "string",
  • "vendor": "string",
  • "scancode": "string",
  • "price": 0.1,
  • "media_mail": true,
  • "packaging": true,
  • "length": 0.1,
  • "width": 0.1,
  • "height": 0.1,
  • "active": true,
  • "wholesale_cost": 0.1,
  • "is_bundle": true,
  • "packaging_type": "WhiplashBag",
  • "promo": true,
  • "street_date": "2019-08-24T14:15:22Z",
  • "category": "string",
  • "include_inbound_in_published": true,
  • "returnable": true,
  • "return_sku_match": "string",
  • "return_price_restricted": true,
  • "request_serial_number": true,
  • "currency": "string",
  • "tariff_number": "string",
  • "notify_originator_inventory": 0,
  • "nmfc_code": "string",
  • "nmfc_class": "string",
  • "commodity_description": "string",
  • "hazmat": true,
  • "misc": "string",
  • "ean": "string",
  • "lot_control": true,
  • "expiration_period": 0,
  • "ship_strategy": 0,
  • "velocity": 0,
  • "case_quantity": 0,
  • "carton_quantity": 0,
  • "origin_country": "AF",
  • "alcohol": true,
  • "shippable_container": true,
  • "goh": true,
  • "label_format": "default",
  • "replenishment_min": 0.1,
  • "replenishment_target": 0.1,
  • "low_inventory_threshold": 0,
  • "hazmat_type": "ormd"
}

Response samples

Content type
application/json
{
  • "id": 1244292,
  • "sku": "ST-0004",
  • "title": "Simple Twill",
  • "description": "Size 4",
  • "full_description": "Simple Twill, Size 4",
  • "original_location": null,
  • "created_at": "2020-09-16T17:03:15.000-04:00",
  • "updated_at": "2020-09-16T17:03:19.000-04:00",
  • "customer_id": 3545,
  • "quantity": 9,
  • "weight": "4.6",
  • "available": false,
  • "image_originator_url": null,
  • "vendor": null,
  • "scancode": "00ST0004",
  • "price": "0.0",
  • "media_mail": false,
  • "packaging": false,
  • "length": "20.0",
  • "width": "14.5",
  • "height": "11.0",
  • "active": true,
  • "wholesale_cost": null,
  • "is_bundle": false,
  • "packaging_type": null,
  • "promo": false,
  • "street_date": null,
  • "category": null,
  • "include_inbound_in_published": false,
  • "returnable": null,
  • "return_sku_match": null,
  • "return_price_restricted": null,
  • "request_serial_number": null,
  • "currency": "USD",
  • "tariff_number": null,
  • "label_format": null,
  • "notify_originator_inventory": 0,
  • "name": "Simple Twill, Size 4",
  • "image_url": null,
  • "hazmat": false,
  • "hazmat_type": null,
  • "misc": null,
  • "ean": null,
  • "lot_control": false,
  • "expiration_period": null,
  • "ship_strategy": 0,
  • "velocity": 0,
  • "case_quantity": null,
  • "carton_quantity": null,
  • "origin_country": null,
  • "alcohol": false,
  • "replenishment_min": null,
  • "replenishment_target": null,
  • "low_inventory_threshold": null,
  • "published_quantity": 9
}

Archive an item

Destroy an item

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

List all bundle items containing this item

Shows all bundle items containing this item

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
No sample

Add an item to an bundle

Add an item to an bundle

path Parameters
id
required
integer
Request Body schema: application/json
required
quantity
integer <int32>

the bundle item quantity

item_id
integer <int32>

the bundle item item id

Responses

Request samples

Content type
application/json
{
  • "quantity": 0,
  • "item_id": 0
}

Response samples

Content type
application/json
No sample

Perform an action on an item

Perform an action on an item

path Parameters
action
required
string
id
required
integer
Request Body schema: application/json
required
action
string
args
object

Method params

Responses

Request samples

Content type
application/json
{
  • "action": "string",
  • "args": { }
}

Response samples

Content type
application/json
{
  • "id": 1244292,
  • "sku": "ST-0004",
  • "title": "Simple Twill",
  • "description": "Size 4",
  • "full_description": "Simple Twill, Size 4",
  • "original_location": null,
  • "created_at": "2020-09-16T17:03:15.000-04:00",
  • "updated_at": "2020-09-16T17:03:19.000-04:00",
  • "customer_id": 3545,
  • "quantity": 9,
  • "weight": "4.6",
  • "available": false,
  • "image_originator_url": null,
  • "vendor": null,
  • "scancode": "00ST0004",
  • "price": "0.0",
  • "media_mail": false,
  • "packaging": false,
  • "length": "20.0",
  • "width": "14.5",
  • "height": "11.0",
  • "active": true,
  • "wholesale_cost": null,
  • "is_bundle": false,
  • "packaging_type": null,
  • "promo": false,
  • "street_date": null,
  • "category": null,
  • "include_inbound_in_published": false,
  • "returnable": null,
  • "return_sku_match": null,
  • "return_price_restricted": null,
  • "request_serial_number": null,
  • "currency": "USD",
  • "tariff_number": null,
  • "label_format": null,
  • "notify_originator_inventory": 0,
  • "name": "Simple Twill, Size 4",
  • "image_url": null,
  • "hazmat": false,
  • "hazmat_type": null,
  • "misc": null,
  • "ean": null,
  • "lot_control": false,
  • "expiration_period": null,
  • "ship_strategy": 0,
  • "velocity": 0,
  • "case_quantity": null,
  • "carton_quantity": null,
  • "origin_country": null,
  • "alcohol": false,
  • "replenishment_min": null,
  • "replenishment_target": null,
  • "low_inventory_threshold": null,
  • "published_quantity": 9
}

List all instances of this item in bundles

Shows all instances of this item in bundles

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "id": 1244292,
  • "sku": "ST-0004",
  • "title": "Simple Twill",
  • "description": "Size 4",
  • "full_description": "Simple Twill, Size 4",
  • "original_location": null,
  • "created_at": "2020-09-16T17:03:15.000-04:00",
  • "updated_at": "2020-09-16T17:03:19.000-04:00",
  • "customer_id": 3545,
  • "quantity": 9,
  • "weight": "4.6",
  • "available": false,
  • "image_originator_url": null,
  • "vendor": null,
  • "scancode": "00ST0004",
  • "price": "0.0",
  • "media_mail": false,
  • "packaging": false,
  • "length": "20.0",
  • "width": "14.5",
  • "height": "11.0",
  • "active": true,
  • "wholesale_cost": null,
  • "is_bundle": false,
  • "packaging_type": null,
  • "promo": false,
  • "street_date": null,
  • "category": null,
  • "include_inbound_in_published": false,
  • "returnable": null,
  • "return_sku_match": null,
  • "return_price_restricted": null,
  • "request_serial_number": null,
  • "currency": "USD",
  • "tariff_number": null,
  • "label_format": null,
  • "notify_originator_inventory": 0,
  • "name": "Simple Twill, Size 4",
  • "image_url": null,
  • "hazmat": false,
  • "hazmat_type": null,
  • "misc": null,
  • "ean": null,
  • "lot_control": false,
  • "expiration_period": null,
  • "ship_strategy": 0,
  • "velocity": 0,
  • "case_quantity": null,
  • "carton_quantity": null,
  • "origin_country": null,
  • "alcohol": false,
  • "replenishment_min": null,
  • "replenishment_target": null,
  • "low_inventory_threshold": null,
  • "published_quantity": 9
}

List locations associated with this item - by role

show locations associated with this item

path Parameters
id
required
integer
query Parameters
role
string
Enum: "pickable" "backstock" "damaged" "expired" "reserved" "pending" "external" "dropoff" "b_stock"

Pickable, backstock, etc

page
integer <int32>

Page number for pagination

per_page
integer <int32>

Number of locations per page for pagination

name
string

the location name

Responses

Response samples

Content type
application/json
No sample

List meta fields

Get the meta fields for a(n) Item

path Parameters
id
required
integer
query Parameters
associations
Array of strings

Include meta fields for associations

Responses

Response samples

Content type
application/json
No sample

Set meta fields

Update Item meta fields

path Parameters
id
required
integer
Request Body schema: application/json
required
fields
object

Hash of key/value pairs

association_fields
object

Included meta fields for associations

Responses

Request samples

Content type
application/json
{
  • "fields": { },
  • "association_fields": { }
}

Response samples

Content type
application/json
{
  • "message": "string"
}

List associated originators

Get the originators for a(n) Item

path Parameters
id
required
integer
query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

sort
string

A list of sort options (ex: name asc,created_at desc)

page
integer <int32>

Page of results to fetch

per_page
integer <int32>

Number of results to return per page

page_total
boolean

Include total count of results

page_links
boolean

Include prev/next links in response headers

Responses

Response samples

Content type
application/json
No sample

Count originators

Get the count of originators for a(n) Item

path Parameters
id
required
integer
query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

Responses

Response samples

Content type
application/json
No sample

List all scancodes associated with this item

show scancodes associated with this item

path Parameters
id
required
integer
query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

sort
string

A list of sort options (ex: name asc,created_at desc)

page
integer <int32>

Page of results to fetch

per_page
integer <int32>

Number of results to return per page

page_total
boolean

Include total count of results

page_links
boolean

Include prev/next links in response headers

Responses

Response samples

Content type
application/json
No sample

List associated ship notice items

List all shipnotice items for a(n) item

path Parameters
id
required
integer
query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

fields
string

Comma-separated list of fields to include in the response

sort
string

A list of sort options (ex: name asc,created_at desc)

page
integer <int32>

Page of results to fetch

per_page
integer <int32>

Number of results to return per page

page_total
boolean

Include total count of results

page_links
boolean

Include prev/next links in response headers

Responses

Response samples

Content type
application/json
No sample

Count associated ship notice items

Get a count of shipnotice items for a(n) item

path Parameters
id
required
integer
query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

Responses

Response samples

Content type
application/json
No sample

List an item's history

Get all transactions for an item

path Parameters
id
required
integer
query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

sort
string

A list of sort options (ex: name asc,created_at desc)

page
integer <int32>

Page of results to fetch

per_page
integer <int32>

Number of results to return per page

page_total
boolean

Include total count of results

page_links
boolean

Include prev/next links in response headers

Responses

Response samples

Content type
application/json
No sample

Count the transactions in an item's history

Returns count of item transactions

path Parameters
id
required
integer
query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

Responses

Response samples

Content type
application/json
No sample

Export an item's transaction history

Export item transaction history to CSV

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
No sample

Item stock by warehouse

Shows the number of this item in the warehouse

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
No sample

notification_events

System event definitions for notifications.

List all notification events

Get a list of notification events

query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

fields
string

Comma-separated list of fields to include in the response

sort
string

A list of sort options (ex: name asc,created_at desc)

page
integer <int32>

Page of results to fetch

per_page
integer <int32>

Number of results to return per page

page_total
boolean

Include total count of results

page_links
boolean

Include prev/next links in response headers

Responses

Response samples

Content type
application/json
No sample

Retrieve a notification event

Get a notification event

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
No sample

notification_subscriptions

User notification preferences and subscriptions.

List all notification subscriptions

Get a list of notification subscriptions

query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

fields
string

Comma-separated list of fields to include in the response

sort
string

A list of sort options (ex: name asc,created_at desc)

page
integer <int32>

Page of results to fetch

per_page
integer <int32>

Number of results to return per page

page_total
boolean

Include total count of results

page_links
boolean

Include prev/next links in response headers

Responses

Response samples

Content type
application/json
No sample

Create a notification subscription

Create a notification subscription

Request Body schema: application/json
required
notification_type
string

the type of notification to send the subscriber

notification_event_id
integer <int32>

the id of the notification event this subscription is subscribed to

endpoint
string

the URL the subscription will hit for Slack and Webhook types

customer_id
integer <int32>

the id of the customer who owns the subscription

user_id
integer <int32>

the id of the intended recipient

active
boolean

is the notification subscription active?

version
integer <int32>

whether the payload will match the v1 or v2 API

Responses

Request samples

Content type
application/json
{
  • "notification_type": "string",
  • "notification_event_id": 0,
  • "endpoint": "string",
  • "customer_id": 0,
  • "user_id": 0,
  • "active": true,
  • "version": 0
}

Response samples

Content type
application/json
No sample

Count notification subscriptions

Get a count of notification subscriptions

query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

Responses

Response samples

Content type
application/json
No sample

Retrieve a notification subscription

Get a notification subscription

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
No sample

Update a notification subscription

Update a notification subscription

path Parameters
id
required
integer
Request Body schema: application/json
required
notification_event_id
integer <int32>

the id of the notification event this subscription is subscribed to

customer_id
integer <int32>

the id of the customer who owns the subscription

user_id
integer <int32>

the id of the intended recipient

notification_type
string

the type of notification to send the subscriber

endpoint
string

the URL the subscription will hit for Slack and Webhook types

active
boolean

is the notification subscription active?

version
integer <int32>

whether the payload will match the v1 or v2 API

discarded_at
string <date-time>

the notification subscription discarded date and time

Responses

Request samples

Content type
application/json
{
  • "notification_event_id": 0,
  • "customer_id": 0,
  • "user_id": 0,
  • "notification_type": "string",
  • "endpoint": "string",
  • "active": true,
  • "version": 0,
  • "discarded_at": "2019-08-24T14:15:22Z"
}

Response samples

Content type
application/json
No sample

Delete a notification subscription

Delete a notification subscription

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

Test a notification subscription

Test a notification subscription

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
No sample

order_documents

Order-related documentation and paperwork.

Delete an order document

Delete an order document

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

order_items

An OrderItem represents an Item with a quantity in an Order.

List actions you can perform

Get resource actions

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

Retrieve an order item

Retrieve an order item

path Parameters
id
required
integer
query Parameters
page
integer <int32>

Page of results to fetch

per_page
integer <int32>

Number of results to return per page

page_total
boolean

Include total count of results

page_links
boolean

Include prev/next links in response headers

Responses

Response samples

Content type
application/json
No sample

Update an order item

Update an order item

path Parameters
id
required
integer
Request Body schema: application/json
required
order_id
integer <int32>

the order item order id

item_id
integer <int32>

the order item item id

package_id
integer <int32>

the order item package id

quote_item_id
integer <int32>

the order item quote item id

sku
string

the SKU of this item

description
string

description for this order item. This will appear in packing slips. If not set, the description will be inherited from the parent Item.

quantity
integer <int32>

number of this item in Order

price
number <float>

price of this item

unshippable
boolean

is this item unshippable?

available
boolean

is this item available?

packed
integer <int32>

number of items packed

packaging
boolean

is this item packaging?

wholesale_cost
number <float>

wholesale cost of the item

is_bundle
boolean

is this item a bundle?

retail_fee
number <float>

retail fee of this item

promo
boolean

is this item a promo?

returnable
boolean

is this item returnable?

currency
string

currency code for this item

wholesale_fee
number <float>

wholesale fee of this item

hazmat
boolean

(deprecated) is the order item hazmat?

misc
string

miscellaneous information about the order item

request_serial_number
boolean

does the item require a serial number when shipping?

case_quantity
integer <int32>

How many of this item to a case?

carton_quantity
integer <int32>

How many CASES to a carton?

goh
boolean

Garment on hanger?

object

Responses

Request samples

Content type
application/json
{
  • "order_id": 0,
  • "item_id": 0,
  • "package_id": 0,
  • "quote_item_id": 0,
  • "sku": "string",
  • "description": "string",
  • "quantity": 0,
  • "price": 0.1,
  • "unshippable": true,
  • "available": true,
  • "packed": 0,
  • "packaging": true,
  • "wholesale_cost": 0.1,
  • "is_bundle": true,
  • "retail_fee": 0.1,
  • "promo": true,
  • "returnable": true,
  • "currency": "string",
  • "wholesale_fee": 0.1,
  • "hazmat": true,
  • "misc": "string",
  • "request_serial_number": true,
  • "case_quantity": 0,
  • "carton_quantity": 0,
  • "goh": true,
  • "wholesale_item_attributes": {
    }
}

Response samples

Content type
application/json
No sample

Destroy an order item

Destroy an order item

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

Perform an action on an order_item

Perform an action on an order_item

path Parameters
action
required
string
id
required
integer
Request Body schema: application/json
required
action
string
args
object

Method params

Responses

Request samples

Content type
application/json
{
  • "action": "string",
  • "args": { }
}

Response samples

Content type
application/json
No sample

List meta fields

Get the meta fields for a(n) OrderItem

path Parameters
id
required
integer
query Parameters
associations
Array of strings

Include meta fields for associations

Responses

Response samples

Content type
application/json
No sample

Set meta fields

Update OrderItem meta fields

path Parameters
id
required
integer
Request Body schema: application/json
required
fields
object

Hash of key/value pairs

association_fields
object

Included meta fields for associations

Responses

Request samples

Content type
application/json
{
  • "fields": { },
  • "association_fields": { }
}

Response samples

Content type
application/json
{
  • "message": "string"
}

Separate an order item

Separate an order item into a new order

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
No sample

List all serial numbers associated with an order item

Return an order_items serial numbers

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
No sample

Retrieve the Wholesale item object for an order item

get the Wholesale item object for an order item

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
No sample

Update a wholesale item object

Update a wholesale item object

path Parameters
id
required
integer
Request Body schema: application/json
required
order_item_id
integer <int32>

the associated order item id

line_no
string

the line number

item_alias
string

the item alias

item_color
string

the item color

item_size
string

the item size

vendor_part_number
string

the vendor part number

buyer_part_number
string

the buyer part number

consumer_package_code
string

the consumer package code

outer_pack_value
string

the outer pack value

inner_pack_value
string

the inner pack value

size_description
string

the size description

color_description
string

the color description

upc
string

the UPC

description
string

the description

style
string

the style

ean
string

the EAN

alternate_item_number
string

the alternate item number

alternate_barcode
string

the alternate barcode

alternate_sku
string

the alternate SKU

lot
string

the lot

ih_category
string

the IH category

Responses

Request samples

Content type
application/json
{
  • "order_item_id": 0,
  • "line_no": "string",
  • "item_alias": "string",
  • "item_color": "string",
  • "item_size": "string",
  • "vendor_part_number": "string",
  • "buyer_part_number": "string",
  • "consumer_package_code": "string",
  • "outer_pack_value": "string",
  • "inner_pack_value": "string",
  • "size_description": "string",
  • "color_description": "string",
  • "upc": "string",
  • "description": "string",
  • "style": "string",
  • "ean": "string",
  • "alternate_item_number": "string",
  • "alternate_barcode": "string",
  • "alternate_sku": "string",
  • "lot": "string",
  • "ih_category": "string"
}

Response samples

Content type
application/json
No sample

order_totes

Order picking container management.

Count order items for an order tote

Returns count of order items for a given order tote

path Parameters
code
required
string
query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

Responses

Response samples

Content type
application/json
No sample

Count orders for a tote

Returns count of orders for a given tote

path Parameters
code
required
string
query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

Responses

Response samples

Content type
application/json
No sample

orders

Orders are end consumer requests for Items. An Order is comprised of OrderItems. Orders represent outgoing stock.

List all orders

Retrieves a list of orders

query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

fields
string

Comma-separated list of fields to include in the response

sort
string

A list of sort options (ex: name asc,created_at desc)

page
integer <int32>

Page of results to fetch

per_page
integer <int32>

Number of results to return per page

page_total
boolean

Include total count of results

page_links
boolean

Include prev/next links in response headers

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • [
    ],
  • {
    }
]

Create an order

Create an order

Request Body schema: application/json
required
shipping_method_id
integer <int32>

the order shipping method id

estimated_shipping_method_id
integer <int32>

the estimated order shipping method id, if set to cheapest rate

order_orig
string

the order original id (from the shop that sent whiplash the order)
Note: contains the global-e order id for any global-e order.

package_label_reference
string

User-defined reference for shipping labels on packages. Note: this field has a limit of 35 chars.

level1_token
string

the order level 1 token

level2_token
string

the order level 2 token

skip_street_date
boolean

skip street date for this order?

due_at
string <date-time>

the order due at date and time

meta_data
string

meta data for this order as stringified JSON

customer_provided_label_carrier
string

the carrier on the customer provided label (for tracking purposes)

purchase_order
string

the purchase order this order

order_type
string
Enum: "direct_to_consumer" "dropship" "retail" "transfer" "value_added_service" "wholesale"

the order type

batch_priority
boolean

the order batch priority

email
string

the order shipping email

skip_address_verification
boolean

skip order shipping address verification? (staff only)

scac
string

the orders Standard Carrier Alpha Code number

tms_id
string

The Transport Management System ID for the order, if applicable

tms_required
boolean

Does the order require a Transport Management System ID

shop_warehouse_ids
Array of integers <int32> [ items <int32 > ]

the order shop warehouse ids

shop_shipping_method_currency
string

the order shop shipping method currency

shop_created_at
string <date-time>

the order shop creation date and time

shop_updated_at
string <date-time>

the order shop last update date and time

shop_shipping_method_text
string

the order shop shipping method text
ge_standard = order uses global-e standard shipping method
ge_express = order uses global-e express shipping method

shop_shipping_method_price
number <float>

the order shop shipping method price

billing_company
string

the order billing company

billing_address_1
string

the order billing street address 1

billing_address_2
string

the order billing street address 2

billing_address_3
string

the order billing street address 3

billing_city
string

the order billing city

billing_state
string

the order billing state

billing_zip
string

the order billing zip

billing_country
string

the order billing country

billing_phone
string

the order billing phone number

do_not_bill
boolean

do not bill for the order? (staff only)

billing_name
string

the order billing name

first_name
string

the first name of the person the order is being shipped to

last_name
string

the last name of the person the order is being shipped to

full_name
string

the full name of the person the order is being shipped to

shipping_name
string

the order shipping name

shipping_company
string

the order shipping company

shipping_address_1
string

the order shipping street address 1

shipping_address_2
string

the order shipping street address 2

shipping_city
string

the order shipping city

shipping_state
string

the order shipping state

shipping_zip
string

the order shipping zip

shipping_country
string

the order shipping country

shipping_country_iso2
string

the order shipping country iso2 (US, GB, CA, etc)

shipping_phone
string

the order shipping phone number

requested_address
string

the order requested address

residential
boolean

is the order address residential?

require_signature
boolean

does the order require a signature upon delivery?

require_adult_signature
boolean

does the order require an adult signature upon delivery?

saturday_delivery
boolean

require a carrier that delivers on Saturdays for this order?

gift
boolean

is the order a gift?

insure
boolean

is the order insured?

contains_alcohol
boolean

does the order contain alcohol?

shipping_carrier_facility
string

carrier facility access point for the address destination

shipping_hold_for_pickup
boolean

pickup option for carrier facility on the address destination

ship_notes
string

the order ship notes

ship_3rdparty_cost
number <float>

the order third party shipping cost

ship_3rdparty_account
string

the order third party shipping account

ship_3rdparty_zip
string

the order third party shipping zip

ship_3rdparty_country
string

the order third party shipping country

payment_type
string
Enum: "sender" "collect" "third_party"

the order payment type

public_note
string

the order public note

days_in_transit
integer <int32>

the order estimated days in transit (used for release planning)

days_in_transit_carrier_estimate
integer <int32>

the order estimated days in transit estimate from the carrier

req_insurance_value
number <float>

the order requested insurance value

customs_vat_number
string

Value Added Tax identifcation number for the sender of the order

customs_eori_number
string

Economic Operators Registration and Identification number for the sender of the order

customs_ioss_number
string

Import One-Stop Shop number for the sender of the order

customs_receiver_tax_id
string

RFC Tax id

carrier_account_id
integer <int32>

the carrier account id for this package, if it has shipped (staff only)

tracking
Array of strings

the order tracking numbers

tracking_links
Array of strings

the order tracking links

approximate_delivery_date
string <date>

the order approxiamte delivery date

global_e_ge_order
boolean

is the order a global_e order?

return_name
string

the order return name

return_company
string

the order return company

return_address_1
string

the order return street address 1

return_address_2
string

the order return street address 2

return_city
string

the order return city

return_state
string

the order return state

return_country
string

the order return country

return_zip
string

the order return zip

return_phone
string

the order return phone number

return_email
string

the order return email

return_time_limit
integer <int32>

the order return time limit

is_workable
boolean

is the order workable?

is_gestating
boolean

is the order gestating?

permissions_limited
boolean

Permission limited orders are not editable, but still may be processed/shipped

order_items
string
incoterm
string
Enum: "EXW" "FCA" "CPT" "CIP" "DAT" "DAP" "DDP" "FAS" "FOB" "CFR" "CIF" "DAF" "DES" "DEQ" "DDU"

desired incoterm for the order

status
integer <int32>
Enum: 30 35

the order status: 30 (Shipped Externally), 35 (Quote), 40 (Cancelled), 45 (Closed by Originator), 50 (Unpaid), 75 (Pending Return), 77 (Return Verified), 80 (Pre-Order), 90 (Paused), 95 (Insufficient Inventory), 100 (Processing), 120 (Printed), 140 (Pending Pick Confirmation), 150 (Picked), 155 (Prepacking in Progress), 160 (Packed), 200 (Label Scheduled for Purchase), 250 (Label Purchased), 300 (Shipped), 325 (Picked Up), 350 (Delivered), 375 (Return Expired), 380 (Replacement Cancelled), 400 (Returned Undeliverable), 410 (Replacement Requested), 430 (Exchanged), 450 (Refund Requested)

Array of objects

Order items attributes

object
object

Hash of key value pairs (must conform to available meta keys)

object

Responses

Request samples

Content type
application/json
{
  • "shipping_method_id": 0,
  • "estimated_shipping_method_id": 0,
  • "order_orig": "string",
  • "package_label_reference": "string",
  • "level1_token": "string",
  • "level2_token": "string",
  • "skip_street_date": true,
  • "due_at": "2019-08-24T14:15:22Z",
  • "meta_data": "string",
  • "customer_provided_label_carrier": "string",
  • "purchase_order": "string",
  • "order_type": "direct_to_consumer",
  • "batch_priority": true,
  • "email": "string",
  • "skip_address_verification": true,
  • "scac": "string",
  • "tms_id": "string",
  • "tms_required": true,
  • "shop_warehouse_ids": [
    ],
  • "shop_shipping_method_currency": "string",
  • "shop_created_at": "2019-08-24T14:15:22Z",
  • "shop_updated_at": "2019-08-24T14:15:22Z",
  • "shop_shipping_method_text": "string",
  • "shop_shipping_method_price": 0.1,
  • "billing_company": "string",
  • "billing_address_1": "string",
  • "billing_address_2": "string",
  • "billing_address_3": "string",
  • "billing_city": "string",
  • "billing_state": "string",
  • "billing_zip": "string",
  • "billing_country": "string",
  • "billing_phone": "string",
  • "do_not_bill": true,
  • "billing_name": "string",
  • "first_name": "string",
  • "last_name": "string",
  • "full_name": "string",
  • "shipping_name": "string",
  • "shipping_company": "string",
  • "shipping_address_1": "string",
  • "shipping_address_2": "string",
  • "shipping_city": "string",
  • "shipping_state": "string",
  • "shipping_zip": "string",
  • "shipping_country": "string",
  • "shipping_country_iso2": "string",
  • "shipping_phone": "string",
  • "requested_address": "string",
  • "residential": true,
  • "require_signature": true,
  • "require_adult_signature": true,
  • "saturday_delivery": true,
  • "gift": true,
  • "insure": true,
  • "contains_alcohol": true,
  • "shipping_carrier_facility": "string",
  • "shipping_hold_for_pickup": true,
  • "ship_notes": "string",
  • "ship_3rdparty_cost": 0.1,
  • "ship_3rdparty_account": "string",
  • "ship_3rdparty_zip": "string",
  • "ship_3rdparty_country": "string",
  • "payment_type": "sender",
  • "public_note": "string",
  • "days_in_transit": 0,
  • "days_in_transit_carrier_estimate": 0,
  • "req_insurance_value": 0.1,
  • "customs_vat_number": "string",
  • "customs_eori_number": "string",
  • "customs_ioss_number": "string",
  • "customs_receiver_tax_id": "string",
  • "carrier_account_id": 0,
  • "tracking": [
    ],
  • "tracking_links": [
    ],
  • "approximate_delivery_date": "2019-08-24",
  • "global_e_ge_order": true,
  • "return_name": "string",
  • "return_company": "string",
  • "return_address_1": "string",
  • "return_address_2": "string",
  • "return_city": "string",
  • "return_state": "string",
  • "return_country": "string",
  • "return_zip": "string",
  • "return_phone": "string",
  • "return_email": "string",
  • "return_time_limit": 0,
  • "is_workable": true,
  • "is_gestating": true,
  • "permissions_limited": true,
  • "order_items": "string",
  • "incoterm": "EXW",
  • "status": 30,
  • "order_items_attributes": [
    ],
  • "originator_attributes": {
    },
  • "meta_fields": {
    },
  • "wholesale_attributes": {
    }
}

Response samples

Content type
application/json
{
  • "id": 2650031,
  • "customer_id": 3545,
  • "order_batch_id": null,
  • "quote_id": null,
  • "warehouse_id": 1,
  • "return_warehouse_id": 1,
  • "shipping_method_id": null,
  • "estimated_shipping_method_id": null,
  • "humanize_id": "2650031-KA11982",
  • "status": 100,
  • "status_name": "Processing",
  • "previous_status": 100,
  • "order_orig": "KA11982",
  • "level1_token": "2da3b2a9fcefb88315c55c2aeaa332db",
  • "level2_token": "25ba76e38a12056440d59f4251a17154",
  • "workable_at": "2020-09-16T18:03:17.000-04:00",
  • "skip_street_date": false,
  • "due_at": "2020-09-17T16:00:00.000-04:00",
  • "created_at": "2020-09-16T17:03:17.000-04:00",
  • "updated_at": "2020-09-16T17:03:17.000-04:00",
  • "meta_data": null,
  • "customer_provided_label_carrier": null,
  • "purchase_order": null,
  • "email": "williehane@borer.co",
  • "address_verified": true,
  • "address_message": null,
  • "shop_warehouse_ids": [ ],
  • "shop_shipping_method_currency": null,
  • "shop_created_at": null,
  • "shop_updated_at": null,
  • "shop_shipping_method_text": null,
  • "shop_shipping_method_price": "0.0",
  • "billing_company": null,
  • "billing_address_1": null,
  • "billing_address_2": null,
  • "billing_address_3": null,
  • "billing_city": null,
  • "billing_state": null,
  • "billing_zip": null,
  • "billing_country": null,
  • "billing_phone": null,
  • "billed": false,
  • "billing_name": null,
  • "first_name": null,
  • "last_name": null,
  • "full_name": null,
  • "shipping_name": "Joanne Mraz",
  • "shipping_company": null,
  • "shipping_address_1": "54295 O'Connell Lakes",
  • "shipping_address_2": null,
  • "shipping_city": "South Claritaton",
  • "shipping_state": "Georgia",
  • "shipping_zip": "46735",
  • "shipping_country": "United States",
  • "shipping_country_iso2": "US",
  • "shipping_phone": null,
  • "requested_address": "54295 O'Connell Lakes\nSouth Claritaton, Georgia 46735\nUnited States",
  • "residential": true,
  • "require_signature": false,
  • "require_adult_signature": false,
  • "saturday_delivery": false,
  • "gift": false,
  • "insure": false,
  • "contains_alcohol": false,
  • "ship_actual_cost": null,
  • "shipped_on": null,
  • "ship_notes": null,
  • "shipping_confirmation_sent": false,
  • "ship_3rdparty_cost": "0.0",
  • "ship_3rdparty_account": null,
  • "ship_3rdparty_zip": null,
  • "ship_3rdparty_country": null,
  • "incoterm": null,
  • "public_note": null,
  • "days_in_transit": 1,
  • "days_in_transit_carrier_estimate": null,
  • "req_insurance_value": null,
  • "ship_method": null,
  • "packingslip_pdf_url": null,
  • "tracking": [ ],
  • "tracking_links": [
    ],
  • "approximate_delivery_date": null,
  • "return_name": null,
  • "return_company": null,
  • "return_address_1": null,
  • "return_address_2": null,
  • "return_city": null,
  • "return_state": null,
  • "return_country": null,
  • "return_zip": null,
  • "return_phone": null,
  • "return_email": null,
  • "return_address_verified": null,
  • "return_time_limit": null,
  • "order_items": [
    ],
  • "originator": {
    },
  • "proto_originator_id": null,
  • "packages": [
    ],
  • "shipping_method": null,
  • "serial_numbers": [ ]
}

List actions you can perform

Get resource actions

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

Create orders in bulk

Create orders in bulk

Request Body schema: application/json
required
Array of objects

An array of order objects to create in bulk

Responses

Request samples

Content type
application/json
{
  • "resources": [
    ]
}

Response samples

Content type
application/json
No sample

Count orders

Returns count of orders

query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

Responses

Response samples

Content type
application/json
No sample

Retrieve an order

Retrieve an order

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "id": 2650031,
  • "customer_id": 3545,
  • "order_batch_id": null,
  • "quote_id": null,
  • "warehouse_id": 1,
  • "return_warehouse_id": 1,
  • "shipping_method_id": null,
  • "estimated_shipping_method_id": null,
  • "humanize_id": "2650031-KA11982",
  • "status": 100,
  • "status_name": "Processing",
  • "previous_status": 100,
  • "order_orig": "KA11982",
  • "level1_token": "2da3b2a9fcefb88315c55c2aeaa332db",
  • "level2_token": "25ba76e38a12056440d59f4251a17154",
  • "workable_at": "2020-09-16T18:03:17.000-04:00",
  • "skip_street_date": false,
  • "due_at": "2020-09-17T16:00:00.000-04:00",
  • "created_at": "2020-09-16T17:03:17.000-04:00",
  • "updated_at": "2020-09-16T17:03:17.000-04:00",
  • "meta_data": null,
  • "customer_provided_label_carrier": null,
  • "purchase_order": null,
  • "email": "williehane@borer.co",
  • "address_verified": true,
  • "address_message": null,
  • "shop_warehouse_ids": [ ],
  • "shop_shipping_method_currency": null,
  • "shop_created_at": null,
  • "shop_updated_at": null,
  • "shop_shipping_method_text": null,
  • "shop_shipping_method_price": "0.0",
  • "billing_company": null,
  • "billing_address_1": null,
  • "billing_address_2": null,
  • "billing_address_3": null,
  • "billing_city": null,
  • "billing_state": null,
  • "billing_zip": null,
  • "billing_country": null,
  • "billing_phone": null,
  • "billed": false,
  • "billing_name": null,
  • "first_name": null,
  • "last_name": null,
  • "full_name": null,
  • "shipping_name": "Joanne Mraz",
  • "shipping_company": null,
  • "shipping_address_1": "54295 O'Connell Lakes",
  • "shipping_address_2": null,
  • "shipping_city": "South Claritaton",
  • "shipping_state": "Georgia",
  • "shipping_zip": "46735",
  • "shipping_country": "United States",
  • "shipping_country_iso2": "US",
  • "shipping_phone": null,
  • "requested_address": "54295 O'Connell Lakes\nSouth Claritaton, Georgia 46735\nUnited States",
  • "residential": true,
  • "require_signature": false,
  • "require_adult_signature": false,
  • "saturday_delivery": false,
  • "gift": false,
  • "insure": false,
  • "contains_alcohol": false,
  • "ship_actual_cost": null,
  • "shipped_on": null,
  • "ship_notes": null,
  • "shipping_confirmation_sent": false,
  • "ship_3rdparty_cost": "0.0",
  • "ship_3rdparty_account": null,
  • "ship_3rdparty_zip": null,
  • "ship_3rdparty_country": null,
  • "incoterm": null,
  • "public_note": null,
  • "days_in_transit": 1,
  • "days_in_transit_carrier_estimate": null,
  • "req_insurance_value": null,
  • "ship_method": null,
  • "packingslip_pdf_url": null,
  • "tracking": [ ],
  • "tracking_links": [
    ],
  • "approximate_delivery_date": null,
  • "return_name": null,
  • "return_company": null,
  • "return_address_1": null,
  • "return_address_2": null,
  • "return_city": null,
  • "return_state": null,
  • "return_country": null,
  • "return_zip": null,
  • "return_phone": null,
  • "return_email": null,
  • "return_address_verified": null,
  • "return_time_limit": null,
  • "order_items": [
    ],
  • "originator": {
    },
  • "proto_originator_id": null,
  • "packages": [
    ],
  • "shipping_method": null,
  • "serial_numbers": [ ]
}

Update an order

Update an order

path Parameters
id
required
integer
Request Body schema: application/json
required
shipping_method_id
integer <int32>

the order shipping method id

estimated_shipping_method_id
integer <int32>

the estimated order shipping method id, if set to cheapest rate

order_orig
string

the order original id (from the shop that sent whiplash the order)
Note: contains the global-e order id for any global-e order.

package_label_reference
string

User-defined reference for shipping labels on packages. Note: this field has a limit of 35 chars.

level1_token
string

the order level 1 token

level2_token
string

the order level 2 token

skip_street_date
boolean

skip street date for this order?

due_at
string <date-time>

the order due at date and time

meta_data
string

meta data for this order as stringified JSON

customer_provided_label_carrier
string

the carrier on the customer provided label (for tracking purposes)

purchase_order
string

the purchase order this order

order_type
string
Enum: "retail" "wholesale" "direct_to_consumer" "dropship" "transfer" "value_added_service"

the order type

batch_priority
boolean

the order batch priority

email
string

the order shipping email

skip_address_verification
boolean

skip order shipping address verification? (staff only)

scac
string

the orders Standard Carrier Alpha Code number

tms_id
string

The Transport Management System ID for the order, if applicable

tms_required
boolean

Does the order require a Transport Management System ID

shop_warehouse_ids
Array of integers <int32> [ items <int32 > ]

the order shop warehouse ids

shop_shipping_method_currency
string

the order shop shipping method currency

shop_created_at
string <date-time>

the order shop creation date and time

shop_updated_at
string <date-time>

the order shop last update date and time

shop_shipping_method_text
string

the order shop shipping method text
ge_standard = order uses global-e standard shipping method
ge_express = order uses global-e express shipping method

shop_shipping_method_price
number <float>

the order shop shipping method price

billing_company
string

the order billing company

billing_address_1
string

the order billing street address 1

billing_address_2
string

the order billing street address 2

billing_address_3
string

the order billing street address 3

billing_city
string

the order billing city

billing_state
string

the order billing state

billing_zip
string

the order billing zip

billing_country
string

the order billing country

billing_phone
string

the order billing phone number

do_not_bill
boolean

do not bill for the order? (staff only)

billing_name
string

the order billing name

first_name
string

the first name of the person the order is being shipped to

last_name
string

the last name of the person the order is being shipped to

full_name
string

the full name of the person the order is being shipped to

shipping_name
string

the order shipping name

shipping_company
string

the order shipping company

shipping_address_1
string

the order shipping street address 1

shipping_address_2
string

the order shipping street address 2

shipping_city
string

the order shipping city

shipping_state
string

the order shipping state

shipping_zip
string

the order shipping zip

shipping_country
string

the order shipping country

shipping_country_iso2
string

the order shipping country iso2 (US, GB, CA, etc)

shipping_phone
string

the order shipping phone number

requested_address
string

the order requested address

residential
boolean

is the order address residential?

require_signature
boolean

does the order require a signature upon delivery?

require_adult_signature
boolean

does the order require an adult signature upon delivery?

saturday_delivery
boolean

require a carrier that delivers on Saturdays for this order?

gift
boolean

is the order a gift?

insure
boolean

is the order insured?

contains_alcohol
boolean

does the order contain alcohol?

shipping_carrier_facility
string

carrier facility access point for the address destination

shipping_hold_for_pickup
boolean

pickup option for carrier facility on the address destination

ship_notes
string

the order ship notes

ship_3rdparty_cost
number <float>

the order third party shipping cost

ship_3rdparty_account
string

the order third party shipping account

ship_3rdparty_zip
string

the order third party shipping zip

ship_3rdparty_country
string

the order third party shipping country

payment_type
string
Enum: "sender" "collect" "third_party"

the order payment type

public_note
string

the order public note

days_in_transit
integer <int32>

the order estimated days in transit (used for release planning)

days_in_transit_carrier_estimate
integer <int32>

the order estimated days in transit estimate from the carrier

req_insurance_value
number <float>

the order requested insurance value

packingslip_pdf_url
string

url for this orders packing slip

customs_vat_number
string

Value Added Tax identifcation number for the sender of the order

customs_eori_number
string

Economic Operators Registration and Identification number for the sender of the order

customs_ioss_number
string

Import One-Stop Shop number for the sender of the order

customs_receiver_tax_id
string

RFC Tax id

carrier_account_id
integer <int32>

the carrier account id for this package, if it has shipped (staff only)

tracking
Array of strings

the order tracking numbers

tracking_links
Array of strings

the order tracking links

approximate_delivery_date
string <date>

the order approxiamte delivery date

global_e_ge_order
boolean

is the order a global_e order?

return_name
string

the order return name

return_company
string

the order return company

return_address_1
string

the order return street address 1

return_address_2
string

the order return street address 2

return_city
string

the order return city

return_state
string

the order return state

return_country
string

the order return country

return_zip
string

the order return zip

return_phone
string

the order return phone number

return_email
string

the order return email

return_time_limit
integer <int32>

the order return time limit

is_workable
boolean

is the order workable?

is_gestating
boolean

is the order gestating?

permissions_limited
boolean

Permission limited orders are not editable, but still may be processed/shipped

incoterm
string
Enum: "EXW" "FCA" "CPT" "CIP" "DAT" "DAP" "DDP" "FAS" "FOB" "CFR" "CIF" "DAF" "DES" "DEQ" "DDU"

desired incoterm for the order

object

Responses

Request samples

Content type
application/json
{
  • "shipping_method_id": 0,
  • "estimated_shipping_method_id": 0,
  • "order_orig": "string",
  • "package_label_reference": "string",
  • "level1_token": "string",
  • "level2_token": "string",
  • "skip_street_date": true,
  • "due_at": "2019-08-24T14:15:22Z",
  • "meta_data": "string",
  • "customer_provided_label_carrier": "string",
  • "purchase_order": "string",
  • "order_type": "retail",
  • "batch_priority": true,
  • "email": "string",
  • "skip_address_verification": true,
  • "scac": "string",
  • "tms_id": "string",
  • "tms_required": true,
  • "shop_warehouse_ids": [
    ],
  • "shop_shipping_method_currency": "string",
  • "shop_created_at": "2019-08-24T14:15:22Z",
  • "shop_updated_at": "2019-08-24T14:15:22Z",
  • "shop_shipping_method_text": "string",
  • "shop_shipping_method_price": 0.1,
  • "billing_company": "string",
  • "billing_address_1": "string",
  • "billing_address_2": "string",
  • "billing_address_3": "string",
  • "billing_city": "string",
  • "billing_state": "string",
  • "billing_zip": "string",
  • "billing_country": "string",
  • "billing_phone": "string",
  • "do_not_bill": true,
  • "billing_name": "string",
  • "first_name": "string",
  • "last_name": "string",
  • "full_name": "string",
  • "shipping_name": "string",
  • "shipping_company": "string",
  • "shipping_address_1": "string",
  • "shipping_address_2": "string",
  • "shipping_city": "string",
  • "shipping_state": "string",
  • "shipping_zip": "string",
  • "shipping_country": "string",
  • "shipping_country_iso2": "string",
  • "shipping_phone": "string",
  • "requested_address": "string",
  • "residential": true,
  • "require_signature": true,
  • "require_adult_signature": true,
  • "saturday_delivery": true,
  • "gift": true,
  • "insure": true,
  • "contains_alcohol": true,
  • "shipping_carrier_facility": "string",
  • "shipping_hold_for_pickup": true,
  • "ship_notes": "string",
  • "ship_3rdparty_cost": 0.1,
  • "ship_3rdparty_account": "string",
  • "ship_3rdparty_zip": "string",
  • "ship_3rdparty_country": "string",
  • "payment_type": "sender",
  • "public_note": "string",
  • "days_in_transit": 0,
  • "days_in_transit_carrier_estimate": 0,
  • "req_insurance_value": 0.1,
  • "packingslip_pdf_url": "string",
  • "customs_vat_number": "string",
  • "customs_eori_number": "string",
  • "customs_ioss_number": "string",
  • "customs_receiver_tax_id": "string",
  • "carrier_account_id": 0,
  • "tracking": [
    ],
  • "tracking_links": [
    ],
  • "approximate_delivery_date": "2019-08-24",
  • "global_e_ge_order": true,
  • "return_name": "string",
  • "return_company": "string",
  • "return_address_1": "string",
  • "return_address_2": "string",
  • "return_city": "string",
  • "return_state": "string",
  • "return_country": "string",
  • "return_zip": "string",
  • "return_phone": "string",
  • "return_email": "string",
  • "return_time_limit": 0,
  • "is_workable": true,
  • "is_gestating": true,
  • "permissions_limited": true,
  • "incoterm": "EXW",
  • "wholesale_attributes": {
    }
}

Response samples

Content type
application/json
{
  • "id": 2650031,
  • "customer_id": 3545,
  • "order_batch_id": null,
  • "quote_id": null,
  • "warehouse_id": 1,
  • "return_warehouse_id": 1,
  • "shipping_method_id": null,
  • "estimated_shipping_method_id": null,
  • "humanize_id": "2650031-KA11982",
  • "status": 100,
  • "status_name": "Processing",
  • "previous_status": 100,
  • "order_orig": "KA11982",
  • "level1_token": "2da3b2a9fcefb88315c55c2aeaa332db",
  • "level2_token": "25ba76e38a12056440d59f4251a17154",
  • "workable_at": "2020-09-16T18:03:17.000-04:00",
  • "skip_street_date": false,
  • "due_at": "2020-09-17T16:00:00.000-04:00",
  • "created_at": "2020-09-16T17:03:17.000-04:00",
  • "updated_at": "2020-09-16T17:03:17.000-04:00",
  • "meta_data": null,
  • "customer_provided_label_carrier": null,
  • "purchase_order": null,
  • "email": "williehane@borer.co",
  • "address_verified": true,
  • "address_message": null,
  • "shop_warehouse_ids": [ ],
  • "shop_shipping_method_currency": null,
  • "shop_created_at": null,
  • "shop_updated_at": null,
  • "shop_shipping_method_text": null,
  • "shop_shipping_method_price": "0.0",
  • "billing_company": null,
  • "billing_address_1": null,
  • "billing_address_2": null,
  • "billing_address_3": null,
  • "billing_city": null,
  • "billing_state": null,
  • "billing_zip": null,
  • "billing_country": null,
  • "billing_phone": null,
  • "billed": false,
  • "billing_name": null,
  • "first_name": null,
  • "last_name": null,
  • "full_name": null,
  • "shipping_name": "Joanne Mraz",
  • "shipping_company": null,
  • "shipping_address_1": "54295 O'Connell Lakes",
  • "shipping_address_2": null,
  • "shipping_city": "South Claritaton",
  • "shipping_state": "Georgia",
  • "shipping_zip": "46735",
  • "shipping_country": "United States",
  • "shipping_country_iso2": "US",
  • "shipping_phone": null,
  • "requested_address": "54295 O'Connell Lakes\nSouth Claritaton, Georgia 46735\nUnited States",
  • "residential": true,
  • "require_signature": false,
  • "require_adult_signature": false,
  • "saturday_delivery": false,
  • "gift": false,
  • "insure": false,
  • "contains_alcohol": false,
  • "ship_actual_cost": null,
  • "shipped_on": null,
  • "ship_notes": null,
  • "shipping_confirmation_sent": false,
  • "ship_3rdparty_cost": "0.0",
  • "ship_3rdparty_account": null,
  • "ship_3rdparty_zip": null,
  • "ship_3rdparty_country": null,
  • "incoterm": null,
  • "public_note": null,
  • "days_in_transit": 1,
  • "days_in_transit_carrier_estimate": null,
  • "req_insurance_value": null,
  • "ship_method": null,
  • "packingslip_pdf_url": null,
  • "tracking": [ ],
  • "tracking_links": [
    ],
  • "approximate_delivery_date": null,
  • "return_name": null,
  • "return_company": null,
  • "return_address_1": null,
  • "return_address_2": null,
  • "return_city": null,
  • "return_state": null,
  • "return_country": null,
  • "return_zip": null,
  • "return_phone": null,
  • "return_email": null,
  • "return_address_verified": null,
  • "return_time_limit": null,
  • "order_items": [
    ],
  • "originator": {
    },
  • "proto_originator_id": null,
  • "packages": [
    ],
  • "shipping_method": null,
  • "serial_numbers": [ ]
}

Perform an action on an order

Perform an action on an order

path Parameters
action
required
string
id
required
integer
Request Body schema: application/json
required
action
string
args
object

Method params

Responses

Request samples

Content type
application/json
{
  • "action": "string",
  • "args": { }
}

Response samples

Content type
application/json
{
  • "id": 2650031,
  • "customer_id": 3545,
  • "order_batch_id": null,
  • "quote_id": null,
  • "warehouse_id": 1,
  • "return_warehouse_id": 1,
  • "shipping_method_id": null,
  • "estimated_shipping_method_id": null,
  • "humanize_id": "2650031-KA11982",
  • "status": 100,
  • "status_name": "Processing",
  • "previous_status": 100,
  • "order_orig": "KA11982",
  • "level1_token": "2da3b2a9fcefb88315c55c2aeaa332db",
  • "level2_token": "25ba76e38a12056440d59f4251a17154",
  • "workable_at": "2020-09-16T18:03:17.000-04:00",
  • "skip_street_date": false,
  • "due_at": "2020-09-17T16:00:00.000-04:00",
  • "created_at": "2020-09-16T17:03:17.000-04:00",
  • "updated_at": "2020-09-16T17:03:17.000-04:00",
  • "meta_data": null,
  • "customer_provided_label_carrier": null,
  • "purchase_order": null,
  • "email": "williehane@borer.co",
  • "address_verified": true,
  • "address_message": null,
  • "shop_warehouse_ids": [ ],
  • "shop_shipping_method_currency": null,
  • "shop_created_at": null,
  • "shop_updated_at": null,
  • "shop_shipping_method_text": null,
  • "shop_shipping_method_price": "0.0",
  • "billing_company": null,
  • "billing_address_1": null,
  • "billing_address_2": null,
  • "billing_address_3": null,
  • "billing_city": null,
  • "billing_state": null,
  • "billing_zip": null,
  • "billing_country": null,
  • "billing_phone": null,
  • "billed": false,
  • "billing_name": null,
  • "first_name": null,
  • "last_name": null,
  • "full_name": null,
  • "shipping_name": "Joanne Mraz",
  • "shipping_company": null,
  • "shipping_address_1": "54295 O'Connell Lakes",
  • "shipping_address_2": null,
  • "shipping_city": "South Claritaton",
  • "shipping_state": "Georgia",
  • "shipping_zip": "46735",
  • "shipping_country": "United States",
  • "shipping_country_iso2": "US",
  • "shipping_phone": null,
  • "requested_address": "54295 O'Connell Lakes\nSouth Claritaton, Georgia 46735\nUnited States",
  • "residential": true,
  • "require_signature": false,
  • "require_adult_signature": false,
  • "saturday_delivery": false,
  • "gift": false,
  • "insure": false,
  • "contains_alcohol": false,
  • "ship_actual_cost": null,
  • "shipped_on": null,
  • "ship_notes": null,
  • "shipping_confirmation_sent": false,
  • "ship_3rdparty_cost": "0.0",
  • "ship_3rdparty_account": null,
  • "ship_3rdparty_zip": null,
  • "ship_3rdparty_country": null,
  • "incoterm": null,
  • "public_note": null,
  • "days_in_transit": 1,
  • "days_in_transit_carrier_estimate": null,
  • "req_insurance_value": null,
  • "ship_method": null,
  • "packingslip_pdf_url": null,
  • "tracking": [ ],
  • "tracking_links": [
    ],
  • "approximate_delivery_date": null,
  • "return_name": null,
  • "return_company": null,
  • "return_address_1": null,
  • "return_address_2": null,
  • "return_city": null,
  • "return_state": null,
  • "return_country": null,
  • "return_zip": null,
  • "return_phone": null,
  • "return_email": null,
  • "return_address_verified": null,
  • "return_time_limit": null,
  • "order_items": [
    ],
  • "originator": {
    },
  • "proto_originator_id": null,
  • "packages": [
    ],
  • "shipping_method": null,
  • "serial_numbers": [ ]
}

Retrieve the CustomsInfo object for an order

get the CustomsInfo object for an order

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
No sample

Retrieve the history for an order

Get the order history

path Parameters
id
required
integer
query Parameters
page
integer <int32>

Page of results to fetch

per_page
integer <int32>

Number of results to return per page

page_total
boolean

Include total count of results

page_links
boolean

Include prev/next links in response headers

Responses

Response samples

Content type
application/json
No sample

Count order's events

Returns count of order's events

path Parameters
id
required
integer
query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

Responses

Response samples

Content type
application/json
No sample

List meta fields

Get the meta fields for a(n) Order

path Parameters
id
required
integer
query Parameters
associations
Array of strings

Include meta fields for associations

Responses

Response samples

Content type
application/json
No sample

Set meta fields

Update Order meta fields

path Parameters
id
required
integer
Request Body schema: application/json
required
fields
object

Hash of key/value pairs

association_fields
object

Included meta fields for associations

Responses

Request samples

Content type
application/json
{
  • "fields": { },
  • "association_fields": { }
}

Response samples

Content type
application/json
{
  • "message": "string"
}

List all order documents for an order

Retrieve all order documents for an order

path Parameters
id
required
integer
query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

fields
string

Comma-separated list of fields to include in the response

sort
string

A list of sort options (ex: name asc,created_at desc)

page
integer <int32>

Page of results to fetch

per_page
integer <int32>

Number of results to return per page

page_total
boolean

Include total count of results

page_links
boolean

Include prev/next links in response headers

Responses

Response samples

Content type
application/json
No sample

Create an order document for an order

Create an order document for an order

path Parameters
id
required
integer
Request Body schema: application/json
required
url
string

the order document file url

customer_id
integer <int32>

the order document customer id

document_type
string

the order document type

Responses

Request samples

Content type
application/json
{
  • "url": "string",
  • "customer_id": 0,
  • "document_type": "string"
}

Response samples

Content type
application/json
No sample

List all order items for an order

Retrieve all order items for an order

path Parameters
id
required
integer
query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

sort
string

A list of sort options (ex: name asc,created_at desc)

fields
string

Comma-separated list of fields to include in the response

page
integer <int32>

Page of results to fetch

per_page
integer <int32>

Number of results to return per page

page_total
boolean

Include total count of results

page_links
boolean

Include prev/next links in response headers

Responses

Response samples

Content type
application/json
No sample

Create an order item

Create an order item

path Parameters
id
required
integer
Request Body schema: application/json
required
item_id
integer <int32>

the order item item id

package_id
integer <int32>

the order item package id

quote_item_id
integer <int32>

the order item quote item id

sku
string

the SKU of this item

description
string

description for this order item. This will appear in packing slips. If not set, the description will be inherited from the parent Item.

quantity
integer <int32>

number of this item in Order

price
number <float>

price of this item

unshippable
boolean

is this item unshippable?

available
boolean

is this item available?

packed
integer <int32>

number of items packed

packaging
boolean

is this item packaging?

wholesale_cost
number <float>

wholesale cost of the item

is_bundle
boolean

is this item a bundle?

retail_fee
number <float>

retail fee of this item

promo
boolean

is this item a promo?

returnable
boolean

is this item returnable?

currency
string

currency code for this item

wholesale_fee
number <float>

wholesale fee of this item

hazmat
boolean

(deprecated) is the order item hazmat?

misc
string

miscellaneous information about the order item

request_serial_number
boolean

does the item require a serial number when shipping?

case_quantity
integer <int32>

How many of this item to a case?

carton_quantity
integer <int32>

How many CASES to a carton?

goh
boolean

Garment on hanger?

object
object

Hash of key value pairs (must conform to available meta keys)

object

Responses

Request samples

Content type
application/json
{
  • "item_id": 0,
  • "package_id": 0,
  • "quote_item_id": 0,
  • "sku": "string",
  • "description": "string",
  • "quantity": 0,
  • "price": 0.1,
  • "unshippable": true,
  • "available": true,
  • "packed": 0,
  • "packaging": true,
  • "wholesale_cost": 0.1,
  • "is_bundle": true,
  • "retail_fee": 0.1,
  • "promo": true,
  • "returnable": true,
  • "currency": "string",
  • "wholesale_fee": 0.1,
  • "hazmat": true,
  • "misc": "string",
  • "request_serial_number": true,
  • "case_quantity": 0,
  • "carton_quantity": 0,
  • "goh": true,
  • "originator_attributes": {
    },
  • "meta_fields": {
    },
  • "wholesale_item_attributes": {
    }
}

Response samples

Content type
application/json
No sample

Count order items

Returns count of order items

path Parameters
id
required
integer
query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

Responses

Response samples

Content type
application/json
No sample

List all serial numbers associated with an order item

Get the serial numbers for an order

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
No sample

Retrieve the Wholesale object for an order

get the Wholesale object for an order

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
No sample

originators

Originators are e-commerce, API, or ERP representations of an Item, Order, OrderItem, ConsumerReturn, Shipnotice, or ShipnoticeItem. They contain your system's ID and, optionally, details. You can use your own ID to retrieve, update, and destroy resources directly.

List originators

Get a list of originators

query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

sort
string

A list of sort options (ex: name asc,created_at desc)

originated_type
required
string

which resource originators you want

page
integer <int32>

Page of results to fetch

per_page
integer <int32>

Number of results to return per page

page_total
boolean

Include total count of results

page_links
boolean

Include prev/next links in response headers

Responses

Response samples

Content type
application/json
No sample

projects

Project management and organization.

List all project_tasks

Get a list of project_tasks

path Parameters
id
required
integer
query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

fields
string

Comma-separated list of fields to include in the response

sort
string

A list of sort options (ex: name asc,created_at desc)

page
integer <int32>

Page of results to fetch

per_page
integer <int32>

Number of results to return per page

page_total
boolean

Include total count of results

page_links
boolean

Include prev/next links in response headers

Responses

Response samples

Content type
application/json
No sample

shipnotice_items

Similar to an OrderItem, ShipnoticeItem represents an Item with a quantity in a Shipnotice. quantity refers to the quantity expected to arrive, and the quantity actually received is quantity_good.

List actions you can perform

Get resource actions

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

Count ship notice items

Returns count of shipnotice items

query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

Responses

Response samples

Content type
application/json
No sample

Retrieve a ship notice item

Get a shipnotice item

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
No sample

Update a ship notice item

Update a shipnotice item

path Parameters
id
required
integer
Request Body schema: application/json
required
quantity
integer <int32>

the number of this shipnotice item in the shipnotice

description
string

description of the item

extended_description
string

an extended description of the item

include_in_published
boolean

include this item in published amount?

purchase_order_number
string

the purchase order number associated with the shipnotice item

location_role
string

the location role into which the item is received. options: pickable (default), damaged, pending, backstock (staff only)

unit_cost
number <float>

Unit cost per item

Responses

Request samples

Content type
application/json
{
  • "quantity": 0,
  • "description": "string",
  • "extended_description": "string",
  • "include_in_published": true,
  • "purchase_order_number": "string",
  • "location_role": "string",
  • "unit_cost": 0.1
}

Response samples

Content type
application/json
No sample

Destroy a shipnotice item

Destroy a shipnotice item

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

List meta fields

Get the meta fields for a(n) ShipnoticeItem

path Parameters
id
required
integer
query Parameters
associations
Array of strings

Include meta fields for associations

Responses

Response samples

Content type
application/json
No sample

Set meta fields

Update ShipnoticeItem meta fields

path Parameters
id
required
integer
Request Body schema: application/json
required
fields
object

Hash of key/value pairs

association_fields
object

Included meta fields for associations

Responses

Request samples

Content type
application/json
{
  • "fields": { },
  • "association_fields": { }
}

Response samples

Content type
application/json
{
  • "message": "string"
}

shipnotices

A Shipnotice is the opposite of an order, and are notifications by the client of inventory that is expected to arrive at a warehouse. Shipnotices represent incoming stock.

List all ship notices

Get all shipnotices

query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

fields
string

Comma-separated list of fields to include in the response

sort
string

A list of sort options (ex: name asc,created_at desc)

page
integer <int32>

Page of results to fetch

per_page
integer <int32>

Number of results to return per page

page_total
boolean

Include total count of results

page_links
boolean

Include prev/next links in response headers

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    },
  • {
    }
]

Create a ship notice

Create a shipnotice

Request Body schema: application/json
required
sender
string

the shipnotice sender

eta
string <date-time>

the shipnotice estimated arrival date

warehouse_id
integer <int32>

the shipnotice warehouse id

status
integer <int32>

status of the shipnotice

received_by
string

the name of the person who received the shipnotice

notes_by_whiplash
string

notes by whiplash

notes_by_customer
string

notes by customer

total_boxes
integer <int32>

total number of boxes in the shipnotice

arrived_at
string <date-time>

the shipnotice arrival date and time

skip_images
boolean

allow skipping of images for this shipnotice?

easypostable_id
string

the ID of the easypost shipment or tracker

easypostable_type
string

the type of the easypost object (shipment or tracker)

shipping_label_url
string

url of the shipping label

ship_actual_cost
number <float>

the shipnotice actual cost of shipping

shipping_method_text
string

the method of shipping for the shipnotice

shipping_method_id
integer <int32>

shipping method id

tracking
string

the tracking number of the shipnotice

order_id
integer <int32>

the order_id of the shipnotice

type
string

shipnotice type (Shipnotice, ConsumerReturn)

postage_billed
boolean

was postage billed?

handling_billed
boolean

was handling billed?

ship_3rdparty_cost
number <float>

3rd party cost for the shipnotice

requires_label
boolean

does this shipnotice require a label?

completed_at
string <date-time>

the shipnotice completion date and time

ship_actual_currency
string

currency used for this shipnotice

delivered_at
string <date-time>

date when was the shipnoticed delivered

due_at
string <date-time>

date when the shipnotice is due to be delivered

meta_data
string

meta data for this shipnotice as stringified JSON

reference
string

purchase order number or other human readable token to another system

quantities_verified
object

JSON object of required and optional receiving quantities verified by staff

bol_proxy
string

BOL proxy for this shipnotice.

mid_code
string

MID code for this shipnotice.

zone_status
string

zone status of this shipnotice.

inspection_required
boolean

is inspection required? (default: false)

processing_started_at
string <date-time>

when the shipnotice entered Processing status

Array of objects
object
object

Hash of key value pairs (must conform to available meta keys)

carrier
string

Responses

Request samples

Content type
application/json
{
  • "sender": "string",
  • "eta": "2019-08-24T14:15:22Z",
  • "warehouse_id": 0,
  • "status": 0,
  • "received_by": "string",
  • "notes_by_whiplash": "string",
  • "notes_by_customer": "string",
  • "total_boxes": 0,
  • "arrived_at": "2019-08-24T14:15:22Z",
  • "skip_images": true,
  • "easypostable_id": "string",
  • "easypostable_type": "string",
  • "shipping_label_url": "string",
  • "ship_actual_cost": 0.1,
  • "shipping_method_text": "string",
  • "shipping_method_id": 0,
  • "tracking": "string",
  • "order_id": 0,
  • "type": "string",
  • "postage_billed": true,
  • "handling_billed": true,
  • "ship_3rdparty_cost": 0.1,
  • "requires_label": true,
  • "completed_at": "2019-08-24T14:15:22Z",
  • "ship_actual_currency": "string",
  • "delivered_at": "2019-08-24T14:15:22Z",
  • "due_at": "2019-08-24T14:15:22Z",
  • "meta_data": "string",
  • "reference": "string",
  • "quantities_verified": { },
  • "bol_proxy": "string",
  • "mid_code": "string",
  • "zone_status": "string",
  • "inspection_required": true,
  • "processing_started_at": "2019-08-24T14:15:22Z",
  • "shipnotice_items_attributes": [
    ],
  • "originator_attributes": {
    },
  • "meta_fields": {
    },
  • "carrier": "string"
}

Response samples

Content type
application/json
{
  • "id": 181657,
  • "customer_id": 3545,
  • "warehouse_id": 4,
  • "sender": "Gleason, Hane and Kautzer",
  • "eta": "2020-10-02T17:03:17.000-04:00",
  • "status": 100,
  • "status_name": "In Transit",
  • "received_by": null,
  • "notes_by_whiplash": null,
  • "notes_by_customer": null,
  • "total_boxes": null,
  • "created_at": "2020-09-16T17:03:17.000-04:00",
  • "updated_at": "2020-09-16T17:03:30.000-04:00",
  • "arrived_at": "2020-09-16T17:03:18.000-04:00",
  • "skip_images": null,
  • "easypostable_id": null,
  • "easypostable_type": "Shipment",
  • "shipping_label_url": null,
  • "ship_actual_cost": null,
  • "shipping_method_text": null,
  • "carrier": null,
  • "shipping_method_id": null,
  • "tracking": null,
  • "order_id": null,
  • "type": "Shipnotice",
  • "postage_billed": null,
  • "handling_billed": null,
  • "ship_3rdparty_cost": null,
  • "requires_label": true,
  • "completed_at": null,
  • "ship_actual_currency": null,
  • "delivered_at": "2020-09-16T17:03:18.000-04:00",
  • "due_at": "2020-09-21T16:00:00.000-04:00",
  • "meta_data": null,
  • "reference": null,
  • "shipnotice_item_count": 9,
  • "shipnotice_item_quantity": 160,
  • "customer": {
    },
  • "warehouse": {
    },
  • "originator": {
    },
  • "shipping_method": null,
  • "shipnotice_items": [
    ]
}

List actions you can perform

Get resource actions

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

Create shipnotices in bulk

Create shipnotices in bulk

Request Body schema: application/json
required
Array of objects

An array of shipnotice objects to create in bulk

Responses

Request samples

Content type
application/json
{
  • "resources": [
    ]
}

Response samples

Content type
application/json
No sample

Count ship notices

Returns count of shipnotices

query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

Responses

Response samples

Content type
application/json
No sample

Retrieve a ship notice

Get a Shipnotice

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "id": 181656,
  • "customer_id": 3545,
  • "warehouse_id": 6,
  • "sender": "Ruecker-Ullrich",
  • "eta": "2020-09-07T17:03:17.000-04:00",
  • "status": 200,
  • "status_name": "Processing",
  • "received_by": null,
  • "notes_by_whiplash": null,
  • "notes_by_customer": null,
  • "total_boxes": null,
  • "created_at": "2020-09-16T17:03:17.000-04:00",
  • "updated_at": "2020-09-16T17:03:30.000-04:00",
  • "arrived_at": "2020-09-16T17:03:30.000-04:00",
  • "skip_images": null,
  • "easypostable_id": null,
  • "easypostable_type": "Shipment",
  • "shipping_label_url": null,
  • "ship_actual_cost": null,
  • "shipping_method_text": null,
  • "carrier": null,
  • "shipping_method_id": null,
  • "tracking": null,
  • "order_id": null,
  • "type": "Shipnotice",
  • "postage_billed": null,
  • "handling_billed": null,
  • "ship_3rdparty_cost": null,
  • "requires_label": true,
  • "completed_at": null,
  • "ship_actual_currency": null,
  • "delivered_at": "2020-09-16T17:03:30.000-04:00",
  • "due_at": "2020-09-21T19:00:00.000-04:00",
  • "meta_data": null,
  • "reference": null,
  • "shipnotice_item_count": 7,
  • "shipnotice_item_quantity": 110,
  • "customer": {
    },
  • "warehouse": {
    },
  • "originator": {
    },
  • "shipping_method": null,
  • "shipnotice_items": [
    ]
}

Update a ship notice

Update a shipnotice

path Parameters
id
required
integer
Request Body schema: application/json
required
sender
string

the shipnotice sender

eta
string <date-time>

the shipnotice estimated arrival date

status
integer <int32>

status of the shipnotice

received_by
string

the name of the person who received the shipnotice

notes_by_whiplash
string

notes by whiplash

notes_by_customer
string

notes by customer

total_boxes
integer <int32>

total number of boxes in the shipnotice

arrived_at
string <date-time>

the shipnotice arrival date and time

skip_images
boolean

allow skipping of images for this shipnotice?

easypostable_id
string

the ID of the easypost shipment or tracker

easypostable_type
string

the type of the easypost object (shipment or tracker)

shipping_label_url
string

url of the shipping label

ship_actual_cost
number <float>

the shipnotice actual cost of shipping

shipping_method_text
string

the method of shipping for the shipnotice

shipping_method_id
integer <int32>

shipping method id

tracking
string

the tracking number of the shipnotice

type
string

shipnotice type (Shipnotice, ConsumerReturn)

postage_billed
boolean

was postage billed?

handling_billed
boolean

was handling billed?

ship_3rdparty_cost
number <float>

3rd party cost for the shipnotice

requires_label
boolean

does this shipnotice require a label?

completed_at
string <date-time>

the shipnotice completion date and time

ship_actual_currency
string

currency used for this shipnotice

delivered_at
string <date-time>

date when was the shipnoticed delivered

due_at
string <date-time>

date when the shipnotice is due to be delivered

meta_data
string

meta data for this shipnotice as stringified JSON

reference
string

purchase order number or other human readable token to another system

quantities_verified
object

JSON object of required and optional receiving quantities verified by staff

bol_proxy
string

BOL proxy for this shipnotice.

mid_code
string

MID code for this shipnotice.

zone_status
string

zone status of this shipnotice.

shipnotice_items
string
processing_started_at
string <date-time>

when the shipnotice entered Processing status

carrier
string

Responses

Request samples

Content type
application/json
{
  • "sender": "string",
  • "eta": "2019-08-24T14:15:22Z",
  • "status": 0,
  • "received_by": "string",
  • "notes_by_whiplash": "string",
  • "notes_by_customer": "string",
  • "total_boxes": 0,
  • "arrived_at": "2019-08-24T14:15:22Z",
  • "skip_images": true,
  • "easypostable_id": "string",
  • "easypostable_type": "string",
  • "shipping_label_url": "string",
  • "ship_actual_cost": 0.1,
  • "shipping_method_text": "string",
  • "shipping_method_id": 0,
  • "tracking": "string",
  • "type": "string",
  • "postage_billed": true,
  • "handling_billed": true,
  • "ship_3rdparty_cost": 0.1,
  • "requires_label": true,
  • "completed_at": "2019-08-24T14:15:22Z",
  • "ship_actual_currency": "string",
  • "delivered_at": "2019-08-24T14:15:22Z",
  • "due_at": "2019-08-24T14:15:22Z",
  • "meta_data": "string",
  • "reference": "string",
  • "quantities_verified": { },
  • "bol_proxy": "string",
  • "mid_code": "string",
  • "zone_status": "string",
  • "shipnotice_items": "string",
  • "processing_started_at": "2019-08-24T14:15:22Z",
  • "carrier": "string"
}

Response samples

Content type
application/json
{
  • "id": 181657,
  • "customer_id": 3545,
  • "warehouse_id": 4,
  • "sender": "Gleason, Hane and Kautzer",
  • "eta": "2020-10-02T17:03:17.000-04:00",
  • "status": 100,
  • "status_name": "In Transit",
  • "received_by": null,
  • "notes_by_whiplash": null,
  • "notes_by_customer": null,
  • "total_boxes": null,
  • "created_at": "2020-09-16T17:03:17.000-04:00",
  • "updated_at": "2020-09-16T17:03:30.000-04:00",
  • "arrived_at": "2020-09-16T17:03:18.000-04:00",
  • "skip_images": null,
  • "easypostable_id": null,
  • "easypostable_type": "Shipment",
  • "shipping_label_url": null,
  • "ship_actual_cost": null,
  • "shipping_method_text": null,
  • "carrier": null,
  • "shipping_method_id": null,
  • "tracking": null,
  • "order_id": null,
  • "type": "Shipnotice",
  • "postage_billed": null,
  • "handling_billed": null,
  • "ship_3rdparty_cost": null,
  • "requires_label": true,
  • "completed_at": null,
  • "ship_actual_currency": null,
  • "delivered_at": "2020-09-16T17:03:18.000-04:00",
  • "due_at": "2020-09-21T16:00:00.000-04:00",
  • "meta_data": null,
  • "reference": null,
  • "shipnotice_item_count": 9,
  • "shipnotice_item_quantity": 160,
  • "customer": {
    },
  • "warehouse": {
    },
  • "originator": {
    },
  • "shipping_method": null,
  • "shipnotice_items": [
    ]
}

Destroy a ship notice

Destroy a shipnotice

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}

List meta fields

Get the meta fields for a(n) Shipnotice

path Parameters
id
required
integer
query Parameters
associations
Array of strings

Include meta fields for associations

Responses

Response samples

Content type
application/json
No sample

Set meta fields

Update Shipnotice meta fields

path Parameters
id
required
integer
Request Body schema: application/json
required
fields
object

Hash of key/value pairs

association_fields
object

Included meta fields for associations

Responses

Request samples

Content type
application/json
{
  • "fields": { },
  • "association_fields": { }
}

Response samples

Content type
application/json
{
  • "message": "string"
}

Count orders waiting for stock in a ship notice

Get the count of orders waiting for the shipnotice

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
No sample

List associated ship notice items

List all shipnotice items for a(n) shipnotice

path Parameters
id
required
integer
query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

fields
string

Comma-separated list of fields to include in the response

sort
string

A list of sort options (ex: name asc,created_at desc)

page
integer <int32>

Page of results to fetch

per_page
integer <int32>

Number of results to return per page

page_total
boolean

Include total count of results

page_links
boolean

Include prev/next links in response headers

Responses

Response samples

Content type
application/json
No sample

Create a ship notice item

create a shipnotice item

path Parameters
id
required
integer
Request Body schema: application/json
required
quantity
integer <int32>

the number of this shipnotice item in the shipnotice

item_id
integer <int32>

the shipnotice item item id

return_action
string

action to perform on item return

description
string

description of the item

extended_description
string

an extended description of the item

include_in_published
boolean

include this item in published amount?

purchase_order_number
string

the purchase order number associated with the shipnotice item

location_role
string

the location role into which the item is received. options: pickable (default), damaged, pending, backstock (staff only)

unit_cost
number <float>

Unit cost per item

object
object
object

Hash of key value pairs (must conform to available meta keys)

Responses

Request samples

Content type
application/json
{
  • "quantity": 0,
  • "item_id": 0,
  • "return_action": "string",
  • "description": "string",
  • "extended_description": "string",
  • "include_in_published": true,
  • "purchase_order_number": "string",
  • "location_role": "string",
  • "unit_cost": 0.1,
  • "originator_attributes": {
    },
  • "lot_attributes": {
    },
  • "meta_fields": {
    }
}

Response samples

Content type
application/json
No sample

Count associated ship notice items

Get a count of shipnotice items for a(n) shipnotice

path Parameters
id
required
integer
query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

Responses

Response samples

Content type
application/json
No sample

simulate

(Sandbox Only) Simulate Order and Ship Notice processing, since these are staff-only operations.

Create a consumer return with simulated data

Create a consumer_return with simulated data

Request Body schema: application/json
required
consumer_return_id
integer <int32>

ConsumerReturn id

Responses

Request samples

Content type
application/json
{
  • "consumer_return_id": 0
}

Response samples

Content type
application/json
No sample

Simulate processing for an consumer return

Simulate processing for a consumer_return, received through finalized

path Parameters
consumer_return_id
required
integer
Request Body schema: application/json
required
finalize
boolean

Finalize this ConsumerReturn

Responses

Request samples

Content type
application/json
{
  • "finalize": true
}

Response samples

Content type
application/json
No sample

Create an order with simulated data

Create an order with simulated data

Request Body schema: application/json
required
order_id
integer <int32>

Order id

Responses

Request samples

Content type
application/json
{
  • "order_id": 0
}

Response samples

Content type
application/json
No sample

Simulate processing for an order

Simulate processing for an order, packed through shipped

path Parameters
order_id
required
integer
Request Body schema: application/json
required
status
string
Enum: "batched" "packed" "shipped"

The target status for this order

Responses

Request samples

Content type
application/json
{
  • "status": "batched"
}

Response samples

Content type
application/json
{
  • "id": 2650031,
  • "customer_id": 3545,
  • "order_batch_id": null,
  • "quote_id": null,
  • "warehouse_id": 1,
  • "return_warehouse_id": 1,
  • "shipping_method_id": null,
  • "estimated_shipping_method_id": null,
  • "humanize_id": "2650031-KA11982",
  • "status": 100,
  • "status_name": "Processing",
  • "previous_status": 100,
  • "order_orig": "KA11982",
  • "level1_token": "2da3b2a9fcefb88315c55c2aeaa332db",
  • "level2_token": "25ba76e38a12056440d59f4251a17154",
  • "workable_at": "2020-09-16T18:03:17.000-04:00",
  • "skip_street_date": false,
  • "due_at": "2020-09-17T16:00:00.000-04:00",
  • "created_at": "2020-09-16T17:03:17.000-04:00",
  • "updated_at": "2020-09-16T17:03:17.000-04:00",
  • "meta_data": null,
  • "customer_provided_label_carrier": null,
  • "purchase_order": null,
  • "email": "williehane@borer.co",
  • "address_verified": true,
  • "address_message": null,
  • "shop_warehouse_ids": [ ],
  • "shop_shipping_method_currency": null,
  • "shop_created_at": null,
  • "shop_updated_at": null,
  • "shop_shipping_method_text": null,
  • "shop_shipping_method_price": "0.0",
  • "billing_company": null,
  • "billing_address_1": null,
  • "billing_address_2": null,
  • "billing_address_3": null,
  • "billing_city": null,
  • "billing_state": null,
  • "billing_zip": null,
  • "billing_country": null,
  • "billing_phone": null,
  • "billed": false,
  • "billing_name": null,
  • "first_name": null,
  • "last_name": null,
  • "full_name": null,
  • "shipping_name": "Joanne Mraz",
  • "shipping_company": null,
  • "shipping_address_1": "54295 O'Connell Lakes",
  • "shipping_address_2": null,
  • "shipping_city": "South Claritaton",
  • "shipping_state": "Georgia",
  • "shipping_zip": "46735",
  • "shipping_country": "United States",
  • "shipping_country_iso2": "US",
  • "shipping_phone": null,
  • "requested_address": "54295 O'Connell Lakes\nSouth Claritaton, Georgia 46735\nUnited States",
  • "residential": true,
  • "require_signature": false,
  • "require_adult_signature": false,
  • "saturday_delivery": false,
  • "gift": false,
  • "insure": false,
  • "contains_alcohol": false,
  • "ship_actual_cost": null,
  • "shipped_on": null,
  • "ship_notes": null,
  • "shipping_confirmation_sent": false,
  • "ship_3rdparty_cost": "0.0",
  • "ship_3rdparty_account": null,
  • "ship_3rdparty_zip": null,
  • "ship_3rdparty_country": null,
  • "incoterm": null,
  • "public_note": null,
  • "days_in_transit": 1,
  • "days_in_transit_carrier_estimate": null,
  • "req_insurance_value": null,
  • "ship_method": null,
  • "packingslip_pdf_url": null,
  • "tracking": [ ],
  • "tracking_links": [
    ],
  • "approximate_delivery_date": null,
  • "return_name": null,
  • "return_company": null,
  • "return_address_1": null,
  • "return_address_2": null,
  • "return_city": null,
  • "return_state": null,
  • "return_country": null,
  • "return_zip": null,
  • "return_phone": null,
  • "return_email": null,
  • "return_address_verified": null,
  • "return_time_limit": null,
  • "order_items": [
    ],
  • "originator": {
    },
  • "proto_originator_id": null,
  • "packages": [
    ],
  • "shipping_method": null,
  • "serial_numbers": [ ]
}

Create a shipnotice with simulated data

Create a shipnotice with simulated data

Request Body schema: application/json
required
shipnotice_id
integer <int32>

Shipnotice id

Responses

Request samples

Content type
application/json
{
  • "shipnotice_id": 0
}

Response samples

Content type
application/json
{
  • "id": 181657,
  • "customer_id": 3545,
  • "warehouse_id": 4,
  • "sender": "Gleason, Hane and Kautzer",
  • "eta": "2020-10-02T17:03:17.000-04:00",
  • "status": 100,
  • "status_name": "In Transit",
  • "received_by": null,
  • "notes_by_whiplash": null,
  • "notes_by_customer": null,
  • "total_boxes": null,
  • "created_at": "2020-09-16T17:03:17.000-04:00",
  • "updated_at": "2020-09-16T17:03:30.000-04:00",
  • "arrived_at": "2020-09-16T17:03:18.000-04:00",
  • "skip_images": null,
  • "easypostable_id": null,
  • "easypostable_type": "Shipment",
  • "shipping_label_url": null,
  • "ship_actual_cost": null,
  • "shipping_method_text": null,
  • "carrier": null,
  • "shipping_method_id": null,
  • "tracking": null,
  • "order_id": null,
  • "type": "Shipnotice",
  • "postage_billed": null,
  • "handling_billed": null,
  • "ship_3rdparty_cost": null,
  • "requires_label": true,
  • "completed_at": null,
  • "ship_actual_currency": null,
  • "delivered_at": "2020-09-16T17:03:18.000-04:00",
  • "due_at": "2020-09-21T16:00:00.000-04:00",
  • "meta_data": null,
  • "reference": null,
  • "shipnotice_item_count": 9,
  • "shipnotice_item_quantity": 160,
  • "customer": {
    },
  • "warehouse": {
    },
  • "originator": {
    },
  • "shipping_method": null,
  • "shipnotice_items": [
    ]
}

Simulate processing for an ship notice

Simulate processing for a shipnotice, received through finalized

path Parameters
shipnotice_id
required
integer
Request Body schema: application/json
required
finalize
boolean

Finalize this Shipnotice

randomize_receiving
boolean

Randomize quantity to receive on this Shipnotice

Responses

Request samples

Content type
application/json
{
  • "finalize": true,
  • "randomize_receiving": true
}

Response samples

Content type
application/json
No sample

templates

Templates allow you to customize packing slips, email confirmations, order inserts, etc.

List all templates

Get a list of templates

query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

page
integer <int32>

Page of results to fetch

per_page
integer <int32>

Number of results to return per page

page_total
boolean

Include total count of results

page_links
boolean

Include prev/next links in response headers

Responses

Response samples

Content type
application/json
No sample

Create a template

Create a template

Request Body schema: application/json
required
name
string

Name of the template

template_type_id
integer <int32>

ID of the template type

content
string

Content of the template

default
boolean

Is the default template

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "template_type_id": 0,
  • "content": "string",
  • "default": true
}

Response samples

Content type
application/json
No sample

Retrieve a template

Get a template

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
No sample

Update a template

Update a template

path Parameters
id
required
integer
Request Body schema: application/json
required
name
string

Name of the template

content
string

Content of the template

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "content": "string"
}

Response samples

Content type
application/json
No sample

Destroy a template

Destroy a template

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
No sample

wholesale_items

List all wholesale item objects

Returns all wholesale item objects

query Parameters
search
string

JSON search string like {"attribute_eq": "Term"}

fields
string

Comma-separated list of fields to include in the response

sort
string

A list of sort options (ex: name asc,created_at desc)

page
integer <int32>

Page of results to fetch

per_page
integer <int32>

Number of results to return per page

page_total
boolean

Include total count of results

page_links
boolean

Include prev/next links in response headers

Responses

Response samples

Content type
application/json
No sample

Retrieve a Wholesale item object

get a Wholesale item object

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
No sample

Update a wholesale item object

Update a wholesale item object

path Parameters
id
required
integer
Request Body schema: application/json
required
order_item_id
integer <int32>

the associated order item id

line_no
string

the line number

item_alias
string

the item alias

item_color
string

the item color

item_size
string

the item size

vendor_part_number
string

the vendor part number

buyer_part_number
string

the buyer part number

consumer_package_code
string

the consumer package code

outer_pack_value
string

the outer pack value

inner_pack_value
string

the inner pack value

size_description
string

the size description

color_description
string

the color description

upc
string

the UPC

description
string

the description

style
string

the style

ean
string

the EAN

alternate_item_number
string

the alternate item number

alternate_barcode
string

the alternate barcode

alternate_sku
string

the alternate SKU

lot
string

the lot

ih_category
string

the IH category

Responses

Request samples

Content type
application/json
{
  • "order_item_id": 0,
  • "line_no": "string",
  • "item_alias": "string",
  • "item_color": "string",
  • "item_size": "string",
  • "vendor_part_number": "string",
  • "buyer_part_number": "string",
  • "consumer_package_code": "string",
  • "outer_pack_value": "string",
  • "inner_pack_value": "string",
  • "size_description": "string",
  • "color_description": "string",
  • "upc": "string",
  • "description": "string",
  • "style": "string",
  • "ean": "string",
  • "alternate_item_number": "string",
  • "alternate_barcode": "string",
  • "alternate_sku": "string",
  • "lot": "string",
  • "ih_category": "string"
}

Response samples

Content type
application/json
No sample

Delete a wholesale item object

Delete a wholesale item object

path Parameters
id
required
integer

Responses

Response samples

Content type
application/json
{
  • "message": "string"
}