Integração CIOT PamCard

Sumário

O que é o CIOT PAMCARD

O CIOT (Código Identificador da Operação de Transporte) é um número obrigatório emitido pela ANTT para contratos de transporte rodoviário de cargas. Ele vincula contratante, transportador e condições de pagamento antes do início da viagem.

A PAMCARD é uma empresa homologada pela ANTT para a emissão eletrônica do CIOT. A integração do TMS Sialog com a PAMCARD permite gerar, cancelar e encerrar o CIOT diretamente da tela de Detalhes do MDF-e, sem sair do sistema

Etapa

 

Emissão

Quando ocorre

 

Antes da viagem partir

Prazo

 

Cancelamento

Até 24h após a emissão, se a carga não foi fiscalizada

24 h

Encerramento

Após a conclusão da viagem

Até 30 dias após o término

Pré-requisitos de Cadastro

O sistema valida automaticamente os cadastros antes de permitir a geração do CIOT. Os itens abaixo precisam estar preenchidos no TMS:

🔵 MOTORISTA VS. FAVORECIDO (Proprietario do veiculo)

O campo Favorecido na aba PAMCARD permite indicar uma pessoa diferente do motorista como beneficiário do pagamento (ex: dono ou proprietario do veículo). Se o Favorecido for informado, as validações de RNTRC, celular e endereço serão aplicadas sobre ele em vez do motorista da viagem.

Dados obrigatórios

RNTRC – Cadastro de Pessoas → aba Informações Internas → campo RNTRC 

Celular (mínimo 10 dígitos) – Cadastro de Pessoas → aba Contatos → tipo Celular

Endereço (logradouro) – Cadastro de Pessoas → campo Endereço

Veículo

RNTRC do veículo – Cadastro da pessoa proprietario do veiculo que fica vinculado no veiculo → campo RNTRC

MDF-e

Status DIGITADO

O CIOT PAMCARD só pode ser gerado antes de o MDF-e ser transmitido à SEFAZ. Se o MDF-e já foi autorizado ou encerrado, a geração é bloqueada.

Motorista vinculado

A viagem deve ter ao menos um motorista do tipo 107 (motorista principal).

Veículo vinculado

A viagem deve ter ao menos um veículo.

Como gerar o CIOT

Acesse a ultima aba dos detalhes do MDFe.

Obs: Caso a aba não esteja aparecendo, entre em contato com o suporte para verificar a parametrização.

Favorecido (CPF/CNPJ)

O que é

CPF ou CNPJ da pessoa que vai receber o pagamento do frete. Pode ser o motorista, proprietário do veículo ou empresa terceirizada.

Obrigatório

Não. Se não preenchido, o sistema usa o motorista vinculado à viagem.

Impacto

A PAMCARD registra o favorecido como beneficiário no contrato de frete. Também é o RNTRC, celular e endereço desta pessoa que são validados antes da geração.

Como preencher

Digite o CPF/CNPJ e pressione Enter. O sistema busca automaticamente o nome no cadastro de pessoas.

 

Distância (km)

O que é

Distância total da viagem em quilômetros.

Obrigatório

Obrigatório. A geração é bloqueada se este campo estiver com valor zero ou vazio.

Impacto

Enviada à PAMCARD. É utilizada no cálculo dos encargos.

Ícone de engrenagem

Oferece dois atalhos:

  • Buscar da rota: preenche automaticamente com a distância cadastrada na rota da viagem.
  • Buscar via API: consulta a distância real utilizando o Google Maps (quando configurado) ou OSRM, a partir das coordenadas de origem e destino.

 

Solução de Pedágio

O que é

Empresa ou sistema de pedágio utilizado pelo transportador.

Obrigatório

Não.

Valor padrão: 11 – Não Informado

Impacto

Enviado à PAMCARD conforme a Tabela 3.

Opções

  • DBTRANS
  • BRADESCO
  • REPOM
  • Sem Parar / Via Fácil
  • PAMCARD
  • TAG
  • TARGET
  • FASTCRED
  • POLICARD
  • UNIK
  • Não Informado
  • MOVE MAIS

Regra

