Integração WinThor Uappi: estoque em lote e NF-e emitida no ERP

A integração WinThor Uappi conecta o seu ERP à Uappi de forma automática, sincronizando produtos, estoque, preços e pedidos sem digitação manual. O catálogo nasce no WinThor, o saldo publicado é o saldo real e cada venda entra no ERP como pedido, pronto para separação e faturamento.

O TOTVS WinThor é um ERP de atacado e distribuição, com filiais, política comercial por região e um fluxo de expedição feito para mover volume. A Uappi é uma plataforma brasileira de e-commerce voltada a projetos sob medida e operações B2B e B2C. A integração é a ponte entre os dois — e ela só funciona bem quando respeita o que cada lado exige de verdade.

Neste conteúdo você vai ver como a conexão funciona na prática, quais problemas ela elimina, o que a API da Uappi permite e por que o modelo ERP First é o caminho mais seguro para quem leva o WinThor a sério.

O que é a integração WinThor Uappi?

É a conexão automática entre o ERP TOTVS WinThor e a Uappi, fazendo os dois sistemas trocarem dados sem intervenção manual.

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

Por que integrar o WinThor exige atenção?

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

• Estoque por filial. Uma distribuidora com mais de um centro de distribuição não tem “um” estoque. O canal precisa enxergar o saldo da filial que realmente atende aquele pedido.
• Política comercial. Preço no WinThor depende de tabela e condição. O valor publicado precisa sair da regra certa, não de um campo solto.
• Fluxo por rotinas encadeadas. Pedido, separação, faturamento e expedição seguem uma ordem. Um pedido que entra fora dela vira exceção no fechamento.
• Tratamento fiscal distinto. Vender no atacado para CNPJ e vender pelo canal para consumidor final não são a mesma operação.

O que a API da Uappi permite?

• A autenticação tem dois níveis: um App-Token fixo no cabeçalho e um token temporário enviado como Bearer, obtido no recurso de autenticação.
• O estoque tem rotas próprias e em lote: PUT /v2/products/stock-batch para definir quantidade e stock-movements-batch para movimentações.
• Há webhooks por domínio — produto, pedido, cliente — que exigem resposta 200. Depois de 10 tentativas sem sucesso, o webhook é desativado.
• Na importação, os campos obrigatórios são SKU, nome, preço de, preço por, categoria de nível 1 e marca.
• Os limites são por endpoint e devolvidos nos cabeçalhos X-RateLimit-Limit e X-RateLimit-Remaining, com 429 no excesso.
• A NF-e é gerada pelo ERP do lojista; a Uappi consulta e exibe a nota, mas não a emite.

Os webhooks não são em tempo real: são processados por rotina periódica. Quem desenha a integração supondo notificação instantânea de pedido acaba prometendo à operação um tempo de resposta que a plataforma não entrega. O ritmo real precisa entrar no combinado desde o começo.

Quais problemas surgem sem a integração entre WinThor e Uappi?

• 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 WinThor Uappi?

A Plugar.me opera como uma camada entre o WinThor e a API da Uappi. 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.

Chave nova nasce bloqueada

Por padrão, uma chave de API recém-criada na Uappi tem todos os endpoints bloqueados. É preciso liberar explicitamente cada método e cada caminho que a integração vai usar. Esquecer disso não gera um erro óbvio de credencial: gera 403 de acesso negado, que costuma ser confundido com token inválido e consome horas de diagnóstico. É o primeiro item a conferir quando algo não sobe.

Como funciona o controle de estoque?

O saldo sai do WinThor 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 do atacado, parte é de outra filial que não atende aquele canal. A integração precisa respeitar essa separação, senão você vende o que já está reservado.

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

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

Para uma distribuidora acostumada a vender para CNPJ, a venda pelo canal é majoritariamente para consumidor final, pessoa física — o que muda tratamento fiscal e cadastro. O canal recebe a informação do documento emitido; ele não substitui essa etapa. Seu fiscal continua sendo um só.

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

1. O cliente compra na Uappi.
2. A integração captura o pedido e o cria no WinThor, 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 WinThor 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 TOTVS WinThor e a Uappi. 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 e atacadistas?

• 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 WinThor, 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?

• Distribuidoras e atacadistas abrindo venda direta ao consumidor.
• Operações com mais de uma filial, onde estoque e faturamento não são triviais.
• Empresas que já rodam WinThor e não pretendem trocar o ERP para vender online.

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 WinThor?

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 TOTVS WinThor, isso é inversão de comando.

• Estoque, preço e cadastro têm uma origem: o WinThor.
• 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 WinThor Uappi?

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 WinThor 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 Uappi 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 WinThor à Uappi?

Vale quando a Uappi 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 WinThor, 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 WinThor 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.