Criar Produto

post

https://{environment}.app/v2/catalog/products

Cria um produto junto com seu SKU base em uma única chamada — não há um endpoint separado para 'criar SKU' referente ao SKU base. O corpo da resposta contém tanto ProductId quanto SkuId (o id do próprio SKU base). Para adicionar SKUs de variação (ex.: combinações de Cor/Tamanho) posteriormente, use POST /products/{id}/variations.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

name

string

required

Nome do produto

cest

string

Código tributário brasileiro (Código Especificador da Substituição Tributária) para relatórios de substituição tributária estadual.

ncm

string

Código de classificação fiscal do produto brasileiro/Mercosul (Nomenclatura Comum do Mercosul)

shortDescription

string

Descrição resumida do produto (maximo 1000 caracteres)

description

string

Descriçao do sku (maximo 20.000 caracteres)

externalId

string

required

Identificador usado para correlacionar este produto com o sistema de origem

externalIdSku

string

Identificador do sku utilizado pelo sistema externo

status

string

enum

required

Status do ciclo de vida.

Allowed:

type

string

enum

required

Tipo do produto, Simple (SKU autônomo), Composite (tem variações), ou Kit (conjunto de outros SKUs como componentes — a montagem do kit é gerenciada por uma feature separada).

Allowed:

production

string

enum

Como o produto é fabricado: Own (fabricado pelo próprio vendedor) ou Outsourced (fabricado por terceiros). Obrigatório quando Status é Active

Allowed:

warranty

string

Descrição de garantia em texto livre (ex.: '90 dias', '1 ano'); não é uma duração estruturada. Obrigatório (não vazio) quando Status é Active

itemsInBox

int32

Quantas unidades vendáveis individuais são embaladas juntas em uma caixa de envio para este SKU. Número inteiro, deve ser >= 1, obrigatório quando Status é Active

height

string

width

string

length

string

weight

string

weightWithoutPackaging

string

volumes

string

volumeType

string

enum

Headers

x-customer-key

string

required

Um hash que identifica o cliente. Deve ser provido pela Logstore

x-api-key

string

required

Chave de acesso

Responses

Language

Credentials

OAuth2

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200200

400400