Download OpenAPI specification:Download
This is the OpenAPI description for accessing the plenigo platform. All API calls are by default synchronous. Asynchronous calls are marked.
Search all access rights that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "startingAfterId": "100002",
- "items": [
- {
- "customerId": "100003",
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "items": [
- {
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "lifeTimeStart": "2019-01-01T07:53:23.450961Z",
- "lifeTimeEnd": "2020-01-01T07:53:23.450961Z",
- "accessTimeStart": "06:00:00",
- "accessTimeEnd": "18:00:00",
- "maxCacheDate": "2020-01-01T07:53:23.450961Z",
- "data": [
- {
- "key": "value"
}
], - "blocked": false,
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_TTA1E7173120881552",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_TTA1E7173120881553",
- "accessRightUniqueId": "UNIQUE-ID",
- "accessRightData": {
- "key": "value"
}, - "itemType": "SUBSCRIPTION_ITEM",
- "itemId": "7212"
}
]
}
]
}
Get all access rights for a customer identified by the passed customer id.
customerId required | string unique id of the customer |
{- "customerId": "100003",
- "customerBlocked": false,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "items": [
- {
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "lifeTimeStart": "2019-01-01T07:53:23.450961Z",
- "lifeTimeEnd": "2020-01-01T07:53:23.450961Z",
- "accessTimeStart": "06:00:00",
- "accessTimeEnd": "18:00:00",
- "maxCacheDate": "2020-01-01T07:53:23.450961Z",
- "data": [
- {
- "key": "value"
}
], - "blocked": false,
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_TTA1E7173120881552",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_TTA1E7173120881553",
- "accessRightUniqueId": "UNIQUE-ID",
- "accessRightData": {
- "key": "value"
}, - "itemType": "SUBSCRIPTION_ITEM",
- "itemId": "7212"
}
]
}
Create a new access right item with the data provided for a customer identified by the passed customer id.
customerId required | string unique id of the customer |
lifeTimeStart | string or null <date-time> date the access right will start with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
lifeTimeEnd | string or null <date-time> date the access right will end with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
accessTimeStart | string or null <date-time> time the access right will start with time notation as defined by RFC 3339, section 5.6, for example, 17:32:28 |
accessTimeEnd | string or null <date-time> time the access right will end with time notation as defined by RFC 3339, section 5.6, for example, 17:32:28 |
maxCacheDate | string or null <date-time> max cache date with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
Array of objects | |
blocked | boolean flag indicating if access is blocked |
{- "lifeTimeStart": "2019-01-01T07:53:23.450961Z",
- "lifeTimeEnd": "2020-01-01T07:53:23.450961Z",
- "accessTimeStart": "06:00:00",
- "accessTimeEnd": "18:00:00",
- "maxCacheDate": "2020-01-01T07:53:23.450961Z",
- "data": [
- {
- "key": "value"
}
], - "blocked": false
}
{- "customerId": "100003",
- "customerBlocked": false,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "items": [
- {
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "lifeTimeStart": "2019-01-01T07:53:23.450961Z",
- "lifeTimeEnd": "2020-01-01T07:53:23.450961Z",
- "accessTimeStart": "06:00:00",
- "accessTimeEnd": "18:00:00",
- "maxCacheDate": "2020-01-01T07:53:23.450961Z",
- "data": [
- {
- "key": "value"
}
], - "blocked": false,
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_TTA1E7173120881552",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_TTA1E7173120881553",
- "accessRightUniqueId": "UNIQUE-ID",
- "accessRightData": {
- "key": "value"
}, - "itemType": "SUBSCRIPTION_ITEM",
- "itemId": "7212"
}
]
}
Updates an access right item with the data provided for a customer identified by the passed customer id.
customerId required | string unique id of the customer |
accessRightUniqueId required | string id of the access right item |
lifeTimeStart | string or null <date-time> date the access right will start with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
lifeTimeEnd | string or null <date-time> date the access right will end with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
accessTimeStart | string or null <date-time> time the access right will start with time notation as defined by RFC 3339, section 5.6, for example, 17:32:28 |
accessTimeEnd | string or null <date-time> time the access right will end with time notation as defined by RFC 3339, section 5.6, for example, 17:32:28 |
maxCacheDate | string or null <date-time> max cache date with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
Array of objects | |
blocked | boolean flag indicating if access is blocked |
{- "lifeTimeStart": "2019-01-01T07:53:23.450961Z",
- "lifeTimeEnd": "2020-01-01T07:53:23.450961Z",
- "accessTimeStart": "06:00:00",
- "accessTimeEnd": "18:00:00",
- "maxCacheDate": "2020-01-01T07:53:23.450961Z",
- "data": [
- {
- "key": "value"
}
], - "blocked": false
}
{- "customerId": "100003",
- "customerBlocked": false,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "items": [
- {
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "lifeTimeStart": "2019-01-01T07:53:23.450961Z",
- "lifeTimeEnd": "2020-01-01T07:53:23.450961Z",
- "accessTimeStart": "06:00:00",
- "accessTimeEnd": "18:00:00",
- "maxCacheDate": "2020-01-01T07:53:23.450961Z",
- "data": [
- {
- "key": "value"
}
], - "blocked": false,
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_TTA1E7173120881552",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_TTA1E7173120881553",
- "accessRightUniqueId": "UNIQUE-ID",
- "accessRightData": {
- "key": "value"
}, - "itemType": "SUBSCRIPTION_ITEM",
- "itemId": "7212"
}
]
}
Delete an access right item for a customer identified by the passed customer id.
customerId required | string unique id of the customer |
accessRightUniqueId required | string id of the access right item |
{- "success": true
}
Block an access right item of type EXTERNAL or SINGLE_PRODUCT for a customer.
customerId required | string unique id of the customer |
accessRightUniqueId required | string id of the access right item |
itemId required | string item id of an access right item |
{- "success": true
}
Unblock an access right item of type EXTERNAL or SINGLE_PRODUCT for a customer.
customerId required | string unique id of the customer |
accessRightUniqueId required | string id of the access right item |
itemId required | string item id of an access right item |
{- "success": true
}
Check if customer has a valid access right for one or multiple access rights identified by the provided access right unique ids.
customerId required | string unique id of the customer |
accessRightUniqueIds required | string comma separated ids of access right unique ids |
{- "customerId": "100003",
- "customerBlocked": false,
- "accessGranted": true,
- "items": [
- {
- "accessGranted": true,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "lifeTimeStart": "2019-01-01T07:53:23.450961Z",
- "lifeTimeEnd": "2020-01-01T07:53:23.450961Z",
- "accessTimeStart": "06:00:00",
- "accessTimeEnd": "18:00:00",
- "maxCacheDate": "2020-01-01T07:53:23.450961Z",
- "data": [
- {
- "key": "value"
}
], - "blocked": false,
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_TTA1E7173120881552",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_TTA1E7173120881553",
- "accessRightUniqueId": "UNIQUE-ID",
- "accessRightData": {
- "key": "value"
}, - "itemType": "SUBSCRIPTION_ITEM",
- "itemId": "7212"
}
]
}
Search all accounting forms that correspond to the given search conditions.
customerId required | string unique id of the customer |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
jsonObjectType | string Enum: "ACCESS_RIGHT_ITEM" "AMAZON_PAY" "BANK_ACCOUNT" "CREDIT_CARD" "CUSTOMER" "DELIVERY_ADDRESS" "INVOICE" "INVOICE_ADDRESS" "ORDER" "PAYPAL" "SUBSCRIPTION" The type the activity belongs to. |
jsonObjectIdentifier | string <= 100 characters The identifier of the object the activity belongs to. Can only be used in combination with jsonObjectType |
{- "items": [
- {
- "id": 100001,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2020-01-13",
- "changedBy": "P_UZV4L63ZBT",
- "changedByType": "MERCHANT",
- "customerId": "12701",
- "activityType": "SYSTEM_API",
- "jsonObjectType": "INVOICE_ADDRESS",
- "jsonObjectIdentifier": "100001",
- "oldObject": [
- {
- "addressId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "type": "INVOICE",
- "preferred": true,
- "customerId": "100003",
- "businessAddress": true,
- "salutation": "MR",
- "title": "",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
], - "newObject": [
- {
- "addressId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "type": "INVOICE",
- "preferred": true,
- "customerId": "100003",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
], - "reason": "DATA_CHANGED"
}
]
}
Search all addresses that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "addressId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "type": "INVOICE",
- "preferred": true,
- "customerId": "100003",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
]
}
Create a new address with the data provided.
overrideValidation | boolean flag if the validation should be ignored |
type required | string Enum: "INVOICE" "DELIVERY" address type |
customerId required | string^[0-9]{1,18}$ unique id of the customer the address belongs to |
preferred | boolean flag indicating if address is default selection for address type |
businessAddress | boolean flag indicating if address represents a private or a business address |
salutation | string Enum: "DIVERSE" "MR" "MRS" "NONE" salutation to identify the correct designation of a customer |
title | string <= 100 characters title of the customer |
firstName | string <= 100 characters first name of the customer - first name and last name or company name are required |
lastName | string <= 100 characters last name of the customer - first name and last name or company name are required |
companyName | string <= 100 characters company name - first name and last name or company name are required |
additionalCompanyInfo | string <= 100 characters additional information belonging to the company |
street | string <= 100 characters street name |
streetNumber | string <= 100 characters street number |
additionalStreetInfo | string <= 100 characters additional information describing address |
postbox | string <= 100 characters postbox id |
postcode | string <= 100 characters postcode |
city | string <= 100 characters city |
state | string <= 2 characters state |
country | string = 2 characters country code formatted as ISO 3166-1 alpha-2 |
vatNumber | string <= 20 characters VAT number of a member country of the European Union |
phoneNumber | string <= 100 characters ^\+?[1-9]\d{1,14}$ phone number of the customer formatted as E.164 |
deliveryInformation | string <= 100 characters delivery information |
academicTitle | string <= 100 characters academic title |
jobPosition | string <= 100 characters job position |
validationStatus | string Enum: "NONE" "VALID" "INVALID" "SUSPECT" "OVERRIDDEN" validation status of the address |
validationHash | string validation hash of a valid address |
{- "type": "INVOICE",
- "preferred": true,
- "customerId": "100003",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
{- "addressId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "type": "INVOICE",
- "preferred": true,
- "customerId": "100003",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
Get address that is identified by the passed address id.
addressId required | integer <int64> unique id of the address |
{- "addressId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "type": "INVOICE",
- "preferred": true,
- "customerId": "100003",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
Update an address that is identified by the passed address id with the data provided. If fields were filled before and are now passed empty these fields will be cleared.
addressId required | integer <int64> unique id of the address |
overrideValidation | boolean flag if the validation should be ignored |
preferred | boolean flag indicating if address is default selection for address type |
businessAddress | boolean flag indicating if address represents a private or a business address |
salutation | string Enum: "DIVERSE" "MR" "MRS" "NONE" salutation to identify the correct designation of a customer |
title | string <= 100 characters title of the customer |
firstName | string <= 100 characters first name of the customer - first name and last name or company name are required |
lastName | string <= 100 characters last name of the customer - first name and last name or company name are required |
companyName | string <= 100 characters company name - first name and last name or company name are required |
additionalCompanyInfo | string <= 100 characters additional information belonging to the company |
street | string <= 100 characters street name |
streetNumber | string <= 100 characters street number |
additionalStreetInfo | string <= 100 characters additional information describing address |
postbox | string <= 100 characters postbox id |
postcode | string <= 100 characters postcode |
city | string <= 100 characters city |
state | string <= 2 characters state |
country | string = 2 characters country code formatted as ISO 3166-1 alpha-2 |
vatNumber | string <= 20 characters VAT number of a member country of the European Union |
phoneNumber | string <= 100 characters ^\+?[1-9]\d{1,14}$ phone number of the customer formatted as E.164 |
deliveryInformation | string <= 100 characters delivery information |
academicTitle | string <= 100 characters academic title |
jobPosition | string <= 100 characters job position |
validationStatus | string Enum: "NONE" "VALID" "INVALID" "SUSPECT" "OVERRIDDEN" validation status of the address |
validationHash | string validation hash of a valid address |
{- "preferred": true,
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
{- "addressId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "type": "INVOICE",
- "preferred": true,
- "customerId": "100003",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
Delete an address that is identified by the passed address id. Only addresses that are not associated with a subscription can be deleted. If such an address shall be deleted it must first be disconnected from the subscription.
addressId required | integer <int64> unique id of the address |
{- "success": true
}
Get all future addresses that correspond to the given address id.
addressId required | integer <int64> unique id of the address |
{- "items": [
- {
- "activationDate": "2019-03-21",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}, - {
- "activationDate": "2019-06-21",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "32",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
]
}
Create a new future address with the data provided. An address can only have two future addresses
addressId required | integer <int64> unique id of the address |
date required | string <date> date of the future address |
overrideValidation | boolean flag if the validation should be ignored |
businessAddress | boolean flag indicating if address represents a private or a business address |
salutation | string Enum: "DIVERSE" "MR" "MRS" "NONE" salutation to identify the correct designation of a customer |
title | string <= 100 characters title of the customer |
firstName | string <= 100 characters first name of the customer - first name and last name or company name are required |
lastName | string <= 100 characters last name of the customer - first name and last name or company name are required |
companyName | string <= 100 characters company name - first name and last name or company name are required |
additionalCompanyInfo | string <= 100 characters additional information belonging to the company |
street | string <= 100 characters street name |
streetNumber | string <= 100 characters street number |
additionalStreetInfo | string <= 100 characters additional information describing address |
postbox | string <= 100 characters postbox id |
postcode | string <= 100 characters postcode |
city | string <= 100 characters city |
state | string <= 2 characters state |
country | string = 2 characters country code formatted as ISO 3166-1 alpha-2 |
vatNumber | string <= 20 characters VAT number of a member country of the European Union |
phoneNumber | string <= 100 characters ^\+?[1-9]\d{1,14}$ phone number of the customer formatted as E.164 |
deliveryInformation | string <= 100 characters delivery information |
academicTitle | string <= 100 characters academic title |
jobPosition | string <= 100 characters job position |
validationStatus | string Enum: "NONE" "VALID" "INVALID" "SUSPECT" "OVERRIDDEN" validation status of the address |
validationHash | string validation hash of a valid address |
{- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
{- "activationDate": "2019-03-21",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
Update a future address that is identified by the passed date with the data provided. If fields were filled before and are now passed empty these fields will be cleared.
addressId required | integer <int64> unique id of the address |
date required | string <date> date of the future address |
overrideValidation | boolean flag if the validation should be ignored |
businessAddress | boolean flag indicating if address represents a private or a business address |
salutation | string Enum: "DIVERSE" "MR" "MRS" "NONE" salutation to identify the correct designation of a customer |
title | string <= 100 characters title of the customer |
firstName | string <= 100 characters first name of the customer - first name and last name or company name are required |
lastName | string <= 100 characters last name of the customer - first name and last name or company name are required |
companyName | string <= 100 characters company name - first name and last name or company name are required |
additionalCompanyInfo | string <= 100 characters additional information belonging to the company |
street | string <= 100 characters street name |
streetNumber | string <= 100 characters street number |
additionalStreetInfo | string <= 100 characters additional information describing address |
postbox | string <= 100 characters postbox id |
postcode | string <= 100 characters postcode |
city | string <= 100 characters city |
state | string <= 2 characters state |
country | string = 2 characters country code formatted as ISO 3166-1 alpha-2 |
vatNumber | string <= 20 characters VAT number of a member country of the European Union |
phoneNumber | string <= 100 characters ^\+?[1-9]\d{1,14}$ phone number of the customer formatted as E.164 |
deliveryInformation | string <= 100 characters delivery information |
academicTitle | string <= 100 characters academic title |
jobPosition | string <= 100 characters job position |
validationStatus | string Enum: "NONE" "VALID" "INVALID" "SUSPECT" "OVERRIDDEN" validation status of the address |
validationHash | string validation hash of a valid address |
{- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
{- "activationDate": "2019-03-21",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
Delete a future address that is identified by the passed date.
addressId required | integer <int64> unique id of the address |
date required | string <date> date of the future address |
{- "success": true
}
Important note: The use of these API endpoints is a chargeable service provided by plenigo GmbH. The billing is done according to the current price list, which you can find in the settings section of your plenigo account. The billing is done with the monthly invoice.
Validates the address with the given id.
addressId required | integer <int64> unique id of the address |
{- "addressId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "type": "INVOICE",
- "preferred": true,
- "customerId": "100003",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
Create a new wbz address with the data provided.
overrideValidation | boolean flag if the validation should be ignored |
customerId required | string^[0-9]{1,18}$ unique id of the customer the address belongs to |
businessAddress | boolean flag indicating if address represents a private or a business address |
salutation | string Enum: "DIVERSE" "MR" "MRS" "NONE" salutation to identify the correct designation of a customer |
title | string <= 100 characters title of the customer |
firstName | string <= 100 characters first name of the customer - first name and last name or company name are required |
lastName | string <= 100 characters last name of the customer - first name and last name or company name are required |
companyName | string <= 100 characters company name - first name and last name or company name are required |
additionalCompanyInfo | string <= 100 characters additional information belonging to the company |
street | string <= 100 characters street name |
streetNumber | string <= 100 characters street number |
additionalStreetInfo | string <= 100 characters additional information describing address |
postbox | string <= 100 characters postbox id |
postcode | string <= 100 characters postcode |
city | string <= 100 characters city |
state | string <= 2 characters state |
country | string = 2 characters country code formatted as ISO 3166-1 alpha-2 |
vatNumber | string <= 20 characters VAT number of a member country of the European Union |
phoneNumber | string <= 100 characters ^\+?[1-9]\d{1,14}$ phone number of the customer formatted as E.164 |
deliveryInformation | string <= 100 characters delivery information |
academicTitle | string <= 100 characters academic title |
jobPosition | string <= 100 characters job position |
validationStatus | string Enum: "NONE" "VALID" "INVALID" "SUSPECT" "OVERRIDDEN" validation status of the address |
validationHash | string validation hash of a valid address |
{- "type": "INVOICE",
- "preferred": true,
- "customerId": "100003",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
{- "addressId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "type": "INVOICE",
- "preferred": true,
- "customerId": "100003",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
Important note: The use of these API endpoints is a chargeable service provided by plenigo GmbH. The billing is done according to the current price list, which you can find in the settings section of your plenigo account. The billing is done with the monthly invoice. Validates the address with the data provided.
type required | string Enum: "INVOICE" "DELIVERY" address type |
customerId required | string^[0-9]{1,18}$ unique id of the customer the address belongs to |
preferred | boolean flag indicating if address is default selection for address type |
businessAddress | boolean flag indicating if address represents a private or a business address |
salutation | string Enum: "DIVERSE" "MR" "MRS" "NONE" salutation to identify the correct designation of a customer |
title | string <= 100 characters title of the customer |
firstName | string <= 100 characters first name of the customer - first name and last name or company name are required |
lastName | string <= 100 characters last name of the customer - first name and last name or company name are required |
companyName | string <= 100 characters company name - first name and last name or company name are required |
additionalCompanyInfo | string <= 100 characters additional information belonging to the company |
street | string <= 100 characters street name |
streetNumber | string <= 100 characters street number |
additionalStreetInfo | string <= 100 characters additional information describing address |
postbox | string <= 100 characters postbox id |
postcode | string <= 100 characters postcode |
city | string <= 100 characters city |
state | string <= 2 characters state |
country | string = 2 characters country code formatted as ISO 3166-1 alpha-2 |
vatNumber | string <= 20 characters VAT number of a member country of the European Union |
phoneNumber | string <= 100 characters ^\+?[1-9]\d{1,14}$ phone number of the customer formatted as E.164 |
deliveryInformation | string <= 100 characters delivery information |
academicTitle | string <= 100 characters academic title |
jobPosition | string <= 100 characters job position |
validationStatus | string Enum: "NONE" "VALID" "INVALID" "SUSPECT" "OVERRIDDEN" validation status of the address |
validationHash | string validation hash of a valid address |
{- "type": "INVOICE",
- "preferred": true,
- "customerId": "100003",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
{- "addressId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "type": "INVOICE",
- "preferred": true,
- "customerId": "100003",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
Search all corporate accounts that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
corporateAccountId | integer <int64> unique id of the corporate account |
{- "items": [
- {
- "corporateAccountId": 9310,
- "customerId": "100003",
- "title": "A new offer",
- "plenigoOfferId": "O_123456789123456789",
- "usersAmount": 5,
- "users": [
- {
- "corporateAccountUserId": 9401,
- "email": "wildflower@example.com",
- "salutation": "MR",
- "firstName": "John",
- "lastName": "Doe",
- "status": "ACTIVE",
- "customerId": "100006",
- "corporateAccountCode": "123456789123"
}
], - "accessRightItems": [
- {
- "lifeTimeStart": "2019-01-01T07:53:23.450961Z",
- "lifeTimeEnd": "2020-01-01T07:53:23.450961Z",
- "accessTimeStart": "06:00:00",
- "accessTimeEnd": "18:00:00",
- "maxCacheDate": "2020-01-01T07:53:23.450961Z",
- "data": [
- {
- "key": "value"
}
], - "blocked": false,
- "accessRightItemId": "P_TTA1E7173120881551",
- "internAccessRightItemId": "P_TTA1E7173120881551",
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_TTA1E7173120881552",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_TTA1E7173120881553",
- "accessRightUniqueId": "UNIQUE-ID",
- "itemType": "SUBSCRIPTION_ITEM",
- "itemId": "7212"
}
]
}
]
}
Search all corporate accounts of the customer that correspond to the given search conditions.
customerId required | string unique id of the customer |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
{- "items": [
- {
- "corporateAccountId": 9310,
- "customerId": "100003",
- "title": "A new offer",
- "plenigoOfferId": "O_123456789123456789",
- "usersAmount": 5,
- "users": [
- {
- "corporateAccountUserId": 9401,
- "email": "wildflower@example.com",
- "salutation": "MR",
- "firstName": "John",
- "lastName": "Doe",
- "status": "ACTIVE",
- "customerId": "100006",
- "corporateAccountCode": "123456789123"
}
], - "accessRightItems": [
- {
- "lifeTimeStart": "2019-01-01T07:53:23.450961Z",
- "lifeTimeEnd": "2020-01-01T07:53:23.450961Z",
- "accessTimeStart": "06:00:00",
- "accessTimeEnd": "18:00:00",
- "maxCacheDate": "2020-01-01T07:53:23.450961Z",
- "data": [
- {
- "key": "value"
}
], - "blocked": false,
- "accessRightItemId": "P_TTA1E7173120881551",
- "internAccessRightItemId": "P_TTA1E7173120881551",
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_TTA1E7173120881552",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_TTA1E7173120881553",
- "accessRightUniqueId": "UNIQUE-ID",
- "itemType": "SUBSCRIPTION_ITEM",
- "itemId": "7212"
}
]
}
]
}
Get the corporate account of the customer.
customerId required | string unique id of the customer |
corporateAccountId required | integer <int64> unique id of the corporate account |
{- "corporateAccountId": 9310,
- "customerId": "100003",
- "title": "A new offer",
- "plenigoOfferId": "O_123456789123456789",
- "usersAmount": 5,
- "users": [
- {
- "corporateAccountUserId": 9401,
- "email": "wildflower@example.com",
- "salutation": "MR",
- "firstName": "John",
- "lastName": "Doe",
- "status": "INVITED",
- "corporateAccountCode": "1234567891234567"
}
], - "accessRightItems": [
- {
- "lifeTimeStart": "2019-01-01T07:53:23.450961Z",
- "lifeTimeEnd": "2020-01-01T07:53:23.450961Z",
- "accessTimeStart": "06:00:00",
- "accessTimeEnd": "18:00:00",
- "maxCacheDate": "2020-01-01T07:53:23.450961Z",
- "data": [
- {
- "key": "value"
}
], - "blocked": false,
- "accessRightItemId": "P_TTA1E7173120881551",
- "internAccessRightItemId": "P_TTA1E7173120881551",
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_TTA1E7173120881552",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_TTA1E7173120881553",
- "accessRightUniqueId": "UNIQUE-ID",
- "itemType": "SUBSCRIPTION_ITEM",
- "itemId": "7212"
}
]
}
Create a corporate account user for the given corporate account.
customerId required | string unique id of the customer |
corporateAccountId required | integer <int64> unique id of the corporate account |
sendMail | boolean flag indicating if an email should be send |
email required | string <email> <= 100 characters email address of the customer that should belong to this corporate account user |
salutation required | string Enum: "DIVERSE" "MR" "MRS" "NONE" salutation to identify the correct designation of a customer |
firstName required | string <= 100 characters first name of the customer - first name and last name or company name are required |
lastName required | string <= 100 characters last name of the customer - first name and last name or company name are required |
{- "email": "wildflower@example.com",
- "salutation": "MR",
- "firstName": "John",
- "lastName": "Doe"
}
{- "corporateAccountId": 9310,
- "customerId": "100003",
- "title": "A new offer",
- "plenigoOfferId": "O_123456789123456789",
- "usersAmount": 5,
- "users": [
- {
- "corporateAccountUserId": 9401,
- "email": "wildflower@example.com",
- "salutation": "MR",
- "firstName": "John",
- "lastName": "Doe",
- "status": "INVITED",
- "corporateAccountCode": "1234567891234567"
}
], - "accessRightItems": [
- {
- "lifeTimeStart": "2019-01-01T07:53:23.450961Z",
- "lifeTimeEnd": "2020-01-01T07:53:23.450961Z",
- "accessTimeStart": "06:00:00",
- "accessTimeEnd": "18:00:00",
- "maxCacheDate": "2020-01-01T07:53:23.450961Z",
- "data": [
- {
- "key": "value"
}
], - "blocked": false,
- "accessRightItemId": "P_TTA1E7173120881551",
- "internAccessRightItemId": "P_TTA1E7173120881551",
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_TTA1E7173120881552",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_TTA1E7173120881553",
- "accessRightUniqueId": "UNIQUE-ID",
- "itemType": "SUBSCRIPTION_ITEM",
- "itemId": "7212"
}
]
}
Delete a corporate account user for the given corporate account.
customerId required | string unique id of the customer |
corporateAccountId required | integer <int64> unique id of the corporate account |
corporateAccountUserId required | integer <int64> unique id of the corporate account user |
{- "corporateAccountId": 9310,
- "customerId": "100003",
- "title": "A new offer",
- "plenigoOfferId": "O_123456789123456789",
- "usersAmount": 5,
- "users": [
- {
- "corporateAccountUserId": 9401,
- "email": "wildflower@example.com",
- "salutation": "MR",
- "firstName": "John",
- "lastName": "Doe",
- "status": "INVITED",
- "corporateAccountCode": "1234567891234567"
}
], - "accessRightItems": [
- {
- "lifeTimeStart": "2019-01-01T07:53:23.450961Z",
- "lifeTimeEnd": "2020-01-01T07:53:23.450961Z",
- "accessTimeStart": "06:00:00",
- "accessTimeEnd": "18:00:00",
- "maxCacheDate": "2020-01-01T07:53:23.450961Z",
- "data": [
- {
- "key": "value"
}
], - "blocked": false,
- "accessRightItemId": "P_TTA1E7173120881551",
- "internAccessRightItemId": "P_TTA1E7173120881551",
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_TTA1E7173120881552",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_TTA1E7173120881553",
- "accessRightUniqueId": "UNIQUE-ID",
- "itemType": "SUBSCRIPTION_ITEM",
- "itemId": "7212"
}
]
}
Resend a corporate account user invitation email for the given corporate account.
customerId required | string unique id of the customer |
corporateAccountId required | integer <int64> unique id of the corporate account |
corporateAccountUserId required | integer <int64> unique id of the corporate account user |
{- "success": true
}
Use a corporate account user code.
customerId required | string unique id of the customer |
code required | string [ 16 .. 19 ] characters unique code for the corporate account user |
{- "code": "1234-5678-9123-4567"
}
{- "success": true
}
Check if a corporate account user code is valid.
code required | string [ 16 .. 19 ] characters unique code for the corporate account user |
{- "code": "1234-5678-9123-4567"
}
{- "corporateAccountId": 9310,
- "plenigoOfferId": "O_123456789123456789",
- "status": "INVITED"
}
Search all customers that correspond to the given search conditions. It is important to note that email, username, and externalSystemid exclude each other so only one query parameter is used. The defined priority is email, username, externalSystemId.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
externalSystemId | string external system id defined by third party systems |
string <email> email to search for | |
username | string username to search for |
{- "items": [
- {
- "customerId": "100003",
- "username": "wild_flower",
- "email": "wildflower@example.com",
- "invoiceEmail": "wildflower-invoices@example.com",
- "birthday": "2001-03-21",
- "language": "de",
- "mobileNumber": "+14155552671",
- "status": "ACTIVATED"
}
]
}
Create a new customer with the data provided.
customerId | string^[0-9]{1,18}$ unique id of the customer |
registrationSource | string <= 100 characters domain, website, app or other source of the customer registration |
password | string <= 100 characters password the new customer should get |
sendWelcomeMail | boolean flag indicating if welcome mail for customer should be sent |
Array of objects (CustomerAddressCreation) addresses that should be directly associated with the customer | |
object (AdditionalCustomerData) | |
pseudoEmail | boolean flag indicating that email should be a pseudo email |
processingBlocked | boolean Flag to indicate to third party systems that the customer is blocked for further processing and should not be used for advertisement, etc. Can be used in combination with the pseudoEmail flag to handle data protection requests without deletion of a customer. |
username | string <= 100 characters selected username of the customer that is unique for all users |
email required | string <email> <= 100 characters email address of the customer that is unique for all users |
externalSystemId | string <= 100 characters external system id - can only be set if not set yet |
salutation | string Enum: "DIVERSE" "MR" "MRS" "NONE" salutation to identify the correct designation of a customer |
firstName | string <= 100 characters first name of the customer - first name and last name or company name are required |
lastName | string <= 100 characters last name of the customer - first name and last name or company name are required |
invoiceEmail | string <email> <= 100 characters email address of the customer where invoices should be sent to |
language required | string = 2 characters language of the customer - two letter language code according to ISO 639-1 |
mobileNumber | string <= 100 characters (^\+?[1-9]\d{1,14}$|^$) mobile number of the customer formatted as E.164 |
birthday | string or null <date> birthday of the customer with full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-01 |
object (CustomerMiscellaneousData) |
{- "customerId": "100003",
- "username": "wild_flower",
- "email": "wildflower@example.com",
- "invoiceEmail": "wildflower-invoices@example.com",
- "birthday": "2001-03-21",
- "language": "de",
- "mobileNumber": "+14155552671",
- "status": "ACTIVATED",
- "addresses": [
- {
- "type": "INVOICE",
- "preferred": true,
- "customerId": "100003",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
], - "data": {
- "myCustomerId": "1234CustomerId"
}
}
{- "customerId": "100003",
- "externalSystemId": "1748-E",
- "username": "wild_flower",
- "email": "wildflower@example.com",
- "salutation": "MR",
- "firstName": "John",
- "lastName": "Doe",
- "invoiceEmail": "wildflower-invoices@example.com",
- "birthday": "2001-03-21",
- "language": "de",
- "mobileNumber": "+14155552671",
- "status": "ACTIVATED",
- "changedDate": "2019-03-21T17:32:12Z",
- "registrationDate": "2019-03-21T17:32:12Z",
- "registrationSource": "www.example.com",
- "twoFactorEnabled": false,
- "addresses": [
- {
- "addressId": 10004,
- "type": "INVOICE",
- "preferred": true,
- "customerId": "100003",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
], - "data": {
- "myCustomerId": "1234CustomerId"
}
}
Search all additional data of customers.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
{- "items": [
- {
- "data": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}
}
]
}
Get customer that is identified by the passed customer id.
customerId required | string unique id of the customer |
{- "customerId": "100003",
- "username": "wild_flower",
- "email": "wildflower@example.com",
- "invoiceEmail": "wildflower-invoices@example.com",
- "birthday": "2001-03-21",
- "language": "de",
- "mobileNumber": "+14155552671",
- "status": "ACTIVATED",
- "acceptedTerms": {
- "AEISLQ565BPITQ251O31": {
- "termId": 103300,
- "uniqueId": "V1.0",
- "acceptanceDate": "2020-03-21T17:32:12Z"
}
}
}
Update a customer that is identified by the passed customer id with the data provided.
customerId required | string unique id of the customer |
pseudoEmail | boolean flag indicating that email should be a pseudo email |
password | string <= 100 characters new password of the user - if left empty the old password will be kept |
processingBlocked | boolean Flag to indicate to third party systems that the customer is blocked for further processing and should not be used for advertisement, etc. Can be used in combination with the pseudoEmail flag to handle data protection requests without deletion of a customer. |
username | string <= 100 characters selected username of the customer that is unique for all users |
string <email> <= 100 characters email address of the customer that is unique for all users | |
externalSystemId | string <= 100 characters external system id - can only be set if not set yet |
salutation | string Enum: "DIVERSE" "MR" "MRS" "NONE" salutation to identify the correct designation of a customer |
firstName | string <= 100 characters first name of the customer - first name and last name or company name are required |
lastName | string <= 100 characters last name of the customer - first name and last name or company name are required |
invoiceEmail | string <email> <= 100 characters email address of the customer where invoices should be sent to |
language | string = 2 characters language of the customer - two letter language code according to ISO 639-1 |
mobileNumber | string <= 100 characters (^\+?[1-9]\d{1,14}$|^$) mobile number of the customer formatted as E.164 |
birthday | string or null <date> birthday of the customer with full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-01 |
object (CustomerMiscellaneousData) |
{- "username": "wild_flower",
- "email": "wildflower@example.com",
- "invoiceEmail": "wildflower-invoices@example.com",
- "birthday": "2001-03-21",
- "language": "de",
- "mobileNumber": "+14155552671"
}
{- "customerId": "100003",
- "username": "wild_flower",
- "email": "wildflower@example.com",
- "invoiceEmail": "wildflower-invoices@example.com",
- "birthday": "2001-03-21",
- "language": "de",
- "mobileNumber": "+14155552671",
- "status": "ACTIVATED",
- "acceptedTerms": {
- "AEISLQ565BPITQ251O31": {
- "termId": 103300,
- "uniqueId": "V1.0",
- "acceptanceDate": "2020-03-21T17:32:12Z"
}
}
}
Delete a customer. This is only possible if customer has no payments done yet.
customerId required | string unique id of the customer |
forceDeletion | boolean flag indicating if force deletion |
{- "success": true
}
Get access rights associated with a customer.
customerId required | string unique id of the customer |
{- "customerId": "100003",
- "customerBlocked": false,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "items": [
- {
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "lifeTimeStart": "2019-01-01T07:53:23.450961Z",
- "lifeTimeEnd": "2020-01-01T07:53:23.450961Z",
- "accessTimeStart": "06:00:00",
- "accessTimeEnd": "18:00:00",
- "maxCacheDate": "2020-01-01T07:53:23.450961Z",
- "data": [
- {
- "key": "value"
}
], - "blocked": false,
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_TTA1E7173120881552",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_TTA1E7173120881553",
- "accessRightUniqueId": "UNIQUE-ID",
- "accessRightData": {
- "key": "value"
}, - "itemType": "SUBSCRIPTION_ITEM",
- "itemId": "7212"
}
]
}
Returns additional data associated with the customer associated with the provided customer id.
customerId required | string unique id of the customer |
{- "data": {
- "myCustomerId": "1234CustomerId"
}
}
Replace additional data of a customer. All data will be replaced with the new data provided.
customerId required | string unique id of the customer |
object |
{- "data": {
- "myCustomerId": "1234CustomerId"
}
}
{- "data": {
- "myCustomerId": "1234CustomerId"
}
}
Search all app store orders that correspond to the given search conditions.
customerId required | string unique id of the customer |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "appStoreOrderId": 0,
- "orderDate": "2019-08-24T14:15:22Z",
- "customerId": "string",
- "storeType": "APPSTORE",
- "additionalStoreData": {
- "receiptType": "string",
- "adamID": 0,
- "appItemID": "string",
- "bundleID": "string",
- "applicationVersion": "string",
- "downloadID": 0,
- "versionExternalIdentifier": "string",
- "originalApplicationVersion": "string",
- "receiptCreationDate": "2019-08-24T14:15:22Z",
- "requestDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "items": [
- {
- "quantity": "string",
- "productId": "string",
- "transactionId": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "promotionalOfferId": "string",
- "subscriptionGroupIdentifier": "string",
- "isTrialPeriod": "string",
- "isInIntroOfferPeriod": "string",
- "isUpgraded": "string",
- "expiresDate": "2019-08-24T14:15:22Z",
- "purchaseDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "cancellationReason": "string"
}
]
}, - "items": [
- {
- "position": 0,
- "deliveryCustomerId": "string",
- "productId": "string",
- "appStoreSubscriptionId": 0,
- "accessRightUniqueId": "string",
- "additionalStoreItemData": {
- "quantity": "string",
- "productId": "string",
- "transactionId": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "promotionalOfferId": "string",
- "subscriptionGroupIdentifier": "string",
- "isTrialPeriod": "string",
- "isInIntroOfferPeriod": "string",
- "isUpgraded": "string",
- "expiresDate": "2019-08-24T14:15:22Z",
- "purchaseDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "cancellationReason": "string"
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
]
}
Search all app store subscriptions that correspond to the given search conditions.
customerId required | string unique id of the customer |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "appStoreSubscriptionId": 0,
- "chainId": 0,
- "externalSystemId": "string",
- "customerId": "string",
- "startDate": "2019-08-24T14:15:22Z",
- "endDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "status": "ACTIVE",
- "accessRightUniqueId": "string",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
]
}
Search all addresses that correspond to the given search conditions and belong to the customer identified by the customer id provided.
customerId required | string unique id of the customer |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "addressId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "type": "INVOICE",
- "preferred": true,
- "customerId": "100003",
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
]
}
Changes a customer's email
customerId required | string unique id of the customer |
string <email> <= 100 characters email address |
{- "email": "email@example.com"
}
{- "items": [
- {
- "customerId": "100003",
- "username": "wild_flower",
- "email": "wildflower@example.com",
- "invoiceEmail": "wildflower-invoices@example.com",
- "birthday": "2001-03-21",
- "language": "de",
- "mobileNumber": "+14155552671",
- "status": "ACTIVATED"
}
]
}
ASYNC Every call to this endpoint will return a promise ID and create a GDPR request callback that contains the customer data requested. The callback also returns the promise ID returned by this call to be identified. This endpoint is highly limited because of its expensive nature. You can only call it three times every five seconds. Unlimited requests can be done by an agent via the plenigo merchant backend.
customerId required | string unique id of the customer |
{- "success": true,
- "promiseId": "0ujsszgFvbiEr7CDgE3z8MAUPFt"
}
Search all invoices that correspond to the given search conditions and belong to the customer identified by the customer id provided.
customerId required | string unique id of the customer |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "invoiceId": 12200,
- "changedDate": "2019-03-21T17:32:12Z",
- "invoiceDate": "2019-03-21T17:32:12Z",
- "accumulatedPrice": 12,
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMetodId": 145,
- "invoiceCustomerId": 100003,
- "invoiceAddress": {
- "businessAddress": true,
- "salutation": "MR",
- "title": "Prince",
- "firstName": "Michael",
- "lastName": "Example",
- "companyName": "Example Ltd.",
- "additionalCompanyInfo": "London",
- "street": "King Street",
- "streetNumber": "4",
- "additionalStreetInfo": "Appartment 5",
- "postcode": "E-3245",
- "city": "London",
- "country": "GB",
- "vatNumber": "GB123456789"
}, - "items": [
- {
- "position": 1,
- "title": "A simple cup",
- "price": 12,
- "tax": 19,
- "taxCountry": "DE",
- "quantity": 12,
- "deliveryCustomerId": "100003",
- "deliveryAddress": {
- "businessAddress": true,
- "salutation": "MR",
- "title": "Prince",
- "firstName": "Michael",
- "lastName": "Example",
- "companyName": "Example Ltd.",
- "additionalCompanyInfo": "London",
- "street": "King Street",
- "streetNumber": "4",
- "additionalStreetInfo": "Appartment 5",
- "postcode": "E-3245",
- "city": "London",
- "country": "GB",
- "vatNumber": "GB123456789"
}
}
]
}
]
}
Changes a customer's invoice email
customerId required | string unique id of the customer |
invoiceEmail | string <email> <= 100 characters invoice email address |
{- "invoiceEmail": "invoice@example.com"
}
{- "items": [
- {
- "customerId": "100003",
- "username": "wild_flower",
- "email": "wildflower@example.com",
- "invoiceEmail": "wildflower-invoices@example.com",
- "birthday": "2001-03-21",
- "language": "de",
- "mobileNumber": "+14155552671",
- "status": "ACTIVATED"
}
]
}
Search all foreign orders that correspond to the given search conditions and belong to the customer identified by the customer id provided.
customerId required | string unique id of the customer |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "orderId": 12200,
- "changedDate": "2019-03-21T17:32:12Z",
- "status": "DONE",
- "type": "ORDER",
- "orderDate": "2019-03-21T17:32:12Z",
- "accumulatedPrice": 12,
- "currency": "EUR",
- "paymentMethod": "PAYPAL",
- "paymentMethodId": 100231,
- "invoiceCustomerId": 100003,
- "invoiceAddress": {
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}, - "items": [
- {
- "position": 1,
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_MZA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "A simple cup",
- "taxType": "PHYSICALPRODUCT",
- "price": 12,
- "tax": 19,
- "taxCountry": "DE",
- "quantity": 12,
- "deliveryCustomerId": "100003",
- "deliveryAddress": {
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
}
]
}
]
}
Get opt-ins of the customer.
customerId required | string unique id of the customer |
{- "customerId": "string",
- "optIns": {
- "key": "EMAIL",
- "value": {
- "optInId": 0,
- "uniqueId": "string",
- "changedDate": "2019-08-24T14:15:22Z",
- "status": "NONE"
}
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Update opt-ins of a customer.
customerId required | string unique id of the customer |
object |
{- "optIns": {
- "key": "EMAIL",
- "value": {
- "status": "NONE"
}
}
}
{- "customerId": "string",
- "optIns": {
- "key": "EMAIL",
- "value": {
- "optInId": 0,
- "uniqueId": "string",
- "changedDate": "2019-08-24T14:15:22Z",
- "status": "NONE"
}
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Search all orders that correspond to the given search conditions and belong to the customer identified by the customer id provided.
customerId required | string unique id of the customer |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "orderId": 12200,
- "changedDate": "2019-03-21T17:32:12Z",
- "status": "DONE",
- "type": "ORDER",
- "orderDate": "2019-03-21T17:32:12Z",
- "accumulatedPrice": 12,
- "currency": "EUR",
- "paymentMethod": "PAYPAL",
- "paymentMethodId": 100231,
- "invoiceCustomerId": 100003,
- "invoiceAddress": {
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}, - "items": [
- {
- "position": 1,
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_MZA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "A simple cup",
- "taxType": "PHYSICALPRODUCT",
- "price": 12,
- "tax": 19,
- "taxCountry": "DE",
- "quantity": 12,
- "deliveryCustomerId": "100003",
- "deliveryAddress": {
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
}
]
}
]
}
Search all payment methods that correspond to the given search conditions and belong to the customer identified by the customer id provided.
customerId required | string unique id of the customer |
{- "amazonPayAccounts": [
- {
- "amazonPayAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "25727275674275",
- "active": true,
- "preferred": true
}
], - "bankAccounts": [
- {
- "bankAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "owner": "John Doe",
- "iban": "DE19123412341234123412",
- "active": true,
- "preferred": true
}
], - "creditCards": [
- {
- "creditCardId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "owner": "John Doe",
- "cardType": "MASTERCARD",
- "paymentProvider": "STRIPE",
- "providerToken": "C13487324913",
- "obfuscatedNumber": "132412432xxxxx1234",
- "validTo": "2019-07-01",
- "active": true,
- "preferred": true
}
], - "payPalAccounts": [
- {
- "payPalAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "billingAgreementId": "B-1234124324124",
- "active": true,
- "preferred": true
}
]
}
Change the current status of a customer
customerId required | string unique id of the customer |
status | string Enum: "ACTIVATED" "BLOCKED" "DEACTIVATED" new status the customer should become
|
{- "status": "BLOCKED"
}
{- "customerId": "100003",
- "username": "wild_flower",
- "email": "wildflower@example.com",
- "invoiceEmail": "wildflower-invoices@example.com",
- "birthday": "2001-03-21",
- "language": "de",
- "mobileNumber": "+14155552671",
- "status": "ACTIVATED",
- "acceptedTerms": {
- "AEISLQ565BPITQ251O31": {
- "termId": 103300,
- "uniqueId": "V1.0",
- "acceptanceDate": "2020-03-21T17:32:12Z"
}
}
}
Returns status history associated with the customer associated with the provided customer id.
customerId required | string unique id of the customer |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
{- "statusChangeId": 0,
- "customerId": "string",
- "startTime": "2019-08-24T14:15:22Z",
- "endTime": "2019-08-24T14:15:22Z",
- "oldStatus": "ACTIVATED",
- "newStatus": "ACTIVATED",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
Search all subscriptions that correspond to the given search conditions and belong to the customer identified by the customer id provided.
customerId required | string unique id of the customer |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptionItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
]
}
Search all cross client subscriptions that correspond to the given search conditions and belong to the customer identified by the customer id provided.
customerId required | string unique id of the customer |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptionItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
]
}
Search all transactions that correspond to the given search conditions and belong to the customer identified by the customer id provided.
customerId required | string unique id of the customer |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
{- "items": [
- {
- "transactionId": "12341243123",
- "plenigoTransactionId": "1TCZCSdg0lFEGGG3JPbZODkZKG0",
- "sortKey": 20190321713212125000,
- "changedDate": "2019-03-21T17:32:12Z",
- "paymentProvider": "PAYPAL",
- "paymentMethod": "PAYPAL",
- "paymentAction": "PAYPAL_REFERENCE_TRANSACTION",
- "paymentStatus": "SUCCESS",
- "customerId": "12701",
- "amount": 12.9,
- "currency": "EUR"
}
]
}
Get customer credit wallets.
customerId required | string unique id of the customer |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
{- "items": [
- {
- "customerId": "42",
- "customerCreditWalletId": 5800001,
- "uniqueId": "company-wallet",
- "title": "Wallet of a customer",
- "availableCreditCount": 5
}
]
}
Search all failed login attempts that correspond to the given search conditions.
customerId required | string unique id of the customer |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "failedCustomerLogInId": 0,
- "customerId": "string",
- "loginDate": "2019-08-24T14:15:22Z",
- "browser": "string",
- "os": "string",
- "source": "string",
- "sourceUrl": "string",
- "country": "string",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Search all successful login attempts that correspond to the given search conditions.
customerId required | string unique id of the customer |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "customerLogInId": 0,
- "customerId": "string",
- "loginDate": "2019-08-24T14:15:22Z",
- "browser": "string",
- "os": "string",
- "source": "string",
- "sourceUrl": "string",
- "country": "string",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Create a stripe customer association for a customer
customerId required | string unique id of the customer |
stripeId | string <= 20 characters Stripe id of the customer |
{- "stripeId": "cus_9s6XGDTHzA66Po"
}
{- "stripeId": "cus_9s6XGDTHzA66Po",
- "customerId": "12341234123"
}
Deletes a Stripe customer if no payment method is associated yet. Also the customer within the Stripe system will be removed if there are no other payment methods associated with.
customerId required | string unique id of the customer |
{- "success": true
}
Changes a customer's username
customerId required | string unique id of the customer |
username | string <= 100 characters username |
{- "username": "marryJ"
}
{- "items": [
- {
- "customerId": "100003",
- "username": "wild_flower",
- "email": "wildflower@example.com",
- "invoiceEmail": "wildflower-invoices@example.com",
- "birthday": "2001-03-21",
- "language": "de",
- "mobileNumber": "+14155552671",
- "status": "ACTIVATED"
}
]
}
Get the customer marks.
customerId required | string unique id of the customer |
{- "customerId": "string",
- "tags": {
- "key": "WBZ",
- "value": {
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API",
- "dealerGroup": "string",
- "dealerNumber": "string",
- "agencyPrice": 0,
- "basePrice": 0,
- "exitLiability": 0,
- "startWkzA": 0,
- "startWkzB": 0,
- "startWkzC": 0,
- "scaleWkzA": 0,
- "scaleWkzB": 0,
- "scaleWkzC": 0,
- "data": {
- "key": "string",
- "value": "string"
}
}
}
}
Get the customer mark data.
customerId required | string unique id of the customer |
customerMark required | string Value: "WBZ" customer mark |
{- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API",
- "dealerGroup": "string",
- "dealerNumber": "string",
- "agencyPrice": 0,
- "basePrice": 0,
- "exitLiability": 0,
- "startWkzA": 0,
- "startWkzB": 0,
- "startWkzC": 0,
- "scaleWkzA": 0,
- "scaleWkzB": 0,
- "scaleWkzC": 0,
- "data": {
- "key": "string",
- "value": "string"
}
}
Update customer mark data.
customerId required | string unique id of the customer |
customerMark required | string Value: "WBZ" customer mark |
dealerGroup required | string <= 200 characters wbz dealer group |
dealerNumber required | string <= 200 characters wbz dealer number |
agencyPrice | number <double> the agency price |
basePrice | number <double> the base price |
exitLiability | integer <int32> exitLiability |
startWkzA | number <double> start WKZ-A price |
startWkzB | number <double> start WKZ-B price |
startWkzC | number <double> start WKZ-C price |
scaleWkzA | number <double> scale WKZ-A price |
scaleWkzB | number <double> scale WKZ-B price |
scaleWkzC | number <double> scale WKZ-C price |
object |
{- "dealerGroup": "string",
- "dealerNumber": "string",
- "agencyPrice": 0,
- "basePrice": 0,
- "exitLiability": 0,
- "startWkzA": 0,
- "startWkzB": 0,
- "startWkzC": 0,
- "scaleWkzA": 0,
- "scaleWkzB": 0,
- "scaleWkzC": 0,
- "data": {
- "key": "string",
- "value": "string"
}
}
{- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API",
- "dealerGroup": "string",
- "dealerNumber": "string",
- "agencyPrice": 0,
- "basePrice": 0,
- "exitLiability": 0,
- "startWkzA": 0,
- "startWkzB": 0,
- "startWkzC": 0,
- "scaleWkzA": 0,
- "scaleWkzB": 0,
- "scaleWkzC": 0,
- "data": {
- "key": "string",
- "value": "string"
}
}
Search all failed login attempts that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "failedCustomerLogInId": 0,
- "customerId": "string",
- "loginDate": "2019-08-24T14:15:22Z",
- "browser": "string",
- "os": "string",
- "source": "string",
- "sourceUrl": "string",
- "country": "string",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Search all successful login attempts that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "customerLogInId": 0,
- "customerId": "string",
- "loginDate": "2019-08-24T14:15:22Z",
- "browser": "string",
- "os": "string",
- "source": "string",
- "sourceUrl": "string",
- "country": "string",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Search opt-ins of a company.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "customerId": "string",
- "optIns": {
- "key": "EMAIL",
- "value": {
- "optInId": 0,
- "uniqueId": "string",
- "changedDate": "2019-08-24T14:15:22Z",
- "status": "NONE"
}
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
]
}
Search all amazon pay accounts that correspond to the given search conditions
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "amazonPayAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "S02-7331650-8246451",
- "active": true,
- "preferred": true
}
]
}
Create a new amazon pay account with the data provided.
customerId required | string^[0-9]{1,18}$ unique id of the customer the amazon pay account belongs to |
createdAt | string or null <date-time> date time the amazon pay account entity was created with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
updatedAt | string or null <date-time> date time the amazon pay account entity was changed with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
chargePermissionId required | string <= 50 characters the amazon pay charge permission id |
preferred | boolean flag indicating if amazon pay account is the preferred amazon pay account - only one amazon pay account can be preferred. |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "chargePermissionId": "S02-7331650-8246451",
- "customerId": "100003",
- "createdAt": "2019-03-21T17:32:12Z",
- "updatedAt": "2019-03-21T17:32:12Z",
- "preferred": true
}
{- "amazonPayAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "S02-7331650-8246451",
- "active": true,
- "preferred": true
}
Get amazon pay account that is identified by the passed amazon pay account id.
amazonPayAccountId required | integer <int64> unique id of the AmazonPay account |
{- "amazonPayAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "S02-7331650-8246451",
- "active": true,
- "preferred": true
}
Update an amazon pay account that is identified by the passed amazon pay account id with the data provided.
amazonPayAccountId required | integer <int64> unique id of the AmazonPay account |
chargePermissionId required | string <= 50 characters the amazon pay charge permission id |
preferred | boolean flag indicating if amazon pay account is the preferred amazon pay account - only one amazon pay account can be preferred. |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "chargePermissionId": "S02-7331650-8246451",
- "preferred": true
}
{- "amazonPayAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "S02-7331650-8246451",
- "active": true,
- "preferred": true
}
Delete an amazon pay account. This is only possible if amazon pay account is not associated with a subscription. Otherwise the subscription association must be removed first.
amazonPayAccountId required | integer <int64> unique id of the AmazonPay account |
{- "success": true
}
Search all bank accounts that correspond to the given search conditions
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "bankAccountId": 100001,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "customerId": "100003",
- "owner": "John Doe",
- "iban": "GB19123412341234123412",
- "mandateId": "12342342",
- "mandateDate": "2019-03-21T17:32:12Z",
- "active": true,
- "preferred": true
}
]
}
Create a new bank account with the data provided.
customerId required | string^[0-9]{1,18}$ unique id of the payment mandate - if not sent plenigo will generate a new one together with a mandate date |
mandateId | string unique id of the payment mandate |
mandateDate | string or null <date> date the payment mandate was created with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
pspMandateId | string <= 100 characters psp mandate id |
owner required | string <= 30 characters name on bank account |
iban required | string [ 18 .. 32 ] characters |
bic | string [ 8 .. 11 ] characters BIC - only necessary for countries outside the EU |
preferred | boolean flag indicating if bank account is the preferred bank account - only one bank account can be preferred. |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "customerId": "100003",
- "owner": "John Doe",
- "iban": "GB19123412341234123412",
- "mandateId": "12342342",
- "mandateDate": "2019-03-21T17:32:12Z",
- "preferred": true
}
{- "bankAccountId": 100001,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "customerId": "100003",
- "owner": "John Doe",
- "iban": "GB19123412341234123412",
- "mandateId": "12342342",
- "mandateDate": "2019-03-21T17:32:12Z",
- "active": true,
- "preferred": true
}
Get bank account that is identified by the passed bank account id.
bankAccountId required | integer <int64> unique id of the bank account |
{- "bankAccountId": 100001,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "customerId": "100003",
- "owner": "John Doe",
- "iban": "GB19123412341234123412",
- "mandateId": "12342342",
- "mandateDate": "2019-03-21T17:32:12Z",
- "active": true,
- "preferred": true
}
Update a bank account that is identified by the passed bank account id with the data provided.
bankAccountId required | integer <int64> unique id of the bank account |
owner required | string <= 30 characters name on bank account |
iban required | string [ 18 .. 32 ] characters |
bic | string [ 8 .. 11 ] characters BIC - only necessary for countries outside the EU |
preferred | boolean flag indicating if bank account is the preferred bank account - only one bank account can be preferred. |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "bankAccountId": 100001,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "customerId": "100003",
- "owner": "John Doe",
- "iban": "GB19123412341234123412",
- "mandateId": "12342342",
- "mandateDate": "2019-03-21T17:32:12Z",
- "active": true,
- "preferred": true
}
{- "bankAccountId": 100001,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "customerId": "100003",
- "owner": "John Doe",
- "iban": "GB19123412341234123412",
- "mandateId": "12342342",
- "mandateDate": "2019-03-21T17:32:12Z",
- "active": true,
- "preferred": true
}
Delete a bank account. This is only possible if bank account is not associated with a subscription. Otherwise the subscription association must be removed first.
bankAccountId required | integer <int64> unique id of the bank account |
{- "success": true
}
Search all credit cards that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "creditCardId": 100001,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "customerId": "100003",
- "owner": "John Doe",
- "cardType": "MASTERCARD",
- "paymentProvider": "STRIPE",
- "providerToken": "C13487324913",
- "obfuscatedNumber": "132412432xxxxx1234",
- "validTo": "2019-07-01",
- "active": true,
- "preferred": true
}
]
}
Create a new credit card with the data provided.
customerId | string^[0-9]{1,18}$ unique id of the customer the credit card belongs to |
owner required | string <= 30 characters name on credit card |
cardType | string Enum: "VISA" "MASTERCARD" "AMERICAN_EXPRESS" "DISCOVER" "DINERS_CLUB" "JCB" type of the credit card provided |
providerToken required | string <= 100 characters unique credit card token provided by the payment service provider to identify credit card |
obfuscatedNumber required | string <= 30 characters obfuscated credit card number |
validTo required | string or null <date> date the credit card is valid to with full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-01 - must be in the future |
preferred | boolean flag indicating if credit card is the preferred credit card - only one credit card can be preferred. |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "customerId": "100003",
- "owner": "John Doe",
- "cardType": "MASTERCARD",
- "providerToken": "C13487324913",
- "obfuscatedNumber": "132412432xxxxx1234",
- "validTo": "2019-07-01",
- "preferred": true
}
{- "creditCardId": 100001,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "customerId": "100003",
- "owner": "John Doe",
- "cardType": "MASTERCARD",
- "paymentProvider": "STRIPE",
- "providerToken": "C13487324913",
- "obfuscatedNumber": "132412432xxxxx1234",
- "validTo": "2019-07-01",
- "active": true,
- "preferred": true
}
Get credit card that is identified by the passed credit card id.
creditCardId required | integer <int64> unique id of the credit card |
{- "creditCardId": 100001,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "customerId": "100003",
- "owner": "John Doe",
- "cardType": "MASTERCARD",
- "paymentProvider": "STRIPE",
- "providerToken": "C13487324913",
- "obfuscatedNumber": "132412432xxxxx1234",
- "validTo": "2019-07-01",
- "active": true,
- "preferred": true
}
Update credit card that is identified by the passed address id with the data provided.
creditCardId required | integer <int64> unique id of the credit card |
owner required | string <= 30 characters name on credit card |
cardType | string Enum: "VISA" "MASTERCARD" "AMERICAN_EXPRESS" "DISCOVER" "DINERS_CLUB" "JCB" type of the credit card provided |
providerToken required | string <= 100 characters unique credit card token provided by the payment service provider to identify credit card |
obfuscatedNumber required | string <= 30 characters obfuscated credit card number |
validTo required | string or null <date> date the credit card is valid to with full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-01 - must be in the future |
preferred | boolean flag indicating if credit card is the preferred credit card - only one credit card can be preferred. |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "owner": "John Doe",
- "cardType": "MASTERCARD",
- "providerToken": "C13487324913",
- "obfuscatedNumber": "132412432xxxxx1234",
- "validTo": "2019-07-01",
- "preferred": true
}
{- "creditCardId": 100001,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "customerId": "100003",
- "owner": "John Doe",
- "cardType": "MASTERCARD",
- "paymentProvider": "STRIPE",
- "providerToken": "C13487324913",
- "obfuscatedNumber": "132412432xxxxx1234",
- "validTo": "2019-07-01",
- "active": true,
- "preferred": true
}
Delete a credit card. This is only possible if credit card is not associated with a subscription. Otherwise the subscription association must be removed first.
creditCardId required | integer <int64> unique id of the credit card |
{- "success": true
}
Search all iDeal accounts that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "iDealAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "owner": "John Doe",
- "obfuscatedIban": "GB19123412341234123412",
- "pspAccountId": "pk_TYooMQauvdEDq54NiTphI7jx",
- "fingerprint": "Xt5EWLLDS7FJjR1c",
- "active": true
}
]
}
Create a new iDeal account with the data provided.
owner required | string <= 30 characters name on bank account |
obfuscatedIban required | string <= 32 characters obfuscated IBAN |
pspAccountId required | string <= 100 characters payment service provider iDeal account id |
fingerprint required | string <= 100 characters fingerprint to check account uniqueness |
preferred required | boolean flag indicating if iDeal account is the preferred one |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "owner": "John Doe",
- "obfuscatedIban": "GB19123412341234123412",
- "pspAccountId": "pk_TYooMQauvdEDq54NiTphI7jx",
- "fingerprint": "Xt5EWLLDS7FJjR1c"
}
{- "iDealAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "owner": "John Doe",
- "obfuscatedIban": "GB19123412341234123412",
- "pspAccountId": "pk_TYooMQauvdEDq54NiTphI7jx",
- "fingerprint": "Xt5EWLLDS7FJjR1c",
- "active": true
}
Get iDeal account that is identified by the passed iDeal account id.
iDealAccountId required | integer <int64> unique id of the iDeal account |
{- "iDealAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "owner": "John Doe",
- "obfuscatedIban": "GB19123412341234123412",
- "pspAccountId": "pk_TYooMQauvdEDq54NiTphI7jx",
- "fingerprint": "Xt5EWLLDS7FJjR1c",
- "active": true
}
Update an iDeal account that is identified by the passed iDeal account id with the data provided.
iDealAccountId required | integer <int64> unique id of the iDeal account |
owner required | string <= 30 characters name on bank account |
obfuscatedIban required | string <= 32 characters obfuscated IBAN |
pspAccountId required | string <= 100 characters payment service provider iDeal account id |
fingerprint required | string <= 100 characters fingerprint to check account uniqueness |
preferred required | boolean flag indicating if iDeal account is the preferred one |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "owner": "John Doe",
- "obfuscatedIban": "GB19123412341234123412",
- "pspAccountId": "pk_TYooMQauvdEDq54NiTphI7jx",
- "fingerprint": "Xt5EWLLDS7FJjR1c"
}
{- "iDealAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "owner": "John Doe",
- "obfuscatedIban": "GB19123412341234123412",
- "pspAccountId": "pk_TYooMQauvdEDq54NiTphI7jx",
- "fingerprint": "Xt5EWLLDS7FJjR1c",
- "active": true
}
Delete an iDeal account. This is only possible if iDeal account is not associated with a subscription. Otherwise the subscription association must be removed first.
iDealAccountId required | integer <int64> unique id of the iDeal account |
{- "success": true
}
Search all PayPal accounts that correspond to the given search conditions
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "payPalAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "billingAgreementId": "B-1234124324124",
- "active": true,
- "preferred": true
}
]
}
Create a new PayPal account with the data provided.
customerId | string^[0-9]{1,18}$ unique id of the customer the PayPal account belongs to |
billingAgreementId required | string <= 30 characters PayPal billing agreement |
preferred | boolean flag indicating if PayPal account is the preferred PayPal account - only one PayPal account can be preferred. |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "customerId": "83432341",
- "billingAgreementId": "B-1234124324124",
- "preferred": true
}
{- "billingAgreementId": "B-1234124324124",
- "changedDate": "2019-03-21T17:32:12Z",
- "active": true,
- "preferred": true
}
Get PayPal account that is identified by the passed PayPal account id.
payPalAccountId required | integer <int64> unique id of the PayPal account |
{- "billingAgreementId": "B-1234124324124",
- "changedDate": "2019-03-21T17:32:12Z",
- "active": true,
- "preferred": true
}
Delete a PayPal account. This is only possible if PayPal account is not associated with a subscription. Otherwise the subscription association must be removed first.
payPalAccountId required | integer <int64> unique id of the PayPal account |
{- "success": true
}
Search all PostFinance accounts that correspond to the given search conditions
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "postFinanceAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "S02-7331650-8246451",
- "active": true,
- "preferred": true
}
]
}
Create a new PostFinance account with the data provided.
customerId required | string^[0-9]{1,18}$ unique id of the customer the PostFinance account belongs to |
createdAt | string or null <date-time> date time the PostFinance account entity was created with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
updatedAt | string or null <date-time> date time the PostFinance account entity was changed with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
chargePermissionId required | string <= 50 characters the PostFinance charge permission id |
preferred | boolean flag indicating if PostFinance account is the preferred PostFinance account - only one PostFinance account can be preferred. |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "chargePermissionId": "S02-7331650-8246451",
- "customerId": "100003",
- "createdAt": "2019-03-21T17:32:12Z",
- "updatedAt": "2019-03-21T17:32:12Z",
- "preferred": true
}
{- "postFinanceAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "S02-7331650-8246451",
- "active": true,
- "preferred": true
}
Get PostFinance account that is identified by the passed PostFinance account id.
postFinanceAccountId required | integer <int64> unique id of the PostFinance account |
{- "postFinanceAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "S02-7331650-8246451",
- "active": true,
- "preferred": true
}
Delete a PostFinance account. This is only possible if PostFinance account is not associated with a subscription. Otherwise the subscription association must be removed first.
postFinanceAccountId required | integer <int64> unique id of the PostFinance account |
{- "success": true
}
Search all Twint accounts that correspond to the given search conditions
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "twintAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "S02-7331650-8246451",
- "active": true,
- "preferred": true
}
]
}
Create a new Twint account with the data provided.
customerId required | string^[0-9]{1,18}$ unique id of the customer the Twint account belongs to |
createdAt | string or null <date-time> date time the Twint account entity was created with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
updatedAt | string or null <date-time> date time the Twint account entity was changed with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
chargePermissionId required | string <= 50 characters the Twint charge permission id |
preferred | boolean flag indicating if Twint account is the preferred Twint account - only one Twint account can be preferred. |
invalid | boolean flag indicating if payment method should be handled as invalid |
{- "chargePermissionId": "S02-7331650-8246451",
- "customerId": "100003",
- "createdAt": "2019-03-21T17:32:12Z",
- "updatedAt": "2019-03-21T17:32:12Z",
- "preferred": true
}
{- "twintAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "S02-7331650-8246451",
- "active": true,
- "preferred": true
}
Get Twint account that is identified by the passed Twint account id.
twintAccountId required | integer <int64> unique id of the Twint account |
{- "twintAccountId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": "100003",
- "chargePermissionId": "S02-7331650-8246451",
- "active": true,
- "preferred": true
}
Delete a Twint account. This is only possible if Twint account is not associated with a subscription. Otherwise the subscription association must be removed first.
twintAccountId required | integer <int64> unique id of the Twint account |
{- "success": true
}
Provides customer data details for the currently active session. Includes the complete customer and her preferred invoice and delivery addresses if available.
sessionToken required | string <= 10000 characters active customer session |
{- "customerId": "100003",
- "username": "wild_flower",
- "email": "wildflower@example.com",
- "invoiceEmail": "wildflower-invoices@example.com",
- "birthday": "2001-03-21",
- "language": "de",
- "mobileNumber": "+14155552671",
- "status": "ACTIVATED",
- "acceptedTerms": {
- "AEISLQ565BPITQ251O31": {
- "termId": 103300,
- "uniqueId": "V1.0",
- "acceptanceDate": "2020-03-21T17:32:12Z"
}
}
}
Validates a customer session and returns the session information in case of a valid session.
sessionToken required | string <= 10000 characters active customer session |
{- "id": "0ujssxh0cECutqzMgbtXSGnjorm",
- "customerId": "6342000",
- "contractCompanyId": "xhzTmlZgnSQ6LpzkRGvK",
- "companyId": "aHgTmlZgnSQ6LpzkRGvK",
- "created": "2019-01-01T07:53:23.450961Z",
- "type": "CUSTOMER_SESSION"
}
Creates a new customer session for the provided customer id. More information provided during the session creation process will lead to a better session protection and also helps the user to identify which session he wants to remove if multiple parallel log ins are allowed and the maximum active session limit is reached.
customerId required | string unique id of the customer |
os | string <= 100 characters operating system session was created on |
browser | string <= 200 characters browser session was created in |
source | string <= 200 characters source domain or app name |
sourceUrl | string <= 2000 characters source url |
ipAddress | string <= 45 characters ip address |
country | string <= 2 characters country code formatted as ISO 3166-1 alpha-2 |
{- "browser": "Mozilla/5.0 (Android 4.4; Mobile; rv:41.0) Gecko/41.0 Firefox/41.0",
- "os": "Android 4.4",
- "source": "www.example.com",
- "ipAddress": "127.0.0.1",
- "country": "GB"
}
{- "activeSessions": {
- "items": [
- {
- "sessionId": "93jsszwN8NRY24YaXiTIE2VWDMM",
- "os": "Windows 10",
- "browser": "Firefox",
- "createdAt": "2019-03-21T17:32:12Z"
}, - {
- "sessionId": "63jsszwN8NRY24YaXiTIE2VWDZZ",
- "os": "Windows 10",
- "browser": "Chrome",
- "createdAt": "2020-02-21T17:32:12Z"
}
]
}, - "removalToken": "2ujsszwN8NRY24YaXiTIE2VWDTE"
}
Creates a new transfer token that enables to transfer a customer session e.g. via Javascript without letting other Javascripts to catch the actual user session. A transfer token is only valid one time and for 30 seconds.
customerSession | string customer session string to be provided for all functionality that needs an active customer session - the string size can be very long so don't set any length restrictions if saved within a database or something similar |
{- "customerSession": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}
{- "transferToken": "0ujssxh0cECutqzMgbtXSGnjorm"
}
Validates a transfer token and returns the session information in case of a transfer token.
transferToken required | string <= 50 characters transfer token |
{- "customerSession": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}
Search all cost centers that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "costCenterId": 100001,
- "costCenter": "12345678",
- "description": "Default cost center",
- "shortDescription": "Default CC"
}
]
}
Create a new cost center with the data provided.
costCenter | string <= 10 characters Cost center value of the cost center |
purchaseNumber | string <= 20 characters Purchase number to use |
description | string <= 400 characters description of the cost center |
shortDescription | string <= 20 characters short description of the cost center |
{- "costCenter": "12345678",
- "description": "Default cost center",
- "shortDescription": "Default CC"
}
{- "costCenterId": 100001,
- "costCenter": "12345678",
- "description": "Default cost center",
- "shortDescription": "Default CC"
}
Get cost center that is identified by the passed cost center id.
costCenterId required | integer <int64> unique id of the cost center |
{- "costCenterId": 100001,
- "costCenter": "12345678",
- "description": "Default cost center",
- "shortDescription": "Default CC"
}
Update a cost center that is identified by the passed cost center id with the data provided.
costCenterId required | integer <int64> unique id of the cost center |
costCenter | string <= 10 characters Cost center value of the cost center |
purchaseNumber | string <= 20 characters Purchase number to use |
description | string <= 400 characters description of the cost center |
shortDescription | string <= 20 characters short description of the cost center |
{- "costCenter": "12345678",
- "description": "Default cost center",
- "shortDescription": "Default CC"
}
{- "costCenterId": 100001,
- "costCenter": "12345678",
- "description": "Default cost center",
- "shortDescription": "Default CC"
}
Search all ledgers that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "ledgerId": 100001,
- "title": "A ledger title",
- "description": "Default ledger description",
- "deliveryCommitmentAccount": "4400",
- "voucherDeliveryCommitmentAccount": "4401",
- "revenueAccount": "5000",
- "bankAccountAmazonPay": "2804",
- "bankAccountApplePay": "2805",
- "bankAccountBilling": "2800",
- "bankAccountCreditCard": "2802",
- "bankAccountGooglePay": "2806",
- "bankAccountPayPal": "2803",
- "bankAccountSepa": "2801",
- "creditLossAccount": "3670",
- "salesTax": "4800",
- "b2bDeliveryCommitmentAccount": "4402",
- "b2bVoucherDeliveryCommitmentAccount": "4403",
- "b2bRevenueAccount": "5001",
- "b2bBankAccountAmazonPay": "2814",
- "b2bBankAccountApplePay": "2815",
- "b2bBankAccountBilling": "2810",
- "b2bBankAccountCreditCard": "2812",
- "b2bBankAccountGooglePay": "2816",
- "b2bBankAccountPayPal": "2813",
- "b2bBankAccountSepa": "2811",
- "b2bCreditLossAccount": "3671",
- "b2bSalesTax": "4801"
}
]
}
Create a new ledger with the data provided.
title required | string <= 100 characters Title of the ledger |
description | string <= 400 characters description of the ledger |
deliveryCommitmentAccount | string <= 80 characters delivery commitment account of the ledger |
voucherDeliveryCommitmentAccount | string <= 80 characters voucher delivery commitment account of the ledger |
revenueAccount | string <= 80 characters revenue account of the ledger |
bankAccountAmazonPay | string <= 80 characters bank account for Amazon Pay of the ledger |
bankAccountApplePay | string <= 80 characters bank account for Apple Pay of the ledger |
bankAccountBilling | string <= 80 characters bank account for billing of the ledger |
bankAccountCreditCard | string <= 80 characters bank account for credit card of the ledger |
bankAccountGooglePay | string <= 80 characters bank account for Google Pay of the ledger |
bankAccountPayPal | string <= 80 characters bank account for PayPal of the ledger |
bankAccountSepa | string <= 80 characters bank account for sepa of the ledger |
creditLossAccount | string <= 80 characters credit loss account of the ledger |
salesTax | string <= 80 characters sales tax account of the ledger |
b2bDeliveryCommitmentAccount | string <= 80 characters b2b delivery commitment account of the ledger |
b2bVoucherDeliveryCommitmentAccount | string <= 80 characters b2b voucher delivery commitment account of the ledger |
b2bRevenueAccount | string <= 80 characters b2b revenue account of the ledger |
b2bBankAccountAmazonPay | string <= 80 characters b2b bank account for Amazon Pay of the ledger |
b2bBankAccountApplePay | string <= 80 characters b2b bank account for Apple Pay of the ledger |
b2bBankAccountBilling | string <= 80 characters b2b bank account for billing of the ledger |
b2bBankAccountCreditCard | string <= 80 characters b2b bank account for credit card of the ledger |
b2bBankAccountGooglePay | string <= 80 characters b2b bank account for Google Pay of the ledger |
b2bBankAccountPayPal | string <= 80 characters b2b bank account for PayPal of the ledger |
b2bBankAccountSepa | string <= 80 characters b2b bank account for sepa of the ledger |
b2bCreditLossAccount | string <= 80 characters b2b credit loss account of the ledger |
b2bSalesTax | string <= 80 characters b2b sales tax account of the ledger |
object custom accountings of the ledger |
{- "title": "A ledger title",
- "description": "Default ledger description",
- "deliveryCommitmentAccount": "4400",
- "voucherDeliveryCommitmentAccount": "4401",
- "revenueAccount": "5000",
- "bankAccountAmazonPay": "2804",
- "bankAccountApplePay": "2805",
- "bankAccountBilling": "2800",
- "bankAccountCreditCard": "2802",
- "bankAccountGooglePay": "2806",
- "bankAccountPayPal": "2803",
- "bankAccountSepa": "2801",
- "creditLossAccount": "3670",
- "salesTax": "4800",
- "b2bDeliveryCommitmentAccount": "4402",
- "b2bVoucherDeliveryCommitmentAccount": "4403",
- "b2bRevenueAccount": "5001",
- "b2bBankAccountAmazonPay": "2814",
- "b2bBankAccountApplePay": "2815",
- "b2bBankAccountBilling": "2810",
- "b2bBankAccountCreditCard": "2812",
- "b2bBankAccountGooglePay": "2816",
- "b2bBankAccountPayPal": "2813",
- "b2bBankAccountSepa": "2811",
- "b2bCreditLossAccount": "3671",
- "b2bSalesTax": "4801"
}
{- "ledgerId": 100001,
- "title": "A ledger title",
- "description": "Default ledger description",
- "deliveryCommitmentAccount": "4400",
- "voucherDeliveryCommitmentAccount": "4401",
- "revenueAccount": "5000",
- "bankAccountAmazonPay": "2804",
- "bankAccountApplePay": "2805",
- "bankAccountBilling": "2800",
- "bankAccountCreditCard": "2802",
- "bankAccountGooglePay": "2806",
- "bankAccountPayPal": "2803",
- "bankAccountSepa": "2801",
- "creditLossAccount": "3670",
- "salesTax": "4800",
- "b2bDeliveryCommitmentAccount": "4402",
- "b2bVoucherDeliveryCommitmentAccount": "4403",
- "b2bRevenueAccount": "5001",
- "b2bBankAccountAmazonPay": "2814",
- "b2bBankAccountApplePay": "2815",
- "b2bBankAccountBilling": "2810",
- "b2bBankAccountCreditCard": "2812",
- "b2bBankAccountGooglePay": "2816",
- "b2bBankAccountPayPal": "2813",
- "b2bBankAccountSepa": "2811",
- "b2bCreditLossAccount": "3671",
- "b2bSalesTax": "4801"
}
Get ledger that is identified by the passed ledger id.
ledgerId required | integer <int64> unique id of the ledger |
{- "ledgerId": 100001,
- "title": "A ledger title",
- "description": "Default ledger description",
- "deliveryCommitmentAccount": "4400",
- "voucherDeliveryCommitmentAccount": "4401",
- "revenueAccount": "5000",
- "bankAccountAmazonPay": "2804",
- "bankAccountApplePay": "2805",
- "bankAccountBilling": "2800",
- "bankAccountCreditCard": "2802",
- "bankAccountGooglePay": "2806",
- "bankAccountPayPal": "2803",
- "bankAccountSepa": "2801",
- "creditLossAccount": "3670",
- "salesTax": "4800",
- "b2bDeliveryCommitmentAccount": "4402",
- "b2bVoucherDeliveryCommitmentAccount": "4403",
- "b2bRevenueAccount": "5001",
- "b2bBankAccountAmazonPay": "2814",
- "b2bBankAccountApplePay": "2815",
- "b2bBankAccountBilling": "2810",
- "b2bBankAccountCreditCard": "2812",
- "b2bBankAccountGooglePay": "2816",
- "b2bBankAccountPayPal": "2813",
- "b2bBankAccountSepa": "2811",
- "b2bCreditLossAccount": "3671",
- "b2bSalesTax": "4801"
}
Update a ledger that is identified by the passed ledger id with the data provided.
ledgerId required | integer <int64> unique id of the ledger |
title required | string <= 100 characters Title of the ledger |
description | string <= 400 characters description of the ledger |
deliveryCommitmentAccount | string <= 80 characters delivery commitment account of the ledger |
voucherDeliveryCommitmentAccount | string <= 80 characters voucher delivery commitment account of the ledger |
revenueAccount | string <= 80 characters revenue account of the ledger |
bankAccountAmazonPay | string <= 80 characters bank account for Amazon Pay of the ledger |
bankAccountApplePay | string <= 80 characters bank account for Apple Pay of the ledger |
bankAccountBilling | string <= 80 characters bank account for billing of the ledger |
bankAccountCreditCard | string <= 80 characters bank account for credit card of the ledger |
bankAccountGooglePay | string <= 80 characters bank account for Google Pay of the ledger |
bankAccountPayPal | string <= 80 characters bank account for PayPal of the ledger |
bankAccountSepa | string <= 80 characters bank account for sepa of the ledger |
creditLossAccount | string <= 80 characters credit loss account of the ledger |
salesTax | string <= 80 characters sales tax account of the ledger |
b2bDeliveryCommitmentAccount | string <= 80 characters b2b delivery commitment account of the ledger |
b2bVoucherDeliveryCommitmentAccount | string <= 80 characters b2b voucher delivery commitment account of the ledger |
b2bRevenueAccount | string <= 80 characters b2b revenue account of the ledger |
b2bBankAccountAmazonPay | string <= 80 characters b2b bank account for Amazon Pay of the ledger |
b2bBankAccountApplePay | string <= 80 characters b2b bank account for Apple Pay of the ledger |
b2bBankAccountBilling | string <= 80 characters b2b bank account for billing of the ledger |
b2bBankAccountCreditCard | string <= 80 characters b2b bank account for credit card of the ledger |
b2bBankAccountGooglePay | string <= 80 characters b2b bank account for Google Pay of the ledger |
b2bBankAccountPayPal | string <= 80 characters b2b bank account for PayPal of the ledger |
b2bBankAccountSepa | string <= 80 characters b2b bank account for sepa of the ledger |
b2bCreditLossAccount | string <= 80 characters b2b credit loss account of the ledger |
b2bSalesTax | string <= 80 characters b2b sales tax account of the ledger |
object custom accountings of the ledger |
{- "ledgerId": 100001,
- "title": "A ledger title",
- "description": "Default ledger description",
- "deliveryCommitmentAccount": "4400",
- "voucherDeliveryCommitmentAccount": "4401",
- "revenueAccount": "5000",
- "bankAccountAmazonPay": "2804",
- "bankAccountApplePay": "2805",
- "bankAccountBilling": "2800",
- "bankAccountCreditCard": "2802",
- "bankAccountGooglePay": "2806",
- "bankAccountPayPal": "2803",
- "bankAccountSepa": "2801",
- "creditLossAccount": "3670",
- "salesTax": "4800",
- "b2bDeliveryCommitmentAccount": "4402",
- "b2bVoucherDeliveryCommitmentAccount": "4403",
- "b2bRevenueAccount": "5001",
- "b2bBankAccountAmazonPay": "2814",
- "b2bBankAccountApplePay": "2815",
- "b2bBankAccountBilling": "2810",
- "b2bBankAccountCreditCard": "2812",
- "b2bBankAccountGooglePay": "2816",
- "b2bBankAccountPayPal": "2813",
- "b2bBankAccountSepa": "2811",
- "b2bCreditLossAccount": "3671",
- "b2bSalesTax": "4801"
}
{- "ledgerId": 100001,
- "title": "A ledger title",
- "description": "Default ledger description",
- "deliveryCommitmentAccount": "4400",
- "voucherDeliveryCommitmentAccount": "4401",
- "revenueAccount": "5000",
- "bankAccountAmazonPay": "2804",
- "bankAccountApplePay": "2805",
- "bankAccountBilling": "2800",
- "bankAccountCreditCard": "2802",
- "bankAccountGooglePay": "2806",
- "bankAccountPayPal": "2803",
- "bankAccountSepa": "2801",
- "creditLossAccount": "3670",
- "salesTax": "4800",
- "b2bDeliveryCommitmentAccount": "4402",
- "b2bVoucherDeliveryCommitmentAccount": "4403",
- "b2bRevenueAccount": "5001",
- "b2bBankAccountAmazonPay": "2814",
- "b2bBankAccountApplePay": "2815",
- "b2bBankAccountBilling": "2810",
- "b2bBankAccountCreditCard": "2812",
- "b2bBankAccountGooglePay": "2816",
- "b2bBankAccountPayPal": "2813",
- "b2bBankAccountSepa": "2811",
- "b2bCreditLossAccount": "3671",
- "b2bSalesTax": "4801"
}
Search all tax codes that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "taxCodeId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "countryType": "SINGLE_COUNTRY",
- "countries": [
- "DE"
], - "tax": 19,
- "analogTag": "A1901",
- "digitalTag": "D1901"
}
]
}
Create a new tax code with the data provided.
countryType required | string Enum: "EU" "EU_B2B" "SINGLE_COUNTRY" "WORLD" type of the country |
countries required | Array of strings array of country codes formatted as ISO 3166-1 alpha-2 |
tax required | number <double> [ 0 .. 100 ] tax percentage operated on this order item |
analogTag required | string <= 80 characters tag for the analog tax code |
digitalTag required | string <= 80 characters tag for the digital tax code |
description | string <= 100 characters description of the tax code |
{- "countryType": "SINGLE_COUNTRY",
- "countries": [
- "DE"
], - "tax": 19,
- "analogTag": "A1901",
- "digitalTag": "D1901"
}
{- "taxCodeId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "countryType": "SINGLE_COUNTRY",
- "countries": [
- "DE"
], - "tax": 19,
- "analogTag": "A1901",
- "digitalTag": "D1901"
}
Get tax code that is identified by the passed tax code id.
taxCodeId required | integer <int64> unique id of the tax code |
{- "taxCodeId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "countryType": "SINGLE_COUNTRY",
- "countries": [
- "DE"
], - "tax": 19,
- "analogTag": "A1901",
- "digitalTag": "D1901"
}
Update a tax code that is identified by the passed tax code id with the data provided.
taxCodeId required | integer <int64> unique id of the tax code |
countryType required | string Enum: "EU" "EU_B2B" "SINGLE_COUNTRY" "WORLD" type of the country |
countries required | Array of strings array of country codes formatted as ISO 3166-1 alpha-2 |
tax required | number <double> [ 0 .. 100 ] tax percentage operated on this order item |
analogTag required | string <= 80 characters tag for the analog tax code |
digitalTag required | string <= 80 characters tag for the digital tax code |
description | string <= 100 characters description of the tax code |
{- "taxCodeId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "countryType": "SINGLE_COUNTRY",
- "countries": [
- "DE"
], - "tax": 19,
- "analogTag": "A1901",
- "digitalTag": "D1901"
}
{- "taxCodeId": 100001,
- "changedDate": "2019-03-21T17:32:12Z",
- "countryType": "SINGLE_COUNTRY",
- "countries": [
- "DE"
], - "tax": 19,
- "analogTag": "A1901",
- "digitalTag": "D1901"
}
Search all disputes that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
customerId | string unique id of the customer |
status | string Enum: "LOST" "NEEDS_RESPONSE" "UNDER_REVIEW" "WARNING_CLOSED" "WARNING_NEEDS_RESPONSE" "WARNING_UNDER_REVIEW" "WON" status of the dispute |
transactionId | string unique id of the transaction |
{- "items": {
- "disputeId": "12341243123",
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": 12701,
- "amount": 12.9,
- "currency": "EUR",
- "paymentProvider": "PAYPAL",
- "cancellationInvoiceId": 23457,
- "transactionId": "2Lx7Hfn42IoFuOiogiyDBxhiBC",
- "status": "SUCCESS",
- "paymentMethod": "PAYPAL",
- "paymentAction": "PAYPAL_REFERENCE_TRANSACTION",
- "paymentStatus": "SUCCESS",
- "statusHistory": {
- "status": "CLOSED",
- "changeDate": "2019-03-21T17:32:12Z"
}
}
}
Get dispute that is identified by the passed dispute id.
disputeId required | string <= 32 characters unique id of the dispute |
{- "disputeId": "12341243123",
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": 12701,
- "amount": 12.9,
- "currency": "EUR",
- "paymentProvider": "PAYPAL",
- "cancellationInvoiceId": 23457,
- "transactionId": "2Lx7Hfn42IoFuOiogiyDBxhiBC",
- "status": "SUCCESS",
- "paymentMethod": "PAYPAL",
- "paymentAction": "PAYPAL_REFERENCE_TRANSACTION",
- "paymentStatus": "SUCCESS",
- "statusHistory": {
- "status": "CLOSED",
- "changeDate": "2019-03-21T17:32:12Z"
}
}
Search all invoices that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
orderId | integer <int64> unique id of the order |
subscriptionItemId | integer <int64> unique id of the subscription item to search for |
filterByInvoiceDate | boolean flag indicating if returned list of invoiced should be filtered by invoice date |
invoiceType | string Enum: "INVOICE" "CANCELLATION" "CANCELLATION_CORRECTION" "CORRECTION" allows filtering by specific invoice type |
{- "items": [
- {
- "invoiceId": 12200,
- "changedDate": "2019-03-21T17:32:12Z",
- "invoiceDate": "2019-03-21T17:32:12Z",
- "accumulatedPrice": 12,
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMetodId": 145,
- "invoiceCustomerId": 100003,
- "invoiceAddress": {
- "businessAddress": true,
- "salutation": "MR",
- "title": "Prince",
- "firstName": "Michael",
- "lastName": "Example",
- "companyName": "Example Ltd.",
- "additionalCompanyInfo": "London",
- "street": "King Street",
- "streetNumber": "4",
- "additionalStreetInfo": "Appartment 5",
- "postcode": "E-3245",
- "city": "London",
- "country": "GB",
- "vatNumber": "GB123456789"
}, - "items": [
- {
- "position": 1,
- "title": "A simple cup",
- "price": 12,
- "tax": 19,
- "taxCountry": "DE",
- "quantity": 12,
- "deliveryCustomerId": "100003",
- "deliveryAddress": {
- "businessAddress": true,
- "salutation": "MR",
- "title": "Prince",
- "firstName": "Michael",
- "lastName": "Example",
- "companyName": "Example Ltd.",
- "additionalCompanyInfo": "London",
- "street": "King Street",
- "streetNumber": "4",
- "additionalStreetInfo": "Appartment 5",
- "postcode": "E-3245",
- "city": "London",
- "country": "GB",
- "vatNumber": "GB123456789"
}
}
]
}
]
}
Get invoice that is identified by the passed invoice id.
invoiceId required | integer <int64> unique id of the invoice |
{- "invoiceId": 12200,
- "changedDate": "2019-03-21T17:32:12Z",
- "invoiceDate": "2019-03-21T17:32:12Z",
- "accumulatedPrice": 12,
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMetodId": 145,
- "invoiceCustomerId": 100003,
- "invoiceAddress": {
- "businessAddress": true,
- "salutation": "MR",
- "title": "Prince",
- "firstName": "Michael",
- "lastName": "Example",
- "companyName": "Example Ltd.",
- "additionalCompanyInfo": "London",
- "street": "King Street",
- "streetNumber": "4",
- "additionalStreetInfo": "Appartment 5",
- "postcode": "E-3245",
- "city": "London",
- "country": "GB",
- "vatNumber": "GB123456789"
}, - "items": [
- {
- "position": 1,
- "title": "A simple cup",
- "price": 12,
- "tax": 19,
- "taxCountry": "DE",
- "quantity": 12,
- "deliveryCustomerId": "100003",
- "deliveryAddress": {
- "businessAddress": true,
- "salutation": "MR",
- "title": "Prince",
- "firstName": "Michael",
- "lastName": "Example",
- "companyName": "Example Ltd.",
- "additionalCompanyInfo": "London",
- "street": "King Street",
- "streetNumber": "4",
- "additionalStreetInfo": "Appartment 5",
- "postcode": "E-3245",
- "city": "London",
- "country": "GB",
- "vatNumber": "GB123456789"
}
}
]
}
Cancel an invoice - only invoices of type INVOICE can be cancelled.
invoiceId required | integer <int64> unique id of the invoice |
suppressCustomerMail | boolean suppress sending mail with cancellation invoice to customer |
suppressRefund | boolean suppress refund the invoice amount to customer |
{- "success": true
}
Handle invoice payment failed for an invoice paid via billing - this must be triggered by the system responsible for invoice handling.
invoiceId required | integer <int64> unique id of the invoice |
{- "success": true
}
Change payment status of an invoice that is paid via billing - this must be triggered by the system responsible for invoice handling.
invoiceId required | integer <int64> unique id of the invoice |
status required | string Enum: "PAID" "NOT_PAID" payment status of the invoice |
{- "status": "PAID"
}
{- "success": true
}
Search all refunds that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
customerId | string unique id of the customer |
status | string Enum: "CLOSED" "IGNORED" "OPEN" "PROCESSING" "REJECTED" status of the refund |
{- "items": {
- "refundId": "12341243123",
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": 12701,
- "amount": 12.9,
- "currency": "EUR",
- "paymentProvider": "PAYPAL",
- "cancellationInvoiceId": 23457,
- "transactionId": "2Lx7Hfn42IoFuOiogiyDBxhiBC",
- "status": "SUCCESS",
- "paymentMethod": "PAYPAL",
- "paymentAction": "PAYPAL_REFERENCE_TRANSACTION",
- "paymentStatus": "SUCCESS",
- "statusHistory": {
- "status": "CLOSED",
- "changeDate": "2019-03-21T17:32:12Z"
}
}
}
Get refund that is identified by the passed refund id.
refundId required | string <= 32 characters unique id of the refund |
{- "refundId": "12341243123",
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": 12701,
- "amount": 12.9,
- "currency": "EUR",
- "paymentProvider": "PAYPAL",
- "cancellationInvoiceId": 23457,
- "transactionId": "2Lx7Hfn42IoFuOiogiyDBxhiBC",
- "status": "SUCCESS",
- "paymentMethod": "PAYPAL",
- "paymentAction": "PAYPAL_REFERENCE_TRANSACTION",
- "paymentStatus": "SUCCESS",
- "statusHistory": {
- "status": "CLOSED",
- "changeDate": "2019-03-21T17:32:12Z"
}
}
Update the refund
refundId required | string <= 32 characters unique id of the refund |
status required | string Enum: "CLOSED" "IGNORED" "OPEN" "PROCESSING" "REJECTED" status of the refund |
reason | string <= 500 characters reason for status change |
{- "status": "CLOSED",
- "reason": "string"
}
{- "refundId": "12341243123",
- "changedDate": "2019-03-21T17:32:12Z",
- "customerId": 12701,
- "amount": 12.9,
- "currency": "EUR",
- "paymentProvider": "PAYPAL",
- "cancellationInvoiceId": 23457,
- "transactionId": "2Lx7Hfn42IoFuOiogiyDBxhiBC",
- "status": "SUCCESS",
- "paymentMethod": "PAYPAL",
- "paymentAction": "PAYPAL_REFERENCE_TRANSACTION",
- "paymentStatus": "SUCCESS",
- "statusHistory": {
- "status": "CLOSED",
- "changeDate": "2019-03-21T17:32:12Z"
}
}
Search all transactions that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
plenigoTransactionId | string plenigo transaction id |
pspTransactionId | string PSP transaction id |
{- "items": [
- {
- "transactionId": "12341243123",
- "plenigoTransactionId": "1TCZCSdg0lFEGGG3JPbZODkZKG0",
- "sortKey": 20190321713212125000,
- "changedDate": "2019-03-21T17:32:12Z",
- "paymentProvider": "PAYPAL",
- "paymentMethod": "PAYPAL",
- "paymentAction": "PAYPAL_REFERENCE_TRANSACTION",
- "paymentStatus": "SUCCESS",
- "customerId": "12701",
- "amount": 12.9,
- "currency": "EUR"
}
]
}
Get transaction that is identified by the passed transaction id.
transactionId required | string <= 32 characters unique id of the transaction |
{- "transactionId": "12341243123",
- "plenigoTransactionId": "1TCZCSdg0lFEGGG3JPbZODkZKG0",
- "sortKey": 20190321713212125000,
- "changedDate": "2019-03-21T17:32:12Z",
- "paymentProvider": "PAYPAL",
- "paymentMethod": "PAYPAL",
- "paymentAction": "PAYPAL_REFERENCE_TRANSACTION",
- "paymentStatus": "SUCCESS",
- "customerId": 12701,
- "amount": 12.9,
- "currency": "EUR"
}
Import the given orders into the system.
purchase | boolean flag indicating if import should be handled as a purchase |
suppressMail | boolean flag indicating if the sending of mails should be suppressed |
Array of objects (OrderImport) |
{- "items": [
- {
- "externalSystemId": "83432341",
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "invoiceAddressId": 100003,
- "deliveryCustomerId": "100004",
- "deliveryAddressId": 100004,
- "quantity": 1,
- "startDate": "2019-03-21T17:32:12Z",
- "paymentMethod": "BILLING"
}
]
}
{- "success": true
}
Search all order import log entries that correspond to the given search conditions. Import logs are only kept for 7 days.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
externalSystemId | string external system id of the order |
plenigoOfferId | string plenigo offer id of the order |
success | boolean flag indicating if only order import logs with the given success flag should be returned |
{- "items": [
- {
- "orderImportLogEntryId": 1230001,
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "externalSystemId": "83432341",
- "plenigoOfferId": "O_MZA1E7173120881551",
- "success": false,
- "orderId": 0,
- "errorReason": "Order could not be imported.",
- "errorDetail": "Payment method is required."
}
]
}
Get order import log entry that is identified by the passed order import log entry id.
orderImportLogEntryId required | integer <int64> unique id of the order import log entry |
{- "orderImportLogEntryId": 1230001,
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "externalSystemId": "83432341",
- "plenigoOfferId": "O_MZA1E7173120881551",
- "success": false,
- "orderId": 0,
- "errorReason": "Order could not be imported.",
- "errorDetail": "Payment method is required."
}
Creates a transfer token for a merchant user.
apiAccessKey | string <= 5000 characters api access key of the merchant user to create transfer token for |
{- "apiAccessKey": "string"
}
{- "transferToken": "string"
}
Executes a purchase for the product represented by the provided voucher code. Only products that are completely free and have no follow up periods that must be paid can be bought that way.
customerId required | string^[0-9]{1,18}$ unique id of the customer the checkout is for |
customerSession | string <= 10000 characters active customer session - if a customer id is provided the customer id overrules the session |
invoiceAddressId | integer <int64> unique id of the invoice address to use |
deliveryAddressId | integer <int64> unique id of the delivery address to use |
customerIpAddress required | string <= 45 characters ip address of the customer |
object (AdditionalOrderData) | |
voucherCode required | string <= 20 characters voucher code to use |
overwrittenProductId | string <= 20 characters add a custom product id during the voucher checkout - this is only allowed for a single offer with one single purchase in it |
{- "customerId": "10003",
- "customerIpAddress": "198.51.100.42",
- "voucherCode": "1234-5678-1234"
}
{- "orderId": 0
}
Purchases a free product for a given customer. The product must be free of charge and if it is a subscription all the steps must be free of charge.
customerId required | string^[0-9]{1,18}$ unique id of the customer the checkout is for |
customerSession | string <= 10000 characters active customer session - if a customer id is provided the customer id overrules the session |
invoiceAddressId | integer <int64> unique id of the invoice address to use |
deliveryAddressId | integer <int64> unique id of the delivery address to use |
customerIpAddress required | string <= 45 characters ip address of the customer |
object (AdditionalOrderData) | |
required | object (CheckoutOffer) |
{- "customerId": "10003",
- "customerIpAddress": "198.51.100.42",
- "offer": {
- "plenigoOfferId": "O_12341423124DF",
- "title": "free offer",
- "quantity": 1
}
}
{- "orderId": 0
}
Prepares everything for a purchase that a customer is supposed to do. The purchase order id returned is only valid a limited time so this method should be called in time before the customer is sent to the checkout.
customerId | string^[0-9]{1,18}$ unique id of the customer the checkout is for |
customerSession | string <= 10000 characters active customer session - if a customer id is provided the customer id overrules the session |
invoiceAddressId | integer <int64> unique id of the invoice address to use |
deliveryAddressId | integer <int64> unique id of the delivery address to use |
customerIpAddress required | string <= 45 characters ip address of the customer |
showNetPrices | boolean flag indicating if net prices should be shown during checkout |
paymentOnly | boolean flag indicating that the checkout should only show payment information |
forcePaymentMethod | string Enum: "AMAZON_PAY" "APPLE_PAY" "BANK_ACCOUNT" "BILLING" "CREDIT_CARD" "GOOGLE_PAY" "IDEAL" "PAYPAL" "POSTFINANCE" "SOFORT" "TWINT" "ZERO" force checkout to use a specific payment method |
basketId | string <= 40 characters unique id of the plenigo basket |
allowMultiplePurchases | boolean flag indicating if product can be bought multiple times - a user will be able to pay the same product twice |
startWithVoucherInput | boolean flag indicating if checkout process should start with a voucher input field - this field is only a hint for the visual representation and if you don't use the plenigo iFrame checkout the logic must be implemented on your side |
hideVoucherInput | boolean flag indicating if checkout process should hide the voucher input field - this field is only a hint for the visual representation and if you don't use the plenigo iFrame checkout the logic must be implemented on your side |
allowedPaymentMethods | Array of strings Items Enum: "AMAZON_PAY" "APPLE_PAY" "BANK_ACCOUNT" "BILLING" "CREDIT_CARD" "GOOGLE_PAY" "IDEAL" "PAYPAL" "POSTFINANCE" "SOFORT" "TWINT" "ZERO" possibility for additional restrictions of payment methods - only payment methods provided here and configured in the backend are allowed during checkout |
language | string <= 2 characters language to use during checkout - two letter language code according to ISO 639-1 |
debugMode | boolean flag indicating if debug information should be shown during purchase process |
subscriptionStartDate | string or null <date-time> optional start date of subscriptions with date notation as defined for example, 2017-07-21 |
object (CheckoutAddressSettings) additional address settings | |
giftOption | string Enum: "FORCE_GIFT_OPTION" "HIDE_GIFT_OPTION" "SHOW_GIFT_OPTION" "PRESELECT_GIFT_OPTION" flag that controls if the checkout should be run as a gift checkout, should show a gift checkout box or hide it - the default value is HIDE_GIFT_OPTION |
object (AdditionalOrderData) additional data associated with this order | |
voucherCode | string voucher code - if voucher code is provided no items must be provided |
Array of objects (CheckoutOffer) offers that should be sold via checkout | |
Array of objects (ConnectedOfferRequest) connected offers that should be sold via checkout |
{- "customerIpAddress": "198.51.100.42",
- "items": [
- {
- "plenigoOfferId": "O_12341423124DF",
- "title": "offer 1",
- "quantity": 1
}, - {
- "plenigoOfferId": "O_34234234234AB",
- "title": "offer 2",
- "quantity": 1
}
]
}
{- "purchaseId": "string"
}
This functionality verifies the log in data of a customer and executes the log in. The caller must decide if a customer name or email address is provided for login. If both are provided only the email address will be used.
username | string <= 100 characters username of the customer |
string <= 100 characters email of the customer | |
password required | string <= 100 characters password of the customer |
os | string <= 100 characters operating system session was created on |
browser | string <= 200 characters browser session was created in |
source | string <= 200 characters source domain or app name |
sourceUrl | string <= 2000 characters source url |
ipAddress | string <= 45 characters ip address |
country | string <= 2 characters country code formatted as ISO 3166-1 alpha-2 |
{- "username": "string",
- "email": "string",
- "password": "string",
- "os": "string",
- "browser": "string",
- "source": "string",
- "sourceUrl": "string",
- "ipAddress": "string",
- "country": "st"
}
{- "token": "0ujsszwN8NRY24YaXiTIE2VWDTS",
- "companyId": "aHgTmlZgnSQ6LpzkRGvK",
- "nextStep": "TWO_FACTOR"
}
This functionality validates the two factor token of a customer.
twoFactorToken required | string <= 6 characters two factor token to verify login |
token required | string The token to validate the step. |
os | string <= 100 characters operating system session was created on |
browser | string <= 200 characters browser session was created in |
source | string <= 200 characters source domain or app name |
sourceUrl | string <= 2000 characters source url |
ipAddress | string <= 45 characters ip address |
country | string <= 2 characters country code formatted as ISO 3166-1 alpha-2 |
{- "twoFactorToken": "string",
- "token": "string",
- "os": "string",
- "browser": "string",
- "source": "string",
- "sourceUrl": "string",
- "ipAddress": "string",
- "country": "st"
}
{- "token": "0ujsszwN8NRY24YaXiTIE2VWDTS",
- "companyId": "aHgTmlZgnSQ6LpzkRGvK",
- "nextStep": "RESET_PASSWORD"
}
This functionality validates the password reset of a customer.
password required | string <= 100 characters new password of the customer |
token required | string The token to validate the step. |
os | string <= 100 characters operating system session was created on |
browser | string <= 200 characters browser session was created in |
source | string <= 200 characters source domain or app name |
sourceUrl | string <= 2000 characters source url |
ipAddress | string <= 45 characters ip address |
country | string <= 2 characters country code formatted as ISO 3166-1 alpha-2 |
{- "password": "string",
- "token": "string",
- "os": "string",
- "browser": "string",
- "source": "string",
- "sourceUrl": "string",
- "ipAddress": "string",
- "country": "st"
}
{- "token": "0ujsszwN8NRY24YaXiTIE2VWDTS",
- "companyId": "aHgTmlZgnSQ6LpzkRGvK",
- "nextStep": "ADDITIONAL_DATA",
- "additionalInformation": {
- "USERNAME": true,
- "NAME": true,
- "TERM": "Newest terms to accept"
}
}
Add missing customer data like username, first name and last name to the customer if requested by process. Only data that are actively requested can be set here.
companyId required | string <= 20 characters Id of the company the process is running for. |
nextStep | string Enum: "ADDITIONAL_DATA" "RESET_PASSWORD" "TWO_FACTOR" The next step the process should go to. |
twoFactorBarCodeImage | string base64 encoded bar code image to show to the user if step is two factor verification |
verificationToken | string verification token sent to user via email if next step requires a verification |
additionalInformation | object additional information depending on the next step |
token required | string The token to validate the step. |
{- "stepToken": "0ujsszwN8NRY24YaXiTIE2VWDTS",
- "username": "user1",
- "firstName": "John",
- "lastName": "Doe",
- "browser": "Firefox",
- "os": "Windows 10",
- "source": "Web",
- "ipAddress": "127.0.0.1",
- "country": "DE"
}
{- "customerSession": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}
Removes one or all active sessions of a customer. If a session id is provided the specific session will be removed otherwise all active sessions will be removed.
removalToken required | string <= 40 characters token for the temporary removal session |
sessionId | string <= 40 characters id of the session |
{- "customerSession": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}
This functionality sends the password forgotten token to reset password.
string <= 100 characters email of the customer - required if username is not provided | |
username | string <= 100 characters username of the customer - required if email is not provided |
language required | string <= 2 characters language of the customer |
verificationUrl | string <= 500 characters url to verify registration - if provided two parameters are added to the url (token and step) and it is passed to the registration mail. This way the application that embeds the plenigo registration from can handle a user verification via link instead of a token process. |
os | string <= 100 characters operating system session was created on |
browser | string <= 200 characters browser session was created in |
source | string <= 200 characters source domain or app name |
sourceUrl | string <= 2000 characters source url |
ipAddress | string <= 45 characters ip address |
country | string <= 2 characters country code formatted as ISO 3166-1 alpha-2 |
{- "email": "test@example.com",
- "language": "de",
- "browser": "Firefox",
- "os": "Windows 10",
- "source": "Web",
- "ipAddress": "127.0.0.1",
- "country": "DE"
}
{- "token": "0ujsszwN8NRY24YaXiTIE2VWDTS",
- "companyId": "aHgTmlZgnSQ6LpzkRGvK",
- "nextStep": "VERIFY_TOKEN",
- "verificationToken": "123456"
}
This functionality resend the password forgotten token to reset password.
token required | string The token to validate the step. |
os | string <= 100 characters operating system session was created on |
browser | string <= 200 characters browser session was created in |
source | string <= 200 characters source domain or app name |
sourceUrl | string <= 2000 characters source url |
ipAddress | string <= 45 characters ip address |
country | string <= 2 characters country code formatted as ISO 3166-1 alpha-2 |
{- "token": "0ujsszwN8NRY24YaXiTIE2VWDTS",
- "browser": "Firefox",
- "os": "Windows 10",
- "source": "Web",
- "ipAddress": "127.0.0.1",
- "country": "DE"
}
{- "token": "0ujsszwN8NRY24YaXiTIE2VWDTS",
- "companyId": "aHgTmlZgnSQ6LpzkRGvK",
- "nextStep": "VERIFY_TOKEN",
- "verificationToken": "123456"
}
This functionality verifies the token to reset password.
verificationToken required | string <= 6 characters email verification token |
token required | string The token to validate the step. |
{- "verificationToken": "string",
- "token": "string"
}
{- "token": "0ujsszwN8NRY24YaXiTIE2VWDTS",
- "companyId": "aHgTmlZgnSQ6LpzkRGvK",
- "nextStep": "RESET_PASSWORD"
}
This functionality resets the password of the customer.
password required | string <= 100 characters new password of the customer |
token required | string The token to validate the step. |
os | string <= 100 characters operating system session was created on |
browser | string <= 200 characters browser session was created in |
source | string <= 200 characters source domain or app name |
sourceUrl | string <= 2000 characters source url |
ipAddress | string <= 45 characters ip address |
country | string <= 2 characters country code formatted as ISO 3166-1 alpha-2 |
{- "password": "string",
- "token": "string",
- "os": "string",
- "browser": "string",
- "source": "string",
- "sourceUrl": "string",
- "ipAddress": "string",
- "country": "st"
}
{- "token": "0ujsszwN8NRY24YaXiTIE2VWDTS",
- "companyId": "aHgTmlZgnSQ6LpzkRGvK",
- "nextStep": "ADDITIONAL_DATA",
- "additionalInformation": {
- "USERNAME": true,
- "NAME": true,
- "TERM": "Newest terms to accept"
}
}
This functionality verifies the two factor of the customer.
twoFactorToken required | string <= 6 characters two factor token to verify the customer |
token required | string The token to validate the step. |
{- "twoFactorToken": "string",
- "token": "string"
}
{- "token": "0ujsszwN8NRY24YaXiTIE2VWDTS",
- "companyId": "aHgTmlZgnSQ6LpzkRGvK",
- "nextStep": "VERIFY_TOKEN",
- "verificationToken": "123456"
}
Add missing customer data like username, first name and last name to the customer if requested by process. Only data that are actively requested can be set here.
object (StepToken) | |
username | string <= 100 characters username of the new customer |
firstName | string <= 100 characters first name of the new customer |
lastName | string <= 100 characters last name of the new customer |
object (LoggingData) |
{- "stepToken": "0ujsszwN8NRY24YaXiTIE2VWDTS",
- "username": "user1",
- "firstName": "John",
- "lastName": "Doe",
- "browser": "Firefox",
- "os": "Windows 10",
- "source": "Web",
- "ipAddress": "127.0.0.1",
- "country": "DE"
}
{- "activeSessions": {
- "items": [
- {
- "sessionId": "93jsszwN8NRY24YaXiTIE2VWDMM",
- "os": "Windows 10",
- "browser": "Firefox",
- "createdAt": "2019-03-21T17:32:12Z"
}, - {
- "sessionId": "63jsszwN8NRY24YaXiTIE2VWDZZ",
- "os": "Windows 10",
- "browser": "Chrome",
- "createdAt": "2020-02-21T17:32:12Z"
}
]
}, - "removalToken": "2ujsszwN8NRY24YaXiTIE2VWDTE"
}
Removes one or all active sessions of a customer. If a session id is provided the specific session will be removed otherwise all active sessions will be removed.
removalToken required | string <= 40 characters token for the temporary removal session |
sessionId | string <= 40 characters id of the session |
{- "customerSession": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}
Get settings for configuring the SSO and checkout part.
language | string = 2 characters language of the request - two letter language code according to ISO 639-1 |
plenigoCheckoutDesignId | string plenigo checkout design id |
{- "designs": {
- "backgroundColor": "#d92020",
- "firstColor": "#0e30dd",
- "secondColor": "#18e71f",
- "font": "",
- "fontColor": "#322f2f",
- "linkColor": "#000000",
- "snippetCss": "body {\\r\\n color: green;\\r\\n}\\r\\nbutton {\\r\\n background: red;\\r\\n color: white;\\r\\n}",
- "snippetJavaScript": ""
}, - "settings": {
- "tokenType": "EMAIL",
- "tokenSmsCountries": [ ],
- "allowedDomains": "",
- "ssoName": "NONE",
- "ssoRecheckTerms": true,
- "ssoOptIn": false,
- "checkoutOptIn": false,
- "invoiceAddressRequired": true,
- "deliveryAddressRequired": true,
- "forceUsername": true,
- "maxSessions": 1,
- "additionalCheckoutText": "",
- "contractorText": "",
- "ssoOptInText": "I want all newsletters.",
- "checkoutOptInText": "",
- "ssoTermText": "Term text",
- "checkoutTermText": "Term text"
}
}
This functionality starts the registration process for a new customer. If address data will be provided a new invoice address will be created - country is mandatory for an address. If only the first and the last name are provided the first and last name of the customer will be filled.
username | string <= 100 characters username of the new customer |
email required | string <= 100 characters email of the new customer |
password required | string <= 100 characters password of the new customer |
language required | string <= 2 characters language of the new customer |
mobileNumber | string <= 100 characters mobile number of the new customer |
ipAddress | string <= 100 characters IP address of the new customer |
customerNotification | boolean flag indicating if a mail or SMS should be send to the customer. |
firstName | string <= 100 characters first name of the new customer |
lastName | string <= 100 characters last name of the new customer |
verificationUrl | string <= 500 characters url to verify registration - if provided two parameters are added to the url (token and step) and it is passed to the registration mail. This way the application that embeds the plenigo registration from can handle a user verification via link instead of a token process. |
object (AddressChange) | |
object (AddressChange) |
{- "username": "string",
- "email": "string",
- "password": "string",
- "language": "st",
- "mobileNumber": "string",
- "ipAddress": "string",
- "customerNotification": true,
- "firstName": "string",
- "lastName": "string",
- "verificationUrl": "string",
- "invoiceAddress": {
- "preferred": true,
- "businessAddress": true,
- "salutation": "DIVERSE",
- "title": "string",
- "firstName": "string",
- "lastName": "string",
- "companyName": "string",
- "additionalCompanyInfo": "string",
- "street": "string",
- "streetNumber": "string",
- "additionalStreetInfo": "string",
- "postbox": "string",
- "postcode": "string",
- "city": "string",
- "state": "st",
- "country": "st",
- "vatNumber": "string",
- "phoneNumber": "string",
- "deliveryInformation": "string",
- "academicTitle": "string",
- "jobPosition": "string",
- "validationStatus": "NONE",
- "validationHash": "string"
}, - "deliveryAddress": {
- "preferred": true,
- "businessAddress": true,
- "salutation": "DIVERSE",
- "title": "string",
- "firstName": "string",
- "lastName": "string",
- "companyName": "string",
- "additionalCompanyInfo": "string",
- "street": "string",
- "streetNumber": "string",
- "additionalStreetInfo": "string",
- "postbox": "string",
- "postcode": "string",
- "city": "string",
- "state": "st",
- "country": "st",
- "vatNumber": "string",
- "phoneNumber": "string",
- "deliveryInformation": "string",
- "academicTitle": "string",
- "jobPosition": "string",
- "validationStatus": "NONE",
- "validationHash": "string"
}
}
{- "token": "0ujsszwN8NRY24YaXiTIE2VWDTS",
- "companyId": "aHgTmlZgnSQ6LpzkRGvK",
- "nextStep": "EMAIL",
- "verificationToken": "123456"
}
This functionality finishes the registration process by providing a token.
verificationToken required | string <= 6 characters token to verify registration |
token required | string The token to validate the step. |
os | string <= 100 characters operating system session was created on |
browser | string <= 200 characters browser session was created in |
source | string <= 200 characters source domain or app name |
sourceUrl | string <= 2000 characters source url |
ipAddress | string <= 45 characters ip address |
country | string <= 2 characters country code formatted as ISO 3166-1 alpha-2 |
{- "verificationToken": "string",
- "token": "string",
- "os": "string",
- "browser": "string",
- "source": "string",
- "sourceUrl": "string",
- "ipAddress": "string",
- "country": "st"
}
{- "customerSession": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}
This functionality resend the registration process token.
token required | string The token to validate the step. |
{- "token": "string"
}
{- "token": "0ujsszwN8NRY24YaXiTIE2VWDTS",
- "companyId": "aHgTmlZgnSQ6LpzkRGvK",
- "nextStep": "EMAIL",
- "verificationToken": "123456"
}
This functionality starts the registration process for an existing customer with registration identifier.
username | string <= 100 characters username of the new customer |
string <= 100 characters email of the new customer | |
password | string <= 100 characters password of the new customer |
language | string <= 2 characters language of the new customer |
mobileNumber | string <= 100 characters mobile number of the new customer |
ipAddress | string <= 100 characters IP address of the new customer |
customerNotification | boolean flag indicating if a mail or SMS should be send to the customer |
firstName | string <= 100 characters first name of the new customer |
lastName | string <= 100 characters last name of the new customer |
object (AddressChange) | |
object (AddressChange) | |
customerId | string^[0-9]{1,18}$ customer id of the existing customer |
subscriptionId | integer <int64> subscription id of the existing subscription - if also a customer id is provided the customer id must match the invoice customer id of the subscription |
postcode | string <= 100 characters postcode of a customer's address - if multiple address information are requested all must belong to one address |
street | string <= 100 characters street of a customer's address - if multiple address information are requested all must belong to one address |
streetNumber | string <= 100 characters street number of a customer's address - if multiple address information are requested all must belong to one address |
city | string <= 100 characters city of a customer's address - if multiple address information are requested all must belong to one address |
{- "username": "string",
- "email": "string",
- "password": "string",
- "language": "st",
- "mobileNumber": "string",
- "ipAddress": "string",
- "customerNotification": true,
- "firstName": "string",
- "lastName": "string",
- "invoiceAddress": {
- "preferred": true,
- "businessAddress": true,
- "salutation": "DIVERSE",
- "title": "string",
- "firstName": "string",
- "lastName": "string",
- "companyName": "string",
- "additionalCompanyInfo": "string",
- "street": "string",
- "streetNumber": "string",
- "additionalStreetInfo": "string",
- "postbox": "string",
- "postcode": "string",
- "city": "string",
- "state": "st",
- "country": "st",
- "vatNumber": "string",
- "phoneNumber": "string",
- "deliveryInformation": "string",
- "academicTitle": "string",
- "jobPosition": "string",
- "validationStatus": "NONE",
- "validationHash": "string"
}, - "deliveryAddress": {
- "preferred": true,
- "businessAddress": true,
- "salutation": "DIVERSE",
- "title": "string",
- "firstName": "string",
- "lastName": "string",
- "companyName": "string",
- "additionalCompanyInfo": "string",
- "street": "string",
- "streetNumber": "string",
- "additionalStreetInfo": "string",
- "postbox": "string",
- "postcode": "string",
- "city": "string",
- "state": "st",
- "country": "st",
- "vatNumber": "string",
- "phoneNumber": "string",
- "deliveryInformation": "string",
- "academicTitle": "string",
- "jobPosition": "string",
- "validationStatus": "NONE",
- "validationHash": "string"
}, - "customerId": "string",
- "subscriptionId": 0,
- "postcode": "string",
- "street": "string",
- "streetNumber": "string",
- "city": "string"
}
{- "token": "0ujsszwN8NRY24YaXiTIE2VWDTS",
- "companyId": "aHgTmlZgnSQ6LpzkRGvK",
- "nextStep": "EMAIL",
- "verificationToken": "123456"
}
This functionality finishes the registration process with registration identifier by providing a token.
verificationToken required | string <= 6 characters token to verify registration |
token required | string The token to validate the step. |
os | string <= 100 characters operating system session was created on |
browser | string <= 200 characters browser session was created in |
source | string <= 200 characters source domain or app name |
sourceUrl | string <= 2000 characters source url |
ipAddress | string <= 45 characters ip address |
country | string <= 2 characters country code formatted as ISO 3166-1 alpha-2 |
{- "verificationToken": "string",
- "token": "string",
- "os": "string",
- "browser": "string",
- "source": "string",
- "sourceUrl": "string",
- "ipAddress": "string",
- "country": "st"
}
{- "customerSession": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}
This functionality resend the registration process registration identifier token.
token required | string The token to validate the step. |
{- "token": "string"
}
{- "token": "0ujsszwN8NRY24YaXiTIE2VWDTS",
- "companyId": "aHgTmlZgnSQ6LpzkRGvK",
- "nextStep": "EMAIL",
- "verificationToken": "123456"
}
This functionality verifies the log in data of a customer over a sso provider and executes the log in. The caller must decide if a customer name or email address is provided for login. If both are provided only the email address will be used.
language | string <= 2 characters language of the customer |
ssoProvider required | string Value: "GOOGLE" sso provider name |
required | object (GoogleSsoAuthentication) |
os | string <= 100 characters operating system session was created on |
browser | string <= 200 characters browser session was created in |
source | string <= 200 characters source domain or app name |
sourceUrl | string <= 2000 characters source url |
ipAddress | string <= 45 characters ip address |
country | string <= 2 characters country code formatted as ISO 3166-1 alpha-2 |
{- "language": "st",
- "ssoProvider": "GOOGLE",
- "authenticationData": {
- "idToken": "string"
}, - "os": "string",
- "browser": "string",
- "source": "string",
- "sourceUrl": "string",
- "ipAddress": "string",
- "country": "st"
}
{- "token": "0ujsszwN8NRY24YaXiTIE2VWDTS",
- "companyId": "aHgTmlZgnSQ6LpzkRGvK",
- "nextStep": "TWO_FACTOR"
}
Search all age rules that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
{- "items": [
- {
- "ageRuleId": 0,
- "internalTitle": "string",
- "description": "string",
- "relationalOperator": "ABOVE",
- "age": 1,
- "protectedPlenigoOfferId": "string",
- "followUpPlenigoOfferId": "string",
- "replacementPlenigoOfferId": "string",
- "stopOnFail": true,
- "translations": [
- {
- "language": "st",
- "title": "string",
- "preDescription": "string",
- "successDescription": "string",
- "failureDescription": "string",
- "preferred": true,
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
]
}
Get age rule that is identified by the passed age rule id.
ageRuleId required | integer <int64> unique id of the age rule |
{- "ageRuleId": 0,
- "internalTitle": "string",
- "description": "string",
- "relationalOperator": "ABOVE",
- "age": 1,
- "protectedPlenigoOfferId": "string",
- "followUpPlenigoOfferId": "string",
- "replacementPlenigoOfferId": "string",
- "stopOnFail": true,
- "translations": [
- {
- "language": "st",
- "title": "string",
- "preDescription": "string",
- "successDescription": "string",
- "failureDescription": "string",
- "preferred": true,
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Search all bonuses that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
plenigoBonusId | string plenigo bonus id of the offer |
{- "items": [
- {
- "accessRightId": 223001,
- "archived": true,
- "availability": "AVAILABLE",
- "taxType": "ADVERTISEMENT",
- "bonusId": 123400,
- "costCenterId": 123001,
- "deliveryAddressMandatory": true,
- "deliveryAmount": 1,
- "deliveryCondition": "AFTER_PAYMENT",
- "description": "The cheapest teacup we have in stock.",
- "internalTitle": "Teacup",
- "invoiceAddressMandatory": true,
- "plenigoBonusId": "BO_12345678901234567",
- "priceIssueId": 323001,
- "shippingCostPriceIssueId": 323002,
- "receiver": "PAYER",
- "translations": [
- {
- "conditions": "You have to be a customer for at least three days.",
- "description": "A modern high quality teacup.",
- "images": [
- {
- "addonTranslationImageId": 100324,
- "altText": "A very nice promotion",
- "image": [
- 0
], - "metaData": null,
- "name": "Promotion image",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "language": "en",
- "preferred": true,
- "title": "Teacup",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
]
}
Search all archived bonuses that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
{- "items": [
- {
- "accessRightId": 223001,
- "archived": true,
- "availability": "AVAILABLE",
- "taxType": "ADVERTISEMENT",
- "bonusId": 123400,
- "costCenterId": 123001,
- "deliveryAddressMandatory": true,
- "deliveryAmount": 1,
- "deliveryCondition": "AFTER_PAYMENT",
- "description": "The cheapest teacup we have in stock.",
- "internalTitle": "Teacup",
- "invoiceAddressMandatory": true,
- "plenigoBonusId": "BO_12345678901234567",
- "priceIssueId": 323001,
- "shippingCostPriceIssueId": 323002,
- "receiver": "PAYER",
- "translations": [
- {
- "conditions": "You have to be a customer for at least three days.",
- "description": "A modern high quality teacup.",
- "images": [
- {
- "addonTranslationImageId": 100324,
- "altText": "A very nice promotion",
- "image": [
- 0
], - "metaData": null,
- "name": "Promotion image",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "language": "en",
- "preferred": true,
- "title": "Teacup",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
]
}
Get bonus that is identified by the passed bonus id.
bonusId required | integer <int64> unique id of the bonus |
{- "accessRightId": 223001,
- "archived": true,
- "availability": "AVAILABLE",
- "taxType": "ADVERTISEMENT",
- "bonusId": 123400,
- "costCenterId": 123001,
- "deliveryAddressMandatory": true,
- "deliveryAmount": 1,
- "deliveryCondition": "AFTER_PAYMENT",
- "description": "The cheapest teacup we have in stock.",
- "internalTitle": "Teacup",
- "invoiceAddressMandatory": true,
- "plenigoBonusId": "BO_12345678901234567",
- "priceIssueId": 323001,
- "shippingCostPriceIssueId": 323002,
- "receiver": "PAYER",
- "translations": [
- {
- "conditions": "You have to be a customer for at least three days.",
- "description": "A modern high quality teacup.",
- "images": [
- {
- "addonTranslationImageId": 100324,
- "altText": "A very nice promotion",
- "image": [
- 0
], - "metaData": null,
- "name": "Promotion image",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "language": "en",
- "preferred": true,
- "title": "Teacup",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Search all cross sellings that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
{- "items": [
- {
- "crossSellingId": 18001,
- "internalTitle": "Update to best product",
- "description": "We offer our customers the best product.",
- "accessStart": "NOW",
- "optional": false,
- "sourceProductTags": [
- {
- "productTagId": 270001,
- "name": "Source product",
- "category": "FLOW",
- "description": "Identifies the source product."
}
], - "targetProductTags": [
- {
- "productTagId": 270003,
- "name": "Target product",
- "category": "FLOW",
- "description": "Identifies the target product."
}
], - "translations": [
- {
- "language": "en",
- "title": "You change to product XYZ",
- "description": "Enjoy the advantages of product XYZ.",
- "preferred": true
}
]
}
]
}
Get cross selling that is identified by the passed cross selling id.
crossSellingId required | integer <int64> unique id of the cross selling |
{- "crossSellingId": 18001,
- "internalTitle": "Update to best product",
- "description": "We offer our customers the best product.",
- "accessStart": "NOW",
- "optional": false,
- "sourceProductTags": [
- {
- "productTagId": 270001,
- "name": "Source product",
- "category": "FLOW",
- "description": "Identifies the source product."
}
], - "targetProductTags": [
- {
- "productTagId": 270003,
- "name": "Target product",
- "category": "FLOW",
- "description": "Identifies the target product."
}
], - "translations": [
- {
- "language": "en",
- "title": "You change to product XYZ",
- "description": "Enjoy the advantages of product XYZ.",
- "preferred": true
}
]
}
Search all delivery lists that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "deliveryListId": 37000,
- "title": "Cool magazine",
- "type": "ANALOG",
- "description": "The best magazine ever!",
- "fileNamePart": "cool_magazine.csv",
- "checkReminderReceivers": "test@example.com",
- "checkDateIntervalWeeks": 32,
- "enabled": true
}
]
}
Get delivery list that is identified by the passed delivery list id.
deliveryListId required | integer <int64> unique id of the delivery list |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "deliveryListId": 37000,
- "title": "Cool magazine",
- "type": "ANALOG",
- "description": "The best magazine ever!",
- "fileNamePart": "cool_magazine.csv",
- "checkReminderReceivers": "test@example.com",
- "checkDateIntervalWeeks": 32,
- "enabled": true
}
Get delivery list dates that belong to the delivery list identified by the passed delivery list id.
deliveryListId required | integer <int64> unique id of the delivery list |
ignorePast | boolean flag indicating if past delivery dates should be ignored |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "deliveryListDateId": 37000,
- "title": "First edition 2019",
- "publishingDate": "2019-03-21",
- "deliveryDate": "2019-03-15",
- "redeliveryDate": "2019-03-20",
- "deliveryListCreatedAt": "2019-03-15T00:32:12Z",
- "redeliveryListCreatedAt": "2019-03-20T00:39:12Z"
}
]
}
Update the status of a delivery list date.
deliveryListId required | integer <int64> unique id of the delivery list |
deliveryListDateId required | integer <int64> unique id of the delivery list date |
status required | string Enum: "AVAILABLE" "SOLD_OUT" status of a delivery list date |
{- "status": "AVAILABLE"
}
{- "deliveryListCreatedAt": "2019-08-24T14:15:22Z",
- "redeliveryListCreatedAt": "2019-08-24T14:15:22Z",
- "deliveryListDateId": 0,
- "title": "string",
- "costCenter": "string",
- "purchaseNumber": "string",
- "publishingDate": "2019-08-24T14:15:22Z",
- "deliveryDate": "2019-08-24T14:15:22Z",
- "redeliveryDate": "2019-08-24T14:15:22Z",
- "additionalData": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}, - "translations": [
- [
- {
- "language": "st",
- "title": "string",
- "description": "string",
- "preferred": true
}
]
], - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Search all ivw rules that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
{- "items": [
- {
- "ivwRuleId": 17001,
- "title": "A new ivw rule",
- "internalTitle": "A new ivw rule",
- "description": "Ivw rule description",
- "ivwType": "ABONNEMENT",
- "ivwPriceType": "PERIOD_BASED",
- "fullPriceDivergenceUp": 10,
- "fullPriceDivergenceDown": 5,
- "fullPriceIssueId": 12001,
- "otherSalePriceDivergenceDown": 5,
- "otherSalePriceIssueId": 12001
}
]
}
Get ivw rule that is identified by the passed ivw rule id.
ivwRuleId required | integer <int64> unique id of the ivw rule |
{- "ivwRuleId": 17001,
- "title": "A new ivw rule",
- "internalTitle": "A new ivw rule",
- "description": "Ivw rule description",
- "ivwType": "ABONNEMENT",
- "ivwPriceType": "PERIOD_BASED",
- "fullPriceDivergenceUp": 10,
- "fullPriceDivergenceDown": 5,
- "fullPriceIssueId": 12001,
- "otherSalePriceDivergenceDown": 5,
- "otherSalePriceIssueId": 12001
}
Search all misuse rules that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "misuseRuleId": 17001,
- "internalTitle": "A new misuse rule",
- "description": "Misuse rule",
- "duration": 12,
- "durationTimespan": "MONTH",
- "plenigoOfferId": "O_123456789123456789",
- "translations": [
- {
- "language": "en",
- "title": "Already used",
- "description": "Please buy this product instead.",
- "preferred": true
}
]
}
]
}
Get misuse rule that is identified by the passed misuse rule id.
misuseRuleId required | integer <int64> unique id of the misuse rule |
{- "misuseRuleId": 17001,
- "internalTitle": "A new misuse rule",
- "description": "Misuse rule",
- "duration": 12,
- "durationTimespan": "MONTH",
- "plenigoOfferId": "O_123456789123456789",
- "translations": [
- {
- "language": "en",
- "title": "Already used",
- "description": "Please buy this product instead.",
- "preferred": true
}
]
}
Search all offers that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
plenigoOfferId | string plenigo offer id of the offer |
leafId | integer <int64> unique id of the sort tree leaf |
{- "items": [
- {
- "offerId": 50001,
- "plenigoOfferId": "O_123456789123456789",
- "internalTitle": "A new offer",
- "pauseAble": false,
- "invoiceAddressMandatory": false,
- "deliveryAddressMandatory": false,
- "multiplePurchases": false,
- "misuseRuleId": 17001,
- "archived": false,
- "allowedPaymentMethods": [
- "CREDIT_CARD",
- "BANK_ACCOUNT"
], - "connectedCompanySettings": [
- {
- "connectionInfo": [
- {
- "companyId": "8XYM4WU2V6NJUM5LZ6C9"
}
]
}
], - "translations": [
- {
- "language": "en",
- "title": "Best offer ever",
- "description": "This product is a must have.",
- "legalText": "If you buy it you have it forever. No way to come out.",
- "summaryText": "Click the buy button now.",
- "withdrawalInstruction": "You can withdrawal every time.",
- "preferred": true,
- "images": [
- {
- "imageType": "PRODUCT_CHECKOUT",
- "name": "Cool image",
- "altText": "Alter text"
}
]
}
], - "products": [
- {
- "plenigoProductId": "P_123456789123456789",
- "internalTitle": "A new product",
- "position": 1,
- "taxType": "BOOK",
- "costCenterId": 1230000,
- "option": false,
- "subscription": true,
- "amount": 1,
- "accessRightId": 2000,
- "steps": [
- {
- "plenigoStepId": "S_123456789123456789",
- "position": 1,
- "termPeriod": 3,
- "termTimespan": "MONTH",
- "durationPeriod": 12,
- "durationTimespan": "MONTH",
- "accountingPeriod": 1,
- "accountingTimespan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationTimespan": "DAY",
- "priceIssueId": 2000,
- "translations": null
}
], - "translations": [
- {
- "language": "en",
- "title": "Single product one",
- "description": "This product is single product one.",
- "legalText": "Buy single product one.",
- "summaryText": "Press to buy.",
- "withdrawalInstruction": "You can withdrawal every time.",
- "preferred": true
}
]
}, - {
- "plenigoProductId": "P_223456789123456789",
- "internalTitle": "A new product",
- "position": 2,
- "taxType": "DIGITALNEWSPAPER",
- "costCenterId": 1230002,
- "option": false,
- "subscription": true,
- "amount": 1,
- "accessRightId": 2000,
- "steps": [
- {
- "plenigoStepId": "S_223456789123456789",
- "position": 1,
- "termPeriod": 3,
- "termTimespan": "MONTH",
- "durationPeriod": 12,
- "durationTimespan": "MONTH",
- "accountingPeriod": 1,
- "accountingTimespan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationTimespan": "DAY",
- "priceIssueId": 0
}
], - "translations": [
- {
- "language": "en",
- "title": "Single product two",
- "description": "This product is single product two.",
- "legalText": "Buy single product two.",
- "summaryText": "Press to buy.",
- "withdrawalInstruction": "You can withdrawal every time.",
- "preferred": true
}
]
}
], - "productGroups": [
- {
- "plenigoProductGroupId": "G_123456789123456789",
- "internalTitle": "A new product group",
- "translations": [
- {
- "language": "en",
- "title": "Best product group ever",
- "description": "This product group is a must have.",
- "legalText": "If you buy it you have it forever. No way to come out of this group.",
- "summaryText": "Click the buy button the group now.",
- "withdrawalInstruction": "You can withdrawal every time.",
- "preferred": true
}
], - "products": [
- {
- "plenigoProductId": "P_323456789123456789",
- "internalTitle": "A new product",
- "position": 1,
- "taxType": "DIGITALOFFER",
- "costCenterId": 1230005,
- "option": false,
- "subscription": true,
- "amount": 1,
- "accessRightId": 0,
- "steps": [
- {
- "plenigoStepId": "S_323456789123456789",
- "position": 1,
- "termPeriod": 3,
- "termTimespan": "MONTH",
- "durationPeriod": 12,
- "durationTimespan": "MONTH",
- "accountingPeriod": 1,
- "accountingTimespan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationTimespan": "DAY",
- "priceIssueId": 2000
}
], - "translations": [
- {
- "language": "en",
- "title": "Group product one",
- "description": "This product is group product one.",
- "legalText": "Buy group product one.",
- "summaryText": "Press to buy.",
- "withdrawalInstruction": "You can withdrawal every time.",
- "preferred": true
}
]
}, - {
- "plenigoProductId": "P_423456789123456789",
- "internalTitle": "A new product",
- "position": 2,
- "taxType": "DOWNLOAD",
- "costCenterId": 1230007,
- "option": false,
- "subscription": true,
- "amount": 1,
- "accessRightId": 0,
- "steps": [
- {
- "plenigoStepId": "S_423456789123456789",
- "position": 1,
- "termPeriod": 3,
- "termTimespan": "MONTH",
- "durationPeriod": 12,
- "durationTimespan": "MONTH",
- "accountingPeriod": 1,
- "accountingTimespan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationTimespan": "DAY",
- "priceIssueId": 2000
}
], - "translations": [
- {
- "language": "en",
- "title": "Group product two",
- "description": "This product is group product two.",
- "legalText": "Buy group product two.",
- "summaryText": "Press to buy.",
- "withdrawalInstruction": "You can withdrawal every time.",
- "preferred": true
}
]
}
]
}
]
}
]
}
Search all archived offers that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
plenigoOfferId | string plenigo offer id of the offer |
leafId | integer <int64> unique id of the sort tree leaf |
{- "items": [
- {
- "offerId": 50001,
- "plenigoOfferId": "O_123456789123456789",
- "internalTitle": "A new offer",
- "pauseAble": false,
- "invoiceAddressMandatory": false,
- "deliveryAddressMandatory": false,
- "multiplePurchases": false,
- "misuseRuleId": 17001,
- "archived": false,
- "allowedPaymentMethods": [
- "CREDIT_CARD",
- "BANK_ACCOUNT"
], - "connectedCompanySettings": [
- {
- "connectionInfo": [
- {
- "companyId": "8XYM4WU2V6NJUM5LZ6C9"
}
]
}
], - "translations": [
- {
- "language": "en",
- "title": "Best offer ever",
- "description": "This product is a must have.",
- "legalText": "If you buy it you have it forever. No way to come out.",
- "summaryText": "Click the buy button now.",
- "withdrawalInstruction": "You can withdrawal every time.",
- "preferred": true,
- "images": [
- {
- "imageType": "PRODUCT_CHECKOUT",
- "name": "Cool image",
- "altText": "Alter text"
}
]
}
], - "products": [
- {
- "plenigoProductId": "P_123456789123456789",
- "internalTitle": "A new product",
- "position": 1,
- "taxType": "BOOK",
- "costCenterId": 1230000,
- "option": false,
- "subscription": true,
- "amount": 1,
- "accessRightId": 2000,
- "steps": [
- {
- "plenigoStepId": "S_123456789123456789",
- "position": 1,
- "termPeriod": 3,
- "termTimespan": "MONTH",
- "durationPeriod": 12,
- "durationTimespan": "MONTH",
- "accountingPeriod": 1,
- "accountingTimespan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationTimespan": "DAY",
- "priceIssueId": 2000,
- "translations": null
}
], - "translations": [
- {
- "language": "en",
- "title": "Single product one",
- "description": "This product is single product one.",
- "legalText": "Buy single product one.",
- "summaryText": "Press to buy.",
- "withdrawalInstruction": "You can withdrawal every time.",
- "preferred": true
}
]
}, - {
- "plenigoProductId": "P_223456789123456789",
- "internalTitle": "A new product",
- "position": 2,
- "taxType": "DIGITALNEWSPAPER",
- "costCenterId": 1230002,
- "option": false,
- "subscription": true,
- "amount": 1,
- "accessRightId": 2000,
- "steps": [
- {
- "plenigoStepId": "S_223456789123456789",
- "position": 1,
- "termPeriod": 3,
- "termTimespan": "MONTH",
- "durationPeriod": 12,
- "durationTimespan": "MONTH",
- "accountingPeriod": 1,
- "accountingTimespan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationTimespan": "DAY",
- "priceIssueId": 0
}
], - "translations": [
- {
- "language": "en",
- "title": "Single product two",
- "description": "This product is single product two.",
- "legalText": "Buy single product two.",
- "summaryText": "Press to buy.",
- "withdrawalInstruction": "You can withdrawal every time.",
- "preferred": true
}
]
}
], - "productGroups": [
- {
- "plenigoProductGroupId": "G_123456789123456789",
- "internalTitle": "A new product group",
- "translations": [
- {
- "language": "en",
- "title": "Best product group ever",
- "description": "This product group is a must have.",
- "legalText": "If you buy it you have it forever. No way to come out of this group.",
- "summaryText": "Click the buy button the group now.",
- "withdrawalInstruction": "You can withdrawal every time.",
- "preferred": true
}
], - "products": [
- {
- "plenigoProductId": "P_323456789123456789",
- "internalTitle": "A new product",
- "position": 1,
- "taxType": "DIGITALOFFER",
- "costCenterId": 1230005,
- "option": false,
- "subscription": true,
- "amount": 1,
- "accessRightId": 0,
- "steps": [
- {
- "plenigoStepId": "S_323456789123456789",
- "position": 1,
- "termPeriod": 3,
- "termTimespan": "MONTH",
- "durationPeriod": 12,
- "durationTimespan": "MONTH",
- "accountingPeriod": 1,
- "accountingTimespan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationTimespan": "DAY",
- "priceIssueId": 2000
}
], - "translations": [
- {
- "language": "en",
- "title": "Group product one",
- "description": "This product is group product one.",
- "legalText": "Buy group product one.",
- "summaryText": "Press to buy.",
- "withdrawalInstruction": "You can withdrawal every time.",
- "preferred": true
}
]
}, - {
- "plenigoProductId": "P_423456789123456789",
- "internalTitle": "A new product",
- "position": 2,
- "taxType": "DOWNLOAD",
- "costCenterId": 1230007,
- "option": false,
- "subscription": true,
- "amount": 1,
- "accessRightId": 0,
- "steps": [
- {
- "plenigoStepId": "S_423456789123456789",
- "position": 1,
- "termPeriod": 3,
- "termTimespan": "MONTH",
- "durationPeriod": 12,
- "durationTimespan": "MONTH",
- "accountingPeriod": 1,
- "accountingTimespan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationTimespan": "DAY",
- "priceIssueId": 2000
}
], - "translations": [
- {
- "language": "en",
- "title": "Group product two",
- "description": "This product is group product two.",
- "legalText": "Buy group product two.",
- "summaryText": "Press to buy.",
- "withdrawalInstruction": "You can withdrawal every time.",
- "preferred": true
}
]
}
]
}
]
}
]
}
Get offer that is identified by the passed offer id.
offerId required | integer <int64> unique id of the offer |
{- "offerId": 50001,
- "plenigoOfferId": "O_123456789123456789",
- "internalTitle": "A new offer",
- "pauseAble": false,
- "invoiceAddressMandatory": false,
- "deliveryAddressMandatory": false,
- "multiplePurchases": false,
- "misuseRuleId": 17001,
- "archived": false,
- "allowedPaymentMethods": [
- "CREDIT_CARD",
- "BANK_ACCOUNT"
], - "connectedCompanySettings": [
- {
- "connectionInfo": [
- {
- "companyId": "8XYM4WU2V6NJUM5LZ6C9"
}
]
}
], - "translations": [
- {
- "language": "en",
- "title": "Best offer ever",
- "description": "This product is a must have.",
- "legalText": "If you buy it you have it forever. No way to come out.",
- "summaryText": "Click the buy button now.",
- "withdrawalInstruction": "You can withdrawal every time.",
- "preferred": true,
- "images": [
- {
- "imageType": "PRODUCT_CHECKOUT",
- "name": "Cool image",
- "altText": "Alter text"
}
]
}
], - "products": [
- {
- "plenigoProductId": "P_123456789123456789",
- "internalTitle": "A new product",
- "position": 1,
- "taxType": "BOOK",
- "costCenterId": 123000,
- "ledgerId": 133000,
- "option": false,
- "subscription": true,
- "amount": 1,
- "accessRightId": 2000,
- "steps": [
- {
- "plenigoStepId": "S_123456789123456789",
- "position": 1,
- "termPeriod": 3,
- "termTimespan": "MONTH",
- "durationPeriod": 12,
- "durationTimespan": "MONTH",
- "accountingPeriod": 1,
- "accountingTimespan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationTimespan": "DAY",
- "priceIssueId": 2000,
- "translations": null
}
], - "translations": [
- {
- "language": "en",
- "title": "Single product one",
- "description": "This product is single product one.",
- "legalText": "Buy single product one.",
- "summaryText": "Press to buy.",
- "withdrawalInstruction": "You can withdrawal every time.",
- "preferred": true
}
]
}, - {
- "plenigoProductId": "P_223456789123456789",
- "internalTitle": "A new product",
- "position": 2,
- "taxType": "DIGITALNEWSPAPER",
- "costCenterId": 1230002,
- "option": false,
- "subscription": true,
- "amount": 1,
- "accessRightId": 2000,
- "steps": [
- {
- "plenigoStepId": "S_223456789123456789",
- "position": 1,
- "termPeriod": 3,
- "termTimespan": "MONTH",
- "durationPeriod": 12,
- "durationTimespan": "MONTH",
- "accountingPeriod": 1,
- "accountingTimespan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationTimespan": "DAY",
- "priceIssueId": 0
}
], - "translations": [
- {
- "language": "en",
- "title": "Single product two",
- "description": "This product is single product two.",
- "legalText": "Buy single product two.",
- "summaryText": "Press to buy.",
- "withdrawalInstruction": "You can withdrawal every time.",
- "preferred": true
}
]
}
], - "productGroups": [
- {
- "plenigoProductGroupId": "G_123456789123456789",
- "internalTitle": "A new product group",
- "translations": [
- {
- "language": "en",
- "title": "Best product group ever",
- "description": "This product group is a must have.",
- "legalText": "If you buy it you have it forever. No way to come out of this group.",
- "summaryText": "Click the buy button the group now.",
- "withdrawalInstruction": "You can withdrawal every time.",
- "preferred": true
}
], - "products": [
- {
- "plenigoProductId": "P_323456789123456789",
- "internalTitle": "A new product",
- "position": 1,
- "taxType": "DIGITALOFFER",
- "costCenterId": 1230005,
- "option": false,
- "subscription": true,
- "amount": 1,
- "accessRightId": 0,
- "steps": [
- {
- "plenigoStepId": "S_323456789123456789",
- "position": 1,
- "termPeriod": 3,
- "termTimespan": "MONTH",
- "durationPeriod": 12,
- "durationTimespan": "MONTH",
- "accountingPeriod": 1,
- "accountingTimespan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationTimespan": "DAY",
- "priceIssueId": 2000
}
], - "translations": [
- {
- "language": "en",
- "title": "Group product one",
- "description": "This product is group product one.",
- "legalText": "Buy group product one.",
- "summaryText": "Press to buy.",
- "withdrawalInstruction": "You can withdrawal every time.",
- "preferred": true
}
]
}, - {
- "plenigoProductId": "P_423456789123456789",
- "internalTitle": "A new product",
- "position": 2,
- "taxType": "DOWNLOAD",
- "costCenterId": 1230007,
- "option": false,
- "subscription": true,
- "amount": 1,
- "accessRightId": 0,
- "steps": [
- {
- "plenigoStepId": "S_423456789123456789",
- "position": 1,
- "termPeriod": 3,
- "termTimespan": "MONTH",
- "durationPeriod": 12,
- "durationTimespan": "MONTH",
- "accountingPeriod": 1,
- "accountingTimespan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationTimespan": "DAY",
- "priceIssueId": 2000
}
], - "translations": [
- {
- "language": "en",
- "title": "Group product two",
- "description": "This product is group product two.",
- "legalText": "Buy group product two.",
- "summaryText": "Press to buy.",
- "withdrawalInstruction": "You can withdrawal every time.",
- "preferred": true
}
]
}
]
}
]
}
Search all price country segments that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "priceCountrySegmentId": 12001,
- "title": "Europa light",
- "priority": 2,
- "description": "Europe with only a few countries",
- "countries": [
- "DE",
- "GB",
- "FR"
], - "archived": false
}
Get price country segment that is identified by the passed price country segment id.
priceCountrySegmentId required | integer <int64> unique id of the price country segment |
{- "priceCountrySegmentId": 12001,
- "title": "Europa light",
- "priority": 2,
- "description": "Europe with only a few countries",
- "countries": [
- "DE",
- "GB",
- "FR"
], - "archived": false
}
Search all price issues that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "priceIssueId": 10001,
- "title": "Price list number one",
- "description": "The first price list for our products",
- "archived": false,
- "priceSegments": [
- {
- "priceSegmentId": 11001,
- "price": 19.99,
- "currency": "EUR",
- "validFrom": "2019-03-21",
- "worldSegment": false,
- "priceCountrySegmentId": 12001,
- "countrySegment": {
- "priceCountrySegmentId": 12001,
- "itle": "Europa light",
- "description": "Europa with only a few countries",
- "countries": [
- "DE",
- "FR"
], - "archived": false
}
}
]
}
]
}
Search all archived price issues that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "priceIssueId": 10001,
- "title": "Price list number one",
- "description": "The first price list for our products",
- "archived": false,
- "priceSegments": [
- {
- "priceSegmentId": 11001,
- "price": 19.99,
- "currency": "EUR",
- "validFrom": "2019-03-21",
- "worldSegment": false,
- "priceCountrySegmentId": 12001,
- "countrySegment": {
- "priceCountrySegmentId": 12001,
- "itle": "Europa light",
- "description": "Europa with only a few countries",
- "countries": [
- "DE",
- "FR"
], - "archived": false
}
}
]
}
]
}
Get price issue that is identified by the passed price issue id.
priceIssueId required | integer <int64> unique id of the price issue |
{- "priceIssueId": 10001,
- "title": "Price list number one",
- "description": "The first price list for our products",
- "archived": false,
- "priceSegments": [
- {
- "priceSegmentId": 11001,
- "price": 19.99,
- "currency": "EUR",
- "validFrom": "2019-03-21",
- "worldSegment": false,
- "countrySegment": {
- "priceCountrySegmentId": 12001,
- "title": "Europa light",
- "description": "Europa with only a few countries",
- "countries": [
- "DE",
- "FR"
], - "archived": false
}
}
]
}
Search all access rights that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "accessRightId": 2000,
- "title": "A new access right",
- "uniqueId": "accessRight",
- "description": "Access right",
- "additionalData": {
- "key": "value"
}
}
]
}
Get access right that is identified by the passed access right id.
accessRightId required | integer <int64> unique id of the access right |
{- "accessRightId": 2000,
- "title": "A new access right",
- "uniqueId": "accessRight",
- "description": "Access right",
- "additionalData": {
- "key": "value"
}
}
Search all product contracts that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
{- "items": [
- {
- "productContractId": 0,
- "archived": true,
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API",
- "priceIssueId": 0,
- "title": "string",
- "leafId": 0,
- "description": "string",
- "contractType": "CREDIT_BASED",
- "productTagIds": [
- 0
], - "ivwRuleId": 0,
- "timeBasedCondition": {
- "termPeriod": 1,
- "termTimespan": "DAY",
- "durationPeriod": 100,
- "durationTimespan": "DAY",
- "accountingPeriod": 1,
- "accountingTimespan": "DAY",
- "cancellationPeriod": 1,
- "cancellationTimespan": "DAY"
}, - "issueBasedCondition": {
- "deliveries": 1,
- "chargeableDeliveries": 1,
- "cancellationType": "ISSUE_BASED",
- "cancellationPeriod": 100,
- "cancellationPeriodTimespan": "DAY",
- "autoRenewalDelivery": true
}, - "creditBasedCondition": {
- "termPeriod": 1,
- "termTimespan": "DAY",
- "durationPeriod": 100,
- "durationTimespan": "DAY",
- "accountingPeriod": 1,
- "accountingTimespan": "DAY",
- "cancellationPeriod": 1,
- "cancellationTimespan": "DAY",
- "creditCount": 0
}
}
]
}
Search all archived product contracts that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
{- "items": [
- {
- "productContractId": 0,
- "archived": true,
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API",
- "priceIssueId": 0,
- "title": "string",
- "leafId": 0,
- "description": "string",
- "contractType": "CREDIT_BASED",
- "productTagIds": [
- 0
], - "ivwRuleId": 0,
- "timeBasedCondition": {
- "termPeriod": 1,
- "termTimespan": "DAY",
- "durationPeriod": 100,
- "durationTimespan": "DAY",
- "accountingPeriod": 1,
- "accountingTimespan": "DAY",
- "cancellationPeriod": 1,
- "cancellationTimespan": "DAY"
}, - "issueBasedCondition": {
- "deliveries": 1,
- "chargeableDeliveries": 1,
- "cancellationType": "ISSUE_BASED",
- "cancellationPeriod": 100,
- "cancellationPeriodTimespan": "DAY",
- "autoRenewalDelivery": true
}, - "creditBasedCondition": {
- "termPeriod": 1,
- "termTimespan": "DAY",
- "durationPeriod": 100,
- "durationTimespan": "DAY",
- "accountingPeriod": 1,
- "accountingTimespan": "DAY",
- "cancellationPeriod": 1,
- "cancellationTimespan": "DAY",
- "creditCount": 0
}
}
]
}
Get product contract that is identified by the passed product contract id.
productContractId required | integer <int64> unique id of the product contract |
{- "productContractId": 0,
- "archived": true,
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API",
- "priceIssueId": 0,
- "title": "string",
- "leafId": 0,
- "description": "string",
- "contractType": "CREDIT_BASED",
- "productTagIds": [
- 0
], - "ivwRuleId": 0,
- "timeBasedCondition": {
- "termPeriod": 1,
- "termTimespan": "DAY",
- "durationPeriod": 100,
- "durationTimespan": "DAY",
- "accountingPeriod": 1,
- "accountingTimespan": "DAY",
- "cancellationPeriod": 1,
- "cancellationTimespan": "DAY"
}, - "issueBasedCondition": {
- "deliveries": 1,
- "chargeableDeliveries": 1,
- "cancellationType": "ISSUE_BASED",
- "cancellationPeriod": 100,
- "cancellationPeriodTimespan": "DAY",
- "autoRenewalDelivery": true
}, - "creditBasedCondition": {
- "termPeriod": 1,
- "termTimespan": "DAY",
- "durationPeriod": 100,
- "durationTimespan": "DAY",
- "accountingPeriod": 1,
- "accountingTimespan": "DAY",
- "cancellationPeriod": 1,
- "cancellationTimespan": "DAY",
- "creditCount": 0
}
}
Search all product tags that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
{- "items": [
- {
- "productTagId": 18001,
- "name": "Action Period",
- "category": "ANALYTICS",
- "description": "Identifies the first action period."
}
]
}
Get product tag that is identified by the passed product tag id.
productTagId required | integer <int64> unique id of the product tag |
{- "productTagId": 18001,
- "name": "Action Period",
- "category": "ANALYTICS",
- "description": "Identifies the first action period."
}
Search all shopping carts that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
plenigoShoppingCartId | string plenigo shopping cart id of the shopping cart |
{- "items": [
- {
- "shoppingCartId": 0,
- "plenigoShoppingCartId": "stringstringstringst",
- "items": [
- {
- "shoppingCartItemId": 0,
- "plenigoOfferId": "stringstringstringst",
- "plenigoBonusId": "stringstringstringst",
- "connectedPlenigoOfferId": "stringstringstringst",
- "connectedOfferCompanyId": "string",
- "position": 1,
- "option": true,
- "defaultSelected": true,
- "offerId": 0,
- "bonus": 0,
- "connectedOfferId": 0,
- "connectedLeadingPlenigoOfferId": "stringstringstringst",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "itemGroups": [
- {
- "shoppingCartItemGroupId": 0,
- "items": [
- {
- "shoppingCartItemId": 0,
- "plenigoOfferId": "stringstringstringst",
- "plenigoBonusId": "stringstringstringst",
- "connectedPlenigoOfferId": "stringstringstringst",
- "connectedOfferCompanyId": "string",
- "position": 1,
- "option": true,
- "defaultSelected": true,
- "offerId": 0,
- "bonus": 0,
- "connectedOfferId": 0,
- "connectedLeadingPlenigoOfferId": "stringstringstringst",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "internalTitle": "string",
- "translations": [
- {
- "language": "st",
- "title": "string",
- "description": "string",
- "legalText": "string",
- "preferred": true,
- "images": [
- {
- "imageType": "PRODUCT_CHECKOUT",
- "name": "string",
- "url": "string",
- "altText": "string",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "internalTitle": "string",
- "translations": [
- {
- "language": "st",
- "title": "string",
- "description": "string",
- "legalText": "string",
- "preferred": true,
- "images": [
- {
- "imageType": "PRODUCT_CHECKOUT",
- "name": "string",
- "url": "string",
- "altText": "string",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "hintTmId": 0,
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
]
}
Search all archived shopping carts that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
{- "items": [
- {
- "shoppingCartId": 0,
- "plenigoShoppingCartId": "stringstringstringst",
- "items": [
- {
- "shoppingCartItemId": 0,
- "plenigoOfferId": "stringstringstringst",
- "plenigoBonusId": "stringstringstringst",
- "connectedPlenigoOfferId": "stringstringstringst",
- "connectedOfferCompanyId": "string",
- "position": 1,
- "option": true,
- "defaultSelected": true,
- "offerId": 0,
- "bonus": 0,
- "connectedOfferId": 0,
- "connectedLeadingPlenigoOfferId": "stringstringstringst",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "itemGroups": [
- {
- "shoppingCartItemGroupId": 0,
- "items": [
- {
- "shoppingCartItemId": 0,
- "plenigoOfferId": "stringstringstringst",
- "plenigoBonusId": "stringstringstringst",
- "connectedPlenigoOfferId": "stringstringstringst",
- "connectedOfferCompanyId": "string",
- "position": 1,
- "option": true,
- "defaultSelected": true,
- "offerId": 0,
- "bonus": 0,
- "connectedOfferId": 0,
- "connectedLeadingPlenigoOfferId": "stringstringstringst",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "internalTitle": "string",
- "translations": [
- {
- "language": "st",
- "title": "string",
- "description": "string",
- "legalText": "string",
- "preferred": true,
- "images": [
- {
- "imageType": "PRODUCT_CHECKOUT",
- "name": "string",
- "url": "string",
- "altText": "string",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "internalTitle": "string",
- "translations": [
- {
- "language": "st",
- "title": "string",
- "description": "string",
- "legalText": "string",
- "preferred": true,
- "images": [
- {
- "imageType": "PRODUCT_CHECKOUT",
- "name": "string",
- "url": "string",
- "altText": "string",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "hintTmId": 0,
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
]
}
Get shopping cart that is identified by the passed shopping cart id.
shoppingCartId required | integer <int64> unique id of the shopping cart |
{- "shoppingCartId": 0,
- "plenigoShoppingCartId": "stringstringstringst",
- "items": [
- {
- "shoppingCartItemId": 0,
- "plenigoOfferId": "stringstringstringst",
- "plenigoBonusId": "stringstringstringst",
- "connectedPlenigoOfferId": "stringstringstringst",
- "connectedOfferCompanyId": "string",
- "position": 1,
- "option": true,
- "defaultSelected": true,
- "offerId": 0,
- "bonus": 0,
- "connectedOfferId": 0,
- "connectedLeadingPlenigoOfferId": "stringstringstringst",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "itemGroups": [
- {
- "shoppingCartItemGroupId": 0,
- "items": [
- {
- "shoppingCartItemId": 0,
- "plenigoOfferId": "stringstringstringst",
- "plenigoBonusId": "stringstringstringst",
- "connectedPlenigoOfferId": "stringstringstringst",
- "connectedOfferCompanyId": "string",
- "position": 1,
- "option": true,
- "defaultSelected": true,
- "offerId": 0,
- "bonus": 0,
- "connectedOfferId": 0,
- "connectedLeadingPlenigoOfferId": "stringstringstringst",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "internalTitle": "string",
- "translations": [
- {
- "language": "st",
- "title": "string",
- "description": "string",
- "legalText": "string",
- "preferred": true,
- "images": [
- {
- "imageType": "PRODUCT_CHECKOUT",
- "name": "string",
- "url": "string",
- "altText": "string",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "internalTitle": "string",
- "translations": [
- {
- "language": "st",
- "title": "string",
- "description": "string",
- "legalText": "string",
- "preferred": true,
- "images": [
- {
- "imageType": "PRODUCT_CHECKOUT",
- "name": "string",
- "url": "string",
- "altText": "string",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "hintTmId": 0,
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Returns all vouchers of the selected channel page, depending on query parameters
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
voucherStatus | string Enum: "ACTIVE" "CANCELLED" "INACTIVE" "DELETED" status of the voucher |
{- "items": [
- {
- "id": 100007,
- "createdDate": "2019-08-13",
- "changedDate": "2019-09-13",
- "changedBy": "P_UZV4L63ZBT",
- "changedByType": "MERCHANT",
- "voucherCode": "HNWN-2ETP-FA97",
- "customData": "Custom data",
- "status": "ACTIVE"
}, - {
- "id": 100008,
- "createdDate": "2019-08-13",
- "changedDate": "2019-09-23",
- "changedBy": "Z2sZV4H63IBT",
- "changedByType": "CUSTOMER",
- "voucherCode": "NVUU-UG7A-T3C3",
- "customData": "Custom data",
- "status": "INACTIVE",
- "orderId": 100001
}
]
}
ASYNC Creates a new voucher campaign with the data provided. ATTENTION - this process is async.
callback | boolean if set to true the call to this endpoint will return a promise ID and creates a new voucher request callback that contains the data provided. The callback also returns the promise ID returned by this call to be identified. |
campaignName required | string <= 200 characters name of the campaign |
voucherType required | string Enum: "MULTI" "SINGLE" represents the type of the vouchers of this campaign |
plenigoOfferId required | string <= 20 characters plenigo offer id the vouchers are for |
startDate required | null or string <date> start date of the campaign with full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21 |
endDate | null or string <date> end date of the campaign with full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21 |
required | Array of objects (ChannelCreation) |
{- "campaignName": "API Campaign Creation",
- "voucherType": "SINGLE",
- "plenigoOfferId": "O_TTA1E7173120881551",
- "startDate": "2019-12-16",
- "endDate": "2099-12-16",
- "channels": [
- {
- "channelName": "API Channel",
- "customData": "Custom data",
- "voucherAmount": 2
}
]
}
{- "items": [
- {
- "campaignId": 100003,
- "changedDate": "2019-09-13",
- "changedBy": "P_UZV4L63ZBT",
- "changedByType": "MERCHANT",
- "campaignName": "Autumn 2019",
- "voucherType": "SINGLE",
- "plenigoOfferId": "O_TTA1E7173120881551",
- "status": "CREATING",
- "startDate": "2019-09-13",
- "channels": [
- {
- "channelId": 100002,
- "changedDate": "2019-09-13",
- "changedBy": "P_UZV4L63ZBT",
- "changedByType": "MERCHANT",
- "channelName": "Internet",
- "customData": "Custom data",
- "voucherAmount": 2,
- "status": "CREATING"
}
]
}
]
}
Search all campaigns that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
voucherCode | string voucher code to get |
{- "items": [
- {
- "startingAfter": 0,
- "size": 10,
- "totalSize": 1,
- "campaigns": [
- {
- "campaignId": 100003,
- "changedDate": "2019-09-13",
- "changedBy": "P_UZV4L63ZBT",
- "changedByType": "MERCHANT",
- "campaignName": "Autumn 2019",
- "voucherType": "SINGLE",
- "plenigoOfferId": "O_TTA1E7173120881551",
- "status": "ACTIVE",
- "startDate": "2019-09-13",
- "channels": [
- {
- "channelId": 100002,
- "changedDate": "2019-09-13",
- "changedBy": "P_UZV4L63ZBT",
- "changedByType": "MERCHANT",
- "channelName": "Internet",
- "customData": "Custom data",
- "voucherAmount": 2,
- "status": "ACTIVE"
}
]
}
]
}
]
}
Get campaign that is identified by the passed campaign id.
campaignId required | string unique id of the campaign |
{- "items": [
- {
- "campaignId": 100003,
- "changedDate": "2019-09-13",
- "changedBy": "P_UZV4L63ZBT",
- "changedByType": "MERCHANT",
- "campaignName": "Autumn 2019",
- "voucherType": "SINGLE",
- "plenigoOfferId": "O_TTA1E7173120881551",
- "status": "ACTIVE",
- "startDate": "2019-09-13",
- "channels": [
- {
- "channelId": 100002,
- "changedDate": "2019-09-13",
- "changedBy": "P_UZV4L63ZBT",
- "changedByType": "MERCHANT",
- "channelName": "Internet",
- "customData": "Custom data",
- "voucherAmount": 2,
- "status": "ACTIVE",
- "vouchers": [
- {
- "id": 100007,
- "createdDate": "2019-08-13",
- "changedDate": "2019-09-13",
- "changedBy": "P_UZV4L63ZBT",
- "changedByType": "MERCHANT",
- "voucherCode": "HNWN-2ETP-FA97",
- "customData": "Custom data",
- "status": "ACTIVE"
}, - {
- "id": 100008,
- "createdDate": "2019-08-13",
- "changedDate": "2019-09-23",
- "changedBy": "Z2sZV4H63IBT",
- "changedByType": "CUSTOMER",
- "voucherCode": "NVUU-UG7A-T3C3",
- "customData": "Custom data",
- "status": "INACTIVE",
- "orderId": 100001
}
]
}
]
}
]
}
ASYNC Update channel that is identified by the passed channel id. ATTENTION - this process is async.
channelId required | string unique id of the channel |
callback | boolean if set to true the call to this endpoint will return a promise ID and creates a new voucher request callback that contains the data provided. The callback also returns the promise ID returned by this call to be identified. |
channelName | string <= 200 characters name of the channel |
customData | string <= 200 characters free text field |
voucherAmount | integer [ 0 .. 10000000 ] represents the amount of vouchers to create for this channel |
{- "channelName": "New API Channel",
- "customData": "New Custom data",
- "voucherAmount": 1
}
{- "items": [
- {
- "channelId": 100002,
- "contractCompanyId": "xhzTmlZgnSQ6LpzkRGvK",
- "companyId": "aHgTmlZgnSQ6LpzkRGvK",
- "changedDate": "2019-09-13",
- "changedBy": "P_UZV4L63ZBT",
- "changedByType": "MERCHANT",
- "channelName": "Internet",
- "customData": "Custom data",
- "voucherAmount": 2,
- "status": "UPDATING",
- "vouchers": [
- {
- "id": 100007,
- "createdDate": "2019-08-13",
- "changedDate": "2019-09-13",
- "changedBy": "P_UZV4L63ZBT",
- "changedByType": "MERCHANT",
- "voucherCode": "HNWN-2ETP-FA97",
- "customData": "Custom data",
- "status": "ACTIVE"
}
]
}
]
}
Returns all vouchers of the selected channel page, depending on query parameters
channelId required | string unique id of the channel |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
voucherStatus | string Enum: "ACTIVE" "CANCELLED" "INACTIVE" "DELETED" status of the voucher |
{- "items": [
- {
- "id": 100007,
- "createdDate": "2019-08-13",
- "changedDate": "2019-09-13",
- "changedBy": "P_UZV4L63ZBT",
- "changedByType": "MERCHANT",
- "voucherCode": "HNWN-2ETP-FA97",
- "customData": "Custom data",
- "status": "ACTIVE"
}, - {
- "id": 100008,
- "createdDate": "2019-08-13",
- "changedDate": "2019-09-23",
- "changedBy": "Z2sZV4H63IBT",
- "changedByType": "CUSTOMER",
- "voucherCode": "NVUU-UG7A-T3C3",
- "customData": "Custom data",
- "status": "INACTIVE",
- "orderId": 100001
}
]
}
Validates the voucher code provided.
voucherCode required | string voucher code to validate |
[- {
- "plenigoOfferId": "O_TTA1E7173120881551",
- "status": "ACTIVE"
}
]
Search all Apple purchases that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
token | string app store token |
{- "items": [
- {
- "appleAppStorePurchaseId": 0,
- "purchaseDate": "2019-08-24T14:15:22Z",
- "token": "string",
- "valid": true,
- "appStoreOrderId": 0,
- "receipt": {
- "receiptType": "string",
- "adamID": 0,
- "appItemID": "string",
- "bundleID": "string",
- "applicationVersion": "string",
- "downloadID": 0,
- "versionExternalIdentifier": "string",
- "originalApplicationVersion": "string",
- "receiptCreationDate": "2019-08-24T14:15:22Z",
- "requestDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "items": [
- {
- "quantity": "string",
- "productId": "string",
- "transactionId": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "promotionalOfferId": "string",
- "subscriptionGroupIdentifier": "string",
- "isTrialPeriod": "string",
- "isInIntroOfferPeriod": "string",
- "isUpgraded": "string",
- "expiresDate": "2019-08-24T14:15:22Z",
- "purchaseDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "cancellationReason": "string"
}
]
}, - "purchaseData": {
- "transactions": [
- {
- "transactionID": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "bundleID": "string",
- "productID": "string",
- "subscriptionGroupIdentifier": "string",
- "purchaseDate": 0,
- "originalPurchaseDate": 0,
- "expiresDate": 0,
- "quantity": 0,
- "type": "string",
- "appAccountToken": "string",
- "inAppOwnershipType": "string",
- "signedDate": 0,
- "offerType": 0,
- "offerIdentifier": "string",
- "revocationDate": 0,
- "revocationReason": 0,
- "isUpgraded": true,
- "storefront": "string",
- "storefrontId": "string",
- "transactionReason": "string",
- "environment": "string",
- "price": 0,
- "currency": "string",
- "offerDiscountType": "string"
}
]
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
]
}
Add an Apple app store purchase to the plenigo system and retrieve a token for further processing.
appIdentifier | string <= 100 characters identifier of the application as defined in the plenigo backend to retrieve the according secret |
receiptData | Array of strings [ 1 .. 100 ] items [ items <= 10000 characters ] |
{- "appIdentifier": "string",
- "receiptData": [
- "string"
]
}
{- "purchases": [
- {
- "customerId": "string",
- "token": "string",
- "hasOrders": true,
- "orders": [
- {
- "purchaseDate": "2019-08-24T14:15:22Z",
- "valid": true,
- "accessRightUniqueId": "string",
- "appStoreProductId": "string",
- "accessRights": {
- "items": [
- {
- "uniqueId": "string",
- "additionalData": {
- "property1": {
- "key": null,
- "value": null
}, - "property2": {
- "key": null,
- "value": null
}
}
}
]
}
}
]
}
]
}
Get details for an Apple app store purchase.
appleAppStorePurchaseId required | integer <int64> unique id of the purchase |
{- "appleAppStorePurchaseId": 0,
- "purchaseDate": "2019-08-24T14:15:22Z",
- "token": "string",
- "valid": true,
- "appStoreOrderId": 0,
- "receipt": {
- "receiptType": "string",
- "adamID": 0,
- "appItemID": "string",
- "bundleID": "string",
- "applicationVersion": "string",
- "downloadID": 0,
- "versionExternalIdentifier": "string",
- "originalApplicationVersion": "string",
- "receiptCreationDate": "2019-08-24T14:15:22Z",
- "requestDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "items": [
- {
- "quantity": "string",
- "productId": "string",
- "transactionId": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "promotionalOfferId": "string",
- "subscriptionGroupIdentifier": "string",
- "isTrialPeriod": "string",
- "isInIntroOfferPeriod": "string",
- "isUpgraded": "string",
- "expiresDate": "2019-08-24T14:15:22Z",
- "purchaseDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "cancellationReason": "string"
}
]
}, - "purchaseData": {
- "transactions": [
- {
- "transactionID": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "bundleID": "string",
- "productID": "string",
- "subscriptionGroupIdentifier": "string",
- "purchaseDate": 0,
- "originalPurchaseDate": 0,
- "expiresDate": 0,
- "quantity": 0,
- "type": "string",
- "appAccountToken": "string",
- "inAppOwnershipType": "string",
- "signedDate": 0,
- "offerType": 0,
- "offerIdentifier": "string",
- "revocationDate": 0,
- "revocationReason": 0,
- "isUpgraded": true,
- "storefront": "string",
- "storefrontId": "string",
- "transactionReason": "string",
- "environment": "string",
- "price": 0,
- "currency": "string",
- "offerDiscountType": "string"
}
]
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Associate an Apple app store purchase with a customer. Only app store purchases that include actual orders can be associated.
token required | string unique id of the purchase of an app store |
customerId | string^[0-9]{1,18}$ id of the customer to associate purchase with |
{- "customerId": "string"
}
{- "customerId": "string",
- "token": "string",
- "hasOrders": true,
- "orders": [
- {
- "purchaseDate": "2019-08-24T14:15:22Z",
- "valid": true,
- "accessRightUniqueId": "string",
- "appStoreProductId": "string",
- "accessRights": {
- "items": [
- {
- "uniqueId": "string",
- "additionalData": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}
}
]
}
}
]
}
Verify validity of Apple app store purchase.
token required | string unique id of the purchase of an app store |
{- "purchases": [
- {
- "customerId": "string",
- "token": "string",
- "hasOrders": true,
- "orders": [
- {
- "purchaseDate": "2019-08-24T14:15:22Z",
- "valid": true,
- "accessRightUniqueId": "string",
- "appStoreProductId": "string",
- "accessRights": {
- "items": [
- {
- "uniqueId": "string",
- "additionalData": {
- "property1": {
- "key": null,
- "value": null
}, - "property2": {
- "key": null,
- "value": null
}
}
}
]
}
}
]
}
]
}
Search all Google Playstore purchases that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
token | string app store token |
{- "items": [
- {
- "googlePlayStorePurchaseId": 0,
- "purchaseDate": "2019-08-24T14:15:22Z",
- "token": "string",
- "packageName": "string",
- "productId": "string",
- "valid": true,
- "subscription": true,
- "purchaseToken": "string",
- "appStoreOrderId": 0,
- "subscriptionPurchase": {
- "autoRenewing": true,
- "autoResumeTimeMillis": "string",
- "cancelReason": 0,
- "cancelSurveyReason": 0,
- "userInputCancelReason": "string",
- "subscriptionEndDate": "2019-08-24T14:15:22Z",
- "countryCode": "string",
- "developerPayload": "string",
- "expiryTimeMillis": "string",
- "kind": "string",
- "linkedPurchaseToken": "string",
- "orderId": "string",
- "paymentState": 0,
- "priceAmountMicros": "string",
- "priceCurrencyCode": "string",
- "profileId": "string",
- "profileName": "string",
- "purchaseType": 0,
- "startTimeMillis": "string",
- "userCancellationTimeMillis": "string"
}, - "productPurchase": {
- "acknowledgementState": "string",
- "consumptionState": "string",
- "developerPayload": "string",
- "kind": "string",
- "orderId": "string",
- "purchaseState": "string",
- "purchaseTimeMillis": "string",
- "purchaseType": "string"
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
]
}
Add a Google Playstore purchase to the plenigo system and retrieve a token for further processing.
packageName | string <= 1000 characters package name of the application this purchase was done for (for example, 'com.some.thing'). |
Array of objects (GooglePlayStorePurchaseAdditionElement) [ 1 .. 100 ] items |
{- "packageName": "string",
- "receiptData": [
- {
- "productId": "string",
- "subscription": true,
- "purchaseToken": "string"
}
]
}
{- "customerId": "string",
- "token": "string",
- "hasOrders": true,
- "orders": [
- {
- "purchaseDate": "2019-08-24T14:15:22Z",
- "valid": true,
- "accessRightUniqueId": "string",
- "appStoreProductId": "string",
- "accessRights": {
- "items": [
- {
- "uniqueId": "string",
- "additionalData": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}
}
]
}
}
]
}
Get details for a Google Playstore purchase.
googlePlayStorePurchaseId required | integer <int64> unique id of the purchase |
{- "googlePlayStorePurchaseId": 0,
- "purchaseDate": "2019-08-24T14:15:22Z",
- "token": "string",
- "packageName": "string",
- "productId": "string",
- "valid": true,
- "subscription": true,
- "purchaseToken": "string",
- "appStoreOrderId": 0,
- "subscriptionPurchase": {
- "autoRenewing": true,
- "autoResumeTimeMillis": "string",
- "cancelReason": 0,
- "cancelSurveyReason": 0,
- "userInputCancelReason": "string",
- "subscriptionEndDate": "2019-08-24T14:15:22Z",
- "countryCode": "string",
- "developerPayload": "string",
- "expiryTimeMillis": "string",
- "kind": "string",
- "linkedPurchaseToken": "string",
- "orderId": "string",
- "paymentState": 0,
- "priceAmountMicros": "string",
- "priceCurrencyCode": "string",
- "profileId": "string",
- "profileName": "string",
- "purchaseType": 0,
- "startTimeMillis": "string",
- "userCancellationTimeMillis": "string"
}, - "productPurchase": {
- "acknowledgementState": "string",
- "consumptionState": "string",
- "developerPayload": "string",
- "kind": "string",
- "orderId": "string",
- "purchaseState": "string",
- "purchaseTimeMillis": "string",
- "purchaseType": "string"
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Associate a Google Playstore purchase with a customer.
token required | string unique id of the purchase of an app store |
customerId | string^[0-9]{1,18}$ id of the customer to associate purchase with |
{- "customerId": "string"
}
{- "customerId": "string",
- "token": "string",
- "hasOrders": true,
- "orders": [
- {
- "purchaseDate": "2019-08-24T14:15:22Z",
- "valid": true,
- "accessRightUniqueId": "string",
- "appStoreProductId": "string",
- "accessRights": {
- "items": [
- {
- "uniqueId": "string",
- "additionalData": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}
}
]
}
}
]
}
Verify validity of Google Playstore purchase.
token required | string unique id of the purchase of an app store |
{- "customerId": "string",
- "token": "string",
- "hasOrders": true,
- "orders": [
- {
- "purchaseDate": "2019-08-24T14:15:22Z",
- "valid": true,
- "accessRightUniqueId": "string",
- "appStoreProductId": "string",
- "accessRights": {
- "items": [
- {
- "uniqueId": "string",
- "additionalData": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}
}
]
}
}
]
}
Search all app store orders that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "appStoreOrderId": 0,
- "orderDate": "2019-08-24T14:15:22Z",
- "customerId": "string",
- "storeType": "APPSTORE",
- "additionalStoreData": {
- "receiptType": "string",
- "adamID": 0,
- "appItemID": "string",
- "bundleID": "string",
- "applicationVersion": "string",
- "downloadID": 0,
- "versionExternalIdentifier": "string",
- "originalApplicationVersion": "string",
- "receiptCreationDate": "2019-08-24T14:15:22Z",
- "requestDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "items": [
- {
- "quantity": "string",
- "productId": "string",
- "transactionId": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "promotionalOfferId": "string",
- "subscriptionGroupIdentifier": "string",
- "isTrialPeriod": "string",
- "isInIntroOfferPeriod": "string",
- "isUpgraded": "string",
- "expiresDate": "2019-08-24T14:15:22Z",
- "purchaseDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "cancellationReason": "string"
}
]
}, - "items": [
- {
- "position": 0,
- "deliveryCustomerId": "string",
- "productId": "string",
- "appStoreSubscriptionId": 0,
- "accessRightUniqueId": "string",
- "additionalStoreItemData": {
- "quantity": "string",
- "productId": "string",
- "transactionId": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "promotionalOfferId": "string",
- "subscriptionGroupIdentifier": "string",
- "isTrialPeriod": "string",
- "isInIntroOfferPeriod": "string",
- "isUpgraded": "string",
- "expiresDate": "2019-08-24T14:15:22Z",
- "purchaseDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "cancellationReason": "string"
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
]
}
Get details for an app store order.
appStoreOrderId required | integer <int64> unique id of the app store order |
{- "appStoreOrderId": 0,
- "orderDate": "2019-08-24T14:15:22Z",
- "customerId": "string",
- "storeType": "APPSTORE",
- "additionalStoreData": {
- "receiptType": "string",
- "adamID": 0,
- "appItemID": "string",
- "bundleID": "string",
- "applicationVersion": "string",
- "downloadID": 0,
- "versionExternalIdentifier": "string",
- "originalApplicationVersion": "string",
- "receiptCreationDate": "2019-08-24T14:15:22Z",
- "requestDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "items": [
- {
- "quantity": "string",
- "productId": "string",
- "transactionId": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "promotionalOfferId": "string",
- "subscriptionGroupIdentifier": "string",
- "isTrialPeriod": "string",
- "isInIntroOfferPeriod": "string",
- "isUpgraded": "string",
- "expiresDate": "2019-08-24T14:15:22Z",
- "purchaseDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "cancellationReason": "string"
}
]
}, - "items": [
- {
- "position": 0,
- "deliveryCustomerId": "string",
- "productId": "string",
- "appStoreSubscriptionId": 0,
- "accessRightUniqueId": "string",
- "additionalStoreItemData": {
- "quantity": "string",
- "productId": "string",
- "transactionId": "string",
- "originalTransactionId": "string",
- "webOrderLineItemId": "string",
- "promotionalOfferId": "string",
- "subscriptionGroupIdentifier": "string",
- "isTrialPeriod": "string",
- "isInIntroOfferPeriod": "string",
- "isUpgraded": "string",
- "expiresDate": "2019-08-24T14:15:22Z",
- "purchaseDate": "2019-08-24T14:15:22Z",
- "originalPurchaseDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "cancellationReason": "string"
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
], - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Search all app store subscriptions that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "appStoreSubscriptionId": 0,
- "chainId": 0,
- "externalSystemId": "string",
- "customerId": "string",
- "startDate": "2019-08-24T14:15:22Z",
- "endDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "status": "ACTIVE",
- "accessRightUniqueId": "string",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
]
}
Get details for an app store subscription.
appStoreSubscriptionId required | integer <int64> unique id of the app store subscription |
{- "appStoreSubscriptionId": 0,
- "chainId": 0,
- "externalSystemId": "string",
- "customerId": "string",
- "startDate": "2019-08-24T14:15:22Z",
- "endDate": "2019-08-24T14:15:22Z",
- "cancellationDate": "2019-08-24T14:15:22Z",
- "status": "ACTIVE",
- "accessRightUniqueId": "string",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Search all orders that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
externalSystemId | string external system id defined by third party systems |
{- "items": [
- {
- "orderId": 12200,
- "changedDate": "2019-03-21T17:32:12Z",
- "status": "DONE",
- "type": "ORDER",
- "orderDate": "2019-03-21T17:32:12Z",
- "accumulatedPrice": 12,
- "currency": "EUR",
- "paymentMethod": "PAYPAL",
- "paymentMethodId": 100231,
- "invoiceCustomerId": 100003,
- "invoiceAddress": {
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}, - "items": [
- {
- "position": 1,
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_MZA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "A simple cup",
- "taxType": "PHYSICALPRODUCT",
- "price": 12,
- "tax": 19,
- "taxCountry": "DE",
- "quantity": 12,
- "deliveryCustomerId": "100003",
- "deliveryAddress": {
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
}
]
}
]
}
Search all additional order data that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "affiliateId": "string",
- "partnerId": "string",
- "sourceId": "string",
- "utm": {
- "source": "string",
- "medium": "string",
- "campaign": "string",
- "term": "string",
- "content": "string"
}, - "data": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z"
}
]
}
Get order that is identified by the passed order id.
orderId required | integer <int64> unique id of the order |
{- "orderId": 12200,
- "changedDate": "2019-03-21T17:32:12Z",
- "status": "DONE",
- "type": "ORDER",
- "orderDate": "2019-03-21T17:32:12Z",
- "accumulatedPrice": 12,
- "currency": "EUR",
- "purchaseOrderIndicator": "2019-03A1",
- "paymentMethod": "PAYPAL",
- "paymentMethodId": 100231,
- "invoiceCustomerId": 100003,
- "invoiceAddress": {
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}, - "items": [
- {
- "position": 1,
- "productId": "P_TTA1E7173120881551",
- "plenigoOfferId": "O_MZA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "A simple cup",
- "taxType": "PHYSICALPRODUCT",
- "price": 12,
- "tax": 19,
- "taxCountry": "DE",
- "quantity": 12,
- "deliveryCustomerId": "100003",
- "deliveryAddress": {
- "businessAddress": true,
- "salutation": "MR",
- "title": "Dr",
- "firstName": "John",
- "lastName": "Doe",
- "companyName": "ARAMARK Ltd.",
- "additionalCompanyInfo": "Subdivision of World Ltd.",
- "street": "Commercial Road",
- "streetNumber": "30",
- "additionalStreetInfo": "Level 5",
- "postcode": "PO1 1AA",
- "city": "Hampshire",
- "country": "GB",
- "vatNumber": "DE123456789"
}
}
]
}
Returns additional data associated with the order associated with the provided order id.
orderId required | integer <int64> unique id of the order |
{- "affiliateId": "AID-32473",
- "partnerId": "PartnerOne",
- "utm": {
- "campaign": "product launch",
- "term": "something",
- "content": "Test1"
}, - "data": [
- {
- "key": "value"
}
]
}
Search all purchased addons that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
{- "items": [
- {
- "purchasedAddonId": 0,
- "deliveryCustomerId": "string",
- "addonType": "BONUS",
- "plenigoAddonId": "stringstringstringst",
- "accessRightUniqueId": "string",
- "orderId": 0,
- "orderItemPosition": 0,
- "status": "CANCELLED",
- "deliveryCondition": "AFTER_PAYMENT",
- "deliveryDate": "2019-08-24T14:15:22Z",
- "trackingData": {
- "trackingId": "string",
- "trackingUrl": "string",
- "serviceProvider": "string",
- "sendingDate": "2019-08-24T14:15:22Z",
- "arrivalDate": "2019-08-24T14:15:22Z",
- "additionalData": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
]
}
Get purchased addon that is identified by the passed address id.
purchasedAddonId required | integer <int64> unique id of the purchase addon |
{- "purchasedAddonId": 0,
- "deliveryCustomerId": "string",
- "addonType": "BONUS",
- "plenigoAddonId": "stringstringstringst",
- "accessRightUniqueId": "string",
- "orderId": 0,
- "orderItemPosition": 0,
- "status": "CANCELLED",
- "deliveryCondition": "AFTER_PAYMENT",
- "deliveryDate": "2019-08-24T14:15:22Z",
- "trackingData": {
- "trackingId": "string",
- "trackingUrl": "string",
- "serviceProvider": "string",
- "sendingDate": "2019-08-24T14:15:22Z",
- "arrivalDate": "2019-08-24T14:15:22Z",
- "additionalData": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Update the tracking data of a purchased addons.
purchasedAddonId required | integer <int64> unique id of the purchase addon |
status required | string Enum: "CANCELLED" "DELIVERED" "IN_DELIVERY" "OPEN" "CONDITIONS_FULFILLED" "READY_FOR_DELIVERY" delivery status of the purchased addon |
object (AddonTrackingData) |
{- "status": "CANCELLED",
- "trackingData": {
- "trackingId": "string",
- "trackingUrl": "string",
- "serviceProvider": "string",
- "sendingDate": "2019-08-24T14:15:22Z",
- "arrivalDate": "2019-08-24T14:15:22Z",
- "additionalData": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}
}
}
{- "purchasedAddonId": 0,
- "deliveryCustomerId": "string",
- "addonType": "BONUS",
- "plenigoAddonId": "stringstringstringst",
- "accessRightUniqueId": "string",
- "orderId": 0,
- "orderItemPosition": 0,
- "status": "CANCELLED",
- "deliveryCondition": "AFTER_PAYMENT",
- "deliveryDate": "2019-08-24T14:15:22Z",
- "trackingData": {
- "trackingId": "string",
- "trackingUrl": "string",
- "serviceProvider": "string",
- "sendingDate": "2019-08-24T14:15:22Z",
- "arrivalDate": "2019-08-24T14:15:22Z",
- "additionalData": {
- "property1": {
- "key": "string",
- "value": "string"
}, - "property2": {
- "key": "string",
- "value": "string"
}
}
}, - "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Search all cross client transactions that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
orderId | integer <int64> unique id of the order |
subscriptionId | integer <int64> unique id of the subscription |
invoiceId | integer <int64> unique id of the invoice |
type | string Enum: "LOSS" "REFUND" "PAYMENT" unique id of the cross client transaction type |
paidStatus | string Enum: "OPEN" "PAID" unique id of the cross client transaction paid status |
connectedCompanyId | string unique id of a connected company |
{- "items": [
- {
- "crossClientTransactionId": 0,
- "sourceCompanyId": "string",
- "connectedCompanyId": "string",
- "orderId": 0,
- "subscriptionId": 0,
- "invoiceId": 0,
- "type": "LOSS",
- "paidStatus": "OPEN",
- "paymentMethod": "AMAZON_PAY",
- "amount": 0,
- "currency": "str",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
]
}
Get cross client transaction that is identified by the passed address id.
crossClientTransactionId required | integer <int64> unique id of the cross client transaction id |
{- "crossClientTransactionId": 0,
- "sourceCompanyId": "string",
- "connectedCompanyId": "string",
- "orderId": 0,
- "subscriptionId": 0,
- "invoiceId": 0,
- "type": "LOSS",
- "paidStatus": "OPEN",
- "paymentMethod": "AMAZON_PAY",
- "amount": 0,
- "currency": "str",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Update the paid status of a cross client transactions.
crossClientTransactionId required | integer <int64> unique id of the cross client transaction id |
paidStatus | string Enum: "OPEN" "PAID" paid status update |
{- "paidStatus": "OPEN"
}
{- "crossClientTransactionId": 0,
- "sourceCompanyId": "string",
- "connectedCompanyId": "string",
- "orderId": 0,
- "subscriptionId": 0,
- "invoiceId": 0,
- "type": "LOSS",
- "paidStatus": "OPEN",
- "paymentMethod": "AMAZON_PAY",
- "amount": 0,
- "currency": "str",
- "createdDate": "2019-08-24T14:15:22Z",
- "changedDate": "2019-08-24T14:15:22Z",
- "createdBy": "string",
- "createdByType": "API",
- "changedBy": "string",
- "changedByType": "API"
}
Search all subscriptions that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
subscriptionItemId | integer <int64> unique id of the subscription item to search for |
externalSystemId | string external system id defined by third party systems |
{- "items": [
- {
- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptionItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
]
}
Search all cross client subscriptions that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
subscriptionItemId | integer <int64> unique id of the subscription item to search for |
externalSystemId | string external system id defined by third party systems |
{- "items": [
- {
- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptionItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
]
}
Get subscription that is identified by the passed subscription id.
subscriptionId required | integer <int64> unique id of the subscription |
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Change the access status of a subscription immediately.
subscriptionId required | integer <int64> unique id of the subscription |
accessBlocked required | boolean flag indicating if the access should be blocked |
[- {
- "accessBlocked": true
}
]
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Change the address that is associated with a subscription.
subscriptionId required | integer <int64> unique id of the subscription |
addressId required | integer <int64> id of the address to add to the subscription |
addressType required | string Enum: "INVOICE" "DELIVERY" address type of the address to change |
{- "addressId": 28023,
- "addressType": "INVOICE"
}
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Change analog invoice flag of a subscription.
subscriptionId required | integer <int64> unique id of the subscription |
analogInvoice required | boolean flag indicating if the subscription is an analog invoice |
[- {
- "analogInvoice": true
}
]
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Cancel a running subscription to a given date.
subscriptionId required | integer <int64> unique id of the subscription |
sendMail | boolean flag indicating if an email should be send |
cancellationReasonUniqueId | string unique id of the cancellation reason |
cancellationDate | string or null <date> date subscription should end with full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21 |
{- "cancellationDate": "2019-02-01"
}
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Get possible cancellation dates of a running subscription.
subscriptionId required | integer <int64> unique id of the subscription |
useAccountingPeriod | boolean flag indicating that the accounting should be used for date calculation instead ot the term period |
{- "items": [
- "2019-09-01",
- "2019-10-01",
- "2019-11-01"
]
}
Cancel subscription immediately and switch the subscription status to inactive.
subscriptionId required | integer <int64> unique id of the subscription |
sendMail | boolean flag indicating if an email should be send |
cancellationReasonUniqueId | string unique id of the cancellation reason |
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Cancel a subscription to the next regular end date.
subscriptionId required | integer <int64> unique id of the subscription |
sendMail | boolean flag indicating if an email should be send |
cancellationReasonUniqueId | string unique id of the cancellation reason |
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Undo cancellation of a subscription that is cancelled but has not reached the end of its runtime yet.
subscriptionId required | integer <int64> unique id of the subscription |
sendMail | boolean flag indicating if an email should be send |
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Change discount percentage of a subscription item.
subscriptionId required | integer <int64> unique id of the subscription |
subscriptionItemId required | integer <int64> unique id of the subscription item to change discount for |
discountPercentage required | integer <int32> [ 0 .. 100 ] discount offered to the subscription item |
[- {
- "subscriptionItemId": 14536,
- "discountPercentage": 25
}
]
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Change payment method of a subscription.
subscriptionId required | integer <int64> unique id of the subscription |
paymentMethod required | string Enum: "AMAZON_PAY" "BANK_ACCOUNT" "BILLING" "CREDIT_CARD" "PAYPAL" payment method used to pay for the subscription |
paymentMethodId required | integer <int64> id of the payment method that is associated with this subscription |
[- {
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230
}
]
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Add deliveries to open deliveries count of a subscription.
subscriptionId required | integer <int64> unique id of the subscription |
deliveryAddition required | integer <int32> [ 1 .. 100 ] amount of deliveries to add to open deliveries |
{- "deliveryAddition": 1
}
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Change quantity of a subscription item.
subscriptionId required | integer <int64> unique id of the subscription |
subscriptionItemId required | integer <int64> unique id of the subscription item to change discount for |
quantity required | integer <int32> [ 1 .. 10000 ] quantity of purchased entities |
[- {
- "subscriptionItemId": 14536,
- "quantity": 4
}
]
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Change suppress invoice sending flag of a subscription.
subscriptionId required | integer <int64> unique id of the subscription |
suppressInvoiceSending required | boolean flag indicating if the subscription invoice sending is suppressed |
[- {
- "suppressInvoiceSending": true
}
]
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Change purchase order indicator of a subscription.
subscriptionId required | integer <int64> unique id of the subscription |
purchaseOrderIndicator required | string <= 50 characters purchase order indicator to set |
{- "purchaseOrderIndicator": "purchase order indicator"
}
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Pause a subscription during the given time range. Only subscriptions with the same accounting period and term can be paused.
subscriptionId required | integer <int64> unique id of the subscription |
sendMail | boolean flag indicating if an email should be send |
startPauseDate required | string or null <date> date subscription pause should be start with full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21 |
endPauseDate required | string or null <date> date subscription pause should be end with full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21 |
pauseType | string Enum: "PAYMENT_ONLY" "STANDARD" type of the pause |
{- "startPauseDate": "2019-02-01",
- "endPauseDate": "2019-02-21"
}
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Delete the pause of a subscription.
subscriptionId required | integer <int64> unique id of the subscription |
sendMail | boolean flag indicating if an email should be send |
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Get possible pause dates of a running subscription.
subscriptionId required | integer <int64> unique id of the subscription |
{- "items": [
- "2019-09-01",
- "2019-10-01",
- "2019-11-01"
]
}
Pause a subscription delivery during the given time range.
subscriptionId required | integer <int64> unique id of the subscription |
sendMail | boolean flag indicating if an email should be send |
startPauseDate required | string or null <date> date subscription pause should be start with full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21 |
endPauseDate required | string or null <date> date subscription pause should be end with full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21 |
pauseType | string Enum: "PAYMENT_ONLY" "STANDARD" type of the pause |
{- "startPauseDate": "2019-02-01",
- "endPauseDate": "2019-02-21"
}
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Delete the pause of a subscription delivery.
subscriptionId required | integer <int64> unique id of the subscription |
sendMail | boolean flag indicating if an email should be send |
{- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptonItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
Get all subscriptions that belong to a specific subscription chain that is identified by the passed chain id.
chainId required | integer <int64> unique id of the subscription chain |
{- "items": [
- {
- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptionItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
]
}
Returns additional data associated with the chain associated with the provided chain id.
chainId required | integer <int64> unique id of the subscription chain |
{- "data": {
- "myChainInfo": "newChain"
}
}
Replace additional data of a subscription chain. All data will be replaced with the new data provided.
chainId required | integer <int64> unique id of the subscription chain |
object |
{- "data": {
- "myChainInfo": "newChain"
}
}
{- "data": {
- "myChainInfo": "newChain"
}
}
Returns status history associated with the chain associated with the provided chain id.
chainId required | integer <int64> unique id of the subscription chain |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
{- "statusChangeId": 0,
- "customerId": "string",
- "startTime": "2019-08-24T14:15:22Z",
- "endTime": "2019-08-24T14:15:22Z",
- "chainId": 0,
- "oldStatus": "ACTIVE",
- "newStatus": "ACTIVE"
}
Get all cross client subscriptions that belong to a specific subscription chain that is identified by the passed chain id.
chainId required | integer <int64> unique id of the subscription chain |
{- "items": [
- {
- "subscriptionId": 9310,
- "changedDate": "2019-03-21T17:32:12Z",
- "startDate": "2019-02-01T17:32:12Z",
- "endDate": "2090-02-01TT17:32:12Z",
- "chainId": 9310,
- "plenigoOfferId": "O_MZA1E7173120881551",
- "invoiceCustomerId": "100003",
- "deliveryCustomerId": "100003",
- "term": 12,
- "termTimeSpan": "MONTH",
- "accountingPeriod": 1,
- "accountingPeriodTimeSpan": "MONTH",
- "cancellationPeriod": 1,
- "cancellationPeriodTimeSpan": "DAY",
- "currency": "EUR",
- "paymentMethod": "CREDIT_CARD",
- "paymentMethodId": 100230,
- "accessBlocked": false,
- "firstBookingDate": "2019-02-01",
- "lastBookingDate": "2019-08-01",
- "nextBookingDate": "2019-09-01",
- "status": "ACTIVE",
- "items": [
- {
- "subscriptionItemId": 7212,
- "productId": "P_TTA1E7173120881551",
- "plenigoProductId": "P_TTA1E7173120881551",
- "plenigoStepId": "S_DRLEE7173120881551",
- "title": "Best monthly news",
- "internalTitle": "Monthly newspaper",
- "taxType": "NEWSPAPER",
- "price": 9.99,
- "priceIssueId": 12345,
- "discountPercentage": 0,
- "quantity": 1,
- "status": "ACTIVE",
- "packageTitle": "Best offer bundle",
- "packageId": "AX20429MK3222",
- "packageCancellationLocked": true,
- "costCenter": "43400",
- "accessRightUniqueId": "global-access"
}
]
}
]
}
Search all subscriptions delivery dates that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
deliveryCustomerId | string unique id of the delivery customer |
subscriptionId | integer <int64> unique id of the subscription |
{- "items": [
- {
- "subscriptionDeliveryDateId": 7212,
- "createdDate": "2090-02-01TT17:32:12Z",
- "changedDate": "2090-02-01TT17:32:12Z",
- "title": "May delivery",
- "publishingDate": "2090-02-01TT17:32:12Z",
- "subscriptionId": 6362,
- "deliveryListId": 3456,
- "deliveryListDateId": 2455,
- "deliveryCustomerId": "100003",
- "deliveryAddressId": 12345
}
]
}
Search all cross client subscriptions delivery dates that correspond to the given search conditions.
deliveryListId required | integer <int64> unique id of the delivery list |
deliveryListDateId required | integer <int64> unique id of the delivery list date |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
deliveryCustomerId | string unique id of the delivery customer |
{- "items": [
- {
- "subscriptionDeliveryDateId": 7212,
- "createdDate": "2090-02-01TT17:32:12Z",
- "changedDate": "2090-02-01TT17:32:12Z",
- "title": "May delivery",
- "publishingDate": "2090-02-01TT17:32:12Z",
- "subscriptionId": 6362,
- "deliveryListId": 3456,
- "deliveryListDateId": 2455,
- "deliveryCustomerId": "100003",
- "deliveryAddressId": 12345
}
]
}
Use a cross client voucher to connect a cross client subscription.
customerId | string^[0-9]{1,18}$ unique id of the customer |
voucherCode | string voucher code |
{- "customerId": "string",
- "voucherCode": "string"
}
{- "success": true
}
Get last 100 payment periods of a subscription order by period start date descending.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
subscriptionId | integer <int64> unique id of the subscription |
{- "items": [
- {
- "subscriptionPaymentPeriodId": 12401,
- "subscriptionId": 12400,
- "customerId": 31000,
- "startTime": "2019-02-01T00:00:00Z",
- "endTime": "2019-02-28TT23:59:59Z",
- "success": true,
- "accessBlocked": false,
- "accessBlockedInPeriod": false,
- "bookingTries": 1,
- "plenigoTransactionId": "1TCZCSdg0lFEGGG3JPbZODkZKG0"
}
]
}
Get the payment period.
subscriptionPaymentPeriodId required | integer <int64> unique id of the subscription payment period |
{- "subscriptionPaymentPeriodId": 12401,
- "subscriptionId": 12400,
- "customerId": 31000,
- "startTime": "2019-02-01T00:00:00Z",
- "endTime": "2019-02-28TT23:59:59Z",
- "success": true,
- "accessBlocked": false,
- "accessBlockedInPeriod": false,
- "bookingTries": 1,
- "plenigoTransactionId": "1TCZCSdg0lFEGGG3JPbZODkZKG0",
- "retryPaymentAllowed": false
}
Create credit wallet.
uniqueId | string^[0-9\-a-zA-Z]{2,30}$ unique id of the wallet for identification |
creditCount | integer <int64> [ 1 .. 100000000 ] credit count to create wallet with |
customerId | string^[0-9]{1,18}$ unique id of the customer the credit wallet belongs to |
{- "items": {
- "customerId": "42",
- "uniqueId": "company-wallet",
- "creditCount": 5
}
}
{- "items": {
- "customerId": "42",
- "customerCreditWalletId": 5800001,
- "uniqueId": "company-wallet",
- "title": "Wallet of a customer",
- "availableCreditCount": 5
}
}
{- "items": [
- {
- "customerId": "42",
- "customerCreditWalletId": 5800001,
- "uniqueId": "company-wallet",
- "title": "Wallet of a customer",
- "availableCreditCount": 5
}
]
}
Get credit wallet by id.
customerCreditWalletId required | integer <int64> id of the credit wallet |
{- "items": {
- "customerId": "42",
- "customerCreditWalletId": 5800001,
- "uniqueId": "company-wallet",
- "title": "Wallet of a customer",
- "availableCreditCount": 5
}
}
Get credit wallet uploads.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "customerId": "42",
- "creditUploadId": 6000001,
- "uploadDate": "2022-01-03T17:32:12Z",
- "uniqueId": "company-wallet",
- "creditsAdded": 5,
- "title": "Added by subscription",
- "itemType": "SUBSCRIPTION_ITEM",
- "itemId": 90300000
}
]
}
Get credit wallet usages.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "customerId": "42",
- "creditUsageId": 5900001,
- "usageDate": "2022-01-02T17:32:12Z",
- "uniqueId": "company-wallet",
- "creditsUsed": 2,
- "reason": "Usage of product one"
}
]
}
Uploads a credit to a given credit wallet.
customerId | string^[0-9]{1,18}$ id of the customer the credit usage should be accounted to |
uniqueId | string^[0-9\-a-zA-Z]{2,30}$ unique id of the wallet to use |
title | string <= 100 characters title of upload |
creditCount | integer <int64> [ 1 .. 100000000 ] amount of credits to add |
{- "items": {
- "customerId": "42",
- "title": "New monthly credits",
- "uniqueId": "company-wallet",
- "creditCount": 2
}
}
{- "items": {
- "customerId": "42",
- "customerCreditWalletId": 5800001,
- "uniqueId": "company-wallet",
- "title": "Wallet of a customer",
- "availableCreditCount": 5
}
}
Uses a credit from a given credit wallet.
customerId required | string^[0-9]{1,18}$ id of the customer the credit usage should be accounted to |
uniqueId required | string^[0-9\-a-zA-Z]{2,30}$ unique id of the wallet to use |
creditsUsed required | integer <int64> [ 1 .. 100000 ] amount of credits used |
reason required | string <= 100 characters reason for credit usage |
category | string <= 100 characters category for credit usage |
{- "items": {
- "customerId": "42",
- "uniqueId": "company-wallet",
- "creditsUsed": 2,
- "reason": "Usage of product one"
}
}
{- "items": {
- "customerId": "42",
- "customerCreditWalletId": 5800001,
- "uniqueId": "company-wallet",
- "title": "Wallet of a customer",
- "availableCreditCount": 5
}
}
Get credit wallet by unique id.
customerId required | string unique id of the customer |
uniqueId required | string unique id of the wallet |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": {
- "customerId": "42",
- "customerCreditWalletId": 5800001,
- "uniqueId": "company-wallet",
- "title": "Wallet of a customer",
- "availableCreditCount": 5
}
}
Get credit wallet uploads.
customerId required | string unique id of the customer |
uniqueId required | string unique id of the wallet |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "customerId": "42",
- "creditUploadId": 6000001,
- "uploadDate": "2022-01-03T17:32:12Z",
- "uniqueId": "company-wallet",
- "creditsAdded": 5,
- "title": "Added by subscription",
- "itemType": "SUBSCRIPTION_ITEM",
- "itemId": 90300000
}
]
}
Get credit wallet usages.
customerId required | string unique id of the customer |
uniqueId required | string unique id of the wallet |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "customerId": "42",
- "creditUsageId": 5900001,
- "usageDate": "2022-01-02T17:32:12Z",
- "uniqueId": "company-wallet",
- "creditsUsed": 2,
- "reason": "Usage of product one"
}
]
}
Search all callback log entries that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
entityType | string Enum: "APP_STORE_ORDER" "APP_STORE_SUBSCRIPTION" "CALLBACK_RENEWAL" "CROSS_CLIENT_ORDER" "CUSTOMER" "CUSTOMER_GDPR" "CUSTOMER_OPT_IN" "DOO_EVENT_ACCESS" "FAILED_PAYMENT" "INVOICE" "INVOICE_CANCELLATION" "INVOICE_CORRECTION" "ORDER" "PURCHASED_ADDON" "SUBSCRIPTION" "TRANSACTION" "VOUCHER_CAMPAIGN" "VOUCHER_CHANNEL" entity type to get entries for |
callbackType | string Enum: "CANCELLATION" "CHANGE" "CONDITIONS_FULFILLED" "CREATION" "DELETION" "ENDED" "FINISHED" "PAYMENT_FAILED" "PAYMENT_REVOKED" "UNDO_CANCELLATION" callback type to get entries for |
{- "items": [
- {
- "callbackLogEntryId": 1230001,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "entityType": "CUSTOMER",
- "callbackType": "CREATION",
- "entityVersion": "3.0",
- "entityId": "1240003",
- "success": false,
- "erroMsg": "Could not reach host https://www.example.com."
}
]
}
Get callback log entry that is identified by the passed callback log entry id.
callbackLogEntryId required | integer <int64> unique id of the callback log entry |
{- "callbackLogEntryId": 1230001,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "entityType": "CUSTOMER",
- "callbackType": "CREATION",
- "entityVersion": "3.0",
- "entityId": "1240003",
- "success": false,
- "erroMsg": "Could not reach host https://www.example.com."
}
Search all downloads log entries that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
downloadType | string Enum: "DELIVERY_LIST" "DELIVERY_NOTE_LIST" "ANALOG_INVOICE_LIST" download type of the downlaod |
fileType | string Enum: "CSV" "PDF" "ZIP" file type of the downlaod |
{- "items": [
- {
- "downloadId": 1230001,
- "uploadedDate": "2019-01-01T07:53:23.450961Z",
- "downloadType": "DELIVERY_LIST",
- "fileType": "CSV",
- "fileSize": 1924,
- "fileName": "delivery_list_2019_01_01"
}
]
}
Get download that is identified by the passed download id.
downloadId required | integer <int64> unique id of the download |
{- "downloadId": 1230001,
- "uploadedDate": "2019-01-01T07:53:23.450961Z",
- "downloadType": "DELIVERY_LIST",
- "fileType": "CSV",
- "fileSize": 1924,
- "fileName": "delivery_list_2019_01_01"
}
Get download file that is identified by the passed download id.
downloadId required | integer <int64> unique id of the download |
{- "fileType": "CSV",
- "fileName": "Delivery list",
- "file": "biwgSm9naHVydCB1bmQgUXVhcms="
}
Search all mail log entries that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
mailTemplateType | string Enum: "CHANGE_EMAIL" "CROSS_SELLING" "INVOICE" "ORDER" "ORDER_ITEM_VOUCHER" "PAYMENT_FAILED" "PAYMENT_METHOD_CHANGED" "RECURRING_PAYMENT_FAILED" "RECURRING_PAYMENT_TRY_FAILED" "REGISTRATION_ALREADY_FINISHED" "REGISTRATION_COMPLETION" "REGISTRATION_FINISHED" "RESET_PASSWORD" "RESET_PASSWORD_FINISHED" "SUBSCRIPTION_CANCELED" "SUBSCRIPTION_DELIVERY_PAUSED" "SUBSCRIPTION_DELIVERY_PAUSED_CANCELED" "SUBSCRIPTION_PAUSED" "SUBSCRIPTION_PAUSED_CANCELED" "SUBSCRIPTION_CANCELLATION_TERMINATION" "SUBSCRIPTION_RELATION_RULE" "WELCOME_MAIL" mail template type of the mail sent |
errorOnly | boolean flag indicating if only failed mail logs should be returned |
{- "items": [
- {
- "mailLogEntryId": 1230001,
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "customerId": "83432341",
- "mailSettingsType": "EXTERNAL",
- "mailTemplateType": "CHANGE_EMAIL",
- "to": "receiver@example.com",
- "from": "merchant@example.com",
- "bcc": "copy@example.com",
- "replyTo": "support@example.com",
- "subject": "Your new email address",
- "success": false,
- "errorReason": "Mail could not be delivered.",
- "errorDetail": "Could not successfully deliver mail because mail box is full."
}
]
}
Get mail log entry that is identified by the passed mail log entry id.
mailLogEntryId required | integer <int64> unique id of the mail log entry |
{- "mailLogEntryId": 1230001,
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "customerId": "83432341",
- "mailSettingsType": "EXTERNAL",
- "mailTemplateType": "CHANGE_EMAIL",
- "to": "receiver@example.com",
- "from": "merchant@example.com",
- "bcc": "copy@example.com",
- "replyTo": "support@example.com",
- "subject": "Your new email address",
- "success": false,
- "errorReason": "Mail could not be delivered.",
- "errorDetail": "Could not successfully deliver mail because mail box is full."
}
Search all SFTP log entries that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
sort | string <= 4 characters Enum: "ASC" "DESC" The sort of the search, if its desc it will revert to search for a lower startingAfter |
{- "items": [
- {
- "sftpLogEntryId": 49000,
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "server": "example.com:22",
- "username": "user1",
- "targetDirectory": "target/directory/",
- "success": false,
- "errorMsg": "connection lost"
}
]
}
Get SFTP log entry that is identified by the passed sftp log entry id.
sftpLogEntryId required | integer <int64> unique id of the sftp log entry |
{- "sftpLogEntryId": 49000,
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "server": "example.com:22",
- "username": "user1",
- "targetDirectory": "target/directory/",
- "success": false,
- "errorMsg": "connection lost"
}
Returns additional data selections.
{- "additions": {
- "title": "Social Media",
- "description": "Social Media Source",
- "identifier": "sm",
- "category": "Checkout",
- "enabled": true,
- "values": {
- "Facebook": "fb",
- "Twitter": "tw"
}
}
}
Update additional data selections.
Array of objects (AdditionalDataSelection) |
{- "additions": {
- "title": "Social Media",
- "description": "Social Media Source",
- "identifier": "sm",
- "category": "Checkout",
- "enabled": true,
- "values": {
- "Facebook": "fb",
- "Twitter": "tw"
}
}
}
{- "additions": {
- "title": "Social Media",
- "description": "Social Media Source",
- "identifier": "sm",
- "category": "Checkout",
- "enabled": true,
- "values": {
- "Facebook": "fb",
- "Twitter": "tw"
}
}
}
Get blocked ibans for a company.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
iban | string [ 18 .. 32 ] characters |
{- "items": [
- {
- "blockedIbanId": 100001,
- "iban": "GB19123412341234123412",
- "description": "This iban is not allowed."
}
]
}
Create a blocked iban for a company.
iban required | string [ 18 .. 32 ] characters |
description | string <= 1000 characters description of the blocked iban |
{- "iban": "stringstringstring",
- "description": "string"
}
{- "blockedIbanId": 100001,
- "iban": "GB19123412341234123412",
- "description": "This iban is not allowed."
}
Get blocked iban for a company.
blockedIbanId required | integer <int64> unique id of the blocked iban |
{- "blockedIbanId": 100001,
- "iban": "GB19123412341234123412",
- "description": "This iban is not allowed."
}
Search all cancellation reasons that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
{- "items": {
- "customerCancellationReasonId": 120302,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "internalTitle": "Too expensive",
- "active": true,
- "priority": 1,
- "uniqueId": "too_expensive",
- "translations": [
- {
- "language": "DE",
- "text": "Too expensive",
- "preferred": true
}
]
}
}
Get cancellation reasons that is identified by the passed cancellation reasons id.
customerCancellationReasonId required | string unique id of a customer cancellation reason |
{- "customerCancellationReasonId": 120302,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "internalTitle": "Too expensive",
- "active": true,
- "priority": 1,
- "uniqueId": "too_expensive",
- "translations": [
- {
- "language": "DE",
- "text": "Too expensive",
- "preferred": true
}
]
}
Search all advertisement opt ins that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
{- "items": {
- "customerOptInId": 120302,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "internalTitle": "Main opt in",
- "active": true,
- "uniqueId": "V1.0",
- "activationTime": "2020-03-21T17:32:12Z",
- "translations": [
- {
- "language": "DE",
- "ssoText": "Accept while registration",
- "checkoutText": "Accept while checkout",
- "preferred": true
}
]
}
}
Get advertisement opt in that is identified by the passed advertisement opt in id.
customerOptInId required | string unique id of a customer opt in |
{- "customerOptInId": 120302,
- "createdDate": "2019-01-01T07:53:23.450961Z",
- "createdBy": "PLENIGO",
- "createdByType": "SYSTEM",
- "changedDate": "2019-01-01T07:53:23.450961Z",
- "changedBy": "PLENIGO",
- "changedByType": "SYSTEM",
- "internalTitle": "Main opt in",
- "active": true,
- "uniqueId": "V1.0",
- "activationTime": "2020-03-21T17:32:12Z",
- "translations": [
- {
- "language": "DE",
- "ssoText": "Accept while registration",
- "checkoutText": "Accept while checkout",
- "preferred": true
}
]
}
Search all terms and conditions that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
{- "items": {
- "customerTermId": 120302,
- "internalTitle": "Main term",
- "active": true,
- "uniqueId": "V1.0",
- "activationTime": "2020-03-21T17:32:12Z",
- "translations": [
- {
- "language": "DE",
- "ssoText": "Accept while registration",
- "checkoutText": "Accept while checkout",
- "preferred": true
}
]
}
}
Get terms and conditions that is identified by the passed terms and conditions id.
customerTermId required | string unique id of a customer term |
{- "customerTermId": 120302,
- "internalTitle": "Main term",
- "active": true,
- "uniqueId": "V1.0",
- "activationTime": "2020-03-21T17:32:12Z",
- "translations": [
- {
- "language": "DE",
- "ssoText": "Accept while registration",
- "checkoutText": "Accept while checkout",
- "preferred": true
}
]
}
Search all sort tree leafs that correspond to the given search conditions.
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
{- "items": [
- {
- "sortTreeLeafId": 9002,
- "name": "New products",
- "parentLeafId": 9001,
- "type": "OFFER"
}
]
}
Search all sort tree leafs that correspond to the given search conditions and type.
type required | string Enum: "OFFER" "PRICE_ISSUE" "PRODUCT_CONTRACT" "TEXT_MODULE" "CHECKOUT_VARIANT" "CHECKOUT_VARIANT_ADDRESS" "CHECKOUT_VARIANT_CONTENT" "CHECKOUT_VARIANT_DESIGN" "CHECKOUT_VARIANT_PAYMENT" type of the sort tree leaf |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
{- "items": [
- {
- "sortTreeLeafId": 9002,
- "name": "New products",
- "parentLeafId": 9001,
- "type": "OFFER"
}
]
}
Get sort tree leaf that is identified by the passed sort tree leaf id.
sortTreeLeafId required | integer <int64> unique id of the sort tree leaf |
{- "sortTreeLeafId": 9002,
- "name": "New products",
- "parentLeafId": 9001
}
Get sort tree leaf that is identified by the passed sort tree leaf id and type.
sortTreeLeafId required | integer <int64> unique id of the sort tree leaf |
type required | string Enum: "OFFER" "PRICE_ISSUE" "PRODUCT_CONTRACT" "TEXT_MODULE" "CHECKOUT_VARIANT" "CHECKOUT_VARIANT_ADDRESS" "CHECKOUT_VARIANT_CONTENT" "CHECKOUT_VARIANT_DESIGN" "CHECKOUT_VARIANT_PAYMENT" type of the sort tree leaf |
{- "sortTreeLeafId": 9002,
- "name": "New products",
- "parentLeafId": 9001
}
Search all text modules that correspond to the given search conditions.
type required | string Enum: "LINK" "HTML_TEXT" "PLAIN_TEXT" type of the text module |
size | integer <int32> [ 5 .. 100 ] amount of elements to return - if no size is provided or the size is not within range it will be automatically set to 5 |
startTime | string <date-time> time the entity was changed after or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
endTime | string <date-time> time the entity was changed before or equal with date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z |
startingAfter | string <= 100 characters A cursor for use in pagination. startingAfter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include startingAfter=obj_foo in order to fetch the next result set. |
endingBefore | string <= 100 characters A cursor for use in pagination. endingBefore is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include endingBefore=obj_bar in order to fetch the previous page of the list. |
leafId | integer <int64> unique id of the sort tree leaf |
{- "items": {
- "internalTitle": "Text module",
- "type": "HTML_TEXT",
- "translations": [
- {
- "language": "DE",
- "text": "text",
- "preferred": true
}
]
}
}
Get text module that is identified by the passed text module id.
textModuleId required | string unique id of a text module |
{- "textModuleId": 123000,
- "internalTitle": "Text module",
- "type": "HTML_TEXT",
- "translations": [
- {
- "language": "DE",
- "text": "text",
- "preferred": true
}
]
}