NUC JSON V2.0.8 — Panamá

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.
`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 schema contenido en esta ficha técnica
O	Objeto JSON, grupo de atributos
C	Coordenada geográfica: Siguiendo las definiciones del anexo H del estándar ISO 6709, estos campos deberán contener grados decimales, sin la altura del punto medido. Las latitudes al norte de la línea del Ecuador deben ser designadas por la señal de positivo (+), y las latitudes al sur de aquella línea deben ser designadas por la señal de negativo (-). El formato a seguir será DD.DDDD, siendo que los dos primeros dígitos expresan grados de 00 a 89, y los dos últimos dígitos representan fracciones decimales de grados, de 000 a 999. Las longitudes al este del primer meridiano deben ser designadas por la señal de positivo (+), y las latitudes al oeste de aquella línea deben ser designadas por la señal de negativo (-). El formato a seguir será DDD.DDDD, siendo que los dos primeros dígitos expresan grados de 000 a 179, y los dos últimos dígitos representan fracciones decimales de grados, de 000 a 999. Por ejemplo, la coordinada 8.9539 norte y 79.5343 oeste, correspondientes al Palacio de las Garzas en la Ciudad de Panamá, será informada de la siguiente manera: +08.9539,-79.5343
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 -5 (hora de Panamá): 2017-04-17T14:23:00-05:00
L	Arreglo o Lista: Atributo de tipo arreglo que puede contener "n" cantidad de objetos
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: { "Name": "", "Data": "", "Value": "" }. Ejemplo: Se tiene que la Naturaleza de la operación de la factura es 01. Por lo que la información a agregar sería de la siguiente manera: { "Name": "NaturalezaOperacion", "Data": null, "Value": "01" }

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 contienen información sobre terceros
`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.

4.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	`1p2`	1-1	Control de versiones. Valor a ingresar: 1.00
`R`	`R03`	`CountryCode`	Código del país donde pertenece la factura electrónica a generar	`R01`	A	`2`	1-1	PA: Panamá

4.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 de Operación Interna; 02: Factura de Importación; 03: Factura de Exportación; 04: Nota de Crédito Referente a una o Varias FE; 05: Nota de Débito Referente a una o Varias FE; 06: Nota de Crédito Genérica; 07: Nota de Débito Genérica; 08: Factura de Zona Franca; 09: Reembolso; 10: Factura de Operación Extranjera. Si no se ingresa uno de estos valores, no se podrá generar la Factura Electrónica. Valores permitidos `01` · Factura de Operación Interna `02` · Factura de Importación `03` · Factura de Exportación `04` · Nota de Crédito Referente a una o Varias FE `05` · Nota de Débito Referente a una o Varias FE `06` · Nota de Crédito Genérica `07` · Nota de Débito Genérica `08` · Factura de Zona Franca `09` · Reembolso `10` · Factura de Operación Extranjera
`A`	`A03`	`IssuedDateTime`	Fecha y hora de emisión	`A01`	F	`25`	1-1
`A`	`A04`	`AdditionalIssueType`	Ambiente de destino	`A01`	N	`1`	1-1	1: Producción; 2: Pruebas Valores permitidos `1` · Producción `2` · Pruebas
`A`	`A05`	`ExchangeRate`	Tipo de cambio de la moneda de la operación	`A01`	N	`1-11p2-4`	0-1	Utilizar únicamente si la moneda de la operación (A06) es diferente del USD. Obligatorio si existe A06 y la factura es de exportación.
`A`	`A06`	`Currency`	Moneda de la operación	`A01`	A	`3`	0-1	De acuerdo con los códigos según la norma ISO 4217. Ver en anexos Monedas para Operaciones Internacionales. Ver catálogo oficial ↗
`A`	`A07`	`AdditionalIssueDocInfo`	Grupo que contiene información general adicional de la factura electrónica	`A01`	L		1-1
`A`	`A071`	`Info`	Elemento que describe la información adicional	`A07`	I		1-25	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 emisión es 01 quedaría así { "Name": "TipoEmision", "Value": "01" }

4.4.2.1Grupo AdditionalIssueDocInfo

ID	Campo	Descripción	T	Tam	Ocu	Observaciones
`AI01`	`TipoEmision`	Tipo de emisión	A	`2`	1-1	01: Autorización de Uso Previa, operación normal; 02: Autorización de Uso Previa, operación en contingencia; 03: Autorización de Uso Posterior, operación normal; 04: Autorización de Uso posterior, operación en contingencia. Ejemplo: { "Name": "TipoEmision", "Value": "02" } Valores permitidos `01` · Autorización de Uso Previa, operación normal `02` · Autorización de Uso Previa, operación en contingencia `03` · Autorización de Uso Posterior, operación normal `04` · Autorización de Uso posterior, operación en contingencia
`AI02`	`FechaContingencia`	Fecha y hora de inicio de la operación en contingencia	F	`25`	0-1	Obligatorio si AI01 = 02 y/o 04
`AI03`	`MotivoContingencia`	Razón de la operación en contingencia	A	`15-250`	0-1	Obligatorio si AI01 = 02 y/o 04. Si la contingencia dura más de 72 horas también debe explicar las razones para no haber regresado a la operación normal
`AI04`	`NumeroDF`	Número del documento fiscal en la serie correspondiente, de 0000000001 a 9999999999, no siendo permitido el reinicio de la numeración.	A	`10`	1-1	Llenar con ceros las posiciones a la izquierda
`AI05`	`PtoFactDF`	Punto de facturación del documento fiscal. La serie sirve para permitir que existan secuencias independientes de numeración de facturas, con diversas finalidades, sea por libre elección del emisor, tales como puntos de facturación distintos (como cajas de un supermercado, o bodegas de un distribuidor), tipos de productos, especies de operación, etc., sea para finalidades que vengan a ser determinadas por la DGI	A	`3`	1-1	No se admite el valor "cero". Llenar con ceros las posiciones a la izquierda. Sólo se deben colocar números y se define Alfanumérico porque debe ser rellenado con ceros (0) a la izquierda
`AI06`	`CodigoSeguridad`	Código de seguridad	A	`9`	1-1	Número aleatorio entre 000,000,001 y 999,999,999, que integra el CUFE y tiene por objetivo asegurar la privacidad de las FE emitidas. No se admite el valor "000,000,000", ni que sea igual al campo AI04. Llenar con ceros las posiciones a la izquierda
`AI07`	`FechaSalida`	Fecha de salida estimada de las mercancías	F	`25`	0-1	Informar cuando sea conocida
`AI08`	`NaturalezaOperacion`	Naturaleza de la operación	N	`2`	1-1	01: Venta; 02: Exportación; 03: Re-exportación; 04: Venta de fuente extranjera; 05: Servicio de Fuente Extranjera; 10: Transferencia/Traspaso; 11: Devolución; 12: Consignación; 13: Remesa; 14: Entrega gratuita; 20: Compra; 21: Importación Valores permitidos `01` · Venta `02` · Exportación `03` · Re-exportación `04` · Venta de fuente extranjera `05` · Servicio de Fuente Extranjera `10` · Transferencia/Traspaso `11` · Devolución `12` · Consignación `13` · Remesa `14` · Entrega gratuita `20` · Compra `21` · Importación
`AI09`	`TipoOperacion`	Tipo de la operación	N	`1`	1-1	1: Salida o venta; 2: Entrada o compra (factura de compra- para comercio informal. Ej.: taxista, trabajadores manuales) Valores permitidos `1` · Salida o venta `2` · Entrada o compra (factura de compra- para comercio informal. Ej.: taxista, trabajadores manuales)
`AI10`	`DestinoOperacion`	Destino de la operación	N	`1`	1-1	1: Panamá; 2: Extranjero Valores permitidos `1` · Panamá `2` · Extranjero
`AI11`	`FormatoGeneracion`	Formato de generación del CAFE	N	`1`	1-1	1: Sin generación de CAFÉ; 2: Cinta de papel; 3: Papel formato carta Valores permitidos `1` · Sin generación de CAFÉ `2` · Cinta de papel `3` · Papel formato carta
`AI12`	`ManeraEntrega`	Manera de entrega del CAFE al receptor	N	`1`	1-1	1: Sin generación de CAFE; 2: CAFE entregado para el receptor en papel; 3: CAFE enviado para el receptor en formato electrónico. Valores permitidos `1` · Sin generación de CAFE `2` · CAFE entregado para el receptor en papel `3` · CAFE enviado para el receptor en formato electrónico
`AI13`	`EnvioContenedor`	Envío del contenedor para el receptor	N	`1`	1-1	1: normal; 2: El receptor exceptúa al emisor de la obligatoriedad del envío del contenedor Valores permitidos `1` · normal `2` · El receptor exceptúa al emisor de la obligatoriedad del envío del contenedor
`AI14`	`ProcesoGeneracion`	Proceso de generación de la FE	N	`1`	1-1	1: Generación por el sistema de facturación del contribuyente (desarrollo propio o producto adquirido); 2: Generación por tercero contratado; 3: Generación gratuita por tercero proveedor de solución; 4: Generación gratuita por la DIRECCIÓN GENERAL DE INGRESOS en página web Valores permitidos `1` · Generación por el sistema de facturación del contribuyente (desarrollo propio o producto adquirido) `2` · Generación por tercero contratado `3` · Generación gratuita por tercero proveedor de solución `4` · Generación gratuita por la DIRECCIÓN GENERAL DE INGRESOS en página web
`AI15`	`TipoTransaccion`	Tipo de transacción de venta	N	`1`	0-1	Tipo de Venta para el vendedor: 1: Venta de Giro del negocio; 2: Venta Activo Fijo; 3: Venta de Bienes Raíces; 4: Prestación de Servicio. Si no es venta, no informar este campo Valores permitidos `1` · Venta de Giro del negocio `2` · Venta Activo Fijo `3` · Venta de Bienes Raíces `4` · Prestación de Servicio
`AI16`	`TipoSucursal`	Tipo de sucursal	N	`1`	0-1	1: Mayor cantidad de Operaciones venta al detal (retail); 2: Mayor cantidad de Operaciones venta al por mayor Valores permitidos `1` · Mayor cantidad de Operaciones venta al detal (retail) `2` · Mayor cantidad de Operaciones venta al por mayor
`AI17`	`InfoInteres`	Información de interés del emisor con respecto a la FE	A	`0-5000`	0-1

