NUC JSON V4.4.0 — Costa Rica

3Convenciones utilizadas en el formato JSON

3.1 Columnas de las tablas de definición

Tabla 2 — Significado de cada columna en las tablas del NUC

Título	Descripción
`C`	Conjunto de campos
`ID`	Identificador del campo, para fines de referencia
`Campo`	Nombre del campo
`Descripción`	Descripción del campo y su significado
`P`	Referencia al ID del campo del grupo que contiene este campo específico (padre)
`T`	Tipo de dato (ver Tabla 3)
`Tam`	Tamaño del campo (ver Tabla 4)
`Ocu`	Ocurrencias en el formato m-n, en el cual m: número mínimo de veces que el campo debe aparecer en el grupo; n: número máximo de veces que el campo puede aparecer en el grupo. Cabe recalcar que si un campo contiene un valor de 1-n, este campo es Obligatorio. Si un campo contiene un valor de 0-n, este campo es Opcional a excepción que pertenezca a una validación condicional dependiendo del valor que tenga otro campo.
`Observaciones`	Observaciones importantes sobre el elemento, incluyendo listas de posibles valores, validaciones relevantes, entre otras.

3.2 Tipos de dato en el archivo JSON

Tabla 3 — Tipos de dato

Tipo	Descripción
JSON	Documento JSON, descrito en un esquema contenido en esta ficha técnica
O	Objeto JSON y/o grupos de elementos
A	Alfanumérico
N	Numérico: ver diversos formatos en la Tabla 4
F	Fecha: Los campos de fecha deberán siempre contener fecha y hora en el formato UTC (Universal Coordinated Time), o sea: AAAA-MM-DDThh:mm:ssTZH. Por ejemplo, para expresar 2:23 PM de 17 de abril de 2017, en la zona horaria GMT-6 (hora de Costa Rica): 2017-04-17T14:23:00-06:00
L	Arreglo o Lista: Atributo de tipo arreglo que puede contener "n" cantidad de objetos o datos
I	Información Adicional: Objeto que contiene atributos para describir la información. Los atributos que contiene son: @_Name: Nombre o identificador de la información a agregar; @_Data: Dato adicional de la información; @_Value: Valor que corresponde al Name/Nombre de la información a agregar. Estructura del elemento: { "@_Name": "", "@_Data": "", "@_Value": "" }. Ejemplo: Se tiene que el valor del dato Codigo Actividad es 000001. Por lo que la información a agregar sería: { "@_Name": "CodigoActividad", "@_Data": null, "@_Value": "000001" }

3.3 Tamaños de los campos

Tabla 4 — Formato de tamaños

Formato	Descripción
`x`	Tamaño exacto del campo. Ejemplo: 5
`x-y`	Tamaño mínimo de "x", máximo de "y". Ejemplo: 0-10 (en este caso es posible expresar ningún valor, porque se permite el tamaño "0")
`xpn`	Tamaño de "x" enteros, y con "n" casillas decimales. Ejemplo: si el tamaño es 5p3, es válido 54321.103
`xpn-m`	Tamaño de "x" enteros, y con un mínimo de "n" casillas decimales y un máximo de "m" casillas decimales. Ejemplo: 11p0-6
`x-ypn-m`	Tamaño mínimo de "x" enteros, máximo de "y" enteros; y con un mínimo de "n" casillas decimales y un máximo de "m" casillas decimales. Ejemplo: 1-11p0-6 (es obligatorio expresar algún valor en la parte entera, porque no se permite el tamaño "0", pero la parte decimal es opcional)

4Formato del NUC

4.1 Información que debe contener el NUC

Tabla 5 — Conjuntos de campos del NUC

Conjunto	Descripción
`R`	Campos que contienen información para la generación de la factura electrónica
`A`	Campos que contienen información general de la Factura Electrónica
`B`	Campos que contienen la información del emisor de la transacción documentada
`C`	Campos que contienen la información del receptor de la transacción documentada
`E`	Campos que describen cada ítem de la transacción documentada
`F`	Campos que describen los subtotales y totales de la transacción documentada
`G`	Campos que describen las formas de pago
`H`	Campos que describen información adicional sobre la transacción documentada
`HA`	Información Adenda Comercial

⚠️

La API es case-sensitive. Los nombres de los campos y datos que hagan referencia a información deben ingresarse respetando mayúsculas y minúsculas exactamente como se especifican.

3.4.1Schema NUCConjunto R

Campos que contienen información para la generación de la factura electrónica.

C	ID	Campo	Descripción	P	T	Tam	Ocu	Observaciones
`R`	`R01`	`Root`	NUC (raíz)	`Raíz`	JSON		1-1
`R`	`R02`	`Version`	Versión del formato de la factura electrónica	`R01`	A		1-1	Control de versiones. Valor a ingresar: 4.4
`R`	`R03`	`CountryCode`	Código del país donde pertenece la factura electrónica a generar	`R01`	A	`2`	1-1	Único valor permitido CR: Costa Rica

3.4.2Campos que contienen información general de la Factura ElectrónicaConjunto A

C	ID	Campo	Descripción	P	T	Tam	Ocu	Observaciones
`A`	`A01`	`Header`	Información general de la factura electrónica	`R01`	O		1-1
`A`	`A02`	`DocType`	Tipo de documento a generar	`A01`	A	`2`	1-1	01: Factura electrónica (FE); 02: Nota de Débito electrónica (ND); 03: Nota de Crédito electrónica (NC); 04: Tiquete electrónico (TE); 08: Factura electrónica de compras (FEC); 09: Factura electrónica de exportación (FEE); 10: Recibo Electrónico de Pago (REP). Si no se ingresa uno de estos valores, no se podrá generar la Factura Electrónica. Valores permitidos `01` · Factura electrónica (FE) `02` · Nota de Débito electrónica (ND) `03` · Nota de Crédito electrónica (NC) `04` · Tiquete electrónico (TE) `08` · Factura electrónica de compras (FEC) `09` · Factura electrónica de exportación (FEE) `10` · Recibo Electrónico de Pago (REP)
`A`	`A03`	`IssuedDateTime`	Fecha y hora de emisión	`A01`	F	`25`	1-1
`A`	`A04`	`ExchangeRate`	Tipo de cambio de la moneda de la operación	`A01`	N	`1-13p0-5`	0-1	En caso de utilizar el código de moneda correspondiente a colones (CRC) en este campo será "1". Se puede agregar el tipo de cambio en caso de querer indicar montos del documento en una moneda extranjera.
`A`	`A05`	`Currency`	Moneda de la operación	`A01`	A	`3`	0-1	Obligatorio si se agrega el Tipo de Cambio (A04) para indicar el tipo de moneda extranjero. De acuerdo con los códigos según los Códigos de Moneda. Ver catálogo oficial ↗
`A`	`A06`	`AdditionalIssueDocInfo`	Grupo que contiene información general adicional de la factura electrónica	`A01`	O		1-1
`A`	`A061`	`Info`	Elemento que describe la información adicional	`A06`	L		1	Lista de objetos tipo Info
`A`	`A0611`		Item de info	`A061`	I		1-25	Ver en sección Grupo AdditionaIssueDocInfo. Agregar el nombre de la información en "Name" y el valor de este en "Value". Por ejemplo: { "@_Name": "CodigoActividad", "@_Data": null, "@_Value": "000001" }

3.4.2.1Grupo AdditionalIssueDocInfo

ID	Campo	Descripción	T	Tam	Ocu	Observaciones
`AI01`	`CodigoActividad`	Código de la actividad económica del emisor	N	`6`	0-1	Código de actividad según Actividades Económicas de Costa Rica. Obligatorio para FE, FEE, TE, NC y ND. Opcional para FEC. No permitido para REP. Ver catálogo oficial ↗
`AI02`	`CondicionVenta`	Condición de la venta	A	`2`	1-1	Ingresar según la codificación. El código 12 únicamente será permitido en el comprobante FE. Valores permitidos `01` · Contado `02` · Crédito `03` · Consignación `04` · Apartado `05` · Arrendamiento en función de compra Ver los 16 valores →
`AI03`	`PlazoCredito`	Plazo del crédito	N	`5`	0-1	Este campo será de condición obligatoria, cuando la venta del producto o prestación de servicio sea 02 o 10 (AI02) y debe expresarse en días. No permitido en REP.
`AI04`	`CodigoPais`	Código de país para la creación de la clave.	N	`3`	1-1	Costa Rica: 506
`AI05`	`Consecutivo`	Numeración del comprobante electrónico	N	`10`	1-1	Ejemplo: 0000000001
`AI06`	`SituacionComprobante`	Situación del comprobante electrónico	N	`1`	1-1	Ingresar según la codificación. 1: Normal. Corresponde a aquellos comprobantes electrónicos que son generados y transmitidos en el mismo acto de compraventa y prestación del servicio al sistema de validación de comprobantes electrónicos de la Dirección General de Tributación, conforme con lo establecido en la presente resolución. 2: Contingencia. Corresponde a aquellos comprobantes electrónicos que sustituyen al comprobante físico emitido por contingencia, conforme lo establecido en el artículo 15 de la presente resolución. 3: Sin internet. Corresponde a aquellos comprobantes que han sido generados y expresados en formato electrónico conforme lo establecido en la presente resolución, pero que no se cuenta con el respectivo acceso a internet. Valores permitidos `1` · Normal (Corresponde a aquellos comprobantes electrónicos que son generados y transmitidos en el mismo acto de compraventa y prestación del servicio al sistema de validación de comprobantes electrónicos de la Dirección General de Tributación, conforme con lo establecido en la presente resolución.) `2` · Contingencia (Corresponde a aquellos comprobantes electrónicos que sustituyen al comprobante físico emitido por contingencia, conforme lo establecido en el artículo 15 de la presente resolución.) `3` · Sin internet (Corresponde a aquellos comprobantes que han sido generados y expresados en formato electrónico conforme lo establecido en la presente resolución, pero que no se cuenta con el respectivo acceso a internet.)
`AI07`	`CodigoSeguridad`	Código de seguridad, el cual debe ser generado por el sistema del obligado tributario.	N	`8`	1-1	Ejemplo: 99999999
`AI08`	`CondicionVentaOtros`	Detalle condición de la venta Otro	A	`5-100`	0-1	Será obligatorio en caso de utilizar el código 99 en el campo CondicionVenta (AI02). Se debe describir puntualmente la condición de la venta utilizada. No permitido usar en REP.

3.4.3Campos que contienen la información del emisor de la transacción documentadaConjunto B

