API atual/Referência completa/Produtos mestre

Ofertas de um produto mestre

Lista os produtos de sellers ligados a um mestre, com preço, estoque, avaliação e frete de cada oferta.

Cada produto de seller ligado a um produto mestre é uma oferta: o mesmo item vendido por um seller específico, com preço e estoque próprios. Use esta rota para ver quem vende o mestre, comparar preços e achar ofertas fora do ar. Exige view_catalog ou manage_catalog.

GET/api/v1/admin/master-products/{id}/offersAdmin

Lista as ofertas de um mestre

É a visão da administração: diferente da vitrine, ela não esconde ofertas ainda não aprovadas, desativadas ou sem estoque, para você poder gerenciar a ligação. Uma oferta por seller.

Parâmetros de caminho

iduuidobrigatório

Id do mestre.

Parâmetros de consulta

pageintegerpadrão: 1

Página, a partir de 1.

per_pageintegerpadrão: 20

Itens por página, de 1 a 100. Fora disso volta a 20.

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/admin/master-products/$MASTER/offers?per_page=20" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Ofertas

json

{
  "offers": [
    {
      "product_id": "2a6541bf-d5b0-4a2e-ad7b-1183af189d42",
      "product_slug": "cafeteira-moderno-branco-01426-1426",
      "vendor_id": "94bd7e9a-fdad-4d01-8fc2-ba9d677d8b36",
      "vendor_name": "Loja Seller Teste",
      "vendor_slug": "loja-seller-teste",
      "vendor_logo_url": "/uploads/exemplo/vendor/logo.png",
      "price": 80990,
      "quantity": 2,
      "track_inventory": true,
      "status": "A",
      "rating_avg": 3.8,
      "rating_count": 0,
      "free_shipping": true,
      "sku": "SD-001426",
      "image_url": "/uploads/exemplo/product/cafeteira.png",
      "created_at": "2026-05-25T12:05:41Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 20,
  "total_pages": 1
}

Campos de cada oferta

product_iduuid

Id do produto do seller (a oferta).

product_slugstring

Trecho de URL do produto do seller. Use este para o link da oferta, não o id do mestre: a página do mestre não é uma página de compra.

vendor_iduuid

Seller dono da oferta.

vendor_namestring

Nome do seller.

vendor_slugstring

Trecho de URL da loja do seller.

vendor_logo_urlstring

Logotipo do seller.

priceinteger

Preço de venda em centavos.

list_priceinteger

Preço "de" em centavos. Ausente quando não há.

quantityinteger

Estoque da oferta.

track_inventoryboolean

Se o seller controla estoque. Com false, quantity 0 não quer dizer esgotado.

statusstring

AHDRX

Status do produto do seller: A ativo, H oculto, D desativado, R aguardando moderação, X rejeitado.

rating_avgnumber

Nota média das avaliações.

rating_countinteger

Quantidade de avaliações.

free_shippingboolean

Se o produto tem frete grátis.

skustring

SKU do seller. Ausente se não houver.

image_urlstring

Primeira imagem do produto do seller. Vazio sem imagem.

created_atstring

Quando o produto do seller foi criado.

Erros

Status	Quando	Corpo de exemplo
401	Token ausente ou expirado	`{"error":"invalid or expired token"}`
403	Módulo desligado, ou falta o privilégio	`{"error":"module_disabled","module":"master-products"}`
404	Recurso desligado na loja	`{"error":"feature not enabled","detail":"enable master_products via admin settings"}`
500	Id que não é UUID	`{"error":"failed to get vendor offers","detail":"..."}`

Veja também