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.

Info

title	Observações

Observações Importantes

Request

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.

Info

title	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

Numero

Número de RNTRC do Transportador	N/A
3	CPFCNPJ	string	Sim	CPF ou CNPJ do Transportador	N/A
4	Nome

stringSimN/A

string

Sim

Em caso de CPF, nome.

Quando for PF (CPF).

Favor informar apenas o primeiro nome.

5

Sobrenome

string

Não

N/A

	Em caso de CPF, sobrenome.	Quando for PF (CPF) informação torna-se obrigatoria.
6	RazãoSocial	string(45)	Não

N/A7DataNascimento

DateTime(YYYY-MM-DD)

SimN/A

Em caso de CNPJ, Razão Social.

Se torna obrigatorio 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

N/A

	Em caso de CPF, RG.	Quando for PF (CPF).
9	OrgaoEmissorRg	string	Não

N/A

	Caso RG preenchido, informar Órgão Expedidor.	Quando for PF (CPF).
10	CNH	string	Não

N/A

	CNH em caso de CPF	Quando for PF (CPF).
11	TipoCNH	string	Não

N/A

	Tipo da CNH caso informado.	Quando for PF (CPF).
12	DataValidadeCNH	DateTime (YYYY-MM-DD)	Não

N/A13SexostringSim

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

N/A

	Naturalidade em caso de CPF	Quando for PF (CPF).
15	Nacionalidade	string	Não

N/A

	Nacionalidade em caso de CPF	Quando for PF (CPF).
16	InscricaoEstadual	string	Não

N/A

	Inscrição Estadual da Transportadora	Caso exista, quando for PJ
17	InscricaoMunicipal	string	Não

N/A

	Inscrição Municipal da Transportadora	Caso exista, quando for PJ
18	NomeFantasia	string (20)	Não

Quando

	Nome Fantasia da Transportadora	Obrigatorio quando for PJ (CNPJ).
19	DataInscricao	DateTime (YYYY-MM-DD)

Não

Sim

Caso possua Inscrição.

Data de Inscrição

.N/A

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.

View file

name	IdDmAtividadeEconomica.xlsx
height	150

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

NãoN/A

Sim

Telefone fixo do Transportador

Exemplo:

DD + 8N
2135005192

Obs: Os telefones não podem ser iguais em nenhum campo de telefone

29

TelefoneCelular

longNãoN/A

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

Não

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

SimN/A

	Não	Email de contato do Transportador.	Exemplo: gabriel.monteiro@targetmp.com.br
32	Usuario

stringNãoN/A

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

N/A

	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

stringNão

	string	Não	Variação da conta poupança do Transportador	N/A
40	NomeContato	string	Sim

N/A

	.Nome do Contato	Dados de contato devem sempre ser informados,obrigatoriamente quando um CNPJ estiver sendo cadastrado.
41	CargoContato	string	Sim

N/A

	Cargo do Contato Transportador.	Dados de contato devem sempre ser informados,obrigatoriamente quando um CNPJ estiver sendo cadastrado.
42	CPFCNPJContato	string	Sim

N/A

	CPF ou CNPJ do Contato do Transportador	Dados de contato devem sempre ser informados,obrigatoriamente quando um CNPJ estiver sendo cadastrado.
43	TelefoneFixoContato	long	Não

N/A44TelefoneCelularContatolongNãoN/A

Telefone Fixo do Contato do Transportador

Dados de contato devem sempre ser informados,obrigatoriamente quando um CNPJ estiver sendo cadastrado.

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.

Obs: Os telefones não podem ser iguais em nenhum campo de telefone

45

EmailContato

string

Sim

N/A46DataNascimentoContatoDateTime (YYYY-MM-DD)NãoN/A

E-mail do Contato do Transportador

Dados de contato devem sempre ser informados,obrigatoriamente quando um CNPJ estiver sendo cadastrado.

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.

Exemplo: (2018-08-20T10:05:33)

47

RGContato

string

Sim

N/A48OrgaoEmissorRgContatostringSim

	RG do Contato do Transportador	Dados de contato devem sempre ser informados,obrigatoriamente quando um CNPJ estiver sendo cadastrado.
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.
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.N/A	Exemplo: (2018-08-20T10:05:33)
4	DataRegistro	DateTime (YYYY-MM-DD)	Sim	Retorna a Data do Registro.N/A	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

...

Version	Old Version 12	New Version Current
Changes made by	Gabriel Nisã Brandão Casaes Monteiro (Unlicensed)	vitor.costa (Unlicensed)
Saved on	Aug 23, 2018	Jun 27, 2024

Versions Compared

Key

Objetivo

Request

Request

Response

Page Comparison

Versions Compared

Key

Request

Request

Response