Documentación Integración EdFactura

Integración EdFactura

Clientes, proveedores, productos, categorías, seriales, inventario, impuestos, facturas, cotizaciones, notas de débito y de crédito, órdenes de compra, gastos, pagos, importaciones y secuencias de comprobantes de un negocio de EdFactura, con la autorización de su propietario. Cada negocio se vincula desde el panel; las llaves sandbox usan su vínculo de prueba y las de producción, el real.

Aquí se muestra lo básico de 20 endpoints. Este módulo tiene 187 más, y el detalle de todos (lo que se envía, lo que se recibe, reglas, ejemplos y errores) está en el panel. Inicie sesión para verlo.
Clientes y contactos 1 Proveedores 1 Productos, variaciones y precios por grupo 1 Seriales 1 Inventario 1 Impuestos, retenciones y grupos 1 Categorías 1 Facturas 1 Cotizaciones 1 Notas de débito 1 Notas de crédito 1 Órdenes de compra 1 Gastos 1 Pagos 1 Secuencias NCF 1 Secuencias e-CF 1 e-CF emitidos 1 e-CF recibidos 1 Bitácora e-CF 1 Pedidos 1

Clientes y contactos

GET /customers Listar clientes

Lista paginada de los clientes del negocio, con filtros.

Estructura de la llamada 
curl "https://api.edfactura.com/v1/edfactura/{vinculo}/customers" \
  -H "X-API-Key: SU_API_KEY"

Proveedores

GET /vendors Listar proveedores

Lista paginada de los proveedores del negocio, con filtros.

Estructura de la llamada 
curl "https://api.edfactura.com/v1/edfactura/{vinculo}/vendors" \
  -H "X-API-Key: SU_API_KEY"

Productos, variaciones y precios por grupo

GET /products Listar productos y servicios

Lista paginada de los productos y servicios del negocio, con filtros.

Estructura de la llamada 
curl "https://api.edfactura.com/v1/edfactura/{vinculo}/products" \
  -H "X-API-Key: SU_API_KEY"

Seriales

GET /serials Listar seriales

Lista paginada de los seriales del negocio, con filtros.

Estructura de la llamada 
curl "https://api.edfactura.com/v1/edfactura/{vinculo}/serials" \
  -H "X-API-Key: SU_API_KEY"

Inventario

GET /inventory Consultar existencias

Existencias paginadas de los productos de venta, rastreables y de tipo product.

Estructura de la llamada 
curl "https://api.edfactura.com/v1/edfactura/{vinculo}/inventory" \
  -H "X-API-Key: SU_API_KEY"

Impuestos, retenciones y grupos

GET /taxes Listar impuestos y retenciones

Lista paginada de los impuestos y retenciones del negocio (activos e inactivos).

Estructura de la llamada 
curl "https://api.edfactura.com/v1/edfactura/{vinculo}/taxes" \
  -H "X-API-Key: SU_API_KEY"
Ejemplo de respuesta 
{
    "success": true,
    "data": [
        {
            "id": 300,
            "group": {
                "id": 110,
                "name": "Propina Legal"
            },
            "name": "Propina Legal",
            "rate": "10.00",
            "is_type": "OtrosImpuesto",
            "dgii_codigo": "001",
            "details": null,
            "is_active": true
        }
    ],
    "meta": {
        "pagination": {
            "limit": 50,
            "next_cursor": null,
            "has_more": false
        },
        "request_id": "9f1c2a7b3e4d5f60",
        "timestamp": "2026-10-03T10:15:00-04:00",
        "ambiente": "sandbox"
    }
}

Categorías

GET /categories Listar categorías

Lista paginada de las categorías de ingreso y de gasto del negocio, con filtros.

Estructura de la llamada 
curl "https://api.edfactura.com/v1/edfactura/{vinculo}/categories" \
  -H "X-API-Key: SU_API_KEY"
Ejemplo de respuesta 
{
    "success": true,
    "data": [
        {
            "id": 358,
            "name": "Prueba Reglas Gastos",
            "type": 2
        }
    ],
    "meta": {
        "pagination": {
            "limit": 50,
            "next_cursor": null,
            "has_more": false
        },
        "request_id": "9f1c2a7b3e4d5f60",
        "timestamp": "2026-10-03T10:15:00-04:00",
        "ambiente": "sandbox"
    }
}

Facturas

GET /invoices Listar facturas

Lista paginada de las facturas del negocio, incluidas las anuladas, con filtros.

Estructura de la llamada 
curl "https://api.edfactura.com/v1/edfactura/{vinculo}/invoices" \
  -H "X-API-Key: SU_API_KEY"

Cotizaciones

GET /estimates Listar cotizaciones

Lista paginada de las cotizaciones del negocio, con filtros.

Estructura de la llamada 
curl "https://api.edfactura.com/v1/edfactura/{vinculo}/estimates" \
  -H "X-API-Key: SU_API_KEY"

Notas de débito

GET /debit-notes Listar notas de débito

Lista paginada de las notas de débito del negocio, con filtros.

