API for Consultation of the 69-B list

Sovos offers an API REST to consult the list of taxpayers published by the SAT and that fulfills article 69-B of the Mexican Fiscal Code (CFF Código Fiscal de la Federación).

Content

• General Features
  • What do I need?
• Consultation of RFCs on the 69-B list
  • HTTP Header
  • Request Body
  • Response codes

General Features

The API for consultations of the taxpayers’ list helps you to know if an RFC is on the list 69-B (blocklist) or not. If a RFC is there you will get the following details:

• Name or Company name of the taxpayer.
• Taxpayer Status.
• Number and date of the presumption document.
• SAT page publication of a presumption.
• DOF (Official Nation Newspaper) publication of a presumption.
• SAT page publication of detracted taxpayers.
• Date and number of the global publication of detracted taxpayers.
• DOF publication of detracted taxpayers.
• Date and number of the global publication of definitive taxpayers.
• Date of publishing in the DOF of definitive taxpayers.
• Date and number of the global publication for a favorable ruling.
• SAT page publication of a favorable ruling.
• DOF publication of a favorable ruling.

What do I need?

• To have the API service for 69-B list consultation active in your Sovos account.
• To generate an API key on your Sovos account, this is an identifier that authenticates the user on the platform web services. To generate an API key, please review this article: Generating an API Key for web services (Spanish only).

Consultation of an RFC in the 69-B list

To consult an RFC in the 69-B list, you should send the following:

HTTP method POST

HTTP header

Body

The structure JSON is only accepted inside the body of a requisition. The supported attributes are the following:

Requesy Body

Example:

{
  "rfcs": [
    "ASE0201179X0",
    "ase0201179x0",
    "TEST010101000"
  ]
}

Body Response

The elements in the body of the response are the following:

When response contains results, these will be expresed as an results array: As response results, those are the elements returned on results

Inside the oficios (files) element, you can find the following elements:

Response example:

{
    "queryDate": "2020-02-26T18:08:31",
    "results": [
        {
            "rfcConsultado": "ASE0201179X0",
            "encontrado": "No"
        },
        {
            "rfcConsultado": "TEST010101000",
            "nombre": "ESTA ES UNA PRUEBA, S.A. DE C.V.",
            "encontrado": "Si",
            "oficios": [
                {
                    "situacion": "Sentencia Favorable",
                    "noOficioPresuncion": "XXX-XX-20XX-XX710 de fecha XX de xxx de 20XX",
                    "fechaSATPresuncion": "20XX-XX-XXT00:00:00",
                    "fechaDOFPresencion": "20XX-XX-XXT00:00:00",
                    "noGlobalDefinitivos": "XXX-XX-20XX-XX004 de fecha XX de xxx de 20XX",
                    "fechaDOFDefinitivos": "20XX-XX-24T00:00:00",
                    "noOficioSentenciaFavorable": "XXX-XX-20XX-XX141 de fecha XX de xxx de 20XX"
                },
                {
                    "situacion": "Definitivo",
                    "noOficioPresuncion": "XXX-XX-20XX-XX219 de fecha XX de xxx de 20XX",
                    "fechaSATPresuncion": "20XX-XX-XXT00:00:00",
                    "fechaDOFPresencion": "20XX-XX-XXT00:00:00",
                    "noGlobalDefinitivos": "XXX-XX-20XX-XX910 de fecha XX de xxx de 20XX",
                    "fechaDOFDefinitivos": "20XX-XX-XXT00:00:00"
                }
            ]
        }
    ]
}

When there are errors, the errors element will show the following information:

Example of a response with errors:

{
    "errors": [
        {
            "Code": "400-001",
            "Message": "Los siguientes RFCs no cumplen con la expresión regular que define a un RFC: 'PRUEBAS010101000'"
        }
    ]
}

Response Codes

As a response from the API REST you will obtain a code indicating the result of the procedure. All responses are in JSON format (application/json)

For more information or any doubt related to this guide, please send an email to MEX-soporte@sovos.com