Intro

This API is meant to validate a list of RFCs for Persona Física and for Persona Moral in the SAT website.

Important points

Mandatory Fields

The field rfcs is mandatory and it is required to send at least one rfc in the body to perform RFCs validations.

Validations applied

For the field rfc which is inside the rfcs array, kiban cloud applies a RFC format validation according to the SAT rules, the RFC must contain an RFC with homoclave and could be for Persona Física or Persona Moral.

Test cases

To recover a success response in sandbox environment is necessary to send a test case (see query parameter "testCase"). The posible values for the query param "testCase" are :

  • valid it will return an example with valid RFCs
  • invalid it will return an example with invalid RFCs

Example : https://sandbox.link.kiban.cloud/api/v1/rfc_sat/validate?testCase=valid

Possible Errors

The next errors can be returned if there is a problem with the request body or the execution of this service:

"RFCs": "EMPTY_ERROR; can't be empty",. rfcs array cannot be empty.

"rfc[1]": "EMPTY_ERROR; can't be empty". At least one element is required in the rfcs array.

"rfc[1]": "FORMAT_ERROR; should be in rfc format with homoclave". The format for the provided rfc in position 1 is incorrect.

Possible responses

RFC no registrado en el padrón de contribuyentes. This means the RFC is not registered and it is not valid

RFC válido, y susceptible de recibir facturas. This means the RFC is registered and it is valid
Language
Authentication
Header
Click Try It! to start a request and see the response here!