Pular para o conteúdo principal
POST
/
api
/
partner
/
v1
/
catalog
/
options
Criar opção
curl --request POST \
  --url https://integracao.sandbox.cardapioweb.com/api/partner/v1/catalog/options \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --header 'X-PARTNER-KEY: <api-key>' \
  --data '
{
  "name": "Pequena",
  "description": "Tamanho pequeno, ideal para 1 pessoa",
  "cost_price": 5.5,
  "external_code": "OPT-001",
  "status": "ACTIVE"
}
'
{
  "id": 123,
  "name": "<string>",
  "description": "<string>",
  "external_code": "<string>",
  "image": {
    "image_url": "<string>",
    "thumbnail_url": "<string>"
  },
  "cost_price": 1,
  "active_stock_control": true,
  "stock": 123
}

Autorizações

X-PARTNER-KEY
string
header
obrigatório

Token de autenticação da integradora. Para ter esse token, a integradora precisa estar previamente cadastrada em nosso sistema. Deve ser enviado no header X-PARTNER-KEY.

X-API-KEY
string
header
obrigatório

Token de autenticação da API. Deve ser enviado no header X-API-KEY.

Corpo

application/json
name
string
obrigatório

Nome da opção. Deve ser único no estabelecimento.

Required string length: 1 - 500
description
string | null

Descrição da opção.

Maximum string length: 1000
cost_price
number

Preço de custo da opção. Deve ser um número positivo com no máximo 2 casas decimais.

Intervalo obrigatório: x >= 0
external_code
string | null

Código externo da opção.

Maximum string length: 50
status
enum<string>
padrão:ACTIVE

Status da opção.

  • ACTIVE: opção ativa e visível.
  • INACTIVE: opção oculta.
  • MISSING: opção em falta.
Opções disponíveis:
ACTIVE,
INACTIVE,
MISSING

Resposta

Opção criada com sucesso.

Opção que pode ser associada a múltiplos grupos de complementos.

id
integer

Identificador único da opção.

name
string

Nome da opção.

description
null | string

Descrição da opção.

external_code
null | string

Código externo da opção.

status
enum<string>

Status da opção.

  • ACTIVE: opção ativa e visível.
  • INACTIVE: opção oculta.
  • MISSING: opção em falta.
Opções disponíveis:
ACTIVE,
INACTIVE,
MISSING
image
Image · object

Imagem da opção.

cost_price
number | null

Preço de custo da opção.

Intervalo obrigatório: x >= 0
active_stock_control
boolean

Indica se o controle de estoque está ativo.

stock
number | null

Quantidade disponível em estoque.

Última modificação em 27 de junho de 2026