Objetivo

Esse método tem como objetivo cadastrar um Roteiro através de um array de Latitude e Longitude, CEP ou CodigoMunicipioIBGE.

Pode-se usar para realmente cadastrar um Roteiro, deixando o mesmo salvo na base de dados da TARGET ou apenas obter os dados do response.

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.

Obs. Há duas maneiras de cadastrar um Roteiro através da integração:

Cadastrando apenas a Origem e Destino: Por default a rota será criada pelo caminho mais rápido.
Cadastrando Origem e Destino com Pontos de parada (Pode até 35 pontos de parada): Iremos criar uma rota de acordo com os pontos de parada, novamente a rota é feita pelo caminho mais rápido, porém obedecendo a ordem das paradas informadas pelo usuário.

Request

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
CadastrarRoteiroDetalhadoRequest
1	NomeRota	String	Sim	Nome da Rota que será cadastrada	N/A
2	CategoriaVeiculos	Int	Sim		Categoria da quantidade de eixos que o veículo possui.
3	LAT	Double	Não	Latitude do Local	Deve ser informado caso deseje criar o roteiro através de LAT/LONG.
4	LNG	Double	Não	Longitude do Local	Deve ser informado caso deseje criar o roteiro através de LAT/LONG.
5	CEP	String	Não	CEP do Local	Deve ser informado caso deseje criar o roteiro através do CEP do local.
6	CodigoIBGEMunicipio	Int	Não	Codigo IBGE do Município	Deve ser informado caso deseje criar o roteiro através do Código IBGE.
7	RotaTemporaria	bool(true \|\| false)	Sim	Caso a Rota seja temporária (true) ou não (false)	N/A
8	SomenteCalculo	bool(true \|\| false)	Sim	Caso só deseje saber o valor que irá custar o pedágio.	N/A

Response

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
CadastrarRoteiroDetalhadoResponse
1	Erro	ErroResponse - string	Não	Mensagem de Erro.	NULO em caso de sucesso.
2	IdRotaCliete	int	Sim	Id do roteiro que foi cadastrado.	N/A
3	NomeRota	String	Sim	Nome do roteiro que foi cadastrado.	N/A
4	Origem	List<CadastrarRoteiro DetalhadoOrigem Response>	Sim	Origem da Rota Cadastrada.	N/A
5	Destino	List<CadastrarRoteiro DetalhadoDestino Response>	Sim	Destino da Rota Cadastrada.	N/A
6	RotaDetalhadaInfoPedagio	List<Rota Detalhada InfoPedagio Response>	Sim	Informações do pedágio da Rota Cadastrada.	N/A
7	ValorTotalPedagio	string	Sim	Valor total do pedágio referente ao roteiro criado.

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
CadastrarRoteiroDetalhadoOrigemResponse
1	Cidade	string	Sim	Cidade de origem do roteiro cadastrado.	N/A
2	Endereço	string	Sim	Endereço de Origem do roteiro cadastrado.	N/A
3	Latitude	double	Sim	Latitude de Origem do roteiro cadastrado.	N/A
4	Longitude	double	Sim	Longitude de Origem do Roteiro Cadastrado.	N/A
5	CEP	string	Sim	CEP de Origem do Roteiro Cadastrado.	N/A
6	Ordem	int	Sim	Ordem sequencial das paradas do Roteiro.	N/A

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
CadastrarRoteiroDetalhadoDestinoResponse
1	Cidade	string	Sim	Cidade de Destino do roteiro cadastrado.	N/A
2	Endereço	string	Sim	Endereço de Destino do roteiro cadastrado.	N/A
3	Latitude	double	Sim	Latitude de Destino do roteiro cadastrado.	N/A
4	Longitude	double	Sim	Longitude de Destino do Roteiro Cadastrado.	N/A
5	CEP	string	Sim	CEP de Destino do Roteiro Cadastrado.	N/A
6	Ordem	int	Sim	Ordem sequencial das paradas do Roteiro.	N/A

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
RotaDetalhadaInfoPedagioResponse
1	NomePedagio	string	Sim	Nome da Praça de Pedágio.	N/A
2	IdDmCategoriaVeiculo	int	Sim	Id da Categoria do Veículo utilizado para criar o Roteiro.	N/A
3	Valor	string	Sim	Valor da Praça de Pedágio	N/A
4	Ordem	int	Sim	Ordem sequencial das paradas do Roteiro.	N/A

Método

CadastrarRoteiroDetalhada

