Facturación a clientes extranjeros

21/07/2026

Esta actualización habilita la facturación a receptores extranjeros (tipo 04) conforme al estándar NUC-JSON de Panamá. Hasta ahora el API trataba al extranjero como si fuera un contribuyente panameño: le exigía RUC y dígito verificador, y no tenía forma de transmitir su pasaporte ni su identificación tributaria de origen. Los cambios son retrocompatibles para los receptores 01, 02 y 03.

Nuevas funciones

Identificación del receptor extranjero Nuevo

El objeto client acepta tres campos nuevos, exclusivos del receptor Extranjero (04):

Campo	Se envía a la DGI como	Descripción
foreignTaxId	NumIdTE	Identificación tributaria del país de origen (3-50 caracteres)
passport	NumPasaporte	Número de pasaporte del receptor (3-50 caracteres)
country	PaisExt	País del receptor en formato ISO 3166-1 alpha-2 (US, CO, ES…)

foreignTaxId y passport son excluyentes: debes enviar uno de los dos. country es obligatorio junto al pasaporte, porque la DGI exige el país de emisión del documento; con foreignTaxId es opcional.

Si no envías foreignTaxId ni passport pero sí taxId, este último se interpreta como la identificación tributaria extranjera (alias por retrocompatibilidad).

Ver la guía completa en .

El extranjero ya no requiere dígito verificador ni tipo de identificación

taxDv y taxIdType ya no son obligatorios para el receptor 04 y no se envían a la DGI: el documento fiscal del extranjero no lleva esos campos. Ambos siguen siendo obligatorios para los receptores Contribuyente (01) y Gobierno (03), sin cambios.

El documento se emite con el literal "EXTRANJERO" como identificación fiscal del receptor —igual que "CF" para el Consumidor Final—, y la identificación real viaja en NumIdTE o NumPasaporte.

Correcciones

Datos fiscales acordes al tipo de receptor

El bloque de identificación del receptor que se envía a la DGI ahora se arma según su tipo, en lugar de enviar siempre las mismas cuatro entradas:

• Contribuyente (01) y Gobierno (03) — tipo de receptor, ubicación y dígito verificador
• Consumidor Final (02) — tipo de receptor, ubicación y cédula
• Extranjero (04) — tipo de receptor, ubicación e identificación tributaria extranjera o pasaporte con su país

Validación del tipo de receptor

taxReceiverType solo acepta los valores del catálogo de la DGI: 01, 02, 03 y 04. Antes admitía cualquier cadena de dos dígitos, lo que dejaba pasar valores inválidos hasta el proveedor de facturación.

Documentación

• Sección nueva de con las reglas de identificación y ejemplos completos, alineada con la especificación NUC-JSON Panamá V2.0.7 y el ejemplo oficial de Digifact NUC 17
• Tabla de datos requeridos por tipo de receptor corregida: taxDv y taxIdType no aplican al extranjero, email es opcional (recomendado) y se agregaron foreignTaxId, passport y country
• Tabla del objeto client en actualizada con los campos nuevos y sus errores 400 asociados
• aclara que el endpoint consulta únicamente el registro de la DGI de Panamá y no aplica a clientes extranjeros