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.receivedtrae el identificador del documento endata.inboundDocumentIdy la descarga de su XML endata.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 conGET …/production/inbound-documents/{inboundDocumentId}, descarga su XML con…/{inboundDocumentId}/xmly responde conPOST …/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ámetro | Qué filtra |
|---|---|
group | por_aprobar, aceptados, rechazados o no_recibidos: las mismas pestañas del portal. |
documentType | Tipo de e-CF, por ejemplo E31. |
encf | Un e-NCF exacto. |
issuerRnc | RNC o cédula del proveedor (9 u 11 dígitos). |
from, to | Fecha de recepción. from se incluye y to no. Una fecha sin hora, como 2026-10-01, es la medianoche de República Dominicana. |
limit | Documentos por página: hasta 100; por defecto, 50. |
cursor | El 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"
}
| Campo | Qué es |
|---|---|
status | received si se recibió; duplicate o rejected si el acuse dijo «no recibido». |
commercialApproval | Tu respuesta (ACECF) si ya la enviaste; si no, null. |
dgiiValidity | Validez del e-CF en la DGII según Consulta Estado; null mientras no se ha consultado. Ver Validez en la DGII. |
group | La pestaña del portal donde aparece. |
commercialApprovalDeadline | Fecha 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. |
view | Lo 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}/xmldescarga el XML tal como lo envió el proveedor, como archivoRNCEmisor+ 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 es404 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:
- Recibes el webhook
document.received(o lo encuentras en la lista congroup=por_aprobar). - Descargas el XML con
data.xmlUrl(cuenta directa) oresource.xmlUrl(Partner). - 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 registro | Campo del XML |
|---|---|
| Proveedor | Encabezado/Emisor/RNCEmisor y RazonSocialEmisor |
| Tipo y número | Encabezado/IdDoc/TipoeCF y eNCF |
| Fecha de emisión | Encabezado/Emisor/FechaEmision (DD-MM-AAAA) |
| Condición de pago | Encabezado/IdDoc/TipoPago: 1 contado, 2 crédito, 3 gratuito |
| Vencimiento | Encabezado/IdDoc/FechaLimitePago (DD-MM-AAAA); TerminoPago si el proveedor lo indica |
| Líneas | Cada 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ínea | Item/IndicadorFacturacion: 1 ITBIS 18 %, 2 ITBIS 16 %, 3 ITBIS 0 %, 4 exento, 0 no facturable |
| Totales | Encabezado/Totales: MontoGravadoTotal, MontoExento, TotalITBIS y MontoTotal |
| Retenciones | Encabezado/Totales/TotalITBISRetenido y TotalISRRetencion |
| Nota de crédito o débito | InformacionReferencia/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.state | En el portal | Qué significa |
|---|---|---|
accepted, accepted_conditional | DGII · aceptado | La DGII lo aceptó: tiene validez fiscal. |
rejected | DGII · rechazado | La DGII lo rechazó. No admite aprobación comercial. |
not_found | DGII · no encontrado | La DGII no lo encuentra; puede que aún no lo haya procesado. No admite aprobación comercial mientras siga así. |
pending | DGII · en proceso | Todavía sin una respuesta concluyente (en proceso o la DGII no respondió). |
not_applicable | — | El ambiente no tiene Consulta Estado: CerteCF. No bloquea nada. |
unverified | DGII · sin verificar | Se 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"
}
| Campo | Qué es |
|---|---|
documentId | Tu e-CF emitido con ese e-NCF en el mismo ambiente; null si no está entre tus emitidos. |
decision | accepted o rejected (el Estado del ACECF). |
approvalDateTime | FechaHoraAprobacionComercial tal como la envió tu cliente, en hora de RD. |
correspondence | Si 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». |
status | received 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
FechaEmisiondel 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
- A la DGII, primero. Si la DGII lo rechaza, no sigue.
- 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
TesteCFyeCF. 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. EnTesteCF, si el emisor también es cliente de ZarelaFact, el ACECF le llega en el receptor de TesteCF de ZarelaFact (targetSourcezarelafact_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" }'
| Campo | Requerido | Qué es |
|---|---|---|
decision | Sí | accept o reject (también aceptado o rechazado). |
rejectionReason | No | Motivo del rechazo (también detalleMotivoRechazo). |
approvalDate | No | Fecha 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. |
targetUrl | No | URL 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.status | Qué significa |
|---|---|
built | Armado, sin firmar ni enviar. |
signed | Firmado, pendiente de envío. |
sent | Enviado al emisor del documento. |
retry_scheduled | El 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_failed | La 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. |
uncertain | Pudo 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, conidempotent: true; - con
retry_scheduled, no reenvía nada mientras su reintento esté programado: responde el estado conidempotent: trueycommercialApproval.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.attemptscuenta 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ódigo | Causa | Qué hacer |
|---|---|---|
409 COMMERCIAL_APPROVAL_DECISION_CONFLICT | Ya enviaste otra decisión para ese documento. | Consulta el estado con GET. |
422 COMMERCIAL_APPROVAL_DATE_INVALID | approvalDate 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_UNCERTAIN | Un 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_DGII | Quieres 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_REJECTED | La 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_UNCERTAIN | No 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_UNAVAILABLE | No hay certificado activo para enviar a la DGII. No salió nada. | Sube o renueva tu certificado y reintenta. |
503 DIRECTORY_DGII_AUTH_FAILED | No 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_MISSING | El directorio de la DGII no se pudo consultar sin token. | Reintenta más tarde. |
503 DIRECTORY_FETCH_TIMEOUT / 503 DIRECTORY_FETCH_FAILED | El 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_FOUND | El 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_FAILED | El 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_ALLOWED | Enviaste 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:
- Emite en
TesteCFun e-CF de los que se entregan (31, 33, 34, 44 o 45), con tu propio RNC comoRNCComprador. 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. - 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, llegadocument.receivedconenvironmenttestecf. - 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.
| Ruta | Para qué |
|---|---|
POST /{ambiente}/fe/recepcion/api/ecf | Recibir 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/ecf | Recibir 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,/CerteCFo/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/responde404. - Reciben el XML como lo envía la DGII, en el campo
xmlde unmultipart/form-data, o directo en el cuerpo (application/xmlotext/xml), de hasta 5 MiB: basta para cualquier e-CF de 1000 líneas. Un cuerpo mayor responde400 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
Estado0. 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» (
Estado1) con motivo 4, «RNC Comprador no corresponde», como espera la DGII:200en la recepción y400en 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 es400con el acuse sin firmar y la cabecerax-zarela-arecf-signed: false. - En las respuestas XML,
FechaHoraRespuestava en hora de República Dominicana.
Siguiente: 5. Certifica ante la DGII.