Recibidos y aprobación comercial · Documentación

Disponible

Cuando un suplidor te envía un e-CF, llega al receptor de Firmo, que responde el acuse de recibo (ARECF) por ti y lo guarda. Luego tú decides si lo apruebas o lo rechazas comercialmente (ACECF).

Listar recibidos#

GET/v1/received?approval=&cursor=&limit=

GET/v1/received/{id}

Recibido

{
  "id": "7d6c5b4a-3928-4170-8e9d-0c1b2a3f4e5d",
  "encf": "E310000000123",
  "rncEmisor": "101000000",
  "razonSocialEmisor": "Distribuidora del Cibao SRL",
  "fechaEmision": "2026-10-05",
  "montoTotal": 23600,
  "totalItbis": 3600,
  "acuse": "recibido",
  "aprobacion": "pendiente",
  "motivoRechazo": null,
  "urls": { "xml": "https://…" },
  "recibidoEn": "2026-10-05T16:02:11.000Z"
}

Campo	Valores
`acuse`	`recibido` o `no_recibido`
`aprobacion`	`pendiente`, `aprobado` o `rechazado`

Aprobar o rechazar#

POST/v1/received/{id}/approval

Campo	Descripción
`aprobado`	Booleano, obligatorio. true para aprobar, false para rechazar.
`motivo`	Texto de hasta 250 caracteres. Obligatorio si aprobado es false.

bash

curl -X POST https://api.firmo.do/v1/received/7d6c5b4a-3928-4170-8e9d-0c1b2a3f4e5d/approval \
  -H "Authorization: Bearer $FIRMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "aprobado": false, "motivo": "Precio distinto al de la orden de compra 1187" }'

Suscríbete al webhook recibido.nuevo para enterarte de cada factura que te llega.