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

O cadastro do Transportador é compartilhado para todos os Clientes TARGET MP.
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.
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

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
TransportadorRequest
1	Instrucao	int	Sim	Instrução do que se fazer com os dados.	1= Inserir ou Atualizar 2= Inserir se não existe
2	RNTRC	string	Sim	Número de RNTRC do Transportador	N/A
3	CPFCNPJ	string	Sim	CPF ou CNPJ do Transportador	N/A
4	Nome	string	Sim	Em caso de CPF, nome.	Quando for PF (CPF). Favor informar apenas o primeiro nome.
5	Sobrenome	string	Não	Em caso de CPF, sobrenome.	Quando for PF (CPF) informação torna-se obrigatoria.
6	RazãoSocial	string(45)	Não	Em caso de CNPJ, Razão Social.	Quando for PJ (CNPJ).
7	DataNascimento	DateTime(YYYY-MM-DD)	Sim	Data de Nascimento ou de Criação	Quando for PF (CPF). Exemplo: (2018-08-20T10:05:33)
8	RG	string	Não	Em caso de CPF, RG.	Quando for PF (CPF).
9	OrgaoEmissorRg	string	Não	Caso RG preenchido, informar Órgão Expedidor.	Quando for PF (CPF).
10	CNH	string	Não	CNH em caso de CPF	Quando for PF (CPF).
11	TipoCNH	string	Não	Tipo da CNH caso informado.	Quando for PF (CPF).
12	DataValidadeCNH	DateTime (YYYY-MM-DD)	Não	Data de Validade da CNG caso informado.	Quando for PF (CPF). Exemplo: (2018-08-20T10:05:33)
13	Sexo	string	Sim	Sexo 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
14	Naturalidade	string	Não	Naturalidade em caso de CPF	Quando for PF (CPF).
15	Nacionalidade	string	Não	Nacionalidade em caso de CPF	Quando for PF (CPF).
16	InscricaoEstadual	string	Não	Inscrição Estadual da Transportadora	Caso exista
17	InscricaoMunicipal	string	Não	Inscrição Municipal da Transportadora	Caso exista
18	NomeFantasia	string (20)	Não	Nome Fantasia da Transportadora	Quando for PJ (CNPJ).
19	DataInscricao	DateTime (YYYY-MM-DD)	Sim	Caso 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)
20	IdDmAtividadeEconomica	int	Não	Atividade Econômica da Transportadora.
21	Endereco	string	Sim	Endereço da Transportadora	N/A
22	NumeroEndereco	int	Sim	Número do Logradouro da Transportadora	N/A
23	EnderecoComplemento	string	Sim	Complemento Endereço da Transportadora	N/A
24	Bairro	string	Sim	Bairro da Transportadora	N/A
25	CEP	string	Sim	CEP da Transportadora	N/A
26	CodigoIBGEMunicipio	int	Sim	Código IBGE do endereço do Transportador	N/A
27	IdentificadorEndereco	string	Sim	Nome de identificação do endereço do Transportador	N/A
28	TelefoneFixo	long	Sim	Telefone fixo do Transportador	Exemplo: DD + 8N 2135005192 Obs: Os telefones não podem ser iguais em nenhum campo de telefone
29	TelefoneCelular	long	Sim	Telefone celular do Transportador	Exemplo: DD + 8N \|\| 9N 2186819085 21986819085 Obs: Os telefones não podem ser iguais em nenhum campo de telefone
30	EstadoCivil	int	Sim	Estado 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
31	Email	string	Não	Email de contato do Transportador	Exemplo: gabriel.monteiro@targetmp.com.br
32	Usuario	string	Nã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.
33	CodigoBanco	string	Não	Código do Banco do Transportador.	Deve possuir 3 dígitos.
34	CodigoAgencia	string	Não	Agência do Transportador	N/A
35	DigitoAgencia	string	Não	Digito Agência do Transportador	N/A
36	ContaCorrente	string	Não	Conta Corrente do Transportador	N/A
37	DigitoContaCorrente	string	Não	Digito Conta Corrente do Transportador	N/A
38	FlagContaPoupanca	bool(true \|\| false)	Não	Flag para indicar se a conta do Transportador é poupança.	N/A
39	VariacaoContaPoupanca	string	Não	Variação da conta poupança do Transportador	N/A
40	NomeContato	string	Sim	.Nome do Contato	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
41	CargoContato	string	Sim	Cargo 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
42	CPFCNPJContato	string	Sim	CPF ou CNPJ 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
43	TelefoneFixoContato	long	Não	Telefone 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
44	TelefoneCelularContato	long	Não	Telefone 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
45	EmailContato	string	Sim	E-mail 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
46	DataNascimentoContato	DateTime (YYYY-MM-DD)	Não	Data 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)
47	RGContato	string	Sim	RG 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
48	OrgaoEmissorRgContato	string	Sim	Órgão Expedidor do RG 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
49	PisPasep	string	Não	O 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

Nº	Campo	Tipo	Obrigatório	Descrição	Observação
TransportadorResponse
1	Erro	ErroResponse - string	Não	Retorna a mensagem de Erro.	NULO em caso de sucesso.
2	CPFCNPJ	string	Sim	Retorna CPF ou CNPJ do Transportador.	N/A
3	DataAtualizacao	DateTime (YYYY-MM-DD)	Não	Retorna a Data da Atualização.	Exemplo: (2018-08-20T10:05:33)
4	DataRegistro	DateTime (YYYY-MM-DD)	Sim	Retorna a Data do Registro.	Exemplo: (2018-08-20T10:05:33)
5	IdCliente	int	Sim	Retorna o Id do Cliente.	N/A
6	IdDmTipoPessoa	int	Sim	Retorna o Tipo de Pessoa.	N/A
7	IdDmTipoTransportador	int	Sim	Retorna o Tipo de Transportador.	N/A
8	NomeRazaoSocial	string	Não	Retorna Nome Razão Social.	N/A
9	RNTRC	string	Sim	Retorna 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>