API de TaxFlow — Documentación

Inicio rápido

Genera una clave. En el panel, entra a Integraciones (menú lateral, bajo Cumplimiento) y pulsa Generar clave de API. Elige Solo lectura si solo vas a extraer datos. La clave se muestra una sola vez: guárdala en tu servidor.
Comprueba que funciona con GET /yo:

curl https://taxflow.com.do/api/yo \
  -H "Authorization: Bearer tf_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Emite tu primera factura con POST /facturas:

curl -X POST https://taxflow.com.do/api/facturas \
  -H "Authorization: Bearer $TAXFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ncf_tipo": "B02",
    "cliente_nombre": "Consumidor final",
    "items": [{ "descripcion": "Almuerzo ejecutivo", "cantidad": 2, "precio": 450, "itbis_tasa": 18 }]
  }'

La respuesta trae la factura con su NCF asignado (B0200000001), los totales calculados y su id para descargar el PDF o enviarla por correo.

Autenticación

Cada petición lleva la clave en la cabecera Authorization con el esquema Bearer. Las claves empiezan por tf_live_. Solo por HTTPS.

Authorization: Bearer tf_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Una clave = una empresa

La clave pertenece a la empresa donde se generó y solo ve sus datos. Si administras varias empresas, genera una clave en cada una.

Actúa con el rol de quien la creó

Las claves las genera un Administrador. En cada petición se vuelve a leer su rol en la empresa: si lo degradan o le quitan el acceso, la clave pierde lo mismo al instante.

Permiso de la clave

Solo lectura: solo peticiones GET (consultas, PDF, exportaciones). Lectura y escritura: además crea, modifica, envía y anula.

Revocación inmediata

Desde Integraciones puedes revocar una clave en cualquier momento; la siguiente petición con ella recibe 401. TaxFlow guarda solo una huella (SHA-256) de la clave, nunca la clave en sí.

Nunca pongas la clave en una página web, una app móvil o un repositorio público: úsala solo desde tu servidor. Los recursos de la cuenta (perfil, planes, colaboradores, asistente y las propias claves) no se pueden usar con una clave.

Respuestas y errores

Todas las respuestas son JSON en UTF-8 con la misma envoltura. Las descargas (PDF y Excel) son la excepción: devuelven el archivo.

Éxito · HTTP 200

{
    "ok": true,
    "data": {
        "…": "…"
    }
}

Error · HTTP 4xx / 5xx

{
    "ok": false,
    "error": "Revisa los datos de la factura.",
    "errors": {
        "cliente_nombre": "Indica el cliente."
    },
    "codigo": null
}

error es un mensaje listo para mostrar; errors trae los errores por campo (en 422); codigo, cuando existe, es estable para programar contra él.

HTTP	codigo	Significado
`400`	—	Petición mal formada.
`401`	`no_autenticado`	No se envió la cabecera `Authorization`.
`401`	`clave_invalida`	La clave no existe, fue revocada, o su cuenta o empresa están desactivadas.
`402`	`plan_*`	La función no está incluida en el plan de la cuenta titular de la empresa.
`403`	`clave_solo_lectura`	La clave es de solo lectura y la petición no es GET.
`403`	`fuera_de_alcance`	El recurso es de la cuenta (perfil, planes, colaboradores, asistente, claves) y no se usa con una clave.
`403`	`sin_permiso`	El rol de la cuenta de la clave no permite esa acción (p. ej. cargar secuencias sin ser Administrador).
`404`	—	El recurso o el documento no existe en la empresa de la clave.
`409`	—	Conflicto con el estado actual: secuencia agotada, factura ya anulada, cotización cerrada…
`422`	—	Datos inválidos. `errors` trae un mensaje por campo.
`429`	`limite_excedido`	Se superó el límite de peticiones por minuto. Espera lo que indique `Retry-After`.
`500`	—	Error nuestro. Reintenta; si persiste, escríbenos.
`502`	—	Un servicio externo (el correo) rechazó la operación.

Límites y convenciones

Límite de peticiones	120 por minuto por clave. Cada respuesta trae `X-RateLimit-Limit`, `X-RateLimit-Remaining` y `X-RateLimit-Reset` (epoch). Al pasarte: `429` con `Retry-After`.
Listados	Los listados de documentos aceptan `limite` (1–500, predeterminado 100) y filtros `desde`/`hasta`: para extraer un periodo grande, pide ventanas de fechas. Las exportaciones 606/607 no tienen límite.
Fechas	`YYYY-MM-DD`. Fechas con hora: `YYYY-MM-DD HH:MM:SS`, hora de Santo Domingo (UTC−4).
Montos	Se devuelven como texto decimal (`"3540.00"`) para no perder precisión; conviértelos a decimal, no a float, si vas a sumar. Los totales siempre los calcula el servidor: no se aceptan del cliente.
Monedas	`DOP` y `USD`. Los montos van en la moneda del documento y `tasa_cambio` dice cuántos pesos vale una unidad; en pesos es 1. El equivalente en RD$ es `total × tasa_cambio`.
Identificadores	UUID en texto (`26f69a58-f683-40d8-b92e-630654bdb5db`).
Cuerpos	JSON con `Content-Type: application/json`. Las subidas de archivos, `multipart/form-data`.
Notificaciones	Lo que se hace por la API dispara los mismos avisos por correo y push que el panel (factura creada, anulada, gasto registrado…).

Catálogos

Códigos que aceptan y devuelven los endpoints.

Tipos de NCF que se emiten (`ncf_tipo`)

`B01`	Credito Fiscal
`B02`	Consumo
`B03`	Nota de Debito
`B04`	Nota de Credito
`B11`	Comprobante de Compras
`B12`	Registro Unico de Ingresos
`B13`	Gastos Menores
`B14`	Regimenes Especiales
`B15`	Gubernamental
`B16`	Exportaciones
`B17`	Pagos al Exterior

Estados de una factura

`emitida`	Emitida
`recibida`	Recibida
`pagada`	Pagada
`anulada`	Anulada

Estados de una cotización

`borrador`	Borrador
`enviada`	Enviada
`aceptada`	Aceptada
`rechazada`	Rechazada
`facturada`	Facturada

Estados de un gasto

`pendiente`	Pendiente de pago
`pagado`	Pagado
`anulado`	Anulado

Clasificación 606 del gasto (`tipo_bien`)

`01`	Gastos de personal
`02`	Gastos por trabajos, suministros y servicios
`03`	Arrendamientos
`04`	Gastos de activos fijos
`05`	Gastos de representación
`06`	Otras deducciones admitidas
`07`	Gastos financieros
`08`	Gastos extraordinarios
`09`	Compras y gastos que forman parte del costo de venta
`10`	Adquisiciones de activos
`11`	Gastos de seguros

Formas de pago (`forma_pago`)

`01`	Efectivo
`02`	Cheque / transferencia / depósito
`03`	Tarjeta de crédito o débito
`04`	Compra a crédito
`05`	Permuta
`06`	Nota de crédito
`07`	Mixto

Retención ISR del gasto (`tipo_retencion_isr`)

`01`	Alquileres
`02`	Honorarios por servicios
`03`	Otras rentas
`04`	Otras rentas (rentas presuntas)
`05`	Intereses pagados a personas jurídicas residentes
`06`	Intereses pagados a personas físicas residentes
`07`	Retención por proveedores del Estado
`08`	Juegos telefónicos

Tipos de NCF que se reciben de un proveedor

`B01`	Credito Fiscal
`B02`	Consumo
`B03`	Nota de Debito
`B04`	Nota de Credito
`B11`	Comprobante de Compras
`B13`	Gastos Menores
`B14`	Regimenes Especiales
`B15`	Gubernamental
`B16`	Exportaciones
`B17`	Pagos al Exterior
`E31`	Factura de Credito Fiscal Electronica
`E32`	Factura de Consumo Electronica
`E33`	Nota de Debito Electronica
`E34`	Nota de Credito Electronica
`E41`	Compras Electronico
`E43`	Gastos Menores Electronico
`E44`	Regimenes Especiales Electronico
`E45`	Gubernamental Electronico
`E46`	Exportaciones Electronico
`E47`	Pagos al Exterior Electronico

Retenciones de una factura (`tipo`)

`isr_servicios_profesionales`	ISR — Servicios profesionales a persona física · 10 %
`isr_servicios_tecnicos`	ISR — Servicios técnicos a persona física · 2 %
`itbis_persona_fisica`	ITBIS — Persona física · 100 %
`itbis_profesional_liberal`	ITBIS — Profesional liberal entre personas jurídicas · 30 %
`itbis_alquiler_muebles`	ITBIS — Alquiler de bienes muebles entre personas jurídicas · 30 %
`itbis_seguridad_vigilancia`	ITBIS — Seguridad / vigilancia · 100 %
`itbis_rst`	ITBIS — RST · 100 %

