POS register

Welcome to the POS-registry

The point of sales registry keeps track of all points of sale, both manned (e.g. a vendor on board a train) and unmanned (e.g a ticket vending machine), using our cash register system. The registry will be populated by the operators through Entur Partner. It is not possible to do a sale from a point of sale not added to this registry.

Authentication

The POS-registry requires for every request a bearer token in the Authorization header either as a internal (Entur employee) user or a partner (e.g NSB employee). You may obtain the token using the Entur Auth0 bearer token provider,  see https://live-entur.devportal.apigee.io/content/authentication

 

 

Short description of POS-registry API

 

Get the location with the given Id

 
 Example response

 

Get all locations in the database

 
 Example response

 

Creates a new Location and returns the created object.

 
 Example request
 
 Example response

GET

Get a POS

Get a POS with the given Id

 
 Example response
 

POST

Create POS

Create a new Point of sale with a PointOfSaleRequest as input and returns the created objects.

 
 Example request
 
 Example response

 

 

The point of sales registry keeps track of all points of sale, both manned (e.g. a vendor on board a train) and unmanned (e.g a ticket vending machine), using our cash register system. The registry will be populated by the operators through Entur Partner. It is not possible to do a sale from a point of sale not added to this registry.

Important concepts:

Point of sale (POS): The place where a transaction is completed. For mobile terminals (MT) this is the employee using the terminal rather than a physical location.
Location: The location of a point of sale identified by coordinates and an optional NSR station identifyer in case the point of sale is situated at a station (whichever type of station, bus station, train station etc). 

ER diagram

 

The API reference(s) can be found here: