POST accounts_receivable/assets/import
- Joseph Ioannou (Unlicensed)
- Ekaterini Tzirtzipi
- George Rossides (Unlicensed)
Available from CRM.COM R14.0.0
This method is used when a traceable physical good is brought by a customer and will be imported as an Asset to the respective Accounts Receivable. These goods have an ownership status that of "Owned by Customer" and do not have a Physical Good Sale against them. Multiple traceable physical goods can be imported through each call. Fixed Bundles or Physical Goods that are Part of a Bundle are not applicable
Resource URL
Parameters
Name | Type | Description | ||||||||||||||||||||||||||||||
token | String | The token retrieved from the login method | ||||||||||||||||||||||||||||||
| accounts_receivable_identifier (mandatory) | Account Receivable Identifier | The identifier of the account receivable that owns the traceable physical good. The allowed account receivable identifier fields are the following:
| ||||||||||||||||||||||||||||||
accounts_receivable_assets_set (mandatory) | Set of Accounts Receivable Assets | A set of traceable physical goods that were brought by the customer and will be imported into the system as the account owner's Assets Not applicable for traceable physical goods that are Bundles or Components of a Bundle | ||||||||||||||||||||||||||||||
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
Response Data
Name | Type | Description |
|---|---|---|
| id | String | The id of the physical good sale |
| sales_method | String | The sales method that was used while selling the installed item, which can be DIRECT_SALE, INDIRECT_SALE or PRE_SALE |
| performed_date | Date | The date that the installed item was provided to the customer |
| transferred_date | Date | The date on which the purchase physical good's ownership was transferred Available from CRM.COM R13.0.0 |
| accounts_receivable | Accounts Receivable Object | The Accounts Receivable that owns the specified physical good. Available from CRM.COM R13.0.0 |
| ownership_transferred_from
| Accounts Receivable Object | The Accounts Receivable from which the purchased physical good's ownership was transferred. Available from CRM.COM R13.0.0 |
| performed_by_user | User Object | The user that provided the installed item to the customer |
| transferred_by_user | User Object | The user that transferred the ownership of the purchased physical good to this account owner. Available from CRM.COM R13.0.0 |
| product | Product Object | The purchased physical good |
| installed_item | Installed Item Object | The purchased installed item |
| invoice | Invoice Object | The invoice that was posted for the purchased physical good |
| stock_out_warehouse_transaction | Warehouse Transaction Object | The stock out warehouse transaction that was applied in order to move the installed item out of the warehouse while selling it to the customer |
| job | Job Object | The Job through which the physical goods was sold to the account owner Available from CRM.COM R11.5.0 and CRM.COM R12.1.0 |
Referred Objects Response Data
Examples
HTTP Method: POST
{{server}}/crmapi/rest/v2/accounts_receivable/assets/import
Request
Response
{
"data": [
{
"ownership_transferred_to": null,
"product": null,
"performed_date": null,
"performed_by_user": null,
"transferred_by_user": null,
"stock_in_warehouse_transaction": null,
"ownership_transferred_from": null,
"accounts_receivable": null,
"transfer_date": null,
"credit_note": null,
"installed_item": {
"product": {
"code": "Printer",
"product_type": {
"service_type": null,
"used_for_provisioning": false,
"alternative_code": "MRTB",
"udr_type": null,
"composition_method": "FLAT",
"name": "Meter Reading Type B",
"description": null,
"id": "E1B628FD5EBF4F25B83911E76AC94B13",
"classification": "PHYSICALGOODS",
"physical_good_type": "TRACEABLE"
},
"alternative_code": "P_11",
"description": "Printer",
"id": "EF45A7E442744146B62F33BEB2987328",
"priority_level": null
},
"alternative_code": "Printer2",
"serial_number": "Printer2",
"id": "DB2AC2A2054146F2B11D062594B936A5",
"state": "EFFECTIVE"
},
"sales_method": "",
"returned_by_user": null,
"id": "951907A4DF7D4C9A9B4916D1227ABECC",
"invoice": null,
"job": null,
"stock_out_warehouse_transaction": null,
"return_date": null
},
{
"ownership_transferred_to": null,
"product": null,
"performed_date": null,
"performed_by_user": null,
"transferred_by_user": null,
"stock_in_warehouse_transaction": null,
"ownership_transferred_from": null,
"accounts_receivable": null,
"transfer_date": null,
"credit_note": null,
"installed_item": {
"product": {
"code": "Printer",
"product_type": {
"service_type": null,
"used_for_provisioning": false,
"alternative_code": "MRTB",
"udr_type": null,
"composition_method": "FLAT",
"name": "Meter Reading Type B",
"description": null,
"id": "E1B628FD5EBF4F25B83911E76AC94B13",
"classification": "PHYSICALGOODS",
"physical_good_type": "TRACEABLE"
},
"alternative_code": "P_11",
"description": "Printer",
"id": "EF45A7E442744146B62F33BEB2987328",
"priority_level": null
},
"alternative_code": "Printer1",
"serial_number": "Printer1",
"id": "C52669079E56431FB0F3FE5B7092AC2F",
"state": "EFFECTIVE"
},
"sales_method": "",
"returned_by_user": null,
"id": "B20881E9C59F459489603659AFC5BB6B",
"invoice": null,
"job": null,
"stock_out_warehouse_transaction": null,
"return_date": null
}
],
"status": {
"code": "OK",
"description": "",
"message": ""
}
}