Roles (los de la cuenta que creó la clave)

`admin`	Administrador — Acceso total: factura, configura la numeración, gestiona los colaboradores y las integraciones (claves de API) de la empresa.
`facturador`	Facturador — Emite facturas y cotizaciones y mantiene clientes y catálogo. No cambia la numeración ni los accesos.
`gestor_gastos`	Gestor de gastos — Solo registra gastos y mantiene proveedores. Ve únicamente los gastos que él mismo registró, y no entra a facturas, clientes ni configuración.
`consulta`	Consulta — Solo lectura: puede ver y descargar documentos, pero no crear ni modificar nada.

Ejemplos de código

Extraer las facturas de un mes, en tu lenguaje. Guarda la clave en una variable de entorno (TAXFLOW_KEY), no en el código.

const res = await fetch('https://taxflow.com.do/api/facturas?desde=2026-09-01&hasta=2026-09-30&limite=500', {
  headers: { Authorization: `Bearer ${process.env.TAXFLOW_KEY}` },
});
const body = await res.json();
if (!body.ok) throw new Error(`${res.status} ${body.codigo ?? ''} ${body.error}`);

for (const f of body.data.facturas) {
  console.log(f.ncf, f.cliente_nombre, f.total, f.estado);
}

$ch = curl_init('https://taxflow.com.do/api/facturas?desde=2026-09-01&hasta=2026-09-30&limite=500');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . getenv('TAXFLOW_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (!$body['ok']) {
    throw new RuntimeException($body['error']);
}
foreach ($body['data']['facturas'] as $f) {
    echo $f['ncf'], ' ', $f['cliente_nombre'], ' ', $f['total'], PHP_EOL;
}

import os, requests

r = requests.get(
    "https://taxflow.com.do/api/facturas",
    params={"desde": "2026-09-01", "hasta": "2026-09-30", "limite": 500},
    headers={"Authorization": f"Bearer {os.environ['TAXFLOW_KEY']}"},
    timeout=30,
)
body = r.json()
if not body["ok"]:
    raise RuntimeError(body["error"])

for f in body["data"]["facturas"]:
    print(f["ncf"], f["cliente_nombre"], f["total"], f["estado"])

curl "https://taxflow.com.do/api/facturas?desde=2026-09-01&hasta=2026-09-30&limite=500" \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Flujo completo: registrar un gasto con su comprobante

# 1) Sube la foto del comprobante
curl -X POST https://taxflow.com.do/api/adjuntos -H "Authorization: Bearer $TAXFLOW_KEY" -F [email protected]
#    → { "ok": true, "data": { "id": "cf7f6ec6-…", ... } }

# 2) Registra el gasto con ese adjunto_id
curl -X POST https://taxflow.com.do/api/gastos -H "Authorization: Bearer $TAXFLOW_KEY" -H "Content-Type: application/json" \
  -d '{"proveedor_documento":"101001577","proveedor_nombre":"Ferretería Ochoa","ncf":"B0100000123",
       "tipo_bien":"02","monto_bienes":1000,"itbis_facturado":180,"adjunto_id":"cf7f6ec6-…"}'

# 3) Al cierre del mes, descarga el 606
curl "https://taxflow.com.do/api/gastos/exportar?desde=2026-09-01&hasta=2026-09-30" -H "Authorization: Bearer $TAXFLOW_KEY" -o 606.xlsx

Primeros pasos

Verificar la clave

La primera llamada para comprobar que tu clave funciona: dice con qué cuenta, empresa, rol y permiso se está autenticando.

GET/yoQuién soy

GET /yo

Quién soy

Devuelve la clave, la cuenta que la creó, la empresa a la que pertenece y el rol con el que actúa.

Petición

curl https://taxflow.com.do/api/yo \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Respuesta

{
    "ok": true,
    "data": {
        "autenticacion": "clave_api",
        "clave": {
            "id": "d361fd2d-df38-473e-9bcf-3b3cec42fc78",
            "nombre": "Tienda en línea",
            "permiso": "escritura",
            "limite_minuto": 120
        },
        "usuario": {
            "id": "9b56432a-ac61-4cac-a8a8-2213254f196d",
            "nombre": "María Pérez",
            "email": "[email protected]"
        },
        "empresa": {
            "id": "3f5a5b15-1014-48e5-9653-d68862d6c9b8",
            "razon_social": "Mi Empresa SRL",
            "nombre_comercial": null,
            "tipo_persona": "juridica",
            "documento": "131246796",
            "documento_formateado": "1-31-24679-6",
            "rol": "admin",
            "rol_nombre": "Administrador",
            "permisos": [
                "operar",
                "gestionar_numeracion",
                "gestionar_empresa",
                "gestionar_equipo",
                "gestionar_integraciones"
            ]
        }
    }
}

Empresa

Los datos fiscales de la empresa de la clave: los que salen impresos en facturas y cotizaciones. Una clave solo ve su empresa.

GET/empresasVer la empresa PUT/empresas/{id}Actualizar la empresa POST/empresas/{id}/logoSubir el logo DELETE/empresas/{id}/logoQuitar el logo

GET /empresas

Ver la empresa

Devuelve la empresa de la clave (en una lista de un elemento, igual que el panel) y el catálogo de tipos de persona.

Petición

curl https://taxflow.com.do/api/empresas \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Respuesta

{
    "ok": true,
    "data": {
        "empresas": [
            {
                "id": "3f5a5b15-1014-48e5-9653-d68862d6c9b8",
                "rnc": "131246796",
                "tipo_persona": "juridica",
                "razon_social": "Mi Empresa SRL",
                "nombre_comercial": "Mi Empresa",
                "direccion": "Calle El Sol 45, Santiago",
                "telefono": "809-555-0199",
                "email": "[email protected]",
                "logo_url": "https://taxflow.com.do/uploads/logos/….png",
                "sello_pagada": true,
                "documento_etiqueta": "RNC",
                "documento_formateado": "1-31-24679-6",
                "rol": "admin"
            }
        ],
        "tipos": {
            "juridica": "Persona jurídica",
            "fisica": "Persona física"
        }
    }
}

PUT /empresas/{id} escritura

Actualizar la empresa

Requiere rol Administrador.

Reemplaza los datos fiscales. Los campos opcionales que no mandes quedan vacíos, salvo sello_pagada, que conserva su valor.

Cuerpo

`razon_social` obligatorio	string	Razón social, o nombre completo si es persona física.
`rnc` obligatorio	string	RNC (9 dígitos) o cédula (11 dígitos) según `tipo_persona`.
`tipo_persona`	string	`juridica` o `fisica`.
`nombre_comercial`	string
`direccion`	string
`telefono`	string
`email`	string
`sello_pagada`	boolean	Imprimir el sello «PAGADA» en el PDF de las facturas pagadas.

Petición

curl -X PUT https://taxflow.com.do/api/empresas/{id} \
  -H "Authorization: Bearer $TAXFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "razon_social": "Mi Empresa SRL",
    "rnc": "131246796",
    "tipo_persona": "juridica",
    "nombre_comercial": "Mi Empresa",
    "email": "[email protected]"
}'

POST /empresas/{id}/logo escritura

Subir el logo

Requiere rol Administrador. Cuerpo multipart/form-data.

Reemplaza el logo que sale en el PDF y en los correos. Campo multipart logo (imagen).

Petición

curl -X POST https://taxflow.com.do/api/empresas/{id}/logo \
  -H "Authorization: Bearer $TAXFLOW_KEY" \
  -F [email protected]

DELETE /empresas/{id}/logo escritura

Quitar el logo

Requiere rol Administrador.

Borra el logo de la empresa.

Petición

curl -X DELETE https://taxflow.com.do/api/empresas/{id}/logo \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Reportes

Indicadores

Los mismos números del Inicio del panel. Todo se agrega en pesos: un documento en dólares se convierte con la tasa guardada en él, no con la de hoy.

GET/dashboardKPIs de ventas y gastos

GET /dashboard

KPIs de ventas y gastos

Facturado, ITBIS, anuladas, gastos, por pagar, balance, serie diaria (o mensual) para gráficos, reparto por tipo de comprobante, estado de las secuencias y las últimas facturas.

Parámetros de consulta

`rango`	string	`hoy` · `semana` · `mes` (predeterminado) · `anio` · `rango`.
`desde`	date	Con `rango=rango`. `YYYY-MM-DD`.
`hasta`	date	Con `rango=rango`. Un rango de más de 62 días se agrupa por mes.

Petición

curl https://taxflow.com.do/api/dashboard \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Respuesta

