| Requires any of the roles: | bookingsupplier-administrator-write, superadmin |
| PUT | /bookings/{Id}/approve | Approve a booking that is reserved and awaiting approval | Updates an existing booking with approved status if you are authorized to do so. |
|---|
using System;
using System.Collections;
using System.Collections.Generic;
using System.Runtime.Serialization;
using ServiceStack;
using ServiceStack.DataAnnotations;
using BokaMera.API.ServiceModel.Dtos;
using BokaMera.API.ServiceModel.Enums;
namespace BokaMera.API.ServiceModel.Dtos
{
[ValidateRequest("IsAuthenticated")]
[ApiResponse(Description="You were unauthorized to call this service", StatusCode=401)]
[ApiResponse(Description="You have too low privilegies to call this service", StatusCode=403)]
public partial class ApproveBooking
: ICompany
{
///<summary>
///The company id, if empty will use the company id for the user you are logged in with.
///</summary>
[ApiMember(Description="The company id, if empty will use the company id for the user you are logged in with.")]
public virtual Guid? CompanyId { get; set; }
///<summary>
///Id of the booking
///</summary>
[ApiMember(Description="Id of the booking", IsRequired=true, ParameterType="path")]
public virtual int? Id { get; set; }
///<summary>
///If payment is enabled, optional to choose payment option, if blank then the default settings will be used
///</summary>
[ApiMember(Description="If payment is enabled, optional to choose payment option, if blank then the default settings will be used")]
public virtual PaymentOptions PaymentOption { get; set; }
///<summary>
///Any comment logged to the booking history and sent to user if SendSmsConfirmation or SendEmailConfirmation
///</summary>
[ApiMember(Description="Any comment logged to the booking history and sent to user if SendSmsConfirmation or SendEmailConfirmation")]
public virtual string Comment { get; set; }
///<summary>
///Any comment sent to user if SendSmsConfirmation or SendEmailConfirmation
///</summary>
[ApiMember(Description="Any comment sent to user if SendSmsConfirmation or SendEmailConfirmation")]
public virtual string Message { get; set; }
///<summary>
///If you want to send SMS confirmation. If null, it will take the default value of the bookings SendSMSConfirmation.
///</summary>
[ApiMember(Description="If you want to send SMS confirmation. If null, it will take the default value of the bookings SendSMSConfirmation.")]
public virtual bool? SendSmsConfirmation { get; set; }
///<summary>
///If you want to send Email confirmation. If null, it will take the default value of the bookings SendEmailConfirmation.
///</summary>
[ApiMember(Description="If you want to send Email confirmation. If null, it will take the default value of the bookings SendEmailConfirmation.")]
public virtual bool? SendEmailConfirmation { get; set; }
}
public partial class BookedCompany
{
public virtual Guid Id { get; set; }
public virtual string Name { get; set; }
public virtual Uri LogoType { get; set; }
public virtual string Category { get; set; }
public virtual string Street1 { get; set; }
public virtual string Street2 { get; set; }
public virtual string ZipCode { get; set; }
public virtual string City { get; set; }
public virtual string CountryId { get; set; }
public virtual string Longitude { get; set; }
public virtual string Latitude { get; set; }
public virtual string Phone { get; set; }
public virtual string Email { get; set; }
public virtual string HomePage { get; set; }
public virtual string SitePath { get; set; }
public virtual bool IsFavorite { get; set; }
public virtual int? PaymentProviderId { get; set; }
}
public partial class BookedCustomer
{
public virtual Guid Id { get; set; }
public virtual string Firstname { get; set; }
public virtual string Lastname { get; set; }
public virtual string Email { get; set; }
public virtual string Phone { get; set; }
public virtual string FacebookUserName { get; set; }
public virtual string ImageUrl { get; set; }
public virtual string CorporateIdentityNumber { get; set; }
public virtual string InvoiceAddress1 { get; set; }
public virtual string InvoiceAddress2 { get; set; }
public virtual string InvoiceCity { get; set; }
public virtual string InvoicePostalCode { get; set; }
public virtual string InvoiceCountryCode { get; set; }
}
public partial class BookedQuantity
{
///<summary>
///The quantity Id
///</summary>
[ApiMember(Description="The quantity Id")]
public virtual int Id { get; set; }
///<summary>
///The quantity for booked on this price category
///</summary>
[ApiMember(Description="The quantity for booked on this price category")]
public virtual int Quantity { get; set; }
///<summary>
///The price
///</summary>
[ApiMember(Description="The price")]
public virtual double? Price { get; set; }
///<summary>
///The price bofore rebate codes
///</summary>
[ApiMember(Description="The price bofore rebate codes")]
public virtual double? PriceBeforeRebate { get; set; }
///<summary>
///The price currency
///</summary>
[ApiMember(Description="The price currency")]
public virtual string CurrencyId { get; set; }
///<summary>
///The price sign
///</summary>
[ApiMember(Description="The price sign")]
public virtual string PriceSign { get; set; }
///<summary>
///The price category
///</summary>
[ApiMember(Description="The price category")]
public virtual string Category { get; set; }
///<summary>
///The price VAT in percent
///</summary>
[ApiMember(Description="The price VAT in percent")]
public virtual decimal? VAT { get; set; }
///<summary>
///The price text to display
///</summary>
[ApiMember(Description="The price text to display")]
public virtual string PriceText { get; set; }
///<summary>
///If the quantity you add should occupy a spot. Default is true. If no it will only be a row that includes price information.
///</summary>
[ApiMember(Description="If the quantity you add should occupy a spot. Default is true. If no it will only be a row that includes price information.")]
public virtual bool OccupiesSpot { get; set; }
}
public partial class BookedResource
{
public virtual int Id { get; set; }
public virtual string Name { get; set; }
public virtual string Color { get; set; }
public virtual Uri ImageUrl { get; set; }
public virtual string Email { get; set; }
public virtual string MobilePhone { get; set; }
public virtual string AccessGroup { get; set; }
public virtual bool EmailNotification { get; set; }
public virtual bool SMSNotification { get; set; }
public virtual bool EmailReminder { get; set; }
public virtual bool SMSReminder { get; set; }
}
public partial class BookedResourceType
{
public BookedResourceType()
{
Resources = new List<BookedResource>{};
}
///<summary>
///The resource type id
///</summary>
[ApiMember(Description="The resource type id")]
public virtual int Id { get; set; }
///<summary>
///The resource type name
///</summary>
[ApiMember(Description="The resource type name")]
public virtual string Name { get; set; }
///<summary>
///The resources inside resource type
///</summary>
[ApiMember(Description="The resources inside resource type")]
public virtual List<BookedResource> Resources { get; set; }
}
public partial class BookingCalendarExportStatus
{
public virtual string CalendarId { get; set; }
public virtual int BookingId { get; set; }
public virtual bool? Synced { get; set; }
}
public partial class BookingCheckoutQueryResponse
{
///<summary>
///The checkout id
///</summary>
[ApiMember(Description="The checkout id")]
public virtual Guid Id { get; set; }
///<summary>
///The booking id
///</summary>
[ApiMember(Description="The booking id")]
public virtual int BookingId { get; set; }
///<summary>
///The purchase id
///</summary>
[ApiMember(Description="The purchase id")]
public virtual int? PurchaseId { get; set; }
///<summary>
///The payment checkout expiration datetime
///</summary>
[ApiMember(Description="The payment checkout expiration datetime")]
public virtual DateTime? ExpirationTime { get; set; }
///<summary>
///The payment snippet code
///</summary>
[ApiMember(Description="The payment snippet code")]
public virtual string Snippet { get; set; }
///<summary>
///The payment status
///</summary>
[ApiMember(Description="The payment status")]
public virtual string Status { get; set; }
///<summary>
///Log message
///</summary>
[ApiMember(Description="Log message")]
public virtual string Message { get; set; }
///<summary>
///When the checkout log item was created
///</summary>
[ApiMember(Description="When the checkout log item was created")]
public virtual DateTime Created { get; set; }
///<summary>
///When the checkout log item was updated
///</summary>
[ApiMember(Description="When the checkout log item was updated")]
public virtual DateTime Updated { get; set; }
}
public partial class BookingLogEventTypeResponse
{
///<summary>
///The event type id
///</summary>
[ApiMember(Description="The event type id")]
public virtual int Id { get; set; }
///<summary>
///The event type name
///</summary>
[ApiMember(Description="The event type name")]
public virtual string Name { get; set; }
///<summary>
///The event type description
///</summary>
[ApiMember(Description="The event type description")]
public virtual string Description { get; set; }
}
public partial class BookingLogQueryResponse
{
///<summary>
///The booking log id
///</summary>
[ApiMember(Description="The booking log id")]
public virtual int Id { get; set; }
///<summary>
///The booking id
///</summary>
[ApiMember(Description="The booking id")]
public virtual int BookingId { get; set; }
///<summary>
///The type of event
///</summary>
[ApiMember(Description="The type of event")]
public virtual int EventTypeId { get; set; }
///<summary>
///The type of event
///</summary>
[ApiMember(Description="The type of event")]
public virtual BookingLogEventTypeResponse EventType { get; set; }
///<summary>
///Comments that could be added to the event log item
///</summary>
[ApiMember(Description="Comments that could be added to the event log item")]
public virtual string Comments { get; set; }
///<summary>
///The user created the event
///</summary>
[ApiMember(Description="The user created the event")]
public virtual string UserName { get; set; }
///<summary>
///Then date when the event occured
///</summary>
[ApiMember(Description="Then date when the event occured")]
public virtual DateTime Created { get; set; }
}
public partial class BookingPaymentLogQueryResponse
{
///<summary>
///The booking payment log id
///</summary>
[ApiMember(Description="The booking payment log id")]
public virtual int Id { get; set; }
///<summary>
///The booking id
///</summary>
[ApiMember(Description="The booking id")]
public virtual int BookingId { get; set; }
///<summary>
///The payment reference id
///</summary>
[ApiMember(Description="The payment reference id")]
public virtual string PaymentReferenceId { get; set; }
///<summary>
///The payment order item reference id
///</summary>
[ApiMember(Description="The payment order item reference id")]
public virtual string OrderItemReferenceId { get; set; }
///<summary>
///The payment reference id
///</summary>
[ApiMember(Description="The payment reference id")]
public virtual int? PaymentProviderId { get; set; }
///<summary>
///The payment amount
///</summary>
[ApiMember(Description="The payment amount")]
public virtual double Amount { get; set; }
///<summary>
///The payment VAT in percent
///</summary>
[ApiMember(Description="The payment VAT in percent")]
public virtual decimal VAT { get; set; }
///<summary>
///The payment amount that is credited
///</summary>
[ApiMember(Description="The payment amount that is credited")]
public virtual double AmountCredited { get; set; }
///<summary>
///The payment currency id
///</summary>
[ApiMember(Description="The payment currency id")]
public virtual string CurrencyId { get; set; }
///<summary>
///The payment currency info
///</summary>
[ApiMember(Description="The payment currency info")]
public virtual CurrencyInfoResponse CurrencyInfo { get; set; }
///<summary>
///Comments that could be added to the event log item
///</summary>
[ApiMember(Description="Comments that could be added to the event log item")]
public virtual string Comments { get; set; }
///<summary>
///The date when the payment items was created
///</summary>
[ApiMember(Description="The date when the payment items was created")]
public virtual DateTime Created { get; set; }
///<summary>
///The date when the payment items was update
///</summary>
[ApiMember(Description="The date when the payment items was update")]
public virtual DateTime Updated { get; set; }
}
public partial class BookingQueryResponse
{
public BookingQueryResponse()
{
CustomFields = new List<CustomFieldConfigData>{};
CustomFieldValues = new List<CustomFieldDataResponse>{};
BookedResourceTypes = new List<BookedResourceType>{};
Quantities = new List<BookedQuantity>{};
Log = new List<BookingLogQueryResponse>{};
PaymentLog = new List<BookingPaymentLogQueryResponse>{};
CheckoutLog = new List<BookingCheckoutQueryResponse>{};
ExternalReference = new List<ExternalReferenceResponse>{};
}
public virtual int Id { get; set; }
public virtual Guid CompanyId { get; set; }
public virtual DateTime From { get; set; }
public virtual DateTime To { get; set; }
public virtual BookingStatusEnum Status { get; set; }
public virtual int StatusId { get; set; }
public virtual string StatusName { get; set; }
public virtual BookingStatusQueryResponse StatusInfo { get; set; }
public virtual bool SendEmailReminder { get; set; }
public virtual bool SendSmsReminder { get; set; }
public virtual bool SendSmsConfirmation { get; set; }
public virtual bool SendEmailConfirmation { get; set; }
public virtual DateTime? LastTimeToUnBook { get; set; }
public virtual List<CustomFieldConfigData> CustomFields { get; set; }
public virtual List<CustomFieldDataResponse> CustomFieldValues { get; set; }
public virtual List<BookedResourceType> BookedResourceTypes { get; set; }
public virtual BookedCompany Company { get; set; }
public virtual BookedCustomer Customer { get; set; }
public virtual List<BookedQuantity> Quantities { get; set; }
public virtual ServiceInfoResponse Service { get; set; }
public virtual DateTime? PaymentExpiration { get; set; }
public virtual List<BookingLogQueryResponse> Log { get; set; }
public virtual List<BookingPaymentLogQueryResponse> PaymentLog { get; set; }
public virtual List<BookingCheckoutQueryResponse> CheckoutLog { get; set; }
public virtual List<ExternalReferenceResponse> ExternalReference { get; set; }
public virtual ResponseStatus ResponseStatus { get; set; }
public virtual BookingCalendarExportStatus CalendarExportStatus { get; set; }
public virtual int? LengthInMinutes { get; set; }
public virtual string BookedBy { get; set; }
public virtual string BookedComments { get; set; }
public virtual string UnbookedComments { get; set; }
public virtual string CommentsToCustomer { get; set; }
public virtual DateTime CreatedDate { get; set; }
public virtual DateTime UpdatedDate { get; set; }
public virtual DateTime? UnbookedOn { get; set; }
public virtual string CancellationCode { get; set; }
public virtual string RatingCode { get; set; }
}
public partial class BookingStatusQueryResponse
{
public virtual int Id { get; set; }
public virtual string Name { get; set; }
public virtual string Description { get; set; }
public virtual string Icon { get; set; }
public virtual string Color { get; set; }
}
public partial class CurrencyInfoResponse
{
///<summary>
///The currency id
///</summary>
[ApiMember(Description="The currency id")]
public virtual string Id { get; set; }
///<summary>
///The currency id
///</summary>
[ApiMember(Description="The currency id")]
public virtual string Name { get; set; }
///<summary>
///The currency id
///</summary>
[ApiMember(Description="The currency id")]
public virtual string CurrencySign { get; set; }
}
public partial class CustomFieldConfigData
{
public CustomFieldConfigData()
{
Values = new List<CustomFieldValueResponse>{};
}
///<summary>
///Custom field id
///</summary>
[ApiMember(Description="Custom field id")]
public virtual int Id { get; set; }
///<summary>
///Configuration name. Example: 'Number of persons'.
///</summary>
[ApiMember(Description="Configuration name. Example: 'Number of persons'.")]
public virtual string Name { get; set; }
///<summary>
///Custom field description. Example: 'For how many persons is this booking?'
///</summary>
[ApiMember(Description="Custom field description. Example: 'For how many persons is this booking?'")]
public virtual string Description { get; set; }
///<summary>
///Field width. Example: 20 for 20px
///</summary>
[ApiMember(Description="Field width. Example: 20 for 20px")]
public virtual int? Width { get; set; }
///<summary>
///Data field of custom field. Valid values are: TextBox, ... Example: 'TextBox'
///</summary>
[ApiMember(Description="Data field of custom field. Valid values are: TextBox, ... Example: 'TextBox'")]
public virtual string DataType { get; set; }
///<summary>
///Default value of the field. Example: '3'
///</summary>
[ApiMember(Description="Default value of the field. Example: '3'")]
public virtual string DefaultValue { get; set; }
///<summary>
///Determines if the field is required to have a value or not
///</summary>
[ApiMember(Description="Determines if the field is required to have a value or not")]
public virtual bool IsMandatory { get; set; }
///<summary>
///Error message shown to the user if the field data is required but not entered
///</summary>
[ApiMember(Description="Error message shown to the user if the field data is required but not entered")]
public virtual string MandatoryErrorMessage { get; set; }
///<summary>
///Max lenght of the field
///</summary>
[ApiMember(Description="Max lenght of the field")]
public virtual int MaxLength { get; set; }
///<summary>
///If the field should have multiple lines
///</summary>
[ApiMember(Description="If the field should have multiple lines")]
public virtual bool MultipleLineText { get; set; }
///<summary>
///Regular expression used for validation of the field
///</summary>
[ApiMember(Description="Regular expression used for validation of the field")]
public virtual string RegEx { get; set; }
///<summary>
///Error message shown if the regular expression validation failed
///</summary>
[ApiMember(Description="Error message shown if the regular expression validation failed")]
public virtual string RegExErrorMessage { get; set; }
///<summary>
///The values to select from if Datatype is DropDown for this custom field
///</summary>
[ApiMember(Description="The values to select from if Datatype is DropDown for this custom field")]
public virtual List<CustomFieldValueResponse> Values { get; set; }
}
public partial class CustomFieldDataResponse
{
public virtual int Id { get; set; }
public virtual string Column { get; set; }
public virtual string Name { get; set; }
public virtual string Description { get; set; }
public virtual string Value { get; set; }
///<summary>
///Data field of custom field. Valid values are: TextBox, ... Example: 'TextBox'
///</summary>
[ApiMember(Description="Data field of custom field. Valid values are: TextBox, ... Example: 'TextBox'")]
public virtual string DataType { get; set; }
}
public partial class CustomFieldValueResponse
{
public virtual string Value { get; set; }
}
public partial class ExternalReferenceResponse
{
public virtual Guid CompanyId { get; set; }
public virtual Guid Id { get; set; }
public virtual Guid OwnerId { get; set; }
public virtual string ReferenceType { get; set; }
public virtual string ExternalData { get; set; }
public virtual string CreatedBy { get; set; }
public virtual DateTime Updated { get; set; }
public virtual DateTime Created { get; set; }
}
public partial class GroupBookingSettings
{
public virtual bool Active { get; set; }
public virtual int Min { get; set; }
public virtual int Max { get; set; }
}
public partial class MultipleResourceSettings
{
public virtual bool Active { get; set; }
public virtual int Min { get; set; }
public virtual int Max { get; set; }
}
public partial class ServiceInfoResponse
{
public virtual int Id { get; set; }
public virtual string Name { get; set; }
public virtual string Description { get; set; }
public virtual Uri ImageUrl { get; set; }
public virtual int? LengthInMinutes { get; set; }
public virtual int MaxNumberOfSpotsPerBooking { get; set; }
public virtual int MinNumberOfSpotsPerBooking { get; set; }
public virtual GroupBookingSettings GroupBooking { get; set; }
public virtual MultipleResourceSettings MultipleResource { get; set; }
public virtual bool IsGroupBooking { get; set; }
public virtual bool IsPaymentEnabled { get; set; }
}
}
namespace BokaMera.API.ServiceModel.Enums
{
public enum BookingStatusEnum
{
Booked = 1,
Unbooked = 2,
Reserved = 3,
Canceled = 4,
AwaitingPayment = 5,
AwaitingPaymentNoTimeLimit = 6,
Payed = 7,
AwaitingPaymentRequestFromAdmin = 8,
AwaitingPaymentFromProvider = 9,
Invoiced = 10,
}
public enum PaymentOptions
{
DefaultSetting,
BookWithoutPayment,
BookWithPaymentMessageToCustomer,
BookWithManualPayment,
}
}
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 /bookings/{Id}/approve HTTP/1.1
Host: api.bokamera.se
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length
{
CompanyId: 00000000-0000-0000-0000-000000000000,
Id: 0,
PaymentOption: DefaultSetting,
Comment: String,
Message: String,
SendSmsConfirmation: False,
SendEmailConfirmation: False
}
HTTP/1.1 200 OK
Content-Type: text/jsv
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
}