4.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 de la factura electrónica	`R01`	O		1-1
`B`	`B02`	`TaxID`	Identificador tributario o Ruc del emisor	`B01`	A	`20`	1-1	RUC del emisor
`B`	`B03`	`TaxIDType`	Tipo de contribuyente	`B01`	N	`1`	1-1	Tipo de Contribuyente: 1: Natural, 2: Jurídico Valores permitidos `1` · Natural `2` · Jurídico
`B`	`B04`	`TaxIDAdditionalInfo`	Elemento que contiene información tributaria adicional del emisor	`B01`	L	`25`	1-1
`B`	`B041`	`Info`	Elemento que describe la información adicional	`B04`	I		1-25	Ver en sección Emisor TaxIDAdditionalInfo
`B`	`B05`	`Name`	Razón social (Persona Jurídica) o Nombre y Apellido (Persona Natural) del emisor de la FE	`B01`	A	`2-200`	1-1	Si A05 = 2, debe contener obligatoriamente el literal "FE generada en ambiente de pruebas - sin valor comercial ni fiscal"
`B`	`B06`	`Contact`	Información de contacto del emisor	`B01`	O		1-1
`B`	`B061`	`PhoneList`	Lista de números telefónicos	`B06`	O		1-1
`B`	`B0611`	`Phone`	Número telefónico	`B061`	L	`7-12`	1-3	Formatos aceptables: 999-9999, 9999-9999, 999999-999-9999 o 999999-9999-9999
`B`	`B062`	`EmailList`	Lista de correos electrónicos	`B06`	O		0-1
`B`	`B0621`	`Email`	Correo electrónico	`B062`	L	`50`	0-3	Correo válido
`B`	`B07`	`BranchInfo`	Información sobre el establecimiento del emisor	`B01`	O		1-1
`B`	`B071`	`Code`	Código relacionado al establecimiento del emisor	`B07`	A	`4`	1-1	0000: casa matriz; 0001 en delante: otras sucursales. Puede utilizar números y letras
`B`	`B072`	`AddressInfo`	Información de la dirección del establecimiento del emisor	`B07`	O		1-1
`B`	`B0721`	`Address`	Dirección de la ubicación	`B072`	A	`100`	1-1	Urbanización, Calle, Casa/Edificio, Número de Local
`B`	`B0722`	`City`	Ciudad o corregimiento donde se encuentra la dirección	`B072`	A	`50`	1-1	Debe corresponder al catálogo de Corregimientos según el Catálogo Unificado de provincias, distritos y corregimientos. Ver catálogo oficial ↗
`B`	`B0723`	`District`	Distrito donde se encuentra la ciudad	`B072`	A	`50`	1-1	Debe corresponder al catálogo de distritos según el Catálogo Unificado de provincias, distritos y corregimientos. Ver catálogo oficial ↗
`B`	`B0724`	`State`	Estado o provincia donde se encuentra el distrito	`B072`	A	`50`	1-1	Debe corresponder al catálogo de provincias según el Catálogo Unificado de provincias, distritos y corregimientos. Ver catálogo oficial ↗
`B`	`B0725`	`Country`	País donde se encuentra el estado	`B072`	A	`50`	1-1
`B`	`B073`	`AdditionalBranchInfo`	Información adicional sobre el establecimiento del emisor	`B07`	L		1-1
`B`	`B0731`	`Info`	Elemento que describe la información adicional	`B04`	I		1-25	Ver en sección Emisor AdditionalBranchInfo

4.4.3.1Grupo Emisor TaxIDAdditionalInfo

C	ID	Campo	Descripción	P	T	Tam	Ocu	Observaciones
	`BI01`	`DigitoVerificador`	Dígito Verificador Ruc Emisor		A	`2`	1-1	Debe ser calculado en base al algoritmo del RUC publicado por la DGI.

4.4.3.2Grupo Emisor AdditionalBranchInfo

C	ID	Campo	Descripción	P	T	Tam	Ocu	Observaciones
	`BI02`	`CoordEm`	Información geográfica de la sucursal donde se ubica el punto de facturación.		C	`22`	1-1	Debe corresponder a una sucursal identificada
	`BI03`	`CodUbi`	Código de provincia, distrito y corregimiento		A	`8`	1-1	Código compuesto de la ubicación. De acuerdo al Catálogo Unificado de provincias, distritos y corregimientos. Ver catálogo oficial ↗

