Costa Rica

En Costa Rica, Floogos se conecta directo al Ministerio de Hacienda (versión 4.4 del esquema de comprobantes electrónicos). No hay un proveedor intermedio obligatorio: el propio motor arma el XML, calcula la clave numérica, lo firma con el certificado del emisor y habla el protocolo REST de Hacienda, autenticándose con OAuth2 contra el ATV (Administración Tributaria Virtual).

Modelo de integración

• Directo, sin proveedor intermedio: el flujo va contra los servicios REST del Ministerio de Hacienda, no contra un PAC o certificador externo.
• Esquema propio v4.4: los comprobantes (factura, notas) se arman en el formato XML propio de Hacienda, versión 4.4.
• Clave numérica de 50 dígitos: cada comprobante lleva una clave que incluye el código de país (506), la identificación del emisor, el consecutivo y una situación de seguridad, y es lo que lo identifica ante Hacienda y en el QR.
• Firma digital: el XML se firma con el certificado (.p12) del emisor antes de enviarlo.
• Autenticación OAuth2: cada envío obtiene un token contra el IDP del ATV (usuario y contraseña de Hacienda) antes de llamar a los servicios de recepción y consulta.
• Recepción + consulta de estado: el comprobante se envía por POST a recepción y luego se consulta su estado (ind-estado) con un GET por clave.
• IVA 13%: el Impuesto al Valor Agregado se calcula según el catálogo de tarifas de Hacienda, siendo 13% (código 08) la tarifa general.

Cuándo queda válido un comprobante

Un comprobante no queda válido por el solo hecho de enviarlo: recién se considera válido cuando Hacienda responde con estado aceptado. Si la respuesta queda en recibido o procesando, hay que reconciliar más tarde consultando de nuevo por la clave. Si Hacienda lo rechaza, el comprobante no tiene validez tributaria y hay que corregir y reemitir.

Nodos disponibles

Nodo	Descripción
HaciendaEmitirFactura	Emite la factura: arma el XML v4.4, calcula la clave, firma, obtiene el token OAuth2 y hace recepción + consulta de estado
HaciendaEmitirNota	Emite nota de crédito (03) o débito (02) referenciando la clave del comprobante original
HaciendaConsultarEstado	Consulta el estado de un comprobante por su clave numérica; reconcilia y actualiza la base
HaciendaRepresentacion	Genera la representación impresa (HTML/PDF) con el código QR del comprobante

Flujo típico

1. HaciendaEmitirFactura — emite la factura (o la nota con HaciendaEmitirNota), obtiene la clave numérica y un primer estado.
2. HaciendaConsultarEstado — si el estado quedó en recibido o procesando, se reconsulta más tarde hasta obtener aceptado o rechazado.
3. HaciendaRepresentacion — una vez aceptado, se genera el HTML con el QR para entregarle al cliente su comprobante impreso o en PDF.

Notas

• La credencial de tipo hacienda guarda el certificado (.p12), su contraseña, la cédula/identificación del emisor, el usuario y contraseña del ATV, y el ambiente (sandbox o producción).
• El motor Floogos valida que el certificado no esté vencido antes de intentar firmar y enviar un comprobante.
• La clave numérica de 50 dígitos es la misma que se codifica en el QR de la representación impresa.