Concepto · Facturación electrónica

¿Qué es el XML de la factura electrónica y qué hago con él?

El XML es un archivo de texto que es tu factura electrónica: adentro llevan escritos los datos de la venta en el formato exacto que exige Hacienda, va firmado digitalmente y es lo que Hacienda valida. El PDF que sí podés leer es solo la foto del comprobante. El que tiene validez fiscal es el XML.

¿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

Esta es la idea que hay que llevarse: el documento fiscal es el XML. El PDF es una representación bonita para que un humano lo lea, pero Hacienda nunca mira el PDF. Si alguna vez tenés que demostrar una compra, lo que vale es el XML.

¿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 XMLEl PDF
Qué esEl comprobante fiscal en síLa representación legible para humanos
Lo valida HaciendaSí — es lo que se firma y se envíaNo — Hacienda nunca lo mira
Sirve para el IVA / la rentaSí, es el respaldo oficialSolo para leerlo, no como respaldo único
Se puede editarNo: va firmado, cualquier cambio lo invalidaSí, es un archivo cualquiera
Hay que conservarloSí, es obligatorioConviene, 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

El error clásico es quedarse solo con el PDF y borrar el XML "porque no se entiende". Si después necesitás respaldar ese gasto, el PDF solo puede no alcanzar. Y nunca abras el XML para "corregir" algo: cualquier cambio lo invalida. Si la factura tiene un error, lo correcto es una , no tocar el archivo.

¿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

Cuánto tiempo exacto tenés que conservar los XML y cómo se cruzan con tus declaraciones depende de tu régimen y actividad. Esta página explica el concepto; para tu caso puntual, validá con tu contador o asesor fiscal.

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 API

Te 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.