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

# Meta Commerce

> Formato CSV do feed de catálogo Meta/Facebook e mapeamento de campos.

## Visão Geral

O feed Meta retorna um arquivo CSV compatível com a importação de catálogo do Meta Commerce Manager. Use-o para sincronizar seu catálogo Alana com Facebook Shops, Instagram Shopping e catálogos Meta Advantage+.

## URL do Feed

```
GET /api/v1/feeds/meta
```

Adicione esta URL no **Meta Commerce Manager → Catálogo → Fontes de dados → Feed agendado**.

## Formato CSV

```csv theme={null}
id,title,description,availability,condition,price,link,image_link,brand,google_product_category
SKU-001,Camiseta de Algodão Azul,"100% algodão, pré-encolhido",in stock,new,29.99 BRL,https://sualoja.com.br/p/camiseta-azul,https://cdn.sualoja.com.br/camiseta-azul.jpg,SuaMarca,212
SKU-002,Tênis Vermelho,Tênis de corrida com amortecimento,in stock,new,199.90 BRL,https://sualoja.com.br/p/tenis-vermelho,https://cdn.sualoja.com.br/tenis-vermelho.jpg,SuaMarca,187
```

## Campos Obrigatórios

| Campo          | Descrição                                                     |
| -------------- | ------------------------------------------------------------- |
| `id`           | Identificador único do produto                                |
| `title`        | Nome do produto                                               |
| `description`  | Descrição do produto                                          |
| `availability` | `in stock`, `out of stock`, `preorder`, `available for order` |
| `condition`    | `new`, `used`, `refurbished`                                  |
| `price`        | Preço com moeda (ex: `29.99 BRL`)                             |
| `link`         | URL da página do produto                                      |
| `image_link`   | URL da imagem do produto                                      |
| `brand`        | Nome da marca                                                 |

## Solicitando o Feed

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://app.alana.shopping/api/v1/feeds/meta" \
    -H "X-API-Key: sk_live_sua_chave_api" \
    -o catalogo-meta.csv
  ```

  ```javascript JavaScript theme={null}
  const res = await fetch(
    "https://app.alana.shopping/api/v1/feeds/meta",
    { headers: { "X-API-Key": "sk_live_sua_chave_api" } }
  );
  const csv = await res.text();
  ```

  ```python Python theme={null}
  import requests

  res = requests.get(
      "https://app.alana.shopping/api/v1/feeds/meta",
      headers={"X-API-Key": "sk_live_sua_chave_api"},
  )
  with open("catalogo-meta.csv", "w", encoding="utf-8") as f:
      f.write(res.text)
  ```
</CodeGroup>

## Mapeamento de Campos

O Alana mapeia automaticamente seus dados de produto para os campos exigidos pela Meta:

| Campo Alana     | Campo Meta     | Observações                                     |
| --------------- | -------------- | ----------------------------------------------- |
| `sku`           | `id`           |                                                 |
| `name`          | `title`        | Truncado em 150 chars                           |
| `description`   | `description`  | Truncado em 9999 chars                          |
| `stock_status`  | `availability` | Mapeado para valores Meta                       |
| `price`         | `price`        | Moeda adicionada das configurações do workspace |
| `images[0].url` | `image_link`   | Primeira imagem usada                           |
| `brand.name`    | `brand`        |                                                 |

## Variantes

Para produtos com variantes (tamanho, cor), o Alana gera uma linha por variante com `item_group_id` definido como o SKU do produto pai, permitindo que a Meta agrupe corretamente no catálogo.