Saltar al contenido principal

Consulta de Estado y Descarga de Evidencias Fiscales

Etribux conserva la custodia digital de cada Comprobante Fiscal Electrónico procesado, permitiendo consultar su estado ante la DGII y descargar las evidencias oficiales requeridas por la ley: XML original firmado, Representación Impresa en PDF y Código QR.

Consultar Estado de un e-CF​

GET /{environment}/api/v1/documents/{id_or_encf}

Puedes consultar tanto por el UUID interno de Etribux (id) como por el e-NCF asignado (ej. E310000000001).

curl -X GET "https://api.etribux.com/testecf/api/v1/documents/E310000000001" \
  -H "Authorization: Bearer <TU_API_KEY>"

Respuesta:​

{
  "id": "e9a0f443-4c90-41fa-8a56-dc0d6df6cf80",
  "external_id": "FAC-2026-001",
  "environment": "testecf",
  "ecf_type": 31,
  "encf": "E310000000001",
  "issue_date": "16-09-2026",
  "total_amount": "11800.00",
  "security_code": "wK9L2x",
  "qr_url": "https://ecf.dgii.gov.do/testecf/consultatimbre?RncEmisor=...",
  "track_id": "89b2-4d1a-98fe",
  "dgii_status": "accepted",
  "commercial_status": "approved",
  "dgii_messages": []
}

Descargar el XML Firmado Oficial​

GET /{environment}/api/v1/documents/{id_or_encf}/xml

Devuelve el documento XML con la firma digital en estándar XMLDSig (Enveloped) canónico según las especificaciones de la DGII.

curl -X GET "https://api.etribux.com/testecf/api/v1/documents/E310000000001/xml" \
  -H "Authorization: Bearer <TU_API_KEY>" \
  -o E310000000001.xml

Descargar Representación Impresa (PDF)​

GET /{environment}/api/v1/documents/{id_or_encf}/pdf

Genera y descarga en tiempo real el PDF de la Representación Impresa oficial, formateado con el diseño estandarizado por la DGII:

  • Datos del Emisor y Comprador.
  • Desglose de Ítems e Indicadores de Facturación.
  • Totales y Retenciones.
  • Código de Seguridad de 6 caracteres.
  • Código QR impreso en alta resolución legible por la aplicación móvil oficial de la DGII.
curl -X GET "https://api.etribux.com/testecf/api/v1/documents/E310000000001/pdf" \
  -H "Authorization: Bearer <TU_API_KEY>" \
  -o factura_E310000000001.pdf