Dành cho AI agent: markdown của trang này — /docs-content-en/entities/catalog-price-types.md chỉ mục tài liệu — /llms.txt
Hiện tại, các bài viết trong tài liệu chỉ có bằng tiếng Anh.
Catalog price types
Price types of your Bitrix24 account: list, retrieve, create, update and delete. A price type is what catalog prices pass in the catalogGroupId field. Bitrix24 requires the Manage price types catalog permission for writes.
Bitrix24 API: catalog.priceType.*
Scope: catalog
Create a price type
POST /v1/catalog-price-types calls catalog.priceType.add. It requires the catalog scope and the Bitrix24 Manage price types permission.
Request fields
| Field | Type | Required | Description |
|---|---|---|---|
name |
string | yes | Price type name |
sort |
number | no | Sort order |
xmlId |
string | no | External integration code |
id, base and audit fields are read-only. Bitrix24 assigns viewing and buying groups [1, 2] (administrators and all users); this route cannot change them.
curl -X POST 'https://vibecode.bitrix24.com/v1/catalog-price-types' \
-H 'X-Api-Key: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"name":"Wholesale","sort":200,"xmlId":"WHOLESALE"}'Success: 201 with the complete created type in data, including id and base: "N". Missing name returns 400 MISSING_REQUIRED_FIELDS; a read-only field returns 400 READONLY_FIELD. A Bitrix24 business refusal returns 422 BITRIX_ERROR with the original message.