DOCUMENTAÇÃO CORPORATIVA

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 19 Next »

Objetivo

Método para inserir ou Atualizar os dados do motorista para o cliente, pode haver acontecer de o motorista já existir em nossa base. Quando isso ocorrer o Motorista será associado ao cliente que realizou esse Request e uma mensagem de sucesso será retornada juntamente com um objeto contendo os dados que possuímos em nossa base para caso desejado atualizar a base local do cliente.


Observações

  1. O cadastro do Motorista é compartilhado para todos os Clientes TARGET MP.
  2. Antes de realizar o cadastro de uma Operação de Transporte, é necessário realizar o cadastro de um Motorista caso o mesmo não exista na base de dados da TARGET.
  3. Não é possível realizar rajadas para esse método, a TARGET limita 50 requisições por minuto, aconselhamos requisições por demanda, caso o limite de 50 requisições seja ultrapassado, iremos bloquear as requisições apenas para o método que ultrapassou o limite durante 5 minutos.


Request

                                                                                             MotoristaRequest
CampoTipoObrigatórioDescriçãoObrigatório
1InstrucaointSimInstrução do que se fazer com os dados.1= Inserir ou Atualizar
2= Inserir se não existe
2CPFCNPJTransportadorstringSimCPF ou CNPJ do TransportadorN/A
3IdMotoristaintNãoId do Motorista na TARGETFazer uso apenas quando for atualizar o cadastro do motorista.
Informamos o IdMotorista no response do método CadastrarAtualziarMotorista.
4NomestringSimNome do MotoristaN/A
5SobrenomestringSimSobrenome do MotoristaN/A
6CPFstringSimCPF do MotoristaN/A
7NumeroRGstringSimNúmero RG do MotoristaN/A
8OrgaoEmissorRGstringSimÓrgão Emissor do MotoristaN/A
9DataNascimentoDateTime (YYYY-MM-DD)SimData de Nascimento do Motorista

É de extra importância que a Data de Nascimento do Motorista esteja correta, principalmente se for realizado uma associação de cartão para o motorista em questão. O Bradesco valida se a Data de Nascimento é válida!


Exemplo: (2018-08-20T10:05:33)

10SexostringSimSexo do MotoristaM; F || Masculino; Feminino
11EstadoCivilstringSimEstado Civil do Motorista0= Sem Informação
1= Solteiro
2= Casado
3= Viúvo
4= Relação de Fato
5= Divorciado
6= Separado
12NomePaistringSimNome do Pai do MotoristaCaso não tenha o nome do pai do motorista, favor por como - Não Informado.
13NomeMaestringSimNome da Mãe do MotoristaCaso não tenha o nome da mãe do motorista, favor por como - Não Informado.
14EmailstringSimE-mail do MotoristaExemplo:
gabriel.monteiro@targetmp.com.br
15TelefonestringSimTelefone Residencial/Trabalho do Motorista

Exemplo:

DD + 8N
2135005192

16TelefoneCelularstringSimTelefone Celular do MotoristaExemplo:
DD + 8N || 9N
2186819085
21986819085
17NacionalidadestringSimNacionalidade do MotoristaN/A
18EnderecostringSimEndereço do MotoristaN/A
19NumeroEnderecostringSimNúmero da Residência do MotoristaN/A
20EnderecoComplementostringSimEndereço Completo do MotoristaN/A
21CEPstringSimCEP do MotoristaN/A
22BairrostringSimBairro do MotoristaN/A
23CodigoIBGEMunicipiointSimCódigo IBGE do Endereço do MotoristaN/A
24CodigoBancostringNãoCódigo do Banco - MotoristaN/A
25CodigoAgenciastringNãoCódigo Agência - MotoristaN/A
26DigitoAgenciastringNãoDígito Agência - MotoristaN/A
27ContaCorrentestringNãoConta Corrente - MotoristaN/A
28DigitoContaCorrentestringNãoDígito Conta Corrente - MotoristaN/A
29FlagContaPoupancabool(true || false)SimFlag Conta Poupança - MotoristaN/A
30VariacaoContaPoupancastringNãoVariação Conta Poupança - MotoristaN/A
31Ativobool(true || false)SimCadastro Ativo ou nãoN/A

