Академический Документы
Профессиональный Документы
Культура Документы
Departamento de Informática
2
Control de versiones
Versión Encargado Descripción
Tabla de contenido
Control de versiones ........................................................................................................................... 2
Estructura del XML: ............................................................................................................................ 7
Datos importantes: ............................................................................................................................. 8
Especificaciones técnicas:............................................................................................................. 10
Descripción de las partes del archivo XML ...................................................................................... 10
Datos del nodo <Encabezado>: .................................................................................................... 10
Datos del nodo <Detalle> <Linea>: .............................................................................................. 16
Datos del nodo <InformacionDeReferencia>: ............................................................................. 22
Datos del nodo <ParametrosAdicionales> .................................................................................. 23
Datos del nodo <Totales>:............................................................................................................ 24
Datos del nodo <Otros>................................................................................................................ 27
Datos del nodo <Otros Cargos> ................................................................................................... 28
Ejemplo de la estructura de los XML (Factura):............................................................................... 29
Métodos del servicio web ................................................................................................................ 30
Métodos de consulta del documento enviado al Ministerio de Hacienda................................. 30
Ejemplo de consulta de un documento: ................................................................................... 30
Método de consulta la respuesta del correo que recibirá la factura. ........................................ 31
Tabla de codificación códigos de respuesta de Correo: .......................................................... 31
Ejemplo correo enviado: ........................................................................................................... 32
Ejemplo correo pendiente: ....................................................................................................... 32
Ejemplo correo no encontrado: ................................................................................................ 32
Método consulta de la respuesta del Ministerio de Hacienda. ................................................. 32
Tabla de codificación códigos de respuesta de Hacienda: ...................................................... 33
Ejemplo de la consulta de la respuesta de un documento: ...................................................... 33
Método de insertar el documento: .............................................................................................. 34
Ejemplo de insertar documento con errores: ........................................................................... 34
Ejemplo de insertar documento con éxito: ............................................................................... 35
Estructuras especiales requeridas por entidades ............................................................................ 36
Walmart ........................................................................................................................................ 36
Automercado ................................................................................................................................ 38
Factura electrónica ........................................................................................................................... 38
Femsa ............................................................................................................................................ 41
BCCR .............................................................................................................................................. 42
Megasuper: ................................................................................................................................... 43
Sigma:............................................................................................................................................ 44
Grupo Q:........................................................................................................................................ 44
Código de barra #1: 0001. ..................................................................................................... 44
El Arreo: ........................................................................................................................................ 44
Notas ................................................................................................................................................. 45
Nota 1: La codificación del tipo de documento debe ser la siguiente: ......................................... 45
Nota 2: La codificación para el tipo de identificación es la siguiente: .......................................... 45
Nota 3: La identificación del receptor debe tener las siguientes características: ........................ 45
Nota 4: La Codificación de la condición de venta es la siguiente: ................................................ 46
Nota 5: La codificación de medio de pago es la siguiente: ........................................................... 46
Nota 6: El desglose de los códigos de impuesto: .......................................................................... 46
Nota: Cuando se facturen bienes usados utilizando como base imponible del IVA el precio de
venta menos el precio de compra, así como, las ventas por catálogo se debe utilizar el código de
impuesto ”07“. .............................................................................................................................. 47
Nota 7: Cuando se trata del IVA las tarifas y códigos a utilizar son las siguientes: ..................... 47
Nota 8: Los códigos de referencia a utilizar son: .......................................................................... 48
Nota 9: La codificación a utilizar en el campo “Tipo de documento de referencia” es la siguiente:
....................................................................................................................................................... 48
Nota 10: La codificación a utilizar en el campo “Tipo de documento exoneración” es la siguiente:
....................................................................................................................................................... 50
Nota 11: Los códigos para la descripción de la respuesta del Ministerio de Hacienda son: ........ 50
Nota 12: La codificación a utilizar en el campo “Tipo de código de producto/servicio” es la
siguiente: ....................................................................................................................................... 50
Nota 13: La codificación a utilizar en el campo “Moneda” es la siguiente: .................................. 51
Nota 15: La codificación a utilizar en los campos cantón, provincia, distrito según el Ministerio
de Hacienda es el siguiente: .......................................................................................................... 57
https://www.hacienda.go.cr/ATV/ComprobanteElectronico/frmAnexosyEstructuras.aspx#
opción codificación_v4.3.zip ......................................................................................................... 67
Nota 16: La codificación a utilizar en el campo “Unidad de medida” es la siguiente: .................. 67
Nota 17: La codificación para el campo “Situación de envió” es la siguiente: ............................ 72
Nota 18: La codificación del correo electrónico debe ser la siguiente: ........................................ 73
Nota 19: La numeración consecutiva debe cumplir con la siguiente estructura:......................... 74
Nota 20: La clave numérica debe cumplir con la siguiente estructura:........................................ 74
Nota 21:............................................................................................................................................. 75
¿Cómo calcular un impuesto al valor agregado u otros impuestos? .............................................. 75
¿Cómo calcular un impuesto del Impuesto Calculo Especial? ........................................................ 76
¿Cómo calcular un impuesto de Bienes Usados? ............................................................................ 77
¿Cómo calcular una exoneración? ................................................................................................... 77
¿Cómo aplicar una regalía? .............................................................................................................. 78
Factura de Compra: .......................................................................................................................... 79
Tabla de códigos de error: ................................................................................................................ 82
Introducción:
El servicio web para facturación electrónica es un sistema en línea que permite enviar los
documentos electrónicos (factura, factura de compra, factura de exportación, tiquete, nota
de crédito y nota de débito) al sistema tributario del Ministerio de Hacienda para ser
registrados como lo estipulan las regulaciones presentes en la actual resolución. El Servicio
está diseñado para que las empresas con sistemas ERP (enterprise resource planning), con
sistemas contables, con sistemas de facturación y con otros tipos de sistemas
administrativos puedan interconectarse con GTI-Factura Electrónica y de esa forma puedan
emitir las facturas electrónicas.
También brinda seguridad en todos sus procesos. Esto le da confianza al cliente que sus
datos o documentos no serán utilizados ni enviados a terceras personas. Ya que para
conectarse se requiere una autenticación del usuario además de algunos datos que solo
tendrá acceso la empresa.
Para la utilización del servicio se requiere que elaboren un XML, el cual está constituido por
las siguientes partes:
Para ver la información más detallada de la estructura del XML puede ir a Descripción de
las partes del archivo XML.
Datos importantes:
Los documentos emitidos son enviados por correo justo como una factura real. Por
lo que se recomienda utilizar correos internos o ficticios de la organización que
realiza la integración del servicio o las pruebas requeridas.
Los contenidos de las etiquetas del documento XML no pueden incluir caracteres
entidad predefinidos en el standard XML 1.0. Los caracteres predefinidos son: “, &,
‘, <, >. Además, no se permite que las etiquetas (nodos) tengan distintos nombres a
la estructura establecida por nuestro sistema. Que no contengan los cierres, que
inicien en mayúscula o contenga errores ortográficos.
1.345285 1.34529 El sexto número (5) El número 5 redondea hacia arriba (así lo trabaja hacienda)
Especificaciones técnicas:
• Servicio WSDL.
• Protocolo SOAP.
**Ver nota**
<CodigoActividad Se debe de indicar el código de String 6 * * * * * *
la actividad económica a
> la cual corresponde el
comprobante electrónico, en
caso
de contar con más de una
actividad económica se debe de
ingresar el código de la
actividad principal.
**Ver nota **
<FechaFactura> Es la fecha en que se hizo la DataTim Si no se envía, se colocará la fecha
factura. Tipo de dato de fecha e del sistema de GTI en el momento de
y hora. Formato: YYYY-MM- emisión
DDTHH:mi:ss] Ejemplo: 2016-
09-26T13:00:00.
Encabezado>Receptor
<Receptor> Contiene los datos del * *
receptor del comprobante.
<NombreReceptor Es el nombre del receptor String 100 * * * * * *
>
Integer 2 * * * * * *
documentación de
Hacienda.
**Ver nota**
<DetalleMerc> Enunciado que describe String 200 * * * * * *
la línea de detalle de la
mercancía transferida o
servicio prestado.
<PrecioUnitario> Precio en la moneda Decimal 18,5 * * * * * *
indicada del producto o
del servicio en relación a
una unidad de medida
de la línea de detalle.
<CodigoTipo> En este campo se coloca IList<byte 2
el tipo de servicio o >
producto.
**Ver nota**
<CodigoProducto> Código Alfanumérico IList<strin 20
interno de la empresa g>
para identificar el
producto o servicio.
<UnidadComercial> Utilizado para indicar String 20
una unidad de medida
que nace del propio giro
comercial del
establecimiento, no es
una cantidad
estandarizada de una
determinada magnitud
física, definida y
adoptada por
convención o por ley
ejemplo "1 Tarima".
<DescripcionExtra> Utilizado para cuándo String 1000
deben de enviar campos
extras en las líneas de
detalle de los
documentos.
<TotalRegalia> Total, de la regalía indica Decimal 18,5
el sub total de los
productos que regala el
negocio, aquí deben de
indicarnos el precio
unitario por la cantidad.
Además cuando se
utilice el precio unitario
deberá ir 0.00
<PartidaArancelaria> Uso exclusivo para String 12 - * - -
Factura de Exportación.
El mínimo y máximo para
esta etiqueta son 12
caracteres.
<Codigo> Codigo de String 13
Producto/Servicio.
**Este campo estará
habilitado, pero se
iniciara su uso en el 2020
según indicaciones del
Ministerio de
Hacienda.**
<BaseImponible> Base imponible especial Decimal 18,5 No, solo cuando se selecciona el
código de impuesto 7 (IVA cálculo
especial)
**Importante**
Si su facturación continuara manejando solo un descuento por línea de detalle podrá la estructura de siempre.
<MontoDescuento> Monto del descuento del Decimal 18,5
producto o del servicio
de la línea de detalle.
<NaturalezaDescuent Enunciado que describe String 80 Si, solo si se utiliza un descuento.
o> el descuento.
**Importante**
Si su facturación manejara más de un descuento por línea de detalle deberá enviarlos los datos en la siguiente
estructura.
Lineas>Descuentos
Descuentos Contiene los descuentos Máximo 5
de la línea por línea.
<MontoDescuento> Monto del descuento del Decimal 18,5
producto o del servicio
de la línea de detalle.
<NaturalezaDescuent Enunciado que describe String 80 Si, solo si se utiliza un descuento.
o> el descuento.
<Impuestos> Contiene el impuesto de
cada producto.
Nodo Impuesto <Impuesto>
<UsaServSalud> Deberá indicarlo el bool
documento fue pagado
con tarjeta y se facturen
**Ver nota**
<PorcentajeCompra> Monto del impuesto Integer 3 * * * * * *
Exonerado o autorizado
sin impuesto.
**Ver nota**
FE FEE FEC TE NC ND
<Totales> Contiene todos los totales del * * * * * *
documento
<TotalServGrava En caso que no posea Decimal 18,5 * * * * * *
dos> exoneración es la suma del
MontoTotal de las líneas que
son servicios y que estén
gravadas con el IVA, es decir, el
código del impuesto 1,7 o 8.
Si cuenta con exoneración se
obtiene de la multiplicación del
MontoTotal por (1 - Porcentaje
Exonerado).
<TotalServExent Es la suma del MontoTotal de Decimal 18,5 * * * * * *
os> las líneas que son servicios y que
no estén gravadas con impuesto
del IVA, es decir que no tengan
Código Impuesto 1,7 o 8.
<TotalServExone Se obtiene al multiplicar el Decimal 18,5 * * * * * *
rados> MontoTotal por el
PorcentajeExonerado de las
líneas que son servicios.
<TotalMercancia En caso que no posea Decimal 18,5 * * * * * *
sGravadas
exoneración es la suma del
>
MontoTotal de las líneas que
son mercancías y que esten
gravadas con el IVA, es decir, el
código del impuesto 1,7 o 8.
Devuelve como respuesta el XML enviado al Ministerio de hacienda asociado con los datos
ingresados por el cliente.
error 0
pendiente 1
enviado 2
no registra 3
Devuelve la respuesta del correo ingresado en el documento según con el consecutivo dado
por parámetro.
aceptado 100
procesando 101
rechazado 102
error 103
Nota importante:
Nota de crédito
Nota importante:
Para las notas de crédito deben contener los elementos requeridos de manera obligatorio
de no ser así los documentos serán rechazadas por Hacienda.
Automercado
Cédula: 3101007186.
Factura electrónica
Estructura:
Etiqueta Nombre Descripción Tipo Tamaño Requerido
Estructura:
Nota importante: Esta entidad maneja más cédulas por ende si las necesita debe
comunicarse al área de servicio al cliente para que se las brinden.
Pricesmart
Cédula: 3101231707.
Factura electrónica
Estructura:
Gessa
Cédula: 3101297812.
Factura electrónica
Estructura:
Femsa
Cédula: 3101005212.
Factura electrónica, nota de crédito y nota de debito
BCCR
Cédula: 4000004017.
50 dígitos
<Param2 BCCR_ORDEN_PEDIDO Número de orden Alfanumérico Mínimo Si
2> 1
de pedido.
y
máximo
50 dígitos
y
máximo
50 dígitos
Megasuper:
Cédula: 3101052164.
Sigma:
Cédula: 3101039749.
Etiqueta Nombre Descripción Tipo Tamaño Requerid
o
Grupo Q:
Cédula: 3101025849.
El Arreo:
Cédula: 3101008150.
Notas
Nota 1: La codificación del tipo de documento debe ser la siguiente:
Tipo de Documento Código
Factura Electrónica 01
Nota de Debito Electrónica 02
Nota de Crédito Electrónica 03
Tiquete Electrónico 04
Factura Electrónica de Compra 08
Factura Electrónica de Exportación 09
Nota: En aquellos casos en los que al momento de la emisión del comprobante electrónico
se desconoce el medio de pago se debe indiciar “Efectivo” o sea el código “01”. Para efectos
de visualización e impresión se mostrará su descripción.
Nota: Cuando se facturen bienes usados utilizando como base imponible del IVA el precio
de venta menos el precio de compra, así como, las ventas por catálogo se debe utilizar el
código de impuesto ”07“.
Nota 7: Cuando se trata del IVA las tarifas y códigos a utilizar son las siguientes:
Nota: Factura por mes vencido se puede utilizar en los comprobantes electrónicos
únicamente cuando el servicio prestado vence el último día del mes, como por ejemplo
servicios públicos, los cuales se facturan en los primeros días del mes, pero los ingresos
pertenecen al mes anterior; En el campo “fecha de emisión del documento de referencia” del
apartado de referencia de debe de indicar la fecha del periodo fiscal que corresponde el
ingreso de la factura.
Tipo de Nombre del tipo de Tipo de Nombre del tipo de Código de Nombre del código
documento documento documento de documento de referencia de referencia
referencia referencia
1 Factura 8 Comprobante 5 Sustituye
emitido en comprobante
contingencia provisional por
contingencia
8 Factura de 8 Comprobante 5 Sustituye
exportación emitido en comprobante
contingencia provisional por
contingencia
9 Factura de compra 8 Comprobante 5 Sustituye
emitido en comprobante
contingencia provisional por
contingencia
2 Nota de debito Todas las Todas las
codificaciones acciones
3 Nota de crédito Todas las Todas las
codificaciones acciones
Nota 11: Los códigos para la descripción de la respuesta del Ministerio de Hacienda son:
Mensaje Código
Aceptado 01
Aceptado parcial 02
Rechazado 03
Aceptación parcial: Para uso exclusivo del Obligado Tributario permite aceptar de forma
parcial el contenido de un comprobante electrónico, permitiendo con esto la confesión de
una nota de crédito que permita ajustar la operación por el monto menor al de la factura
originalmente emitida, de forma tal que la suma algebraica de sus importes, sea positivo el
de la factura y negativo el de la nota de crédito, dando como resultado el valor neto real de
la operación
Herzegovina
105 Metical Mozambiqueño MZN
106 Naira Nigeriana NGN
107 Nakfa Eritreo ERN
108 Ngultrum De Bután BTN
109 Nuevo Shéquel Israelí ILS
110 Nuevo Sol Peruano PEN
111 Ouguiya Mauritana MRO
112 Pa'Anga Tongano TOP
113 Pataca De Macao MOP
114 Peso Argentino ARS
115 Peso Chileno CLP
116 Peso Colombiano COP
117 Peso Cubano CUP
118 Peso Cubano Convertible CUC
119 Peso Dominicano DOP
120 Peso Filipino PHP
121 Peso Mexicano MXN
122 Peso Uruguayo UYU
123 Pula De Botsuana BWP
124 Quetzal Guatemalteco GTQ
125 Rand Sudafricano ZAR
126 Real Brasileño BRL
127 Rial Iraní IRR
128 Rial Omaní OMR
129 Rial Qatarí QAR
130 Rial Yemení YER
131 Riel Camboyano KHR
Nota 15: La codificación a utilizar en los campos cantón, provincia, distrito según el
Ministerio de Hacienda es el siguiente:
Provincia Cantón Distrito Nombre Distrito
1 1 1 CARMEN
1 1 2 MERCED
1 1 3 HOSPITAL
1 1 4 CATEDRAL
1 1 5 ZAPOTE
1 1 6 SAN FRANCISCO DE DOS RÍOS
1 1 7 URUCA
1 1 8 MATA REDONDA
1 1 9 PAVAS
1 1 10 HATILLO
1 1 11 SAN SEBASTIÁN
1 2 1 ESCAZÚ
1 2 2 SAN ANTONIO
1 2 3 SAN RAFAEL
1 3 1 DESAMPARADOS
1 3 2 SAN MIGUEL
1 3 3 SAN JUAN DE DIOS
1 3 4 SAN RAFAEL ARRIBA
1 3 5 SAN ANTONIO
1 3 6 FRAILES
1 3 7 PATARRÁ
1 3 8 SAN CRISTÓBAL
1 3 9 ROSARIO
1 3 10 DAMAS
1 3 11 SAN RAFAEL ABAJO
1 3 12 GRAVILIAS
1 3 13 LOS GUIDO
1 4 1 SANTIAGO
1 4 2 MERCEDES SUR
1 4 3 BARBACOAS
1 4 4 GRIFO ALTO
1 4 5 SAN RAFAEL
1 4 6 CANDELARITA
1 4 7 DESAMPARADITOS
1 4 8 SAN ANTONIO
1 4 9 CHIRES
1 5 1 SAN MARCOS
1 5 2 SAN LORENZO
1 5 3 SAN CARLOS
1 6 1 ASERRI
1 6 2 TARBACA
1 6 3 VUELTA DE JORCO
1 6 4 SAN GABRIEL
1 6 5 LEGUA
1 6 6 MONTERREY
1 6 7 SALITRILLOS
1 7 1 COLÓN
1 7 2 GUAYABO
1 7 3 TABARCIA
1 7 4 PIEDRAS NEGRAS
1 7 5 PICAGRES
1 7 6 JARIS
1 7 7 QUITIRRISI
1 8 1 GUADALUPE
1 8 2 SAN FRANCISCO
1 8 3 CALLE BLANCOS
1 8 4 MATA DE PLÁTANO
1 8 5 IPÍS
1 8 6 RANCHO REDONDO
1 8 7 PURRAL
1 9 1 SANTA ANA
1 9 2 SALITRAL
1 9 3 POZOS
1 9 4 URUCA
1 9 5 PIEDADES
1 9 6 BRASIL
1 10 1 ALAJUELITA
1 10 2 SAN JOSECITO
1 10 3 SAN ANTONIO
1 10 4 CONCEPCIÓN
1 10 5 SAN FELIPE
1 11 1 SAN ISIDRO
1 11 2 SAN RAFAEL
1 11 3 DULCE NOMBRE DE JESÚS
1 11 4 PATALILLO
1 11 5 CASCAJAL
1 12 1 SAN IGNACIO
1 12 2 GUAITIL Villa
1 12 3 PALMICHAL
1 12 4 CANGREJAL
1 12 5 SABANILLAS
1 13 1 SAN JUAN
1 13 2 CINCO ESQUINAS
1 13 3 ANSELMO LLORENTE
1 13 4 LEON XIII
1 13 5 COLIMA
1 14 1 SAN VICENTE
1 14 2 SAN JERÓNIMO
1 14 3 LA TRINIDAD
1 15 1 SAN PEDRO
1 15 2 SABANILLA
1 15 3 MERCEDES
1 15 4 SAN RAFAEL
1 16 1 SAN PABLO
1 16 2 SAN PEDRO
1 16 3 SAN JUAN DE MATA
1 16 4 SAN LUIS
1 16 5 CARARA
1 17 1 SANTA MARÍA
1 17 2 JARDÍN
1 17 3 COPEY
1 18 1 CURRIDABAT
1 18 2 GRANADILLA
1 18 3 SÁNCHEZ
1 18 4 TIRRASES
1 19 1 SAN ISIDRO DE EL GENERAL
1 19 2 EL GENERAL
1 19 3 DANIEL FLORES
1 19 4 RIVAS
1 19 5 SAN PEDRO
1 19 6 PLATANARES
1 19 7 PEJIBAYE
1 19 8 CAJÓN
1 19 9 BARÚ
1 19 10 RÍO NUEVO
1 19 11 PÁRAMO
1 20 1 SAN PABLO
1 20 2 SAN ANDRÉS
1 20 3 LLANO BONITO
1 20 4 SAN ISIDRO
1 20 5 SANTA CRUZ
1 20 6 SAN ANTONIO
2 1 1 ALAJUELA
2 1 2 SAN JOSÉ
2 1 3 CARRIZAL
2 1 4 SAN ANTONIO
2 1 5 GUÁCIMA
2 1 6 SAN ISIDRO
2 1 7 SABANILLA
2 1 8 SAN RAFAEL
2 1 9 RÍO SEGUNDO
2 1 10 DESAMPARADOS
2 1 11 TURRÚCARES
2 1 12 TAMBOR
2 1 13 GARITA
2 1 14 SARAPIQUÍ
2 2 1 SAN RAMÓN
2 2 2 SANTIAGO
2 2 3 SAN JUAN
2 2 4 PIEDADES NORTE
2 2 5 PIEDADES SUR
2 2 6 SAN RAFAEL
2 2 7 SAN ISIDRO
2 2 8 ÁNGELES
2 2 9 ALFARO
2 2 10 VOLIO
2 2 11 CONCEPCIÓN
2 2 12 ZAPOTAL
2 2 13 PEÑAS BLANCAS
2 3 1 GRECIA
1 13 4 LEON XIII
1 13 5 COLIMA
1 14 1 SAN VICENTE
1 14 2 SAN JERÓNIMO
1 14 3 LA TRINIDAD
1 15 1 SAN PEDRO
1 15 2 SABANILLA
1 15 3 MERCEDES
1 15 4 SAN RAFAEL
1 16 1 SAN PABLO
1 16 2 SAN PEDRO
1 16 3 SAN JUAN DE MATA
1 16 4 SAN LUIS
1 16 5 CARARA
1 17 1 SANTA MARÍA
1 17 2 JARDÍN
1 17 3 COPEY
1 18 1 CURRIDABAT
1 18 2 GRANADILLA
1 18 3 SÁNCHEZ
1 18 4 TIRRASES
1 19 1 SAN ISIDRO DE EL GENERAL
1 19 2 EL GENERAL
1 19 3 DANIEL FLORES
1 19 4 RIVAS
1 19 5 SAN PEDRO
1 19 6 PLATANARES
1 19 7 PEJIBAYE
1 19 8 CAJÓN
1 19 9 BARÚ
1 19 10 RÍO NUEVO
1 19 11 PÁRAMO
1 20 1 SAN PABLO
1 20 2 SAN ANDRÉS
1 20 3 LLANO BONITO
1 20 4 SAN ISIDRO
1 20 5 SANTA CRUZ
1 20 6 SAN ANTONIO
2 1 1 ALAJUELA
2 1 2 SAN JOSÉ
2 1 3 CARRIZAL
2 1 4 SAN ANTONIO
2 1 5 GUÁCIMA
2 1 6 SAN ISIDRO
2 1 7 SABANILLA
2 1 8 SAN RAFAEL
2 1 9 RÍO SEGUNDO
2 1 10 DESAMPARADOS
2 1 11 TURRÚCARES
2 1 12 TAMBOR
2 1 13 GARITA
2 1 14 SARAPIQUÍ
2 2 1 SAN RAMÓN
2 2 2 SANTIAGO
2 2 3 SAN JUAN
2 2 4 PIEDADES NORTE
2 2 5 PIEDADES SUR
2 2 6 SAN RAFAEL
2 2 7 SAN ISIDRO
2 2 8 ÁNGELES
2 2 9 ALFARO
2 2 10 VOLIO
2 2 11 CONCEPCIÓN
2 2 12 ZAPOTAL
2 2 13 PEÑAS BLANCAS
2 3 1 GRECIA
1 13 4 LEON XIII
1 13 5 COLIMA
1 14 1 SAN VICENTE
1 14 2 SAN JERÓNIMO
1 14 3 LA TRINIDAD
1 15 1 SAN PEDRO
1 15 2 SABANILLA
1 15 3 MERCEDES
1 15 4 SAN RAFAEL
1 16 1 SAN PABLO
1 16 2 SAN PEDRO
1 16 3 SAN JUAN DE MATA
1 16 4 SAN LUIS
1 16 5 CARARA
1 17 1 SANTA MARÍA
1 17 2 JARDÍN
1 17 3 COPEY
1 18 1 CURRIDABAT
1 18 2 GRANADILLA
1 18 3 SÁNCHEZ
1 18 4 TIRRASES
1 19 1 SAN ISIDRO DE EL GENERAL
1 19 2 EL GENERAL
1 19 3 DANIEL FLORES
1 19 4 RIVAS
1 19 5 SAN PEDRO
1 19 6 PLATANARES
1 19 7 PEJIBAYE
1 19 8 CAJÓN
1 19 9 BARÚ
1 19 10 RÍO NUEVO
1 19 11 PÁRAMO
1 20 1 SAN PABLO
1 20 2 SAN ANDRÉS
1 20 3 LLANO BONITO
1 20 4 SAN ISIDRO
1 20 5 SANTA CRUZ
1 20 6 SAN ANTONIO
2 1 1 ALAJUELA
2 1 2 SAN JOSÉ
2 1 3 CARRIZAL
2 1 4 SAN ANTONIO
2 1 5 GUÁCIMA
2 1 6 SAN ISIDRO
2 1 7 SABANILLA
2 1 8 SAN RAFAEL
2 1 9 RÍO SEGUNDO
2 1 10 DESAMPARADOS
2 1 11 TURRÚCARES
2 1 12 TAMBOR
2 1 13 GARITA
2 1 14 SARAPIQUÍ
2 2 1 SAN RAMÓN
2 2 2 SANTIAGO
2 2 3 SAN JUAN
2 2 4 PIEDADES NORTE
2 2 5 PIEDADES SUR
2 2 6 SAN RAFAEL
2 2 7 SAN ISIDRO
2 2 8 ÁNGELES
2 2 9 ALFARO
2 2 10 VOLIO
2 2 11 CONCEPCIÓN
2 2 12 ZAPOTAL
2 2 13 PEÑAS BLANCAS
2 3 1 GRECIA
Nota: Para ver todas las codificaciones que brinda el Ministerio de Hacienda puede
encontrarla en:
https://www.hacienda.go.cr/ATV/ComprobanteElectronico/frmAnexosyEstructuras.aspx#
opción codificación_v4.3.zip
Debe tomar en cuenta que por cambios de Hacienda las unidades que marcaremos como *
corresponde a servicios por ende en los cálculos de los totales no podrá enviarlas como mercancías.
Además, a nivel de líneas de detalle ya no deberá indicar el Tipo “S” o “M” que con la versión 4.2
indicaba.
1 Unid Unidad
2 kg Kilogramo
4 Oz Onzas
5 L litro
7 Gal Galón
10 m Metro
12 min minuto
13 h hora *
14 d dia *
19 mL mililitro
20 g Gramo
23 t tonelada
24 Sp Servicios Profesionales *
25 s Segundo *
26 A Ampere
27 K Kelvin
28 mol Mol
29 cd Candela
30 m² metro cuadrado
31 m³ metro cúbico
41 rad radián
42 sr estereorradián
43 Hz hertz
44 N newton
45 Pa pascal
46 J Joule
47 W Watt
48 C coulomb
49 V volt
50 F farad
51 ? ohm
52 S siemens
53 Wb weber
54 T tesla
55 H henry
56 °C grado Celsius
57 lm lumen
58 lx lux
59 Bq Becquerel
60 Gy gray
61 Sv sievert
62 kat katal
85 º grado
86 Np neper
87 bel bel
88 eV electronvolt
90 ua unidad astronómica
91 Km Kilometro
92 ln pulgada
93 cm centimetro
94 mm Milimetro
95 Otros Otros
98 Cm Comisiones *
99 I Intereses *
103 Kw kilovatios
Facturación Sin Internet: Este caso se presenta cuando el sistema generador puede crear
la factura o documento electrónico correctamente, pero sin embargo por alguna causa no
se puede hacer llegar al sistema del Ministerio de Hacienda, esto puede ser a causa de que
no haya conexión con internet temporalmente, o que el sistema de Hacienda este con
problemas. En estos casos se debe almacenar la factura y cuando nuevamente se den las
condiciones para que lleguen al sistema de Hacienda se deben enviar con situación de envió
Sin Internet y con la fecha de contingencia en que se creó la factura y no cuando se envió a
hacienda.
^\s*[a-zA-Z0-9_\-\.~]{1,}@[a-zA-Z0-9_\-\.~]{2,}\.[a-zA-Z]{2,10}\s*$
.-
-.
..
@.
.@
--
El cliente debe tomar en cuenta en el caso que ellos nos brinden el número consecutivo que
la sucursal 001 queda terminantemente prohibido utilizarla ya que esta es utilizada por GTI.
Debe ser de cincuenta dígitos; la clave para cada documento electrónico es única y se
encuentra compuesta de la siguiente manera:
Descripcion Código
Contribución parafiscal 01
Timbre de la Cruz Roja 02
Timbre de Benemérito Cuerpo de 03
Bomberos de Costa Rica
Cobro de un tercero 04
Costos de Exportación 05
Impuesto de servicio 10% 06
Timbre de Colegios Profesionales 07
Otros Cargos 99
Línea:
Cantidad: 1.
Precio unitario: 9000.
Descuento: 150.
Impuesto:
o Codigo impuesto: 1.
o Codigo tarifa: 2.
Pasos:
1. Debe calcular el subtotal de la línea que se obtiene al multiplicar ((cantidad * precio
unitario) menos descuentos).
a. Subtotal: 8850.
2. Debe calcular el monto del impuesto que se obtiene al multiplicar (subtotal * el
porcentaje del impuesto) para este ejemplo se utilizó el impuesto 1, es decir, el IVA
por ende siempre debe llevar un código de tarifa y según el seleccionado se obtiene
el porcentaje que puede observarlo dando clic aquí. Según la codificación el
porcentaje seria 1.
a. MontoImpuesto: 88,5.
Línea:
Cantidad: 1.
Precio unitario: 9000.
Descuento: 150.
Base imponible: 500.12.
Impuesto:
o Codigo impuesto: 7.
o Codigo tarifa: 2.
Pasos:
1. Debe calcular el monto del impuesto que se obtiene al multiplicar (base imponible
* el porcentaje del impuesto) para este ejemplo se utilizó el impuesto 7, es decir, el
IVA calculo especial por ende siempre debe llevar un código de tarifa y según el
seleccionado se obtiene el porcentaje que puede observarlo dando clic aquí. Según
la codificación el porcentaje seria 1.
a. MontoImpuesto: 5,00.
Línea:
Cantidad: 1.
Precio unitario: 9000.
Descuento: 150.
Impuesto:
o Codigo impuesto: 8.
o Factor IVA: 2
Pasos:
Pasos:
En versiones anteriores del servicio web usted debía aplicar regla de 3 y cambiar el
monto del impuesto, ahora no debe hacerlo. Por ende, la línea quedaría:
Línea:
Cantidad: 1.
Precio unitario: 900.
Descuento: 150.
Impuesto:
o Codigo impuesto: 1.
o Codigo tarifa: 2.
o Monto impuesto: 7.50.
Exoneración:
Porcentaje exoneración: 5.
Monto exonerado: 0.38.
Imagínese el siguiente escenario. Usted le va a vender 10 quesos a un cliente y por ser una
compra grande, usted desea regalarle un queso de cortesía, pero los quesos que usted
vende deben de pagar un impuesto al Ministerio de Hacienda. Entonces este escenario debe
de enviarlo de la siguiente manera:
Gestión en Tecnología e Información GTI S.A
Tel: 2105-4400
79
Con esto sus facturas no tendrán problemas de regalar productos y enviarlos con hacienda
puesto que estará pagando el debido impuesto del producto.
Factura de Compra:
Para la factura electrónica de compra se invertirán los papeles su empresa pasa a ser el
receptor y el receptor pasara a ser el emisor, pero GTI se encargará de realizar internamente
este cambio para que su empresa o desarrollo no tenga ninguna afectación, pero debe
tomar en cuenta la información siguiente:
1. Usted deberá seguir enviando la información del receptor (su cliente) igual en el
apartado Receptor, pero debe tomar en cuentas las siguientes restricciones de los
campos:
Encabezado>Receptor
FE FEE FC TE NC ND
<Receptor> Contiene los datos del * *
receptor del comprobante.
<NombreReceptor Es el nombre del receptor String 100 * * * * * *
>
<TipoIdentificacio Tipo de identificación del Integer 2 * * * * * *
n> receptor.
**Ver nota**
Debe colocarlo si se utiliza
identificación del receptor.
<IdentificacionRec Es la identificación del String 20 * * * * * *
eptor> receptor. Debe colocarlo si se utiliza el tipo de
**Ver nota** identificación del receptor.
El tipo de identificación 10
(Extranjero) es inexistente.
<idProvincia> Es el número que identifica la Integer 1 * * * * *
provincia según la
documentación de Hacienda.
**Ver nota**
<idCanton> Es el número que identifica el Integer 2 * * * * *
cantón según la
documentación de Hacienda.
**Ver nota**
<idDistrito> Es el número que identifica el Integer 2 * * * * *
distrito según la
documentación de Hacienda.
**Ver nota**
7 En el archivo XML el nodo (FechaFactura) no puede La fecha del documento no puede ser
ser menor a 3 días, según la (SituacionEnvio). menos a tres días según la situación
de envió que tiene este documento.
10 En el archivo XML no existe un nodo (TipoDoc) con un El tipo de documento, que quiere
valor valido, según la estructura establecida. emitir, no lo coloco o es incorrecto.
13 En el archivo XML no existe un nodo (DiasCredito) con Los días de crédito, son requeridos ya
un valor valido, según la condición de venta. que la condición de venta es crédito,
no coloco los días de crédito o su valor
es incorrecto.
23 En el archivo XML no existe un nodo (idCanton) con un El código del cantón no se colocó o su
valor válido, según la estructura establecida. valor es incorrecto.
24 En el archivo XML no existe un nodo (idDistrito) con EL código del distrito no se colocó o su
un valor válido, según la estructura establecida. valor es incorrecto.
25 En el archivo XML no existe un nodo (idBarrio) con un El código del barrio no se colocó o su
valor válido, según la estructura establecida. valor es incorrecto.
29 En el archivo XML no existe un nodo (Detalle) con un No se colocó el detalle del documento
valor válido, según la estructura establecida. o es incorrecto.
33 En el archivo XML no existe un nodo (CodigoTipo) con El código tipo producto no se colocó
un valor válido, según la estructura establecida. o su valor es incorrecto.
56 En el archivo XML los (TipoDoc) 2 y 3 (Nota de débito, Los documentos: Nota de débito, nota
Nota de Crédito) y la (SituacionEnvio) de crédito y la situación de envió por
2(Contingencia), debe contener contingencia debe tener información
(InformacionDeReferencia). de referencia.
57 En el archivo XML no existe un nodo (Totales) con un Los totales no se colocaron o su valor
valor válido, según la estructura establecida. es incorrecto.
63 En el archivo XML no existe un nodo (TotalExento) con El total exento no se colocó o su valor
un valor válido, según la estructura establecida o la es incorrecto.
configuración de decimales.
69 En el archivo XML, el nodo (PrecioUnitario) indica que El precio unitario es cero debe colocar
es cero, debe colocar el (TotalRegalia). el total de la regalía.
76 El archivo XML los valores indicados en el apartado Los totales indicados no concuerdan
(Totales) no coinciden con los cálculos por GTI. con los cálculos realizados por GTI.
78 Error interno en generar la firma digital del Error al generar la firma digital,
documento, comuníquese con el administrador. comuníquese con el administrador.
80 Error al insertar línea de detalle, comuníquese con el Error al guardar la línea de detalle,
administrador. comuníquese con el administrador.
81 Error al generar el XML del documento, comuníquese Error al generar el XML del
con el administrador. documento, comuníquese con el
administrador.
82 Error interno al guardar el XML que se enviara a Error al guardar el XML, comuníquese
hacienda, comuníquese con el administrador. con el administrador.
84 En el archivo XML el nodo (FechaFactura) debe estar La fecha del documento debe estar
entre el rango 1/1/1753 12:00:00 AM y 12/31/9999 entre el rango establecido.
11:59:59 P.M.
OtrosCargos(TipoDocumento)
número 4.
100 En el archivo XML no existe un nodo (Codigo) con un El (Codigo) de la línea no cumple con
valor válido, según la estructura establecida el formato establecido.
101 En el archivo XML no existe un nodo (Descuentos) con Los (Descuentos) de la línea no
un valor válido, según la estructura establecida cumple con el formato establecido o
excede el máximo permitido.
104 En el archivo XML no existe un nodo (CodigoTarifa) con El (CodigoTarifa) es obligatorio para el
un valor válido, según la estructura establecida impuesto 1 (IVA) y 7 (IVA cálculo
especial).
105 En el archivo XML no existe un nodo (CodigoTarifa) con El (CodigoTarifa) no tiene un valor
un valor válido, según la estructura establecida válido según la configuración
establecida.
106 En el archivo XML no existe un nodo (FactorIVA) con un El (FactorIVA) es obligatorio para el
valor válido, según la estructura establecida impuesto 8 (IVA Régimen de Bienes
Usados).
107 En el archivo XML no existe un nodo (FactorIVA) con un El campo (FactorIVA) no tiene un valor
valor válido, según la estructura establecida válido según la configuración
establecida.
115 Error al Agregar Línea Otros Cargos. Error al agregar la línea de Otros
Cargos, comuníquese con el
administrador.