GET invoices/configuration/types/list
This method returns the invoice types that are allowed to be used in the system. Multiple invoice types are returned by each call
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
group_identifier (optional) | Group Identifier | The identifier of the group that will be providing the invoice type. The group is filtered against the invoice types' allowed organisational units. The allowed group identifier fields are the following:
| ||||||||||||
unit_identifier (optional) | Unit Identifier | The identifier of the unit that will be providing the invoice type. The unit is filtered against the invoice types' allowed organisational units. The allowed unit identifier fields are the following:
| ||||||||||||
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 |
Response Data
| Name | Type | Description |
|---|---|---|
id | String | The ID of the retrieved financial transaction type |
name | String | The name of the retrieved financial transaction type |
alternative_code | String | The alternative code of the retrieved financial transaction type |
| description | String | A description of the retrieved financial transaction type |
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 |
| log_information | Log Information Object | The log information of the retrieved financial transaction type |
Referred Objects Response Data
Examples
HTTP Method: GET
Request:
Response:
{
"status":
{
"message": "",
"description": "",
"code": "OK"
},
"data":
[
{
"udf_float_1": null,
"udf_float_2": null,
"udf_float_3": null,
"udf_date_1": null,
"udf_float_4": null,
"udf_date_2": null,
"udf_date_3": null,
"udf_date_4": null,
"name": "Invoice 1",
"udf_string_1": null,
"udf_string_2": null,
"udf_string_3": null,
"udf_string_4": null,
"udf_string_5": null,
"udf_string_6": null,
"udf_string_7": null,
"log_information":
{
"updated_date": "2014-07-18T15:29:59",
"created_date": "2014-05-14T09:06:21",
"created_by_unit":
{
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"name": "Admin Unit",
"description": "r1 Test Description for resource request tab.Test Description for resource request tab.",
"alternative_code": "MG"
},
"updated_by_unit":
{
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"name": "Admin Unit",
"description": "r1 Test Description for resource request tab.Test Description for resource request tab.",
"alternative_code": "MG"
},
"created_by_user":
{
"person_name": "MPAdministrator",
"username": "MPAdministrator",
"id": "1"
},
"updated_by_user":
{
"person_name": "g_neocleous",
"username": "g_neocleous",
"id": "80D37EB91123AE12EEABA6232ADA654F"
}
},
"udf_string_8": null,
"id": "D75737F9C4EDF822BBC1024ADE086695",
"description": "Invoice 1",
"alternative_code": "I1"
},
{
"udf_float_1": null,
"udf_float_2": null,
"udf_float_3": null,
"udf_date_1": null,
"udf_float_4": null,
"udf_date_2": null,
"udf_date_3": null,
"udf_date_4": null,
"name": "Invoice 2",
"udf_string_1": null,
"udf_string_2": null,
"udf_string_3": null,
"udf_string_4": null,
"udf_string_5": null,
"udf_string_6": null,
"udf_string_7": null,
"log_information":
{
"updated_date": "2015-08-04T12:31:09",
"created_date": "2014-05-14T09:07:26",
"created_by_unit":
{
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"name": "Admin Unit",
"description": "r1 Test Description for resource request tab.Test Description for resource request tab.",
"alternative_code": "MG"
},
"updated_by_unit":
{
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"name": "Admin Unit",
"description": "r1 Test Description for resource request tab.Test Description for resource request tab.",
"alternative_code": "MG"
},
"created_by_user":
{
"person_name": "MPAdministrator",
"username": "MPAdministrator",
"id": "1"
},
"updated_by_user":
{
"person_name": "MPAdministrator",
"username": "MPAdministrator",
"id": "1"
}
},
"udf_string_8": null,
"id": "AD2930A767CA6BDB51E2BF7072D82E68",
"description": "Invoice 2",
"alternative_code": "I2"
}
]
}
GET invoices/configuration/categories/list
This method returns the invoice categories that are allowed to be used by invoices of a specific type. Multiple invoice categories are returned by each call
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
invoice_type_identifier (mandatory) | Financial Transaction Type Identifier | The identifier of the type of the invoice that will be using the categories. The categories are filtered against the allowed categories of the specified type. The allowed financial transaction type identifier fields are the following:
| ||||||||||||
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 |
Response Data
Name | Type | Description |
|---|---|---|
id | String | The id of the retrieved category |
name | String | The name of the retrieved category |
code | String | The code of the retrieved category |
| description | String | The description of the retrieved category |
| parent_id | String | The id of the retrieved category's parent category |
Examples
HTTP Method: GET
Request:
Response:
{
"status":
{
"message": "",
"description": "",
"code": "OK"
},
"data":
[
{
"parent_id": null,
"id": "1AABE70F46D5937ABE25B2FDCBD7BCF5",
"name": "Invoice Categories",
"description": "Invoice Categories",
"code": "IC"
},
{
"parent_id": "1AABE70F46D5937ABE25B2FDCBD7BCF5",
"id": "FAB9F5213BE89D214775ED35D56A28CB",
"name": "Invoice Category 2",
"description": "Invoice Category 2",
"code": "IC2"
}
]
}
GET invoices/configuration/rejection_reasons/list
This method returns the rejection reasons that can be used while rejecting a draft invoice, as defined through the active financial transactions definition. Multiple rejection reasons are returned by each call
Resource URL
Parameters
Name | Type | Description |
token | String | The token retrieved from the login method |
| 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 |
Response Data
| Name | Type | Description |
|---|---|---|
| default | Boolean | Determines if the rejection reason is the default rejection reason or not |
Rejection Reason Object | The supported rejection reason |
Referred Objects Response Data
Examples
HTTP Method: GET
Request:
Response:
{
"status":
{
"message": "",
"description": "",
"code": "OK"
},
"data":
[
{
"default": false,
"rejection_reason":
{
"id": "CE833230AAD6D276E30DEA53F166CB8F",
"name": "Reject Due to Business Request",
"description": "Reject Due to Business Request",
"alternative_code": "RDTBR"
}
},
{
"default": true,
"rejection_reason":
{
"id": "86082D82A5C8D93D048ED95161C554A7",
"name": "Reject Due to Error",
"description": "Reject Due to Error",
"alternative_code": "RDTE"
}
},
{
"default": false,
"rejection_reason":
{
"id": "B5407A536ACD49B58192D4C19325D2CA",
"name": "Rejection Reason Modal 1",
"description": null,
"alternative_code": "RRM1"
}
}
]
}