Consultar lo recibido

GET /api/v1/received-ecf
GET /api/v1/received-ecf/{id}

El listado es paginado, igual que el de tus propios comprobantes emitidos, y admite filtros que se combinan entre sí. Cada entrada trae el resultado de la recepción y, si ya decidiste algo, el estado de la aprobación comercial:

{
  "id": "...",
  "status": "Received",
  "noReceptionReason": null,
  "issuerRnc": "130862346",
  "issuerName": "Mi Proveedor SRL",
  "encf": "E310000000010",
  "type": 31,
  "issueDate": "10-01-2026",
  "montoTotal": 5900.0,
  "receivedAt": "2026-01-10T09:15:00-04:00",
  "commercialApprovalDecision": "accepted",
  "commercialApprovalRejectionReason": null,
  "commercialApprovalDecidedAt": "2026-01-10T10:00:00-04:00",
  "commercialApprovalSentToIssuerAt": "2026-01-10T10:00:05-04:00",
  "commercialApprovalSentToDgiiAt": "2026-01-10T10:00:06-04:00",
  "commercialApprovalApplies": true
}

status es Received (se aceptó el comprobante) o NotReceived (se rechazó; en ese caso noReceptionReason siempre viene acompañando el motivo). Los campos commercialApproval* quedan en null hasta que tú tomas una decisión sobre ese comprobante.

commercialApprovalApplies indica si la DGII admite una aprobación comercial para el tipo de ese comprobante. Es false para los tipos 32, 41, 43, 46 y 47: nunca pueden quedar pendientes de una decisión tuya.

Filtros del listado

Todos son opcionales y se combinan con “y”.

Parámetro	Qué filtra
status	Received o NotReceived.
decision	pending (recibido, de un tipo que admite aprobación y sin decisión), accepted o rejected.
search	Texto dentro del e-NCF, del RNC del emisor o de su nombre.
type	Código del tipo de comprobante (31, 33, 34…).
from, to	Rango de días de recepción, en hora de Santo Domingo, con ambos extremos incluidos.
environment	test, cert o production. Sin valor, el listado incluye todos.

Un valor que no se reconoce responde 400 en vez de ignorarse, para que un filtro mal escrito no devuelva todo sin avisar.