4.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 de la factura electrónica	`R01`	O		1-1
`C`	`C02`	`TaxID`	Identificador tributario o Ruc del receptor	`C01`	A	`20`	1-1	Ruc del receptor. En caso de que el receptor CI01 sea 02 (Consumidor Final) colocar en este campo "CF". En el caso de que el tipo de receptor CI01 sea 04 (Extranjero) colocar en este campo "EXTRANJERO"
`C`	`C03`	`TaxIDType`	Tipo de contribuyente receptor	`C01`	N	`1`	0-1	Tipo de Contribuyente: 1: Natural, 2: Jurídico. Obligatorio cuando el tipo de receptor CI01 sea 01 y 03 Valores permitidos `1` · Natural `2` · Jurídico
`C`	`C04`	`TaxIDAdditionalInfo`	Elemento que contiene información tributaria adicional del receptor	`C01`	L	`25`	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`	Razón social o Nombre y Apellido del receptor de la FE	`C01`	A	`2-200`	0-1	Es obligatorio y debe ser válido si "Tipo Receptor" CI01 es 01 o 03 (comprador contribuyente del ITBMS)
`C`	`C07`	`Contact`	Información de contacto del receptor	`C01`	O		0-1
`C`	`C071`	`PhoneList`	Lista de números telefónicos	`C07`	O		0-1
`C`	`C0711`	`Phone`	Número telefónico	`C071`	L	`7-12`	0-3	Formatos aceptables: 999-9999, 9999-9999, 999999-999-9999 o 999999-9999-9999
`C`	`C072`	`EmailList`	Lista de correos electrónicos	`C07`	O		0-1
`C`	`C0721`	`Email`	Correo electrónico	`C072`	L	`100`	0-3	Correo válido
`C`	`C06`	`AdditionlInfo`	Información adicional del receptor	`C01`	L		1-1
`C`	`C061`	`Info`	Elemento que describe la información adicional del receptor	`C06`	I		1-25	Ver en sección Receptor AdditionlInfo
`C`	`C08`	`AddressInfo`	Información de la dirección del receptor	`C01`	O		0-1	Es obligatorio y debe ser válido si CI01 es 01 o 03.
`C`	`C081`	`Address`	Dirección de la ubicación	`C08`	A	`100`	0-1	Urbanización, Calle, Casa/Edificio, Número de Local
`C`	`C082`	`City`	Ciudad o corregimiento donde se encuentra la dirección	`C08`	A	`50`	1-1	Debe corresponder al catálogo de Corregimientos según el Catálogo Unificado de provincias, distritos y corregimientos. Ver catálogo oficial ↗
`C`	`C083`	`District`	Distrito donde se encuentra la ciudad	`C08`	A	`50`	1-1	Debe corresponder al catálogo de distritos según el Catálogo Unificado de provincias, distritos y corregimientos. Ver catálogo oficial ↗
`C`	`C084`	`State`	Estado o provincia donde se encuentra el distrito	`C08`	A	`50`	1-1	Debe corresponder al catálogo de provincias según el Catálogo Unificado de provincias, distritos y corregimientos. Ver catálogo oficial ↗
`C`	`C085`	`Country`	País donde se encuentra el estado	`C08`	A	`50`	1-1

4.4.4.1Grupo Receptor TaxIDAdditionalInfo

ID	Campo	Descripción	T	Tam	Ocu	Observaciones
`CI01`	`TipoReceptor`	Tipo de receptor de la FE	A	`2`	1-1	01: Contribuyente; 02: Consumidor final; 03: Gobierno; 04: Extranjero. Si el tipo de documento (A02) es 10 – Factura de operación extranjera, debe colocar obligatoriamente tipo de receptor extranjero 04. Valores permitidos `01` · Contribuyente `02` · Consumidor final `03` · Gobierno `04` · Extranjero (Si el tipo de documento (A02) es 10 – Factura de operación extranjera, debe colocar obligatoriamente tipo de receptor extranjero 04.)
`CI02`	`DigitoVerificador`	Dígito Verificador Ruc Emisor	A	`2`	0-1	Debe ser calculado en base al algoritmo del RUC publicado por la DGI. Es obligatorio y debe ser válido si CI01 es 01 o 03.
`CI03`	`CedulaCF`	Cédula de identificación del ciudadano	A	`20`	0-1	Si el Tipo de receptor CI01 es 02 se puede agregar este campo.
`CI04`	`CodUbi`	Código de provincia, distrito y corregimiento	A	`8`	0-1	Código compuesto de la ubicación. Obligatorio si se agrega información sobre la dirección del receptor (C08) Ver catálogo oficial ↗
`CI05`	`NumIdTE`	Número de identificación tributaria extranjera	A	`1-50`	0-1	Es obligatorio si el Tipo de receptor CI01 es 04. Si se agrega este valor no informar sobre CI06.
`CI06`	`NumPasaporte`	Número de pasaporte	A	`1-50`	0-1	Es obligatorio si el Tipo de receptor CI01 es 04. Si se agrega este valor no informar sobre CI05.
`CI07`	`PaisExt`	País extranjero	A	`2-100`	0-1	Obligatorio informar solo si se ingresa CI06

4.4.4.2Grupo Receptor AdditionlInfo

C	ID	Campo	Descripción	P	T	Tam	Ocu	Observaciones
	`CI08`	`PaisReceptorFE`	País receptor de la FE		A	`2`	1-1	De acuerdo con los códigos de la Tabla xx. Debe ser PA (Panamá) si AI10=1 (destino u origen de la operación es Panamá). No puede ser PA (Panamá) si AI10=2 (el destino de la operación es otro país) Ver catálogo oficial ↗
	`CI09`	`PaisRecDesc`	País del receptor de la FE no existente en la tabla xx		A	`5-50`	0-1	Obligatorio si CI08 = ZZ. Si CI08 es diferente de ZZ, no debe agregarse dicho campo.

4.4.5Campos que contienen información sobre tercerosConjunto D

C	ID	Campo	Descripción	P	T	Tam	Ocu	Observaciones
`D`	`D01`	`ThirdParties`	Grupo de datos que identifican al autorizado a descargar la FE	`R01`	L		0-1	Identifica personas naturales o jurídicas que, por deseo del emisor, podrán tener acceso irrestricto a esta FE
`D`	`D02`	`ThirdParty`	Información sobre tercero	`D01`	O		1-10
`D`	`D03`	`TaxID`	Ruc autorizado a descargar	`D02`	A	`20`	1-1	RUC autorizado a descargar la FE. Ejemplo: Caso: La empresas desea darle acceso a su firma de contadores o a un tercero
`D`	`D04`	`TaxIDType`	Tipo de contribuyente	`D02`	A	`1`	1-1	Tipo de Contribuyente: 1: Natural, 2: Jurídico Valores permitidos `1` · Natural `2` · Jurídico
`D`	`D05`	`TaxIDAdditionalInfo`	Información adicional	`D02`	L		1-1
`D`	`D06`	`Info`	Elemento que describe la información adicional	`D05`	I		1-25	Ver en sección Tercero TaxIDAdditionalInfo

4.4.5.1Grupo Tercero TaxIDAdditionalInfo

C	ID	Campo	Descripción	P	T	Tam	Ocu	Observaciones
	`DI01`	`DigitoVerificador`	Dígito Verificador Ruc Autorizado		A	`2`	1-1	Debe ser calculado en base al algoritmo del RUC publicado por la DGI.

4.4.6Campos 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`	L		1-1
`E`	`E02`	`Item`	Grupo de datos que especifica cada detalle del ítem	`E01`	O		1-1000	Ver observación en el campo EI17 (grupo de detalle de vehículos nuevos). En caso de que la factura sea sobre un vehículo nuevo, ésta deberá contener solamente un ítem que especifique el vehículo nuevo.
`E`	`E03`	`Codes`	Información relacionada a códigos del ítem	`E02`	L		0-1
`E`	`E031`	`Code`	Elemento que describe la información adicional	`E03`	I	`1`	1-25	Ver en sección Ítem Codes
`E`	`E04`	`Description`	Descripción del producto o servicio	`E02`	A	`2-500`	1-1
`E`	`E05`	`Qty`	Cantidad del producto o servicio, en la unidad de medida	`E02`	N	`1-11p0-6`	1-1	Expresado en la unidad de medida del código interno
`E`	`E06`	`UnitOfMeasure`	Unidad de medida del código interno	`E02`	A	`1-20`	0-1	Debe corresponder al Catálogo de Unidades de Medida Ver catálogo oficial ↗
`E`	`E07`	`Price`	Precio unitario de la transferencia del bien o servicio	`E02`	N	`1-9p2-6`	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	El descuento total será el monto ingresado en el campo E0811. El descuento total debe ser menor que E07 (precio unitario)
`E`	`E081`	`Discount`	Elemento que describe un descuento	`E08`	L		1-1
`E`	`E0811`	`Amount`	Descuento por precio unitario del ítem	`E081`	N	`1-9p2-6`	1-1	Informar valor del descuento en Balboas, no en porcentaje. Si no posee descuento, no informar este campo. El valor informado debe ser menor que E07 (precio unitario)
`E`	`E09`	`Taxes`	Información relacionada a impuestos aplicados al ítem	`E02`	O		1-1	El total de impuestos será la suma de todas las ocurrencias de E0914
`E`	`E091`	`Tax`	Elemento que describe un impuesto	`E09`	L		1-15	Obligatorio incluir impuesto ITBMS. En caso de ISC, no informar si el ítem no es gravado por el ISC. En el caso de OTI, solo informar si el ítem incluye el cobro de sus posibles valores
`E`	`E0911`	`Code`	Tipo de tasa y/o impuesto a aplicar	`E091`	A	`2`	0-1	Obligatorio informar cuando el impuesto sea ITBMS u OTI (Otras Tasas o Impuestos). Si es ITBMS: 00: 0% (excento); 01: 7%; 02: 10%; 03: 15%. Si es OTI: 01: SUME 911; 02: Tasa Portabilidad Numérica; 03: Impuesto sobre seguro (5%); 04: ATTT-Impuestos sobre seguro autos (1%); 05: Tasa Salida Aeropuerto (FZ); 06: Cargo Incentivo Desarrollo Aeropuerto (F3); 07: Cargo Seguridad Aeropuerto (AH); 08: Otros Cargos (XT); 09: Combustible (YQ); 10: FECI; 11: Intereses Valores permitidos `00` · 0% (excento) `01` · 7% `02` · 10% `03` · 15%
`E`	`E0912`	`Description`	Tipo de impuesto a aplicar	`E091`	A	`3-5`	1-1	Nombre del impuesto: ITMBS, ISC, OTI Valores permitidos `ITMBS` · Impuesto de Transferencia de Bienes Muebles y Servicios (Nombre del impuesto según la tabla del campo E0912 del PDF (sic: "ITMBS").) `ISC` · Impuesto Selectivo al Consumo `OTI` · Otras Tasas o Impuestos
`E`	`E0913`	`Rate`	Tasa aplicable	`E091`	N	`1-11p2-6`	0-1	Válido y opcional cuando es impuesto ISC, puede agregarse la tasa si se quiere indicar. Si no puede solo indicarse el monto correspondiente al impuesto a aplicar. Por ejemplo, si la tasa aplicable es del 5%, colocar 0.05. Si la tasa aplicable es del 15% colocar 0.15
`E`	`E0914`	`Amount`	Monto resultante de aplicar el impuesto por el total del ítem.	`E091`	N	`1-9p2-6`	1-1	Si es ISC y existe E0913, se debe hacer el producto del total del ítem E05 * (E07-descuentos). De lo contrario indicar únicamente el monto. Si es ITBMS, producto del total del ítem y la tasa porcentual correspondiente a E0911. Si es OTI, monto del impuesto
`E`	`E10`	`Charges`	Información relacionada a cargos adicionales o acarreos aplicados al ítem	`E02`	O		0-1	El cargo o acarreo total será la suma de las ocurrencias del campo E1011. Si se informa, no se puede informar F03 (Valor del acarreo cobrado en el precio total)
`E`	`E101`	`Charge`	Elemento que describe el cargo o acarreo	`E10`	L		1-10
`E`	`E1011`	`Amount`	Cargo a aplicar	`E101`	N
`E`	`E11`	`Totals`	Grupo de datos que contienen información relacionada a los precios totales del ítem	`E02`	O
`E`	`E111`	`TotalBDiscounts`	Subtotal del ítem antes de aplicar descuentos	`E11`	N	`1-11p2-6`	0-1	Resultado de E05 * E07
`E`	`E112`	`TotalWDiscounts`	Subtotal del ítem aplicando descuentos	`E11`	N	`1-11p2-6`	0-1	Resultado de E05 * (E07 – total de ocurrencias de E08)
`E`	`E113`	`TotalBTaxes`	Subtotal del ítem antes de aplicar impuestos	`E11`	N	`1-11p2-6`	0-1	Si no aplicó descuento E05 * E07
`E`	`E114`	`TotalWTaxes`	Subtotal del ítem aplicando impuestos	`E11`	N	`1-11p2-6`	0-1	Suma del precio del ítem y todas las ocurrencias de E09
`E`	`E115`	`SpecificTotal`	Subtotal aplicando cargos, seguros.	`E11`	N	`1-11p2-6`	0-1	Suma del ítem con impuesto, incluyendo cargos (E10) y seguro (EI08)
`E`	`E116`	`TotalItem`	Precio total del ítem	`E11`	N	`1-11p2-6`	1-1	Si el ítem no es valorable: informar campo en 0.00. Si se agrega E115 debe ser igual. En caso contrario: informar la suma de Precio unitario (E07), acarreo (E10), precio del seguro (EI08), impuesto ITMBS, impuesto ISC e impuesto OTI (E09)
`E`	`E12`	`AdditionalInfo`	Información adicional	`E02`	L		0-1
`E`	`E121`	`Info`	Elemento que describe la información adicional	`E12`	I		1-25	Ver en sección Ítem AdditionalInfo

