DOCUMENTAÇÃO CORPORATIVA

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Next »

Objetivo

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


Observaçõ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.


Request

ParticipanteRequest
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.

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
13EmailstringNãoE-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
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

ParticipanteRequest
<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.

Cadastro - ParticipanteRequest
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.

Atualizar - ParticipanteRequest
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.

ParticipanteRequest
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>
  • No labels