Legacy APIEssentials

Returned

Return an entire order previously Captured.

Request

Return a previously captured order
apiLoginIDstringRequired>=7 characters<=8 characters

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

apiKeystringRequired=8 characters

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

orderIDstringRequired>=5 characters<=50 characters
This is the immutable Order identifier used by your system to idenitify unique orders.
cartItemslist of lists of objectsOptional
returnedDatestringOptionalformat: "date-time"

The Date/Time the order was returned. IMPORTANT: Returning a previously captured order will create a tax credit which TaxCloud will automatically track and deduct from your next tax remittance.

Although our Returned API requires you to set the ReturnedDate parameter, this should be set to today’s date unless you know what you are doing.

TO BE VERY CLEAR: If you provide a returnedDate, such as the original purchase date, and the tax return for that period has already been filed, you will trigger an obligation for TaxCloud (or any tax preparer) to file an Amended Sales Tax Return for that period (and likely any interviening period through current). AMENDED RETURNS INCUR AMENDMENT FEES.

Response

OK
ReturnedResultobject or null