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

# Credenciais de Mktplace (Apps)

> Como criar as aplicações OAuth no Mercado Livre e Shopee para o OmniDom.

Para que o módulo de integrações funcione, a equipe de desenvolvimento (Proprietária da Infraestrutura) deve criar os "Aplicativos" oficiais nos painéis de desenvolvedor dos Marketplaces. É isso que fornecerá o `CLIENT_ID` e o `CLIENT_SECRET` a serem injetados nas variáveis de ambiente do Backend.

***

## 1. Mercado Livre Developers

Você precisará de uma conta no Mercado Livre habilitada como **Developer**.

<Steps>
  <Step title="Acessar o Painel">
    Acesse [Mercado Livre Developers](https://developers.mercadolivre.com.br/devcenter) e faça login.
  </Step>

  <Step title="Criar Nova Aplicação">
    Clique em **Criar Aplicação**.

    * **Nome:** OmniDom Hub (ou outro de sua preferência).
    * **Descrição:** Hub de integração de Vendas e Estoque.
    * **URL da Aplicação (URI de redirecionamento):** OBRIGATÓRIO! Deve ser a URL da sua API de produção acrescida do caminho do callback. Exemplo: `https://sua-api.up.railway.app/integrations/oauth/meli/callback`.
  </Step>

  <Step title="Permissões">
    Solicite todos os Escopos (Scopes) de permissão necessários: Leitura de dados offline, Publicação de produtos, Mensageria, Gestão de Pedidos.
  </Step>

  <Step title="Webhooks (Tópicos de Notificação)">
    O ML envia notificações em tempo real. Você deve configurar a Callback URL para notificações:
    `https://sua-api.up.railway.app/integrations/webhooks/meli`
    Marque os tópicos exigidos (ex: `orders`, `items`, `questions`, `payments`).
  </Step>

  <Step title="Injetar no .env">
    Após criar, o painel mostrará o **App ID** e o **Client Secret**. Copie-os as coloque nas variáveis do railway (`MELI_APP_ID`, `MELI_SECRET`).
  </Step>
</Steps>

***

## 2. Shopee Open Platform

A Shopee possui um processo ligeiramente diferente: exigem verificação da conta do desenvolvedor.

<Steps>
  <Step title="Acesse a Open Platform">
    Vá para a [Shopee Open Platform](https://open.shopee.com/) e crie sua conta de Partner/Developer.
  </Step>

  <Step title="Crie um App (Console)">
    No Developer Console, crie um App do Tipo **Seller In-house App** (se for para uso da sua própria conta) ou **Third-Party App** (se você for revender como SaaS multi-tenant a terceiros).
  </Step>

  <Step title="Configurar URLs">
    * **App Callback URL:** `https://sua-api.up.railway.app/integrations/oauth/shopee/callback`
    * **Push Mechanism URL (Webhooks):** `https://sua-api.up.railway.app/integrations/webhooks/shopee`
  </Step>

  <Step title="Permissões">
    Adicione as permissões (Order Management, Product, Logistics, Returns).
  </Step>

  <Step title="Injetar no .env">
    Copie o **Partner ID** e a **Partner Key**. Coloque-os na sua instância Railway correspondente (`SHOPEE_PARTNER_ID`, `SHOPEE_SECRET_KEY`).
  </Step>
</Steps>

<Warning>
  **Segurança dos Tokens:** Nunca compartilhe os "Secrets" da Shopee ou do Mercado Livre no código do frontend (Next.js). Eles devem existir exclusivamente em backend seguro (na Vercel não, apenas na Railway!).
</Warning>