Puente Factura
Volver a Puente

DOCUMENTACIÓN · VISTA INICIAL

Una API. El recorrido completo.

Estamos construyendo nuestra propia infraestructura de facturación electrónica dominicana. El panel de empresas, el espacio del contador y las integraciones comparten el mismo núcleo.

La plataforma está en desarrollo. Esta guía explica la dirección del producto y la prueba local. Todavía no hay API pública de producción ni emisión fiscal disponible.

Empieza por tu forma de trabajar

Empresa

Prepara borradores, invita a tu contador y revisa cada factura antes de continuar. El estado fiscal, la entrega y el pago se siguen por separado.

Contador

Trabaja con las empresas que te han dado acceso. Revisa documentos y pendientes dentro del contexto de cada cliente.

Desarrollador

Integra el mismo recorrido desde tu software. El diseño contempla permisos por empresa, validación, seguimiento y recuperación de documentos.

EJEMPLO LOCAL · DATOS FICTICIOS

Empieza con una solicitud.

Cliente y conceptos juntos. Los importes se calculan en el servidor y el resultado inicial es un borrador para revisar.

Envía una Idempotency-Key única y conserva la misma clave para los reintentos.

Para la emisión de prueba en un solo paso, action: issue requiere approvalTotal con el importe exacto que autorizaste. La firma y el resultado se consultan en la operación original.

POST /api/v1/invoices
{
  "mode": "test",
  "issuerId": "empresa-a",
  "externalId": "venta-ejemplo-001",
  "action": "draft",
  "customer": {
    "name": "Cliente Ficticio",
    "taxId": "DEMO-EJEMPLO",
    "email": "cliente@ejemplo.test"
  },
  "items": [
    {
      "description": "Servicio ficticio",
      "unitPrice": "1000.00",
      "tax": 18
    }
  ],
  "dueDate": "2026-11-01"
}

El contrato local, hoy

Estas rutas pertenecen a la prueba local con datos ficticios. Son una referencia de trabajo, no endpoints públicos ni un contrato de producción estable.

POST/api/v1/invoices

Cliente y conceptos en una solicitud

POST/api/invoices/{id}/review

Solicitar revisión

POST/api/invoices/{id}/approve

Aprobar una versión

POST/api/invoices/{id}/submit

Iniciar una emisión simulada

GET/api/operations/{id}

Consultar el resultado

GET/api/invoices/{id}/documents/{format}

Recuperar el documento de prueba

GET/api/webhooks

Consultar eventos y entregas

POST/api/webhooks

Pausar, reanudar o reenviar un evento

Una interrupción no debería obligarte a empezar de nuevo.

En la prueba local, los eventos se guardan con el cambio de la factura. Tres entregas fallidas pausan la conexión; reanudar o reenviar conserva el mismo evento. La entrega puede repetirse: el receptor debe deduplicar por ID.

event.created→retry→paused→replay

Lo que debe ser claro desde la primera integración

01

Acceso por empresa

Cada persona o integración debe tener permiso para la empresa con la que trabaja. Un inicio de sesión no concede acceso a todas las facturas.

02

Reintentos sin duplicados

La prueba local utiliza una clave de idempotencia y la versión aprobada al solicitar una emisión. Una respuesta pendiente se consulta antes de repetir la operación.

03

Estados que explican lo que pasó

Una solicitud recibida, una aceptación fiscal, una entrega y un pago son eventos distintos. Puente los mantiene separados.

04

Documentos e historial

El objetivo es conservar los documentos y resultados originales, enlazar las correcciones y facilitar la recuperación de información.

Lo que falta antes del acceso público

Completar y verificar el motor fiscal, la conexión directa con DGII, los requisitos de operación, el entorno público de pruebas y la documentación estable. Las pruebas locales no acreditan una autorización fiscal.

¿Quieres integrar Puente?

Cuéntanos qué software desarrollas y qué recorrido necesitas resolver.

Hablar de una integración
Puente Factura · Un producto de Super Intelligence Group, desarrollado por Applied SI.@puente.factura