{
    "ok": true,
    "data": {
        "rango": "mes",
        "desde": "2026-09-01",
        "hasta": "2026-09-28",
        "kpis": {
            "emitidas": 42,
            "facturado": 385400.5,
            "itbis": 58790.2,
            "anuladas": 1,
            "clientes": 18,
            "productos": 36
        },
        "gastos": {
            "cantidad": 27,
            "total": 121300,
            "itbis": 17800,
            "por_pagar": 24500,
            "pendientes": 4,
            "balance": 264100.5
        },
        "barras": [
            {
                "fecha": "2026-09-28",
                "etiqueta": "28",
                "cantidad": 3,
                "monto": 21240,
                "gasto": 1180
            }
        ],
        "barras_por": "dia",
        "por_tipo": [
            {
                "tipo_documento": "fiscal",
                "ncf_tipo": "B01",
                "cantidad": 30,
                "monto": 301000,
                "nombre": "Credito Fiscal"
            }
        ],
        "secuencias": [
            "…"
        ],
        "numeracion": [
            "…"
        ],
        "recientes": [
            "…"
        ]
    }
}

Ventas

Facturas

Dos tipos de documento: fiscal, con NCF de la DGII tomado de tus secuencias (B01, B02, B14…), e interna, sin valor fiscal, con tu numeración propia (FAC00000065). Los totales siempre los calcula el servidor. Una factura emitida no se edita ni se borra: se anula, y su NCF queda reportado como anulado.

GET/facturasListar facturas GET/facturas/{id}Ver una factura POST/facturasEmitir una factura POST/facturas/{id}/estadoCambiar el estado POST/facturas/{id}/anularAnular GET/facturas/{id}/pdfDescargar el PDF POST/facturas/{id}/enviarEnviar por correo GET/facturas/{id}/enviosHistorial de correos POST/facturas/{id}/envios/{envio}/cancelarCancelar un envío programado GET/facturas/{id}/historialLínea de tiempo del estado GET/facturas/{id}/retencionesRetenciones POST/facturas/{id}/retencionesRegistrar una retención DELETE/facturas/{id}/retenciones/{retencion}Quitar una retención GET/facturas/{id}/adjuntosArchivos de la factura POST/facturas/{id}/adjuntosAdjuntar un archivo DELETE/facturas/{id}/adjuntos/{adjunto}Borrar un archivo GET/facturas/exportarExportar el 607

GET /facturas

Listar facturas

Las más recientes primero. Para extraer un periodo completo usa desde/hasta y limite=500, o la exportación 607.

Parámetros de consulta

`q`	string	Busca en NCF, nombre y documento del cliente.
`estado`	string	`emitida` · `recibida` · `pagada` · `anulada`.
`tipo_documento`	string	`fiscal` o `interna`.
`moneda`	string	`DOP` o `USD`.
`desde`	date	Fecha de emisión desde (incluida).
`hasta`	date	Fecha de emisión hasta (incluida).
`limite`	int	De 1 a 500. Predeterminado 100.

Petición

curl https://taxflow.com.do/api/facturas \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Respuesta

{
    "ok": true,
    "data": {
        "facturas": [
            {
                "id": "26f69a58-f683-40d8-b92e-630654bdb5db",
                "tipo_documento": "fiscal",
                "ncf": "B0100000150",
                "ncf_tipo": "B01",
                "numero": 150,
                "cliente_id": "88129800-d743-4682-a9a1-2073a48de7f9",
                "cliente_nombre": "Distribuidora Caribe SRL",
                "cliente_documento": "131246796",
                "cliente_tipo_documento": "RNC",
                "fecha": "2026-09-28",
                "vencimiento": "2026-10-28",
                "condicion_pago": "credito",
                "moneda": "DOP",
                "tasa_cambio": "1.000000",
                "subtotal": "3000.00",
                "descuento": "0.00",
                "itbis": "540.00",
                "total": "3540.00",
                "estado": "emitida",
                "estado_nombre": "Emitida",
                "anulada": false,
                "pagada": false,
                "motivo_anulacion": null,
                "recibida_en": null,
                "pagada_en": null,
                "notas": null,
                "creado_en": "2026-09-28 09:14:03"
            }
        ],
        "estados": [
            {
                "codigo": "emitida",
                "nombre": "Emitida",
                "asignable": true
            }
        ]
    }
}

GET /facturas/{id}

Ver una factura

La factura completa: líneas (items), correos enviados y sus aperturas (envios), línea de tiempo del estado (historial), archivos (adjuntos) y retenciones con su resumen.

Petición

curl https://taxflow.com.do/api/facturas/{id} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Respuesta

{
    "ok": true,
    "data": {
        "id": "26f69a58-f683-40d8-b92e-630654bdb5db",
        "tipo_documento": "fiscal",
        "ncf": "B0100000150",
        "ncf_tipo": "B01",
        "numero": 150,
        "cliente_id": "88129800-d743-4682-a9a1-2073a48de7f9",
        "cliente_nombre": "Distribuidora Caribe SRL",
        "cliente_documento": "131246796",
        "cliente_tipo_documento": "RNC",
        "fecha": "2026-09-28",
        "vencimiento": "2026-10-28",
        "condicion_pago": "credito",
        "moneda": "DOP",
        "tasa_cambio": "1.000000",
        "subtotal": "3000.00",
        "descuento": "0.00",
        "itbis": "540.00",
        "total": "3540.00",
        "estado": "emitida",
        "estado_nombre": "Emitida",
        "anulada": false,
        "pagada": false,
        "motivo_anulacion": null,
        "recibida_en": null,
        "pagada_en": null,
        "notas": null,
        "creado_en": "2026-09-28 09:14:03",
        "items": [
            {
                "id": "c73b6145-7f36-47c3-8d16-eb3cde464946",
                "producto_id": null,
                "codigo": null,
                "descripcion": "Consultoría",
                "cantidad": "2.000",
                "precio": "1500.00",
                "descuento": "0.00",
                "itbis_tasa": "18.00",
                "itbis_monto": "540.00",
                "total": "3540.00",
                "orden": 0
            }
        ],
        "envios": [
            {
                "id": "b1d0c1f2-6e0a-4c43-9d5e-0f0a8c1d2e3f",
                "estado": "enviado",
                "destinatarios": [
                    "[email protected]"
                ],
                "programado_para": null,
                "enviado_en": "2026-09-28 09:20:11",
                "aperturas": 0
            }
        ],
        "historial": [
            "…"
        ],
        "adjuntos": [],
        "retenciones": [],
        "retenciones_resumen": {
            "total": 3540,
            "isr": 0,
            "itbis": 0,
            "retenido": 0,
            "neto": 3540,
            "hay": false
        }
    }
}

POST /facturas escritura

Emitir una factura

Toma el siguiente NCF de la secuencia activa del tipo pedido (o el siguiente número interno) dentro de una transacción: dos emisiones simultáneas nunca repiten número. Descuenta el stock de los productos que lo controlan.

Cuerpo

`tipo_documento`	string	`fiscal` (predeterminado) o `interna`.
`ncf_tipo`	string	Para fiscal: `B01`, `B02` (predeterminado), `B14`… Ver catálogos. B01 exige el RNC del cliente.
`secuencia_id`	uuid	Forzar una secuencia concreta del tipo (si tienes varias activas).
`cliente_id`	uuid	Cliente del catálogo. Si lo mandas, nombre y documento salen de él.
`cliente_nombre`	string	Obligatorio si no mandas `cliente_id`.
`cliente_documento`	string	RNC o cédula del cliente capturado a mano.
`cliente_tipo_documento`	string	`RNC` · `CEDULA` · `PASAPORTE` · `NINGUNO`.
`items` obligatorio	array	Líneas del documento (al menos una). Cada línea: `producto_id` (opcional, del catálogo), `descripcion`, `cantidad`, `precio`, `descuento` (monto), `itbis_tasa` (18, 16 o 0), `codigo`. Si mandas `producto_id`, lo que omitas sale del catálogo (en USD se usa `precio_usd`).
`moneda`	string	`DOP` (predeterminada) o `USD`.
`tasa_cambio`	number	Obligatoria en USD: pesos por cada US$1.00. Consulta la del día en /tasa_cambio.
`fecha`	date	Predeterminada: hoy.
`vencimiento`	date
`condicion_pago`	string	`contado` (predeterminado) o `credito`.
`notas`	string	Sale impresa en el PDF.
`pagada`	boolean	Nace emitida y pasa enseguida a pagada.
`cotizacion_id`	uuid	Factura que nace de una cotización: esta queda marcada como facturada.

Errores frecuentes: 409 si la secuencia está agotada, vencida o no existe (o la numeración interna está apagada) · 422 con errors por campo.

