Component: INVENTORY_SETTINGS
Abstract
Inventory settings define whether said product is an Inventory Service product and sets its mappings if so.
Values for this component can be set via ExperienceComponentsDto.inventorySettings which is of ExperienceInventorySettingsDto type.
Note (1): a product can’t be Channel manager and combo or box at the same time.
Note (2): improperly mapped Channel manager product can’t be published/activated.
Note (3): make sure a complete list of IDs for every type of mapping (rates, extras, pricing categories) is sent on mapping update as omitted entries will be deleted.
Note(4): if a remote product is already mapped against any Bókun-local product, the system won’t allow mapping it again to another local product without unbinding the remote product first. Either remap remote product to another Bókun-local product first (either via API or UI) or disable IS via API (send enabled=false).
Attributes of ExperienceInventorySettingsDto
Attribute JSON path | Attribute JSON path | Data type | Mandatory | Settable | Notes |
enabled | boolean | ✓ | ✓ | true if this product is Channel manager connected, false otherwise | |
inventoryPluginId | string | Mandatory if enabled == true, otherwise should be omitted | ✓ | Bókun's ID of Channel manager Plugin. ID is assigned at the time of plugin registration (done by Bókun staff).
Note the plugin should also be configured for the calling vendor. It’s not permitted to map the same product more than once | |
remoteProductId | string | Mandatory if enabled == true, otherwise should be omitted | ✓ | ID of the corresponding product, as reported by the plugin (external to Bókun platform). This product is or will be mapped against Bókun-local experience product. It’s not permitted to map the same product more than once | |
rateMappings | Array of ExperienceInventoryRateMappingDto | Mandatory if enabled == true, otherwise should be omitted. At least one rate must be mapped | ✓ | Connects Bókun rate(s) to external rate(s). It’s not permitted to map the same rate more than once | |
platformRate | IdExternalIdDto | Mandatory for every ExperienceInventoryRateMappingDto | ✓ | Bókun-local experience rate ID and/or external rate ID | |
remoteRateId | string | Mandatory for every ExperienceInventoryRateMappingDto | ✓ | Bókun-remote experience rate (rate of product coming from Channel manager plugin) ID | |
pricingCategoryMappings | Array of ExperienceInventoryPricingCategoryMappingDto | Mandatory if enabled == true, otherwise should be omitted. At least one pricing category must be mapped | ✓ | Connects Bókun pricing category(-ies) to external pricing category(-ies) | |
platformPricingCategoryId | long | Mandatory for every ExperienceInventoryPricingCategoryMappingDto | ✓ | Bókun-local pricing category ID | |
remotePricingCategoryId | string | Mandatory for every ExperienceInventoryPricingCategoryMappingDto | ✓ | Bókun-remote pricing category (pricing category of product coming from Channel manager plugin) ID | |
extraMappings | Array of ExperienceInventoryExtraMappingDto | ✓ | Connects Bókun extra(s) to external extra(s) | ||
platformExtra | IdExternalIdDto | Mandatory for every ExperienceInventoryExtraMappingDto | ✓ | Bókun-local extra ID and/or external extra ID | |
remoteExtraId | string | Mandatory for every ExperienceInventoryExtraMappingDto | ✓ | Bókun-remote extra (extra coming from Channel manager plugin) ID |