Créer des commandes

POST /orders

Crée une ou plusieurs commandes de préparation. Chaque commande reçoit un identifiant unique (orderUniqueID) qui ne peut pas être réutilisé.

Paramètres de requête

Paramètre	Type	Défaut	Description
`validationOnly`	`bool`	`false`	Si `true`, valide sans persister

Champs de la commande

Identification (obligatoires)

Champ	Type	Max	Description
`activityCode`	string	3	Code activité
`activityName`	string	30	Libellé de l’activité
`orderUniqueID`	string	20	Identifiant unique de la commande. Format : `^(?!.*\s)[A-Z0-9_\-.#/\\]+$` (pas d’espaces)
`customerOrderPlacementDate`	DateTime	—	Date de passation de la commande client

Informations commande

Champ	Type	Max	Requis	Description
`subActivityCode`	string	3	Non	Code sous-activité
`operationType`	string	1	Non	Type d’opération
`customerOrderID`	string	30	Non	N° de commande client
`prepOrderGroupID`	string	14	Non	Groupe de préparation
`commandChannelDescription`	string	50	Non	Canal de commande
`commandType`	string	50	Non	Type de commande
`expectedPrepDate`	DateTime	—	Non	Date de préparation souhaitée
`dOManagedCustomerNumber`	string	50	Conditionnel	N° client géré. Obligatoire si `config.CheckCustomer` est activé

Adresse de livraison (obligatoires)

Champ	Type	Max	Description
`deliveryAddressLastname`	string	30	Nom du destinataire
`deliveryAddressAddress1`	string	35	Adresse ligne 1
`deliveryAddressPostalCode`	string	20	Code postal
`deliveryAddressCity`	string	50	Ville
`deliveryAddressCountry`	string	2	Code pays ISO 3166-1 alpha-2
`deliveryAddressPhone`	string	20	Téléphone
`deliveryAddressEmail`	string	100	Email

Adresse de livraison (optionnels)

Champ	Type	Max	Description
`deliveryAddressTitle`	string	5	Civilité
`deliveryAddressFirstname`	string	30	Prénom
`deliveryAddressCompany`	string	50	Société
`deliveryAddressAddress2`	string	35	Adresse ligne 2
`deliveryAddressAddress3`	string	35	Adresse ligne 3
`deliveryAddressFax`	string	20	Fax
`deliveryAddressNameOption`	string	50	Nom complémentaire
`deliveryAddressComment`	string	200	Commentaire livraison

Adresse de facturation

Mêmes champs que l’adresse de livraison, préfixés par billingAddress : billingAddressTitle, billingAddressLastname, billingAddressFirstname, billingAddressCompany, billingAddressAddress1 à 3, billingAddressPostalCode, billingAddressCity, billingAddressCountry, billingAddressPhone, billingAddressFax, billingAddressEmail

Tous optionnels.

Transport (obligatoire)

Champ	Type	Max	Requis	Description
`transportServiceCode`	string	50	Oui	Code service transport
`transportCode`	string	50	Non	Code transport
`deliveryPickupPointID`	string	25	Non	ID du point relais
`pickupPointCountryCode`	string	2	Non	Code pays du point relais
`carrierImposed`	bool	—	Non	Transporteur imposé

Informations financières

Champ	Type	Requis	Description
`totalInvoiceHT`	int	Conditionnel	Total HT en centimes. Obligatoire hors UE
`totalInvoiceTTC`	int	Non	Total TTC en centimes
`shippingCost`	int	Conditionnel	Frais de port en centimes. Obligatoire hors UE
`paymentCurrency`	string (30)	Conditionnel	Devise ISO 4217 (ex: `"EUR"`, `"USD"`). Obligatoire hors UE
`discountAmount`	int	Non	Montant remise en centimes
`discountRate`	int	Non	Taux remise (ex: `10` pour 10%)
`customerInvoiceNumber`	string (30)	Non	N° facture (défaut : `orderUniqueID`)

Options de livraison

