Version	Description	Date	Auteur
2.0.4	Ajout de l'endpoint TransportScheduleRouteEtag pour les routes de transport avec arrêts intégrés	2026-05-03	DDH
2.0.3	Ajout de l'endpoint PrognosesReservation pour les réservations de prévision	2026-03-09	DDH
2.0.2	Modification des routes ListPreOrderGroupItemEtag : Count/ et /	2026-01-09	DDH
2.0.1	Ajout d'endpoints Count à tous les endpoints (sauf ShopFavorites) pour le total d'enregistrements	2026-01-08	DDH
2.0.0	Version V2 initiale de l'API avec synchronisation basée sur Etag	2026-01-08	DDH

Pour commencer

Introduction

L'API V2 utilise une synchronisation basée sur Etag pour une récupération incrémentielle efficace des données. Chaque enregistrement contient une valeur Etag — il suffit de passer l'Etag du dernier enregistrement pour obtenir le lot suivant d'enregistrements nouveaux ou modifiés.

Améliorations clés en V2 :

Pagination basée sur Etag pour une synchronisation incrémentielle fiable
Tous les endpoints supportent la synchronisation incrémentielle

L'autorisation fonctionne comme en V1 — vous devez être autorisé pour chaque base de données à laquelle vous vous connectez. Si non autorisé, vous recevrez le statut HTTP 401 (Unauthorized).

Les sections ci-dessous décrivent :

Informations générales sur les formats JSON, codes de statut et Etags
Tous les endpoints GET disponibles organisés par catégorie
Spécifications détaillées des modèles

Général

JSON

Informations sur les types spécifiques et leur formatage en JSON.

Format DateTime

Symbole	Description	Exemple
yyyy	année	2026
MM	mois	01
dd	jour	31
HH	heure	13
mm	minute	01
ss	secondes	22
tttttt	fuseau horaire	+02:00
Z	fuseau UTC	Z

Date

**Format 😗* yyyy-MM-dd
**Exemple 😗* 2026-12-30

DateTime

**Format 😗* yyyy-MM-dd\THH:mm:ssttttttt
**Exemple 😗* 2026-12-30T13:40:20+02:00
**Remarques 😗* Utiliser le fuseau horaire du débiteur

LanguageValue

Objet contenant toutes les langues disponibles (ISO-639-1).

{
  "nl": "Désignation néerlandaise",
  "de": "Désignation allemande",
  "fr": "Titre français"
}

Valeur Null

N'envoyez pas de paramètres sans valeur.

**Faux 😗*

{
  "RequiredParameter": "text",
  "OptionalParameter": null
}

**Correct 😗*

{
  "RequiredParameter": "text"
}

Encodage

UTF-8

ETags (Entity Tags)

L'API V2 utilise des ETags pour une synchronisation incrémentielle efficace. Chaque enregistrement contient une valeur Etag qui s'incrémente à chaque modification.

Comment fonctionne la synchronisation Etag

**Synchronisation initiale 😗* appeler l'endpoint sans paramètre Etag pour obtenir le premier lot
**Obtenir le dernier Etag 😗* prendre l'Etag du dernier enregistrement de la réponse
**Synchronisation suivante 😗* passer cet Etag comme paramètre pour obtenir le lot suivant
**Répéter 😗* continuer jusqu'à recevoir un tableau vide

Exemple de flux

# Première requête - sans Etag
GET /api/v2/ArticleEtag
# Retourne 2000 enregistrements, le dernier a Etag: "a1b2c3d4-..."

# Deuxième requête - utiliser le dernier Etag
GET /api/v2/ArticleEtag/a1b2c3d4-...
# Retourne les 2000 enregistrements suivants, dernier Etag: "e5f6g7h8-..."

# Troisième requête
GET /api/v2/ArticleEtag/e5f6g7h8-...
# Retourne [] - synchronisation terminée

En stockant et réutilisant le dernier Etag, vous ne recevez que les enregistrements nouveaux ou modifiés lors des synchronisations suivantes.

Important : Gestion des mises à jour

