Design an invoice correction handoff for Starter Integration
Show the right action while a client corrects a draft invoice, saves it and explicitly submits it through Debitura Starter Integration.
By Lars Holdgaard, Founder & CEO of Debitura

When Starter Integration returns needs_fixing with a current fix link, keep the request on the existing invoice row and send the client to the hosted correction step. After the client returns, read the same request again to decide what the row should show.
Follow one invoice across the handoff
Fictional example. The invoice INV-624 is readable, but the current request reports a missing buyer street address. It belongs to an already connected client with no earlier action due. The client corrects it in Debitura. Your app tracks the request and the next action the API currently returns.
| Client step | Current request evidence | What the invoice row shows | Who acts |
|---|---|---|---|
| First read · 10:00 UTC | needs_fixing, solutionType fix and a current action link. Invoice outcome is draft, with an address issue. | Correct invoice and submit. Open the link supplied by the current response. Keep the same invoice and request associated. | Client opens the hosted correction. |
| Client saves and returns · 10:07 UTC | Fresh read still shows needs_fixing and a draft invoice. Saving details leaves it a draft. | Return to the correction task if the current response still provides the fix link. The request is awaiting explicit submission. | Client reviews and submits on Debitura. |
| Client submits and returns · 10:12 UTC | Fresh read shows request status submitted, invoice outcome created, a case ID and case status PendingVerification in this example. | Submitted for verification. Show the returned case link when available and display the actual case status. | Your app updates the existing invoice row from the current read. |
Give the client an action from the current response
The current GET response drives the display after the client returns or selects Refresh, or after your integration receives a verified update. A fresh link for this invoice can open the action that is currently due. If the link is absent, leave a refresh action and show what the current response confirms.
Keep the correction in the hosted flow
Your row can show the issue described by the response and the latest confirmation time. Have the client enter corrected invoice details in Debitura. Keep your app’s original submission action unavailable while that invoice has an unresolved existing request.
Copy the worksheet
Paste the rows into a spreadsheet and replace the fictional identifiers with your own.
| Invoice ref | Request ref | Client step | Time UTC | Current request status | Invoice outcome / case status | Row action | Next owner |
|---|---|---|---|---|---|---|---|
| INV-624 | REQ-624 | First read | 10:00 | needs_fixing | draft | Open current correction link | Client |
| INV-624 | REQ-624 | Saved | 10:07 | needs_fixing | draft | Open current fix link if available | Client |
| INV-624 | REQ-624 | Submitted | 10:12 | submitted | created / PendingVerification | Show current case status and returned link if available | Integration |
Next step
See how to embed debt collection
References
-min.webp)
Sign up to our newsletter
Get updated on best practices, tips and tricks about international debt collection and accounts receivable management.

.webp)