Champ	Type	Requis	Description
`saturdayDeliveryRequired`	bool	Non	Livraison samedi
`recipientNotification`	bool	Non	Notification destinataire
`counterReimbursementRequested`	bool	Non	Contre-remboursement
`counterReimbursementAmount`	int	Non	Montant CR en centimes

Messages

Champ	Type	Max	Description
`deliveryComment`	string	200	Commentaire livraison
`shippingLabelMessage`	string	100	Message étiquette
`specificGiftMessage`	string	200	Message cadeau
`preparationInstructions`	string	200	Instructions de préparation

Champs personnalisés

Champ	Type	Max	Description
`customField1`, `customField2`	string	200	Texte libre
`customField3` à `customField11`	string	256	Texte libre
`customField12` à `customField15`	DateTime	—	Dates

Lignes de commande (`orderEntries`)

Champ	Type	Max	Requis	Description
`orderLineID`	string	35	Oui	Identifiant de la ligne (doit être > “0”)
`articleReference`	string	17	Oui	Référence article. Doit exister dans le référentiel (erreur 211)
`quantityToPrepare`	int	—	Oui	Quantité à préparer. Doit être > 0 (erreur 202)
`ownerStockCode`	string	3	Non	Code propriétaire stock
`unitPriceHT`	int	—	Conditionnel	Prix unitaire HT en centimes. Obligatoire hors UE
`unitPriceTTC`	int	—	Non	Prix unitaire TTC en centimes
`articleVATRate`	int	—	Non	Taux TVA (ex: `20` pour 20%)
`articleVATAmount`	int	—	Non	Montant TVA en centimes
`articleOriginCountry`	string	15	Conditionnel	Pays d’origine. Obligatoire hors UE
`articleCN23CustomsCode`	string	15	Conditionnel	Code douane CN23. Obligatoire hors UE
`articleNatureCN23`	string	35	Non	Nature CN23
`attachedLotNumber`	string	35	Non	N° de lot imposé
`articleHasSerialNumber`	bool	—	Non	Article avec n° de série
`articleHasDLUO`	bool	—	Non	Article avec DLUO
`articleHasLotNumber`	bool	—	Non	Article avec n° de lot
`allowPackagingSubstitution`	bool	—	Non	Substitution d’emballage autorisée. Défaut : `false`
`gradeCode`	string	3	Non	Code qualité. Défaut : `"STD"`
`articlePreparationComment`	string	100	Non	Commentaire préparation
`articleComment`	string	200	Non	Commentaire article
`articleRequiresIngredientLabel`	bool	—	Non	Étiquette ingrédients requise
`customField1`, `customField2`	int	—	Non	Champs personnalisés numériques
`customField3`, `customField4`	DateTime	—	Non	Champs personnalisés date
`customField5` à `customField11`	string	256	Non	Champs personnalisés texte
`customField12`	string	200	Non	Champ personnalisé texte

Sous-commandes (`orderSubOrders`)

Champ	Type	Max	Requis	Description
`clientOrderID`	string	30	Oui	Identifiant de la sous-commande
`clientOrderPlacementDate`	DateTime	—	Non	Date de passation
`subOrderHeader`	string	30	Non	En-tête
`subOrderClientMessage`	string	200	Non	Message client
`subOrderBreakCriterion`	string	5	Non	Critère de rupture
`orderEntries`	OrderEntry[]	—	Oui	Lignes (au moins une)
`customField1`, `customField2`	int	—	Non	Champs personnalisés numériques
`customField3`, `customField4`	DateTime	—	Non	Champs personnalisés date
`customField5` à `customField11`	string	256	Non	Champs personnalisés texte
`customField12`	string	200	Non	Champ personnalisé texte

Règles de validation

Champs obligatoires

activityCode, activityName, orderUniqueID, customerOrderPlacementDate
Adresse livraison : deliveryAddressLastname, deliveryAddressAddress1, deliveryAddressPostalCode, deliveryAddressCity, deliveryAddressCountry, deliveryAddressPhone, deliveryAddressEmail
transportServiceCode
Au moins une ligne ou une sous-commande

Format

