Using Country- or Region-Specific SuiteApps to Retrieve Mappings

This section describes how you can use country- or region-specific SuiteApps to retrieve your mappings created in the Universal Mapping Assistant SuiteApp. You can then use your retrieved mapped data in compliance with your country's tax authority requirements.

When a mapping type instance is implemented and provided in the Universal Mapping Assistant SuiteApp, it's possible to start creating mappings. These mappings can be retrieved by calling the customscript_uma_sl_map_retriever Suitelet, as shown in the following example:

          require(["N/https"], function (NsHttps) {
   NsHttps.requestSuitelet.promise({
        scriptId: 'customscript_uma_sl_map_retriever',
        deploymentId: 'customdeploy_uma_sl_map_retriever',
        body: JSON.stringify({
         mappingTypeId: 'UMA_SAFT_2_0_ACCOUNTS',
         mappingTypeInstanceId: 'NO_SAFT_2_0_ACCOUNTS',
            parameters: {
                subsidiary: 1,
                account: 1
            }
      })
    }).then((response) => {
      const responseBody = JSON.parse(response.body);
      console.log(responseBody);
   });
});

In this example, the HTTP request body specifies the parameters that are needed to retrieve a mapping:

mappingTypeId is the identifier of the mapping type.
mappingTypeInstanceId is the identifier of the mapping type instance.
parameters provides the information necessary to retrieve a specific mapping or a set of mappings, depending on the considered mapping type. In this example, to retrieve a SAF-T Account mapping, the caller must provide a Subsidiary ID and, optionally, a GL Account ID.

For more information about the mapping-type-specific parameter shapes, see Expected Configuration and Results of Mapping Retrieval. For the Tax Codes mapping type, callers must pass concrete subsidiary ids, not the Assistant UI All Subsidiaries value.

The result is a JSON object containing the results. The body property constitutes a collection of mappings in a format determined by the considered mapping type.

          {
    "success": true,
    "body": [
        {
            "accountId": 1,
            "groupingCode": "1000",
            "groupingCategory": "balanseverdiForAnleggsmiddel"
        },
        {
            "accountId": 2,
            "groupingCode": "1020",
            "groupingCategory": "balanseverdiForAnleggsmiddel"
        }
    ]
}

For more detailed information about mapping retrievals, read the articles below:

Related Topics