Factura electrónica para comercios, retail y ferreterías

Es que toda venta de tu tienda —desde un tornillo hasta una compra grande— genere un comprobante electrónico y se reporte a Hacienda. En un comercio de mostrador eso pasa decenas o cientos de veces al día, y cada línea del comprobante arrastra dos datos técnicos: el código CABYS del producto (13 dígitos) y la tarifa de IVA que le corresponde.

Por eso el reto de un comercio no es «emitir una factura»: es emitir muchas, rápido y sin equivocarse de tipo (tiquete vs. factura), de código ni de impuesto. Un negocio de servicios factura un puñado de documentos al mes; una ferretería, una pulpería o una tienda factura todo el día, con productos que pueden llevar tarifas distintas.

El mostrador. Cuando hay clientes esperando, cada segundo que el cajero pasa buscando un código o reteclando datos en el portal de Hacienda es fila que crece. Y a más ventas, más probabilidad de colar un error: la tarifa equivocada, el CABYS de otro producto, o entregar un tiquete cuando el cliente necesitaba factura.

Y está la decisión de tiquete o factura en cada venta. La mayoría de las ventas de mostrador son tiquete (04), pero apenas un cliente da su cédula para deducir, la misma venta tiene que salir como factura (01). La diferencia de fondo la explicamos en factura vs. tiquete electrónico.

Que cada venta se respalda con un comprobante electrónico de la versión 4.4, obligatoria desde el 1 de setiembre de 2025. Al consumidor final le corresponde el tiquete electrónico (04); a quien pide con su cédula para deducir, la factura electrónica (01). Si el cliente la solicita, estás obligado a emitirla.

Cada artículo que vendés se identifica con su código CABYS (13 dígitos), y ese código arrastra la tarifa de IVA. El general es 13 %, pero hay tarifas reducidas de 4 %, 2 % y 1 % (canasta básica) y bienes exentos —por eso una ferretería y una pulpería no facturan con el mismo IVA en todos sus productos—. El detalle está en tarifas de IVA en Costa Rica y el código, en qué es CABYS.

Con lo mismo para todos los tamaños de comercio, en dos modos. Si tu tienda es chica, emitís desde el panel web sin instalar nada. Si ya tenés un punto de venta, lo conectás por API para timbrar desde la misma caja. En los dos casos, el trabajo pesado —el XML v4.4, la firma, el envío a Hacienda— lo llevamos nosotros.

• Buscador de CABYS incorporado: asignás el código de 13 dígitos a cada producto de tu catálogo, y con él queda fijada la tarifa de IVA del artículo.
• Un campo decide tiquete o factura en la misma venta: cambiás tipo_documento de 04 a 01 y agregás el receptor cuando el cliente pide factura.
• Cada caja lleva su consecutivo: si tenés varias cajas o sucursales, cada una numera su serie sola y no se cruzan.
• Clientes frecuentes guardados: al cliente empresa que siempre pide factura no le retecleás la cédula ni el correo cada vez.
• La clave vuelve al instante: la API responde 202 con la clave de 50 dígitos y el consecutivo en segundos, así el tiquete imprime sin frenar la fila.
• El comprobante le llega al cliente: en la factura, Plaxp le manda al receptor el PDF y el XML por correo, como exige la normativa.

Así se ve una venta de mostrador con dos productos —uno gravado al 13 % y otro de canasta básica— salida como tiquete:

POST /api/procesar
{
  "tipo_documento": "04",        // 04 = tiquete (consumidor final)
  "codigo_sucursal": "001",
  "codigo_caja": "002",          // la terminal que está cobrando
  "condicion_venta": "01",       // 01 = contado
  "medios_pago": [{ "tipo": "02", "monto": 12430 }],  // 02 = tarjeta
  "lineas": [
    {
      "codigo_cabys": "4661101050000",
      "detalle": "Cemento gris 50 kg",
      "cantidad": 1,
      "precio_unitario": 9500,
      "codigo_tarifa": "08",     // 08 = IVA general 13 %
      "tarifa": 13
    },
    {
      "codigo_cabys": "0111301000100",
      "detalle": "Arroz 1 kg (canasta básica)",
      "cantidad": 2,
      "precio_unitario": 1200,
      "codigo_tarifa": "02",     // 02 = tarifa reducida 1 %
      "tarifa": 1
    }
  ]
}
// ← 202: { clave, consecutivo } en segundos → imprimí el tiquete ya.

Ferretería El Tornillo tiene dos cajas y factura todo el día. A media mañana, un vecino compra una bolsa de cemento y unos tornillos por ₡12.430 con tarjeta. No pide nada a su nombre: sale un tiquete electrónico (04) por la caja 2, y la fila sigue avanzando porque la clave volvió en segundos.

Al rato entra el encargado de una constructora que necesita factura para deducir el gasto de la obra. El cajero no cambia de sistema ni de caja: emite una factura electrónica (01) con la cédula jurídica de la constructora —que ya estaba guardada como cliente frecuente— y a la empresa le llega el PDF y el XML por correo. La secuencia de la caja 2 avanza sola, aparte de la caja 1.

Mismo mostrador, mismos productos con su CABYS y su IVA, dos comprobantes distintos según quién compra. Lo único que cambió fue el tipo de documento —y eso el sistema lo resolvió sin frenar la venta.

• Factura vs. tiquete electrónico — cuándo usar cada uno en el mostrador y por qué.
• Facturar desde tu POS — si ya tenés punto de venta y querés timbrar desde la caja.
• Cómo empezar a facturar — inscripción, certificado .p12 y credenciales de sandbox para probar.
• ¿Venís de otro sistema? Migrar de TicoFactura o mirá la comparativa de sistemas.