For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
Help CenterSign Up
GuidesAPI Reference
GuidesAPI Reference
  • Sales Tax API
    • GETHealth
      • POSTCalculate sales tax for one or more carts
      • POSTCreate an order from a cartID
  • Management API
    • API Disclaimer
Help CenterSign Up
Sales Tax APICart

Create an order from a cartID

POST
https://api.v3.taxcloud.com/tax/connections/:connectionId/carts/orders
POST
/tax/connections/:connectionId/carts/orders
$curl -X POST https://api.v3.taxcloud.com/tax/connections/25eb9b97-5acb-492d-b720-c03e79cf715a/carts/orders \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "cartId": "my-cart-1",
>  "orderId": "my-order-1"
>}'
1{
2  "channel": "amazon",
3  "connectionId": "25eb9b97-5acb-492d-b720-c03e79cf715a",
4  "currency": {
5    "currencyCode": "string"
6  },
7  "customerId": "string",
8  "deliveredBySeller": true,
9  "destination": {
10    "city": "Minneapolis",
11    "countryCode": "US",
12    "line1": "323 Washington Ave N",
13    "state": "MN",
14    "zip": "55401-2427",
15    "line2": "string"
16  },
17  "excludeFromFiling": false,
18  "exemption": {
19    "exemptionId": "string",
20    "isExempt": true
21  },
22  "kind": "credit",
23  "lineItems": [
24    {
25      "index": 0,
26      "itemId": "item-1",
27      "originalPrice": 12,
28      "price": 10.75,
29      "quantity": 1.5,
30      "tax": {
31        "amount": 1.31,
32        "rate": 0.08125
33      },
34      "tic": 0
35    }
36  ],
37  "orderId": "string",
38  "origin": {
39    "city": "Minneapolis",
40    "countryCode": "US",
41    "line1": "323 Washington Ave N",
42    "state": "MN",
43    "zip": "55401-2427",
44    "line2": "string"
45  },
46  "transactionDate": "2024-01-15T09:30:00Z",
47  "$schema": "https://example.com/tax/schemas/OrderResponse.json",
48  "batchId": "string",
49  "completedDate": "2024-01-15T09:30:00Z",
50  "refunds": [
51    {
52      "connectionId": "25eb9b97-5acb-492d-b720-c03e79cf715a",
53      "items": [
54        {
55          "index": 1,
56          "itemId": "string",
57          "price": 1.1,
58          "quantity": 1.1,
59          "tax": {
60            "amount": 1.1
61          },
62          "tic": 0
63        }
64      ],
65      "batchId": "string",
66      "createdDate": "2024-01-15T09:30:00Z",
67      "returnedDate": "2024-01-15T09:30:00Z"
68    }
69  ]
70}
Use this endpoint to convert an existing cart into a full order that will be filed. We recommend doing this when customer checks out or the order has been submitted, rather than when payment is collected. Note that the transactionDate will be the moment the endpoint is called.
Was this page helpful?
Previous

Create Exemption Certificate

Next
Built with

Authentication

AuthorizationBearer
This authentication type can be used to directly call the service.
OR
X-API-KEYstring
This authentication type is supported by using the provided API key for the merchant account.

Path parameters

connectionIdstringRequired>=36 characters
represents the ID of a connection. It is used as a unique identifier for the connection

Request

This endpoint expects an object.
cartIdstringRequired1-50 characters
Id that represents this cart.
orderIdstringRequired1-50 characters
orderId in external system
completedbooleanOptionalDefaults to false
was the order shipped, creating a tax liability.
kindenumOptionalDefaults to order
The kind of order to create. Defaults to 'order'. Use 'credit' for credit orders.
Allowed values:

Response

Created
channelstring or null
what channel did this come from
connectionIdstring>=36 characters
represents the ID of a connection. It is used as a unique identifier for the connection
currencyobject
represents information about a currency including its code and denomination.
customerIdstring
customerId in external system
deliveredBySellerboolean
represents if the seller directly delivered the order.
destinationobject
the destination address of the order
excludeFromFilingbooleanDefaults to false
Whether to exclude from filing
exemptionobject
information about exemption on the order
kindenum
The kind of order, either credit or order. Defaults to order if not provided.
Allowed values:
lineItemslist of objects
orderIdstring
orderId in external system
originobject
the origin address of the order
transactionDatestringformat: "date-time"
The RFC3339 datetime string the order was purchased on
$schemastringRead-onlyformat: "uri"
A URL to the JSON Schema for this object.
batchIdstring
Batch ID for grouping orders
completedDatestringformat: "date-time"
The RFC3339 datetime string the order was shipped on, created a tax liability
refundslist of objects

refunds associated with this order when expand=refunds is specified

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error