Sandbox IA — Factura Fácil

PAC — Emitir Factura

Emite FE, NC, ND. Credenciales en headers X-FF-Company / X-FF-API-Key / X-FF-Branch.

POST /api/pac/reception_fe/detailed/ Headers

X-FF-Company —

X-FF-API-Key —

X-FF-Branch —

Payload // o  para preguntas

Sin resultado todavía

Carga un ejemplo o usa el payload actual, luego Ejecutar o Validar con IA.

⌘ + ↵ ejecuta

Field Guide PAC — Emitir Factura

header

3 ▶

header.id opt string (max 100)

Referencia interna única. Clave de idempotencia — el mismo id no genera duplicados. Opcional si se provee system_ref a nivel raíz.

header.environment req choice

Ambiente — usa el número exacto

"1" Producción "2" QA / Pruebas

header.pos opt string (exactamente 3 chars)

Código del punto de venta. Default: '001'

document

4 ▶

document.fd_number req integer (0-9999999999)

Número de la factura. Usar 0 para que la API asigne automáticamente la secuencia.

document.type req choice

Tipo de documento

"01" Factura operación interna "02" Nota de Crédito — requiere referred "03" Nota de Débito — requiere referred "04" Factura de Exportación — requiere export_info

document.condition opt choice

Condición de venta. Default: 1

"1" Contado "2" Crédito — requiere installments

document.total opt decimal (15,2)

Total con impuestos. Si se omite, se calcula automáticamente a partir de los ítems.

document.referred — solo para NC (02) y ND (03)

2 ▶

referred.fd_number cond string (exactamente 66 chars)

CUFE completo de la FE original. Debe ser exactamente 66 caracteres.

⚠ Obligatorio si document.type es 02 o 03

referred.fd_date cond date YYYY-MM-DD

Fecha de emisión de la FE original

⚠ Obligatorio si document.type es 02 o 03

document.receptor

8 ▶

receptor.type req choice

Tipo de receptor

"01" Contribuyente — ruc real DGI + ruc_type + dv + address + location "02" Consumidor Final — solo 'name' requerido "03" Gobierno — ruc real DGI + dv + address + location + gns en TODOS ítems "04" Extranjero — ruc REQUERIDO pero acepta cualquier formato, no valida DGI

receptor.name req string (max 100)

Nombre del receptor. Para Consumidor Final acepta 'Consumidor Final'.

receptor.ruc cond string (max 20)

RUC del receptor. Tipo 01 y 03: consulta en VIVO contra BD de DGI — solo RUCs reales. Tipo 04 (Extranjero): requerido pero acepta cualquier formato sin validar: PE-xxx-xxx, E-xxx-xxx, N-x-xxxxx, pasaporte, ID extranjero, etc.

⚠ Obligatorio si receptor.type es 01, 03 o 04

receptor.ruc_type cond choice

Tipo de contribuyente

⚠ Obligatorio si receptor.type es 01

"1" Natural "2" Jurídico

receptor.dv cond string (max 2)

Dígito verificador del RUC. Ej: '55' o '0'

⚠ Obligatorio si receptor.type es 01 o 03

receptor.address cond string (max 100)

Dirección del receptor

⚠ Obligatorio si receptor.type es 01 o 03

receptor.location cond string (5-8 chars)

Código ubicación DGI (provincia-distrito-corregimiento). Ej: 8-8-10

⚠ Obligatorio si receptor.type es 01 o 03

receptor.email opt email (max 255)

Email del receptor para envío del PDF. Hasta 3 direcciones separadas por coma.

document.items[] (1-1000 ítems)

8 ▶

items[].line req integer (≥1)

Número de línea secuencial (1, 2, 3...)

items[].description req string (2-500 chars)

Descripción del producto/servicio

items[].quantity req decimal string (17,6)

Cantidad. Ej: "1.00"

items[].price req decimal string (15,6)

Precio unitario en Balboas. Ej: "100.00". Puede ser 0.

items[].discount req decimal (15,6)

Descuento en BALBOAS (monto fijo, no porcentaje). Usar 0.00 si no hay descuento.

items[].mu opt string (1-20 chars)

Unidad de medida del catálogo DGI. Solo funciona en minúsculas exactas. VERIFICADO: 'und'.

"und" Unidad — único valor confirmado ✓

items[].internal_code opt string (max 20)

Código interno del producto

items[].gns cond string (max 4)

Código CPBS (Panameño de Bienes y Servicios)

⚠ Obligatorio en TODOS los ítems si receptor.type es 03 (Gobierno)

document.items[].taxes[] — impuestos por ítem

4 ▶

taxes[].type req choice

Tipo de impuesto

"01" ITBMS — impuesto al consumo (más común) "02" ISC — impuesto selectivo al consumo "03" OTI — otros tipos de impuesto

taxes[].code cond string (exactamente 2 chars)

Tasa del impuesto. Requerido para ITBMS y OTI.

"00" Exento (0%) "01" 7% "02" 10% "03" 15%

taxes[].amount req decimal (15,6)

Monto del impuesto en Balboas. Calcular: price × quantity × tasa. Ej: 100.00 × 1.00 × 0.07 = 7.00

taxes[].rate cond decimal (15,6)

Tasa en decimal. Solo para ISC.

⚠ Obligatorio si taxes[].type es 02 (ISC)

document.payments[] (1-10 pagos)

3 ▶

payments[].type req choice

Forma de pago

"01" Efectivo "02" Cheque "03" Tarjeta crédito/débito "08" Transferencia/ACH "07" Devolución — usar en NC "99" Otro — requiere description (mín 10 chars)

payments[].amount req float (≥0)

Monto del pago en Balboas

payments[].description cond string (10-100)

Descripción del medio de pago

⚠ Obligatorio si type es 99

Ejemplos