Petición

curl -X POST https://taxflow.com.do/api/facturas \
  -H "Authorization: Bearer $TAXFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ncf_tipo": "B01",
    "cliente_id": "88129800-d743-4682-a9a1-2073a48de7f9",
    "condicion_pago": "credito",
    "vencimiento": "2026-10-28",
    "items": [
        {
            "producto_id": "5372f5fb-5caa-462b-b6a6-edf9ebe887f4",
            "cantidad": 2
        },
        {
            "descripcion": "Instalación",
            "cantidad": 1,
            "precio": 1500,
            "itbis_tasa": 18
        }
    ]
}'

Respuesta

{
    "ok": true,
    "data": {
        "id": "26f69a58-f683-40d8-b92e-630654bdb5db",
        "tipo_documento": "fiscal",
        "ncf": "B0100000150",
        "ncf_tipo": "B01",
        "numero": 150,
        "cliente_id": "88129800-d743-4682-a9a1-2073a48de7f9",
        "cliente_nombre": "Distribuidora Caribe SRL",
        "cliente_documento": "131246796",
        "cliente_tipo_documento": "RNC",
        "fecha": "2026-09-28",
        "vencimiento": "2026-10-28",
        "condicion_pago": "credito",
        "moneda": "DOP",
        "tasa_cambio": "1.000000",
        "subtotal": "3000.00",
        "descuento": "0.00",
        "itbis": "540.00",
        "total": "3540.00",
        "estado": "emitida",
        "estado_nombre": "Emitida",
        "anulada": false,
        "pagada": false,
        "motivo_anulacion": null,
        "recibida_en": null,
        "pagada_en": null,
        "notas": null,
        "creado_en": "2026-09-28 09:14:03",
        "items": [
            {
                "id": "c73b6145-7f36-47c3-8d16-eb3cde464946",
                "producto_id": null,
                "codigo": null,
                "descripcion": "Consultoría",
                "cantidad": "2.000",
                "precio": "1500.00",
                "descuento": "0.00",
                "itbis_tasa": "18.00",
                "itbis_monto": "540.00",
                "total": "3540.00",
                "orden": 0
            }
        ]
    }
}

POST /facturas/{id}/estado escritura

Cambiar el estado

Mueve la factura entre emitida, recibida y pagada. Para anular usa el endpoint de anulación. Devuelve la factura y la línea de tiempo actualizada.

Cuerpo

estado obligatorio string emitida · recibida · pagada.

Petición

curl -X POST https://taxflow.com.do/api/facturas/{id}/estado \
  -H "Authorization: Bearer $TAXFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "estado": "pagada"
}'

Respuesta

{
    "ok": true,
    "data": {
        "factura": {
            "…": "…",
            "estado": "pagada"
        },
        "historial": [
            "…"
        ]
    }
}

POST /facturas/{id}/anular escritura

Anular

Irreversible. El NCF no se reutiliza: queda reportado como anulado en el 607.

Cuerpo

motivo obligatorio string Motivo de la anulación.

Petición

curl -X POST https://taxflow.com.do/api/facturas/{id}/anular \
  -H "Authorization: Bearer $TAXFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "motivo": "Error en el RNC del cliente"
}'

GET /facturas/{id}/pdf

Descargar el PDF

Respuesta binaria: application/pdf.

El mismo PDF con tu logo que recibe el cliente por correo.

Petición

curl https://taxflow.com.do/api/facturas/{id}/pdf \
  -H "Authorization: Bearer $TAXFLOW_KEY" -o factura.pdf

POST /facturas/{id}/enviar escritura

Enviar por correo

Manda el PDF por correo, ahora o programado. Cada correo lleva un pixel de lectura: al abrirse, la factura pasa sola a recibida.

Cuerpo

`destinatarios` obligatorio	string[]	De 1 a 10 correos.
`mensaje`	string	Texto que acompaña el PDF en el correo.
`programado_para`	datetime	Para enviarlo después: `2026-10-01 08:00` (hora de Santo Domingo), hasta un año adelante.

Errores frecuentes: 502 si el proveedor de correo rechaza el envío.

Petición

curl -X POST https://taxflow.com.do/api/facturas/{id}/enviar \
  -H "Authorization: Bearer $TAXFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "destinatarios": [
        "[email protected]"
    ],
    "mensaje": "Adjunto la factura del mes. ¡Gracias!"
}'

Respuesta

{
    "ok": true,
    "data": {
        "envio": {
            "id": "b1d0c1f2-6e0a-4c43-9d5e-0f0a8c1d2e3f",
            "estado": "enviado",
            "destinatarios": [
                "[email protected]"
            ],
            "programado_para": null,
            "enviado_en": "2026-09-28 09:20:11",
            "aperturas": 0
        },
        "envios": [
            {
                "id": "b1d0c1f2-6e0a-4c43-9d5e-0f0a8c1d2e3f",
                "estado": "enviado",
                "destinatarios": [
                    "[email protected]"
                ],
                "programado_para": null,
                "enviado_en": "2026-09-28 09:20:11",
                "aperturas": 0
            }
        ]
    }
}

GET /facturas/{id}/envios

Historial de correos

Envíos (hechos, programados o cancelados) con sus aperturas.

Petición

curl https://taxflow.com.do/api/facturas/{id}/envios \
  -H "Authorization: Bearer $TAXFLOW_KEY"

POST /facturas/{id}/envios/{envio}/cancelar escritura

Cancelar un envío programado

Solo mientras siga en cola. 409 si ya salió.

Petición

curl -X POST https://taxflow.com.do/api/facturas/{id}/envios/{envio}/cancelar \
  -H "Authorization: Bearer $TAXFLOW_KEY"

GET /facturas/{id}/historial

Línea de tiempo del estado

Cada cambio de estado con quién, cuándo, el origen (emision, manual, lectura, anulacion) y la nota.

Petición

curl https://taxflow.com.do/api/facturas/{id}/historial \
  -H "Authorization: Bearer $TAXFLOW_KEY"

GET /facturas/{id}/retenciones

Retenciones

Lo que el cliente te retuvo al pagar: las registradas, las opciones del catálogo evaluadas para esta factura (disponible, motivo) y el resumen (total, retenido, neto).

Petición

curl https://taxflow.com.do/api/facturas/{id}/retenciones \
  -H "Authorization: Bearer $TAXFLOW_KEY"

POST /facturas/{id}/retenciones escritura

Registrar una retención

El monto lo calcula el servidor según el tipo. Una por impuesto; se rechaza (409) la que no aplica a esta factura.

Cuerpo

tipo obligatorio string Código del catálogo de retenciones.

Petición

curl -X POST https://taxflow.com.do/api/facturas/{id}/retenciones \
  -H "Authorization: Bearer $TAXFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tipo": "itbis_profesional_liberal"
}'

DELETE /facturas/{id}/retenciones/{retencion} escritura

Quitar una retención

Devuelve el bloque de retenciones recalculado.

Petición

curl -X DELETE https://taxflow.com.do/api/facturas/{id}/retenciones/{retencion} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

GET /facturas/{id}/adjuntos

Archivos de la factura

Archivos guardados junto a la factura (orden de compra, comprobante de pago…).

Petición

curl https://taxflow.com.do/api/facturas/{id}/adjuntos \
  -H "Authorization: Bearer $TAXFLOW_KEY"

POST /facturas/{id}/adjuntos escritura

Adjuntar un archivo

Cuerpo multipart/form-data.

Campo archivo (cualquier tipo) y titulo opcional (máx. 150 caracteres).

Petición

curl -X POST https://taxflow.com.do/api/facturas/{id}/adjuntos \
  -H "Authorization: Bearer $TAXFLOW_KEY" \
  -F [email protected] -F titulo="Orden de compra 88"

DELETE /facturas/{id}/adjuntos/{adjunto} escritura

Borrar un archivo

Lo elimina también del disco.

Petición

curl -X DELETE https://taxflow.com.do/api/facturas/{id}/adjuntos/{adjunto} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

GET /facturas/exportar

Exportar el 607

Respuesta binaria: libro de Excel (.xlsx).

Libro de Excel en el formato del 607 de la DGII con los mismos filtros del listado y sin límite de filas, ordenado por fecha de emisión.

Parámetros de consulta

`desde / hasta`	date	El periodo a declarar.
`estado, tipo_documento, moneda, q`		Igual que en el listado.

Petición

curl "https://taxflow.com.do/api/facturas/exportar?desde=2026-09-01&hasta=2026-09-30" \
  -H "Authorization: Bearer $TAXFLOW_KEY" -o 607-septiembre.xlsx

Ventas

Cotizaciones

