Conecta tu programa con tukonta

Crea clientes, emite facturas con TicketBAI y registra ingresos, gastos y proveedores desde tu propio programa. Pruébalo todo antes en el entorno de pruebas, sin efectos reales.

Empezar Entorno de pruebas

Entorno de pruebashttps://api-sandbox.tukonta.com/v1

Producciónhttps://api.tukonta.com/v1

Versión1.7.0 · 11/11/2026

Tu primera petición en 3 pasos

Crea el entorno de pruebas. En la aplicación web de tukonta, entra en Configuración › Claves de API y pulsa «Crear entorno de pruebas». Copia la clave que aparece: empieza por tuk_test_.
Guarda la clave en una variable para no escribirla en cada petición:
Ventana de terminal
```
export TUKONTA_API_KEY="tuk_test_..."
```
Pide la lista de clientes. Si todo va bien, recibirás los clientes de tu empresa en formato JSON:
Tu primera petición
```
curl "https://api-sandbox.tukonta.com/v1/customers/" \
  -H "X-API-KEY: $TUKONTA_API_KEY"
```

Cuando tu integración funcione, cambia la dirección por la de producción y usa una clave de producción (empieza por tuk_). Más detalles en Entorno de pruebas y Autenticación.

Qué puedes hacer

EmpresaConsulta los datos de tu empresa y sus series de facturación.ClientesLista, consulta, crea, actualiza y elimina los clientes de la empresa.IngresosLista, consulta, crea, actualiza y elimina ingresos.FacturasCrea, emite con TicketBAI, deshace, descarga en PDF y envía por email las facturas.ProveedoresLista, consulta, crea, actualiza y elimina proveedores.GastosLista, consulta, crea, actualiza y elimina gastos, y adjunta su PDF.Vencimientos (transactions)Fechas de vencimiento e importes de las facturas, los ingresos y los gastos.

Antes de empezar

Emite tu primera facturaPaso a paso: consulta tu empresa, crea el cliente, emite la factura, descarga el PDF y envíala.AutenticaciónCómo enviar la clave de API y qué pasa cuando no es válida.ErroresCómo es una respuesta de error y qué hacer con cada código.ListadosPaíses, provincias y códigos de las cuentas de ingreso y de gasto.