EdFactura API · para desarrolladores

Tu sistema y EdFactura, trabajando juntos

EdFactura API (api.edfactura.com) es el servicio que permite que tu tienda en línea, tu ERP o tu aplicación trabajen con tu negocio de EdFactura y con los datos fiscales de la República Dominicana, sin entrar al panel y solo con los permisos que tú autorices.

Cómo se integra Ir a api.edfactura.com
REST · JSONrespuestas uniformes
Pruebasambiente aparte
Permisoslos decides tú
Qué es

Una API, dos usos

Sirve para consultar y validar datos fiscales dominicanos, y también para operar tu negocio de EdFactura desde tu propio software.

Sin cuenta en EdFactura

Datos fiscales de RD

Consultas y validaciones que cualquier sistema necesita, tengas o no una cuenta en EdFactura.

  • Contribuyentes por RNC o cédula, según el padrón de la DGII
  • Verificación de NCF y e-CF
  • Cálculo de ITBIS, retenciones, ISR, TSS y prestaciones
  • Validación de los archivos 606, 607, 608 y 609 antes de enviarlos
  • Tasas de cambio del Banco Central
Con EdFactura

Tu negocio, desde tu sistema

Lo que hoy haces en el panel puede hacerlo tu propio software, con tu permiso y hasta donde tú decidas.

  • Facturas, cotizaciones y notas de crédito o de débito
  • Emisión de e-CF y consulta de su estado
  • Clientes, productos, precios y existencias al día
  • Gastos, órdenes de compra y pagos
Facturación electrónica · e-CF

API de facturación electrónica para República Dominicana

Emite comprobantes fiscales electrónicos (e-CF) ante la DGII desde tu propio software. Tu sistema envía los datos de la venta y EdFactura se encarga del resto: asigna el e-NCF, genera el XML, lo firma con el certificado digital del negocio y lo transmite a la DGII.

No tienes que construir ni mantener la firma digital, la comunicación con la DGII ni el control de secuencias: tu sistema trabaja con una API REST en JSON y recibe el resultado de cada comprobante.

Empezar en api.edfactura.com Certificación e-CF

  • Emisión de e-CF al facturar

    Facturas de crédito fiscal y de consumo, notas de crédito y de débito electrónicas, cada una con su e-NCF.

  • Estado ante la DGII

    Consulta la respuesta de la DGII para cada e-CF emitido y descarga su XML firmado.

  • Entrega, reintento y anulación

    Entrega el e-CF al receptor, reintenta un envío que no se completó o anula un comprobante.

  • e-CF recibidos

    Consulta los comprobantes electrónicos que te emiten tus proveedores y responde su aprobación comercial.

Para emitir e-CF con validez fiscal, el negocio debe estar habilitado como emisor electrónico en EdFactura. En el ambiente de pruebas el e-CF se genera con su e-NCF, pero no se envía a la DGII ni tiene validez fiscal, así que puedes desarrollar tu integración completa antes de pasar a producción.
Estructura de la integración

Cómo se conecta con EdFactura

Tu sistema nunca entra directo a tu negocio: habla con la API, y la API solo llega hasta donde el propietario autorizó.

Una cuenta en la API

La API tiene su propio panel y su propia cuenta, separados de tu cuenta de EdFactura. Incluye un ambiente de pruebas desde el primer día.

El propietario autoriza

Al vincular un negocio, EdFactura muestra al propietario qué permisos se piden. Él acepta, y puede quitar cualquiera antes de autorizar.

Llaves con permisos

Tu sistema se identifica con una llave que lleva solo los permisos que necesita. Lectura y escritura se conceden por separado.

Tu sistema opera

Lo que tu sistema crea o cambia queda en tu negocio de EdFactura, junto a lo que haces en el panel, con los mismos comprobantes y reportes.

Pruebas y producción, separadas Cada ambiente tiene su propio vínculo y sus propias llaves. En pruebas, un e-CF no se envía a la DGII ni tiene validez fiscal.
El control es del propietario El vínculo se puede revocar en cualquier momento, y con él termina el acceso de tu sistema al negocio.
Sin documentos duplicados Si la conexión falla y tu sistema repite un envío, la API lo reconoce y no crea la misma factura dos veces.
Alcance

Qué se puede hacer en EdFactura desde la API

Cada bloque es un permiso distinto: tu sistema recibe solo los que su trabajo requiere.

Clientes y proveedores

Alta y actualización de clientes con sus contactos, y de tus proveedores, desde tu CRM o tu tienda.

Productos e inventario

Productos con variaciones y precios por grupo, seriales y ajustes de existencias.

Cotizaciones y facturas

Cotizaciones que se convierten en factura, facturas con NCF o e-CF y facturas recurrentes.

Notas de crédito y de débito

Devoluciones, descuentos y ajustes sobre una factura, enlazados a su documento de origen.

Compras y gastos

Órdenes de compra a tus proveedores y registro de gastos por categoría.

Pagos

Registro de los pagos de tus facturas y consulta de sus recibos.

Comprobantes fiscales

Secuencias NCF y e-CF, estado de cada e-CF emitido y los comprobantes que recibes de otros emisores.

Pedidos

Pedidos que llegan desde tu canal de venta y se facturan cuando están listos.

Importaciones y catálogos

Carga de registros por lotes y consulta de impuestos, categorías, monedas y formas de pago del negocio.

Seguridad y control

Tu negocio sigue en tus manos

La API está pensada para que un sistema externo trabaje con tus datos sin que pierdas de vista qué hace.

  • Cada llave se muestra una sola vez y se puede revocar al instante
  • Las llaves se pueden limitar a tus dominios o a tus direcciones IP
  • Fecha de vencimiento opcional por llave
  • Registro de cada petición, visible en el panel de la API
  • Límites de uso que protegen tu negocio de un sistema mal configurado

Qué hace falta

Para consultar datos fiscales basta una cuenta en la API. Para trabajar con tu negocio hace falta, además, que tu suscripción de EdFactura incluya la Integración API y que tu plan de la API la contemple. La conexión siempre la autoriza el propietario del negocio. EdFactura API no es un servicio oficial de la DGII.

¿Quieres integrar tu sistema?

La cuenta, las llaves, la documentación y las bibliotecas para PHP, .NET, Python y JavaScript están en api.edfactura.com. Si tienes dudas sobre qué conectar, te orientamos.

Ir a api.edfactura.com → Hablar con nosotros