BokaMera.API.Host

<back to all web services

CreateLicense

Requires Authentication
Requires any of the roles:bookingsupplier-administrator-write, superadmin
The following routes are available for this service:
POST/licenses/companyAdd new license to a companyAdd 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
}

Kotlin CreateLicense DTOs

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 /licenses/company HTTP/1.1 
Host: api.bokamera.se 
Accept: text/jsonl
Content-Type: text/jsonl
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/jsonl
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}