BokaMera.API.Host

UpdateIncentive

**Requires Authentication**
Requires the role:	superadmin

The following routes are available for this service:
PUT	/superadmin/incentive/{id}	Update incentive

**UpdateIncentive** Parameters:
Name	Parameter	Data Type	Required	Description
Id	path	int	Yes	The id of the incentive.
Heading	body	string	No
StorageUrl	body	string	No
SuccessButtonText	body	string	No
ActionId	body	int?	No
Frequency	body	IncentiveRecurrenceFrequency	No
RecurrenceInterval	body	uint	No
InitialDelayInSeconds	body	int	No
MaxDisplayCount	body	int?	No
ValidFrom	body	DateTimeOffset	No
ValidTo	body	DateTimeOffset	No
CompanyIds	body	List<Guid>	No
Criteria	body	List<IncentiveCriteriaDto>	No
Payload	body	string	No

**IncentiveRecurrenceFrequency** Enum:
Name	Value
OneTime	1
Weekly	2
Monthly	3

**IncentiveCriteriaDto** Parameters:
Name	Parameter	Data Type	Required
CriteriaType	form	CriteriaType	No
Value	form	string	No
InvertCondition	form	bool	No

**CriteriaType** Enum:
LicenseAvailability
SmsActivation
eAccountingActivation
CodeLockActivation
SocialActivation
OnlinePaymentActivation
FollowUpMessageActivation
RatingActivation

**AdminIncentiveQueryResponse** Parameters:
Name	Parameter	Data Type	Required
Frequency	form	IncentiveRecurrenceFrequency	No
RecurrenceInterval	form	uint	No
CreatedDate	form	DateTimeOffset	No
ModifiedDate	form	DateTimeOffset	No
CompanyIds	form	List<Guid>	No
Criteria	form	List<IncentiveCriteria>	No
ApplyToAllCompanies	form	bool	No

**CompanyIncentiveResponse** Parameters:
Name	Parameter	Data Type	Required
Id	form	int	No
Heading	form	string	No
StorageUrl	form	string	No
SuccessButtonText	form	string	No
ActionId	form	int	No
InitialDelayInSeconds	form	int	No
MaxDisplayCount	form	int?	No
ValidFrom	form	DateTimeOffset	No
ValidTo	form	DateTimeOffset	No
Action	form	IncentiveActionResponse	No
Payload	form	string	No

**IncentiveActionResponse** Parameters:
Name	Parameter	Data Type	Required
Id	form	int	No
ActionType	form	IncentiveActionType	No
Page	form	string	No
Segment	form	string	No
Element	form	string	No
LicenseTypeId	form	int?	No
SuggestedLicenseToUpgrade	form	LicenseTypeQueryResponse	No

**IncentiveActionType** Enum:
Name	Value
Upgrade	1
AddOn	2
Information	3

**LicenseTypeQueryResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Id	form	int	No	The license type id
Name	form	string	No	The license type name
Description	form	string	No	The license type description
IsExtraLicenseOption	form	bool	No	If the license type is not a standard license but instead an extra license option. An example would be sending new letter license.
PeriodOfNoticeDays	form	int	No	The period of notice for the license in days.
Items	form	List<LicenseItemsResponse>	No	The license items for the license type
Prices	form	List<LicensePriceResponse>	No	The license prices in each country for the license type

**LicenseItemsResponse** Parameters:
Name	Parameter	Data Type	Required
Id	form	int	No
Name	form	string	No
AllowedItems	form	int	No

**LicensePriceResponse** Parameters:
Name	Parameter	Data Type	Required
LicenseTypeId	form	int	No
CountryId	form	string	No
Price	form	int	No
Country	form	Country	No
LicensePlanId	form	int	No

**Country** Parameters:
Name	Parameter	Data Type	Required
CurrencyId	form	string	No
CurrencyInfo	form	Currency	No
Name	form	string	Yes
Culture	form	string	No
TimeZone	form	string	No
ModifiedDate	form	DateTimeOffset?	No
Id	form	string	Yes

**Currency** Parameters:
Name	Parameter	Data Type	Required
Name	form	string	Yes
CurrencySign	form	string	Yes
Active	form	bool	Yes
ModifiedDate	form	DateTimeOffset?	No
Id	form	string	Yes

**IncentiveCriteria** Parameters:
Name	Parameter	Data Type	Required
Id	form	int	No
IncentiveId	form	int	No
CriteriaType	form	CriteriaType	No
Value	form	string	No
InvertCondition	form	bool	No
CreatedDate	form	DateTimeOffset	No

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

PUT /superadmin/incentive/{id} HTTP/1.1 
Host: testapi.bokamera.se 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<UpdateIncentive xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BokaMera.API.ServiceModel.Dtos">
  <ActionId>0</ActionId>
  <CompanyIds xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:guid>00000000-0000-0000-0000-000000000000</d2p1:guid>
  </CompanyIds>
  <Criteria>
    <IncentiveCriteriaDto>
      <CriteriaType>LicenseAvailability</CriteriaType>
      <InvertCondition>false</InvertCondition>
      <Value>String</Value>
    </IncentiveCriteriaDto>
  </Criteria>
  <Frequency>OneTime</Frequency>
  <Heading>String</Heading>
  <Id>0</Id>
  <InitialDelayInSeconds>0</InitialDelayInSeconds>
  <MaxDisplayCount>0</MaxDisplayCount>
  <Payload>String</Payload>
  <RecurrenceInterval>0</RecurrenceInterval>
  <StorageUrl>String</StorageUrl>
  <SuccessButtonText>String</SuccessButtonText>
  <ValidFrom xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>0001-01-01T00:00:00Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </ValidFrom>
  <ValidTo xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>0001-01-01T00:00:00Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </ValidTo>