C	ID	Campo	Descripción	P	T	Tam	Ocu	Observaciones
`B`	`B01`	`Seller`	Información del emisor del documento electrónico	`R01`	O		1-1	Nodo obligatorio para todos los documentos
`B`	`B02`	`TaxID`	Identificador tributario del emisor	`B01`	A	`9-20`	1-1	▪ Este campo será de condición obligatoria, cuando se posea información en el nodo "Tipo de identificación del emisor". ▪ Formato: La "Cédula física" debe de contener 9 dígitos, sin cero al inicio y sin guiones. La "Cédula de personas Jurídicas" debe contener 10 caracteres y sin guiones. El "Documento de Identificación Migratorio para Extranjeros (DIMEX)" debe contener 11 o 12 dígitos, sin ceros al inicio y sin guiones. El "Documento de Identificación de la DGT (NITE)" debe contener 10 dígitos y sin guiones. El número de identificación del "Extranjero no domiciliado", puede contener hasta un máximo de 20 caracteres (números y letras) en el campo denominado número, de lo contrario se mantienen las longitudes ya establecidas para los números de cédulas. El número de identificación del "No Contribuyente", puede contener hasta un máximo de 20 caracteres (números y letras) en el campo denominado número, de lo contrario se mantienen las longitudes ya establecidas para los números de cédulas. ▪ Validación: Se verificará que el comprobante cumpla con el formato establecido según el tipo de identificación, caso contrario se rechazará el comprobante. ▪ El contribuyente debe estar inscrito ante la Administración Tributaria en todos los casos, excepto el número de identificación del "Extranjero No Domiciliado" y "No Contribuyente" en la FEC.
`B`	`B03`	`TaxIDType`	Tipo de identificación del emisor	`B01`	A	`2`	1-1	Tipo de identificación del emisor, valores aceptados: 01 a 06. El tipo 05 es de uso exclusivo para el tipo de comprobante FEC, por lo que no debe habilitarse en ningún otro tipo de comprobante electrónico. Además, se debe verificar que este tipo de identificación se complemente con el código de documento de referencia 16 "Comprobante de proveedor no domiciliado" en el apartado en el campo TipoDocIR "Tipo de documento referenciado". Valores permitidos `01` · Cédula física `02` · Cédula jurídica `03` · DIMEX `04` · NITE `05` · Extranjero no domiciliado `06` · No contribuyente (Aplica para el tipo de identificación del emisor (B03).)
`B`	`B04`	`Name`	Nombre o razón social del emisor	`B01`	A	`1-100`	1-1
`B`	`B05`	`Contact`	Información de contacto del emisor	`B01`	O		1-1
`B`	`B051`	`PhoneList`	Lista de números telefónicos	`B05`	O		1-1
`B`	`B0511`	`Phone`	Número telefónico	`B051`	L	`1-1`	1-1	Lista de strings. Permite un único elemento dentro del arreglo. Deberá contener mínimo 8 dígitos y un máximo de 20, excepto en aquellos casos que se posea un número telefónico especial, por ejemplo, el 911.
`B`	`B052`	`EmailList`	Lista de correos electrónicos	`B05`	O		0-1	Obligatorio para todos los documentos a excepción de FEC.
`B`	`B0521`	`Email`	Correo electrónico	`B052`	L	`1-1`	1-1	Lista de strings. Se pueden incluir hasta 4 direcciones de correo y debe ser un correo con formato válido. Se permite una cadena por correo de hasta 160 caracteres.
`B`	`B06`	`AdditionlInfo`	Elemento que contiene información tributaria adicional del emisor	`B01`	O	`25`	1-1
`B`	`B061`	`Info`	Elemento que describe la información adicional	`B06`	L		1-25	Ver en sección Emisor AdditionalInfo
`B`	`B07`	`AddressInfo`	Información de la dirección del establecimiento del emisor	`B01`	O		1-1
`B`	`B071`	`Address`	Dirección de la ubicación	`B07`	A	`1-100`	1-1	Otras señas de la dirección. Debe de indicarse lo más exacta posible.
`B`	`B08`	`BranchInfo`	Información sobre el establecimiento del emisor	`B01`	O		1-1
`B`	`B081`	`Code`	Nombre de la sucursal que emite el documento	`B08`	A	`3`	1-1	Sucursal
`B`	`B082`	`Name`	Nombre comercial	`B08`	A	`1-80`	0-1	En el caso que se cuente con nombre comercial debe indicarse.
`B`	`B083`	`AdditionalBranchInfo`	Elemento que contiene información tributaria adicional del emisor	`B08`	O	`25`	1-1
`B`	`B0831`	`Info`	Elemento que describe la información adicional	`B083`	L		1-25	Ver en sección AdditionalBranchInfo

3.4.3.1Grupo Emisor AdditionalInfo

ID	Campo	Descripción	T	Tam	Ocu	Observaciones
`BI01`	`Provincia`	Provincia de la ubicación del emisor	A	`1`	1-1	Código según el catálogo de Codificación Territorial de Costa Rica Ver catálogo oficial ↗
`BI02`	`Canton`	Cantón de la ubicación del emisor	A	`2`	1-1	Código según el catálogo de Codificación Territorial de Costa Rica Ver catálogo oficial ↗
`BI03`	`Distrito`	Distrito de la ubicación del emisor	A	`2`	1-1	Código según el catálogo de Codificación Territorial de Costa Rica Ver catálogo oficial ↗
`BI04`	`Barrio`	Barrio de la ubicación del emisor	A	`2`	0-1	Código según el catálogo de Codificación Territorial de Costa Rica Ver catálogo oficial ↗
`BI05`	`CodigoPais`	Código del país del número de teléfono	A	`3`	0-1	En el caso que se cuente con un número de teléfono (B0511) debe indicarse
`BI06`	`RegistroFiscal8707`	Número de registro fiscal de bebidas alcohólicas Ley 8707	A	`1-12`	0-1	Campo condicional. Se convierte en carácter obligatorio cuando se estén facturando códigos CAByS de bebidas alcohólicas según la Ley 8707. Contiene los datos del número de registro de bebidas alcohólicas, suministrado por la Dirección General de Aduanas. No permitido para REP.
`BI07`	`OtrasSenasExtranjero`	Otras señas extranjero	A	`1-300`	0-1	Debe de indicarse lo más exacta posible. Es de uso exclusivo para cuanto se selecciona el código "05" en el campo denominado "Tipo de identificación del emisor." (B03) por lo cual no puede ser utilizado ningún otro tipo de identificación. Únicamente permitido para FEC.

3.4.3.2Grupo Emisor AdditionalBranchInfo

C	ID	Campo	Descripción	P	T	Tam	Ocu	Observaciones
	`BI20`	`Caja`	Caja donde se registra la factura		A	`3`	1-1	Ejemplo: { "@_Name": "Caja", "@_Data": null, "@_Value": "001" }

3.4.4Campos que contienen la información del receptor de la transacción documentadaConjunto C

C	ID	Campo	Descripción	P	T	Tam	Ocu	Observaciones
`C`	`C01`	`Buyer`	Información del receptor/comprador de la factura electrónica	`R01`	O		0-1	Obligatorio para FE, FEC y REP. Condicional para FEE, TE, NC y ND.
`C`	`C02`	`TaxID`	Identificador tributario del receptor	`C01`	A	`9-20`	1-1	▪ Este campo será de condición obligatoria, cuando se posea información sobre Número de cédula física / jurídica / NITE / DIMEX / extranjero no domiciliado del receptor. ▪ Formato: La "Cédula física" debe de contener 9 dígitos, sin cero al inicio y sin guiones. La "cédula de personas Jurídicas" debe contener 10 caracteres y sin guiones. El "Documento de Identificación Migratorio para Extranjeros (DIMEX)" debe contener 11 o 12 dígitos, sin ceros al inicio y sin guiones. El "Documento de Identificación de la DGT (NITE)" debe contener 10 dígitos y sin guiones. El número de identificación del "Extranjero No Domiciliado", puede contener hasta un máximo de 20 caracteres (números y letras) en el campo denominado número, de lo contrario se mantienen las longitudes ya establecidas para los números de cédulas. ▪ Validación: Se verificará que el comprobante cumpla con el formato establecido según el tipo de identificación. En FEC, el receptor debe estar inscrito ante la Administración Tributaria. En el caso de FE, FEE y TE, de los datos registrados en este campo, se verificará que el número de identificación sea un dato real en los padrones y registros correspondientes, excepto el "Extranjero No Domiciliado" el cual no requiere estar inscrito o empadronado. En el caso de FE, el número de identificación del "Extranjero No Domiciliado" únicamente se permitirá en los Datos del Receptor, cuando en el campo "Condición de la Venta" se haya indicado el código 12 "Venta Mercancía No Nacionalizada". En REP, NC y ND, los datos registrados deben coincidir con el comprobante original. De no cumplirse los puntos anteriores se rechazará el comprobante.
`C`	`C03`	`TaxIDType`	Tipo de identificación del receptor	`C01`	N	`2`	1-1	Tipo de identificación del emisor, valores aceptados: 01 a 05. El uso del código 05 para el Extranjero no domiciliado, se permitirá en FEE, NC y ND. En FE, se permitirá únicamente el código 05 cuando la condición de la venta sea código 12 "Venta de Mercancía No Nacionalizada" (AI02). En estos casos se deberá indicar en el apartado, "Información de Referencia" los datos del documento de respaldo de no indicarse se rechazará el comprobante electrónico. En FEC y REP se rechazará el uso del código 05. Valores permitidos `01` · Cédula física `02` · Cédula jurídica `03` · DIMEX `04` · NITE `05` · Extranjero no domiciliado `06` · No contribuyente (Aplica para el tipo de identificación del emisor (B03).)
`C`	`C04`	`TaxIDAdditionalInfo`	Información de identificación extranjero	`C01`	O		0-1
`A`	`C041`	`Info`	Elemento que describe la información adicional	`C04`	L		1-25	Ver en sección Grupo Receptor TaxIDAdditionalInfo
`C`	`C05`	`Name`	Nombre o razón social del receptor del documento.	`C01`	A	`1-100`	1-1
`C`	`C06`	`Contact`	Información de contacto del receptor	`C01`	O		0-1
`C`	`C061`	`PhoneList`	Lista de números telefónicos	`C06`	O		0-1
`C`	`C0611`	`Phone`	Número telefónico	`C061`	L	`1-1`	1-1	Lista de strings. Permite un único elemento dentro del arreglo. Deberá contener mínimo 8 dígitos y un máximo de 20, excepto en aquellos casos que se posea un número telefónico especial, por ejemplo, el 911.
`C`	`C062`	`EmailList`	Lista de correos electrónicos	`C06`	O		0-1
`C`	`C0621`	`Email`	Correo electrónico	`C062`	L	`1-1`	1-1	Lista de strings. Se pueden incluir hasta 1 dirección de correo y debe ser un correo con formato válido. Se permite una cadena por correo de hasta 160 caracteres.
`C`	`C07`	`AdditionlInfo`	Información adicional del receptor	`C01`	O		1-1
`C`	`C071`	`Info`	Elemento que describe la información adicional del receptor	`C07`	L		1-25	Ver en sección Receptor AdditionlInfo
`C`	`C08`	`AddressInfo`	Información de la dirección del receptor	`C01`	O		0-1
`C`	`C081`	`Address`	Otras señas	`C08`	A	`160`	1-1	Dirección lo más exacta posible
`C`	`C09`	`BranchInfo`	Información sobre el establecimiento del emisor	`C01`	O		0-1	No permitido para REP
`C`	`C091`	`Name`	Nombre comercial	`C09`	A	`1-80`	0-1	En el caso que se cuente con nombre comercial debe indicarse.

3.4.4.1Grupo Receptor TaxIDAdditionalInfo

C	ID	Campo	Descripción	P	T	Tam	Ocu	Observaciones
	`CI01`	`CodigoActividad`	Codigo de la actividad económica del receptor		A	`6`	0-1	Se debe de indicar el código de la actividad económica inscrita del receptor a la cual corresponden los bienes o servicios que se le están facturando al receptor en caso de ser requerido para un crédito o un gasto deducible. Obligatorio para FEC. Condicional para FE, NC y ND. No permitido para FEE, TE y REP. Ver catálogo oficial ↗

3.4.4.2Grupo Receptor AdditionlInfo

