Saltar al contenido principal

Recepción y aprobación comercial

Como receptor electrónico, tus proveedores te envían sus e-CF a las URLs que registraste en la DGII. ZarelaFact los recibe por ti, verifica la firma y el XSD, responde el acuse de recibo (ARECF) y los guarda. Después puedes responder a cada uno con la aprobación comercial (ACECF): aceptarlo o rechazarlo.

Dónde ves los documentos recibidos​

  • En el portal: Documentos → Recibidos.
  • Por API: GET /{ambiente}/documentos-recibidos. Ver Lista los recibidos por API.
  • Por webhook (opcional): el evento document.received trae el identificador del documento en data.inboundDocumentId y la descarga de su XML en data.xmlUrl. Ver Webhooks.
  • Si integras como Partner, lista los recibidos de cada cliente con GET /partner/v1/fiscal-accounts/{fiscalAccountId}/production/inbound-documents (mismos filtros, cursor y campos que la lista directa; los de pruebas, en …/testecf/inbound-documents). Consulta uno con GET …/production/inbound-documents/{inboundDocumentId}, descarga su XML con …/{inboundDocumentId}/xml y responde con POST …/production/inbound-documents/{inboundDocumentId}/commercial-approval (mismo cuerpo que abajo). Ver la referencia Partner.

Lista los recibidos por API​

Requiere el permiso ecf:read, que ya trae la clave estándar: tu ERP puede leer sus compras sin una clave de administración. Responder la aprobación comercial sí requiere tenant:admin.

GET /{ambiente}/documentos-recibidos
curl "https://api.zarelafact.com/eCF/documentos-recibidos?group=por_aprobar&limit=50" \
-H 'X-API-KEY: zrl_live_...'

Devuelve los e-CF que tus proveedores te enviaron en ese ambiente, del más reciente al más antiguo. No incluye las aprobaciones comerciales que tus clientes envían sobre tus e-CF: esas están en Las aprobaciones comerciales que te envían tus clientes.

ParámetroQué filtra
grouppor_aprobar, aceptados, rechazados o no_recibidos: las mismas pestañas del portal.
documentTypeTipo de e-CF, por ejemplo E31.
encfUn e-NCF exacto.
issuerRncRNC o cédula del proveedor (9 u 11 dígitos).
from, toFecha de recepción. from se incluye y to no. Una fecha sin hora, como 2026-10-01, es la medianoche de República Dominicana.
limitDocumentos por página: hasta 100; por defecto, 50.
cursorEl nextCursor de la página anterior.
{
"ok": true,
"environment": "ecf",
"items": [
{
"inboundDocumentId": "1f6d2c7a-9b3e-4f10-8a5d-6c2e9b7f0a11",
"encf": "E310000000045",
"issuerRnc": "{{RNC_PROVEEDOR}}",
"receiverRnc": "{{RNC}}",
"status": "received",
"commercialApproval": null,
"dgiiValidity": {
"state": "accepted",
"final": true,
"dgiiStatus": "Aceptado",
"checkedAt": "2026-10-21T15:05:12.000Z",
"attempts": 1
},
"receivedAt": "2026-10-21T15:00:00.000Z",
"group": "por_aprobar",
"commercialApprovalDeadline": "2026-11-15",
"view": {
"kind": "recepcion",
"documentType": "E31",
"senderName": "{{RAZON_SOCIAL_PROVEEDOR}}",
"senderRnc": "{{RNC_PROVEEDOR}}",
"amount": "18450.00",
"issueDate": "2026-10-20",
"acuse": { "state": "recibido" },
"approval": { "state": "pendiente", "deadline": "2026-11-15" },
"dgii": { "state": "aceptado", "checkedAt": "2026-10-21T15:05:12.000Z", "dgiiStatus": "Aceptado", "retrying": false },
"group": "por_aprobar"
}
}
],
"nextCursor": "eyJjcmVhdGVkQXQiOiIyMDI2LTEwLTIxVDE1OjAwOjAwLjAwMFoiLCJpZCI6Ii4uLiJ9",
"correlationId": "c0a8012e-5b1f-4d2a-9e43-7f6a1b2c3d4e"
}
CampoQué es
statusreceived si se recibió; duplicate o rejected si el acuse dijo «no recibido».
commercialApprovalTu respuesta (ACECF) si ya la enviaste; si no, null.
dgiiValidityValidez del e-CF en la DGII según Consulta Estado; null mientras no se ha consultado. Ver Validez en la DGII.
groupLa pestaña del portal donde aparece.
commercialApprovalDeadlineFecha límite para responder (AAAA-MM-DD). Solo en por_aprobar; ver Plazo para responder. Es null en los demás grupos o si el XML no trae FechaEmision.
viewLo mismo que muestra Documentos → Recibidos: proveedor, tipo, monto, fecha de emisión (issueDate), acuse y aprobación.

