Wersja	Opis	Data	Autor
2.0.4	Dodano endpoint TransportScheduleRouteEtag dla tras transportowych z zagnieżdżonymi przystankami	2026-05-03	DDH
2.0.3	Dodano endpoint PrognosesReservation dla rezerwacji prognostycznych	2026-03-09	DDH
2.0.2	Zmieniono trasy ListPreOrderGroupItemEtag: Count/ i /	2026-01-09	DDH
2.0.1	Dodano endpointy Count do wszystkich endpointów (oprócz ShopFavorites) dla łącznej liczby rekordów	2026-01-08	DDH
2.0.0	Pierwsze wydanie V2 API z synchronizacją opartą na Etag	2026-01-08	DDH

Pierwsze kroki

Wprowadzenie

V2 API używa synchronizacji opartej na Etag dla efektywnego przyrostowego pobierania danych. Każdy rekord zawiera wartość Etag — wystarczy przekazać Etag ostatniego rekordu, aby uzyskać kolejną porcję nowych lub zmodyfikowanych rekordów.

Kluczowe ulepszenia w V2:

Paginacja oparta na Etag dla niezawodnej synchronizacji przyrostowej
Wszystkie endpointy obsługują synchronizację przyrostową

Autoryzacja działa tak samo jak w V1 — musisz być autoryzowany dla każdej bazy danych, do której się łączysz. W przeciwnym razie otrzymasz status HTTP 401 (Unauthorized).

Sekcje poniżej opisują:

Ogólne informacje o formatach JSON, kodach statusu i Etagach
Wszystkie dostępne endpointy GET pogrupowane według kategorii
Szczegółowe specyfikacje modeli

Ogólne

JSON

Informacje o konkretnych typach i ich formatowaniu w JSON.

Format DateTime

Symbol	Opis	Przykład
yyyy	rok	2026
MM	miesiąc	01
dd	dzień	31
HH	godzina	13
mm	minuta	01
ss	sekundy	22
tttttt	strefa czasowa	+02:00
Z	strefa UTC	Z

Date

Format: yyyy-MM-dd
Przykład: 2026-12-30

DateTime

Format: yyyy-MM-dd\THH:mm:ssttttttt
Przykład: 2026-12-30T13:40:20+02:00
Uwagi: Użyj strefy czasowej dłużnika

LanguageValue

Obiekt zawierający wszystkie dostępne języki (ISO-639-1).

{
  "nl": "Holenderskie oznaczenie",
  "de": "Niemieckie oznaczenie",
  "fr": "Francuski tytuł"
}

Wartość Null

Nie wysyłaj parametrów bez wartości.

Źle:

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

Dobrze:

{
  "RequiredParameter": "text"
}

Kodowanie

UTF-8

ETagi (Entity Tags)

V2 API używa ETagów dla efektywnej synchronizacji przyrostowej. Każdy rekord zawiera wartość Etag, która zwiększa się przy każdej zmianie.

Jak działa synchronizacja Etag

Synchronizacja początkowa: Wywołaj endpoint bez parametru Etag, aby uzyskać pierwszą porcję
Pobierz ostatni Etag: Weź Etag ostatniego rekordu z odpowiedzi
Następna synchronizacja: Przekaż ten Etag jako parametr, aby uzyskać następną porcję
Powtórz: Aż otrzymasz pustą tablicę

Przykład przepływu

# Pierwsze żądanie - bez Etag
GET /api/v2/ArticleEtag
# Zwraca 2000 rekordów, ostatni ma Etag: "a1b2c3d4-..."

# Drugie żądanie - użyj ostatniego Etag
GET /api/v2/ArticleEtag/a1b2c3d4-...
# Zwraca następne 2000 rekordów, ostatni Etag: "e5f6g7h8-..."

# Trzecie żądanie
GET /api/v2/ArticleEtag/e5f6g7h8-...
# Zwraca [] - synchronizacja zakończona

Przez zapisanie i ponowne użycie ostatniego Etaga, otrzymujesz tylko nowe lub zmodyfikowane rekordy przy kolejnych synchronizacjach.