Response

MotoristaResponse
CampoTipoObrigatórioDescriçãoObrigatório
1ErroErroResponse - stringNãoRetorna o ErroNULO em caso de sucesso.
2IdMotoristaintSimRetorna o ID do Motorista.N/A
3NomestringSimNome do MotoristaN/A
4SobrenomestringSimSobrenome do MotoristaN/A
5CPFstringSimCPF do MotoristaN/A
6NumeroRGstringSimNúmero RG do MotoristaN/A
7OrgaoEmissorRgstringSimÓrgão Emissor RG - MotoristaN/A
8DataNascimentoDateTime (YYYY-MM-DD)SimData Nascimento do MotoristaExemplo: (2018-08-20T10:05:33)
9SexostringSimSexo do MotoristaN/A
10EstadoCivilstringSimEstado Civil do MotoristaN/A
11NomePaistringSimNome do Pai do MotoristaN/A
12NomeMaestringSimNome da Mãe do MotoristaN/A
13EmailstringSimE-mail do MotoristaN/A
14TelefonestringSimTelefone Residencial/Trabalho do MotoristaN/A
15TelefoneCelularstringSimTelefone Celular do MotoristaN/A
16NacionalidadestringSimNacionalidade do MotoristaN/A
17EnderecostringSimEndereço do MotoristaN/A
18NumeroPortastringSimNúmero ResidênciaN/A
19EnderecoComplementostringSimEndereço Completo do MotoristaN/A
20CEPstringSimCEP do MotoristaN/A
21BairrostringSimBairro do MotoristaN/A
22CidadestringSimCidade do MotoristaN/A
23UFstringSimUF do MotoristaN/A
24CodigoBancostringNãoCódigo Banco - MotoristaN/A
25CodigoAgenciastringNãoCódigo Agência - MotoristaN/A
26DigitoAgenciastringNãoDígito Agência - MotoristaN/A
27ContaCorrentestringNãoConta Corrente - MotoristaN/A
28DigitoContaCorrentestringNãoDígito Conta Corrente - MotoristaN/A
29FlagContaPoupancabool(true || false)NãoFlag Conta Poupança - MotoristaN/A
30VariacaoContaPoupancastringNãoVariação Conta Poupança - MotoristaN/A
31Ativobool(true || false)SimCadastro Ativo ou NãoN/A


Método

Abaixo, segue exemplo do método - CadastrarAtualizarMotorista.

