Skip to main content

Endpoint

Descrição

Este serviço permite criar uma nova conta de usuário no Olist ERP de forma programática. Ideal para parceiros que desejam automatizar o onboarding de novos clientes.

Parâmetros

(1) Este endpoint requer um token especial de parceiro. Solicite através do suporte comercial. (2) Estrutura XML detalhada abaixo.

Estrutura XML dos Dados

Campos da Empresa

Campos do Responsável

Campos de Configurações

(1) Regimes tributários: 1=Simples Nacional, 2=Simples Nacional Excesso, 3=Regime Normal

Retorno

Observações

  • Este serviço está disponível apenas para parceiros autorizados
  • Cada conta criada inicia com período de teste de 14 dias
  • O e-mail do responsável será usado como login
  • Uma senha temporária é gerada e enviada por e-mail
  • O CNPJ deve ser válido e não pode estar cadastrado anteriormente
  • O token retornado já pode ser usado para chamadas à API

Exemplo de chamada

Exemplos de retorno

Erro - Token de parceiro inválido

Erro - CNPJ já cadastrado

Erro - Dados inválidos

Sucesso

Fluxo Pós-Cadastro

Após criar a conta com sucesso:
  1. E-mail de Boas-vindas: O usuário recebe e-mail com instruções
  2. Senha Temporária: Enviada no retorno e por e-mail
  3. Primeiro Acesso: Usuário deve alterar a senha no primeiro login
  4. Configuração Inicial: Wizard guia pelas configurações básicas
  5. Período de Teste: 14 dias para testar todas as funcionalidades

Exemplo de Integração Completa

PHP

Validações Realizadas

O sistema valida automaticamente:
  • CNPJ: Formato e dígitos verificadores
  • CPF: Formato e dígitos verificadores
  • E-mail: Formato válido e unicidade
  • CEP: Formato válido
  • Telefone: Formato brasileiro válido
  • Dados obrigatórios: Presença de todos os campos requeridos

Segmentos Disponíveis

  • Vestuário e Moda
  • Eletrônicos
  • Alimentos e Bebidas
  • Livros e Papelaria
  • Casa e Decoração
  • Esportes e Lazer
  • Saúde e Beleza
  • Informática
  • Telefonia
  • Outros

Planos Disponíveis

  • básico: Até 100 pedidos/mês
  • profissional: Até 500 pedidos/mês
  • empresarial: Ilimitado

Requisitos para Parceiros

Para se tornar um parceiro autorizado e ter acesso a este endpoint:
  1. Cadastro como parceiro no programa de parcerias
  2. Aprovação da equipe comercial
  3. Assinatura de contrato de parceria
  4. Recebimento do token especial de parceiro
Entre em contato com comercial@olist.com para mais informações.