BokaMera.API.Host

UpdateBooking

The following routes are available for this service:
PUT	/bookings/{Id}	Update existing booking	Updates an existing booking if you are authorized to do so. Note. Price is not updated automatically when changing number of spots or resources.

**UpdateBooking** Parameters:
Name	Parameter	Data Type	Required	Description
CompanyId	body	Guid?	No	The company id, if empty will use the company id for the user you are logged in with.
Id	path	int?	No	Id of the booking
From	body	DateTime?	No
To	body	DateTime?	No
Status	body	BookingStatusEnum?	No
PaymentExpiration	body	DateTime?	No
LastTimeToUnBook	body	DateTime?	No
UnbookedComments	body	string	No	If you want to add comments when canceling a booking you can add them here, this comments are send in the confirmation to the customer
BookedComments	body	string	No	If you want to add comments to a booking you can add them here, this comments are never shared with the customer
CommentsToCustomer	body	string	No	If you want to add comments to the booking that is sent to the customer, you can add them here. Comments will be sent in the booking confirmation
CustomFields	body	List<AddCustomField>	No	If Custom Fields are added to the booking, here you will send the id and the value for each custom field to be updated
Resources	body	ResourceToUpdate	No	Resources you want to change, leave it empty if no changes to the booked resources
AllowBookingOutsideSchedules	body	bool	No	If want to allow to book outside the service schedules. This means you can book a time after the schedule opening hours as long as the resource are available. This is only allowed by administrators
Comment	body	string	No	Any comment to save to the log when changing the booking.
Message	body	string	No	Any comment sent to user if SendSmsConfirmation or SendEmailConfirmation
SendSmsConfirmation	body	bool?	No	If you want to send SMS confirmation. If null, it will take the default value of the bookings SendSMSConfirmation.
SendEmailConfirmation	body	bool?	No	If you want to send Email confirmation. If null, it will take the default value of the bookings SendEmailConfirmation.

**BookingStatusEnum** Enum:
Name	Value
Booked	1
Unbooked	2
Reserved	3
Canceled	4
AwaitingPayment	5
AwaitingPaymentNoTimeLimit	6
Payed	7
AwaitingPaymentRequestFromAdmin	8
AwaitingPaymentFromProvider	9
Invoiced	10

**AddCustomField** Parameters:
Name	Parameter	Data Type	Required	Description
Id	form	int	No
Value	form	string	No

**ResourceToUpdate** Parameters:
Name	Parameter	Data Type	Required	Description
AutoSelectNotDefinedResources	form	bool	No	Set this property to true if you want to autoselected not provided resources. If false you will need to add all resources you want to have booked
Resources	form	List<ResourceToBook>	No	All resources to be booked, if AutoSelectNotDefinedResources is true you will only need to provide the one you want to select, rest will be auto selected if avaiable.

**ResourceToBook** Parameters:
Name	Parameter	Data Type	Required	Description
ResourceTypeId	form	int	No
ResourceId	form	int	No

**BookingQueryResponse** Parameters:
Name	Parameter	Data Type	Required
Id	form	int	No
CompanyId	form	Guid	No
From	form	DateTime	No
To	form	DateTime	No
Status	form	BookingStatusEnum	No
StatusId	form	int	No
StatusName	form	string	No
StatusInfo	form	BookingStatusQueryResponse	No
SendEmailReminder	form	bool	No
SendSmsReminder	form	bool	No
SendSmsConfirmation	form	bool	No
SendEmailConfirmation	form	bool	No
LastTimeToUnBook	form	DateTime?	No
CustomFields	form	List<CustomFieldConfigData>	No
CustomFieldValues	form	List<CustomFieldDataResponse>	No
BookedResourceTypes	form	List<BookedResourceType>	No
Company	form	BookedCompany	No
Customer	form	BookedCustomer	No
Quantities	form	List<BookedQuantity>	No
Service	form	ServiceInfoResponse	No
PaymentExpiration	form	DateTime?	No
Log	form	List<BookingLogQueryResponse>	No
PaymentLog	form	List<BookingPaymentLogQueryResponse>	No
CheckoutLog	form	List<BookingCheckoutQueryResponse>	No
ExternalReference	form	List<ExternalReferenceResponse>	No
ResponseStatus	form	ResponseStatus	No
CalendarExportStatus	form	BookingCalendarExportStatus	No
LengthInMinutes	form	int?	No
BookedBy	form	string	No
BookedComments	form	string	No
UnbookedComments	form	string	No
CommentsToCustomer	form	string	No
CreatedDate	form	DateTime	No
UpdatedDate	form	DateTime	No
UnbookedOn	form	DateTime?	No
CancellationCode	form	string	No
RatingCode	form	string	No

**BookingStatusQueryResponse** Parameters:
Name	Parameter	Data Type	Required
Id	form	int	No
Name	form	string	No
Description	form	string	No
Icon	form	string	No
Color	form	string	No

**CustomFieldConfigData** Parameters:
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

**CustomFieldValueResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Value	form	string	No

**CustomFieldDataResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Id	form	int	No
Column	form	string	No
Name	form	string	No
Description	form	string	No
Value	form	string	No
DataType	form	string	No	Data field of custom field. Valid values are: TextBox, ... Example: 'TextBox'

**BookedResourceType** Parameters:
Name	Parameter	Data Type	Required	Description
Id	form	int	No	The resource type id
Name	form	string	No	The resource type name
Resources	form	List<BookedResource>	No	The resources inside resource type

**BookedResource** Parameters:
Name	Parameter	Data Type	Required
Id	form	int	No
Name	form	string	No
Color	form	string	No
ImageUrl	form	Uri	No
Email	form	string	No
MobilePhone	form	string	No
AccessGroup	form	string	No
EmailNotification	form	bool	No
SMSNotification	form	bool	No
EmailReminder	form	bool	No
SMSReminder	form	bool	No

**BookedCompany** Parameters:
Name	Parameter	Data Type	Required
Id	form	Guid	No
Name	form	string	No
LogoType	form	Uri	No
Category	form	string	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
Phone	form	string	No
Email	form	string	No
HomePage	form	string	No
SitePath	form	string	No
IsFavorite	form	bool	No
PaymentProviderId	form	int?	No

**BookedCustomer** Parameters:
Name	Parameter	Data Type	Required
Id	form	Guid	No
Firstname	form	string	No
Lastname	form	string	No
Email	form	string	No
Phone	form	string	No
FacebookUserName	form	string	No
ImageUrl	form	string	No
CorporateIdentityNumber	form	string	No
InvoiceAddress1	form	string	No
InvoiceAddress2	form	string	No
InvoiceCity	form	string	No
InvoicePostalCode	form	string	No
InvoiceCountryCode	form	string	No

**BookedQuantity** Parameters:
Name	Parameter	Data Type	Required	Description
Id	form	int	No	The quantity Id
Quantity	form	int	No	The quantity for booked on this price category
Price	form	double?	No	The price
PriceBeforeRebate	form	double?	No	The price bofore rebate codes
CurrencyId	form	string	No	The price currency
PriceSign	form	string	No	The price sign
Category	form	string	No	The price category
VAT	form	decimal?	No	The price VAT in percent
PriceText	form	string	No	The price text to display
OccupiesSpot	form	bool	No	If the quantity you add should occupy a spot. Default is true. If no it will only be a row that includes price information.

**ServiceInfoResponse** Parameters:
Name	Parameter	Data Type	Required
Id	form	int	No
Name	form	string	No
Description	form	string	No
ImageUrl	form	Uri	No
LengthInMinutes	form	int?	No
MaxNumberOfSpotsPerBooking	form	int	No
MinNumberOfSpotsPerBooking	form	int	No
GroupBooking	form	GroupBookingSettings	No
MultipleResource	form	MultipleResourceSettings	No
IsGroupBooking	form	bool	No
IsPaymentEnabled	form	bool	No

**GroupBookingSettings** Parameters:
Name	Parameter	Data Type	Required
Active	form	bool	No
Min	form	int	No
Max	form	int	No

**MultipleResourceSettings** Parameters:
Name	Parameter	Data Type	Required
Active	form	bool	No
Min	form	int	No
Max	form	int	No

**BookingLogQueryResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Id	form	int	No	The booking log id
BookingId	form	int	No	The booking id
EventTypeId	form	int	No	The type of event
EventType	form	BookingLogEventTypeResponse	No	The type of event
Comments	form	string	No	Comments that could be added to the event log item
UserName	form	string	No	The user created the event
Created	form	DateTime	No	Then date when the event occured

**BookingLogEventTypeResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Id	form	int	No	The event type id
Name	form	string	No	The event type name
Description	form	string	No	The event type description

**BookingPaymentLogQueryResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Id	form	int	No	The booking payment log id
BookingId	form	int	No	The booking id
PaymentReferenceId	form	string	No	The payment reference id
OrderItemReferenceId	form	string	No	The payment order item reference id
PaymentProviderId	form	int?	No	The payment reference id
Amount	form	double	No	The payment amount
VAT	form	decimal	No	The payment VAT in percent
AmountCredited	form	double	No	The payment amount that is credited
CurrencyId	form	string	No	The payment currency id
CurrencyInfo	form	CurrencyInfoResponse	No	The payment currency info
Comments	form	string	No	Comments that could be added to the event log item
Created	form	DateTime	No	The date when the payment items was created
Updated	form	DateTime	No	The date when the payment items was update

**CurrencyInfoResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Id	form	string	No	The currency id
Name	form	string	No	The currency id
CurrencySign	form	string	No	The currency id

**BookingCheckoutQueryResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Id	form	Guid	No	The checkout id
BookingId	form	int	No	The booking id
PurchaseId	form	int?	No	The purchase id
ExpirationTime	form	DateTime?	No	The payment checkout expiration datetime
Snippet	form	string	No	The payment snippet code
Status	form	string	No	The payment status
Message	form	string	No	Log message
Created	form	DateTime	No	When the checkout log item was created
Updated	form	DateTime	No	When the checkout log item was updated

