Ir al contenido
NovaFENovaFE

Recepción B2BAprobación comercial

Aprobación comercial

Ver como Markdown

La aprobación comercial (ACECF) es la confirmación de que un comprador está de acuerdo con lo que dice un comprobante. Va en dos direcciones independientes.

Alguien más aprueba uno de tus comprobantes

Sección titulada «Alguien más aprueba uno de tus comprobantes»
POST /{tenantid}/fe/aprobacioncomercial/api/ecf

Misma ruta fija que la recepción de comprobantes, también sin credencial por defecto. NovaFE valida el XML, verifica la firma, y contrasta el ACECF contra el comprobante propio que dice aprobar o rechazar: emisor, e-NCF, fecha de emisión, monto total y comprador tienen que coincidir exactamente con lo que NovaFE ya tiene guardado.

La decisión queda reflejada en tu comprobante y dispara el webhook commercial_approval.received.

Tú apruebas uno que recibiste

Sección titulada «Tú apruebas uno que recibiste»
POST /api/v1/received-ecf/{id}/commercial-approval
{ "decision": "accepted" }

O, para rechazar, con el motivo obligatorio:

{
  "decision": "rejected",
  "rejectionReason": "El monto no coincide con lo acordado"
}

Solo funciona sobre un comprobante que recibiste correctamente, que todavía no tiene una decisión tuya y cuyo tipo admite aprobación comercial. Responde 202: NovaFE firma el ACECF con tu certificado y lo encola para entregar, no lo envía dentro del mismo request.

Aprobación automática (opcional)

Sección titulada «Aprobación automática (opcional)»

Por defecto una persona decide cada comprobante recibido. Si recibes muchos de proveedores de siempre, puedes pedir que se acepten solos con tres ajustes de Configuración:

Ajuste Qué hace
inbound.auto_commercial_approval manual (por defecto) o auto_trusted.
inbound.trusted_issuers RNC o cédulas, sin guiones, de los emisores de confianza.
inbound.auto_approve_max_amount Monto máximo en RD$. Es obligatorio: con 0 no se aprueba nada automáticamente.

Un comprobante recibido de un emisor de confianza, por un monto que no pase del máximo, se acepta al instante y su ACECF se entrega como cualquier otro. Nunca se rechaza nada automáticamente, y todo lo demás (otro emisor, un monto mayor) queda pendiente de una persona. Cada aprobación automática queda marcada como tal en el comprobante recibido (commercialApprovalAutomatic y commercialApprovalAutomaticRule).

A dónde se entrega

Sección titulada «A dónde se entrega»

A dos destinos independientes, cada uno con su propio reintento: si uno falla, el otro no se bloquea.

  1. Al emisor del comprobante: NovaFE busca su URL de recepción en el directorio de la DGII y le manda el ACECF a su propio endpoint de aprobación comercial (el mismo que describe esta página, del lado de quien recibe).
  2. A la DGII: para que quede registrado también ahí.