ID	Campo	Descripción	T	Tam	Ocu	Observaciones
`CI02`	`Provincia`	Provincia de la ubicación del emisor	A	`1`	1-1	Código según el catálogo de Codificación Territorial de Costa Rica. No válido para FEE y REP. Ver catálogo oficial ↗
`CI03`	`Canton`	Cantón de la ubicación del emisor	A	`2`	1-1	Código según el catálogo de Codificación Territorial de Costa Rica. No válido para FEE y REP. Ver catálogo oficial ↗
`CI04`	`Distrito`	Distrito de la ubicación del emisor	A	`2`	1-1	Código según el catálogo de Codificación Territorial de Costa Rica. No válido para FEE y REP. Ver catálogo oficial ↗
`CI05`	`Barrio`	Barrio de la ubicación del emisor	A	`2`	0-1	Código según el catálogo de Codificación Territorial de Costa Rica. No válido para FEE y REP. Ver catálogo oficial ↗
`CI06`	`OtrasSenas`	Otras señas	A	`1-160`	0-1	No válido para FEE y REP.
`CI07`	`OtrasSenasExtranjero`	Otras señas extranjero	A	`5-300`	0-1	Campo para incluir la dirección en el extranjero, en caso de requerirlo. En FE se permitirá este campo para el tipo de identificación de Extranjero No Domiciliado cuando se utilice el código "05" (C03) en el campo denominado "Tipo de identificación del receptor."
`CI08`	`CodigoPais`	Código del país del número de teléfono	A	`3`	0-1	En el caso que se cuente con un número de teléfono (C0611) debe indicarse

3.4.5Campos que describen cada ítem de la transacción documentadaConjunto E

C	ID	Campo	Descripción	P	T	Tam	Ocu	Observaciones
`E`	`E01`	`Items`	Grupo de datos que especifica los ítems de la transacción.	`R01`	O		1-1	Es de carácter obligatorio en todos los comprobantes, excepto en FE, TE, NC y ND cuando se utilicen "Otros Cargos" y se seleccione el código 04, 08 y 10 en el campo Tipo de documento otros cargos en el campo TipoDocumentoOC "Tipo de documento otros cargos"
`E`	`E02`	`Item`	Grupo de datos que especifica cada detalle del ítem.	`E01`	L		1-100	En el caso de REP representa el pago de un comprobante a crédito para las condiciones ya establecidas para los códigos 08 y 10 en el campo Condición Venta
`E`	`E03`	`Codes`	Información relacionada a códigos del ítem.	`E02`	O		0-1
`E`	`E031`	`Code`	Elemento que describe la información adicional.	`E03`	L	`1`	1-5	Ver en sección Ítem Codes
`E`	`E04`	`Description`	Detalle de la mercancía transferida o servicio prestado	`E02`	A	`3-200`	1-1	Debe de detallarse el tipo de producto o servicio que se brinde. En el caso del REP se detalla el pago al comprobante original, indicando al menos el número de cuota.
`E`	`E05`	`Qty`	Cantidad del ítem	`E02`	N	`1-13p0-3`	1-1	Expresado en la unidad de medida del código Interno
`E`	`E06`	`UnitOfMeasure`	Indica la unidad de medida que está expresada en la cantidad.	`E02`	N	`2`	0-1	Debe corresponder al Catálogo de Unidades de Medida Ver catálogo oficial ↗
`E`	`E07`	`Price`	Dato correspondiente al precio unitario del ítem.	`E02`	N	`1-13p0-5`	1-1	Si el ítem no es valorable: informar campo en 0.00
`E`	`E08`	`Discounts`	Información relacionada a descuentos del ítem	`E02`	O		0-1	Tipo complejo descuento. Se puede incluir un máximo de 5 repeticiones de descuentos, cada descuento adicional se calcula sobre la base menos el descuento anterior.
`E`	`E081`	`Discount`	Elemento que describe un descuento	`E08`	L		1-5	Se pueden incluir 5 objetos dentro de la lista que describan descuentos en el ítem. El objeto lo componen los campos E0811 y E0812.
`E`	`E0811`	`Code`	Naturaleza del descuento	`E081`	A	`80`	1-1	Valores para ingresar según la codificación de naturaleza del descuento. Valores permitidos `01` · Descuento por Regalía `02` · Descuento por Regalía IVA Cobrado al Cliente `03` · Descuento por Bonificación `04` · Descuento por volumen `05` · Descuento por Temporada (estacional) `06` · Descuento promocional `07` · Descuento Comercial `08` · Descuento por frecuencia `09` · Descuento sostenido `99` · Otros descuentos
`E`	`E0812`	`Amount`	Monto de descuentos concedidos	`E081`	N	`1-13p0-5`	1-1	Se deberá de incluir un valor igual o menor al del Monto total.
`E`	`E0813`	`AdditionalInfo`	Espacio para información adicional del descuento	`E081`	O		0-1
`E`	`E08131`	`Info`	Elemento que describe la información adicional	`E0813`	L		1-2	Ver en sección Ítem Discounts AdditionalInfo
`E`	`E09`	`Taxes`	Información relacionada con los impuestos adicionales.	`E02`	O		0-1	En el REP se volverá obligatorio, cuando la condición de la venta sea códigos "08" y "10".
`E`	`E091`	`Tax`	Elemento que describe un impuesto	`E09`	L		1-1000	Lista de objetos que describen los impuestos de un item. El objeto lo componen los campos E0911, E0912, E0913, E0914 y E0915.
`E`	`E0911`	`Code`	Unidad de medida de la subcantidad / Código del impuesto	`E091`	A	`2`	1-1	Códigos de impuesto según la codificación. Al utilizar el código de Naturaleza del Descuento 01 correspondiente a "Regalías" o 03 de "Bonificaciones" y el código de impuesto 01, se debe utilizar para el cálculo del impuesto el campo denominado "Monto Total" y la tarifa. Al utilizar el código 07 se debe de utilizar para el cálculo del impuesto el campo denominado "base imponible" y la tarifa. Al utilizar el código 08, se debe utilizar para el cálculo de factor del IVA por el subtotal. Valores permitidos `01` · Impuesto al Valor Agregado `02` · Impuesto Selectivo de Consumo `03` · Impuesto Único a los Combustibles `04` · Impuesto Específico de Bebidas Alcohólicas `05` · Impuesto Específico sobre las bebidas envasadas sin contenido alcohólico y jabones de tocador `06` · Impuesto a los Productos de Tabaco `07` · IVA (Cálculo Especial) `08` · IVA Régimen de Bienes Usados (Factor) `12` · Impuesto Especial al Cemento `99` · Otros
`E`	`E0912`	`Description`	Código de tarifa del IVA	`E091`	A	`2`	0-1	Se convierte en obligatorio para los Códigos 01, 07 del campo Code (E0911). En el caso que se utilicen "Detalle de productos del surtido, paquetes o combos", no se deberá utilizar este campo, ya que el impuesto se calcula como la suma de los montos de impuestos individuales de las líneas de detalle de los componentes del surtido que se deben incluir en estos casos. La eventual validación de la consistencia de los impuestos calculados y aplicación de tarifas se hará sobre las líneas individuales de detalle. Valores permitidos `01` · Tarifa 0% (Artículo 32, num 1, RLIVA) `02` · Tarifa reducida 1% `03` · Tarifa reducida 2% `04` · Tarifa reducida 4% `05` · Transitorio 0% `06` · Transitorio 4% `07` · Tarifa transitoria 8% `08` · Tarifa general 13% `09` · Tarifa reducida 0.5% `10` · Tarifa Exenta `11` · Tarifa 0% sin derecho a crédito
`E`	`E0913`	`Rate`	Tarifa del impuesto o Factor para Calculo IVA	`E091`	N	`1-3p0-5, 1p0-5`	1-1	Tarifa: Este campo es de condición obligatoria, cuando el producto/servicio este gravado con algún impuesto según corresponda. Debe de expresarse el porcentaje como número entero (Ejemplo: la tarifa del 13% se debe de reflejar como 13, la tarifa del 1% como 1, o bien la tarifa del 0.5% como 0.5). En el caso que se utilice "Detalle de productos del surtido, paquetes o combos", no se deberá utilizar este campo, ya que el impuesto se calcula como la suma de los montos de impuestos individuales de las líneas de detalle de componentes del surtido que se deben incluir en estos casos. Para Cálculo del Impuesto al Cemento código 12, la tarifa será del 5%. FactorIVA: Este campo es de condición obligatoria, cuando el producto/servicio posea un factor para su cálculo. Cuando en el código de impuesto se defina IVA Bienes Usados se deberá utilizar este campo con el factor establecido por el Ministerio de Hacienda. Debe expresarse en formato decimal. En caso de utilizar el código 08 del campo Code (E0911), se verificará que este campo se encuentre en el comprobante, caso contario se rechazará.
`E`	`E0914`	`Amount`	Monto del impuesto	`E091`	N	`1-13p0-5`	1-1	Este campo será de condición obligatoria, cuando el producto/servicio este gravado con algún impuesto. El detalle sobre los cálculos se encuentra en la sección Detalle de cálculos para Monto del Impuesto.
`E`	`E0915`	`AdditionalInfo`	Espacio para Exoneración y Exportación	`E091`	O		0-1
`E`	`E09151`	`Info`	Elemento que describe la información adicional	`E0915`	L		1-7	Ver en sección Ítem Taxes AdditionalInfo EyE
`E`	`E10`	`Charges`	Detalle de productos del surtido	`E02`	O		0-1	Este nodo es de uso obligatorio cuando se facturan surtidos, combos o paquetes que contienen bienes sujetos a distintas tarifas del IVA. La conformación de surtidos, combos o paquetes que se facturan como tales y se detallan en este nodo se permite únicamente a fabricantes – industriales o importadores, en los demás casos, los elementos que conforman o están contenidos en los surtidos, combos o paquetes, deben especificarse en las líneas de detalle del comprobante. Estos surtidos, combos o paquetes deben tener asignado un código comercial específico (SKU, GTIN o equivalente) a efecto de permitir su identificación y trazabilidad. La facturación de surtidos, combos o paquetes que no cumplen con estas condiciones, los elementos que lo conforman se deben especificar en las líneas de detalle del comprobante, de manera que no procede la utilización del nodo.
`E`	`E101`	`Charge`	Línea de detalle de surtido	`E10`	L		1-1000	Lista de objetos que describen cada línea del detalle del surtido. El objeto lo componen los campos E1011, E1012, E1013, E1014, E1015, E1016, E1017 y E1018.
`E`	`E1011`	`Code`	CodigoCABYSSurtido	`E101`	A	`13`	1-1	Se Verificará que el código sea válido en el catálogo vigente publicado en el sitio web del BCCR, salvo en las NC y ND que tengan código de notas de crédito financieras (código 08 y 09 en Codigos de Referencia), en el apartado de información de referencia. Ver catálogo oficial ↗
`E`	`E1012`	`Description`	Detalle de la mercancía transferida o servicio prestado incluido en el surtido	`E101`	A	`3-200`	1-1	Debe de detallarse el tipo de producto o servicio que se brinde
`E`	`E1013`	`Qty`	Cantidad componente de surtido	`E101`	N	`1-16p0-3`	1-1	Se deberá incluir un valor mayor a "cero"
`E`	`E1014`	`Price`	Precio unitario componente de surtido	`E101`	N	`1-18p0-5`	1-1	Se deberá incluir un valor mayor a "cero"
`E`	`E1015`	`ChargableAmount`	Monto total componente surtido	`E101`	N	`1-18p0-5`	1-1	Se obtiene de la multiplicación del campo "Cantidad componente de surtido" por el campo "Precio unitario componente de surtido".
`E`	`E1016`	`Amount`	Subtotal componente del surtido	`E101`	N	`1-18p0-5`	1-1	Se obtiene de la resta del campo "Monto total componente surtido" menos la sumatorio de "Monto de descuentos concedidos al componente de surtido".
`E`	`E1017`	`AditionalData`	Grupo que contiene datos adicionales	`E101`	O		0-1	Contiene información sobre descuentos y los impuestos aplicados a un surtido
`E`	`E10171`	`Data`	Elemento que contiene datos adicionales descuentos e impuestos	`E1017`	L		1-1005	En el atributo Name puede venir el siguiente contenido. Descuento: Cuando se desea agregar información sobre descuentos aplicados al surtido. Máximo de 5 repeticiones. Impuesto: Cuando se desea agregar información sobre impuestos aplicados al surtido. Máximo de 1000 repeticiones.
`E`	`E101711`	`Info`	Elemento que contiene la información adicional	`E10171`	L		1-20	Ver en sección Información Grupo Item Charges Adicional Data
`E`	`E1018`	`AdditionalInfo`	Espacio para Exoneración y Exportación	`E101`	O		0-1
`E`	`E10181`	`Info`	Elemento que describe la información adicional	`E1018`	L		1-7	Ver en sección Ítem Charges AdditionalInfo
`E`	`E11`	`Totals`	Grupo de datos que contienen información relacionada a los precios totales del ítem	`E02`	O
`E`	`E111`	`TotalBDiscount`	Monto Total	`E11`	N	`1-13p0-5`	1-1	Se obtiene de la multiplicación de la cantidad por el precio unitario.
`E`	`E112`	`TotalWDiscount`	SubTotal	`E11`	N	`1-13p0-5`	1-1	Se obtiene de la resta del Monto Total menos la sumatoria de descuentos aplicado(s). En el caso de utilizar el "Detalle de productos del surtido, paquetes o combos", este campo se calcula con la sumatoria de los montos de subtotal individuales de las líneas de detalle del surtido que se deben incluir en estos casos.
`E`	`E113`	`SpecificTotals`	Impuesto Neto	`E11`	N	`1-13p0-5`	0-1	Este campo será condición obligatoria, cuando se incluye información de Exoneración en Taxes AdditionalInfo. Este monto se obtiene al restar el campo "Monto del Impuesto" menos "Monto del Impuesto Exonerado" o el campo "Impuestos Asumidos por el Emisor o cobrado a Nivel de Fábrica" cuando corresponda. En caso de no contar con datos en los campos "Monto del Impuesto Exonerado" o "Impuestos Asumidos por el Emisor o cobrado a Nivel de Fábrica" el monto será el mismo al del impuesto calculado.
`E`	`E114`	`TotalItem`	Monto total por la línea de detalle	`E11`	N	`1-13p0-5`	1-1	Es la sumatoria de los campos "Subtotal" e "Impuesto Neto"
`E`	`E12`	`AdditionalInfo`	Información adicional	`E02`	O		0-1
`E`	`E121`	`Info`	Elemento que describe la información adicional	`E12`	L		1-25	Ver en sección Ítem AdditionalInfo

