Stock articles

GET /articles/stock

Retourne un snapshot (image) du stock à une date donnée. Les données sont extraites du WMS et reflètent l’état du stock au moment de l’extraction.

Paramètres de requête

Paramètre	Type	Description
`atDate`	DateTime	Date du snapshot souhaité (ISO 8601). Si omis, retourne le snapshot le plus récent.
`filter`	string	Expression de filtrage QueryKit
`sort`	string	Expression de tri

Filtrage automatique

Seuls les articles de vos activités autorisées sont retournés
Les articles internes (référence commençant par *) sont exclus

Champs de la réponse

Champ	Type	Description
`id`	long	Identifiant technique
`activityCode`	string	Code activité
`stockImageExtractionDate`	DateTime	Date et heure de l’extraction du stock
`articleReference`	string	Référence article
`stockUnitID`	string	Code propriétaire du stock
`totalStockQuantity`	int	Quantité totale en stock
`notStartedProductionQuantity`	int	Quantité non lancée en production
`inProgressPreparationQuantity`	int	Quantité en cours de préparation
`totalAvailableForSaleQuantity`	int	Quantité disponible à la vente
`totalBlockedQuantity`	int	Quantité immobilisée / bloquée
`logisticsDefinedPCB`	int	PCB défini par le logisticien
`articleLotNumber`	string	Numéro de lot
`oldestReceptionDate`	DateTime	Date de réception la plus ancienne
`newestReceptionDate`	DateTime	Date de réception la plus récente
`oldestSaleDeadlineDate`	DateTime	DLV la plus ancienne
`newestSaleDeadlineDate`	DateTime	DLV la plus récente
`gradeCode`	string	Code qualité (ex: `"STD"`)

Exemple de requête

# Snapshot le plus récent
curl -X GET "https://api.ezyconnect.com/articles/stock" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Snapshot à une date donnée
curl -X GET "https://api.ezyconnect.com/articles/stock?atDate=2024-06-15" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Uniquement les articles avec du stock disponible
curl -X GET "https://api.ezyconnect.com/articles/stock?filter=totalAvailableForSaleQuantity%20%3E%200" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch(
  "https://api.ezyconnect.com/articles/stock?atDate=2024-06-15",
  { headers: { "Authorization": "Bearer YOUR_TOKEN" } }
);
const result = await response.json();
console.log(result);

import requests

response = requests.get(
    "https://api.ezyconnect.com/articles/stock",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
    params={"atDate": "2024-06-15"}
)
result = response.json()
print(result)

using System.Net.Http;
using System.Net.Http.Json;

var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", "YOUR_TOKEN");

var result = await client.GetFromJsonAsync<object[]>(
    "https://api.ezyconnect.com/articles/stock?atDate=2024-06-15");

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.ezyconnect.com/articles/stock?atDate=2024-06-15"))
    .header("Authorization", "Bearer YOUR_TOKEN")
    .GET()
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Exemple de réponse

[
  {
    "id": 12345,
    "activityCode": "001",
    "stockImageExtractionDate": "2024-06-15T06:00:00Z",
    "articleReference": "ART-001",
    "stockUnitID": "001",
    "totalStockQuantity": 500,
    "notStartedProductionQuantity": 0,
    "inProgressPreparationQuantity": 25,
    "totalAvailableForSaleQuantity": 450,
    "totalBlockedQuantity": 25,
    "logisticsDefinedPCB": 12,
    "articleLotNumber": "LOT2024-A",
    "oldestReceptionDate": "2024-03-01T08:00:00Z",
    "newestReceptionDate": "2024-06-10T14:30:00Z",
    "oldestSaleDeadlineDate": "2025-03-01T00:00:00Z",
    "newestSaleDeadlineDate": "2025-06-10T00:00:00Z",
    "gradeCode": "STD"
  }
]