> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.erp.olist.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Homologação de Parceiros de Tecnologia

> Informações Gerais de Homologação de Soluções

# 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](https://docs.google.com/forms/d/e/1FAIpQLSeoW7vzw6Py2RJJgLHqDoCFLnMW2rWWYN6gVWV_i2MRzvl6cg/viewform)
* **Agendamento Reunião:** Agenda o melhor dia e hora para a homologação, neste link: [Agendamento Reunião](https://script.google.com/macros/s/AKfycbxq_3RLvYl_kF7jkT2KpHh2toZoIO0nLfRM-s7MLmnYYhDMhRlZZpWVDhZHMDxPCFO-/exec)
* **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:

| Etapa                  | Ação                 | Descrição                                                                                                 |
| :--------------------- | :------------------- | :-------------------------------------------------------------------------------------------------------- |
| **1. Solicitante**     | Cadastro & Submissão | O parceiro solicita o início da homologação realizando em conjuntos os testes de aplicação e credenciais. |
| **2. Análise Técnica** | Validação de Rotas   | O time técnico executa os testes de carga, autenticação e validação dos cenários da API v3.               |
| **3. Certificação**    | Aprovação Final      | Com todos os testes validados, a aplicação recebe o selo de parceiro homologado.                          |

***

## 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)