Variant
POST /variant/entity/<entity_id>
DELETE /variant/entity/<entity_id>
POST /variant/updateEntitiesWithDependencies
DELETE /variant/document/<_id>
GET /variant/mapping/entity/<entity_id>
POST /variant/mapping/entity/<entity_id>
Endpoints
GET /variant/master
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
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 | 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 |
query |
| boolean | No | Includes the documents that are inactive for the current sites |
Response: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
| integer | |
| [ array, object ] | Stores the definition of a variant |
| string | The name of the variant |
| string | The type of product the variant can be applied to. Examples: "standard," "modifier" |
| string, object | The |
| string | How the variant affects the price, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the price multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | How the variant affects the quantity, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the quantity multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | Identifies whether or not the variation is the The possible values are "none," "add," or "no." |
| integer | The sort option for the variant positioning. For example, Small (1), Medium (2), Large (3). |
| string | The auto-assigned system document identifier |
| string | The identifier of the company that owns the document |
| string | The auto-assigned unique identifier (UID) of the entity, set on creation. All future versions of the entity share the same |
| boolean | |
| boolean | Marking property is the essence of active documents. Sets in |
| string | |
| 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 date and time (date-time) the document was created |
| string | The last date and time (date-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 |
GET /variant/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 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 |
| 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: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
| integer | |
| [ array, object ] | Stores the definition of a variant |
| string | The name of the variant |
| string | The type of product the variant can be applied to. Examples: "standard," "modifier" |
| string, object | The |
| string | How the variant affects the price, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the price multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | How the variant affects the quantity, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the quantity multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | Identifies whether or not the variation is the The possible values are "none," "add," or "no." |
| integer | The sort option for the variant positioning. For example, Small (1), Medium (2), Large (3). |
| string | The auto-assigned system document identifier |
| string | The identifier of the company that owns the document |
| string | The auto-assigned UID of the entity, set on creation. All future versions of the entity share the same |
| boolean | |
| boolean | Marking property is the essence of active documents. Sets in |
| string | |
| 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 date and time (date-time) the document was created |
| string | The last date and time (date-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 |
GET /variant/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: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
| integer | |
| [ array, object ] | Stores the definition of a variant |
| string | The name of the variant |
| string | The type of product the variant can be applied to. Examples: "standard," "modifier" |
| string, object | The |
| string | How the variant affects the price, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the price multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | How the variant affects the quantity, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the quantity multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50%. |
| string | Identifies whether or not the variation is the The possible values are "none," "add," or "no." |
| integer | The sort option for the variant positioning. For example, Small (1), Medium (2), Large (3). |
| string | The auto-assigned system document identifier |
| string | The identifier of the company that owns the document |
| string | The auto-assigned UID of the entity, set on creation. All future versions of the entity share the same |
| boolean | |
| boolean | Marking property is the essence of active documents. Sets in |
| string | |
| 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 date and time (date-time) the document was created |
| string | The last date and time (date-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 /variant
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
Field Name | Type | Description |
|---|---|---|
object | Stores the definition of a variant | |
| string | The name of the variant |
| string | The type of product the variant can be applied to. Examples: "standard," "modifier" |
| string, object | The |
| string | none, fixed_amount, fixed_rate How the variant affects the price, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the price multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | How the variant affects the quantity, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the quantity multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | Identifies whether or not the variation is the The possible values are "none," "add," or "no." |
| integer | The sort option for the variant positioning. For example, Small (1), Medium (2), Large (3). |
| string | The auto-assigned unique identifier (UID) of the entity, set on creation. All future versions of the entity share the same |
| string |
Response: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
object | Stores the definition of a variant | |
| string | The name of the variant |
| string | The type of product the variant can be applied to. Examples: standard, modifier |
| string, object | The |
| string | How the variant affects the price, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the price multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | How the variant affects the quantity, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the quantity multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | Identifies whether or not the variation is the The possible values are "none," "add," or "no." |
| integer | The sort option for the variant positioning. For example, Small (1), Medium (2), Large (3). |
| string | The auto-assigned system document identifier |
| string | The identifier of the company that owns the document |
| string | The auto-assigned UID of the entity, set on creation. All future versions of the entity share the same |
| boolean | |
| boolean | Marking property is the essence of active documents. Sets in |
| string | |
| 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 date and time (date-time) the document was created |
| string | The last date and time (date-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 /variant/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
Field Name | Type | Description |
|---|---|---|
[ array, object ] | Stores the definition of a variant | |
| string | The name of the variant |
| string | The type of product the variant can be applied to. Examples: "standard," "modifier" |
| string, object | The |
| string | How the variant affects the price, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the price multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | How the variant affects the quantity, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the quantity multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | Identifies whether or not the variation is the The possible values are "none," "add," or "no." |
| integer | The sort option for the variant positioning. For example, Small (1), Medium (2), Large (3). |
| string | The auto-assigned unique identifier (UID) of the entity, set on creation. All future versions of the entity share the same |
| string |
Response: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
[ array, object ] | Stores the definition of a variant | |
| string | The name of the variant |
| string | The type of product the variant can be applied to. Examples: standard, modifier |
| string, object | The |
| string | How the variant affects the price, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the price multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | How the variant affects the quantity, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the quantity multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | Identifies whether or not the variation is the The possible values are "none," "add," or "no." |
| integer | The sort option fort he variant positioning. For example, Small (1), Medium (2), Large (3). |
| string | The auto-assigned system document identifier |
| string | The identifier of the company that owns the document |
| string | The auto-assigned UID of the entity, set on creation. All future versions of the entity share the same |
| boolean | |
| boolean | Marking property is the essence of active documents. Sets in |
| string | |
| 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 date and time (date-time) the document was created |
| string | The last date and time (date-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 |
DELETE /variant/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 /variant/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
Field Name | Type | Description |
|---|---|---|
[ array, object ] | Stores the definition of a variant | |
| string | The name of the variant |
| string | The type of product the variant can be applied to. Examples: "standard," "modifier" |
| string, object | The |
| string | How the variant affects the price, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the price multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | How the variant affects the quantity, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the quantity multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | Identifies whether or not the variation is the The possible values are "none," "add," or "no." |
| integer | The sort option for the variant positioning. For example, Small (1), Medium (2), Large (3). |
| string | The auto-assigned UID of the entity, set on creation. All future versions of the entity share the same |
| string |
Response: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
| integer | |
| [ array, object ] | Stores the definition of a variant |
| string | The name of the variant |
| string | The type of product the variant can be applied to. Examples: standard, modifier |
| string, object | The |
| string | How the variant affects the price, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the price multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | How the variant affects the quantity, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the quantity multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | Identifies whether or not the variation is the The possible values are "none," "add," or "no." |
| integer | The sort option for the variant positioning. For example, Small (1), Medium (2), Large (3). |
| string | The auto-assigned system document identifier |
| string | The identifier of the company that owns the document |
| string | The auto-assigned UID of the entity, set on creation. All future versions of the entity share the same |
| boolean | |
| boolean | Marking property is the essence of active documents. Sets in |
| string | |
| 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 date and time (date-time) the document was created |
| string | The last date and time (date-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 |
GET /variant/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: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
object | Stores the definition of a variant | |
| string | The name of the variant |
| string | The type of product the variant can be applied to. Examples: "standard," "modifier" |
| string, object | The |
| string | How the variant affects the price, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the price multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | How the variant affects the quantity, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the quantity multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50%. |
| string | Identifies whether or not the variation is the The possible values are "none," "add," or "no." |
| integer | The sort option for the variant positioning. For example, Small (1), Medium (2), Large (3). |
| string | The auto-assigned system document identifier |
| string | The identifier of the company that owns the document |
| string | The auto-assigned unique identifier (UID) of the entity, set on creation. All future versions of the entity share the same |
| boolean | |
| boolean | Marking property is the essence of active documents. Sets in |
| string | |
| 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 date and time (date-time) the document was created |
| string | The last date and time (date-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 |
PATCH /variant/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
Field Name | Type | Description |
|---|---|---|
object | Stores the definition of a variant | |
| string | The name of the variant |
| string | The type of product the variant can be applied to. Examples: "standard," "modifier" |
| string, object | The |
| string | How the variant affects the price, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the price multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | How the variant affects the quantity, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the quantity multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | Identifies whether or not the variation is the The possible values are "none," "add," or "no." |
| integer | The sort option for the variant positioning. For example, Small (1), Medium (2), Large (3). |
| string |
Response: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
object | Stores the definition of a variant | |
| string | The name of the variant |
| string | The type of product the variant can be applied to. Examples: standard, modifier |
| string, object | The |
| string | How the variant affects the price, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the price multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | How the variant affects the quantity, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the quantity multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | Identifies whether or not the variation is the The possible values are "none," "add," or "no." |
| integer | The sort option for the variant positioning. For example, Small (1), Medium (2), Large (3). |
| string |
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 /variant/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 /variant/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 |
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: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
| integer | |
| [ array, object ] | |
| 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 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 date and time (date-time) the document was created |
| string | The last date and time (date-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 /variant/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 time period mappings being added |
Request Body
[ array ] (unspecified type)
Response: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
| integer | |
| [ array, object ] | |
| 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 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 date and time (date-time) the document was created |
| string | The last date and time (date-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 /variant/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 variant 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 (date-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, object ] | |
| 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 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 date and time (date-time) the document was created |
| string | The last date and time (date-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
variant_entity_id
The variant entity_id.
Field Name | Type | Description |
|---|---|---|
| string, object | The variant entity_id |
variant_type_entity_id
Field Name | Type | Description |
|---|---|---|
| string, object |
variant_kit_entity_ids
An array of variant entity_ids.
Field Name | Type | Description |
|---|---|---|
| array | An array of variant |
variant
Stores the definition of a variant.
Field Name | Type | Required | Description |
|---|---|---|---|
| string | Yes |
|
| string | No | The type of product the variant can be applied to. The possible values are "standard" or "modifier." |
| string, object | No | The |
| string | Yes | How the variant affects the price, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | Yes | The value of the price multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | Yes | How the variant affects the quantity, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | Yes | The value of the quantity multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | No | Identifies whether or not the variation is the without or with. The possible values are "none," "add," or "no." |
| integer | No | The sort option for the variant positioning. For example, Small (1), Medium (2), Large (3). |
| No |
| |
| No |
| |
| No |
| |
| No |
| |
| No |
| |
| No |
| |
| No |
| |
| No |
| |
| No |
| |
| No |
|
variant_create
Stores the definition of a variant.
Field Name | Type | Required | Description |
|---|---|---|---|
| string | Yes |
|
| string | No | The type of product the variant can be applied to. The possible values are "standard" or "modifier." |
| string, object | No | The |
| string | Yes | How the variant affects the price, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | Yes | The value of the price multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | Yes | How the variant affects the quantity, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | Yes | The value of the quantity multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | No | Identifies whether or not the variation is the The possible values are "none," "add," or "no." |
| integer | No | The sort option for the variant positioning. For example, Small (1), Medium (2), Large (3). |
| No |
| |
| No |
|
variant_edit
Stores the definition of a variant.
Field Name | Type | Description |
|---|---|---|
| string |
|
| string | The type of product the variant can be applied to. The possible values are "standard" or "modifier." |
| string, object | The |
| string | How the variant affects the price, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the price multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | How the variant affects the quantity, either by a fixed amount or a percentage. The possible values are "none," "fixed_amount," or "fixed_rate." |
| number | The value of the quantity multiplier, either a currency value such as 0.50 for $0.50 or 0.50 for 50% |
| string | Identifies whether or not the variation is the The possible values are "none," "add," or "no." |
| integer | The sort option for the variant positioning. For example, Small (1), Medium (2), Large (3). |
|
|
variant_list
Field Name | Type | Description |
|---|---|---|
| integer |
|
| [variant ] |
|
variant_type
Describes the variation type of the product.
Field Name | Type | Required | Description |
|---|---|---|---|
| string | Yes |
|
| string | Yes |
|
| string | No | The product variations synchronization method applied at Data Management. The possible values are "sync_all" or "prompt." |
| No |
| |
| No |
| |
| No |
| |
| No |
| |
| No |
| |
| No |
| |
| No |
| |
| No |
| |
| No |
| |
| No |
|
variant_type_create
Describes the variation type of the product.
Field Name | Type | Required | Description |
|---|---|---|---|
| string | Yes |
|
| string | Yes |
|
| string | No | The product variations synchronization method applied at Data Management. The possible values are "sync_all" or "prompt." |
| No |
| |
| No |
|
variant_type_edit
Describes the variation type of the product.
Field Name | Type | Description |
|---|---|---|
| string |
|
| string |
|
| string | The product variations synchronization method applied at Data Management. The possible values are "sync_all" or "prompt." |
|
|
variant_type_list
Field Name | Type | Description |
|---|---|---|
| integer |
|
| [variant_type ] |
|
name
Field Name | Type | Description |
|---|---|---|
| string |
_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 |