Analiza szczegółowa
Usługi REST (ORDS)
Pełna enumeracja usług ORDS systemu EVAN — moduły, ścieżki bazowe, endpointy i metody HTTP.
Usługi REST są zdefiniowane w latest/rest_services/ (schemat VAN_DATA, wspólny URL mapping evan). Łącznie 10 usług / ok. 34 endpointów.
Autoryzacja: brak auto-REST-auth — endpointy wymagają nagłówka
Api-Key oraz client. Komunikacja jest logowana do API_KOMUNIKACJA_LOGS. Główne pakiety obsługujące: EVAN_API_WRAPPER_PKG, BBS_NEGOCJACJE_PKG, KONTRAHENT_GUI_PKG.Zbiorcza tabela
| Usługa | Base path | Endpointy | Przeznaczenie |
|---|---|---|---|
ORDS_FAKTURY | /invoice/ | 1 | tworzenie faktur (New Transaction) |
ORDS_FLEET | /fleet/ | 1 | zgody przewoźnika i kierowcy |
ORDS_KONTRAHENT | /cst/ | 4 | weryfikacja, pobranie, dodanie, modyfikacja kontrahenta |
ORDS_ZLECENIE | /order/ | 8 | tworzenie/akceptacja zleceń, dokumenty, statusy |
ORDS_KARTY_FLOTOWE | /fuel_card/ | 4 | umowy, transakcje, faktury kart paliwowych |
ORDS_PRICING | /pricing/ | 2 | oferty rynkowe, wycena zlecenia |
ORDS_BBS | /bbsnegoffer/ | 6 | negocjacje ofert (potwierdzenie/akceptacja/odrzucenie) |
ORDS_PRZEWOZNIK | /carrier/ | 6 | saldo, oferty, dokumenty, rozliczenia paliwa, faktury |
ORDS_BBS_MAIN | /bbs/ | 1 | usuwanie ofert BBS |
ORDS_VANWAYKONTA | /mobile/ | 1 | status konta aplikacji mobilnej (z rate limiting) |
Szczegóły endpointów
/order/ — ORDS_ZLECENIE (8)
POST /order/create— tworzenie zlecenia (zwracaorder_id).POST /order/confirm,POST /order/order_accept_now— potwierdzenie/akceptacja.POST /order/order_status_set— ustawienie statusu zlecenia.POST /order/document_set— dołączanie dokumentów.POST /order/document_status— zmiana statusu dokumentu (akceptacja/odrzucenie z przyczyną).DELETE /order/document_status— wycofanie statusu dokumentu (powrót do akceptacji).POST /order/instruction_book— Książka Instrukcji jako PDF (base64).
/carrier/ — ORDS_PRZEWOZNIK (6)
GET /carrier/balance— należności, zobowiązania, saldo (w tym Lotos).POST /carrier/bid_set— ustawienie stawki/oferty.POST /carrier/document_print— druk dokumentu zlecenia.GET /carrier/specification_details— szczegóły specyfikacji.GET /carrier/fuel_settlements— rozliczenia paliwa (Lotos).POST /carrier/invoice— utworzenie faktury dla przewoźnika.
/bbsnegoffer/ — ORDS_BBS (6)
Para GET+POST dla każdej akcji:
confirm/:offer_id/:person_id/:confirmation_type— potwierdzenie oferty.accept_now— akceptacja.refuse/:offer_id/:person_id— odrzucenie.
/cst/ — ORDS_KONTRAHENT (4)
POST /cst/verification— weryfikacja tożsamości.POST /cst/get_company— pobranie danych firmy.POST /cst/add,POST /cst/mod— dodanie / modyfikacja (zwracają m.in.evan_company_id,vanway_id,vat_number,address_id,bank_account_id).
/fuel_card/ — ORDS_KARTY_FLOTOWE (4)
POST /fuel_card/agreement— dodanie/zasilenie umowy;PUT /fuel_card/agreement— zmiana stanu umowy.POST /fuel_card/transaction— transakcje.POST /fuel_card/invoice— faktury.
/pricing/ — ORDS_PRICING (2)
POST /pricing/offers— zapis ofert rynkowych.POST /pricing/order_price— wycena zlecenia (JSON).
Pozostałe (po 1)
POST /invoice/ntran_create— ORDS_FAKTURY: faktura New Transaction.POST /fleet/user_data— ORDS_FLEET: zgody przewoźnika/kierowcy.POST /bbs/delete— ORDS_BBS_MAIN: usuwanie ofert BBS.POST /mobile/account_status— ORDS_VANWAYKONTA: status konta (obsługa429 Too Many Requests).
KSeF nie jest wystawiony jako usługa ORDS — komunikacja z KSeF odbywa się wychodząco z pakietów PL/SQL przez
APEX_WEB_SERVICE. Zob. Integracja KSeF.