Ligue qualquer sistema ao OneBooks.
Uma API OAuth 2.0 assente em normas, com tokens delimitados por âmbito e webhooks, e ainda MCP para agentes de IA — a base da plataforma para programadores do OneBooks. Sincronize o seu sistema ou construa um agente aqui e vá mais longe com aplicações que funcionam dentro do OneBooks e uma ficha no Marketplace.
OAuth 2.0 + PKCE
código de autorização, rotação de tokens de renovação, registo dinâmico, fluxo de dispositivo
Tokens com âmbitos
âmbitos de leitura e escrita por domínio — faturas, recebimentos, relatórios…
Todos os planos
acesso à API e ao MCP em todos os planos do OneBooks, incluindo o Grátis
Da consola aos clientes.
Registar a sua aplicação
Crie-a na consola para programadores e desenvolva com empresas sandbox gratuitas.
Desenvolver
OAuth 2.0 padrão com PKCE e âmbitos; endpoints documentados para documentos, recebimentos e relatórios; webhooks para o que muda; MCP se estiver a construir um agente.
Lançar
Passe a revisão da aplicação e ela pode ligar-se a qualquer empresa OneBooks. Para aparecer no Marketplace, submeta uma ficha à sua própria revisão.
Normas, sem surpresas.
Se já integrou com qualquer fornecedor OAuth moderno, já sabe como isto funciona.
- ✓ OAuth 2.0 — código de autorização com PKCE, rotação de tokens de renovação, registo dinâmico RFC 7591, fluxo de dispositivo RFC 8628 para aplicações nativas, descoberta RFC 8414 / 9728.
- ✓ Âmbitos por domínio — faturas, recebimentos, compras, relatórios e mais, em leitura ou escrita, consentidos empresa a empresa.
- ✓ Idempotência em todo o lado — todas as escritas financeiras aceitam uma chave de idempotência, pelo que as repetições são seguras.
- ✓ Webhooks e uma API de eventos — entregas assinadas com novas tentativas para mais de 40 eventos, e um registo de eventos para pôr tudo em dia.
- ✓ Versões datadas da API — fixe a versão com que desenvolveu; cada uma continua suportada durante 12 meses depois de chegar a seguinte.
- ✓ MCP para agentes — a mesma superfície de autorização expõe ferramentas tipadas para agentes de IA, com escritas confirmadas por uma pessoa.
Para além da API.
A API é uma parte da plataforma para programadores do OneBooks. Quando uma integração não chega, crie uma aplicação que os comerciantes usam dentro do OneBooks.
- ✓ Aplicações dentro do OneBooks — as suas próprias páginas, ações no menu Aplicações de um registo e cartões nos registos e no painel, numa moldura isolada com tokens de sessão de curta duração.
- ✓ Dados de aplicação nos registos — os seus próprios campos tipados em faturas, clientes, artigos e mais nove tipos de registo.
- ✓ Funções alojadas — o seu código é executado com os eventos num ambiente isolado que só alcança os destinos que declarar.
- ✓ O Marketplace de aplicações — passe a revisão da ficha e todas as empresas OneBooks podem encontrar e instalar a sua aplicação; cobra diretamente aos seus clientes e fica com 100% do que cobra.
- ✓ Empresas em sandbox — desenvolva e teste sem tocar em contabilidade real.
API do OneBooks — perguntas frequentes
Que autenticação usa a API?
OAuth 2.0 — código de autorização com PKCE para aplicações, registo dinâmico de clientes para clientes de autosserviço, o fluxo de dispositivo para aplicações nativas sem redirecionamento, e rotação de tokens de renovação em todo o percurso.
Existe uma sandbox?
Sim — a consola para programadores cria empresas em sandbox para poder desenvolver e testar com contabilidade realista sem tocar nos dados de um cliente.
Que planos do OneBooks podem ligar a minha aplicação?
Todos. O acesso à API e ao MCP está incluído em todos os planos, incluindo o Grátis, por isso qualquer empresa OneBooks pode ligar a sua aplicação.
Preciso de uma ficha no Marketplace?
Não. É a revisão da aplicação que lhe permite ligar-se a empresas reais. A ficha no Marketplace é opcional e tem a sua própria revisão antes de ser publicada.
Posso construir um agente de IA sobre a plataforma?
Sim — o OneBooks expõe um servidor MCP na mesma superfície OAuth, com ferramentas tipadas, acesso delimitado por âmbito e escritas confirmadas por uma pessoa.
Os meus clientes podem ter o OneBooks sem custos?
Através do nosso programa de parceiros, os fornecedores de POS e de plataformas podem oferecer aos seus clientes verificados o plano Standard do OneBooks sem custos. Fale-nos do seu produto na página Seja nosso parceiro.
Construa a integração que os seus clientes estão a pedir.
Crie uma conta de programador gratuita, desenvolva numa sandbox e entre em produção depois de uma única revisão.