Ofertas previas a la factura, con numeración propia (COT…). No consumen NCF. Estados: borrador → enviada → aceptada / rechazada → facturada. Solo se editan abiertas (borrador o enviada). Para facturarla, emite con POST /facturas y cotizacion_id.

GET/cotizacionesListar cotizaciones GET/cotizaciones/{id}Ver una cotización POST/cotizacionesCrear una cotización PUT/cotizaciones/{id}Editar POST/cotizaciones/{id}/estadoCambiar el estado POST/cotizaciones/{id}/enviarEnviar por correo GET/cotizaciones/{id}/enviosHistorial de correos POST/cotizaciones/{id}/envios/{envio}/cancelarCancelar un envío programado GET/cotizaciones/{id}/pdfDescargar el PDF DELETE/cotizaciones/{id}Eliminar

GET /cotizaciones

Listar cotizaciones

Parámetros de consulta

`q`	string	Número, nombre o documento del cliente.
`estado`	string	`borrador` · `enviada` · `aceptada` · `rechazada` · `facturada` · `vencida` (abiertas con la vigencia pasada).
`moneda`	string
`desde / hasta`	date
`limite`	int	De 1 a 500. Predeterminado 100.

Petición

curl https://taxflow.com.do/api/cotizaciones \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Respuesta

{
    "ok": true,
    "data": {
        "cotizaciones": [
            {
                "id": "232953a0-4c5b-4005-a21c-4b73d11dcdbf",
                "numero": "COT00000001",
                "correlativo": 1,
                "cliente_id": null,
                "cliente_nombre": "Prospecto SRL",
                "fecha": "2026-09-28",
                "valida_hasta": "2026-10-28",
                "moneda": "DOP",
                "subtotal": "500.00",
                "descuento": "0.00",
                "itbis": "90.00",
                "total": "590.00",
                "estado": "borrador",
                "estado_nombre": "Borrador",
                "vencida": false,
                "editable": true,
                "facturable": true,
                "dias_restantes": 30,
                "factura_id": null
            }
        ],
        "estados": [
            {
                "codigo": "borrador",
                "nombre": "Borrador"
            }
        ]
    }
}

GET /cotizaciones/{id}

Ver una cotización

Con sus líneas (items), correos y el número de la factura si ya se facturó.

Petición

curl https://taxflow.com.do/api/cotizaciones/{id} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

POST /cotizaciones escritura

Crear una cotización

Nace en borrador y toma el siguiente número de la numeración de cotizaciones.

Cuerpo

`cliente_id`	uuid	Cliente del catálogo. Si lo mandas, nombre y documento salen de él.
`cliente_nombre`	string	Obligatorio si no mandas `cliente_id`.
`cliente_documento`	string	RNC o cédula del cliente capturado a mano.
`cliente_tipo_documento`	string	`RNC` · `CEDULA` · `PASAPORTE` · `NINGUNO`.
`items` obligatorio	array	Líneas del documento (al menos una). Cada línea: `producto_id` (opcional, del catálogo), `descripcion`, `cantidad`, `precio`, `descuento` (monto), `itbis_tasa` (18, 16 o 0), `codigo`. Si mandas `producto_id`, lo que omitas sale del catálogo (en USD se usa `precio_usd`).
`moneda`	string	`DOP` (predeterminada) o `USD`.
`tasa_cambio`	number	Obligatoria en USD: pesos por cada US$1.00. Consulta la del día en /tasa_cambio.
`fecha`	date	Predeterminada: hoy.
`valida_hasta`	date	Vigencia de la oferta.
`condicion_pago`	string	`contado` o `credito`.
`notas`	string
`condiciones`	string	Términos y condiciones impresos.

Petición

curl -X POST https://taxflow.com.do/api/cotizaciones \
  -H "Authorization: Bearer $TAXFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cliente_nombre": "Prospecto SRL",
    "valida_hasta": "2026-10-28",
    "items": [
        {
            "descripcion": "Plan anual",
            "cantidad": 1,
            "precio": 500
        }
    ]
}'

Respuesta

{
    "ok": true,
    "data": {
        "id": "232953a0-4c5b-4005-a21c-4b73d11dcdbf",
        "numero": "COT00000001",
        "correlativo": 1,
        "cliente_id": null,
        "cliente_nombre": "Prospecto SRL",
        "fecha": "2026-09-28",
        "valida_hasta": "2026-10-28",
        "moneda": "DOP",
        "subtotal": "500.00",
        "descuento": "0.00",
        "itbis": "90.00",
        "total": "590.00",
        "estado": "borrador",
        "estado_nombre": "Borrador",
        "vencida": false,
        "editable": true,
        "facturable": true,
        "dias_restantes": 30,
        "factura_id": null
    }
}

PUT /cotizaciones/{id} escritura

Editar

Mismo cuerpo que al crear; reemplaza las líneas y conserva el número. 409 si ya no está abierta.

Petición

curl -X PUT https://taxflow.com.do/api/cotizaciones/{id} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

POST /cotizaciones/{id}/estado escritura

Cambiar el estado

facturada no se asigna a mano: la pone la emisión de la factura.

Cuerpo

`estado` obligatorio	string	`borrador` · `enviada` · `aceptada` · `rechazada`.
`motivo`	string	Obligatorio al rechazar.

Petición

curl -X POST https://taxflow.com.do/api/cotizaciones/{id}/estado \
  -H "Authorization: Bearer $TAXFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "estado": "aceptada"
}'

POST /cotizaciones/{id}/enviar escritura

Enviar por correo

Igual que en facturas. Enviarla ahora la pasa de borrador a enviada.

Cuerpo

`destinatarios` obligatorio	string[]	De 1 a 10 correos.
`mensaje`	string	Texto que acompaña el PDF en el correo.
`programado_para`	datetime	Para enviarlo después: `2026-10-01 08:00` (hora de Santo Domingo), hasta un año adelante.

Petición

curl -X POST https://taxflow.com.do/api/cotizaciones/{id}/enviar \
  -H "Authorization: Bearer $TAXFLOW_KEY"

GET /cotizaciones/{id}/envios

Historial de correos

Petición

curl https://taxflow.com.do/api/cotizaciones/{id}/envios \
  -H "Authorization: Bearer $TAXFLOW_KEY"

POST /cotizaciones/{id}/envios/{envio}/cancelar escritura

Cancelar un envío programado

Petición

curl -X POST https://taxflow.com.do/api/cotizaciones/{id}/envios/{envio}/cancelar \
  -H "Authorization: Bearer $TAXFLOW_KEY"

GET /cotizaciones/{id}/pdf

Descargar el PDF

Respuesta binaria: application/pdf.

Petición

curl https://taxflow.com.do/api/cotizaciones/{id}/pdf \
  -H "Authorization: Bearer $TAXFLOW_KEY"

DELETE /cotizaciones/{id} escritura

Eliminar

Solo un borrador que nunca se envió. Lo demás se cierra como rechazada.

Petición

curl -X DELETE https://taxflow.com.do/api/cotizaciones/{id} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Compras

Gastos (606)

Comprobantes recibidos de tus proveedores, con la apertura que pide el 606. A diferencia de una factura, un gasto sí se edita y se borra. El subtotal y el total los recalcula el servidor a partir de los montos capturados.

GET/gastosListar gastos GET/gastos/{id}Ver un gasto POST/gastosRegistrar un gasto PUT/gastos/{id}Corregir un gasto POST/gastos/{id}/estadoCambiar el estado DELETE/gastos/{id}Eliminar un gasto GET/gastos/exportarExportar el 606 GET/gastos/panelResumen de gastos GET/gastos/nuevoCatálogos del formulario

GET /gastos

Listar gastos

Incluye un resumen calculado sobre todo lo filtrado (no solo la página) y los catálogos del formulario.

Parámetros de consulta

`q`	string	NCF, proveedor, documento o descripción.
`estado`	string	`pendiente` · `pagado` · `anulado`.
`tipo_bien`	string	Clasificación 606 (`01`…`11`).
`proveedor_id`	uuid
`categoria_id`	uuid
`moneda`	string
`desde / hasta`	date	Fecha del comprobante.
`limite`	int	De 1 a 500. Predeterminado 100.

Petición

curl https://taxflow.com.do/api/gastos \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Respuesta