Quando a opção TAG for selecionada, o campo Emissor TAG torna-se visível e obrigatório.

 

Emissor TAG

O que é

Operadora responsável pela TAG de pedágio eletrônico.

Visível

Somente quando Solução de Pedágio = TAG.

Impacto

Enviado à PAMCARD conforme a Tabela 40.

Opções

  • CONECTCAR
  • SEM PARAR
  • MOVE MAIS
  • VELOE
  • TLOG

 

Tipo de Operação

O que é

Define se a carga pertence a um único remetente (Carga Lotação) ou a vários remetentes (Carga Fracionada).

Obrigatório

Obrigatório.

Impacto

Enviado à PAMCARD.

Quando Carga Fracionada for selecionada, o sistema verifica se os CT-es vinculados possuem pelo menos dois remetentes diferentes.

Caso contrário, a geração será bloqueada.

Opções

  • Carga Lotação
  • Carga Fracionada

 

Contratação

O que é

Define a abrangência da contratação do transporte.

Pode considerar:

  • Apenas o veículo trator (cavalo).
  • Toda a composição (cavalo + carreta).

Impacto

Enviado à PAMCARD.

Opções

  • Composição Veicular
  • Só Automotor

 

Pagamento Frete

O que é

Forma de pagamento acordada com o transportador.

Impacto

Enviado à PAMCARD.

Opções

  • À Vista
  • À Prazo

 

Meio de Pagamento

O que é

Canal utilizado para o favorecido receber os valores.

Impacto

Enviado à PAMCARD.

A opção selecionada influencia os tipos de pagamento disponíveis.

Regra

Quando for selecionado Conta Depósito, os campos bancários tornam-se visíveis e passam a ser obrigatórios.

Opções

  • Cartão PAMCARD
  • Conta Depósito

 

Dados Bancários

(Banco / Agência / Dígito da Agência / Nº da Conta / Tipo da Conta)

Visível

Somente quando Meio de Pagamento = Conta Depósito.

Banco

Código do banco com 3 dígitos.

Exemplos:

  • 237 — Bradesco
  • 001 — Banco do Brasil

Agência

Número da agência com até 5 dígitos, sem o dígito verificador.

Dígito da Agência

Dígito verificador da agência (1 caractere).

Caso a agência não possua dígito, deixar o campo vazio.

Número da Conta

Número da conta corrente ou poupança, incluindo o dígito verificador.

Tipo da Conta

  • CC — Conta Corrente
  • PP — Poupança

Impacto

Os dados são enviados à PAMCARD para realização de crédito via TED/DOC ao favorecido.

 

Parcelas

O que é

Cronograma de pagamento do frete ao favorecido.

É obrigatório possuir pelo menos uma parcela.

Obrigatório

Sim.

Quantidade mínima: 1 parcela.

Campos de cada parcela

Tipo

Conforme a Tabela 5 da PAMCARD:

  • Adiantamento
  • Intermediária
  • Saldo Final
  • Vale Abastecimento
  • Combustível
  • Diária
  • Despesa

Data Prevista

Data prevista para pagamento.

Formato: dd/mm/aaaa

Valor (R$)

Valor da parcela em reais.

Utilizar ponto (.) como separador decimal, quando exigido pelo sistema.

Impacto

Cada parcela é enviada individualmente à PAMCARD como um item da programação de pagamento.

A soma de todas as parcelas deve ser exatamente igual ao valor total do frete.

Adicionar parcela

Clique no botão + localizado ao lado do título Parcelas.

Remover parcela

Clique no ícone da lixeira localizado à direita da parcela desejada.

Fluxo de Geração do CIOT

Preencher todos os campos obrigatórios (Distância km e ao menos uma Parcela).

Clicar em “Gerar CIOT PAMCARD”.

O sistema valida os dados de cadastro (RNTRC, celular, endereço do favorecido/motorista e veículo). Se houver pendências, exibe uma lista de erros e não prossegue.


Se as validações passarem, o sistema envia os dados ao AppServer, que aciona a PAMCARD via SOAP.

O resultado aparece em alguns segundos no campo “CIOT:” no topo da aba.


