Anexos y Estructuras v4.4 AY-027

Especificación técnica XML — Vigente desde 01/09/2025 (Noviembre 2024 · DGT)

Menú Ayuda

Vigencia

FechaHito
01/12/2024Inicio del plazo de implementación (9 meses)
01/01/2025Obligatorio implementar campos de medicamentos en v4.3
01/04/2025Quienes tengan desarrollos previos pueden adoptar v4.4
01/09/2025v4.4 obligatoria — deroga v4.3 y anteriores
06/10/2025Plazo máximo de prórroga (casos justificados)
PendienteVigencia del Código QR (suspendida hasta comunicado DGT)
A partir del 01/09/2025 v4.3 y anteriores solo se podrán usar para NC/ND que ajusten comprobantes emitidos durante su vigencia.

Tipos de comprobante

SiglaTipoUso
FEFactura ElectrónicaVenta a cliente identificado
FEEFactura Electrónica de ExportaciónVenta al exterior
FECFactura Electrónica de CompraEl adquirente factura cuando el vendedor no está obligado
TETiquete ElectrónicoConsumidor final (no respalda créditos/gastos)
NCNota de Crédito ElectrónicaAnula/modifica efectos contables
NDNota de Débito ElectrónicaCargos adicionales
REPRecibo Electrónico de PagoPago parcial de venta a crédito (LIVA art. 27) — nuevo

Cada tipo tiene su XML Schema (XSD) bajo el namespace https://cdn.comprobanteselectronicos.go.cr/xml-schemas/v4.4/.

Apartados del XML

ApartadoContenido
a) EncabezadoVersión, numeración, identificación, condiciones de venta, emisor, receptor
b) DetalleLíneas con cantidad, valor, impuestos, descuentos, monto neto
c) Resumen / TotalTotalización de montos
d) Información de referenciaDocumento sustituido (NC/ND, contingencia, etc.)
e) Otros (uso comercial)Información no tributaria
f) Mecanismo de seguridadFirma digital o llave criptográfica del MH

Condiciones de campo

CódigoCondiciónSignificado
1ObligatorioSiempre debe estar
2CondicionalObligatorio en ciertas circunstancias
3OpcionalSi lo desea
4InexistenteNo debe usarse en ese tipo

Validaciones (3 niveles)

NivelVerifica
1Estructura vigente (XSD)
2Formato de campos
3Información en BD del MH (CABYS, RUT, actividades)

Si supera los 3 niveles → emite mensaje de aceptación. Si falla cualquiera → emite mensaje de rechazo con detalle.

Cambios principales v4.4

Encabezado

  • Cédulas alfanuméricas para personas jurídicas (Q4 2026).
  • Nuevo campo ProveedorSistemas obligatorio (20 chars).
  • Nuevo CodigoActividadReceptor.
  • Nuevos tipos de identificación: 05 Extranjero No Domiciliado y 06 No Contribuyente (uso exclusivo FEC).
  • Cédula expandida a 20 caracteres con códigos 05/06.
  • Nuevo Registrofiscal8707 para bebidas alcohólicas.
  • Eliminado el nodo Fax.
  • Teléfono: mín 8, máx 20 dígitos (excepción 911).

Condiciones de venta (nota 5)

  • 12 Venta Mercancía No Nacionalizada
  • 13 Venta Bienes Usados No Contribuyente
  • 14 Arrendamiento Operativo
  • 15 Arrendamiento Financiero
  • PlazoCredito ahora es Integer de 5 dígitos en días.

Detalle

  • Nuevo TipoTransaccion (nota 22).
  • Nuevo VINoSerie para vehículos.
  • Nuevo nodo DetalleProductosSurtido (hasta 20) para CABYS combos.
  • Nuevo IVAcobradoFabrica (nota 21).
  • BaseImponibleEspecialBaseImponible.
  • Cardinalidad de Impuesto: 1 a 1000.

Otros cambios

  • Medio de pago se traslada al apartado Resumen/Total.
  • Firma del receptor en comprobantes a crédito.
  • Firmas para endoso (factura endosada).

Tarifas IVA (nota 8.1)

CódigoTarifaEstado
01Tarifa 0% (Art. 32, num 1, RLIVA) — antes "Exento"Activo
02Tarifa reducida 1%Activo
03Tarifa reducida 2%Activo
04Tarifa reducida 4%Activo
05Transitorio 0%Solo NC/ND
06Transitorio 4%Solo NC/ND
07Transitorio 8%Inhabilitado
08Tarifa general 13%Activo
09Tarifa reducida 0.5%Nuevo
10Tarifa ExentaNuevo
11Tarifa 0% sin derecho a créditoNuevo

