BokaMera.API.Host

<back to all web services

UpdateCompany

Requires Authentication
Requires any of the roles:bookingsupplier-administrator-write, superadmin
The following routes are available for this service:
PUT/companies/{CompanyId}Update existing companyUpdates your company profile information.
"use strict";
/** @typedef {'Sample'|'RcoM5'|'AxemaVaka'|'VanderbiltOmnis'|'ParakeyParakey'|'AmidoDax'|'TelkeyTelkey'|'TechSolutionsSiedle'|'Accessy'|'Zesec'|'Enabla'} */
export var CodeLockSystemType;
(function (CodeLockSystemType) {
    CodeLockSystemType["Sample"] = "Sample"
    CodeLockSystemType["RcoM5"] = "RcoM5"
    CodeLockSystemType["AxemaVaka"] = "AxemaVaka"
    CodeLockSystemType["VanderbiltOmnis"] = "VanderbiltOmnis"
    CodeLockSystemType["ParakeyParakey"] = "ParakeyParakey"
    CodeLockSystemType["AmidoDax"] = "AmidoDax"
    CodeLockSystemType["TelkeyTelkey"] = "TelkeyTelkey"
    CodeLockSystemType["TechSolutionsSiedle"] = "TechSolutionsSiedle"
    CodeLockSystemType["Accessy"] = "Accessy"
    CodeLockSystemType["Zesec"] = "Zesec"
    CodeLockSystemType["Enabla"] = "Enabla"
})(CodeLockSystemType || (CodeLockSystemType = {}));
export class CompanyBookingSettings {
    /** @param {{EnableMobileApp?:boolean,BookingReceiptMessage?:string,ShowFreeTimesLeft?:boolean,EnableShowBookedTimes?:boolean,BookingAgreement?:string,WeekNumberSetting?:number,ShowBookedTimes?:boolean,PaymentProviderId?:number,BookOnlyOnExistingCustomers?:boolean,PaymentEnabled?:boolean}} [init] */
    constructor(init) { Object.assign(this, init) }
    /** @type {boolean} */
    EnableMobileApp;
    /** @type {string} */
    BookingReceiptMessage;
    /** @type {boolean} */
    ShowFreeTimesLeft;
    /** @type {boolean} */
    EnableShowBookedTimes;
    /** @type {string} */
    BookingAgreement;
    /**
     * @type {number}
     * @description The settings for how to display week number. 1 = ShowWeekNumberFromDate, 2 = ShowWeekNumberToDate, 3 = ShowWeekNumberFromToDate, 4 = DontShowWeekNumber   */
    WeekNumberSetting;
    /** @type {boolean} */
    ShowBookedTimes;
    /**
     * @type {number}
     * @description The payment provider id. 1 = Payson Checkout 1.0, 2= Payson Checkout 2.0 ... To get the full payment provider for the company call GET /payment/settings */
    PaymentProviderId;
    /**
     * @type {boolean}
     * @description If it's only allowed for existing customers to book */
    BookOnlyOnExistingCustomers;
    /**
     * @type {boolean}
     * @description If payment is enabled */
    PaymentEnabled;
}
export class CompanySystemSettings {
    /** @param {{Active?:boolean,InactiveMessage?:string,Searchable?:boolean,GATrackingId?:string,GoogleAdsConversionId?:string,LinkedinTagId?:string,GoogleAdsConversionLabel?:string,GTMTrackingId?:string,FacebookPixelId?:string,MultiLanguage?:boolean,ShowOnMarketplace?:boolean,EnableAPITranslation?:boolean,DefaultLanguage?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {boolean}
     * @description If the booking is active or not */
    Active;
    /**
     * @type {string}
     * @description If the booking is not active, what message to show to the customers */
    InactiveMessage;
    /**
     * @type {boolean}
     * @description If the company should be visible in search results on hompage */
    Searchable;
    /**
     * @type {string}
     * @description If you have a google analytics account and want to track your customers behaviors. */
    GATrackingId;
    /**
     * @type {string}
     * @description If you have a google Ads Conversion Id account and want to track your customers behaviors. */
    GoogleAdsConversionId;
    /**
     * @type {string}
     * @description If you have a LinkedIn account and want to track your customers behaviors. */
    LinkedinTagId;
    /**
     * @type {string}
     * @description If you have a Google Ads Conversion Label and want to track your customers behaviors. */
    GoogleAdsConversionLabel;
    /**
     * @type {string}
     * @description If you have a google tag manager account and want to track your customers behaviors. */
    GTMTrackingId;
    /**
     * @type {string}
     * @description If you have a facebook account and want to track your customers behaviors. */
    FacebookPixelId;
    /**
     * @type {boolean}
     * @description If you want your customers to be albe to change language on your homepage */
    MultiLanguage;
    /**
     * @type {boolean}
     * @description If the company should be visible on the marketplace */
    ShowOnMarketplace;
    /**
     * @type {boolean}
     * @description If you want your own written text on your homepage to be translated using google analytics when a user changes language */
    EnableAPITranslation;
    /**
     * @type {string}
     * @description What is the standard language your homepage information is written in. Select from the different countries, ie. SE,NO,EN */
    DefaultLanguage;
}
export class CompanyWidgetSettings {
    /** @param {{ServiceLayoutId?:number,TimeLayoutId?:number,BookingLayoutId?:number,PrimaryColor?:string,ShowServiceImage?:boolean,ShowRebateCodeField?:boolean,ShowNextAvailableTime?:boolean,ShowEndTime?:boolean,BookedTimeSlotText?:string,DarkTheme?:boolean}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {number}
     * @description The service layouts id. */
    ServiceLayoutId;
    /**
     * @type {number}
     * @description The time layouts id. */
    TimeLayoutId;
    /**
     * @type {number}
     * @description The booking layouts id. */
    BookingLayoutId;
    /**
     * @type {string}
     * @description The primary color of the booking widget. */
    PrimaryColor;
    /**
     * @type {boolean}
     * @description If you should show the service image in the booking widget. */
    ShowServiceImage;
    /**
     * @type {boolean}
     * @description If you should show the rebate code field in the booking widget. */
    ShowRebateCodeField;
    /**
     * @type {boolean}
     * @description If you should show the next available time in the booking widget. */
    ShowNextAvailableTime;
    /**
     * @type {boolean}
     * @description If you should show the end time in the booking widget. */
    ShowEndTime;
    /**
     * @type {string}
     * @description What text to show on booked time slots. Default text is Booked */
    BookedTimeSlotText;
    /**
     * @type {boolean}
     * @description If the widget should be displayed in dark theme */
    DarkTheme;
}
export class HomepageSettingsResponse {
    /** @param {{HomepageHeading?:string,WelcomePageHeading?:string,WelcomePageBody?:string,AboutUsPageHeading?:string,AboutUsPageBody?:string,ImageUrl?:string,CoverImage?:string,ShowRating?:boolean,HomePageTemplateId?:number,HeroSectionStyleId?:number,EnableHomepage?:boolean}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {string}
     * @description The text for homepage heading */
    HomepageHeading;
    /**
     * @type {string}
     * @description The text for homepage startpage heading */
    WelcomePageHeading;
    /**
     * @type {string}
     * @description The text for homepage startpage body */
    WelcomePageBody;
    /**
     * @type {string}
     * @description The text for homepage about us page heading */
    AboutUsPageHeading;
    /**
     * @type {string}
     * @description The text for homepage about us page body */
    AboutUsPageBody;
    /**
     * @type {string}
     * @description The startpage image url */
    ImageUrl;
    /**
     * @type {string}
     * @description The cover image url */
    CoverImage;
    /**
     * @type {boolean}
     * @description Show rating on the page */
    ShowRating;
    /**
     * @type {number}
     * @description The template for the homepage */
    HomePageTemplateId;
    /**
     * @type {number}
     * @description The hero section style for the homepage */
    HeroSectionStyleId;
    /**
     * @type {boolean}
     * @description Enable the BokaMera Homepage */
    EnableHomepage;
}
export class CompanyRatingSummary {
    /** @param {{AverageScore?:number,RatingScore1Count?:number,RatingScore2Count?:number,RatingScore3Count?:number,RaingScore4Count?:number,RatingScore5Count?:number,Count?:number}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {number}
     * @description The average rating score */
    AverageScore;
    /**
     * @type {number}
     * @description The number of ratings of score 1 */
    RatingScore1Count;
    /**
     * @type {number}
     * @description The number of ratings of score 2 */
    RatingScore2Count;
    /**
     * @type {number}
     * @description The number of ratings of score 3 */
    RatingScore3Count;
    /**
     * @type {number}
     * @description The number of ratings of score 4 */
    RaingScore4Count;
    /**
     * @type {number}
     * @description The number of ratings of score 5 */
    RatingScore5Count;
    /**
     * @type {number}
     * @description The number of ratings */
    Count;
}
export class RatingReviewResponse {
    /** @param {{Title?:string,Description?:string,RatingScore?:number,Author?:string,Created?:string,ReviewAnswer?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {string}
     * @description The title for the review */
    Title;
    /**
     * @type {string}
     * @description The description for the review */
    Description;
    /**
     * @type {number}
     * @description The rating score */
    RatingScore;
    /**
     * @type {string}
     * @description The review author */
    Author;
    /**
     * @type {string}
     * @description The created date */
    Created;
    /**
     * @type {string}
     * @description The review answer from the company */
    ReviewAnswer;
}
export class CustomFieldValueResponse {
    /** @param {{Value?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /** @type {string} */
    Value;
}
export class CustomFieldConfigData {
    /** @param {{Id?:number,Name?:string,Description?:string,Width?:number,DataType?:string,DefaultValue?:string,IsMandatory?:boolean,MandatoryErrorMessage?:string,MaxLength?:number,MultipleLineText?:boolean,RegEx?:string,RegExErrorMessage?:string,Values?:CustomFieldValueResponse[]}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {number}
     * @description Custom field id */
    Id;
    /**
     * @type {string}
     * @description Configuration name. Example: 'Number of persons'. */
    Name;
    /**
     * @type {string}
     * @description Custom field description. Example: 'For how many persons is this booking?' */
    Description;
    /**
     * @type {?number}
     * @description Field width. Example: 20 for 20px */
    Width;
    /**
     * @type {string}
     * @description Data field of custom field. Valid values are: TextBox, ... Example: 'TextBox' */
    DataType;
    /**
     * @type {string}
     * @description Default value of the field. Example: '3' */
    DefaultValue;
    /**
     * @type {boolean}
     * @description Determines if the field is required to have a value or not */
    IsMandatory;
    /**
     * @type {string}
     * @description Error message shown to the user if the field data is required but not entered */
    MandatoryErrorMessage;
    /**
     * @type {number}
     * @description Max lenght of the field */
    MaxLength;
    /**
     * @type {boolean}
     * @description If the field should have multiple lines */
    MultipleLineText;
    /**
     * @type {string}
     * @description Regular expression used for validation of the field */
    RegEx;
    /**
     * @type {string}
     * @description Error message shown if the regular expression validation failed */
    RegExErrorMessage;
    /**
     * @type {CustomFieldValueResponse[]}
     * @description The values to select from if Datatype is DropDown for this custom field */
    Values;
}
export class CompanyQueryResponse {
    /** @param {{Id?:string,Name?:string,OrganisationNumber?:string,TypeId?:number,Details?:string,CategoryId?:number,Category?:string,LogoType?:string,CoverImage?:string,Street1?:string,Street2?:string,ZipCode?:string,City?:string,CountryId?:string,Longitude?:string,Latitude?:string,Distance?:number,Phone?:string,Email?:string,Homepage?:string,SitePath?:string,Active?:boolean,CodeLockSystem?:CodeLockSystemType,IsFreeAccount?:boolean,Updated?:string,Created?:string,StatusId?:number,IsFavorite?:boolean,BookingAgreements?:string,BookingSettings?:CompanyBookingSettings,SystemSettings?:CompanySystemSettings,WidgetSettings?:CompanyWidgetSettings,HomepageSettings?:HomepageSettingsResponse,RatingSummary?:CompanyRatingSummary,Reviews?:RatingReviewResponse[],CustomerCustomFields?:CustomFieldConfigData[],ResponseStatus?:ResponseStatus}} [init] */
    constructor(init) { Object.assign(this, init) }
    /** @type {string} */
    Id;
    /** @type {string} */
    Name;
    /**
     * @type {string}
     * @description The organisation number will only be visible if your owner to the company */
    OrganisationNumber;
    /**
     * @type {?number}
     * @description What type of company. If it's used for personal use or as a company. */
    TypeId;
    /** @type {string} */
    Details;
    /** @type {number} */
    CategoryId;
    /** @type {string} */
    Category;
    /** @type {string} */
    LogoType;
    /** @type {string} */
    CoverImage;
    /** @type {string} */
    Street1;
    /** @type {string} */
    Street2;
    /** @type {string} */
    ZipCode;
    /** @type {string} */
    City;
    /** @type {string} */
    CountryId;
    /** @type {string} */
    Longitude;
    /** @type {string} */
    Latitude;
    /** @type {?number} */
    Distance;
    /** @type {string} */
    Phone;
    /** @type {string} */
    Email;
    /** @type {string} */
    Homepage;
    /** @type {string} */
    SitePath;
    /** @type {boolean} */
    Active;
    /** @type {?CodeLockSystemType} */
    CodeLockSystem;
    /** @type {boolean} */
    IsFreeAccount;
    /**
     * @type {?string}
     * @description Will show when the company was updated, note it will only be shown if your logged in as admin for the company. */
    Updated;
    /**
     * @type {?string}
     * @description Will show when the company was created, note it will only be shown if your logged in as admin for the company. */
    Created;
    /** @type {number} */
    StatusId;
    /**
     * @type {boolean}
     * @description If the company is marked as favourite for the logged in user */
    IsFavorite;
    /** @type {string} */
    BookingAgreements;
    /** @type {CompanyBookingSettings} */
    BookingSettings;
    /** @type {CompanySystemSettings} */
    SystemSettings;
    /** @type {CompanyWidgetSettings} */
    WidgetSettings;
    /** @type {HomepageSettingsResponse} */
    HomepageSettings;
    /** @type {CompanyRatingSummary} */
    RatingSummary;
    /** @type {RatingReviewResponse[]} */
    Reviews;
    /** @type {CustomFieldConfigData[]} */
    CustomerCustomFields;
    /** @type {ResponseStatus} */
    ResponseStatus;
}
export class UpdateCompany {
    /** @param {{CompanyId?:string,Name?:string,OrganisationNumber?:string,TypeId?:number,OpeningHours?:string,Details?:string,CategoryId?:number,LogoType?:string,Street1?:string,Street2?:string,ZipCode?:string,City?:string,CountryId?:string,Longitude?:string,Latitude?:string,Phone?:string,Email?:string,Fax?:string,Homepage?:string,SitePath?:string}} [init] */
    constructor(init) { Object.assign(this, init) }
    /**
     * @type {string}
     * @description The company id, if empty will use the company id for the user you are logged in with. */
    CompanyId;
    /** @type {string} */
    Name;
    /** @type {string} */
    OrganisationNumber;
    /**
     * @type {?number}
     * @description What type of company. If it's used for personal use or as a company. 1 = Company use, 2 = Personal use */
    TypeId;
    /** @type {string} */
    OpeningHours;
    /** @type {string} */
    Details;
    /** @type {?number} */
    CategoryId;
    /** @type {string} */
    LogoType;
    /** @type {string} */
    Street1;
    /** @type {string} */
    Street2;
    /** @type {string} */
    ZipCode;
    /** @type {string} */
    City;
    /** @type {string} */
    CountryId;
    /** @type {string} */
    Longitude;
    /** @type {string} */
    Latitude;
    /** @type {string} */
    Phone;
    /** @type {string} */
    Email;
    /** @type {string} */
    Fax;
    /** @type {string} */
    Homepage;
    /** @type {string} */
    SitePath;
}