Ważne: Obsługa aktualizacji

Rekordy mogą pojawić się wielokrotnie w różnych żądaniach synchronizacji, gdy są modyfikowane.

Gdy otrzymasz rekord z ID, które już istnieje w Twojej lokalnej bazie danych, nadpisz istniejący rekord nowymi danymi. To jest aktualizacja, nie duplikat.

Przykład scenariusza:

Początkowa synchronizacja zwraca Article z Id "articles/123" i Name "Red Roses"
Artykuł jest modyfikowany w EasyFlor (nazwa zmieniona na "Red Roses Premium")
Następna przyrostowa synchronizacja zwraca to samo Id "articles/123" ze zaktualizowanym Name "Red Roses Premium"
Akcja: Nadpisz lokalny rekord z Id "articles/123"

Kluczowa zasada: Pole Id jest unikalnym identyfikatorem. Jeśli otrzymasz rekord z Id, które już masz, to jest aktualizacja — całkowicie zastąp stary rekord nowymi danymi.

Kody statusu

Kod	Opis
200	OK - Żądanie pomyślne
400	BadRequest - Obiekt zawiera błąd
401	Unauthorized - Wymagane uwierzytelnienie lub nieudane
404	NotFound - Zasób nie znaleziony
500	ServerError - Błąd przetwarzania wiadomości

Format odpowiedzi błędu:

{
  "error": "<error>",
  "message": "<czytelny błąd>"
}

Wskazówki

Kolejność właściwości w JSON nie jest gwarantowana - parsuj po nazwie właściwości, nie po pozycji
Każda właściwość niebędąca wymaganą może być NULL
Zawsze używaj Etaga ostatniego rekordu w odpowiedzi do następnego żądania
Odpowiedź pustej tablicy oznacza, że synchronizacja jest zakończona
Wszystkie endpointy mają endpoint /Count do sprawdzenia całkowitej liczby rekordów

Endpointy Count

Każdy V2 endpoint ma odpowiadający endpoint Count do pobrania całkowitej liczby rekordów bez pobierania danych:

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

Przykłady:

GET /api/v2/PurchaseEtag/Count - Zwraca całkowitą liczbę zakupów
GET /api/v2/DebtorEtag/Count - Zwraca całkowitą liczbę dłużników
GET /api/v2/ListPreOrderGroupItemEtag/Count/{id} - Zwraca łączną liczbę pozycji w konkretnej grupie

Zwraca: Liczba całkowita reprezentująca łączną liczbę

Uwaga: ShopFavoritesEtag nie ma endpointa Count ze względu na złożoną logikę agregacji.

Zalecenia częstotliwości synchronizacji

Różne endpointy mają różne zalecane częstotliwości synchronizacji w zależności od częstotliwości zmian danych:

Endpointy danych czasu rzeczywistego (zalecany interwał 5 minut)

Te endpointy dostarczają często zmieniające się dane transakcyjne:

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

Zalecenie: Synchronizuj co 5 minut w godzinach pracy.

Endpointy danych godzinowych (zalecany interwał 1 godziny)

Te endpointy dostarczają umiarkowanie zmieniające się dane logistyczne:

TransportScheduleRoute

Zalecenie: Synchronizuj raz na godzinę w godzinach operacyjnych.

Endpointy danych podstawowych (zalecana synchronizacja dzienna)

Te endpointy dostarczają względnie statyczne dane podstawowe:

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

Zalecenie: Synchronizuj raz dziennie. Aby rozłożyć obciążenie serwera, losuj czas synchronizacji każdego endpointu w ciągu dnia zamiast synchronizować wszystkie endpointy w tym samym ustalonym czasie.

Autoryzacja / logowanie

Polecenie: api/authorization

Po pomyślnej autoryzacji otrzymasz cookie zawierające sesję. Dołącz to cookie do każdego innego wywołania. Sesja jest powiązana z użytkownikiem i wygaśnie, gdy zostanie wykonane inne wywołanie z tym samym nazwą użytkownika w przypadku ważnego logowania.