Exoneraciones (nota 10.1)

CódigoExoneraciónEstado
01Compras autorizadas DGTInhabilitado
02Ventas exentas a diplomáticosActivo
03Autorizado por Ley especialActivo
04Exenciones DGH Autorización Local GenéricaActivo (renombrado)
05Transitorio V (ingeniería/arq./topografía obra civil)Inhabilitado
06Servicios turísticos ICTInhabilitado
07Transitorio XVII (Reciclaje)Inhabilitado
08Exoneración a Zona FrancaNuevo
09Servicios complementarios export. (Art 11 RLIVA)Nuevo
10Órgano de las corporaciones municipalesNuevo
11Exenciones DGH Autorización Impuesto Local ConcretaNuevo

Medios de pago (nota 6)

CódigoMedio
01Efectivo
02Tarjeta
03Cheque
04Transferencia / Depósito Bancario
05Recaudado por terceros
06SINPE Móvil (nuevo)
07Plataforma Digital (nuevo)
99Otros

Otros cargos (nota 16)

  • 08 Depósitos de Garantía
  • 09 Multas o Penalizaciones
  • 10 Intereses Moratorios

Información de referencia

Tipos de referencia (nota 9)

  • 06 Devolución de mercancía
  • 07 Sustituye Comprobante electrónico
  • 08 Factura Endosada
  • 09 Nota de crédito financiera
  • 10 Nota de débito financiera
  • 11 Proveedor No Domiciliado
  • 12 Crédito por exoneración posterior a la facturación
  • 13–17 (Bitácora 22/04/2026)

Tipos de documento (nota 10)

  • 10 Comprobante electrónico rechazado por el MH
  • 14 Comprobante aportado por contribuyente de Régimen Especial
  • 16 Comprobante de Proveedor No Domiciliado
  • 17 Nota de Crédito a Factura Electrónica de Compra
  • 18 Nota de Débito a Factura Electrónica de Compra
  • 19, 20 (Bitácora 22/04/2026)

Cédulas alfanuméricas (Q4 2026)

Formato del campo Numero según tipo de identificación:

CódigoTipoFormato
01Cédula física9 dígitos, sin cero al inicio, sin guiones
02Cédula jurídica10 caracteres alfanuméricos, sin guiones
03DIMEX11 o 12 dígitos, sin ceros al inicio
04NITE10 dígitos, sin ceros al inicio
05Extranjero No DomiciliadoHasta 20 caracteres alfanuméricos (FEC exclusivo)
06No ContribuyenteHasta 20 caracteres alfanuméricos (FEC exclusivo)
FactuPOS ya tiene implementado el soporte alfanumérico desde 2026-04-28 (helpers normalizarCedula() y validaCedula() en PHP y JS).

Archivos de la versión 4.4

Documentos descargados de Hacienda en /var/www/factupos.com/Documentacion/Hacienda/info/v4.4/:

ArchivoContenido
ANEXOS_Y_ESTRUCTURAS_V4.4.pdfDocumento técnico completo (99 páginas)
Guia_IdP.pdfGuía del IdP de Comprobantes Electrónicos
FacturaElectronica_V4.4.{doc,xsd}Estructura FE
FacturaElectronicaCompra_V4.4.{doc,xsd}Estructura FEC
FacturaElectronicaExportacion_V4.4.{doc,xsd}Estructura FEE
TiqueteElectronico_V4.4.{doc,xsd}Estructura TE
NotaCreditoElectronica_V4.4.{doc,xsd}Estructura NC
NotaDebitoElectronica_V4.4.{doc,xsd}Estructura ND
ReciboElectronicoPago_V4.4.{doc,xsd}Estructura REP (nuevo)
MensajeHacienda_V4.4.{doc,xsd}Mensaje de respuesta del MH
MensajeReceptor_V4.4.{doc,xsd}Mensaje de aceptación/rechazo
Codificacionubicacion_V4.4.xlsxCódigos provincia/cantón/distrito/barrio
Codigodemoneda_V4.4.pdfCódigos ISO de moneda
Nota_9_Codigo_Forma_Farmaceutica.xlsxCódigos de forma farmacéutica

Documentos relacionados