Objetivo

Esse método tem como objetivo realizar a busca de um motorista em nossa base de dados.

Observações Importantes

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.

Uso

Muitos Integradores, invocam o Método – ‘BuscarMotorista’ antes de invocarem o método – ‘CadastrarAtualizarMotorista’, então:

BuscarMotorista
1. Se o Motorista estiver cadastrado, não invocar o Método – ‘CadastrarAtualizarMotorista’.
2. Se o Motorista não estiver cadastrado, invocar o Método – ‘CadastrarAtualizarMotorista’.
CadastrarAtualizarMotorista

Request

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
BuscaMotoristaRequest
1	QuantidadeItensPorPagina	int	Sim	Quantidade de Itens por Página	N/A
2	NumeroPagina	int	Sim	Número da Página	N/A
3	CPFCNPJTransportador	string	Não	CPF ou CNPJ do Transportador	Transportador vinculado no cadastro de de motorista.
4	IdMotorista	int	Não	Id do Motorista	N/A
5	CPF	string	Sim	CPF do Motorista	É obrigatorio informar apenas motoristas já cadastraddos em sistema, vinculado a um transportador.
6	Ativo	bool(true \|\| false)	Não	CPF está Ativo ou Não	Ativo na base de dados da TARGET

Response

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
MotoristaResponse
1	Erro	ErroResponse - string	Não	Retorna o Erro	NULO em caso de sucesso
2	IdMotorista	int	Sim	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	N/A
8	DataNascimento	Datetime (YYYY-MM-DD)	Sim	Data de Nascimento do Motorista	N/A
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 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 da Residência do Motorista	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	Sim	Código do Banco do Motorista	N/A
25	CodigoAgencia	string	Sim	Código Agência do Motorista	N/A
26	DigitoAgencia	string	Sim	Dígito Agência do Motorista	N/A
27	ContaCorrente	string	Sim	Conta Corrente do Motorista	N/A
28	DigitoContaCorrente	string	Sim	Dígito Conta Corrente do Motorista	N/A
29	FlagContaPoupanca	bool(true \|\| false)	Sim	Flag Conta Poupança	N/A
30	VariacaoContaPoupanca	string	Sim	Variação Conta Poupança	N/A
31	Ativo	bool(true \|\| false)	Sim	Informamos se o Motorista está Ativo ou não em nossa base de dados	N/A

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
ResultadoPaginadoResponse
1	Erro	ErroResponse - string	Não	Retorna o Erro	NULO em caso de sucesso
2	Itens	N/A	N/A	Itens	N/A
3	NumeroPagina	int	Sim	Número da Página	N/A
4	QuantidadeItensPorPagina	int	Sim	Quantidade de Itens por Página	N/A
5	QuantidadeTotalItens	int	Sim	Quantidade Total de Itens	N/A
6	QuantidadeTotalPaginas	int	Sim	Quantidade Total de Páginas	N/A

Método

Abaixo, segue método - 'BuscaMotoristaRequest'.

BuscaMotoristaRequest

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br">
   <soapenv:Header/>
   <soapenv:Body>
      <tms:BuscarMotorista>
         <tms:auth>
            <tms:Usuario>?</tms:Usuario>
            <tms:Senha>?</tms:Senha>
            <tms:Token>?</tms:Token>
         </tms:auth>
         <tms:buscaMotorista>
            <tms:QuantidadeItensPorPagina>?</tms:QuantidadeItensPorPagina>
            <tms:NumeroPagina>?</tms:NumeroPagina>
            <tms:CPFCNPJTransportador>?</tms:CPFCNPJTransportador>
            <tms:IdMotorista>?</tms:IdMotorista>
            <tms:CPF>?</tms:CPF>
            <tms:Ativo>?</tms:Ativo>
         </tms:buscaMotorista>
      </tms:BuscarMotorista>
   </soapenv:Body>
</soapenv:Envelope>

Buscar Motorista

Abaixo, segue exemplo do método - 'BuscarMotorista'.

Exemplo - BuscaMotorista

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:BuscarMotorista>
         <tms:auth>
            <tms:Usuario>tms.exemplo</tms:Usuario>
            <tms:Senha>v0hXPrwerKblaBs=</tms:Senha>
            <tms:Token i:nil="true" />
         </tms:auth>
         <tms:buscaMotorista>
            <tms:QuantidadeItensPorPagina>1</tms:QuantidadeItensPorPagina>
            <tms:NumeroPagina>1</tms:NumeroPagina>
            <tms:CPFCNPJTransportador i:nil="true" />
            <tms:IdMotorista i:nil="true" />
            <tms:CPF>59175036720</tms:CPF>
            <tms:Ativo>true</tms:Ativo>
         </tms:buscaMotorista>
      </tms:BuscarMotorista>
   </soapenv:Body>
</soapenv:Envelope>

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

BuscarMotorista

Objetivo

Request

Response

Método

Buscar Motorista

Related pages