Products – Stocks

Endpoint: /get/products-raw

Este endpoint devolve uma listagem minimalista de produtos ativos com stock, ideal para integrações rápidas ou sincronizações básicas.

Inclui apenas os campos essenciais:

  • ProductName — Nome do produto
  • PVP — Preço de venda ao público
  • WholesalePrice — Preço de revenda
  • Stock — Quantidade em stock (best_quantity)
  • EAN13 — Código de barras EAN-13

Requer Autenticação

Cabeçalho obrigatório:

Authorization: Bearer {TOKEN}

Formatos suportados

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

URLs válidos:

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

Exemplo em PHP (consumo 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 (dados simples e rápidos)
$endpoint = "$apiBase/get/products-raw/format/json";
$opts = [
    "http" => [
        "method" => "GET",
        "header" => "Authorization: Bearer $token"
    ]
];
$context = stream_context_create($opts);
$result = file_get_contents($endpoint, false, $context);

// Mostrar resultado
$produtos = json_decode($result, true);
foreach ($produtos as $produto) {
    echo "EAN: {$produto['EAN13']} | Produto: {$produto['ProductName']} | Stock: {$produto['Stock']}\n";
}