API para consulta del listado 69-B

Cuando la autoridad fiscal detecte que un contribuyente ha estado emitiendo comprobantes sin contar con los activos, personal, infraestructura o capacidad material, directa o indirectamente, para prestar los servicios o producir, comercializar o entregar los bienes que amparan tales comprobantes, o bien, que dichos contribuyentes se encuentren no localizados, se presumirá la inexistencia de las operaciones amparadas en tales comprobantes.

Reachcore pone a su disposición un API REST para llevar a cabo consultas al listado de contribuyentes publicado por el SAT y que se encuentran en los supuestos contenidos en el artículo 69-B del Código Fiscal de la Federación.

Contenido

• Características generales
  • ¿Qué necesito?
• Consulta de RFC en lista 69-B
  • Encabezado HTTP
  • Cuerpo de la petición
  • Códigos de respuesta

Características generales

El API para consultas al listado de contribuyentes incumplidos permite consultar un RFC para conocer si el RFC consultado se encuentra o no en el listado completo de contribuyentes (para el artículo 69-B). Si se encuentra, se regresa el siguiente detalle:

• Nombre o razón social del Contribuyente
• Situación del Contribuyente
• Número y fecha de oficio global de presuncion
• Publicación en página del SAT de presuntos
• Publicación en DOF de presuntos
• Publicación en página del SAT de desvirtuados
• Número y fecha de oficio global de contribuyentes que desvirtuaron
• Publicación en DOF de contribuyentes que desvirtuaron
• Número y fecha de oficio global de definitivos
• Fecha de publicación en DOF Definitivos
• Número y fecha de Oficio global de Sentencia Favorable
• Publicación en página del SAT de sentencia favorable
• Publicación en DOF de sentencia favorable

¿Qué necesito?

• Tener activo el servicio de API para Consulta del listado 69-B en tu cuenta Reachcore.
• Generar un API Key en tu cuenta Reachcore, ya que se usa para autenticar la solicitud en el API Rest. El API Key debe corresponder al ambiente en el que se realiza la solicitud. Para referencia de como generar el API Key, consulta el siguiente artículo: Generar API Key para Web Services.

Consulta de un RFC en lista 69-B

Para consultar un RFC en la lista 69-B, se debe enviar al API REST lo siguiente:

Verbo HTTP: POST

Encabezado HTTP

Cuerpo

Solo se acepta la estructura de un JSON en el cuerpo del la petición. Los atributos soportados son los siguientes:

Cuerpo de la Petición

Un ejemplo de petición es el siguiente:

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

Cuerpo de la Respuesta

Los elementos en la respuesta son los siguientes:

Para el caso de peticiones cuya respuesta genera resultados, estos son los elementos que se regresan como parte del arreglo results:

Dentro de los oficios se pueden tener los siguientes elementos:

Ejemplo de respuesta

{
    "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"
                }
            ]
        }
    ]
}

Cuando hay errores, el elemento errors tiene la siguiente información:

Ejemplo de una respuesta con errores

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

Códigos de respuesta

Como respuesta del API REST, obtendrá un código indicando el resultado de la operación. Todas las repuestas son en formato JSON (application/json)

Para mayor información o aclaración de dudas relacionadas con esta guía, por favor envía un correo a MEX-soporte@sovos.com