4.4.6.1Grupo Ítem Codes

ID	Campo	Descripción	T	Tam	Ocu	Observaciones
`EI01`	`CodigoProd`	Código interno del ítem	A	`1-20`	0-1	Código del producto o servicio en el catálogo del emisor
`EI02`	`CodCPBSabr`	Código del Ítem en la Codificación panameña de Bienes y Servicios Abreviada	N	`2`	0-1	Debe corresponder a la tabla de la Codificación Panameña de Bienes y Servicios de Segmentos y Familias. No informar este campo si el bien o servicio no puede ser clasificado en ninguna de las opciones de esta tabla. Si el Tipo de Receptor (CI01) es 01 o 02, debe informarse al menos uno de EI02 y EI03 Ver catálogo oficial ↗
`EI03`	`CodCPBScmp`	Código del Ítem en la Codificación Panameña de Bienes y Servicios	N	`4`	0-1	Debe corresponder a la tabla de la Codificación Panameña de Bienes y Servicios de Segmentos y Familias. Campo obligatorio si es venta a la Administración Pública (CI01= 03). Si el Tipo de Receptor (CI01) es 01 o 02, debe informarse al menos uno de EI02 y EI03 Ver catálogo oficial ↗
`EI04`	`UnidadCPBS`	Unidad de medida en la Codificación Panameña de Bienes y Servicios	A	`1-30`	0-1	Debe corresponder al Catálogo de Unidades de Medida Ver catálogo oficial ↗

4.4.6.2Grupo Ítem AdditionalInfo

