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

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
TransportadorRequest
1	Instrucao	int	Sim	Instrução do que se fazer com os dados.	1= Inserir ou Atualizar 2= Inserir se não existe
2	RNTRC	string	Sim	Número de RNTRC do Transportador	N/A
3	CPFCNPJ	string	Sim	CPF ou CNPJ do Transportador	N/A
4	Nome	string	Sim	Em caso de CPF, nome.	N/A
5	Sobrenome	string	Não	Em caso de CPF, sobrenome.	N/A
6	RazãoSocial	string(45)	Não	Em caso de CNPJ, razão social.	N/A
7	DataNascimento	DateTime(YYYY-MM-DD)	Sim	Data de Nascimento ou de Criação	N/A
8	RG	string	Não	Em caso de CPF, RG.	N/A
9	OrgaoEmissorRg	string	Não	Caso RG preenchido, informar Órgão Expedidor.	N/A
10	CNH	string	Não	CNH em caso de CPF	N/A
11	TipoCNH	string	Não	Tipo da CNH caso informado.	N/A
12	DataValidadeCNH	DateTime (YYYY-MM-DD)	Não	Data de Validade da CNG caso informado.	N/A
13	Sexo	string	Sim	Sexo em caso de CPF.	M= Masculino F= Feminino S= Não Informado
14	Naturalidade	string	Não	Naturalidade em caso de CPF	N/A
15	Nacionalidade	string	Não	Nacionalidade em caso de CPF	N/A
16	InscricaoEstadual	string	Não	Caso exista	N/A
17	InscricaoMunicipal	string	Não	Caso exista	N/A
18	NomeFantasia	string (20)	Não	Em caso de CNPJ	Quando for PJ.
19	DataInscricao	DateTime (YYYY-MM-DD)	Não	Caso possua Inscrição.	N/A
20	IdDmAtividadeEconomica	int	Não	Atividade Econômica da Transportadora.
21	Endereco	string	Sim	Endereço CPF ou CNPJ	N/A
22	NumeroEndereco	int	Sim	Número do Logradouro	N/A
23	EnderecoComplemento	string	Sim	Complemento Endereço	N/A
24	Bairro	string	Sim	Bairro	N/A
25	CEP	string	Sim	CEP	N/A
26	CodigoIBGEMunicipio	int	Sim	Código IBGE do endereço do Transportador	N/A
27	IdentificadorEndereco	string	Sim	Nome de identificação do endereço do Transportador	N/A
28	TelefoneFixo	long	Não	Telefone fixo do Transportador	N/A
29	TelefoneCelular	long	Não	Telefone celular do Transportador	N/A
30	EstadoCivil	int	Não	Estado Civil do Transportador conforme lista ao lado.	0= Sem Informação 1= Solteiro 2= Casado 3= Viúvo 4= Relação de Fato 5= Divorciado 6= Separado
31	Email	string	Sim	Email de contato do Transportador	N/A
32	Usuario	string	Não	Usuário no Sistema TARGET Frete do Transportador. Somente em caso de PJ, a senha é enviada para o e-mail cadastrado.	N/A
33	CodigoBanco	string	Não	Código do Banco do Transportador.	N/A
34	CodigoAgencia	string	Não	Agência do Transportador	N/A
35	DigitoAgencia	string	Não	Digito Agência do Transportador	N/A
36	ContaCorrente	string	Não	Conta Corrente do Transportador	N/A
37	DigitoContaCorrente	string	Não	Digito Conta Corrente do Transportador	N/A
38	FlagContaPoupanca	bool(true \|\| false)	Não	Flag para indicar se a conta do Transportador é poupança.	N/A
39	VariacaoContaPoupanca	string	Não	Variação da conta poupança do Transportador	N/A
40	NomeContato	string	Sim	.Nome do Contato	Dados de contato devem sempre ser informados,obrigatoriamente quando um CNPJ estiver sendo cadastrado. Em caso de CPF, assumiremos os dados do próprio como contato
41	CargoContato	string	Sim	Cargo do Contato Transportador.	Dados de contato devem sempre ser informados,obrigatoriamente quando um CNPJ estiver sendo cadastrado. Em caso de CPF, assumiremos os dados do próprio como contato
42	CPFCNPJContato	string	Sim	CPF ou CNPJ do Contato do Transportador	Dados de contato devem sempre ser informados,obrigatoriamente quando um CNPJ estiver sendo cadastrado. Em caso de CPF, assumiremos os dados do próprio como contato
43	TelefoneFixoContato	long	Não	Telefone Fixo do Contato do Transportador	Dados de contato devem sempre ser informados,obrigatoriamente quando um CNPJ estiver sendo cadastrado. Em caso de CPF, assumiremos os dados do próprio como contato
44	TelefoneCelularContato	long	Não	Telefone Celular do Contato do Transportador	Dados de contato devem sempre ser informados,obrigatoriamente quando um CNPJ estiver sendo cadastrado. Em caso de CPF, assumiremos os dados do próprio como contato
45	EmailContato	string	Sim	E-mail do Contato do Transportador	Dados de contato devem sempre ser informados,obrigatoriamente quando um CNPJ estiver sendo cadastrado. Em caso de CPF, assumiremos os dados do próprio como contato
46	DataNascimentoContato	DateTime (YYYY-MM-DD)	Não	Data de Nascimento do Contato do Transportador	Dados de contato devem sempre ser informados,obrigatoriamente quando um CNPJ estiver sendo cadastrado. Em caso de CPF, assumiremos os dados do próprio como contato
47	RGContato	string	Sim	RG do Contato do Transportador	Dados de contato devem sempre ser informados,obrigatoriamente quando um CNPJ estiver sendo cadastrado. Em caso de CPF, assumiremos os dados do próprio como contato
48	OrgaoEmissorRgContato	string	Sim	Órgão Expedidor do RG do Contato do Transportador	Dados de contato devem sempre ser informados,obrigatoriamente quando um CNPJ estiver sendo cadastrado. Em caso de CPF, assumiremos os dados do próprio como contato

Response

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
TransportadorResponse
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>