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

O cadastro do Motorista é compartilhado para todos os Clientes TARGET MP.
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.
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

Nº	Campo	Tipo	Obrigatório	Descrição	Obrigatório
MotoristaRequest
1	Instrucao	int	Sim	Instrução do que se fazer com os dados.	1= Inserir ou Atualizar 2= Inserir se não existe
2	CPFCNPJTransportador	string	Sim	CPF ou CNPJ do Transportador
3	IdMotorista	int	Não	Id do Motorista na TARGET	Fazer uso apenas quando for atualizar o cadastro do motorista. Informamos o IdMotorista no request do método CadastrarAtualziarMotorista.
4	Nome	string	Sim	Nome do Motorista	N/A
5	Sobrenome	string	Sim	Sobrenome do Motorista	N/A
6	CPF	string	Sim	CPF do Motorista	N/A
7	NumeroRG	string	Sim	Número RG do Motorista	N/A
8	OrgaoEmissorRG	string	Sim	Órgão Emissor do Motorista	N/A
9	DataNascimento	DateTime (YYYY-MM-DD)	Sim	Data 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)
10	Sexo	string	Sim	Sexo do Motorista	M; F \|\| Masculino; Feminino
11	EstadoCivil	string	Sim	Estado Civil do Motorista	Obs. Importante: Favor informar o código de 0 a 6 e não o que cada um significa. 0= Sem Informação 1= Solteiro 2= Casado 3= Viúvo 4= Relação de Fato 5= Divorciado 6= Separado
12	NomePai	string	Sim	Nome do Pai do Motorista	Caso não tenha o nome do pai do motorista, favor por como - Não Informado.
13	NomeMae	string	Sim	Nome da Mãe do Motorista	Caso não tenha o nome da mãe do motorista, favor por como - Não Informado.
14	Email	string	Sim	E-mail do Motorista	Exemplo: gabriel.monteiro@targetmp.com.br
15	Telefone	string	Sim	Telefone Residencial/Trabalho do Motorista	Exemplo: DD + 8N 2135005192
16	TelefoneCelular	string	Sim	Telefone Celular do Motorista	Exemplo: DD + 8N \|\| 9N 2186819085 21986819085
17	Nacionalidade	string	Sim	Nacionalidade do Motorista	N/A
18	Endereco	string	Sim	Endereço do Motorista	N/A
19	NumeroEndereco	string	Sim	Número da Residência do Motorista	N/A
20	EnderecoComplemento	string	Sim	Endereço Completo do Motorista	N/A
21	CEP	string	Sim	CEP do Motorista	N/A
22	Bairro	string	Sim	Bairro do Motorista	N/A
23	CodigoIBGEMunicipio	int	Sim	Código IBGE do Endereço do Motorista	N/A
24	CodigoBanco	string	Não	Código do Banco - Motorista	N/A
25	CodigoAgencia	string	Não	Código Agência - Motorista	N/A
26	DigitoAgencia	string	Não	Dígito Agência - Motorista	N/A
27	ContaCorrente	string	Não	Conta Corrente - Motorista	N/A
28	DigitoContaCorrente	string	Não	Dígito Conta Corrente - Motorista	N/A
29	FlagContaPoupanca	bool(true \|\| false)	Sim	Flag Conta Poupança - Motorista	N/A
30	VariacaoContaPoupanca	string	Não	Variação Conta Poupança - Motorista	N/A
31	Ativo	bool(true \|\| false)	Sim	Cadastro Ativo ou não	N/A

Response

Nº	Campo	Tipo	Obrigatório	Descrição	Obrigatório
MotoristaResponse
1	Erro	ErroResponse - string	Não	Retorna o Erro	NULO em caso de sucesso.
2	IdMotorista	int	Sim	Retorna o ID do Motorista.	N/A
3	Nome	string	Sim	Nome do Motorista	N/A
4	Sobrenome	string	Sim	Sobrenome do Motorista	N/A
5	CPF	string	Sim	CPF do Motorista	N/A
6	NumeroRG	string	Sim	Número RG do Motorista	N/A
7	OrgaoEmissorRg	string	Sim	Órgão Emissor RG - Motorista	N/A
8	DataNascimento	DateTime (YYYY-MM-DD)	Sim	Data Nascimento do Motorista	Exemplo: (2018-08-20T10:05:33)
9	Sexo	string	Sim	Sexo do Motorista	N/A
10	EstadoCivil	string	Sim	Estado Civil do Motorista	N/A
11	NomePai	string	Sim	Nome do Pai do Motorista	N/A
12	NomeMae	string	Sim	Nome da Mãe do Motorista	N/A
13	Email	string	Sim	E-mail do Motorista	N/A
14	Telefone	string	Sim	Telefone Residencial/Trabalho do Motorista	N/A
15	TelefoneCelular	string	Sim	Telefone Celular do Motorista	N/A
16	Nacionalidade	string	Sim	Nacionalidade do Motorista	N/A
17	Endereco	string	Sim	Endereço do Motorista	N/A
18	NumeroPorta	string	Sim	Número Residência	N/A
19	EnderecoComplemento	string	Sim	Endereço Completo do Motorista	N/A
20	CEP	string	Sim	CEP do Motorista	N/A
21	Bairro	string	Sim	Bairro do Motorista	N/A
22	Cidade	string	Sim	Cidade do Motorista	N/A
23	UF	string	Sim	UF do Motorista	N/A
24	CodigoBanco	string	Não	Código Banco - Motorista	N/A
25	CodigoAgencia	string	Não	Código Agência - Motorista	N/A
26	DigitoAgencia	string	Não	Dígito Agência - Motorista	N/A
27	ContaCorrente	string	Não	Conta Corrente - Motorista	N/A
28	DigitoContaCorrente	string	Não	Dígito Conta Corrente - Motorista	N/A
29	FlagContaPoupanca	bool(true \|\| false)	Não	Flag Conta Poupança - Motorista	N/A
30	VariacaoContaPoupanca	string	Não	Variação Conta Poupança - Motorista	N/A
31	Ativo	bool(true \|\| false)	Sim	Cadastro Ativo ou Não	N/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>

Documentação WS 2.0 - Target Frete (Terceiros)

CadastrarAtualizarMotorista

Objetivo

Request

Response

Método

Cadastrar

Atualizar

Related pages