O arquivo de retorno de Envio Operação de Vale-Pedágio terá a seguinte nomenclatura:
RetOpvp_NomeDoArquivoOriginal_ddMMyyyyHHmmssfff.xml
Abaixo segue a especificação do arquivo de retorno de Envio Operação de Vale-Pedágio, que será gerado pela solução nddCargo na pasta de integração, após o envio desta através do Agente.
As informações abaixo, até o registro 0612 serão retornados conforme os dados enviados no arquivo de solicitação. Portanto, serão uma repetição da solicitação.
|
Campo |
Elem. |
Pai |
Tipo |
Ocor. |
Tam. |
Dec. |
Observação |
|---|---|---|---|---|---|---|---|
|
retornoOperacaoValePedagio |
Raiz |
|
|
1 |
|
|
|
|
mensagens |
Raiz |
retornoOperacaoValePedagio |
|
0-1 |
|
|
Dados das mensagens |
|
mensagem |
Raiz |
mensagens |
|
1-N |
|
|
Dados da mensagem de retorno |
|
categoria |
E |
mensagem |
N |
1 |
3 |
|
Categoria da mensagem |
|
codigo |
E |
mensagem |
N |
1 |
1-3 |
|
Código de mensagem de retorno |
|
mensagem |
E |
mensagem |
S |
1 |
1-2000 |
|
|
|
observacao |
E |
mensagem |
S |
0-1 |
1-2000 |
|
Observação sobre a mensagem. Neste campo poderão ser apresentadas informações mais técnicas sobre o que ocorreu no processo. |
|
envioOperacaoValePedagio |
Raiz |
retornoOperacaoValePedagio |
|
0-1 |
|
|
Dados da solicitação |
|
ID |
A |
envioOperacaoValePedagio |
S |
0-1 |
|
|
GUID único para assinatura da mensagem. Utilizar este formato ou o formato abaixo. |
|
Id |
A |
envioOperacaoValePedagio |
S |
0-1 |
|
|
GUID único para assinatura da mensagem. Utilizar este formato ou o formato acima. |
|
impAuto |
A |
envioOperacaoValePedagio |
N |
0-1 |
1 |
|
Informar se haverá a necessidade de impressão automática ou não. 1 = Sim 2 = Não Por padrão haverá a impressão automática. Este atributo não tem validade para integrações que não utilizam o módulo agente. |
|
token |
A |
envioOperacaoValePedagio |
S |
1 |
24 |
|
O token será usado para determinar quais os níveis de permissionamento podem ser aceitos. Por exemplo: determinar um valor limite de operações de transporte por token. |
|
cnpj |
E |
envioOperacaoValePedagio |
N |
1 |
14 |
|
CNPJ da contratante ou agrupador que esta realizando a emissão. Este CNPJ deve será utilizado para validar a assinatura. |
|
ide |
Raiz |
envioOperacaoValePedagio |
|
1 |
|
|
Informações sobre a Operação de Vale-Pedágio |
|
cnpj |
E |
ide |
N |
1 |
14 |
|
CNPJ da contratante para a qual está sendo emitida a operação de vale-pedágio. |
|
numero |
E |
ide |
N |
1 |
1-9 |
|
Número para a operação de vale-pedágio. |
|
serie |
E |
ide |
N |
1 |
1-4 |
|
Série para operação de vale-pedágio. |
|
ptEmissor |
E |
ide |
S |
1 |
1-30 |
|
Ponto emissor responsável pela operação de vale-pedágio. |
|
gestoraCartao |
E |
ide |
N |
1 |
3 |
|
Gestora de cartão Dock - 009. Código de identificação da gestora de cartão que será usada para o pagamento. |
|
transportador |
Raiz |
envioOperacaoValePedagio |
|
1 |
|
|
Informações sobre o transportador |
|
rntrc |
E |
transportador |
N |
1 |
9 |
|
RNTRC do transportador responsável pela prestação de serviço e que receberá os valores do transporte |
|
cpfTransportador |
E |
transportador |
N |
1 |
11 |
|
CPF do transportador Deverá ser informado este elemento ou o cpfTransportador |
|
cnpjTransportador |
E |
transportador |
S |
1 |
14 |
|
CNPJ do transportador Deverá ser informado este elemento ou o cpfTransportador |
|
infTransportador |
Raiz |
transportador |
|
0-1 |
|
|
Dados do transportador para cadastro. |
|
ide |
Raiz |
infTransportador |
|
0-1 |
|
|
Identificação do tipo de transportador. |
|
tac |
Raiz |
ide |
|
0-1 |
|
|
Dados do Transportador TAC. Deverá ser informado este elemento ou o etc ou ctc. |
|
nomeCompleto |
E |
tac |
S |
1 |
1-150 |
|
Nome completo do Transportador TAC. |
|
nomeMae |
E |
tac |
S |
1 |
1-150 |
|
Nome da mãe do transportador TAC. |
|
nomePai |
E |
tac |
S |
0-1 |
1-150 |
|
Nome do pai do transportador TAC. |
|
dataNascimento |
E |
tac |
D |
1 |
|
|
Data de nascimento do transportador. Deve ser informado para a entrega de cartão a um TAC. Deverá ser informado caso o campo identidade seja informado.
Formato: AAAA-MM-DD |
|
identidade |
E |
tac |
S |
1 |
1-20 |
|
Identidade do transportador. O campo deve ser preenchido sem máscara. Deverá ser informado caso o campo dataNascimento seja informado. |
|
etc |
Raiz |
ide |
|
1 |
|
|
Dados do Transportador ETC. Deverá ser informado este elemento ou o tac ou ctc. |
|
razaoSocial |
E |
etc |
S |
1 |
1-150 |
|
Razao social do Transportador ETC. |
|
nomeFantasia |
E |
etc |
S |
1 |
1-150 |
|
Nome fantasia do Transportador ETC. |
|
inscEstadual |
E |
etc |
S |
1 |
1-14 |
|
Inscricao estadual do Transportador ETC. |
|
atividadePrincipal |
E |
etc |
N |
1 |
2 |
|
Ver anexo Lista de Atividades |
|
formaConstituicao |
E |
etc |
S |
1 |
5 |
|
Ver anexo Lista e Formas de Constituicao |
|
dataConstituicao |
E |
etc |
D |
1 |
|
|
Formato AAAA-MM-DD |
|
socio |
Raiz |
etc |
|
1 |
|
|
Dados do sócio do Transportador ETC |
|
nomeCompleto |
E |
socio |
S |
1 |
1-150 |
|
Nome completo do sócio do Transportador ETC. |
|
nomeMae |
E |
socio |
S |
1 |
1-150 |
|
Nome da mãe do sócio do Transportador ETC. |
|
nomePai |
E |
socio |
S |
0-1 |
1-150 |
|
Nome do pai do sócio do Transportador ETC. |
|
dataNascimento |
E |
socio |
D |
1 |
|
|
Data de nascimento do sócio do Transportador ETC. |
|
cpf |
E |
socio |
N |
1 |
11 |
|
CPF do sócio do Transportador ETC. |
|
identidade |
E |
socio |
S |
1 |
1-20 |
|
Identidade do sócio do Transportador ETC. |
|
endereço |
Raiz |
socio |
|
1 |
|
|
Dados de endereço do sócio do Transportador ETC. |
|
UF |
E |
endereço |
S |
1 |
2 |
|
Sigla da Unidade Federativa sócio do Transportador ETC. |
|
cidade |
E |
endereço |
S |
1 |
1-100 |
|
Nome da Cidade sócio do Transportador ETC. |
|
bairro |
E |
endereço |
S |
1 |
1-255 |
|
Informar EXTERIOR caso seja do exterior. |
|
logradouro |
E |
endereço |
S |
1 |
1-255 |
|
Informar EXTERIOR caso seja do exterior. |
|
numero |
E |
endereço |
N |
0-1 |
1-8 |
|
número do endereço do sócio |
|
CEP |
E |
endereço |
N |
0-1 |
8 |
|
Informar 0 caso seja do exterior. |
|
complemento |
E |
endereço |
S |
0-1 |
1-255 |
|
CEP do sócio |
|
telefone |
E |
endereço |
N |
1 |
10|11 |
|
Telefone do sócios do Transportador ETC. |
|
|
E |
endereço |
S |
0-1 |
1-255 |
|
Email do sócio do Transportador ETC |
|
ctc |
Raiz |
ide |
|
1 |
|
|
Dados de endereço do transportador CTC. Deverá ser informado este elemento ou o tac ou etc. . |
|
razaoSocial |
E |
ctc |
S |
1 |
1-150 |
|
Razão social do Transportador CTC. |
|
nomeFantasia |
E |
ctc |
S |
1 |
1-150 |
|
Nome fantasia do Transportador CTC. |
|
inscEstadual |
E |
ctc |
S |
1 |
1-14 |
|
Inscrição Estadual do Transportador CTC. |
|
atividadePrincipal |
E |
ctc |
N |
1 |
2 |
|
Ver anexo Lista de Atividades |
|
formaConstituicao |
E |
ctc |
S |
1 |
5 |
|
Ver anexo Lista de Forma de Constituicao |
|
dataConstituicao |
E |
ctc |
D |
1 |
|
|
Formato AAAA-MM-DD |
|
socio |
Raiz |
ctc |
|
1 |
|
|
Dados do sócio do Transportador CTC. |
|
nomeCompleto |
E |
socio |
S |
1 |
1-150 |
|
Nome completo do sócio do Transportador CTC. |
|
nomeMae |
E |
socio |
S |
1 |
1-150 |
|
Nome da mãe do sócio do Transportador CTC. |
|
nomePai |
E |
socio |
S |
0-1 |
1-150 |
|
Nome do pai do sócio do Transportador CTC. |
|
dataNascimento |
E |
socio |
D |
1 |
|
|
Data de nascimento do sócio do Transportador CTC. |
|
cpf |
E |
socio |
N |
1 |
11 |
|
CPF do sócio do Transportador CTC. |
|
identidade |
E |
socio |
S |
1 |
1-20 |
|
Identidade do sócio do Transportador CTC. |
|
endereço |
Raiz |
socio |
|
1 |
|
|
Dados de endereço do sócio do Transportador CTC. |
|
UF |
E |
endereço |
S |
1 |
2 |
|
Sigla da Unidade Federativa do sócio. |
|
cidade |
E |
endereço |
S |
1 |
1-100 |
|
cidade do sócio |
|
bairro |
E |
endereço |
S |
1 |
1-255 |
|
Informar EXTERIOR caso seja do exterior. |
|
logradouro |
E |
endereço |
S |
1 |
1-255 |
|
Informar EXTERIOR caso seja do exterior. |
|
numero |
E |
endereço |
N |
0-1 |
1-8 |
|
número do endereço do sócio |
|
CEP |
E |
endereço |
N |
0-1 |
8 |
|
Informar 0 caso seja do exterior. |
|
complemento |
E |
endereço |
S |
0-1 |
1-255 |
|
complemento do sócio |
|
telefone |
E |
socio |
N |
1 |
10|11 |
|
Telefone do sócio. |
|
|
E |
socio |
S |
0-1 |
1-255 |
|
Email do sócio |
|
endereçoTransportador |
Raiz |
infTransportador |
|
1 |
|
|
Dados de endereço do transportador TAC/ETC/CTC. |
|
UF |
E |
endereçoTransportador |
S |
1 |
2 |
|
Sigla UF do transportador TAC/ETC/CTC. |
|
cidade |
E |
endereçoTransportador |
S |
1 |
1-100 |
|
Código do município do transportador TAC/ETC/CTC. |
|
bairro |
E |
endereçoTransportador |
S |
1 |
1-255 |
|
Bairro do transportador TAC/ETC/CTC. |
|
logradouro |
E |
endereçoTransportador |
S |
1 |
1-255 |
|
Logradouro do transportador TAC/ETC/CTC. |
|
numero |
E |
endereçoTransportador |
N |
0-1 |
1-8 |
|
Número do transportador TAC/ETC/CTC. |
|
CEP |
E |
endereçoTransportador |
N |
0-1 |
8 |
|
CEP do transportador TAC/ETC/CTC. |
|
complemento |
E |
endereçoTransportador |
S |
0-1 |
1-255 |
|
Complemento do endereço do transportador TAC/ETC/CTC. |
|
telefone |
E |
infTransportador |
N |
1 |
10-11 |
|
Telefone celular do transportador. Informar o número do celular do transportador, juntamente com o DDD. Caso não haja um número válido, informar 9999999999 ou 99999999999. |
|
cartaoId |
E |
infTransportador |
N |
0-1 |
1-15 |
|
Identificador do cartão para vincular ao transportador. |
|
|
E |
infTransportador |
S |
0-1 |
1-255 |
|
E-mail do transportador. |
|
condutorFavorecido |
Raiz |
envioOperacaoValePedagio |
|
0-1 |
|
|
Dados do condutor. |
|
cpf |
E |
condutorFavorecido |
N |
1 |
11 |
|
CPF do condutor |
|
informacoes |
Raiz |
condutorFavorecido |
|
0-1 |
|
|
Dados para cadastramento do condutor no nddCargo, juntamente com o CPF da tag anterior. |
|
nomeCompleto |
E |
informacoes |
S |
1 |
1-150 |
|
Nome do condutor. |
|
nomeMae |
E |
informacoes |
S |
1 |
1-150 |
|
Nome da mãe do condutor. |
|
nomePai |
E |
informacoes |
S |
0-1 |
1-150 |
|
Nome do pai do condutor. |
|
dataNascimento |
E |
informacoes |
D |
1 |
|
|
Data de nascimento do transportador. Deve ser informado para a entrega de cartão a um TAC Formato: AAAA-MM-DD |
|
identidade |
E |
informacoes |
S |
1 |
1-20 |
|
Identidade do condutor. |
|
RNTRCTransportador |
E |
informacoes |
N |
0-1 |
9 |
|
RNTRC do transportador. Este campo será obrigatório quando o condutor tiver um cartão a ser vinculado, pois esta ação deverá criar o condutor equiparado. |
|
cpfTransportador |
E |
informacoes |
N |
1 |
11 |
|
CPF do transportador Deverá ser informado este elemento ou o cnpjTransportador |
|
cnpjTransportador |
E |
informacoes |
N |
1 |
14 |
|
CNPJ do transportador Deverá ser informado este elemento ou o cpfTransportador |
|
endereco |
Raiz |
informacoes |
|
1 |
|
|
Dados de endereço do condutor. |
|
UF |
E |
endereco |
S |
1 |
2 |
|
Sigla UF do condutor. |
|
cidade |
E |
endereco |
S |
1 |
1-100 |
|
Nome do Município do condutor. |
|
bairro |
E |
endereco |
S |
1 |
1-255 |
|
Bairro do condutor. |
|
logradouro |
E |
endereco |
S |
1 |
1-255 |
|
Logradouro do condutor. |
|
numero |
E |
endereco |
N |
0-1 |
1-8 |
|
Número do endereço do condutor. |
|
CEP |
E |
endereco |
N |
0-1 |
8 |
|
CEP do condutor. |
|
complemento |
E |
endereco |
S |
0-1 |
1-255 |
|
Complemento do endereço do condutor. |
|
CNH |
E |
endereco |
N |
0-1 |
1-15 |
|
Número da CNH do condutor. |
|
dataEmissaoCNH |
E |
endereco |
D |
0-1 |
|
|
Data de emissão da CNH do condutor. Formato: AAAA-MM-DD |
|
dataRenovacaoCNH |
E |
endereco |
D |
0-1 |
|
|
Data de vencimento da CNH do condutor. Formato: AAAA-MM-DD |
|
telefone |
E |
endereco |
N |
1 |
10-11 |
|
Informar o número do celular do condutor, juntamente com o DDD. Caso não haja um número válido, informar 9999999999 ou 99999999999. |
|
cartaoId |
E |
endereco |
N |
0-1 |
1-15 |
|
Identificação do cartão que foi entregue ao condutor, para que seja feito o vínculo na processadora. |
|
infRota |
Raiz |
envioOperacaoValePedagio |
|
0-1 |
|
|
Campos contendo os dados da rota para integração |
|
categoriaPedagio |
E |
infRota |
N |
1 |
1-2 |
|
Categoria de pedágio. Valores possíveis disponíveis nos anexos desse documento. |
|
rota |
Raiz |
infRota |
|
1 |
|
|
Informações da rota para direcionamento de pedágio |
|
rotaERP |
E |
rota |
S |
1 |
1-30 |
|
Nome da rota no ERP para a integração. |
|
informacoes |
Raiz |
rota |
|
0-1 |
|
|
Dados para inserção de uma rota no sistema ou atualização de uma já existente. |
|
nome |
E |
informacoes |
S |
1 |
1-50 |
|
Nome de apresentação da rota dentro do sistema. |
|
tipoRotaPadrao |
E |
informacoes |
N |
0-1 |
1 |
|
Define o tipo de rota padrão a ser utilizado nos pontos de parada. 1 = Rápida 2 = Curta |
|
pontosParada |
Raiz |
informacoes |
|
1 |
|
|
Dados dos pontos da parada da rota. |
|
pontoParada |
Raiz |
pontosParada |
|
2-N |
|
|
Dados do ponto de parada. |
|
codigoIBGE |
E |
pontoParada |
N |
1 |
7 |
|
Código IBGE do ponto de parada. Deverá ser informada esta tag ou a tag cep |
|
cep |
E |
pontoParada |
N |
1 |
8 |
|
CEP do ponto de parada. Deverá ser informada esta tag ou a tag codigoIBGE |
|
tipoRotaEspecifico |
E |
pontoParada |
N |
0-1 |
1 |
|
Tipo de rota específico para o ponto de parada em relação ao ponto anterior. 1 = Rápida 2 = Curta |
|
responsaveis |
Raiz |
infRota |
|
0-1 |
|
|
Dados dos responsáveis pela rota. |
|
responsavel |
Raiz |
responsaveis |
|
1-N |
|
|
Dados do responsável. |
|
nome |
E |
responsavel |
S |
1 |
1-50 |
|
Nome do responsável pela rota na Contratante. |
|
|
E |
responsavel |
S |
1 |
1-255 |
|
E-mail do responsável pela rota na Contratante. Em caso de alterações na rota, o aviso será encaminhado para este e-mail. |
|
utilizarRoteirizador |
E |
infRota |
N |
0-1 |
1 |
|
Possibilita a utilização do roteirizador para calcular a distância e valores de pedágio. 1 = Sim 2 = Não |
|
totalKm |
E |
infRota |
N |
0-1 |
1-15 |
2 |
Total de quilômetros da rota. |
|
notificarRespContratante |
E |
infRota |
N |
0-1 |
1 |
|
Define a notificação para os responsáveis na Contratante, caso o roteirizador identifique alterações na rota. 1 = Sim 2 = Não |
|
valor |
E |
envioOperacaoValePedagio |
N |
0-1 |
1-15 |
2 |
Valor de vale-pedágio a ser pago ao condutor da operação de vale-pedágio. |
|
operacaoTransporte |
E |
envioOperacaoValePedagio |
S |
0-1 |
1-150 |
|
Identificação da operação de transporte. Este campo deve ser utilizado quando há obrigatoriedade de vinculo do pagamento de pedágio há uma operação de transporte. |
|
observacao |
E |
envioOperacaoValePedagio |
S |
0-1 |
1-500 |
|
Observação livre da operação de vale-pedágio. Será exibida na impressão do NDVP. |
|
retOperacaoValePedagio |
Raiz |
retornoOperacaoValePedagio |
|
0-1 |
|
|
Dados do retorno |
|
ndvp |
Raiz |
retOperacaoValePedagio |
|
1 |
|
|
Dados do NDVP |
|
numero |
E |
ndvp |
N |
1 |
12 |
|
Número do NDVP. |
|
ndvpCodVerificador |
E |
ndvp |
N |
1 |
4 |
|
Protocolo de autorização do NDVP. |
|
dataHora |
E |
retOperacaoValePedagio |
D |
1 |
|
|
Data da emissão. Data e hora que o processamento foi realizado. Padrão: AAAA-MM-DD HH:MM:SS |
|
pedagio |
Raiz |
retOperacaoValePedagio |
|
1 |
|
|
Dados do Pedágio |
|
valor |
E |
pedagio |
N |
1 |
1-15 |
2 |
Valor do pedágio. |
|
origem |
E |
pedagio |
S |
0-1 |
1-200 |
|
Cidade e estado de origem. |
|
destino |
E |
pedagio |
S |
0-1 |
1-200 |
|
Cidade e estado de destino. |
|
pracas |
Raiz |
pedagio |
|
0-1 |
|
|
Dados das praças de pedágio. |
|
praca |
Raiz |
pracas |
|
1-N |
|
|
Dados da praça. |
|
nome |
E |
praca |
S |
1 |
1-200 |
|
Nome da praça de pedágio. |
|
valor |
E |
praca |
N |
1 |
1-15 |
2 |
Valor a ser pago no pedágio. |
|
localizacao |
E |
praca |
S |
1 |
1-200 |
|
Localização da praça de pedágio. |
|
idValePedagio |
E |
retOperacaoValePedagio |
S |
0-N |
28 |
|
Identificador do vale pedágio ANTT |