Applies to integrated customers using the RecoveryConnect API
Update Standard Invoice
Description: This endpoint updates an existing standard invoice associated with a specific order.
Standard invoices follow a contract-driven billing structure, but allow updates to key fields such as billing details, due date, invoice status, and invoice number.
This endpoint is typically used during the invoice lifecycle, for example when moving an invoice from draft → submitted → approved.
Only the fields provided in the request body will be updated. Fields not included will remain unchanged.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/orders/{order_id}/standard_invoices/{invoice_id}
Method: PUT
Request Body Parameters:
PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE |
billTo | Identifier of the entity to whom the invoice is billed | No | 65690 |
invoiceDueDate | Updated due date and time for the invoice | No | 2025-08-28 22:02.57 |
bill_from_location | Updated billing source location ID | No | 16217129 |
bill_to_location | Updated billing destination location ID | No | 56458222 |
status | Updated invoice status (e.g., draft, submitted, approved) | No | submitted |
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/orders/56226663/standard_invoices/6006470 |
Request Body:
{ "billTo": 65690, "invoiceDueDate": "2023-08-28 22:02.57", "bill_from_location": 16217129, "bill_to_location": 56458222, "status": "submitted", "invoiceNum": 648 } |
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 } ] } } |
Delete Standard Invoice
Description: This endpoint deletes an existing standard invoice associated with a specific order.
Standard invoices can be deleted when they are no longer required or were created incorrectly. Typically, deletion is allowed only when the invoice is in a draft or unsubmitted state. Once an invoice is submitted or approved, deletion may be restricted based on system rules.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/orders/{order_id}/standard_invoices/{invoice_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 |
Request Body: NA
Response:
{ "message": "Invoice deleted successfully." } |
Create Standard Invoice Service Item
Description: This endpoint adds one or more service items to an existing standard invoice.
Service items represent individual billable charges included in the invoice, such as recovery fees, storage charges, or other contract-based services. These items contribute directly to the total invoice amount.
Although standard invoices are generally contract-driven, this endpoint allows adding or adjusting specific service items before finalizing the invoice.
All requests must include a valid Bearer Token in the request header.
URL: /api/v150/orders/{order_id}/standard_invoices/{invoice_id}/service_items
Method: POST
Request Body Parameters:
PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE |
itemsToAdd | |||
itemID | Identifier of the service item | Yes | 1016235 |
itemDate | Date and time when the service was performed | Yes | 2026-02-18 21:02.6 |
itemQty | Quantity of the service item | Yes | 1 |
itemCost | Cost of the service item | Yes | 122 |
itemRemarks | Description or remarks for the service item | No | Adding Personal Property Storage Fee |
itemTaxRate | Array of applicable tax rate IDs | No | [253] |
Success Code: 200 OK – Request Successful
Example:
URL: https://api.mbsisystems.com/api/v150/orders/56226663/standard_invoices/6006470/service_items |
Request Body:
{ "itemsToAdd": [ { "itemID": 1016235, "itemDate": "2026-02-25 21:02.57", "itemQty": 1, "itemCost": 122, "itemRemarks": "Adding Personal Property Storage Fee", "itemTaxRate": [ 253 ] } ] } |
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 } ] } } |