Consultando todos os produtos

Para realizar a consulta dos produtos já cadastrados, utilize o endpoint Retorna todos os produtos.

Parâmetros para consulta:

  • pagina - [DEPRECADO - A partir de 21/09/2026] somente a paginação via cursor será suportada com uso do parâmetro produtoVarianteIdDe.
  • categorias - Lista de categorias que deverão retornar (lista separada por "," ex.: 1,2,3), caso vazio retornará todas as categorias;
  • fabricantes - Lista de fabricantes que deverão retornar (lista separada por "," ex.: 1,2,3), caso vazio retornará todas as situações;
  • centrosDistribuicao - Lista de Centros de Distribuição que deverão retornar (lista seperada por "," ex.: 1,2,3), caso vazio retornará produtos de todos os CDs;
  • alteradosPartirDe - Retorna apenas os produtos que sofreram alguma alteração a partir da data/hora informada (Formato: aaaa-mm-dd hh:mm:ss com no máximo 48 horas de antecedência);
  • quantidadeRegistros - Quantidade de registros que deverão retornar (max: 50);
  • somenteValidos - Campos adicionais que se selecionados retornaram junto com o produto;
  • produtoVarianteIdDe - Cursor de paginação retorna IDs subsequentes ao informado. Dispensável na primeira requisição; nas demais, utilize o valor retornado no header 'X-Ultimo-Produto-Variante-Id'.

Response body:

[
  {
    "produtoVarianteId": 112233,
    "produtoId": 0,
    "idPaiExterno": "string",
    "idVinculoExterno": "string",
    "sku": "string",
    "nome": "string",
    "nomeProdutoPai": "string",
    "urlProduto": "string",
    "exibirMatrizAtributos": "Sim",
    "contraProposta": true,
    "fabricante": "string",
    "autor": "string",
    "editora": "string",
    "colecao": "string",
    "genero": "string",
    "precoCusto": 0,
    "precoDe": 0,
    "precoPor": 0,
    "fatorMultiplicadorPreco": 0,
    "prazoEntrega": 0,
    "valido": true,
    "exibirSite": true,
    "freteGratis": "Sempre",
    "trocaGratis": true,
    "peso": 0,
    "altura": 0,
    "comprimento": 0,
    "largura": 0,
    "produtoPerigoso": true,
    "garantia": 0,
    "isTelevendas": true,
    "ean": "string",
    "localizacaoEstoque": "string",
    "listaAtacado": [
      {
        "precoPor": 0,
        "quantidade": 0
      }
    ],
    "estoque": [
      {
        "estoqueFisico": 0,
        "estoqueReservado": 0,
        "centroDistribuicaoId": 0,
        "produtoVarianteId": 0,
        "alertaEstoque": 0,
        "permitePreVenda": true,
        "estoquePreVenda": 0,
        "dataLancamento": "2026-09-09T18:47:43.832Z"
      }
    ],
    "atributos": [
      {
        "tipoAtributo": "Selecao",
        "isFiltro": true,
        "nome": "string",
        "valor": "string",
        "exibir": true
      }
    ],
    "quantidadeMaximaCompraUnidade": 0,
    "quantidadeMinimaCompraUnidade": 0,
    "condicao": "Novo",
    "informacoes": [
      {
        "informacaoId": 0,
        "titulo": "string",
        "texto": "string",
        "tipoInformacao": "Informacoes",
        "exibirSite": true
      }
    ],
    "tabelasPreco": [
      {
        "tabelaPrecoId": 0,
        "nome": "string",
        "precoDe": 0,
        "precoPor": 0
      }
    ],
    "categorias": [
      {
        "id": 0,
        "nome": "string",
        "ativo": true,
        "caminhoHierarquia": "string",
        "categoriaPrincipal": true
      }
    ],
    "dataCriacao": "2026-09-09T18:47:43.832Z",
    "dataAtualizacao": "2026-09-09T18:47:43.832Z",
    "urlVideo": "string",
    "spot": true,
    "paginaProduto": true,
    "marketplace": true,
    "somenteParceiros": true,
    "reseller": {
      "resellerId": 0,
      "razaoSocial": "string",
      "centroDistribuicaoId": 0,
      "ativo": true,
      "ativacaoAutomaticaProdutos": true,
      "autonomia": true,
      "buyBox": true,
      "nomeMarketPlace": "string"
    },
    "buyBox": true,
    "consumo": {
      "quantidadeDias": 0,
      "enviarEmail": true
    },
    "prazoValidade": 0,
    "parentId": 0,
    "urlImagem": "string"
  },
  {
    "produtoVarianteId":223344 ,
    "produtoId": 29,
    "idPaiExterno": null,
    "idVinculoExterno": null,
    "sku": "724683",
    "nome": "Kit Prático Maxton Louro Extra Claro Platina 12.01",
    "nomeProdutoPai": "Kit Prático Maxton Louro Extra Claro Platina 12.01",
    "urlProduto": "https://lojacss.fbits.store/Produto/kit-pratico-maxton-louro-extra-claro-platina-12-01-29",
    "exibirMatrizAtributos": "Neutro",
    "contraProposta": true,
    "fabricante": "Maxton ",
    "autor": null,
    "editora": null,
    "colecao": null,
    "genero": null,
    "precoCusto": 0,
    "precoDe": 269.7,
    "precoPor": 280,
    "fatorMultiplicadorPreco": 1,
    "prazoEntrega": 1,
    "valido": true,
    "exibirSite": true,
    "freteGratis": "Neutro",
    "trocaGratis": false,
    "peso": 100,
    "altura": 14.5,
    "comprimento": 10,
    "largura": 5.5,
    "garantia": 0,
    "isTelevendas": false,
    "ean": "7896013544390",
    "localizacaoEstoque": null,
    "listaAtacado": [],
    "estoque": [],
    "atributos": [],
    "quantidadeMaximaCompraUnidade": 0,
    "quantidadeMinimaCompraUnidade": 0,
    "condicao": "Novo",
    "informacoes": [],
    "tabelasPreco": [],
    "dataCriacao": "2014-08-27T21:13:44",
    "dataAtualizacao": "2022-07-01T16:21:12.737",
    "urlVideo": null,
    "spot": true,
    "paginaProduto": true,
    "marketplace": true,
    "somenteParceiros": false,
    "reseller": null,
    "buyBox": false,
    "prazoValidade": 0,
    "consumo": {
      "quantidadeDias": 0,
      "enviarEmail": true
    }
  }
]
 cache-control: no-cache 
 content-length: 112326 
 content-type: application/json; charset=utf-8 
 date: Wed,09 Sep 2026 18:38:56 GMT 
 expires: -1 
 pragma: no-cache 
 x-rate-limit-limit: 1m 
 x-rate-limit-remaining: 119 
 x-rate-limit-reset: 2026-09-09T18:39:56.7554950Z 
 x-request-id: 507fdfba-83fe-4e9b-b085-391e111111 
 x-tem-proxima-pagina: true 
 x-total-count: 16077 
 x-ultimo-produto-variante-id: 223344 
📘

Response Headers

No response headers, temos o campo "x-total-count", que retorna a contagem total de pedidos que atendem o filtro realizado, dessa forma o integrador poderá saber quantas páginas existem na consulta realizada. Além disso, o campo "x-tem-proxima-pagina" informa se há ou não uma próxima página para consulta.

Utilize o valor retornado no header "x-ultimo-produto-variante-id" para que a paginação por cursor retorne os IDs subsequentes considerando os informados no parâmetro produtoVarianteIdDe.