1. Home
  2. Compras
  3. API V2
  4. Endpoint: Buscar produtos

Endpoint: Buscar produtos

Endpoint que permite a listagem dos produtos criados na plataforma da SULTS.

URL: https://api.sults.com.br/api/v2/compras/product/list
Método: GET

Parâmetros

Headers

HeaderValor
Authorization<token_de_acesso>
Content-Typeapplication/json;charset=UTF-8

Query parameters

FiltroValorDescrição
idIntegerCódigo do produto
referenceCodeStringCódigo externo do produto

Faz referência do código do produto cadastrado em um sistema externo ao SULTS.
barcodeIntegerCódigo de barras do produto
activeBooleantrue – (Padrão) produtos ativos
false – produtos inativos
categoryIdIntegerCódigo da categoria do produto
supplierIdIntegerCódigo do fornecedor do produto
saleableAfterStringProdutos publicados a partir de:

Exemplo: 2027-05-29
saleableBeforeStringProdutos publicados anterior a:

Exemplo: 2027-05-29
pageIntegerÍndice da paginação da listagem. Inicia-se em 0

Exemplo

fetch("https://api.sults.com.br/api/v2/compras/product/list?active=true&categoryId=2&page=0", {
	method: "GET",
	headers: {
		"Authorization": "<token_de_acesso>",
                "Content-Type":"application/json;charset=UTF-8"
	}
})

Resposta

[
	{
		"id": 1,
		"name": "Produto 1",
		"barcode": 1223334,
		"referenceCode": "1a2b3c4d",
		"category": {
			"id": 1,
			"name": "Produtos especiais"
		},
		"supplier": {
			"id": 5,
			"name": "Fornecedor 1",
			"legalName": "Fornecedor 1",
			"active": true
		},
		"saleableDate": "2027-01-01",
		"inventoryScope": "ON_PRODUCT",
		"active": true,
		"variation": [
			{
				"id": 8,
				"name": "Sabor",
				"active": true,
				"index": 0,
				"option": [
					{
						"id": 18,
						"name": "Uva",
						"active": true,
						"index": 0
					},
					{
						"id": 19,
						"name": "Morango",
						"active": true,
						"index": 1
					}
				]
			}
		],
		"image": [
			{
				"id": 1,
				"name": "produto1.png",
				"url": "https://link/produto1.png",
				"fileLength": 615324
			}
		],
		"shortDescription": "Produto especial 1",
		"htmlDescription": "<b>Produto especial 1</b>"
	}
]



Atualizado em 17/07/2026