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

# Produtos

> Listar, criar e editar produtos do projeto

## Listar produtos e ofertas

```
GET /product/list/product/checkout/{projectId}
```

Devolve `{"products": [...]}`. Cada produto traz os seus dados e a lista `offer`, com as ofertas dele. Use essa rota para descobrir os IDs dos produtos e das ofertas que já existem.

```bash curl theme={null}
curl https://bff.assiny.com.br/v1/public/product/list/product/checkout/SEU_PROJECT_ID \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "ProjectId: SEU_PROJECT_ID"
```

## Criar produto

```
POST /product
```

| Campo | Tipo | Descrição |
| - | - | - |
| `projectId` | UUID | **Obrigatório.** Projeto onde o produto será criado. |
| `name` | texto | **Obrigatório.** Nome interno do produto. |
| `nameDisplayed` | texto | **Obrigatório.** Nome mostrado ao comprador no checkout. |
| `class` | texto | **Obrigatório.** `DIGITAL` ou `PHYSICAL`. |
| `productCategoryId` | UUID | **Obrigatório.** Categoria do produto. Use um ID da tabela abaixo. |
| `supportEmail` | texto | **Obrigatório.** E-mail de suporte mostrado ao comprador. |
| `productorName` | texto | **Obrigatório.** Nome do produtor. |
| `description` | texto | Descrição do produto. |
| `productType` | texto | `PRODUCT` (padrão), `SERVICE` ou `SPLIT`. |
| `guarantee` | número | Garantia em dias: `7`, `15`, `30`, `60` ou `90`. |
| `productImage` | texto | URL da imagem do produto. |
| `phoneNumber` | texto | Telefone de suporte. |
| `language`, `currency` | texto | Idioma e moeda do checkout. Use os mesmos valores de um produto que já existe no projeto. |
| `isTermsEnabled`, `termsOfUse` | sim/não, texto | Exige que o comprador aceite os termos de uso informados. |
| `width`, `height`, `length`, `weight` | número | Medidas e peso, só para produto físico. |

```bash curl theme={null}
curl -X POST https://bff.assiny.com.br/v1/public/product \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "ProjectId: SEU_PROJECT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "SEU_PROJECT_ID",
    "name": "Curso de Fotografia",
    "nameDisplayed": "Curso de Fotografia Completo",
    "class": "DIGITAL",
    "productCategoryId": "9e36e78f-f0e3-42e4-8551-e18e8cecc5cf",
    "supportEmail": "suporte@suaempresa.com.br",
    "productorName": "Sua Empresa",
    "productType": "PRODUCT",
    "guarantee": 7
  }'
```

A resposta (`201`) traz o produto criado, com o `id` que você vai usar para [criar as ofertas](https://docs.assiny.com/api/ofertas.md).

## Criar vários produtos

```
POST /multiple-products
```

Mesmo corpo do **Criar produto**, dentro de uma lista: `[{...}, {...}]`. Cada item leva o próprio `projectId`.

## Editar produto

```
POST /product/{productId}
```

Mesmos campos do **Criar produto**, sem `projectId` — o projeto vai no cabeçalho.

> [!WARNING]
>
> Mande o produto **completo**, não só os campos alterados: comece pelos dados que a listagem devolve e troque o que precisar.

## Categorias

Valores aceitos em `productCategoryId`:

| Categoria | ID |
| - | - |
| Desenvolvimento Pessoal | `9e36e78f-f0e3-42e4-8551-e18e8cecc5cf` |
| Saúde e Bem-estar | `67374e68-ca1a-40fa-85d4-590a7ba16d66` |
| Renda Extra | `3611beb8-5c41-4b24-b857-97463d4bcc39` |
| Artes e Ofícios | `780590e5-9341-461c-9c00-66325ae7c70e` |
| Ensino de idiomas | `0b4ab084-3990-4c3f-b1ec-76122cf3c5ca` |
| Viagens e Lazer | `581dd56a-43c9-4a91-aff3-cd9c4430ed89` |
| Culinária e Gastronomia | `8f5a247e-2589-4388-ac5f-44e372eb5652` |
| Relacionamentos | `3d484fcf-0f4e-430c-b7e5-8b4668b59d35` |
| Finanças | `a283c3fc-8a5b-4cff-9c21-f230c314a5d3` |
| Midias Sociais | `08ecf47c-5468-499e-b2d7-cba13b1ba6ba` |
| E-commerce | `ede244ef-e49b-46cc-939a-3ae5a9262c4f` |
| Branding e Identidade | `a8c6674b-1fbf-4e4a-84d3-7f4d59b564ed` |
| Design de produto | `9c844d4c-6fe6-4fb9-8c50-d6fca043bdc3` |
| Marketing Digital | `4687b15f-c4c6-4d96-8346-1c7e2e88ff5b` |
| Automação e Ferramentas | `2edfa341-407d-402b-b446-0a97811ec1b5` |
| Aquisição e Ads | `6412fe3c-0901-4d4e-8de4-a0317620bc96` |
| Chatbots e IA | `8cd1e715-8fa2-44ba-8cb8-a9670d8384b7` |
| Web design e Desenvolvimento | `b7ca36bf-3fd1-4375-9112-f281c7b28d65` |
| Gestão de projetos | `ee9cb75a-210b-4cfa-9105-698b544e17c2` |
| Desenvolvimento de jogos | `a66021a5-9d8c-43e1-9aec-5b41d6c18324` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.