Aller au contenu

Comptes-rendus de réception

GET /procurements/reports

Retourne les comptes-rendus de réception générés par le WMS.

GET /procurements/{uniqueProcurementID}/reports

Retourne les rapports pour un approvisionnement spécifique.

Paramètres de requête

Paramètre	Type	Description
`afterId`	long	Résultats avec `id` supérieur
`afterDate`	DateTime	Résultats après cette date
`uniqueProcurementID`	string	Filtrer par approvisionnement

Limite

100 résultats maximum par requête.

Structure de la réponse

Rapport (`ProcurementReport`)

Champ	Type	Description
`id`	long	Identifiant technique
`activityCode`	string	Code activité
`receptionUniqueID`	string	Identifiant de l’approvisionnement d’origine
`supplierCode`	string	Code fournisseur
`receptionStatus`	string	Statut de réception
`ezytailReceptionUniqueID`	string	Identifiant unique de réception Ezytail
`receptionProcessingNumber`	string	Numéro de traitement
`carrierDeliveryBLNumber`	string	Numéro BL transporteur
`blIssuanceDate`	DateTime	Date d’émission du BL
`actualReceptionDate`	DateTime	Date de réception effective
`entries`	ProcurementReportEntry[]	Lignes du rapport

Lignes du rapport (`ProcurementReportEntry`)

Champ	Type	Description
`orderLineID`	string	Identifiant de la ligne d’origine
`articleReference`	string	Référence article
`receivedQuantity`	int	Quantité réceptionnée
`theoreticalRemainingQuantity`	int	Reliquat théorique
`supplierBLQuantity`	int	Quantité sur BL fournisseur
`ezytailReceptionUniqueID`	string	ID réception Ezytail
`details`	ProcurementReportEntryDetail[]	Détails par réception physique

Détails de réception (`ProcurementReportEntryDetail`)

Champ	Type	Description
`ownerCode`	string	Code propriétaire
`receivedQuantity`	int	Quantité reçue
`receivedLotNumber`	string	Numéro de lot reçu
`articleReceivedDate`	DateTime	Date article
`serialNumber`	string	Numéro de série
`orderLineID`	string	Identifiant ligne
`ezytailReceptionUniqueID`	string	ID réception
`articleReference`	string	Référence article

Exemple de requête

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

# Rapports d'un approvisionnement spécifique
curl -X GET "https://api.ezyconnect.com/procurements/APPRO-2024-001/reports" \
  -H "Authorization: Bearer YOUR_TOKEN"

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

import requests

response = requests.get(
    "https://api.ezyconnect.com/procurements/reports",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
    params={"afterId": 0}
)
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/procurements/reports?afterId=0");

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/procurements/reports?afterId=0"))
    .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": 67890,
    "activityCode": "001",
    "receptionUniqueID": "APPRO-2024-001",
    "supplierCode": "FOUR01",
    "receptionStatus": "T",
    "ezytailReceptionUniqueID": "REC-2024-00123",
    "carrierDeliveryBLNumber": "BL-54321",
    "actualReceptionDate": "2024-07-02T09:15:00Z",
    "entries": [
      {
        "orderLineID": "1",
        "articleReference": "ART-001",
        "receivedQuantity": 480,
        "theoreticalRemainingQuantity": 20,
        "supplierBLQuantity": 500,
        "details": [
          {
            "ownerCode": "001",
            "receivedQuantity": 480,
            "receivedLotNumber": "LOT2024-A",
            "articleReceivedDate": "2025-03-01T00:00:00Z",
            "articleReference": "ART-001"
          }
        ]
      },
      {
        "orderLineID": "2",
        "articleReference": "ART-002",
        "receivedQuantity": 200,
        "theoreticalRemainingQuantity": 0,
        "supplierBLQuantity": 200,
        "details": [
          {
            "receivedQuantity": 200,
            "receivedLotNumber": "LOT2024-B",
            "articleReference": "ART-002"
          }
        ]
      }
    ]
  }
]