ID	Campo	Descripción	T	Tam	Ocu	Observaciones
`EI05`	`FechaFab`	Fecha de fabricación/elaboración	A	`10`	0-1	Formato AAAA-MM-DD
`EI06`	`FechaCad`	Fecha de caducidad	A	`10`	0-1	Formato AAAA-MM-DD
`EI07`	`InfEmFE`	Información de interés del emisor con respeto a un ítem de la FE	A	`0-5000`	0-1
`EI08`	`PrSegItem`	Precio del seguro, para este ítem específico	N	`1-9p2`	0-1	Si se informa, no se puede informar F03 (Valor del seguro cobrado en el precio total)
`EI09`	`GTINCom`	Código GTIN del ítem, para la unidad de Comercialización. Por ejemplo, paquete con ocho botellas	A	`0, 8, 12, 13 o 14`	0-1	Grupo de otros códigos del ítem. Códigos GTIN-8, GTIN-12, GTIN-13 o GTIN-14 antiguos códigos EAN, UPC y DUN-14. Informar campo vacío si el producto no posee este código. Agregar si se agregan también EI10, EI11, EI12
`EI10`	`CantGTINCom`	Cantidad del producto o servicio en el Código GTIN del ítem de comercialización	N	`1-11p0-6`	0-1	Grupo de otros códigos del ítem. Agregar si se agregan también EI09, EI11, EI12
`EI11`	`GTINInv`	Código GTIN del ítem, para la unidad de inventario. Por ejemplo, botella	A	`0, 8, 12, 13 o 14`	0-1	Grupo de otros códigos del ítem. Agregar si se agregan también EI09, EI10, EI12
`EI12`	`CantComInvent`	Cantidad del producto o servicio en el Código GTIN del ítem de inventario	N	`1-11p0-6`	0-1	Grupo de otros códigos del ítem. Agregar si se agregan también EI09, EI10, EI11
`EI13`	`NroLote`	Número de lote de medicinas y materias primas farmacéuticas	A	`5-35`	0-1	Medicinas y materias primas farmacéuticas. Obligatorio si el ítem es medicina o materia prima farmacéutica. Agregar si se agrega también EI14
`EI14`	`CtLote`	Cantidad de productos en el lote de medicinas y materias primas farmacéuticas	N		0-1	Medicinas y materias primas farmacéuticas. Obligatorio si el ítem es medicina o materia prima farmacéutica. Agregar si se agrega también EI13
`EI15`	`NroPed`	Número del pedido de compra	N	`1-9`	0-1	Información del Pedido Comercial relacionada con un ítem de la factura. Agregar si se agrega también EI16
`EI16`	`InfEmPedIt`	Información de interés del emisor con respeto al pedido comercial, relacionado con un ítem de la factura	N	`0-5000`	0-1	Información del Pedido Comercial relacionada con un ítem de la factura. Agregar si se agrega también EI15
`EI17`	`ModOpVN`	Modalidad de la operación de venta de vehículos nuevos	A	`2`	0-1	Vehículo Nuevo. En caso de vehículo nuevo la factura solamente podrá contener un único ítem. 01: venta a representante; 02: venta al consumidor final; 03: venta a gobierno; 04: venta a flota de vehículos; 99: otros. Obligatorio para vehículo Valores permitidos `01` · venta a representante `02` · venta al consumidor final `03` · venta a gobierno `04` · venta a flota de vehículos `99` · otros
`EI18`	`ModOpVNDesc`	Modalidad de la operación de venta de vehículos nuevos no listada en el formato	A	`10-50`	0-1	Vehículo Nuevo. Obligatorio si EI17 = 99
`EI19`	`Chasis`	Chasis del vehículo	A	`17`	0-1	Vehículo Nuevo. Código VIN o número serial. Obligatorio para vehículo
`EI20`	`ColorCod`	Color del vehículo	A	`1-4`	0-1	Vehículo Nuevo. Código interno del fabricante. Obligatorio para vehículo
`EI21`	`ColorNomb`	Descripción del color del vehículo	A	`1-40`	0-1	Vehículo Nuevo
`EI22`	`PotVeh`	Potencia del motor (CV)	N	`1-4`	0-1	Vehículo Nuevo
`EI23`	`Cilin`	Capacidad del motor	N	`1-4`	0-1	Vehículo Nuevo. Expresa en centímetros cúbicos (cc)
`EI24`	`PesoNeto`	Peso Neto	N	`1-11p0-4`	0-1	Vehículo Nuevo. Toneladas
`EI25`	`PesoBruto`	Peso Bruto	N	`1-11p0-4`	0-1	Vehículo Nuevo. Toneladas
`EI26`	`TipoCombustible`	Tipo de combustible	A	`2`	0-1	Vehículo Nuevo. 01: gasolina; 02: diésel; 03: etanol; 08: eléctrico; 09: gasolina/eléctrico; 99: otro. Obligatorio para vehículo Valores permitidos `01` · gasolina `02` · diésel `03` · etanol `08` · eléctrico `09` · gasolina/eléctrico `99` · otro
`EI27`	`TipoCombustibleDesc`	Tipo de combustible no listado en el formato	A	`10-50`	0-1	Vehículo Nuevo. Obligatorio si EI26 = 99
`EI28`	`NroMotor`	Número del motor	A	`1-21`	0-1	Vehículo Nuevo. Obligatorio si para vehículo
`EI29`	`CapTracc`	Capacidad máxima de tracción	N	`1-11p0-4`	0-1	Vehículo Nuevo. Toneladas
`EI30`	`DistEjes`	Distancia entre ejes	N	`1-11p0-4`	0-1	Vehículo Nuevo. Metros
`EI31`	`AnoMod`	Año del modelo de fabricación	N	`4`	0-1	Vehículo Nuevo
`EI32`	`AnoFab`	Año de fabricación	N	`4`	0-1	Vehículo Nuevo
`EI33`	`TipoPintura`	Tipo de pintura	N	`1`	0-1	Vehículo Nuevo. 1: sólida; 2: metálica; 3: perla; 4: fosca; 9: otra Valores permitidos `1` · sólida `2` · metálica `3` · perla `4` · fosca `9` · otra
`EI34`	`TipoPinturaDesc`	Tipo de pintura no listada en el formato	A	`10-50`	0-1	Vehículo Nuevo. Obligatorio si EI33 = 9
`EI35`	`TipoVehic`	Tipo del vehículo	N	`1`	0-1	Vehículo Nuevo. Utilizar tipos aceptados en el Registro Vehicular. 1: motocicleta, 2: bus, 3: camión, 4: sedán, 5: camioneta, 6: pickup, 7: Mini Pick-Up, 8: Pick Up Grua, 9: Pick Cabina Sencilla, 10: Pick Up Cabina y Media, 11: Pick- Up Doble Cabina, 12: Sedan Híbrido, 13: Microbus, 14: Mini Bus, 15: Mini Microbus, 16: Busito, 17: Hatcback, 18: Mini Panel, 19: Panel, 20: Convertible, 21: Coupe, 22: Coupe Convertible, 23: Mini Car, 24: Motorscooter, 25: Mototriciclo, 26: Scooter, 27: Triciclo, 28: Limosina, 29: Mini Vans, 30: Van, 31: Trailer, 32: Semi Trailer, 33: Suburvan, 34: Vagon, 35: Vagoneta, 36: Remolque, 37: Four Wheel, 38: SUV. Obligatorio para vehículo Valores permitidos `1` · motocicleta `2` · bus `3` · camión `4` · sedán `5` · camioneta Ver los 38 valores →
`EI36`	`UsoVehic`	Uso del vehículo	N	`1`	0-1	Vehículo Nuevo. Utilizar tabla del Departamento de Registro Vehicular: 1: comercial; 2: particular; 3: Diplomatica; 4: Oficial; 5: Especial. Obligatorio para vehículo Valores permitidos `1` · comercial `2` · particular `3` · Diplomatica `4` · Oficial `5` · Especial
`EI37`	`CondVehic`	Condición del vehículo	N	`1`	0-1	Vehículo Nuevo. 1: acabado; 2: semi-acabado; 3: inacabado Valores permitidos `1` · acabado `2` · semi-acabado `3` · inacabado
`EI38`	`Lotac`	Capacidad máxima de pasajeros	N	`1-3`	0-1	Vehículo Nuevo. Capacidad máxima de pasajeros sentados

