Endpoint
Parâmetros
| Parâmetro | Tipo | Ocorrência | Descrição |
|---|---|---|---|
| token | string | obrigatório | Chave gerada para identificar sua empresa |
| id | int | obrigatório | Número de identificação do contato na Olist |
| formato | string | obrigatório | Formato do retorno. Use json |
Retorno
| Campo | Tipo | Tamanho | Ocorrência | Descrição |
|---|---|---|---|---|
| retorno.status_processamento | int | - | obrigatório | Código de status do processamento |
| retorno.status | string | - | obrigatório | ”OK” ou “Erro” |
| retorno.codigo_erro | int | - | condicional | Código do erro conforme tabela da API (1) |
| retorno.erros | array | - | condicional | Lista de erros ocorridos (1) |
| retorno.erros[].erro | string | - | condicional | Descrição do erro |
| retorno.contato | object | - | condicional | Dados completos do contato (2) |
| contato.id | int | - | condicional | Identificação do contato na Olist |
| contato.codigo | string | 30 | condicional | Código do contato |
| contato.nome | string | 50 | condicional | Nome ou razão social |
| contato.fantasia | string | 60 | condicional | Nome fantasia |
| contato.tipo_pessoa | string | 1 | condicional | F (Física), J (Jurídica), E (Estrangeiro) |
| contato.cpf_cnpj | string | 18 | condicional | CPF ou CNPJ |
| contato.ie | string | 18 | condicional | Inscrição estadual |
| contato.rg | string | 10 | condicional | RG |
| contato.im | string | 18 | condicional | Inscrição municipal |
| contato.endereco | string | 50 | condicional | Logradouro |
| contato.numero | string | 10 | condicional | Número do endereço |
| contato.complemento | string | 50 | condicional | Complemento |
| contato.bairro | string | 30 | condicional | Bairro |
| contato.cep | string | 10 | condicional | CEP |
| contato.cidade | string | 30 | condicional | Cidade |
| contato.uf | string | 30 | condicional | UF |
| contato.pais | string | 50 | condicional | País |
| contato.endereco_cobranca | string | 50 | condicional | Endereço de cobrança |
| contato.numero_cobranca | string | 10 | condicional | Número endereço cobrança |
| contato.complemento_cobranca | string | 50 | condicional | Complemento endereço cobrança |
| contato.bairro_cobranca | string | 30 | condicional | Bairro de cobrança |
| contato.cep_cobranca | string | 10 | condicional | CEP de cobrança |
| contato.cidade_cobranca | string | 30 | condicional | Cidade de cobrança |
| contato.uf_cobranca | string | 30 | condicional | UF de cobrança |
| contato.contatos | string | 100 | condicional | Pessoas de contato |
| contato.fone | string | 40 | condicional | Telefone |
| contato.fax | string | 40 | condicional | Fax |
| contato.celular | string | 40 | condicional | Telefone celular |
| contato.email | string | 50 | condicional | |
| contato.email_nfe | string | 50 | condicional | E-mail para NFe |
| contato.site | string | 40 | condicional | Website |
| contato.crt | string | 1 | condicional | Código de regime tributário |
| contato.estadoCivil | int | - | condicional | Código do estado civil |
| contato.profissao | string | 50 | condicional | Profissão |
| contato.sexo | string | 10 | condicional | ”masculino” ou “feminino” |
| contato.data_nascimento | string | 10 | condicional | Data de nascimento (dd/mm/aaaa) |
| contato.naturalidade | string | 40 | condicional | Naturalidade |
| contato.nome_pai | string | 100 | condicional | Nome do pai |
| contato.cpf_pai | string | 18 | condicional | CPF do pai |
| contato.nome_mae | string | 100 | condicional | Nome da mãe |
| contato.cpf_mae | string | 18 | condicional | CPF da mãe |
| contato.limite_credito | decimal | - | condicional | Limite de crédito |
| contato.situacao | string | 1 | condicional | A (Ativo), E (Excluído), I (Inativo), S (Sem movimento) |
| contato.obs | string | 200 | condicional | Observações gerais |
| contato.id_lista_preco | int | - | condicional | ID da lista de preço |
| contato.id_vendedor | int | - | condicional | ID do vendedor associado |
| contato.nome_vendedor | string | 50 | condicional | Nome do vendedor associado |
| contato.data_criacao | string | 19 | condicional | Data de criação (dd/mm/aaaa hh:mm:ss) |
| contato.data_atualizacao | string | 19 | obrigatório | Data da última atualização (dd/mm/aaaa hh:mm:ss) |
| contato.tipos_contato | array | - | condicional | Lista de tipos do contato |
| tipos_contato[].tipo | string | - | condicional | Tipo do contato (Cliente, Fornecedor, etc.) |
| contato.pessoas_contato | array | - | condicional | Lista de pessoas de contato |
(1) Retornado quando status = “Erro” (2) Retornado quando status = “OK”
Exemplo de chamada
Exemplo de retorno
Sucesso
Erro - Token inválido
Erro - Contato não encontrado
Observações
- O ID do contato pode ser obtido através do endpoint de pesquisa de contatos
- Campos de pessoa física (estado civil, profissão, etc.) são retornados apenas para contatos do tipo “F”
- Consulte a tabela de códigos de erro para interpretação dos erros
