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

# Configuração

> Como acessar o FUEL, configurar ambientes e preparar menus de teste.

## Autenticação

Faça login com suas credenciais de conta do FUEL na URL do FUEL fornecida pela sua equipe. O FUEL usa seu próprio banco de dados de usuários gerenciado por um superadmin — entre em contato com seu admin se precisar de uma conta.

## Selecionando um contexto de operação

Antes de usar qualquer aba, você precisa selecionar um contexto de operação completo na barra lateral esquerda:

<Steps>
  <Step title="Selecione um ambiente">
    Um ambiente mapeia para uma implantação específica do FIRE (ex.: homologação Brasil, produção Equador). Cada ambiente tem sua própria URL base e chaves de API.
  </Step>

  <Step title="Selecione uma conta">
    A conta dentro desse ambiente (corresponde a uma rede de restaurantes ou grupo de marcas).
  </Step>

  <Step title="Selecione um país">
    O país de operação. Determina as regras fiscais, moeda, processadores de pagamento e canais disponíveis.
  </Step>

  <Step title="Selecione um vendor">
    O vendor (marca) dentro da conta. Cada vendor tem sua própria chave de API configurada no ambiente.
  </Step>

  <Step title="Selecione uma loja">
    A localização específica da loja. Carrega os canais disponíveis para essa loja.
  </Step>
</Steps>

Quando todos os cinco estiverem selecionados, as abas ficam ativas e todas as requisições são vinculadas a esse contexto.

## Ambientes

Os ambientes são configurados por um superadmin. Cada ambiente armazena:

| Configuração         | Descrição                                                                                            |
| -------------------- | ---------------------------------------------------------------------------------------------------- |
| **Rótulo**           | Nome legível (ex.: "Homologação BR", "Produção EC")                                                  |
| **URL base do FIRE** | O endpoint da API do FIRE para esse ambiente                                                         |
| **Chaves de API**    | Uma chave de API criptografada por vendor ID — usada para todas as requisições de pedidos e webhooks |

<Note>
  As chaves de API são armazenadas criptografadas. Superadmins as gerenciam pelo painel **Admin → Utils** (o botão de ação flutuante no canto inferior direito, visível apenas para superadmins).
</Note>

## Menus de teste

As abas **Pedido individual** e **Lote** exigem um **menu de teste** — um catálogo de produtos predefinido criado por um admin para um ambiente e vendor específicos. Um menu de teste define:

* Produtos disponíveis com preços e grupos de modificadores
* Canais de venda (POS, KIOSK, APP, AGGREGATOR)
* Processadores de pagamento

Se nenhum menu de teste aparecer no dropdown, peça a um superadmin para criar um em **Admin → Menus de Teste**.

## Painel admin (somente superadmin)

Superadmins têm acesso a um painel admin flutuante (o botão no canto inferior direito):

| Seção                | O que faz                                                                            |
| -------------------- | ------------------------------------------------------------------------------------ |
| **Ambientes**        | Criar/editar ambientes, definir URL base do FIRE, gerenciar chaves de API por vendor |
| **Usuários**         | Convidar e gerenciar usuários do FUEL, restringir acesso por ambiente                |
| **Menus de Teste**   | Criar e publicar catálogos de produtos para qualquer ambiente/vendor                 |
| **Dados de exemplo** | Sincronizar amostras de pedidos do FIRE                                              |