Debt enforcement
-
2
 min read

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

Design an invoice correction handoff for Starter Integration

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.

Worked example and next actions
Client stepCurrent request evidenceWhat the invoice row showsWho acts
First read · 10:00 UTCneeds_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 UTCFresh 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 UTCFresh 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 refRequest refClient stepTime UTCCurrent request statusInvoice outcome / case statusRow actionNext owner
INV-624REQ-624First read10:00needs_fixingdraftOpen current correction linkClient
INV-624REQ-624Saved10:07needs_fixingdraftOpen current fix link if availableClient
INV-624REQ-624Submitted10:12submittedcreated / PendingVerificationShow current case status and returned link if availableIntegration

Next step

See how to embed debt collection

References

Subscription

Sign up to our newsletter

Get updated on best practices, tips and tricks about international debt collection and accounts receivable management.

Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.