Response Code and Messages
The table below lists the message codes used when a Web Request fails. When a Web Request encounters header failures, it will fail upon the first detected issue and return the corresponding message. For Item Level failures, SureTax will process all items, both successful and unsuccessful, returning relevant response codes for any erroneous items.
Note: Before validating specific data elements of a web request, the CCH SureTax serializer checks the entire request for proper formatting and encoding. If an error occurs during this process, a 1101 error code will be returned, accompanied by a header message such as "Failure - There was an error deserializing the object of type...".
Header Level Response Codes
Code | Description |
---|---|
1000 | Failure - STAN already processed |
1100 | Failure - General Failure |
1101 | Failure - There is a format error in the web request - Input string was not in a correct format |
1110 | Failure - Data Month Required |
1120 | Failure - Data Year Required |
1121 | Failure - Invalid Data Year/Month - Must be a published Data Year/Month |
1130 | Failure - Client Number Required |
1131 | Failure - Invalid Client Number |
1141 | Failure - Invalid Business Unit |
1150 | Failure - Validation Key Required |
1151 | Failure - Invalid Validation Key |
1171 | Failure - Invalid Client Tracking Code |
1190 | Failure - Response Group Code Required |
1191 | Failure - Invalid Response Group Code |
1200 | Failure - Response Type Required |
1201 | Failure - Invalid Response Type |
1210 | Failure - Return File Code Required |
1211 | Failure - Invalid Return File Code |
1220 | Failure - Item List Required |
1510 | Failure - Transaction is more than 60 days old (generated from Cancel Request method) |
9001 | Success with Item Errors (see table 9.2) |
9999 | Success |
Item Level Response Codes
Code | Description |
---|---|
9100 | Invalid Invoice Number - Must be Alphanumeric |
9101 | Invalid Invoice Number - Exceeds Character Limit (20) |
9110 | Invalid Customer Number - Must be Numeric |
9111 | Invalid Customer Number - Exceeds Character Limit (10) |
9151 | Invalid ShipTo Zip Code = Zip Code not found |
9153 | Invalid Country Code - Must be 2 characters |
9155 | Invalid Geocode - cannot be null |
9160 | Invalid Billing Zip Code Extension - Must be a 4 digit number |
9170 | Invalid Secondary Zip Code - cannot be null |
9171 | Invalid Secondary Zip Code = CAN - Must be a 6 character Alpha-Numeric |
9172 | Invalid Secondary Zip Code = Zip Code not found |
9180 | Invalid Secondary Zip Code Extension - Must be a 4 digit number |
9190 | Invalid BillingPeriodEndDate or BillingPeriodStartDate - cannot be null |
9200 | Invalid Line Number - Exceeds Character Limit (20) |
9220 | Invalid Unit Type - cannot be null |
9240 | Invalid Tax Included Code - cannot be null |
9250 | Invalid Tax Situs Rule Code |
9260 | Invalid Transaction Type Code |
9270 | Invalid Sales Type Code - cannot be null |
9280 | Invalid Regulatory Code - cannot be null |
9290 | AuxRevenueType Required |
9410 | Transaction is already cancelled (generated from Cancel Request method) |