Applies to integrated customers using the RecoveryConnect API
Delete Expense from Standard Invoice
Description: This endpoint deletes a specific expense from a standard invoice.
Expenses represent additional operational costs included in the invoice. Removing an expense will update the total invoice amount accordingly. This action is typically allowed when the invoice is in a draft or editable state.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/orders/{order_id}/standard_invoices/{invoice_id}/expenses/{expense_id}
Method: DELETE
Request Body Parameters: NA
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/orders/56226663/standard_invoices/6006470/expenses/928101 |
Request Body: NA
Response:
{ "message": "Expense deleted successfully." } |
Get Standard Invoice Billable Fees
Description: This endpoint retrieves the list of billable fees available for standard invoice creation for a specific order.
Billable fees represent predefined chargeable items configured under the contract, such as recovery charges, storage fees, and other service-related costs. These are used as reference data while creating or updating standard invoice service items.
The response may also include contract-related billing configurations applicable to the order.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/orders/{order_id}/standard_invoice_billable_fees
Method: GET
Request Body Parameters: NA
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/orders/56226663/standard_invoice_billable_fees |
Request Body: NA
Response:
{ "data": { "standard_fees_by_client": [ { "fee_id": 276417, "default_amount": 19, "fee_name": "FielVisit" } ], "standard_fees_for_client": [ { "fee_id": 276417, "default_amount": 19, "fee_name": "FielVisit" } ], "standard_fees_by_department": [ { "fee_id": 276417, "default_amount": 19, "fee_name": "FielVisit" } ], "default_standard_fees": [ { "fee_id": 276417, "default_amount": 19, "fee_name": "FielVisit" } ] }, "meta": { "bill_to_location": [ { "id": 56712, "name": "0", "address_1": "730 Paradise Lane", "address_2": null, "unit": null, "zip": 48336, "type": 1, "latitude": 33.65031449, "longitude": -117.24815155, "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2014-10-29 19:01:18", "updated_at": "2017-12-13 01:21:33", "deleted_at": null, "migration": null, "phones": [ { "id": 11314, "type": 6, "mobile_carrier_id": null, "number": "123456", "extension": null, "memo": null, "valid": 1, "no_contact": 0, "created_at": "2020-06-10 10:53:41", "updated_at": "2020-06-10 10:53:41", "migration": null, "address_with_number": "No Address" } ], "zip_code_details": { "zip_code_id": 48336, "zip_code": "92507", "zip_code_city_id": 48330, "city_name": "Riverside", "zip_code_state_id": 47459, "state_name": "California", "state_abbr": "CA", "state_county": "CA-Riverside", "zip_code_county_id": 47953, "county_name": "Riverside", "latitude": 33.976325, "longitude": -117.330414, "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-117.274844\",\"34.004654\",\"0.0\"],[\"-117.268245\",\"33.940869\",\"0.0\"],[\"-117.289141\",\"33.924923\",\"0.0\"],[\"-117.37657\",\"33.968912\",\"0.0\"],[\"-117.339179\",\"34.0195\",\"0.0\"],[\"-117.336429\",\"34.0195\",\"0.0\"],[\"-117.305637\",\"34.0195\",\"0.0\"],[\"-117.274844\",\"34.004654\",\"0.0\"]]" } } ], "bill_from_location": [ { "id": 56712, "name": "0", "address_1": "730 Paradise Lane", "address_2": null, "unit": null, "zip": 48336, "type": 1, "latitude": 33.65031449, "longitude": -117.24815155, "date_delay": null, "available_from": "00:00:00", "available_to": "23:59:00", "priority": 0, "hits": 0, "no_contact": 0, "created_at": "2014-10-29 19:01:18", "updated_at": "2017-12-13 01:21:33", "deleted_at": null, "migration": null, "phones": [ { "id": 11314, "type": 6, "mobile_carrier_id": null, "number": "123456", "extension": null, "memo": null, "valid": 1, "no_contact": 0, "created_at": "2020-06-10 10:53:41", "updated_at": "2020-06-10 10:53:41", "migration": null, "address_with_number": "No Address" } ], "zip_code_details": { "zip_code_id": 48336, "zip_code": "92507", "zip_code_city_id": 48330, "city_name": "Riverside", "zip_code_state_id": 47459, "state_name": "California", "state_abbr": "CA", "state_county": "CA-Riverside", "zip_code_county_id": 47953, "county_name": "Riverside", "latitude": 33.976325, "longitude": -117.330414, "system_msg": 0, "country": "United States of America", "country_code": "US", "trigger_msg": 0, "shape_data": "[[[\"-117.274844\",\"34.004654\",\"0.0\"],[\"-117.268245\",\"33.940869\",\"0.0\"],[\"-117.289141\",\"33.924923\",\"0.0\"],[\"-117.37657\",\"33.968912\",\"0.0\"],[\"-117.339179\",\"34.0195\",\"0.0\"],[\"-117.336429\",\"34.0195\",\"0.0\"],[\"-117.305637\",\"34.0195\",\"0.0\"],[\"-117.274844\",\"34.004654\",\"0.0\"]]" } } ], "tax_rates": [ { "id": 533, "company_id": 180540, "name": "Tax", "description": "Tax Rate", "rate": "Tax" } ] } } |
Attach Fee Request to Standard Invoice
Description: This endpoint attaches one or more existing fee requests to a standard invoice.
Fee requests represent pre-approved or pending billing charges created earlier in the workflow. By attaching them to a standard invoice, these charges become part of the invoice total and billing breakdown.
This is typically used to include additional charges into a standard invoice before submission or approval.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/orders/{order_id}/standard_invoices/{invoice_id}/fee_requests/attach
Method: POST
Request Body Parameters:
PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE |
fee_request_ids | Array of fee request IDs to be attached to the invoice | Yes | [7428684] |
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/orders/56226663/standard_invoices/6006470/fee_requests/attach |
Request Body:
{ "fee_request_ids": [ 7428684 ] } |
Response:
{ "data": { "id": 6006470, "order_id": 56226663, "order_type_id": 1, "billed_company_id": 65690, "billed_company_name": "Demo Bank and Trust MRS", "company_refno": 19015, "status": "draft", "gross_amount": 500, "tax_amount": 68.75, "is_sent": 0, "is_recurring": 0, "payment_status": "unpaid", "due_date": "2023-04-09 12:00:00", "date_accepted": "2023-04-09 12:00:00", "created_at": "2024-04-04 00:00:00", "updated_at": "2023-03-09 23:23:00", "date_sent": "2023-03-09 23:23:00", "date_paid": "2024-04-04 23:23:00", "from_location": 4, "to_location": 276417, "is_contracted": 1, "service_items": [ { "id": 928101, "item_id": 6006470, "item_name": "Collateral Redemption Reinstatement Fee", "gross_amount": 75.3, "tax_amount": 10.35, "net_amount": 85.65, "quantity": 1, "remarks": "testing", "is_expense": 0, "pay_to_id": 23992, "pay_to_type": "employee", "created_at": "2024-04-04 00:00:00", "updated_at": "2024-04-04 00:00:00", "approval_status": "Approved", "is_contracted": 1 } ] } } |