4.4.7Campos 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 de la factura electrónica	`R01`	O		1-1
`F`	`F02`	`QtyItems`	Cantidad de Items en la factura electrónica	`F01`	N		1-1000	Ver observación en el campo EI14 (grupo de detalle de vehículos nuevos)
`F`	`F03`	`TotalCharges`	Grupo de datos que contiene información de cargos adicionales sobre el total de la factura	`F01`	O		0-1	El cargo o acarreo total será la suma de las ocurrencias del campo F0312 donde la descripción sea FACTURA. Si se informa, no se puede informar E10 (Valor del acarreo cobrado sobre un ítem). En el caso de un seguro, el seguro total será la suma de las ocurrencias del campo F0312 donde la descripción sea SEGURO. Si se informa, no se puede informar EI08 (Valor del seguro cobrado sobre un ítem). Para registrar otros gastos cobrados en el precio total, la descripción debe ser OTROS_GASTOS, solo debe agregarse una vez la información que representa este gasto.
`F`	`F031`	`TotalCharge`	Elemento que contiene información sobre el cargo	`F03`	L		1-10	En el caso de acarreo cobrado en el precio total de la factura, si se informa, no se puede informar E10. En el caso de seguro cobrado en el precio total de la factura, si se informa, no se puede informar en EI08. Si es otro gasto, debe informarse una sola vez.
`F`	`F0311`	`Description`	Tipo de cargo a aplicar	`F031`	A	`6-7`	1-1	Valores para ingresar. FACTURA: si se desea agregar un cargo por acarreo indicar este nombre en la descripción. SEGURO: si se desea agregar el precio por seguro cobrado en el precio total. OTROS_GASTOS: valor de otros gastos cobrados en el precio total.
`F`	`F0312`	`Amount`	Valor del cargo/seguro cobrado en el precio total	`F031`	N	`1-11p2`	1-1
`F`	`F04`	`TotalDiscounts`	Grupo de datos que contiene información de descuentos o bonificaciones aplicados a la factura	`F01`	O		0-1	Informar solo cuando se agreguen descuentos o bonificaciones sobre el total de la factura. El total de descuentos y bonificaciones concedidos sobre el valor total de la factura serán todas las ocurrencias de F0412
`F`	`F041`	`Discount`	Elemento que contiene información sobre el descuento	`F04`	L		1-5
`F`	`F0411`	`Description`	Descripción de descuentos o bonificaciones adicionales aplicados a la factura	`F041`	A	`1-500`	1-1
`F`	`F0412`	`Amount`	Monto descuentos/bonificaciones	`F041`	N	`1-11p2`	1-1
`F`	`F05`	`GrandTotal`	Información sobre el precio total de la factura	`F01`	O		1-1
`F`	`F051`	`TotalBDiscounts`	Monto total antes de aplicar descuentos sobre la factura	`F05`	N	`1-11p2`	0-1	Suma del precio de cada ítem (E116) y seguros y/o cargos (F03)
`F`	`F052`	`TotalWDiscounts`	Monto total aplicando descuentos sobre la factura	`F05`	N	`1-11p2`	0-1	Suma del precio de cada ítem (E116); seguros, cargos y/u otros gastos (F03) menos descuentos (F04). Resultado: ocurrencias de E116 + F03 – F04
`F`	`F053`	`InvoiceTotal`	Precio total de la factura	`F05`	N	`1-11p2`	1-1	Precio total de la factura aplicando cargos y/o seguros y descuentos. Resultado: ocurrencias de E116 + F03 – F04

4.4.8Campos 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 de la factura electrónica	`R01`	L		1-1	Si existe el grupo D50 (información de pago a crédito/plazo), la forma de pago corresponde a la primera fracción.
`G`	`G02`	`Payment`	Grupo que describe un pago	`G01`	O		1-20	Pago a plazo: Debe haber por lo menos una ocurrencia de un pago a plazo si existe una forma de pago G021 diferente de 1 (pago a crédito/plazo). La primer forma de pago informada deberá corresponder a la primera cuota a pagar en el plazo
`G`	`G021`	`Type`	Tipo de pago	`G02`	A	`2-5`	1-1	Si se quiere agregar información sobre forma de Pago de la factura. 01: Crédito; 02: Efectivo; 03: Tarjeta Crédito; 04: Tarjeta Débito; 05: Tarjeta Fidelización; 06: Vale; 07: Tarjeta de Regalo; 08: Transf./Depósito a cta. Bancaria; 09: Cheque; 10: Punto de Pago; 99: otro. Si es información sobre pago a plazo agregar PLAZO Valores permitidos `01` · Crédito `02` · Efectivo `03` · Tarjeta Crédito `04` · Tarjeta Débito `05` · Tarjeta Fidelización `06` · Vale `07` · Tarjeta de Regalo `08` · Transf./Depósito a cta. Bancaria `09` · Cheque `10` · Punto de Pago `99` · otro
`G`	`G022`	`Description`	Descripción de forma de pago	`G02`	A	`10-100, 15-1000`	0-1	Forma de pago de la factura (Tamaño de 10-100). Obligatorio si se agrega información sobre la forma de pago de la factura y G021 es 99. Pago a plazos (Tamaño de 15-1000). Si se desea agregar información de interés de parte del emisor con respecto a la cuota
`G`	`G023`	`Date`	Tipo de cargo a aplicar	`G02`	F	`25`	0-1	Pago a plazos. Obligatorio para indicar la fecha de vencimiento de la cuota
`G`	`G024`	`Amount`	Valor de la cuota	`G02`	N	`1-11p2`	1-1	Obligatorio para ambos casos (Forma de pago de la factura y Pago a plazos)

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

C	ID	Campo	Descripción	P	T	Tam	Ocu	Observaciones
`H`	`H01`	`AdditionalDocumentInfo`	Grupo de datos que contiene información adicional sobre la factura electrónica	`R01`	O		1-1
`H`	`H02`	`AdditionalInfo`	Grupo que contiene información adicional	`H01`	L		1-2	Si se agregan 2 ocurrencias, la número 2 deberá contener la información de la Adenda Comercial, especificada en la sección de Adenda Comercial
`H`	`H03`	`AddressInfo`	Grupo que contiene información adicional sobre la dirección de un establecimiento	`H02`	O		0-1	Válido únicamente cuando se quiere agregar la dirección de identificación del local de entrega y si es diferente de la dirección del receptor.
`H`	`H031`	`Address`	Dirección de la ubicación	`H03`	A	`100`	1-1	Urbanización, Calle, Casa/Edificio, Número de Local
`H`	`H032`	`City`	Ciudad o corregimiento donde se encuentra la dirección	`H03`	A	`50`	1-1	Debe corresponder al catálogo de Corregimientos según el Catálogo Unificado de provincias, distritos y corregimientos. Ver catálogo oficial ↗
`H`	`H033`	`District`	Distrito donde se encuentra la ciudad	`H03`	A	`50`	1-1	Debe corresponder al catálogo de distritos según el Catálogo Unificado de provincias, distritos y corregimientos. Ver catálogo oficial ↗
`H`	`H034`	`State`	Estado o provincia donde se encuentra el distrito	`H03`	A	`50`	1-1	Debe corresponder al catálogo de provincias según el Catálogo Unificado de provincias, distritos y corregimientos. Ver catálogo oficial ↗
`H`	`H035`	`Country`	País donde se encuentra el estado	`H03`	A	`50`	1-1
`H`	`H04`	`AditionalData`	Grupo que contiene datos adicionales como información de documento fiscal referenciado	`H02`	O		0-1	Obligatorio si Tipo de documento A02 = 04 o 05. Llenar campos cuando se desee agregar información sobre Documentos Fiscales Referenciados
`H`	`H041`	`Data`	Elemento que contiene datos adicionales sobre documentos, referencias, etc.	`H04`	L		1-50
`H`	`H0411`	`Info`	Elemento que contiene la información adicional	`H041`	I		1-3	Ver en sección Información Adicional Data
`H`	`H05`	`AditionalInfo`	Grupo que contiene información adicional	`H02`	L		1-1	Si se quiere agregar información sobre forma de Pago de la factura
`H`	`H051`	`Info`	Elemento que contiene la información adicional	`H05`	I		1-25	Ver en sección Información Adicional AditionalInfo

4.4.9.1Grupo Información Adicional Data

ID	Campo	Descripción	T	Tam	Ocu	Observaciones
`HI01`	`NombEmRef`	Razón social (persona jurídica) o nombre y apellido (persona natural) del emisor del documento fiscal referenciado	A	`2-200`	1-1	Documento Fiscal Referenciado
`HI02`	`FechaDFRef`	Fecha de emisión del Documento Fiscal Referenciado	F	`25`	1-1	Documento Fiscal Referenciado
`HI03`	`CUFERef`	CUFE de FE referenciada	A	`66`	0-1	Documento Fiscal Referenciado. Información de referencia de la FE. Deben ser las 66 posiciones que conforman el CUFE. Si se informa, no incluir HI04 y HI05. Sólo se debe informar una de estas tres opciones.
`HI04`	`NroFacPap`	Número de factura en papel	A	`22`	0-1	Documento Fiscal Referenciado. Hace referencia al número de la factura en papel. Si se informa, no incluir HI03 y HI05. Sólo se debe informar una de estas tres opciones.
`HI05`	`NroFacIE`	Número de factura emitida por impresora fiscal	A	`22`	0-1	Documento Fiscal Referenciado. Información de Referencia a factura emitida por impresora fiscal. Si se informa, no incluir HI03 y HI04. Sólo se debe informar una de estas tres opciones.

