Integração SAP Business One Bagy: catálogo, estoque e NF-e

A Bagy roda sobre a plataforma Dooca, e isso aparece logo na primeira chamada: os endpoints da API ficam em api.dooca.store. Saber disso evita a confusão mais comum no começo do projeto, que é procurar a documentação técnica no domínio da marca.

A autenticação é simples — Bearer token no cabeçalho Authorization, com o token gerado no painel da loja em Configurações → APIs e Webhooks. O catálogo se organiza em /products e /variations, com a variação carregando sku, price e balance, e os pedidos em /orders, já com os objetos de endereço, pagamento e frete montados.

Para o estoque existe rota dedicada, /stocks, que aceita atualização em lote com o limite de 150 objetos por requisição — número que define diretamente o tamanho do bloco na sincronização vinda do SAP Business One. O preço, por outro lado, não tem endpoint próprio: é campo do produto ou da variação. Essa assimetria entre preço e estoque é o detalhe que costuma ser descoberto tarde e obriga a refazer a fila de sincronização. Conheça os ERPs que integramos.

O que é a integração SAP Business One Bagy?

É a conexão automática entre o ERP SAP Business One e a Bagy, fazendo os dois sistemas trocarem dados sem intervenção manual.

A divisão de papéis não deveria ser negociável: o SAP Business One é a fonte oficial — controla estoque, preços, faturamento e fiscal. A Bagy é canal — apresenta o produto, capta o cliente e registra o pedido.

Por que integrar o SAP Business One exige atenção?

Porque um conector genérico ignora justamente o que faz o ERP funcionar:

• Sincronização de estoque quebrando em lotes grandes. A rota de estoque aceita no máximo 150 objetos por requisição. Esse número define diretamente o tamanho do bloco na sincronização vinda do SAP Business One, e ignorá-lo derruba a carga no meio.
• Preço enviado por uma rota que não existe. Diferente do estoque, o preço não tem endpoint próprio: é campo do produto (price, price_compare) e da variação. Essa assimetria entre preço e estoque costuma ser descoberta tarde, quando a fila já foi desenhada errada.
• Documentação procurada no domínio errado. A Bagy roda sobre a plataforma Dooca e os endpoints ficam em api.dooca.store. Procurar a referência técnica no site da marca atrasa o início do projeto.
• Pedido parado esperando digitação. O cliente já pagou e o pedido ainda não existe no ERP.
• Retrabalho fiscal. Pedido lançado às pressas gera nota com operação errada.

O que a API da Bagy permite?

• A API autentica por Bearer token, gerado no painel da loja em Configurações → APIs e Webhooks.
• Os recursos ficam separados: /products, /variations, /orders e /stocks.
• Estoque tem endpoint próprio, com atualização em lote de até 150 objetos por requisição. Preço, não: é campo do produto e da variação.
• Há webhooks para produtos, variações, categorias, pedidos e carrinhos.
• Os dados da nota fiscal entram no fulfillment do pedido, em nfe_number, nfe_series e nfe_token, junto dos marcos de faturado, enviado e entregue.

Existe um teto de 150 variações por produto. Para catálogo de moda com grade larga — cor por tamanho por modelagem — esse limite aparece antes do que se imagina, e obriga a repensar como o produto é quebrado no cadastro.

Quais problemas surgem sem a integração entre SAP Business One e Bagy?

• Venda de produto sem estoque. O canal segue anunciando o que já saiu no ERP por outra via, e o cancelamento vem depois.
• Pedido parado esperando digitação. O cliente já pagou e o pedido ainda não existe no ERP.
• Preço desatualizado. A tabela mudou no ERP e o canal não acompanhou — margem errada ou venda perdida.
• Retrabalho fiscal. Pedido lançado às pressas gera nota com operação errada.
• Conciliação manual no fechamento. O que o canal registrou não bate com o que o ERP faturou.

Quanto custa continuar no manual?

O custo raramente aparece como linha de orçamento, e é por isso que passa despercebido. Ele aparece como uma pessoa dedicada a copiar pedido, como venda perdida por ruptura que não existia no estoque real, e como margem errada em item cujo preço mudou sem o canal acompanhar.

Enquanto o volume é baixo, dá para absorver. O problema é o teto: passado certo número de pedidos por dia, a digitação deixa de ser incômoda e passa a ser o que impede o canal de crescer.

Como funciona a integração ERP SAP Business One Bagy?

A Plugar.me opera como uma camada entre o SAP Business One e a API da Bagy. Ela traduz os dados de um lado para o outro, orquestra a ordem das operações e trata os erros que aparecem no caminho — porque eles aparecem.

Estoque tem endpoint próprio; preço não tem

Essa assimetria decide o desenho da sincronização. Como o saldo tem rota dedicada e aceita lote, dá para atualizar estoque com frequência alta e custo baixo, sem reenviar o cadastro. O preço, por viver dentro do produto e da variação, exige uma atualização do recurso — então mudança de tabela deve ser tratada num ritmo próprio, e não misturada no mesmo ciclo do saldo.

Como funciona o controle de estoque?

O saldo sai do SAP Business One e atualiza o canal. A pergunta relevante não é apenas “quanto tem”, e sim quanto pode ser vendido ali.

É comum não querer expor todo o saldo: parte está comprometida com pedidos em aberto, parte é de um depósito que não atende o canal. A integração precisa respeitar essa separação.

