SAP Business One Service Layer Connector

Connector komunikuje výhradně přes SAP Business One Service Layer /b1s/v1.

Hlavní vlastnosti:

login/logout přes Service Layer
správa B1SESSION a ROUTEID
automatický re-login po expiraci session
HTTP API s credentials předávanými v X-SAP-B1-* hlavičkách podle AppFactory pravidel
OData parametry $select, $filter, $top, $skip, $orderby
stránkování přes odata.nextLink a @odata.nextLink
retry pro dočasné chyby
zod validace konfigurace a hlavních response tvarů

Bezpečnostní pravidla:

při knihovním použití se konfigurace může číst z environment variables
při HTTP API použití se SAP credentials posílají v request headers
hesla, cookies a session tokeny se nelogují
hesla a session tokeny se nevrací v běžných response
testy nepoužívají reálný SAP přístup
pro self-signed certifikáty je dostupné rejectUnauthorized, ale produkčně se doporučuje důvěryhodný certifikát

HTTP API hlavičky:

Detaily komunikace se Service Layer

Login – POST /b1s/v1/Login s { CompanyDB, UserName, Password, Language? }. Language se posílá jako celé číslo (Service Layer očekává Edm.Int32); nenumerická hodnota se vynechá. Z odpovědi se čtou cookies B1SESSION a ROUTEID (s fallbackem na SessionId v body) a SessionTimeout (minuty) pro výpočet expirace.
Autentizované requesty – posílají Cookie: B1SESSION=…; ROUTEID=…. Při 401 connector jednou provede re-login a request zopakuje; re-login nesnižuje retry budget, takže funguje i při SAP_B1_RETRY_COUNT=0.
Logout – POST /b1s/v1/Logout se posílá s aktivní session cookie, jinak by Service Layer nevěděl, kterou session ukončit, a nechal by ji běžet až do timeoutu.
Stránkování – následuje odata.nextLink i @odata.nextLink. U absolutních nextLinků se zachová i query string ($skip apod.), takže listAll nezacyklí.

Aplikace běží za AppFactory proxy na /apps/<app-id> (Caddy handle_path prefix před předáním do containeru odstraní). Proto:

OpenAPI servers obsahuje ROOT_PATH (/apps/<app-id>), takže Swagger Try it out volá …/apps/<app-id>/api/<resource>.
Swagger UI načítá OpenAPI dokument z ROOT_PATH + /openapi.json, ne z kořene domény.
Lokálně bez ROOT_PATH se vše chová relativně ke kořeni (/openapi.json, server /).