BokaMera.API.Host

CreateBooking

The following routes are available for this service:
POST	/bookings	Create a new booking	Create a new booking if you are authorized to do so.

**CreateBooking** Parameters:
Name	Parameter	Data Type	Required	Description
From	body	DateTime	Yes	The datetime you want to start the booking.
To	body	DateTime	Yes	The datetime you want to end the booking.
Quantities	body	QuantityToBook[]	Yes	Set the number of spots you want to book. You add number of spots per price category. Multiple spots require that the service has GroupBooking enabled. Default is one spot.

**CreateBookingBase** Parameters:
Name	Parameter	Data Type	Required	Description
CompanyId	form	Guid?	No	The company id, if empty will use the company id for the user you are logged in with.
CustomerId	form	Guid?	No	If you want to book on an existing customer instead of CustomerToBook info set the CustomerId here. Set Empty Guid (00000000-0000-0000-0000-000000000000) if you want to book without any customer, this is only allowed by admin. The customer id is shown in the customer list named as id. When booking as customer (no admin) leave this field blank.
PinCode	form	string	Yes	If company requires to be authenticated or a pin code entered to book on a specific customer, enter it here.
Customer	form	CustomerToHandle	Yes	If you want to book with customer information instead of the Customer Id send the customer information here. Note: If customer profile already exists with the same email the information will not be changed, instead the provided information will be added as BookingsComments if it differs from the ordinary profile.
InvoiceAddress	form	InvoiceAddressToHandle	Yes	If you want to book with customer information instead of the Customer Id send the customer information here. Note: If customer profile already exists with the same email the information will not be changed, instead the provided information will be added as BookingsComments if it differs from the ordinary profile.
ServiceId	form	int	Yes	The service to be booked
BookedComments	form	string	Yes	If you want to add comments to a booking you can add them here, this comments are never shared with the customer
CommentsToCustomer	form	string	Yes	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
Resources	form	List<ResourceToBook>	Yes
RebateCodeIds	form	List<int>	Yes	Rebate codes applied to booking
SendEmailReminder	form	bool?	No	If you want to send Email reminder
SendSmsReminder	form	bool?	No	If you want to send SMS reminder
SendSmsConfirmation	form	bool?	No	If you want to send SMS confirmation
SendEmailConfirmation	form	bool?	No	Only admins are allowed to not send an email confirmation. Default is true
PaymentOption	form	PaymentOptions	No	If payment is enabled and you're an administrator, optional to choose payment option, if empty then the default settings will be used. Following payment options exists. DefaultSetting = 0, BookWithoutPayment = 1 (will be direcyly booked without payment), BookWithPaymentMessageToCustomer = 2 (will set status AwaitingPayment and send payment instructions to customer), BookWithManualPayment = 3 (Will set status AwaitingPaymentNoTimeLimit and Admin will need to manually mark the booking as payed when recieved payment).
CustomFields	form	List<AddCustomField>	Yes	If Custom Fields are added to the booking, here you will send the id and the value for each custom field to be saved
CustomerCustomFields	form	List<AddCustomField>	Yes	If Custom Fields are added to the customer, here you will send the id and the value for each custom field to be updated
AllowBookingOutsideSchedules	form	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

**CustomerBase** Parameters:
Name	Parameter	Data Type	Required
CustomerId	form	Guid?	No
Firstname	form	string	Yes
Lastname	form	string	Yes
Email	form	string	Yes
Phone	form	string	Yes
SubscribedToNewsletter	form	bool	No

**InvoiceAddressToHandle** Parameters:
Name	Parameter	Data Type	Required
CorporateIdentityNumber	form	string	Yes
InvoiceAddress1	form	string	Yes
InvoiceAddress2	form	string	Yes
InvoiceCity	form	string	Yes
InvoicePostalCode	form	string	Yes
InvoiceCountryCode	form	string	Yes

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

