BokaMera.API.Host

CreateLicense

**Requires Authentication**
Requires any of the roles:	bookingsupplier-administrator-write, superadmin

The following routes are available for this service:
POST	/licenses/company	Add new license to a company	Add a new license to the company for the logged in user.

**CreateLicense** 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.
TypeId	body	int?	Yes	Id of the license type
MetaData	body	string	Yes	Any metadata connected to the license. In example for domain license set the requested domain name here.
BillingInformation	body	BillingInformationResponse	Yes	If you want to update your company billing information. Note, if no billing information is added before, you need to set this.

**BillingInformationResponse** Parameters:
Name	Parameter	Data Type	Required	Description
CompanyId	form	Guid	No	The company id.
BillingMethodId	form	int	Yes	The prefered billing method.
Name	form	string	Yes	The name that should be printed on the billing information, normally this would be your company name.
FirstName	form	string	Yes	Billing person first name
LastName	form	string	Yes	Billing person last name
PhoneNumber	form	string	Yes	Billing person phone numbers
Attention	form	string	Yes	If you want to add the attention to the billing address.
Street1	form	string	Yes	The street for the billing adress. This is required when having postal invoice as billing method.
Street2	form	string	Yes	The street for the billing adress.
ZipCode	form	string	Yes	The zip code (postal code) for the billing adress. This is required when having postal invoice as billing method.
City	form	string	Yes	The city for the billing adress. This is required when having postal invoice as billing method.
CountryId	form	string	Yes	The country for the billing adress. This is required when having postal invoice as billing method.
Email	form	string	Yes	The billing email. This is required when having email invoice as billing method.
GLN	form	string	Yes	The company global location number.
ReferenceLine1	form	string	Yes	Your internal reference.
ReferenceLine2	form	string	Yes	Your internal reference.
PaymentTermsDays	form	int	No	The billing payment terms in days. This is default 15 days.
VatRegistrationNumber	form	string	Yes	The company vat registration number.
BillingMethodOptions	form	List<BillingMethod>	Yes	The billing method options to choose from

**BillingMethod** Parameters:
Name	Parameter	Data Type	Required
BillingMethodCountriesRelation	form	List<BillingMethodCountriesRelation>	Yes
Name	form	string	Yes
Description	form	string	Yes
ModifiedDate	form	DateTimeOffset?	No
Id	form	int	No

**BillingMethodCountriesRelation** Parameters:
Name	Parameter	Data Type	Required
BillingMethodId	form	int	Yes
CountryId	form	string	Yes
ModifiedDate	form	DateTimeOffset?	No

**CompanyLicenseQueryResponse** Parameters:
Name	Parameter	Data Type	Required
Id	form	int	No
TypeId	form	int	No
Type	form	LicenseTypeQueryResponse	Yes
ValidFrom	form	DateTime	No
ValidTo	form	DateTime	No
MetaData	form	string	Yes
Active	form	bool	No
Canceled	form	bool	No
Updated	form	DateTime	No
Created	form	DateTime	No

**LicenseTypeQueryResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Id	form	int	No	The license type id
Name	form	string	Yes	The license type name
Description	form	string	Yes	The license type description
IsExtraLicenseOption	form	bool	No	If the license type is not a standard license but instead an extra license option. An example would be sending newsletter license.
PeriodOfNoticeDays	form	int	No	The period of notice for the license in days.
Items	form	List<LicenseItemsResponse>	Yes	The license items for the license type
Prices	form	List<LicensePrice>	Yes	The license prices in each country for the license type

**LicenseItemsResponse** Parameters:
Name	Parameter	Data Type	Required
Id	form	int	No
Name	form	string	Yes
AllowedItems	form	int	No

**LicensePrice** Parameters:
Name	Parameter	Data Type	Required
Country	form	Country	Yes
MonthlyPayment	form	bool	No
LicenseTypeId	form	int	Yes
CountryId	form	string	Yes
Price	form	int	Yes
ModifiedDate	form	DateTimeOffset?	No

**Country** Parameters:
Name	Parameter	Data Type	Required
CurrencyId	form	string	Yes
CurrencyInfo	form	Currency	Yes
Name	form	string	Yes
Culture	form	string	No
TimeZone	form	string	No
ModifiedDate	form	DateTimeOffset?	No
Id	form	string	Yes

**Currency** Parameters:
Name	Parameter	Data Type	Required
Name	form	string	Yes
CurrencySign	form	string	Yes
Active	form	bool	Yes
ModifiedDate	form	DateTimeOffset?	No
Id	form	string	Yes

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

HTTP + JSV

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

POST /licenses/company HTTP/1.1 
Host: api.bokamera.se 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	CompanyId: 00000000-0000-0000-0000-000000000000,
	TypeId: 0,
	MetaData: String,
	BillingInformation: 
	{
		BillingMethodId: 0,
		Name: String,
		FirstName: String,
		LastName: String,
		PhoneNumber: String,
		Attention: String,
		Street1: String,
		Street2: String,
		ZipCode: String,
		City: String,
		CountryId: String,
		Email: String,
		GLN: String,
		ReferenceLine1: String,
		ReferenceLine2: String,
		PaymentTermsDays: 0,
		VatRegistrationNumber: String,
		BillingMethodOptions: 
		[
			{
				BillingMethodCountriesRelation: 
				[
					{
						BillingMethodId: 0,
						CountryId: String,
						ModifiedDate: 0001-01-01T00:00:00.0000000+00:00
					}
				],
				Name: String,
				Description: String,
				ModifiedDate: 0001-01-01T00:00:00.0000000+00:00,
				Id: 0
			}
		]
	}
}

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

{
	Id: 0,
	TypeId: 0,
	Type: 
	{
		Id: 0,
		Name: String,
		Description: String,
		IsExtraLicenseOption: False,
		PeriodOfNoticeDays: 0,
		Items: 
		[
			{
				Id: 0,
				Name: String,
				AllowedItems: 0
			}
		],
		Prices: 
		[
			{
				Country: 
				{
					CurrencyId: String,
					CurrencyInfo: 
					{
						Name: String,
						CurrencySign: String,
						Active: False,
						ModifiedDate: 0001-01-01T00:00:00.0000000+00:00,
						Id: String
					},
					Name: String,
					Culture: String,
					TimeZone: String,
					ModifiedDate: 0001-01-01T00:00:00.0000000+00:00,
					Id: String
				},
				MonthlyPayment: True,
				LicenseTypeId: 0,
				CountryId: String,
				Price: 0,
				ModifiedDate: 0001-01-01T00:00:00.0000000+00:00
			}
		]
	},
	MetaData: String,
	Active: False,
	Canceled: False
}