Pular para o conteúdo
Veltra Ajuda
Manual da APIPlaybookEntrar

APIs dos clientes

Ativa e acompanha as integrações com os sistemas dos clientes (Intemobile, Lincros, Lupeon e Dovac): conta, CNPJs, configurações, histórico e reenvio.

APIs dos clientes

A tela Configuração > APIs dos clientes reúne, num só lugar, os sistemas dos seus clientes que recebem a baixa do Veltra. Cada sistema tem uma aba: Intemobile, Lincros (Anjo), Lupeon (Sherwin) e Dovac (FTP). Quando o motorista dá a baixa, o Veltra avisa o sistema do cliente sem ninguém digitar duas vezes.

Para que serve#

  • Ligar e desligar o envio para cada cliente.
  • Conferir a conta usada (endereço, ambiente, CNPJs atendidos) sem ver a senha.
  • Ver o último envio, o último erro e os envios recentes, e reenviar o que parou.
  • Escolher o que vale como comprovante da entrega.

Quem vê#

Só o Administrador. Os demais perfis não têm o item no menu.

Como usar#

  1. Abra Configuração > APIs dos clientes e escolha a aba do sistema.
  2. Se a aba disser Não criado, clique em Criar conector. Ele nasce desativado.
  3. Em Dados da conta, confira o endereço e os CNPJs atendidos. Use Informar usuário e senha (ou Trocar usuário e senha) para gravar o acesso. A senha é guardada cifrada e nunca volta para a tela: você vê só "Configurado em dd/mm/aaaa".
  4. Clique em Testar conexão. O teste não toca em nenhuma entrega real.
  5. Em Situação, clique em Ativar. Para parar o envio, clique em Desativar e confirme. Sem a configuração completa o botão Ativar fica bloqueado e a tela diz o que falta.

Em Histórico dos últimos envios, os que falharam ou ficaram aguardando configuração têm o botão Reenviar.

A regra do comprovante#

Sem foto do CT-e, enviamos a foto do canhoto. Para cada nota, o comprovante que vai ao cliente é a foto do comprovante do CT-e vinculado. Quando a nota não tem essa foto, vai a foto do canhoto da própria nota. Isso vale para Intemobile, Lincros e Lupeon e vem ligado por padrão. Em Configurações da aba, você pode desligar a opção: então o envio espera a foto do CT-e chegar. A Dovac (FTP) recebe o PDF do comprovante; sem ele, a foto do canhoto vira uma página do PDF.

Canhoto em folha A4 (Intemobile)#

O canhoto da Intemobile é a folha A4 inteira, não o canhoto pequeno. Por isso, para as notas dos clientes atendidos pela Intemobile, o app do motorista pede "Fotografe a folha inteira" e usa a mesma captura do comprovante do CT-e. O Veltra envia essa imagem sem recorte. A opção Canhoto em folha A4 inteira aparece marcada na Intemobile e pode ser marcada em outro sistema que use folha grande.

Dúvidas comuns#

  • O Ativar não funciona. Falta algo na configuração: endereço da API, CNPJs ou usuário e senha. A tela avisa.
  • Ativei e nada foi enviado. Confira se há CNPJs atendidos e se a nota é de produção: notas de teste não seguem ao cliente.
  • A senha mudou no cliente. Use Trocar usuário e senha e depois Reenviar os envios que falharam.