**PaymentOptions** Enum:
DefaultSetting
BookWithoutPayment
BookWithPaymentMessageToCustomer
BookWithManualPayment

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

**QuantityToBook** Parameters:
Name	Parameter	Data Type	Required	Description
PriceId	form	int	Yes	If service has a price, enter the price id for that price. If no price exists for the service set 0 as PriceId. If you put 0 and a price exists, it will use that price (only works if just one price exists for the current selected date to book)
Quantity	form	int	Yes	Set the number of spots or resources you want to book on the specific price category
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.

**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	Yes
StatusInfo	form	BookingStatusQueryResponse	Yes
SendEmailReminder	form	bool	No
SendSmsReminder	form	bool	No
SendSmsConfirmation	form	bool	No
SendEmailConfirmation	form	bool	No
LastTimeToUnBook	form	DateTime?	No
CustomFields	form	List<CustomFieldConfigData>	Yes
CustomFieldValues	form	List<CustomFieldDataResponse>	Yes
BookedResourceTypes	form	List<BookedResourceType>	Yes
Company	form	BookedCompany	Yes
Customer	form	BookedCustomer	Yes
Quantities	form	List<BookedQuantity>	Yes
Service	form	ServiceInfoResponse	Yes
InvoiceAddress	form	InvoiceAddressResponse	Yes
PaymentExpiration	form	DateTime?	No
Log	form	List<BookingLogQueryResponse>	Yes
PaymentLog	form	List<BookingPaymentLogQueryResponse>	Yes
CheckoutLog	form	List<BookingCheckoutQueryResponse>	Yes
ExternalReference	form	List<ExternalReferenceResponse>	Yes
ResponseStatus	form	ResponseStatus	Yes
LengthInMinutes	form	int?	No
BookedBy	form	string	Yes
BookedComments	form	string	Yes
UnbookedComments	form	string	Yes
CommentsToCustomer	form	string	Yes
CreatedDate	form	DateTime	No
UpdatedDate	form	DateTime	No
UnbookedOn	form	DateTime?	No
CancellationCode	form	string	Yes
RatingCode	form	string	Yes

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

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

**CustomFieldConfigData** Parameters:
Name	Parameter	Data Type	Required	Description
Id	form	int	No	Custom field id
Name	form	string	Yes	Configuration name. Example: 'Number of persons'.
Description	form	string	Yes	Custom field description. Example: 'For how many persons is this booking?'
Width	form	int?	No	Field width. Example: 20 for 20px
DataType	form	string	Yes	Data field of custom field. Valid values are: TextBox, ... Example: 'TextBox'
DefaultValue	form	string	Yes	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	Yes	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	Yes	Regular expression used for validation of the field
RegExErrorMessage	form	string	Yes	Error message shown if the regular expression validation failed
Values	form	List<CustomFieldValueResponse>	Yes	The values to select from if Datatype is DropDown for this custom field

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

**CustomFieldDataResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Id	form	int	No
Column	form	string	Yes
Name	form	string	Yes
Description	form	string	Yes
Value	form	string	Yes
DataType	form	string	Yes	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	Yes	The resource type name
Resources	form	List<BookedResource>	Yes	The resources inside resource type

**BookedResource** Parameters:
Name	Parameter	Data Type	Required
Id	form	int	No
Name	form	string	Yes
Color	form	string	Yes
ImageUrl	form	Uri	Yes
Email	form	string	Yes
MobilePhone	form	string	Yes
AccessGroup	form	string	Yes
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	Yes
LogoType	form	Uri	Yes
Category	form	string	Yes
Street1	form	string	Yes
Street2	form	string	Yes
ZipCode	form	string	Yes
City	form	string	Yes
CountryId	form	string	Yes
Longitude	form	string	Yes
Latitude	form	string	Yes
Phone	form	string	Yes
Email	form	string	Yes
HomePage	form	string	Yes
SitePath	form	string	Yes
IsFavorite	form	bool	No
PaymentProviderId	form	int?	No

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

