POSPOS Unit

Open POS Unit

Opens a POS Unit so it can accept sales. Idempotent: if the unit is already OPEN, returns the current unit state. Only UNATTENDED POS Units can be opened via this endpoint — it is intended for self-service / kiosk flows. Returns 400 when the unit is not UNATTENDED, INACTIVE (cannot be opened via API — activate it first), or EOD (complete the attended End-of-Day procedure before reopening). Returns 404 if the unitId is unknown.

Authentication

x-np-api-keystring
API Key authentication via header

Path parameters

tenantstringRequired

Your Entra Tenant ID. More details.

environmentstringRequired

Your Business Central Environment. More details.

companystringRequired

Your Business Central Company. More details.

unitIdUUIDRequired

Headers

x-api-versiondateOptional

Used for API versioning. More details.

Response

This endpoint returns an object.
idUUID
codestring
namestring
posStoreCodestring
The code of the POS Store that the unit is associated with.
selfserviceProfileobject

Self-service configuration from the unit’s Self Service Profile. Only present when the unit has a profile assigned.