Version	Beschreibung	Datum	Autor
2.0.4	TransportScheduleRouteEtag-Endpunkt für Transportrouten mit eingebetteten Stopps hinzugefügt	2026-05-03	DDH
2.0.3	PrognosesReservation-Endpunkt für Prognosereservierungen hinzugefügt	2026-03-09	DDH
2.0.2	ListPreOrderGroupItemEtag-Routen geändert: Count/ und /	2026-01-09	DDH
2.0.1	Count-Endpunkte zu allen Endpunkten hinzugefügt (außer ShopFavorites) für Gesamtanzahl Datensätze	2026-01-08	DDH
2.0.0	Erste V2-API-Version mit Etag-basierter Synchronisierung	2026-01-08	DDH

Erste Schritte

Einführung

Die V2-API verwendet eine Etag-basierte Synchronisierung für effiziente inkrementelle Datenabfrage. Jeder Datensatz enthält einen Etag-Wert — übergeben Sie einfach den Etag des letzten Datensatzes, um den nächsten Batch neuer oder geänderter Datensätze zu erhalten.

Wichtige Verbesserungen in V2:

Etag-basierte Paginierung für zuverlässige inkrementelle Synchronisierung
Alle Endpunkte unterstützen inkrementelle Synchronisierung

Die Autorisierung funktioniert wie in V1 — Sie müssen für jede Datenbank, mit der Sie sich verbinden, autorisiert sein. Wenn nicht autorisiert, erhalten Sie HTTP-Status 401 (Unauthorized).

Die Abschnitte unten beschreiben:

Allgemeine Informationen über JSON-Formate, Statuscodes und Etags
Alle verfügbaren GET-Endpunkte nach Kategorie organisiert
Detaillierte Modellspezifikationen

Allgemein

JSON

Informationen über spezifische Typen und deren Formatierung in JSON.

DateTime-Format

Symbol	Beschreibung	Beispiel
yyyy	Jahr	2026
MM	Monat	01
dd	Tag	31
HH	Stunde	13
mm	Minute	01
ss	Sekunden	22
tttttt	Zeitzone	+02:00
Z	UTC-Zeitzone	Z

Date

Format: yyyy-MM-dd
Beispiel: 2026-12-30

DateTime

Format: yyyy-MM-dd\THH:mm:ssttttttt
Beispiel: 2026-12-30T13:40:20+02:00
Hinweis: Zeitzone des Debitors verwenden

LanguageValue

Objekt mit allen verfügbaren Sprachen (ISO-639-1).

{
  "nl": "Niederländische Bezeichnung",
  "de": "Deutsche Bezeichnung",
  "fr": "Französischer Titel"
}

Null-Wert

Senden Sie keine Parameter ohne Wert.

Falsch:

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

Richtig:

{
  "RequiredParameter": "text"
}

Kodierung

UTF-8

ETags (Entity Tags)

Die V2-API verwendet ETags für effiziente inkrementelle Synchronisierung. Jeder Datensatz enthält einen Etag-Wert, der sich mit jeder Änderung erhöht.

Wie Etag-Synchronisierung funktioniert

Initiale Synchronisierung: Endpunkt ohne Etag-Parameter aufrufen, um den ersten Batch zu erhalten
Letzten Etag holen: Etag des letzten Datensatzes aus der Antwort nehmen
Nächste Synchronisierung: Diesen Etag als Parameter übergeben, um den nächsten Batch zu erhalten
Wiederholen: Bis ein leeres Array empfangen wird

Beispiel-Flow

# Erste Anfrage - ohne Etag
GET /api/v2/ArticleEtag
# Gibt 2000 Datensätze zurück, letzter hat Etag: "a1b2c3d4-..."

# Zweite Anfrage - letzten Etag verwenden
GET /api/v2/ArticleEtag/a1b2c3d4-...
# Gibt nächste 2000 Datensätze zurück, letzter Etag: "e5f6g7h8-..."

# Dritte Anfrage
GET /api/v2/ArticleEtag/e5f6g7h8-...
# Gibt [] zurück - Synchronisierung abgeschlossen

Durch Speichern und Wiederverwenden des letzten Etag erhalten Sie nur neue oder geänderte Datensätze bei nachfolgenden Synchronisierungen.

Wichtig: Umgang mit Updates

Datensätze können in verschiedenen Synchronisierungsanfragen mehrfach erscheinen, wenn sie geändert werden.

