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
MotoristaRequest | |||||
Nº | Campo | Tipo | Obrigatório | Descrição | Obrigatório |
---|---|---|---|---|---|
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 | N/A |
3 | IdMotorista | int | Não | Id do Motorista na TARGET | Fazer uso apenas quando for atualizar o cadastro do motorista. Informamos o IdMotorista no response 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 |
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 | string | Sim | E-mail do Motorista | Exemplo: gabriel.monteiro@targetmp.com.br | |
15 | Telefone | string | Sim | Telefone Residencial/Trabalho do Motorista | Exemplo: DD + 8N |
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
MotoristaResponse | |||||
Nº | Campo | Tipo | Obrigatório | Descrição | Obrigatório |
---|---|---|---|---|---|
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 | 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.
<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.
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.
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>