Facturar por panel o por API: ¿cuándo usar cada uno?

Son dos formas de disparar la misma emisión. El comprobante electrónico que sale es idéntico: el mismo .xml v4.4, la misma firma XAdES, la misma clave de 50 dígitos y su consecutivo. Lo que cambia es quién lo dispara y cómo:

• Panel (interfaz web): una persona entra al sistema, elige el cliente, arma las líneas y presiona Emitir. Es facturación manual, a la vista.
• API (endpoint REST): tu propio software hace un POST con los datos de la venta y el comprobante sale solo, sin que nadie teclee nada.

Dicho de otra forma: el panel es para vos (o tu equipo), la API es para tu sistema. Ninguno es "más real" que el otro ante Hacienda.

El criterio principal es el volumen y si tus ventas ya viven en un sistema. Si facturás poco y a mano, el panel te sobra. Si vendés mucho —o cada venta ya queda registrada en tu e-commerce, POS o ERP— la API te ahorra el doble tecleo y los errores:

Una guía rápida por escenario:

No. A Hacienda le da igual si emitiste a mano o por código: lo que exige es el mismo XML v4.4 firmado con XAdES, con su clave de 50 dígitos, su consecutivo de 20 y el correo al receptor con el PDF y el XML. La versión 4.4 es obligatoria desde el 1 de setiembre de 2025, y las sanciones por no emitir o emitir mal —artículos 83 y 86 del CNPT, hasta 100 salarios base y hasta cierre del negocio— aplican igual por panel que por API. Los detalles y fechas los seguimos en facturación electrónica 4.4: qué cambia y desde cuándo.

Y el estado del comprobante (aceptado o rechazado) tampoco depende del canal: se consulta igual por la clave. Cómo funciona eso lo explicamos en estado del comprobante: webhook o consulta.

Plaxp Invoice te da los dos canales sobre el mismo motor de emisión: el mismo emisor, el mismo certificado .p12, los mismos consecutivos por caja. No es "una herramienta para el panel y otra para la API": es una sola, con dos puertas de entrada.

Lo importante: podés empezar en el panel y migrar a la API cuando crezcas, sin cambiar de proveedor y sin reiniciar tu numeración —los consecutivos los llevamos nosotros por caja. Así emitís por API cuando lo dispara tu venta:

curl -X POST 'https://api.plaxp.com/api/procesar' \
  -H 'Content-Type: application/json' \
  -H "X-API-Key: $PLAXP_API_KEY" \
  -d '{ "tipo_documento": "01", "condicion_venta": "01", ... }'
# → 202 { data: { clave, consecutivo } }  (firma + envío a Hacienda en background)

Si vas a integrar por código, el punto de partida es la documentación de la API. Y si tu volumen viene de una tienda en línea, mirá factura electrónica para WooCommerce y Shopify. ¿Recién arrancás? Empezá por el paso a paso para facturar.

Mismo país, misma normativa, decisiones opuestas —y las dos correctas:

• Dra. Fonseca, consultorio en Curridabat. Atiende y emite unas 25 facturas al mes, una por paciente. Le sobra el panel: abre Plaxp, elige el paciente (guardado), pone la consulta en ₡35.000 con IVA del 13 % (total ₡39.550) y emite. Cero código, cero integración.
• Pura Vida Store, ropa en línea. Recibe ~600 órdenes al mes, muchas de madrugada. Nadie va a estar tecleando facturas: conecta su tienda a la API. Cada orden pagada dispara un POST y el tiquete o la factura sale sola, firmada y enviada a Hacienda, con el PDF al cliente en segundos.

Y cuando a la Dra. Fonseca le entre un convenio con una empresa que factura cientos de sesiones, o Pura Vida necesite emitir una nota de crédito puntual por una devolución, cada una usa el otro canal sin cambiar de sistema. Ese es el punto de tener los dos.

Tres cosas que evitan sorpresas:

• La API necesita quien la integre una vez. No es más difícil de usar que el panel a largo plazo, pero sí requiere un desarrollador al inicio. Si no tenés equipo técnico y facturás poco, el panel es el camino sensato.
• El volumen no es lo único. Aunque emitas poco, si tus ventas ya viven en un e-commerce o POS, la API te ahorra copiar datos a mano y elimina errores de digitación.
• No te encajona. Con un proveedor que solo tiene panel —como el facturador gratuito de Hacienda— no podés automatizar el día que crezcas. Lo vemos en migrar de TicoFactura.