PUT api/deal/{id}/cost/{guid}
Add or update a deal cost for a deal cost header
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| id |
Deal cost header identifier |
globally unique identifier |
Required |
| guid |
Product identifier |
globally unique identifier |
Required |
Body Parameters
Deal cost to save
DealCost| Name | Description | Type | Additional information |
|---|---|---|---|
| HeaderIdentifier | Collection of byte |
None. |
|
| HeaderIdentifierGuid | globally unique identifier |
None. |
|
| Identifier | Collection of byte |
None. |
|
| IdentifierGuid | globally unique identifier |
None. |
|
| SupplierIdentifier | Collection of byte |
None. |
|
| SupplierGuid | globally unique identifier |
None. |
|
| PLUG_UID | Collection of byte |
None. |
|
| PluGuid |
A Store Product GUID |
globally unique identifier |
None. |
| CampaignName | string |
Deprecated. Please use CampaignPLU.DealCostIdentifier instead. String length: inclusive between 0 and 64 |
|
| Description | string |
None. |
|
| Cost | integer |
None. |
|
| CostDecimals | integer |
None. |
|
| Start | date |
Data type: Date |
|
| End | date |
Data type: Date |
|
| Type | DealCostType |
None. |
|
| PromoType | PromoType |
None. |
|
| BonusItemPLUG_UID | Collection of byte |
None. |
|
| BonusItemPluGuid |
A Store Product GUID |
globally unique identifier |
None. |
| BonusPurchaseUnits | integer |
None. |
|
| BonusReceiveUnits | integer |
None. |
|
| Updated | date |
None. |
|
| MetcashPromotionID | string |
None. |
|
| FromHost |
FromHost identifying the source, see |
integer |
None. |
| StoreNames |
Concatenated list of the stores that the deal cost header is in |
string |
Relation. This field may not always be loaded or used for updates. |
| StoreIDs |
List of store ids of the stores that the deal cost header belongs to |
Collection of integer |
Relation. This field may not always be loaded or used for updates. |
| SupplierName |
Supplier name |
string |
Relation. This field may not always be loaded or used for updates. |
| CampaignDescription |
Campaign description of campaign using this deal cost |
string |
Relation. This field may not always be loaded or used for updates. |
| NewPrice |
New sell price of campaign using this deal cost |
integer |
Relation. This field may not always be loaded or used for updates. |
| CampaignMetcashPromotionID |
Metcash promotion id of campaign using this deal cost |
string |
Relation. This field may not always be loaded or used for updates. |
| CampaignActive |
Active status of campaign using this deal cost |
boolean |
Relation. This field may not always be loaded or used for updates. |
| CampaignStartDate |
Start date of campaign using this deal cost |
date |
Relation. This field may not always be loaded or used for updates. |
| CampaignEndDate |
End date of campaign using this deal cost |
date |
Relation. This field may not always be loaded or used for updates. |
| MasterPLUG_UID |
Master plu guid for the deal cost store product |
Collection of byte |
Relation. This field may not always be loaded or used for updates. |
| MasterID |
Master guid for the deal cost store product |
globally unique identifier |
Relation. This field may not always be loaded or used for updates. |
| ProductName |
Product description |
string |
Relation. This field may not always be loaded or used for updates. |
| ProductAPN |
Product barcode |
string |
Relation. This field may not always be loaded or used for updates. |
| OrderCode |
Order code of product for this supplier deal cost |
string |
Relation. This field may not always be loaded or used for updates. |
| NormalSell |
Normal product sell |
integer |
Relation. This field may not always be loaded or used for updates. |
| NormalCost |
Normal product cost |
integer |
Relation. This field may not always be loaded or used for updates. |
| NormalCostDecimals |
Normal product cost decimals |
integer |
Relation. This field may not always be loaded or used for updates. |
| CartonQuantity | integer |
Relation. This field may not always be loaded or used for updates. |
|
| SalesMode | integer |
Relation. This field may not always be loaded or used for updates. |
|
| OrderPacked | integer |
Relation. This field may not always be loaded or used for updates. |
|
| FuelItem | boolean |
Relation. This field may not always be loaded or used for updates. |
|
| Active | boolean |
Relation. This field may not always be loaded or used for updates. |
|
| BonusMasterPLUG_UID |
Master plu guid for the deal cost store bonus product |
Collection of byte |
Relation. This field may not always be loaded or used for updates. |
| BonusMasterID |
Master guid for the deal cost store bonus product |
globally unique identifier |
Relation. This field may not always be loaded or used for updates. |
| BonusProductName |
Bonus product description |
string |
Relation. This field may not always be loaded or used for updates. |
| BonusProductAPN |
Bonus product barcode |
string |
Relation. This field may not always be loaded or used for updates. |
| BonusOrderCode |
Order code of bonus product for this supplier deal cost |
string |
Relation. This field may not always be loaded or used for updates. |
| BonusNormalSell |
Normal bonus product sell |
integer |
Relation. This field may not always be loaded or used for updates. |
| BonusNormalCost |
Normal bonus product cost |
integer |
Relation. This field may not always be loaded or used for updates. |
| BonusNormalCostDecimals |
Normal bonus product cost decimals |
integer |
Relation. This field may not always be loaded or used for updates. |
| BonusCartonQuantity | integer |
Relation. This field may not always be loaded or used for updates. |
|
| BonusSalesMode | integer |
Relation. This field may not always be loaded or used for updates. |
|
| BonusOrderPacked | integer |
Relation. This field may not always be loaded or used for updates. |
|
| BonusFuelItem | boolean |
Relation. This field may not always be loaded or used for updates. |
|
| BonusActive | boolean |
Relation. This field may not always be loaded or used for updates. |
Request Formats
application/json, text/json
{
"headerIdentifier": "Mqn8i1xtcUCaeOqjpnsGjg==",
"headerIdentifierGuid": "8bfca932-6d5c-4071-9a78-eaa3a67b068e",
"identifier": "Kz7Oh47l8EO9JxnGxSRCjg==",
"identifierGuid": "87ce3e2b-e58e-43f0-bd27-19c6c524428e",
"supplierIdentifier": "JdU0GUPBj0WmjVCPGLPzcg==",
"supplierGuid": "1934d525-c143-458f-a68d-508f18b3f372",
"pluG_UID": "9hn2L+4KJUKuJYsXwD/ttA==",
"pluGuid": "2ff619f6-0aee-4225-ae25-8b17c03fedb4",
"campaignName": "08d49128-753d-49f5-8cc6-290b8ad50566",
"description": "sample string 4",
"cost": 5,
"costDecimals": 6,
"start": "2026-04-03T06:21:17.3009526",
"end": "2026-04-03T06:21:17.3009526",
"type": 9,
"promoType": 10,
"bonusItemPLUG_UID": "NXNnG3q/akeyw1dj/3h34Q==",
"bonusItemPluGuid": "1b677335-bf7a-476a-b2c3-5763ff7877e1",
"bonusPurchaseUnits": 11,
"bonusReceiveUnits": 12,
"updated": "2026-04-03T06:21:17.3009526",
"metcashPromotionID": "sample string 14",
"fromHost": 15,
"storeNames": "sample string 16",
"storeIDs": [
1,
2
],
"supplierName": "sample string 17",
"campaignDescription": "sample string 18",
"newPrice": 1,
"campaignMetcashPromotionID": "sample string 19",
"campaignActive": true,
"campaignStartDate": "2026-04-03T06:21:17.3009526",
"campaignEndDate": "2026-04-03T06:21:17.3009526",
"masterPLUG_UID": "++151D5ktECjUsfphhMoXw==",
"masterID": "d479edfb-643e-40b4-a352-c7e98613285f",
"productName": "sample string 22",
"productAPN": "sample string 23",
"orderCode": "sample string 24",
"normalSell": 25,
"normalCost": 26,
"normalCostDecimals": 27,
"cartonQuantity": 28,
"salesMode": 29,
"orderPacked": 30,
"fuelItem": true,
"active": true,
"bonusMasterPLUG_UID": "vQ5PRCS2Yk+Sqs1MwDwZ0A==",
"bonusMasterID": "444f0ebd-b624-4f62-92aa-cd4cc03c19d0",
"bonusProductName": "sample string 34",
"bonusProductAPN": "sample string 35",
"bonusOrderCode": "sample string 36",
"bonusNormalSell": 37,
"bonusNormalCost": 38,
"bonusNormalCostDecimals": 39,
"bonusCartonQuantity": 40,
"bonusSalesMode": 41,
"bonusOrderPacked": 42,
"bonusFuelItem": true,
"bonusActive": true
}
application/xml, text/xml
<DealCost xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://gapsolutions.com.au/schema/ezimanager">
<Active>true</Active>
<BonusActive>true</BonusActive>
<BonusCartonQuantity>40</BonusCartonQuantity>
<BonusFuelItem>true</BonusFuelItem>
<BonusItemPLUG_UID>NXNnG3q/akeyw1dj/3h34Q==</BonusItemPLUG_UID>
<BonusItemPluGuid>1b677335-bf7a-476a-b2c3-5763ff7877e1</BonusItemPluGuid>
<BonusMasterID>444f0ebd-b624-4f62-92aa-cd4cc03c19d0</BonusMasterID>
<BonusMasterPLUG_UID>vQ5PRCS2Yk+Sqs1MwDwZ0A==</BonusMasterPLUG_UID>
<BonusNormalCost>38</BonusNormalCost>
<BonusNormalCostDecimals>39</BonusNormalCostDecimals>
<BonusNormalSell>37</BonusNormalSell>
<BonusOrderCode>sample string 36</BonusOrderCode>
<BonusOrderPacked>42</BonusOrderPacked>
<BonusProductAPN>sample string 35</BonusProductAPN>
<BonusProductName>sample string 34</BonusProductName>
<BonusPurchaseUnits>11</BonusPurchaseUnits>
<BonusReceiveUnits>12</BonusReceiveUnits>
<BonusSalesMode>41</BonusSalesMode>
<CampaignActive>true</CampaignActive>
<CampaignDescription>sample string 18</CampaignDescription>
<CampaignEndDate>2026-04-03T06:21:17.3009526+00:00</CampaignEndDate>
<CampaignMetcashPromotionID>sample string 19</CampaignMetcashPromotionID>
<CampaignName>08d49128-753d-49f5-8cc6-290b8ad50566</CampaignName>
<CampaignStartDate>2026-04-03T06:21:17.3009526+00:00</CampaignStartDate>
<CartonQuantity>28</CartonQuantity>
<Cost>5</Cost>
<CostDecimals>6</CostDecimals>
<Description>sample string 4</Description>
<End>2026-04-03T06:21:17.3009526+00:00</End>
<FromHost>15</FromHost>
<FuelItem>true</FuelItem>
<HeaderIdentifier>Mqn8i1xtcUCaeOqjpnsGjg==</HeaderIdentifier>
<HeaderIdentifierGuid>8bfca932-6d5c-4071-9a78-eaa3a67b068e</HeaderIdentifierGuid>
<Identifier>Kz7Oh47l8EO9JxnGxSRCjg==</Identifier>
<IdentifierGuid>87ce3e2b-e58e-43f0-bd27-19c6c524428e</IdentifierGuid>
<MasterID>d479edfb-643e-40b4-a352-c7e98613285f</MasterID>
<MasterPLUG_UID>++151D5ktECjUsfphhMoXw==</MasterPLUG_UID>
<MetcashPromotionID>sample string 14</MetcashPromotionID>
<NewPrice>1</NewPrice>
<NormalCost>26</NormalCost>
<NormalCostDecimals>27</NormalCostDecimals>
<NormalSell>25</NormalSell>
<OrderCode>sample string 24</OrderCode>
<OrderPacked>30</OrderPacked>
<PLUG_UID>9hn2L+4KJUKuJYsXwD/ttA==</PLUG_UID>
<PluGuid>2ff619f6-0aee-4225-ae25-8b17c03fedb4</PluGuid>
<ProductAPN>sample string 23</ProductAPN>
<ProductName>sample string 22</ProductName>
<PromoType>10</PromoType>
<SalesMode>29</SalesMode>
<Start>2026-04-03T06:21:17.3009526+00:00</Start>
<StoreIDs xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d2p1:int>1</d2p1:int>
<d2p1:int>2</d2p1:int>
</StoreIDs>
<StoreNames>sample string 16</StoreNames>
<SupplierGuid>1934d525-c143-458f-a68d-508f18b3f372</SupplierGuid>
<SupplierIdentifier>JdU0GUPBj0WmjVCPGLPzcg==</SupplierIdentifier>
<SupplierName>sample string 17</SupplierName>
<Type>9</Type>
<Updated>2026-04-03T06:21:17.3009526+00:00</Updated>
</DealCost>
application/x-www-form-urlencoded
Sample not available.
Response Information
Resource Description
None.