orderUniqueID : ^(?!.*\s)[A-Z0-9_\-.#/\\]+$ — pas d’espaces
deliveryAddressCountry : ISO 3166-1 alpha-2

Structure exclusive

orderEntries OU orderSubOrders, jamais les deux (erreur 103)
Chaque sous-commande doit avoir au moins une ligne (erreur 213)

Lignes

quantityToPrepare > 0 (erreur 202)
articleReference doit exister dans le référentiel (erreur 211)

Unicité

orderUniqueID ne doit pas déjà exister en base (erreur 203)
Pas de doublons d’orderUniqueID dans un même envoi (erreur 205)
orderLineID doit être > "0" (erreur 104)

Commandes internationales (hors UE)

Pays UE : FR, MC, DE, AT, BE, BG, CY, HR, DK, ES, EE, FI, GR, HU, IE, IT, LV, LT, LU, MT, NL, PL, PT, RO, SK, SI, SE, CZ

Si le pays de livraison n’est pas dans cette liste, deviennent obligatoires :

totalInvoiceHT, shippingCost, paymentCurrency
Sur chaque ligne : articleOriginCountry, unitPriceHT, articleCN23CustomsCode

Adresse française

Validation code postal / ville via API data.geopf.fr/geocodage/ (Géoplateforme IGN) (erreur 802)
Monaco : utiliser country = "FR", postalCode = "98000" (pas "MC")

Téléphone (si configuré)

Validation et reformatage E.164 pour les pays : FR, ES, BE, DE, LU, PT, AT, UK, IT, GF, MF, MQ, YT, NL, IE, MC, CH, PL (erreur 207)

Erreurs possibles

Code	Description
103	Présence simultanée de `orderEntries` et `orderSubOrders`
104	Format `orderUniqueID` invalide (regex) ou `orderLineID` ≤ `"0"`
201	Champ obligatoire manquant
202	Valeur incorrecte (ex: `quantityToPrepare` ≤ 0, `ForcedPrioDateMinNumberOfDays` > 900)
203	`orderUniqueID` déjà existant en base
205	`orderUniqueID` en doublon dans le même envoi
206	Activité non autorisée
207	Numéro de téléphone invalide
211	Article inconnu dans le référentiel
213	Commande ou sous-commande sans ligne
216	Client inconnu dans le référentiel (si `config.CheckCustomer` activé)
302	Code pays de destination invalide
802	Adresse française non reconnue

Exemple de requête

Payload

[
  {
    "activityCode": "001",
    "activityName": "Mon activité",
    "orderUniqueID": "CMD-2024-001",
    "customerOrderID": "WEB-12345",
    "customerOrderPlacementDate": "2024-06-15T10:30:00Z",
    "transportServiceCode": "COLISSIMO",
    "deliveryAddressTitle": "M.",
    "deliveryAddressLastname": "Dupont",
    "deliveryAddressFirstname": "Jean",
    "deliveryAddressAddress1": "15 rue de la Paix",
    "deliveryAddressPostalCode": "75002",
    "deliveryAddressCity": "Paris",
    "deliveryAddressCountry": "FR",
    "deliveryAddressPhone": "0612345678",
    "deliveryAddressEmail": "jean.dupont@email.com",
    "totalInvoiceTTC": 5990,
    "shippingCost": 590,
    "orderEntries": [
      {
        "orderLineID": "1",
        "articleReference": "ART-001",
        "quantityToPrepare": 2,
        "unitPriceHT": 2200,
        "unitPriceTTC": 2640,
        "articleVATRate": 20
      },
      {
        "orderLineID": "2",
        "articleReference": "ART-002",
        "quantityToPrepare": 1,
        "unitPriceHT": 710,
        "unitPriceTTC": 852,
        "articleVATRate": 20
      }
    ]
  }
]

Exemples de code

curl -X POST "https://api.ezyconnect.com/orders" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[{"activityCode":"001","activityName":"Mon activité","orderUniqueID":"CMD-2024-001","customerOrderPlacementDate":"2024-06-15T10:30:00Z","transportServiceCode":"COLISSIMO","deliveryAddressLastname":"Dupont","deliveryAddressAddress1":"15 rue de la Paix","deliveryAddressPostalCode":"75002","deliveryAddressCity":"Paris","deliveryAddressCountry":"FR","deliveryAddressPhone":"0612345678","deliveryAddressEmail":"jean.dupont@email.com","orderEntries":[{"orderLineID":"1","articleReference":"ART-001","quantityToPrepare":2}]}]'

const response = await fetch("https://api.ezyconnect.com/orders", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify([{
    activityCode: "001",
    activityName: "Mon activité",
    orderUniqueID: "CMD-2024-001",
    customerOrderPlacementDate: "2024-06-15T10:30:00Z",
    transportServiceCode: "COLISSIMO",
    deliveryAddressLastname: "Dupont",
    deliveryAddressAddress1: "15 rue de la Paix",
    deliveryAddressPostalCode: "75002",
    deliveryAddressCity: "Paris",
    deliveryAddressCountry: "FR",
    deliveryAddressPhone: "0612345678",
    deliveryAddressEmail: "jean.dupont@email.com",
    orderEntries: [{ orderLineID: "1", articleReference: "ART-001", quantityToPrepare: 2 }]
  }])
});
const result = await response.json();
console.log(result);

