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

# Entenda o merchant e o catálogo

> Conheça a entidade que representa sua loja, seu status e seu catálogo na Onbeef.

O merchant representa sua loja na Onbeef. Ele reúne disponibilidade, categorias e produtos.

## Estrutura principal

| Campo        | O que representa                       |
| ------------ | -------------------------------------- |
| `id`         | Identificador único da loja.           |
| `status`     | Disponibilidade da loja.               |
| `lastUpdate` | Data da última atualização.            |
| `TTL`        | Tempo de cache dos dados, em segundos. |
| `categories` | Categorias exibidas no catálogo.       |
| `products`   | Produtos disponíveis na loja.          |

Consulte a estrutura completa em [`GET /v1/merchant`](/api-reference/merchant/get-merchant).

## Disponibilidade

<CardGroup cols={2}>
  <Card title="AVAILABLE" icon="circle-check">
    A loja está disponível para receber pedidos.
  </Card>

  <Card title="UNAVAILABLE" icon="circle-xmark">
    A loja está fechada ou pausada.
  </Card>
</CardGroup>

Categorias organizam a vitrine e controlam a ordem de exibição. Produtos armazenam nome, preço, unidade, imagens e disponibilidade.

As categorias referenciam os produtos por ID. O mesmo produto pode aparecer em mais de uma categoria.

## Fluxo de atualização

<Steps>
  <Step title="Registre a integração">
    Use `PUT /v1/merchantOnboarding` para informar as URLs da sua integração.
  </Step>

  <Step title="Envie o catálogo">
    Use `PUT /v1/merchantUpdate` para sincronizar categorias, produtos e ofertas.
  </Step>

  <Step title="Consulte o processamento">
    Use `GET /v1/merchantStatus` para verificar o resultado da sincronização.
  </Step>
</Steps>

<Card title="Sincronizar o catálogo" icon="arrow-rotate-right" href="/guides/catalog-sync">
  Siga o fluxo completo de publicação e atualização.
</Card>