Les enregistrements peuvent apparaître plusieurs fois dans différentes requêtes de synchronisation lorsqu'ils sont modifiés.

Lorsque vous recevez un enregistrement avec un ID qui existe déjà dans votre base de données locale, écrasez l'enregistrement existant avec les nouvelles données. Il s'agit d'une mise à jour, pas d'un doublon.

**Scénario d'exemple 😗*

La synchronisation initiale retourne l'Article avec Id "articles/123" et Name "Red Roses"
L'article est modifié dans EasyFlor (nom changé en "Red Roses Premium")
La synchronisation incrémentielle suivante retourne le même Id "articles/123" avec Name mis à jour "Red Roses Premium"
**Action 😗* Écraser votre enregistrement local avec Id "articles/123"

**Principe clé 😗* Le champ Id est l'identifiant unique. Si vous recevez un enregistrement avec un Id que vous avez déjà, il s'agit d'une mise à jour — remplacez complètement l'ancien enregistrement par les nouvelles données.

Codes de statut

Code	Description
200	OK - Requête réussie
400	BadRequest - Objet contenant l'erreur
401	Unauthorized - Authentification requise ou échouée
404	NotFound - Ressource introuvable
500	ServerError - Erreur lors du traitement du message

**Format de réponse d'erreur 😗*

{
  "error": "<error>",
  "message": "<message lisible par l'humain>"
}

Astuces

L'ordre des propriétés en JSON n'est pas garanti — analyser par nom de propriété, pas par position
Toute propriété non requise peut être NULL
Toujours utiliser l'Etag du dernier enregistrement dans la réponse pour la requête suivante
Une réponse de tableau vide signifie que la synchronisation est terminée
Tous les endpoints ont un endpoint /Count pour vérifier le nombre total d'enregistrements

Endpoints Count

Chaque endpoint V2 a un endpoint Count correspondant pour récupérer le nombre total d'enregistrements sans charger les données :

**Format 😗* GET /api/v2/{EndpointName}/Count

**Exemples 😗*

GET /api/v2/PurchaseEtag/Count - Retourne le nombre total d'achats
GET /api/v2/DebtorEtag/Count - Retourne le nombre total de débiteurs
GET /api/v2/ListPreOrderGroupItemEtag/Count/{id} - Retourne le total d'items dans un groupe spécifique

**Retourne 😗* Entier représentant le total

**Note 😗* ShopFavoritesEtag n'a pas d'endpoint Count en raison de sa logique d'agrégation complexe.

Recommandations de fréquence de synchronisation

Les différents endpoints ont des fréquences de synchronisation recommandées différentes selon la fréquence de changement des données :

Endpoints de données en temps réel (intervalle de 5 minutes recommandé)

Ces endpoints fournissent des données transactionnelles fréquemment modifiées :

PreOrder
Purchase
DistributedPurchase
DistributedPurchaseOrderable
Invoice
DebetInvoicePurchaseItem
DebetInvoiceCustomItem
DebetInvoicePackagingItem
DebetInvoiceTrolleyItem
CreditInvoicePurchaseItem
CreditInvoiceCustomItem
CreditInvoiceDepositItem
Payment
DistributedTrolley
Supplier
Debtor
ListPreOrderGroupItem
ListArticleSort
PrognosesReservation

**Recommandation 😗* Synchroniser toutes les 5 minutes pendant les heures ouvrables.