{
    "ok": true,
    "data": {
        "gastos": [
            {
                "id": "785e99d8-6535-41d8-9fee-65d04bedecc2",
                "proveedor_id": null,
                "proveedor_nombre": "Ferretería Ochoa",
                "proveedor_documento": "101001577",
                "proveedor_tipo_documento": "RNC",
                "ncf": "B0100000123",
                "ncf_tipo": "B01",
                "ncf_tipo_nombre": "Credito Fiscal",
                "ncf_modificado": null,
                "tipo_bien": "02",
                "tipo_bien_nombre": "Gastos por trabajos, suministros y servicios",
                "forma_pago": "02",
                "categoria_id": null,
                "categoria_nombre": null,
                "fecha": "2026-09-28",
                "fecha_pago": null,
                "descripcion": "Materiales de oficina",
                "notas": null,
                "adjunto_id": "cf7f6ec6-939f-4d79-bdf7-4bea8a09127d",
                "moneda": "DOP",
                "tasa_cambio": "1.000000",
                "monto_servicios": "0.00",
                "monto_bienes": "1000.00",
                "subtotal": "1000.00",
                "itbis_facturado": "180.00",
                "itbis_retenido": "0.00",
                "retencion_isr": "0.00",
                "isc": "0.00",
                "otros_impuestos": "0.00",
                "propina_legal": "0.00",
                "total": "1180.00",
                "retenido": 0,
                "neto": 1180,
                "total_dop": 1180,
                "estado": "pendiente",
                "estado_nombre": "Pendiente de pago"
            }
        ],
        "resumen": {
            "cantidad": 1,
            "total_dop": "1180.00",
            "itbis_dop": "180.00",
            "retenido_dop": "0.00",
            "pendiente_dop": "1180.00"
        },
        "catalogos": {
            "estados": [
                "…"
            ],
            "tipos_bien": [
                "…"
            ],
            "formas_pago": [
                "…"
            ],
            "retenciones_isr": [
                "…"
            ],
            "tipos_ncf": [
                "…"
            ]
        }
    }
}

GET /gastos/{id}

Ver un gasto

Devuelve gasto, su adjunto (la captura del comprobante) y los catálogos.

Petición

curl https://taxflow.com.do/api/gastos/{id} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

POST /gastos escritura

Registrar un gasto

El tipo de NCF se deduce del propio NCF. El mismo NCF del mismo proveedor no se registra dos veces. Para guardar la foto del comprobante, súbela antes a /adjuntos y manda su id.

Cuerpo

`proveedor_id`	uuid	Proveedor del catálogo. Si no, captura nombre y documento.
`proveedor_nombre`	string	Obligatorio sin `proveedor_id`.
`proveedor_documento`	string	RNC o cédula.
`ncf`	string	B + 10 dígitos (`B0100000123`) o e-CF E + 12 dígitos (`E310000000001`).
`ncf_modificado`	string	Para notas de crédito/débito.
`tipo_bien`	string	Clasificación 606. Predeterminada `09`.
`categoria_id`	uuid	Categoría de gasto propia.
`fecha`	date	Fecha del comprobante. Predeterminada: hoy.
`monto_servicios`	number	Monto facturado en servicios.
`monto_bienes`	number	Monto facturado en bienes. Servicios + bienes debe ser mayor que 0.
`itbis_facturado`	number
`itbis_retenido`	number	No mayor que el facturado.
`itbis_proporcionalidad, itbis_costo, itbis_adelantar, itbis_percibido`	number	Columnas del 606.
`tipo_retencion_isr`	string	Ver catálogos.
`retencion_isr, isr_percibido`	number
`isc, otros_impuestos, propina_legal`	number	Propina legal es el 10 % de ley, no un cargo que ya viene en el subtotal.
`forma_pago`	string	`01` efectivo … `07` mixto.
`estado`	string	`pendiente` (predeterminado) o `pagado`.
`fecha_pago`	date	Si está pagado y no la mandas, se toma la del comprobante.
`descripcion, notas`	string
`adjunto_id`	uuid	Id devuelto por `POST /adjuntos`.
`moneda`	string	`DOP` (predeterminada) o `USD`.
`tasa_cambio`	number	Obligatoria en USD: pesos por cada US$1.00. Consulta la del día en /tasa_cambio.

Petición

curl -X POST https://taxflow.com.do/api/gastos \
  -H "Authorization: Bearer $TAXFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "proveedor_nombre": "Ferretería Ochoa",
    "proveedor_documento": "101001577",
    "ncf": "B0100000123",
    "tipo_bien": "02",
    "monto_bienes": 1000,
    "itbis_facturado": 180,
    "forma_pago": "02",
    "descripcion": "Materiales de oficina",
    "adjunto_id": "cf7f6ec6-939f-4d79-bdf7-4bea8a09127d"
}'

Respuesta

{
    "ok": true,
    "data": {
        "id": "785e99d8-6535-41d8-9fee-65d04bedecc2",
        "proveedor_id": null,
        "proveedor_nombre": "Ferretería Ochoa",
        "proveedor_documento": "101001577",
        "proveedor_tipo_documento": "RNC",
        "ncf": "B0100000123",
        "ncf_tipo": "B01",
        "ncf_tipo_nombre": "Credito Fiscal",
        "ncf_modificado": null,
        "tipo_bien": "02",
        "tipo_bien_nombre": "Gastos por trabajos, suministros y servicios",
        "forma_pago": "02",
        "categoria_id": null,
        "categoria_nombre": null,
        "fecha": "2026-09-28",
        "fecha_pago": null,
        "descripcion": "Materiales de oficina",
        "notas": null,
        "adjunto_id": "cf7f6ec6-939f-4d79-bdf7-4bea8a09127d",
        "moneda": "DOP",
        "tasa_cambio": "1.000000",
        "monto_servicios": "0.00",
        "monto_bienes": "1000.00",
        "subtotal": "1000.00",
        "itbis_facturado": "180.00",
        "itbis_retenido": "0.00",
        "retencion_isr": "0.00",
        "isc": "0.00",
        "otros_impuestos": "0.00",
        "propina_legal": "0.00",
        "total": "1180.00",
        "retenido": 0,
        "neto": 1180,
        "total_dop": 1180,
        "estado": "pendiente",
        "estado_nombre": "Pendiente de pago"
    }
}

PUT /gastos/{id} escritura

Corregir un gasto

Mismo cuerpo que al registrar: reemplaza todos los campos (lo que no mandes queda en cero o vacío). 409 si está anulado.

Petición

curl -X PUT https://taxflow.com.do/api/gastos/{id} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

POST /gastos/{id}/estado escritura

Cambiar el estado

Cuerpo

`estado` obligatorio	string	`pendiente` · `pagado` · `anulado`.
`fecha_pago`	date	Al pagar. Predeterminada: hoy.
`motivo`	string	Obligatorio al anular.

Petición

curl -X POST https://taxflow.com.do/api/gastos/{id}/estado \
  -H "Authorization: Bearer $TAXFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "estado": "pagado",
    "fecha_pago": "2026-09-30"
}'

DELETE /gastos/{id} escritura

Eliminar un gasto

Petición

curl -X DELETE https://taxflow.com.do/api/gastos/{id} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

GET /gastos/exportar

Exportar el 606

Respuesta binaria: libro de Excel (.xlsx).

Libro en el formato del 606 de la DGII, con los filtros del listado y sin límite de filas.

Petición

curl "https://taxflow.com.do/api/gastos/exportar?desde=2026-09-01&hasta=2026-09-30" \
  -H "Authorization: Bearer $TAXFLOW_KEY" -o 606-septiembre.xlsx

GET /gastos/panel

Resumen de gastos

Hoy, esta semana y este mes; pendientes de pago; serie de 14 días y los últimos registrados.

Petición

curl https://taxflow.com.do/api/gastos/panel \
  -H "Authorization: Bearer $TAXFLOW_KEY"

GET /gastos/nuevo

Catálogos del formulario

Estados, clasificaciones 606, formas de pago, tipos de retención ISR y tipos de NCF que se reciben.

Petición

curl https://taxflow.com.do/api/gastos/nuevo \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Compras

Archivos

La foto o el PDF de un comprobante. Se sube primero y su id se manda como adjunto_id al registrar el gasto.

POST/adjuntosSubir un archivo GET/adjuntos/{id}Ver los datos del archivo GET/adjuntos/{id}/descargarDescargar el archivo

POST /adjuntos escritura

Subir un archivo

Cuerpo multipart/form-data. JPG, PNG, WebP o PDF.

Campo multipart archivo.

Petición

curl -X POST https://taxflow.com.do/api/adjuntos \
  -H "Authorization: Bearer $TAXFLOW_KEY" \
  -F [email protected]

Respuesta

{
    "ok": true,
    "data": {
        "id": "cf7f6ec6-939f-4d79-bdf7-4bea8a09127d",
        "nombre": "comprobante.jpg",
        "mime": "image/jpeg",
        "bytes": 184233,
        "tamano": "179.9 KB",
        "es_imagen": true
    }
}

GET /adjuntos/{id}

Ver los datos del archivo

Nombre, tipo y tamaño.

