Usar la API de AccBooks

Descripción general

La API REST de AccBooks te permite leer y escribir datos de forma programática: extraer informes financieros a tus propios paneles, enviar transacciones desde tus sistemas de ventas o crear integraciones personalizadas no disponibles de serie.

La API está disponible en todos los planes de AccBooks. Los límites de uso varían según el plan.

URL base

https://api.accbooks.co.uk/v1/

Todas las solicitudes deben realizarse a través de HTTPS. Las solicitudes HTTP son rechazadas.

Autenticación

AccBooks usa claves de API para la autenticación. Cada clave está vinculada a una empresa específica y a un conjunto de permisos.

Generar una clave de API:

1. Ve a Configuración → Integraciones → API → Claves → Crear clave.
2. Asigna un nombre a la clave (p. ej., “Integración de panel”).
3. Selecciona los permisos (solo lectura, lectura-escritura o personalizado).
4. Haz clic en Crear. La clave se muestra una única vez: cópiala y guárdala de forma segura.

Usar la clave de API: Inclúyela como token Bearer en cada solicitud:

GET /v1/transactions HTTP/1.1
Authorization: Bearer tu_clave_api_aqui
Content-Type: application/json

Permisos de clave

Permiso	Lectura	Escritura
transactions	Listar, obtener	Crear, actualizar
invoices	Listar, obtener	Crear, actualizar, eliminar
contacts	Listar, obtener	Crear, actualizar
reports	PyG, balance, balance de comprobación	—
journals	Listar, obtener	Crear
bank_accounts	Listar, obtener	—
company	Obtener	—

Endpoints habituales

Listar transacciones

GET /v1/transactions?from=2026-01-01&to=2026-03-31&account_id=1001

Crear una factura

POST /v1/invoices
{
  "customer_id": "cust_123",
  "date": "2026-04-15",
  "due_date": "2026-05-15",
  "line_items": [
    {
      "description": "Servicios de consultoría — Abril",
      "quantity": 1,
      "unit_price": 2500.00,
      "vat_rate": "20",
      "nominal_code": "4000"
    }
  ]
}

Obtener informe de PyG

GET /v1/reports/profit-loss?from=2026-04-01&to=2027-03-31&format=json

Límites de uso

Plan	Solicitudes por minuto	Solicitudes por día
Starter	60	10.000
Pro	300	100.000
Enterprise	Personalizado	Personalizado

Las cabeceras de límite de uso se devuelven en cada respuesta:

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 299
X-RateLimit-Reset: 1714000000

Paginación

Todos los endpoints de lista devuelven resultados paginados:

GET /v1/transactions?page=2&per_page=100

La respuesta incluye:

{
  "data": [...],
  "meta": {
    "current_page": 2,
    "total_pages": 5,
    "total_records": 487
  }
}

Webhooks

En lugar de consultar la API periódicamente, usa webhooks para recibir notificaciones en tiempo real cuando se produzcan eventos. Consulta Webhooks para más detalles.

Referencia de API

La documentación completa de la API con definiciones de endpoints, esquemas de solicitud/respuesta y ejemplos de código en Python, JavaScript y PHP está disponible en:

developer.accbooks.co.uk

Soporte

Para preguntas sobre integración con la API, únete a la comunidad de desarrolladores de AccBooks en community.accbooks.co.uk o contacta con el soporte para desarrolladores en [email protected].