MotoristaRequest
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br">
   <soapenv:Header/>
   <soapenv:Body>
      <tms:CadastrarAtualizarMotorista>
         <tms:auth>
            <tms:Usuario>?</tms:Usuario>
            <tms:Senha>?</tms:Senha>
            <tms:Token>?</tms:Token>
         </tms:auth>
         <tms:motorista>
            <tms:Instrucao>?</tms:Instrucao>
            <tms:CPFCNPJTransportador>?</tms:CPFCNPJTransportador>
            <tms:IdMotorista>?</tms:IdMotorista>
            <tms:Nome>?</tms:Nome>
            <tms:Sobrenome>?</tms:Sobrenome>
            <tms:CPF>?</tms:CPF>
            <tms:NumeroRG>?</tms:NumeroRG>
            <tms:OrgaoEmissorRg>?</tms:OrgaoEmissorRg>
            <tms:DataNascimento>?</tms:DataNascimento>
            <tms:Sexo>?</tms:Sexo>
            <tms:EstadoCivil>?</tms:EstadoCivil>
            <tms:NomePai>?</tms:NomePai>
            <tms:NomeMae>?</tms:NomeMae>
            <tms:Email>?</tms:Email>
            <tms:Telefone>?</tms:Telefone>
            <tms:TelefoneCelular>?</tms:TelefoneCelular>
            <tms:Nacionalidade>?</tms:Nacionalidade>
            <tms:Endereco>?</tms:Endereco>
            <tms:NumeroEndereco>?</tms:NumeroEndereco>
            <tms:EnderecoComplemento>?</tms:EnderecoComplemento>
            <tms:CEP>?</tms:CEP>
            <tms:Bairro>?</tms:Bairro>
            <tms:CodigoIBGEMunicipio>?</tms:CodigoIBGEMunicipio>
            <tms:CodigoBanco>?</tms:CodigoBanco>
            <tms:CodigoAgencia>?</tms:CodigoAgencia>
            <tms:DigitoAgencia>?</tms:DigitoAgencia>
            <tms:ContaCorrente>?</tms:ContaCorrente>
            <tms:DigitoContaCorrente>?</tms:DigitoContaCorrente>
            <tms:FlagContaPoupanca>?</tms:FlagContaPoupanca>
            <tms:VariacaoContaPoupanca>?</tms:VariacaoContaPoupanca>
            <tms:Ativo>?</tms:Ativo>
         </tms:motorista>
      </tms:CadastrarAtualizarMotorista>
   </soapenv:Body>
</soapenv:Envelope>

Cadastrar

Abaixo, segue o exemplo do cadastro de um Motorista.

MotoristaRequest
Request
            
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <soapenv:Header/>
  <soapenv:Body>
    <tms:CadastrarAtualizarMotorista>
      <tms:auth>
        <tms:Usuario>tms.exemplo</tms:Usuario>
        <tms:Senha>v0hXPrwerKblaBs=</tms:Senha>
        <tms:Token i:nil="true" />
      </tms:auth>
      <tms:motorista>
        <tms:Instrucao>2</tms:Instrucao>
            <tms:CPFCNPJTransportador>08432903000235</tms:CPFCNPJTransportador>
            <tms:IdMotorista i:nil="true" />
            <tms:Nome>JUDSON</tms:Nome>
            <tms:Sobrenome>JUNIOR GIUSTTI</tms:Sobrenome>
            <tms:CPF>82499460968</tms:CPF>
            <tms:NumeroRG>5018577</tms:NumeroRG>
            <tms:OrgaoEmissorRg>SSP</tms:OrgaoEmissorRg>
            <tms:DataNascimento>1973-08-27</tms:DataNascimento>
            <tms:Sexo>M</tms:Sexo>
            <tms:EstadoCivil>0</tms:EstadoCivil>
            <tms:NomePai>JOSE LEONIDAS GIUSTTI</tms:NomePai>
            <tms:NomeMae>ANELI GHIGGI</tms:NomeMae>
            <tms:Email>rede.portalpr@hotmail.com</tms:Email>
            <tms:Telefone>4998362052</tms:Telefone>
            <tms:TelefoneCelular>21986819087</tms:TelefoneCelular>
            <tms:Nacionalidade>brasileiro</tms:Nacionalidade>
            <tms:Endereco>RUA JOSE BONIFACIO</tms:Endereco>
            <tms:NumeroEndereco>699</tms:NumeroEndereco>
            <tms:EnderecoComplemento>Casa</tms:EnderecoComplemento>
            <tms:CEP>89610000</tms:CEP>
            <tms:Bairro>Centro</tms:Bairro>
            <tms:CodigoIBGEMunicipio>4206702</tms:CodigoIBGEMunicipio>
            <tms:CodigoBanco i:nil="true" />
            <tms:CodigoAgencia i:nil="true" />
            <tms:DigitoAgencia i:nil="true" />
            <tms:ContaCorrente i:nil="true" />
            <tms:DigitoContaCorrente i:nil="true" />
            <tms:FlagContaPoupanca i:nil="true" />
            <tms:VariacaoContaPoupanca i:nil="true" />
            <tms:Ativo>true</tms:Ativo>
      </tms:motorista>
    </tms:CadastrarAtualizarMotorista>
  </soapenv:Body>
