> For the complete documentation index, see [llms.txt](https://docs.xplorpay.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xplorpay.com/api-reference/resources/visas-commercial-enhanced-data-program/level-3-error-code.md). # Level 3 error code Resolve Visa Commercial Enhanced Data Program Level 3 validation errors. Use this reference to resolve Visa Commercial Enhanced Data Program (CEDP) Level 3 validation errors. It covers supported enhanced-data capabilities only. {% hint style="warning" %} These error codes are Visa Confidential and are not part of the Visa Rules. If this reference conflicts with Visa rules or specifications, use the Visa-controlled source and contact your Visa representative. {% endhint %} ### Identify the record family Use this table to identify where to begin investigating an error code.

Code prefix	Start your investigation with
`CS-xxxx`	The TC05 clearing record and supporting enhanced-data fields.
`TC50-0xxx`	Invoice structure and the PURCHA header or summary.
`TC50-1xxx` or `TC50-2xxx`	PURCHL line details, calculations, sequence, and description quality.

### Error code **What Visa is flagging** describes the validation failure. **First thing to check** gives a practical starting point. It does not replace Visa-controlled specifications. #### CS codes: TC05 summary checks Use this table to resolve errors in the TC05 clearing record and related summary fields.

Code	Type	What Visa is flagging	First thing to check
`CS-0001`	Allowed value	Number of payment forms contains a value Visa does not allow.	Send blank, `1`–`9`, or `+`, as applicable.
`CS-0002`	Allowed value	Purchase ID format contains an unsupported value.	Use blank, `0`, `1`, or `5`.
`CS-0003`	Missing dependency	Purchase ID format indicates an ID should exist, but Purchase ID is empty.	Provide the Purchase ID. Use blank or `0` when no ID is supplied.
`CS-0004`	Allowed value	Local Tax Included is not coded as included or not included.	Use `1` or `2`.
`CS-0005`	Field dependency	A local tax amount was sent, but Local Tax Included does not indicate tax is included.	When Local Tax Amount is provided, set Local Tax Included to `1`.
`CS-0006`	Field dependency	No local tax amount was sent, but Local Tax Included does not indicate tax is not included.	When Local Tax Amount is absent, set Local Tax Included to `2`.
`CS-0007`	Must be zero	National Tax Amount is nonzero.	Set National Tax Amount to `0`.
`CS-0008`	Must be zero	National Tax Included is nonzero.	Set National Tax Included to `0`.
`CS-0009`	Missing field	Message ID is empty.	Populate Message ID.
`CS-0010`	Format	Purchase time is not a valid 24-hour `HHMM` value.	Send a valid hour and minute in `HHMM` format.
`CS-0011`	Amount reconciliation	Source Amount does not reconcile to line totals, taxes, invoice shipping, and invoice discount.	Recalculate all components. Confirm signs, rounding, and included lines.
`CS-0012`	Amount reconciliation	Local Tax Amount does not equal the total submitted tax amounts.	Align the header tax amount with all tax details.
`CS-0089`	Data quality pattern	Repeated single-item transactions prevent Visa from creating a unique digital receipt or invoice.	Send complete, transaction-specific line-item detail instead of repeated generic single items.

#### TC50-0000 series: invoice structure and header checks Use this table to resolve invoice structure and PURCHA header errors.

Code	Type	What Visa is flagging	First thing to check
`TC50-0001`	Missing record	The invoice header or summary record (`PURCHA`) is missing.	Include TC50 `PURCHA`.
`TC50-0002`	Missing record	The invoice line-detail record (`PURCHL`) is missing.	Include TC50 `PURCHL` line items.
`TC50-0003`	Record structure	More than one TC50 type was found where the structure does not allow it.	Review record construction. Remove the unintended TC50 type.
`TC50-0004`	Duplicate record	A duplicate `PURCHA` header was found.	Send one intended `PURCHA` header.
`TC50-0005`	Duplicate record	Duplicate `PURCHL` detail was found.	Remove unintended duplicate line-detail records.
`TC50-0006`	Format	Destination postal or ZIP code does not match the destination country format.	Validate the postal code against the country code.
`TC50-0007`	Code mapping	Destination Country Code is not a valid ISO country code.	Use a valid ISO country code.
`TC50-0009`	Format	`PURCHA` Order Date is not a valid `YYMMDD` date.	Send a real calendar date in `YYMMDD` format.
`TC50-0010`	Field dependency	Freight tax amount is nonzero although freight amount is `0`.	Set freight tax amount to `0` when freight amount is `0`.
`TC50-0011`	Amount calculation	Freight tax amount does not equal freight amount multiplied by freight tax rate.	Recalculate freight tax. Review signs and rounding.
`TC50-0012`	Field dependency	Freight tax rate is nonzero although freight amount is `0`.	Set freight tax rate to `0` when freight amount is `0`.
`TC50-0013`	Cross-record mismatch	`PURCHA` Authorization Code is populated but differs from the TC05 Authorization Code.	Make the authorization codes match. Leave `PURCHA` blank when appropriate.
`TC50-0014`	Allowed value	Invoice-level Discount Treatment Code is invalid.	Use `0`, `1`, or `2`.
`TC50-0015`	Allowed value	Tax Treatment contains an unsupported value.	Use `0`, `1`, `2`, `3`, or `4`.
`TC50-0016`	Allowed value	Discount Amount signage contains an unsupported value.	Use blank, `C`, or `D`.
`TC50-0017`	Allowed value	Freight or Shipping Amount signage contains an unsupported value.	Use blank, `C`, or `D`.
`TC50-0018`	Allowed value	Duty Amount signage contains an unsupported value.	Use blank, `C`, or `D`.
`TC50-0019`	Allowed value	VAT or Tax Amount signage contains an unsupported value.	Use blank, `C`, or `D`.

#### TC50-1000 series: line-item structure and calculations Use this table to resolve PURCHL line-item structure, calculation, and sequence errors.

Code	Type	What Visa is flagging	First thing to check
`TC50-1001`	Missing field	Item Description is blank, null, or all zeros.	Provide a meaningful item description.
`TC50-1002`	Missing field	Product Code is blank, null, or all zeros.	Provide a valid product code.
`TC50-1003`	Missing field	Unit of Measure is blank, null, or all zeros.	Provide the applicable unit of measure.
`TC50-1004`	Amount calculation	Line total does not equal unit cost × quantity minus line discount.	Recalculate each line total. Review signs and rounding.
`TC50-1005`	Allowed value	Line-item Detail Indicator is invalid.	Use `0`, `1`, `2`, `3`, `4`, or `5`.
`TC50-1006`	Record ending	Detail indicators do not follow Visa’s even or odd rule.	Use an even indicator for each nonfinal line. Use an odd indicator for the final line.
`TC50-1007`	Allowed value	Line-item Discount Treatment Code is invalid.	Use `0`, `1`, or `2`.
`TC50-1011`	Sequence	The line-item sequence does not progress correctly from the first line.	Renumber line items sequentially from the starting value.

#### TC50-2000 series: description quality Use this table to improve PURCHL descriptions that do not identify purchased goods or services.

Code	Type	What Visa is flagging	First thing to check
`TC50-2001`	Description quality	Line-item description is blank or effectively blank.	Provide a meaningful description of the purchase.
`TC50-2002`	Description quality	Line-item description is the same as, or nearly the same as, the merchant name.	Describe the actual product or service.
`TC50-2003`	Description quality	Line-item product code repeats the cardholder product ID.	Provide the item's product code.
`TC50-2004`	Description quality	Line-item description is too generic to identify the purchase.	Use a specific product or service description.
`TC50-2005`	Description quality	Line-item description contains only one character.	Provide a meaningful, multicharacter description.
`TC50-2006`	Description quality	The entire line-item description is contained within the merchant name.	Describe the item or service independently.
`TC50-2007`	Description quality	Descriptions are mostly generic, numeric, merchant-specific, or otherwise not descriptive.	Use clear, transaction-specific descriptions.

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.xplorpay.com/api-reference/resources/visas-commercial-enhanced-data-program/level-3-error-code.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.