Para recorrer todo, repite la consulta con cursor igual al nextCursor hasta que llegue null; los filtros se mantienen. Un filtro, limit o cursor inválido responde 400 INVALID_RECEIVED_DOCUMENTS_QUERY.

Con el inboundDocumentId:

  • GET /{ambiente}/documentos-recibidos/{inboundDocumentId} devuelve el mismo elemento.
  • GET /{ambiente}/documentos-recibidos/{inboundDocumentId}/xml descarga el XML tal como lo envió el proveedor, como archivo RNCEmisor + e-NCF .xml. Sale de su copia inmutable, que se conserva 10 años, después de comprobar su huella SHA-256. Si el envío se rechazó sin una firma verificada, ese XML no se guarda y la respuesta es 404 RECEIVED_DOCUMENT_XML_NOT_AVAILABLE.

Un documento de otra cuenta o de otro ambiente responde 404 RECEIVED_DOCUMENT_NOT_FOUND. Si la copia guardada no coincide con su huella, la respuesta es 500 RECEIVED_DOCUMENT_XML_INTEGRITY_FAILED y no se entrega nada; escríbenos con el correlationId.

Registra la compra con el XML​

Para registrar un e-CF recibido como factura de proveedor (líneas, ITBIS, vencimiento), lee su XML:

  1. Recibes el webhook document.received (o lo encuentras en la lista con group=por_aprobar).
  2. Descargas el XML con data.xmlUrl (cuenta directa) o resource.xmlUrl (Partner).
  3. Lees los campos de la tabla y registras la compra. Si la aceptas o rechazas, envía la aprobación comercial antes del plazo.

Es el formato e-CF de la DGII, sin cambios. Los campos opcionales pueden no venir, y cada tipo de e-CF trae los suyos.

Para tu registroCampo del XML
ProveedorEncabezado/Emisor/RNCEmisor y RazonSocialEmisor
Tipo y númeroEncabezado/IdDoc/TipoeCF y eNCF
Fecha de emisiónEncabezado/Emisor/FechaEmision (DD-MM-AAAA)
Condición de pagoEncabezado/IdDoc/TipoPago: 1 contado, 2 crédito, 3 gratuito
VencimientoEncabezado/IdDoc/FechaLimitePago (DD-MM-AAAA); TerminoPago si el proveedor lo indica
LíneasCada DetallesItems/Item: NombreItem, CantidadItem, UnidadMedida, PrecioUnitarioItem, DescuentoMonto y MontoItem. UnidadMedida es un código de la tabla de unidades de la DGII
ITBIS de cada líneaItem/IndicadorFacturacion: 1 ITBIS 18 %, 2 ITBIS 16 %, 3 ITBIS 0 %, 4 exento, 0 no facturable
TotalesEncabezado/Totales: MontoGravadoTotal, MontoExento, TotalITBIS y MontoTotal
RetencionesEncabezado/Totales/TotalITBISRetenido y TotalISRRetencion
Nota de crédito o débitoInformacionReferencia/NCFModificado: el e-NCF que modifica

Los montos usan punto decimal. Antes de usar la compra para crédito fiscal, revisa dgiiValidity: solo un e-CF que la DGII aceptó (accepted o accepted_conditional) tiene validez fiscal; ver Validez en la DGII.

Validez en la DGII​

Poco después de recibir un e-CF (con firma válida), ZarelaFact pregunta a la DGII si lo tiene aceptado, con el servicio Consulta Estado y el token DGII de tu cuenta. El Decreto 587-24 (art. 17, párrafo VII) pide al receptor consultar la validez del e-CF, y la DGII solo recibe aprobaciones comerciales de e-CF que ya aceptó (Informe Técnico e-CF v1.0, nota 10).