import requests

payload = [{
    "activityCode": "001",
    "activityName": "Mon activité",
    "orderUniqueID": "CMD-2024-001",
    "customerOrderPlacementDate": "2024-06-15T10:30:00Z",
    "transportServiceCode": "COLISSIMO",
    "deliveryAddressLastname": "Dupont",
    "deliveryAddressAddress1": "15 rue de la Paix",
    "deliveryAddressPostalCode": "75002",
    "deliveryAddressCity": "Paris",
    "deliveryAddressCountry": "FR",
    "deliveryAddressPhone": "0612345678",
    "deliveryAddressEmail": "jean.dupont@email.com",
    "orderEntries": [{"orderLineID": "1", "articleReference": "ART-001", "quantityToPrepare": 2}]
}]

response = requests.post(
    "https://api.ezyconnect.com/orders",
    json=payload,
    headers={"Authorization": "Bearer YOUR_TOKEN"}
)
print(response.json())

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 orders = new[] { new {
    activityCode = "001", activityName = "Mon activité",
    orderUniqueID = "CMD-2024-001",
    customerOrderPlacementDate = "2024-06-15T10:30:00Z",
    transportServiceCode = "COLISSIMO",
    deliveryAddressLastname = "Dupont",
    deliveryAddressAddress1 = "15 rue de la Paix",
    deliveryAddressPostalCode = "75002",
    deliveryAddressCity = "Paris",
    deliveryAddressCountry = "FR",
    deliveryAddressPhone = "0612345678",
    deliveryAddressEmail = "jean.dupont@email.com",
    orderEntries = new[] { new { orderLineID = "1", articleReference = "ART-001", quantityToPrepare = 2 } }
}};

var response = await client.PostAsJsonAsync("https://api.ezyconnect.com/orders", orders);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);

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

String body = """
    [{"activityCode":"001","activityName":"Mon activité","orderUniqueID":"CMD-2024-001",
      "customerOrderPlacementDate":"2024-06-15T10:30:00Z","transportServiceCode":"COLISSIMO",
      "deliveryAddressLastname":"Dupont","deliveryAddressAddress1":"15 rue de la Paix",
      "deliveryAddressPostalCode":"75002","deliveryAddressCity":"Paris",
      "deliveryAddressCountry":"FR","deliveryAddressPhone":"0612345678",
      "deliveryAddressEmail":"jean.dupont@email.com",
      "orderEntries":[{"orderLineID":"1","articleReference":"ART-001","quantityToPrepare":2}]}]
    """;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.ezyconnect.com/orders"))
    .header("Authorization", "Bearer YOUR_TOKEN")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

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

Exemple de réponse

{
  "status": 0,
  "operationId": "e5f6a7b8-9012-cdef-3456-789012345678",
  "errors": {},
  "passed": ["CMD-2024-001"]
}