Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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.

...

                                                                                      TransportadorRequest
CampoTipoObrigatórioDescriçãoObservação
1InstrucaointSimInstrução do que se fazer com os dados.1= Inserir ou Atualizar
2= Inserir se não existe
2RNTRCstringSimNúmero de RNTRC do TransportadorN/A
3CPFCNPJstringSimCPF ou CNPJ do TransportadorN/A
4NomestringSimEm caso de CPF, nome.

Quando for PF (CPF).


Favor informar apenas o primeiro nome.

5SobrenomestringNãoEm caso de CPF, sobrenome.Quando for PF (CPF) informação torna-se obrigatoria.
6RazãoSocialstring(45)NãoEm caso de CNPJ, Razão Social.Quando for PJ (CNPJ).
7DataNascimento

DateTime(YYYY-MM-DD)

SimData de Nascimento ou de Criação

Quando for PF (CPF).


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

8RGstringNãoEm caso de CPF, RG.Quando for PF (CPF).
9OrgaoEmissorRgstringNãoCaso RG preenchido, informar Órgão Expedidor.Quando for PF (CPF).
10CNHstringNãoCNH em caso de CPFQuando for PF (CPF).
11TipoCNHstringNãoTipo da CNH caso informado.Quando for PF (CPF).
12DataValidadeCNHDateTime (YYYY-MM-DD)NãoData de Validade da CNG caso informado.

Quando for PF (CPF).


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

13SexostringSimSexo 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

14NaturalidadestringNãoNaturalidade em caso de CPFQuando for PF (CPF).
15NacionalidadestringNãoNacionalidade em caso de CPFQuando for PF (CPF).
16InscricaoEstadualstringNãoInscrição Estadual da TransportadoraCaso exista
17InscricaoMunicipalstringNãoInscrição Municipal da TransportadoraCaso exista
18NomeFantasiastring (20)NãoNome Fantasia da TransportadoraQuando for PJ (CNPJ).
19DataInscricaoDateTime (YYYY-MM-DD)SimCaso 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)

20IdDmAtividadeEconomicaintNãoAtividade Econômica da Transportadora.
View file
nameIdDmAtividadeEconomica.xlsx
height150
21EnderecostringSimEndereço da TransportadoraN/A
22NumeroEnderecointSimNúmero do Logradouro da TransportadoraN/A
23EnderecoComplementostringSimComplemento Endereço da TransportadoraN/A
24BairrostringSimBairro da TransportadoraN/A
25CEPstringSimCEP da TransportadoraN/A
26CodigoIBGEMunicipiointSimCódigo IBGE do endereço do TransportadorN/A
27IdentificadorEnderecostringSimNome de identificação do endereço do TransportadorN/A
28TelefoneFixolongSimTelefone fixo do Transportador

Exemplo:

DD + 8N
2135005192

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

29TelefoneCelularlongSimTelefone celular do Transportador

Exemplo:





DD + 8N || 9N





2186819085





21986819085

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

30EstadoCivilintSimEstado 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

31EmailstringSimNãoEmail de contato do TransportadorExemplo:





gabriel.monteiro@targetmp.com.br
32UsuariostringNã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.

33CodigoBancostringNãoCódigo do Banco do Transportador.Deve possuir 3 dígitos. 
34CodigoAgenciastringNãoAgência do TransportadorN/A
35DigitoAgenciastringNãoDigito Agência do TransportadorN/A
36ContaCorrentestringNãoConta Corrente do TransportadorN/A
37DigitoContaCorrentestringNãoDigito Conta Corrente do TransportadorN/A
38FlagContaPoupanca

bool(true || false)

NãoFlag para indicar se a conta do Transportador é poupança.N/A
39VariacaoContaPoupancastringNãoVariação da conta poupança do TransportadorN/A
40NomeContatostringSim.Nome do ContatoDados 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
41CargoContatostringSimCargo 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
42CPFCNPJContatostringSimCPF ou CNPJ do Contato do TransportadorDados 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
43TelefoneFixoContatolongNãoTelefone 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

44TelefoneCelularContatolongNãoTelefone 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

45EmailContatostringSimE-mail do Contato do TransportadorDados 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
46DataNascimentoContatoDateTime (YYYY-MM-DD)NãoData 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)

47RGContatostringSimRG do Contato do TransportadorDados 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
48OrgaoEmissorRgContatostringSimÓrgão Expedidor do RG do Contato do TransportadorDados 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
49PisPasepstringNãoO 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

TransportadorResponse
CampoTipoObrigatórioDescriçãoObservação
1ErroErroResponse - stringNãoRetorna a mensagem de Erro.NULO em caso de sucesso.
2CPFCNPJstringSimRetorna CPF ou CNPJ do Transportador.N/A
3DataAtualizacaoDateTime (YYYY-MM-DD)NãoRetorna a Data da Atualização.Exemplo: (2018-08-20T10:05:33)
4DataRegistroDateTime (YYYY-MM-DD)SimRetorna a Data do Registro.Exemplo: (2018-08-20T10:05:33)
5IdClienteintSimRetorna o Id do Cliente.N/A
6IdDmTipoPessoaintSimRetorna o Tipo de Pessoa.N/A
7IdDmTipoTransportadorintSimRetorna o Tipo de Transportador.N/A
8NomeRazaoSocialstringNãoRetorna Nome Razão Social.N/A
9RNTRCstringSimRetorna o RNTRC.N/A

...