Wenn Sie einen Datensatz mit einer ID erhalten, die bereits in Ihrer lokalen Datenbank existiert, überschreiben Sie den bestehenden Datensatz mit den neuen Daten. Dies ist ein Update, kein Duplikat.

Beispielszenario:

Initiale Synchronisierung gibt Article mit Id "articles/123" und Name "Red Roses" zurück
Artikel wird in EasyFlor geändert (Name in "Red Roses Premium" geändert)
Nächste inkrementelle Synchronisierung gibt dieselbe Id "articles/123" mit aktualisiertem Name "Red Roses Premium" zurück
Aktion: Lokalen Datensatz mit Id "articles/123" überschreiben

Kernprinzip: Das Feld Id ist der eindeutige Identifikator. Wenn Sie einen Datensatz mit einer Id erhalten, die Sie bereits haben, ist es ein Update — ersetzen Sie den alten Datensatz vollständig durch die neuen Daten.

Statuscodes

Code	Beschreibung
200	OK - Anfrage erfolgreich
400	BadRequest - Objekt enthält Fehler
401	Unauthorized - Authentifizierung erforderlich oder fehlgeschlagen
404	NotFound - Ressource nicht gefunden
500	ServerError - Fehler bei der Verarbeitung der Nachricht

Fehlerantwortformat:

{
  "error": "<error>",
  "message": "<menschenlesbarer Fehler>"
}

Tipps

Die Reihenfolge der Eigenschaften in JSON ist nicht garantiert - parsen Sie nach Eigenschaftsname, nicht nach Position
Jede nicht erforderliche Eigenschaft kann NULL sein
Verwenden Sie immer den Etag des letzten Datensatzes in der Antwort für Ihre nächste Anfrage
Eine leere Array-Antwort bedeutet, dass die Synchronisierung abgeschlossen ist
Alle Endpunkte haben einen /Count-Endpunkt, um die Gesamtanzahl der Datensätze zu prüfen

Count-Endpunkte

Jeder V2-Endpunkt hat einen entsprechenden Count-Endpunkt, um die Gesamtanzahl der Datensätze abzurufen, ohne die Daten zu laden:

Format: GET /api/v2/{EndpointName}/Count

Beispiele:

GET /api/v2/PurchaseEtag/Count - Gibt Gesamtanzahl Einkäufe zurück
GET /api/v2/DebtorEtag/Count - Gibt Gesamtanzahl Debitoren zurück
GET /api/v2/ListPreOrderGroupItemEtag/Count/{id} - Gibt Gesamtanzahl Items in spezifischer Gruppe zurück

Gibt zurück: Integer mit Gesamtanzahl

Hinweis: ShopFavoritesEtag hat keinen Count-Endpunkt aufgrund seiner komplexen Aggregationslogik.

Empfehlungen zur Synchronisierungsfrequenz

Verschiedene Endpunkte haben unterschiedliche empfohlene Synchronisierungsfrequenzen, je nachdem, wie oft sich die Daten ändern:

Echtzeit-Daten-Endpunkte (5-Minuten-Intervall empfohlen)

Diese Endpunkte liefern häufig wechselnde transaktionale Daten:

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

Empfehlung: Alle 5 Minuten während der Geschäftszeiten synchronisieren.

Stündliche Daten-Endpunkte (1-Stunden-Intervall empfohlen)

Diese Endpunkte liefern mäßig wechselnde Logistikdaten:

TransportScheduleRoute

Empfehlung: Einmal pro Stunde während der Betriebszeiten synchronisieren.

Stammdaten-Endpunkte (tägliche Synchronisierung empfohlen)

Diese Endpunkte liefern relativ statische Stammdaten:

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

Empfehlung: Einmal pro Tag synchronisieren. Um die Serverlast zu verteilen, die Synchronisierungszeit jedes Endpunkts über den Tag verteilt randomisieren, statt alles zur gleichen festen Zeit zu synchronisieren.

Autorisierung / Anmelden

Befehl: api/authorization

Bei erfolgreicher Autorisierung erhalten Sie ein Cookie mit einer Sitzung. Hängen Sie dieses Cookie an alle weiteren Aufrufe an. Die Sitzung ist an den Benutzer gebunden und läuft ab, wenn ein weiterer Aufruf mit demselben Benutzernamen und gültiger Anmeldung erfolgt.

Bei Empfang von HTTP-Statuscode 401 erneut autorisieren.

