Pular para o conteúdo principal
POST
/
api
/
partner
/
v1
/
catalog
/
items
Criar item
curl --request POST \
  --url https://integracao.sandbox.cardapioweb.com/api/partner/v1/catalog/items \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --header 'X-PARTNER-KEY: <api-key>' \
  --data '
{
  "name": "Margherita",
  "description": "A clássica pizza italiana",
  "category_id": 658,
  "price": 30,
  "cost_price": 12.5,
  "status": "ACTIVE",
  "unit_type": "UN",
  "highlighted": false,
  "adults_only": false,
  "hide_observation_field": false,
  "promotional_price_active": false,
  "option_groups": [
    {
      "option_group_id": 1039,
      "index": 1
    },
    {
      "option_group_id": 1040,
      "index": 2
    }
  ]
}
'
{
  "id": 123,
  "name": "<string>",
  "description": "<string>",
  "image": {
    "image_url": "<string>",
    "thumbnail_url": "<string>"
  },
  "highlighted": true,
  "external_code": "<string>",
  "price": 1,
  "cost_price": 1,
  "stock": 1,
  "active_stock_control": true,
  "index": 123,
  "available_for": [],
  "hide_observation_field": true,
  "adults_only": true,
  "promotional_price_active": true,
  "promotional_price": 1,
  "promotional_price_schedules": [
    {
      "start": "18:00",
      "end": "23:00"
    }
  ],
  "unit_type": "UN",
  "allowed_times": [
    {
      "start_at": "18:00",
      "end_at": "23:00"
    }
  ],
  "extra_images": [
    {
      "image_url": "<string>",
      "thumbnail_url": "<string>"
    }
  ],
  "option_groups": [
    {
      "id": 123,
      "name": "<string>",
      "minimum_quantity": 1,
      "maximum_quantity": 2,
      "index": 123,
      "options": [
        {
          "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,
          "index": 123,
          "max_quantity": 123,
          "price": 1
        }
      ]
    }
  ],
  "combo_steps": [
    {
      "id": 123,
      "name": "<string>",
      "price": 1,
      "remove_add_on_prices": true,
      "index": 123,
      "combo_step_items": [
        {
          "item_id": 123,
          "index": 123,
          "additional_price": 1
        }
      ]
    }
  ]
}

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 do item. Deve ser único no estabelecimento.

Required string length: 1 - 500
category_id
integer
obrigatório

ID da categoria à qual o item pertence.

price
number
obrigatório

Preço base do item. Deve ter no máximo 2 casas decimais.

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

Descrição do item. Suporta formatação: negrito (*texto*), itálico (_texto_) ou riscado (~texto~).

Maximum string length: 5000
highlighted
boolean

Define se o item aparece em destaque.

external_code
string | null

Código externo do item.

Maximum string length: 50
cost_price
number

Preço de custo do item. Deve ter no máximo 2 casas decimais.

Intervalo obrigatório: x >= 0
status
enum<string>
padrão:ACTIVE

Status do item.

  • ACTIVE: item ativo e visível.
  • INACTIVE: item oculto.
  • MISSING: item em falta.
Opções disponíveis:
ACTIVE,
INACTIVE,
MISSING
index
integer | null

Índice de exibição do item dentro da categoria.

Intervalo obrigatório: x >= 0
unit_type
enum<string>
padrão:UN

Unidade de medida do item.

  • UN: unidade (padrão).
  • KG: quilograma.
  • L: litro.
Opções disponíveis:
UN,
KG,
L
badge
enum<string> | null

Badge de destaque do item.

  • best_seller: mais vendido.
  • new_item: novidade.
  • recommended: recomendado.
  • limited_edition: edição limitada.
Opções disponíveis:
best_seller,
new_item,
recommended,
limited_edition
hide_observation_field
boolean

Define se o campo de observações deve ser escondido.

adults_only
boolean

Define se o item é apenas para maiores de 18 anos.

promotional_price
number | null

Preço promocional. Obrigatório quando promotional_price_active é true. Deve ser menor que price e ter no máximo 2 casas decimais.

Intervalo obrigatório: x >= 0
promotional_price_active
boolean

Ativa ou desativa o preço promocional.

promotional_price_schedules
PromotionalPriceSchedule · object[] | null

Define os dias e horários em que o preço promocional é aplicado.

option_groups
object[]

Grupos de complementos a associar ao item.

Resposta

Item criado com sucesso.

Produto do cardápio que pode ser item regular ou combo.

id
integer

Identificador único do item.

name
string

Nome do item.

description
string | null

Descrição do item. Suporta formatação: negrito (*texto*), itálico (_texto_) ou riscado (~texto~).

image
Image · object

Imagem principal do item.

highlighted
boolean

Indica se o item deve aparecer em destaque no site.

external_code
string | null

Código externo do item.

price
number

Preço base do item. Deve ser um número positivo com no máximo 2 casas decimais.

Intervalo obrigatório: x >= 0
cost_price
number

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

Intervalo obrigatório: x >= 0
stock
number

Quantidade disponível em estoque.

Intervalo obrigatório: x >= 0
active_stock_control
boolean

Indica se o controle de estoque está ativo.

index
integer | null

Índice de exibição do item dentro da categoria.

available_for
enum<string>[]

Locais onde o item está disponível.

  • delivery: cardápio digital de delivery e retirada.
  • internal_table: pedido de mesa pelo portal.
  • table: pedido de mesa pelo cardápio digital.
  • service_desk: cardápio digital de balcão e portal.
  • view_only: cardápio digital de visualização.
Opções disponíveis:
delivery,
table,
service_desk,
view_only,
internal_table
hide_observation_field
boolean

Indica se o campo de observações deve ser escondido.

adults_only
boolean

Indica se o item é apenas para maiores de 18 anos.

promotional_price_active
boolean

Indica se o preço promocional está ativo.

promotional_price
number | null

Preço promocional do item. Deve ser menor que price quando ativo. É obrigatório se promotional_price_active for true.

Intervalo obrigatório: x >= 0
promotional_price_schedules
PromotionalPriceSchedule · object[] | null

Horários em que o preço promocional é aplicado. Se promotional_price_active for true, define os dias e horários da promoção.

status
enum<string>

Status do item.

  • ACTIVE: item ativo e visível.
  • INACTIVE: item oculto.
  • MISSING: item em falta.
Opções disponíveis:
ACTIVE,
INACTIVE,
MISSING
unit_type
enum<string>
padrão:UN

Unidade de medida do item.

  • UN: unidade (padrão).
  • KG: quilograma.
  • L: litro.
Opções disponíveis:
UN,
KG,
L
badge
enum<string> | null

Badge de destaque do item.

  • best_seller: mais vendido.
  • new_item: novidade.
  • recommended: recomendado.
  • limited_edition: edição limitada.
Opções disponíveis:
best_seller,
new_item,
recommended,
limited_edition
kind
enum<string>

Tipo do item.

  • regular_item: item normal.
  • combo: combo.
Opções disponíveis:
regular_item,
combo
allowed_times
AllowedTimes · object[]

Horários de disponibilidade do item. Array vazio significa sempre disponível.

extra_images
(Image · object | null)[]

Imagens extras do item.

Imagem associada a um recurso (categoria, item ou opção).

option_groups
Grupo de complementos (no item) · object[]

Grupos de complementos associados ao item. Disponível quando kind é regular_item.

combo_steps
ComboStep · object[]

Etapas do combo. Disponível quando kind é combo.

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