Ligar a sua loja em linha à sua faturação sem reintroduzir as encomendas

Uma encomenda de loja e uma fatura suíça não carregam os mesmos campos

Uma encomenda registada no WooCommerce, no Shopify ou no PrestaShop descreve um carrinho, uma morada de entrega, um modo de expedição e um pagamento cobrado ou pendente. Uma fatura suíça pede outra coisa, um devedor identificado, linhas ligadas a uma conta e a um código de IVA, uma referência de pagamento estruturada e, na maior parte dos casos, uma secção QR conforme. Os dois objetos assemelham-se no ecrã e divergem no detalhe. É nessa diferença que se alojam as reintroduções de segunda-feira de manhã.

Na realidade circulam três fluxos, e não têm nem o mesmo ritmo nem o mesmo sentido. O primeiro desce da loja para o software de gestão, leva as encomendas e os clientes. O segundo sobe do software para a loja, leva os artigos, os preços e as quantidades disponíveis. O terceiro liga a cobrança à contabilidade, pela conta bancária, pelo prestador de pagamento ou por ambos. Uma cadeia que trata apenas o primeiro fluxo deixa o catálogo, as quantidades e a cobrança à mão.

Antes de qualquer técnica impõe-se uma decisão de gestão, a de saber onde vive a referência de cada dado. O catálogo é mantido na loja ou no software, o preço de venda faz fé do lado do comércio ou do lado da gestão, o número de cliente vem do sítio ou da base existente. Enquanto essa questão ficar em aberto, dois sistemas escrevem o mesmo dado e ninguém sabe qual tem razão no dia em que diferem.

O que um conector já feito retoma mesmo, e o que fica no cais

Vários fornecedores publicam conectores de loja. A Abacus anuncia Shopify, WooCommerce por pingWoo, Magento e PepperShop. A SelectLine anuncia Shopware, Shopify e Venabo. O WinBIZ publica um conector WooCommerce, uma ligação de encomendas PrestaShop e um conector Sempio. A Infoniqa regista um diretório de 175 ligações de terceiros, das quais 159 declaradas compatíveis com o ONE 50. O Odoo ocupa uma posição diferente, vivendo a loja e a gestão no mesmo sistema, o que desloca a questão da interface para o perímetro funcional.

O que estes conetores cobrem é real e útil, a retoma das encomendas, a criação ou a atualização do cliente, a criação de um documento comercial, muitas vezes o retorno das quantidades. O que raramente cobrem está nos detalhes que fazem o volume de negócios exato. O conector genérico trata o caso nominal, uma encomenda simples, paga, entregue de uma só vez. São as encomendas que se afastam desse caso nominal que tomam tempo todas as semanas.

Antes de assinar é portanto preciso ler a ficha do conector linha a linha e confrontar cada campo com as suas encomendas dos últimos doze meses. Um conector que retoma o essencial das encomendas sem intervenção deixa ainda assim uma fila diária de casos particulares, e essa fila custa mais em atenção do que em minutos.

• As variantes de artigo, tamanho, cor, embalagem, e a sua correspondência com um código de artigo único
• Os descontos por linha, os vales de desconto e os preços por grupo de clientes
• Os portes de envio e de processamento, com a sua própria taxa de IVA
• Os adiantamentos, os pagamentos parciais e as assinaturas renovadas
• As devoluções, as notas de crédito e os reembolsos parciais do prestador de pagamento
• As encomendas em várias moedas e os custos de câmbio

Os portes de envio, os adiantamentos e as devoluções fazem divergir o total antes da contabilidade

O IVA é o primeiro ponto de atrito. As taxas em vigor desde 1 de janeiro de 2024 são de 8,1 % para a taxa normal, 2,6 % para a taxa reduzida e 3,8 % para o alojamento, e os fornecedores suíços documentam o seu tratamento, o WinBIZ por exemplo nos formulários oficiais da Administração federal das contribuições. A questão não está aí. Está em saber que taxa a loja aplica aos portes de envio, como trata uma encomenda fora da Suíça, e se os preços afixados são introduzidos com IVA incluído de um lado e sem IVA do outro.

O segundo ponto de atrito é a cobrança. Um prestador de pagamento raramente transfere o montante da encomenda, transfere um saldo líquido, por lotes, após retenção das suas comissões e dedução dos reembolsos do período. A contabilidade espera o inverso, uma fatura, uma cobrança, um lançamento de encargos. Sem regra de conciliação estabelecida de antemão, a conta bancária e o razão afastam-se um pouco todas as semanas, e o fecho ocupa-se de descobrir porquê.

O terceiro ponto é a devolução de mercadoria. Um cliente reembolsado produz três acontecimentos distintos, um movimento de stock, uma nota de crédito, e um reembolso financeiro. Uma loja gere isso no seu próprio vocabulário, um software de gestão no seu. Decidir como um se traduz no outro é um trabalho de conceção, e esse trabalho faz-se uma vez, com calma, e não caso a caso.

Dois stocks para um só artigo, e a questão de saber qual faz fé

Uma PME que vende em loja e em linha detém dois contadores para o mesmo artigo. O problema não é torná-los iguais num dado instante, é definir quem descreve a verdade entre duas sincronizações e o que acontece quando ambos descem ao mesmo tempo. A resposta depende do seu comércio, do prazo de preparação, do volume e da aceitação ou não de uma rutura pontual.

O perímetro do software conta aqui mais do que o conector. No bexio, a gestão de lotes, de números de série e de vários armazéns não está documentada na ajuda do fornecedor no dia da consulta, e a importação de produtos é relatada como limitada a 15'000 linhas. A SelectLine anuncia a produção e a gestão comercial, o Infoniqa ONE 200 a logística e o controlling, o Odoo o stock e a produção no mesmo sistema. A SelectLine instala-se em servidor Windows com Microsoft SQL Server, as suites Infoniqa instalam-se no cliente, e a implementação do Odoo passa em regra por um parceiro. Escolher a profundidade de stock é uma decisão anterior à escolha do conector, não posterior.