Post-Parameter

Eigenschaftsname	Beschreibung	Datentyp	Erforderlich
Username	Benutzername eines Benutzers in der Datenbank, mit der Sie sich verbinden möchten	string	ja
Password	Passwort eines Benutzers in der Datenbank, mit der Sie sich verbinden möchten	string	ja
Database	Die Datenbank, mit der Sie sich verbinden möchten	string	ja

Post-Beispiel

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

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

Rückgabe: 200 OK / 401 Unauthorized

JWT Bearer Token-basierte Autorisierung

Befehl: api/authorizationtoken

Bei erfolgreicher Autorisierung erhalten Sie ein Modell mit einem Token. Fügen Sie diesen Token als Header zu allen weiteren Aufrufen hinzu. Der Token ist an den Benutzer gebunden und läuft nach dem Ablaufdatum ab.

Bei Empfang von HTTP-Statuscode 401 erneut autorisieren.

Post-Parameter

Eigenschaftsname	Beschreibung	Datentyp	Erforderlich
Username	Benutzername eines Benutzers in der Datenbank	string	ja
Password	Passwort eines Benutzers in der Datenbank	string	ja
Database	Die Datenbank, mit der Sie sich verbinden möchten	string	ja

Post-Beispiel

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

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

Rückgabe: 200 OK / 401 Unauthorized

Eigenschaftsname	Beschreibung	Datentyp
Token	Token zur Authentifizierung bei jeder Anfrage	string
Expiration	Ablaufdatum, ab dem der Token nicht mehr gültig ist	DateTime

Beispiel autorisierter Anfrage

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

Abmeldung

Befehl: api/unauthorization

Cookie-basierte Abmeldung. Beim Versand wird das Cookie, das die Sitzung gestartet hat, ungültig und alle weiteren Befehle erhalten eine 401-unauthorized-Ausnahme.

Post-Parameter: Keine

Post-Beispiel:

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

Rückgabe: Nichts

Stammdaten

Debtors

Endpunkte:

GET /api/v2/DebtorEtag/{etag?} - Debitoren abrufen
GET /api/v2/DebtorEtag/Count - Gesamtanzahl abrufen

Ein Unternehmen oder eine Person, an die Waren geliefert und Rechnungen gesendet werden.

Parameter

Parameter	Beschreibung	Erforderlich
etag	Etag der vorherigen Anfrage für inkrementelle Synchronisierung	nein

Beispiel

# Initiale Synchronisierung
GET https://api.easyflor.eu/api/v2/DebtorEtag

# Inkrementelle Synchronisierung
GET https://api.easyflor.eu/api/v2/DebtorEtag/a1b2c3d4-e5f6-7890-abcd-ef1234567890

Rückgabe

Array von DebtorEtagResult-Objekten (max. 2000 pro Anfrage)

Suppliers

Endpunkte:

GET /api/v2/SupplierEtag/{etag?} - Lieferanten abrufen
GET /api/v2/SupplierEtag/Count - Gesamtanzahl abrufen

Ein Unternehmen oder eine Person, das/die Waren an das Unternehmen liefert, mit dessen Datenbank Sie sich verbinden.

Parameter

Parameter	Beschreibung	Erforderlich
etag	Etag der vorherigen Anfrage	nein

Beispiel

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

Rückgabe

Array von SupplierEtagResult-Objekten (max. 2000 pro Anfrage)

Employee

Endpunkte:

GET /api/v2/EmployeeEtag/{etag?} - Mitarbeiter abrufen
GET /api/v2/EmployeeEtag/Count - Gesamtanzahl abrufen

Ein Mitarbeiter, der im Unternehmen arbeitet, mit dessen Datenbank Sie sich verbinden.

Parameter

Parameter	Beschreibung	Erforderlich
etag	Etag der vorherigen Anfrage	nein

Beispiel

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

Rückgabe

Array von EmployeeEtagResult-Objekten (max. 1000 pro Anfrage)

Countries

Endpunkte:

GET /api/v2/CountryEtag/{etag?} - Länder abrufen
GET /api/v2/CountryEtag/Count - Gesamtanzahl abrufen

Ein in unserer Datenbank gespeichertes Land. Verknüpft mit Debitoren, Rechnungen, Lieferanten usw.

Beispiel

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

Rückgabe

Array von CountryEtagResult-Objekten (max. 1000 pro Anfrage)

