Software de contabilidade com uma API

Todas as partes do Nordlet estão disponíveis através de uma única API JSON, com SDKs, webhooks, tentativas idempotentes e um servidor MCP para assistentes de IA.

Uma API (interface de programação de aplicações) é uma forma de um programa comunicar com outro. Uma API de contabilidade permite que o seu próprio software crie faturas, registe pagamentos e consulte relatórios, sem que ninguém tenha de navegar por ecrãs.

O Nordlet é um software de contabilidade em que a API é a principal via de acesso. Tudo o que a aplicação web faz está disponível através da mesma API JSON. Esta página destina-se a programadores e aos responsáveis por decidir com o que o seu produto se liga.

O que o Nordlet faz

Uma estrutura de pedido uniforme. Cada chamada segue o formato POST /v1/{module}/{resource}/{action} com um corpo em JSON, por exemplo sales/invoices/create ou bank/transactions/match.
Chaves de API com âmbitos (scopes). Cada chave pertence a uma única empresa e possui âmbitos específicos, tais como sales:read ou bank:write. Uma chave sem o âmbito necessário recebe uma resposta 403.
Valores monetários como texto. Os montantes são strings decimais com um máximo de 4 casas decimais, nunca números de vírgula flutuante (floating-point numbers), evitando assim a perda de cêntimos devido a arredondamentos.
Um formato de erro único. Todos os erros utilizam o mesmo invólucro (envelope), contendo um código, uma mensagem e um ID de pedido.
Consultas de listagem partilhadas. Todas as chamadas de listagem (list) aceitam os mesmos campos de paginação, ordenação e filtragem, podendo também devolver totais.
Regras contabilísticas reais. Os lançamentos contabilísticos devem estar equilibrados, a numeração dos documentos não pode ter falhas e um período contabilístico encerrado rejeita novos lançamentos com uma resposta 409. Todas as alterações são registadas num registo de auditoria (audit log).

Tentativas seguras com idempotência

Uma rede pode falhar depois de o seu pedido ter sido processado, mas antes de receber a resposta. Tentar novamente nessa situação poderia resultar na duplicação da fatura. A idempotência significa que um pedido repetido produz exatamente o mesmo efeito que o primeiro.

Envie um cabeçalho Idempotency-Key em qualquer chamada que altere dados.
Uma nova tentativa com a mesma chave e o mesmo corpo devolve a resposta guardada, acompanhada do cabeçalho x-idempotent-replay: true.
A utilização da mesma chave com um corpo diferente é rejeitada.
As chaves são guardadas durante 24 horas.

Webhooks

Um webhook é uma mensagem enviada pelo Nordlet para o seu servidor quando ocorre um evento, tal como sale_invoice.paid.

Os eventos são gravados na mesma transação de base de dados que a alteração, pelo que uma alteração revertida não envia nenhum evento.
Cada entrega é assinada com HMAC-SHA256 utilizando o segredo da sua subscrição, permitindo-lhe verificar se provém do Nordlet.
As entregas falhadas são repetidas durante cerca de 24 horas. Também pode reenviá-las manualmente.
As subscrições são geridas em Conta → Webhooks ou através da API.

Ferramentas para programadores

Referência da API. Uma referência da API interativa gerada a partir da descrição OpenAPI, juntamente com uma coleção do Postman.
SDKs. Clientes tipados para TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift e Rust, gerados a partir da mesma descrição. Consulte o guia de SDKs.
Servidor MCP. Assistentes de IA, como o Claude, podem efetuar pesquisas e chamar a API utilizando a sua chave de API. Consulte o guia do servidor MCP.
Empresas em modo sandbox. Uma empresa de teste funciona como uma empresa real, está identificada como dados de teste e envia declarações e faturas eletrónicas exclusivamente para os endpoints de teste das administrações públicas.
Limitação de velocidade (rate limit). 300 pedidos por minuto por cada chave de API, com cabeçalhos que indicam a capacidade restante.

FAQ

O que posso fazer através da API?

Tudo o que está disponível no produto: faturação, compras, a contabilidade geral, reconciliação bancária, inventário, ativos, saldos, relatórios e obrigações fiscais setoriais. O guia de introdução acompanha todo o ciclo, desde a emissão da fatura até aos valores de IVA.

Posso integrar a contabilidade no meu próprio produto?

Sim. Cada empresa no Nordlet tem a sua própria contabilidade, e o seu software opera sobre ela através da respetiva chave de API. A API não dispõe de nenhuma operação para editar ou eliminar um lançamento contabilístico validado. Qualquer correção é efetuada através de um novo lançamento, mantendo assim um diário imutável.