3.4.5.1Grupo Ítem Codes

C	ID	Campo	Descripción	P	T	Tam	Ocu	Observaciones
	`EI01`	`Codigo`	Código CAByS del producto/servicio		A	`13`	1-1	Código debe corresponder a un producto según el catálogo de bienes y servicios para uso tributario y de cuentas nacionales de Costa Rica. Para las Notas de Crédito y Débito será obligatorio el código CAByS, cuando la misma se encuentre ligada a un Comprobante electrónico que contenga código CAByS. No será obligatorio en las Notas de Crédito o Débito cuando en el apartado de "Información de Referencia", el documento de referencia sea un comprobante emitido antes del 01 de diciembre del 2020 o se identifique como una Nota de Crédito Financiera o Nota de Debito Financiera, definidas en el campo "Códigos de Referencia a Utilizar". No permitido para REP. Ver catálogo oficial ↗
	`EI02`	`CodigoCom`	Código comercial: Tipo complejo para el código de un producto o servicio. Se puede incluir un máximo de 5 repeticiones de códigos de producto/servicio. Data: Tipo de código. Value: Código.		A	`Data: 2 Value: 20`	0-5	Tipos de códigos según la codificación. Ejemplo: { "@_Name": "CodigoCom", "@_Data": "01", "@_Value": "19202" }, { "@_Name": "CodigoCom", "@_Data": "02", "@_Value": "192033" }. Sera obligatorio para las líneas de detalle que utilicen uno de los códigos de producto/servicio de "surtidos" que estén habilitados en el CAByS, entendidos como la combinación de mas de dos productos con diferentes códigos de producto/servicio. En el caso de la inclusión de paquetes, surtidos o combos, entendidos como la combinación de más de dos productos con diferentes códigos de producto/servicio, se debe seleccionar el código 03 "Código del producto asignado por el fabricante – industriales o importadores" e incluir en el campo del codigo el respectivo código "SKU", GTIN o equivalentes, con el que el paquete este identificado por el fabricante – industria o importador. Estos códigos deben ser verificables en los catálogos disponibles por el fabricante – industria o importador. Valores permitidos `01` · Código del producto del vendedor `02` · Código del producto del comprador `03` · Código del producto asignado por el fabricante – industrias o importadores `04` · Código uso interno `99` · Otros

3.4.5.2Grupo Ítem Discounts AdditionalInfo

C	ID	Campo	Descripción	P	T	Tam	Ocu	Observaciones
	`EID01`	`CodigoDescuentoOTRO`	Codigo del descuento OTRO		A	`5-100`	0-1	Será obligatorio en caso de utilizar el código 99 de "Otros" del campo E0811. Se debe describir puntualmente el descuento utilizado
	`EID02`	`NaturalezaDescuento`	Naturaleza del descuento		A	`3-80`	0-1	Será obligatorio en caso de utilizar el código 99 de "Otros" del campo E0811.

3.4.5.4Grupo Ítem Taxes AdditionalInfo EyE

Sección 3.4.5.3 Detalle de cálculos para Monto del Impuesto: Cálculo del IVA — Se obtiene de la multiplicación del campo "tarifa del impuesto" por "Base Imponible". Casos especiales: cuando se utilice el código 10 de tarifa exenta, se deberá de indicar "0" en este campo; al utilizar el código de Naturaleza del Descuento 01 "Regalías" o 03 "Bonificaciones" y el código de impuesto 01, se debe utilizar para el cálculo el campo "Monto Total" y la "Tarifa"; en caso de utilizar el factor establecido para el régimen de bienes usados, se obtiene de la multiplicación del factor por el subtotal; en caso de utilizar el campo "Base Imponible", se obtiene de la multiplicación "Base Imponible" por la tarifa; en surtidos se calcula como la sumatoria de los montos de IVA de las líneas de detalle del surtido. Impuesto Selectivo de Consumo — tarifa del impuesto por subtotal. Impuesto específico a las Bebidas Alcohólicas — Cantidad por Proporción por Impuesto por Unidad. Impuesto Específico sobre las bebidas envasadas sin contenido alcohólico y jabones de tocador — para bebidas: Cantidad por Cantidad de la unidad de medida a utilizar por (Impuesto por Unidad entre Volumen por Unidad de Consumo); para jabón de tocador: Cantidad por Volumen por Unidad de Consumo por Impuesto por Unidad. Impuesto a los productos de Tabaco — Cantidad por Cantidad de la unidad de medida a utilizar por Impuesto por Unidad. Impuesto al Cemento — tarifa del impuesto por subtotal.

ID	Campo	Descripción	T	Tam	Ocu	Observaciones
`EIT01`	`CodigoImpuestoOTRO`	Codigo de impuesto OTRO	A	`5-100`	0-1	Será obligatorio en caso de utilizar el código 99 de "Otros". Se debe describir puntualmente el impuesto utilizado.
`EIT02`	`CantidadUnidadMedida`	Cantidad de la unidad de medida a utilizar	N	`1-7p0-2`	0-1	Datos impuesto específico. Este campo es de condición obligatoria, cuando se utilicen los códigos de impuesto 03, 04, 05, 06. En el caso que se utilice "Detalle de productos del surtido, paquetes o combos", no se deberá utilizar este campo, para los códigos de impuesto 04, 05, 06 de la nota 8, ya que el impuesto se calcula como la suma de los montos de impuestos individuales de las líneas de detalle de componentes del surtido que se deben incluir en estos casos. La eventual validación de la consistencia de los impuestos calculados y aplicación de tarifas se hará sobre las líneas individuales de detalle.
`EIT03`	`Porcentaje`	Porcentaje	N	`1-4p0-2`	0-1	Datos impuesto específico. Este campo es de condición obligatoria, cuando se utilicen el código de impuesto 04. En el caso que se utilice "Detalle de productos del surtido, paquetes o combos", no se deberá utilizar este campo, para el código de impuesto 04, ya que el impuesto se calcula como la suma de los montos de impuestos individuales de las líneas de detalle de componentes del surtido que se deben incluir en estos casos. La eventual validación de la consistencia de los impuestos calculados y aplicación de tarifas se hará sobre las líneas individuales de detalle.
`EIT04`	`Proporción`	Proporción	A	`1-5p0-2`	0-1	Datos impuesto específico. Este campo es de condición obligatoria, cuando se utilicen el código de impuesto 04. En el caso que se utilice "Detalle de productos del surtido, paquetes o combos", no se deberá utilizar este campo, para el código de impuesto 04, ya que el impuesto se calcula como la suma de los montos de impuestos individuales de las líneas de detalle de componentes del surtido que se deben incluir en estos casos. La eventual validación de la consistencia de los impuestos calculados y aplicación de tarifas se hará sobre las líneas individuales de detalle.
`EIT05`	`VolumenUnidadConsumo`	Volumen por unidad de consumo	N	`1-7p0-2`	0-1	Datos impuesto específico. Este campo es de condición obligatoria, cuando se utilicen el código de impuesto 05. En el caso que se utilice "Detalle de productos del surtido, paquetes o combos", no se deberá utilizar este campo, para el código de impuesto 05, ya que el impuesto se calcula como la suma de los montos de impuestos individuales de las líneas de detalle de componentes del surtido que se deben incluir en estos casos. La eventual validación de la consistencia de los impuestos calculados y aplicación de tarifas se hará sobre las líneas individuales de detalle.
`EIT06`	`ImpuestoUnidad`	Impuesto por unidad	N	`1-18p0-5`	0-1	Datos impuesto específico. Este campo es de condición obligatoria, cuando se utilicen los códigos de impuesto 03, 04, 05, 06. En el caso que se utilice "Detalle de productos del surtido, paquetes o combos", no se deberá utilizar este campo, para los códigos de impuesto 04, 05, 06 de la nota 8, ya que el impuesto se calcula como la suma de los montos de impuestos individuales de las líneas de detalle de componentes del surtido que se deben incluir en estos casos. La eventual validación de la consistencia de los impuestos calculados y aplicación de tarifas se hará sobre las líneas individuales de detalle.
`EIT07`	`MontoExportacion`	Monto de impuesto de exportación	N	`1-18p0-5`	0-1	Datos de exportación. Uso exclusivo para exportación de mercancías que apliquen impuestos especiales. También podrá ser utilizado en las notas de crédito y débito según corresponda.
`EIT08`	`TipoDocumento`	Tipo de documento de exoneración o de autorización	A	`2`	0-1	Datos de exoneración. Códigos según la codificación de tipo de documento de exoneración o de autorización. Valores permitidos `01` · Compras autorizadas por la Dirección General de Tributación `02` · Ventas exentas a diplomáticos `03` · Autorizado por Ley especial `04` · Exenciones Dirección General de Hacienda Autorización Local Genérica `05` · Exenciones Dirección General de Hacienda Transitorio V (servicios de ingeniería, arquitectura, topografía obra civil) `06` · Servicios turísticos inscritos ante el Instituto Costarricense de Turismo (ICT) `07` · Transitorio XVII (Recolección, Clasificación, almacenamiento de Reciclaje y reutilizable) `08` · Exoneración a Zona Franca `09` · Exoneración de servicios complementarios para la exportación articulo 11 RLIVA `10` · Órgano de las corporaciones municipales `11` · Exenciones Dirección General de Hacienda Autorización de Impuesto Local Concreta `99` · Otros
`EIT09`	`TipoDocumentoOTRO`	Tipo de documento de exoneración o de autorización OTRO	A	`5-100`	0-1	Datos de exoneración. Será obligatorio en caso de utilizar el código 99 de "Otros" en el campo TipoDocumento. Se debe describir puntualmente el tipo de documento o autorización utilizado
`EIT10`	`NumeroDocumento`	Número de documento de exoneración o de autorización	A	`3-40`	0-1	Datos de exoneración. Este campo será de condición obligatoria, cuando se incluya información en el campo "Tipo de documento de exoneración o de autorización". Debe de indicarse tal y como se encuentra en el documento otorgado por la institución incluyendo los guiones. En caso de utilizar los códigos "02" o "03" y "08" en el tipo de documento debe de indicar el número de la ley que lo autoriza.
`EIT11`	`Articulo`	Número de artículo que establece la exoneración o autorización	N	`6`	0-1	Datos de exoneración. Este campo será de condición obligatoria, cuando se elija para "Tipo de documento de exoneración o de autorización" los códigos "02" o "03", "06", "07" y "08" y se debe de indicar el número del artículo de la ley.
`EIT12`	`Inciso`	Número de inciso que establece la exoneración o autorización	N	`6`	0-1	Datos de exoneración. Este campo será de condición obligatoria, cuando el artículo de la ley hace referencia a un inciso de esta, por lo cual se debe de indicar el número del inciso de la ley.
`EIT13`	`NombreInstitucion`	Nombre de institución o dependencia que emitió la exoneración	A	`2`	0-1	Datos de exoneración. Este campo será de condición obligatoria, cuando se incluya información en el campo "Tipo de documento de exoneración o de autorización". Códigos según la codificación de instituciones. Valores permitidos `01` · Ministerio de Hacienda `02` · Ministerio de Relaciones Exteriores y Culto `03` · Ministerio de Agricultura y Ganadería `04` · Ministerio de Economía, Industria y Comercio `05` · Cruz Roja Costarricense Ver los 13 valores →
`EIT14`	`NombreInstitucionOTROS`	Detalle Nombre de institución o dependencia que emitió la exoneración OTRO	A	`5-160`	0-1	Datos de exoneración. Será obligatorio en caso de utilizar el código 99 de "Otros" de la nota 23. Se deb
`EIT15`	`FechaEmision`	Fecha de emisión del documento de exoneración o de autorización	F	`25`	0-1	Datos de exoneración. Este campo será de condición obligatoria, cuando se incluya información en el campo "Tipo de documento de exoneración o de autorización". Tipo de dato de fecha y hora, basado en el estándar RFC3339 sección 5.6, tipo "date-time". Formato: YYYY-MM-DDThh:mi:ss[Z\|(+\|-)hh:mm] Ejemplo: 2016-09-26T13:00:00+06:00
`EIT16`	`TarifaExonerada`	Tarifa exonerada	N	`1-4p0-2`	0-1	Datos de exoneración. Este campo será de condición obligatoria, cuando se incluya información en el campo "Tipo de documento de exoneración o de autorización". Debe de indicarse los puntos de la tarifa otorgado de exoneración. Debe de expresarse el porcentaje como número entero (Ejemplo: la tarifa del 13% se debe de reflejar como 13, la tarifa del 1% como 1, o bien la tarifa del 0.5% como 0.5).
`EIT17`	`MontoExoneracion`	Monto del impuesto exonerado	N	`1-18p0-5`	0-1	Datos de exoneración. Este campo será de condición obligatoria, cuando se incluya información en el campo "Tipo de exoneración". Dicho monto se obtiene de la multiplicación del campo "Tarifa exonerada" por el campo "Subtotal" o base imponible en caso de contar con esta.

