apidocs / com.srv4pos.server.api.activation / ActivationService / claim

claim

fun claim(country: String, corporateId: String, cashRegisterName: String, applicationPackage: String?, features: Set<Feature>, validFrom: Date?, validTo: Date?, contactInfo: ContactInfo?, comment: String?, controlUnitSerial: String?, controlUnitLocation: ControlUnitLocation?, controlUnitGeolocation: GeolocationInfo?, deviceId: String, buildInfo: Map<String, String>, programVersion: String?, applicationNameAndVersion: String?): ActivationSecurityInfo

If current application does not have Activation the app uses this method to request (order) new one. Seller and/or installation will be created, if it's needed.

Parameters

country - where seller is located

corporateId - of the seller

cashRegisterName - the name for the cash register

applicationPackage - identifies the application description

features - the features

validFrom - the start date for activation interval

validTo - the end date for activation interval

contactInfo - contact information, can be null

comment - the comment for the activation, can be null

controlUnitSerial - the control unit serial, can be null

controlUnitLocation - the control unit location, can be null

controlUnitGeolocation - the control unit geolocation, can be null

deviceId - id of device

buildInfo - information about android build

programVersion - application version

applicationNameAndVersion - application name and version

Exceptions

com.srv4pos.server.api.exceptions.ReferenceNotFoundJsonException - if application package or control unit are not found

com.srv4pos.server.api.exceptions.NonUniqueJsonException - if cash register name is not unique within a seller

com.srv4pos.server.api.exceptions.InconsistentDataJsonException - see: InconsistentDataErrorType.VALID_FROM_AND_VALID_TO_INCONSISTENCY, InconsistentDataErrorType.REGISTRATION_EXISTS_FOR_SELLER_AND_INSTALLATION

com.srv4pos.server.api.exceptions.UnprocessableEntityJsonException - see: UnprocessableEntityErrorType.CU_LOCATION_MUST_BE_SET

Return
ActivationSecurity - entity contains unique secure random identifier which represents activation ordered, production number and activation id.

fun claim(country: String, corporateId: String, cashRegisterName: String, applicationPackage: String, features: Set<Feature>, validFrom: Date, validTo: Date, contactInfo: ContactInfo?, comment: String?, deviceId: String, buildInfo: Map<String, String>, programVersion: String?, applicationNameAndVersion: String?): ActivationSecurityInfo

If current application does not have Activation, the app uses this method to request (order) new one. Seller and/or installation will be created, if it's needed.