Pacioli API e-CF

E47 — Comprobante Electrónico para Pagos al Exterior

← Volver al índice

Para qué sirve

Lo emite tu empresa cuando paga a una persona o empresa no residente en el país (licencias de software, servicios profesionales, regalías…). Declara la retención de ISR que le haces.

Cuándo NO usarlo

Campos

Obligatorios

Campo Notas
tipo_ecf = "47", encf (E47…), fecha_emision
fecha_vencimiento Vencimiento de la secuencia E47. Sin él, 422 por XSD.
direccion_emisor
monto_exento, monto_total, valor_pagar monto_exento = monto_total.
detalle con indicador_facturacion = 4
Por línea: monto_isr_retenido Obligatorio (puede ser 0). Si falta, 500: El campo monto_isr_retenido es obligatorio en cada item para Pagos al Exterior (tipo 47).

Opcionales: tipo_pago, formas_pago, fecha_limite_pago, termino_pago, indicador_agente_retencion_percepcion por línea (por defecto 1), total_isr_retencion (si no lo envías se suma del detalle).

No enviar

Campo Qué pasa
razon_social_comprador 500: El campo identificador_extranjero es obligatorio para Pagos al Exterior (tipo 47).
descuento en una línea 422: el E47 no admite descuentos.

No aplican (se ignoran): rnc_comprador, tipo_ingresos, indicador_monto_gravado, zona_venta, montos gravados e ITBIS, monto_itbis_retenido, total_itbis_retenido.

Totales

monto_exento        = Σ monto_item
monto_total         = monto_exento
valor_pagar         = monto_total          (la retención NO se resta)
total_isr_retencion = Σ monto_isr_retenido

Ejemplo: licencia 1 × 120,000.00 → monto_total = valor_pagar = 120,000.00; ISR retenido 27 % = 32,400.00. Lo que transfieres al proveedor (87,600.00) no va en el e-CF. La tasa de retención depende del tipo de renta: el API no la calcula ni la valida.

Particularidades

Ejemplo: licencia de software con 27 % de ISR retenido

{
  "factura": {
    "tipo_ecf": "47",
    "encf": "E470000000001",
    "fecha_emision": "2026-10-12",
    "fecha_vencimiento": "2027-12-31",
    "tipo_pago": "1",
    "direccion_emisor": "Av. Winston Churchill 1099, Santo Domingo",
    "monto_exento": 120000.00,
    "monto_total": 120000.00,
    "valor_pagar": 120000.00,
    "total_isr_retencion": 32400.00
  },
  "detalle": [
    {
      "numero_linea": 1,
      "nombre_item": "Licencia anual de software",
      "indicador_bien_servicio": 2,
      "indicador_facturacion": 4,
      "cantidad": 1,
      "unidad_medida": "43",
      "precio_unitario": 120000.00,
      "monto_item": 120000.00,
      "indicador_agente_retencion_percepcion": 1,
      "monto_isr_retenido": 32400.00
    }
  ]
}

Respuesta esperada

201 como en el README. url_dgii no lleva rnccomprador.

Advertencia: la salida actual del E47 tiene limitaciones conocidas (se emite sin datos del comprador) y no se ha verificado que la DGII la acepte. Coordina con soporte antes de usarlo en produccion.