Pular para o conteúdo
Veltra Ajuda
Manual da APIPlaybookEntrar

Trilha · Módulo 6

Comprovantes

Comprovantes

Cada vez que o motorista conclui uma baixa (entrega, coleta, ocorrência ou transferência), o Veltra emite um comprovante. Neste módulo você aprende o que ele contém, onde consultar e baixar, e como funciona a assinatura ICP-Brasil, que é opcional e escolhida por cada transportadora.

O que o comprovante registra#

O comprovante reúne os dados do fato, cada um com a sua origem:

Dados, fotos e selo de integridade de um comprovante.
Dados, fotos e selo de integridade de um comprovante.
  • a hora da baixa, em três horários rotulados: "Hora do celular (declarada, pode estar ajustada)", "Recebido no servidor Veltra" e, quando existe assinatura, "Assinado no servidor Veltra";
  • o local informado pelo aparelho;
  • as fotos e os códigos de verificação (hash SHA-256) de cada arquivo;
  • o nome, o documento e a imagem da assinatura de quem recebeu, que entram como dados dentro do comprovante.
Regras de emissão e do que aparece no comprovante.
Regras de emissão e do que aparece no comprovante.

A hora do celular é só uma informação complementar, porque o aparelho pode ter o relógio ajustado. A referência de tempo do comprovante é a hora do servidor do Veltra, conforme o acordo contratual entre você e o Veltra.

Selo de integridade e custódia#

O comprovante é um selo de integridade e custódia dos dados da baixa. Ele permite conferir se o conteúdo mudou depois de emitido e identifica o emitente. Ele não substitui a assinatura do recebedor e não autoriza descartar o canhoto em papel.

O Veltra registra e guarda as evidências. Se o comprovante será aceito por um embarcador, uma seguradora, a Receita ou um juiz, isso depende de parecer jurídico e de acordo com cada um deles. O Veltra não promete esse resultado.

Consultar e baixar#

Abra a lista de comprovantes

No portal, entre em Comprovantes (/comprovantes). Filtre por ambiente (Produção ou Teste), tipo, manifesto, documento ou chave de 44 dígitos, motorista, período e situação.

Comprovantes emitidos, com filtros por período e situação.
Comprovantes emitidos, com filtros por período e situação.

Entenda a situação

  • Em emissão: o comprovante está sendo montado.
  • Aguardando fotos: falta o aparelho enviar as fotos. A tela mostra a causa, por exemplo "Aguardando fotos do aparelho".
  • Emitido: pronto para baixar.
  • Retificado: existe uma versão nova, com link para ela.

Baixe o PDF e o pacote de evidências

Abra o comprovante e use Baixar PDF ou Baixar pacote de evidências. Os dois ficam habilitados quando a situação é Emitido ou Retificado. Se aparecer "Ainda sendo emitido; tente de novo em instantes", aguarde um pouco.

O pacote traz o manifesto.json, a assinatura (quando houver), as fotos e o arquivo hashes.sha256, para qualquer pessoa conferir fora do Veltra.

Seu sistema também pode consultar os dados pela API, com a chave de acesso. Veja o módulo 5, "Webhooks e chaves de acesso".

Verificação pública#

Quem recebe o PDF pode conferi-lo sem login em /v. Basta digitar o código impresso no PDF e no QR, ou soltar o manifesto.json. O navegador calcula o código de verificação (hash) do arquivo e compara com o registrado; o arquivo em si nunca é enviado. A página não mostra nome, documento, foto, coordenada, placa nem número de nota.

Resultado da verificação pública de um comprovante.
Resultado da verificação pública de um comprovante.
Página aberta a qualquer pessoa para conferir a autenticidade de um comprovante.
Página aberta a qualquer pessoa para conferir a autenticidade de um comprovante.

Assinatura ICP-Brasil: módulo opcional por transportadora#

Enquanto a validação está desligada, o Veltra emite o comprovante sem assinatura ICP-Brasil, e o documento diz isso de forma clara. Isso não é erro: é uma escolha da transportadora.

Cadastro opcional do certificado da transportadora para assinar comprovantes.
Cadastro opcional do certificado da transportadora para assinar comprovantes.

A assinatura é um módulo opcional, que cada transportadora liga por conta própria:

  1. Certificado próprio. Você cadastra o seu e-CNPJ A1 em Certificado (/certificado). Ele precisa ser do CNPJ da sua própria empresa e do tipo A1 em arquivo. O Veltra não assina com um certificado dele no lugar do seu.
  2. Termo de ativação. Em Configuração do comprovante (/configuracao-comprovante), um administrador lê e aceita o termo de ativação. O aceite fica registrado (quem, quando, versão) e vale entre você e o Veltra. Se o termo mudar, é preciso aceitar de novo.
  3. Validação ligada. Com o termo aceito, a validação ligada na configuração e o certificado ativo, cada baixa nova sai assinada no padrão AD-RB da ICP-Brasil.

