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

Endpoint: Buscar pedidos

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

URL: https://api.sults.com.br/api/v2/compras/order/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 pedido
companyIdIntegerCódigo da empresa
supplierIdIntegerCódigo do fornecedor do produto
stageIdIntegerCódigo da etapa
statusStringSituação do pedido

Valores aceitos (‘OPEN‘, ‘CONCLUDED‘)
pageIntegerDefine a página da listagem que será retornada
canceledBooleantrue – pedidos cancelados
false – (Padrão) pedidos não cancelados

Exemplo

fetch("https://api.sults.com.br/api/v2/compras/order/list?companyId=10&supplierId=5&page=0", {
	method: "GET",
	headers: {
		"Authorization": "<token_de_acesso>",
                "Content-Type":"application/json;charset=UTF-8"
	}
})

Resposta

[
  {
    "id": 1,
    "amount": "302.00",
    "minAmount": "100.00",
    "productSubtotal": "47.90",
    "productDiscount": "2.00",
    "note": "",
    "message": "",
    "stage": {
      "id": 3,
      "name": "Enviado",
      "color": "#00cdac",
      "index": 4
    },
    "createdAt": "2026-05-20T02:37:52Z",
    "concludedAt": null,
    "company": {
      "id": 10,
      "name": "REDE",
      "legalName": "Modelo",
      "cnpj": "99999999999999",
      "active": true
    },
    "supplier": {
      "id": 5,
      "name": "Fornecedor GX",
      "legalName": "Fornecedor GX",
      "active": true
    },
    "paymentMethod": {
      "id": 3,
      "name": "A Combinar"
    },
    "shippingMethod": {
      "id": 1,
      "name": "A Combinar"
    },
    "createdByUser": {
      "id": 53,
      "name": "Pessoa G"
    },
    "shippingAddress": {
      "postalCode": "99999999",
      "street": "Rua H1",
      "neighborhood": "Barra da Tijuca",
      "number": "0",
      "complement": "",
      "city": "Rio de Janeiro",
      "state": "RJ"
    },
    "status": "OPEN",
    "canceled": false
  }
]
Atualizado em 10/07/2026