Sitoo API Reference

This is the reference pages for the Sitoo API containing information on all endpoints and their usage.

Cash Registers

The Cash Registers endpoints are used to get information on the POS-instances used in the system.

Go to Cash Registers endpoints


Categories are used to structure products in the POS and can be used for filtering. The categories can be ordered in a tree structure if needed. A product can belong to multiple categories.

Go to Categories endpoints

Dashboard Custom Metrics

Custom Metrics for Dashboards is used to integrate external data in Sitoo Dashboards.

Go to Dashboard Custom Metrics endpoints

Gift Cards

The endpoints handle all use-cases for gift cards such as creating, validating, redeeming and refilling. The endpoints can also be used to integrate e-commerce gift cards with one-point of truth.

Go to Gift Cards endpoints

Influencer Codes

Use Influencer Codes to promote your campaigns via a network of influencers. An influencer code is used to activate one or more campaigns in Sitoo POS.

Go to Influencer Codes endpoints

Influencer Vouchers

Influencer Vouchers is used to handle the actual use of your influencer vouchers.

Go to Influencer Vouchers endpoints


Manufacturers (Brands) are used to group products in the POS. They can also be used to filter products in the POS.

Go to Manufacturers endpoints


Orders endpoints are used for handling all transactions in the system. Also used to add e-commerce orders for validated refunds in store, bookings/reservations and pick-up-in-store functionality.

Go to Orders endpoints

POS Payment Types

Endpoints for payment types used in Sitoo POS.

Go to POS Payment Types endpoints

Price Lists

Use price lists to manage the prices for your products. Price lists can be locked to a specific store or campaign.

Go to Price Lists endpoints

Product Custom Attributes

Custom attributes are definitions of custom fields for products. A powerful way of setting up custom product attributes specific to your own industry or use case.

Go to Product Custom Attributes endpoints

Product Groups (VAT)

Product Groups are used to group products, mainly for bookkeeping purposes. The product groups also have the setting for the VAT percentage, used for a product.

Go to Product Groups (VAT) endpoints

Product Images & Files

Assign images and files to products.

Go to Product Images & Files endpoints

Product Variants

This interface is used for handling product variants, e.g. Sizes. All product variants are also accessible via the Products endpoints, but with restricted fields available.

Go to Product Variants endpoints


The endpoints are used for adding, updating and deleting basic products.

Go to Products endpoints. For more specifice use of products, please refer to:


Resources is used for handling images and other files. The resources are shared for all sites in a Sitoo system.

Go to Resources endpoints

Reason Codes

Collection of reason codes for warehouse transactions, actions and other events used in the POS to distinguish different usages.

Go to Reason Codes endpoints

Sales Taxes

Endpoints for handling settings and rules for applying sales taxes. Not to be confused with VAT which is handled in Product Groups (VAT)

Go to Sales Taxes endpoints

Service Orders

Endpoints for handling functionality regarding when service needs to be performed on a product.

Go to Service Orders endpoints


Endpoints for handling shipments of items to and from stores/warehouses.

Go to Shipments endpoints


A site represents an instance of an organisation/sales-channel. Note! The siteid(uniqueidentifier) has been deprecated in favor of eshopid(integer). For all requests to Sitoo API endpoint URLs, the {siteid} parameter should contain the eshopid value.

Future endpoints added to the API will only implement the use of eshopid for the {siteid} parameter.

Go to Sites endpoints


Set up stores for your business.

Go to Stores endpoints


The endpoints are used to handle campaigns in a Sitoo system. There are 4 groups of vouchers: Order/Cart, Product, Package and Pricelist which together cover most of the use-cases for campaign handling.

Go to Vouchers endpoints


Endpoints for handling users. Users are shared for all sites in a Sitoo system.

Go to Users endpoints

Warehouse Batches

Warehouses batches are used to handle a session on the server for updating warehouse items. Closing a warehouse batch will create a warehouse transaction with the changes to the stock in it.

Go to Warehouse Batches endpoints

Warehouse Transactions

Warehouse transactions are the events that operate on warehouseitems.

Go to Warehouse Transactions endpoints


The endpoints handle common use-cases for warehouses. Stock levels can be directly modified for Virtual warehouses, but for FIFO-warehouses, stock needs to be handled using Warehouse Transactions or Warehouse Batches. Warehouses can be connected (belong) to a store.

Go to Warehouses endpoints


These endpoints are used to get z-reports generated by the POS-instances. Also includes endpoints for z-reports aggregated per store (Aggregated store Z-reports require backend configuration, ask your Sitoo-contact for more info)

Go to Z-Reports endpoints