Products – Company

Endpoint: /get/products-company

Este endpoint devolve a listagem completa de produtos da empresa, com informação detalhada, incluindo:

  • Preço de venda (PVP) e preço de revenda (WholesalePrice)
  • Descrições curta e longa
  • Informações físicas (dimensões, peso)
  • Marca e categoria (até sub-subcategoria)
  • Códigos EAN13 e referências
  • Estado (IsNew), IVA, taxas ecológicas e última atualização

Requer Autenticação

Este endpoint exige token JWT válido no cabeçalho:

Authorization: Bearer {TOKEN}

Formatos suportados

Podes escolher o formato da resposta com o parâmetro format:

  • XML (por omissão)
  • JSON
  • CSV

Exemplos de URL válidos:

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

Exemplo em PHP (consumo autenticado)

<?php

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

// Obter o 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 os produtos da empresa
$endpoint = "$apiBase/get/products-company/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 "Produto: " . $produto['ProductName'] . " - Preço: " . $produto['PVP'] . "€\n";
}