{"id":998,"date":"2026-09-22T09:07:20","date_gmt":"2026-09-22T09:07:20","guid":{"rendered":"https:\/\/smppcenter.com\/kb\/?p=998"},"modified":"2026-09-22T09:07:22","modified_gmt":"2026-09-22T09:07:22","slug":"global-error-codes-setup-smpp-software","status":"publish","type":"post","link":"https:\/\/smppcenter.com\/kb\/global-error-codes-setup-smpp-software\/","title":{"rendered":"How to Set Up Global Error Codes So Your Clients Get Consistent Delivery Statuses"},"content":{"rendered":"\n\n

Every vendor you connect to returns its own error codes. If those raw codes reached your clients, each client would have to handle a different set of codes for every route you use, and switching a vendor would break their integration. Global Error Codes<\/strong> fix this. You define one catalog of codes, map each vendor’s codes to it, and your clients only ever see your catalog in their delivery reports.<\/p>\n\n\n\n

Where to find it<\/h3>\n\n\n\n

Sidebar \u2192 Settings \u2192 Error Codes \u2192 Global<\/strong><\/p>\n\n\n\n

What each field controls<\/h3>\n\n\n\n
Field<\/th>What it does<\/th>How aggregators use it<\/th><\/tr><\/thead>
Product<\/strong><\/td>SMS, WhatsApp, etc.<\/td>Keep separate catalogs per channel<\/td><\/tr>
Identifier<\/strong><\/td>Unique name for the code<\/td>Use readable names like ABSENT_SUBSCRIBER<\/code><\/td><\/tr>
Source<\/strong><\/td>OPERATOR<\/code> or INTERNAL<\/code><\/td>INTERNAL<\/code> fails the message on your platform without sending it to any vendor<\/td><\/tr>
Status<\/strong><\/td>SUBMITTED<\/code>, DELIVERED<\/code>, FAILED<\/code>, NOTSENT<\/code><\/td>The final status your client sees<\/td><\/tr>
Cause<\/strong><\/td>Description text<\/td>Shown to clients, so write it for them<\/td><\/tr>
Charge to User<\/strong><\/td>Yes\/No<\/td>Whether your client pays for this outcome<\/td><\/tr>
Charge by Operator<\/strong><\/td>Yes\/No<\/td>Whether your vendor bills you for it<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Steps<\/h3>\n\n\n\n
    \n
  1. Open Manage Global Error Codes<\/strong> and click + (Add)<\/strong>.<\/li>\n\n\n\n
  2. Select the Product<\/strong>.<\/li>\n\n\n\n
  3. Enter an Identifier<\/strong> and a client-friendly Cause<\/strong>.<\/li>\n\n\n\n
  4. Set Source<\/strong>. If you pick INTERNAL<\/strong>, set Status<\/strong> to NOTSENT<\/strong>.<\/li>\n\n\n\n
  5. Set Charge to User<\/strong> and Charge by Operator<\/strong>.<\/li>\n\n\n\n
  6. Click Save Changes<\/strong>.<\/li>\n<\/ol>\n\n\n\n

    To add a similar code quickly, use the Clone<\/strong> action on an existing row. You can also export the whole catalog from the list screen.<\/p>\n\n\n\n

    Using the two charge flags for margin control<\/h3>\n\n\n\n

    The two charge flags are commercial decisions, and they don’t have to match:<\/p>\n\n\n\n