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.
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 | Não | 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>