3.4.5.5Grupo Item Charges Aditional Data

ID	Campo	Descripción	T	Tam	Ocu	Observaciones
`EIC01`	`MontoDescuentoSurtido`	Monto de descuentos concedidos al componente de surtido	N	`1-18p0-5`	0-1	Descuento. Este campo será de condición obligatoria, cuando se indique un descuento, regalía o bonificación en el campo "Código del descuento de componente del surtido"
`EIC02`	`CodigoDescuentoSurtido`	Código del descuento del componente de surtido	A	`2`	0-1	Descuento. Códigos según la codificación de naturaleza del descuento. Este campo será de condición obligatoria, cuando se incluya información en el campo "Monto de descuentos concedidos al componente de surtido" Valores permitidos `01` · Descuento por Regalía `02` · Descuento por Regalía IVA Cobrado al Cliente `03` · Descuento por Bonificación `04` · Descuento por volumen `05` · Descuento por Temporada (estacional) `06` · Descuento promocional `07` · Descuento Comercial `08` · Descuento por frecuencia `09` · Descuento sostenido `99` · Otros descuentos
`EIC03`	`DescuentoSurtidoOtros`	Naturaleza del descuento de componente del surtido	A	`3-80`	0-1	Descuento. Este campo será de condición obligatoria, cuando se utilice el código 99 en "Código del descuento del componente de surtido"
`EIC04`	`CodigoImpuestoSurtido`	Código del impuesto para componente de surtido	A	`2`	0-1	Impuesto. Códigos según la codificación de impuestos. Al utilizar el código de Naturaleza del Descuento 01 correspondiente a "Regalías" o 03 de "Bonificaciones" y el código de impuesto 01, se debe utilizar para el cálculo del impuesto el campo denominado "Monto total componente de surtido" y la "Tarifa del Impuesto al Valor Agregado para componente de surtido" Valores permitidos `01` · Impuesto al Valor Agregado `02` · Impuesto Selectivo de Consumo `03` · Impuesto Único a los Combustibles `04` · Impuesto Específico de Bebidas Alcohólicas `05` · Impuesto Específico sobre las bebidas envasadas sin contenido alcohólico y jabones de tocador `06` · Impuesto a los Productos de Tabaco `07` · IVA (Cálculo Especial) `08` · IVA Régimen de Bienes Usados (Factor) `12` · Impuesto Especial al Cemento `99` · Otros
`EIC05`	`CodigoImpuestoOTROSurtido`	Código del impuesto OTRO para componente de surtido	a	`5-100`	0-1	Impuesto. Será obligatorio en caso de utilizar el código 99 de "Otros" en el campo CodigoImpuestoSurtido. Se debe describir puntualmente el impuesto utilizado.
`EIC06`	`CodigoTarifaIVASurtido`	Código de la tarifa del Impuesto al Valor Agregado para componente de surtido	A	`2`	0-1	Impuesto. Códigos según la codificación de tarifas del IVA. Se convierte en obligatorio cuando se usa el código 01 de impuestos de surtido Valores permitidos `01` · Tarifa 0% (Artículo 32, num 1, RLIVA) `02` · Tarifa reducida 1% `03` · Tarifa reducida 2% `04` · Tarifa reducida 4% `05` · Transitorio 0% `06` · Transitorio 4% `07` · Tarifa transitoria 8% `08` · Tarifa general 13% `09` · Tarifa reducida 0.5% `10` · Tarifa Exenta `11` · Tarifa 0% sin derecho a crédito
`EIC07`	`TarifaSurtido`	Tarifa del Impuesto para componente de surtido	N	`1-4p0-2`	0-1	Impuesto. Este campo es de condición obligatoria, cuando el componente este gravado con alguna tarifa de impuesto, según corresponda. Debe de expresarse el porcentaje como número entero (Ejemplo: la tarifa del 13% se debe de reflejar como 13, la tarifa del 1% como 1, o bien la tarifa del 0.5% como 0.5). Para Cálculo del IVA, Ver nota 8.1. Para Cálculo del Impuesto Selectivo de Consumo código 02 de la nota 8, la tarifa será editable, según la normativa correspondiente. Para Cálculo de "otros impuestos" código 99, la tarifa será editable, según la normativa correspondiente. Validación: Cuando se utilice el Código de impuesto 01 la tarifa del impuesto debe de coincidir con el correspondiente código de impuesto IVA. Si se utiliza código de impuesto 02 o 99 debe de incluirse el porcentaje como un número entero.
`EIC08`	`CantidadUnidadMedidaSurtido`	Cantidad de la unidad de medida a utilizar para componente de surtido	N	`1-7p0-2`	0-1	Impuesto. Este campo es de condición obligatoria, cuando se utilicen los códigos de impuesto 04, 05 y 06 del CodigoImpuestoSurtido
`EIC09`	`PorcentajeSurtido`	Porcentaje en componente de surtido	N	`1-4p0-2`	0-1	Impuesto. Este campo es de condición obligatoria, cuando se utilice el código de impuesto 04 del CodigoImpuestoSurtido. Debe de expresarse el porcentaje como número entero (Ejemplo: la tarifa del 13% se debe de reflejar como 13, la tarifa del 1% como 1, o bien la tarifa del 0.5% como 0.5).
`EIC10`	`ProporcionSurtido`	Proporción en componente de surtido	N	`1-5p0-2`	0-1	Impuesto. Este campo es de condición obligatoria, cuando se utilice el código de impuesto 04 del CodigoImpuestoSurtido. Este campo se obtiene de multiplicar la "Cantidad de la unidad de medida a utilizar" por el "Porcentaje"
`EIC11`	`VolumenUnidadConsumoSurtido`	Volumen por Unidad de Consumo componente de surtido	N	`1-7p0-2`	0-1	Impuesto. Este campo es de condición obligatoria, cuando se utilice el código de impuesto 05 del CodigoImpuestoSurtido
`EIC12`	`ImpuestoUnidadSurtido`	Impuesto por Unidad componente de surtido	N	`1-18p0-5`	0-1	Impuesto. Este campo es de condición obligatoria, cuando se utilicen los códigos de impuesto 04, 05 y 06 del CodigoImpuestoSurtido.
`EIC13`	`MontoImpuestoSurtido`	Monto del impuesto para componente de surtido	N	`1-18p0-5`	0-1	Impuesto. Este campo será de condición obligatoria, cuando el componente este gravado con algún impuesto. El monto para colocar se describe en Detalle de Cálculos para el Monto Impuesto Surtido

3.4.5.7Grupo Item Charges AditionalInfo

Sección 3.4.5.6 Detalle de Cálculos para el Monto Impuesto Surtido: Cálculo del IVA — Se obtiene de la multiplicación del campo "Tarifa del Impuesto al Valor Agregado para componente de surtido" por el campo "Base Imponible del surtido". Casos especiales: al utilizar el código de Naturaleza del Descuento 01 "Regalías" o 02 "Bonificaciones" y el código de impuesto 01, se debe utilizar el campo "Monto total componente surtido" y la "Tarifa del Impuesto al Valor Agregado para componente de surtido"; en caso de utilizar el campo "Base Imponible para componente de Surtido", se obtiene de la multiplicación de este por la "Tarifa del Impuesto al Valor Agregado para componente de surtido". Impuesto Selectivo de Consumo — "Tarifa del Impuesto para componente de surtido" por "Subtotal componente del surtido". Impuesto específico a las Bebidas Alcohólicas — "Cantidad componente de surtido" por "Proporción en componente de surtido" por "Impuesto por Unidad componente de surtido". Impuesto Específico sobre las bebidas envasadas sin contenido alcohólico y jabones de tocador — para bebidas: "Cantidad componente de surtido" por "Cantidad de la unidad de medida a utilizar para componente de surtido" por ("Impuesto por Unidad componente de surtido" entre "Volumen por Unidad de Consumo componente de surtido"); para jabón de tocador: "Cantidad componente de surtido" por "Volumen por Unidad de Consumo componente de surtido" por "Impuesto por Unidad componente de surtido". Impuesto a los productos de Tabaco — "Cantidad componente de surtido" por "Cantidad de la unidad de medida a utilizar para componente de surtido" por "Impuesto por Unidad componente de surtido".

