orders

Create Order

Create orders from marketplace transactions, pre-existing systems, or bulk uploads.

post/tax/connections/{connectionId}/orders

Request

  • Base URL: https://api.v3.taxcloud.com
  • URL: https://api.v3.taxcloud.com/tax/connections/{connectionId}/orders
  • Auth: HTTP bearer

Path parameters

connectionIdstring required

represents the ID of a connection. It is used as a unique identifier for the connection

Query parameters

addressAutocomplete'none' | 'origin' | 'destination' | 'all'

The specified addresses (origin, destination, or all) will be overridden with the first result from an address validation search

Request body

$schemastring uri

A URL to the JSON Schema for this object.

batchIdstring

Optional batch ID for grouping orders

channelstring

what channel did this come from. Pass in one of amazon,ebay,walmart for tax exclusion

completedDatestring date-time required

The RFC3339 datetime string the order was shipped on, created a tax liability

customerIdstring required

customerId in external system

deliveredBySellerboolean

represents if the seller directly delivered the order.

excludeFromFilingboolean

When true, the order is recorded but omitted from the filed sales tax return (no tax liability). Defaults to false. Typically for orders whose tax is filed elsewhere, e.g. a marketplace facilitator.

kind'credit' | 'order'

The kind of order, either credit or order. Defaults to order if not provided.

orderIdstring required

orderId in external system

transactionDatestring date-time required

The RFC3339 datetime string the order was purchased on

Response

Created

$schemastring uri

A URL to the JSON Schema for this object.

batchIdstring

Batch ID for grouping orders

channelstring nullable required

what channel did this come from

completedDatestring date-time

The RFC3339 datetime string the order was shipped on, created a tax liability

connectionIdstring required

represents the ID of a connection. It is used as a unique identifier for the connection

customerIdstring required

customerId in external system

deliveredBySellerboolean required

represents if the seller directly delivered the order.

excludeFromFilingboolean required

Whether to exclude from filing

kind'credit' | 'order' required

The kind of order, either credit or order. Defaults to order if not provided.

orderIdstring required

orderId in external system

transactionDatestring date-time required

The RFC3339 datetime string the order was purchased on

Changes

No recorded changes to this operation across all 1 revision of this API.