</UpdateIncentive>

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<AdminIncentiveQueryResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BokaMera.API.ServiceModel.Dtos">
  <Action>
    <ActionType>Upgrade</ActionType>
    <Element>String</Element>
    <Id>0</Id>
    <LicenseTypeId>0</LicenseTypeId>
    <Page>String</Page>
    <Segment>String</Segment>
    <SuggestedLicenseToUpgrade>
      <Description>String</Description>
      <Id>0</Id>
      <IsExtraLicenseOption>false</IsExtraLicenseOption>
      <Items>
        <LicenseItemsResponse>
          <AllowedItems>0</AllowedItems>
          <Id>0</Id>
          <Name>String</Name>
        </LicenseItemsResponse>
      </Items>
      <Name>String</Name>
      <PeriodOfNoticeDays>0</PeriodOfNoticeDays>
      <Prices>
        <LicensePriceResponse>
          <Country xmlns:d6p1="http://schemas.datacontract.org/2004/07/BokaMera.API.ServiceModel.Db">
            <d6p1:Culture>String</d6p1:Culture>
            <d6p1:CurrencyId>String</d6p1:CurrencyId>
            <d6p1:CurrencyInfo>
              <d6p1:Active>false</d6p1:Active>
              <d6p1:CurrencySign>String</d6p1:CurrencySign>
              <d6p1:Id>String</d6p1:Id>
              <d6p1:ModifiedDate xmlns:d8p1="http://schemas.datacontract.org/2004/07/System">
                <d8p1:DateTime>0001-01-01T00:00:00Z</d8p1:DateTime>
                <d8p1:OffsetMinutes>0</d8p1:OffsetMinutes>
              </d6p1:ModifiedDate>
              <d6p1:Name>String</d6p1:Name>
            </d6p1:CurrencyInfo>
            <d6p1:Id>String</d6p1:Id>
            <d6p1:ModifiedDate xmlns:d7p1="http://schemas.datacontract.org/2004/07/System">
              <d7p1:DateTime>0001-01-01T00:00:00Z</d7p1:DateTime>
              <d7p1:OffsetMinutes>0</d7p1:OffsetMinutes>
            </d6p1:ModifiedDate>
            <d6p1:Name>String</d6p1:Name>
            <d6p1:TimeZone>String</d6p1:TimeZone>
          </Country>
          <CountryId>String</CountryId>
          <LicensePlanId>0</LicensePlanId>
          <LicenseTypeId>0</LicenseTypeId>
          <Price>0</Price>
        </LicensePriceResponse>
      </Prices>
    </SuggestedLicenseToUpgrade>
  </Action>
  <ActionId>0</ActionId>
  <Heading>String</Heading>
  <Id>0</Id>
  <InitialDelayInSeconds>0</InitialDelayInSeconds>
  <MaxDisplayCount>0</MaxDisplayCount>
  <Payload>String</Payload>
  <StorageUrl>String</StorageUrl>
  <SuccessButtonText>String</SuccessButtonText>
  <ValidFrom xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>0001-01-01T00:00:00Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </ValidFrom>
  <ValidTo xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>0001-01-01T00:00:00Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </ValidTo>
  <ApplyToAllCompanies>false</ApplyToAllCompanies>
  <CompanyIds xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:guid>00000000-0000-0000-0000-000000000000</d2p1:guid>
  </CompanyIds>
  <CreatedDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>0001-01-01T00:00:00Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </CreatedDate>
  <Criteria xmlns:d2p1="http://schemas.datacontract.org/2004/07/BokaMera.API.ServiceModel.Db.Incentive">
    <d2p1:IncentiveCriteria>
      <d2p1:CreatedDate xmlns:d4p1="http://schemas.datacontract.org/2004/07/System">
        <d4p1:DateTime>0001-01-01T00:00:00Z</d4p1:DateTime>
        <d4p1:OffsetMinutes>0</d4p1:OffsetMinutes>
      </d2p1:CreatedDate>
      <d2p1:CriteriaType>LicenseAvailability</d2p1:CriteriaType>
      <d2p1:Id>0</d2p1:Id>
      <d2p1:IncentiveId>0</d2p1:IncentiveId>
      <d2p1:InvertCondition>false</d2p1:InvertCondition>
      <d2p1:Value>String</d2p1:Value>
    </d2p1:IncentiveCriteria>
  </Criteria>
  <Frequency>OneTime</Frequency>
  <ModifiedDate xmlns:d2p1="http://schemas.datacontract.org/2004/07/System">
    <d2p1:DateTime>0001-01-01T00:00:00Z</d2p1:DateTime>
    <d2p1:OffsetMinutes>0</d2p1:OffsetMinutes>
  </ModifiedDate>
  <RecurrenceInterval>0</RecurrenceInterval>
</AdminIncentiveQueryResponse>