4.4.9.2Grupo Información Adicional AditionalInfo

ID	Campo	Descripción	T	Tam	Ocu	Observaciones
`HI06`	`TiempoPago`	Tiempo de pago	N	`1`	1-1	1: Contado; 2: Crédito/Plazo; 3: Mixto Valores permitidos `1` · Contado `2` · Crédito/Plazo `3` · Mixto
`HI07`	`CondEntr`	Condiciones de entrega de acuerdo con la tabla de INCOTERMS	A	`3`	0-1	Facturas en caso de exportación. Obligatorio en exportación. No puede existir si AI10 = 1 (destino de la operación es Panamá). Debe existir si AI10 = 2 (destino u origen de la operación es otro país). Debe corresponder a una de las siglas de la columna "Condición" de la Tabla 9 de INCOTERMS. Valores permitidos `EXW` · EX Works (El vendedor pone mercancía a disposición del comprador en sus propias instalaciones: fábrica, almacén, etc. Todos los gastos a partir de ese momento son por cuenta del comprador.) `FCA` · Free Carrier (El vendedor se compromete a entregar la mercancía en un punto acordado dentro del país de origen, que pueden ser los locales de un transitorio, una estación ferroviaria... (este lugar convenido para entregar la mercancía suele estar relacionado con los espacios del transportista). Se hace cargo de los costes hasta que la mercancía está situada en ese punto convenido.) `CPT` · Carriage Paid To (El vendedor se hace cargo de todos los costes, incluido el transporte principal, hasta que la mercancía llegue al punto convenido en el país de destino. Sin embargo, el riesgo se transfiere al comprador en el momento de la entrega de la mercancía al transportista dentro del país de origen. Si se utilizan varios transportistas para llegar a destino, el riesgo se transmite cuando la mercancía se haya entregado al primero.) `CIP` · Carriage and Insurance Paid to (El vendedor se hace cargo de todos los costes, incluidos el transporte principal y el seguro, hasta que la mercancía llegue al punto convenido en el país de destino. Aunque el seguro lo ha contratado el vendedor, el beneficiario del seguro es el comprador.) `DAT` · Delivered At Terminal (El vendedor se hace cargo de todos los costes, incluidos el transporte principal y el seguro (que no es obligatorio), hasta que la mercancía es descargada en la terminal convenida. También asume los riesgos hasta ese momento.) `DAP` · Delivered At Place (El vendedor se hace cargo de todos los costes, incluidos el transporte principal y el seguro (que no es obligatorio), pero no de los costes asociados a la importación, hasta que la mercancía se ponga a disposición del comprador en un vehículo listo para ser descargado. También asume los riesgos hasta ese momento.) `DDP` · Delivered Duty Paid (El vendedor paga todos los gastos hasta dejar la mercancía en el punto convenido en el país de destino. El comprador no realiza ningún tipo de trámite. Los gastos de aduana de importación son asumidos por el vendedor.) `FAS` · Free Alongside Ship (El vendedor entrega la mercancía en el muelle pactado del puerto de carga convenido; esto es, al lado del barco. El incoterm FAS es propio de mercancías de carga a granel o de carga voluminosa porque se depositan en terminales del puerto especializadas, que están situadas en el muelle. El vendedor es responsable de las gestiones y costes de la aduana de exportación.) `FOB` · Free On Board (El vendedor entrega la mercancía sobre el buque. El comprador se hace cargo de designar y reservar el transporte principal (buque).) `CFR` · Cost and FReight (El vendedor se hace cargo de todos los costes, incluido el transporte principal, hasta que la mercancía llegue al puerto de destino. Sin embargo, el riesgo se transfiere al comprador en el momento que la mercancía se encuentra cargada en el buque, en el país de origen.) `CIF` · Cost Insurance and Freight (El vendedor se hace cargo de todos los costes, incluidos el transporte principal y el seguro, hasta que la mercancía llegue al puerto de destino. Aunque el seguro lo ha contratado el vendedor, el beneficiario del seguro es el comprador. El riesgo se transfiere al comprador en el momento que la mercancía se encuentra cargada en el buque, en el país de origen.) `DPU` · Delivered at Place Unloaded (El vendedor realiza la entrega de la mercancía y transmite el riesgo cuando la pone a disposición del comprador en el medio de transporte de llegada, descargada por sus medios, y en el punto de destino convenido.)
`HI08`	`MonedaDesc`	Moneda de la operación de exportación no existente en la Tabla x	A	`5-50`	0-1	Facturas en caso de exportación. Obligatorio si A07 = ZZZ
`HI09`	`PuertoEmbarq`	Puerto de embarque de la mercancía	A	`5-50`	0-1	Facturas en caso de exportación
`HI10`	`CodRetenc`	Código de la retención a aplicar	N	`2`	0-1	Retenciones a factura. Informar cuando se le aplican retenciones a la factura. Corresponde al catálogo de objetos de retención: 1: Pago por servicio profesional al estado 100%; 2: Pago por venta de bienes/servicios al estado 50%; 3: Pago o acreditación a no domiciliado o empresa constituida en el exterior 100%; 4: Pago o acreditación por compra de bienes/servicios 50%; 7: Pago a comercio afiliado a sistema de TC/TD 50%; 8: Otros (disminución de la retención) Valores permitidos `1` · Pago por servicio profesional al estado 100% `2` · Pago por venta de bienes/servicios al estado 50% `3` · Pago o acreditación a no domiciliado o empresa constituida en el exterior 100% `4` · Pago o acreditación por compra de bienes/servicios 50% `7` · Pago a comercio afiliado a sistema de TC/TD 50% `8` · Otros (disminución de la retención)
`HI101`	`ValRetenc`	Monto de la retención a aplicar	N	`1-11p2`	0-1	Retenciones a factura. Obligatorio si HI10 es 8 (Otros)
`HI11`	`NroPed`	Número del pedido de compra	A	`1-12`	0-1	Información del Pedido Comercial Relacionadas con la Factura. Obligatorio cuando se quiera agregar información del pedido comercial
`HI12`	`NumAcept`	Número de Aceptación	A	`1-12`	0-1	Información del Pedido Comercial Relacionadas con la Factura. Número de aceptación del pedido. Opcional
`HI13`	`CodRec`	Código de cliente/receptor	A	`1-50`	0-1	Información del Pedido Comercial Relacionadas con la Factura. Número de aceptación del pedido. Opcional
`HI14`	`CodSisEm`	Código de sistema emisor	A	`1-50`	0-1	Información del Pedido Comercial Relacionadas con la Factura. Permite registrar el código del sistema que emite la factura electrónica (de utilidad cuando un emisor disponga de más de un sistema de facturación). Opcional
`HI15`	`InfEmPedGl`	Información de interés del emisor con respeto al Pedido Comercial global	A	`1-5000`	0-1	Información del Pedido Comercial Relacionadas con la Factura. Opcional
`HI16`	`NroVols`	Número de volúmenes	N	`1-3`	0-1	Información de Logística. Opcional
`HI17`	`PesoTot`	Peso total de la carga	N	`1-4p2-6`	0-1	Información de Logística. Opcional
`HI18`	`UnPesoTot`	Unidad del peso total	N	`1`	0-1	Información de Logística. 1: g; 2: kg; 3: toneladas; 4: libras. Opcional Valores permitidos `1` · g `2` · kg `3` · toneladas `4` · libras
`HI19`	`LicCamion`	Licencia del vehículo de carga	A	`6`	0-1	Información de Logística. Opcional
`HI20`	`NomTransp`	Nombre o Razón social del transportista	A	`15-100`	0-1	Información de Logística. Obligatorio
`HI21`	`TipoRucT`	Tipo de Contribuyente	A	`1`	0-1	Información de Logística. Tipo de Contribuyente: 1: Natural, 2: Jurídico. Obligatorio Valores permitidos `1` · Natural `2` · Jurídico
`HI22`	`RucT`	Ruc del Transportista	A	`5-20`	0-1	Información de Logística. RUC del transportista. Obligatorio
`HI23`	`DigitoVerificadorT`	Dígito Verificador Ruc Transportista	A	`2`	0-1	Información de Logística. Debe ser calculado en base al algoritmo del RUC publicado por la DGI. Obligatorio
`HI24`	`InfEmLog`	Información de interés del emisor con respeto a logística	A	`0-5000`	0-1	Información de Logística
`HI25`	`TipoRucLE`	Tipo de Contribuyente	A	`1`	0-1	Identificación del Local de Entrega. Tipo de Contribuyente: 1: Natural, 2: Jurídico. Obligatorio Valores permitidos `1` · Natural `2` · Jurídico
`HI26`	`RucLE`	Ruc receptor	A	`5-20`	0-1	Identificación del Local de Entrega. RUC del receptor. Obligatorio
`HI27`	`DigitoVerificadorLE`	Dígito Verificador Ruc Receptor	A	`2`	0-1	Identificación del Local de Entrega. Debe ser calculado en base al algoritmo del RUC publicado por la DGI. Obligatorio
`HI28`	`CodUbiLE`	Código de Provincia, distrito y corregimiento	A	`8`	0-1	Identificación del Local de Entrega. Código compuesto de la ubicación según el Catálogo Unificado de provincias, distritos y corregimientos. Obligatorio Ver catálogo oficial ↗
`HI29`	`NombrLcEntr`	Razón Social (Persona Jurídica) o Nombre y Apellido (Persona Natural) del local de la entrega	A	`2-100`	0-1	Identificación del Local de Entrega. Obligatorio
`HI30`	`TfnLcEntr`	Teléfono de contacto del local de la entrega	N	`7-12`	0-1	Identificación del Local de Entrega. Formato aceptables: 999-9999 o 9999-9999. Opcional
`HI31`	`TfnAdLcEntr`	Teléfono de contacto adicional, o alterno del local de la entrega	N	`7-12`	0-1	Identificación del Local de Entrega. Formato aceptables: 999-9999 o 9999-9999. Ejemplo teléfonos de atención al cliente o de otro número que el contribuyente considere importante incluir. Opcional

