Legacy APIAdvanced

Returned Pro

Return or adjust a previously Captured transaction. [Additional License Required]. Our regular Returned API does not allow you to return (adjust) the original sales price. ReturnedPro enables you to Return a negative quantity, thereby increasing the original sales price (such as when a customer doesn’t want to wait for a back-ordered item, and opts for a more expensive product instead).

Request

Return or adjust a previously Captured transaction
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
ReturnedProResultobject or null