Requires any of the roles: | bookingsupplier-administrator-write, superadmin |
PUT | /companies/{CompanyId} | Update existing company | Updates your company profile information. |
---|
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
CompanyId | path | Guid? | Yes | The company id, if empty will use the company id for the user you are logged in with. |
Name | body | string | No | |
OrganisationNumber | body | string | No | |
TypeId | body | int | No | What type of company. If it's used for personal use or as a company. 1 = Company use, 2 = Personal use |
OpeningHours | body | string | No | |
Details | body | string | No | |
CategoryId | body | int? | No | |
LogoType | body | Uri | No | |
Street1 | body | string | No | |
Street2 | body | string | No | |
ZipCode | body | string | No | |
City | body | string | No | |
CountryId | body | string | No | |
Longitude | body | string | No | |
Latitude | body | string | No | |
Phone | body | string | No | |
body | string | No | ||
Fax | body | string | No | |
Homepage | body | string | No | |
SitePath | body | string | No |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Id | form | Guid | No | |
Name | form | string | No | |
OrganisationNumber | form | string | No | The organisation number will only be visible if your owner to the company |
TypeId | form | int | No | What type of company. If it's used for personal use or as a company. |
Details | form | string | No | |
CategoryId | form | int | No | |
Category | form | string | No | |
LogoType | form | Uri | No | |
CoverImage | form | Uri | No | |
Street1 | form | string | No | |
Street2 | form | string | No | |
ZipCode | form | string | No | |
City | form | string | No | |
CountryId | form | string | No | |
Longitude | form | string | No | |
Latitude | form | string | No | |
Distance | form | double? | No | |
Phone | form | string | No | |
form | string | No | ||
Homepage | form | string | No | |
SitePath | form | string | No | |
Active | form | bool | No | |
CodeLockSystem | form | CodeLockSystemType? | No | |
IsFreeAccount | form | bool | No | |
Updated | form | datetime | No | Will show when the company was updated, note it will only be shown if your logged in as admin for the company. |
Created | form | datetime | No | Will show when the company was created, note it will only be shown if your logged in as admin for the company. |
StatusId | form | int | No | |
IsFavorite | form | boolean | No | If the company is marked as favourite for the logged in user |
BookingAgreements | form | string | No | |
BookingSettings | form | CompanyBookingSettings | No | |
SystemSettings | form | CompanySystemSettings | No | |
WidgetSettings | form | CompanyWidgetSettings | No | |
HomepageSettings | form | HomepageSettingsResponse | No | |
RatingSummary | form | CompanyRatingSummary | No | |
Reviews | form | List<RatingReviewResponse> | No | |
CustomerCustomFields | form | List<CustomFieldConfigData> | No | |
ResponseStatus | form | ResponseStatus | No |
Sample | |
RcoM5 | |
AxemaVaka | |
VanderbiltOmnis | |
ParakeyParakey | |
AmidoDax | |
TelkeyTelkey | |
TechSolutionsSiedle | |
Accessy | |
Zesec | |
Enabla |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
EnableMobileApp | form | bool | No | |
BookingReceiptMessage | form | string | No | |
ShowFreeTimesLeft | form | bool | No | |
EnableShowBookedTimes | form | bool | No | |
BookingAgreement | form | string | No | |
WeekNumberSetting | form | int | No | The settings for how to display week number. 1 = ShowWeekNumberFromDate, 2 = ShowWeekNumberToDate, 3 = ShowWeekNumberFromToDate, 4 = DontShowWeekNumber |
ShowBookedTimes | form | bool | No | |
PaymentProviderId | form | int | No | 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 |
BookOnlyOnExistingCustomers | form | boolean | No | If it's only allowed for existing customers to book |
PaymentEnabled | form | boolean | No | If payment is enabled |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Active | form | bool | No | If the booking is active or not |
InactiveMessage | form | string | No | If the booking is not active, what message to show to the customers |
Searchable | form | bool | No | If the company should be visible in search results on hompage |
GATrackingId | form | string | No | If you have a google analytics account and want to track your customers behaviors. |
GoogleAdsConversionId | form | string | No | If you have a google Ads Conversion Id account and want to track your customers behaviors. |
LinkedinTagId | form | string | No | If you have a LinkedIn account and want to track your customers behaviors. |
GoogleAdsConversionLabel | form | string | No | If you have a Google Ads Conversion Label and want to track your customers behaviors. |
GTMTrackingId | form | string | No | If you have a google tag manager account and want to track your customers behaviors. |
FacebookPixelId | form | string | No | If you have a facebook account and want to track your customers behaviors. |
MultiLanguage | form | bool | No | If you want your customers to be albe to change language on your homepage |
ShowOnMarketplace | form | bool | No | If the company should be visible on the marketplace |
EnableAPITranslation | form | bool | No | If you want your own written text on your homepage to be translated using google analytics when a user changes language |
DefaultLanguage | form | string | No | What is the standard language your homepage information is written in. Select from the different countries, ie. SE,NO,EN |
SendCustomerInformationToExternalProviders | form | bool | No | If you want to allow to send customer information in the tracking events to the external providers. Note you as a company are responsible for informing your customers and handling the data in terms of GDPR. |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
ServiceLayoutId | form | int | No | The service layouts id. |
TimeLayoutId | form | int | No | The time layouts id. |
BookingLayoutId | form | int | No | The booking layouts id. |
PrimaryColor | form | string | No | The primary color of the booking widget. |
ShowServiceImage | form | bool | No | If you should show the service image in the booking widget. |
ShowRebateCodeField | form | bool | No | If you should show the rebate code field in the booking widget. |
ShowNextAvailableTime | form | bool | No | If you should show the next available time in the booking widget. |
ShowEndTime | form | bool | No | If you should show the end time in the booking widget. |
BookedTimeSlotText | form | string | No | What text to show on booked time slots. Default text is Booked |
DarkTheme | form | bool | No | If the widget should be displayed in dark theme |
ShowSubscribeToNewsletter | form | bool | No | If you should show the subscribe to newsletter checkbox in the booking widget. |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
HomepageHeading | form | string | No | The text for homepage heading |
WelcomePageHeading | form | string | No | The text for homepage startpage heading |
WelcomePageBody | form | string | No | The text for homepage startpage body |
AboutUsPageHeading | form | string | No | The text for homepage about us page heading |
AboutUsPageBody | form | string | No | The text for homepage about us page body |
ImageUrl | form | Uri | No | The startpage image url |
CoverImage | form | Uri | No | The cover image url |
ShowRating | form | bool | No | Show rating on the page |
HomePageTemplateId | form | int | No | The template for the homepage |
HeroSectionStyleId | form | int | No | The hero section style for the homepage |
EnableHomepage | form | bool | No | Enable the BokaMera Homepage |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
AverageScore | form | double | No | The average rating score |
RatingScore1Count | form | int | No | The number of ratings of score 1 |
RatingScore2Count | form | int | No | The number of ratings of score 2 |
RatingScore3Count | form | int | No | The number of ratings of score 3 |
RaingScore4Count | form | int | No | The number of ratings of score 4 |
RatingScore5Count | form | int | No | The number of ratings of score 5 |
Count | form | int | No | The number of ratings |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Title | form | string | No | The title for the review |
Description | form | string | No | The description for the review |
RatingScore | form | int | No | The rating score |
Author | form | string | No | The review author |
Created | form | DateTime | No | The created date |
ReviewAnswer | form | string | No | The review answer from the company |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Id | form | int | No | Custom field id |
Name | form | string | No | Configuration name. Example: 'Number of persons'. |
Description | form | string | No | Custom field description. Example: 'For how many persons is this booking?' |
Width | form | int? | No | Field width. Example: 20 for 20px |
DataType | form | string | No | Data field of custom field. Valid values are: TextBox, ... Example: 'TextBox' |
DefaultValue | form | string | No | Default value of the field. Example: '3' |
IsMandatory | form | bool | No | Determines if the field is required to have a value or not |
MandatoryErrorMessage | form | string | No | Error message shown to the user if the field data is required but not entered |
MaxLength | form | int | No | Max lenght of the field |
MultipleLineText | form | bool | No | If the field should have multiple lines |
RegEx | form | string | No | Regular expression used for validation of the field |
RegExErrorMessage | form | string | No | Error message shown if the regular expression validation failed |
Values | form | List<CustomFieldValueResponse> | No | The values to select from if Datatype is DropDown for this custom field |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Value | form | string | No |
To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv
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: text/jsv
Content-Type: text/jsv
Content-Length: length
{
CompanyId: 00000000-0000-0000-0000-000000000000,
Name: String,
OrganisationNumber: String,
TypeId: 0,
OpeningHours: String,
Details: String,
CategoryId: 0,
Street1: String,
Street2: String,
ZipCode: String,
City: String,
CountryId: String,
Longitude: String,
Latitude: String,
Phone: String,
Email: String,
Fax: String,
Homepage: String,
SitePath: String
}
HTTP/1.1 200 OK Content-Type: text/jsv Content-Length: length { Name: String, OrganisationNumber: String, TypeId: 0, Details: String, CategoryId: 0, Category: String, Street1: String, Street2: String, ZipCode: String, City: String, CountryId: String, Longitude: String, Latitude: String, Distance: 0, Phone: String, Email: String, Homepage: String, SitePath: String, Active: False, CodeLockSystem: Sample, IsFreeAccount: False, Updated: "0001-01-01T00:00:00", Created: "0001-01-01T00:00:00", StatusId: 0, IsFavorite: False, BookingAgreements: String, BookingSettings: { EnableMobileApp: False, BookingReceiptMessage: String, ShowFreeTimesLeft: False, EnableShowBookedTimes: False, BookingAgreement: String, WeekNumberSetting: 0, ShowBookedTimes: False, PaymentProviderId: 0, BookOnlyOnExistingCustomers: False, PaymentEnabled: False }, SystemSettings: { Active: False, InactiveMessage: String, Searchable: False, GATrackingId: String, GoogleAdsConversionId: String, LinkedinTagId: String, GoogleAdsConversionLabel: String, GTMTrackingId: String, FacebookPixelId: String, MultiLanguage: False, ShowOnMarketplace: False, EnableAPITranslation: False, DefaultLanguage: String, SendCustomerInformationToExternalProviders: False }, WidgetSettings: { ServiceLayoutId: 0, TimeLayoutId: 0, BookingLayoutId: 0, PrimaryColor: String, ShowServiceImage: False, ShowRebateCodeField: False, ShowNextAvailableTime: False, ShowEndTime: False, BookedTimeSlotText: String, DarkTheme: False, ShowSubscribeToNewsletter: False }, HomepageSettings: { HomepageHeading: String, WelcomePageHeading: String, WelcomePageBody: String, AboutUsPageHeading: String, AboutUsPageBody: String, ShowRating: False, HomePageTemplateId: 0, HeroSectionStyleId: 0, EnableHomepage: False }, RatingSummary: { AverageScore: 0, RatingScore1Count: 0, RatingScore2Count: 0, RatingScore3Count: 0, RaingScore4Count: 0, RatingScore5Count: 0, Count: 0 }, Reviews: [ { Title: String, Description: String, RatingScore: 0, Author: String, ReviewAnswer: String } ], CustomerCustomFields: [ { "Id": 0, "Name": "String", "Description": "String", "Width": 0, "DataType": "String", "DefaultValue": "String", "IsMandatory": false, "MandatoryErrorMessage": "String", "MaxLength": 0, "MultipleLineText": false, "RegEx": "String", "RegExErrorMessage": "String", "Values": [ { "Value": "String" } ] } ], ResponseStatus: { ErrorCode: String, Message: String, StackTrace: String, Errors: [ { ErrorCode: String, FieldName: String, Message: String, Meta: { String: String } } ], Meta: { String: String } } }