SifenConsultarRUC

Descripción

Consulta un RUC (Registro Único del Contribuyente) en el padrón de la DNIT (siConsRUC). Devuelve la razón social asociada, el estado del contribuyente y si está habilitado como facturador electrónico. Es útil para validar al receptor de un Documento Electrónico antes de emitirlo, evitando rechazos por datos incorrectos.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial de SIFEN
ruc	text	No	RUC a consultar, sin dígito verificador. Si se deja vacío se toma de los datos de entrada

Credenciales

Este módulo requiere una credencial de tipo sifen (certificado .p12, RUC y ambiente). Ver el detalle de campos en SifenEmitirDE.

Salida

{
  "success": true,
  "ruc": "80012345",
  "codigo": "0502",
  "mensaje": "RUC encontrado",
  "encontrado": true,
  "detalle": {
    "razonSocial": "Empresa Cliente S.A.",
    "estado": "ACTIVO",
    "facturadorElectronico": true
  }
}

Ejemplo de Uso

{
  "credentials_id": "cred-sifen-prod",
  "ruc": "80012345"
}

Notas

• El RUC se consulta sin el dígito verificador (DV); el nodo limpia cualquier carácter que no sea numérico antes de enviar la consulta
• No consume numeración ni requiere firma digital, solo la credencial para autenticar la conexión
• Si el receptor no figura como facturador electrónico, igual puede recibir un DE (queda como consumidor final o receptor no habilitado, según el tipo de comprobante)

Nodos Relacionados

• SifenEmitirDE - Emitir el DE una vez validado el receptor
• SifenConsultarDE - Consultar el estado de un DE por su CDC