HaciendaConsultarEstado

Descripción

Consulta el estado de un comprobante electrónico ante el Ministerio de Hacienda de Costa Rica, usando su clave numérica de 50 dígitos. Es el nodo indicado para reconciliar comprobantes que quedaron recibidos o procesando después de emitirlos, o para verificar el estado real antes de generar la representación impresa. El nodo actualiza el estado del comprobante en la base al recibir la respuesta.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial de Hacienda
clave	text	Sí	Clave numérica (50 dígitos) del comprobante

Credenciales

Este módulo requiere una credencial de tipo hacienda con los siguientes campos:

• Certificado (.p12): certificado digital del emisor
• Contraseña del certificado
• Cédula/identificación del emisor (9 a 12 dígitos)
• Usuario y contraseña del ATV (IDP de Hacienda)
• Ambiente: sandbox (pruebas) o producción

Salida

{
  "clave": "50601012600310123456700100001010000000001100000001",
  "estado": "accepted",
  "indEstado": "aceptado",
  "detalle": "Comprobante aceptado",
  "respuestaXml": "...",
  "enProceso": false
}

Ejemplo de Uso

{
  "credentials_id": "cred-hacienda-prod",
  "clave": "50601012600310123456700100001010000000001100000001"
}

Notas

• Si la clave no tiene exactamente 50 dígitos, el nodo termina en error antes de consultar a Hacienda.
• Mientras enProceso sea verdadero (indEstado recibido o procesando) conviene reintentar la consulta más tarde, por ejemplo con un nodo de espera o un cron corto.
• El resultado también actualiza el registro del comprobante que quedó guardado al emitirlo, si el nodo encuentra la clave en la base.

Nodos Relacionados

• HaciendaEmitirFactura - Emitir la factura
• HaciendaEmitirNota - Emitir nota de crédito o débito
• HaciendaRepresentación - Generar la representación impresa con QR