Objetivo
Método para inserir ou atualizar um transportador de qualquer tipo, pode acontecer de o transportador já existir em nossa base. Quando isso ocorrer, o Transportador será associado ao cliente que realizou esse Request e uma mensagem de sucesso será retornada juntamente com um objeto contendo os dados do transportador para conferência. Em caso de instruções de inserção e o transportador já exista, será retornado os dados do transportador em um objeto.
Observações
Observações Importantes
Request
| TransportadorRequest | |||||
| Nº | Campo | Tipo | Obrigatório | Descrição | Observação |
|---|---|---|---|---|---|
| 1 | Instrucao | int | Sim | ||
| 2 | RNTRC | string | Sim | ||
| 3 | CPFCNPJ | string | Sim | ||
| 4 | Nome | string | Sim | ||
| 5 | Sobrenome | string | Não | ||
| 6 | RazãoSocial | string(45) | Não | ||
| 7 | DataNascimento | DateTime(YYYY-MM-DD) | Sim | ||
| 8 | RG | string | Não | ||
| 9 | OrgaoEmissorRg | string | Não | ||
| 10 | CNH | string | Não | ||
| 11 | TipoCNH | string | Não | ||
| 12 | DataValidadeCNH | DateTime (YYYY-MM-DD) | Não | ||
| 13 | Sexo | string | Sim | ||
| 14 | Naturalidade | string | Não | ||
| 15 | Nacionalidade | string | Não | ||
| 16 | InscricaoEstadual | string | Não | ||
| 17 | InscricaoMunicipal | string | Não | ||
| 18 | NomeFantasia | string (20) | Não | Quando for PJ. | |
| 19 | DataInscricao | DateTime (YYYY-MM-DD) | Não | Caso possua Inscrição. | |
| 20 | IdDmAtividadeEconomica | int | Não | Atividade Econômica da Transportadora. | |
| 21 | Endereco | string | Sim | ||
| 22 | NumeroEndereco | int | Sim | ||
| 23 | EnderecoComplemento | string | Sim | ||
| 24 | Bairro | string | Sim | ||
| 25 | CEP | string | Sim | ||
| 26 | CodigoIBGEMunicipio | int | Sim | ||
| 27 | IdentificadorEndereco | string | Sim | ||
| 28 | TelefoneFixo | long | Não | ||
| 29 | TelefoneCelular | long | Não | ||
| 30 | EstadoCivil | int | Não | 0= Sem Informação 1= Solteiro 2= Casado 3= Viúvo 4= Relação de Fato 5= Divorciado 6= Separado | |
| 31 | string | Sim | |||
| 32 | Usuario | string | Não | ||
| 33 | CodigoBanco | string | Não | ||
| 34 | CodigoAgencia | string | Não | ||
| 35 | DigitoAgencia | string | Não | ||
| 36 | ContaCorrente | string | Não | ||
| 37 | DigitoContaCorrente | string | Não | ||
| 38 | FlagContaPoupanca | bool(true || false) | Não | ||
| 39 | VariacaoContaPoupanca | string | Não | ||
| 40 | NomeContato | string | Sim | ||
| 41 | CargoContato | string | Sim | ||
| 42 | CPFCNPJContato | string | Sim | ||
| 43 | TelefoneFixoContato | long | Não | ||
| 44 | TelefoneCelularContato | long | Não | ||
| 45 | EmailContato | string | |||
| 46 | DataNascimentoContato | DateTime (YYYY-MM-DD) | Não | ||
| 47 | RGContato | string | Sim | ||
| 48 | OrgaoEmissorRgContato | string | Sim | ||
Response
| TransportadorResponse | |||||
| Nº | Campo | Tipo | Obrigatório | Descrição | Observação |
|---|---|---|---|---|---|
| 1 | Erro | ErroResponse - string | Não | Retorna a mensagem de Erro. | NULO em caso de sucesso. |
| 2 | CPFCNPJ | string | Sim | Retorna CPF ou CNPJ do Transportador. | N/A |
| 3 | DataAtualizacao | DateTime (YYYY-MM-DD) | Não | Retorna a Data da Atualização. | N/A |
| 4 | DataRegistro | DateTime (YYYY-MM-DD) | Sim | Retorna a Data do Registro. | N/A |
| 5 | IdCliente | int | Sim | Retorna o Id do Cliente. | N/A |
| 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 | Não | Retorna Nome Razão Social. | N/A |
| 9 | RNTRC | string | Sim | Retorna o RNTRC. | N/A |
Método
Abaixo, segue o método - CadastrarAtualizarTransportador.
TransportadorRequest
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br">
<soapenv:Header/>
<soapenv:Body>
<tms:CadastrarAtualizarTransportador>
<tms:auth>
<tms:Usuario>?</tms:Usuario>
<tms:Senha>?</tms:Senha>
<tms:Token>?</tms:Token>
</tms:auth>
<tms:transportador>
<tms:Instrucao>?</tms:Instrucao>
<tms:RNTRC>?</tms:RNTRC>
<tms:CPFCNPJ>?</tms:CPFCNPJ>
<tms:Nome>?</tms:Nome>
<tms:Sobrenome>?</tms:Sobrenome>
<tms:RazaoSocial>?</tms:RazaoSocial>
<tms:DataNascimento>?</tms:DataNascimento>
<tms:RG>?</tms:RG>
<tms:OrgaoEmissorRg>?</tms:OrgaoEmissorRg>
<tms:CNH>?</tms:CNH>
<tms:TipoCNH>?</tms:TipoCNH>
<tms:DataValidadeCNH>?</tms:DataValidadeCNH>
<tms:Sexo>?</tms:Sexo>
<tms:Naturalidade>?</tms:Naturalidade>
<tms:Nacionalidade>?</tms:Nacionalidade>
<tms:InscricaoEstadual>?</tms:InscricaoEstadual>
<tms:InscricaoMunicipal>?</tms:InscricaoMunicipal>
<tms:NomeFantasia>?</tms:NomeFantasia>
<tms:DataInscricao>?</tms:DataInscricao>
<tms:IdDmAtividadeEconomica>?</tms:IdDmAtividadeEconomica>
<tms:Endereco>?</tms:Endereco>
<tms:NumeroEndereco>?</tms:NumeroEndereco>
<tms:EnderecoComplemento>?</tms:EnderecoComplemento>
<tms:Bairro>?</tms:Bairro>
<tms:CEP>?</tms:CEP>
<tms:CodigoIBGEMunicipio>?</tms:CodigoIBGEMunicipio>
<tms:IdentificadorEndereco>?</tms:IdentificadorEndereco>
<tms:TelefoneFixo>?</tms:TelefoneFixo>
<tms:TelefoneCelular>?</tms:TelefoneCelular>
<tms:EstadoCivil>?</tms:EstadoCivil>
<tms:Email>?</tms:Email>
<tms:Usuario>?</tms:Usuario>
<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:NomeContato>?</tms:NomeContato>
<tms:CargoContato>?</tms:CargoContato>
<tms:CPFCNPJContato>?</tms:CPFCNPJContato>
<tms:TelefoneFixoContato>?</tms:TelefoneFixoContato>
<tms:TelefoneCelularContato>?</tms:TelefoneCelularContato>
<tms:EmailContato>?</tms:EmailContato>
<tms:DataNascimentoContato>?</tms:DataNascimentoContato>
<tms:RGContato>?</tms:RGContato>
<tms:OrgaoEmissorRgContato>?</tms:OrgaoEmissorRgContato>
</tms:transportador>
</tms:CadastrarAtualizarTransportador>
</soapenv:Body>
</soapenv:Envelope>
Cadastrar
Abaixo, segue exemplo do cadastro de um Transportador.
TransportadorRequest
Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Header/>
<soapenv:Body>
<tms:CadastrarAtualizarTransportador>
<tms:auth>
<tms:Usuario>tms.exemplo</tms:Usuario>
<tms:Senha>v0hXPrwerKblaBs=</tms:Senha>
<tms:Token i:nil="true" />
</tms:auth>
<tms:transportador>
<tms:Instrucao>1</tms:Instrucao>
<tms:RNTRC>049329100</tms:RNTRC>
<tms:CPFCNPJ>24465698000260</tms:CPFCNPJ>
<tms:Nome i:nil="true" />
<tms:Sobrenome i:nil="true" />
<tms:RazaoSocial>M Tirapu Transportes Ltda</tms:RazaoSocial>
<tms:DataNascimento>1980-01-01</tms:DataNascimento>
<tms:RG i:nil="true" />
<tms:OrgaoEmissorRg i:nil="true" />
<tms:CNH i:nil="true" />
<tms:TipoCNH i:nil="true" />
<tms:DataValidadeCNH i:nil="true" />
<tms:Sexo i:nil="true" />
<tms:Naturalidade i:nil="true" />
<tms:Nacionalidade i:nil="true" />
<tms:InscricaoEstadual>90745789-31</tms:InscricaoEstadual>
<tms:InscricaoMunicipal i:nil="true" />
<tms:NomeFantasia>M Tirapu Transportes Ltda</tms:NomeFantasia>
<tms:DataInscricao i:nil="true" />
<tms:IdDmAtividadeEconomica i:nil="true" />
<tms:Endereco>Estrada do Bairro Tatupeva</tms:Endereco>
<tms:NumeroEndereco>0</tms:NumeroEndereco>
<tms:EnderecoComplemento>Adrianópolis</tms:EnderecoComplemento>
<tms:Bairro>Tatupeva</tms:Bairro>
<tms:CEP>83490-000</tms:CEP>
<tms:CodigoIBGEMunicipio>4100202</tms:CodigoIBGEMunicipio>
<tms:IdentificadorEndereco>NA</tms:IdentificadorEndereco>
<tms:TelefoneFixo>4732422128</tms:TelefoneFixo>
<tms:TelefoneCelular>21986819087</tms:TelefoneCelular>
<tms:EstadoCivil>0</tms:EstadoCivil>
<tms:Email>gabriel.monteiro@targetmp.com.br</tms:Email>
<tms:Usuario i:nil="true" />
<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:NomeContato>Gabriel Monteiro</tms:NomeContato>
<tms:CargoContato>Analista</tms:CargoContato>
<tms:CPFCNPJContato>16664732171</tms:CPFCNPJContato>
<tms:TelefoneFixoContato>2122603544</tms:TelefoneFixoContato>
<tms:TelefoneCelularContato>21986819058</tms:TelefoneCelularContato>
<tms:EmailContato>gabriel.monteiro@targetmp.com.br</tms:EmailContato>
<tms:DataNascimentoContato i:nil="true" />
<tms:RGContato>208457844</tms:RGContato>
<tms:OrgaoEmissorRgContato>DETRAN</tms:OrgaoEmissorRgContato>
</tms:transportador>
</tms:CadastrarAtualizarTransportador>
</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/CadastrarAtualizarTransportadorResponse</Action>
</s:Header>
<s:Body>
<CadastrarAtualizarTransportadorResponse xmlns="http://tmsfrete.v2.targetmp.com.br">
<CadastrarAtualizarTransportadorResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<Erro i:nil="true" />
<CPFCNPJ>24465698000260</CPFCNPJ>
<DataAtualizacao>2018-08-23T14:45:12.1894163-03:00</DataAtualizacao>
<DataRegistro>2018-08-23T14:45:12.142621-03:00</DataRegistro>
<IdCliente>28331</IdCliente>
<IdDmTipoPessoa>2</IdDmTipoPessoa>
<IdDmTipoTransportador>2</IdDmTipoTransportador>
<NomeRazaoSocial>M Tirapu Transportes Ltda</NomeRazaoSocial>
<RNTRC>049329100</RNTRC>
</CadastrarAtualizarTransportadorResult>
</CadastrarAtualizarTransportadorResponse>
</s:Body>
</s:Envelope>
Atualizar
Abaixo, segue exemplo da atualização do cadastro de um Transportador.
TransportadorRequest
Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Header/>
<soapenv:Body>
<tms:CadastrarAtualizarTransportador>
<tms:auth>
<tms:Usuario>tms.exemplo</tms:Usuario>
<tms:Senha>v0hXPrwerKblaBs=</tms:Senha>
<tms:Token i:nil="true" />
</tms:auth>
<tms:transportador>
<tms:Instrucao>1</tms:Instrucao>
<tms:RNTRC>049329100</tms:RNTRC>
<tms:CPFCNPJ>24465698000260</tms:CPFCNPJ>
<tms:Nome i:nil="true" />
<tms:Sobrenome i:nil="true" />
<tms:RazaoSocial>M Tirapu Transportes Ltda</tms:RazaoSocial>
<tms:DataNascimento>1980-01-01</tms:DataNascimento>
<tms:RG i:nil="true" />
<tms:OrgaoEmissorRg i:nil="true" />
<tms:CNH i:nil="true" />
<tms:TipoCNH i:nil="true" />
<tms:DataValidadeCNH i:nil="true" />
<tms:Sexo i:nil="true" />
<tms:Naturalidade i:nil="true" />
<tms:Nacionalidade i:nil="true" />
<tms:InscricaoEstadual>90745789-31</tms:InscricaoEstadual>
<tms:InscricaoMunicipal i:nil="true" />
<tms:NomeFantasia>M Tirapu Transportes Ltda</tms:NomeFantasia>
<tms:DataInscricao i:nil="true" />
<tms:IdDmAtividadeEconomica i:nil="true" />
<tms:Endereco>Estrada do Bairro Tatupeva</tms:Endereco>
<tms:NumeroEndereco>0</tms:NumeroEndereco>
<tms:EnderecoComplemento>Adrianópolis</tms:EnderecoComplemento>
<tms:Bairro>Tatupeva</tms:Bairro>
<tms:CEP>83490-000</tms:CEP>
<tms:CodigoIBGEMunicipio>4100202</tms:CodigoIBGEMunicipio>
<tms:IdentificadorEndereco>NA</tms:IdentificadorEndereco>
<tms:TelefoneFixo>4732422128</tms:TelefoneFixo>
<tms:TelefoneCelular>21986819087</tms:TelefoneCelular>
<tms:EstadoCivil>0</tms:EstadoCivil>
<tms:Email>gabriel.monteiro@targetmp.com.br</tms:Email>
<tms:Usuario i:nil="true" />
<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:NomeContato>Gabriel Monteiro</tms:NomeContato>
<tms:CargoContato>Analista</tms:CargoContato>
<tms:CPFCNPJContato>16664732171</tms:CPFCNPJContato>
<tms:TelefoneFixoContato>2122603544</tms:TelefoneFixoContato>
<tms:TelefoneCelularContato>21986819058</tms:TelefoneCelularContato>
<tms:EmailContato>gabriel.monteiro@targetmp.com.br</tms:EmailContato>
<tms:DataNascimentoContato>25-04-1992</tms:DataNascimentoContato>
<tms:RGContato>208457844</tms:RGContato>
<tms:OrgaoEmissorRgContato>DETRAN</tms:OrgaoEmissorRgContato>
</tms:transportador>
</tms:CadastrarAtualizarTransportador>
</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/CadastrarAtualizarTransportadorResponse</Action>
</s:Header>
<s:Body>
<CadastrarAtualizarTransportadorResponse xmlns="http://tmsfrete.v2.targetmp.com.br">
<CadastrarAtualizarTransportadorResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<Erro i:nil="true" />
<CPFCNPJ>24465698000260</CPFCNPJ>
<DataAtualizacao>2018-08-23T14:45:12.1894163-03:00</DataAtualizacao>
<DataRegistro>2018-08-23T14:45:12.142621-03:00</DataRegistro>
<IdCliente>28331</IdCliente>
<IdDmTipoPessoa>2</IdDmTipoPessoa>
<IdDmTipoTransportador>2</IdDmTipoTransportador>
<NomeRazaoSocial>M Tirapu Transportes Ltda</NomeRazaoSocial>
<RNTRC>049329100</RNTRC>
</CadastrarAtualizarTransportadorResult>
</CadastrarAtualizarTransportadorResponse>
</s:Body>
</s:Envelope>