Product Price
POST /product-price/entity/<entity_id>
DELETE /product-price/entity/<entity_id>
POST /product-price/updateEntitiesWithDependencies
GET /product-price/document/<_id>
PATCH /product-price/document/<_id>
DELETE /product-price/document/<_id>
GET /product-price/mapping/entity/<entity_id>
POST /product-price/mapping/entity/<entity_id
Endpoints
GET /product-price/current
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
header |
| [ csv of string ] | No | The unique identifier (UIDs) of the site to manage data for |
query |
| string | No | A filter expression in OData v4 format |
query |
| int32 | No | The maximum documents to return |
query |
| int32 | No | The documents to skip before returning |
query |
| string | No | An order by expression in OData v4 format |
query |
| string | Yes | The date and time to query against |
query |
| [ string ] | No | An array of entity identifiers |
query |
| boolean | No | Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups) |
query |
| boolean | No | Include the mappings for the document in the response |
query |
| [ csv of string ] | No | Specifies entity types for which mappings are presented as a part of the response (For example, |
query |
| [ csv of string ] | No | Specifies |
query |
| boolean | No | Adds audit fields to each document when returning a result ( |
query |
| boolean | No | Includes the documents that are inactive for the current sites |
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
Sample Success Response Body
{ "items": [ { "_id": "9999999999999999", "unit_price": 4.29, "time_period_entity_ids": [], "product_entity_id": "9999999999999999", "product_id": "9999", "external_category_ids": [], "external_id": "", "entity_id": "9999999999999999", "type": "standard", "imported_at": "20YY-06-15T14:43:01.754Z" } ], "total": 167, "page_count": 2, "current_page": 1, "page_size": 100 }
GET /product-price/list
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
header |
| [ csv of string ] | No | The unique identifiers (UIDs) of the site to manage data for |
query |
| string | No | A filter expression in OData v4 format |
query |
| int32 | No | The maximum documents to return |
query |
| int32 | No | The documents to skip before returning |
query |
| string | No | An order by expression in OData v4 format |
query |
| string | Yes | The date and time to query against |
query |
| [ string ] | No | An array of entity identifiers |
query |
| boolean | No | Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups) |
query |
| [ csv of string ] | No | Specifies |
query |
| boolean | No | Adds audit fields to each document when returning a result ( |
query |
| boolean | No | Includes the documents that are inactive for the current sites |
query |
| [ csv of string ] | No | Specifies entity types for which mappings are presented as a part of the response (For example, |
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
POST /product-price
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
query |
| boolean | No | Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups) |
query |
| [ csv of string ] | No | Specifies |
body |
| Yes | The JSON formatted request |
Request Body
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
POST /product-price/entity/<entity_id>
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
path |
| string | Yes | The identifier of the entity |
body |
| Yes | The JSON formatted request |
Request Body
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
DELETE /product-price/entity/<entity_id>
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
path |
| string | Yes | The identifier of the entity |
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
POST /product-price/updateEntitiesWithDependencies
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
header |
| [ csv of string ] | No | The unique identifiers (UIDs) of the site to manage data for |
body |
| Yes | Supports the mappings field (array/boolean) for each document. With mappings: True mappings are created for the current date and sites from the |
Request Body
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
GET /product-price/document/<_id>
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
path |
| string | Yes | The identifier of the document |
query |
| boolean | No | Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups) |
query |
| [ csv of string ] | No | Specifies |
query |
| [ csv of string ] | No | Specifies entity types for which mappings are presented as a part of the response (For example, |
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
PATCH /product-price/document/<_id>
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
path |
| string | Yes | The identifier of the document |
query |
| boolean | No | Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups) |
query |
| [ csv of string ] | No | Specifies |
body |
| Yes | The JSON of the category being patched |
Request Body
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
DELETE /product-price/document/<_id>
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
path |
| string | Yes | The identifier of the document |
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
GET /product-price/mapping/entity/<entity_id>
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
header |
| [ csv of string ] | No | The identifiers of the site to manage data for |
path |
| string | Yes | The identifier of the entity |
query |
| int32 | No | The maximum documents to return |
query |
| int32 | No | The documents to skip before returning |
query |
| string | No | A filter expression in OData v4 format |
query |
| string | No | An order by expression in OData v4 format |
query |
| boolean | No | Includes the documents that are inactive for the current sites |
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
POST /product-price/mapping/entity/<entity_id>
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
header |
| [ csv of string ] | No | The unique identifiers (UIDs) of the site to manage data for |
path |
| string | Yes | The identifier of the entity |
body |
| Yes | The array of the product price mappings being added |
Request Body
[ array ] (unspecified type)
Response: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
| integer | |
| [ array ] | |
| string | The auto-assigned system document identifier |
| string | The identifier of the company that owns the document |
| string | The identifier of the site associated with the document |
| string | The auto-assigned unique identifier of the entity, set on creation. All future versions of the entity share the same |
| string | The identifier of the document in the collection the mapping refers to |
| string | The identifier of the OPRA user or site that created the document |
| string | The identifier of the OPRA user or site that last updated the document |
| string | The last date and time the document was updated |
| string | The last date and time the document was updated |
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
POST /product-price/mapping
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
body |
| Yes | The JSON of the product price mapping being added |
Request Body
Field Name | Type | Description |
|---|---|---|
| string | The identifier of the document in the collection the mapping refers to |
| string | The auto-assigned unique identifier (UID) of the entity, set on creation. All future versions of the entity share the same |
| string | The date and time the document becomes "current" |
| [ string ] | The identifier of the site associated with the document |
Response: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
| integer | |
| [ array ] | |
| string | The auto-assigned system document identifier |
| string | The identifier of the company that owns the document |
| string | The identifier of the site associated with the document |
| string | The auto-assigned unique identifier (UID) of the entity, set on creation. All future versions of the entity share the same |
| string | The identifier of the document in the collection the mapping refers to |
| string | The identifier of the OPRA user or site that created the document |
| string | The identifier of the OPRA user or site that last updated the document |
| string | The last date and time the document was updated |
| string | The last date and time the document was updated |
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
Data Models
product_price
The Product Price request create validation JSON-schema.
Field Name | Type | Required | Description |
|---|---|---|---|
| string | No |
|
| string | No | The possible values are"standard," "conditional," "child-tag," "child-product," "child-both," "child-quantity-product," "child-quantity-tag," or "child-quantity-both." |
| number (currency) | Yes |
|
| string | No |
|
| [ string,object ] | No |
|
| string,object | No |
|
| [ string,object ] | No |
|
| [ string,object ] | No |
|
| [ string ] | No |
|
| object | No |
|
| string | No | The possible values are"replace" or "adjust." |
| [ string ] | No | The category identifiers provided by IRIS/EDM, not exposed to the Data Management (DM) user interface (UI) |
| [ string,object ] | No | An array of Product Category entity identifiers |
| string,object | No |
|
| [ string,object ] | No | An array of allowed Order Source entity identifiers |
| [ string ] | No | An array of allowed Order Source identifiers |
| [ string,object ] | No | An array of allowed Order Destination entity identifiers |
| [ string ] | No | An array of allowed Order Destination identifiers |
| boolean | No | The flag that indicates if the price is quantity-based or not |
| string,object | No | The identifier of the group of quantity price ranges. It helps to understand which prices are related to the same group. |
| string | No | The possible values are"child-product," "child-tag," or "child-both." |
| [ string,object ] | No | The list of the product entity identifiers related to the price |
| [ string,object ] | No | The list of the tag entity identifiers related to the price |
| integer | No | The quantity-based field. It defines the range start of the price. |
| integer | No | The quantity-based field. It defines the range end of the price. |
| boolean | No | This price already includes all taxes that are applicable to it |
| boolean | No | The internal property to keep |
| integer | No | Defines the priority between the prices of one type |
| No |
| |
| No |
| |
| No |
| |
| No |
| |
| No |
| |
| No |
| |
| No |
| |
| No | ||
| No | ||
| No |
product_price_create
The Product Price request create validation JSON-schema.
Field Name | Type | Description |
|---|---|---|
| string |
|
| string | The possible values are"standard," "conditional," "child-tag," "child-product," "child-both," "child-quantity-product," "child-quantity-tag," or "child-quantity-both." |
| number (currency) |
|
| string |
|
| [ string, object ] |
|
| string, object |
|
| [ string, object ] |
|
| [ string, object ] |
|
| [ string ] |
|
| object |
|
| string | The possible values are"replace" or "adjust." |
| [ string ] | The category identifiers provided by IRIS/EDM, not exposed to the Data Management (DM) user interface (UI) |
| [ string, object ] | An array of Product Category entity identifiers |
| string, object |
|
| [ string, object ] | An array of allowed Order Source entity identifiers |
| [ string ] | An array of allowed Order Source identifiers |
| [ string, object ] | An array of allowed Order Destination entity identifiers |
| [ string ] | An array of allowed Order Destination identifiers |
| boolean | The flag that indicates if the price is quantity-based or not |
| string, object | The identifier of the group of quantity price ranges. Defines which prices are related to the same group. |
| string | The possible values are "child-product," "child-tag," or "child-both." |
| [ string, object ] | The list of the product entity identifiers related to the price |
| [ string, object ] | The list of the tag entity identifiers related to the price |
| integer | The quantity-based field. It defines the range start of the price. |
| integer | The quantity-based field. It defines the range end of the price. |
| boolean | The price already includes all taxes that are applicable to it |
| boolean | The internal property to keep |
| integer | Defines the priority between the prices of one type |
|
| |
|
|
product_price_edit
The Product Price request create validation JSON-schema.
Field Name | Type | Description |
|---|---|---|
| string |
|
| string | The possible values are"standard," "conditional," "child-tag," "child-product," "child-both," "child-quantity-product," "child-quantity-tag," or "child-quantity-both." |
| number (currency) |
|
| string |
|
| [ string, object ] |
|
| string, object |
|
| [ string, object ] |
|
| [ string, object ] |
|
| [ string ] |
|
| object |
|
| string | The possible values are"replace" or "adjust." |
| [ string ] | The category identifiers provided by IRIS/EDM, not exposed to the Data Management (DM) user interface (UI) |
| [ string, object ] | An array of Product Category entity identifiers |
| string, object |
|
| [ string, object ] | An array of allowed Order Source entity identifiers |
| [ string ] | An array of allowed Order Source identifiers |
| [ string, object ] | An array of allowed Order Destination entity identifiers |
| [ string ] | An array of allowed Order Destination identifiers |
| boolean | The flag that indicates if the price is quantity-based or not |
| string, object | The identifier of the group of quantity price ranges. It helps to understand which prices are related to the same group. |
| string | The possible values are "child-product," "child-tag," or "child-both." |
| [ string, object ] | The list of the product entity identifiers related to the price |
| [ string, object ] | The list of the tag entity identifiers related to the price |
| integer | The quantity-based field. It defines the range start of the price. |
| integer | The quantity-based field. It defines the range end of the price. |
| boolean | The price already includes all taxes that are applicable to it |
| boolean | The internal property to keep tax_inclusive sync logic (tax_inclusive is inherited from the parent product) |
| integer | Defines the priority between prices of one type |
|
|
product_price_list
Field Name | Type | Description |
|---|---|---|
| integer |
|
| [ product_price ] |
|
name
Field Name | Type | Description |
|---|---|---|
| string |
product_id
Field Name | Type | Description |
|---|---|---|
| string |
product_entity_id
The product entity_id.
Field Name | Type | Description |
|---|---|---|
| string,object | The product |
quantity_based
The flag that indicates if the price is quantity-based or not.
Field Name | Type | Description |
|---|---|---|
| boolean | The flag that indicates if the price is quantity-based or not |
_id
The auto-assigned system document identifier.
Field Name | Type | Description |
|---|---|---|
| string | The auto-assigned system document identifier |
company_id
The identifier of the company that owns the document.
Field Name | Type | Description |
|---|---|---|
| string | The identifier of the company that owns the document |
entity_id
The auto-assigned unique identifier (UID) of the entity, set on creation. All future versions of the entity share the same entity_id.
Field Name | Type | Description |
|---|---|---|
| string | The auto-assigned unique ID of this entity, set on creation. All future versions of this entity will share the same |
is_master
Field Name | Type | Description |
|---|---|---|
| boolean |
is_active
Marking property is the essence of active documents. Sets in true by default.
Field Name | Type | Description |
|---|---|---|
| boolean | Marking property is the essence of active documents. Sets in true by default. |
external_id
Field Name | Type | Description |
|---|---|---|
| string |
created_by
The identifier of the OPRA user or site that created the document.
Field Name | Type | Description |
|---|---|---|
| string | The identifier of the OPRA user or site that created the document |
updated_by
The identifier of the OPRA user or site that last updated the document.
Field Name | Type | Description |
|---|---|---|
| string | The identifier of the OPRA user or site that last updated the document |
created_at
The date and time the document was created.
Field Name | Type | Description |
|---|---|---|
| string | The date and time (date-time) the document was created |
updated_at
The last date and time the document was updated.
Field Name | Type | Description |
|---|---|---|
| string | The last date and time (date-time) the document was updated |