Po otrzymaniu kodu statusu HTTP 401, autoryzuj ponownie.

Parametry Post

Nazwa właściwości	Opis	Typ danych	Wymagane
Username	Nazwa użytkownika w bazie danych, do której chcesz się połączyć	string	tak
Password	Hasło użytkownika w bazie danych, do której chcesz się połączyć	string	tak
Database	Baza danych, do której chcesz się połączyć	string	tak

Przykład Post

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

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

Zwraca: 200 OK / 401 Unauthorized

Autoryzacja oparta na JWT Bearer Token

Polecenie: api/authorizationtoken

Po pomyślnej autoryzacji otrzymasz model zawierający Token. Dodaj ten token jako nagłówek do każdego innego wywołania. Token jest powiązany z użytkownikiem i wygaśnie po dacie ważności.

Po otrzymaniu kodu statusu HTTP 401, autoryzuj ponownie.

Parametry Post

Nazwa właściwości	Opis	Typ danych	Wymagane
Username	Nazwa użytkownika w bazie danych	string	tak
Password	Hasło użytkownika	string	tak
Database	Baza danych	string	tak

Przykład Post

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

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

Zwraca: 200 OK / 401 Unauthorized

Nazwa właściwości	Opis	Typ danych
Token	Token używany do uwierzytelniania każdego żądania	string
Expiration	Data wygaśnięcia, po której Token nie będzie już ważny	DateTime

Przykład autoryzowanego żądania

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

Wylogowanie

Polecenie: api/unauthorization

Wylogowanie oparte na cookie. Po wysłaniu cookie, które rozpoczęło sesję, staje się nieważne, a wszelkie dalsze polecenia otrzymają wyjątek 401 unauthorized.

Parametry Post: Brak

Przykład Post:

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

Zwraca: Nic

Dane podstawowe

Debtors

Endpointy:

GET /api/v2/DebtorEtag/{etag?} - Pobierz dłużników
GET /api/v2/DebtorEtag/Count - Pobierz łączną liczbę

Firma lub osoba, do której dostarczane są towary i wysyłane faktury.

Parametry

Parametr	Opis	Wymagane
etag	Etag z poprzedniego żądania dla synchronizacji przyrostowej	nie

Przykład

# Synchronizacja początkowa
GET https://api.easyflor.eu/api/v2/DebtorEtag

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

Zwraca

Tablicę obiektów DebtorEtagResult (maks. 2000 na żądanie)

Suppliers

Endpointy:

GET /api/v2/SupplierEtag/{etag?} - Pobierz dostawców
GET /api/v2/SupplierEtag/Count - Pobierz łączną liczbę

Firma lub osoba, która dostarcza towary firmie, której bazę danych odpytujesz.

Zwraca

Tablicę obiektów SupplierEtagResult (maks. 2000 na żądanie)

Employee

Endpointy:

GET /api/v2/EmployeeEtag/{etag?} - Pobierz pracowników
GET /api/v2/EmployeeEtag/Count - Pobierz łączną liczbę

Pracownik, który pracuje w firmie, której bazę danych odpytujesz.

Zwraca

Tablicę obiektów EmployeeEtagResult (maks. 1000 na żądanie)

Countries

Endpointy:

GET /api/v2/CountryEtag/{etag?} - Pobierz kraje
GET /api/v2/CountryEtag/Count - Pobierz łączną liczbę

Kraj przechowywany w naszej bazie danych. Powiązany z dłużnikami, fakturami, dostawcami itp.

Zwraca

Tablicę obiektów CountryEtagResult (maks. 1000 na żądanie)

Currencies

Endpointy:

GET /api/v2/CurrencyEtag/{etag?} - Pobierz waluty
GET /api/v2/CurrencyEtag/Count - Pobierz łączną liczbę

Waluty używane w systemie.

Zwraca

Tablicę obiektów CurrencyEtagResult (maks. 1000 na żądanie)

Administrations

Endpointy:

GET /api/v2/AdministrationEtag/{etag?} - Pobierz administracje
GET /api/v2/AdministrationEtag/Count - Pobierz łączną liczbę

