A integração entre o Totvs Moda e a Base permite uma gestão automatizada e centralizada das operações do seu e-commerce.
Funcionalidades Principais da Integração
Sincronização de dados de produtos.
Atualização automática de estoques.
Atualização de preços promocionais e regulares.
Integração de pedidos confirmados.
Atualização de clients PF e PJ.
Atualização de status de pedidos.
Envio dos XMLs do Totvs Moda para o Base.
Configuração de Dados de Integração
Entre em contato com o time de atendimento para solicitar a criação de URL de configuração da ferramenta.
Acesse a Base > Integrações > TOTVS Moda e instale
Acessa a URL criada pelo time da Base e acesse com o login e senha disponibilizado
Acesse a página “Dados Integração” no menu lateral
Preencha e altere os campos obrigatórios com os dados da sua operação. Alguns exemplos:
branch_code: Código da filial (Informação do TOTVS Moda)
inventory_id: Identificador do inventário
Painel Base > Configurações de produtos > Inventário > ID
Price Group: Identificador de grupo de preços a ser considerado
Painel Base > Configurações de produtos > grupos de preços > ID
Warehouse: Identificador do depósito
Painel Base > Configurações de produtos > warehouse > incluir “bl_” + ID
url_host_base:
Informar: https://api.Base.com/connector.php
url_host_moda: URL API do Moda
token_base: Token de autenticação
Painel Base > Config de integração
location: Armazém do Moda
Client ID: Utilizado na API do Totvs Moda
Client Secret: Utilizado na API do Totvs Moda
Username: Usuário utilizado na API do Totvs Moda
Password: Senha do usuário que será utilizado na API do Totvs Moda
3. Clique no botão “Salvar” para concluir.
Configuração de Payload: o que vai ser sincronizado
Aqui você decide quais dados vão ser levados em conta nas sincronizações feitas com o Totvs Moda.
Produto: Configuração de parâmetros de produtos
Dados relevantes:
branchInfoCodeList – Código da empresa utilizado no Totvs Moda
branchCode – Código da empresa utilizado no Totvs Moda
type – Código do tipo de classificação que será considerado para integração dos produtos.
Para integração do produto se faz necessário ter uma classificação específica para integração dos produtos, pode ser criada a “8888” conforme consta no exemplo ou pode se utilizar uma já existente e só alterar nas Configurações do Payload.
Estoque: Controle de atualizações de saldo
Dados relevantes:
inSalesOrder: Define se o sistema deve considerar produtos que estão em pedidos ainda não faturados
branchSalesOrderCodeList: Código da empresa no Moda para saldo em pedidos
branchStockCodeList: Código da empresa para saldo de estoque
inTransaction: Define se o sistema deve considerar produtos que estão em movimentação
branchTransactionCodeList: Código da empresa para essas transações
branchCode: Código da empresa
type: Tipo de classificação para sincronização de estoque
stockCodeList: Lista de saldos de estoque que serão considerados na integração
Preço: Gerenciamento de preços e promoções
Dados relevantes:
branchPriceCodeList: Código da empresa para os preços no Totvs Moda
priceCodeList: Lista de preços que serão sincronizados
branchCode: Código da empresa
type: Tipo de classificação do preço
isPromotionalPrice: Define se o sistema deve buscar também os preços promocionais do Moda
Como funciona a atualização de status dos pedidos
Você consegue fazer com que o status dos pedidos fique igual nos dois sistemas, sem precisar alterar manualmente
Como Atualizar Status:
Os status configurados na Base são carregados automaticamente na execução do job de status
Os principais status do Moda que precisam ser vinculados para que as integrações funcionem são “Faturado”, “Cancelado” e “Aguardando Faturamento”
Os textos têm de estar exatamente como escritos na imagem abaixo.
Acesse a página “Configuração de Status”
Edite os valores no campo “Status Moda” conforme necessário
Clique em “Salvar Alterações” para aplicar as modificações
Pedidos: como são enviados para o Moda
Existe uma tarefa automática chamada “pedido_moda.sinc_order”, que:
Busca todos os pedidos confirmados no Base a cada “x” minutos (conforme definido no agendamento)
Envia os pedidos para o Totvs Moda
Antes do envio, o sistema valida se o cliente já existe e faz o envio do cadastro ou atualização, se necessário.
Notas Fiscais: envio automático dos XMLs
Outra tarefa automática chamada “xml_moda.sinc_xml” busca os XMLs de notas fiscais que foram autorizadas no Totvs Moda e envia para o Base.
O envio é feito no formato Base64
Se uma nota for cancelada, o sistema só envia novamente depois que uma nova nota for emitida e aprovada
⚠️ Importante: Para esse envio funcionar, o módulo da SEFAZ precisa estar configurado no Base.o XML, o Base precisa ter configurado o módulo do Sefaz.
Acompanhamento via Logs: veja tudo o que foi feito
Você pode acompanhar todas as ações feitas pelo sistema.
Para consultar os registros:
Vá para a tela inicial
Use os filtros disponíveis:
Método: Filtra por tipo de ação (ex: envio de pedido, atualização de estoque)
Status: Mostra só os que deram certo (OK) ou os que deram erro
Período: Escolha uma data de início e fim
Clique em Aplicar Filtros
Assim você consegue ver tudo o que aconteceu e resolver mais rápido caso algo não funcione como esperado.
Agendamento de Tarefas: automatize tudo
Você pode deixar todas essas tarefas programadas para rodarem automaticamente. Para isso:
Vá no menu lateral e acesse Agendamento
Configure:
Nome da tarefa (ex: sincronização de estoque)
Frequência com que deve rodar (ex: a cada 30 minutos)
Próxima data de execução
Clique em Salvar Alterações
Tarefas que você pode agendar:
produto_moda.sinc_product → Sincroniza produtos e variantes
estoque_moda.sinc_stock → Atualiza os saldos de estoque
preco_moda.sinc_price → Atualiza os preços
pedido_moda.sinc_order → Envia pedidos para o Moda
status_moda.sinc_status → Atualiza o status dos pedidos
xml_moda.sinc_xml → Envia os XMLs das notas fiscais
📌 Importante: o sistema não roda uma nova tarefa se a anterior ainda não terminou. Por isso, se você configurar uma frequência muito curta, a próxima execução só será feita quando a anterior finalizar.
Finalização
Com a integração configurada, os dados entre o Totvs Moda e o Base serão sincronizados automaticamente conforme os parâmetros definidos. É possível ajustar as configurações e os agendamentos sempre que necessário, além de acompanhar as execuções por meio dos logs. Caso ocorra qualquer divergência, recomenda-se revisar os campos preenchidos e os filtros aplicados para garantir o correto funcionamento das rotinas.
