Saltar al contenido
firmo
Docs / Reportes 606, 607, 608 y 609

Reportes 606, 607, 608 y 609

Los formatos de la DGII del mes en JSON, Excel y TXT oficial, el resumen para el IT-1 y el IR-17, y las compras manuales (/v1/reports, /v1/purchases).

Firmo calcula cada mes los formatos 606 (compras), 607 (ventas), 608 (comprobantes anulados) y 609 (pagos al exterior) de la empresa activa, más un resumen fiscal con los datos para el IT-1 (ITBIS) y el IR-17 (retenciones de ISR). Los devuelve en JSON, en Excel con el orden de columnas de la herramienta de la DGII y en el TXT del formato oficial.

Borrador para tu contador; verifica antes de declarar. Firmo no envía nada a la DGII: tú (o tu contador) pasas el TXT por la Herramienta de Pre-validación y lo subes en la Oficina Virtual. Cada reporte traeadvertencias con lo que falta y con los supuestos que hizo Firmo.

Reportes del mes#

GET/v1/reports/{606|607|608|609}?period=AAAAMM&format=json|xlsx|txt

ParámetroDescripción
periodMes AAAAMM (p. ej. 202609). El corte es en hora de República Dominicana (America/Santo_Domingo).
formatjson (por defecto), xlsx (Excel) o txt (archivo para la Oficina Virtual).
bash
# El 607 de septiembre de 2026 en el formato oficial
curl "https://api.firmo.do/v1/reports/607?period=202609&format=txt" \
  -H "Authorization: Bearer $FIRMO_API_KEY" -o DGII_F_607_101000009_202609.TXT
FormatoQué incluye
606e-CF recibidos de suplidores (con su XML), E41 (compras a informales), E43 (gastos menores) y E47 (pagos al exterior, con el RNC de la empresa) emitidos, y las compras manuales.
607e-CF 31, 32 (RD$250,000 o más en el detalle; las menores van solo en el resumen de consumo), 33, 34, 44, 45 y 46 aceptados o aceptados condicionales.
608Secuencias anuladas con ANECF y aceptadas por la DGII, expandidas e-NCF por e-NCF (código de anulación 08).
609e-CF tipo 47 (pagos por servicios al exterior). País, tipo de servicio y detalle salen de la <code>metadata</code> del e-CF.
Respuesta (JSON, 607)
{
  "formato": "607",
  "periodo": "202609",
  "empresa": { "rnc": "101000009", "razonSocial": "Mi Empresa SRL" },
  "fechaLimite": "2026-10-15",
  "filas": [
    { "ncf": "E310000000001", "tipoId": 1, "rnc": "131880738", "fechaComprobante": "2026-09-05",
      "montoFacturado": 1000, "itbisFacturado": 180, "itbisRetenido": 0, "cheque": 1180, "signo": 1 }
  ],
  "totales": { "registros": 1, "montoFacturado": 1000, "itbisFacturado": 180, "itbisRetenido": 0, "retencionRenta": 0 },
  "resumenConsumo": { "cantidad": 12, "cantidadMenores": 12, "montoFacturado": 8200, "itbis": 1476, "total": 9676 },
  "advertencias": [],
  "notas": ["Si facturas 100 % con e-CF, la DGII indica que no tienes que enviar el 607 ni el 608 …"],
  "aviso": "Borrador para tu contador; verifica antes de declarar."
}

Los totales restan las notas de crédito (signo: -1); el TXT y el Excel llevan siempre montos positivos, como pide la DGII.

Resumen fiscal: IT-1 e IR-17#

GET/v1/reports/tax-summary?period=AAAAMM

it1 trae las operaciones del período (total, exportaciones, exentas, gravadas al 18 % y al 16 %), el ITBIS cobrado, el ITBIS por adelantar de las compras (606), el ITBIS retenido que te hicieron y el que retuviste, y un resultado estimado (positivo = a pagar; negativo = saldo a favor). ir17 trae el ISR retenido por tipo de retención y en pagos al exterior. Los números de casilla son los del instructivo del IT-1 que publica la DGII (versión 2019 en adelante); confírmalos contra el formulario vigente.

El archivo TXT#

Es el formato de la Norma General 07-2018 (Anexos A a D): campos separados por |, una línea de encabezado FORMATO|RNC|AAAAMM|cantidad y un registro por línea (la cantidad no cuenta el encabezado). Las líneas terminan en CRLF y el nombre del archivo sigue el ejemplo del instructivo: DGII_F_606_RNC_AAAAMM.TXT. Los códigos van con dos dígitos (02), las fechas como AAAAMMDD y los montos con punto decimal y dos decimales. Los campos de percepción que la DGII no habilita van vacíos.

FormatoCampos del registro, en orden
606 (23)RNC/cédula del suplidor · tipo id (1 RNC, 2 cédula) · tipo de bienes y servicios (01–11) · NCF · NCF modificado · fecha del comprobante · fecha de pago · monto en servicios · monto en bienes · total facturado · ITBIS facturado · ITBIS retenido · ITBIS sujeto a proporcionalidad · ITBIS llevado al costo · ITBIS por adelantar · ITBIS percibido (vacío) · tipo de retención en ISR (01–09) · monto de retención de renta · ISR percibido (vacío) · ISC · otros impuestos · propina legal · forma de pago (01–07)
607 (23)RNC/cédula/pasaporte del comprador · tipo id (1, 2, 3 pasaporte) · NCF · NCF modificado · tipo de ingreso (01–06) · fecha · fecha de retención · monto facturado · ITBIS facturado · ITBIS retenido por terceros · ITBIS percibido (vacío) · retención de renta por terceros · ISR percibido (vacío) · ISC · otros impuestos · propina legal · efectivo · cheque/transferencia/depósito · tarjeta · venta a crédito · bonos o certificados de regalo · permuta · otras formas
608 (3)NCF anulado · fecha · tipo de anulación (01–10)
609 (13)Razón social · tipo id tributaria (1 física, 2 jurídica) · id tributaria · país destino · tipo de servicio (01–08) · detalle del servicio · parte relacionada (0/1) · número de documento · fecha del documento · monto facturado · fecha de retención de ISR · renta presunta · ISR retenido
608 de septiembre de 2026
608|101000009|202609|2
E310000000010|20260910|08
E310000000011|20260910|08

