---
title: TOTVS Moda - Como funciona a Integração
description: Integração Vesti com TOTVS Moda
---

[Pular para o conteúdo](https://vendas.vesti.com.br/ajuda/totvs-moda-como-funciona-a-integra%C3%A7%C3%A3o#main-content)

Português - Brasil

Mostrar submenu para traduções

![vesti-horizontal-branco](https://vendas.vesti.com.br/hs-fs/hubfs/Andressa/vesti-horizontal-branco.png?width=90&height=19&name=vesti-horizontal-branco.png)

Abrir navegação principal

Fechar navegação principal

- Português - Brasil
  
  Mostrar submenu para traduções
- Ainda com dúvidas? Fale com a gente

 Ainda com dúvidas? Fale com a gente

 Olá. Como podemos ajudar você?

- Não há sugestões porque o campo de pesquisa está em branco.

1. [Central de Conhecimento](https://vendas.vesti.com.br/ajuda?hsLang=pt-br)
2. [Integrações](https://vendas.vesti.com.br/ajuda/integra%C3%A7%C3%B5es?hsLang=pt-br)
3. [Totvs Moda](https://vendas.vesti.com.br/ajuda/integra%C3%A7%C3%B5es?hsLang=pt-br#totvs-moda)

# TOTVS Moda - Como funciona a Integração

## Guia prático para clientes Este artigo explica, de forma simples, como funciona a integração da Vesti com o TOTVS Moda (Virtual Age) e responde às principais dúvidas sobre produtos, estoque, preços e pedidos.

#### **📦 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?**

Sim.

### **Posso trabalhar com representantes e vendedores juntos?**

Não na mesma integração.  
Serão necessárias duas integrações separadas.

---

#### **🛍 Preço promocional de outra empresa**

Sim, é possível.  
É necessário informar o código da empresa e o código da tabela de preço.

---

#### **🚫 Erro ao integrar pedido (CEP não encontrado)**

Se aparecer erro de CEP:

1. Cadastre o CEP dentro do TOTVS.
2. Resincronize o pedido. ( [Como resincronizar pedido](https://vendas.vesti.com.br/ajuda/-como-for%C3%A7ar-a-ressincroniza%C3%A7%C3%A3o-manualmente?hsLang=pt-br) )

---

**🧩 Componentes do TOTVS (onde encontrar informações)**

No TOTVS Moda, cada tela é chamada de **componente, e na nossa integração com o TOTVS, utilizamos esses componentes por padrão.** Muitas vezes é mais fácil localizar informações pelo código do componente.

Alguns dos principais:

- Preço promocional → PRDFM002
- Descrição do produto → PRDFM164

- [Acessos](https://vendas.vesti.com.br/ajuda/acessos?hsLang=pt-br)
- [Cadastros](https://vendas.vesti.com.br/ajuda/cadastros?hsLang=pt-br#main-content)
  
  
  
  
  
    - [Produtos](https://vendas.vesti.com.br/ajuda/cadastros?hsLang=pt-br#produtos)
- [Link do Vendedor](https://vendas.vesti.com.br/ajuda/link-do-vendedor?hsLang=pt-br)
- [Pedidos](https://vendas.vesti.com.br/ajuda/pedidos?hsLang=pt-br)
- [Configurações da Loja](https://vendas.vesti.com.br/ajuda/configura%C3%A7%C3%B5es-da-loja?hsLang=pt-br#main-content)
  
  
  
  
  
    - [Frete](https://vendas.vesti.com.br/ajuda/configura%C3%A7%C3%B5es-da-loja?hsLang=pt-br#frete)
    - [Produtos](https://vendas.vesti.com.br/ajuda/configura%C3%A7%C3%B5es-da-loja?hsLang=pt-br#produtos)
    - [Descontos](https://vendas.vesti.com.br/ajuda/configura%C3%A7%C3%B5es-da-loja?hsLang=pt-br#descontos)
- [Integrações](https://vendas.vesti.com.br/ajuda/integra%C3%A7%C3%B5es?hsLang=pt-br#main-content)
  
  
  
  
  
    - [Bling](https://vendas.vesti.com.br/ajuda/integra%C3%A7%C3%B5es?hsLang=pt-br#bling)
    - [Tiny](https://vendas.vesti.com.br/ajuda/integra%C3%A7%C3%B5es?hsLang=pt-br#tiny)
    - [WebPic - Dapic](https://vendas.vesti.com.br/ajuda/integra%C3%A7%C3%B5es?hsLang=pt-br#webpic-dapic)
    - [Totvs Moda](https://vendas.vesti.com.br/ajuda/integra%C3%A7%C3%B5es?hsLang=pt-br#totvs-moda)
    - [API](https://vendas.vesti.com.br/ajuda/integra%C3%A7%C3%B5es?hsLang=pt-br#api)
- [Relatórios](https://vendas.vesti.com.br/ajuda/relat%C3%B3rios?hsLang=pt-br)
- [Representantes](https://vendas.vesti.com.br/ajuda/representantes?hsLang=pt-br)
- [VestiPago](https://vendas.vesti.com.br/ajuda/vestipago?hsLang=pt-br)
- [Clientes](https://vendas.vesti.com.br/ajuda/clientes?hsLang=pt-br)
- [Marketing](https://vendas.vesti.com.br/ajuda/marketing?hsLang=pt-br)
- [Oráculo](https://vendas.vesti.com.br/ajuda/or%C3%A1culo?hsLang=pt-br#main-content)
  
  
  
  
  
    - [Campanhas](https://vendas.vesti.com.br/ajuda/or%C3%A1culo?hsLang=pt-br#campanhas)
    - [Salvy](https://vendas.vesti.com.br/ajuda/or%C3%A1culo?hsLang=pt-br#salvy)
    - [Como o Oráculo Funciona?](https://vendas.vesti.com.br/ajuda/or%C3%A1culo?hsLang=pt-br#como-o-or%C3%A1culo-funciona)
    - [YCloud](https://vendas.vesti.com.br/ajuda/or%C3%A1culo?hsLang=pt-br#ycloud)
- [Implantação](https://vendas.vesti.com.br/ajuda/implanta%C3%A7%C3%A3o?hsLang=pt-br)
- [Encontros ao vivo](https://vendas.vesti.com.br/ajuda/encontros-ao-vivo?hsLang=pt-br#main-content)
  
  
  
  
  
    - [Varejo](https://vendas.vesti.com.br/ajuda/encontros-ao-vivo?hsLang=pt-br#varejo)
- [Suporte Técnico](https://vendas.vesti.com.br/ajuda/suporte-t%C3%A9cnico?hsLang=pt-br)
- [Showroom](https://vendas.vesti.com.br/ajuda/showroom?hsLang=pt-br)

[![Chill listening crop-3](https://vendas.vesti.com.br/hs-fs/hubfs/vestilogobranco.png?width=35&height=24&name=vestilogobranco.png "Chill listening crop-3")](http://vesti.co)

Central de Conhecimento Vesti

<https://www.instagram.com/vestioficial> <https://www.youtube.com/c/Vestioficial>

Copyright © 2026, Vesti Locação e Prestação de Serviços de Software LTDA