Skip to main content

Parceiros Oficiais ERP da Olist

Esta documentação tem como objetivo orientar desenvolvedores e empresas parceiras no processo de integração e certificação de soluções junto à nossa plataforma (homologação).

O que é

  • A homologação da integração no ERP da Olist é realizada para garantir que a solução conectada esteja aderente à utilização da API.
  • Ela garante que o sistema atende às regras de negócio, funciona sem erros e está pronto para ser liberado aos usuários no ambiente de produção.

1. Informações Gerais e Requisitos

Para que a sua solução seja homologada com sucesso, é necessário cumprir os seguintes pré-requisitos fundamentais:

Requisitos Obrigatórios

  • Desenvolvimento Concluído: Todas as funcionalidades previstas para a integração devem estar implementadas e totalmente funcionais utilizando a conta de testes (plano Parceiros) concedida pelo ERP.
  • Identidade Visual: Aplicação das marcas e elementos visuais de acordo com o guia de estilo e diretrizes da plataforma, neste formulário: Identidade Visual - ERP da Olist
  • Agendamento Reunião: Agenda o melhor dia e hora para a homologação, neste link: Agendamento Reunião
  • Testes de Autenticação: Validação completa dos fluxos de autenticação (OAuth2), garantindo segurança e renovação correta de tokens.
  • Testes de Rotas (Endpoints): Cobertura e validação das chamadas das APIs, garantindo o tratamento adequado de erros e respostas em conformidade com as especificações.

2. Tipos de Aplicativos

Compreenda o funcionamento e a disponibilidade das modalidades de aplicativos na versão atual da nossa API (v3):

Aplicativo Privado

  • Disponibilidade Atual: No momento, apenas aplicativos privados estão disponíveis para a API v3.
  • Instalação Individual: O parceiro homologado na v3 pode utilizar normalmente a integração, porém cada seller precisará instalar um aplicativo em sua própria conta.
  • Gestão de Credenciais: A gestão das credenciais dos sellers (client_id e client_secret) deverá ser feita inicialmente e de forma independente pelo parceiro.

Aplicativo Público

  • Status: Em desenvolvimento (em breve teremos novidades!).
  • Visão Futura: Permitirá a distribuição centralizada da integração na nossa loja de aplicativos, simplificando a jornada de ativação para os sellers.

3. Manual Resumido de Homologação

O processo de homologação é composto por 4 etapas simples:

4. Contatos do Time Técnico

Se você tiver dúvidas, encontrar inconsistências durante a integração ou precisar agendar sua validação técnica, entre em contato com nosso time:
  • E-mail de Suporte Técnico: erp.partners@olist.com
  • Horário de Atendimento: Segunda a Sexta-feira, das 09h às 18h (Horário de Brasília)