Software de contabilidad con API

Todas las funciones de Nordlet están disponibles a través de una única API JSON, con SDK, webhooks, reintentos idempotentes y un servidor MCP para asistentes de inteligencia artificial.

Una interfaz de programación de aplicaciones (API) permite que un programa se comunique con otro. Una API de contabilidad permite que su propio software cree facturas, registre pagos y consulte informes sin necesidad de que una persona navegue por pantallas.

Nordlet es un software de contabilidad diseñado desde cero con la API como principal vía de acceso. Todo lo que realiza la aplicación web está disponible a través de la misma API JSON. Esta página está dirigida a desarrolladores y a los responsables de decidir la conectividad de sus productos.

Qué hace Nordlet

Estructura de solicitud unificada. Cada llamada sigue el formato POST /v1/{module}/{resource}/{action} con un cuerpo JSON, por ejemplo, sales/invoices/create o bank/transactions/match.
Claves de API con ámbitos (scopes). Cada clave pertenece a una empresa y cuenta con ámbitos específicos, como sales:read o bank:write. Una clave que carezca del ámbito necesario recibirá una respuesta 403.
Importes monetarios como texto. Los importes son cadenas de caracteres decimales con un máximo de 4 cifras decimales; nunca se utilizan números de coma flotante, lo que evita la pérdida de céntimos por redondeo.
Formato de error único. Todos los errores comparten la misma estructura, que incluye un código, un mensaje y un identificador de solicitud.
Consultas de listados normalizadas. Toda llamada de tipo list acepta los mismos parámetros de paginación, ordenación y filtrado, y puede devolver totales.
Normas contables estrictas. Los asientos contables deben cuadrar, los números de documento no pueden presentar saltos y un ejercicio contable cerrado rechaza cualquier nueva contabilización con una respuesta 409. Cada modificación queda registrada en una pista de auditoría (audit log).

Reintentos seguros con idempotencia

Una red puede fallar después de que su solicitud haya sido procesada pero antes de que reciba la respuesta. En tal caso, un reintento podría duplicar la creación de una factura. La idempotencia garantiza que una solicitud repetida produzca exactamente el mismo efecto que la primera.

Envíe una cabecera Idempotency-Key en cualquier llamada que modifique datos.
Un reintento que utilice la misma clave y el mismo cuerpo devuelve la respuesta almacenada, acompañada de la cabecera x-idempotent-replay: true.
Si se utiliza la misma clave con un cuerpo diferente, la solicitud será rechazada.
Las claves se conservan durante 24 horas.

Webhooks

Un webhook es un mensaje que Nordlet envía a su servidor cuando se produce un evento determinado, como sale_invoice.paid.

Los eventos se registran en la misma transacción de base de datos que el cambio correspondiente, de modo que si un cambio se revierte, no se envía ningún evento.
Cada envío está firmado mediante HMAC-SHA256 utilizando el secreto de su suscripción, lo que le permite verificar que proviene de Nordlet.
Los envíos fallidos se reintentan durante aproximadamente 24 horas y también pueden reenviarse manualmente.
Las suscripciones se gestionan desde Cuenta → Webhooks o a través de la API.

Herramientas para desarrolladores

Referencia de la API. Una referencia de la API interactiva generada a partir de la especificación OpenAPI, junto con una colección de Postman.
SDK. Clientes tipados para TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift y Rust, generados a partir de la misma especificación. Consulte la guía de SDK.
Servidor MCP. Los asistentes de inteligencia artificial como Claude pueden realizar búsquedas y llamadas a la API utilizando su clave de API. Consulte la guía del servidor MCP.
Empresas de prueba (Sandbox). Una empresa de prueba funciona exactamente igual que una real, está identificada como dato de prueba y envía las declaraciones y facturas electrónicas exclusivamente a los entornos de prueba de las administraciones.
Límite de solicitudes (Rate limit). 300 solicitudes por minuto y por clave de API, con cabeceras que indican la capacidad restante.

FAQ

Qué puedo hacer a través de la API?

Todas las funciones del producto: facturación, compras, libro mayor, conciliación bancaria, inventario, activos, nóminas, informes y declaraciones fiscales. La guía de inicio detalla un ciclo completo, desde la emisión de la factura hasta el cálculo del IVA.

Puedo integrar la contabilidad en mi propio producto?

Sí. Cada empresa en Nordlet gestiona sus propios libros contables y su software opera sobre ellos mediante su correspondiente clave de API. La API no incluye ninguna función para editar o eliminar un asiento contable ya registrado. Cualquier corrección se realiza mediante un nuevo asiento, lo que preserva la inmutabilidad del libro mayor inalterable.