✅ SUCESSO
O número do CIOT é exibido no topo da aba (ex: aba CIOT do MDF-e (guia CIOT).

O número também é registrado automaticamente.

Ex: CIOT: 560000246330


❌ FALHA
Uma mensagem em vermelho aparece com a descrição do erro retornado pela PAMCARD. Os campos ficam habilitados para que o usuário corrija e tente novamente. Consulte a seção 8 para lista de erros e soluções.


⚠ CIOT JÁ GERADO
Se o CIOT desta viagem já foi gerado com sucesso e não foi cancelado, o sistema exibe o número existente e não gera um novo. Para gerar novamente, é necessário cancelar o CIOT atual primeiro.

Cancelamento do CIOT

O cancelamento pode ser feito em até 24 horas após a emissão do CIOT, desde que a carga não tenha sido fiscalizada pela ANTT.

Abrir a aba “Gerar CIOT PAMCARD” do MDF-e que possui o CIOT ativo.

A seção “Cancelar CIOT (prazo: até 24h após emissão)” aparece abaixo do formulário quando o CIOT está ativo.

Digitar o motivo do cancelamento no campo de texto (obrigatório).

Clicar em “Cancelar CIOT”.

Aguardar a confirmação. O processo pode levar alguns segundos.

✅ CANCELAMENTO CONFIRMADO
O status exibido muda para “CIOT nº XXXXXX, cancelado: [motivo]”. O registro na aba CIOT do MDF-e é removido. O formulário é desbloqueado para gerar um novo CIOT se necessário.


⚠ APÓS 24 HORAS
Se o prazo de 24 horas já passou, a PAMCARD recusará o cancelamento e retornará um erro. Neste caso, o CIOT não pode mais ser cancelado — apenas encerrado após a conclusão da viagem.

Encerramento do CIOT

O encerramento confirma para a ANTT que a viagem foi concluída. Deve ser feito após o término da viagem, em até 30 dias.

🔵 ENCERRAMENTO AUTOMÁTICO

O sistema TMS pode disparar o encerramento automaticamente quando a viagem é finalizada (status de encerramento de viagem). Verifique com o administrador se essa automação está configurada.

Se necessário, o encerramento também pode ser feito manualmente pela mesma aba. Os dados de valor do frete e peso da carga são obtidos automaticamente a partir dos documentos vinculados à viagem.

Mensagens de Erro e Como Resolver


Erros de validação (antes de enviar à PAMCARD)
Esses erros aparecem em uma lista de alertas no topo da tela assim que o usuário clica em “Gerar CIOT PAMCARD”.

MensagemCausaComo resolver
Nenhum motorista vinculado à viagem. Vincule um motorista antes de gerar o CIOT.A viagem não possui um motorista principal (tipo 107) vinculado.Acesse a viagem, vincule um motorista cadastrado como motorista principal (tipo 107) e tente novamente.
Motorista “NOME” sem RNTRC cadastrado. Acesse o Cadastro de Pessoas e preencha o RNTRC.O motorista (ou favorecido) não possui RNTRC cadastrado.Acesse Arquivo → Cadastro de Pessoas, localize a pessoa e preencha o campo RNTRC na aba Informações Internas.
Motorista “NOME” sem celular cadastrado. Acesse o Cadastro de Pessoas e informe um celular.Não existe um contato do tipo Celular cadastrado para o motorista (ou favorecido).Acesse Cadastro de Pessoas → Contatos, adicione um contato do tipo Celular com no mínimo 10 dígitos e salve as alterações.
Motorista “NOME” sem endereço cadastrado. Acesse o Cadastro de Pessoas e informe o endereço.O campo Endereço (logradouro) não foi preenchido no cadastro da pessoa.Acesse Cadastro de Pessoas e preencha o campo Endereço (logradouro).
Favorecido informado não foi encontrado no cadastro de pessoas.O CPF ou CNPJ informado não existe no cadastro de pessoas.Verifique se o CPF/CNPJ foi informado corretamente ou cadastre a pessoa em Arquivo → Cadastro de Pessoas.
Nenhum veículo vinculado à viagem.A viagem não possui nenhum veículo vinculado.Acesse a viagem e vincule pelo menos um veículo antes de gerar o CIOT.
Veículo PLACA sem RNTRC cadastrado. Acesse o Cadastro de Veículos e preencha o RNTRC.O veículo informado não possui RNTRC cadastrado.Acesse Arquivo → Cadastro de Veículos, localize o veículo e preencha o campo RNTRC.
Informe ao menos uma parcela antes de gerar o CIOT.Nenhuma parcela foi adicionada ao pagamento do frete.Adicione pelo menos uma parcela clicando no botão + da seção Parcelas.
Informe a distância da viagem antes de gerar o CIOT.O campo Distância (km) está vazio ou possui valor igual a 0.Informe a distância manualmente ou utilize o botão de engrenagem para Buscar da Rota ou Buscar via API.
Somente MDF-e com status DIGITADO permite a geração do CIOT.O MDF-e já foi transmitido, autorizado ou encerrado.O CIOT deve ser gerado antes da transmissão do MDF-e à SEFAZ. Após a autorização, não é mais possível realizar a geração.
Carga Fracionada requer CT-es de pelo menos dois remetentes diferentes. Encontrado(s): X.Foi selecionado o tipo de operação Carga Fracionada, porém os CT-es vinculados pertencem a apenas um remetente.Altere o Tipo de Operação para Carga Lotação ou vincule CT-es de pelo menos dois remetentes diferentes à viagem.

Erros de comunicação com o sistema

MensagemCausaComo resolver
Falha na chamada do servidor de aplicação.O AppServer (servidor de aplicação Delphi) não está respondendo ou está indisponível.Verifique se o AppServer está em execução e se o servidor possui acesso à internet para comunicação com a PAMCARD. Caso o problema persista, entre em contato com o suporte técnico.
MDF-e não encontrado.O ID do MDF-e informado não foi localizado no banco de dados.Feche a tela, abra novamente o MDF-e e tente realizar a operação. Se o problema persistir, entre em contato com o suporte técnico.
Rota não localizada para este MDF-e.A viagem não possui uma rota cadastrada. Esse erro pode ocorrer ao utilizar a opção Buscar da Rota.Cadastre uma rota para a viagem ou informe a distância manualmente antes de gerar o CIOT.
Cidades de origem ou destino sem coordenadas cadastradas.As cidades da rota não possuem coordenadas geográficas (latitude e longitude) cadastradas. Esse erro pode ocorrer ao utilizar a opção Buscar via API.Informe a distância manualmente ou solicite ao administrador que cadastre as coordenadas geográficas das cidades de origem e destino.
Erro de comunicação.Ocorreu uma falha na comunicação entre o sistema e o servidor, como timeout ou perda de conexão.Verifique a conexão de internet do servidor e tente novamente após alguns instantes. Se o problema persistir, entre em contato com o suporte técnico.

Erros retornados pela PAMCARD (via AppServer)

Esses erros aparecem no campo de status em vermelho após o botão “Gerar CIOT PAMCARD” ser processado. O texto exato varia conforme a PAMCARD

Tipo de erro (PAMCARD)Causa provávelComo resolver
RNTRC inválido ou inativoO RNTRC cadastrado no TMS não corresponde a um registro ativo na base da ANTT/PAMCARD.Confirme o RNTRC junto ao transportador e atualize o cadastro em Cadastro de Pessoas ou Cadastro de Veículos. Após a correção, tente gerar o CIOT novamente.
Certificado digital inválido ou expiradoO certificado digital A1 da empresa não está configurado corretamente no AppServer ou está vencido.Entre em contato com o suporte técnico para renovar ou reconfigurar o certificado digital da empresa no AppServer.
Dados bancários inválidosOs dados bancários informados (banco, agência ou conta) não são reconhecidos pela PAMCARD.Confirme os dados bancários com o favorecido, corrija as informações na aba Gerar CIOT PAMCARD e tente novamente.
CIOT já emitido para esta viagemJá existe um CIOT ativo na PAMCARD para a mesma combinação de contratante, transportador e viagem.Verifique no portal da PAMCARD se já existe um CIOT ativo. Caso exista, cancele-o pelo sistema TMS (quando permitido) ou diretamente no portal da PAMCARD antes de realizar uma nova geração.
Falha no cancelamento do CIOTA PAMCARD rejeitou a solicitação de cancelamento. Isso pode ocorrer quando o prazo de 24 horas já expirou, a carga já foi fiscalizada pela ANTT ou o CIOT já foi cancelado na base da PAMCARD.Verifique se o prazo de 24 horas após a emissão do CIOT ainda não foi ultrapassado. Caso o problema persista, consulte o portal da PAMCARD para verificar a situação do CIOT.
Motivo do cancelamento não informadoO campo Motivo do Cancelamento foi deixado em branco.Preencha o campo Informe o motivo do cancelamento antes de clicar no botão Cancelar CIOT e tente novamente.

A aba CIOT do MDF-e

A aba CIOT (dentro das Detalhes do MDF-e) exibe os registros de CIOT vinculados ao MDF-e para fins de transmissão à SEFAZ.

Campo Descrição

CIOT Número do CIOT emitido (formato 12 dígitos).

Pessoa Responsável CNPJ da empresa emissora (preenchido automaticamente com o CNPJ da agência).


🔵 PREENCHIMENTO AUTOMÁTICO
Quando o CIOT é gerado com sucesso via PAMCARD, o sistema registra automaticamente o número na aba CIOT do MDF-e. Não é necessário preencher manualmente. O registro também é removido automaticamente quando o CIOT é cancelado.


⚠ EDIÇÃO MANUAL
É possível incluir, editar ou excluir registros na aba CIOT manualmente (via toolbar da grade). Use esta opção apenas para corrigir situações excepcionais, pois o número do CIOT informado manualmente não é validado pela PAMCARD.

Perguntas Frequentes

A aba “Gerar CIOT PAMCARD” não aparece no MDF-e. O que fazer?
A aba só é exibida quando a empresa logada está configurada com Emissor CIOT = PAMCARD. Verifique com o suporte a parametrização.


Quanto tempo leva para o CIOT ser gerado?
Normalmente entre 5 e 30 segundos. O sistema aguarda a resposta da PAMCARD antes de exibir o resultado. Em situações de lentidão de internet, o processo pode levar até 2 minutos.

 

Posso gerar o CIOT após o MDF-e ser autorizado pela SEFAZ?
Não. O CIOT PAMCARD só pode ser gerado quando o MDF-e está com status DIGITADO (antes da transmissão). Gere o CIOT antes de transmitir o MDF-e.

 

Posso usar “Buscar via API” para calcular a distância automaticamente?
Sim, desde que as cidades de origem e destino da rota tenham coordenadas geográficas cadastradas no TMS. Se não tiverem, use “Buscar da rota” (que usa a distância cadastrada manualmente na rota) ou informe a distância manualmente.

 

O que acontece se o CIOT for gerado mas o MDF-e for cancelado?
O CIOT não é cancelado automaticamente junto com o MDF-e. É necessário cancelar o CIOT manualmente pela aba “Gerar CIOT PAMCARD” antes ou após cancelar o MDF-e, respeitando o prazo de 24h.

 

O total das parcelas deve bater com o valor do frete?
Tecnicamente o sistema não bloqueia se os valores não baterem, mas a PAMCARD pode rejeitar ou criar inconsistências. Recomenda-se sempre informar parcelas cuja soma corresponda ao valor total do frete da viagem.

 

O que é o número de encerramento?
Após o encerramento do CIOT, a PAMCARD retorna um número de protocolo de encerramento (viagem.antt.ciot.encerramento.numero). Esse número fica registrado no banco de dados e pode ser consultado para fins de auditoria.

 

O suporte pode verificar os dados enviados para a PAMCARD?

Sim. O payload SOAP completo enviado em cada operação fica registrado no campo payload_enviado da tabela integra_ciot do banco slg_cargo. O suporte técnico pode consultá-lo para diagnóstico.

Busque por outros assuntos

Fale com nossa equipe de suporte!

Nossa equipe de atendimento está disponível 24h por dia, caso o manual não tenha sido claro você também pode abrir um chamado ou ligar para nosso serviço de atendimento e um de nossos especialistas irá explicar para você!