Por fim, a reserva merece ser posta preto no branco. Uma quantidade deve sair do disponível no momento da encomenda, do pagamento, ou da expedição. A escolha influi diretamente no número de encomendas que não poderá honrar, e escreve-se nos dois sistemas da mesma maneira, sem o que não quer dizer nada.

Sem webhook, a sincronização torna-se uma regulação de frequência

Um webhook é uma chamada que o fornecedor envia ao seu sistema no momento em que algo muda. Sem ele, a única via que resta é a interrogação periódica, o seu programa pergunta regularmente o que se moveu. A documentação pública do bexio lida a 23 de agosto de 2026 não comporta qualquer secção de webhooks, a do smallinvoice não expõe qualquer caminho de retorno, e a procura do termo no centro de ajuda do WinBIZ fica sem resultado. O Odoo anuncia webhooks, e o AbaNinja anuncia-os logo no seu plano Basic.

A sondagem periódica não é um remendo, é uma arquitetura que se dimensiona. É preciso escolher uma frequência, respeitar a paginação imposta pelo fornecedor, até 500 elementos por pedido no bexio, um meio de detetar o que mudou, uma memória do que já foi tratado, e uma conduta a seguir quando uma chamada falha. A documentação da KLARA indica que existe um limite de débito, com uma resposta 429, sem publicar nem o limiar nem a janela, o que torna o cálculo teórico impossível e impõe uma medição.

Um último detalhe pesa muito na exploração. A documentação da KLARA indica também que não existe um ambiente de teste separado e que cada chamada trabalha sobre os dados de produção. Isso muda a maneira de construir, escrevem-se primeiro leituras, regista-se, repete-se em seco, e só depois se escreve.

O que estabelecemos antes de escrever a primeira linha de código

Não vendemos nenhuma licença. Começamos portanto pelas suas encomendas reais, não pela ficha do conector. Uma amostra das encomendas dos últimos doze meses mostra a parte dos carrinhos simples, a das encomendas com portes de envio particulares, a das devoluções e a dos casos que ninguém tinha mencionado. Essa contagem orienta o resto, diz se um conector padrão basta, se é preciso completá-lo, ou se vale mais escrever diretamente contra a API.

Verificamos em seguida as condições de acesso técnicas, na documentação do fornecedor consultada a 23 de agosto de 2026 e não na sua brochura. A API da SelectLine está incluída a partir da edição Premium e pressupõe a instalação do Mobile Manager e da Toolbox. A do Odoo Online só está aberta na fórmula Custom. No WinBIZ, a documentação indica que a chave de API se obtém sendo parceiro segundo as condições gerais de parceria. No Crésus, as trocas passam por máscaras de importação e de exportação em texto e em CSV.

Depois escrevemos a receção antes da mecânica. Uma encomenda de ensaio com variante, uma com portes de envio, uma com adiantamento, uma com devolução parcial, uma fora da Suíça, cada uma com o resultado esperado no software de gestão e na contabilidade. No dia em que a cadeia roda, esse conjunto de ensaios torna-se o controlo que relança após cada atualização da loja ou do software, e pertence-lhe.

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.

• Documentação API bexio, REST e JSON, OAuth 2.0 e OpenID Connect, paginação até 500 elementos, nenhuma secção de webhooks a 23.08.2026Condições de acesso à API do bexio e ausência de webhooks na documentação lida
• Documentação para programadores KLARA, ausência de ambiente de teste separado, resposta 429 sem limiar publicadoConstrangimentos de exploração de uma sincronização por interrogação periódica
• Tarifas smallinvoice, plano FREE, STARTER a CHF 15 por mês com acesso API incluídoCusto de entrada de um acesso API numa solução de faturação suíça
• API externa Odoo, acesso aos dados reservado às fórmulas Custom no Odoo OnlineCondição de abertura da API segundo a fórmula de assinatura
• Ajuda em linha da API SelectLine, perímetro ERP, pré-requisitos Mobile Manager e Toolbox, nenhum webhook documentadoPré-requisitos técnicos de uma integração SelectLine
• Assinaturas SelectLine na Suíça, API incluída a partir da edição Premium a CHF 119.- por utilizador e por mêsEdição mínima que dá acesso à API
• Centro de ajuda WinBIZ, obtenção de uma chave de API condicionada ao estatuto de parceiro segundo as condições gerais de parceriaCondição de acesso à API do WinBIZ
• Página de produto WinBIZ, declarações de IVA em formulários da Administração federal das contribuições com as taxas de 2024, normal 8,1 %, reduzida 2,6 %, especial 3,8 %Taxas de IVA suíças tratadas e perímetro funcional
• AbaNinja, planos Starter, Basic e Pro, API e webhooks anunciados logo no plano BasicCaso de um fornecedor suíço que documenta webhooks
• Especificações do Crésus Faturação, trocas por máscaras de importação e de exportação em texto e em CSVNatureza das trocas de dados na ausência de API pública documentada
• Conectores anunciados pela Abacus, entre os quais Shopify, WooCommerce por pingWoo, Magento e PepperShopPerímetro dos conectores de comércio em linha anunciados pelo fornecedor
• Diretório oficial Infoniqa das ligações de terceiros, 175 soluções das quais 159 declaradas compatíveis ONE 50Ecossistema de pontes nomeadas em torno do ONE 50

LEVANTAMENTO DE 23.08.2026

Perguntas frequentes