Available from CRM.COM R14.14.0
This method uses multiple vouchers (printed or electronic). Either all vouchers will be successfully used, or none.
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
accounts_receivable_identifier | Accounts receivable identifier | The identifier of the account receivable that the payments should be allocated in. The allowed accounts receivable identifier fields are the following:
| ||||||||||||
(mandatory) | Voucher Secret Number Object | Information related to the vouchers that will be used such as voucher's secret number and payment category. At least one voucher information is mandatory | ||||||||||||
fields_set (optional) | List of Strings, comma separated | A list of fields that should be included in the results. If not specified then all the available fields will be returned |
Referred Parameter Objects
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
Name | Type | Description |
|---|---|---|
id | String | The ID of the retrieved voucher |
number | String | The number of the retrieved voucher |
| description | String | The description of the retrieved voucher |
| value | Number | The value of the retrieved voucher |
| extra_added_value | Number | The extra added value of the retrieved voucher From CRM.COM R13.1.0 and onwards this information is available only if the voucher type classification is "Printed Payment Voucher" with value option set to Fixed OR type classification is "Electronic Payment Voucher" and value options is other set to Fixed or Variable |
| effective_date | Date | The date that the voucher becomes effective |
| expiration_date | Date | The date that the voucher expires |
life_cycle_state | String | The life cycle state of the retrieved voucher which can be DRAFT, ACCEPTED_FOR_ACTIVATION, NOT_ACCEPTED_FOR_ACTIVATION, ACTIVATED, USED, CANCELLED, PURGED From CRM.COM R13.1.0 and onwards the applicable life cycle state of the retrieved voucher of a type with classification "Electronic Voucher" can be ACTIVATED, USED, CANCELLED From CRM.COM R15.0.0 and onwards the PURGED life cycle state will also be avialable for Electronic vouchers From CRM.COM R14.0.0 and onwards the applicable life cycle state of the retrieved voucher of a type with classification "Refund Voucher" can be ACTIVATED, USED, PURGED |
| cancellation_reason | String | The cancellation reason of the retrieved voucher. Available only if Voucher Type's Classification is equal to "Electronic Voucher" and it's life cycle state is set to CANCELLED. Applicable values:
From CRM.COM R13.1.0 and onwards From CRM.COM R15.0.0 cancellation reasons will also applicable for Printed payment vouchers (all except VOUCHER_RETURN) |
udf_string_1 | String | User Defined Field of type String |
udf_string_2 | String | User Defined Field of type String |
udf_string_3 | String | User Defined Field of type String |
udf_string_4 | String | User Defined Field of type String |
udf_string_5 | String | User Defined Field of type String |
udf_string_6 | String | User Defined Field of type String |
udf_string_7 | String | User Defined Field of type String |
udf_string_8 | String | User Defined Field of type String |
udf_float_1 | Float | User Defined Field of type Float |
udf_float_2 | Float | User Defined Field of type Float |
udf_float_3 | Float | User Defined Field of type Float |
udf_float_4 | Float | User Defined Field of type Float |
udf_date_1 | Date | User Defined Field of type Date |
udf_date_2 | Date | User Defined Field of type Date |
udf_date_3 | Date | User Defined Field of type Date |
udf_date_4 | Date | User Defined Field of type Date |
| purchased_by | Accounts Receivable Object | The Accounts Receivable of the Customer who bought the e-voucher. Available only if Voucher Type's Classification is equal to "Electronic Voucher" Available from CRM.COM R13.1.0 |
| sold_by | Accounts Receivable Object | The Accounts Receivable of the Retailer who sold the e-voucher. Available only if Voucher Type's Classification is equal to "Electronic Voucher" Available from CRM.COM R13.1.0 |
| purchased_for | Accounts Receivable Object | The Accounts Receivable of the Customer for whom the e-voucher was bought for. Available only if Voucher Type's Classification is equal to "Electronic Voucher" Available from CRM.COM R13.1.0 |
| type | Voucher Type object | The voucher type information of the retrieved voucher |
| lot | Vouchers Lot Object | The lot of the retrieved voucher. Applicable only for Printed vouchers generated within CRM.COM
|
| payment | Payment Object | The payment that was created and posted as a result of using the voucher. This information becomes available only if the voucher is used From CRM.COM R13.1.0 and onwards this information is available only if the voucher type classification is "Payment Voucher" or "Electronic Voucher" |
| refund | Refund Object | The refund that created the voucher. This information becomes available only if the voucher was created due to a refund being posted Available from CRM.COM R14.0.0 |
| log_information | Log Information Object | The log information of the retrieved voucher |
| currency | Currency Object | The voucher's currency Available from CRM.COM R14.2.0 |
| products_set | Set of Voucher Products Objects | The voucher products that can consume the amount of money that was paid through the voucher |
| allowed_organisational_units_set | Set of unit Objects | The organisational units that can use the specific voucher type Deprecated from CRM.COM R13.1.0 onwards |
Referred Objects Response Data
Examples
HTTP Method: POST
Request:
Body
{
"token": "{{token}}",
"secret_numbers_set": [
{
"secret_number": "478998235307",
"notes":"test1"
},
{
"secret_number": "176404672883",
"notes":"test2"
},
{
"secret_number": "348597852067",
"notes":"test3"
}
],
"accounts_receivable_identifier": {
"number": "ACR0000001698"
}
}
Response:
{
"data": [
{
"log_information": {
"created_by_unit": {
"alternative_code": "AU",
"group_name": "EKO Group",
"community_name": "Internal Community",
"name": "Admin Unit",
"description": "Admin Unit",
"id": "30DCAB2BEE60E08D3466CF23CA406201"
},
"updated_by_unit": {
"alternative_code": "adminunit",
"group_name": "Main Group",
"community_name": "Community",
"name": "Admin Unit",
"description": "admin unit",
"id": "1"
},
"created_date": "2014-10-30T18:45:24",
"updated_date": "2019-08-26T16:43:55",
"updated_by_user": {
"person_name": "CRM COM",
"id": "1",
"email": "test@crm.com",
"username": "MPAdministrator"
},
"created_by_user": {
"person_name": "CRM COM",
"id": "1",
"email": "test@crm.com",
"username": "MPAdministrator"
}
},
"description": null,
"extra_added_value": 0,
"expiration_date": "2030-11-14T00:00:00",
"udf_date_2": null,
"type": {
"alternative_code": "BV",
"value_options": "FIXED",
"name": "Basic Voucher",
"description": "Basic Voucher",
"id": "69BEF054387FA38D08DFA49539CA7E69",
"classification": "PRINTED_PAYMENT_VOUCHER"
},
"udf_date_1": null,
"udf_date_4": null,
"products_set": [],
"udf_date_3": null,
"lot": {
"number": "1",
"alternative_code": "00001",
"description": "Basic voucher 1,500 ",
"id": "43554E7E2510290931C01CBEE8BBAFA4"
},
"number": "27",
"udf_float_3": null,
"udf_float_4": null,
"effective_date": "2014-11-01T00:00:00",
"payment": {
"posted_on": "2019-08-26T16:43:55",
"number": "1375",
"payment_amount": 1500,
"issued_on": "2019-08-26T16:43:55",
"currency_rate_period": {
"from_date": "2018-08-07 00:00:00.0",
"to_date": null,
"rate": 5,
"inverse_rate": 0.2,
"currency": {
"suffix_symbol": "N/A",
"prefix_symbol": "€",
"decimal_part_name": "cents",
"code": "EUR",
"integer_part_name": "euro",
"id": "2",
"life_cycle_state": "EFFECTIVE"
},
"id": "71996F27996C44DC9E2FD4C2F05AE563"
},
"id": "5C0BAB59898140F8B80AAF3EF440D592",
"life_cycle_state": "POSTED",
"reference_number": "7561"
},
"currency": {
"suffix_symbol": "N/A",
"prefix_symbol": "€",
"decimal_part_name": "cents",
"code": "EUR",
"integer_part_name": "euro",
"id": "2",
"life_cycle_state": "EFFECTIVE"
},
"id": "0291BB649702C20DE6EE44AD3B0C11C7",
"udf_float_1": null,
"value": 1500,
"udf_float_2": null,
"udf_string_2": null,
"udf_string_3": null,
"udf_string_4": null,
"udf_string_5": null,
"udf_string_1": null,
"life_cycle_state": "USED",
"udf_string_6": null,
"udf_string_7": null,
"udf_string_8": null
},
{
"log_information": {
"created_by_unit": {
"alternative_code": "AU",
"group_name": "EKO Group",
"community_name": "Internal Community",
"name": "Admin Unit",
"description": "Admin Unit",
"id": "30DCAB2BEE60E08D3466CF23CA406201"
},
"updated_by_unit": {
"alternative_code": "adminunit",
"group_name": "Main Group",
"community_name": "Community",
"name": "Admin Unit",
"description": "admin unit",
"id": "1"
},
"created_date": "2014-10-30T18:45:22",
"updated_date": "2019-08-26T16:43:56",
"updated_by_user": {
"person_name": "CRM COM",
"id": "1",
"email": "test@crm.com",
"username": "MPAdministrator"
},
"created_by_user": {
"person_name": "CRM COM",
"id": "1",
"email": "test@crm.com",
"username": "MPAdministrator"
}
},
"description": null,
"extra_added_value": 0,
"expiration_date": "2030-11-14T00:00:00",
"udf_date_2": null,
"type": {
"alternative_code": "BV",
"value_options": "FIXED",
"name": "Basic Voucher",
"description": "Basic Voucher",
"id": "69BEF054387FA38D08DFA49539CA7E69",
"classification": "PRINTED_PAYMENT_VOUCHER"
},
"udf_date_1": null,
"udf_date_4": null,
"products_set": [],
"udf_date_3": null,
"lot": {
"number": "1",
"alternative_code": "00001",
"description": "Basic voucher 1,500 ",
"id": "43554E7E2510290931C01CBEE8BBAFA4"
},
"number": "3",
"udf_float_3": null,
"udf_float_4": null,
"effective_date": "2014-11-01T00:00:00",
"payment": {
"posted_on": "2019-08-26T16:43:56",
"number": "1376",
"payment_amount": 1500,
"issued_on": "2019-08-26T16:43:56",
"currency_rate_period": {
"from_date": "2018-08-07 00:00:00.0",
"to_date": null,
"rate": 5,
"inverse_rate": 0.2,
"currency": {
"suffix_symbol": "N/A",
"prefix_symbol": "€",
"decimal_part_name": "cents",
"code": "EUR",
"integer_part_name": "euro",
"id": "2",
"life_cycle_state": "EFFECTIVE"
},
"id": "71996F27996C44DC9E2FD4C2F05AE563"
},
"id": "9D8E27AFE8C54F87B7936B62327948D0",
"life_cycle_state": "POSTED",
"reference_number": "7562"
},
"currency": {
"suffix_symbol": "N/A",
"prefix_symbol": "€",
"decimal_part_name": "cents",
"code": "EUR",
"integer_part_name": "euro",
"id": "2",
"life_cycle_state": "EFFECTIVE"
},
"id": "BD9596280FE954B59F2C3A574B80EB5D",
"udf_float_1": null,
"value": 1500,
"udf_float_2": null,
"udf_string_2": null,
"udf_string_3": null,
"udf_string_4": null,
"udf_string_5": null,
"udf_string_1": null,
"life_cycle_state": "USED",
"udf_string_6": null,
"udf_string_7": null,
"udf_string_8": null
},
{
"log_information": {
"created_by_unit": {
"alternative_code": "AU",
"group_name": "EKO Group",
"community_name": "Internal Community",
"name": "Admin Unit",
"description": "Admin Unit",
"id": "30DCAB2BEE60E08D3466CF23CA406201"
},
"updated_by_unit": {
"alternative_code": "adminunit",
"group_name": "Main Group",
"community_name": "Community",
"name": "Admin Unit",
"description": "admin unit",
"id": "1"
},
"created_date": "2014-10-30T18:45:24",
"updated_date": "2019-08-26T16:43:56",
"updated_by_user": {
"person_name": "CRM COM",
"id": "1",
"email": "test@crm.com",
"username": "MPAdministrator"
},
"created_by_user": {
"person_name": "CRM COM",
"id": "1",
"email": "test@crm.com",
"username": "MPAdministrator"
}
},
"description": null,
"extra_added_value": 0,
"expiration_date": "2030-11-14T00:00:00",
"udf_date_2": null,
"type": {
"alternative_code": "BV",
"value_options": "FIXED",
"name": "Basic Voucher",
"description": "Basic Voucher",
"id": "69BEF054387FA38D08DFA49539CA7E69",
"classification": "PRINTED_PAYMENT_VOUCHER"
},
"udf_date_1": null,
"udf_date_4": null,
"products_set": [],
"udf_date_3": null,
"lot": {
"number": "1",
"alternative_code": "00001",
"description": "Basic voucher 1,500 ",
"id": "43554E7E2510290931C01CBEE8BBAFA4"
},
"number": "30",
"udf_float_3": null,
"udf_float_4": null,
"effective_date": "2014-11-01T00:00:00",
"payment": {
"posted_on": "2019-08-26T16:43:56",
"number": "1377",
"payment_amount": 1500,
"issued_on": "2019-08-26T16:43:56",
"currency_rate_period": {
"from_date": "2018-08-07 00:00:00.0",
"to_date": null,
"rate": 5,
"inverse_rate": 0.2,
"currency": {
"suffix_symbol": "N/A",
"prefix_symbol": "€",
"decimal_part_name": "cents",
"code": "EUR",
"integer_part_name": "euro",
"id": "2",
"life_cycle_state": "EFFECTIVE"
},
"id": "71996F27996C44DC9E2FD4C2F05AE563"
},
"id": "24ED62E448F6466EB9310B5E32BAE9C1",
"life_cycle_state": "POSTED",
"reference_number": "7563"
},
"currency": {
"suffix_symbol": "N/A",
"prefix_symbol": "€",
"decimal_part_name": "cents",
"code": "EUR",
"integer_part_name": "euro",
"id": "2",
"life_cycle_state": "EFFECTIVE"
},
"id": "9B839233DF9C49238410FCB4EABE65D0",
"udf_float_1": null,
"value": 1500,
"udf_float_2": null,
"udf_string_2": null,
"udf_string_3": null,
"udf_string_4": null,
"udf_string_5": null,
"udf_string_1": null,
"life_cycle_state": "USED",
"udf_string_6": null,
"udf_string_7": null,
"udf_string_8": null
}
],
"status": {
"code": "OK",
"description": "",
"message": ""
}
}