Três recursos do Vendelo dependem de coisas que vivem fora do banco do ERP: o boleto e a DANFE, que são PDFs gerados pelo Protheus, e a imagem do produto, cujo arquivo fica no servidor. Os três seguem o mesmo princípio, e é ele que explica o comportamento: o Vendelo não fabrica esses documentos, ele busca os que o ERP já tem. Este artigo mostra o que precisa existir do lado do cliente e o que fazer quando o recurso aparece como indisponível.
Índice
O princípio comum
O Vendelo recupera boleto e DANFE, nunca os emite. O boleto foi gerado pelo processo do banco no ERP; a DANFE vem da nota autorizada. O Vendelo apenas entrega ao vendedor o documento que já existe.
Isso é o que garante que o vendedor entregue ao cliente exatamente o documento oficial, no layout homologado, e não uma reprodução parecida. A contrapartida é que, se o ERP não tiver o documento, não há o que buscar.
O agente de impressão
Antes de qualquer discussão sobre boleto e DANFE, um item de infraestrutura precisa estar resolvido: o agente de impressão que acompanha o SmartClient tem que estar presente em cada instância que atende a integração.
Sem esse agente, nenhum PDF gerado pelo servidor sai. Boleto, DANFE e DANFE nativo falham juntos, e o console acusa agente de impressão não encontrado. É um arquivo copiado, mas derruba os três recursos de uma vez.
Coloque esse item no checklist de instalação. Ele costuma ser esquecido porque não afeta nada até o cliente pedir o primeiro documento.
Boleto
O boleto em PDF depende de uma rotina do próprio cliente, publicada no ambiente de customização dele. É essa rotina que devolve o boleto no layout homologado do banco.
Por que assim, e não uma geração própria do Vendelo:
- o layout do boleto é homologado entre o cliente e o banco dele;
- cada banco tem um formato, e o cliente normalmente já tem essa rotina funcionando;
- um boleto gerado de outro jeito pode ser recusado no pagamento.
Se o cliente já tem uma rotina de boleto, inclusive uma rotina padrão do ERP, ela pode ser indicada na configuração. Não é preciso desenvolver nada novo nem recompilar a integração.
DANFE
A DANFE segue a mesma lógica: uma rotina do cliente devolve o documento a partir da nota autorizada. Enquanto a nota não estiver autorizada, não existe DANFE a buscar.
Vale explicar isso ao cliente antes do go-live, porque a expectativa natural do vendedor é ver a DANFE assim que o pedido é faturado, e há um intervalo até a autorização.
Quando o recurso aparece como indisponível
Se a rotina não estiver publicada no ambiente, o Vendelo informa que o recurso não está disponível.
Essa mensagem é a resposta correta, não um defeito. A alternativa seria devolver um PDF sintético parecido com um boleto, que alguém acabaria enviando a um cliente final. Melhor dizer que não está configurado.
| Sintoma | Causa provável | Ação |
|---|---|---|
| Recurso indisponível ao pedir boleto | Rotina do cliente não publicada, ou não indicada na configuração | Publicar a rotina, ou indicar a existente |
| Recurso indisponível ao pedir DANFE | Mesma causa, ou nota ainda não autorizada | Conferir a situação da nota primeiro |
| Nenhum PDF sai, e o console acusa agente | Agente de impressão ausente | Copiar o agente para todas as instâncias |
| Boleto sai em layout diferente do esperado | A rotina indicada não é a que o cliente homologou com o banco | Confirmar qual rotina deve ser usada |
Imagens de produto
No Protheus, o cadastro do produto guarda apenas o nome do arquivo da foto; o arquivo em si fica no sistema de arquivos do servidor. Por isso a importação de imagem tem comportamento próprio e vem desligada por padrão.
Esse padrão é deliberado: a maior parte das bases não mantém foto no cadastro de produto, e ligar por ligar só adicionaria peso à carga inicial.
Como a importação evita mover megabytes à toa
Quando ligada, a importação não transfere tudo toda vez. Antes de pedir qualquer binário, o Vendelo compara o que já tem com o que existe no ERP e transfere apenas:
- produtos que ainda não têm foto no Vendelo;
- produtos cuja foto mudou de tamanho no ERP.
Duas consequências úteis: em regime contínuo, o tráfego de imagem tende a zero; e uma carga inicial interrompida não refaz o que já entrou, bastando repetir a carga.
Limites de proteção
| Proteção | Efeito |
|---|---|
| Teto de tamanho por imagem | Acima do teto, o arquivo nem é lido e o produto fica sem foto. O motivo fica registrado. |
| Transferência em pequenos lotes | Evita acumular muitas imagens em memória durante a carga |
| Tempo limite próprio | Um lote lento não pendura o ciclo inteiro da sincronização |
Esses limites existem porque já causaram problema em homologação: uma foto de vários megabytes e uma página inteira de imagens chegaram a derrubar o ciclo. Não os afrouxe sem folga de recurso.
Dimensionar a importação de imagens
Antes de ligar, levante três coisas com o cliente:
Quantos produtos têm foto e onde os arquivos estão no servidor.
Qual o tamanho típico das imagens. Foto de catálogo não precisa de vários megabytes, e o Vendelo gera miniatura de qualquer forma.
Qual a janela para a primeira importação. Em homologação, cerca de setenta megabytes de foto levaram uns quinze minutos.
Ligue a importação junto com a carga inicial, fora do horário de uso. Ligar depois, com a operação rodando, transforma a primeira sincronização num pico de tráfego.
O que testar na homologação
| Teste | Resultado esperado |
|---|---|
| Solicitar boleto de um título elegível | PDF real no layout do banco, ou aviso de indisponível se a rotina não existir |
| Abrir a DANFE de uma nota autorizada | PDF real da nota |
| Abrir a DANFE de uma nota ainda não autorizada | Aviso claro, não erro genérico |
| Abrir um produto com foto no ERP | Foto exibida, se a importação estiver ligada |
| Abrir um produto sem foto | Produto normal, sem imagem, sem erro |
| Produto com foto acima do teto | Produto sem imagem, com o motivo registrado |
Perguntas frequentes
O Vendelo emite boleto?
Não. Ele recupera o boleto que o ERP gerou, no layout que o cliente homologou com o banco. Isso evita entregar ao cliente final um documento que poderia ser recusado.
O cliente precisa desenvolver uma rotina nova?
Normalmente não. A maioria já tem uma rotina de boleto funcionando, e ela pode ser indicada na configuração, inclusive se for uma rotina padrão do ERP.
Por que a DANFE não aparece logo depois de faturar?
Porque ela vem da nota autorizada. Entre o faturamento e a autorização existe um intervalo, e nesse período não há DANFE a buscar.
Devo ligar a importação de imagens?
Só se o cliente mantém foto no cadastro de produto e quer usá-la no catálogo. Ela vem desligada porque a maior parte das bases não mantém.
Ligar imagens deixa a integração lenta?
A carga inicial fica mais pesada, e por isso deve ser feita fora do horário de uso. Em regime contínuo o custo é baixo: só transfere foto nova ou alterada.
Um produto ficou sem foto. Por quê?
As causas comuns são arquivo ausente no servidor, arquivo acima do teto de tamanho ou arquivo ilegível. O motivo fica registrado, então vale conferir antes de mexer na configuração.
A carga de imagens foi interrompida. Preciso recomeçar do zero?
Não. Basta repetir a carga: o que já entrou não é transferido de novo.
Posso aumentar o teto de tamanho das imagens?
É configurável, mas avalie com a Vendelo. Os limites existem porque imagens grandes já derrubaram ciclos de sincronização em homologação.
Próxima leitura
Cancelar ou encerrar um pedido integrado?: Pedido que não vai seguir adiante: saiba quando encerrar (eliminar o resíduo) e quando cancelar, e o que o ERP permite.