Currencies

Endpunkte:

GET /api/v2/CurrencyEtag/{etag?} - Währungen abrufen
GET /api/v2/CurrencyEtag/Count - Gesamtanzahl abrufen

Im System verwendete Währungen.

Rückgabe

Array von CurrencyEtagResult-Objekten (max. 1000 pro Anfrage)

Administrations

Endpunkte:

GET /api/v2/AdministrationEtag/{etag?} - Administrationen abrufen
GET /api/v2/AdministrationEtag/Count - Gesamtanzahl abrufen

In unserer Datenbank gespeicherte Administrationen. Verknüpft mit Debitoren, Standorten usw.

Rückgabe

Array von AdministrationEtagResult-Objekten (max. 1000 pro Anfrage)

Locations

Endpunkte:

GET /api/v2/LocationEtag/{etag?} - Standorte abrufen
GET /api/v2/LocationEtag/Count - Gesamtanzahl abrufen

In unserer Datenbank gespeicherte Standorte. Verknüpft mit Debitoren, Einkäufen usw.

Rückgabe

Array von LocationEtagResult-Objekten (max. 1000 pro Anfrage)

Artikel & Produkte

Article

Endpunkte:

GET /api/v2/ArticleEtag/{etag?} - Artikel abrufen
GET /api/v2/ArticleEtag/Count - Gesamtanzahl abrufen

Ein Artikel, wie z.B. rote Rosen.

Rückgabe

Array von ArticleEtagResult-Objekten (max. 2000 pro Anfrage)

ArticleSort

Endpunkte:

GET /api/v2/ArticleSortEtag/{etag?} - ArticleSorts abrufen
GET /api/v2/ArticleSortEtag/Count - Gesamtanzahl abrufen

Eine Variation eines Artikels. Zum Beispiel rote Rosen mit einer 50cm- und 60cm-ArticleSort.

Rückgabe

Array von ArticleSortEtagResult-Objekten (max. 2000 pro Anfrage)

ArticleGroup

Endpunkte:

GET /api/v2/ArticleGroupEtag/{etag?} - Artikelgruppen abrufen
GET /api/v2/ArticleGroupEtag/Count - Gesamtanzahl abrufen

Eine Kategorie für Artikel. Kategorien können verschachtelt sein. Zum Beispiel fällt die Kategorie Rosen unter die Kategorie Blumen.

Rückgabe

Array von ArticleGroupEtagResult-Objekten (max. 2000 pro Anfrage)

Markup Categories

Endpunkte:

GET /api/v2/MarkupCategoryEtag/{etag?} - Markup-Kategorien abrufen
GET /api/v2/MarkupCategoryEtag/Count - Gesamtanzahl abrufen

Für Preisberechnungen verwendete Markup-Kategorien.

Rückgabe

Array von MarkupCategoryEtagResult-Objekten (max. 1000 pro Anfrage)

Remarks

Endpunkte:

GET /api/v2/RemarkEtag/{etag?} - Bemerkungen abrufen
GET /api/v2/RemarkEtag/Count - Gesamtanzahl abrufen

In der Datenbank gespeicherte Artikelbemerkungen.

Rückgabe

Array von RemarkEtagResult-Objekten (max. 1000 pro Anfrage)

Webshop

ListGroup

Endpunkte:

GET /api/v2/ListGroupEtag/{etag?} - ListGroups abrufen
GET /api/v2/ListGroupEtag/Count - Gesamtanzahl abrufen

Eine ListGroup ist eine Sammlung von Listen, die im Shop unter einer Überschrift angezeigt werden.

Rückgabe

Array von ListGroupEtagResult-Objekten (max. 1000 pro Anfrage)

ListArticleSort

Endpunkte:

GET /api/v2/ListArticleSortEtag/{etag?} - ListArticleSorts abrufen
GET /api/v2/ListArticleSortEtag/Count - Gesamtanzahl abrufen

Ein ArticleSort, der auf einer Webshop-Liste angeboten wird.

Rückgabe

Array von ListArticleSortEtagResult-Objekten (max. 1000 pro Anfrage)

ListPreOrderGroupItem

Endpunkte:

GET /api/v2/ListPreOrderGroupItemEtag/{id} - Items abrufen (initiale Synchronisierung)
GET /api/v2/ListPreOrderGroupItemEtag/{etag}/{id} - Items abrufen (inkrementelle Synchronisierung)
GET /api/v2/ListPreOrderGroupItemEtag/Count/{id} - Gesamtanzahl abrufen

