Concepto · Facturación electrónica
¿Qué es el XML de la factura electrónica y qué hago con él?
¿Qué es exactamente un XML?
Abrís el correo de una factura, hay un PDF que entendés bien… y al lado un archivo raro que termina en .xml. Si lo abrís, ves un montón de etiquetas y números. Es normal no entenderlo: el XML no está hecho para que lo leas vos, sino para que lo lean las computadoras de Hacienda.
Un XML es simplemente un archivo de texto ordenado con etiquetas, como una ficha con casillas rotuladas: una casilla dice quién vende, otra quién compra, otra qué producto, otra cuánto IVA. Hacienda definió exactamente qué casillas debe tener una factura electrónica —esa plantilla es la versión 4.4— para poder leerlas todas igual, sin importar quién las emitió.
El XML es el comprobante; el PDF es la foto
¿En qué se diferencia del PDF?
Los dos describen la misma factura, pero cumplen papeles distintos. El PDF es para vos; el XML es para Hacienda y tu contabilidad. Así de simple:
| El XML | El PDF | |
|---|---|---|
| Qué es | El comprobante fiscal en sí | La representación legible para humanos |
| Lo valida Hacienda | Sí — es lo que se firma y se envía | No — Hacienda nunca lo mira |
| Sirve para el IVA / la renta | Sí, es el respaldo oficial | Solo para leerlo, no como respaldo único |
| Se puede editar | No: va firmado, cualquier cambio lo invalida | Sí, es un archivo cualquiera |
| Hay que conservarlo | Sí, es obligatorio | Conviene, pero el que cuenta es el XML |
Ese archivo .xml además va firmado con un certificado digital (el .p12) mediante una firma llamada . Por eso no se puede editar: si le cambiás una coma, la firma se rompe y deja de valer. El PDF, en cambio, es un archivo común que cualquiera puede modificar —por eso no sirve como respaldo por sí solo.
Me llegó un XML por correo, ¿qué hago con él?
Guardalo. Eso es todo. No hace falta abrirlo, imprimirlo ni entenderlo. Ese XML es el respaldo oficial de esa compra, y lo vas a necesitar para dos cosas:
- Deducir el gasto y el IVA. Cuando tu contador prepara la declaración de IVA (formulario D-104) o la renta, se apoya en los XML de tus compras, no en los PDF.
- Respaldar la compra si Hacienda pregunta. Ante una revisión, lo que se muestra es el XML, no el papelito ni el PDF.
En la práctica, junto con el XML de la factura te llega (o deberías poder obtener) también el XML de respuesta de Hacienda, que es la constancia de que ese comprobante fue aceptado. Conviene conservar los dos. La duda de siempre —"¿cómo sé que Hacienda de verdad lo aceptó?"— la explicamos en .
No lo borres, no lo edites
¿Qué dice la normativa de Costa Rica sobre el XML?
La regla de fondo es clara: el comprobante que la norma reconoce es el XML firmado, no el PDF. Por eso, cuando emitís una factura electrónica, estás obligado a entregarle al cliente el XML (no solo el PDF), y a conservar tus propios XML por el plazo que exige la legislación tributaria. El PDF es la representación gráfica: la norma la permite para que la gente lea el comprobante, pero deja claro que no sustituye al XML.
Esto viene de la mano de la versión 4.4, obligatoria desde el 1 de setiembre de 2025, y del hecho de que hoy todo el trámite vive en TRIBU-CR (el portal que reemplazó al ATV; el facturador gratuito TicoFactura se descontinuó en octubre de 2025). Los detalles y las fechas están en .
Confirmá con tu contador
Ejemplo: una soda en Cartago
Doña Marta tiene una soda y le compra ₡40.000 de verduras a su proveedor. El proveedor le emite una factura electrónica y le llegan al correo dos archivos: un PDF que dice "Factura ₡40.000 + IVA" y un .xml con el mismo detalle en formato de Hacienda.
- Doña Marta mira el PDF para confirmar el monto y el detalle. Perfecto para el día a día.
- Pero guarda el XML en una carpeta (o lo hace su sistema). Ese es el que su contador va a usar para la declaración de IVA D-104.
- Si algún día Hacienda le pide respaldo de esa compra, presenta el XML, no el PDF ni el recibo.
Y del otro lado del mostrador, cuando ella le vende un casado a un cliente que pide factura, ocurre lo mismo al revés: su sistema arma el XML con el código CABYS de cada producto, lo firma, lo manda a Hacienda y le envía al cliente el PDF y el XML. Doña Marta nunca toca un archivo .xml a mano.
¿Cómo maneja Plaxp el XML por mí?
La gracia de un buen sistema de facturación es que vos no tocás el XML nunca. Con Plaxp Invoice, cuando emitís una factura (desde el panel o por API), nosotros nos encargamos de toda la parte técnica del archivo:
- Generamos el XML v4.4 con todas las casillas que exige Hacienda, a partir de los datos de la venta
- Lo firmamos con tu certificado
.p12(firma XAdES-EPES), sin que tengás que instalar nada - Lo enviamos a Hacienda y consultamos por vos si quedó aceptado o rechazado
- Lo guardamos: podés recuperar el XML firmado y el XML de respuesta de Hacienda por su clave, cuando querás
- Y lo representamos en un PDF legible que le llega al cliente junto con los XML, como manda la norma
Es decir: vos declarás qué vendiste y Plaxp produce el XML, lo firma, lo envía, lo archiva y lo convierte en el PDF que ve tu cliente. Si querés ver cómo se hace por código, mirá la ; si te interesa la parte de la firma, está en . Y si venís de otra herramienta, mirá o la .
¿Querés dejar de pelear con archivos XML?
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.
