Nordlet para programadores de aplicações

Adicione faturação, contabilidade e entregas de declarações fiscais na UE ao seu software através de uma única API JSON, SDKs tipados, webhooks, um servidor MCP e empresas sandbox.

Muitas aplicações criam eventos financeiros: uma encomenda é paga, uma subscrição é renovada, um reembolso é emitido. Cada um destes eventos tem de acabar na contabilidade de uma empresa.

O Nordlet é um software de contabilidade criado com a API em primeiro lugar (API-first). Tudo o que a aplicação web faz também está disponível através de uma única API JSON. A sua aplicação envia os eventos e o Nordlet mantém a contabilidade e prepara as declarações fiscais.

O que o Nordlet faz

Expõe cada ação como POST /v1/{module}/{resource}/{action} com um corpo em JSON, por exemplo /v1/sales/invoices/create.
Autentica cada pedido com uma chave de API que pertence a uma empresa. Cada chave possui âmbitos (scopes), tais como sales:read ou sales:write, que limitam o que esta pode fazer.
Aceita montantes como strings decimais, nunca como números de vírgula flutuante (floating-point numbers), para que nenhum cêntimo se perca em arredondamentos.
Aceita um cabeçalho Idempotency-Key em cada alteração. Uma nova tentativa com a mesma chave devolve a primeira resposta em vez de executar o trabalho duas vezes. Idempotência (idempotency) significa que um pedido repetido tem o mesmo efeito que um único pedido.
Devolve todos os erros num formato partilhado.
Permite 300 pedidos por minuto por chave de API.
Regista cada alteração num registo de auditoria (audit log).

O guia de convenções da API aborda cada uma destas regras em detalhe.

Contabilidade que se mantém correta

A emissão de uma fatura atribui um número sequencial sem falhas, verifica se o período contabilístico (accounting period) está aberto e regista o lançamento contabilístico (journal entry) na mesma transação de base de dados.
Cada lançamento tem de estar equilibrado. A própria base de dados verifica isto quando a transação é guardada.
Os documentos emitidos e registados não podem ser eliminados. Uma reconciliação bancária incorreta é anulada com um lançamento de reversão, e não através da edição do documento anterior. É isto que significa um razão imutável (immutable ledger).

SDKs, MCP e webhooks

Os SDKs tipados são gerados a partir da mesma descrição OpenAPI para TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift e Rust. Até que um SDK seja publicado, pode instalá-lo a partir do seu repositório de código fonte. Consulte o guia de SDKs.
Está disponível uma coleção Postman com todos os endpoints.
O servidor MCP permite que um assistente de IA, como o Claude Code, pesquise na API e a invoque com a sua chave de API. Cada chamada é um pedido de API comum com os mesmos âmbitos e limites.
Os webhooks informam a sua aplicação quando algo acontece, por exemplo sale_invoice.issued ou sale_invoice.paid. Cada envio é assinado com uma assinatura HMAC para que possa verificar se provém do Nordlet. As tentativas de envio falhadas são repetidas durante cerca de 24 horas.

Testar com empresas sandbox

Crie uma empresa com isSandbox: true, ou selecione a caixa sandbox quando configurar uma empresa na aplicação.
Uma empresa sandbox funciona como uma empresa real: os mesmos módulos, a mesma API.
Está claramente identificada como dados de teste e não pode converter uma empresa real numa sandbox, nem vice-versa.
As declarações e faturas eletrónicas (e-invoices) de uma empresa sandbox são enviadas para os serviços de teste das administrações.
A utilização numa empresa sandbox é contabilizada e faturada tal como a utilização numa empresa real.

O guia de introdução orienta-o através da primeira chave de API, da primeira fatura e de todo o ciclo.

FAQ

Uma aplicação pode servir várias empresas?

Sim. Cada chave de API pertence a uma empresa, pelo que cria uma chave por empresa. Cada envio de webhook transporta o companyId da empresa a que pertence, permitindo que um único receptor sirva várias empresas.

Tenho de criar as declarações fiscais por conta própria?

Não. O Nordlet gera as declarações a partir da contabilidade. Dependendo do país, para cada declaração o sistema envia-a diretamente, gera um ficheiro para carregar ou apresenta os valores para introdução manual. A tabela de suporte a declarações (filing support table) lista todos os casos.