POST
/
v1
/
retailers
/
{retailer_pk}
/
sales-orders
/

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

retailer_pk
number
required

Retailer ID

Body

application/json
purchase_order_number
string
required

Purchase order number

Minimum length: 1
ordered_at
string
required

Time of order finalization (UTC format)

customer_order_number
string | null

Customer order number

Maximum length: 64
retailer_order_number
string

Retailer order number

Minimum length: 1
brand_identifier
string | null

Vendor identifier

Maximum length: 64
retailer
object
brand
object
connection_id
integer

A numeric connection ID

shipping_method
object
requested_shipping_method_id
integer

ID of the requested shipping method

requested_shipping_method
object
bill_to
object
sold_to
object
ship_to
object
ship_from
object
return_to
object
allow_shipping_label_generation
boolean

true: Automatically generates shipping labels based on the carrier <br /> false: Does not support generation of shipping labels

shipping_charged
string

Shipped charged

is_gift
boolean

true: Order is a gift <br /> false: Order is not a gift

gift_fee
string | null

Gift fee (if applicable)

is_replacement
boolean

true: order is a replacement <br /> false: order is not a replacement

currency
object
acknowledged_at
string | null

Time of order acknowledgement (UTC format)

fulfilled_at
string | null

Time of order fulfillment (UTC format)

pickup_on
string | null

Time of when order was picked up (UTC format)

on_hold_at
string | null

Time of when order got placed on hold (UTC format)

on_hold_until
string | null

Date till when the order will be on hold

backordered_until
string | null

Time till when product or order is backordered (UTC format)

backorder_acknowledged_at
string | null

Time of backorder acknowledgement (UTC format)

canceled_at
string | null

Time of order cancellation (UTC format)

fill_time
string | null

Fill time

signature
enum<string> | null

Represents whether signature is required

Available options:
required,
not_required,
adult
connection_shipping_provider_account
object
is_priority
boolean

true: Priority order <br /> false: Not a priority order

priority_user
object

Response

201 - application/json
purchase_order_number
string
required

Purchase order number

Minimum length: 1
ordered_at
string
required

Time of order finalization (UTC format)

id
integer

Order ID

customer_order_number
string | null

Customer order number

Maximum length: 64
retailer_order_number
string

Retailer order number

Minimum length: 1
brand_identifier
string | null

Vendor identifier

Maximum length: 64
retailer
object
brand
object
brands
object[]
connection_id
integer

A numeric connection ID

shipping_method
object
requested_shipping_method_id
integer

ID of the requested shipping method

requested_shipping_method
object
shipment_count
integer

Shipment count

invoice_count
integer

Invoice count

bill_to
object
sold_to
object
ship_to
object
ship_from
object
return_to
object
allow_shipping_label_generation
boolean

true: Automatically generates shipping labels based on the carrier <br /> false: Does not support generation of shipping labels

subtotal_charged
string

Subtotal amount excluding shipping

shipping_charged
string

Shipped charged

is_gift
boolean

true: Order is a gift <br /> false: Order is not a gift

gift_fee
string | null

Gift fee (if applicable)

is_replacement
boolean

true: order is a replacement <br /> false: order is not a replacement

status
string

Order status

Minimum length: 1
currency
object
is_acknowledged
boolean

true: Order is acknowledged <br /> false: Order is not acknowledged

acknowledged_at
string | null

Time of order acknowledgement (UTC format)

fulfill_by
string

Time when order will be completely fulfilled (UTC format)

fulfilled_at
string | null

Time of order fulfillment (UTC format)

closed_at
string

Time of complete order fulfillment (UTC format)

received_at
string

Time of when order was received (UTC format)

is_on_hold
boolean

true: Order is on hold <br /> false: Order is not on hold

pickup_on
string | null

Time of when order was picked up (UTC format)

on_hold_at
string | null

Time of when order got placed on hold (UTC format)

on_hold_until
string | null

Date till when the order will be on hold

backordered_until
string | null

Time till when product or order is backordered (UTC format)

backorder_acknowledged_at
string | null

Time of backorder acknowledgement (UTC format)

canceled_at
string | null

Time of order cancellation (UTC format)

updated_at
string

Time of order update (UTC format)

order_lines
object[]
cancels
object[]
shipments
object[]
attachments
object[]
memos
object[]
memos_count
integer

Total memos

unread_memos_count
integer

Number of unread memos

tags
object[]
gift_message
string

Gift message

fill_time
string | null

Fill time

invoices
object[]
signature
enum<string> | null

Represents whether signature is required

Available options:
required,
not_required,
adult
rmas
object[]
credits
object[]
order_batches
object[]
metadata
object[]
connection_shipping_provider_account
object
is_priority
boolean

true: Priority order <br /> false: Not a priority order

priority_user
object
envelopes
object[]