Files
sap-bo/documentation/sap-business-one-service-layer.md
T
JiriUhlir a7aedfce10 upt1
2026-06-29 09:55:04 +02:00

34 lines
1.2 KiB
Markdown

# 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:
- `X-SAP-B1-BaseUrl`
- `X-SAP-B1-CompanyDB`
- `X-SAP-B1-Username`
- `X-SAP-B1-Password`
- `X-SAP-B1-Language` volitelně
- `X-SAP-B1-Reject-Unauthorized` volitelně
- `X-SAP-B1-Timeout-Ms` volitelně