**ExternalReferenceResponse** Parameters:
Name	Parameter	Data Type	Required
CompanyId	form	Guid	No
Id	form	Guid	No
OwnerId	form	Guid	No
ReferenceType	form	string	No
ExternalData	form	string	No
CreatedBy	form	string	No
Updated	form	DateTime	No
Created	form	DateTime	No

**BookingCalendarExportStatus** Parameters:
Name	Parameter	Data Type	Required
CalendarId	form	string	No
BookingId	form	int	No
Synced	form	bool?	No

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

HTTP + OTHER

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

PUT /bookings/{Id} HTTP/1.1 
Host: api.bokamera.se 
Accept: text/jsonl
Content-Type: text/jsonl
Content-Length: length

{"CompanyId":"00000000-0000-0000-0000-000000000000","Id":0,"From":"0001-01-01T00:00:00","To":"0001-01-01T00:00:00","Status":"0","PaymentExpiration":"0001-01-01T00:00:00","LastTimeToUnBook":"0001-01-01T00:00:00","UnbookedComments":"String","BookedComments":"String","CommentsToCustomer":"String","CustomFields":[{"Id":0,"Value":"String"}],"Resources":{"AutoSelectNotDefinedResources":false,"Resources":[{"ResourceTypeId":0,"ResourceId":0}]},"AllowBookingOutsideSchedules":false,"Comment":"String","Message":"String","SendSmsConfirmation":false,"SendEmailConfirmation":false}

HTTP/1.1 200 OK
Content-Type: text/jsonl
Content-Length: length

{"Id":0,"Status":"Booked","StatusId":0,"StatusName":"String","StatusInfo":{"Id":0,"Name":"String","Description":"String","Icon":"String","Color":"String"},"SendEmailReminder":false,"SendSmsReminder":false,"SendSmsConfirmation":false,"SendEmailConfirmation":false,"LastTimeToUnBook":"0001-01-01T00:00:00","CustomFields":[{"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"}]}],"CustomFieldValues":[{"Id":0,"Column":"String","Name":"String","Description":"String","Value":"String","DataType":"String"}],"BookedResourceTypes":[{"Id":0,"Name":"String","Resources":[{"Id":0,"Name":"String","Color":"String","Email":"String","MobilePhone":"String","AccessGroup":"String","EmailNotification":false,"SMSNotification":false,"EmailReminder":false,"SMSReminder":false}]}],"Company":{"Name":"String","Category":"String","Street1":"String","Street2":"String","ZipCode":"String","City":"String","CountryId":"String","Longitude":"String","Latitude":"String","Phone":"String","Email":"String","HomePage":"String","SitePath":"String","IsFavorite":false,"PaymentProviderId":0},"Customer":{"Firstname":"String","Lastname":"String","Email":"String","Phone":"String","FacebookUserName":"String","ImageUrl":"String","CorporateIdentityNumber":"String","InvoiceAddress1":"String","InvoiceAddress2":"String","InvoiceCity":"String","InvoicePostalCode":"String","InvoiceCountryCode":"String"},"Quantities":[{"Id":0,"Quantity":0,"Price":0,"PriceBeforeRebate":0,"CurrencyId":"String","PriceSign":"String","Category":"String","VAT":0,"PriceText":"String","OccupiesSpot":false}],"Service":{"Id":0,"Name":"String","Description":"String","LengthInMinutes":0,"MaxNumberOfSpotsPerBooking":0,"MinNumberOfSpotsPerBooking":0,"GroupBooking":{"Active":false,"Min":0,"Max":0},"MultipleResource":{"Active":false,"Min":0,"Max":0},"IsGroupBooking":false,"IsPaymentEnabled":false},"PaymentExpiration":"0001-01-01T00:00:00","Log":[{"Id":0,"BookingId":0,"EventTypeId":0,"EventType":{"Id":0,"Name":"String","Description":"String"},"Comments":"String","UserName":"String"}],"PaymentLog":[{"Id":0,"BookingId":0,"PaymentReferenceId":"String","OrderItemReferenceId":"String","PaymentProviderId":0,"Amount":0,"VAT":0,"AmountCredited":0,"CurrencyId":"String","CurrencyInfo":{"Id":"String","Name":"String","CurrencySign":"String"},"Comments":"String"}],"CheckoutLog":[{"BookingId":0,"PurchaseId":0,"ExpirationTime":"0001-01-01T00:00:00","Snippet":"String","Status":"String","Message":"String"}],"ExternalReference":[{"ReferenceType":"String","ExternalData":"String","CreatedBy":"String"}],"ResponseStatus":{"ErrorCode":"String","Message":"String","StackTrace":"String","Errors":[{"ErrorCode":"String","FieldName":"String","Message":"String","Meta":{"String":"String"}}],"Meta":{"String":"String"}},"CalendarExportStatus":{"CalendarId":"String","BookingId":0,"Synced":false},"LengthInMinutes":0,"BookedBy":"String","BookedComments":"String","UnbookedComments":"String","CommentsToCustomer":"String","UnbookedOn":"0001-01-01T00:00:00","CancellationCode":"String","RatingCode":"String"}