Items in einer spezifischen ListPreOrderGroup.

Parameter

Parameter	Beschreibung	Erforderlich
id	ID der ListPreOrderGroup (z.B. `ListPreOrderGroups/123`)	ja
etag	Etag der vorherigen Anfrage	nein

Rückgabe

Array von ListPreOrderGroupItemEtagResult-Objekten (max. 2000 pro Anfrage)

Favorites

Endpunkt: GET /api/v2/ShopFavoritesEtag/{etag?}

Favorisierte Artikel pro Debitor für den Webshop.

Rückgabe

Array von ShopFavoritesEtagResult-Objekten (max. 1000 pro Anfrage)

DebtorSessions

Endpunkte:

GET /api/v2/ShopDebtorSessionEtag/{etag?} - Debitor-Sitzungen abrufen
GET /api/v2/ShopDebtorSessionEtag/Count - Gesamtanzahl abrufen

Debitor-Sitzungsdatensätze mit zuletzt bekannten Aktivitäten.

Rückgabe

Array von ShopDebtorSessionEtagResult-Objekten (max. 1000 pro Anfrage)

Bestellungen & Einkäufe

PreOrder

Endpunkte:

GET /api/v2/PreOrderEtag/{etag?} - PreOrders abrufen
GET /api/v2/PreOrderEtag/Count - Gesamtanzahl abrufen

Die Anfrage (Nachfrage) für einen bestimmten ArticleSort von einem Debitor.

Rückgabe

Array von PreOrderEtagResult-Objekten (max. 2000 pro Anfrage)

Purchase

Endpunkte:

GET /api/v2/PurchaseEtag/{etag?} - Einkäufe abrufen
GET /api/v2/PurchaseEtag/Count - Gesamtanzahl abrufen

Ein Einkauf ist eine Kaufaktion des Unternehmens, in dessen Datenbank Sie sich befinden, von einem Lieferanten.

Rückgabe

Array von PurchaseEtagResult-Objekten (max. 2000 pro Anfrage)

DistributedPurchase

Endpunkte:

GET /api/v2/DistributedPurchaseEtag/{etag?} - Verteilte Einkäufe abrufen
GET /api/v2/DistributedPurchaseEtag/Count - Gesamtanzahl abrufen

Ein DistributedPurchase repräsentiert Waren aus einem Einkauf, die einem bestimmten Debitor zugewiesen/verkauft wurden.

Rückgabe

Array von DistributedPurchaseEtagResult-Objekten (max. 1024 pro Anfrage)

DistributedPurchaseOrderable

Endpunkte:

GET /api/v2/DistributedPurchaseOrderableEtag/{etag?} - Bestellbare verteilte Einkäufe abrufen
GET /api/v2/DistributedPurchaseOrderableEtag/Count - Gesamtanzahl abrufen

Bestellbare verteilte Einkäufe.

Rückgabe

Array von DistributedPurchaseOrderableEtagResult-Objekten (max. 2000 pro Anfrage)

Rechnungsstellung - Debet

Invoice

Endpunkte:

GET /api/v2/InvoiceEtag/{etag?} - Rechnungen abrufen
GET /api/v2/InvoiceEtag/Count - Gesamtanzahl abrufen

Eine für einen Debitor erstellte Rechnung (sowohl Gutschriften als auch Debet-Rechnungen).

Rückgabe

Array von InvoiceEtagResult-Objekten (max. 2000 pro Anfrage)

DebetInvoicePurchaseItem

Endpunkte:

GET /api/v2/DebetInvoicePurchaseItemEtag/{etag?} - Debet-Rechnungs-Einkaufsposten abrufen
GET /api/v2/DebetInvoicePurchaseItemEtag/Count - Gesamtanzahl abrufen

An einen Debitor verkaufte und dann fakturierte Blumen und Pflanzen.

Rückgabe

Array von DebetInvoicePurchaseItemEtagResult-Objekten (max. 2000 pro Anfrage)

DebetInvoiceCustomItem

Endpunkte:

GET /api/v2/DebetInvoiceCustomItemEtag/{etag?} - Benutzerdefinierte Debet-Rechnungsposten abrufen
GET /api/v2/DebetInvoiceCustomItemEtag/Count - Gesamtanzahl abrufen

