Products – Simple

Endpoint: /get/products-simple

Este endpoint devolve uma listagem simplificada de produtos ativos com stock, ideal para consultas rápidas ou sistemas que só precisam dos dados essenciais de catálogo.

Inclui:

  • Nome do produto (ProductName)
  • Preço de venda (PVP)
  • Preço de revenda (WholesalePrice)
  • Stock (best_quantity)
  • Referência, EAN13, classe energética
  • Informações de marca e categoria
  • Medidas físicas e taxas aplicáveis
  • Sem descrições (short/long), para otimizar desempenho

Requer Autenticação

Cabeçalho obrigatório:

Authorization: Bearer {TOKEN}

Formatos suportados

  • XML (por omissão)
  • JSON
  • CSV (com BOM para Excel)

URLs disponíveis:

  • /api/get/products-simple
  • /api/get/products-simple/format/json
  • /api/get/products-simple/format/csv

Exemplo em PHP (acesso autenticado)

<?php

$apiBase = 'https://O.MEU.DNS/api';
$username = 'username@mail.pt';
$password = 'password';

// Obter token
$tokenUrl = "$apiBase/generate-token/username/$username/password/$password";
$response = file_get_contents($tokenUrl);
$data = json_decode($response, true);
$token = $data['token'] ?? die("Erro ao obter token");

// Pedir produtos com stock (versão simplificada)
$endpoint = "$apiBase/get/products-simple/format/json";
$opts = [
    "http" => [
        "method" => "GET",
        "header" => "Authorization: Bearer $token"
    ]
];
$context = stream_context_create($opts);
$result = file_get_contents($endpoint, false, $context);

// Apresentar resultados
$produtos = json_decode($result, true);
foreach ($produtos as $produto) {
    echo "Produto: {$produto['ProductName']} | Stock: {$produto['Stock']} | PVP: {$produto['PVP']}€\n";
}