A Bagy tem rota dedicada de estoque, /stocks, com atualização em lote limitada a 150 objetos por requisição. Na prática isso significa paginar a carga do SAP Business One em blocos de até 150 SKUs e tratar cada bloco como unidade de retentativa — se um lote falha, só ele volta para a fila, e o restante do catálogo permanece consistente.

Como funciona o faturamento e a emissão de notas fiscais?

A nota nasce no SAP Business One. É a regra que separa uma integração ERP First de um conector qualquer.

O pedido segue a cadeia de documentos da empresa e a NF-e é emitida com a operação fiscal correta, dentro do ERP. O canal recebe a informação do documento emitido; ele não substitui essa etapa. Seu fiscal continua sendo um só.

A Bagy registra o pedido com os objetos de endereço, pagamento e frete já montados, o que facilita o lançamento no ERP, mas não emite documento fiscal. A integração devolve à loja a informação da NF-e emitida, mantendo o histórico do comprador completo sem tirar o fiscal de dentro do ERP.

Qual é o fluxo completo, do clique à nota fiscal?

1. O cliente compra na Bagy.
2. A integração captura o pedido e o cria no SAP Business One, na operação correta.
3. O estoque é baixado no ERP e o saldo do canal é atualizado.
4. O pedido segue o fluxo interno de separação e conferência.
5. O faturamento é executado no SAP Business One e a NF-e é emitida.
6. Número da nota e rastreio voltam para o canal.
7. O painel da Plugar.me registra cada etapa em log, para auditoria.

Preciso desenvolver essa integração do zero?

Não existe conector nativo entre o SAP Business One e a Bagy. Os dois lados têm interface; ninguém fez a ponte por você. E a ponte não é só transporte de dados: é mapear a estrutura do ERP, respeitar os limites do canal e tratar o que falha.

O que costuma ser subestimado no desenvolvimento interno não é construir. É manter: o canal muda regra de API, muda exigência de cadastro, muda comportamento. Quem construiu internamente assume essa fila para sempre.

Quais os benefícios para distribuidoras, importadoras e indústrias?

• Volume sem headcount proporcional. Dobrar pedidos não significa dobrar gente digitando.
• Menos cancelamento. O saldo publicado passa a refletir o estoque real.
• Margem sob controle. O preço do canal sai da política definida no ERP.
• Fiscal em um lugar só. A nota nasce no SAP Business One, com a operação correta.
• Fechamento sem conciliação manual. O que aconteceu no canal está registrado no ERP.
• Rastreabilidade. Log de cada etapa, para quando algo precisar ser auditado.

Para quais empresas essa integração é indicada?

• Empresas que rodam SAP Business One e querem canal digital sem trocar de ERP.
• Operações com mais de um depósito, onde estoque e faturamento não são triviais.
• Negócios que precisam de fiscal correto por obrigação, não por preferência.

Se o volume é baixo e não há complexidade fiscal, o manual ainda se sustenta. A conta vira quando o volume cresce ou quando o erro passa a custar reputação.

Por que escolher uma integração ERP First para o SAP Business One?

Porque a alternativa é deixar o canal ditar a operação. Existe um modelo comum em que a plataforma vira o centro: o catálogo passa a viver nela, o pedido é tratado nela e o ERP recebe um resumo depois. Para quem investiu em SAP Business One, isso é inversão de comando.

• Estoque, preço e cadastro têm uma origem: o SAP Business One.
• A nota fiscal nasce no ERP, com a operação da sua empresa.
• O canal é canal — importante, mas não dono do dado.
• Se amanhã você abrir outro canal, a fonte da verdade não muda.

Como a Plugar.me realiza a integração SAP Business One Bagy?

A operação roda 100% em nuvem: não é preciso subir servidor nem manter estrutura adicional na sua infraestrutura.

1. Diagnóstico. Entender como o seu SAP Business One está configurado e o que a operação exige.
2. Mapeamento e setup. Definir de onde sai cada dado, qual operação o pedido da Bagy deve usar e qual saldo o canal enxerga.
3. Go-live assistido. Acompanhamento nos primeiros ciclos, quando os casos de exceção aparecem, com painel de logs para auditar cada etapa.

Conclusão: vale a pena integrar o SAP Business One à Bagy?

Vale quando a Bagy deixa de ser teste e passa a ser canal. A partir daí, digitação manual não é economia: é o teto do canal e a origem dos erros que custam tempo e margem.

A integração bem feita não muda a forma como a sua empresa opera. Faz o contrário: garante que o canal se encaixe na operação que já existe no SAP Business One, em vez de obrigar a operação a se contorcer para caber no canal.

Quer avaliar como ficaria no seu cenário? Fale com a equipe da Plugar.me e conte como o seu SAP Business One está estruturado hoje: volume, estrutura de estoque e como funciona o seu faturamento.

Luan Carvalho

Luan Carvalho é fundador e CTO da Plugar.me, empresa especializada em integração de ERP com marketplaces e plataformas de e-commerce. Atua no desenvolvimento de soluções para automação de pedidos, estoque, preços, faturamento e documentos fiscais, ajudando empresas a escalarem suas operações com estabilidade, segurança e alto desempenho. Ao longo de sua trajetória, participa da implementação de integrações entre ERPs como SAP Business One, Protheus, WinThor, Consinco e Sankhya, conectando-os aos principais marketplaces e plataformas do mercado.