A pergunta que mais aparece na implantação é simples de enunciar e cara de errar: onde eu cadastro isso? Este artigo responde item por item. Para cada tipo de dado, em que sentido ele circula, com que frequência e onde deve ser editado. Use esta página para decidir o que entra no treinamento do cliente e o que entra na política interna dele.
Índice
A regra geral
Para os cadastros que só o ERP mantém (produtos, preços, condições de pagamento, filiais), o Protheus é a origem oficial e o Vendelo reflete. Editar esses dados no Vendelo é trabalho perdido: a próxima sincronização sobrescreve.
As exceções não se resumem ao documento de venda. Tudo o que o vendedor pode criar ou alterar no Vendelo é gravado no Protheus pela rotina oficial do ERP: pedido de venda, solicitação de compra e também os cadastros de cliente, fornecedor e vendedor. Nesses casos o dado existe dos dois lados e as alterações circulam nos dois sentidos. Depois de gravado no ERP, o documento passa a ter o Protheus como referência de estado.
Os três regimes
| Regime | Como funciona | Quando o dado atualiza |
|---|---|---|
| Replicado por evento | Uma alteração no ERP é detectada e o Vendelo busca o registro. | No próximo ciclo de sincronização |
| Gravado no ERP | O Vendelo chama a rotina oficial do ERP para incluir ou alterar. | Na hora da operação |
| Consultado on-line | Nada é replicado; o Vendelo pergunta ao ERP no momento em que a tela é aberta. | Sempre atual |
Cadastros: o que replica e em que sentido
Os itens abaixo são replicados por evento a partir do ERP. Alguns também descem do Vendelo para o Protheus pela rotina oficial; a coluna Sentido mostra quais.
| No Vendelo | Sentido | Observação |
|---|---|---|
| Produtos e serviços | ERP para Vendelo | Por padrão, só tipos considerados vendáveis. Imagens são importadas do servidor do ERP quando habilitado |
| Grupos de itens | ERP para Vendelo | |
| Unidades de medida | ERP para Vendelo | |
| Listas de preços | ERP para Vendelo | |
| Clientes | Nos dois | Criado ou alterado no Vendelo, desce pela rotina oficial do ERP |
| Fornecedores | Nos dois | Mesma carga de parceiros dos clientes |
| Transportadoras | ERP para Vendelo | Entram como parceiros somente leitura; a manutenção é no ERP |
| Grupos de parceiros | ERP para Vendelo | O campo de vínculo no cliente é configurável |
| Vendedores e carteiras | Nos dois | Vendedor criado no Vendelo é gravado no ERP. O vínculo com o usuário é por e-mail |
| Territórios | Nos dois | Pelo campo de região do cliente |
| Filiais | ERP para Vendelo | A filial principal configurada vira a filial padrão |
| Condições de pagamento | ERP para Vendelo | |
| Meios de pagamento | ERP para Vendelo | |
| Estados e países | ERP para Vendelo | |
| Municípios | ERP para Vendelo | |
| Finalidades | ERP para Vendelo | Correspondem ao TES. A semântica difere do B1; mapear com atenção |
| Despesas adicionais | Não replica | Não vêm do ERP: frete, seguro e despesa são fixos no Vendelo. Os valores trafegam no pedido, nos dois sentidos |
Tipos de relacionamento entre parceiros não têm equivalente no Protheus e ficam só no Vendelo, embora apareçam na seleção da carga inicial, pois a tela é comum a todos os ERPs. Na dúvida sobre um cadastro, confirme antes de prometer ao cliente.
Documentos: nos dois sentidos
| Documento | Sentido |
|---|---|
| Pedido de venda | Nos dois. Criado no Vendelo vira pedido no ERP; criado no ERP é refletido no Vendelo. |
| Nota fiscal de saída | ERP para Vendelo |
| Devolução | ERP para Vendelo |
| Solicitação de compra | Nos dois. Criada no Vendelo é gravada no ERP; aprovação e atendimento voltam por evento. Exige o campo de identificação C1_XVDOUID no dicionário |
| Cotação | Pode existir só no Vendelo. Vira pedido no ERP quando copiada |
Ciclo do pedido
Quando o vendedor fecha um pedido no Vendelo, a integração chama a rotina oficial de pedido de venda do Protheus. O ERP aplica as mesmas validações que aplicaria numa digitação pela tela: cliente, TES, condição de pagamento, natureza, preço, estoque. Recusa vira mensagem de erro na fila de integração.
Depois de gravado, o pedido segue o fluxo normal do ERP: liberação, faturamento, nota. Cada etapa volta para o Vendelo por evento.
Cancelar um pedido integrado exclui o pedido no Protheus. Encerrar preserva o documento e fecha o saldo. São operações diferentes, e a escolha errada não se desfaz sozinha.
Consulta on-line: nada é replicado
Estas informações não têm cópia no Vendelo. Toda vez que a tela é aberta, o ERP é consultado.
| Informação | Depende de |
|---|---|
| Saldo de estoque | Configuração de depósito |
| Situação financeira do cliente | Nada além do ERP no ar |
| Cálculo de imposto do documento | TES e parametrização fiscal do ERP |
| Boleto em PDF | Rotina publicada pelo cliente |
| DANFE | Nota autorizada e rotina publicada pelo cliente |
A vantagem é o vendedor ver o número atual, não uma cópia de ontem. A contrapartida é que essas telas dependem do ERP estar no ar. Vale explicar isso ao cliente antes do primeiro incidente, não depois.
O que existe só no Vendelo
Nem tudo tem correspondente no ERP. Estes dados nascem e vivem no Vendelo, e não são enviados ao Protheus:
- funil de vendas, oportunidades, etapas, concorrentes e motivos de perda;
- atividades, agenda e planejamento de visitas;
- metas de vendas;
- cotações que ainda não viraram pedido;
- políticas de desconto;
- formas de envio e tipos de relacionamento entre parceiros;
- solicitações de devolução (a devolução em si nasce no backoffice do ERP e é refletida no Vendelo);
- modelos de mensagem, caixa de entrada e banners;
- perfis de usuário, permissões e licenças do Vendelo.
Campos de usuário
Campo personalizado criado no Protheus entra na integração sozinho, desde que exista dos dois lados. O cadastro no Vendelo usa o nome completo do campo, que é a convenção do Protheus:
| Onde o campo está | Modelo de dados no Vendelo |
|---|---|
| Cliente | Parceiro de negócio |
| Fornecedor | Parceiro de negócio |
| Cabeçalho do pedido | Documento de negócio, pedido de venda |
| Linha do pedido | Item do documento |
| Linha da solicitação de compra | Item do documento |
Campo de usuário de produto não entra na integração com o Protheus: o cadastro de Item do Vendelo até aceita campos personalizados, mas a sincronização não os lê nem grava.
Crie o campo pelo Configurador ou UPDDISTR. Campo de tipo data ou lógico criado por comando SQL derruba a gravação da tabela inteira, e o sintoma aparece longe da causa: o pedido passa a ser gravado sem itens, mesmo sem o campo ser enviado.
Onde eu edito cada coisa
| Quero mudar | Edito em | Por quê |
|---|---|---|
| Preço de um produto | Protheus | Lista de preços é do ERP |
| Cadastro de cliente já existente | Qualquer um dos dois | Cliente sincroniza nos dois sentidos: alteração no Vendelo desce pela rotina oficial; alteração no ERP volta por evento |
| Cliente novo, criado pelo vendedor | Vendelo | A integração cria no ERP pela rotina oficial |
| Carteira de um vendedor | Protheus | Cadastro do ERP |
| Quem tem licença de acesso | Vendelo | Licença é do Vendelo, não do ERP |
| Condição de pagamento | Protheus | Cadastro do ERP |
| Pedido ainda em rascunho | Vendelo | Ainda não existe no ERP |
| Pedido já integrado | Depende | Alteração pelo Vendelo usa a rotina oficial; alteração no ERP volta por evento |
| Etapa da oportunidade | Vendelo | Não existe no ERP |
| Foto do produto | Protheus | Arquivo no servidor do ERP; o Vendelo importa quando habilitado |
Perguntas frequentes
Se eu corrigir um endereço de cliente no Vendelo, ele vai para o Protheus?
Vai. O cliente sincroniza nos dois sentidos: a alteração feita no Vendelo é gravada no Protheus pela rotina oficial, com as mesmas validações do ERP. Se o ERP recusar, o erro aparece na fila de integração.
Em quanto tempo uma alteração no Protheus aparece no Vendelo?
O ciclo de varredura roda a cada minuto; some o tempo de processamento da fila. Meça na homologação com o volume do cliente e use esse número para calibrar a expectativa da operação.
O estoque que o vendedor vê é do momento?
É. O saldo é consultado no ERP quando a tela é aberta, não replicado. Por isso ele depende do ERP estar disponível.
Posso desligar a importação de algum cadastro?
Alguns comportamentos são configuráveis, como importar apenas produtos vendáveis ou não importar imagens. Para o resto, avalie com a Vendelo: desligar cadastro que documento depende costuma criar erro na fila em vez de economia.
Cotação vai para o Protheus?
A cotação pode existir apenas no Vendelo. Ela chega ao ERP quando é convertida em pedido.
O que acontece se alguém alterar um pedido no ERP enquanto o vendedor edita no Vendelo?
Existe um controle opcional de concorrência que recusa gravar por cima de uma alteração feita no ERP depois da última leitura. Habilite quando houver backoffice mexendo nos mesmos pedidos.
Metas e atividades vão para o ERP?
Não. São dados do Vendelo, sem correspondente no Protheus.
Como sei se um campo de usuário está sendo sincronizado?
Ele precisa existir dos dois lados: no dicionário do Protheus e cadastrado no Vendelo com o nome completo, no modelo de dados correto. Faltando um dos lados, o campo simplesmente não circula.
Próxima leitura
Produtos, preços, estoque e impostos: Veja como o catálogo se comporta: produtos, preços, saldo de estoque, escolha de depósito e impostos.
