Applies to integrated customers using the RecoveryConnect API
Delete Standard Invoice Service Item
Description: This endpoint deletes a specific service item from a standard invoice.
Service items represent individual billable components of an invoice. Removing a service item will update the total invoice amount accordingly. This operation 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}/service_items/{service_item_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/service_items/928101 |
Request Body: NA
Response:
{ "message": "Service item deleted successfully." } |
Add Expense to Standard Invoice
Description: This endpoint adds one or more expenses to an existing standard invoice.
Expenses represent additional operational or miscellaneous costs incurred during service execution, such as towing charges, fuel costs, or other field expenses. These are separate from service items and are included in the overall invoice total.
Although standard invoices are contract-driven, this endpoint allows adding extra costs before invoice finalization.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/orders/{order_id}/standard_invoices/{invoice_id}/expenses
Method: POST
Request Body Parameters:
PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE |
expensesToAdd | |||
expenseItem | Identifier of the expense type/item | Yes | 1001786 |
expenseCost | Cost of the expense | Yes | 50 |
expenseRemarks | Description or remarks for the expense | No | Expense Reason |
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/orders/56226663/standard_invoices/6006470/expenses |
Request Body:
{ "expensesToAdd": [ { "expenseItem": 1001786, "expenseCost": 50, "expenseRemarks": "Expense Reason" } ] } |
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 } ] } } |
Get Standard Invoice Expenses
Description: This endpoint retrieves the list of expenses associated with a specific standard invoice.
Expenses represent additional costs incurred during service execution, such as towing charges, fuel, or other operational expenses. These expenses are included along with service items to form the overall invoice total.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/orders/{order_id}/standard_invoices/{invoice_id}/expenses
Method: GET
Request Body Parameters: NA
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/orders/56226663/standard_invoices/6006470/expenses |
Request Body: NA
Response:
{ "data": [ { "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 } ] } |