Consultar y descargar · Documentación

Todas las rutas que reciben {idOEncf} aceptan el id de Firmo (UUID) o el e-NCF (por ejemplo E310000000001).

Obtener un e-CF#

GET/v1/ecf/{idOEncf}

bash

curl https://api.firmo.do/v1/ecf/E310000000001 \
  -H "Authorization: Bearer $FIRMO_API_KEY"

Listar e-CF#

GET/v1/ecf?status=&type=&from=&to=&cursor=&limit=

Parámetro	Descripción
`status`	Filtra por estado: pendiente, en_proceso, aceptado, aceptado_condicional, rechazado o error.
`type`	Filtra por tipo de e-CF (31, 32…).
`from`	Fecha inicial, AAAA-MM-DD.
`to`	Fecha final, AAAA-MM-DD.
`cursor`	Valor de `siguiente` de la página anterior.
`limit`	Cantidad de resultados por página.

Aceptados de octubre, tipo 31

curl "https://api.firmo.do/v1/ecf?status=aceptado&type=31&from=2026-10-01&to=2026-10-31&limit=50" \
  -H "Authorization: Bearer $FIRMO_API_KEY"

La respuesta es paginada:

Paginado<Ecf>

{
  "datos": [ { "id": "0f8c2a9e-…", "encf": "E310000000001", "estado": "aceptado" } ],
  "siguiente": "eyJjcmVhZG9FbiI6…"
}

Cuando siguiente es null, no hay más páginas.

Descargar XML, representación impresa y QR#

Ruta	Devuelve
`GET /v1/ecf/{idOEncf}/xml`	XML firmado (`application/xml`).
`GET /v1/ecf/{idOEncf}/pdf`	Representación impresa. En la versión actual es un HTML listo para imprimir; el PDF llega en la próxima versión.
`GET /v1/ecf/{idOEncf}/qr`	Imagen PNG del código QR.

Guardar el XML firmado

curl https://api.firmo.do/v1/ecf/E310000000001/xml \
  -H "Authorization: Bearer $FIRMO_API_KEY" \
  -o E310000000001.xml

Enviar por correo#

POST/v1/ecf/{idOEncf}/email

bash

curl -X POST https://api.firmo.do/v1/ecf/E310000000001/email \
  -H "Authorization: Bearer $FIRMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "correo": "compras@ferreteriaelpuente.do" }'

Reenviar un e-CF con error#

POST/v1/ecf/{idOEncf}/resend

Reintenta el envío de un e-CF en estado error (no llegó a la DGII). Firmo ya reintenta solo; usa esta ruta si quieres forzarlo.

Consultar el estado en la DGII#

GET/v1/lookups/status?encf=&issuerRnc=&buyerRnc=&securityCode=

Consulta directamente a la DGII el estado de un e-CF, propio o de un tercero.

Parámetro	Descripción
`encf`	e-NCF del comprobante.
`issuerRnc`	RNC del emisor.
`buyerRnc`	RNC o cédula del comprador (opcional).
`securityCode`	Código de seguridad de 6 caracteres impreso en el comprobante.

bash

curl "https://api.firmo.do/v1/lookups/status?encf=E310000000001&issuerRnc=101000000&buyerRnc=131000000&securityCode=Xk3P9a" \
  -H "Authorization: Bearer $FIRMO_API_KEY"

Útil para validar las facturas que recibes antes de registrarlas en tu contabilidad.