Day 3: Store IRBM UUID and Submission Timestamp for Tracking #irbuuid

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.

Comments

No comments yet. Why don’t you start the discussion?

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.