PORTOS Developers
  • πŸ‘‹Introduction
  • πŸ“–Glossary
  • HTTP Status codes
  • Error models
  • Error codes
  • Validation constraints
  • Resource names
  • πŸ”’User rights
  • Device environments
  • 🌍Localization
  • πŸ”NData query syntax
  • OpenAPI specification
  • Data models
  • Authentication
    • πŸ”Authentication schemes
      • JWT Bearer Authentication
      • HMAC Authentication
  • ⚑Notifications
    • SignalR
    • Webhooks
  • API reference
    • πŸ”‘API keys
    • πŸ›οΈArticle categories
    • πŸ’ΌCompanies
    • πŸ’±Currencies
    • πŸ‘«Customers
    • πŸ“ˆDaily sales reports
    • πŸ–₯️Devices
    • πŸ–¨οΈFiscals
    • ❀️Health check
    • πŸ“ƒLicense
    • 🎚️Modifiers
    • πŸ‘¨β€πŸ³Order endpoints
    • πŸ›ŽοΈOrders
    • πŸͺ™Payment types
    • β˜•Plus
    • πŸ”Roles
    • πŸ”Sessions
    • βš™οΈSettings
    • πŸ”ŽStock takings
    • πŸ”’Stock transfer numbering
    • 🚚Stock transfers
    • πŸ“¦Stocks
    • 🧾Tickets
      • Ticket Model States
      • Ticket Operations and User Rights
      • Ticket Model Mathematics
    • πŸ‘¨β€πŸ’ΌUsers
    • βš–οΈVats
    • πŸͺ‘Zones
  • 3rd Party Integrations
    • Introduction
    • Online orders API
    • Rewards API
    • PDA Files
  • Previous versions
    • Migration to V4.1
    • Migration to V4
    • Legacy documentation
Powered by GitBook
On this page
  • API methods
  • Get stock transfers
  • Get stock transfer
  • Create stock transfer
  • Create or update stock transfer
  • Delete stock transfer

Was this helpful?

  1. API reference

Stock transfers

This page provides a description of the available API routes for managing stock transfers.

PreviousStock transfer numberingNextStocks

Last updated 1 year ago

Was this helpful?

refers to an operation that alters the quantity of products within storage. Various types of stock transfers are defined, each tailored to a specific purpose: increasing, decreasing, or fixing inaccuracies in stock quantity.

  1. Income: This category signifies the purchase of goods from suppliers, leading to an increase in the stock quantity of the purchased items.

  2. Outcome: Applies when goods are withdrawn from storage due to reasons such as expiration, etc.

  3. Transfer: Relocation of goods from one stock location to another within the inventory.

  4. Sale: Comparable to an "outcome," the system generates this transfer type automatically once a ticket is closed. Each sale stock transfer is associated with a single corresponding ticket.

  5. Invoice: Similar to the "outcome" type, the "invoice" transfer may be used when goods are not directly sold through a cash register.

  6. Correction: Generated automatically by system after finalizing of stock-taking process (closing the ). Its role is to fix inaccuracies in stock quantities that were not matched during the stock-taking phase. May contain both positive and negative stock quantity changes.

API methods

Get stock transfers

GET http://{server-address}/stocktransfers

Returns all stock transfers that matches query parameters. Result is of type .

Query Parameters

Name
Type
Description

type

StockTransferType

Supports NData syntax.

id

string

Supports NData syntax.

$skip

int

Pagination property. Describing number of records to skip from beginning of result collection.

$take

int

Pagination property. Maximum count of items to be returned.

$sort

string[]

Comma separated list of property names. Please see NData syntax.

$count

bool

If set to true, response will not contain items collection. Use to get resource count, not the resources themselves.

specificSymbol

string

Supports NData syntax.

constantSymbol

string

Supports NData syntax.

variableSymbol

string

Supports NData syntax.

deliveryDate

DateTime

Supports NData syntax.

documentDate

DateTime

Supports NData syntax.

documentNumber

string

Supports NData syntax.

dueDate

DateTime

Supports NData syntax.

closedByUserName

string

Filtering based on closedBy.userName property. Supports NData syntax.

closedAt

DateTime

Supports NData syntax.

createdByUserName

string

Filtering based on createdBy.userName property. Supports NData syntax.

partnerCRN

string

Filtering based on partner.crn property. Supports NData syntax.

companyCRN

string

Filtering based on company.crn property. Supports NData syntax.

itemSourceOrDestinationPluCode

int

Filtering based on sourcePlu.code and destinationPlu.code properties in items collection. Supports NData syntax.

currencyLabel

string

Supports NData syntax.

discountRate

decimal

Supports NData syntax.

paymentType

string

Supports NData syntax.

deliveryType

string

Supports NData syntax.

itemDestinationPluStockName

string

Filtering based on destinationPlu.stockName property in items collection. Supports NData syntax.

itemSourcePluCode

int

Filtering based on sourcePlu.code property in items collection. Supports NData syntax.

itemSourcePluStockName

string

Filtering based on sourcePlu.stockName property in items collection. Supports NData syntax.

itemSourceOrDestinationPluStockName

string

Filtering based on sourcePlu.stockName and destinationPlu.stockName properties in items collection. Supports NData syntax.

itemDestinationPluCode

int

Filtering based on destinationPlu.code property in items collection. Supports NData syntax.

Headers

Name
Type
Description

Authorization*

string

Authorization header with authorization token.

Get stock transfer

GET http://{server-address}/stocktransfers/{id}

Path Parameters

Name
Type
Description

id*

string

Stock transfer identifier.

Headers

Name
Type
Description

Authorization*

string

Authorization header with authorization token.

{
    "title": "Zdroj nebol nΓ‘jdenΓ½",
    "status": 404
}

Create stock transfer

POST http://{server-address}/stocktransfers

Required rights

Headers

Name
Type
Description

Authorization*

string

Authorization header with authorization token.

Request Body

Name
Type
Description

(body)*

StockTransfer

Model to create

Create or update stock transfer

PUT http://{server-address}/stocktransfers/{id}

Stock transfer marked as closed cannot be updated.

Required rights

Path Parameters

Name
Type
Description

id*

string

Stock transfer identifier.

Headers

Name
Type
Description

Authorization*

string

Authorization header with authorization token.

Request Body

Name
Type
Description

(body)*

StockTransfer

Model to create or update.

Delete stock transfer

DELETE http://{server-address}/stocktransfers/{id}

Required rights

Path Parameters

Name
Type
Description

id*

string

Stock transfer identifier.

Headers

Name
Type
Description

Authorization*

string

Authorization header with authorization token.

{
    "title": "Zdroj nebol nΓ‘jdenΓ½",
    "status": 404
}

Result is of type .

Creates new stock transfer. Result is of type .

Authorized user must have StockTransferCreate assigned. If stock transfer is marked as closed, additional StockTransferClose is required.

Updates existing or creates new stock transfer. Result is of type .

Authorized user must have assigned StockTransferCreate or StockTransferUpdate . If stock transfer is created by another user, additional StockTransferUpdateAny is required. If stock transfer is marked as closed, additional StockTransferClose is required.

Authorized user must have StockTransferDelete assigned.

🚚
right
right
right
right
right
right
stock taking
Stock transfer
QueryResult<StockTransfer>
StockTransfer
StockTransfer
StockTransfer