APConfigSetting

Accounts

Addresses

AvaFileForms

Batches

CertExpressInvites

Certificates

CommunicationCertificates

Compliance

Contacts

CostCenter

Customers

DataSources

Definitions

DistanceThresholds

DomainControlVerification

ECommerceToken

EcmEventNotifications

FirmClientLinkages

FundingRequests

GLAccount

JurisdictionOverrides

Locations

MultiDocument

Nexus

Notices

Notifications

Provisioning

Registrar

Reports

Settings

Subscriptions

TaxCodes

TaxContent

TaxRules

Upcs

UserDefinedFields

Users

Utilities

Models

Top 10 EndPoints

AvaTax API

REST interface to Avalara's enterprise tax service, AvaTax.

Check top 10 endpoints

MultiDocument

VoidMultiDocumentTransaction

Void a MultiDocument transaction

Voids the current transaction uniquely identified by this URL.

A transaction represents a unique potentially taxable action that your company has recorded, and transactions include actions like sales, purchases, inventory transfer, and returns (also called refunds).

When you void a transaction, that transaction's status is recorded as DocVoided.

Transactions that have been previously reported to a tax authority by Avalara Managed Returns Service are considered locked, and they are no longer available to be voided.

NOTE: If your companyCode or transactionCode contains any of these characters /, +, ? or a space please use the following encoding before making a request:

Replace '/' with '_-ava2f-_' For example: document/Code becomes document_-ava2f-_Code
Replace '+' with '_-ava2b-_' For example: document+Code becomes document_-ava2b-_Code
Replace '?' with '_-ava3f-_' For example: document?Code becomes document_-ava3f-_Code
Replace '%' with '_-ava25-_' For example: document%Code becomes document_-ava25-_Code
Replace '#' with '_-ava23-_' For example: document#Code becomes document_-ava23-_Code
Replace ' ' with '%20' For example: document Code becomes document%20Code

Security Policies

This API requires one of the following user roles: AccountAdmin, AccountOperator, BatchServiceAdmin, CompanyAdmin, CSPTester, ProStoresOperator, SSTAdmin, TechnicalSupportAdmin.
This API depends on the following active services:Required (all): AvaTaxPro.

VoidMultiDocumentTransaction

VoidMultiDocumentTransaction

POSThttps://sandbox-rest.avatax.com/api/v2/transactions/multidocument/{code}/type/{type}/void

SAMPLE

PARAMETERS

Request

Curl

cURL

1curl -g 'https://sandbox-rest.avatax.com/api/v2/transactions/multidocument/{code}/type/{type}/void' \
2-H 'X-Avalara-Client: {X-Avalara-Client}' \
3-H 'Authorization: Basic <Base64-encoded credentials>' \
4-H 'Content-Type: application/json' \
5-d '{"code":"DocVoided"}'

Response

HEADER

Content-type: application/json

BODY

