Adding customers

To add customers, use the AddPartner method. Customers are added one at a time.

Required Parameters

Parameter	Description	Supported values
partnerInfo	A group of parameters related to the partner	PartnerInfo, (has child parameters of its own see the PartnerInfo child parametersable below)
createDefaultAccount	The type of account to be created	bool Boolean True False

Parameter

Description

Supported values

partnerInfo

A group of parameters related to the partner

PartnerInfo, (has child parameters of its own see the PartnerInfo child parametersable below)

createDefaultAccount

The type of account to be created

bool Boolean

True
False

PartnerInfo child parameters

Parameter	Description	Supported values
ID	The ID of the Customer	<int> Integer
ParentId	The ID of the parent customer	<int> Integer
Name	The name to assign to the customer	OptionalNonEmptyString String
Level	The level of the customer in the hierarchy tree (must be lower than the level of the parent customer)	<PartnerPrivilege::Enum> Undefined Distributor SubDistributor Reseller EndCustomer
ChildServiceTypes	The type of service the customer company can provide to its own customers	<PartnerServiceType::FlagsType> Undefined AllInclusive SoftwareOnly
ServiceType	The type of service provided to the customer	<PartnerServiceType::Enum> Undefined AllInclusive SoftwareOnly
State	The current state of the customer	<PartnerState::Enum> Undefined InProduction InTrial
DeviceCountry	The country the device is in	<std::string>
LocationId	The location that the customer is assigned to (it is used to set a default storage pool for the customer's devices). Normally, the location is identified automatically by the country in which a customer is located (the Country parameter), but you can specify it yourself as well.	<int> Integer You can get the list of available locations using the EnumerateLocations method
Flags	Properties the customer has configured	<PartnerFlag::FlagsType> Undefined HasCustomBranding HasCustomUpdatePackages UnsubscribedFromTrialNotifications CanInvoiceOthers Count
Company	A group of parameters related to the company	PartnerCompanyInfo (has child parameters of its own see the PartnerCompanyInfo child parameters table below)
TrialRegistrationTime	The time stamp that the trial was registered for the Customer	<std::time_t> Integer in Unix format. For example, 1535673599 stands for August 30, 2018
TrialExpirationTime	The time stamp of when the trial will expire for the Customer	<std::time_t> Integer in Unix format. For example, 1535673599 stands for August 30, 2018
AdvancedPartnerProperties	Advanced information relating to the Partner	AdvancedPartnerPropertiesInfo (has child parameters of its own see the AdvancedPartnerPropertiesInfo child parameters table below)

PartnerCompanyInfo Child Parameters

Parameter	Description	Supported values
PostAddress	The postal address for the Customer's company	PostAddressInfo (has child parameters of its own see the PostAddress child parameters table below)
PhoneNumber	The phone number for the Customer's company	<std::String> String
FaxNumber	The fax number for the Customer's company	<std::String> String
WebsiteAddress	The website address in full for the Customer's company	<std::String> String
LegalCompanyName	The legal name of the Customer's company	<std::String> String
ChamberOfCommerceNumber	The chamber of commerce number for the Customer's company	<std::String> String
VatNumber	The VAT number for the Customer's company	<std::String> String
BankAccountNumber	The bank account number for the Customer's company	<std::String> String
BillingContactPersonId	The ID for the person to contatc with regards to billing for the Customer's company	<std::String> String

PostAddressInfo Child parameters

Parameter	Description	Supported values
Country	The country in which the customer is located. Based on the country, each customer is assigned to a location (see the LocationId parameter). Several neighboring countries may belong to the same location. The location is used to set a default storage pool for devices belonging to the customer.	<std::String> String Country code in ISO Alpha-2 format (recommended) or official country/area name in English. If the parameter is not submitted, the location of the parent customer is used.
State	The state in which the customer is located	<std::String> String
District	The district in which the customer is located	<std::String> String
City	The city in which the customer is located	<std::String> String
ZipCode	The ZipCode in which the customer is located	<std::String> String
Address	The street address at which the customer is located	<std::String> String

AdvancedPartnerPropertiesInfo Child Parameters

Parameter	Description	Supported values
RegionId	The ID number for the region the customer is in	<int> Integer
ResponsibleUserId	The ID for the responsible use	<int> Integer

Sample request

{
    "id": "jsonrpc",
    "visa": "{{visa}}",
    "method": "AddPartner",
    "jsonrpc": "2.0",
    "params": {
	"partnerInfo": {
	    "ParentId": 12345,
	    "Name": "Zeus & Sons",
	    "Level": "EndCustomer",
	    "ServiceType": "AllInclusive",
	    "ChildServiceTypes": [
		"AllInclusive"
	    ],
	    "Country": "Greece"
	    }
    }
}

Sample response

{
    "id": "jsonrpc",
    "jsonrpc": "2.0",
    "result": {
	"result": 55806
    },
    "visa": "{{visa}}"
}