Inicio  |  Emisión  |  Webservice ConsultaRFC
La LCO fue actualizada por última vez el 02/dic/2022


Webservice ConsultaRFC

Este servicio proporciona a los usuarios la opción de consultar RFC que se encuentren registrados en la lista de contribuyentes del Artículo 69-B del Código Fiscal de la Federación.


Autenticación

El nombre de usuario y contraseña a utilizar en los métodos deberán ser usuarios registrados en la implementación.


Solicitud

Para consumir el servicio se deberá solicitar:

GET /ServiciosSAT/ConsultaRFC/{rfc}/{type}

Parámetros de Encabezado

Nombre Descripción Requerido
Authorization

Es el código BASIC generado previamente con el usuario y contraseña.
(Ejemplo: Authorization = Basic ZGVtb0BlbXByZXNhLmNvbTplbXByZXNh)

AuthorizationType

Es el tipo de autenticación que realizará el WS antes de la petición, consulte el catálogo Tipos de Autorización

Parámetros de Ruta

Nombre Descripción Requerido
rfc

Parámetro de tipo TEMPLATE (REQUERIDO). Es el RFC que se desea consultar, es el primero de los parámetros en la URL ({rfc}).

type

Tipo de lista en la que se buscará el RFC consultado, es el segundo de los parámetros en la URL ({type}). Consulte el catálogo Tipos de Lista

Tipos de Autorización

Tipo Descripción
TIMBRADO

Usuario del Panel de Timbrado

BASIC

Usuario de Emisión o Recepción SF:ERP

Tipos de Lista

Código Descripción
ARTICULO_69B

Lista de EFOS y EDOS publicada de acuerdo al Artículo 69B, también conocida como Lista Negra del SAT. Consultar RFC en lista de EFOs y EDOs ( ARTICULO_69B )


Códigos de Error

Código Mensaje
403

Mecanismo de autenticación no soportado

403

Falló la autenticación al servicio

403

Error al obtener usuario y contraseña. No se logró decodificar el mecanismo de autenticación.

403

Error al acceder al servidor de datos. No se logró obtener la configuración del servidor de datos.

500

Ocurrió un error al interpretar la respuesta del servidor.

500

Ocurrió un error al consultar el servicio de consulta de RFCs.

500

Error de conexión remota en el acceso a datos.

601

El acceso a SF:ERP para la cuenta solicitada ha sido bloqueado. Bloqueo por intentos fallidos.

621

Type inexistente.El valor permitido es ARTICULO_69B.

621

Error al verificar el token de autenticación.

621

El token de autentificación no es válido

621

El token de autenticación ha expirado

621

Error al obtener el valor de la expiración del token

621

No se encontró información del usuario que se desea autenticar

621

La implementación del usuario que desea autenticarse se encuentra inactiva


Descripción de datos de respuesta

Nombre Descripción
existente

Booleano que indica si el RFC validado se encuentra en la lista Negra. Si el valor de este campo es falso los demás datos serán omitidos en la respuesta.

nombre

Nombre del contribuyente

situacion

Status en el que se encuentra el contribuyente. consultar catalogo de situación Lista Situación ARTICULO_69B

numeroFechaPresuncionSat

Numero de la fecha de presunción SAT

fechaPublicacionPresuncionSat

Fecha de publicación de presunción SAT

numeroFechaPresuncionDof

Numero de la fecha de presunción DOF

fechaPublicacionPresuncionDof

Fecha de publicación de presunción DOF

numeroFechaDesvirtuadosSat

Numero de la fecha de Desvirtuados SAT

numeroFechaDefinitivo

Numero de la fecha de Definitivo

fechaPublicacionDefinitivosSat

Fecha de publicación de Definitivos SAT

fechaPublicacionDefinitivosDof

Fecha de publicación de Definitivos DOF

numeroFechaFavorablesSat

Numero de la fecha de Favorable SAT

numeroFechaFavorableDof

Numero de la fecha de Favorable DOF


Ejemplos


Solicitudes HTTP


Paso 1.

Necesitamos abrir la aplicación SoapUI, una vez estando en la aplicación seleccionamos New REST project e ingresamos el endPoint y seleccionamos Ok

rest SoapUI

Paso 2.

Después de realizar el paso anterior se procederá a agregar las credenciales de Autorización para consumir el servicio. Para ello seleccionaremos la opción "Auth" ubicada en la parte inferior izquierda, una vez hay daremos a la opción de agregar nueva autorización "Add Authorization" y elegimos la opción "Basic" posteriormente seleccionamos la opción "OK".

Una vez hecho esto procederemos agregando las credenciales para el consumo de la petición, una vez ingresadas procederemos a ejecutar la petición dando click al icono de "play" color verde. Generando así una respuesta del WS.

rest SoapUI

Respuestas ARTICULO_69B

A continuación se muestran dos ejemplos cuando se solicita la consulta de un RFC existente y otro RFC no existente en ARTICULO_69B:

1. Respuesta RFC Existente en Lista de EFOS y EDOS:

2. Respuesta RFC inexistente en Lista de EFOS y EDOS:

Datos de contacto