1{
2 	"id": 12,
3 	"accountId": 123456,
4 	"code": "64199fc8-d5b7-428c-b755-12cfed47f7c3",
5 	"type": "SalesInvoice",
6 	"createdUserId": 87954,
7 	"createdDate": "2025-05-02T00:00:00+00:00",
8 	"modifiedDate": "2025-05-02T00:00:00+00:00",
9 	"modifiedUserId": 66783,
10 	"documents": [
11 	 	{
12 	 	 	"id": 123456789,
13 	 	 	"code": "5e24b627-df93-4e2a-ab35-8d9b6eadd2b7",
14 	 	 	"companyId": 12345,
15 	 	 	"date": "2025-05-02",
16 	 	 	"status": "Committed",
17 	 	 	"type": "SalesInvoice",
18 	 	 	"currencyCode": "USD",
19 	 	 	"exchangeRateCurrencyCode": "USD",
20 	 	 	"entityUseCode": "",
21 	 	 	"customerVendorCode": "ABC",
22 	 	 	"customerCode": "ABC",
23 	 	 	"exemptNo": "",
24 	 	 	"reconciled": true,
25 	 	 	"locationCode": "DEFAULT",
26 	 	 	"salespersonCode": "DEF",
27 	 	 	"taxOverrideType": "None",
28 	 	 	"taxOverrideAmount": 0,
29 	 	 	"taxOverrideReason": "",
30 	 	 	"totalAmount": 1000,
31 	 	 	"totalExempt": 0,
32 	 	 	"totalDiscount": 0,
33 	 	 	"totalTax": 62.5,
34 	 	 	"totalTaxable": 1000,
35 	 	 	"totalTaxCalculated": 62.5,
36 	 	 	"adjustmentReason": "NotAdjusted",
37 	 	 	"adjustmentDescription": "",
38 	 	 	"locked": false,
39 	 	 	"region": "CA",
40 	 	 	"country": "US",
41 	 	 	"version": 0,
42 	 	 	"originAddressId": 123456789,
43 	 	 	"destinationAddressId": 123456789,
44 	 	 	"exchangeRateEffectiveDate": "2025-05-02",
45 	 	 	"exchangeRate": 2,
46 	 	 	"isSellerImporterOfRecord": false,
47 	 	 	"description": "Yarn",
48 	 	 	"taxDate": "2025-05-02T00:00:00+00:00",
49 	 	 	"lines": [
50 	 	 	 	{
51 	 	 	 	 	"id": 123456789,
52 	 	 	 	 	"transactionId": 123456789,
53 	 	 	 	 	"lineNumber": "1",
54 	 	 	 	 	"boundaryOverrideId": 0,
55 	 	 	 	 	"entityUseCode": "",
56 	 	 	 	 	"description": "Yarn",
57 	 	 	 	 	"destinationAddressId": 12345,
58 	 	 	 	 	"originAddressId": 123456789,
59 	 	 	 	 	"discountAmount": 100,
60 	 	 	 	 	"discountTypeId": 0,
61 	 	 	 	 	"exemptAmount": 0,
62 	 	 	 	 	"exemptCertId": 0,
63 	 	 	 	 	"exemptNo": "",
64 	 	 	 	 	"isItemTaxable": true,
65 	 	 	 	 	"isSSTP": false,
66 	 	 	 	 	"itemCode": "116292",
67 	 	 	 	 	"lineAmount": 1000,
68 	 	 	 	 	"quantity": 1,
69 	 	 	 	 	"ref1": "Note: Deliver to Bob",
70 	 	 	 	 	"reportingDate": "2025-05-02",
71 	 	 	 	 	"revAccount": "",
72 	 	 	 	 	"sourcing": "Destination",
73 	 	 	 	 	"tax": 62.5,
74 	 	 	 	 	"taxableAmount": 1000,
75 	 	 	 	 	"taxCalculated": 62.5,
76 	 	 	 	 	"taxCode": "PS081282",
77 	 	 	 	 	"taxDate": "2025-05-02",
78 	 	 	 	 	"taxEngine": "",
79 	 	 	 	 	"taxOverrideType": "None",
80 	 	 	 	 	"taxOverrideAmount": 0,
81 	 	 	 	 	"taxOverrideReason": "",
82 	 	 	 	 	"taxIncluded": false,
83 	 	 	 	 	"details": [
84 	 	 	 	 	 	{
85 	 	 	 	 	 	 	"id": 123456789,
86 	 	 	 	 	 	 	"transactionLineId": 123456789,
87 	 	 	 	 	 	 	"transactionId": 123456789,
88 	 	 	 	 	 	 	"addressId": 12345,
89 	 	 	 	 	 	 	"country": "US",
90 	 	 	 	 	 	 	"region": "CA",
91 	 	 	 	 	 	 	"stateFIPS": "06",
92 	 	 	 	 	 	 	"exemptAmount": 0,
93 	 	 	 	 	 	 	"exemptReasonId": 4,
94 	 	 	 	 	 	 	"exemptRuleId": 0,
95 	 	 	 	 	 	 	"inState": false,
96 	 	 	 	 	 	 	"jurisCode": "06",
97 	 	 	 	 	 	 	"jurisName": "CALIFORNIA",
98 	 	 	 	 	 	 	"jurisdictionId": 5000531,
99 	 	 	 	 	 	 	"signatureCode": "AGAM",
100 	 	 	 	 	 	 	"stateAssignedNo": "",
101 	 	 	 	 	 	 	"jurisType": "STA",
102 	 	 	 	 	 	 	"nonTaxableAmount": 0,
103 	 	 	 	 	 	 	"nonTaxableRuleId": 0,
104 	 	 	 	 	 	 	"nonTaxableType": "BaseRule",
105 	 	 	 	 	 	 	"rate": 0.0625,
106 	 	 	 	 	 	 	"rateRuleId": 1321915,
107 	 	 	 	 	 	 	"rateSourceId": 3,
108 	 	 	 	 	 	 	"serCode": "",
109 	 	 	 	 	 	 	"sourcing": "Destination",
110 	 	 	 	 	 	 	"tax": 62.5,
111 	 	 	 	 	 	 	"taxableAmount": 1000,
112 	 	 	 	 	 	 	"taxType": "Sales",
113 	 	 	 	 	 	 	"taxName": "CA STATE TAX",
114 	 	 	 	 	 	 	"taxAuthorityTypeId": 45,
115 	 	 	 	 	 	 	"taxRegionId": 2127184,
116 	 	 	 	 	 	 	"taxCalculated": 62.5,
117 	 	 	 	 	 	 	"taxOverride": 0,
118 	 	 	 	 	 	 	"rateType": "General",
119 	 	 	 	 	 	 	"taxableUnits": 62.5,
120 	 	 	 	 	 	 	"nonTaxableUnits": 1000,
121 	 	 	 	 	 	 	"exemptUnits": 62.5,
122 	 	 	 	 	 	 	"reportingTaxableUnits": 125,
123 	 	 	 	 	 	 	"reportingNonTaxableUnits": 2000,
124 	 	 	 	 	 	 	"reportingExemptUnits": 125,
125 	 	 	 	 	 	 	"reportingTax": 125,
126 	 	 	 	 	 	 	"reportingTaxCalculated": 125,
127 	 	 	 	 	 	 	"recoverabilityPercentage": 1,
128 	 	 	 	 	 	 	"recoverableAmount": 62.5,
129 	 	 	 	 	 	 	"nonRecoverableAmount": 0
130 	 	 	 	 	 	}
131 	 	 	 	 	],
132 	 	 	 	 	"vatNumberTypeId": 0,
133 	 	 	 	 	"recoverabilityPercentage": 1,
134 	 	 	 	 	"recoverableAmount": 62.5,
135 	 	 	 	 	"nonRecoverableAmount": 0
136 	 	 	 	}
137 	 	 	],
138 	 	 	"addresses": [
139 	 	 	 	{
140 	 	 	 	 	"id": 0,
141 	 	 	 	 	"transactionId": 0,
142 	 	 	 	 	"boundaryLevel": "Address",
143 	 	 	 	 	"line1": "100 Ravine Lane Northeast #220",
144 	 	 	 	 	"city": "Bainbridge Island",
145 	 	 	 	 	"region": "WA",
146 	 	 	 	 	"postalCode": "98110",
147 	 	 	 	 	"country": "US",
148 	 	 	 	 	"taxRegionId": 0
149 	 	 	 	}
150 	 	 	],
151 	 	 	"taxDetailsByTaxType": [
152 	 	 	 	{
153 	 	 	 	 	"taxType": "SalesAndUse",
154 	 	 	 	 	"totalTaxable": 100,
155 	 	 	 	 	"totalExempt": 0.05,
156 	 	 	 	 	"totalNonTaxable": 0,
157 	 	 	 	 	"totalTax": 0.625
158 	 	 	 	}
159 	 	 	]
160 	 	}
161 	]
162}

SAMPLE

PARAMETERS