M3 Recode Supplier Invoice

Use the Recode Supplier Invoice Widget to correct accounting lines on supplier invoices that have already been posted to the general ledger and have reached status 90. The widget supports controlled recoding by guiding you through the process of selecting eligible accounting lines, applying transaction type and dimension rules, balancing the recode, and creating recode entries.

The widget runs in the context of posted supplier invoices and uses standard APS450 APIs. This functionality helps ensure that recoding follows M3 accounting principles while maintaining a complete audit trail.

To help you recode posted supplier invoice accounting lines, the widget:

  • Listens to the InforSupplierInvoice business context.
  • Retrieves the voucher accounting lines associated with the selected invoice.
  • Enables you redistribute amounts by applying a configured Standard Voucher.
  • Creates recode voucher lines through standard APS450 processing while preserving the original voucher.

Prerequisites

Before you use the widget:

  1. Add the widget to programs that publish the InforSupplierInvoice business context, such as APS200, APS205, and CMS740.
  2. Ensure that the source list view includes these context fields:
    • Invoice Number (id1)
    • Supplier ID (id2)
    • Invoice Year (id6)
  3. Configure a Standard Voucher (STVO) in the widget settings.

Scope

You can use the widget to:

  • Recode supplier invoices that are GL-posted and have reached status 90.
  • Select and recode eligible voucher accounting lines.
  • Create recode batches through APS450 and validate and confirm them through APS455.
  • Maintain a complete audit trail throughout the recoding process.

Limitations

The current version has these limitations:

  • Debit or credit switching handling (S/H) support is not supported.
  • Only suspense accounts can be recoded.
  • You can't edit the original voucher.
  • Supplier invoices that are not GL-posted are not supported.
  • Only Type 4 - Simplified Voucher is supported.
  • Template-based recoding is not supported beyond the configured Standard Voucher.

Business context handling

The widget uses the InforSupplierInvoice business context to identify the supplier invoice that you want to recode. It maps these published context fields:

  • id1 identifies the supplier invoice number, SINO.
  • id2 identifies the supplier ID, SUNO.
  • id6 identifies the invoice year.
  • accountingEntity provides the company and division values parsed from COMPANY_DIVISION.
  • session.cono and session.divi provide the company and division values when accountingEntity is not available.

Recoding process

When you recode a supplier invoice, the widget follows this process:

  1. Select a supplier invoice in a list view.
  2. The invoice information is passed to the widget through the business context.
  3. The widget retrieves the invoice identifiers, company, and division.
  4. Reference data and transaction data are loaded.
  5. Select the configured Standard Voucher and start the recoding process.
  6. The widget shows the accounting lines that are eligible for recoding.
  7. Select the accounting line that you want to recode.
  8. The widget loads the Standard Voucher detail lines in an editable grid.
  9. Update the dimensions and amounts as needed.
  10. Submit the recode for validation and confirmation.

For example, if an accounting line was posted to a suspense account by mistake, you can select the line, load the configured Standard Voucher, adjust the accounting dimensions, and submit the recode. The widget then creates the recode entries while preserving the original voucher and its audit trail.