Lookup for Date | TaxCloud

Lookup applicable tax amounts, based on a particular date, for items being purchased based on a variety of factors.

Request

Lookup Request for a particular date

apiLoginIDstringRequired7-8 characters

Find your API ID via https://app.taxcloud.com/go/stores/

Find your API ID via <a href="https://app.taxcloud.com/go/stores/" target="_blank">https://app.taxcloud.com/go/stores/</a>

apiKeystringRequired=8 characters

Find your API KEY via https://app.taxcloud.com/go/stores/

Find your API KEY via <a href="https://app.taxcloud.com/go/stores/" target="_blank">https://app.taxcloud.com/go/stores/</a>

customerIDstringRequired5-50 characters

This should be the abstract identifier used by your system to uniquely identify customers. Note: This should not be your customer’s email address or any other form of Personally Identifiable Information (PII).

deliveredBySellerbooleanRequiredDefaults to false

If you ship orders to customers via common carrier (USPS, UPS, FedEx, etc) should always be false.

originobjectRequired

destinationobjectRequired

cartItemslist of objectsRequired

useDatestringOptionalformat: "date-time"

Rather than inferring the Lookup date, specify the Lookup date.

cartIDstringOptionalformat: "uuid"5-50 characters

CartID is very similar to an Order ID, except most systems do not issue immutable (permanent) identifiers for orders until customers actually place their order (clicking the BUY button).

Something went wrong!

You must be able to persist the CartID accross all Lookup requests for a particular customer (including situations where a customer puts an item in her cart before logging in, then proceeds ordering after logging in).

If your system does not provide a mechanism to create unique identifiers, you can omit this parameter (or submit as null) and TaxCloud will provide a unique identifier in the response (which you should persist for subsequent Lookup calls and the ultimate Authorized or AuthorizedWithCapture calls).

CartID is very similar to an Order ID, except most systems do not issue immutable (permanent) identifiers for orders until customers actually place their order (clicking the BUY button).<div>IMPORTANT: You must be able to persist the CartID accross all Lookup requests for a particular customer (including situations where a customer puts an item in her cart before logging in, then proceeds ordering after logging in).If your system does not provide a mechanism to create unique identifiers, you can omit this parameter (or submit as null) and TaxCloud will provide a unique identifier in the response (which you should persist for subsequent Lookup calls and the ultimate Authorized or AuthorizedWithCapture calls).</div>

Response

LookupResultobject or null

CartID is very similar to an Order ID, except most systems do not issue immutable (permanent) identifiers for orders until customers actually place their order (clicking the BUY button).

Something went wrong!

1	import requests
2
3	url = "https://api.taxcloud.net/1.0/TaxCloud/LookupForDate"
4
5	payload = {
6	"apiLoginID": "2D7D820",
7	"apiKey": "0946110c-2aa9-4387-ad5c-4e1c551b8d0c",
8	"customerID": "CustomerX23",
9	"deliveredBySeller": False,
10	"origin": {
11	"Address1": "162 East Avenue",
12	"City": "Norwalk",
13	"State": None,
14	"Zip5": 6850,
15	"Zip4": 5720
16	},
17	"destination": {
18	"Address1": "162 East Avenue",
19	"City": "Norwalk",
20	"State": None,
21	"Zip5": 6850,
22	"Zip4": 5720
23	},
24	"cartItems": [
25	{
26	"Index": 0,
27	"ItemID": "ProductX23",
28	"TIC": 0,
29	"Price": 19.9,
30	"Qty": 2
31	}
32	]
33	}
34	headers = {"Content-Type": "application/json"}
35
36	response = requests.post(url, json=payload, headers=headers)
37
38	print(response.json())

1	{
2	"LookupResult": {
3	"CartID": "Cart2342534235",
4	"CartItemsResponse": [
5	{
6	"CartItemIndex": 0,
7	"TaxAmount": 2.65
8	}
9	],
10	"ResponseType": {
11	"value": 0
12	},
13	"Messages": [
14	"string"
15	]
16	}
17	}