After submitting an invoice to IRBM successfully, you’ll receive a UUID that uniquely identifies that invoice in the MyInvois system. Storing this UUID allows you to:
- ✅ Track invoice status later via API
- ✅ Display it on PDFs, emails, and audit logs
- ✅ Avoid duplicate submissions
✅ Example API Response:
{
"uuid": "12345678-90ab-cdef-1234-567890abcdef",
"submissionDateTime": "2024-01-01T10:00:00Z",
"invoiceStatus": "RECEIVED"
}
✅ What to do in Laravel:
// After successful submission
$invoice->update([
'irb_uuid' => $response['uuid'] ?? null,
'irb_submitted_at' => now(),
'irb_status' => $response['invoiceStatus'] ?? 'UNKNOWN',
]);
Recommended Columns:
irb_uuid
(string)irb_submitted_at
(timestamp)irb_status
(string)
This will help when implementing status checks or reconciling submission logs.
Coming up in Day 4:
We’ll implement a command to auto-retry failed IRBM submissions using Laravel queues.