dgiiValidity.stateEn el portalQué significa
accepted, accepted_conditionalDGII · aceptadoLa DGII lo aceptó: tiene validez fiscal.
rejectedDGII · rechazadoLa DGII lo rechazó. No admite aprobación comercial.
not_foundDGII · no encontradoLa DGII no lo encuentra; puede que aún no lo haya procesado. No admite aprobación comercial mientras siga así.
pendingDGII · en procesoTodavía sin una respuesta concluyente (en proceso o la DGII no respondió).
not_applicable—El ambiente no tiene Consulta Estado: CerteCF. No bloquea nada.
unverifiedDGII · sin verificarSe agotaron las consultas sin respuesta concluyente. No bloquea la aprobación.

not_found y pending se vuelven a consultar solos con espera creciente (5 min, 15 min, 1 h, 6 h y 24 h: hasta 6 consultas). Después final pasa a true y no se consulta más. Para consultar necesitamos el certificado activo de tu cuenta en ese ambiente: sin él queda pending.

Las aprobaciones comerciales que te envían tus clientes​

Cuando tú emites un e-CF, tu cliente (el comprador) puede aceptarlo o rechazarlo con un ACECF que llega a tu URL de aprobación comercial. Lo recibes con el webhook document.commercial_approval_received y, por API, con el mismo permiso ecf:read:

GET /{ambiente}/aprobaciones-comerciales-recibidas
GET /{ambiente}/aprobaciones-comerciales-recibidas/{inboundDocumentId}
GET /{ambiente}/aprobaciones-comerciales-recibidas/{inboundDocumentId}/xml
curl "https://api.zarelafact.com/eCF/aprobaciones-comerciales-recibidas?encf=E310000000201" \
-H 'X-API-KEY: zrl_live_...'

La lista va del más reciente al más antiguo, con el mismo cursor que los recibidos (limit, cursor, from y to funcionan igual). Filtros propios: encf (el e-NCF que emitiste) y buyerRnc (RNC o cédula de tu cliente).

{
"ok": true,
"environment": "ecf",
"items": [
{
"inboundDocumentId": "6b1e0c55-3f0a-4c7e-9d2b-1a4f8e2c7b90",
"encf": "E310000000201",
"documentId": "0d9f3a1c-77b2-4e65-a0c4-5b8e1f2d3c4a",
"issuerRnc": "{{RNC_PROVEEDOR}}",
"buyerRnc": "{{RNC}}",
"status": "received",
"decision": "rejected",
"rejectionReason": "Mercancía no recibida",
"approvalDateTime": "25-10-2026 11:15:00",
"issueDate": "2026-10-20",
"amount": "1180.00",
"correspondence": { "status": "matched", "documentId": "0d9f3a1c-77b2-4e65-a0c4-5b8e1f2d3c4a", "mismatches": [] },
"notReceived": null,
"receivedAt": "2026-10-25T15:20:00.000Z"
}
],
"nextCursor": null,
"correlationId": "c0a8012e-5b1f-4d2a-9e43-7f6a1b2c3d4e"
}
CampoQué es
documentIdTu e-CF emitido con ese e-NCF en el mismo ambiente; null si no está entre tus emitidos.
decisionaccepted o rejected (el Estado del ACECF).
approvalDateTimeFechaHoraAprobacionComercial tal como la envió tu cliente, en hora de RD.
correspondenceSi el ACECF corresponde con el e-CF que emitiste, comprobado al recibirlo: matched (mismo RNC emisor, RNC comprador y monto), mismatch (mismatches trae cada campo que difiere, con el valor recibido y el de tu e-CF) o ecf_not_found (no emitiste ese e-NCF en el ambiente; el ACECF igual se recibe). null si no se recibió o llegó antes de esta comprobación. En el portal se ve en Documentos → Recibidos, bajo «ACECF del cliente».
statusreceived si el receptor la recibió. rejected o duplicate si no (por ejemplo, firma no verificada): notReceived trae el motivo, decision es null y no hay XML guardado.

