| Requires any of the roles: | bookingsupplier-administrator-write, superadmin |
| POST | /licenses/company | Add new license to a company | Add a new license to the company for the logged in user. |
|---|
import java.math.*
import java.util.*
import java.io.InputStream
import net.servicestack.client.*
@ApiResponse(Description="You were unauthorized to call this service", StatusCode=401)
@ValidateRequest(Validator="IsAuthenticated")
open class CreateLicense : ICompany
{
/**
* The company id, if empty will use the company id for the user you are logged in with.
*/
@ApiMember(Description="The company id, if empty will use the company id for the user you are logged in with.")
override var CompanyId:UUID? = null
/**
* Id of the license type
*/
@ApiMember(Description="Id of the license type", IsRequired=true)
open var TypeId:Int? = null
/**
* Any metadata connected to the license. In example for domain license set the requested domain name here.
*/
@ApiMember(Description="Any metadata connected to the license. In example for domain license set the requested domain name here.", IsRequired=true)
open var MetaData:String? = null
/**
* If you want to update your company billing information. Note, if no billing information is added before, you need to set this.
*/
@ApiMember(Description="If you want to update your company billing information. Note, if no billing information is added before, you need to set this.")
open var BillingInformation:BillingInformationResponse? = null
}
open class BillingInformationResponse
{
/**
* The company id.
*/
@ApiMember(Description="The company id.")
open var CompanyId:UUID? = null
/**
* The prefered billing method.
*/
@ApiMember(Description="The prefered billing method.", IsRequired=true)
open var BillingMethodId:Int? = null
/**
* The name that should be printed on the billing information, normally this would be your company name.
*/
@ApiMember(Description="The name that should be printed on the billing information, normally this would be your company name.")
open var Name:String? = null
/**
* If you want to add the attention to the billing address.
*/
@ApiMember(Description="If you want to add the attention to the billing address.")
open var Attention:String? = null
/**
* The street for the billing adress. This is required when having postal invoice as billing method.
*/
@ApiMember(Description="The street for the billing adress. This is required when having postal invoice as billing method.")
open var Street1:String? = null
/**
* The street for the billing adress.
*/
@ApiMember(Description="The street for the billing adress.")
open var Street2:String? = null
/**
* The zip code (postal code) for the billing adress. This is required when having postal invoice as billing method.
*/
@ApiMember(Description="The zip code (postal code) for the billing adress. This is required when having postal invoice as billing method.")
open var ZipCode:String? = null
/**
* The city for the billing adress. This is required when having postal invoice as billing method.
*/
@ApiMember(Description="The city for the billing adress. This is required when having postal invoice as billing method.")
open var City:String? = null
/**
* The country for the billing adress. This is required when having postal invoice as billing method.
*/
@ApiMember(Description="The country for the billing adress. This is required when having postal invoice as billing method.")
open var CountryId:String? = null
/**
* The billing email. This is required when having email invoice as billing method.
*/
@ApiMember(Description="The billing email. This is required when having email invoice as billing method.")
open var Email:String? = null
/**
* The company global location number.
*/
@ApiMember(Description="The company global location number.")
open var GLN:String? = null
/**
* Your internal reference.
*/
@ApiMember(Description="Your internal reference.")
open var ReferenceLine1:String? = null
/**
* Your internal reference.
*/
@ApiMember(Description="Your internal reference.")
open var ReferenceLine2:String? = null
/**
* The billing payment terms in days. This is default 15 days.
*/
@ApiMember(Description="The billing payment terms in days. This is default 15 days.")
open var PaymentTermsDays:Int? = null
/**
* The company vat registration number.
*/
@ApiMember(Description="The company vat registration number.")
open var VatRegistrationNumber:String? = null
/**
* The billing method options to choose from
*/
@ApiMember(Description="The billing method options to choose from")
open var BillingMethodOptions:ArrayList<BillingMethod>? = null
}
open class BillingMethod : BaseModel()
{
open var BillingMethodCountriesRelation:ArrayList<BillingMethodCountriesRelation>? = null
@Required()
open var Name:String? = null
@Required()
open var Description:String? = null
open var ModifiedDate:Date? = null
open var Id:Int? = null
}
open class BaseModel
{
}
open class BillingMethodCountriesRelation : BaseModel()
{
@Required()
open var BillingMethodId:Int? = null
@Required()
open var CountryId:String? = null
open var ModifiedDate:Date? = null
}
open class CompanyLicenseQueryResponse
{
open var Id:Int? = null
open var TypeId:Int? = null
open var Type:LicenseTypeQueryResponse? = null
open var ValidFrom:Date? = null
open var ValidTo:Date? = null
open var MetaData:String? = null
open var Active:Boolean? = null
open var Canceled:Boolean? = null
open var Updated:Date? = null
open var Created:Date? = null
}
open class LicenseTypeQueryResponse
{
/**
* The license type id
*/
@ApiMember(Description="The license type id")
open var Id:Int? = null
/**
* The license type name
*/
@ApiMember(Description="The license type name")
open var Name:String? = null
/**
* The license type description
*/
@ApiMember(Description="The license type description")
open var Description:String? = null
/**
* If the license type is not a standard license but instead an extra license option. An example would be sending newsletter license.
*/
@ApiMember(Description="If the license type is not a standard license but instead an extra license option. An example would be sending newsletter license.")
open var IsExtraLicenseOption:Boolean? = null
/**
* The period of notice for the license in days.
*/
@ApiMember(Description="The period of notice for the license in days.")
open var PeriodOfNoticeDays:Int? = null
/**
* The license items for the license type
*/
@ApiMember(Description="The license items for the license type")
open var Items:ArrayList<LicenseItemsResponse>? = null
/**
* The license prices in each country for the license type
*/
@ApiMember(Description="The license prices in each country for the license type")
open var Prices:ArrayList<LicensePrice>? = null
}
open class LicenseItemsResponse
{
open var Id:Int? = null
open var Name:String? = null
open var AllowedItems:Int? = null
}
open class LicensePrice : BaseModel()
{
@Ignore()
open var Country:Country? = null
@Ignore()
open var MonthlyPayment:Boolean? = null
@Required()
open var LicenseTypeId:Int? = null
@Required()
open var CountryId:String? = null
@Required()
open var Price:Int? = null
open var ModifiedDate:Date? = null
}
open class Country : BaseModel()
{
@References(Type=Currency::class)
open var CurrencyId:String? = null
open var CurrencyInfo:Currency? = null
@Required()
open var Name:String? = null
open var Culture:String? = null
open var TimeZone:String? = null
open var ModifiedDate:Date? = null
@Required()
open var Id:String? = null
}
open class Currency : BaseModel()
{
@Required()
open var Name:String? = null
@Required()
open var CurrencySign:String? = null
@Required()
open var Active:Boolean? = null
open var ModifiedDate:Date? = null
@Required()
open var Id:String? = null
}
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.
POST /licenses/company HTTP/1.1
Host: api.bookmore.com
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,
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
}