# Cadastrar produto local do catálogo

`POST /business/catalog/product`

Pasta: **Business**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Cadastrar produto local do catálogo

Cria um produto no banco local da API (shop/catalog GoZap) para uso em envios (`POST /send/product`). Não cria o produto no catálogo remoto do WhatsApp.

## Endpoint

`POST {{baseUrl}}/business/catalog/product`

## Autenticação

Envie o token da instância no header `token: {{token}}`.

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `product_id` | string | Sim | ID do produto. |
| `title` | string | Sim | Título. |
| `description` | string | Não | Descrição. |
| `currency_code` | string | Não | Moeda (ex.: `BRL`). |
| `price_amount_1000` | number | Não | Preço × 1000 (ex.: R$ 99,00 → `99000`). |
| `retailer_id` | string | Não | SKU / ID do varejista. |
| `url` | string | Não | URL do produto. |
| `image_url` | string | Não | URL da imagem. |
| `image_count` | number | Não | Quantidade de imagens. |
| `business_owner_jid` | string | Não | JID do dono do negócio. |

## Exemplo de Requisição

```bash
curl --request POST '{{baseUrl}}/business/catalog/product' \
  --header 'token: {{token}}' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "product_id": "sku-fone-001",
  "title": "Fone Bluetooth",
  "description": "Fone sem fio com estojo",
  "currency_code": "BRL",
  "price_amount_1000": 99000,
  "retailer_id": "SKU-FONE-001",
  "url": "https://loja.exemplo.com/fone",
  "image_url": "https://loja.exemplo.com/fone.jpg",
  "image_count": 1,
  "business_owner_jid": "5511999999999@s.whatsapp.net"
}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "product": {
    "product_id": "sku-fone-001",
    "title": "Fone Bluetooth",
    "currency_code": "BRL",
    "price_amount_1000": 99000,
    "active": true
  }
}
```

## Erros comuns

- `401 Unauthorized`: o header `token` não foi enviado ou é inválido.
- `400 Bad Request`: JSON inválido ou campo obrigatório ausente.
- `500 Internal Server Error`: instância desconectada ou a operação falhou no WhatsApp.
- `400 Bad Request`: `product_id` ou `title` ausente.

## Observações

Armazenamento local na API. Para catálogo WhatsApp use as rotas `business/catalog/list|info|delete|show|hide`.

## Corpo (exemplo)

```json
{
  "product_id": "sku-fone-001",
  "title": "Fone Bluetooth",
  "description": "Fone sem fio com estojo",
  "currency_code": "BRL",
  "price_amount_1000": 99000,
  "retailer_id": "SKU-FONE-001",
  "url": "https://loja.exemplo.com/fone",
  "image_url": "https://loja.exemplo.com/fone.jpg",
  "image_count": 1,
  "business_owner_jid": "5511999999999@s.whatsapp.net"
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/business/catalog/product" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "product_id": "sku-fone-001",
  "title": "Fone Bluetooth",
  "description": "Fone sem fio com estojo",
  "currency_code": "BRL",
  "price_amount_1000": 99000,
  "retailer_id": "SKU-FONE-001",
  "url": "https://loja.exemplo.com/fone",
  "image_url": "https://loja.exemplo.com/fone.jpg",
  "image_count": 1,
  "business_owner_jid": "5511999999999@s.whatsapp.net"
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=business/cadastrar-produto-local-do-catalogo)