Petición

curl https://taxflow.com.do/api/adjuntos/{id} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

GET /adjuntos/{id}/descargar

Descargar el archivo

Respuesta binaria.

El archivo tal como se subió.

Petición

curl https://taxflow.com.do/api/adjuntos/{id}/descargar \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Catálogos

Clientes

Un cliente con facturas no se borra: al eliminarlo se desactiva.

GET/clientesListar clientes POST/clientesCrear un cliente PUT/clientes/{id}Actualizar un cliente DELETE/clientes/{id}Eliminar un cliente

GET /clientes

Listar clientes

Ordenados por nombre, hasta 500.

Parámetros de consulta

q string Nombre, documento o correo.

Petición

curl https://taxflow.com.do/api/clientes \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Respuesta

{
    "ok": true,
    "data": [
        {
            "id": "88129800-d743-4682-a9a1-2073a48de7f9",
            "tipo_documento": "RNC",
            "documento": "131246796",
            "nombre": "Distribuidora Caribe SRL",
            "nombre_comercial": "Caribe",
            "email": "[email protected]",
            "telefono": "809-555-0100",
            "direccion": "Av. Winston Churchill 1099, Santo Domingo",
            "activo": 1
        }
    ]
}

POST /clientes escritura

Crear un cliente

Consulta antes el nombre en la DGII con /rnc.

Cuerpo

`nombre` obligatorio	string	Nombre o razón social.
`tipo_documento`	string	`RNC` (predeterminado) · `CEDULA` · `PASAPORTE` · `NINGUNO`.
`documento`	string	RNC de 9 dígitos o cédula de 11. Único por empresa.
`nombre_comercial`	string
`email`	string	Se ofrece como destinatario al enviar sus facturas.
`telefono`	string
`direccion`	string
`activo`	boolean	Predeterminado `true`.

Petición

curl -X POST https://taxflow.com.do/api/clientes \
  -H "Authorization: Bearer $TAXFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "nombre": "Distribuidora Caribe SRL",
    "tipo_documento": "RNC",
    "documento": "131246796",
    "email": "[email protected]"
}'

Respuesta

{
    "ok": true,
    "data": {
        "id": "88129800-d743-4682-a9a1-2073a48de7f9",
        "tipo_documento": "RNC",
        "documento": "131246796",
        "nombre": "Distribuidora Caribe SRL",
        "nombre_comercial": "Caribe",
        "email": "[email protected]",
        "telefono": "809-555-0100",
        "direccion": "Av. Winston Churchill 1099, Santo Domingo",
        "activo": 1
    }
}

PUT /clientes/{id} escritura

Actualizar un cliente

Mismo cuerpo que al crear (reemplaza todos los campos).

Petición

curl -X PUT https://taxflow.com.do/api/clientes/{id} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

DELETE /clientes/{id} escritura

Eliminar un cliente

Si tiene facturas se desactiva y la respuesta trae message.

Petición

curl -X DELETE https://taxflow.com.do/api/clientes/{id} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Catálogos

Proveedores

El espejo de clientes, del lado de las compras. Un proveedor con gastos se desactiva en lugar de borrarse.

GET/proveedoresListar proveedores POST/proveedoresCrear un proveedor PUT/proveedores/{id}Actualizar un proveedor DELETE/proveedores/{id}Eliminar un proveedor

GET /proveedores

Listar proveedores

Parámetros de consulta

q string Nombre, nombre comercial, documento o correo.

Petición

curl https://taxflow.com.do/api/proveedores \
  -H "Authorization: Bearer $TAXFLOW_KEY"

POST /proveedores escritura

Crear un proveedor

Cuerpo

`nombre` obligatorio	string	Nombre o razón social.
`tipo_documento`	string	`RNC` (predeterminado) · `CEDULA` · `PASAPORTE` · `NINGUNO`.
`documento`	string	RNC de 9 dígitos o cédula de 11. Único por empresa.
`nombre_comercial`	string
`email`	string
`telefono`	string
`direccion`	string
`activo`	boolean	Predeterminado `true`.

Petición

curl -X POST https://taxflow.com.do/api/proveedores \
  -H "Authorization: Bearer $TAXFLOW_KEY"

PUT /proveedores/{id} escritura

Actualizar un proveedor

Mismo cuerpo que al crear.

Petición

curl -X PUT https://taxflow.com.do/api/proveedores/{id} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

DELETE /proveedores/{id} escritura

Eliminar un proveedor

Petición

curl -X DELETE https://taxflow.com.do/api/proveedores/{id} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Catálogos

Productos y servicios

El catálogo que se factura. Un producto ya facturado se desactiva en lugar de borrarse.

GET/productosListar productos POST/productosCrear un producto PUT/productos/{id}Actualizar un producto DELETE/productos/{id}Eliminar un producto

GET /productos

Listar productos

Parámetros de consulta

`q`	string	Nombre, código o descripción.
`categoria_id`	uuid
`activos`	string	`1` = solo activos.

Petición

curl https://taxflow.com.do/api/productos \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Respuesta

{
    "ok": true,
    "data": [
        {
            "id": "5372f5fb-5caa-462b-b6a6-edf9ebe887f4",
            "codigo": "SRV-01",
            "nombre": "Soporte mensual",
            "tipo": "servicio",
            "unidad": "UND",
            "precio": "1000.00",
            "precio_usd": "18.00",
            "costo": "0.00",
            "itbis_tasa": "18.00",
            "stock": "0.000",
            "controla_stock": 0,
            "activo": 1,
            "categoria_id": null,
            "categoria_nombre": null
        }
    ]
}

POST /productos escritura

Crear un producto

Cuerpo

`codigo` obligatorio	string	Único por empresa.
`nombre` obligatorio	string
`descripcion`	string
`tipo`	string	`bien` (predeterminado) o `servicio`.
`unidad`	string	Predeterminada `UND`.
`precio`	number	En pesos.
`precio_usd`	number	Precio propio en dólares (no se convierte).
`costo`	number
`itbis_tasa`	number	18 (predeterminado), 16 o 0.
`categoria_id`	uuid
`stock`	number
`controla_stock`	boolean	Descontar stock al facturar.
`activo`	boolean

Petición

curl -X POST https://taxflow.com.do/api/productos \
  -H "Authorization: Bearer $TAXFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "codigo": "SRV-01",
    "nombre": "Soporte mensual",
    "tipo": "servicio",
    "precio": 1000,
    "precio_usd": 18,
    "itbis_tasa": 18
}'

PUT /productos/{id} escritura

Actualizar un producto

Mismo cuerpo que al crear.

Petición

curl -X PUT https://taxflow.com.do/api/productos/{id} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

DELETE /productos/{id} escritura

Eliminar un producto

Petición

curl -X DELETE https://taxflow.com.do/api/productos/{id} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Catálogos

Categorías de productos

Una categoría en uso no se borra (409): desactívala.

GET/categoriasListar POST/categoriasCrear PUT/categorias/{id}Actualizar DELETE/categorias/{id}Eliminar

GET /categorias

Listar

Con el número de productos de cada una.

Petición

curl https://taxflow.com.do/api/categorias \
  -H "Authorization: Bearer $TAXFLOW_KEY"

POST /categorias escritura

Crear

Cuerpo

`nombre` obligatorio	string	Único.
`descripcion`	string
`activo`	boolean

Petición

curl -X POST https://taxflow.com.do/api/categorias \
  -H "Authorization: Bearer $TAXFLOW_KEY"

PUT /categorias/{id} escritura

Actualizar

Petición

curl -X PUT https://taxflow.com.do/api/categorias/{id} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

DELETE /categorias/{id} escritura

Eliminar

Petición

curl -X DELETE https://taxflow.com.do/api/categorias/{id} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Catálogos

Categorías de gastos

Independientes de las de productos. Cada una puede sugerir su clasificación 606.

GET/categorias_gastoListar POST/categorias_gastoCrear PUT/categorias_gasto/{id}Actualizar DELETE/categorias_gasto/{id}Eliminar POST/categorias_gasto/predeterminadasReponer las predeterminadas

GET /categorias_gasto

Listar

Con el número de gastos de cada una.

Petición

curl https://taxflow.com.do/api/categorias_gasto \
  -H "Authorization: Bearer $TAXFLOW_KEY"

POST /categorias_gasto escritura

Crear

Cuerpo

`nombre` obligatorio	string	Único.
`descripcion`	string
`tipo_bien`	string	Clasificación 606 sugerida.
`activo`	boolean

Petición

curl -X POST https://taxflow.com.do/api/categorias_gasto \
  -H "Authorization: Bearer $TAXFLOW_KEY"

PUT /categorias_gasto/{id} escritura

