Concepto · Punto de venta
¿Cómo facturar electrónicamente desde tu POS?
POST a la API al cobrar y recibe la clave de 50 dígitos en segundos, así el tiquete o la factura imprime al instante y el cajero no sale del POS. Plaxp arma el XML v4.4, lo firma, lo envía a Hacienda y le manda el comprobante al cliente por correo.¿Qué es timbrar desde el POS?
Es que el mismo software con el que cobrás —tu punto de venta— sea el que emite el en el instante de la venta. En vez de cerrar el cobro y abrir aparte el facturador de Hacienda para reteclear al cliente y el monto, la caja le pasa los datos a una API y el comprobante sale solo: con su clave, su consecutivo y su firma.
«Timbrar» es la costumbre tica de decir emitir el comprobante fiscal. Antes se timbraban facturas de papel; hoy timbrar es generar el XML de la versión 4.4 y que Hacienda lo acepte. Desde el POS eso pasa sin cambiar de pantalla.
¿Qué problema resuelve facturar desde la caja?
El de la caja que se frena en hora pico. Cuando el cajero tiene que salir del POS, abrir otra herramienta y reteclear la cédula y el monto de cada venta, la fila crece y se cuela un error de tipeo cada tanto. Timbrar desde la caja elimina ese salto: una sola pantalla, una sola captura de la venta.
| momento | salir al facturador | timbrar desde el POS |
|---|---|---|
| Al cobrar | Cerrás en el POS y abrís otra pantalla | La misma pantalla emite el comprobante |
| Datos del cliente | Se reteclean en el facturador | Ya están en la venta; se envían solos |
| El cliente espera | Minutos mientras copiás y timbrás | Segundos: la clave vuelve al instante |
| Consecutivo por caja | Lo llevás vos a mano | Cada caja lleva su secuencia sola |
| Cola en hora pico | Se traba: hay que digitar cada venta | No se traba: la caja factura sin manos |
Es un caso puntual del argumento general de . En un POS el dolor se siente más fuerte porque hay un cliente esperando frente a la caja.
¿Qué dice la normativa de Costa Rica?
Que el comprobante que sale de tu caja tiene que ser el XML de la versión 4.4, firmado con XAdES, con su clave numérica de 50 dígitos y aceptado por Hacienda —da igual que lo emitás desde un portal o desde tu POS por API—. La 4.4 es obligatoria desde el 1 de setiembre de 2025. Los detalles y las próximas fechas los seguimos en .
En la caja, el comprobante correcto depende del cliente: tiquete electrónico (tipo 04) para el consumidor final y factura electrónica (tipo 01) para quien da su cédula y quiere deducir el gasto —la diferencia está en —. Además, el consecutivo de 20 dígitos identifica la sucursal y la caja que emitió, así que cada caja lleva su propia secuencia sin cruzarse con las demás.
Si se cae internet: contingencia
Confirmá con tu contador
¿Cómo lo hace Plaxp?
Con una API REST. Tu POS hace un POST a /api/procesar con los datos de la venta y el codigo_sucursal y codigo_caja de la terminal que está cobrando. La respuesta es HTTP 202: te devuelve la clave de 50 dígitos y el consecutivo al instante, para que la caja imprima sin esperar. La firma y el envío a Hacienda corren en background.
// el POS ya tiene la venta armada al confirmar el cobro:
const res = await fetch('https://api.plaxp.com/api/procesar', {
method: 'POST',
headers: { 'X-API-Key': process.env.PLAXP_API_KEY },
body: JSON.stringify({
tipo_documento: '04', // 04 = tiquete (consumidor final) · 01 = factura
codigo_sucursal: '001', // sucursal de esta caja
codigo_caja: '002', // terminal que está cobrando
condicion_venta: '01', // 01 = contado
medios_pago: [{ tipo: '02', monto: 3390 }], // 02 = tarjeta
lineas: [/* los mismos ítems del carrito, sin reteclear */],
}),
});
const { data } = await res.json();
// ← 202: { clave, consecutivo } en segundos → imprimí el tiquete ya.Cada caja lleva su consecutivo por vos: al dar de alta un emisor se crean su sucursal, su caja y la secuencia de cada tipo de comprobante. Y no tenés que implementar polling contra Hacienda ni recibir webhooks: Plaxp consulta el estado por vos y tu POS lo lee después por clave con GET /api/consultar/:clave —el detalle está en y el catálogo de rechazos en .
- La clave vuelve en segundos (202): la caja imprime sin frenarse
- Un campo decide tiquete o factura, en la misma terminal
- Cada sucursal y caja lleva su propio consecutivo, sin cruces
- No tocás XML ni librerías de firma: subís tu .p12 una vez y mandás JSON
- El PDF y el XML le llegan al cliente por correo, como exige la norma
Tu equipo integra en JSON, no en la burocracia de Hacienda
Ejemplo: una soda con dos cajas en San José
Una soda tiene dos cajas. En hora de almuerzo, la caja 2 cobra un casado por ₡3.000 con tarjeta. El sistema calcula el IVA del 13 % (₡390 sobre la base) para un total de ₡3.390, hace un solo POST con codigo_caja: '002' y recibe la clave en segundos: el tiquete imprime y el cliente sigue su camino sin que nadie retecleara nada.
Un rato después llega un cliente de una empresa que pide factura con la cédula jurídica para deducir el gasto. El cajero no cambia de sistema: en la misma caja emite una factura electrónica (tipo 01) con los datos del receptor, y a esa empresa le llega el PDF y el XML a su correo. La secuencia de la caja 2 avanza sola, aparte de la de la caja 1.
El mismo patrón sirve para tu e-commerce
¿Por dónde arranco?
Si ya tenés tu , conectar tu POS es rápido: configurás tu emisor una vez, te damos credenciales de para probar el flujo completo sin emitir en real, y arrancás a timbrar desde la caja. Si venís de otra herramienta, mirá la o en .
¿Listo para timbrar desde tu propia caja?
Te damos credenciales de sandbox y te acompañamos en la integración. Escribinos y arrancamos hoy.
Solicitar acceso a la APITe acompañamos en la puesta en marcha · soporte rápido de gente real · fácil de usar para todo tu equipo. Somos gente ayudando gente.