/xml descarga el ACECF firmado tal como lo envió tu cliente, como archivo RNCComprador + e-NCF .xml. Sale de su copia inmutable, que se conserva 10 años, después de comprobar su huella SHA-256. Una ACECF de otra cuenta, de otro ambiente o un e-CF recibido responde 404 RECEIVED_COMMERCIAL_APPROVAL_NOT_FOUND; sin XML guardado, 404 RECEIVED_COMMERCIAL_APPROVAL_XML_NOT_AVAILABLE.

Plazo para responder​

El Decreto 587-24 (art. 17, párrafo V) da al receptor «hasta la fecha límite de remisión de información» para responder. Para las compras, esa remisión es el Formato 606, que vence el día 15 del mes siguiente (Norma General 07-18, art. 8). Leídas juntas, las dos normas dan este plazo:

  • Fecha límite: el día 15 del mes siguiente al de la FechaEmision del e-CF. Un e-CF del 20 de octubre vence el 15 de noviembre; uno de diciembre, el 15 de enero.
  • ZarelaFact cuenta desde la FechaEmision, no desde el día en que recibiste el e-CF. Si llega el mes siguiente, el plazo no se corre.
  • La norma no fija una aprobación tácita a las 48 horas.
  • Si rechazas la compra por medio del 606, no hace falta enviar el ACECF (Decreto 587-24, art. 17, párrafo X).

En Documentos → Recibidos cada documento por aprobar dice «Responde antes del dd/mm/aaaa», en rojo cuando faltan 3 días o menos o el plazo ya pasó. Por API es commercialApprovalDeadline.

Si tienes un webhook con el evento document.commercial_approval_due, ZarelaFact te avisa una sola vez por e-CF recibido cuando faltan 3 días o menos para la fecha límite (desde el día 12, en hora de República Dominicana) y todavía no respondiste. Si el e-CF llega cuando ya faltan menos de 3 días, el aviso sale enseguida; si llega con el plazo vencido, no se avisa. No se envían correos.

Responder desde el portal​

En Documentos → Recibidos, abre el documento y elige Aprobar comercialmente o Rechazar comercialmente. ZarelaFact firma el ACECF con tu certificado y lo envía.

A dónde va el ACECF​

  1. A la DGII, primero. Si la DGII lo rechaza, no sigue.
  2. Al emisor del e-CF, a la URL de aprobación comercial que registró en la DGII. ZarelaFact la busca en el directorio de la DGII con el token DGII de tu cuenta, en TesteCF y eCF. Si el emisor declaró en el directorio su servicio de autenticación, ZarelaFact pide su semilla, la firma con tu certificado y envía el ACECF con el token que recibe. En TesteCF, si el emisor también es cliente de ZarelaFact, el ACECF le llega en el receptor de TesteCF de ZarelaFact (targetSource zarelafact_testecf); ver Recibir e-CF en TesteCF.

En CerteCF la DGII no tiene directorio: el ACECF va solo a la DGII, salvo que envíes targetUrl. La respuesta es 200 con commercialApproval.status signed y targetSource not_applicable; no es un error. Cuando la DGII acepta esa copia, el documento pasa a aceptados o rechazados en Documentos → Recibidos y en GET /{ambiente}/documentos-recibidos (view.approval.acecfSent: true). Si la DGII lo rechaza, sigue en por_aprobar con el aviso «la DGII rechazó el ACECF». En TesteCF y eCF, mientras la DGII lo tiene pero el emisor todavía no, sigue en por_aprobar con el aviso «la DGII recibió el ACECF; falta entregarlo al emisor».

El ACECF solo va a la URL que el emisor registró en el directorio de la DGII. Puedes indicar otra con targetUrl únicamente cuando el emisor no aparece en el directorio de ese ambiente (400 DIRECTORY_VENDOR_NOT_FOUND) o en CerteCF. Si el emisor está en el directorio, un targetUrl distinto de su URL registrada responde 422 ACECF_TARGET_URL_NOT_ALLOWED; si el directorio no se puede consultar, el targetUrl no se acepta a ciegas (503).

ZarelaFact firma el ACECF una sola vez y, antes de enviarlo, lo guarda como evidencia inmutable durante 10 años, junto con la respuesta de la DGII. Si un envío falla y repites la decisión, sale exactamente el mismo ACECF: la DGII y el emisor reciben el mismo documento, con la misma fecha y hora de aprobación. Solo si la DGII lo rechaza se firma uno nuevo cuando envías la decisión otra vez; el rechazado queda en la evidencia.

