HaciendaEmitirNota

Descripción

Emite una Nota de Crédito (tipo 03) o una Nota de Débito (tipo 02) ante el Ministerio de Hacienda de Costa Rica. El nodo requiere la referencia al documento original (clave numérica del comprobante que se corrige o anula), arma el XML, lo firma y ejecuta el mismo flujo de recepción y consulta de estado que la factura.

Como la factura, la nota queda válida tributariamente recién cuando Hacienda la ACEPTA.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial de Hacienda
nota	json	No	Nota en JSON: tipo (03 crédito, 02 débito), receptor, items, referencia {clave, tipoDoc, fecha, codigo, razon} del documento original. Si se deja vacío, se usan los datos de entrada del nodo anterior.

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": "50601012600310123456700200001010000000002100000001",
  "tipo": "03",
  "estado": "accepted",
  "indEstado": "aceptado",
  "enProceso": false,
  "referencia": { "clave": "50601012600310123456700100001010000000001100000001", "tipoDoc": "01" },
  "total": 113,
  "detalle": "Comprobante aceptado",
  "xml": "..."
}

Ejemplo de Uso

{
  "credentials_id": "cred-hacienda-prod",
  "nota": {
    "tipo": "03",
    "receptor": { "cedula": "3101123456", "tipoCedula": "02", "nombre": "Cliente SA" },
    "items": [
      { "descripcion": "Servicio de consultoria", "cantidad": 1, "precioUnitario": 100, "codigoTarifa": "08" }
    ],
    "referencia": { "clave": "50601012600310123456700100001010000000001100000001", "tipoDoc": "01", "fecha": "2026-08-01", "codigo": "01", "razon": "Anula por error en el monto" }
  }
}

Notas

• La nota exige la referencia (clave del comprobante original); sin ella, el nodo termina en error antes de armar el XML.
• El tipo 03 (crédito) es el más común para anular o corregir facturas; el tipo 02 (débito) se usa para cargos adicionales sobre un comprobante ya emitido.
• Igual que la factura, el XML firmado se persiste antes de enviarlo, y el estado se reconcilia con HaciendaConsultarEstado si queda en proceso.

Nodos Relacionados

• HaciendaEmitirFactura - Emitir la factura original
• HaciendaConsultarEstado - Consultar el estado del comprobante
• HaciendaRepresentación - Generar la representación impresa con QR