Skip to main content

CFDI status validation via API

You can query an invoice’s status with the SAT and its cancellation conditions, regardless of whether it was issued from Facturama or not.
Using this endpoint consumes 1 folio per request made.

Endpoint

string
required
Fiscal folio of the invoice whose status you want to verify.
string
required
Full RFC of the issuer of the invoice whose status you want to verify.
string
required
Full RFC of the receiver of the invoice whose status you want to verify.
string
required
Total amount of the invoice whose status you want to verify, with two decimals (including taxes).

Response data

  • Status: The invoice’s status with the SAT. The possible values for this field are: Vigente, Cancelado, No encontrado.
  • IsCancelable: Text indicating whether the invoice is cancellable or not, and under what conditions it would be cancellable. The possible values are No cancelable, Cancelable con aceptación, and Cancelable sin aceptación.
  • Uuid: The same UUID entered in the request (corresponds to the receipt’s UUID).
Response
In sandbox, status validations with the SAT cannot be performed because it is a test environment; all returned responses will be simulated.

Extract information from the CSF

Using this endpoint consumes 1 folio per request made.

Endpoint

You must also add the following information in the request body:
  • PDF of the CIF converted to Base64
  • Validation type (it will always be 0 for the CIF)
When you add this data to the request JSON, it will look as follows:
Body Request
The endpoint does not work for sandbox, only in the production environment.
Response
Where:
  • RFC: RFC of the taxpayer being validated.
  • TaxName: Fiscal name / business name of the taxpayer being validated.
  • StartOperationsDate: Start-of-operations date.
  • LastStatusChangeDate: Date of the last status change.
  • Status: Current status in the registry of the taxpayer being validated.
  • TaxRegimeName: Name of the tax regime the taxpayer being validated belongs to.
  • TaxRegimeCode: Code corresponding to the tax regime the taxpayer being validated belongs to.
  • Email: Email of the taxpayer being validated, as registered in the registry.
  • ZipCode: Zip code of the taxpayer being validated, as registered in the registry.
  • FederalEntity: Name of the federal entity of the taxpayer being validated, as registered in the registry.
  • Municipality: Name of the municipality or territorial demarcation of the taxpayer being validated, as registered in the registry.
  • Suburb: Name of the neighborhood of the taxpayer being validated, as registered in the registry.
  • RoadName: Name of the road of the address of the taxpayer being validated, as registered in the registry.
  • RoadType: Type of road of the address of the taxpayer being validated, as registered in the registry.
  • ExternalNumber: Exterior number of the address of the taxpayer being validated, as registered in the registry.
  • InternalNumber: Interior number of the address of the taxpayer being validated, as registered in the registry.
  • CreationDate: Creation date.
  • CapitalRegime: Capital regime of the taxpayer being validated.