Búsqueda de RFC en Listas Negras del SAT
Esta transacción permite la búsqueda de un RFC particular en las Listas Negras del SAT. La respuesta es una, o dos listas (en dependencia del parámetro de búsqueda especificado), con el detalle de cada registro encontrado.
OBTENER_INFO_LN_SAT_HTML
El valor suministrado en el parámetro jsonData es la serialización (formato java), de una clase que contenga las propiedades searchType y taxID
(ambas de tipo string).
Definición de propiedades:
searchType: Indica en cuáles de las listas disponibles se realizará la búsqueda (valores posibles: BL69B, BL69 y ALL); obligatorio.
taxID: Indica el RFC a buscar; obligatorio.
Ejemplo de valor para el parámetro jsonData (se muestra en varias líneas para que se entienda mejor, debe especificarse en una sola):
- {
"searchType": "ALL",
"taxID": "RFC"
}
SOLICITUD
A continuación se muestra la manera en que debe realizarse la solicitud:
- <soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ws="http://www.fact.com.mx/schema/ws">
<soap:Header/>
<soap:Body>
<ws:JsonServiceCall>
<ws:jsonData>{
"searchType": "ALL",
"taxID": "RFC"
}</ws:jsonData>
<ws:transactionName>OBTENER_INFO_LN_SAT_HTML</ws:transactionName>
<ws:token>wAw8u5r19BZsJOIE+TV82o3mjAD4Jd6KanFbMzieB4bK6HPiD2LSW/zpXIW/jAnPC+8=</ws:token>
</ws:JsonServiceCall>
</soap:Body>
</soap:Envelope>
RESPUESTA
- <soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<JsonServiceCallResponse xmlns="http://www.fact.com.mx/schema/ws">
<JsonServiceCallResult>
{
"Result":true,
"Payload":"Respuesta en Base64",
"ErrorMsg":"",
"ErrorCode":0,
"Token":"wAw8LzeFYnhlw2Qc0/5MXwvO7OepjeLJd/jci7o5wxlQu5r19BZsJOIE+TV82o3mjAD4Jd6KanFbMzieB4bK6PKuaHaBSN7Arkk9nZhzy2E="
}
</JsonServiceCallResult>
</JsonServiceCallResponse>
</soap:Body>
</soap:Envelope>
La respuesta, en caso de que los datos sean válidos, siempre será exitosa (Result con valor true). Esto no indica que el RFC haya sido encontrado o no, lo cual tendrá que ser confirmado en lo que se devuelve en Payload.
Ejemplo de valor devuelto en Payload, formato JSON (aunque se muestra plano, y en varias líneas, el valor de Payload viene codificado Base64):
- {"TaxID":"RFC",
"Dt69b":"
[{\"No\":5,
\"RFC\":\"RFC\",
\"Name\":\"RAZÓN SOCIAL, S.A. DE CV.\",
\"SituacionContribuyente\":\"Presunto\",
\"NumeroFechaOficioGlobalPresuncion\":\"500-05-2019-7349 de fecha 1 de abril de 2019\",
\"PublicacionPaginaSatPresuntos\":\"01/04/2019\",
\"NumeroFechaOficioGlobalPresuncion1\":\"500-05-2019-7349 de fecha 1 de abril de 2019\",
\"PublicacionDofPresuntos\":\"26/04/2019\",
\"PublicacionPaginaSatDesvirtuados\":\"\",
\"NumeroFechaOficioGlobalContribuyenteDesvirtuado\":\"\",
\"PublicacionDofDesvirtuados\":\"\",
\"NumeroFechaOficioGlobalDefinitivos\":\"\",
\"PublicacionPaginaSatDefinitivos\":\"\",
\"PublicacionDofDefinitivos\":\"\",
\"NumeroFechaOficioGlobalSentenciaFavorable\":\"\",
\"PublicacionPaginaSatSentenciaFavorable\":\"\",
\"NumeroFechaOficioGlobalSentenciaFavorable1\":\"\",
\"PublicacionDofSentenciaFavorable\":\"\",
\"Source1\":1000}]",
"Dt69":"
[
{\"Id\":228634,
\"RFC\":\"RFC\",
\"Name\":\"RAZÓN SOCIAL SA DE CV\",
\"TipoPersona\":\"M\",
\"Supuesto\":\"FIRMES\",
\"FechasPrimeraPublicacion\":\"16/02/2016\\r\",
\"Monto\":null,
\"FechaPublicacionConMonto\":null,
\"SinNombre1\":null,
\"SinNombre2\":null,
\"Source1\":10},
{\"Id\":532708,
\"RFC\":\"RFC\",
\"Name\":\"RAZÓN SOCIAL SA DE CV\",
\"TipoPersona\":\"M\",
\"Supuesto\":\"NO LOCALIZADOS\",
\"FechasPrimeraPublicacion\":\"01/10/2018\",
\"Monto\":\"\\r\",
\"FechaPublicacionConMonto\":null,
\"SinNombre1\":null,
\"SinNombre2\":null,
\"Source1\":11}
]"
}
Noten en la respuesta del ejemplo anterior que el RFC indicado existe una vez en la lista 69B y dos veces en la 69.
En Payload se devuelve una clase serializada (formato java), que contiene el atributo TaxID (su valor coincide con el RFC indicado como parámetro en taxID), y dos DataTables serializados de la manera que siempre se ha entregado al front para transacciones de este tipo.
El primer DataTable, de nombre Dt69b, devuelve todos los registros encontrados en la Lista Negra del SAT 69B; por supuesto, eso en caso de que haya sido tenida en cuenta de acuerdo al valor indicado para el parámetro searchType (BL69B y ALL).
El segundo DataTable, de nombre Dt69, devuelve todos los registros encontrados en la Lista Negra del SAT 69; por supuesto, eso en caso de que haya sido tenida en cuenta de acuerdo al valor indicado para el parámetro searchType (BL69 y ALL).
Todos los parámetros que se especifican en jsonData son obligatorios; cualquiera que no sea indicado (o que su valor sea incorrecto contra lo especificado en este documento), generará un error cuyo mensaje indica el motivo.
A continuación encontrará ejemplos adjuntos utilizando esta transacción que le servirán de guía para llevar su integración de manera eficiente.
Related Articles
Búsqueda de RFC en Listas Negras del SAT
Esta transacción permite la búsqueda de un RFC particular en las Listas Negras del SAT. La respuesta es una, o dos listas (en dependencia del parámetro de búsqueda especificado), con el detalle de cada registro encontrado. OBTENER_INFO_LN_SAT Los ...
Búsqueda por RFC en Listas Negras
SERVICIO API LISTAS NEGRAS SAT Documentación Técnica 1.- ALTA COMO DESARROLLADOR Para darse de alta y solicitar el enrolamiento como desarrollador debe ingresar a la siguiente URL: https://mysuiteapi.developer.azure-api.net/ Llenar la información ...
Recuperación de Lista de Alertas por Listas Negras del SAT
Esta transacción permite recuperar la lista (paginada y que cumplan criterios de filtrado establecidos, así como un ordenamiento indicado), con los metadatos asociados a Alertas por operaciones con empresas publicadas en las Listas Negras del SAT. La ...
Recuperación de Lista de Alertas por Listas Negras del SAT
Esta transacción permite recuperar la lista (paginada y que cumplan criterios de filtrado establecidos, así como un ordenamiento indicado), con los metadatos asociados a Alertas por operaciones con empresas publicadas en las Listas Negras del SAT. La ...
Cambio de Estado (Leída/No Leída), de Alerta en Listas Negras del SAT.
Esta transacción permite cambiar el estado de Leída / No Leída a una alerta por operaciones con empresas publicadas en las Listas Negras del SAT. CAMBIAR_ESTADO_LEIDA_ALERTA_LN_HTML El valor suministrado en el parámetro jsonData es la serialización ...