Endpoints de données horaires (intervalle d'1 heure recommandé)

Ces endpoints fournissent des données logistiques modérément changeantes :

TransportScheduleRoute

**Recommandation 😗* Synchroniser une fois par heure pendant les heures opérationnelles.

Endpoints de données de référence (synchronisation quotidienne recommandée)

Ces endpoints fournissent des données de référence relativement statiques :

Administration
Country
Currency
Location
MarkupCategory
Remark
ListGroup
Employee
Article
ArticleSort
ArticleGroup
ShopDebtorSession
ShopFavorites
PrognosePrice
PrognoseQuantity

**Recommandation 😗* Synchroniser une fois par jour. Pour répartir la charge serveur, randomiser l'heure de synchronisation de chaque endpoint dans la journée plutôt que de tout synchroniser à heure fixe.

Autorisation / connexion

**Commande 😗* api/authorization

En cas de succès, vous recevrez un cookie contenant une session. Ajoutez ce cookie à tous vos autres appels. La session est liée à l'utilisateur et expirera lors d'un nouvel appel avec le même nom d'utilisateur et une connexion valide.

Lors de la réception du code HTTP 401, réauthorisez.

Paramètres Post

Nom propriété	Description	Type	Requis
Username	Nom d'utilisateur de la base de données à laquelle se connecter	string	oui
Password	Mot de passe de l'utilisateur de la base de données	string	oui
Database	Base de données à laquelle se connecter	string	oui

Exemple Post

POST https://api.easyflor.eu/api/authorization

{
  "Username": "api",
  "Password": "wouldntyouliketoknow",
  "Database": "EasyFlor-Demo"
}

**Retourne 😗* 200 OK / 401 Unauthorized

Autorisation par JWT Bearer Token

**Commande 😗* api/authorizationtoken

En cas de succès, vous recevrez un modèle contenant un Token. Ajoutez ce token comme header à tous vos autres appels. Le token est lié à l'utilisateur et expirera après la date d'expiration.

Lors de la réception du code HTTP 401, réauthorisez.

Paramètres Post

Nom propriété	Description	Type	Requis
Username	Nom d'utilisateur de la base de données	string	oui
Password	Mot de passe de l'utilisateur	string	oui
Database	Base de données	string	oui

Exemple Post

POST https://api.easyflor.eu/api/authorizationtoken

{
  "Username": "api",
  "Password": "wouldntyouliketoknow",
  "Database": "EasyFlor-Demo"
}

**Retourne 😗* 200 OK / 401 Unauthorized

Nom propriété	Description	Type
Token	Token utilisé pour l'authentification de chaque requête	string
Expiration	Date d'expiration après laquelle le token ne sera plus valide	DateTime

Exemple de requête authentifiée

curl --location --request GET 'https://api.easyflor.eu/api/v2/ArticleEtag' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ##TOKEN##'

Déconnexion

**Commande 😗* api/unauthorization

Déconnexion par cookie. Lors de l'envoi, le cookie qui a démarré la session est invalidé et toute commande suivante recevra une exception 401 unauthorized.

**Paramètres Post 😗* Aucun

**Exemple Post 😗*

POST https://api.easyflor.eu/api/unauthorization

**Retourne 😗* Rien

Données de référence

Debtors

**Endpoints 😗*

GET /api/v2/DebtorEtag/{etag?} - Récupérer les débiteurs
GET /api/v2/DebtorEtag/Count - Obtenir le total

Une entreprise ou personne à qui sont livrés des marchandises et envoyées des factures.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente pour synchronisation incrémentielle	non

Exemple

# Synchronisation initiale
GET https://api.easyflor.eu/api/v2/DebtorEtag

# Synchronisation incrémentielle
GET https://api.easyflor.eu/api/v2/DebtorEtag/a1b2c3d4-e5f6-7890-abcd-ef1234567890

Retourne

Tableau d'objets DebtorEtagResult (max 2000 par requête)

Suppliers

**Endpoints 😗*

GET /api/v2/SupplierEtag/{etag?} - Récupérer les fournisseurs
GET /api/v2/SupplierEtag/Count - Obtenir le total

Une entreprise ou personne qui livre des marchandises à l'entreprise dont vous interrogez la base de données.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente pour synchronisation incrémentielle	non

Exemple

# Synchronisation initiale
GET https://api.easyflor.eu/api/v2/SupplierEtag

# Synchronisation incrémentielle
GET https://api.easyflor.eu/api/v2/SupplierEtag/a1b2c3d4-e5f6-7890-abcd-ef1234567890

Retourne

Tableau d'objets SupplierEtagResult (max 2000 par requête)

Employee

**Endpoints 😗*

GET /api/v2/EmployeeEtag/{etag?} - Récupérer les employés
GET /api/v2/EmployeeEtag/Count - Obtenir le total

Un employé qui travaille dans l'entreprise dont vous interrogez la base de données.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente pour synchronisation incrémentielle	non

Exemple

GET https://api.easyflor.eu/api/v2/EmployeeEtag

Retourne

Tableau d'objets EmployeeEtagResult (max 1000 par requête)

Countries

**Endpoints 😗*

GET /api/v2/CountryEtag/{etag?} - Récupérer les pays
GET /api/v2/CountryEtag/Count - Obtenir le total

Un pays stocké dans notre base de données. Lié aux débiteurs, factures, fournisseurs, etc.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/CountryEtag

Retourne

Tableau d'objets CountryEtagResult (max 1000 par requête)

Currencies

**Endpoints 😗*

GET /api/v2/CurrencyEtag/{etag?} - Récupérer les devises
GET /api/v2/CurrencyEtag/Count - Obtenir le total

Devises utilisées dans le système.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/CurrencyEtag

Retourne

Tableau d'objets CurrencyEtagResult (max 1000 par requête)

Administrations

**Endpoints 😗*

GET /api/v2/AdministrationEtag/{etag?} - Récupérer les administrations
GET /api/v2/AdministrationEtag/Count - Obtenir le total

Administrations stockées dans notre base de données. Liées aux débiteurs, locations, etc.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/AdministrationEtag

Retourne

Tableau d'objets AdministrationEtagResult (max 1000 par requête)

Locations

**Endpoints 😗*

GET /api/v2/LocationEtag/{etag?} - Récupérer les emplacements
GET /api/v2/LocationEtag/Count - Obtenir le total

Emplacements stockés dans notre base de données. Liés aux débiteurs, achats, etc.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/LocationEtag

Retourne

Tableau d'objets LocationEtagResult (max 1000 par requête)

Articles & Produits

Article

**Endpoints 😗*

GET /api/v2/ArticleEtag/{etag?} - Récupérer les articles
GET /api/v2/ArticleEtag/Count - Obtenir le total

Un article, comme des roses rouges.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/ArticleEtag

Retourne

Tableau d'objets ArticleEtagResult (max 2000 par requête)

ArticleSort

**Endpoints 😗*

GET /api/v2/ArticleSortEtag/{etag?} - Récupérer les sortes d'articles
GET /api/v2/ArticleSortEtag/Count - Obtenir le total

Une variation d'un article. Par exemple des roses rouges avec une sorte 50cm et 60cm.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/ArticleSortEtag

Retourne

Tableau d'objets ArticleSortEtagResult (max 2000 par requête)

ArticleGroup

**Endpoints 😗*

GET /api/v2/ArticleGroupEtag/{etag?} - Récupérer les groupes d'articles
GET /api/v2/ArticleGroupEtag/Count - Obtenir le total

Une catégorie pour articles. Les catégories peuvent être imbriquées. Par exemple, la catégorie Roses tombe sous la catégorie Fleurs.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/ArticleGroupEtag

Retourne

Tableau d'objets ArticleGroupEtagResult (max 2000 par requête)

Markup Categories

**Endpoints 😗*

GET /api/v2/MarkupCategoryEtag/{etag?} - Récupérer les catégories de majoration
GET /api/v2/MarkupCategoryEtag/Count - Obtenir le total

Catégories de majoration utilisées pour le calcul des prix.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/MarkupCategoryEtag

Retourne

Tableau d'objets MarkupCategoryEtagResult (max 1000 par requête)

Remarks

**Endpoints 😗*

GET /api/v2/RemarkEtag/{etag?} - Récupérer les remarques
GET /api/v2/RemarkEtag/Count - Obtenir le total

Remarques d'articles stockées dans la base de données.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/RemarkEtag

Retourne

Tableau d'objets RemarkEtagResult (max 1000 par requête)

Webshop

ListGroup

**Endpoints 😗*

GET /api/v2/ListGroupEtag/{etag?} - Récupérer les groupes de liste
GET /api/v2/ListGroupEtag/Count - Obtenir le total

Un groupe de liste est une collection de listes affichées sous un seul en-tête dans la boutique.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/ListGroupEtag

Retourne

Tableau d'objets ListGroupEtagResult (max 1000 par requête)

ListArticleSort

**Endpoints 😗*

GET /api/v2/ListArticleSortEtag/{etag?} - Récupérer les sortes d'articles de liste
GET /api/v2/ListArticleSortEtag/Count - Obtenir le total

Une sorte d'article proposée sur une liste webshop.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/ListArticleSortEtag

Retourne

Tableau d'objets ListArticleSortEtagResult (max 1000 par requête)

ListPreOrderGroupItem

**Endpoints 😗*

GET /api/v2/ListPreOrderGroupItemEtag/{id} - Récupérer les items (synchronisation initiale)
GET /api/v2/ListPreOrderGroupItemEtag/{etag}/{id} - Récupérer les items (synchronisation incrémentielle)
GET /api/v2/ListPreOrderGroupItemEtag/Count/{id} - Obtenir le total

Items dans un groupe de pré-commande de liste spécifique.

Paramètres

Paramètre	Description	Requis
id	ID du ListPreOrderGroup (ex., `ListPreOrderGroups/123`)	oui
etag	Etag de la requête précédente	non

Exemple

# Synchronisation initiale
GET https://api.easyflor.eu/api/v2/ListPreOrderGroupItemEtag/ListPreOrderGroups/123

# Synchronisation incrémentielle
GET https://api.easyflor.eu/api/v2/ListPreOrderGroupItemEtag/a1b2c3d4-e5f6-7890-abcd-ef1234567890/ListPreOrderGroups/123

# Count
GET https://api.easyflor.eu/api/v2/ListPreOrderGroupItemEtag/Count/ListPreOrderGroups/123

Retourne

Tableau d'objets ListPreOrderGroupItemEtagResult (max 2000 par requête)

Favorites

**Endpoint 😗* GET /api/v2/ShopFavoritesEtag/{etag?}

Articles favoris par débiteur pour le webshop.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/ShopFavoritesEtag

Retourne

Tableau d'objets ShopFavoritesEtagResult (max 1000 par requête)

DebtorSessions

**Endpoints 😗*

GET /api/v2/ShopDebtorSessionEtag/{etag?} - Récupérer les sessions de débiteur
GET /api/v2/ShopDebtorSessionEtag/Count - Obtenir le total

Enregistrements de session de débiteur contenant les dernières activités connues.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/ShopDebtorSessionEtag

Retourne

Tableau d'objets ShopDebtorSessionEtagResult (max 1000 par requête)

Commandes & Achats

PreOrder

**Endpoints 😗*

GET /api/v2/PreOrderEtag/{etag?} - Récupérer les pré-commandes
GET /api/v2/PreOrderEtag/Count - Obtenir le total

La demande pour une certaine sorte d'article d'un débiteur.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/PreOrderEtag

Retourne

Tableau d'objets PreOrderEtagResult (max 2000 par requête)

Purchase

**Endpoints 😗*

GET /api/v2/PurchaseEtag/{etag?} - Récupérer les achats
GET /api/v2/PurchaseEtag/Count - Obtenir le total

Un achat est une action d'achat de l'entreprise dont vous interrogez la base, depuis un fournisseur.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/PurchaseEtag

Retourne

Tableau d'objets PurchaseEtagResult (max 2000 par requête)

DistributedPurchase

**Endpoints 😗*

GET /api/v2/DistributedPurchaseEtag/{etag?} - Récupérer les achats distribués
GET /api/v2/DistributedPurchaseEtag/Count - Obtenir le total

Un achat distribué représente des marchandises d'un achat qui ont été allouées/vendues à un débiteur spécifique.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/DistributedPurchaseEtag

Retourne

Tableau d'objets DistributedPurchaseEtagResult (max 1024 par requête)

DistributedPurchaseOrderable

**Endpoints 😗*

GET /api/v2/DistributedPurchaseOrderableEtag/{etag?} - Récupérer les achats distribués commandables
GET /api/v2/DistributedPurchaseOrderableEtag/Count - Obtenir le total

Achats distribués commandables.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/DistributedPurchaseOrderableEtag

Retourne

Tableau d'objets DistributedPurchaseOrderableEtagResult (max 2000 par requête)

Facturation - Débit

Invoice

**Endpoints 😗*

GET /api/v2/InvoiceEtag/{etag?} - Récupérer les factures
GET /api/v2/InvoiceEtag/Count - Obtenir le total

Une facture créée pour un débiteur (factures de crédit et de débit).

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/InvoiceEtag

Retourne

Tableau d'objets InvoiceEtagResult (max 2000 par requête)

DebetInvoicePurchaseItem

**Endpoints 😗*

GET /api/v2/DebetInvoicePurchaseItemEtag/{etag?} - Récupérer les items d'achat de factures débit
GET /api/v2/DebetInvoicePurchaseItemEtag/Count - Obtenir le total

Fleurs et plantes vendues à un débiteur puis facturées.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/DebetInvoicePurchaseItemEtag

Retourne

Tableau d'objets DebetInvoicePurchaseItemEtagResult (max 2000 par requête)

DebetInvoiceCustomItem

**Endpoints 😗*

GET /api/v2/DebetInvoiceCustomItemEtag/{etag?} - Récupérer les items personnalisés des factures débit
GET /api/v2/DebetInvoiceCustomItemEtag/Count - Obtenir le total

Lignes personnalisées sur les factures débit créées par l'utilisateur sans lien avec un achat.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/DebetInvoiceCustomItemEtag

Retourne

Tableau d'objets DebetInvoiceCustomItemEtagResult (max 2000 par requête)

DebetInvoicePackagingItem

**Endpoints 😗*

GET /api/v2/DebetInvoicePackagingItemEtag/{etag?} - Récupérer les items d'emballage des factures débit
GET /api/v2/DebetInvoicePackagingItemEtag/Count - Obtenir le total

Emballage (Néerlandais : fust) qui est facturé.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/DebetInvoicePackagingItemEtag

Retourne

Tableau d'objets DebetInvoicePackagingItemEtagResult (max 2000 par requête)

DebetInvoiceTrolleyItem

**Endpoints 😗*

GET /api/v2/DebetInvoiceTrolleyItemEtag/{etag?} - Récupérer les items chariots des factures débit
GET /api/v2/DebetInvoiceTrolleyItemEtag/Count - Obtenir le total

Chariots (Néerlandais : karren) qui sont facturés.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/DebetInvoiceTrolleyItemEtag

Retourne

Tableau d'objets DebetInvoiceTrolleyItemEtagResult (max 2000 par requête)

Facturation - Crédit

CreditInvoicePurchaseItem

**Endpoints 😗*

GET /api/v2/CreditInvoicePurchaseItemEtag/{etag?} - Récupérer les items d'achat des factures crédit
GET /api/v2/CreditInvoicePurchaseItemEtag/Count - Obtenir le total

Fleurs et plantes vendues à un débiteur, facturées puis créditées.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/CreditInvoicePurchaseItemEtag

Retourne

Tableau d'objets CreditInvoicePurchaseItemEtagResult (max 2000 par requête)

CreditInvoiceCustomItem

**Endpoints 😗*

GET /api/v2/CreditInvoiceCustomItemEtag/{etag?} - Récupérer les items personnalisés des factures crédit
GET /api/v2/CreditInvoiceCustomItemEtag/Count - Obtenir le total

Lignes personnalisées sur les factures crédit créées par l'utilisateur sans lien avec un achat.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/CreditInvoiceCustomItemEtag

Retourne

Tableau d'objets CreditInvoiceCustomItemEtagResult (max 2000 par requête)

CreditInvoiceDepositItem

**Endpoints 😗*

GET /api/v2/CreditInvoiceDepositItemEtag/{etag?} - Récupérer les items de consigne des factures crédit
GET /api/v2/CreditInvoiceDepositItemEtag/Count - Obtenir le total

Emballage (Néerlandais : fust) et chariots (Néerlandais : karren) ayant un prix de consigne et ayant été retournés par le débiteur.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/CreditInvoiceDepositItemEtag

Retourne

Tableau d'objets CreditInvoiceDepositItemEtagResult (max 2000 par requête)

Paiements & Chariots

Payment

**Endpoints 😗*

GET /api/v2/PaymentEtag/{etag?} - Récupérer les paiements
GET /api/v2/PaymentEtag/Count - Obtenir le total

Paiements enregistrés pour les factures (transactions bancaires, paiements en espèces, chèques).

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/PaymentEtag

Retourne

Tableau d'objets PaymentEtagResult (max 2000 par requête)

DistributedTrolley

**Endpoints 😗*

GET /api/v2/DistributedTrolleyEtag/{etag?} - Récupérer les chariots distribués
GET /api/v2/DistributedTrolleyEtag/Count - Obtenir le total

Enregistrements de distribution de chariots.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/DistributedTrolleyEtag

Retourne

Tableau d'objets DistributedTrolleyEtagResult (max 2000 par requête)

Prévisions

PrognosePrice

**Endpoints 😗*

GET /api/v2/PrognosePriceEtag/{etag?} - Récupérer les prix prévisionnels
GET /api/v2/PrognosePriceEtag/Count - Obtenir le total

Prévisions de prix par article, semaine et année. Ne retourne des données que pour l'année en cours et la suivante.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/PrognosePriceEtag

Retourne

Tableau d'objets PrognosePriceEtagResult (max 2000 par requête)

PrognoseQuantity

**Endpoints 😗*

GET /api/v2/PrognoseQuantityEtag/{etag?} - Récupérer les quantités prévisionnelles
GET /api/v2/PrognoseQuantityEtag/Count - Obtenir le total

Prévisions de quantité par article, semaine et année. Inclut la distribution par jour de la semaine. Ne retourne des données que pour l'année en cours et la suivante.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

GET https://api.easyflor.eu/api/v2/PrognoseQuantityEtag

Retourne

Tableau d'objets PrognoseQuantityEtagResult (max 2000 par requête)

PrognosesReservation

**Endpoints 😗*

GET /api/v2/PrognosesReservationEtag/{etag?} - Récupérer les réservations prévisionnelles
GET /api/v2/PrognosesReservationEtag/Count - Obtenir le total

Réservations prévisionnelles par débiteur, contenant les composants d'articles, les attributions journalières et les détails de pré-commande. Utilisées pour gérer les quantités prévisionnelles réservées par semaine et par année.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

# Synchronisation initiale
GET https://api.easyflor.eu/api/v2/PrognosesReservationEtag

# Synchronisation incrémentielle
GET https://api.easyflor.eu/api/v2/PrognosesReservationEtag/a1b2c3d4-e5f6-7890-abcd-ef1234567890

Retourne

Tableau d'objets PrognosesReservationEtagResult (max 2000 par requête)

Logistique

TransportScheduleRoute

**Endpoints 😗*

GET /api/v2/TransportScheduleRouteEtag/{etag?} - Récupérer les routes de transport
GET /api/v2/TransportScheduleRouteEtag/Count - Obtenir le total

Routes de transport planifiées par jour, incluant chauffeur, véhicule et arrêts intégrés avec informations logistiques calculées (heures d'arrivée, distance, durée). Chaque route appartient à un TransportSchedule (un planning par jour) et contient une liste ordonnée d'arrêts. Les arrêts peuvent être des arrêts Debtor (livraison à un ou plusieurs clients) ou Vehicle (collecte/dépose du véhicule). Les objets Info sur les routes et arrêts contiennent les valeurs produites par le moteur d'optimisation.

Paramètres

Paramètre	Description	Requis
etag	Etag de la requête précédente	non

Exemple

# Synchronisation initiale
GET https://api.easyflor.eu/api/v2/TransportScheduleRouteEtag

# Synchronisation incrémentielle
GET https://api.easyflor.eu/api/v2/TransportScheduleRouteEtag/a1b2c3d4-e5f6-7890-abcd-ef1234567890

Retourne

Tableau d'objets TransportScheduleRouteEtagResult (max 1000 par requête)

Modèles

Tous les modèles de réponse sont listés ci-dessous avec leurs propriétés. Les noms de propriétés, types de données et structures restent en anglais conformément à la convention API.

AdministrationEtagResult

Hérite de Export_AdministrationTransformer.Result

Property	Description	Data type	Required
Id	Id of the administration	string	yes
Name	Name of the administration	string	yes
DateTimeLastModified	Last modification date/time	DateTime	yes
Etag	Etag for next request	Guid	yes

ArticleEtagResult

Property	Description	Data type	Required
Id	Id of the article	string	yes
Name	Name of article	LanguageValues	yes
Code	Code of article	string	yes
Features	Features of the article	IEnumerable<Feature>	yes
Tags	Tags given to article	IEnumerable<LanguageValues>	yes
SecondaryColor	RHS secondary color code	string	no
Color	RHS primary color code	string	no
FreshDays	Days the product stays fresh	int?	no
VBNCode	VBN code of article	string	no
ArticleGroupId	Id of the article group	string	yes
LastModifiedOn	Last modification date/time	DateTime	yes
Etag	Etag for next request	Guid	yes

Feature object:

Property	Description	Data type
FeatureName	Name of feature	LanguageValues
FeatureCode	Code of feature	string
FeatureTypeName	Name of feature type	LanguageValues
FeatureTypeCode	Code of feature type	string

Pour la définition complète de tous les modèles restants (ArticleSortEtagResult, ArticleGroupEtagResult, CountryEtagResult, CreditInvoice, CurrencyEtagResult, DebetInvoice*, DebtorEtagResult, DistributedPurchase*, DistributedTrolleyEtagResult, EmployeeEtagResult, InvoiceEtagResult, ListArticleSortEtagResult, ListGroupEtagResult, ListPreOrderGroupItemEtagResult, LocationEtagResult, MarkupCategoryEtagResult, PaymentEtagResult, PreOrderEtagResult, PrognosePriceEtagResult, PrognoseQuantityEtagResult, PrognosesReservationEtagResult, PurchaseEtagResult, RemarkEtagResult, ShopDebtorSessionEtagResult, ShopFavoritesEtagResult, SupplierEtagResult, TransportScheduleRouteEtagResult), veuillez consulter la version anglaise de cette documentation qui contient toutes les définitions de propriétés détaillées.*

Vous avez des questions ou besoin d'aide? N'hésitez pas à nous contacter par téléphone au +31 (0)71 30 20 310 ou envoyez un e-mail à support@easyflor.nl.

API v2

Table des matières

Pour commencer

Données de référence

Articles & Produits

Webshop

Commandes & Achats

Facturation - Débit

Facturation - Crédit

Paiements & Chariots

Prévisions

Logistique

Référence des modèles

Changelog

Pour commencer

Introduction

Général

JSON

Format DateTime

Date

DateTime

LanguageValue

Valeur Null

Encodage

ETags (Entity Tags)

Comment fonctionne la synchronisation Etag

Exemple de flux

Important : Gestion des mises à jour

Codes de statut

Astuces

Endpoints Count

Recommandations de fréquence de synchronisation

Endpoints de données en temps réel (intervalle de 5 minutes recommandé)

Endpoints de données horaires (intervalle d'1 heure recommandé)

Endpoints de données de référence (synchronisation quotidienne recommandée)

Autorisation / connexion

Autorisation par Cookie

Paramètres Post

Exemple Post

Autorisation par JWT Bearer Token

Paramètres Post

Exemple Post

Exemple de requête authentifiée

Déconnexion

Données de référence

Debtors

Paramètres

Exemple

Retourne

Suppliers

Paramètres

Exemple

Retourne

Employee

Paramètres

Exemple

Retourne

Countries

Paramètres

Exemple

Retourne

Currencies

Paramètres

Exemple

Retourne

Administrations

Paramètres

Exemple

Retourne

Locations

Paramètres

Exemple

Retourne

Articles & Produits

Article

Paramètres

Exemple

Retourne

ArticleSort

Paramètres