Gå til innhold

Connect API – endepunktsreferanse

Kontrollerne og deres endepunkter. «Auth»-kolonnen: JWT = krever Bearer-token, åpen = AllowAnonymous, nøkkel = egen API-nøkkel, Basic = basic-auth (webhook). Forretningskall går mot jhlVismaAPI.Business der ikke annet er nevnt.

Auth (AuthController) — /api/auth

Verb Rute Auth Gjør
POST /api/auth/refresh åpen Forny access-token fra refresh-token
POST /api/auth/logout åpen Revoker refresh-token (én/alle enheter)

Se Autentisering.

Bruker og app (UserController) — /user (+ /api/user/...)

Den store «arbeidshest»-kontrolleren for appen. Utvalg (alle JWT unntatt login):

Verb Rute Gjør → operasjon
POST /user/login Pålogging (åpen) → User.VerifyUser + token-par
GET GetBasicData / GetCompanies / GetDrivers / GetDeliveryZones Grunndata for appen
GET GetTrailersAndTrucks · POST SaveTrailerAndTruck · GET GetCurrentTruckAndTrailer Bil/henger → BasicData/User
GET GetProducts / GetFeaturedProducts / SearchProducts Produkter → BasicData
GET GetTanks / GetInventoryProducts / GetTankProducts / GetCurrentTruckProducts / GetCurrentInventory(Current) / GetStocks Tanker og beholdning → Inventory/BasicData
GET CustomerSearch / CustomerByGroup / AddressSearch / AddressGPSSearch · POST CreateCustomer Kunder og adresser → BasicData
POST CreateNewOrder · SetOrderAsCompleted · SetWorkOrderAsCompleted Ordre → Order (+ PDF-kvittering, e-post, timeføring)
POST AssignOrderToDriver / UnassignOrder / AssignOrderToTruck / UnassignOrderFromTruck / AssignOrderRoom / DeleteAssignedOrderRoom / AssignRoute / GetAssignedRoute / DeleteAssignedRoute / UpdateOrderETA Planlegger/fordeling → Order
GET GetOrderCount Antall ordre for dato → Order.GetOrders
POST SaveTransactions / EgneAddTransaction / SaveDeviations / SaveStockGoods Lager/lasting/avvik → Inventory
GET GetDepos Depoter → BasicData.GetDepos
GET GetMessages · POST NewMessage Interne meldinger → User
GET GetReleaseNotes / GetAppShortcuts App-innhold (fil/JSON)

Selskap (CompanyController) — /api/company

Verb Rute Auth Gjør
GET GetCompanies åpen Selskapsliste m/innstillinger (CompaniesSection) — brukes i login-dropdown

Kunde-API (Customers/*) — /api/orders, /api/transactions

Verb Rute Auth Gjør
GET /api/transactions/Get nøkkel Kort-/bulktransaksjoner → Inventory.API_TransactionLog
GET /api/orders/BottomlineOrders · /api/orders/InvoiceDetails nøkkel Utkommentert i koden

Skjema (Forms/FormController) — /api/forms

Verb Rute Auth Gjør
GET CheckExistingEntry JWT Finnes sjekkliste? → Forms.DoesChecklistExists
POST SubmitForm JWT Lagre skjemarespons → Forms.SaveFormResponseAsync
GET GetAllForms JWT Hent responser → Forms.GetAllFormResponsesAsync
GET export JWT Skjemarespons som PDF

Avvik og survey (Landax/*) — /api/landax

Proxy/integrasjon mot Landax (OAuth2). Hovedendepunkter:

Område Endepunkter
Avvik (incidents) GET incidents/my, GET/POST/PATCH incidents, GET incidents/search, notater (GET/POST notes, DELETE notes/{id}), dokumenter (GET/POST/DELETE documents, download)
Oppslagslister IncidentTypes / Categories / Statuses / Priorities / Causes (OData-proxy)
Kiosk-token /api/landax/kiosk-tokens (CRUD + toggle + stats + submissions) → SurveyRepository
Survey /api/landax/surveys (CRUD + søk + proxy)
Kiosk (offentlig) /api/landax/surveys/kiosk/validate · /definitionåpen (AllowAnonymous)

Timeregistrering (Eportal/*)

To kontrollere mot ePortal-databasen (alle JWT):

  • TimeRegistrationController (/api/timeRegistration) — registrering og visning for den ansatte: LoadTimeRegistrationData, GetWageTypes, GetAccex, GetWorkOrders, GetProjects, GetDepartments, SaveTimeRegistration, CopyDayRegistration, DeleteRegistration, m.fl. (50+ endepunkter).
  • TimeRegistrationSettingController (/api/timeRegistrationSetting) — administrasjon: brukere, lønnstyper, avdelinger, prosjekter, tidsgrupper, selvmelding, ansvarsmatrise, periodestatus … (CRUD, 40+ endepunkter).

Disse er admin-/skjematunge og bruker TimeRegistration*Repository direkte mot ePortal-DB (ikke Visma).

Webhooks og MVC

Kontroller Rute Auth Gjør
SMSController POST /SMS/Post Basic Måler-SMS inn → Metering.RegisterMeterValue + svar-SMS
SMSController POST /SMS/Report Basic Leveringsrapport (DLR) → Metering.RegisterDLR
ReceiptController /Receipt/Index MVC-visning av kvittering (mest testkode)

Relaterte sider