Administracje przechowywane w naszej bazie danych. Powiązane z dłużnikami, lokalizacjami itp.

Zwraca

Tablicę obiektów AdministrationEtagResult (maks. 1000 na żądanie)

Locations

Endpointy:

GET /api/v2/LocationEtag/{etag?} - Pobierz lokalizacje
GET /api/v2/LocationEtag/Count - Pobierz łączną liczbę

Lokalizacje przechowywane w naszej bazie danych. Powiązane z dłużnikami, zakupami itp.

Zwraca

Tablicę obiektów LocationEtagResult (maks. 1000 na żądanie)

Artykuły i produkty

Article

Endpointy:

GET /api/v2/ArticleEtag/{etag?} - Pobierz artykuły
GET /api/v2/ArticleEtag/Count - Pobierz łączną liczbę

Artykuł, taki jak czerwone róże.

Zwraca

Tablicę obiektów ArticleEtagResult (maks. 2000 na żądanie)

ArticleSort

Endpointy:

GET /api/v2/ArticleSortEtag/{etag?} - Pobierz ArticleSorty
GET /api/v2/ArticleSortEtag/Count - Pobierz łączną liczbę

Wariacja artykułu. Na przykład czerwone róże z ArticleSort 50cm i 60cm.

Zwraca

Tablicę obiektów ArticleSortEtagResult (maks. 2000 na żądanie)

ArticleGroup

Endpointy:

GET /api/v2/ArticleGroupEtag/{etag?} - Pobierz grupy artykułów
GET /api/v2/ArticleGroupEtag/Count - Pobierz łączną liczbę

Kategoria dla artykułów. Kategorie mogą być zagnieżdżone. Na przykład kategoria Róże znajduje się pod kategorią Kwiaty.

Zwraca

Tablicę obiektów ArticleGroupEtagResult (maks. 2000 na żądanie)

Markup Categories

Endpointy:

GET /api/v2/MarkupCategoryEtag/{etag?} - Pobierz kategorie markup
GET /api/v2/MarkupCategoryEtag/Count - Pobierz łączną liczbę

Kategorie markup używane do obliczeń cenowych.

Zwraca

Tablicę obiektów MarkupCategoryEtagResult (maks. 1000 na żądanie)

Remarks

Endpointy:

GET /api/v2/RemarkEtag/{etag?} - Pobierz uwagi
GET /api/v2/RemarkEtag/Count - Pobierz łączną liczbę

Uwagi do artykułów przechowywane w bazie danych.

Zwraca

Tablicę obiektów RemarkEtagResult (maks. 1000 na żądanie)

Sklep internetowy

ListGroup

Endpointy:

GET /api/v2/ListGroupEtag/{etag?} - Pobierz ListGroups
GET /api/v2/ListGroupEtag/Count - Pobierz łączną liczbę

ListGroup to kolekcja list pokazywanych pod jednym nagłówkiem w sklepie.

Zwraca

Tablicę obiektów ListGroupEtagResult (maks. 1000 na żądanie)

ListArticleSort

Endpointy:

GET /api/v2/ListArticleSortEtag/{etag?} - Pobierz ListArticleSorts
GET /api/v2/ListArticleSortEtag/Count - Pobierz łączną liczbę

ArticleSort oferowany na liście sklepu internetowego.

Zwraca

Tablicę obiektów ListArticleSortEtagResult (maks. 1000 na żądanie)

ListPreOrderGroupItem

Endpointy:

GET /api/v2/ListPreOrderGroupItemEtag/{id} - Pobierz pozycje (synchronizacja początkowa)
GET /api/v2/ListPreOrderGroupItemEtag/{etag}/{id} - Pobierz pozycje (synchronizacja przyrostowa)
GET /api/v2/ListPreOrderGroupItemEtag/Count/{id} - Pobierz łączną liczbę

Pozycje w konkretnej ListPreOrderGroup.

Parametry

Parametr	Opis	Wymagane
id	ID ListPreOrderGroup (np. `ListPreOrderGroups/123`)	tak
etag	Etag z poprzedniego żądania	nie