Actualizar

Petición

curl -X PUT https://taxflow.com.do/api/categorias_gasto/{id} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

DELETE /categorias_gasto/{id} escritura

Eliminar

Petición

curl -X DELETE https://taxflow.com.do/api/categorias_gasto/{id} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

POST /categorias_gasto/predeterminadas escritura

Reponer las predeterminadas

Crea las categorías de fábrica que falten. Devuelve {"creadas": n}.

Petición

curl -X POST https://taxflow.com.do/api/categorias_gasto/predeterminadas \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Configuración fiscal

Secuencias NCF

Los rangos autorizados por la DGII (Desde/Hasta) de los que salen los NCF. Los rangos del mismo tipo no pueden solaparse.

GET/secuenciasListar secuencias POST/secuenciasCargar una secuencia PUT/secuencias/{id}Corregir una secuencia DELETE/secuencias/{id}Eliminar una secuencia

GET /secuencias

Listar secuencias

Con usados, disponibles, próximo NCF y si está agotada, vencida o por agotarse.

Petición

curl https://taxflow.com.do/api/secuencias \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Respuesta

{
    "ok": true,
    "data": {
        "secuencias": [
            {
                "id": "5a804d20-e7ff-45a1-b31a-5582063a7ac3",
                "tipo": "B01",
                "tipo_nombre": "Credito Fiscal",
                "desde": 1,
                "hasta": 500,
                "actual": 151,
                "vencimiento": "2027-12-31",
                "activa": 1,
                "usados": 150,
                "disponibles": 350,
                "proximo_ncf": "B0100000151",
                "agotada": false,
                "vencida": false,
                "por_agotarse": false
            }
        ],
        "tipos": {
            "B01": "Credito Fiscal",
            "…": "…"
        }
    }
}

POST /secuencias escritura

Cargar una secuencia

Requiere rol Administrador.

Cuerpo

`tipo` obligatorio	string	B01, B02, B14…
`desde` obligatorio	int
`hasta` obligatorio	int	Máximo 99999999.
`vencimiento`	date
`activa`	boolean

Petición

curl -X POST https://taxflow.com.do/api/secuencias \
  -H "Authorization: Bearer $TAXFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tipo": "B01",
    "desde": 1,
    "hasta": 500,
    "vencimiento": "2027-12-31"
}'

PUT /secuencias/{id} escritura

Corregir una secuencia

Requiere rol Administrador.

Con comprobantes emitidos, desde no cambia y hasta no baja de lo usado.

Petición

curl -X PUT https://taxflow.com.do/api/secuencias/{id} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

DELETE /secuencias/{id} escritura

Eliminar una secuencia

Requiere rol Administrador.

Solo si no ha emitido nada; si no, desactívala.

Petición

curl -X DELETE https://taxflow.com.do/api/secuencias/{id} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Configuración fiscal

Numeración propia

Las numeraciones que no son de la DGII: facturas sin valor fiscal (FAC…) y cotizaciones (COT…). Un contador no puede retroceder por debajo de lo ya emitido.

GET/numeracionNumeración de facturas internas PUT/numeracionConfigurarla GET/numeracion/cotizacionesNumeración de cotizaciones PUT/numeracion/cotizacionesConfigurarla

GET /numeracion

Numeración de facturas internas

Prefijo, dígitos, próximo número y si está activa.

Petición

curl https://taxflow.com.do/api/numeracion \
  -H "Authorization: Bearer $TAXFLOW_KEY"

PUT /numeracion escritura

Configurarla

Requiere rol Administrador.

Cuerpo

`prefijo`	string	1 a 10 caracteres (A-Z, 0-9, guion).
`longitud`	int	Dígitos, 1 a 12.
`proximo`	int
`activa`	boolean	Apagada, no se pueden emitir facturas internas.

Petición

curl -X PUT https://taxflow.com.do/api/numeracion \
  -H "Authorization: Bearer $TAXFLOW_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prefijo": "FAC",
    "longitud": 8,
    "proximo": 1,
    "activa": true
}'

GET /numeracion/cotizaciones

Numeración de cotizaciones

Petición

curl https://taxflow.com.do/api/numeracion/cotizaciones \
  -H "Authorization: Bearer $TAXFLOW_KEY"

PUT /numeracion/cotizaciones escritura

Configurarla

Requiere rol Administrador.

Igual que la anterior, más validez_dias (0 a 365; 0 = sin vencimiento).

Petición

curl -X PUT https://taxflow.com.do/api/numeracion/cotizaciones \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Utilidades

Tasa del dólar

La tasa de referencia del Banco Central, para documentos en USD.

GET/tasa_cambioTasa del día POST/tasa_cambio/refrescarForzar la consulta

GET /tasa_cambio

Tasa del día

La última conocida; se refresca sola si no es de hoy.

Petición

curl https://taxflow.com.do/api/tasa_cambio \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Respuesta

{
    "ok": true,
    "data": {
        "disponible": true,
        "moneda": "USD",
        "fecha": "2026-09-26",
        "compra": 63.12,
        "venta": 63.45,
        "tasa": 63.45,
        "del_dia": false,
        "fuente": "Banco Central (tasa de referencia del mercado spot)"
    }
}

POST /tasa_cambio/refrescar escritura

Forzar la consulta

Vuelve a preguntar al Banco Central.

Petición

curl -X POST https://taxflow.com.do/api/tasa_cambio/refrescar \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Utilidades

Consulta de RNC

Quién es el dueño de un RNC o una cédula según la DGII. Si la DGII no responde contesta 200 con ok: false dentro de data: nunca rompe tu flujo.

GET/rnc/{documento}Consultar un RNC o cédula

GET /rnc/{documento}

Consultar un RNC o cédula

Parámetros de consulta

forzar string 1 = ignorar la caché y preguntar de nuevo.

Petición

curl https://taxflow.com.do/api/rnc/{documento} \
  -H "Authorization: Bearer $TAXFLOW_KEY"

Respuesta

{
    "ok": true,
    "data": {
        "ok": true,
        "encontrado": true,
        "documento": "131246796",
        "documento_formateado": "131-24679-6",
        "tipo": "RNC",
        "nombre": "INVERSIONES ROWLAND GARCIA SRL",
        "nombre_comercial": "INVERSIONES ROWLAND GARCIA",
        "estado": "ACTIVO",
        "activo": true,
        "de_cache": false
    }
}

¿Listo para conectar?

Genera tu clave en Integraciones y haz tu primera llamada en un minuto. ¿Aún no tienes cuenta? Solicita una demo.

Ir a Integraciones Solicitar demo

Conecta tus sistemas con TaxFlow

Inicio rápido

Autenticación

Una clave = una empresa

Actúa con el rol de quien la creó

Permiso de la clave

Revocación inmediata

Respuestas y errores

Límites y convenciones

Catálogos

Tipos de NCF que se emiten (ncf_tipo)

Estados de una factura

Estados de una cotización

Estados de un gasto

Clasificación 606 del gasto (tipo_bien)

Formas de pago (forma_pago)

Retención ISR del gasto (tipo_retencion_isr)

Tipos de NCF que se reciben de un proveedor

Retenciones de una factura (tipo)

Roles (los de la cuenta que creó la clave)

Ejemplos de código

Flujo completo: registrar un gasto con su comprobante

Verificar la clave

Quién soy

Empresa

Ver la empresa

Actualizar la empresa

Subir el logo

Quitar el logo

Indicadores

KPIs de ventas y gastos

Facturas

Listar facturas

Ver una factura

Emitir una factura

Cambiar el estado

Anular

Descargar el PDF

Enviar por correo

Historial de correos

Cancelar un envío programado

Línea de tiempo del estado

Retenciones

Registrar una retención

Quitar una retención

Archivos de la factura

Adjuntar un archivo

Borrar un archivo

Exportar el 607

Cotizaciones

Listar cotizaciones

Ver una cotización

Crear una cotización

Editar

Cambiar el estado

Enviar por correo

Historial de correos

Cancelar un envío programado

Descargar el PDF

Eliminar

Gastos (606)

Listar gastos

Ver un gasto

Registrar un gasto

Corregir un gasto

Cambiar el estado

Eliminar un gasto

Exportar el 606

Resumen de gastos

Catálogos del formulario

Archivos

Subir un archivo

Ver los datos del archivo

Descargar el archivo

Clientes

Listar clientes

Crear un cliente

Actualizar un cliente

Eliminar un cliente

Proveedores

Tipos de NCF que se emiten (`ncf_tipo`)

Clasificación 606 del gasto (`tipo_bien`)

Formas de pago (`forma_pago`)

Retención ISR del gasto (`tipo_retencion_isr`)

Retenciones de una factura (`tipo`)