Benutzerdefinierte Zeilen auf Debet-Rechnungen, erstellt vom Benutzer ohne Verknüpfung zu einem Einkauf.

Rückgabe

Array von DebetInvoiceCustomItemEtagResult-Objekten (max. 2000 pro Anfrage)

DebetInvoicePackagingItem

Endpunkte:

GET /api/v2/DebetInvoicePackagingItemEtag/{etag?} - Debet-Rechnungs-Verpackungsposten abrufen
GET /api/v2/DebetInvoicePackagingItemEtag/Count - Gesamtanzahl abrufen

Verpackung (Niederländisch: fust), die fakturiert wird.

Rückgabe

Array von DebetInvoicePackagingItemEtagResult-Objekten (max. 2000 pro Anfrage)

DebetInvoiceTrolleyItem

Endpunkte:

GET /api/v2/DebetInvoiceTrolleyItemEtag/{etag?} - Debet-Rechnungs-Wagenposten abrufen
GET /api/v2/DebetInvoiceTrolleyItemEtag/Count - Gesamtanzahl abrufen

Wagen (Niederländisch: karren), die fakturiert werden.

Rückgabe

Array von DebetInvoiceTrolleyItemEtagResult-Objekten (max. 2000 pro Anfrage)

Rechnungsstellung - Gutschrift

CreditInvoicePurchaseItem

Endpunkte:

GET /api/v2/CreditInvoicePurchaseItemEtag/{etag?} - Gutschrift-Einkaufsposten abrufen
GET /api/v2/CreditInvoicePurchaseItemEtag/Count - Gesamtanzahl abrufen

An einen Debitor verkaufte Blumen und Pflanzen, die dann fakturiert und gutgeschrieben wurden.

Rückgabe

Array von CreditInvoicePurchaseItemEtagResult-Objekten (max. 2000 pro Anfrage)

CreditInvoiceCustomItem

Endpunkte:

GET /api/v2/CreditInvoiceCustomItemEtag/{etag?} - Benutzerdefinierte Gutschriftposten abrufen
GET /api/v2/CreditInvoiceCustomItemEtag/Count - Gesamtanzahl abrufen

Benutzerdefinierte Zeilen auf Gutschriften, erstellt vom Benutzer ohne Verknüpfung zu einem Einkauf.

Rückgabe

Array von CreditInvoiceCustomItemEtagResult-Objekten (max. 2000 pro Anfrage)

CreditInvoiceDepositItem

Endpunkte:

GET /api/v2/CreditInvoiceDepositItemEtag/{etag?} - Gutschrift-Pfandposten abrufen
GET /api/v2/CreditInvoiceDepositItemEtag/Count - Gesamtanzahl abrufen

Verpackung (Niederländisch: fust) und Wagen (Niederländisch: karren) mit Pfandpreis, die vom Debitor zurückgegeben wurden.

Rückgabe

Array von CreditInvoiceDepositItemEtagResult-Objekten (max. 2000 pro Anfrage)

Zahlungen & Wagen

Payment

Endpunkte:

GET /api/v2/PaymentEtag/{etag?} - Zahlungen abrufen
GET /api/v2/PaymentEtag/Count - Gesamtanzahl abrufen

Für Rechnungen registrierte Zahlungen (Banktransaktionen, Barzahlungen, Schecks).

Rückgabe

Array von PaymentEtagResult-Objekten (max. 2000 pro Anfrage)

DistributedTrolley

Endpunkte:

GET /api/v2/DistributedTrolleyEtag/{etag?} - Verteilte Wagen abrufen
GET /api/v2/DistributedTrolleyEtag/Count - Gesamtanzahl abrufen

Wagen-Distributionsdatensätze.

Rückgabe

Array von DistributedTrolleyEtagResult-Objekten (max. 2000 pro Anfrage)

Prognose

PrognosePrice

Endpunkte:

GET /api/v2/PrognosePriceEtag/{etag?} - Prognosepreise abrufen
GET /api/v2/PrognosePriceEtag/Count - Gesamtanzahl abrufen

Preisprognosen pro Artikel, Woche und Jahr. Gibt nur Daten für aktuelles und nächstes Jahr zurück.

Rückgabe

Array von PrognosePriceEtagResult-Objekten (max. 2000 pro Anfrage)

PrognoseQuantity

Endpunkte:

GET /api/v2/PrognoseQuantityEtag/{etag?} - Prognosemengen abrufen
GET /api/v2/PrognoseQuantityEtag/Count - Gesamtanzahl abrufen

