A integração entre o Vendelo e o TOTVS Protheus é nativa: não existe middleware de terceiros nem serviço da Vendelo instalado no servidor do cliente. Este é o artigo-mestre da integração. Ele explica quais são as peças, onde cada uma roda, como uma alteração no ERP chega ao Vendelo, como um pedido do Vendelo chega ao ERP e quem é responsável por cada frente da implantação.
Índice
As peças e onde cada uma roda
São três blocos, em dois lugares.
| Peça | Onde roda | Papel |
|---|---|---|
| Vendelo | Nuvem | Faz a leitura, a triagem e a gravação. É quem toma a iniciativa em todas as operações. |
| Integração publicada no ambiente de customização | Ambiente do cliente | É por onde todo acesso a dado passa. Nada consulta o banco por fora. |
| Objetos próprios da integração no banco | Banco do cliente | Permitem ao Vendelo saber o que mudou no ERP. |
O único tráfego entre o cliente e a nuvem é a chamada do Vendelo para a instância dedicada, autenticada e restrita por rede.
Do Protheus para o Vendelo
O Protheus não avisa sistemas externos quando um dado muda. A integração cobre essa lacuna: toda alteração feita no ERP fica registrada, e o Vendelo a busca e reflete.
Três propriedades desse desenho importam no dia a dia:
- Captura qualquer origem. Alteração pela tela, por rotina automática ou por intervenção direta no banco é detectada do mesmo jeito.
- Só o que realmente aconteceu. O registro da alteração é confirmado junto com o dado. Operação desfeita não gera sincronização.
- Nada se perde. Se a integração ficar fora do ar, as alterações esperam e são processadas quando ela voltar. Várias alterações no mesmo registro resultam em uma sincronização só.
Manutenção de dicionário pelo Configurador pode derrubar objetos da integração. Existe uma verificação automática que reconstrói sozinha, em ciclos curtos. Se as alterações pararem de chegar logo depois de uma manutenção, essa é a primeira causa a investigar.
Do Vendelo para o Protheus
A gravação é sempre explícita. Não existe um caminho genérico que escreva no ERP.
- Cada operação é específica e nomeada: incluir pedido, cancelar pedido, encerrar pedido, criar cliente, criar solicitação de compra, faturar, lançar adiantamento.
- Cada uma usa a rotina oficial do Protheus correspondente, com as mesmas validações que uma digitação pela tela teria. Se o ERP recusaria a operação na tela, ele recusa pela integração também.
- A mensagem de recusa do ERP chega ao Vendelo e aparece na fila de integração.
Isso significa que erro de negócio do Protheus continua sendo erro de negócio do Protheus. Se falta natureza, TES, liberação ou conta corrente na filial, a operação é recusada e a correção é no ERP, não no Vendelo.
Consultas em tempo real
Nem tudo é replicado. Algumas informações são consultadas na hora, direto no ERP, porque replicar não faria sentido:
- saldo de estoque;
- situação financeira do cliente, com títulos, parcelas e vencidos;
- cálculo de imposto do documento;
- boleto e DANFE em PDF;
- imagem do produto, quando habilitada.
A vantagem é que o vendedor vê o número atual, não uma cópia de ontem. A contrapartida é que essas telas dependem do ERP estar no ar.
A fila de integração
Tudo que atravessa a integração aparece na fila, no menu Integrações e auditoria. É a tela de diagnóstico da implantação e do suporte.
Cada item mostra o modelo de dados, o identificador no ERP, a ação, a direção, o status e a mensagem de erro quando houver. Os status são três: Pendente, Sincronizado e Erro.
Uma falha em um registro não derruba o lote. A integração isola o erro naquela linha e segue com os demais, então o resultado normal de uma carga grande é a maioria sincronizada e uma minoria em erro, para tratamento pontual.
O que fica instalado no cliente
| Artefato | Onde | Quem mantém |
|---|---|---|
| Artefatos da integração | Ambiente de customização | Consultor TOTVS, na instalação e nas atualizações |
| Instância dedicada à integração | Configuração da aplicação | Consultor TOTVS, uma vez |
| Objetos próprios da integração | Banco do ERP | Criados e mantidos sozinhos pela verificação automática |
| Agente de impressão | Cada instância que atende a integração | Consultor TOTVS, uma vez |
| Campos de dicionário exigidos pelos recursos usados | Dicionário do cliente | Configurador, na instalação |
Nenhum desses artefatos altera tabela de negócio do Protheus. Os objetos criados ficam fora do dicionário e existem apenas para a integração.
Quem faz o quê
| Frente | Responsável |
|---|---|
| Publicar a integração, configurar a instância, criar campos, licenças | Consultor TOTVS ou TI do cliente |
| Rede, certificado, firewall, VPN | Infraestrutura do cliente |
| Configurar a empresa e a integração, executar a primeira carga | Vendelo |
| Massa, homologação funcional, treinamento e aceite | Consultoria de implantação e cliente |
| Cadastros do ERP que a operação exige | Cliente |
A jornada de uma implantação
Pré-requisitos. Conferir release, banco, ambiente de customização, instância dedicada, usuário exclusivo, rede e janelas.
Instalação. Publicar a integração, configurar a instância dedicada, copiar o agente de impressão, criar os campos necessários e validar.
Configuração. Preencher a configuração da empresa no Vendelo, com endereço, credencial e regras de negócio.
Segurança. Apertar os controles que vêm permissivos por padrão e registrar os critérios de aceite.
Primeira carga. Trazer o acervo do Protheus para o Vendelo, fora do horário de uso.
Homologação. Rodar o ciclo completo com o cliente, do cadastro ao faturamento, e registrar o aceite.
Produção. Acompanhar a fila nos primeiros dias e ajustar o que aparecer.
Perguntas frequentes
Precisa instalar alguma coisa no servidor do cliente?
Precisa publicar a integração no ambiente de customização, configurar uma instância dedicada e copiar o agente de impressão. Serviço executável da Vendelo, não. A integração roda na nuvem.
Qual a latência entre alterar no Protheus e ver no Vendelo?
A alteração é registrada na hora em que acontece; o tempo até aparecer no Vendelo é o do próximo ciclo de sincronização mais o processamento. Meça na homologação com o volume do cliente.
E se a integração ficar fora do ar por um dia?
Nada se perde. As alterações ficam acumuladas no ERP e são processadas quando a integração voltar. Várias alterações no mesmo registro resultam em uma sincronização só.
A integração pode rodar comando arbitrário no banco do cliente?
Não. A consulta aceita apenas leitura, com validação restritiva nos dois lados. As gravações são operações específicas que usam as rotinas oficiais do ERP.
O Vendelo vira a fonte da verdade dos cadastros?
Não. Para os dados que vêm do ERP, o Protheus continua sendo a origem oficial. O Vendelo reflete. Corrigir no Vendelo um dado cuja origem é o ERP é trabalho perdido: a próxima sincronização sobrescreve.
Funciona com mais de uma filial?
Funciona. A filial principal definida na instalação vira a filial padrão do Vendelo, e as demais são reconhecidas. Cada filial precisa dos cadastros exclusivos dela e da licença TOTVS do próprio CNPJ.
Onde eu olho quando algo não chega?
Na fila de integração, filtrando por erro. A coluna de descrição traz a mensagem devolvida pelo ERP, que quase sempre aponta a causa. Se não houver nem item na fila, o problema é anterior: objetos da integração derrubados por manutenção, serviço fora do ar ou rede bloqueada.
A integração mexe nas tabelas do Protheus?
Cria objetos próprios, fora do dicionário e exclusivos da integração. As tabelas de negócio só recebem gravação pelas rotinas oficiais do ERP, quando o usuário emite um documento.
Próxima leitura
O que decidir antes de ativar a integração: Antes de ativar a integração, alinhe as decisões de configuração: conexão, catálogo, documentos e até onde ir no pedido pago.