REQUEST
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br">
    <soapenv:Header/>
     <soapenv:Body>
        <tms:CadastrarRoteiroDetalhado>
             <tms:auth>
                 <tms:Usuario>target.tms</tms:Usuario>
                 <tms:Senha>******</tms:Senha>
                 <tms:Token i:nil="true" />
            </tms:auth>
            <tms:rotaDetalhada>
                   <tms:NomeRota>Teste</tms:NomeRota>
                   <tms:CategoriaVeiculo>7</tms:CategoriaVeiculo>
                    <tms:Paradas>
                   <tms:RotaDetalhadaParada>
                         <tms:LAT>-22.3710357</tms:LAT>
                         <tms:LNG>-47.3810465</tms:LNG>
                         <tms:CEP i:nil="true" />
                         <tms:CodigoIBGEMunicipio>0</tms:CodigoIBGEMunicipio>
                  </tms:RotaDetalhadaParada>
                  <tms:RotaDetalhadaParada>
                         <tms:LAT>-22.8283659</tms:LAT>
                         <tms:LNG>-43.2737664</tms:LNG>
                         <tms:CEP i:nil="true" />
                        <tms:CodigoIBGEMunicipio>0</tms:CodigoIBGEMunicipio>
                  </tms:RotaDetalhadaParada>
                  <tms:RotaTemporaria>false</tms:RotaTemporaria>
                  <tms:SomenteCalculo>false</tms:SomenteCalculo>
              </tms:rotaDetalhada>
          </tms:CadastrarRoteiroDetalhado>
       </soapenv:Body>
</soapenv:Envelope>

RESPONSE

<s:Envelope
xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<CadastrarRoteiroDetalhadoResponse
xmlns="http://tmsfrete.v2.targetmp.com.br">
<CadastrarRoteiroDetalhadoResult
xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<Erro i:nil="true"/>
<IdRotaCliente>139137</IdRotaCliente>
<NomeRota>TESTE</NomeRota>
<Origem>
<Cidade>Araras, SP</Cidade>
<Endereco>Avenida Limeira</Endereco>
<Latitude>-22.371021182009</Latitude>
<Longitude>-47.3810848484768</Longitude>
<Cep i:nil="true"/>
<Ordem>0</Ordem>
</Origem>
<Destino>
<Cidade>Rio de Janeiro, RJ</Cidade>
<Endereco>Rua Conde De Agrolongo,26</Endereco>
<Latitude>-22.82831</Latitude>
<Longitude>-43.273751</Longitude>
<Cep i:nil="true"/>
<Ordem>0</Ordem>
</Destino>
<Paradas/>
<Pedagios>
<RotaDetalhadaInfoPedagio>
<NomePedagio>Pedágio - Limeira A Sul</NomePedagio>
<IdDmCategoriaVeiculo>7</IdDmCategoriaVeiculo>
<Valor>12.8</Valor>
<Ordem>1</Ordem>
</RotaDetalhadaInfoPedagio>
<RotaDetalhadaInfoPedagio>
<NomePedagio>Pedágio - Nova Odessa Sul</NomePedagio>
<IdDmCategoriaVeiculo>7</IdDmCategoriaVeiculo>
<Valor>16.8</Valor>
<Ordem>2</Ordem>
</RotaDetalhadaInfoPedagio>
<RotaDetalhadaInfoPedagio>
<NomePedagio>Pedágio - Itatiba</NomePedagio>
<IdDmCategoriaVeiculo>7</IdDmCategoriaVeiculo>
<Valor>20.4</Valor>
<Ordem>3</Ordem>
</RotaDetalhadaInfoPedagio>
<RotaDetalhadaInfoPedagio>
<NomePedagio>Pedágio - Atibaia</NomePedagio>
<IdDmCategoriaVeiculo>7</IdDmCategoriaVeiculo>
<Valor>15.2</Valor>
<Ordem>4</Ordem>
</RotaDetalhadaInfoPedagio>
<RotaDetalhadaInfoPedagio>
<NomePedagio>Pedágio - Igaratá</NomePedagio>
<IdDmCategoriaVeiculo>7</IdDmCategoriaVeiculo>
<Valor>19</Valor>
<Ordem>5</Ordem>
</RotaDetalhadaInfoPedagio>
<RotaDetalhadaInfoPedagio>
<NomePedagio>Pedágio - Jacareí</NomePedagio>
<IdDmCategoriaVeiculo>7</IdDmCategoriaVeiculo>
<Valor>13.4</Valor>
<Ordem>6</Ordem>
</RotaDetalhadaInfoPedagio>
<RotaDetalhadaInfoPedagio>
<NomePedagio>Pedágio - Moreira César</NomePedagio>
<IdDmCategoriaVeiculo>7</IdDmCategoriaVeiculo>
<Valor>30.4</Valor>
<Ordem>7</Ordem>
</RotaDetalhadaInfoPedagio>
<RotaDetalhadaInfoPedagio>
<NomePedagio>Pedágio - Itatiaia</NomePedagio>
<IdDmCategoriaVeiculo>7</IdDmCategoriaVeiculo>
<Valor>30.4</Valor>
<Ordem>8</Ordem>
</RotaDetalhadaInfoPedagio>
<RotaDetalhadaInfoPedagio>
<NomePedagio>Pedágio - Viúva Graça</NomePedagio>
<IdDmCategoriaVeiculo>7</IdDmCategoriaVeiculo>
<Valor>30.4</Valor>
<Ordem>9</Ordem>
</RotaDetalhadaInfoPedagio>
</Pedagios>
<ValorTotalPedagio>188.8</ValorTotalPedagio>
</CadastrarRoteiroDetalhadoResult>
</CadastrarRoteiroDetalhadoResponse>
</s:Body>
</s:Envelope>