Mode validation

Tous les endpoints POST supportent le paramètre validationOnly pour valider vos données sans les enregistrer.

Utilisation

POST /articles?validationOnly=true
POST /orders?validationOnly=true
POST /procurements?validationOnly=true
POST /customers?validationOnly=true
POST /suppliers?validationOnly=true

Comportement

Quand validationOnly=true :

Toutes les validations sont exécutées : champs obligatoires, formats, longueurs max, existence des articles/clients/fournisseurs, unicité des identifiants
Aucune donnée n’est persistée en base de données
La réponse est identique à un appel normal : vous recevez l’OperationResult complet avec les erreurs éventuelles

Cas d’usage

Test d’intégration : Validez le format de vos données avant la mise en production
Pré-validation : Vérifiez qu’une commande passera la validation avant de l’envoyer définitivement
Diagnostic : Identifiez les erreurs sans impact sur les données réelles

Exemple

curl -X POST "https://api.ezyconnect.com/orders?validationOnly=true" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[{
    "activityCode": "001",
    "activityName": "Mon activité",
    "orderUniqueID": "TEST_001",
    "customerOrderPlacementDate": "2024-06-15T00:00:00Z",
    "deliveryAddressLastname": "Dupont",
    "deliveryAddressAddress1": "1 rue de la Paix",
    "deliveryAddressPostalCode": "75001",
    "deliveryAddressCity": "Paris",
    "deliveryAddressCountry": "FR",
    "deliveryAddressPhone": "0612345678",
    "deliveryAddressEmail": "test@example.com",
    "transportServiceCode": "STD",
    "orderEntries": [{
      "orderLineID": "1",
      "articleReference": "ART001",
      "quantityToPrepare": 2
    }]
  }]'

Réponse si validation OK :

{
  "status": 0,
  "operationId": "abc-123",
  "errors": {},
  "passed": ["TEST_001"]
}