Documentación Técnica NUC-XML El Salvador
Especificación oficial V2.0.0 · en vigencia desde el 20/11/2025 del formato NUC en XML. Misma estructura que la versión JSON — cambia solo la serialización.
3Convenciones utilizadas en el formato XML
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. |
Observaciones | Observaciones importantes sobre el elemento, incluyendo listas de posibles valores, validaciones relevantes, entre otras. |
Perm | Indica los tipos de documentos donde es permitido agregar el elemento. Si se encuentra el valor "A" es válido para todos los documentos. |
3.2 Tipos de dato en el archivo XML
Tabla 3 — Tipos de dato
| Tipo | Descripción |
|---|---|
| xml | Documento XML, descrito en un schema contenido en esta ficha técnica |
| G | Grupo de elementos y/o grupos de elementos |
| A | Alfanumérico |
| N | Numérico: ver diversos formatos en la Tabla 4 |
| F | Fecha: Atributo tipo alfanumérico que deberá contener siempre la 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 El Salvador): 2017-04-17T14:23:00-06:00 |
| I | Informacion 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 <Info Name="" Data="" Value="" /> ó <Code Name="" Data="" Value="" /> |
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 |
D | Campos que describen cada ítem de la transacción documentada |
E | Campos que describen los subtotales y totales de la transacción documentada |
F | Campos que describen las formas de pago |
G | Campos que describen información adicional sobre la transacción documentada |
GA | Información Adenda Comercial |
El XML es case-sensitive. Los nombres de los elementos y atributos deben ingresarse respetando mayúsculas y minúsculas exactamente como se especifican. Recordar que en XML los grupos se representan como elementos contenedores y los arreglos como elementos repetidos del mismo nombre.
4.3.1Schema NUCConjunto R
Campos que contienen información para la generación de la factura electrónica. Importante: los nombres de los campos y datos que hagan referencia a información deben ser ingresados tomando en cuenta las mayúsculas y minúsculas, es decir, el API es case sensitive.
| C | ID | Campo | Descripción | P | T | Tam | Ocu | Observaciones |
|---|---|---|---|---|---|---|---|---|
R | R01 | CuerpoNUC | NUC (raíz) | | xml | | 1-1 | |
R | R02 | Version | Versión del formato de la factura electrónica | R01 | A | 1 | 1-1 | Control de versiones. Valores a ingresar según el tipo de documento.
Version 1: Para tipos de documentos 01, 07, 08, 09, 11, 14 y 15
Version 3: Para tipos de documentos 03, 04, 05 y 06 |
R | R03 | CountryCode | Código del país donde pertenece la factura electrónica a generar | R01 | A | 2 | 1-1 | SV: El Salvador |
4.3.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 | G | | 1-1 | |
A | A02 | DocType | Tipo de documento a generar | A01 | A | 2 | 1-1 | 01: Factura
03: Comprobante de Crédito Fiscal
04: Nota de Remisión
05: Nota de Crédito
06: Nota de Débito
07: Comprobante de Retención
08: Comprobante de Liquidación
09: Documento Contable de Liquidación
11: Factura de Exportación
14: Factura Sujeto Excluido
15: Comprobante de Donación
Si no se ingresa uno de estos valores, no se podrá generar la Factura Electrónica. Valores permitidos
|
A | A07 | GUID | Código de generación | A01 | A | 36 | 1-1 | Consiste en un número identificador único, aleatorio y universal. Debe cumplir con el estándar del UUID v4, el cual debe ser único por documento (no debe repetirse), la longitud debe ser de 32 dígitos separados por 4 guiones, haciendo un total de 36 posiciones dividido en 5 grupos. Ejemplo: 20DB43DA-8812-4F6E-B793-001916E2C74D |
A | A03 | IssuedDateTime | Fecha y hora de emisión | A01 | F | 25 | 1-1 | Si el documento fue emitido en contingencia la fecha y hora de emisión debe estar dentro del rango indicado de inicio (AI10) y fin (AI11) de contingencia. |
A | A04 | AdditionalIssueType | Ambiente de destino | A01 | A | 2 | 1-1 | 00: Pruebas
01: Producción |
A | A05 | Currency | Moneda de la operación | A01 | A | 3 | 0-1 | Único valor aceptado USD |
A | A06 | AdditionalIssueDocInfo | Grupo que contiene información general adicional de la factura electrónica | A01 | G | | 1-1 | |
A | A061 | Info | Elemento que describe la información adicional | A06 | I | | 1-6 | Ver en sección Grupo AdditionaIssueDocInfo. Agregar el nombre de la información en "Name" y el valor del mismo en "Value". Por ejemplo: si el Tipo de modelo es 1 quedaría así
{
"Name": "TipoModelo",
"Value": "1"
} |
4.3.2.1Grupo AdditionalIssueDocInfo
| C | ID | Campo | Descripción | P | T | Tam | Ocu | Observaciones |
|---|---|---|---|---|---|---|---|---|
| AI01 | Secuencial | Número secuencial | | A | 15 | 1-1 | Número secuencial de 15 dígitos, completado con "0" a la izquierda. Ejemplo:
{
"Name": "Secuencial",
"Value": "00000000000001"
} |
| AI02 | CodEstPuntoV | Código del establecimiento | | A | 8 | 1-1 | Código del establecimiento y punto de venta. Ejemplo:
{
"Name": "CodEstPuntoV",
"Value": "M001P001"
} |
| AI03 | TipoModelo | Modelo de facturación | | A | 1 | 1-1 | Puede tener uno de los siguientes valores de acuerdo al modelo de facturación que se utilizará
1: Modelo facturación previo
2: Modelo facturación diferido
Nota: los contribuyentes deberán utilizar modelo de recepción diferido únicamente en contingencia. |
| AI04 | TipoOperacion | Tipo de transmisión | | A | 1 | 1-1 | Puede tener uno de los siguientes valores
1: Transmisión normal
2: Transmisión en contingencia
Nota: el uso de transmisión por contingencia debe ser utilizado cuando el Modelo de facturación sea diferido (2). |
| AI05 | TipoContingencia | Tipo de contingencia | | A | 1 | 0-1 | Debe colocarse este atributo si se elige el Tipo de Transmisión 2. Los valores que pueden ingresarse son
1: No disponibilidad del MH
2: No disponibilidad en sistema del emisor
3: Falla en el suministro de servicio de internet del emisor
4: Falla en el suministro de servicio de energía del emisor que impida la transmisión de los DTE
5: Otro (deberá digitar un máximo de 500 caracteres en el campo AI06, Motivo de Contingencia, explicando el motivo). |
| AI06 | MotivoContingencia | Motivo de Contingencia | | A | 1-500 | 0-1 | Se podrá ampliar el motivo de la contingencia. Obligatorio si en Tipo de Contingencia (AI05) se ingresa la opción 5-Otro. Si el documento electrónico no se está generando en contingencia o en el campo Tipo de Contingencia, se ingresa un valor diferente a 5, no enviar este campo. |
| AI07 | NombreResponsableConting | Nombre del responsable del establecimiento | | A | 5-100 | 0-1 | Obligatorio si el documento se reporta en contingencia. Indica el nombre de la persona responsable del establecimiento que informa el evento de contingencia |
| AI08 | TipoDocResponsableConting | Tipo de documento de indentificación | | A | 2 | 0-1 | Obligatorio si el documento se reporta en contingencia. Tipo de documento de identificación de la persona que informa el evento de contingencia, puede ser uno de los siguientes valores:
36: NIT
13: DUI
37: Otro
03: Pasaporte
02: Carnet de Residente |
| AI09 | NumDocResponsableConting | Número de documento de identificación del responsabel | | A | 5-25 | 0-1 | Obligatorio si el documento se reporta en contingencia. Se debe colocar el número de documento de identificación de la persona responsable |
| AI10 | FecHorInicioConting | Fecha y hora de inicio/entrada en contingencia | | F | 25 | 0-1 | Obligatorio si el documento se reporta en contingencia. Por ejemplo: 2017-04-17T14:23:00-06:00 |
| AI11 | FecHorFinConting | Fecha y hora de finalización en contingencia | | F | 25 | 0-1 | Obligatorio si el documento se reporta en contingencia. Por ejemplo: 2017-04-17T16:23:00-06:00
Nota: si el documento fue emitido en contingencia la fecha y hora de emisión (A03) debe estar dentro del rango indicado de inicio (AI10) y fin (AI11) de contingencia. |
4.3.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 de la factura electrónica | R01 | G | | 1-1 | |
B | B02 | TaxID | Identificador tributario o NIT del emisor | B01 | A | 9-14 | 1-1 | NIT del emisor |
B | B03 | TaxIDAdditionalInfo | Elemento que contiene información tributaria adicional del emisor | B01 | G | 25 | 1-1 | |
B | B031 | Info | Elemento que describe la información adicional | B03 | I | | 1-25 | Ver en sección Emisor TaxIDAdditionalInfo |
B | B04 | Name | Nombre, denominación o razón social del contribuyente emisor | B01 | A | 1-250 | 1-1 | Deberá contener el Nombre, denominación o razón social del contribuyente Emisor, tal cual aparezca en la última Tarjeta de NRC |
B | B05 | Contact | Información de contacto del emisor | B01 | G | | 1-1 | |
B | B051 | PhoneList | Lista de números telefónicos | B05 | G | | 1-1 | |
B | B0511 | Phone | Número telefónico | B051 | A | 8-30 | 1-1 | |
B | B052 | EmailList | Lista de correos electrónicos | B05 | G | | 1-1 | |
B | B0521 | Email | Correo electrónico | B052 | A | 3-100 | 1-1 | Correo válido |
B | B06 | AdditionlInfo | Información adicional sobre datos relevantes del emisor | B01 | G | | 1-1 | |
B | B061 | Info | Elemento que describe la información adicional | B06 | I | | 1-25 | Ver en sección Emisor AdditionlInfo |
B | B07 | AddressInfo | Información sobre la dirección del emisor | B01 | G | | 1-1 | Ver códigos de municipios y departamentos en el Anexo Catálogo de municipios y departamentos |
B | B071 | Address | Dirección complemento | B07 | A | 1-200 | 1-1 | Detalle de la dirección de la casa matriz, sucursal, agencia, bodega, patio, predio, otro donde se ha realizado la operación. |
B | B072 | District | Codigo Municipio | B07 | A | 2 | 1-1 | Código del municipio donde se encuentra ubicada la casa matriz, sucursal, agencia, bodega, patio, predio, otro donde se ha realizado la operación. Valores permitidos
|
B | B073 | State | Codigo Departamento | B07 | A | 2 | 1-1 | Código del Departamento en el cual se encuentra ubicada la casa matriz, sucursal, agencia, bodega, patio, predio, otro donde se ha realizado la operación. Valores permitidos
|
B | B074 | Country | País | B07 | A | 2 | 1-1 | Único valor permitido SV |
4.3.3.1Grupo Emisor TaxIDAdditionalInfo
| C | ID | Campo | Descripción | P | T | Tam | Ocu | Observaciones |
|---|---|---|---|---|---|---|---|---|
| BI01 | NRC | NRC emisor | | A | 2-8 | 1-1 | Deberá de contener el número de NRC del emisor tal cual aparece en la tarjeta emitida por la Administración Tributaria sin guion. |
| BI02 | CodigoActividad | Código de Actividad Económica | | A | 5-6 | 1-1 | Código que corresponde a cualquier actividad económica. Ver códigos en Anexo Catálogo de actividades económicas. Valores permitidos
|
| BI03 | DescActividad | Actividad Económica | | A | 5-150 | 1-1 | Nombre de la actividad económica registrada. |
4.3.3.2Grupo Emisor AdditionlInfo
| C | ID | Campo | Descripción | P | T | Tam | Ocu | Observaciones |
|---|---|---|---|---|---|---|---|---|
| BI04 | NombreComercial | Nombre Comercial del contribuyente emisor | | A | 1-150 | 0-1 | Nombre comercial del emisor |
| BI05 | TipoEstablecimiento | Tipo de Establecimiento | | A | 2 | 1-1 | Tipo de establecimientos
01: Surcursal
02: Casa matriz
04: Bodega
07: Patio |
| BI06 | CodEstablecimientoMH | Código de tipo de Establecimiento asignado por el MH | | A | 4 | 0-1 | Deberá ingresar el código de Casa matriz / Sucursal / Agencia / Bodega / Predio / Otro que la Administración Tributaria le asigne. |
| BI07 | CodEstablecimiento | Código de tipo de Establecimiento asignado por el contribuyente | | A | 4 | 0-1 | Deberá ingresar el código de Casa matriz / Sucursal / Agencia / Bodega / Predio / Otro que la Administración Tributaria le asigne. |
| BI08 | CodPuntoVentaMH | Código de identificación del Punto de Venta asignado por el MH | | A | 4 | 0-1 | Deberá incorporar el código que ha sido asignado por la Administración Tributaria para el punto de venta donde se genera el documento electrónico. |
| BI09 | CodPuntoVenta | Código de identificación del Punto de Venta asignado por el contribuyente | | A | 4 | 0-1 | Deberá incorporar el código del punto de venta que el contribuyente emisor maneja internamente |
| BI10 | TipoItemExpor | Tipo de ítem | | A | 1 | 1-1 | Indica qué tipo de ítem se está exportando, los valores aceptados son:
1: Bienes
2: Servicios
3: Ambos (Bienes y Servicios, incluye los dos inherente a los productos o servicios)
Válido únicamente para tipo de documento 11 - Exportación |
| BI11 | RecintoFiscal | Recinto fiscal | | A | 2 | 0-1 | Cuando en Tipo de Item (BI10) se ingresen las opciones 1 o 3, se deberá indicar el recinto fiscal de la operación. Ver catálogo de opciones de Recinto Fiscal Valores permitidos
|
| BI12 | Regimen | Régimen de exportación | | A | 13 | 0-1 | Cuanto en Tipo de Item (BI10) se ingresen las opciones 1 o 3, deberá ingresar el régimen de exportación a que se somete la mercadería en El Salvador. Ver catálogo de opciones de Régimen de Exportación Valores permitidos
|
4.3.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 de la factura electrónica | R01 | G | | 1-1 | |
C | C02 | TaxID | Identificador tributario del receptor | C01 | A | 9-14 | 1-1 | Para los documentos 03, 05, 06, 08 y 09 este campo debe ser llenado con el NIT del receptor, sin guiones.
Para los documentos 01, 04, 07 y 11 este campo debe ser llenado con el número del documento que se indique en el campo Tipo de Documento (C03) |
C | C03 | TaxIDType | Tipo de documento de identificación | C01 | A | 2 | 0-1 | Código del tipo de documento de identificación
36: NIT
13: DUI
37: Otro
03: Pasaporte
02: Carnet de Residente |
C | C04 | TaxIDAdditionalInfo | Elemento que contiene información tributaria adicional del receptor | C01 | G | | 1-1 | |
C | C041 | Info | Elemento que describe la información adicional | C04 | I | | 1-25 | Ver en sección Receptor TaxIDAdditionalInfo |
C | C05 | Name | Nombre receptor | C01 | A | 1-250 | 0-1 | Nombre, denominación o razón social del contribuyente Receptor. Obligatorio cuando las operaciones sean mayores o iguales a $200.00 |
C | C06 | Contact | Información de contacto del receptor | C01 | G | | 0-1 | |
C | C061 | PhoneList | Lista de números telefónicos | C06 | G | | 0-1 | |
C | C0611 | Phone | Número telefónico | C061 | A | 8-30 | 1-1 | |
C | C062 | EmailList | Lista de correos electrónicos | C06 | G | | 0-1 | |
C | C0621 | Email | Correo electrónico | C062 | A | 3-100 | 1-1 | Correo válido |
C | C07 | AdditionlInfo | Información adicional del receptor | C01 | G | | 1-1 | |
C | C071 | Info | Elemento que describe la información adicional del receptor | C07 | I | | 1-25 | Ver en sección Receptor AdditionlInfo |
C | C08 | AddressInfo | Información de la dirección del receptor | C01 | G | | 0-1 | Ver códigos de municipios y departamentos en el Anexo Catálogo de municipios y departamentos |
C | C081 | Address | Dirección complemento | C08 | A | 1-200 | 1-1 | Detalle de la dirección de la casa matriz, sucursal, agencia, bodega, patio, predio, u otro donde indique el receptor |
C | C082 | District | Dirección Municipio | C08 | A | 2 | 1-1 | Código del municipio donde se encuentra ubicada la casa matriz, sucursal, agencia, bodega, patio, predio, otro, de la dirección del receptor Valores permitidos
|
C | C083 | State | Dirección Departamento | C08 | A | 2 | 1-1 | Código del Departamento en el cual se encuentra ubicada la casa matriz, sucursal, agencia, bodega, patio, predio, otro, de la dirección del receptor Valores permitidos
|
C | C084 | Country | País | C08 | A | 2 | 1-1 | Único valor permitido SV |
4.3.4.1Grupo Receptor TaxIDAdditionalInfo
| C | ID | Campo | Descripción | P | T | Tam | Ocu | Observaciones |
|---|---|---|---|---|---|---|---|---|
| CI01 | NRC | NRC receptor | | A | 2-8 | 0-1 | Cuando aplique, deberá de contener el número de NRC del receptor tal cual aparece en la tarjeta emitida por la Administración Tributaria sin guion.
• Requerido para documentos 03, 05, 06, 08
• Requerido según tipo de operación para documentos 04, 07, 09
Opcional para documentos 01, 15 |
| CI02 | CodigoActividad | Código de Actividad Económica | | A | 5-6 | 0-1 | Código que corresponde a cualquier actividad económica. Ver códigos en Anexo Catálogo de actividades económicas. Valores permitidos
|
| CI03 | DescActividad | Actividad Económica | | A | 5-150 | 0-1 | Nombre de la actividad económica registrada. |
| CI04 | TipoPersona | Tipo de Persona | | A | | 0-1 | Tipo de persona jurídica o natural
1: Persona Natural
2: Persona Jurídica
Obligatorio para tipo de documento 11 – Exportación |
4.3.4.2Grupo Receptor AdditionlInfo
| C | ID | Campo | Descripción | P | T | Tam | Ocu | Observaciones |
|---|---|---|---|---|---|---|---|---|
| CI05 | NombreComercial | Nombre Comercial | | A | 5-150 | 0-1 | Nombre comercial del receptor |
| CI06 | BienTitulo | Título a que se remiten los bienes | | A | 2 | 1-1 | Código que clasifica la condición para el traslado de los bienes por medio de una nota de remisión
01: Depósito
02: Propiedad
03: Consignación
04: Traslado
05: Otros
Válido únicamente para tipo de documento 04 – Nota de Remisión |
| CI07 | TipoEstablecimiento | Tipo de Establecimiento | | A | 2 | 1-1 | Tipo de establecimientos
01: Surcursal
02: Casa matriz
04: Bodega
07: Patio
Válido únicamente para tipo de documento 09 – Documento Contable de Liquidación Electrónico |
| CI08 | CodEstablecimientoMH | Código del Establecimiento | | A | 4 | 0-1 | Código del establecimiento donde se genera el DTE. Válido únicamente para tipo de documento 09 – Documento Contable de Liquidación Electrónico |
| CI09 | CodPuntoVentaMH | Código del Punto de Venta | | A | 4 | 0-1 | Código identificador del punto de venta. Válido únicamente para tipo de documento 09 – Documento Contable de Liquidación Electrónico |
| CI10 | CodPais | Codigo del país de exportación | | A | 4 | 1-1 | Código del país de exportación |
| CI11 | NombrePais | Nombre del país de exportación | | A | 3-50 | 1-1 | Nombre del país destino de la mercancía. Válido únicamente para tipo de documento 11 – Factura de Exportación |
| CI12 | Complemento | Direccion complemento | | A | 5-300 | 1-1 | Detalle de las especificaciones de la dirección. Válido únicamente para tipo de documento 11 – Factura de Exportación |
| CI13 | CodigoDomiciliado | Codigo del domiciliado | | A | 1 | 0-1 | Codificación de domicilio fiscal. Obligatorio para documento 15
1: Domiciliado
2: No Domiciliado |
4.3.5Campos que describen cada ítem de la transacción documentadaConjunto D
| C | ID | Campo | Descripción | P | T | Tam | Ocu | Observaciones |
|---|---|---|---|---|---|---|---|---|
D | D01 | Items | Grupo de datos que especifica los ítems de la transacción | R01 | G | | 1-1 | |
D | D02 | Item | Grupo de datos que especifica cada detalle del ítem | D01 | G | | 1-2000 | Cuando el documento sea tipo 09 – Documento Contable de Liquidación Electrónico, solo es permitido agregar 1 ítem. |
D | D03 | Number | Correlativo del item | D02 | N | 1-2000 | 1-1 | Numero correlativo que indica la línea del ítem. Desde 1 a 2000. |
D | D04 | Codes | Información relacionada a códigos del ítem | D02 | G | | 0-1 | |
D | D041 | Code | Elemento que describe la información adicional | D04 | I | | 1-25 | Ver en sección Ítem Codes |
D | D05 | Type | Tipo de Item | D02 | A | 1 | 1-1 | Tipo de Ítem, puede tener los siguientes valores
1: Bienes
2: Servicios
3: Ambos (Bienes y Servicios, incluye los dos inherente a los Productos o Servicios)
4: Otros tributos por ítem
Se deberá ingresar en este campo la opción 4, cuando se requiera ingresar el valor de un impuesto cuyo valor calculado esté sujeto calcular IVA. Es decir, que en este ítem apliquen los códigos contenidos en la sección 2 del Catálogo de Tributos.
Para tipo de documento 14 – FSE no se permite el uso del código 4.
Para documento 15 – CD: Se deberá indicar el tipo de donación que se está realizando según los siguientes valores
1: Efectivo
2: Bien
3: Servicio |
D | D06 | Description | Descripción del producto o servicio | D02 | A | 1-1000 | 1-1 | Descripción que detalle el producto y/o servicio que se brinda |
D | D07 | Qty | Cantidad del producto o servicio, en la unidad de medida | D02 | N | 1-10p1-8 | 1-1 | Cantidad del producto o servicio.
Deberá completarse con valor 1.00 cuando:
a) campo Type (D05) contenga valor de 4. Valido para documento 01
b) Cuando se haga uso del valor No Gravado (D12). Valido para documento 01, 03. |
D | D08 | UnitOfMeasure | Unidad de medida del código interno | D02 | A | 1-2 | 0-1 | Código de unidad de medida, puede ver el catálogo en el Anexo Catálogo de unidades de medida.
Se ingresará código 99 – otro cuando:
a) Cuando el contribuyente preste un servicio.
b) Cuando no aplique unidad de medida o cuando la unidad de medida no esté contemplada dentro del catálogo proporcionado
c) Cuando el campo Type (D05) contenga valor 4 para documentos 01, 03, 04. O si el campo Type (D05) contiene valor 1 o 3 para documento 15.
d) Cuando se detalle documento relacionado y se requiera informar el mismo en un solo valor consolidado. Valores permitidos
|
D | D09 | Price | Precio unitario de la transferencia del bien o servicio | D02 | N | 1-9p2-8 | 1-1 | Para documentos 01, 03, 04, 05, 06, 11, 14: Precio unitario del ítem.
Condiciones especiales:
a) Cuando se haga uso del campo NO_GRAVADO (D1211), deberá ingresarse como precio unitario el valor 0.00. Valido para documentos 01, 03
b) Cuando el campo Type (D05) se haya completado con la opción 4, se deberá reflejar en Price el valor calculado del tributo. Valido para documentos 01, 03.
c) Cuando se detalle un documento relacionado (ya sea físico o electrónico) y se informe de manera consolidada, este campo reflejará el valor total del documento.
Para documento 09: Valor de las operaciones a liquidar. Obligatorio. Deberá indicar el valor monetario total (bruto incluyendo IVA, propina u otro) de las transacciones a liquidar.
Para documento 15: Deberá indicar el costo unitario de los bienes o servicios donados. |
D | D10 | Discounts | Información relacionada a descuentos del ítem | D02 | G | | 0-1 | Sección para indicar descuentos, bonificaciones o rebajas en los productos o servicios por ítem. Elemento opcional. |
D | D101 | Discount | Elemento que describe un descuento | D10 | G | | 1-1 | |
D | D1011 | Amount | Descuento por precio unitario del ítem | D101 | N | 1-11p2-8 | 1-1 | Cuando no aplique descuento puede ingresar el valor 0.00 |
D | D11 | Taxes | Información relacionada a impuestos aplicados al ítem | D02 | G | | 0-1 | Para los documentos 01, 03, 04, 05, 06, 08, 11: Sección para indicar los tributos relacionados al ítem.
Cuando en el ítem exista VENTA_GRAVADA (D1211) se debe contener por lo menos un código de tributo.
Esta sección no debe agregarse en los siguientes casos:
a) Cuando en el ítem se detalle VENTA_NO_SUJETA (D1211)
b) Cuando en el ítem se detalle VENTA_EXENTA (D1211)
c) Cuando se haga uso del campo NO_GRAVADO (D1211)
d) Cuando el campo Type (D05) esté completo con la opción 4.
Para el documento 07 – Comprobante de Retención: Sección para ingresar el detalle de valores de retención |
D | D111 | Tax | Elemento que describe un impuesto | D11 | G | | 1-20 | |
D | D1111 | Code | Tipo de tasa y/o impuesto a aplicar | D111 | A | 2 | 1-1 | Para los documentos 01, 03, 04, 05, 06, 08, 11: Código según Catálogo de Tributos.
Restricciones:
a) Para documento 01: no se debe colocar el código de impuesto 20 – Impuesto al Valor Agregado (13%) ya que los valores que presenta cada item tienen el IVA incluido.
b) Para los documentos 03, 04, 05, 06, cuando en un ítem se detallen tributos contenidos en el elemento CodTributo (DI03), a este ítem deberá adicionarse en este campo el código de tributo 20 – IVA.
c) Para los documentos 05, 06 y 08 solo aplicarán los tributos contenidos en la sección 1 del catálogo de tributos.
Para el documento 07 – Comprobante de Retención: Se deberá ingresar el código según aplique la retención del IVA
22: Retención IVA 1%
C4: Retención IVA 13%
C9: Otras retenciones IVA casos especiales Valores permitidos
|
D | D1112 | TaxableAmount | Monto sujeto a retención | D111 | N | 1-9p2 | 0-1 | Aplica únicamente para documento 07. Se deberá detallar el valor neto que fue sujeto de retención por cada documento detallado en cada ítem |
D | D1113 | Amount | Iva retenido | D111 | N | 1-9p2-8 | 1-1 | Para los documentos 01, 03, 04, 05, 06, 08, 11: Deberá contener el valor 0.00
Para el documento 07 – Comprobante de Retención: Se deberá detallar el monto de retención IVA efectuada en el documento relacionado. Es el resultado del Monto sujeto a retención (D1112) multiplicado por el porcentaje legal que se indicó según el código elegido (D1111). |
D | D12 | Charges | Información relacionada a tipos de ventas que corresponden en los ítems | D02 | G | | 0-1 | Sección donde se detallarán los montos de ventas u otros valores del ítem.
Solo es posible que exista un monto diferente de 0.00 en el ítem, por ejemplo si la venta corresponde a una venta gravada
[
{ "Code": "VENTA_GRAVADA", "Amount": 100.00 },
{ "Code": "VENTA_EXENTA", "Amount": 0.00 },
{ "Code": "VENTA_NO_SUJETA", "Amount": 0.00 },
{ "Code": "NO_GRAVADO", "Amount": 0.00 }
]
O puede solo indicarse el tipo de venta o monto que corresponde al ítem
[
{ "Code": "VENTA_GRAVADA", "Amount": 100.00 }
] |
D | D121 | Charge | Elemento que describe el tipo de Venta | D12 | G | | 1-4 | |
D | D1211 | Code | Venta/monto a aplicar | D121 | A | 1-20 | 1-1 | Puede contener los siguientes valores
VENTA_NO_SUJETA: Cuando las ventas realizadas cumplan con las características de ser no sujetas. De no existir ventas sujetas en el campo Amount (D1212) deberá ingresar 0.00. Aplica para documentos 01, 03, 04, 05, 06, 08.
VENTA_EXENTA: Cuando las ventas realizadas cumplan con las características de ser exentas. De no existir ventas exentas en el campo Amount (D1212) deberá ingresar ingresar 0.00. Aplica para documentos 01, 03, 04, 05, 06, 08.
VENTA_GRAVADA: Se deberá indicar las ventas (ventas con inclusión de IVA) realizadas que cumplan con las características de ser gravadas. Si no existen ventas gravadas en el campo Amount (D1212) se deberá ingresar 0.00. Aplica para documentos 01, 03, 04, 05, 06, 08, 11.
NO_GRAVADO: Cuando el contribuyente emisor quiera acreditar saldos o montos a favor del contribuyente receptor que no estén afectos a la base imponible. Deberá contener signo negativo o positivo según sea el caso. Cuando no existan montos no gravados se deberá completar el campo Amount (D1212) con valor 0.00. Aplica para documentos 01, 03, 11.
EXPORTACIONES: Se deberán detallar únicamente los valores de factura de exportación. Cuando se informen documentos con estado invalidado/anulado, se deberá ingresar los valores monetarios con signo negativo. Aplica para documento 08. |
D | D1212 | Amount | Monto a aplicar | D121 | N | 1-9p2-8 | 1-1 | El monto para venta no sujeta, venta exenta o venta gravada se calcula de la siguiente manera a excepción del documento 08:
Resultado = [Precio unitario (D09) * Cantidad (D07)] - descuento unitario (D1011)
Para documento 08 – CL los valores a agregar son los siguientes:
• Para Ventas no Sujetas el resultado será "Total de operaciones Ventas no sujetas (E0311 y E0312)" – "monto global de descuento bonificación, rebajas y otros a Ventas no sujetas (E0411 y E0412)" contenidos en el documento que se está liquidando
• Para Ventas Exentas el resultado será "Total de operaciones Ventas exentas" – "monto global de descuento, bonificación, rebajas y otros a ventas exentas" contenidos en el documento que se está liquidando.
• Para Ventas Gravadas el resultado será "Total de operaciones Ventas Gravadas" – "monto global de descuento, bonificación, rebajas y otros a ventas gravadas" contenidos en el documento que se está liquidando.
Para el caso de monto no gravado, corresponde al valor que el contribuyente emisor quiera acreditar al receptor. Puede ser positivo o negativo según sea el caso. |
D | D13 | Totals | Contiene el resumen de precios del ítem | D02 | G | | 1-1 | |
D | D131 | TotalItem | Precio total del ítem | D13 | N | 1-11p2-8 | 1-1 | Corresponde al valor de la venta indicada en el campo D1212.
Por ejemplo si el ítem corresponde a una venta no sujeta con monto de 150.00 se deberá completar en este campo el valor de 150.00
Para documento 07 – CR, deberá contener el IVA retenido del ítem.
Para documento 14 – FSE, se deberá indicar el monto de la venta, la cual estará dada por el resultado de: [PrecioUnitario (D09) * Cantidad (D07)] – Descuento (D1011)
Para documento 15 – CD, se deberá ingresar el valor donado el cual será el resultado de: [PrecioUnitario (D09) * Cantidad (D07)] – Depreciacion (DI22) |
D | D14 | AdditionalInfo | Información adicional | D02 | G | | 0-1 | |
D | D141 | Info | Elemento que describe la información adicional | D12 | I | | 1-25 | Ver en sección Ítem AdditionalInfo |
4.3.5.1Grupo Ítem Codes
| C | ID | Campo | Descripción | P | T | Tam | Ocu | Observaciones |
|---|---|---|---|---|---|---|---|---|
| DI01 | NumeroDocumento | Numero de Documento Relacionado | | A | 1-36 | 0-1 | Cuando aplique, se deberá ingresar el código de generación o número de correlativo del documento que se está referenciando. Solo podrá ingresarse los números de documentos relacionados que se encuentren descritos en el apartado de Documentos Relacionados. (GI01, GI02, GI03, GI04) |
| DI02 | Codigo | Codigo del producto/servicio | | A | 1-25 | 0-1 | Si se cuenta con una codificación para los productos o servicios que se detallan en la factura.
No indicar
• cuando el Tipo de Item (D05) sea 4.
• Cuando se haga uso del valor No Gravado (D1211) |
| DI03 | CodTributo | Código de tributo sujeto a cálculo de IVA MH | | A | 2 | 0-1 | Debe ingresarse Código de Tributo contenidos en el apartado 2 (códigos A8, 57, 90, D4, D5 o A6) en el Catálogo de Tributos.
Valor requerido cuando Tipo de Item (D05) sea 4.
Cuando se haga uso de este campo para los documentos 03, 04, 05 y 06 se permitirá únicamente el código 20-IVA en el campo "Código del Tributo" (D1111) Valores permitidos
|
| DI04 | CodigoLiquidacion | Código de Liquidación Interna | | A | 1-30 | 0-1 | Código de la liquidación interna, llevado por la administradora de tarjetas de crédito o debito |
4.3.5.2Grupo Ítem AdditionalInfo
| C | ID | Campo | Descripción | P | T | Tam | Ocu | Observaciones |
|---|---|---|---|---|---|---|---|---|
| DI20 | PrecioSugeridoVenta | Precio sugerido de venta | | N | 1-9p2-8 | 0-1 | Deberá contener el precio sugerido de venta (psv) según aplique para los productos de tabaco o alcohol, de acuerdo a lo informado a la Administración Tributaria en los formularios respectivos, el psv deberá detallarse por ítem.
Si la naturaleza del negocio no lo requiere deberá agregar en este campo 0.00 |
| DI21 | IvaItem | IVA por item | | N | 1-9p2-8 | 0-1 | Debe contener el monto computado del impuesto a la transferencia de bienes inmuebles y prestación de servicios (IVA) por cada ítem.
Para el documento 01, el valor de este campo estará dado por el siguiente cálculo
[[Ventas gravadas por ítem (D1212)] / 1.13] * 13%
Para el documento 08, el valor de este campo estará dado por el siguiente cálculo
[Ventas gravadas por ítem (D1212)]*13%
En el caso del documento 08, cuando el documento a liquidar informado se encuentre con estado invalidado/anulado, se ingresarán los valores de IVA en negativo, a excepción de la Nota de crédito que se ingresará con valores positivos. |
| DI22 | Depreciacion | Depreciación | | N | 1-11p0-8 | 0-1 | Cuando el tipo de donación (D05) esté completo con la opción 2 (Bien), deberá ingresar el valor de la depreciación del bien donado. |
| DI23 | TipoDte | Tipo de Documento Tributario Relacionado | | A | 2 | 0-1 | Obligatorio para documentos 07, 08. Se deberá indicar el código del documento relacionado
• Se podrán relacionar documentos emitidos de forma física y electrónica de manera conjunta o separada
• Para documento 07, no se podrán relacionar diferentes tipos de documentos en un mismo documento (es decir un CCF con una F)
• Para documento 08, es permitido relacionar documentos de diferentes tipos. Por ejemplo en un CL podrán relacionarse CCF, F, FEX, NC y ND.
Por ejemplo, si se quiere relacionar un Comprobante de Crédito Fiscal se debe colocar el valor "03" |
| DI24 | TipoDoc | Tipo de generación del documento | | N | 1 | 0-1 | Obligatorio para documentos 07, 08. Se deberá indicar el tipo de generación del documento
1: Físico
2: Electrónico |
| DI25 | FechaEmision | Fecha de generación del documento relacionado | | A | 10 | 0-1 | Obligatorio para documentos 07, 08. Se deberá ingresar la fecha de generación del documento relacionado. Con la siguiente estructura YYYY-MM-DD |
| DI26 | PeriodoLiqFechaInicio | Fecha de inicio del período de liquidación | | A | 10 | 0-1 | Obligatorio para documento 09. Deberá indicar la fecha inicial del período a liquidar. Deberá cumplir con la siguiente estructura YYYY-MM-DD. |
| DI27 | PeriodoLiqFechaFin | Fecha fin del período de liquidación | | A | 10 | 0-1 | Obligatorio para documento 09. Deberá indicar la fecha final del período a liquidar. Deberá cumplir con la siguiente estructura YYYY-MM-DD. |
| DI28 | PeriodoLiqFechaFin | Fecha fin del período de liquidación | | A | 10 | 0-1 | Deberá indicar la fecha final del período a liquidar. Deberá cumplir con la siguiente estructura YYYY-MM-DD. |
| DI29 | CantidadDoc | Cantidad de documentos | | N | 1-1000 | 0-1 | Podrá indicar la cantidad de documentos que se están liquidando |
| DI30 | MontoSinPercepcion | Valores no sujetos a percepción | | N | 1-11p2 | 0-1 | El agente de percepción podrá colocar el monto de las operaciones a liquidar no sujetas a percepción. De no hacer uso del campo se puede ingresar 0.00 |
| DI31 | DescripcionSinPercepcion | Descripción del valor no sujeto a percepción | | A | 1-100 | 0-1 | Se podrá indicar una breve descripción de las operaciones que identifiquen el origen de los montos no sujetos a percepción |
| DI32 | Observaciones | Observaciones por item | | A | 5-200 | 0-1 | Queda a disposición de cualquier otra observación que el emisor desee colocar. |
| DI33 | IVA | IVA de las operaciones a liquidar | | N | 1-11p2 | 0-1 | Obligatorio para documento 09. Deberá indicar el IVA de las transacciones que se calcula sobre el valor neto de las operaciones reportadas por el afiliado.
IVA = 13 * [ (valor de operaciones (D09) – montoSinPercepcion (DI30)) / 113 ] |
| DI34 | MontoSujetoPercepcion | Monto sujeto a percepción sin IVA | | N | 1-11p2 | 0-1 | Obligatorio para documento 09. Deberá indicar el valor neto de las operaciones sobre el cual se efectúa la percepción IVA
IVA = [valor de operaciones (D09) – montoSinPercepcion (DI30) ] / 1.13 |
| DI35 | IVApercibido | IVA percibido (2%) | | N | 1-11p2 | 0-1 | Obligatorio para documento 09. Deberá indicar el IVA percibido sobre el valor neto de la operación
IvaPercibido = [MontoSujetoPercepcion (DI34)] * 2% |
| DI36 | Comision | Comisión | | N | 1-11p2 | 0-1 | Obligatorio para documento 09. Deberá indicar el monto de la comisión por el servicio. De no hacer uso del campo ingresar 0.00 |
| DI37 | PorcentajeComision | Porcentaje de Comisión | | A | 1-100 | 0-1 | Podrá indicar el porcentaje de la comisión |
| DI38 | IVAcomision | IVA de la comisión | | N | 1-11p2 | 0-1 | Obligatorio para documento 09. Deberá indicar el monto del IVA de la comisión por el servicio |
| DI39 | LiquidoAPagar | Valor líquido a pagar al afiliado | | N | 1-11p2 | 0-1 | Obligatorio para documento 09. Deberá indicar el valor líquido a pagar al afiliado en la fecha o período pactado.
LiquidoAPagar = ValorOperaciones (D09) – comision (DI36) – ivaPercibido (DI35) – IVAcomision (DI38) |
| DI40 | TotalLetras | Valor en letras | | N | 1-11p2 | 0-1 | Obligatorio para documento 09. Deberá indicar en letras el valor total a pagar |
4.3.6Campos que describen los subtotales y totales de la transacción documentadaConjunto E
| C | ID | Campo | Descripción | P | T | Tam | Ocu | Observaciones |
|---|---|---|---|---|---|---|---|---|
E | E01 | Totals | Grupo de datos que contiene información sobre el total del documento electrónico | R01 | G | | 1-1 | |
E | E02 | TotalTaxes | Elemento que contiene información de los tributos aplicados en la factura | E01 | G | | 0-1 | Para documentos 01, 03, 04, 05, 06, 08: Se deberá indicar de forma consolidada los códigos de los tributos que se hayan aplicado en Items (D111). Cada código de tributo solo se podrá aplicar una sola vez, aunque su código se hubiera aplicado 2000 veces en el documento.
Consideraciones
a) NO se detallarán aquellos tributos cuyo valor está sujeto al cálculo de IVA y fueron detallados en Items (ítem con tipo de ítem 4 (D05) y con código de tributo (DI03) con códigos A8, 57, 90, D4, D5 o A6)
b) Deberá mostrarse a nivel informativo los códigos diferenciales de precios los cuales están contemplados en la sección 3 del catálogo de Tributos (C5, C6 y C7) y no se sumarán en los totales, son de uso informativo
Para documento 07: Sección donde se colocarán los valores del total sujeto a retención e IVA retenido. Únicamente debe agregarse un valor por TOTAL_SUJETO_RETENCION y por el TOTAL_IVA_RETENIDO de manera que resuman los montos sujetos a retención y retenidos en los ítems.
Por ejemplo:
"TotalTax": [
{ "Code": "TOTAL_SUJETO_RETENCION", "Amount": "1000.00" },
{ "Code": "TOTAL_IVA_RETENIDO", "Amount": "130.00" }
] |
E | E021 | TotalTax | Elemento que describe un tributo | E02 | G | | 1-25 | |
E | E0211 | Code | Codigo de tributo | E021 | A | 2 | 1-1 | Código del tributo. Ejemplo de consolidación de tributos:
{ "Code": "D1", "Description": "FOVIAL ($0.20 Ctvs. por galón)", "Amount": 10.00 }
Para el tipo de documento 01 se detallarán los tributos pertenecientes a la sección 1 y 3. (Códigos 59, 71, D1, C8, D5, D4, C5, C6 y C7).
Para el tipo de documento 03 se detallarán los tributos pertenecientes a la sección 1 y 3. (Códigos 20, 59, 71, D1, C8, D5, D4, C5, C6 y C7).
Para el tipo de documento 04, 05, 06 o 08, se detallarán los tributos pertenecientes a la sección 1.
Para documento 07: Deberá ingresar los siguientes valores
TOTAL_SUJETO_RETENCION: deberá contener la sumatoria de los montos sujetos a retención.
TOTAL_IVA_RETENIDO: deberá contener la suma de los campos IVA retenido. Valores permitidos
|
E | E0212 | Description | Nombre del tributo | E021 | A | 1-50 | 1-1 | Para documentos 01, 03, 04, 05, 06, 08: Deberá describir el nombre de cada tributo que corresponda a los códigos ingresados en el campo E0211.
Ejemplo de consolidación de tributos:
{ "Code": "D1", "Description": "FOVIAL ($0.20 Ctvs. por galón", "Amount": 10.00 } |
E | E0213 | Amount | Monto de impuesto | E021 | N | | 1-1 | Para documentos 01, 03, 04, 05, 06, 08: Debe contener la sumatoria consolidada de los valores calculados de los tributos detallados.
{ "Code": "D1", "Description": "FOVIAL ($0.20 Ctvs. por galón", "Amount": 10.00 }
Para documento 07: Deberá ingresar los siguientes valores en cada opción que se muestra a continuación
TOTAL_SUJETO_RETENCION: deberá contener la sumatoria de los montos sujetos a retención (D1112) de los documentos relacionados.
TOTAL_IVA_RETENIDO: deberá contener la suma de los campos IVA retenido (D131). |
E | E03 | TotalCharges | Elemento que contiene información de los montos o ventas totales de la factura | E01 | G | | 1-1 | Debe contener el total de las ventas y montos aplicados sobre los ítems, si no se realizó un tipo de venta se debe colocar en Amount (E0312) el valor de 0.00 siempre y cuando el tipo de venta aplique para ese documento. |
E | E031 | TotalCharge | Elemento que contiene la información de un monto o venta | E03 | G | | 1-5 | |
E | E0311 | Code | Tipo de venta a resumir | E031 | A | 1-20 | 1-1 | Puede contener los siguientes valores
TOTAL_NO_SUJETA: Corresponde al total de ventas no sujetas sobre los ítems. Válido para documentos 01, 03, 04, 05, 06, 08.
TOTAL_EXENTA: Corresponde al total de ventas exentas sobre los ítems. Válido para documentos 01, 03, 04, 05, 06, 08.
TOTAL_GRAVADA: Corresponde al total de ventas gravadas sobre los ítems. Válido para documentos 01, 03, 04, 05, 06, 08, 11.
TOTAL_EXPORTACIONES: Corresponde a la sumatoria de las operaciones de exportación realizadas. Para documento 08.
TOTAL_NO_GRAVADO: Corresponde al total de montos no gravados sobre los ítems.
TOTAL_COMPRA: Deberá contener la sumatoria de todas las operaciones realizadas. Para documento 14. |
E | E0312 | Amount | Valor de venta o monto total | E031 | N | 1-11p2 | 1-1 | El valor en este campo puede ser el siguiente:
TOTAL_NO_SUJETA: Corresponde al total de ventas no sujetas sobre los ítems. Será la suma de todos los valores de ventas no sujetas (D1211 y D1212).
TOTAL_EXENTA: Corresponde al total de ventas exentas sobre los ítems. Será la suma de todos los valores de ventas exentas (D1211 y D1212).
TOTAL_GRAVADA: Corresponde al total de ventas gravadas sobre los ítems. Será la suma de todos los valores de ventas gravadas (D1211 y D1212).
TOTAL_EXPORTACIONES: Corresponde a la sumatoria de las operaciones de exportación realizadas. Será la suma de todos los valores de exportación (D1211 y D1212).
TOTAL_NO_GRAVADO: Corresponde al total de montos no gravados sobre los ítems. Será la suma de todos los valores de montos no gravados (D1211 y D1212). Colocar en documentos 01, 03, 11.
TOTAL_COMPRA: Deberá contener la sumatoria de todas las operaciones realizadas (D131). |
E | E04 | TotalDiscounts | Grupo de datos que contiene información de descuentos o bonificaciones globales aplicados a la factura | E01 | G | | 0-1 | Se podrá realizar un descuento adicional sobre los montos totales de cada tipo de venta efectuada en los ítems de la factura. |
E | E041 | Discount | Elemento que contiene información sobre el descuento | E04 | G | | 1-5 | |
E | E0411 | Code | Descripción de descuentos o bonificaciones adicionales aplicados a la factura | E041 | A | 1-20 | 1-1 | Puede tener los siguientes valores
NO_SUJETA: indica el descuento a aplicar sobre el total de operaciones no sujetas. Aplica para documentos 01, 03, 04, 05, 06.
EXENTA: indica el descuento a aplicar sobre el total de operaciones exentas. Aplica para documentos 01, 03, 04, 05, 06.
GRAVADA: indica el descuento a aplicar sobre el total de operaciones gravadas. Aplica para documentos 01, 03, 04, 05, 06.
PORCENTAJE_DESCUENTO: se podrá indicar el porcentaje global de descuento, bonificación, rebajas, subsidio y otros que el emisor realice sobre la sumatoria de ventas. Aplica para documentos 01, 03, 04, 11.
DESCUENTO: indica el descuento a aplicar sobre el total de operaciones afectas. Aplica para documentos 11, 14. |
E | E0412 | Amount | Monto descuentos/bonificaciones | E041 | N | 1-11p2 | 1-1 | Indica el monto de descuento sobre la el valor indicado en el campo E0411. Cuando no quiera aplicarse descuento se deberá agregar el valor 0.00 |
E | E05 | GrandTotal | Información sobre el precio total de la factura | E01 | G | | 1-1 | |
E | E051 | InvoiceTotal | Precio total de la factura | E05 | N | 1-11p2 | 1-1 | Indica el monto total a pagar en la factura.
subtotal = [total de ventas no sujetas (E031) + total de ventas exentas (E031) + total de ventas gravadas (E031)] – [descuento global a ventas no sujetas (E041) + descuento global a ventas exentas (E041) + descuento global a ventas gravadas (E041)]
valorTributos = [sumatoria de valores de cada tributo (E0213) a excepción de los tributos C5, C6 y C7]
Para documento 01 el cálculo es el siguiente:
Total a pagar = subtotal + valorTributos - retencionRenta (EI02) – ivaRetenido (EI01) + totalMontoNoGravado (E0311)
Para documento 03 el cálculo es el siguiente:
Total a pagar = subtotal + valorTributos - retencionRenta (EI02) – ivaRetenido (EI01) + totalMontoNoGravado (E0311) + ivaPercibido (EI06)
Para documento 04 el cálculo es el siguiente:
Total a pagar = subtotal + valorTributos
Para documentos 05, 06 el cálculo es el siguiente:
Total a pagar = subtotal + valorTributos + ivaPercibido (EI06) – ivaRetenido (EI01) – retencionRenta (EI02)
Para documento 07, deberá contener el valor del Total de IVA retenido (E0213)
Para documento 08 el cálculo es el siguiente:
Total = [total de ventas no sujetas (E031) + total de ventas exentas (E031) + total de ventas gravadas (E031) + total de ventas de exportación (E031)] + valorTributos + IvaPercibido (EI06)
Monto total de la operación + iva percibido liquidado
Para documento 09, este campo debe tener un valor de 0.00
Para documento 11 el cálculo es el siguiente:
Total a pagar = [total de ventas gravadas (E031)] – [descuento sobre el total de operaciones afectas (E0411)] + totalMontoNoGravado (E0311) + Seguro (EI07) + Flete (EI08)
Para documento 14 el cálculo es el siguiente:
Total a pagar = [Total_Compra (E031)] – [Descuento (E0411)] – ivaRetenido (EI01) – retencionRenta (EI02)
Para documento 15, deberá contener la sumatoria de todos los valores donados (D131) |
E | E06 | InWords | Valor en letras | E01 | A | 1-200 | 1-1 | Deberá contener el valor total a pagar en letras |
E | E07 | AdditionalInfo | Información adicional | E01 | G | | 0-1 | |
E | E071 | Info | Elemento que describe la información adicional | E07 | I | | 1-25 | Ver en sección Total AdditionalInfo |
4.3.6.1Grupo Total AdditionalInfo
| C | ID | Campo | Descripción | P | T | Tam | Ocu | Observaciones |
|---|---|---|---|---|---|---|---|---|
| EI01 | IvaRetenido | IVA Retenido | | N | 1-9p2 | 0-1 | Cuando la operación esté sujeta a retención IVA, debe contener el monto computado del impuesto retenido. De no existir IVA retenido se deberá completar con valor 0.00 |
| EI02 | RetencionRenta | Retención Renta | | N | 1-9p2 | 0-1 | Cuando la operación esté sujeta a retención renta, debe contener el monto computado del Impuesto retenido por renta. De no existir renta retenida deberá completar con valor 0.00 |
| EI03 | SaldoFavor | Saldo a Favor | | N | 1-9p2 | 0-1 | Indicará el saldo a favor cuando el contribuyente otros créditos o pagos a favor del receptor, dicho valor se registrará en valor negativo. |
| EI04 | CondicionOperacion | Condiciones de la Operación | | N | 1 | 1-1 | Se debe indicar uno de los siguientes valores:
1 – Contado
2 – A crédito
3 – Otro
Cuando sea el caso de operaciones de manera mixta (parte al crédito y parte al contado) se deberá elegir la opción 3 – Otro. |
| EI05 | NumPagoElectronico | Número de Pago Electrónico | | A | 1-100 | 0-1 | Campo destinado para indicar el número de pago electrónico |
| EI06 | IvaPercibido | IVA percibido | | N | 1-9p2 | 0-1 | Cuando la operación esté sujeta a percepción, debe contener el monto computado del impuesto percibido. De no existir IVA percibido deberá completar con valor 0.00 |
| EI07 | Seguro | Seguro | | N | 1-11p2 | 0-1 | Cuando aplique, se deberá indicar el valor del seguro de la exportación |
| EI08 | Flete | Flete | | N | 1-11p2 | 0-1 | Cuando aplique, se deberá indicar el valor del flete de la exportación |
| EI09 | CodIncoterms | INCOTERMS | | A | 2 | 0-1 | Deberá indicar el código de los términos y condiciones pactadas en la exportación para la entrega de las mercancías. Será requerido cuando el Tipo de ítem (BI10) sea 1 o 3. Ver códigos en Anexo Catálogo de INCOTERMS Valores permitidos
|
| EI10 | DescIncoterms | Descripción INCOTERMS | | A | 1-150 | 0-1 | Deberá colocar la descripción según el catálogo de INCOTERMS. Será requerido cuando el Tipo de ítem (BI10) sea 1 o 3. |
| EI11 | Observaciones | Observaciones | | A | 1-500 | 0-1 | Podrá detallar otra observación que se desee agregar. |
4.3.7Campos que describen las formas de pagoConjunto F
| C | ID | Campo | Descripción | P | T | Tam | Ocu | Observaciones |
|---|---|---|---|---|---|---|---|---|
F | F01 | Payments | Grupo de datos que contiene información sobre las formas de pago de la factura electrónica | R01 | G | | 0-1 | Sección para detallar la modalidad de pago.
Para los documentos 01, 03, 11 y 14 deberá agregarse este nodo si el valor de Condición de la operación (EI04) es 1-contado o 3-otro.
Para el documento 15, deberá agregarse obligatoriamente este nodo si el valor de Tipo de donación (D05) está completado con 1, si contiene los valores 2 o 3 no debe agregarse información sobre las formas de pago. |
F | F02 | Payment | Grupo que describe un pago | F01 | G | | 1-20 | |
F | F021 | Code | Codigo de forma de pago | F02 | A | 2-5 | 1-1 | Código de modalidad de pago. Ver códigos en Anexo Catálogo de codigos de formas de pago Valores permitidos
|
F | F022 | Amount | Valor de la cuota | F02 | N | 1-11p2 | 1-1 | Valor monetario que se aplica con la forma de pago indicada. |
F | F023 | AditionalData | Información adicional | F02 | G | | 0-1 | |
F | F0231 | Info | Elemento que describe la información adicional | F023 | I | | 1-25 | Ver en sección Payments AditionalData |
4.3.7.1Grupo Payments AditionalData
| C | ID | Campo | Descripción | P | T | Tam | Ocu | Observaciones |
|---|---|---|---|---|---|---|---|---|
| FI01 | Referencia | Referencia de modalidad de pago | | A | 1-50 | 0-1 | Deberá contener el número de referencia de cada modalidad de pago detallada. Si la forma de pago es "Billetes y monedas" no se deberá agregar |
| FI02 | Plazo | Plazo de pago | | A | 2 | 0-1 | Cuando sea requerido por el contribuyente, este campo se llenará si en Condición de operación (EI04) se indica la opción 02.
01: Días
02: Meses
03: Años |
| FI03 | Periodo | Período de plazo | | N | 3 | 0-1 | Cuando sea requerido por el contribuyente se llenará si la condición de la operación es al crédito. En este campo se deberá ingresar el número de días, meses o años en que se otorga el plazo. |
| FI04 | NumPagoElectronico | Número de pago electrónico | | A | 1-100 | 0-1 | Campo destinado para indicar el número de pago electrónico cuando exista |
4.3.8Campos que describen información adicional sobre la transacción documentadaConjunto G
| C | ID | Campo | Descripción | P | T | Tam | Ocu | Observaciones |
|---|---|---|---|---|---|---|---|---|
G | G01 | AdditionalDocumentInfo | Grupo de datos que contiene información adicional sobre la factura electrónica | R01 | G | | 0-1 | Si se agregan 2 ocurrencias en el arreglo, la número 2 deberá contener la información de la Adenda Comercial, especificada en la sección de Adenda Comercial |
G | G02 | AdditionalInfo | Grupo que contiene información adicional | G01 | G | | 0-2 | |
G | G03 | AditionalData | Grupo que contiene datos adicionales como información de documentos referenciados y otro tipo de documentos a relacionar | G02 | G | | 0-1 | |
G | G031 | Data | Elemento que contiene datos adicionales sobre documentos, referencias, etc. | G04 | G | | 1-50 | Debe agregarse 1 elemento Data para cada tipo de documento referenciado u otros documentos asociados |
G | G0311 | Name | Tipo de información o referencia | G031 | A | 1-20 | 1-1 | Identificador que indicará a qué tipo de información pertenecerán los datos ingresados en los valores de G0312.
Valores aceptados:
• DOC_RELACIONADO: cuando la información a especificar en G0312 es para Relacionar documentos emitidos anteriormente. Se podrán describir desde 1 hasta 10 documentos relacionados, excepto para el documento 11 – Factura de Exportación, donde se podrán describir desde 1 hasta 20 documentos.
• OTROS_DOC_RELACIONADOS: cuando la información a especificar en G0312 es para indicar documentos asociados (documentos del emisor, receptor, transporte, medico, etc.)
• APENDICE: Para agregar información propia del emisor. Solo debe añadirse una sola vez. |
G | G0312 | Info | Elemento que contiene la información adicional | G031 | I | | 1-5 | Ver en sección Información Adicional Data |
G | G04 | AditionalInfo | Grupo que contiene información adicional | G02 | G | | 0-1 | Si se quiere agregar información sobre forma de pago de la factura |
G | G041 | Info | Elemento que contiene la información adicional | G04 | I | | 1-25 | Ver en sección Información Adicional AditionalInfo |
4.3.8.1Grupo Información Adicional Data
| C | ID | Campo | Descripción | P | T | Tam | Ocu | Observaciones |
|---|---|---|---|---|---|---|---|---|
| GI01 | TipoDocumento | Tipo de documento a relacionado | | A | 2 | 0-1 | Para DOC_RELACIONADO. Cuando aplique, deberá indicar el código del documento relacionado.
Cuando el documento sea 01, solo se podrán referenciar documentos 04 (Nota de remisión) o 09 (Documento contable de liquidación).
Cuando el documento sea 03, solo se podrán referenciar documentos 04 (Nota de remisión), 08 (Comprobante de Liquidación) o 09 (Documento Contable de Liquidación).
Cuando el documento sea 04, solo se podrán referenciar documentos 01 (Factura) o 03 (Comprobante de crédito fiscal)
Cuando el documento sea 05 o 06, solo se podrán referenciar documentos 03 (Comprobante de crédito fiscal) o 07 (Comprobante de retención).
Todos los documentos a referenciar en un documento deben ser del mismo tipo. |
| GI02 | TipoGeneracion | Tipo de generación del DTE relacionado | | N | 1 | 0-1 | Para DOC_RELACIONADO. Cuando aplique, deberá indicar el código del tipo de generación del documento a relacionar.
Valores permitidos:
1: Físico
2: Electrónico |
| GI03 | NumDocumento | Número de documento relacionado | | A | 1-36 | 0-1 | Para DOC_RELACIONADO. Cuando aplique, deberá indicar el número de documento que se está relacionando.
Si el documento relacionado se ha emitido de forma electrónica, se ingresará el código de generación de dicho documento relacionado (UUID Versión 4).
Si el documento relacionado se ha emitido de forma tradicional (Físico-papel) deberá indicar el número de correlativo autorizado del documento (serie + número). |
| GI04 | FechaEmision | Fecha de generación del documento relacionado | | A | 10 | 0-1 | Para DOC_RELACIONADO. Cuando aplique, deberá indicar la fecha en que fue generado el documento que se esté relacionando, independientemente haya sido generado de manera electrónica o física, en formato YYYY-MM-DD (2021-10-27) |
| GI05 | CodigoDocAsociado | Documento asociado | | A | 1 | 0-1 | Para OTROS_DOC_RELACIONADOS. El contribuyente podrá describir cuanto aplique, si el documento asociado corresponde al emisor, al receptor o al médico.
Valores permitidos:
1: Emisor
2: Receptor
3: Médico (solo aplica para contribuyentes obligados a la presentación de F-958)
4: Transporte (solo aplica para facturas de exportación) |
| GI06 | DescDoc | Identificación del documento asociado | | N | 100 | 0-1 | Para OTROS_DOC_RELACIONADOS. El contribuyente podrá describir el nombre del tipo de documento asociado al que hace referencia, (por ejemplo: Resoluciones, Licencias, Permisos, Contratos, Carta de Venta, Otros). Aplicará cuando Documento asociado (GI05) esté lleno con la opción 1 o 2 |
| GI07 | DetalleDoc | Descripción del documento asociado | | A | 1-300 | 0-1 | Para OTROS_DOC_RELACIONADOS. Deberá describir datos importantes del tipo de documento asociado (Ejemplo: El número de resolución, fechas, número de contrato, otros). Aplicará cuando el Documento asociado (GI05) tenga la opción 1 o 2. |
| GI08 | NombreMedico | Nombre de médico que presta el servicio | | A | 1-100 | 0-1 | Para OTROS_DOC_RELACIONADOS. Deberá completarse si Documento asociado (GI05) se ha completado con la opción 3 – médico. Cuando aplique deberá detallar el nombre del médico que intervino. |
| GI09 | Nit | NIT de médico que presta el servicio | | A | 9-14 | 0-1 | Para OTROS_DOC_RELACIONADOS. Deberá completarse si Documento asociado (GI05) se ha completado con la opción 3 – médico. Cuando aplique deberá detallar el NIT del médico que intervino en bienes y/o servicios prestados. El NIT debe estar sin guiones |
| GI10 | DocIdentificacion | Documento de identificación de médico no domiciliado | | A | 1-25 | 0-1 | Para OTROS_DOC_RELACIONADOS. Deberá completarse si Documento asociado (GI05) se ha completado con la opción 3 – médico. Cuando aplique deberá detallar el documento con el que se identifique el médico no domiciliado. |
| GI11 | TipoServicio | Código del servicio realizado | | A | 1 | 0-1 | Para OTROS_DOC_RELACIONADOS. Deberá completarse si Documento asociado (GI05) se ha completado con la opción 3 – médico. Cuando aplique deberá detallar el código según aplique con uno de los siguientes valores permitidos:
1: Cirugía
2: Operación
3: Tratamiento médico
4: Cirugía instituto Salvadoreño de Bienestar Magisterial
5: Operación Instituto Salvadoreño de Bienestar Magisterial
6: Tratamiento médico Instituto Salvadoreño de Bienestar Magisterial |
| GI12 | ModoTransporte | Modo de transporte | | N | 1 | 0-1 | Para OTROS_DOC_RELACIONADOS. Deberá completarse si Documento asociado (GI05) se ha completado con la opción 4 – Transporte. Se deberá ingresar el tipo de transporte utilizado en la exportación, valores posibles:
1: Terrestre
2: Aéreo
3: Marítimo
4: Férreo
5: Multimodal
6: Correo |
| GI13 | PlacaTransporte | Número de identificación del transporte | | A | 5-70 | 0-1 | Para OTROS_DOC_RELACIONADOS. Deberá completarse si Documento asociado (GI05) se ha completado con la opción 4 – Transporte. Se deberá ingresar el número de identificación del medio de transporte utilizado en la exportación |
| GI14 | NumeroConductor | No. de identificación del conductor | | A | 5-100 | 0-1 | Para OTROS_DOC_RELACIONADOS. Deberá completarse si Documento asociado (GI05) se ha completado con la opción 4 – Transporte. Se deberá ingresar el número de identificación del conductor del transporte |
| GI15 | NombreConductor | Nombre y apellidos del conductor | | A | 5-100 | 0-1 | Para OTROS_DOC_RELACIONADOS. Deberá completarse si Documento asociado (GI05) se ha completado con la opción 4 – Transporte. Se deberá escribir el nombre y apellidos del conductor del medio de transporte |
| GI16 | <cualquier valor> | Informacion propia del emisor | | A | 1-25 | 0-10 | Para APENDICE. Cuando pertenezca al grupo que contiene como nombre APENDICE, un nombre que deberá indicar cualquier información que el emisor considere. Deberá ingresar una descripción y un valor asociado al nombre del campo, agregando los siguientes atributos como conjunto
Name: Nombre del campo
Data: Descripcion del campo
Value: Valor o dato del campo
Por ejemplo: si se quiere agregar información sobre el vendedor que emitió la factura y alguna otra información adicional
{
"Name": "APENDICE"
"Info": [
{ "Name": "Vendedor", "Data": "Encargado de atender", "Value": "Lionel Messi" },
{ "Name": "Nombre de la info adicional", "Data": "Descripcion de la informacion", "Value": "valor de la informacion" }
]
} |
4.3.8.2Grupo Información Adicional AditionalInfo
| C | ID | Campo | Descripción | P | T | Tam | Ocu | Observaciones |
|---|---|---|---|---|---|---|---|---|
| GI20 | NitTercero | NIT del tercero | | A | 9-14 | 0-1 | Venta a Tercero. Deberá contener el NIT del tercero, cuando se realice una venta a cuenta de terceros. El NIT deberá ingresarse sin guiones. |
| GI21 | NombreTercero | Nombre del tercero | | A | 1-250 | 0-1 | Venta a Tercero. Deberá agregarse el nombre, denominación o razón social del tercero. |
| GI22 | NombreEntrega | Nombre del responsable que genera el DTE | | A | 1-100 | 0-1 | Nombre de la persona que entrega el documento electrónico. |
| GI23 | DocuEntrega | Documento de identificación de quien genera el DTE | | A | 1-25 | 0-1 | Documento de identificación de quien entrega el documento |
| GI24 | NombreRecibe | Nombre del responsable de la operación por parte del receptor | | A | 1-100 | 0-1 | Podrá ingresar el nombre de la persona encargada del área de recepción de los documentos electrónicos por parte del receptor o persona designada por el receptor |
| GI25 | DocuRecibe | Documento de identificación de responsable de la operación por parte del receptor | | A | 1-25 | 0-1 | Podrá ingresar el documento de identificación del responsable designado por el receptor |
| GI27 | Observaciones | Observaciones | | A | 1-3000 | 0-1 | Queda a disposición de cualquier otra observación que el emisor desee colocar |
| GI28 | PlacaVehiculo | Placa de vehículo | | A | 1-10 | 0-1 | Deberá colocar el número de placa del vehículo del receptor. Aplica para aquellos contribuyentes emisores que se dediquen a Venta de combustibles, lubricantes y otros (Gasolineras) |
| GI29 | CodigoEmpleado | Código de empleado responsable de la liquidación | | A | 1-15 | 0-1 | Podrá indicar el código del responsable de efectuar la liquidación a los afiliados |
4.3.9Información Adenda ComercialConjunto GA
La Adenda es un apartado que permite a los diferentes emisores agregar aspectos comerciales o de control interno. Dicha información contempla algunos datos comerciales que pueden ser de utilidad, como por ejemplo, detalles adicionales por ítem, manejo de referencias internas, y la aplicación de algunas validaciones a los elementos incluidos. Esta información a agregar es opcional. Debe agregarse en un elemento AdditionalInfo (G02), adicional al que ya se menciona anteriormente.
| C | ID | Campo | Descripción | P | T | Tam | Ocu | Observaciones |
|---|---|---|---|---|---|---|---|---|
G | G01 | AdditionalDocumentInfo | Grupo de datos que contiene información adicional sobre la factura electrónica | R01 | G | | 0-1 | |
GA | GA01 | AdditionalInfo | Grupo que contiene información adicional | G01 | G | | 1-2 | Si se agregan 2 ocurrencias, la número 2 deberá contener la información de la Adenda Comercial |
GA | GA02 | Code | Código o número de referencia interna | GA01 | A | 2-500 | 1-1 | Identificador o número interno con el que se desea hacer referencia al documento emitido. Acepta únicamente números, letras y los siguientes símbolos:
Punto .
Guión bajo _
Símbolo de dólar $
Diagonal /
Numeral #
Paréntesis izq (
Paréntesis der )
Arroba @ |
GA | GA03 | Type | Tipo de información | GA01 | A | 5-10 | 1-1 | Corresponde al tipo de información que se agregará. Único valor permitido: ADENDA |
GA | GA04 | AditionalData | Grupo que contiene datos adicionales | GA01 | G | | 0-1 | |
GA | GA041 | Data | Elemento que contiene datos adicionales sobre documentos, referencias, etc. | GA04 | G | | 1-50 | Este elemento contiene un atributo llamado "Name", que únicamente será utilizado al Momento de agregar información sobre la Adenda. |
GA | GA0411 | Name | Tipo de información | GA041 | A | 1-20 | 1-1 | Los valores que puede tomar el atributo Name son:
INFORMACIÓN_ADICIONAL: para asociar que la información a agregar será información adicional.
DetallesAux_Detalle: Para agregar detalles Auxiliares a los ítems de la factura.
De manera que si se desea agregar información adicional, este elemento debe quedar así
"Data": [
{
"Name": "INFORMACION_ADICIONAL",
"Info": [ { "Name": "", "Data": "", "Value": "" } ]
},
{ .... }
] |
GA | GA0412 | Info | Elemento que contiene la información adicional | GA041 | I | | 1-25 | Ver en sección Información Adicional Data en Adenda |
GA | GA05 | AditionalInfo | Grupo que contiene información adicional | G02 | G | | 1-1 | |
GA | GA051 | Info | Elemento que contiene la información adicional | G05 | I | | 1-25 | Ver en sección Información Adicional AditionalInfo en Adenda |
4.3.9.1Grupo Información Adicional Data en Adenda
| C | ID | Campo | Descripción | P | T | Tam | Ocu | Observaciones |
|---|---|---|---|---|---|---|---|---|
| GIA01 | NumeroLinea | Indica el número de línea (ítem) al cual se estará haciendo referencia de la información adicional | | A | 2-100 | 1-1 | Válido únicamente para "DetallesAux_Detalle" |
| GIA02 | Descripcion_Adicional | Descripción adicional para el ítem | | A | 1-200 | 1-1 | Válido únicamente para "DetallesAux_Detalle". Si no se desea agregar información, colocar "-" |
| GIA03 | CodigoEAN | Código adicional del producto o ítem | | A | 1-50 | 1-1 | Válido únicamente para "DetallesAux_Detalle". Si no se desea agregar información, colocar "-" |
| GIA04 | CategoriaAdicional | Categoría adicional a la que pertenece el ítem | | A | 1-50 | 1-1 | Válido únicamente para "DetallesAux_Detalle". Si no se desea agregar información, colocar "-" |
| GIA05 | Textos | Textos adicionales relacionados al item | | A | 1-60 | 0-10 | Válido únicamente para "DetallesAux_Detalle" |
| GIA06 | <cualquier nombre> | Cualquier identificador | | A | 1-50 | 1-50 | Válido únicamente para "INFORMACION_ADICIONAL". Puede agregarse cualquier nombre y asignarle el valor que quede a criterio del emisor. Con el fin de que pueda agregarse información a conveniencia |
4.3.9.2Grupo Información Adicional AditionalInfo en Adenda
| C | ID | Campo | Descripción | P | T | Tam | Ocu | Observaciones |
|---|---|---|---|---|---|---|---|---|
| GIB01 | VALIDAR_REFERENCIA | Validar referencia interna | | A | 1-10 | 1-1 | Valor que indicará si se desea validar la Referencia Interna y verificar que no sea un documento duplicado. Valores esperados:
VALIDAR
NO_VALIDAR |
| GIB02 | VERSION | Versión de la adenda | | A | 1-20 | 1-1 | Valor que indica la versión de la adenda que manejará el emisor, este dato debe ser obligatorio |
5Respuesta de la API
Al enviar el contenido del NUC (en XML), 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 NUC del DTE 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 |
responseData4 | Texto codificado en base64 que contiene el JSON del documento certificado |
authNumber | código de generación único de la factura electrónica. En el caso de enviar un documento con código de generación o número de control que ya ha sido utilizado por un documento previo, caso conocido como envío de un documento duplicado, este campo mostrará el código de generación perteneciente al primer documento emitido, haciendo relación al que contiene dicho código de generación o número de control. |
url | Contiene el enlace para consultar el DTE emitido en el Ministerio 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 | número de serie de la factura, atributo sin valor por el momento |
serial | Contiene el número de control del documento |
issuedTimeStamp | fecha de emisión de la factura electrónica |
taxID | NIT del contribuyente emisor de la factura |
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 | NIT o 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. Puede contener como atributos los siguientes valores: selloRecepcion: contiene el sello de recibido otorgado por el Ministerio de Hacienda |
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 "mensaje". |
0 | Error en el contenido del JSON NUC. Este tipo de error se mostrará si en el proceso de transformar el NUC a la factura electrónica nativa surge un error. Se indicará en los atributos "mensaje" y "descripción" el detalle y la descripción del error informado, indicando donde se encuentra el error y la referencia hacia esta documentación. |
1 | Consulta realizada correctamente. |
400 | Error en realizar la consulta. Se mostrará en los atributos "message" y "description" la descripción del error. |
500 | Error inesperado. Se mostrara el contenido del error en los atributos "message" y "description". |
3010 | Error en el Schema del 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, NIT del emisor incorrecto, entre otros. Se indicará el error en los atributos "message", "description" y dependiendo del caso "infoDetails". |
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 |