Responder por API​

Requiere el permiso tenant:admin.

POST /{ambiente}/inbound-dgii/{inboundDocumentId}/aprobacion-comercial
curl -X POST \
https://api.zarelafact.com/eCF/inbound-dgii/{inboundDocumentId}/aprobacion-comercial \
-H 'X-API-KEY: zrl_live_...' \
-H 'Content-Type: application/json' \
-d '{ "decision": "reject", "rejectionReason": "Mercancía no recibida" }'
CampoRequeridoQué es
decisionSíaccept o reject (también aceptado o rechazado).
rejectionReasonNoMotivo del rechazo (también detalleMotivoRechazo).
approvalDateNoFecha y hora de la decisión (FechaHoraAprobacionComercial). Sin zona es hora de RD (2026-10-20T15:30:00); con Z u offset se convierte a hora de RD. Debe estar entre la medianoche de la FechaEmision del e-CF y la hora actual de RD más 5 minutos. Si no lo envías, es la hora actual de RD.
targetUrlNoURL de aprobación comercial del emisor (https), solo si no está en el directorio de la DGII de ese ambiente o en CerteCF. Ver A dónde va el ACECF.

Responde 202 cuando el ACECF llegó al emisor y 200 cuando solo se armó o firmó (o en CerteCF):

{
"ok": true,
"inboundId": "1f6d2c7a-9b3e-4f10-8a5d-6c2e9b7f0a11",
"encf": "E310000000045",
"commercialApproval": {
"status": "sent",
"decision": "accept",
"estado": "Aceptado",
"signed": true,
"xsd": { "validated": true, "ok": true }
}
}
commercialApproval.statusQué significa
builtArmado, sin firmar ni enviar.
signedFirmado, pendiente de envío.
sentEnviado al emisor del documento.
retry_scheduledEl emisor no lo recibió por una causa pasajera (502): respondió 408, 429 o 5xx, su autenticación no respondió o no se pudo conectar. ZarelaFact lo reintenta solo, con el mismo ACECF, hasta 10 intentos durante unas 2 horas, con espera creciente (de 30 segundos a 30 minutos). commercialApproval.dispatch.nextAttemptAt dice cuándo es el próximo.
dispatch_failedLa entrega al emisor falló (502) y no se reintenta sola: el emisor respondió con un error definitivo (otro 4xx) o se agotaron los 10 intentos. El ACECF queda registrado.
uncertainPudo enviarse, pero no se confirmó. No envíes otra decisión. También queda así, con commercialApproval.dispatch.errorCode ACECF_SUBMISSION_INTERRUPTED, una entrega que se interrumpió a mitad del envío (por ejemplo, un reinicio del servidor): unos 10 minutos después ZarelaFact la marca incierta en lugar de reenviarla, porque el emisor pudo haberla recibido.

commercialApproval.dispatch resume la respuesta del emisor: statusCode, hasta 4 KB de su cuerpo en responseXml (responseTruncated dice si se recortó y responseBytes su tamaño completo), attempts y nextAttemptAt. Sus cabeceras no se devuelven. La respuesta completa de cada intento queda en la evidencia que ZarelaFact conserva 10 años.

Repetir la misma decisión sobre el mismo documento:

  • con el ACECF ya entregado (sent), devuelve el acuse registrado, con idempotent: true;
  • con retry_scheduled, no reenvía nada mientras su reintento esté programado: responde el estado con idempotent: true y commercialApproval.dispatch.nextAttemptAt, sin gastar intentos. Si ese momento ya pasó, lo reenvía;
  • con dispatch_failed, lo reenvía al emisor en ese momento, con los mismos bytes firmados (commercialApproval.dispatch.attempts cuenta los intentos). Úsalo cuando el sistema del emisor vuelva a responder;
  • con uncertain, no reenvía nada: concilia primero (ver Resultado incierto).

Para ver el estado actual usa GET en la misma ruta.

Errores​

