A integração entre SAP Business One e Tray é direta no catálogo e sutil no estoque. Publicar produto e preço é simples; o que exige desenho é decidir de qual centro de distribuição sai o saldo que a loja mostra — porque a Tray trabalha com múltiplos CDs e o SAP Business One, com depósitos.
A API da Tray usa OAuth 2.0: o lojista autoriza o aplicativo em /auth.php, o integrador recebe Consumer Key e Consumer Secret, e o access_token viaja como query string nas chamadas. Preço é campo do produto ou da variação — não há endpoint dedicado para o preço base —, mas o estoque por centro de distribuição tem rota própria (PUT /multicd/distribution-centers/{id}/stock), além das listas de preço B2B, que são um recurso à parte.
Os limites são generosos, mas finitos: 180 requisições por minuto e 10 mil por dia por loja (50 mil em contas corporativas). A Tray também não oferece ambiente de teste dedicado — a homologação acontece em uma loja compartilhada, o que torna o cuidado com dados de produção parte do projeto desde o começo. É por isso que o mapeamento depósito-SAP → CD-Tray precisa existir antes da primeira carga. Entenda o modelo ERP-first que usamos.
O que é a integração SAP Business One Tray?
É a conexão automática entre o ERP SAP Business One e a Tray, 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 Tray é 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:
- Saldo publicado a partir do centro de distribuição errado. A Tray trabalha com múltiplos CDs e o SAP Business One com depósitos. Sem o mapa entre os dois, a loja anuncia um saldo que fisicamente não atende aquele cliente.
- Teto diário atingido no meio da carga. São 180 requisições por minuto e 10 mil por dia por loja (50 mil em contas corporativas). Uma carga completa de catálogo sem envio incremental consome a cota antes de terminar.
- Teste feito em ambiente compartilhado. A Tray não oferece ambiente de teste dedicado — a homologação acontece em uma loja compartilhada, o que exige cuidado com dados reais desde o início.
- 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 Tray permite?
- A API da Tray usa OAuth 2.0: a loja autoriza o aplicativo e a integração recebe as credenciais para operar.
- O escopo cobre produtos, variações, categorias, clientes, pedidos, nota fiscal e webhooks.
- Existe endpoint específico de MultiCD, para estoque por centro de distribuição — e não apenas um saldo único por produto.
- Preço é campo do produto ou da variação; há endpoints próprios para listas de preço B2B.
O MultiCD é a peça que costuma ser ignorada. Quem publica um saldo único quando a operação tem mais de um centro de distribuição perde a capacidade de dizer de onde a mercadoria sai — e descobre isso na hora de expedir.
Quais problemas surgem sem a integração entre SAP Business One e Tray?
- 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 Tray?
A Plugar.me opera como uma camada entre o SAP Business One e a API da Tray. 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.
| Dado | Direção | O que acontece |
|---|---|---|
| Produtos e categorias | SAP Business One → Tray | Cadastro sai do ERP e alimenta o canal |
| Estoque | SAP Business One → Tray | Saldo correto atualiza a oferta |
| Preços | SAP Business One → Tray | Valor sai da política definida no ERP |
| Pedidos | Tray → SAP Business One | Venda entra como pedido, com a operação correta |
| Clientes | Tray → SAP Business One | Dados do comprador chegam prontos para faturar |
| Nota fiscal | SAP Business One → Tray | NF-e emitida no ERP e informada ao canal |
| Rastreio | SAP Business One → Tray | Código de envio atualiza o pedido |
Estoque por centro de distribuição muda o desenho
A Tray expõe estoque por centro de distribuição, não apenas um número por produto. Para um ERP que já controla saldo por filial ou depósito, isso é uma boa notícia: o desenho pode espelhar a realidade da operação em vez de achatá-la num saldo só. Mas exige decidir, no projeto, qual CD corresponde a qual filial — e manter esse mapa vivo.
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 Tray tem rota dedicada para estoque por centro de distribuição — PUT /multicd/distribution-centers/{id}/stock — e é ela que torna o desenho correto possível. O mapeamento depósito do SAP Business One → CD da Tray precisa existir antes da primeira carga, porque depois de publicado é o saldo do CD que define o que a loja pode vender e de onde sai a entrega.
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 Tray tem recurso de nota fiscal na API, mas no modelo ERP First ele serve para receber a informação do documento já emitido, não para gerar o documento. O pedido segue a cadeia interna — pedido de venda, entrega, NF-e — e a plataforma é notificada ao final, o que mantém numeração e operação fiscal sob controle de um sistema só.
Qual é o fluxo completo, do clique à nota fiscal?
- O cliente compra na Tray.
- A integração captura o pedido e o cria no SAP Business One, na operação correta.
- O estoque é baixado no ERP e o saldo do canal é atualizado.
- O pedido segue o fluxo interno de separação e conferência.
- O faturamento é executado no SAP Business One e a NF-e é emitida.
- Número da nota e rastreio voltam para o canal.
- 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 Tray. 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.
| Caminho | Investimento inicial | Tempo até operar | Manutenção |
|---|---|---|---|
| Desenvolver internamente | Alto | Longo | Sua equipe, para sempre — inclusive quando a API mudar |
| Consultoria sob medida | Alto | Médio | Depende de contrato; cada ajuste é novo escopo |
| Hub ERP-first | Baixo | Curto | Do fornecedor, com o ERP seguindo como fonte da verdade |
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 Tray?
A operação roda 100% em nuvem: não é preciso subir servidor nem manter estrutura adicional na sua infraestrutura.
- Diagnóstico. Entender como o seu SAP Business One está configurado e o que a operação exige.
- Mapeamento e setup. Definir de onde sai cada dado, qual operação o pedido da Tray deve usar e qual saldo o canal enxerga.
- 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 à Tray?
Vale quando a Tray 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 é 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.