ID	Campo	Descripción	T	Tam	Ocu	Observaciones
`EIC20`	`CodigoCom`	Código comercial: Tipo complejo para el código de un producto o servicio. Se puede incluir un máximo de 5 repeticiones de códigos de producto/servicio. Data: Tipo de código. Value: Código.	A	`Data: 2 Value: 20`	0-5	Tipos de códigos según la codificación. Ejemplo: { "@_Name": "CodigoCom", "@_Data": "01", "@_Value": "19202" }, { "@_Name": "CodigoCom", "@_Data": "02", "@_Value": "192033" } Valores permitidos `01` · Código del producto del vendedor `02` · Código del producto del comprador `03` · Código del producto asignado por el fabricante – industrias o importadores `04` · Código uso interno `99` · Otros
`EIC21`	`UnidadMedidaSurtido`	Unidad de Medida componente de surtido	A	`15`	0-1	Deberá ser una unidad de medida según El catálogo de unidades de medida Ver catálogo oficial ↗
`EIC22`	`UnidadMedidaComercialSurtido`	Unidad de Medida Comercial componente de surtido	A	`20`	0-1	Campo utilizado para indicar 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"
`EIC23`	`IVACobradoFabricaSurtido`	IVA cobrado a nivel de fábrica componente surtido	A	`2`	0-1	Valores para ingresar según la codificación. En este campo se indicará si el Impuesto al Valor Agregado fue cobrado a nivel de fábrica, por lo que deberá ser utilizado únicamente por los obligados tributarios a realizar el pago de esta forma. Se convierte en obligatorio cuando el IVA se cobra o se cobró a nivel de fábrica. Al hacer uso del presente campo el producto se entenderá exento para el código 02, por lo cual deberá llenar en el campo de impuestos para el cálculo del IVA, el código 10 de tarifa exenta. Para el código 01 el emisor puede separar los impuestos que está cobrando en la fábrica Valores permitidos `01` · Venta de bienes con IVA según el sistema especial de determinación de IVA a nivel de fábrica (Se utiliza cuando se está cobrando el IVA a nivel de fábrica.) `02` · Ventas exentas según el sistema especial de determinación de IVA a nivel de fábrica, mayorista y aduanas (Se utiliza cuando el producto se encuentra exento ya que el bien soporto el cobro de impuestos a nivel de fábrica.)
`EIC24`	`BaseImponibleSurtido`	Base imponible para componente de surtido	N	`1-18p0-5`	0-1	Este campo será de condición obligatoria, cuando el producto este gravado con algún impuesto. Se obtiene de la suma entre el campo "Subtotal componente del surtido", más el impuesto selectivo de consumo (02), el Impuesto específico de Bebidas Alcohólicas (04) y el Impuesto Específico sobre las bebidas envasadas sin contenido alcohólico y jabones de tocador (05), cuando corresponda. Este campo se podrá editar cuando se seleccione en el campo "IVA cobrado a nivel de fábrica" el Código 01 o en el campo de "Código del impuesto" el código 07.

3.4.5.8Grupo Ítem AdditionalInfo

ID	Campo	Descripción	T	Tam	Ocu	Observaciones
`EI10`	`PartidaArancelaria`	Partida arancelaria en la que se encuentra le producto	A	`12`	0-1	Se convierte en obligatorio cuando se elija el tipo de comprobante FEE para la venta de una mercancía y se seleccione un código CAByS que corresponda a un producto. Debe incluir al menos 12 digitos cuando se trate de una FEE, NC o ND que modifiquen una FEE y que el primer digito del código CAByS sea 0, 1, 2, 3 y 4 (bienes) Ver catálogo oficial ↗
`EI11`	`BaseImponible`	Base imponible especial	N	`1-13p0-5`	0-1	Este campo será de condición obligatoria, cuando el producto/servicio esté gravado con algún impuesto. Se obtiene de la suma entre el campo "Subtotal", más el impuesto selectivo de consumo (02), el Impuesto específico de Bebidas Alcohólicas (04), el Impuesto Específico sobre las bebidas envasadas sin contenido alcohólico y jabones de tocador (05) y el impuesto al cemento (12), cuando corresponda. Este campo se podrá editar cuando se seleccione en el campo "IVA cobrado a nivel de fábrica" (EI17) el Código 01 o en el campo de "Código del impuesto" el código 07.
`EI12`	`Tipo Transacción`	Tipo de transacciones	A	`2`	0-1	Se utilizará para identificar el tipo de transacción que se realizará. Códigos según la codificación de tipos de transacción. Valores permitidos `01` · Venta Normal de Bienes y Servicios (Transacción General) `02` · Mercancía de Autoconsumo exento `03` · Mercancía de Autoconsumo gravado `04` · Servicio de Autoconsumo exento `05` · Servicio de Autoconsumo gravado Ver los 13 valores →
`EI13`	`UnidadMedidaComercial`	Unidad de medida comercial	A	`20`	0-1	Utilizado para indicar 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"
`EI14`	`NumeroVINoSerie`	Numero de VIN o Serie del medio de transporte	A	`17`	0-1000	Se convierte en carácter obligatorio, cuando el código CAByS del producto que se esté comercializando pertenece a un medio de transporte con esta numeración. Se pueden utilizar la cantidad de repeticiones que se requieran
`EI15`	`RegistroMedicamento`	Registro de Medicamento	A	`100`	0-1	Se convierte en carácter obligatorio, cuando el código CAByS del producto que se esté comercializando pertenece a un medicamento que posea registro sanitario.
`EI16`	`FormaFarmaceutica`	Forma farmacéutica	A	`3`	0-1	Se convierte en carácter obligatorio cuando se utilice un código CAByS que corresponda a medicamento que posea registro sanitario. Debe corresponder al Catálogo de códigos de formas farmacéuticas. Ver catálogo oficial ↗
`EI17`	`IVACobradoFabrica`	IVA cobrado a nivel de fabrica	A	`2`	0-1	Valores para ingresar según la codificación. En este campo se indicará si el Impuesto al Valor Agregado fue cobrado a nivel de fábrica, por lo que deberá ser utilizado únicamente por los obligados tributarios a realizar el pago de esta forma. Se convierte en obligatorio cuando el IVA se cobra o se cobró a nivel de fábrica. Al hacer uso del presente campo el producto se entenderá exento para el código 02, por lo cual deberá llenar en la sección de impuestos para el cálculo del IVA, el código 10 de tarifa exenta. Para el código 01 el emisor puede separar los impuestos que está cobrando en la fábrica. Valores permitidos `01` · Venta de bienes con IVA según el sistema especial de determinación de IVA a nivel de fábrica (Se utiliza cuando se está cobrando el IVA a nivel de fábrica.) `02` · Ventas exentas según el sistema especial de determinación de IVA a nivel de fábrica, mayorista y aduanas (Se utiliza cuando el producto se encuentra exento ya que el bien soporto el cobro de impuestos a nivel de fábrica.)
`EI18`	`ImpuestoAsumidoEmisorFabrica`	Impuestos asumidos por el emisor o cobrado a nivel de fábrica	N	`1-18p0-5`	0-1	Este campo será de condición obligatoria cuando: Se facturen productos o servicios, en cuya línea de detalle se indique en el campo "Código del descuento" los códigos 01 de "Regalías" o código 03 de "Bonificaciones". Se incluyan en la línea de detalle impuestos específicos a los combustibles, Bebidas Alcohólicas, sin contenido alcohólico, jabón de tocador y cemento. Se obtiene de la sumatoria del Monto de los Impuestos calculados a productos definidos como regalías o bonificaciones con IVA cobrado a nivel de fábrica, y se incluyan impuestos específicos a los combustibles, Bebidas Alcohólicas, sin contenido alcohólico, jabón y cemento. En caso de no aplicarse estos impuestos, se deberá agregar el valor "0" y en caso de aplicarse una exoneración se calculará como la resta entre el Monto del Impuesto menos el Monto Exonerado.

3.4.6Campos que describen los subtotales y totales de la transacción documentadaConjunto F

C	ID	Campo	Descripción	P	T	Tam	Ocu	Observaciones
`F`	`F01`	`Totals`	Grupo de datos que contiene información sobre el total del documento electrónico.	`R01`	O		1-1	Sección obligatoria para todos los documentos
`F`	`F02`	`TotalTaxes`	Grupo de datos que contiene información del total de impuestos	`F01`	O		0-1
`F`	`F021`	`TotalTax`	Elemento que contiene información un impuesto	`F02`	L		1-1000	Lista de objetos que describen los impuestos resumidos. Se repetirán la cantidad de códigos de impuestos que se hayan incluido en las líneas de detalles. En el caso de las líneas que contengan "surtidos", se utilizará para este cálculo la información de los campos monto del nodo "Impuesto Surtido". Este campo es de condición obligatoria, cuando existen producto/servicio gravados con algún impuesto en las líneas de detalle. El mismo se obtiene de la suma de los campos denominados "Monto del impuesto" de las líneas que no poseen exoneración más todos los "Impuestos Netos" de las líneas que si poseen exoneración o se calculen en el campo "Impuestos Asumidos por el Emisor o cobrado a Nivel de Fábrica", entendiendo el impuesto neto como la resta entre el campo Monto del Impuesto menos las Exoneraciones o Impuestos Asumidos por el Emisor o cobrado a Nivel de Fábrica para cada código de impuesto
`F`	`F0211`	`Code`	Código de impuesto	`F021`	A	`13, 16`		Indicará los códigos de impuesto registrados en las líneas de detalle. Para indicar los montos de TotalImpuesto, TotalImpAsumEmisorFabrica y TotalIVADevuelto, NO deberá agregarse este campo.
`F`	`F0212`	`Description`	Código que identificará a qué tipo de totales se refiere	`F021`	A	`13, 16`	1-1	Si se desea registrar el monto para TotalImpuesto, TotalImpAsumEmisorFabrica y TotalIVADevuelto, deberá agregarse en la descripción el nombre como identificador de cada uno. Si se agregó el campo F0211, se debe agregar el código de la tarifa del IVA.
`F`	`F0213`	`Amount`		`F041`	N	`1-16p0-4`	1-1	Si se agregó el campo F0211, este campo corresponde a la sumatoria del monto por código de impuesto cobrado en el comprobante electrónico. Caso contrario, el valor de este campo será lo siguiente: TotalImpuesto: Este campo es de condición obligatoria, cuando existen producto/servicio gravados con algún impuesto en las líneas de detalle. El mismo se obtiene de la suma de todos los campos denominados "Monto del impuesto" de las líneas que no poseen exoneración más todos los campos "Impuesto Neto" de las líneas que si poseen exoneración o se hayan calculado "Impuestos Asumidos por el Emisor o cobrado a Nivel de Fábrica". TotalImpAsumEmisorFabrica: Este campo es de condición obligatoria, cuando existen producto/servicio gravados con algún impuesto en las líneas de detalle que sean asumidos por el emisor, el mismo se obtiene de la suma de todos los campos denominados "Impuestos Asumidos por el Emisor o cobrado a Nivel de Fábrica". TotalIVADevuelto: ▪ Este campo será de condición obligatoria cuando se facturen servicios de salud y cuyo método de pago sea "Tarjeta". ▪ Se obtiene de la sumatoria del Monto de los Impuestos pagado por los servicios de salud en tarjetas, según lo que establezca la norma, cuando se venda únicamente el servicio salud. Cuando se genere una venta de un servicio de salud con más de un medio de pago y/o se incluyan otros productos o servicios, además de los servicios de salud se debe aplicar la siguiente fórmula: Monto IVA Devuelto = (monto pagado tarjeta / venta neta) * Monto del impuesto Validación: Se verificará que el monto indicado corresponda a líneas de detalle con códigos CAByS de servicios médicos y el medio de pago sea tarjeta. Caso contrario se rechazará el comprobante.
`F`	`F03`	`TotalDiscounts`	Grupo de datos que contiene información sobre descuentos aplicados al documento	`F01`	O		0-1	Agregar si se han aplicado descuentos en ítems
`F`	`F031`	`TotalDiscount`	Elemento que contiene información un descuento	`F03`	L		1-1	Lista de objetos que describen los descuentos aplicados.
`F`	`F0311`	`Amount`	Total descuentos	`F031`	N	`1-18p0-5`	1-1	Se obtiene de la suma de todos los campos de "monto de descuentos concedidos".
`F`	`F04`	`GrandTotal`	Información sobre el precio total de la factura	`F01`	O		1-1
`F`	`F041`	`TotalBDiscounts`	Total venta	`F04`	N	`1-18p0-5`	1-1	Se obtiene de la sumatoria de los campos "total gravado", "total exento", "Total Exonerado" y "Total No Sujeto". En caso del "Recibo electrónico de Pago" se obtiene de la suma de los montos totales de las líneas de detalle
`F`	`F042`	`TotalWDiscounts`	Total venta neta	`F04`	N	`1-18p0-5`	1-1	Se obtiene de la resta de los campos "Total venta" menos "Total descuentos"
`F`	`F043`	`InvoiceTotal`	Total del comprobante	`F04`	N	`1-16p0-4`	1-1	En todos los comprobantes, se obtiene de la suma de los campos "total venta neta", "monto total del impuesto" y "total otros cargos" menos "total IVA devuelto" en caso de contar con dichos campos. En caso de Recibo Electrónico de Pago se obtiene de la suma de los campos "Total de la venta". Este monto deberá coincidir con la sumatoria de los montos de los totales por "Medio de Pago" cuando se utilicen dos o más.
`F`	`F05`	`AdditionalInfo`	Información adicional	`F01`	O		1-1
`F`	`F051`	`Info`	Elemento que describe la información adicional	`F05`	L		1-25	Ver en sección Total AdditionalInfo

