# Financial Allocations

Collection of API endpoints to manage Financial Allocations within the Property Management System (PMS). These Allocations are reconciliations between Sales Credits and Sales Invoices. 

## Retrieve list of all allocations involving credit / invoice reconciliations with optional filtering by export statuses. In the PMS, these will be reconciliations of sales credits against sales invoices

 - [GET /api/v3/financialAllocations](https://apidocs.resharmonics.com/apis/resharmonics-pms/financial-allocations/listallocationlistitems.md)

## Create a financial allocation, between a sales credit and a sales invoice.

 - [POST /api/v3/financialAllocations](https://apidocs.resharmonics.com/apis/resharmonics-pms/financial-allocations/performsalescreditallocation.md): This effectively reconciles a sales credit against a sales invoice.

## Retrieve list of all financials allocations for a payment financial using financial ID.

 - [GET /api/v3/financialAllocations/{id}/allocations](https://apidocs.resharmonics.com/apis/resharmonics-pms/financial-allocations/listallocationlistitemsbypaymentid.md)

## Update a financial allocation to a given status in relation to an external finance system

 - [PATCH /api/v3/financialAllocations/{id}/updateFinancialAllocationExportStatus](https://apidocs.resharmonics.com/apis/resharmonics-pms/financial-allocations/updateallocationexportstatus.md): Update the external identifier record linked to a specific financial allocation; the updatable fields are export status, external ID and exported date time. This operation is essential for synchronizing the financial allocation export status with external financial systems, ensuring that the financial allocation export status is maintained in line with the integrated external system. The request body should include the external ID, export status and the exported date. If the specified financial allocation ID does not exist, a 404 Not Found error will be returned. In case of an unexpected system error, a 500 Internal Server Error will be triggered.