Estructura de la llamada 
curl "https://api.edfactura.com/v1/edfactura/{vinculo}/debit-notes" \
  -H "X-API-Key: SU_API_KEY"

Notas de crédito

GET /credit-notes Listar notas de crédito

Lista paginada de las notas de crédito del negocio, con filtros.

Estructura de la llamada 
curl "https://api.edfactura.com/v1/edfactura/{vinculo}/credit-notes" \
  -H "X-API-Key: SU_API_KEY"

Órdenes de compra

GET /purchase-orders Listar órdenes de compra

Lista paginada de las órdenes de compra del negocio, incluidas las anuladas, con filtros.

Estructura de la llamada 
curl "https://api.edfactura.com/v1/edfactura/{vinculo}/purchase-orders" \
  -H "X-API-Key: SU_API_KEY"

Gastos

GET /expenses Listar gastos

Lista paginada de los gastos del negocio, con filtros.

Estructura de la llamada 
curl "https://api.edfactura.com/v1/edfactura/{vinculo}/expenses" \
  -H "X-API-Key: SU_API_KEY"

Pagos

GET /payments Listar pagos

Lista paginada de los pagos del negocio, con filtros.

Estructura de la llamada 
curl "https://api.edfactura.com/v1/edfactura/{vinculo}/payments" \
  -H "X-API-Key: SU_API_KEY"

Secuencias NCF

GET /ncf-sequences Listar secuencias NCF

Lista paginada de las secuencias NCF del negocio, con su disponibilidad y vigencia.

Estructura de la llamada 
curl "https://api.edfactura.com/v1/edfactura/{vinculo}/ncf-sequences" \
  -H "X-API-Key: SU_API_KEY"
Ejemplo de respuesta 
{
    "success": true,
    "data": [
        {
            "id": 26,
            "ncf_type_id": 13,
            "type_name": "Regímenes Especiales de Tributación",
            "prefix": "B14",
            "start": 23,
            "end": 35,
            "next": 25,
            "next_ncf": "B1400000025",
            "available": 11,
            "validity_from": "2023-01-01",
            "validity_to": "2024-12-31",
            "status": "inactive",
            "exhausted": false,
            "low_stock": false,
            "expired": true,
            "usable": false
        }
    ],
    "meta": {
        "pagination": {
            "limit": 50,
            "next_cursor": null,
            "has_more": false
        },
        "request_id": "9f1c2a7b3e4d5f60",
        "timestamp": "2026-10-03T10:15:00-04:00",
        "ambiente": "sandbox"
    }
}

Secuencias e-CF

GET /ecf-sequences Listar secuencias e-CF

Lista paginada de las secuencias e-CF del negocio, con su disponibilidad y vigencia.

Estructura de la llamada 
curl "https://api.edfactura.com/v1/edfactura/{vinculo}/ecf-sequences" \
  -H "X-API-Key: SU_API_KEY"
Ejemplo de respuesta 
{
    "success": true,
    "data": [
        {
            "id": 51,
            "ecf_type": 31,
            "type_name": "Factura de Crédito Fiscal Electrónica",
            "prefix": "E31",
            "start": 100,
            "end": 1000,
            "current": 139,
            "next": 140,
            "next_encf": "E310000000140",
            "available": 861,
            "validity_from": "2026-06-01",
            "validity_to": "2028-12-31",
            "authorization_number": "",
            "status": "active",
            "expired": false,
            "usable": true,
            "low_stock": false,
            "expiring_soon": false
        }
    ],
    "meta": {
        "pagination": {
            "limit": 50,
            "next_cursor": null,
            "has_more": false
        },
        "request_id": "9f1c2a7b3e4d5f60",
        "timestamp": "2026-10-03T10:15:00-04:00",
        "ambiente": "sandbox"
    }
}

e-CF emitidos

GET /ecf-documents Listar e-CF emitidos

Lista paginada de los e-CF emitidos por el negocio, sin el XML.

Estructura de la llamada 
curl "https://api.edfactura.com/v1/edfactura/{vinculo}/ecf-documents" \
  -H "X-API-Key: SU_API_KEY"

e-CF recibidos

GET /ecf-received Listar e-CF recibidos

Lista paginada de los e-CF que otros emisores enviaron al negocio, sin el XML.

Estructura de la llamada 
curl "https://api.edfactura.com/v1/edfactura/{vinculo}/ecf-received" \
  -H "X-API-Key: SU_API_KEY"

Bitácora e-CF

GET /ecf-logs Listar la bitácora e-CF

Lista paginada de las comunicaciones e-CF del negocio con la DGII y con los receptores, sin los cuerpos.

Estructura de la llamada 
curl "https://api.edfactura.com/v1/edfactura/{vinculo}/ecf-logs" \
  -H "X-API-Key: SU_API_KEY"

Pedidos

GET /orders Listar pedidos

Lista paginada de los pedidos del negocio, sin sus líneas.

Estructura de la llamada 
curl "https://api.edfactura.com/v1/edfactura/{vinculo}/orders" \
  -H "X-API-Key: SU_API_KEY"