Consultar produtos de um catálogo ativo

GET

/v1/catalogos/{id}/produtos

curl --request GET \
  --url 'https://api.cotejar.com.br/v1/catalogos/0198d000-0000-7000-8000-000000000001/produtos?apos_id=0198d000-0000-7000-8000-000000000001&estado=ativo' \
  --header 'Authorization: Bearer <token>'

• Produção

Catálogo inexistente, alheio ou excluído retorna 404. Aplica os mesmos filtros e orçamento da consulta empresarial de produtos.

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 consulta

limite

Padrão 50; máximo 200 e orçamento de bytes por página.

string

/^(?:[1-9]|[1-9][0-9]|1[0-9]{2}|200)$/

apos_id

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

origem

string

/^[A-Za-z0-9_-]{1,128}$/

id_externo

Igualdade exata; exige origem.

string

>= 1 caractere <= 512 caracteres

sku

string

>= 1 caractere <= 512 caracteres

ncm

string

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

estado

string

Valores permitidos: ativo inativo

Respostas

200

Response for status 200

Tipo de mídiaapplication/json

object

itens

obrigatório

Array<object>

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>

proximo_id

obrigatório

Qualquer um de:

string

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}$/

null

null

Exemplo

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

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"
  }
}

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"
  }
}

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"
  }
}