TOTVS Moda - Como funciona a Integração

📦 Pedidos

Por que trabalhamos apenas com Pedido de Venda?

Atualmente, a API do TOTVS Moda permite integração Pedido de Venda e Transação.

Porém, existe uma limitação importante sobre transação:

❗ Não é possível fazer ressincronização do pedido quando utilizado Transação.

Isso acontece porque, na documentação da API do TOTVS, não existe endpoint para cancelamento de transação.

É possível integrar condições de pagamento?

Sim ✅
Se sua loja utiliza VestiPago, conseguimos enviar junto ao pedido:

Forma de pagamento (Cartão ou Pix)
Bandeira do cartão (Visa, Master, etc.)
Parcelamento
NSU da transação

Essas informações entram automaticamente no pedido dentro do TOTVS.

💡 O processo de antifraude não é alterado pela integração.

Também é possível configurar qual status o pedido ficará no TOTVS quando for pago (ex: Em progresso ou Bloqueado).

Desconto de Pix e Cupom vão para o pedido?

Sim.
O valor aparece no campo de desconto do pedido, e o nome do cupom ou desconto Pix vai na observação.

É possível enviar classificação ou motivo de cancelamento?

Sim.
Essas configurações podem ser definidas uma única vez para a loja. Depois de configuradas, todos os pedidos seguirão esse padrão automaticamente.

👤 Usuários

Por que o usuário precisa ter acesso à Loja 1 (Matriz)?

Porque a Loja 1 é a principal no ERP.
Normalmente, os produtos são cadastrados nela e depois distribuídos para as demais lojas.

Sem acesso à matriz, podem ocorrer falhas na integração.

👕 Produtos

Quando cadastro um produto novo, o que vem para a Vesti?

Para produtos novos, que ainda não existem na Vesti, serão importados:

✅ Preço
✅ Categoria
✅ Estoque

Desde que essas informações estejam corretamente cadastradas no ERP.

O produto não apareceu na Vesti. O que pode ser?

Verifique:

Se o produto está dentro da classificação configurada na integração.

A cor do produto não veio

A cor precisa estar ativa no ERP.
Se estiver marcada como inativa, ela não será enviada para a Vesti.

Removi a classificação do produto no ERP. O que acontece?

O produto:

❌ Não será mais atualizado
✅ Continua ativo na Vesti

Remover a classificação do produto no TOTVS não desativa automaticamente o produto na Vesti.

Isso acontece porque, ao remover a classificação, o produto deixa de aparecer na resposta da API.

Ou seja, a Vesti não consegue identificar que ele foi desativado — apenas que ele não está mais sendo retornado.

As dimensões e peso são integrados?

Sim.

📌 Importante:

Peso deve estar em KG
Dimensões devem estar em Metros

A Vesti converte automaticamente:

KG → Gramas
Metro → Centímetros

Se forem cadastrados em outro formato, o cálculo de frete pode ser afetado.

Se nenhuma unidade for configurada:

Peso padrão: Gramas
Dimensão padrão: Centímetros

📊 Estoque

Existe estoque em tempo real?

Sim ✅

O estoque pode ser atualizado automaticamente quando:

Um produto é aberto no catálogo
Um vendedor abre o pedido
O cliente inicia o checkout

O sistema consulta o ERP e atualiza o estoque na Vesti naquele momento.

Por que o estoque está negativo na Vesti?

A Vesti considera:

Estoque disponível = Estoque atual - Peças em pedido e Pedido em Transação.

💰 Preço

Quantas tabelas de preço posso integrar?

Apenas uma por loja.

Como funciona preço promocional?

A promoção deve estar ativa no ERP.

⚠ Importante:

Para remover promoção, é preciso desativar primeiro, não excluir.
Se excluir direto, a alteração pode não refletir na Vesti.

Produto ficou sem preço na Vesti

Pode acontecer quando:

O preço não é atualizado há muito tempo.
A atualização acabou de ser feita (aguardar alguns minutos).
Houve erro na ordem de atualização (produto antes do preço).

Se persistir, o time de integração pode verificar.

Variações com preços diferentes

Na Vesti, o produto assume o preço da última variação atualizada.

Por isso, recomendamos que todas as variações tenham o mesmo valor.

👥 Representantes e Vendedores

Posso trabalhar apenas com representantes?