Operação multi-filial funciona na integração com o Protheus, e foi validada com o ciclo completo de pedido rodando numa filial que não é a matriz. O que costuma dar trabalho não é a integração: é o conjunto de cadastros que cada filial precisa ter no ERP. Este artigo explica como a filial entra no Vendelo, o que precisa existir nela e em que ordem preparar uma filial nova.
Índice
A filial principal
A instalação define uma empresa e filial principal, e é ela que se torna a filial padrão do Vendelo. Toda operação que não especifica filial acontece nela.
Confira a filial principal antes de subir o serviço, na instalação. Trocar depois significa remapear o que já foi integrado, e não é uma mudança de configuração trivial.
Como uma filial entra no Vendelo
O cadastro de filiais do Protheus não é monitorado como os demais cadastros. Isso muda o comportamento de um jeito que surpreende na implantação:
Filial nova entra no Vendelo por dois caminhos: na recarga do grupo de filiais pela fila de integração, ou sob demanda, quando o primeiro documento dela chega. Criar a filial no ERP e esperar que ela apareça sozinha no Vendelo não funciona.
Na prática, depois de criar a filial e reiniciar o serviço, o caminho certo é solicitar à Vendelo a recarga do grupo de filiais, que a materializa sem criar documento nenhum. A mesma recarga, em modo de atualização, é o que traz correções feitas no cadastro de uma filial que já existe no Vendelo, porque esse cadastro não gera eventos.
O que vem do cadastro da filial
| Informação | Observação |
|---|---|
| Nome e documentos | Vêm do cadastro da filial no ERP |
| Endereço, com complemento | Inclui a resolução do município |
| Telefone e e-mail | Viram meios de contato no Vendelo. O e-mail depende de o campo existir no dicionário daquela release |
O município é resolvido preferencialmente pelo código oficial. Quando ele está ausente ou inválido, o Vendelo tenta pelo nome da cidade dentro do estado, ignorando diferenças de maiúsculas, acentos, espaços e pontuação.
Se nenhuma estratégia resolver o município, a filial ainda é importada, com documentos e contatos; apenas o endereço fica de fora. Endereço incompleto não coloca a filial em erro nem interrompe o lote. É uma escolha deliberada: uma cidade grafada de forma estranha não deve impedir a operação inteira.
Cadastros exclusivos por filial
Esta é a parte que trava implantações. Alguns cadastros do Protheus são exclusivos por filial, ou seja, existir na matriz não significa existir na filial nova.
| Cadastro | Sem ele na filial |
|---|---|
| Regra fiscal de saída | Não fatura nem calcula imposto. A linha é recusada. |
| Condições de pagamento | O pedido não fecha, com erro de campo obrigatório |
| Armazéns | O produto não é aceito, com erro de produto não cadastrado no armazém |
| Saldo de estoque | O catálogo aparece inteiro, com os produtos zerados; a linha do pedido fica retida no faturamento até entrar saldo |
| Contas correntes | Adiantamento recusado por conta inexistente na filial |
| Naturezas financeiras | Título de tarifa recusado por natureza inválida |
Saldo de estoque não é pré-requisito de catálogo: produto sem registro de saldo na filial aparece com saldo zero e preço normal, e o pedido é aceito (venda sob encomenda). O que o saldo controla é o faturamento: a linha só é liberada quando o estoque entra. Versões da integração anteriores a agosto de 2026 ocultavam esses produtos e deixavam o catálogo da filial vazio; se observar isso, atualize a integração.
O que é compartilhado
Nem tudo precisa ser replicado. Estes cadastros valem para todas as filiais, sem cópia:
- clientes;
- produtos;
- listas de preços;
- vendedores e suas carteiras.
Isso simplifica bastante a abertura de filial: o trabalho fica concentrado nos cadastros fiscais, financeiros e de estoque.
Numeração por filial
A numeração de documentos é por filial. O primeiro pedido de uma filial nova sai com o número inicial dela, independentemente do que já foi emitido na matriz.
Duas consequências práticas:
- Números repetidos entre filiais são normais. A identificação de um documento é o número mais a filial.
- Ao procurar um documento no ERP a partir do Vendelo, confirme a filial antes de concluir que ele não existe.
Licença por CNPJ
A licença TOTVS é validada pelo CNPJ da filial. Uma filial sem licença própria pode falhar no faturamento com mensagem de licença, enquanto a matriz fatura normalmente.
Confirme com a TOTVS a licença de cada filial que vai operar pelo Vendelo. Esse item entra no checklist de homologação como bloqueante, porque só aparece quando alguém tenta faturar de verdade.
Roteiro para abrir uma filial
Criar a filial no Protheus e reiniciar o serviço, porque o cadastro de filiais é lido na subida.
Criar os cadastros exclusivos dela: regra fiscal, condições de pagamento, armazéns, contas correntes e naturezas.
Lançar saldo de estoque nos produtos que a filial já tem fisicamente. Sem saldo o produto aparece zerado e pode ser vendido sob encomenda, mas a linha só fatura quando o estoque entrar.
Confirmar a licença do CNPJ da filial com a TOTVS.
Solicitar à Vendelo a recarga do grupo de filiais pela fila de integração, para a filial se materializar no Vendelo.
Rodar o ciclo completo nela: criar, alterar, encerrar e cancelar um pedido, e faturar.
Conferir no ERP que os documentos ficaram na filial correta, sem vazar para a matriz.
Erros típicos de filial
| Sintoma | Causa |
|---|---|
| Todos os produtos com saldo zero naquela filial | Sem saldo de estoque lançado na filial. O catálogo funciona e aceita pedidos; o faturamento aguarda o saldo |
| Catálogo vazio para os vendedores daquela filial | Integração desatualizada: versões anteriores a agosto de 2026 ocultavam produto sem registro de estoque |
| Produto recusado por armazém | Armazém não cadastrado na filial |
| Pedido não fecha, com campo obrigatório | Condição de pagamento inexistente na filial |
| Linha recusada no faturamento | Regra fiscal de saída ausente na filial |
| Adiantamento recusado por conta | Conta corrente não existe na filial |
| Título de tarifa recusado | Natureza financeira não existe na filial |
| Faturamento falha com mensagem de licença, só nessa filial | Licença TOTVS do CNPJ da filial |
| A filial não aparece no Vendelo | Faltou a recarga do grupo de filiais (ou um documento dela), e o serviço precisa ter sido reiniciado após a criação |
| A filial aparece sem endereço | Município não resolvido. O restante do cadastro veio normalmente |
Perguntas frequentes
Criei a filial no ERP e ela não aparece no Vendelo. É erro?
Não. O cadastro de filiais não gera eventos: ela se materializa na recarga do grupo de filiais ou quando o primeiro documento dela chega. Confirme que o serviço foi reiniciado após a criação e solicite a recarga à Vendelo.
Preciso replicar clientes e produtos na filial nova?
Não. Clientes, produtos, listas de preços e vendedores são compartilhados entre filiais. O que precisa existir na filial são os cadastros fiscais, financeiros e de armazém, além do saldo de estoque do que ela vende de pronta entrega.
Posso vender numa filial que ainda não tem estoque?
Pode. O produto aparece com saldo zero e preço normal, o pedido é aceito e o ERP retém a linha no faturamento até o estoque entrar. É o fluxo da venda sob encomenda. Se o catálogo da filial aparecer vazio, o caso é outro: integração desatualizada, de versão anterior a agosto de 2026.
Dois pedidos com o mesmo número. Isso é problema?
Não, se forem de filiais diferentes. A numeração é por filial, e a identificação do documento inclui a filial.
A filial veio sem endereço. O que faço?
Confira o código do município e o nome da cidade no cadastro da filial no ERP. Como o cadastro de filiais não gera eventos, a correção não entra sozinha: solicite à Vendelo a recarga do grupo de filiais em modo de atualização. A filial continua utilizável nesse meio-tempo.
Posso trocar a filial principal depois de implantado?
Não é uma mudança trivial: ela remapeia o que já foi integrado. Trate como mudança de projeto, com a Vendelo, não como ajuste de configuração.
O vendedor escolhe a filial no aplicativo?
A operação segue a configuração da empresa e as filiais reconhecidas. Valide esse comportamento na homologação com o cliente, porque ele depende de como a operação dele é organizada.
Preciso de licença TOTVS separada por filial?
A licença é validada pelo CNPJ da filial. Confirme com a TOTVS a situação de cada filial que vai faturar pelo Vendelo, antes do go-live.
Próxima leitura
Campos personalizados e solicitações de compra: Precisa de campos além do padrão? Use campos personalizados e integre solicitações de compra.