**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	Yes	The price currency
PriceSign	form	string	Yes	The price sign
Category	form	string	Yes	The price category
VAT	form	decimal?	No	The price VAT in percent
PriceText	form	string	Yes	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	Yes
Description	form	string	Yes
ImageUrl	form	Uri	Yes
LengthInMinutes	form	int?	No
MaxNumberOfSpotsPerBooking	form	int	No
MinNumberOfSpotsPerBooking	form	int	No
GroupBooking	form	GroupBookingSettings	Yes
MultipleResource	form	MultipleResourceSettings	Yes
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

**InvoiceAddressResponse** Parameters:
Name	Parameter	Data Type	Required
InvoiceAddressId	form	Guid	No
UserId	form	Guid?	No
CorporateIdentityNumber	form	string	Yes
InvoiceAddress1	form	string	Yes
InvoiceAddress2	form	string	Yes
InvoiceCity	form	string	Yes
InvoicePostalCode	form	string	Yes
InvoiceCountryCode	form	string	Yes

**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	Yes	The type of event
Comments	form	string	Yes	Comments that could be added to the event log item
UserName	form	string	Yes	The user created the event
Created	form	DateTime	No	The date when the event occurred

**BookingLogEventTypeResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Id	form	int	No	The event type id
Name	form	string	Yes	The event type name
Description	form	string	Yes	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	Yes	The payment reference id
OrderItemReferenceId	form	string	Yes	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	Yes	The payment currency id
CurrencyInfo	form	CurrencyInfoResponse	Yes	The payment currency info
Comments	form	string	Yes	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 were updated.

**CurrencyInfoResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Id	form	string	Yes	The currency id
Name	form	string	Yes	The currency id
CurrencySign	form	string	Yes	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	Yes	The payment snippet code
Status	form	string	Yes	The payment status
Message	form	string	Yes	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	Yes
ExternalData	form	string	Yes
CreatedBy	form	string	Yes
Updated	form	DateTime	No
Created	form	DateTime	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.

POST /bookings HTTP/1.1 
Host: testapi.bokamera.se 
Accept: text/jsonl
Content-Type: text/jsonl
Content-Length: length

{"Quantities":[{"PriceId":0,"Quantity":0,"OccupiesSpot":false}],"CompanyId":"00000000-0000-0000-0000-000000000000","CustomerId":"00000000-0000-0000-0000-000000000000","PinCode":"String","Customer":{"CustomerId":"00000000-0000-0000-0000-000000000000","Firstname":"String","Lastname":"String","Email":"String","Phone":"String","SubscribedToNewsletter":false},"InvoiceAddress":{"CorporateIdentityNumber":"String","InvoiceAddress1":"String","InvoiceAddress2":"String","InvoiceCity":"String","InvoicePostalCode":"String","InvoiceCountryCode":"String"},"ServiceId":0,"BookedComments":"String","CommentsToCustomer":"String","Resources":[{"ResourceTypeId":0,"ResourceId":0}],"RebateCodeIds":[0],"SendEmailReminder":false,"SendSmsReminder":false,"SendSmsConfirmation":false,"SendEmailConfirmation":false,"PaymentOption":"DefaultSetting","CustomFields":[{"Id":0,"Value":"String"}],"CustomerCustomFields":[{"Id":0,"Value":"String"}],"AllowBookingOutsideSchedules":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},"InvoiceAddress":{"UserId":"00000000-0000-0000-0000-000000000000","CorporateIdentityNumber":"String","InvoiceAddress1":"String","InvoiceAddress2":"String","InvoiceCity":"String","InvoicePostalCode":"String","InvoiceCountryCode":"String"},"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"}},"LengthInMinutes":0,"BookedBy":"String","BookedComments":"String","UnbookedComments":"String","CommentsToCustomer":"String","UnbookedOn":"0001-01-01T00:00:00","CancellationCode":"String","RatingCode":"String"}