Ligar o bexio às suas ferramentas, o que a sua interface documenta mesmo

A interface REST 2.0 do bexio, lida antes de ser ligada

A interface chama-se a partir de uma raiz única, https://api.bexio.com/2.0/, e troca JSON. A autenticação segue OAuth 2.0 com OpenID Connect, no domínio de autorização https://auth.bexio.com/realms/bexio, em fluxo Authorization Code e depois Refresh Token quando uma aplicação age em nome de um utilizador. Para uma ponte que corre sozinha num servidor, a documentação do fornecedor, consultada a 23 de agosto de 2026, descreve igualmente tokens de acesso pessoais. As duas vias não abrem o mesmo caminho, e a escolha faz-se antes da primeira linha de código.

Esta escolha tem consequências concretas. Um token pessoal está ligado a um utilizador da conta bexio e convém a uma ligação servidor a servidor que diz respeito a uma só empresa. O fluxo Authorization Code convém a uma aplicação chamada a servir várias contas bexio, dando cada uma o seu acordo do seu lado. A documentação pública descreve ambos, assim como a mecânica de renovação dos tokens, o que permite estimar o trabalho antes de se comprometer.

Pormenor que tem a sua importância ao longo do tempo, o número de versão figura na própria raiz da interface. Uma ponte é portanto escrita contra uma versão nomeada, e não contra um endereço anónimo que se movesse sem aviso. É o género de ponto que se anota no momento da conceção e que se relê três anos depois, quando ninguém na empresa se lembra de quem construiu o quê.

Os âmbitos descrevem, objeto a objeto, o que a ponte tem o direito de ver

O bexio reparte os direitos de uma aplicação em âmbitos granulares, um por objeto e por nível de ação. A documentação nomeia por exemplo contact_show para a leitura dos contactos, kb_invoice_edit para a escrita nas faturas, project_show para os projetos. Uma ponte bem concebida pede apenas aquilo de que precisa, e esse pedido relê-se mais tarde, em claro, no dia em que se coloca uma questão sobre o que um automatismo pôde modificar no processo.

É também o primeiro arbítrio de um projeto de integração. Uma ligação só de leitura para um painel não exige os mesmos âmbitos que um automatismo que cria faturas a partir de uma loja em linha. Alargar o perímetro mais tarde toca a própria autorização, portanto a validação pela pessoa que detém a conta. Mais vale estabelecer a lista logo no enquadramento, com a razão de ser de cada linha.

Quinhentos elementos por pedido, e uma limitação de débito a medir

A documentação anuncia uma paginação limitada a 500 elementos por pedido e uma limitação de débito aplicada às chamadas. O primeiro número dimensiona toda a retoma de dados. Uma base de vários milhares de contactos, de artigos ou de faturas relê-se por fatias, com um cursor mantido do lado do integrador, e essa divisão reencontra-se em cada ressincronização posterior, não apenas no dia do arranque.

O segundo número não se lê em parte alguma sob a forma de limiar nas páginas consultadas a 23 de agosto de 2026. Constata-se em condições reais, na conta em causa, observando o comportamento das chamadas quando a cadência sobe. Uma obra séria começa portanto por uma medição e não por uma hipótese, e a cadência escolhida escreve-se na receção, com a conduta a seguir quando a interface recusa uma chamada.

Sem webhook documentado, a frescura dos dados torna-se uma regulação

A documentação pública lida a 23 de agosto de 2026 não comporta qualquer secção dedicada aos webhooks nem a um mecanismo de eventos. Toda a sincronização com outra ferramenta constrói-se portanto em interrogação periódica. O ponto sensível não é a riqueza da interface, é a cadência a que se decide interrogá-la.

Este constrangimento trata-se. Guarda-se do lado do integrador o rasto do que já foi visto, repetem-se as chamadas sem criar duplicados quando uma execução se interrompe a meio, e escolhe-se uma frequência diferente conforme os objetos. Um catálogo de artigos não se move ao mesmo ritmo que um diário de faturas. A conceção dessa mecânica representa uma parte real do trabalho, e merece ser descrita preto no branco antes da encomenda.

Há uma consequência visível para os utilizadores. Uma fatura criada na loja não aparece no bexio no segundo seguinte, aparece no ciclo seguinte. Esse prazo escolhe-se, documenta-se e mostra-se às pessoas em causa, em vez de ser descoberto numa segunda-feira de manhã pelo contabilista que procura uma peça. É uma decisão de gestão tanto quanto um parâmetro técnico.

Nem tudo passa pela interface, e certos fluxos têm o seu próprio canal

Para a retoma inicial, o bexio documenta importações por ficheiros Excel ou CSV para os contactos, os produtos e o plano de contas, descritas nos artigos de ajuda 000001781 e 000001598. Um limite de 15'000 linhas é relatado para a importação de produtos. Esse canal continua muitas vezes o mais curto para carregar um existente, tomando depois a interface o testemunho para a vida corrente dos dados.