JavaScript UpdateCompany DTOs

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 /companies/{CompanyId} HTTP/1.1 
Host: testapi.bokamera.se 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<UpdateCompany xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BokaMera.API.ServiceModel.Dtos">
  <CategoryId>0</CategoryId>
  <City>String</City>
  <CompanyId>00000000-0000-0000-0000-000000000000</CompanyId>
  <CountryId>String</CountryId>
  <Details>String</Details>
  <Email>String</Email>
  <Fax>String</Fax>
  <Homepage>String</Homepage>
  <Latitude>String</Latitude>
  <LogoType i:nil="true" />
  <Longitude>String</Longitude>
  <Name>String</Name>
  <OpeningHours>String</OpeningHours>
  <OrganisationNumber>String</OrganisationNumber>
  <Phone>String</Phone>
  <SitePath>String</SitePath>
  <Street1>String</Street1>
  <Street2>String</Street2>
  <TypeId>0</TypeId>
  <ZipCode>String</ZipCode>
</UpdateCompany>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<CompanyQueryResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BokaMera.API.ServiceModel.Dtos">
  <Active>false</Active>
  <BookingAgreements>String</BookingAgreements>
  <BookingSettings>
    <BookOnlyOnExistingCustomers>false</BookOnlyOnExistingCustomers>
    <BookingAgreement>String</BookingAgreement>
    <BookingReceiptMessage>String</BookingReceiptMessage>
    <EnableMobileApp>false</EnableMobileApp>
    <EnableShowBookedTimes>false</EnableShowBookedTimes>
    <PaymentEnabled>false</PaymentEnabled>
    <PaymentProviderId>0</PaymentProviderId>
    <ShowBookedTimes>false</ShowBookedTimes>
    <ShowFreeTimesLeft>false</ShowFreeTimesLeft>
    <WeekNumberSetting>0</WeekNumberSetting>
  </BookingSettings>
  <Category>String</Category>
  <CategoryId>0</CategoryId>
  <City>String</City>
  <CodeLockSystem>Sample</CodeLockSystem>
  <CountryId>String</CountryId>
  <CoverImage i:nil="true" />
  <Created>0001-01-01T00:00:00</Created>
  <CustomerCustomFields>
    <CustomFieldConfigData>
      <DataType>String</DataType>
      <DefaultValue>String</DefaultValue>
      <Description>String</Description>
      <Id>0</Id>
      <IsMandatory>false</IsMandatory>
      <MandatoryErrorMessage>String</MandatoryErrorMessage>
      <MaxLength>0</MaxLength>
      <MultipleLineText>false</MultipleLineText>
      <Name>String</Name>
      <RegEx>String</RegEx>
      <RegExErrorMessage>String</RegExErrorMessage>
      <Values>
        <CustomFieldValueResponse>
          <Value>String</Value>
        </CustomFieldValueResponse>
      </Values>
      <Width>0</Width>
    </CustomFieldConfigData>
  </CustomerCustomFields>
  <Details>String</Details>
  <Distance>0</Distance>
  <Email>String</Email>
  <Homepage>String</Homepage>
  <HomepageSettings>
    <AboutUsPageBody>String</AboutUsPageBody>
    <AboutUsPageHeading>String</AboutUsPageHeading>
    <CoverImage i:nil="true" />
    <EnableHomepage>false</EnableHomepage>
    <HeroSectionStyleId>0</HeroSectionStyleId>
    <HomePageTemplateId>0</HomePageTemplateId>
    <HomepageHeading>String</HomepageHeading>
    <ImageUrl i:nil="true" />
    <ShowRating>false</ShowRating>
    <WelcomePageBody>String</WelcomePageBody>
    <WelcomePageHeading>String</WelcomePageHeading>
  </HomepageSettings>
  <Id>00000000-0000-0000-0000-000000000000</Id>
  <IsFavorite>false</IsFavorite>
  <IsFreeAccount>false</IsFreeAccount>
  <Latitude>String</Latitude>
  <LogoType i:nil="true" />
  <Longitude>String</Longitude>
  <Name>String</Name>
  <OrganisationNumber>String</OrganisationNumber>
  <Phone>String</Phone>
  <RatingSummary>
    <AverageScore>0</AverageScore>
    <Count>0</Count>
    <RaingScore4Count>0</RaingScore4Count>
    <RatingScore1Count>0</RatingScore1Count>
    <RatingScore2Count>0</RatingScore2Count>
    <RatingScore3Count>0</RatingScore3Count>
    <RatingScore5Count>0</RatingScore5Count>
  </RatingSummary>
  <ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types">
    <d2p1:ErrorCode>String</d2p1:ErrorCode>
    <d2p1:Message>String</d2p1:Message>
    <d2p1:StackTrace>String</d2p1:StackTrace>
    <d2p1:Errors>
      <d2p1:ResponseError>
        <d2p1:ErrorCode>String</d2p1:ErrorCode>
        <d2p1:FieldName>String</d2p1:FieldName>
        <d2p1:Message>String</d2p1:Message>
        <d2p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:KeyValueOfstringstring>
            <d5p1:Key>String</d5p1:Key>
            <d5p1:Value>String</d5p1:Value>
          </d5p1:KeyValueOfstringstring>
        </d2p1:Meta>
      </d2p1:ResponseError>
    </d2p1:Errors>
    <d2p1:Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:KeyValueOfstringstring>
        <d3p1:Key>String</d3p1:Key>
        <d3p1:Value>String</d3p1:Value>
      </d3p1:KeyValueOfstringstring>
    </d2p1:Meta>
  </ResponseStatus>
  <Reviews>
    <RatingReviewResponse>
      <Author>String</Author>
      <Created>0001-01-01T00:00:00</Created>
      <Description>String</Description>
      <RatingScore>0</RatingScore>
      <ReviewAnswer>String</ReviewAnswer>
      <Title>String</Title>
    </RatingReviewResponse>
  </Reviews>
  <SitePath>String</SitePath>
  <StatusId>0</StatusId>
  <Street1>String</Street1>
  <Street2>String</Street2>
  <SystemSettings>
    <Active>false</Active>
    <DefaultLanguage>String</DefaultLanguage>
    <EnableAPITranslation>false</EnableAPITranslation>
    <FacebookPixelId>String</FacebookPixelId>
    <GATrackingId>String</GATrackingId>
    <GTMTrackingId>String</GTMTrackingId>
    <GoogleAdsConversionId>String</GoogleAdsConversionId>
    <GoogleAdsConversionLabel>String</GoogleAdsConversionLabel>
    <InactiveMessage>String</InactiveMessage>
    <LinkedinTagId>String</LinkedinTagId>
    <MultiLanguage>false</MultiLanguage>
    <Searchable>false</Searchable>
    <ShowOnMarketplace>false</ShowOnMarketplace>
  </SystemSettings>
  <TypeId>0</TypeId>
  <Updated>0001-01-01T00:00:00</Updated>
  <WidgetSettings>
    <BookedTimeSlotText>String</BookedTimeSlotText>
    <BookingLayoutId>0</BookingLayoutId>
    <DarkTheme>false</DarkTheme>
    <PrimaryColor>String</PrimaryColor>
    <ServiceLayoutId>0</ServiceLayoutId>
    <ShowEndTime>false</ShowEndTime>
    <ShowNextAvailableTime>false</ShowNextAvailableTime>
    <ShowRebateCodeField>false</ShowRebateCodeField>
    <ShowServiceImage>false</ShowServiceImage>
    <TimeLayoutId>0</TimeLayoutId>
  </WidgetSettings>
  <ZipCode>String</ZipCode>
</CompanyQueryResponse>