Cómo The Well conecta su POS con Hacienda
The Well usa Shopify y TicoSync para conectar el cobro en su clínica, el IVA del 4% y su devolución al pagar con tarjeta con el comprobante electrónico.
El monto correcto al cobrar. Un registro fiscal claro.
UN SERVICIO · DOS MEDIOS DE PAGO
| Detalle | Efectivo | Tarjeta |
|---|---|---|
| Servicio antes del IVA | ₡100.000 | ₡100.000 |
| IVA calculado (4%) | ₡4.000 | ₡4.000 |
| IVA devuelto | ₡0 | ₡4.000 |
| Monto cobrado | ₡104.000 | ₡100.000 |
4% calculado. Devuelto cuando corresponde.
Para servicios de salud privados elegibles pagados con tarjeta de crédito o débito, Hacienda establece la devolución del IVA en el mismo acto. Se registran tanto el impuesto como su devolución.
En este ejemplo, el mismo servicio de ₡100.000 genera un pago de ₡104.000 en efectivo o de ₡100.000 con tarjeta, después de devolver ₡4.000 de IVA.
Cómo funciona la integración: metacampos, validación y notas de crédito
La necesidad: registrar el impuesto y su devolución
Costa Rica aplica una tarifa reducida de IVA del 4% a los servicios de salud humana privados que cumplen los requisitos. Hacienda explica que, cuando el consumidor paga esos servicios con tarjeta de crédito o débito, el prestador reintegra el impuesto en el mismo acto. Este tratamiento se conoce como devolución del IVA.
Por eso, el flujo de The Well conserva por separado el IVA calculado y el IVA devuelto. El monto cobrado a la tarjeta puede excluir el IVA devuelto, mientras el comprobante fiscal registra ambos importes.
Cómo se conecta el proceso
1. Calcular el total de la venta
El POS de The Well solicita el cálculo del impuesto a Shopify. La configuración del catálogo identifica los artículos habilitados para el flujo de devolución, y el medio de pago seleccionado determina si se aplica. Cuando el carrito contiene ambos tipos, los artículos elegibles y los de impuesto normal se procesan por separado.
2. Conservar los datos de pago en el pedido
El POS guarda datos estructurados en el pedido de Shopify: medio de pago, código fiscal del pago, IVA calculado, IVA devuelto, total antes de la devolución y total final del comprobante. El equipo también puede ver una nota sobre la devolución del IVA en el pedido.
3. Generar el comprobante fiscal
TicoSync lee los datos de pago del pedido y calcula los impuestos de las líneas con los datos tributarios de CABYS. Antes de generar la factura o el tiquete electrónico, verifica que la devolución solicitada use el código de pago con tarjeta y que no supere el IVA calculado de los servicios al 4%, con la tolerancia de redondeo del sistema.
4. Mostrar impuesto, devolución y pago
El XML fiscal registra por separado el impuesto calculado, el IVA devuelto y el total resultante. El PDF también muestra el IVA devuelto. La persona que cobra utiliza el monto resultante para el cobro en el datáfono externo.
Qué datos viajan en los metacampos del pedido
La conexión usa el metacampo JSON del pedido hacienda.payment_context. Este conserva el código fiscal del medio de pago y los montos, sin depender del nombre visible del pedido ni de interpretar una nota manualmente. Para pedidos históricos, TicoSync también admite el atributo anterior well_pos_hacienda.
En el comprobante electrónico, TotalImpuesto registra el impuesto calculado, TotalIVADevuelto registra el IVA devuelto y TotalComprobante refleja el monto resultante. El efectivo usa el código de pago 01; el flujo con tarjeta usa 02.
Mantener las correcciones vinculadas
Cuando una venta se corrige con una nota de crédito, TicoSync lee los datos de pago originales y recalcula la devolución del IVA de las líneas elegibles reembolsadas. Así maneja reembolsos totales y parciales y conserva la relación con el comprobante fiscal original. La devolución del dinero por el medio de pago externo sigue siendo un paso operativo aparte.
Este caso describe el flujo configurado de The Well para servicios elegibles. Cada negocio debe establecer el tratamiento tributario y la configuración del catálogo que corresponden a lo que vende.