Multi Subsidiary Inbound Support

You can create Multi Subsidiary transactions by setting subsidiary on inbound e-documents record.

There are two ways to set Subsidiary on inbound e-document record:

  1. Manual Selection: You can choose the desired subsidiary through the subsidiary drop down which consists of all the subsidiaries available in the account on the inbound e-document record. If you choose a subsidiary other than the available ones, you will get an alert asking to choose an appropriate subsidiary.

  2. Plugin Implementation: You can also implement the Custom Plugin as provided in the sample to automatically populate the subsidiary on creating the inbound e-document record using any of the available methods. The plugin should be provided in the e-document template record dropdown field 'Inbound Multi-Subsidiary Custom Data Source Plugin Implementation'.

After providing the subsidiary on the inbound e-document record or providing the plugin in e-document template, it will mark the inbound record as multi-subsidiary inbound record.

If the plugin execution is failed, or the plugin implementation shows an inactive subsidiary id or unavailable subsidiary id, the inbound e-document record will be created with the 'Incomplete' status.

There are two ways to update the status from 'Incomplete' to 'For Conversion':

  1. You can update the plugin implementation, edit and save the inbound record. It will auto-populate the subsidiary on the inbound record with the subsidiary id in plugin implementation at the expected path.

  2. If there are multiple inbound records with 'Incomplete' status, you can run the Map Reduce Script 'Update Inbound Subsidiary MR' by updating the plugin with an appropriate subsidiary. This MR will pick all the inbound records with status 'Incomplete', which have empty subsidiary field and plugin selected in e-document template record to populate the subsidiary Id by executing the plugin.

Important:

In case of an Inactive License account, the subsidiary provided in the inbound record will be considered to match with the free country set in the Subsidiary Preference record. If the subsidiary is not populated and status is 'For Conversion', then the entity primary subsidiary is considered for free country check.

Also, the Bulk Conversion MR picks the records based on subsidiary populated on inbound record. And you will be able to view and convert inbound record of status 'Conversion Failed' from portlet matching with the free country.

Note:
  • As the subsidiary mentioned on the Purchase Order is considered for inbound conversion to Bill transaction, in case of an inactive license account, the conversion will fail if the free country is not matched with this Purchase Order subsidiary country.

  • The bypass PO validation will be based on the preference selected on 'Bypass PO# Validation in Inbound Conversion' field in subsidiary preference record of the subsidiary selected on the inbound e-document record.

  • In consideration with the below sample plugin, the subsidiary id path will be: “customDataSources[0].data.subsdiaryId”. The path for subsidiary id should be as mentioned, as the EI script will fetch the subsidiary id.

Plugin script:

          /**
 * @NApiVersion 2.x
 * @NScriptType plugintypeimpl
 * @NModuleScope Public
 */
define(['N/render'], function (nsrender) {
   
    function inject(params) {
        // the expected structure should be defined same as below,
        // as this path is used by EI script to fetch subsidiary details
            var customObj = {
              subsidiaryId: "1" // internal id of the subsidiary
            };
        
        return {
            customDataSources: [
                {
                    format: nsrender.DataSource.OBJECT,
                    alias: "subsidiaryDetails",
                    data: customObj,
                },
            ],
        };
    }

    return {
        inject: inject,
    };
}); 

        

Errors Encountered During Multi Subsidiary Inbound E-Document Creation and Conversion

Message

Description

Solution

The inbound e-document is incomplete. Subsidiary was not selected due to the following reasons:

  1. Plugin implementation failure

  2. Fetched subsidiary is not associated with the entity or is inactive

Inbound e-document record is set with status ‘Incomplete’ as the subsidiary field is not populated.

You can check plugin implementation and also check whether subsidiary id provided is active and present on the entity record.

Purchase order subsidiary is not matching with the free country. This account does not have an active license to use the Electronic Invoicing SuiteApp in multiple countries. To convert this e-document to a transaction and to purchase a license, contact a user with the Administrator role.

In case of inactive Electronic Invoicing license, during inbound e-document conversion Purchase Order Subsidiary country is not matching with the free country.

You can purchase license to use the Electronic Invoicing SuiteApp in multiple countries.

General Notices