Invoices
List CFDI errors
Retrieve a paginated and filterable list of CFDI errors from the error matrix. Use this endpoint to search for error codes, understand error causes, and find solutions.
Query Options:
- Filter by exact error code using code parameter
- Search across all fields using q parameter
- Filter by error type (invoice, receiver, sender, unknown)
- Paginate results with limit and page parameters
get/invoices/errors
Query parameters
codestring
Filter by exact error code (e.g., CFDI140223). Returns single document if found.
qstring
Search query. Searches across code, description, explanation, and solution fields.
type'invoice' | 'receiver' | 'sender' | 'unknown'
Filter by error type
limitinteger
Number of results per page (max 100)
pageinteger
Page number for pagination
Response
CFDI errors retrieved successfully
Example response
{
"success": true,
"data": [
{
"code": "CFDI140223",
"description": "El campo Rfc del receptor no es valido",
"explanation": "The RFC (tax ID) provided for the receiver does not meet the validation requirements or format specified by SAT",
"solution": "Verify that the receiver's RFC is correct, properly formatted (13 characters for individuals, 12 for legal entities), and matches SAT's registered information",
"type": "receiver"
}
],
"total": 150,
"page": 1,
"limit": 50,
"message": "CFDI errors retrieved successfully",
"timestamp": 1734605400000
}