OnPostReceiveOrder_OnHandleRegistrationForSalesReturnLine

Owned by Michael Voigt
Last updated: Oct 13, 2023 by Johannes Sebastian Nielsen
1 min read

Use this event to

Handle collected values from a single Registration for a Sales Return Line.

If your code is not specific to Sales Lines consider using the OnPostReceiveOrder_OnHandleRegistrationForAnyLine event.

Description

This event is used to handle collected "line" level steps and is executed once for each individual Mobile WMS Registration.

Examples of use could be:

  • Write collected values to new or existing fields in the database that subsequently can be accessed from standard posting function events.
  • Validate collected values against live data since registration at the mobile device is mostly conducted offline.
  • Not to process "header" level steps.  Steps added via OnAddStepsToAnyHeader[...] is better handled via OnPostReceiveOrder_OnBeforePost...-events.

Database transactions in this event is committed to database prior to calling standard BC posting routines. Your customized code must be structured accordingly.

Nearly always you must subscribe to standard BC posting events to do your actual processing to ensure rollback of database transactions on error.

Note: The "Sales-Post"-codeunit includes commits in standard code that is not always correctly suppressed for Sales Return Orders, even if SalesPost.SetSuppressCommit(true); is set. This needs to be taken into account and tested carefully before relying on SalesPost rollback for your custom code for Sales Return Orders.

Item Tracking

For Sales Return orders it is assumed that the item tracking details have been entered on the line when the return order was created.
So reservation entries are not created.

 

Template

    [EventSubscriber(ObjectType::Codeunit, Codeunit::"MOB WMS Receive", 'OnPostReceiveOrder_OnHandleRegistrationForSalesReturnLine', '', true, true)]
    local procedure OnPostReceiveOrder_OnHandleRegistrationForSalesReturnLine(var _Registration: Record "MOB WMS Registration"; var _SalesReturnLine: Record "Sales Line")
    begin
    end;



Examples

  • Page:
    Case: Add Line Steps to Warehouse Receipts — A customer wishes to start using Item NetWeight and -GrossWeight, but have currently no values registered at the Item Card. Create a temporary customization is to collect these weights when goods are received.
  • Page:
    How-to: Subscribing to standard events — You may subscribe to posting events in the Business Central base App to process collected values, or when events offered by Extension API do not fit your exact need.


Version History

Version

Changes

MOB5.11Introduced