Zwraca

Tablicę obiektów ListPreOrderGroupItemEtagResult (maks. 2000 na żądanie)

Favorites

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

Ulubione artykuły na dłużnika dla sklepu internetowego.

Zwraca

Tablicę obiektów ShopFavoritesEtagResult (maks. 1000 na żądanie)

DebtorSessions

Endpointy:

GET /api/v2/ShopDebtorSessionEtag/{etag?} - Pobierz sesje dłużnika
GET /api/v2/ShopDebtorSessionEtag/Count - Pobierz łączną liczbę

Rekordy sesji dłużnika zawierające ostatnio znane aktywności.

Zwraca

Tablicę obiektów ShopDebtorSessionEtagResult (maks. 1000 na żądanie)

Zamówienia i zakupy

PreOrder

Endpointy:

GET /api/v2/PreOrderEtag/{etag?} - Pobierz PreOrders
GET /api/v2/PreOrderEtag/Count - Pobierz łączną liczbę

Zapytanie (popyt) na konkretny ArticleSort od dłużnika.

Zwraca

Tablicę obiektów PreOrderEtagResult (maks. 2000 na żądanie)

Purchase

Endpointy:

GET /api/v2/PurchaseEtag/{etag?} - Pobierz zakupy
GET /api/v2/PurchaseEtag/Count - Pobierz łączną liczbę

Zakup to działanie kupna firmy, której bazę danych odpytujesz, od dostawcy.

Zwraca

Tablicę obiektów PurchaseEtagResult (maks. 2000 na żądanie)

DistributedPurchase

Endpointy:

GET /api/v2/DistributedPurchaseEtag/{etag?} - Pobierz rozdystrybuowane zakupy
GET /api/v2/DistributedPurchaseEtag/Count - Pobierz łączną liczbę

DistributedPurchase reprezentuje towary z zakupu, które zostały przypisane/sprzedane konkretnemu dłużnikowi.

Zwraca

Tablicę obiektów DistributedPurchaseEtagResult (maks. 1024 na żądanie)

DistributedPurchaseOrderable

Endpointy:

GET /api/v2/DistributedPurchaseOrderableEtag/{etag?} - Pobierz zamawialne rozdystrybuowane zakupy
GET /api/v2/DistributedPurchaseOrderableEtag/Count - Pobierz łączną liczbę

Zamawialne rozdystrybuowane zakupy.

Zwraca

Tablicę obiektów DistributedPurchaseOrderableEtagResult (maks. 2000 na żądanie)

Fakturowanie - Debet

Invoice

Endpointy:

GET /api/v2/InvoiceEtag/{etag?} - Pobierz faktury
GET /api/v2/InvoiceEtag/Count - Pobierz łączną liczbę

Faktura utworzona dla dłużnika (zarówno faktury kredytowe, jak i debetowe).

Zwraca

Tablicę obiektów InvoiceEtagResult (maks. 2000 na żądanie)

DebetInvoicePurchaseItem

Endpointy:

GET /api/v2/DebetInvoicePurchaseItemEtag/{etag?} - Pobierz pozycje zakupów faktur debetowych
GET /api/v2/DebetInvoicePurchaseItemEtag/Count - Pobierz łączną liczbę

Kwiaty i rośliny sprzedane dłużnikowi i następnie zafakturowane.

Zwraca

Tablicę obiektów DebetInvoicePurchaseItemEtagResult (maks. 2000 na żądanie)

DebetInvoiceCustomItem

Endpointy:

GET /api/v2/DebetInvoiceCustomItemEtag/{etag?} - Pobierz niestandardowe pozycje faktur debetowych
GET /api/v2/DebetInvoiceCustomItemEtag/Count - Pobierz łączną liczbę

Niestandardowe linie na fakturach debetowych utworzone przez użytkownika bez powiązania z zakupem.

Zwraca

Tablicę obiektów DebetInvoiceCustomItemEtagResult (maks. 2000 na żądanie)

DebetInvoicePackagingItem

Endpointy:

GET /api/v2/DebetInvoicePackagingItemEtag/{etag?} - Pobierz pozycje opakowań faktur debetowych
GET /api/v2/DebetInvoicePackagingItemEtag/Count - Pobierz łączną liczbę

Opakowanie (Holenderski: fust), które jest fakturowane.

Zwraca

Tablicę obiektów DebetInvoicePackagingItemEtagResult (maks. 2000 na żądanie)

DebetInvoiceTrolleyItem

Endpointy:

GET /api/v2/DebetInvoiceTrolleyItemEtag/{etag?} - Pobierz pozycje wózków faktur debetowych
GET /api/v2/DebetInvoiceTrolleyItemEtag/Count - Pobierz łączną liczbę

Wózki (Holenderski: karren), które są fakturowane.

Zwraca

Tablicę obiektów DebetInvoiceTrolleyItemEtagResult (maks. 2000 na żądanie)

Fakturowanie - Kredyt

CreditInvoicePurchaseItem

Endpointy:

GET /api/v2/CreditInvoicePurchaseItemEtag/{etag?} - Pobierz pozycje zakupów faktur kredytowych
GET /api/v2/CreditInvoicePurchaseItemEtag/Count - Pobierz łączną liczbę

Kwiaty i rośliny sprzedane dłużnikowi, następnie zafakturowane i skredytowane.

Zwraca

Tablicę obiektów CreditInvoicePurchaseItemEtagResult (maks. 2000 na żądanie)

CreditInvoiceCustomItem

Endpointy:

GET /api/v2/CreditInvoiceCustomItemEtag/{etag?} - Pobierz niestandardowe pozycje faktur kredytowych
GET /api/v2/CreditInvoiceCustomItemEtag/Count - Pobierz łączną liczbę

Niestandardowe linie na fakturach kredytowych utworzone przez użytkownika bez powiązania z zakupem.

Zwraca

Tablicę obiektów CreditInvoiceCustomItemEtagResult (maks. 2000 na żądanie)

CreditInvoiceDepositItem

Endpointy:

GET /api/v2/CreditInvoiceDepositItemEtag/{etag?} - Pobierz pozycje depozytów faktur kredytowych
GET /api/v2/CreditInvoiceDepositItemEtag/Count - Pobierz łączną liczbę

Opakowanie (Holenderski: fust) i wózki (Holenderski: karren) z ceną depozytu, które zostały zwrócone przez dłużnika.

Zwraca

Tablicę obiektów CreditInvoiceDepositItemEtagResult (maks. 2000 na żądanie)

Płatności i wózki

Payment

Endpointy:

GET /api/v2/PaymentEtag/{etag?} - Pobierz płatności
GET /api/v2/PaymentEtag/Count - Pobierz łączną liczbę

Płatności zarejestrowane dla faktur (transakcje bankowe, płatności gotówkowe, czeki).

Zwraca

Tablicę obiektów PaymentEtagResult (maks. 2000 na żądanie)

DistributedTrolley

Endpointy:

GET /api/v2/DistributedTrolleyEtag/{etag?} - Pobierz rozdystrybuowane wózki
GET /api/v2/DistributedTrolleyEtag/Count - Pobierz łączną liczbę

Rekordy dystrybucji wózków.

Zwraca

Tablicę obiektów DistributedTrolleyEtagResult (maks. 2000 na żądanie)

Prognozowanie

PrognosePrice

Endpointy:

GET /api/v2/PrognosePriceEtag/{etag?} - Pobierz ceny prognostyczne
GET /api/v2/PrognosePriceEtag/Count - Pobierz łączną liczbę

Prognozy cen na artykuł, tydzień i rok. Zwraca dane tylko dla bieżącego i następnego roku.

Zwraca

Tablicę obiektów PrognosePriceEtagResult (maks. 2000 na żądanie)

PrognoseQuantity

Endpointy:

GET /api/v2/PrognoseQuantityEtag/{etag?} - Pobierz ilości prognostyczne
GET /api/v2/PrognoseQuantityEtag/Count - Pobierz łączną liczbę

