Versions Compared

Version Old Version 3 New Version Current
Changes made by

Gabriel Nisã Brandão Casaes Monteiro (Unlicensed)

Gabriel Nisã Brandão Casaes Monteiro (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Objetivo

Observações Importantes

Request

...

Realizar o cadastro de um Participante na base de dados da TARGET.


Info
titleObservações
  1. O Participante é o Destinatário da viagem.
  2. O Cadastro de Participante não é compartilhado com os Clientes TARGET MP, o mesmo é exclusivo para cada Cliente.
  3. Antes de realizar o cadastro de uma Operação de Transporte, é necessário realizar o cadastro de um Participante caso o mesmo não exista na base de dados da TARGET.
  4. 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

Response
ParticipanteRequest
NºCampoTipoObrigatórioDescriçãoObservação
1InstrucaointSimInstrução do que se fazer com os dados.1= Inserir ou Atualizar
2= Inserir se não existe
4= Desativar/Anular
2IdParticipanteintNãoId Participante na TARGETUsar apenas quando for atualizar o Cadastro de um Participante.

Response


Informamos o IdParticipante no response ao cadastrar ou atualizar o Participante.
3IdDmTipoPessoaintSimTipo de Pesso PF ou PJ1= PF
2= PJ
4NomestringSimNome do ParticipanteEm caso de CNPJ, informar o Nome Fantasia do Participante
5RazaoSocialstringSimRazão Social do ParticipanteN/A
6CPFCNPJstringSimCPF ou CNPJ do ParticipanteN/A
7EnderecostringSimEndereço do ParticipanteN/A
8BairrostringSimBairro do ParticipanteN/A
9CEPstringSimCEP do ParticipanteN/A
10MunicipioCodigoIBGEstringSimMunicípio Código IBGE do ParticipanteN/A
11RNTRCstringNãoRNTRC do ParticipanteCaso tenha
12AtivostringSimCadastro Ativo ou NãoN/A
13EmailstringSimE-mail do ParticipanteExemplo:
gabriel.monteiro@targetmp.com.br
14TelefonestringNãoTelefone Residencial/Trabalho do Participante

Exemplo:

DD + 8N
2135005192

15TelefoneCelularstringNãoTelefone Celular do ParticipanteExemplo:
DD + 8N || 9N
2186819085
21986819085


Response

ParticipanteResponse
NºCampoTipoObrigatórioDescriçãoObservação
1ErrostringSimRetorna o Erro.NULO em caso de sucesso.
2IdParticipantestringSimId do Participante na TARGETN/A
3IdDmTipoPessoastringSimTipo Pessoa1= PF
2= PJ
4NomestringSimNome do Participante Em caso de CNPJ, informar o Nome Fantasia
5RazaoSocialstringSimRazão Social do ParticipanteN/A
6CPFCNPJstringSimCPF ou CNPJ do ParticipanteN/A
7EnderecostringSimEndereço do ParticiapnteN/A
8BairrostringSimBairro do ParticipanteN/A
9CEPstringSimCEP do Participante N/A
10MunicipioCodigoIBGEstringSimMunicípio Código IBGE do ParticipanteN/A
11RNTRCstringNãoRNTRC do ParticianteCaso tenha
12AtivostringSimCadastro Ativo ou NãoN/A
13Emailbool(true || false)SimE-mail do ParticipanteExemplo:
gabriel.monteiro@targetmp.com.br
14TelefonestringNãoTelefone Residencial/Trabalho Participante 

Exemplo:

DD + 8N
2135005192

15TelefoneCelularstringNãoTelefone Celular do ParticipanteExemplo:
DD + 8N || 9N
2186819085
21986819085


Método

Code Block
languagexml
themeRDark
firstline1
titleParticipanteRequest
linenumberstrue
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tms="http://tmsfrete.v2.targetmp.com.br">
   <soapenv:Header/>
   <soapenv:Body>
      <tms:CadastrarAtualizarParticipante>
         <tms:auth>
            <tms:Usuario>?</tms:Usuario>
            <tms:Senha>?</tms:Senha>
            <tms:Token>?</tms:Token>
         </tms:auth>
         <tms:participante>
            <tms:Instrucao>?</tms:Instrucao>
            <tms:IdParticipante>?</tms:IdParticipante>
            <tms:IdDmTipoPessoa>?</tms:IdDmTipoPessoa>
            <tms:Nome>?</tms:Nome>
            <tms:RazaoSocial>?</tms:RazaoSocial>
            <tms:CPFCNPJ>?</tms:CPFCNPJ>
            <tms:Endereco>?</tms:Endereco>
            <tms:Bairro>?</tms:Bairro>
            <tms:CEP>?</tms:CEP>
            <tms:MunicipioCodigoIBGE>?</tms:MunicipioCodigoIBGE>
            <tms:RNTRC>?</tms:RNTRC>
            <tms:Ativo>?</tms:Ativo>
            <tms:Email>?</tms:Email>
            <tms:Telefone>?</tms:Telefone>
            <tms:TelefoneCelular>?</tms:TelefoneCelular>
         </tms:participante>
      </tms:CadastrarAtualizarParticipante>
   </soapenv:Body>
</soapenv:Envelope>


Cadastrar

Abaixo, segue exemplo de cadastro de um Participante.

Code Block
languagexml
themeRDark
firstline1
titleCadastro - ParticipanteRequest
linenumberstrue
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:CadastrarAtualizarParticipante>
         <tms:auth>
            <tms:Usuario>tms.exemplo</tms:Usuario>
            <tms:Senha>v0hXPrwerKblaBs=</tms:Senha>
            <tms:Token i:nil="true" />
         </tms:auth>
         <tms:participante>
            <tms:Instrucao>2</tms:Instrucao>
            <tms:IdParticipante i:nil="true" />
            <tms:IdDmTipoPessoa>2</tms:IdDmTipoPessoa>
            <tms:Nome>OZIEL TEIXEIRA JUNIOR</tms:Nome>
            <tms:RazaoSocial>OZIEL TEIXEIRA JUNIOR</tms:RazaoSocial>
            <tms:CPFCNPJ>30844261000159</tms:CPFCNPJ>
            <tms:Endereco>TRAVESSA VICENTE BENEDITO NOGUEIRA, 173</tms:Endereco>
            <tms:Bairro>Centro</tms:Bairro>
            <tms:CEP>37589000</tms:CEP>
            <tms:MunicipioCodigoIBGE>3167400</tms:MunicipioCodigoIBGE>
            <tms:RNTRC i:nil="true" />
            <tms:Ativo>true</tms:Ativo>
            <tms:Email i:nil="true" />
            <tms:Telefone i:nil="true" />
            <tms:TelefoneCelular i:nil="true" />
         </tms:participante>
      </tms:CadastrarAtualizarParticipante>
   </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/CadastrarAtualizarParticipanteResponse</Action>
  </s:Header>
  <s:Body>
    <CadastrarAtualizarParticipanteResponse xmlns="http://tmsfrete.v2.targetmp.com.br">
      <CadastrarAtualizarParticipanteResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <Erro i:nil="true" />
        <IdParticipante>77289</IdParticipante>
        <IdDmTipoPessoa>2</IdDmTipoPessoa>
        <Nome>OZIEL TEIXEIRA JUNIOR</Nome>
        <RazaoSocial>OZIEL TEIXEIRA JUNIOR</RazaoSocial>
        <CPFCNPJ>30844261000159</CPFCNPJ>
        <Endereco>TRAVESSA VICENTE BENEDITO NOGUEIRA, 173</Endereco>
        <Bairro>CENTRO</Bairro>
        <CEP>37589000</CEP>
        <MunicipioCodigoIBGE>3167400</MunicipioCodigoIBGE>
        <RNTRC i:nil="true" />
        <Ativo>true</Ativo>
        <Email />
        <Telefone />
        <TelefoneCelular i:nil="true" />
      </CadastrarAtualizarParticipanteResult>
    </CadastrarAtualizarParticipanteResponse>
  </s:Body>
</s:Envelope>


Atualizar

Abaixo, segue exemplo de atualização de um Participante.

Code Block
languagexml
themeRDark
firstline1
titleAtualizar - ParticipanteRequest
linenumberstrue
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:CadastrarAtualizarParticipante>
         <tms:auth>
            <tms:Usuario>tms.exemplo</tms:Usuario>
            <tms:Senha>v0hXPrwerKblaBs=</tms:Senha>
            <tms:Token i:nil="true" />
         </tms:auth>
         <tms:participante>
            <tms:Instrucao>1</tms:Instrucao>
            <tms:IdParticipante i:nil="true" />
            <tms:IdDmTipoPessoa>2</tms:IdDmTipoPessoa>
            <tms:Nome>OZIEL TEIXEIRA JUNIOR</tms:Nome>
            <tms:RazaoSocial>OZIEL TEIXEIRA JUNIOR</tms:RazaoSocial>
            <tms:CPFCNPJ>30844261000159</tms:CPFCNPJ>
            <tms:Endereco>TRAVESSA VICENTE BENEDITO NOGUEIRA, 173</tms:Endereco>
            <tms:Bairro>Centro</tms:Bairro>
            <tms:CEP>37589000</tms:CEP>
            <tms:MunicipioCodigoIBGE>3167400</tms:MunicipioCodigoIBGE>
            <tms:RNTRC i:nil="true" />
            <tms:Ativo>true</tms:Ativo>
            <tms:Email i:nil="true" />
            <tms:Telefone i:nil="true" />
            <tms:TelefoneCelular i:nil="true" />
         </tms:participante>
      </tms:CadastrarAtualizarParticipante>
   </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/CadastrarAtualizarParticipanteResponse</Action>
  </s:Header>
  <s:Body>
    <CadastrarAtualizarParticipanteResponse xmlns="http://tmsfrete.v2.targetmp.com.br">
      <CadastrarAtualizarParticipanteResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <Erro i:nil="true" />
        <IdParticipante>77289</IdParticipante>
        <IdDmTipoPessoa>2</IdDmTipoPessoa>
        <Nome>OZIEL TEIXEIRA JUNIOR</Nome>
        <RazaoSocial>OZIEL TEIXEIRA JUNIOR</RazaoSocial>
        <CPFCNPJ>30844261000159</CPFCNPJ>
        <Endereco>TRAVESSA VICENTE BENEDITO NOGUEIRA, 173</Endereco>
        <Bairro>CENTRO</Bairro>
        <CEP>37589000</CEP>
        <MunicipioCodigoIBGE>3167400</MunicipioCodigoIBGE>
        <RNTRC i:nil="true" />
        <Ativo>true</Ativo>
        <Email />
        <Telefone />
        <TelefoneCelular i:nil="true" />
      </CadastrarAtualizarParticipanteResult>
    </CadastrarAtualizarParticipanteResponse>
  </s:Body>
</s:Envelope>


Anular

Abaixo, segue exemplo para anular o cadastro de um Participante.

Code Block
languagexml
themeRDark
firstline1
titleParticipanteRequest
linenumberstrue
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:CadastrarAtualizarParticipante>
         <tms:auth>
            <tms:Usuario>tms.exemplo</tms:Usuario>
            <tms:Senha>v0hXPrwerKblaBs=</tms:Senha>
            <tms:Token i:nil="true" />
         </tms:auth>
         <tms:participante>
            <tms:Instrucao>4</tms:Instrucao>
            <tms:IdParticipante i:nil="true" />
            <tms:CPFCNPJ>30844261000159</tms:CPFCNPJ>
         </tms:participante>
      </tms:CadastrarAtualizarParticipante>
   </soapenv:Body>
</soapenv:Envelope>            


Response
            

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <CadastrarAtualizarParticipanteResponse xmlns="http://tmsfrete.v2.targetmp.com.br">
         <CadastrarAtualizarParticipanteResult xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <Erro i:nil="true"/>
            <IdParticipante>3461</IdParticipante>
            <IdDmTipoPessoa>2</IdDmTipoPessoa>
            <Nome>OZIEL TEIXEIRA JUNIOR</Nome>
            <RazaoSocial>OZIEL TEIXEIRA JUNIOR</RazaoSocial>
            <CPFCNPJ>30844261000159</CPFCNPJ>
            <Endereco>TRAVESSA VICENTE BENEDITO NOGUEIRA, 173</Endereco>
            <Bairro>Centro</Bairro>
            <CEP>37589000</CEP>
            <MunicipioCodigoIBGE>3167400</MunicipioCodigoIBGE>
            <RNTRC i:nil="true"/>
            <Ativo>false</Ativo>
            <Email i:nil="true"/>
            <Telefone i:nil="true"/>
            <TelefoneCelular i:nil="true"/>
         </CadastrarAtualizarParticipanteResult>
      </CadastrarAtualizarParticipanteResponse>
   </s:Body>
</s:Envelope>