Si facturas con e-CF#

  • 607 y 608: la DGII ha respondido que quien factura 100 % con e-CF no está obligado a enviarlos (sus ventas y sus correcciones ya le llegan en línea). Úsalos para cuadrar tu IT-1 y tus libros, o si todavía emites comprobantes de la serie B fuera de Firmo.
  • 606: sigue siendo obligatorio, con los e-CF que te emiten. El 609 aplica si pagaste servicios al exterior.
  • Facturas de consumo menores de RD$250,000: no van en el detalle del 607 sino en el «Resumen General de Facturas de Consumo» del módulo de envío de la Oficina Virtual; resumenConsumo te da la cantidad y los montos.
  • IT-1: las casillas 1 a 8 del Anexo A las llena a mano quien factura con e-CF; tax-summary te da los números.

Compras manuales (para el 606)#

Los comprobantes de papel de tus suplidores (B01, B02, B11, B13, B14, B15…) no llegan por la DGII. Anótalos para que el 606 quede completo. Los e-CF no se anotan aquí: salen solos.

GET/v1/purchases?period=AAAAMM

POST/v1/purchases

GET/v1/purchases/{id}

PATCH/v1/purchases/{id}

DELETE/v1/purchases/{id}

GET/v1/purchases/template

POST/v1/purchases/import

bash
curl -X POST https://api.firmo.do/v1/purchases \
  -H "Authorization: Bearer $FIRMO_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "rncProveedor": "101000009",
    "tipoBienesServicios": 2,
    "ncf": "B0100000007",
    "fechaComprobante": "2026-09-18",
    "montoBienes": 1000,
    "itbisFacturado": 180,
    "formaPago": 2
  }'
CampoDescripción
rncProveedorRNC (9) o cédula (11) del suplidor. Obligatorio salvo en gastos menores (B13/E43). El tipo de id se deduce.
tipoBienesServicios1 a 11 (tabla de costos y gastos del 606).
ncfNCF completo: 11 posiciones (B0100000001) o e-NCF de 13. Único por suplidor.
fechaComprobanteAAAA-MM-DD. Define el mes del 606.
montoBienesy montoServicios: sin impuestos. Uno de los dos debe ser mayor que 0.
itbisFacturadomás itbisRetenido, itbisProporcionalidad, itbisCosto, isc, otrosImpuestos, propinaLegal. El ITBIS por adelantar = facturado − llevado al costo.
fechaPagoObligatoria si hay ITBIS o renta retenidos.
tipoRetencionIsr1 a 9; obligatorio si montoRetencionRenta es mayor que 0.
ncfModificadoObligatorio en notas de débito y de crédito.
formaPago1 a 7 (efectivo, cheque/transferencia, tarjeta, crédito, permuta, nota de crédito, mixto). Por defecto 1.

POST /v1/purchases/import recibe un .xlsx (la plantilla de GET /v1/purchases/template) o un .csv por multipart/form-data en el campo archivo. Valida todas las filas; si alguna falla no guarda ninguna y devuelve los errores por fila y columna. Las compras ya anotadas se omiten. Con ?dryRun=true solo valida. Máximo 2,000 filas y 5 MB.

Pagos al exterior (609): metadata del E47#

El e-CF 47 no trae el país ni el tipo de servicio que pide el 609. Envíalos en metadata al emitir; lo que falte lo completa Firmo con un supuesto y lo marca en advertencias.

Clave de metadataValor
pais_destinoCódigo del país según ISO 3166 (p. ej. USA).
tipo_servicio1 a 8 (tabla de tipos de servicios del 609). Por defecto 2.
detalle_servicioCódigo del detalle (p. ej. 21 honorarios a personas morales, 24 otros servicios a personas morales). Por defecto 24.
tipo_id_tributaria1 persona física o 2 jurídica (por defecto).
parte_relacionada1 o 0 (por defecto).
numero_documentoDocumento que respalda el pago (por defecto el e-NCF).
renta_presuntaBase del ISR retenido (por defecto, el monto facturado).

Planes y permisos#

Los reportes están disponibles en todos los planes, para todos los roles que pueden ver facturas (dueño, administrador, contador, emisor y solo lectura). Anotar compras lo pueden hacer el dueño, los administradores, el contador y el emisor. Como en el resto de la API, usar una llave sk_live_ desde fuera del portal requiere un plan con API (Negocio o superior); en el portal y con llaves de sandbox no hay límite.

SDK, MCP y WhatsApp#

  • SDK: firmo.reportes.reporte607('202609'), .excel(…), .txt(…), .resumenFiscal(…) y firmo.compras.crear / listar / actualizar / eliminar / importar.
  • MCP: reporte_606, reporte_607, reporte_608, reporte_609, resumen_fiscal, listar_compras_manuales y registrar_compra_manual.
  • WhatsApp: «mándame el 607 de septiembre» responde con un enlace firmado (7 días) al Excel.

Fuentes#

El detalle completo, con lo que debe verificar tu contador, está en docs/reportes-dgii.md del repositorio.