DOCUMENTAÇÃO CORPORATIVA
BuscarTransportador
- Gabriel Nisã Brandão Casaes Monteiro (Unlicensed)
Objetivo
Esse método tem como objetivo realizar uma busca de transportadores que estejam cadastrados 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.
Request
| BuscaTransportadorRequest | |||||
| Nº | Campo | Tipo | Obrigatório | Descrição | Observação |
|---|---|---|---|---|---|
| 1 | QuantidadeItensPorPagina | int | Sim | Quantidade de Itens por Página | N/A |
| 2 | NumeroPagina | int | Sim | Número da Página | N/A |
| 3 | CPFCNPJ | string | Sim | CPF ou CNPF do Transportador | N/A |
Response
| TransportadorResponse | |||||
| Nº | Campo | Tipo | Obrigatório | Descrição | Observação |
|---|---|---|---|---|---|
| 1 | Erro | ErroResponse - string | Não | Retorna o Erro | NULO em caso de sucesso |
| 2 | CPFCNPJ | string | Sim | CPF ou CNPJ do Transportador | N/A |
| 3 | DataAtualizacao | Datetime (YYYY-MM-DD) | Não | Data de Atualização do Cadastro do Transportador | N/A |
| 4 | DataRegistro | Datetime (YYYY-MM-DD) | Sim | Data do Registro do Cadastro do Transportador | N/A |
| 5 | IdCliente | int | Sim | Id Cliente | Id do Cliente TARGET que Cadastrou o Transportador |
| 6 | IdDmTipoPessoa | int | Sim | Retorna o Tipo de Pessoa | N/A |
| 7 | IdDmTipoTransportador | int | Sim | Retorna o Tipo de Transportador. | N/A |
| 8 | NomeRazaoSocial | string | Sim | Nome Razão Social | Apenas em caso de CNPJ |
| 9 | RNTRC | string | Sim | RNTRC do Transportador | N/A |
Método
Abaixo, segue método - 'BuscarTransportador'.
BuscaTransportadorRequest
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br">
<soapenv:Header/>
<soapenv:Body>
<tms:BuscarTransportador>
<tms:auth>
<tms:Usuario>?</tms:Usuario>
<tms:Senha>?</tms:Senha>
<tms:Token>?</tms:Token>
</tms:auth>
<tms:buscaTransportador>
<tms:QuantidadeItensPorPagina>?</tms:QuantidadeItensPorPagina>
<tms:NumeroPagina>?</tms:NumeroPagina>
<tms:CPFCNPJ>?</tms:CPFCNPJ>
</tms:buscaTransportador>
</tms:BuscarTransportador>
</soapenv:Body>
</soapenv:Envelope>
Buscar Transportador
Abaixo, segue exemplo do método - 'BuscaTransportador'.
Exemplo - BuscaTransportador
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:BuscarTransportador>
<tms:auth>
<tms:Usuario>tms.exemplo</tms:Usuario>
<tms:Senha>v0hXPrwerKblaBs=</tms:Senha>
<tms:Token i:nil="true" />
</tms:auth>
<tms:buscaTransportador>
<tms:QuantidadeItensPorPagina>1</tms:QuantidadeItensPorPagina>
<tms:NumeroPagina>1</tms:NumeroPagina>
<tms:CPFCNPJ>08277185430</tms:CPFCNPJ>
</tms:buscaTransportador>
</tms:BuscarTransportador>
</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/BuscarTransportadorResponse</Action>
</s:Header>
<s:Body>
<BuscarTransportadorResponse xmlns="http://tmsfrete.v2.targetmp.com.br">
<BuscarTransportadorResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<Erro i:nil="true" />
<CPFCNPJ>08277185430</CPFCNPJ>
<DataAtualizacao i:nil="true" />
<DataRegistro>0001-01-01T00:00:00</DataRegistro>
<IdCliente>29800</IdCliente>
<IdDmTipoPessoa>1</IdDmTipoPessoa>
<IdDmTipoTransportador>0</IdDmTipoTransportador>
<NomeRazaoSocial>DURVAN ELLITON VIANA DA SILVA</NomeRazaoSocial>
<RNTRC>50817399</RNTRC>
</BuscarTransportadorResult>
</BuscarTransportadorResponse>
</s:Body>
</s:Envelope>