Comptes-rendus de commande

GET /orders/reports

Retourne les comptes-rendus de préparation (expédition) générés par le WMS.

GET /orders/{uniqueOrderID}/reports

Retourne les comptes-rendus pour une commande spécifique.

Paramètres de requête

Paramètre	Type	Description
afterId	long	Mouvements avec id supérieur
afterDate	DateTime	Mouvements après cette date
uniqueOrderID	string	Filtrer par commande

Limite

100 résultats maximum par requête.

Structure de la réponse

Compte-rendu (OrderReport)

Champ	Type	Description
id	long	Identifiant technique
activityCode	string	Code activité
subActivityCode	string	Code sous-activité
orderUniqueID	string	Identifiant de la commande
prepClosedState	int	État de clôture de la préparation
firstPackageCreationDate	DateTime	Date de création du premier colis
lastPackageLoadDate	DateTime	Date de chargement du dernier colis
shippedHandlingUnitCount	int	Nombre d’unités de manutention expédiées
packedPackageCount	int	Nombre de colis emballés
packedPaletteCount	int	Nombre de palettes emballées
totalPrepWeight	decimal	Poids total préparé
totalPrepVolume	decimal	Volume total préparé
prepOrderGroupID	string	Groupe de préparation
lignes	OrderReportEntry[]	Lignes du compte-rendu
parcels	OrderReportParcel[]	Détails des colis

Lignes du rapport (OrderReportEntry)

Champ	Type	Description
orderLineID	string	Identifiant de la ligne commande
articleReference	string	Référence article
orderedQuantity	int	Quantité commandée
preparedQuantity	int	Quantité effectivement préparée
gradeCode	string	Code qualité

Colis (OrderReportParcel)

Champ	Type	Description
packageNumber	string	Numéro de colis
palletNumber	string	Numéro de palette
shipmentTrackingNumber	string	Numéro de suivi transporteur
palletSSCC	string	SSCC palette
packageSSCC	string	SSCC colis
trpcont	string	Code transport
trpchg	string	Référence de chargement transport
transportService	string	Service de transport utilisé
transportLoadNumber	string	Numéro de chargement
packageCreationDate	DateTime	Date de création du colis
packageLoadDate	DateTime	Date de chargement
packageRank	int	Rang du colis
seqColis	int	Séquence du colis
actualPackageWeight	int	Poids réel du colis (g)
shippedPackageVolume	int	Volume du colis (cm³)
activityPackagingCode	string	Code emballage
ezytailWaveID	string	ID vague Ezytail
trackingurl	string	URL de suivi
entries	OrderReportParcelEntry[]	Articles dans ce colis

Articles par colis (OrderReportParcelEntry)

Champ	Type	Description
parcelId	string	Identifiant du colis
articleReference	string	Référence article
shippedQuantityInPackage	int	Quantité expédiée dans ce colis
properties	object[]	Propriétés dynamiques (n° de lot, n° de série, quantités)

Note

Le champ properties est un tableau de dictionnaires clé-valeur. Il contient des informations variables selon le type d’article : numéros de lot, numéros de série, etc. Chaque dictionnaire contient le type d’acquisition et sa valeur, ainsi que la quantité (Qtte).

Exemple de requête

cURL

# Tous les comptes-rendus (polling incrémental)
curl -X GET "https://api.ezyconnect.com/orders/reports?afterId=0" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Comptes-rendus d'une commande spécifique
curl -X GET "https://api.ezyconnect.com/orders/CMD-2024-001/reports" \
  -H "Authorization: Bearer YOUR_TOKEN"

JavaScript

const response = await fetch(
  "https://api.ezyconnect.com/orders/reports?afterId=0",
  { headers: { "Authorization": "Bearer YOUR_TOKEN" } }
);
const result = await response.json();
console.log(result);

Python

import requests

response = requests.get(
    "https://api.ezyconnect.com/orders/reports",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
    params={"afterId": 0}
)
result = response.json()
print(result)

C#

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/orders/reports?afterId=0");

Java

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/orders/reports?afterId=0"))
    .header("Authorization", "Bearer YOUR_TOKEN")
    .GET()
    .build();

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

Pattern de polling recommandé

last_id = 0

while True:
    response = requests.get(
        f"https://api.ezyconnect.com/orders/reports?afterId={last_id}",
        headers=headers
    )
    reports = response.json()

    if not reports:
        time.sleep(60)
        continue

    for report in reports:
        # Traiter les quantités préparées
        for ligne in report["lignes"]:
            if ligne["preparedQuantity"] < ligne["orderedQuantity"]:
                print(f"Ligne {ligne['orderLineID']}: préparation partielle")

        # Récupérer les numéros de tracking
        for parcel in report["parcels"]:
            print(f"Colis {parcel['packageNumber']}: tracking {parcel['shipmentTrackingNumber']}")
            if parcel.get("trackingurl"):
                print(f"  Suivi: {parcel['trackingurl']}")

        last_id = max(last_id, report["id"])

Exemple de réponse

[
  {
    "id": 54321,
    "activityCode": "001",
    "orderUniqueID": "CMD-2024-001",
    "prepClosedState": 1,
    "firstPackageCreationDate": "2024-06-16T08:30:00Z",
    "lastPackageLoadDate": "2024-06-16T14:00:00Z",
    "packedPackageCount": 1,
    "totalPrepWeight": 0.65,
    "lignes": [
      {
        "orderLineID": "1",
        "articleReference": "ART-001",
        "orderedQuantity": 2,
        "preparedQuantity": 2,
        "gradeCode": "STD"
      }
    ],
    "parcels": [
      {
        "packageNumber": "PKG-001",
        "shipmentTrackingNumber": "6A12345678901",
        "transportService": "COLISSIMO",
        "packageCreationDate": "2024-06-16T08:30:00Z",
        "actualPackageWeight": 0.65,
        "trackingurl": "https://www.laposte.fr/outils/suivre-vos-envois?code=6A12345678901",
        "entries": [
          {
            "articleReference": "ART-001",
            "shippedQuantityInPackage": 2,
            "properties": []
          }
        ]
      }
    ]
  }
]