Mengenprognosen pro Artikel, Woche und Jahr. Enthält Verteilung pro Wochentag. Gibt nur Daten für aktuelles und nächstes Jahr zurück.

Rückgabe

Array von PrognoseQuantityEtagResult-Objekten (max. 2000 pro Anfrage)

PrognosesReservation

Endpunkte:

GET /api/v2/PrognosesReservationEtag/{etag?} - Prognose-Reservierungen abrufen
GET /api/v2/PrognosesReservationEtag/Count - Gesamtanzahl abrufen

Prognose-Reservierungen pro Debitor, mit Artikelkomponenten, Tageszuweisungen und PreOrder-Details. Wird zur Verwaltung reservierter Prognosemengen pro Woche und Jahr verwendet.

Rückgabe

Array von PrognosesReservationEtagResult-Objekten (max. 2000 pro Anfrage)

Logistik

TransportScheduleRoute

Endpunkte:

GET /api/v2/TransportScheduleRouteEtag/{etag?} - Transportrouten abrufen
GET /api/v2/TransportScheduleRouteEtag/Count - Gesamtanzahl abrufen

Geplante Transportrouten pro Tag, einschließlich Fahrer, Fahrzeug und eingebetteten Stopps mit berechneten Logistikinformationen (Ankunftszeiten, Distanz, Dauer). Jede Route gehört zu einem TransportSchedule (ein Schedule pro Tag) und enthält eine geordnete Liste von Stopps. Stopps können Debtor-Stopps (Lieferung an einen oder mehrere Kunden) oder Vehicle-Stopps (Fahrzeug-Abholung/Abgabe) sein. Die Info-Objekte auf Routen und Stopps enthalten Werte, die vom Optimierungsmotor erzeugt werden.

Rückgabe

Array von TransportScheduleRouteEtagResult-Objekten (max. 1000 pro Anfrage)

Modelle

Alle Modelle sind unten mit ihren Eigenschaften aufgeführt. Die Eigenschaftsnamen, Datentypen und Strukturen bleiben gemäß API-Konvention auf Englisch.

Für die vollständige Definition aller Modelle (AdministrationEtagResult, ArticleEtagResult, 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) siehe bitte die englische Version dieser Dokumentation, die alle detaillierten Eigenschaftsdefinitionen enthält.*

Haben Sie Fragen oder benötigen Sie Hilfe? Kontaktieren Sie uns gerne telefonisch unter +31 (0)71 30 20 310 oder senden Sie eine E-Mail an support@easyflor.nl.

API v2

Inhaltsverzeichnis

Erste Schritte

Stammdaten

Artikel & Produkte

Webshop

Bestellungen & Einkäufe

Rechnungsstellung - Debet

Rechnungsstellung - Gutschrift

Zahlungen & Wagen

Prognose

Logistik

Modellreferenz

Changelog

Erste Schritte

Einführung

Allgemein

JSON

DateTime-Format

Date

DateTime

LanguageValue

Null-Wert

Kodierung

ETags (Entity Tags)

Wie Etag-Synchronisierung funktioniert

Beispiel-Flow

Wichtig: Umgang mit Updates

Statuscodes

Tipps

Count-Endpunkte

Empfehlungen zur Synchronisierungsfrequenz

Echtzeit-Daten-Endpunkte (5-Minuten-Intervall empfohlen)

Stündliche Daten-Endpunkte (1-Stunden-Intervall empfohlen)

Stammdaten-Endpunkte (tägliche Synchronisierung empfohlen)

Autorisierung / Anmelden

Cookie-basierte Autorisierung

Post-Parameter

Post-Beispiel

JWT Bearer Token-basierte Autorisierung

Post-Parameter

Post-Beispiel

Beispiel autorisierter Anfrage

Abmeldung

Stammdaten

Debtors

Parameter

Beispiel

Rückgabe

Suppliers

Parameter

Beispiel

Rückgabe

Employee

Parameter

Beispiel

Rückgabe

Countries

Beispiel

Rückgabe

Currencies

Rückgabe

Administrations

Rückgabe

Locations

Rückgabe

Artikel & Produkte

Article

Rückgabe

ArticleSort

Rückgabe

ArticleGroup

Rückgabe

Markup Categories

Rückgabe

Remarks

Rückgabe

Webshop

ListGroup

Rückgabe