CódigoCausaQué hacer
409 COMMERCIAL_APPROVAL_DECISION_CONFLICTYa enviaste otra decisión para ese documento.Consulta el estado con GET.
422 COMMERCIAL_APPROVAL_DATE_INVALIDapprovalDate no es una fecha real, es anterior a la FechaEmision del e-CF o posterior a la hora actual de RD más 5 minutos (details.reason: invalid, before_issue_date o in_future). No se firmó ni se envió nada.Corrige la fecha u omite approvalDate para usar la hora actual.
409 ACECF_DGII_SUBMISSION_UNCERTAINUn envío anterior a la DGII quedó sin confirmar.No envíes otro hasta conciliarlo; escríbenos con el correlationId.
409 RECEIVED_ECF_NOT_VALID_IN_DGIIQuieres aprobar (accept) un e-CF que la DGII reporta rechazado o no encontrado (details.dgiiValidity). La DGII solo recibe aprobaciones comerciales de e-CF aceptados. No se generó nada.Si es not_found, espera a que la DGII lo procese (se vuelve a consultar solo) o pide al proveedor que lo envíe a la DGII. Si es rejected, pide un e-CF nuevo. El rechazo comercial (reject) sí se permite.
422 ACECF_DGII_REJECTEDLa DGII rechazó la aprobación comercial. Es definitivo: details.dgiiSubmission trae dgiiMessages, dgiiCodigo y dgiiEstado.Corrige según el mensaje y envía la decisión otra vez.
502 ACECF_DGII_SUBMISSION_UNCERTAINNo se pudo confirmar el envío a la DGII. No se reintenta solo.Escríbenos con el correlationId antes de enviar otra decisión.
503 ACECF_DGII_CERTIFICATE_UNAVAILABLENo hay certificado activo para enviar a la DGII. No salió nada.Sube o renueva tu certificado y reintenta.
503 DIRECTORY_DGII_AUTH_FAILEDNo se obtuvo el token DGII para consultar el directorio (certificado no disponible o autenticación DGII fallida).Reintenta más tarde; si persiste, revisa tu certificado.
503 DIRECTORY_ACCESS_TOKEN_MISSINGEl directorio de la DGII no se pudo consultar sin token.Reintenta más tarde.
503 DIRECTORY_FETCH_TIMEOUT / 503 DIRECTORY_FETCH_FAILEDEl directorio de la DGII, donde se busca la URL del emisor, no respondió a tiempo o respondió con error. Si la copia a la DGII ya salió, queda registrada y no se repite.Repite la misma decisión en unos segundos.
400 DIRECTORY_VENDOR_NOT_FOUNDEl emisor no aparece en el directorio de la DGII de ese ambiente.Envía targetUrl con la URL de aprobación comercial del emisor.
500 RECEIVED_DOCUMENT_XML_INTEGRITY_FAILEDEl ACECF se arma con el e-CF recibido tal como quedó guardado (evidencia inmutable, comprobada por su SHA-256) y esa comprobación falló. No se firmó ni se envió nada.Escríbenos con el correlationId.
422 ACECF_TARGET_URL_NOT_ALLOWEDEnviaste un targetUrl distinto de la URL que el emisor registró en el directorio de la DGII. details.directoryTargetUrl trae la registrada.Envía la decisión sin targetUrl.

Resultado incierto​

Si el estado es uncertain y tienes una confirmación verificable del emisor, regístrala con POST /{ambiente}/inbound-dgii/{inboundDocumentId}/aprobacion-comercial/reconciliar, enviando outcome (sent o dispatch_failed) y la evidence. No reenvía el XML y no se puede cambiar después.

Recibir e-CF en TesteCF​

Puedes probar la recepción y la aprobación comercial en TesteCF antes de producción, sin efectos fiscales y sin consumir tu plan.

