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.
advertencias 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ámetro | Descripción |
|---|---|
period | Mes AAAAMM (p. ej. 202609). El corte es en hora de República Dominicana (America/Santo_Domingo). |
format | json (por defecto), xlsx (Excel) o txt (archivo para la Oficina Virtual). |
# 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| Formato | Qué incluye |
|---|---|
606 | e-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. |
607 | e-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. |
608 | Secuencias anuladas con ANECF y aceptadas por la DGII, expandidas e-NCF por e-NCF (código de anulación 08). |
609 | e-CF tipo 47 (pagos por servicios al exterior). País, tipo de servicio y detalle salen de la <code>metadata</code> del e-CF. |
{
"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.
| Formato | Campos 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|101000009|202609|2
E310000000010|20260910|08
E310000000011|20260910|08Si 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;
resumenConsumote 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-summaryte 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
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
}'| Campo | Descripción |
|---|---|
rncProveedor | RNC (9) o cédula (11) del suplidor. Obligatorio salvo en gastos menores (B13/E43). El tipo de id se deduce. |
tipoBienesServicios | 1 a 11 (tabla de costos y gastos del 606). |
ncf | NCF completo: 11 posiciones (B0100000001) o e-NCF de 13. Único por suplidor. |
fechaComprobante | AAAA-MM-DD. Define el mes del 606. |
montoBienes | y montoServicios: sin impuestos. Uno de los dos debe ser mayor que 0. |
itbisFacturado | más itbisRetenido, itbisProporcionalidad, itbisCosto, isc, otrosImpuestos, propinaLegal. El ITBIS por adelantar = facturado − llevado al costo. |
fechaPago | Obligatoria si hay ITBIS o renta retenidos. |
tipoRetencionIsr | 1 a 9; obligatorio si montoRetencionRenta es mayor que 0. |
ncfModificado | Obligatorio en notas de débito y de crédito. |
formaPago | 1 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 metadata | Valor |
|---|---|
pais_destino | Código del país según ISO 3166 (p. ej. USA). |
tipo_servicio | 1 a 8 (tabla de tipos de servicios del 609). Por defecto 2. |
detalle_servicio | Código del detalle (p. ej. 21 honorarios a personas morales, 24 otros servicios a personas morales). Por defecto 24. |
tipo_id_tributaria | 1 persona física o 2 jurídica (por defecto). |
parte_relacionada | 1 o 0 (por defecto). |
numero_documento | Documento que respalda el pago (por defecto el e-NCF). |
renta_presunta | Base 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(…)yfirmo.compras.crear / listar / actualizar / eliminar / importar. - MCP:
reporte_606,reporte_607,reporte_608,reporte_609,resumen_fiscal,listar_compras_manualesyregistrar_compra_manual. - WhatsApp: «mándame el 607 de septiembre» responde con un enlace firmado (7 días) al Excel.
Fuentes#
- Norma General 07-2018 sobre Remisión de Informaciones (DGII)
- Instructivo de llenado del Formato 606 (DGII, feb. 2026)
- Instructivo de llenado del Formato 607 (DGII, dic. 2025)
- Respuesta de la DGII sobre los formatos 606 a 609 para emisores electrónicos
El detalle completo, con lo que debe verificar tu contador, está en docs/reportes-dgii.md del repositorio.