Cadastrar produto neste catálogo

POST

/v1/catalogos/{id}/produtos

curl --request POST \
  --url https://api.cotejar.com.br/v1/catalogos/0198d000-0000-7000-8000-000000000001/produtos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'idempotency-key: pedido-exemplo-00000001' \
  --data '{ "origem": "erp", "id_externo": "00001", "ncm": "01012100", "atributos": [] }'

• Produção

Criação incremental, sem assinatura. Repetição devolve o resultado original com status 201.

Autorizações

• bearerAuth

Parâmetros

Parâmetros de caminho

id

obrigatório

Exemplo sintético; substitua pelo UUID obtido na consulta do seu recurso.

string

/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$/

Exemplo

0198d000-0000-7000-8000-000000000001

Parâmetros de cabeçalho

idempotency-key

obrigatório

Gere uma chave por pedido e preserve-a somente nas repetições desse mesmo pedido.

string

>= 16 caracteres <= 128 caracteres /^[A-Za-z0-9._:-]+$/

Exemplo

pedido-exemplo-00000001

Corpo da requisição^obrigatório

Tipo de mídiaapplication/json

object

id_externo

string

aceita nulo >= 1 caractere <= 256 caracteres

sku

string

aceita nulo >= 1 caractere <= 256 caracteres

descricao

string

aceita nulo >= 1 caractere <= 2000 caracteres

ncm

obrigatório

string

/^[0-9]{8}$/

atributos

obrigatório

Array<object>

<= 128 itens

object

codigo

obrigatório

string

>= 1 caractere <= 128 caracteres

valores

obrigatório

Array<string>

>= 1 item <= 50 itens

origem

string

padrão: api /^[A-Za-z0-9_-]{1,128}$/

Exemplo

{
  "origem": "erp",
  "id_externo": "00001",
  "ncm": "01012100",
  "atributos": []
}

Respostas

201

Response for status 201

Tipo de mídiaapplication/json

object

id

obrigatório

Exemplo sintético; substitua pelo UUID obtido na consulta do seu recurso.

string

/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$/

id_externo

obrigatório

Qualquer um de:

string

string

null

null

origem

obrigatório

string

sku

obrigatório

Qualquer um de:

string

string

null

null

descricao

obrigatório

Qualquer um de:

string

string

null

null

ncm

obrigatório

string

atributos

obrigatório

Array<object>

object

codigo

obrigatório

string

valores

obrigatório

Array<string>

versao

obrigatório

Qualquer um de:

string

string formato: integer

0

integer

integer

ativo

obrigatório

boolean

catalogos

obrigatório

Array<string>

Exemplo

{
  "id": "0198d000-0000-7000-8000-000000000001",
  "versao": 0,
  "catalogos": [
    "0198d000-0000-7000-8000-000000000001"
  ]
}

Cabeçalhos

ETag

string

Versão opaca do recurso, incluindo aspas. Preserve o valor completo ao enviar If-Match.

Location

string

Caminho da consulta do recurso criado ou da operação aceita. Aceite não comprova conclusão.

400

Response for status 400

Tipo de mídiaapplication/json

object

erro

obrigatório

object

codigo

obrigatório

string

mensagem

obrigatório

string

request_id

obrigatório

string

caminho

string

Exemplo^gerado

{
  "erro": {
    "codigo": "example",
    "mensagem": "example",
    "request_id": "example",
    "caminho": "example"
  }
}

401

Response for status 401

Tipo de mídiaapplication/json

object

erro

obrigatório

object

codigo

obrigatório

string

mensagem

obrigatório

string

request_id

obrigatório

string

caminho

string

Exemplo^gerado

{
  "erro": {
    "codigo": "example",
    "mensagem": "example",
    "request_id": "example",
    "caminho": "example"
  }
}

403

Response for status 403

Tipo de mídiaapplication/json

object

erro

obrigatório

object

codigo

obrigatório

string