4.4.10Información Adenda ComercialConjunto HA

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 (H02) adicional al que ya se menciona anteriormente.

C	ID	Campo	Descripción	P	T	Tam	Ocu	Observaciones
`H`	`HA-H01`	`AdditionalDocumentInfo`	Grupo de datos que contiene información adicional sobre la factura electrónica	`R01`	O		1-1	En el PDF este campo aparece con el ID H01 (mismo grupo de la sección 4.4.9).
`HA`	`HA01`	`AdditionalInfo`	Grupo que contiene información adicional	`H01`	L		1-2	Este elemento debe ser la ocurrencia 2 que aparecerá en el XML. Si se agrega debe contener únicamente la información relacionada a la adenda comercial.
`HA`	`HA02`	`Code`	Código o número de referencia interna	`HA01`	A	`2-500`	1-1	Identificador o numero 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 (@)
`HA`	`HA03`	`Type`	Tipo de información	`HA01`	A	`5-10`	1-1	Corresponde al tipo de información que se agregará. Único valor permitido: ADENDA
`HA`	`HA04`	`AditionalData`	Grupo que contiene datos adicionales	`HA01`	O		0-1
`HA`	`HA041`	`Data`	Elemento que contiene datos adicionales sobre la factura o datos específicos de ítems, etc.	`HA04`	L		1-50	Este elemento contiene un atributo llamado "Name", que únicamente será utilizado al Momento de agregar información sobre la Adenda. Los valores que puede tomar el atributo Name son: INFORMACIÓN_ADICIONAL: para agregar información adicional. DetallesAux_Detalle: Para agregar detalles Auxiliares a los ítems de la factura.
`HA`	`HA0411`	`Info`	Elemento que contiene la información adicional	`HA041`	I		1-70	Ver en sección Información Adicional Data en Adenda
`HA`	`HA05`	`AditionalInfo`	Grupo que contiene información adicional	`HA01`	A		1-1
`HA`	`HA051`	`Info`	Elemento que contiene la información adicional	`HA05`	I		1-25	Ver en sección Información Adicional AditionalInfo en Adenda

4.4.10.1Grupo Información Adicional Data en Adenda

ID	Campo	Descripción	T	Tam	Ocu	Observaciones
`HIA01`	`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"
`HIA02`	`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 "-"
`HIA03`	`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 "-"
`HIA04`	`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 "-"
`HIA05`	`Textos`	Textos adicionales relacionados al item	A	`1-60`	0-10	Válido únicamente para "DetallesAux_Detalle"
`HIA06`	`<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.4.10.2Grupo Información Adicional AditionalInfo en Adenda

C	ID	Campo	Descripción	P	T	Tam	Ocu	Observaciones
	`HIB01`	`VALIDAR_REFERENCIA`	Validar referencia interna		A	`2`	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
	`HIB02`	`VERSION`	Versión de la adenda		A	`10-n`	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, se obtiene como respuesta un objeto JSON que tiene la siguiente estructura.

Donde:

Atributo	Descripción
`code`	muestra el código de la respuesta obtenida. Ver detalle de códigos en Códigos dentro de la Respuesta
`message`	contiene un mensaje informativo relacionado a la respuesta
`description`	descripción adicional del mensaje
`responseData1`	texto codificado en base64 que contiene la factura el formato XML
`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`	CUFE o código único de la factura electrónica
`url`	url del QR generado para consultar la factura
`infoDetails`	atributo tipo arreglo de objetos que, cuando la respuesta es un error, muestra el listado de errores que contiene el XML. El objeto que contiene cada ítem del arreglo contiene los siguientes atributos: evento: tipo de error; dCodRes: código del error; dMsgRes: descripción de error
`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
`serial`	número de documento fiscal
`issuedTimeStamp`	fecha de emisión de la factura electrónica
`taxID`	RUC 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`	RUC del receptor/comprador
`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
`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. No posee un formato en específico ya que será de utilidad para agregar cualquier valor según sea útil y necesario. Actualmente puede contener como atributos los siguientes valores: DocumentGUID: identificador único del documento emitido; ProtocoloAutorizacion: protocolo de autorización del documento emitido.

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 mostrará el contenido del error en los atributos "message" y "description".
`3010`	Error en el Schema del NUC. Verificar que el esquema (objetos y atributos del JSON enviado) 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, RUC 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

Documentación Técnica NUC-JSON Panamá

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

4.4.1Schema NUCConjunto R

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

4.4.2.1Grupo AdditionalIssueDocInfo

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

4.4.3.1Grupo Emisor TaxIDAdditionalInfo

4.4.3.2Grupo Emisor AdditionalBranchInfo

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

4.4.4.1Grupo Receptor TaxIDAdditionalInfo

4.4.4.2Grupo Receptor AdditionlInfo

4.4.5Campos que contienen información sobre tercerosConjunto D

4.4.5.1Grupo Tercero TaxIDAdditionalInfo

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

4.4.6.1Grupo Ítem Codes

4.4.6.2Grupo Ítem AdditionalInfo

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

4.4.8Campos que describen las formas de pagoConjunto G

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

4.4.9.1Grupo Información Adicional Data

4.4.9.2Grupo Información Adicional AditionalInfo

4.4.10Información Adenda ComercialConjunto HA

4.4.10.1Grupo Información Adicional Data en Adenda

4.4.10.2Grupo Información Adicional AditionalInfo en Adenda

5Respuesta de la API

Donde:

5.1 Códigos dentro de la Respuesta

5.2 Códigos de Estado HTTP