DOCUMENTAÇÃO CORPORATIVA

CadastrarAtualizarTransportador

Owned by Gabriel Nisã Brandão Casaes Monteiro (Unlicensed)
Last updated: Dec 13, 2023 by vitor.costa

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

  1. O cadastro do Transportador é compartilhado para todos os Clientes TARGET MP.
  2. Antes de realizar o cadastro de uma Operação de Transporte, é necessário realizar o cadastro de um Transportador caso o mesmo não exista na base de dados da TARGET.
  3. 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

                                                                                      TransportadorRequest
NºCampoTipoObrigatórioDescriçãoObservação
1InstrucaointSimInstrução do que se fazer com os dados.1= Inserir ou Atualizar
2= Inserir se não existe
2RNTRCstringSimNúmero de RNTRC do TransportadorN/A
3CPFCNPJstringSimCPF ou CNPJ do TransportadorN/A
4NomestringSimEm caso de CPF, nome.

Quando for PF (CPF).


Favor informar apenas o primeiro nome.

5SobrenomestringNãoEm caso de CPF, sobrenome.Quando for PF (CPF) informação torna-se obrigatoria.
6RazãoSocialstring(45)NãoEm caso de CNPJ, Razão Social.Quando for PJ (CNPJ).
7DataNascimento

DateTime(YYYY-MM-DD)

SimData de Nascimento ou de Criação

Quando for PF (CPF).


Exemplo: (2018-08-20T10:05:33)

8RGstringNãoEm caso de CPF, RG.Quando for PF (CPF).
9OrgaoEmissorRgstringNãoCaso RG preenchido, informar Órgão Expedidor.Quando for PF (CPF).
10CNHstringNãoCNH em caso de CPFQuando for PF (CPF).
11TipoCNHstringNãoTipo da CNH caso informado.Quando for PF (CPF).
12DataValidadeCNHDateTime (YYYY-MM-DD)NãoData de Validade da CNG caso informado.

Quando for PF (CPF).


Exemplo: (2018-08-20T10:05:33)

13SexostringSimSexo em caso de CPF.

Obs. Importante: Favor informar o código de M, F ou S e não o que cada um significa.


M= Masculino
F= Feminino
S= Não Informado

14NaturalidadestringNãoNaturalidade em caso de CPFQuando for PF (CPF).
15NacionalidadestringNãoNacionalidade em caso de CPFQuando for PF (CPF).
16InscricaoEstadualstringNãoInscrição Estadual da TransportadoraCaso exista
17InscricaoMunicipalstringNãoInscrição Municipal da TransportadoraCaso exista
18NomeFantasiastring (20)NãoNome Fantasia da TransportadoraQuando for PJ (CNPJ).
19DataInscricaoDateTime (YYYY-MM-DD)SimCaso possua Inscrição.

Data de Inscrição da Transportadora (Quando o CNPJ da mesma foi criado.).

Caso o Cliente não tenha essa informação, a data informada deve ser menor do que a data atual.


Exemplo: (2018-08-20T10:05:33)

20IdDmAtividadeEconomicaintNãoAtividade Econômica da Transportadora.
21EnderecostringSimEndereço da TransportadoraN/A
22NumeroEnderecointSimNúmero do Logradouro da TransportadoraN/A
23EnderecoComplementostringSimComplemento Endereço da TransportadoraN/A
24BairrostringSimBairro da TransportadoraN/A
25CEPstringSimCEP da TransportadoraN/A
26CodigoIBGEMunicipiointSimCódigo IBGE do endereço do TransportadorN/A
27IdentificadorEnderecostringSimNome de identificação do endereço do TransportadorN/A
28TelefoneFixolongSimTelefone fixo do Transportador

Exemplo:

DD + 8N
2135005192

Obs: Os telefones não podem ser iguais em nenhum campo de telefone

29TelefoneCelularlongSimTelefone celular do Transportador

Exemplo:



DD + 8N || 9N



2186819085



21986819085

Obs: Os telefones não podem ser iguais em nenhum campo de telefone

30EstadoCivilintSimEstado Civil do Transportador conforme lista ao lado.

Obs. Importante: Favor informar o código de 0 a 6 e não o que cada um significa.


0= Sem Informação
1= Solteiro
2= Casado
3= Viúvo
4= Relação de Fato
5= Divorciado
6= Separado

31EmailstringSimEmail de contato do TransportadorExemplo:



gabriel.monteiro@targetmp.com.br
32UsuariostringNão

Usuário no Sistema TARGET Frete do Transportador.

Pode informar o CPF/CNPJ como usuário.

A senha é enviada para o e-mail cadastrado.

33CodigoBancostringNãoCódigo do Banco do Transportador.Deve possuir 3 dígitos. 
34CodigoAgenciastringNãoAgência do TransportadorN/A
35DigitoAgenciastringNãoDigito Agência do TransportadorN/A
36ContaCorrentestringNãoConta Corrente do TransportadorN/A
37DigitoContaCorrentestringNãoDigito Conta Corrente do TransportadorN/A
38FlagContaPoupanca

bool(true || false)

NãoFlag para indicar se a conta do Transportador é poupança.N/A
39VariacaoContaPoupancastringNãoVariação da conta poupança do TransportadorN/A
40NomeContatostringSim.Nome do ContatoDados 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
41CargoContatostringSimCargo 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
42CPFCNPJContatostringSimCPF ou CNPJ do Contato do TransportadorDados 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
43TelefoneFixoContatolongNãoTelefone 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


Obs: Os telefones não podem ser iguais em nenhum campo de telefone

44TelefoneCelularContatolongNãoTelefone 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


Obs: Os telefones não podem ser iguais em nenhum campo de telefone

45EmailContatostringSimE-mail do Contato do TransportadorDados 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
46DataNascimentoContatoDateTime (YYYY-MM-DD)NãoData 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


Exemplo: (2018-08-20T10:05:33)

47RGContatostringSimRG do Contato do TransportadorDados 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
48OrgaoEmissorRgContatostringSimÓrgão Expedidor do RG do Contato do TransportadorDados 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
49PisPasepstringNãoO PIS/PASEP é um número cadastrado  através de Documento de Cadastro do NIS (DCN) e Cartão de CNPJ, sendo que este serve para dar segurança ao FGTS e gerir o Programa de Integração.N/A

Response

TransportadorResponse
NºCampoTipoObrigatórioDescriçãoObservação
1ErroErroResponse - stringNãoRetorna a mensagem de Erro.NULO em caso de sucesso.
2CPFCNPJstringSimRetorna CPF ou CNPJ do Transportador.N/A
3DataAtualizacaoDateTime (YYYY-MM-DD)NãoRetorna a Data da Atualização.Exemplo: (2018-08-20T10:05:33)
4DataRegistroDateTime (YYYY-MM-DD)SimRetorna a Data do Registro.Exemplo: (2018-08-20T10:05:33)
5IdClienteintSimRetorna o Id do Cliente.N/A
6IdDmTipoPessoaintSimRetorna o Tipo de Pessoa.N/A
7IdDmTipoTransportadorintSimRetorna o Tipo de Transportador.N/A
8NomeRazaoSocialstringNãoRetorna Nome Razão Social.N/A
9RNTRCstringSimRetorna 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>