DOCUMENTAÇÃO CORPORATIVA
CadastrarAtualizarParticipante
- Gabriel Nisã Brandão Casaes Monteiro (Unlicensed)
Objetivo
Realizar o cadastro de um Participante na base de dados da TARGET.
Observações
- O Participante é o Destinatário da viagem.
- O Cadastro de Participante não é compartilhado com os Clientes TARGET MP, o mesmo é exclusivo para cada Cliente.
- 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.
- 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
| ParticipanteRequest | |||||
| Nº | Campo | Tipo | Obrigatório | Descrição | Observação |
|---|---|---|---|---|---|
| 1 | Instrucao | int | Sim | Instrução do que se fazer com os dados. | 1= Inserir ou Atualizar 2= Inserir se não existe 4= Desativar/Anular |
| 2 | IdParticipante | int | Não | Id Participante na TARGET | Usar apenas quando for atualizar o Cadastro de um Participante. Informamos o IdParticipante no response ao cadastrar ou atualizar o Participante. |
| 3 | IdDmTipoPessoa | int | Sim | Tipo de Pesso PF ou PJ | 1= PF 2= PJ |
| 4 | Nome | string | Sim | Nome do Participante | Em caso de CNPJ, informar o Nome Fantasia do Participante |
| 5 | RazaoSocial | string | Sim | Razão Social do Participante | N/A |
| 6 | CPFCNPJ | string | Sim | CPF ou CNPJ do Participante | N/A |
| 7 | Endereco | string | Sim | Endereço do Participante | N/A |
| 8 | Bairro | string | Sim | Bairro do Participante | N/A |
| 9 | CEP | string | Sim | CEP do Participante | N/A |
| 10 | MunicipioCodigoIBGE | string | Sim | Município Código IBGE do Participante | N/A |
| 11 | RNTRC | string | Não | RNTRC do Participante | Caso tenha |
| 12 | Ativo | string | Sim | Cadastro Ativo ou Não | N/A |
| 13 | string | Sim | E-mail do Participante | Exemplo: gabriel.monteiro@targetmp.com.br | |
| 14 | Telefone | string | Não | Telefone Residencial/Trabalho do Participante | Exemplo: DD + 8N |
| 15 | TelefoneCelular | string | Não | Telefone Celular do Participante | Exemplo: DD + 8N || 9N 2186819085 21986819085 |
Response
| ParticipanteResponse | |||||
| Nº | Campo | Tipo | Obrigatório | Descrição | Observação |
|---|---|---|---|---|---|
| 1 | Erro | string | Sim | Retorna o Erro. | NULO em caso de sucesso. |
| 2 | IdParticipante | string | Sim | Id do Participante na TARGET | N/A |
| 3 | IdDmTipoPessoa | string | Sim | Tipo Pessoa | 1= PF 2= PJ |
| 4 | Nome | string | Sim | Nome do Participante | Em caso de CNPJ, informar o Nome Fantasia |
| 5 | RazaoSocial | string | Sim | Razão Social do Participante | N/A |
| 6 | CPFCNPJ | string | Sim | CPF ou CNPJ do Participante | N/A |
| 7 | Endereco | string | Sim | Endereço do Particiapnte | N/A |
| 8 | Bairro | string | Sim | Bairro do Participante | N/A |
| 9 | CEP | string | Sim | CEP do Participante | N/A |
| 10 | MunicipioCodigoIBGE | string | Sim | Município Código IBGE do Participante | N/A |
| 11 | RNTRC | string | Não | RNTRC do Particiante | Caso tenha |
| 12 | Ativo | string | Sim | Cadastro Ativo ou Não | N/A |
| 13 | bool(true || false) | Sim | E-mail do Participante | Exemplo: gabriel.monteiro@targetmp.com.br | |
| 14 | Telefone | string | Não | Telefone Residencial/Trabalho Participante | Exemplo: DD + 8N |
| 15 | TelefoneCelular | string | Não | Telefone Celular do Participante | Exemplo: 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>