O texto completo do termo está em termo de ativação.

Limites que você precisa conhecer#

  • Não há carimbo do tempo de uma Autoridade de Carimbo do Tempo. A referência de tempo é a hora do servidor do Veltra, aceita entre as partes por cláusula contratual.
  • A assinatura AD-RB só pode ser verificada como válida enquanto o certificado usado estiver dentro da validade e não revogado. Depois, valem os registros guardados e o acordo sobre a referência de tempo.
  • Dependendo do leitor de PDF, a assinatura pode aparecer como "desconhecida", porque alguns leitores não confiam na cadeia ICP-Brasil por padrão. Nesse caso, confira pelo validador do ITI ou pelo código de verificação.
  • O efeito jurídico dessa assinatura sem carimbo depende de parecer, e a revisão por advogado é recomendada, mas opcional.

Cuidados com o certificado#

  • Só administradores cadastram, renovam ou removem o certificado, e o portal pede um login recente para isso.
  • O arquivo e a senha são guardados cifrados e nunca aparecem de volta. A tela mostra só os dados do certificado (titular, validade, situação).
  • O A1 vale 1 ano. Renove antes de vencer, enviando o certificado novo: o anterior fica no histórico. Por padrão, o portal avisa a 60, 30, 15 e 7 dias do vencimento e no dia.
  • Se o certificado vencer, os comprovantes continuam sendo emitidos e ficam "pendentes de assinatura". Ao renovar, a fila volta a andar sozinha, e a assinatura leva a data real em que foi feita.
  • Você pode remover o certificado a qualquer momento. Os novos comprovantes ficam pendentes de assinatura até haver outro, e os já assinados continuam guardados.

Custo do módulo#

A assinatura ICP-Brasil é cobrada por celular ativo, junto com a mensalidade. Não há um número fixo neste texto: o valor por aparelho aparece na tela de contratação e na sua fatura. O módulo 7, "Plano e pagamento", explica como o consumo do mês e o crédito de incentivo funcionam.

Se você estiver experimentando o módulo com crédito de incentivo, ele se desliga sozinho quando o crédito acaba, com aviso antes. O que já foi gerado, como os comprovantes assinados, continua acessível.

Corrigir um comprovante: retificação#

Um comprovante emitido nunca é editado nem apagado. Se for preciso corrigir algo, um administrador abre o comprovante e usa Retificar, escolhendo a categoria e escrevendo o motivo (de 10 a 500 caracteres). O Veltra cria uma nova versão, ligada à original. A original continua existindo e verificável, e a tela mostra "Retificado por" com o link da versão nova.

Os comprovantes de Produção ficam guardados por, no mínimo, 5 anos, independentemente de pagamento. Os do ambiente de Teste nunca são assinados e podem ser apagados. A sequência de comprovantes de cada transportadora também é encadeada e conferida todo dia, como evidência complementar de integridade.

Canhoto do CT-e e evento 110180#

Para dispensar o canhoto em papel do DACTE, o caminho previsto na legislação fiscal é outro: o evento 110180 (comprovante de entrega do CT-e), registrado pela SEFAZ. No Veltra, ele é o perfil à parte "Comprovante Digital Homologado", desligado por padrão. Para usá-lo é preciso aceitar o termo, ter o certificado da mesma empresa e homologar o serviço na SEFAZ da sua transportadora.

Sem o evento 110180 registrado, o comprovante do Veltra é uma prova complementar e não muda as suas obrigações com o papel. Cada embarcador pode exigir o papel; só o aceite escrito dele cobre esse risco. Por isso, por padrão o papel e o comprovante digital convivem, e o registro de dispensa do papel por embarcador é apenas uma anotação sua. Confirme prazos e regras fiscais com seu contador ou advogado.

Comprovante de estadia#

Em Estadia (/estadia), você vê as visitas com chegada, saída, permanência e o excedente da franquia. Selecione até 50 visitas e use Emitir comprovante de estadia. Os comprovantes aparecem na lista como "Em emissão". Só administradores e operadores da torre emitem. A franquia é configurada pela transportadora; confirme com o seu contador ou advogado.

Relatório de permanência para cobrança de estadia.
Relatório de permanência para cobrança de estadia.

Dados pessoais#

O comprovante guarda nome, documento e imagem da assinatura de quem recebeu, a posição e as fotos, para registrar e provar a entrega. No PDF, o documento do recebedor sai mascarado, conforme a sua configuração. Só no perfil do evento 110180 esses dados vão à SEFAZ sem máscara, porque o leiaute do evento exige. Informe seus recebedores sobre esse tratamento nos seus canais.