Nordlet para desarrolladores de aplicaciones

Integre facturación, contabilidad y declaraciones de impuestos de la UE en su software a través de una sola API JSON, SDK tipados, webhooks, un servidor MCP y empresas de prueba (sandbox companies).

Muchas aplicaciones generan eventos monetarios: se paga un pedido, se renueva una suscripción o se emite un reembolso. Cada uno de estos eventos debe registrarse en la contabilidad de la empresa.

Nordlet es un programa de contabilidad concebido desde el diseño para la API (API-first). Todo lo que hace la aplicación web también está disponible a través de una única API JSON. Su aplicación envía los eventos, y Nordlet se encarga de llevar la contabilidad y preparar las declaraciones de impuestos.

Qué hace Nordlet

Expone cada acción como POST /v1/{module}/{resource}/{action} con un cuerpo JSON, por ejemplo, /v1/sales/invoices/create.
Autentica cada solicitud con una clave de API que pertenece a una empresa. Cada clave cuenta con permisos (scopes), tales como sales:read o sales:write, que limitan lo que puede hacer.
Toma los importes como cadenas de texto decimales, nunca como números de coma flotante, de modo que no se pierdan céntimos por redondeo.
Acepta una cabecera Idempotency-Key en cada modificación. Un reintento con la misma clave devuelve la primera respuesta en lugar de repetir la operación. La idempotencia significa que una solicitud repetida produce el mismo efecto que una sola solicitud.
Devuelve todos los errores en un formato compartido uniforme.
Permite 300 solicitudes por minuto por cada clave de API.
Registra cada modificación en un registro de auditoría (audit log).

La guía de convenciones de la API aborda cada una de estas reglas en detalle.

Libros contables que siempre son correctos

La emisión de una factura asigna un número secuencial sin huecos, comprueba que el periodo contable esté abierto y registra el asiento contable en la misma transacción de la base de datos.
Todo asiento debe cuadrar. La propia base de datos verifica esta condición al guardar la transacción.
Los documentos emitidos y registrados no se pueden eliminar. Una conciliación bancaria errónea se corrige mediante un asiento de reversión (reversing entry), no editando el registro anterior. En esto consiste un libro mayor inmutable.

SDK, MCP y webhooks

Se generan SDK tipados a partir de la misma descripción de OpenAPI para TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift y Rust. Hasta que se publique un SDK, puede instalarlo desde su repositorio de código fuente. Consulte la guía de SDK.
Hay disponible una colección de Postman con todos los puntos de acceso (endpoints).
El servidor MCP permite que un asistente de inteligencia artificial como Claude Code busque en la API y la invoque con su clave de API. Cada llamada es una solicitud de API ordinaria con los mismos permisos y límites.
Los webhooks notifican a su aplicación cuando ocurre un evento, por ejemplo, sale_invoice.issued o sale_invoice.paid. Cada envío está firmado con una firma HMAC para que pueda verificar que proviene de Nordlet. Los envíos fallidos se reintentan durante aproximadamente 24 horas.

Pruebas con empresas de prueba (sandbox)

Cree una empresa con isSandbox: true, o marque la casilla de entorno de pruebas al configurar una empresa en la aplicación.
Una empresa de prueba funciona igual que una real: mismos módulos y misma API.
Se identifica claramente como datos de prueba, y no es posible convertir una empresa real en una de prueba ni viceversa.
Las declaraciones y las facturas electrónicas de una empresa de prueba se envían a los servicios de ensayo de las administraciones.
El uso en una empresa de prueba se mide y se factura del mismo modo que en una empresa real.

La guía de introducción le guía paso a paso en la obtención de su primera clave de API, la emisión de su primera factura y el ciclo completo.

FAQ

¿Puede una sola aplicación dar servicio a varias empresas?

Sí. Cada clave de API pertenece a una empresa, por lo que debe crear una clave por cada empresa. Cada envío de webhook incluye el parámetro companyId de la empresa a la que pertenece, lo que permite que un único receptor gestione varias empresas.

¿Tengo que preparar las declaraciones de impuestos por mi cuenta?

No. Nordlet genera las declaraciones a partir de la contabilidad. Dependiendo del país, para cada declaración se encarga de enviarla, genera un archivo listo para su carga o muestra las cifras que debe introducir manualmente. La tabla de soporte de declaraciones enumera todos los casos.