Qué hace la DGII. En TesteCF el directorio de la DGII no usa las URLs de cada contribuyente: para cualquier RNC devuelve su propio emisor-receptor simulado (https://ecf.dgii.gov.do/testecf/emisorreceptor). Por eso un proveedor que no usa ZarelaFact no te puede entregar un e-CF de prueba, y no hay una URL de TesteCF que registrar en la Oficina Virtual. En la DGII registras solo la de producción (https://api.zarelafact.com/eCF).

Qué hace ZarelaFact. Entre clientes de ZarelaFact, el e-CF y el ACECF de TesteCF se entregan en el receptor de TesteCF de ZarelaFact, sin pasar por el simulador. Para recibir, la cuenta necesita TesteCF con un certificado activo, porque con él se firma el acuse (ARECF). A cualquier otro comprador o emisor se le entrega como siempre, en la URL del directorio de la DGII.

Cómo probarlo con una sola cuenta:

  1. Emite en TesteCF un e-CF de los que se entregan (31, 33, 34, 44 o 45), con tu propio RNC como RNCComprador. Usa un eNCF de prueba de TesteCF. La DGII de TesteCF acepta un e-CF emitido a tu mismo RNC. También sirve que otra cuenta de ZarelaFact te lo emita.
  2. Cuando la DGII lo acepta, ZarelaFact te lo entrega. Aparece en Documentos → Recibidos de TesteCF y en GET /TesteCF/documentos-recibidos (Partner: GET …/testecf/inbound-documents). Si tienes un webhook, llega document.received con environment testecf.
  3. Descarga su XML y acéptalo o recházalo: el ACECF va a la DGII de TesteCF y vuelve a la cuenta que emitió el e-CF. Esa cuenta lo ve en GET /TesteCF/aprobaciones-comerciales-recibidas.

Las URLs públicas de recepción​

Son las que registras en la DGII durante la certificación. Las usan la DGII y los demás emisores, no tu sistema, y no llevan API key: cada solicitud se valida con la firma digital, el XSD oficial y control de duplicados, y queda auditada.

RutaPara qué
POST /{ambiente}/fe/recepcion/api/ecfRecibir un e-CF. Responde 200 con el ARECF firmado: Estado 0 si se recibió, 1 con su motivo si no. Solo recibe e-CF: un resumen RFCE va únicamente a la DGII y responde 400 INVALID_XML_ROOT.
POST /{ambiente}/fe/aprobacioncomercial/api/ecfRecibir la aprobación comercial que un cliente envía sobre tus documentos. Responde 200 si se recibió y 400 si no.
  • En la DGII se registra solo la base del ambiente (https://api.zarelafact.com/eCF); quien envía le agrega la ruta. Las rutas no distinguen mayúsculas, como pide la DGII. Sin el ambiente (/TesteCF, /CerteCF o /eCF) la solicitud se rechaza.
  • La URL de autenticación va en blanco: ZarelaFact no ofrece la autenticación opcional de la DGII (semilla y validacioncertificado), y cualquier otra ruta bajo /fe/ responde 404.
  • Reciben el XML como lo envía la DGII, en el campo xml de un multipart/form-data, o directo en el cuerpo (application/xml o text/xml), de hasta 5 MiB: basta para cualquier e-CF de 1000 líneas. Un cuerpo mayor responde 400 BODY_TOO_LARGE, sin acuse.
  • La firma se verifica contra el certificado que trae el XML y su vigencia. Puede ser el de la empresa o el de su representante (con su cédula), como permite la DGII.
  • La firma se verifica como lo hace la DGII, sin contar los espacios en blanco entre etiquetas (preservewhitespace = false). Así se recibe también un XML que el emisor guardó con sangría o saltos de línea después de firmarlo, como hacen muchos sistemas .NET. Un cambio en el contenido, aunque sea un espacio dentro de un valor, sigue siendo firma inválida (motivo 2).
  • Un reenvío del mismo XML recibe el mismo acuse. La excepción es un XML rechazado por la firma (motivo 2): cada reenvío se verifica otra vez y, si ahora valida, se recibe con Estado 0. Otro XML con un e-NCF ya recibido es un envío duplicado (motivo 3).
  • Si el XML no es para una cuenta de ZarelaFact en ese ambiente (el comprador, en la recepción; el emisor del e-CF aprobado, en la aprobación comercial), la respuesta es el acuse «e-CF No Recibido» (Estado 1) con motivo 4, «RNC Comprador no corresponde», como espera la DGII: 200 en la recepción y 400 en la aprobación comercial. Lo firma el certificado de ese RNC en otro ambiente, si lo tiene; si no hay ningún certificado con el que firmar, la respuesta es 400 con el acuse sin firmar y la cabecera x-zarela-arecf-signed: false.
  • En las respuestas XML, FechaHoraRespuesta va en hora de República Dominicana.

Siguiente: 5. Certifica ante la DGII.