3.4.6.1Grupo Total AdditionalInfo

ID	Campo	Descripción	T	Tam	Ocu	Observaciones
`FI01`	`TotalServGravados`	Total de servicios gravados con IVA	N	`1-18p0-5`	0-1	Se debe agregar cuando en los ítems existan servicios gravados con IVA. En el caso que exista una exoneración este campo se obtiene de la multiplicación (1-porcentaje de exoneración) por el monto de la venta. Porcentaje de exoneración: (Tarifa Exonerada /Tarifa IVA). En caso de que en el campo "Código de bien o servicio" se utilicen códigos que empiecen con: 5,6,7,8,9 del CAByS y que este gravado con IVA, deberá de cumplir con el cálculo de este campo. No permitido para REP.
`FI02`	`TotalServExentos`	Total de servicios exentos de IVA	N	`1-18p0-5`	0-1	Se debe agregar cuando se seleccionen códigos CAByS que correspondan a un servicio y el servicio este exento de IVA. En caso de que en el campo "Código de bien o servicio" se utilicen códigos que empiecen con: 5,6,7,8,9 del CAByS y que estén exentos de IVA, deberá de cumplir con el cálculo de este campo. No permitido para REP.
`FI03`	`TotalServExonerado`	Total de servicios exonerados del IVA	N	`1-18p0-5`	0-1	Este campo será de condición obligatoria, cuando el servicio esté gravado y se preste a un cliente que goce de exoneración, se debe de indicar el monto equivalente al porcentaje exonerado. Se obtiene de la multiplicación del porcentaje de la exoneración por el monto del servicio. En caso de que en el campo "Código de Bien o Servicio" se utilicen códigos que empiecen con: 5,6,7,8,9 del CAByS y que goce de exoneración del IVA, deberá de cumplir con el cálculo de este campo. No permitido para FEE y REP.
`FI04`	`TotalServNoSujeto`	Total servicios No Sujetos de IVA	N	`1-18p0-5`	0-1	Este campo será de condición obligatoria, cuando se seleccionen códigos CAByS que correspondan a un servicio y el servicio sea No Sujeto de IVA (que se utilicen los códigos de tarifa del IVA 01 y 11 de la nota 8.1). En caso de que en el campo "Código de bien o servicio" se utilicen códigos que empiecen con: 5,6,7,8,9 del CAByS y que este no sujeto de IVA, deberá de cumplir con el cálculo de este campo. No permitido para FEE y REP.
`FI05`	`TotalMercanciasGravadas`	Total de mercancías gravadas con IVA	N	`1-18p0-5`	0-1	Este campo será de condición obligatoria, cuando se seleccionen códigos CAByS que correspondan a una mercancía y la mercancía este gravada con IVA, con excepción de las mercancías que indiquen "IVA cobrado a nivel de fábrica". Este campo se obtiene de la sumatoria de los campos de Monto Total de cada línea de detalle que contenga IVA, menos las líneas de detalle que contengan el código de "IVA cobrado a nivel de Fábrica". En el caso que exista una exoneración este campo se obtiene de la multiplicación (1-porcentaje de exoneración) por el monto de la venta. Porcentaje de exoneración: (Tarifa Exonerada /Tarifa IVA). En el caso de que en el campo "Código de bien o servicio" se utilicen códigos que empiecen con: 0,1,2,3,4 del CAByS y que este gravado con IVA, deberá de cumplir con el cálculo de este campo. No permitido para REP.
`FI06`	`TotalMercanciasExentas`	Total de mercancías exentas de IVA	N	`1-18p0-5`	0-1	Este campo será de condición obligatoria, cuando se seleccionen códigos CAByS que correspondan a una mercancía y la mercancía este exenta de IVA. En caso de que en el campo "Código de bien o servicio" se utilicen códigos que empiecen con: 0,1,2,3,4 del CAByS y que este exento de IVA, deberá de cumplir con el cálculo de este campo. No permitido para REP
`FI07`	`TotalMercExonerada`	Total de mercancías exoneradas del IVA	N	`1-18p0-5`	0-1	Este campo será de condición obligatoria, cuando la mercancía o producto esté gravada y se venda a un cliente que goce de exoneración para la compra de esta. Se obtiene de la multiplicación del porcentaje de la exoneración por el monto del producto. En caso de que en el campo "Código de bien o servicio" se utilicen códigos que empiecen con: 0,1,2,3,4 del CAByS y que goce de exoneración del IVA, deberá de cumplir con el cálculo de este campo. No permitido para FEE y REP.
`FI08`	`TotalMerNoSujeta`	Total mercancías No Sujetas de IVA	N	`1-18p0-5`	0-1	Este campo será de condición obligatoria, cuando se seleccionen códigos CAByS que correspondan a una mercancía y la mercancía sea No Sujeta de IVA (que se utilicen los códigos de tarifa del IVA 01 y 11 de la nota). En caso de que en el campo "Código de bien o servicio" se utilicen códigos que empiecen con: 0,1,2,3,4 del CAByS y que este no sujeto de IVA, deberá de cumplir con el cálculo de este campo. No permitido para FEE y REP.
`FI09`	`TotalGravado`	Total gravado	N	`1-18p0-5`	0-1	Se obtiene de la suma de los campos "total servicios gravados con IVA" mas "total de mercancías gravadas con IVA". No permitido para REP.
`FI10`	`TotalExento`	Total exento	N	`1-18p0-5`	0-1	Se obtiene de la suma de los campos "total servicios exentos de IVA" mas "total de mercancías exentas de IVA". No permitido para REP.
`FI11`	`TotalExonerado`	Total exonerado	N	`1-18p0-5`	0-1	Se obtiene de la suma de los campos "total servicios exonerados de IVA" mas "total de mercancías exoneradas del IVA". No permitido para FEE y REP.
`FI12`	`TotalNoSujeto`	Total no sujeto	N	`1-18p0-5`	0-1	Se obtiene de la suma de los campos "Total servicios No Sujetos de IVA" mas "Total mercancías No Sujetas de IVA". No permitido para FEE y REP.
`FI13`	`TotalOtrosCargos`	Total Otros Cargos	N	`1-18p0-5`	0-1	Este campo será de condición obligatoria, cuando se posean otros cargos. No Sujetas de IVA". No permitido para REP.

3.4.7Campos que describen las formas de pagoConjunto G

C	ID	Campo	Descripción	P	T	Tam	Ocu	Observaciones
`G`	`G01`	`Payments`	Grupo de datos que contiene información sobre las formas de pago del documento electrónico.	`R01`	O		0-1	Obligatorio para REP. Este campo es de carácter obligatorio en todos los casos, excepto cuando se utilice en el campo condición de la venta, los códigos 02, 08 y 10, correspondientes a créditos
`G`	`G02`	`Payment`	Grupo que describe un medio de pago	`G01`	L		1-4	Puede haber máximo 4 formas de pago
`G`	`G021`	`Code`	Tipo de Medio de Pago	`G02`	A	`2`	1-1	Podrá colocar uno de los valores según la codificación de medios de pago. Valores permitidos `01` · Efectivo `02` · Tarjeta `03` · Cheque `04` · Transferencia – depósito bancario `05` · Recaudado por terceros `06` · SINPE MOVIL `07` · Plataforma Digital `99` · Otros (Se debe indicar el medio de pago en la representación gráfica.)
`G`	`G022`	`Description`	Detalle Medio de pago OTROS	`G02`	A	`3-100`	0-1	Será obligatorio en caso de utilizar el código 99 de "Otros". Se debe describir puntualmente el medio de pago utilizado.
`G`	`G023`	`Amount`	Monto Total por Medio de Pago	`G02`	N	`1-18p0-5`	0-1	Se deberá detallar el monto correspondiente al tipo de pago seleccionado. Se volverá obligatorio cuando se utilice más de un medio de pago

3.4.8Campos que describen información adicional sobre la transacción documentadaConjunto H

C	ID	Campo	Descripción	P	T	Ocu	Observaciones
`H`	`H01`	`AdditionalDocumentInfo`	Grupo de datos que contiene información adicional sobre el documento electrónico	`R01`	L	1-1
`H`	`H02`	`AdditionalInfo`	Grupo que contiene información adicional	`H01`	O	1-1
`H`	`H021`	`Texts`	Grupo que contiene datos adicionales al documento	`H02`	O	0-1
`H`	`H0211`	`Text`	Elemento que contiene la información de Otros.	`H021`	L		Ver en sección Otros
`H`	`H03`	`AditionalData`	Grupo que contiene datos adicionales como información de documento fiscal referenciado	`H02`	O	0-1	Cuando la factura cuenta con Información de referencia u Otros cargos.
`H`	`H031`	`Data`	Elemento que contiene datos adicionales sobre referencias y otros cargos.	`H03`	L	1-25	En el atributo Name puede venir el siguiente contenido. InformacionReferencia: Aquí se debe agregar la información necesaria para hacer referencia a documentos. Obligatorio para Notas de crédito y débito. Máximo de 10 repeticiones. OtrosCargos: Cuando se posean otros cargos que forman parte del costo total de la línea de detalle. Máximo de 15 repeticiones.
`H`	`H0311`	`Info`	Elemento que contiene la información adicional	`H031`	L	1-3	Ver en sección Información Adicional Data