Do lado do banco, a retoma dos dados de contas e de transações passa por bLink, a plataforma da SIX. Os pagamentos a partir do bexio pertencem ao bexio Pay, faturado CHF 14.00 por mês e incluído no pacote Ultimate. Os salários saem por Swissdec para as seguradoras e as autoridades, figurando o produto bexio Lohnbuchhaltung no registo oficial em ELM 5.0, 5.1 e 5.3 sob o certificado n.º 1142.24. A QR-fatura, essa, é gerada nativamente.

Dois fluxos merecem uma verificação a montante. O envio de faturas para o e-banking do destinatário por eBill passa por uma aplicação de terceiros do Marketplace, eBill da iomarket AG, faturada à parte. E o bexio não figura na lista OpenPeppol dos Certified Service Providers, atualizada a 21 de agosto de 2026. Uma empresa que tenha de faturar a um dono de obra que exige Peppol olha para outro lado para esse canal preciso, e sabe-o antes de assinar.

O Marketplace cobre um caso conhecido, uma ponte cobre o seu

O Marketplace do bexio anuncia mais de cem aplicações, do comércio em linha à gestão documental. Quando uma aplicação publicada corresponde exatamente à necessidade, é o caminho mais curto, e testa-se antes de qualquer desenvolvimento. A medida começa noutro sítio, ali onde é preciso emparelhar identificadores de clientes entre dois sistemas, aplicar uma regra própria da casa, ou ligar uma ferramenta de ofício interna que mais ninguém usa.

Uma ponte precisa de um acesso à conta, e esse acesso conta-se. Os pacotes publicados a 23 de agosto de 2026 incluem um número de utilizadores fixo, e o preço de um acesso suplementar é publicado para uma parte deles. O arbítrio coloca-se no momento de decidir se o automatismo trabalha sob uma conta técnica dedicada, o que torna os rastos legíveis, ou sob a conta de uma pessoa, o que os mistura com o seu trabalho quotidiano.

Entre as duas opções, o critério útil é a duração de vida. Uma aplicação do Marketplace é um contrato com um terceiro, com o seu próprio ritmo de atualizações e o seu próprio apoio. Uma ponte escrita para a empresa segue os âmbitos e a cadência que lhe foram fixados, e o seu código pertence ao processo. Ambas se justificam, e a escolha coloca-se fluxo a fluxo, não de uma vez por todas.

A saída dos dados prepara-se no dia em que se entra

A ajuda do fornecedor documenta exportações em PDF e em Excel assim como uma função de cópia de segurança. Nenhuma exportação completa da base sob a forma de ficheiro único está documentada nas páginas consultadas a 23 de agosto de 2026. Nesse contexto, a própria interface torna-se um meio de releitura, e os âmbitos concedidos à ponte determinam o que ela pode efetivamente retomar. A questão coloca-se no arranque de um projeto, não no dia em que se deseja partir.

Uma última referência útil. O programa de parceiros oficial do bexio dirige-se às fiduciárias, anunciando o diretório público mais de 1'000 sociedades fiduciárias e estatutos que vão de Prata a Platina. Para a parte técnica, a empresa apoia-se na documentação pública e em quem a sabe ler. Não vendemos nenhuma licença.

• Os objetos a sincronizar, e o sentido de circulação de cada um
• Os âmbitos estritamente necessários, leitura e escrita separadas
• A via de acesso escolhida, token pessoal ou fluxo OAuth completo
• A cadência de sondagem, medida na conta real antes de ser fixada
• A conta sob a qual a ponte trabalha, e o que custa
• O que deve poder sair um dia, e por que canal

De onde vêm estas respostas

Cada facto desta página verifica-se na fonte. As ligações abrem diretamente o site do fornecedor ou do organismo em causa.

• bexio, planos e preçosNomes e preços dos quatro pacotes, utilizadores incluídos e preço de um acesso suplementar, consultados a 23.08.2026
• Documentação da interface bexioRaiz api.bexio.com/2.0, OAuth 2.0 e OpenID Connect, tokens de acesso pessoais, âmbitos, paginação a 500, limitação de débito, nenhuma secção de webhook
• bexio, a QR-faturaGeração nativa da QR-fatura suíça e conciliação dos pagamentos
• bexio, a fatura eletrónicaeBill pela aplicação de terceiros iomarket AG do Marketplace, faturada à parte
• Registo Swissdec dos softwares certificadosbexio Lohnbuchhaltung certificado ELM 5.0, 5.1 e 5.3, certificado n.º 1142.24
• Lista OpenPeppol dos Certified Service ProvidersLista atualizada a 21.08.2026, sem entrada bexio
• Política de privacidade do bexioDados pessoais dos clientes conservados e tratados exclusivamente na Suíça, servidores situados na Suíça
• Comunicado do bexio de 18 de fevereiro de 2026100'000 clientes, filial a 100 % da Mobiliar, novos pacotes a partir de março de 2026
• inside-it, o bexio anuncia 100'000 clientesPosta em perspetiva pela imprensa informática suíça, Swiss21 mais de 80'000 e KLARA 50'000
• Diretório das fiduciárias parceiras do bexioPrograma de parceiros reservado às fiduciárias, mais de 1'000 sociedades listadas, estatutos de Prata a Platina
• inside-it, a Mobiliar assume o bexioAnúncio da compra a 05.07.2018, 100 % das ações

LEVANTAMENTO DE 23.08.2026

Perguntas frequentes