mensagem

obrigatório

string

request_id

obrigatório

string

caminho

string

Exemplo^gerado

{
  "erro": {
    "codigo": "example",
    "mensagem": "example",
    "request_id": "example",
    "caminho": "example"
  }
}

404

Response for status 404

Tipo de mídiaapplication/json

object

erro

obrigatório

object

codigo

obrigatório

string

mensagem

obrigatório

string

request_id

obrigatório

string

caminho

string

Exemplo^gerado

{
  "erro": {
    "codigo": "example",
    "mensagem": "example",
    "request_id": "example",
    "caminho": "example"
  }
}

408

Response for status 408

Tipo de mídiaapplication/json

object

erro

obrigatório

object

codigo

obrigatório

string

mensagem

obrigatório

string

request_id

obrigatório

string

caminho

string

Exemplo^gerado

{
  "erro": {
    "codigo": "example",
    "mensagem": "example",
    "request_id": "example",
    "caminho": "example"
  }
}

409

Response for status 409

Tipo de mídiaapplication/json

object

erro

obrigatório

object

codigo

obrigatório

string

mensagem

obrigatório

string

request_id

obrigatório

string

caminho

string

Exemplo^gerado

{
  "erro": {
    "codigo": "example",
    "mensagem": "example",
    "request_id": "example",
    "caminho": "example"
  }
}

412

Response for status 412

Tipo de mídiaapplication/json

object

erro

obrigatório

object

codigo

obrigatório

string

mensagem

obrigatório

string

request_id

obrigatório

string

caminho

string

Exemplo^gerado

{
  "erro": {
    "codigo": "example",
    "mensagem": "example",
    "request_id": "example",
    "caminho": "example"
  }
}

413

Response for status 413

Tipo de mídiaapplication/json

object

erro

obrigatório

object

codigo

obrigatório

string

mensagem

obrigatório

string

request_id

obrigatório

string

caminho

string

Exemplo^gerado

{
  "erro": {
    "codigo": "example",
    "mensagem": "example",
    "request_id": "example",
    "caminho": "example"
  }
}

415

Response for status 415

Tipo de mídiaapplication/json

object

erro

obrigatório

object

codigo

obrigatório

string

mensagem

obrigatório

string

request_id

obrigatório

string

caminho

string

Exemplo^gerado

{
  "erro": {
    "codigo": "example",
    "mensagem": "example",
    "request_id": "example",
    "caminho": "example"
  }
}

422

Response for status 422

Tipo de mídiaapplication/json

object

erro

obrigatório

object

codigo

obrigatório

string

mensagem

obrigatório

string

request_id

obrigatório

string

caminho

string

Exemplo^gerado

{
  "erro": {
    "codigo": "example",
    "mensagem": "example",
    "request_id": "example",
    "caminho": "example"
  }
}

428

Response for status 428

Tipo de mídiaapplication/json

object

erro

obrigatório

object

codigo

obrigatório

string

mensagem

obrigatório

string

request_id

obrigatório

string

caminho

string

Exemplo^gerado

{
  "erro": {
    "codigo": "example",
    "mensagem": "example",
    "request_id": "example",
    "caminho": "example"
  }
}

429

Response for status 429

Tipo de mídiaapplication/json

object

erro

obrigatório

object

codigo

obrigatório

string

mensagem

obrigatório

string

request_id

obrigatório

string

caminho

string

Exemplo^gerado

{
  "erro": {
    "codigo": "example",
    "mensagem": "example",
    "request_id": "example",
    "caminho": "example"
  }
}

503

Response for status 503

Tipo de mídiaapplication/json

object

erro

obrigatório

object

codigo

obrigatório

string

mensagem

obrigatório

string

request_id

obrigatório

string

caminho

string

Exemplo^gerado

{
  "erro": {
    "codigo": "example",
    "mensagem": "example",
    "request_id": "example",
    "caminho": "example"
  }
}