---
title: "POST /api/pos"
method: POST
path: "/api/pos"
tags: ["api", "pos"]
---

# POST /api/pos

`POST /api/pos`

Create a POS

## Request body

- POSTPosCreateAPos
  - `name` string, required
  - `posNo` string, nullable
  - `printingType` string, required

## Response `201`

Created

- POSResource
  - `_id` string, required — The ID of the POS
  - `sellerId` string — The ID of the seller owning this POS
  - `active` boolean, required — Whether the POS is active or not
  - `name` string, required — The name of the POS
  - `posNo` string, required — The number of the POS
  - `printingType` 'EXTERNAL' | 'DIRECT', required — The printing type of the POS. DIRECT = direct printing. EXTERNAL = extenral printing.
  - `restrictions` object — Restrictions of the POS
    - `restrictXReportAccess` boolean — Whether the code must be inserted in order to see the x reports
    - `restrictZReportAccess` boolean — Whether the code must be inserted in order to generate a z report and to finish the session
    - `restrictDashboardAccess` boolean — Whether the POS user can see the dashboard
    - `restrictInstantCancellation` boolean — Whether POS user can cancel a transaction immediately
    - `code` string — Code to unlock x and z reports if restricted
    - `restrictEventAccess` boolean — Whether the POS user can only choose specific events and/or specific secret shops
    - `restrictPurchaseIntents` boolean — Whether the POS user can manage purchase intents
    - `restrictCustomerAccess` boolean — Whether the POS user can manage customers and select them during transactions
    - `allowedEvents` string[] — An array of IDs of allowed events
  - `signature` object — POS signature settings
    - `fiskaly` object — Fiskaly settings
      - `tssId` string — The ID of the TSS
      - `clientId` string — The ID of the client
      - `state` 'UNINITIALIZED' | 'INITIALIZED' | 'DISABLED' — The state of the TSS
  - `state` 'disabled' | 'active' — The state of the POS
  - `createdAt` string, date-time — An ISO timestamp indicating when the POS was created
  - `updatedAt` string, date-time — An ISO timestamp indicating when the POS was updated

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/vivenu/apis/vivenu-api.md) · [All operations](https://skmtc.net/vivenu/apis/vivenu-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vivenu/vivenu-api/revisions/36be0dca14e7/schema)