</soapenv:Envelope>
                

            

Response
            

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <Action s:mustUnderstand="1" xmlns="http://schemas.microsoft.com/ws/2005/05/addressing/none">http://tmsfrete.v2.targetmp.com.br/FreteTMSService/CadastrarAtualizarMotoristaResponse</Action>
  </s:Header>
  <s:Body>
    <CadastrarAtualizarMotoristaResponse xmlns="http://tmsfrete.v2.targetmp.com.br">
      <CadastrarAtualizarMotoristaResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <Erro i:nil="true" />
        <IdMotorista>22568</IdMotorista>
        <Nome>JUDSON</Nome>
        <Sobrenome>JUNIOR GIUSTTI</Sobrenome>
        <CPF>82499460968</CPF>
        <NumeroRG>5018577</NumeroRG>
        <OrgaoEmissorRg>SSP</OrgaoEmissorRg>
        <DataNascimento>1973-08-23T00:00:00</DataNascimento>
        <Sexo>M</Sexo>
        <EstadoCivil>0</EstadoCivil>
        <NomePai>JOSE LEONIDAS GIUSTTI</NomePai>
        <NomeMae>ANELI GHIGGI</NomeMae>
        <Email>rede.portalpr@hotmail.com</Email>
        <Telefone>4998362052</Telefone>
        <TelefoneCelular>21986819087</TelefoneCelular>
        <Nacionalidade>BRASILEIRO</Nacionalidade>
        <Endereco>RUA JOSE BONIFACIO</Endereco>
        <NumeroPorta>699</NumeroPorta>
        <EnderecoComplemento>CASA</EnderecoComplemento>
        <CEP>89610000</CEP>
        <Bairro>CENTRO</Bairro>
        <Cidade>Herval dOeste</Cidade>
        <UF>SC</UF>
        <CodigoBanco i:nil="true" />
        <CodigoAgencia i:nil="true" />
        <DigitoAgencia i:nil="true" />
        <ContaCorrente i:nil="true" />
        <DigitoContaCorrente i:nil="true" />
        <FlagContaPoupanca>false</FlagContaPoupanca>
        <VariacaoContaPoupanca i:nil="true" />
        <Ativo>true</Ativo>
      </CadastrarAtualizarMotoristaResult>
    </CadastrarAtualizarMotoristaResponse>
  </s:Body>
</s:Envelope>

Atualizar

Abaixo, segue o exemplo de atualização do cadastro de Motorista.

MotoristaRequest
Request
            
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <soapenv:Header/>
  <soapenv:Body>
    <tms:CadastrarAtualizarMotorista>
      <tms:auth>
        <tms:Usuario>tms.exemplo</tms:Usuario>
        <tms:Senha>v0hXPrwerKblaBs=</tms:Senha>
        <tms:Token i:nil="true" />
      </tms:auth>
      <tms:motorista>
            <tms:Instrucao>2</tms:Instrucao>
            <tms:CPFCNPJTransportador>08432903000235</tms:CPFCNPJTransportador>
            <tms:IdMotorista i:nil="true" />
            <tms:Nome>JUDSON</tms:Nome>
            <tms:Sobrenome>JUNIOR GIUSTTI</tms:Sobrenome>
            <tms:CPF>82499460968</tms:CPF>
            <tms:NumeroRG>5018577</tms:NumeroRG>
            <tms:OrgaoEmissorRg>SSP</tms:OrgaoEmissorRg>
            <tms:DataNascimento>1973-08-27</tms:DataNascimento>
            <tms:Sexo>M</tms:Sexo>
            <tms:EstadoCivil>0</tms:EstadoCivil>
            <tms:NomePai>JOSE LEONIDAS GIUSTTI</tms:NomePai>
            <tms:NomeMae>ANELI GHIGGI</tms:NomeMae>
            <tms:Email>rede.portalpr@hotmail.com</tms:Email>
            <tms:Telefone>4998362052</tms:Telefone>
            <tms:TelefoneCelular>21986819087</tms:TelefoneCelular>
            <tms:Nacionalidade>brasileiro</tms:Nacionalidade>
            <tms:Endereco>RUA JOSE BONIFACIO</tms:Endereco>
            <tms:NumeroEndereco>699</tms:NumeroEndereco>
            <tms:EnderecoComplemento>Casa</tms:EnderecoComplemento>
            <tms:CEP>89610000</tms:CEP>
            <tms:Bairro>Centro</tms:Bairro>
            <tms:CodigoIBGEMunicipio>4206702</tms:CodigoIBGEMunicipio>
            <tms:CodigoBanco i:nil="true" />
            <tms:CodigoAgencia i:nil="true" />
            <tms:DigitoAgencia i:nil="true" />
            <tms:ContaCorrente i:nil="true" />
            <tms:DigitoContaCorrente i:nil="true" />
            <tms:FlagContaPoupanca i:nil="true" />
            <tms:VariacaoContaPoupanca i:nil="true" />
            <tms:Ativo>true</tms:Ativo>
      </tms:motorista>
    </tms:CadastrarAtualizarMotorista>
  </soapenv:Body>
</soapenv:Envelope>
                

            

Response
            

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <Action s:mustUnderstand="1" xmlns="http://schemas.microsoft.com/ws/2005/05/addressing/none">http://tmsfrete.v2.targetmp.com.br/FreteTMSService/CadastrarAtualizarMotoristaResponse</Action>
  </s:Header>
  <s:Body>
    <CadastrarAtualizarMotoristaResponse xmlns="http://tmsfrete.v2.targetmp.com.br">
      <CadastrarAtualizarMotoristaResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <Erro i:nil="true" />
        <IdMotorista>22568</IdMotorista>
        <Nome>JUDSON</Nome>
        <Sobrenome>JUNIOR GIUSTTI</Sobrenome>
        <CPF>82499460968</CPF>
        <NumeroRG>5018577</NumeroRG>
        <OrgaoEmissorRg>SSP</OrgaoEmissorRg>
        <DataNascimento>1973-08-23T00:00:00</DataNascimento>
        <Sexo>M</Sexo>
        <EstadoCivil>0</EstadoCivil>
        <NomePai>JOSE LEONIDAS GIUSTTI</NomePai>
        <NomeMae>ANELI GHIGGI</NomeMae>
        <Email>rede.portalpr@hotmail.com</Email>
        <Telefone>4998362052</Telefone>
        <TelefoneCelular>21986819087</TelefoneCelular>
        <Nacionalidade>BRASILEIRO</Nacionalidade>
        <Endereco>RUA JOSE BONIFACIO</Endereco>
        <NumeroPorta>699</NumeroPorta>
        <EnderecoComplemento>CASA</EnderecoComplemento>
        <CEP>89610000</CEP>
        <Bairro>CENTRO</Bairro>
        <Cidade>Herval dOeste</Cidade>
        <UF>SC</UF>
        <CodigoBanco i:nil="true" />
        <CodigoAgencia i:nil="true" />
        <DigitoAgencia i:nil="true" />
        <ContaCorrente i:nil="true" />
        <DigitoContaCorrente i:nil="true" />
        <FlagContaPoupanca>false</FlagContaPoupanca>
        <VariacaoContaPoupanca i:nil="true" />
        <Ativo>true</Ativo>
      </CadastrarAtualizarMotoristaResult>
    </CadastrarAtualizarMotoristaResponse>
  </s:Body>
</s:Envelope>
  • No labels