3.4.8.1Grupo Información Adicional Data

ID	Campo	Descripción	T	Tam	Ocu	Observaciones
`HI01`	`TipoDocIR`	Tipo de documento referenciado	N	`2`	1-1	InformacionReferencia. Códigos según la codificación de tipos de documento de referencia. El código 16 de "Comprobante de Proveedor No Domiciliado" únicamente podrá ser utilizado en la Factura Electrónica de Compra. En el Comprobante "Recibo Electrónico de Pago", únicamente podrán ser utilizados los códigos 01, 02, 03, 04 y 08 correspondientes a "Factura Electrónica", "Nota de Crédito Electrónica", "Nota de Débito Electrónica", "Tiquete Electrónico" y "Factura Electrónica de Compras". Valores permitidos `01` · Factura electrónica `02` · Nota de débito electrónica `03` · Nota de crédito electrónica `04` · Tiquete electrónico `05` · Nota de despacho Ver los 21 valores →
`HI02`	`TipoDocRefOTRO`	Tipo de documento de referencia OTRO	A	`5-100`	0-1	InformacionReferencia. Será obligatorio en caso de utilizar el código 99 de "Otros". Se debe describir puntualmente el tipo de documento utilizado
`HI03`	`Numero`	Clave numérica del comprobante electrónico o consecutivo del documento de referencia.	N	`50`	0-1	InformacionReferencia. Este campo será de condición obligatoria, cuando se incluya información en el campo: TipoDoc, excepto cuando se utilice el código 13.
`HI04`	`FechaEmisionIR`	Fecha de emisión del documento referenciado.	N		1-1	InformacionReferencia. Se verificará que la fecha de referencia no supere una antigüedad de 10 años. Caso contrario se rechazará el comprobante
`HI05`	`Codigo`	Código de referencia	N	`2`	0-1	InformacionReferencia. Este campo será de condición obligatoria, cuando se incluya información en el campo: TipoDoc, excepto cuando se utilice el código 13. Códigos según la codificación de códigos de referencia. Este campo será de condición obligatoria, cuando se incluya información en el campo "Tipo de documento de referencia", excepto cuando se utilice el código 13. Valores permitidos `01` · Anula Documento de Referencia `02` · Corrige Monto `04` · Referencia a otro documento `05` · Sustituye comprobante provisional por contingencia `06` · Devolución de mercancía Ver los 17 valores →
`HI06`	`CodigoReferenciaOTRO`	Código de referencia OTRO	A	`5-100`	0-1	InformacionReferencia. Será obligatorio en caso de utilizar el código 99 de "Otros" en el campo Codigo (HI05).
`HI07`	`Razon`	Razón de referencia	A	`3-180`	0-1	InformacionReferencia. Este campo será de condición obligatoria, cuando se incluya información en el campo: TipoDocIR, excepto cuando se utilice el código 13.
`HI08`	`TipoDocumentoOC`	Tipo de documento otros cargos	N	`2`	1-1	OtrosCargos. Códigos según la codificación de tipos de documento otros cargos. Cuando se seleccione el código 04, 08, 09 y 10 en "Tipo de documento otros cargos" y no se cuente con una línea de servicio o producto, no es obligatorio usar el nodo "Detalle de la mercancía o servicio prestado" Valores permitidos `01` · Contribución parafiscal `02` · Timbre de la Cruz Roja `03` · Timbre de Benemérito Cuerpo de Bomberos de Costa Rica `04` · Cobro de un tercero `05` · Costos de Exportación `06` · Impuesto de servicio 10% `07` · Timbre de Colegios Profesionales `08` · Depósitos de Garantía `09` · Multas o Penalizaciones `10` · Intereses Moratorios `99` · Otros Cargos
`HI09`	`TipoDocumentoOTROS`	Tipo de documento OTRO	A	`5-100`	0-1	OtrosCargos. Será obligatorio en caso de utilizar el código 99 de "Otros". Se debe describir puntualmente el tipo de documento utilizado
`HI10`	`Tipo`	Tipo de identificación del Tercero	A	`2`	0-1	OtrosCargos. Tipo de identificación del emisor, valores aceptados: 01: Cédula física; 02: Cédula jurídica; 03: DIMEX; 04: NITE; 05: Extranjero no domiciliado Valores permitidos `01` · Cédula física `02` · Cédula jurídica `03` · DIMEX `04` · NITE `05` · Extranjero no domiciliado `06` · No contribuyente (Aplica para el tipo de identificación del emisor (B03).)
`HI11`	`Numero`	Número de cédula física/jurídica/NITE/DIMEX/ Extranjero No Domiciliado, del Tercero	A	`20`	0-1	OtrosCargos. Este campo será condición obligatoria, cuando se seleccione en TipoDocumentoOC el código 04.
`HI12`	`NombreTercero`	Nombre o razón social del Receptor	A	`100`	0-1	OtrosCargos. Este campo será de condición obligatoria, cuando se seleccione un TipoDocumentoOC el código 04.
`HI13`	`Detalle`	Detalle otros Cargos	A	`160`	1-1	OtrosCargos
`HI14`	`PorcentajeOC`	Porcentaje otros cargos	N	`1-9p0-5`	0-1	OtrosCargos. En el caso que el cargo posea un porcentaje o monto para su cálculo se debe de indicar el mismo. Debe de expresarse el porcentaje como número entero (Ejemplo: la tarifa del 13% se debe de reflejar como 13, la tarifa del 1% como 1, o bien la tarifa del 0.5% como 0.5).
`HI15`	`MontoCargo`	Monto del cargo	N	`1-13p5`	1-1	OtrosCargos

3.4.8.2Otros

C	ID	Campo	Descripción	P	T	Tam	Ocu	Observaciones
	`HI21`	`OtroTexto`	Otro Texto		A	`Indefinido`	0-1000	Elemento opcional que se puede utilizar para almacenar texto. Permite agregar un código opcional para facilitar la identificación del elemento y una cadena de texto. Ejemplo: Se quiere agregar un elemento nuevo con código OBSERVACIONES: { "@_CNo": "OtroTexto", "@_RNo": "OBSERVACIONES", "#text": "Información de la observación ….. etc." }
	`HI22`	`OtroContenido`	Otro Contenido		A	`Indefinido`	0-1000	Elemento opcional que se puede utilizar para almacenar contenido.

5Respuesta de la API

Al enviar el contenido del NUC, se obtiene como respuesta un objeto JSON que tiene la siguiente estructura.

Donde:

Atributo	Descripción
`code`	contiene el código de la respuesta obtenida
`message`	contiene un mensaje informativo relacionado a la respuesta
`description`	descripción adicional del mensaje
`responseData1`	texto codificado en base64 del xml del documento enviado
`responseData2`	texto codificado en base64 que contiene la factura el formato HTML
`responseData3`	texto codificado en base64 que contiene la factura el formato PDF
`authNumber`	Identificador único del documento
`url`	Contiene el enlace para consultar el documento en el portal de hacienda
`infoDetails`	atributo tipo arreglo de objetos que, cuando la respuesta es un error, muestra el listado de errores que contiene el NUC.
`suggestedFileName`	nombre sugerido para nombrar y guardar el contenido de la información que contiene el responseData1, responseData2, responseData3 o algún otro documento relacionado con la información de la factura emitida.
`suggestedFileName2`	otro nombre sugerido
`batch`	atributo sin valor por el momento
`serial`	atributo sin valor por el momento
`issuedTimeStamp`	fecha de emisión de la factura electrónica
`taxID`	Identificador del contribuyente emisor del documento
`name`	nombre o razón social del emisor
`branchCode`	código de establecimiento o sucursal donde fue emitida la factura, atributo sin valor por el momento
`branchName`	nombre comercial, atributo sin valor por el momento
`receiverTaxID`	identificador del receptor/comprador, atributo sin valor por el momento
`receiverName`	nombre o razón social del receptor
`discounts`	indica el total de descuentos aplicados a la factura, atributo sin valor por el momento
`taxes`	indica el total de impuestos aplicados a la factura, atributo sin valor por el momento
`subtotal`	subtotal de la factura, atributo sin valor por el momento
`totalAmount`	monto total de la factura, atributo sin valor por el momento
`enrolledTimeStamp`	fecha y hora de certificación de la factura
`backprocessor`	servidor que realiza la consulta
`additionalInfo`	Atributo tipo objeto que contiene información adicional sobre la factura emitida.

5.1 Códigos dentro de la Respuesta

Tabla 8 — Códigos de respuesta de la API

Código	Descripción
`-1`	Error al realizar certificación. País no válido ingresado en el NUC. Mostrará el mensaje de error en el atributo "message".
`0`	Error en el contenido del XML NUC. Este tipo de error se mostrará si en el proceso de transformar xml surge un error, puede ser causado por la ausencia de un valor importante, un tipo de dato incorrecto, etc. Se indicará en los atributos "message" y "description" el detalle y la descripción del error informado, indicando donde se encuentra el error y la referencia hacia esta documentación.
`1`	Operación realizada correctamente.
`400`	Error en realizar la consulta. Se mostrará en el atributo "message" la descripción del error.
`500`	Error inesperado. Se mostrará el contenido del error en los atributos "message" y "description".
`3010`	Error en el Schema del NUC. Verificar que el esquema (nodos y atributos del archivo XML) sea válido y que corresponda al NUC. Se indicará el error en los atributos "message" y "description"
`3000`	Error en el proceso de certificación. Puede ser por motivos de documento duplicado, NRC del emisor incorrecto, entre otros. Se indicará el error en los atributos "message" y "description".

5.2 Códigos de Estado HTTP

Tabla 9 — Códigos de estado HTTP

Código	Descripción
`200`	Ok
`400`	Bad Request
`401`	Unauthorized. Verificar token de autorización
`500`	Internal Server Error

Documentación Técnica NUC-JSON Costa Rica

3Convenciones utilizadas en el formato JSON

3.1 Columnas de las tablas de definición

3.2 Tipos de dato en el archivo JSON

3.3 Tamaños de los campos

4Formato del NUC

4.1 Información que debe contener el NUC

3.4.1Schema NUCConjunto R

3.4.2Campos que contienen información general de la Factura ElectrónicaConjunto A

3.4.2.1Grupo AdditionalIssueDocInfo

3.4.3Campos que contienen la información del emisor de la transacción documentadaConjunto B

3.4.3.1Grupo Emisor AdditionalInfo

3.4.3.2Grupo Emisor AdditionalBranchInfo

3.4.4Campos que contienen la información del receptor de la transacción documentadaConjunto C

3.4.4.1Grupo Receptor TaxIDAdditionalInfo

3.4.4.2Grupo Receptor AdditionlInfo

3.4.5Campos que describen cada ítem de la transacción documentadaConjunto E

3.4.5.1Grupo Ítem Codes

3.4.5.2Grupo Ítem Discounts AdditionalInfo

3.4.5.4Grupo Ítem Taxes AdditionalInfo EyE

3.4.5.5Grupo Item Charges Aditional Data

3.4.5.7Grupo Item Charges AditionalInfo

3.4.5.8Grupo Ítem AdditionalInfo

3.4.6Campos que describen los subtotales y totales de la transacción documentadaConjunto F

3.4.6.1Grupo Total AdditionalInfo

3.4.7Campos que describen las formas de pagoConjunto G

3.4.8Campos que describen información adicional sobre la transacción documentadaConjunto H

3.4.8.1Grupo Información Adicional Data

3.4.8.2Otros

5Respuesta de la API

Donde:

5.1 Códigos dentro de la Respuesta

5.2 Códigos de Estado HTTP