GET credit_notes/show
This method returns information related with a credit note. A single credit note is returned by each call
Resource URL
Parameters
Name | Type | Description | |||||||||||||||
token | String | The token retrieved from the login method | |||||||||||||||
credit_note_identifier (mandatory) | Credit note identifier | The identifier of the credit not that should be returned as a result. The allowed credit note 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 |
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 credit note |
number | String | The number of the retrieved credit note |
reference_number | String | The reference number of the retrieved credit note |
life_cycle_state | String | The state of the retrieved credit note which can be one of the following: DRAFT, REJECTED, POSTED, CANCELLED |
discount_amount | Number | The total discount amount provided by the credit note |
vat_amount | Number | The total VAT amount applied on the credit note Deprecated from CRM.COM R17.0.0 |
tax_amount | Number | The total Tax amount applied on the credit note Available from CRM.COM R12.0.0 |
net_amount | Number | The total net amount of the credit note |
total_amount | Number | The total amount which is credited |
issued_on | Date | The date that the credit note was issued |
posted_on | Date | The date that the credit note was posted |
notes | String | Shared notes for the credit note |
back_office_code | String | The back office code of the retrieved credit note |
issue_reason | String | A description of the reason that the credit note is issued |
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 |
accounts_receivable | Accounts receivable object | The related accounts receivable |
member_account | Accounts receivable object | The member accounts receivable. Applicable only if the retrieved Credit Note was issued against a parent accounts receivable which fund the member accounts of its group. |
type | Financial transaction type object | The financial transaction type of this credit note |
category | Financial transaction category object | The category of the credit note |
rejection_reason | Financial transaction rejection reason object | The reason that the credit note was rejected |
accounting_period_information | Accounting Period Information object | The Accounting Period Information of the credit note which includes the Accounting period of the credit note and the date on which it was set. This is applicable only if the credit note is processed during an Accounting Period Closing process |
currency_rate_period | Currency Rate Period object | The currency rate period based on which the credit note's amounts were calculated Available from CRM.COM R10.0.0 |
Log Information Object | The log information relatedwiththe retrieved credit note | |
credit_note_item_set | Set of invoice item objects | A list of items which are credited by this credit note |
Referred Objects Response Data
Examples
GET credit_notes/list
This method returns information related with credit notes. Multiple credit notes are returned by each call
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
accounts_receivable_identifier (mandatory) | Accounts receivable identifier | The identifier of the accounts receivable in which the credit note that should be returned as a result should be allocated. The allowed accounts receivable identifier fields are the following:
| ||||||||||||
type_identifier (optional) | Financial transaction type identifier | The financial transaction type of the credit note that should be returned as a result. The allowed financial transaction type identifier field are the following:
| ||||||||||||
category_identifier (optional) | Financial transaction category identifier | The financial transaction category of the credit note that should be returned as a result. The allowed financial transaction category 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 |
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 credit note |
number | String | The number of the retrieved credit note |
reference_number | String | The reference number of the retrieved credit note |
life_cycle_state | String | The state of the retrieved credit note which can be one of the following: DRAFT, REJECTED, POSTED, CANCELLED |
discount_amount | Number | The total discount amount provided by the credit note |
vat_amount | Number | The total VAT amount applied on the credit note Deprecated from CRM.COM R17.0.0 |
tax_amount | Number | The total Tax amount applied on the credit note Available from CRM.COM R12.0.0 |
net_amount | Number | The total net amount of the credit note |
total_amount | Number | The total amount which is credited |
issued_on | Date | The date that the credit note was issued |
posted_on | Date | The date that the credit note was posted |
notes | String | Shared notes for the credit note |
back_office_code | String | The back office code of the retrieved credit note |
issue_reason | String | A description of the reason that the credit note is issued |
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 |
accounts_receivable | Accounts receivable object | The related accounts receivable |
member_account | Accounts receivable object | The member accounts receivable. Applicable only if the retrieved Credit Note was issued against a parent accounts receivable which fund the member accounts of its group. |
type | Financial transaction type object | The financial transaction type of this credit note |
category | Financial transaction category object | The category of the credit note |
rejection_reason | Financial transaction rejection reason object | The reason that the credit note was rejected |
accounting_period_information | Accounting Period Information object | The Accounting Period Information of the credit note which includes the Accounting period of the credit note and the date on which it was set. This is applicable only if the credit note is processed during an Accounting Period Closing process |
currency_rate_period | Currency Rate Period object | The currency rate period based on which the credit note's amounts were calculated Available from CRM.COM R10.0.0 |
Log Information Object | The log information relatedwiththe retrieved credit note | |
credit_note_item_set | Set of invoice item objects | A list of items which are credited by this credit note |
Referred Objects Response Data
Examples
POST credit_notes/create
This method is creating a new credit note either in Draft or Posted state
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
accounts_receivable_identifier (mandatory) | Accounts receivable identifier | The identifier of the accounts receivable in which the credit note should be allocated to. The allowed accounts receivable identifier fields are the following:
| ||||||||||||
type_identifier (mandatory) | Financial transaction type identifier | The financial transaction type of the credit note. The allowed financial transaction type identifier field are the following:
| ||||||||||||
life_cycle_state (mandatory) | String | The state of the retrieved credit note which can be one of the following: DRAFT, POSTED | ||||||||||||
category_identifier (optional) | Financial transaction category identifier | The financial transaction category of the credit note that should be returned as a result. The allowed financial transaction category identifier fields are the following:
| ||||||||||||
member_accounts_receivable_identifier (optional) | Accounts receivable identifier | The member accounts receivable. Applicable only if the Credit Note is issued against a parent accounts receivable within a group which funds its members. The allowed accounts receivable identifier fields are the following:
| ||||||||||||
notes (optional) | String | Shared notes for the credit note | ||||||||||||
back_office_code (optional) | String | A back office code for the credit note. If specified then it should be unique | ||||||||||||
issue_reason (optional) | String | A description of the reason that the credit note is issued | ||||||||||||
intended_currency_identifier (optional) | Currency Identifier | The currency that the user was intended to use for the credit note. If specified then it is validated against the currency of the specified accounts receivable and if they don't match then an error is throw. Note that the intended currency is not saved within CRM.COM; it is just used for validation purposes. The allowed currency identifier fields are the following:
| ||||||||||||
udf_string_1 (optional) | String | User Defined Field of type String | ||||||||||||
udf_string_2 (optional) | String | User Defined Field of type String | ||||||||||||
udf_string_3 (optional) | String | User Defined Field of type String | ||||||||||||
udf_string_4 (optional) | String | User Defined Field of type String | ||||||||||||
udf_string_5 (optional) | String | User Defined Field of type String | ||||||||||||
udf_string_6 (optional) | String | User Defined Field of type String | ||||||||||||
udf_string_7 (optional) | String | User Defined Field of type String | ||||||||||||
udf_string_8 (optional) | String | User Defined Field of type String | ||||||||||||
udf_float_1 (optional) | Float | User Defined Field of type Float | ||||||||||||
udf_float_2 (optional) | Float | User Defined Field of type Float | ||||||||||||
udf_float_3 (optional) | Float | User Defined Field of type Float | ||||||||||||
udf_float_4 (optional) | Float | User Defined Field of type Float | ||||||||||||
udf_date_1 (optional) | Date | User Defined Field of type Date | ||||||||||||
udf_date_2 (optional) | Date | User Defined Field of type Date | ||||||||||||
udf_date_3 (optional) | Date | User Defined Field of type Date | ||||||||||||
udf_date_4 (optional) | Date | User Defined Field of type Date | ||||||||||||
(optional) | Set of invoice objects | The invoices that are intended to be credited | ||||||||||||
(mandatory) | Set of credit item objects | The items of the credit not | ||||||||||||
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
Examples
POST credit_notes/post
This method is used to post a credit note which is in draft state.
Resource URL
Parameters
Name | Type | Description | |||||||||||||||
token | String | The token retrieved from the login method | |||||||||||||||
credit_note_identifier (mandatory) | Credit note identifier | The identifier of the credit note that should be posted. Only credit notes in draft state can be specified.The allowed credit note identifier fields are the following:
| |||||||||||||||
fields_set | 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 |
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
Examples
POST credit_notes/reject
This method is used to reject a credit note which is in draft state.
Resource URL
Parameters
Name | Type | Description | |||||||||||||||
token | String | The token retrieved from the login method | |||||||||||||||
credit_note_identifier (mandatory) | Credit note identifier | The identifier of the credit note that should be posted. Only credit notes in draft state can be specified.The allowed credit note identifier fields are the following:
| |||||||||||||||
rejection_reason_identifier | Rejection reason identifier | The reason that the credit note is rejected. The allowed rejection reason identifier fields are the following:
| |||||||||||||||
fields_set | 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 |
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
Examples
POST credit_notes/update
Available from CRM.COM R9.1.0
This method is updating a single Credit Note but only as long as it is in Draft life cycle state
Resource URL
Parameters
Name | Type | Description | |||||||||||||||
token | String | The token retrieved from the login method | |||||||||||||||
credit_note_identifier (mandatory) | Credit Note identifier | The identifier of the credit note that should be updated. Only credit notes in draft state can be specified.The allowed credit note identifier fields are the following:
| |||||||||||||||
accounts_receivable_identifier (optional) | Accounts receivable identifier | The identifier of the accounts receivable in which the credit note should be allocated to. The allowed accounts receivable identifier fields are the following:
| |||||||||||||||
type_identifier (optional) | Financial transaction type identifier | The financial transaction type of the credit note. Only financial transaction types with classification Credit Note can be specified. The allowed financial transaction type identifier field are the following:
| |||||||||||||||
category_identifier (optional) | Financial transaction category identifier | The financial transaction category of the credit note that should be returned as a result. The allowed financial transaction category identifier fields are the following:
| |||||||||||||||
member_accounts_receivable_identifier (optional) | Accounts receivable identifier | The member accounts receivable. Applicable only if the Credit Note is issued against a parent accounts receivable within a group which funds its members. The allowed accounts receivable identifier fields are the following:
| |||||||||||||||
notes (optional) | String | Shared notes for the credit note | |||||||||||||||
back_office_code (optional) | String | A back office code for the credit note. If specified then it should be unique
| |||||||||||||||
issue_reason (optional) | String | A description of the reason that the credit note is issued | |||||||||||||||
intended_currency_identifier (optional) | Currency Identifier | The currency that the user was intended to use for the credit note. If specified then it is validated against the currency of the specified accounts receivable and if they don't match then an error is throw. Note that the intended currency is not saved within CRM.COM; it is just used for validation purposes. The allowed currency identifier fields are the following:
| |||||||||||||||
udf_string_1 (optional) | String | User Defined Field of type String | |||||||||||||||
udf_string_2 (optional) | String | User Defined Field of type String | |||||||||||||||
udf_string_3 (optional) | String | User Defined Field of type String | |||||||||||||||
udf_string_4 (optional) | String | User Defined Field of type String | |||||||||||||||
udf_string_5 (optional) | String | User Defined Field of type String | |||||||||||||||
udf_string_6 (optional) | String | User Defined Field of type String | |||||||||||||||
udf_string_7 (optional) | String | User Defined Field of type String | |||||||||||||||
udf_string_8 (optional) | String | User Defined Field of type String | |||||||||||||||
udf_float_1 (optional) | Float | User Defined Field of type Float | |||||||||||||||
udf_float_2 (optional) | Float | User Defined Field of type Float | |||||||||||||||
udf_float_3 (optional) | Float | User Defined Field of type Float | |||||||||||||||
udf_float_4 (optional) | Float | User Defined Field of type Float | |||||||||||||||
udf_date_1 (optional) | Date | User Defined Field of type Date | |||||||||||||||
udf_date_2 (optional) | Date | User Defined Field of type Date | |||||||||||||||
udf_date_3 (optional) | Date | User Defined Field of type Date | |||||||||||||||
udf_date_4 (optional) | Date | User Defined Field of type Date | |||||||||||||||
(optional) | Set of invoice objects | The invoices that are intended to be credited If no records are specified in the set then nothing will be updated. To update a record use "action" : "update". To remove a record use "action" : "remove". To add a record use "action" : "add". Different actions can be used within the same set. For example: "set": [ { "action": "update", ........... }, { "action": "remove", ........... }, { "action": "add", ........... } ] | |||||||||||||||
(optional) | Set of credit item objects | The items of the credit note If no records are specified in the set then nothing will be updated. To update a record use "action" : "update". To remove a record use "action" : "remove". To add a record use "action" : "add". Different actions can be used within the same set. For example: "set": [ { "action": "update", ........... }, { "action": "remove", ........... }, { "action": "add", ........... } ] | |||||||||||||||
fields_set | 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 credit note |
number | String | The number of the retrieved credit note |
reference_number | String | The reference number of the retrieved credit note |
life_cycle_state | String | The state of the retrieved credit note which can be one of the following: DRAFT, REJECTED, POSTED, CANCELLED |
discount_amount | Number | The total discount amount provided by the credit note |
vat_amount | Number | The total VAT amount applied on the credit note Deprecated from CRM.COM R17.0.0 |
tax_amount | Number | The total Tax amount applied on the credit note Available from CRM.COM R12.0.0 |
net_amount | Number | The total net amount of the credit note |
total_amount | Number | The total amount which is credited |
issued_on | Date | The date that the credit note was issued |
posted_on | Date | The date that the credit note was posted |
notes | String | Shared notes for the credit note |
back_office_code | String | The back office code of the retrieved credit note |
issue_reason | String | A description of the reason that the credit note is issued |
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 |
accounts_receivable | Accounts receivable object | The related accounts receivable |
member_account | Accounts receivable object | The member accounts receivable. Applicable only if the retrieved Credit Note was issued against a parent accounts receivable which fund the member accounts of its group. |
type | Financial transaction type object | The financial transaction type of this credit note |
category | Financial transaction category object | The category of the credit note |
rejection_reason | Financial transaction rejection reason object | The reason that the credit note was rejected |
accounting_period_information | Accounting Period Information object | The Accounting Period Information of the credit note which includes the Accounting period of the credit note and the date on which it was set. This is applicable only if the credit note is processed during an Accounting Period Closing process |
currency_rate_period | Currency Rate Period object | The currency rate period based on which the credit note's amounts were calculated Available from CRM.COM R10.0.0 |
Log Information Object | The log information relatedwiththe retrieved credit note | |
credit_note_item_set | Set of invoice item objects | A list of items which are credited by this credit note |
Referred Objects Response Data