Positions
The model describing receipt line items.
If an external validation is performed for a marking code, the response is reused for 30 minutes for requests with the same data. Sale and refund results are stored separately. Service availability errors are not cached; restarting REGOS: VCR clears the cache.
| Name | Data type | Required | Parameter description |
|---|---|---|---|
| amount | int64 | Required | Total line-item value before discount. Amount * 100. Must not be less than 0 |
| articul | string | Optional | Product article number |
| barcode | string | Required without a marking code | Product barcode. If a valid label is present in the receipt, REGOS: VCR uses the barcode extracted from the marking code instead of the supplied value. In Receipt.ValidatePosition, the barcode is required and checked against the marking code |
| brand_name | string | Optional | Brand name |
| code | string | Optional | Product code |
| color_name | string | Optional | Color name |
| commission_inn | string | Optional | TIN (9 digits) or PINFL (14 digits) of the person supplying the goods on consignment |
| country_name | string | Optional | Country of manufacture |
| department_name | string | Optional | Department name |
| discount | int64 | Required | Line-item discount amount. Amount * 100. Must not be less than 0 |
| group_name | string | Optional | Product group name |
| icps | string | Required | ICPS - identification code of products and services |
| label | string | Optional | Mandatory marking code: every value must be unique within one receipt; an empty string is allowed. Allowed characters: ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789!"%&'()*+,-./_:;=<>? |
| name | string | Required | Product name |
| owner_type | enum | Required / Optional if "Product origin" is configured in REGOS: VCR settings | Product origin: NotSpecified (not specified), BuyingAndSelling (purchase and sale), Produced (production), Service (services) |
| package_code | string | Required | Package code. If omitted and the "Store the ICPS database locally" setting is enabled in REGOS: VCR, package_code is looked up in that database; if the setting is disabled, package_code is looked up online on the servers of the UNIFIED ELECTRONIC NATIONAL CATALOG OF PRODUCTS (GOODS AND SERVICES) at https://tasnif.soliq.uz/ |
| producer_name | string | Optional | Manufacturer name |
| quantity | int64 | Required | Quantity in grams. Always greater than 0. If label is set, always 1000. For unit-counted goods, 1000 * number of units |
| size_name | string | Optional | Size name |
| type_name | string | Optional | Product type name |
| unit_name | string | Optional | Unit of measurement name |
| vat_value | int64 | Required | VAT rate * 100. For "Without VAT", send "-1". The VAT rate must be registered in REGOS: VCR |
A marking code identifies a specific product instance. An instance cannot be sold again on this REGOS: VCR installation until the corresponding sale is successfully refunded. Different representations of the same marking code do not count as different instances. Local validation applies independently of external validation and its cache.
Local marking records accumulate only for sales registered after upgrading to version 2026-10-30. Earlier receipts are not used to initialize these records.