Prognozy ilości na artykuł, tydzień i rok. Zawiera dystrybucję na dzień tygodnia. Zwraca dane tylko dla bieżącego i następnego roku.

Zwraca

Tablicę obiektów PrognoseQuantityEtagResult (maks. 2000 na żądanie)

PrognosesReservation

Endpointy:

GET /api/v2/PrognosesReservationEtag/{etag?} - Pobierz rezerwacje prognostyczne
GET /api/v2/PrognosesReservationEtag/Count - Pobierz łączną liczbę

Rezerwacje prognostyczne na dłużnika, zawierające komponenty artykułów, przydziały dzienne i szczegóły PreOrder. Używane do zarządzania zarezerwowanymi ilościami prognostycznymi na tydzień i rok.

Zwraca

Tablicę obiektów PrognosesReservationEtagResult (maks. 2000 na żądanie)

Logistyka

TransportScheduleRoute

Endpointy:

GET /api/v2/TransportScheduleRouteEtag/{etag?} - Pobierz trasy transportowe
GET /api/v2/TransportScheduleRouteEtag/Count - Pobierz łączną liczbę

Planowane trasy transportowe na dzień, w tym kierowca, pojazd i zagnieżdżone przystanki z obliczonymi informacjami logistycznymi (czasy przybycia, odległość, czas trwania). Każda trasa należy do TransportSchedule (jeden harmonogram na dzień) i zawiera uporządkowaną listę przystanków. Przystanki mogą być przystankami Debtor (dostawa do jednego lub więcej klientów) lub Vehicle (odbiór/oddanie pojazdu). Obiekty Info na trasach i przystankach zawierają wartości generowane przez silnik optymalizacji.

Zwraca

Tablicę obiektów TransportScheduleRouteEtagResult (maks. 1000 na żądanie)

Modele

Wszystkie modele są wymienione poniżej z ich właściwościami. Nazwy właściwości, typy danych i struktury pozostają w języku angielskim zgodnie z konwencją API.

Pełną definicję wszystkich modeli (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) można znaleźć w angielskiej wersji tej dokumentacji, która zawiera wszystkie szczegółowe definicje właściwości.*

Masz pytania lub potrzebujesz pomocy? Skontaktuj się z nami telefonicznie pod numerem +31 (0)71 30 20 310 lub wyślij e-mail na adres support@easyflor.nl.

API v2

Spis treści

Pierwsze kroki

Dane podstawowe

Artykuły i produkty

Sklep internetowy

Zamówienia i zakupy

Fakturowanie - Debet

Fakturowanie - Kredyt

Płatności i wózki

Prognozowanie

Logistyka

Referencja modeli

Changelog

Pierwsze kroki

Wprowadzenie

Ogólne

JSON

Format DateTime

Date

DateTime

LanguageValue

Wartość Null

Kodowanie

ETagi (Entity Tags)

Jak działa synchronizacja Etag

Przykład przepływu

Ważne: Obsługa aktualizacji

Kody statusu

Wskazówki

Endpointy Count

Zalecenia częstotliwości synchronizacji

Endpointy danych czasu rzeczywistego (zalecany interwał 5 minut)

Endpointy danych godzinowych (zalecany interwał 1 godziny)

Endpointy danych podstawowych (zalecana synchronizacja dzienna)

Autoryzacja / logowanie

Autoryzacja oparta na Cookie

Parametry Post

Przykład Post

Autoryzacja oparta na JWT Bearer Token

Parametry Post

Przykład Post

Przykład autoryzowanego żądania

Wylogowanie

Dane podstawowe

Debtors

Parametry

Przykład

Zwraca

Suppliers

Zwraca

Employee

Zwraca

Countries

Zwraca

Currencies

Zwraca

Administrations

Zwraca

Locations

Zwraca

Artykuły i produkty

Article

Zwraca

ArticleSort

Zwraca

ArticleGroup

Zwraca

Markup Categories

Zwraca

Remarks

Zwraca

Sklep internetowy

ListGroup

Zwraca

ListArticleSort

Zwraca

ListPreOrderGroupItem

Parametry

Zwraca