Tabla de contenidos
Este es un servicio síncrono con respuesta inmediata que consulta por el RUC la existencia de una Empresa directamente en el SIFEN, a través de la API del SIFEN.
El RUC informado como parámetro no debe contener el dígito verificador.
Esta consulta por RUC también puede realizarse desde el panel de FacturaSend, todas las consultas anteriores realizadas quedan almacenadas y se despliegan en un listado.
Para invocar éste servicio se requiere que la empresa relacionada al tenantId esté conectada a SIFEN (en ambiente de PRUEBAS o de PRODUCCIÓN), y también se requiere de un Certificado Digital válido.
Endpoint (URL) #
POST https://api.facturasend.com.py/<tenantId>/ruc/<ruc>
Header (Encabezado) #
Requiere el envío del los siguientes atributos en el encabezado
| Campo | Valor |
|---|---|
| Authorization | Bearer api_key_reemplazar_api_key |
Parámetros (BODY) #
No posee
Parámetros (Query Param) #
No posee
Ejemplo de llamadas #
# Consulta los datos de una Empresa Física o Juridica por el RUC curl \ -X \ POST "https://api.facturasend.com.py/<tenantId>/ruc/80069563" -H "Authorization: Bearer api_key_<reemplazar_api_key >"
# El ejemplo se muestra utilizando AXIOS
import axios from 'axios';
const headers = {
`Authorization` : `Bearer api_key_<reemplazar_api_key>`
};
axios.post(`https://api.facturasend.com.py/<tenantId>/ruc/80069563`,
null,
{headers}
)
.then( respuesta => {
console.log(respuesta);
});
Como respuesta obtendrá lo siguiente:
{
"success": true,
"respuesta_codigo": "0502",
"respuesta_mensaje": "CDC encontrado",
"razon_social": "TIPS S.A",
"estado_codigo": "ACT",
"estado_mensaje": "ACTIVO",
"facturador_electronico": true
}
Respuesta de la Petición #
{
"success": true,
"respuesta_codigo": "0502",
"respuesta_mensaje": "CDC encontrado",
"razon_social": "TIPS S.A",
"estado_codigo": "ACT",
"estado_mensaje": "ACTIVO",
"facturador_electronico": true
}
| Campo | Tipo | Descripción |
|---|---|---|
| success | boolean | true si la consulta se ejecutó con éxito, false si dio algún error |
| error | string | El mensaje de error en caso de que haya retornado success=false. |
| respuesta_codigo | string | Código de respuesta de la consulta. Valores: 0500=RUC no existe. 0501=RUC sin permiso consulta WS. 0502=RUC encontrado. |
| respuesta_mensaje | string | Mensaje de respuesta de la consulta. Valores: 0500=RUC no existe. 0501=RUC sin permiso consulta WS. 0502=RUC encontrado. |
| razon_social | string | Razón Social de la Empresa como se encuentra en el Marangatú. Este atributo solo retorna si respuesta_codigo=0502 |
| estado_codigo | string | Código del Estado o situación fiscal de la Empresa, con los posibles valores: ACT=Activo SUS=Suspensión Temporal SAD=Suspensión Administrativa BLQ=Bloqueado CAN=Cancelado CDE=Cancelado Definitivo Este atributo solo retorna si respuesta_codigo=0502 |
| estado_mensaje | string | Descripción del Estado o situación fiscal de la Empresa, con los posibles valores: ACT=Activo SUS=Suspensión Temporal SAD=Suspensión Administrativa BLQ=Bloqueado CAN=Cancelado CDE=Cancelado Definitivo Este atributo solo retorna si respuesta_codigo=0502 |
| facturador_electronico | boolean | true si la empresa ya se encuentra facturando electrónicamente. |
Recomendaciones #
- No aplica
Validaciones #
- No aplica
