{"id":12561,"date":"2026-03-13T11:52:52","date_gmt":"2026-03-13T11:52:52","guid":{"rendered":"https:\/\/www.greytrix.com\/blogs\/salesforce\/?p=12561"},"modified":"2026-03-12T08:39:31","modified_gmt":"2026-03-12T08:39:31","slug":"how-to-exclude-default-mapped-fields-in-gumu-without-code-changes-in-sf-to-erp-tab","status":"publish","type":"post","link":"https:\/\/www.greytrix.com\/blogs\/salesforce\/2026\/03\/13\/how-to-exclude-default-mapped-fields-in-gumu-without-code-changes-in-sf-to-erp-tab\/","title":{"rendered":"How to Exclude Default Mapped Fields in GUMU Without Code Changes in SF to ERP tab"},"content":{"rendered":"\n<p>In some GUMU integration scenarios, certain fields are mapped by default within the integration code. Because these mappings are defined at the code level, users cannot remove or deactivate them directly from the Mapping UI. Even if a user attempts to delete or disable the mapping, it may still remain active because it is embedded in the promotion logic.<\/p>\n\n\n\n<p>However, there is a simple configuration-based workaround that allows users to exclude these fields during promotion without making any code changes.<\/p>\n\n\n\n<p>In this blog, we will explain how default mapped fields can be excluded from the promotion payload using the ERP Configuration object.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-red-color\">Problem<\/mark><\/strong><\/h2>\n\n\n\n<p>In some integration scenarios, users may not want certain ERP fields to be promoted even though they are included in the default mapping logic.<\/p>\n\n\n\n<p>Some common examples include:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>FOB<\/li>\n\n\n\n<li>CustomerPONo<\/li>\n\n\n\n<li>TermsCode<\/li>\n<\/ul>\n\n\n\n<p>Since these fields are generated as part of the default payload generation logic, they cannot be removed using standard mapping settings.<\/p>\n\n\n\n<p>To resolve this, users can configure exclusions using the ERP Configuration object, which dynamically removes these fields from the promotion payload.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-red-color\">Example Scenario<\/mark><\/strong><\/h2>\n\n\n\n<p><strong>Object:<\/strong> Sales Order Header<\/p>\n\n\n\n<p>Suppose you want to exclude fields like FOB or CustomerPONo from the Sales Order Header promotion payload.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-red-color\">Step-by-Step Solution<\/mark><\/strong><\/h2>\n\n\n\n<p><strong>Step 1 : <\/strong>Open Developer Console<\/p>\n\n\n\n<p><strong>Step 2 <\/strong>: Inside the Developer Console:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Click <strong>File<\/strong><\/li>\n\n\n\n<li>Select <strong>Open Resource<\/strong><\/li>\n\n\n\n<li>Search for the object: ERP_Configuration__c<\/li>\n<\/ol>\n\n\n\n<center><a href=\"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-content\/uploads\/2026\/03\/1-Remove-Mappong.png\" target=\"_blank\" rel=\"noreferrer noopener\"><img decoding=\"async\" class=\"size-full\" style=\"border: 1px solid #A9A9A9; padding: 2px; margin: 2px; align: center;\" src=\"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-content\/uploads\/2026\/03\/1-Remove-Mappong.png\" alt=\"Click on File and Select Open Resource\"><\/a><\/center><font size=\"2\"><center><i>Click on File and Select Open Resource<\/i><\/center><\/font>\n\n\n\n<center><a href=\"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-content\/uploads\/2026\/03\/2-Remove-mapping.png\" target=\"_blank\" rel=\"noreferrer noopener\"><img decoding=\"async\" class=\"size-full\" style=\"border: 1px solid #A9A9A9; padding: 2px; margin: 2px; align: center;\" src=\"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-content\/uploads\/2026\/03\/2-Remove-mapping.png\" alt=\"Select ERP_Configuration__c.obj\"><\/a><\/center><font size=\"2\"><center><i>Select ERP_Configuration__c.obj<\/i><\/center><\/font>\n\n\n\n<p><strong>Step 3 : <\/strong>Run Query<\/p>\n\n\n\n<p>Execute the following query to review the existing configuration records:<\/p>\n\n\n\n<p>SELECT Id,<br>GUMU__Integration_Key__c,<br>GUMU__Read_Header__c,<br>GUMU__Read_Payload__c,<br>Name<br>FROM GUMU__ERP_Configuration__c<\/p>\n\n\n\n<center><a href=\"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-content\/uploads\/2026\/03\/3-Remove-Mapping.png\" target=\"_blank\" rel=\"noreferrer noopener\"><img decoding=\"async\" class=\"size-full\" style=\"border: 1px solid #A9A9A9; padding: 2px; margin: 2px; align: center;\" src=\"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-content\/uploads\/2026\/03\/3-Remove-Mapping.png\" alt=\"Select Fields\"><\/a><\/center><font size=\"2\"><center><i>Select Fields<\/i><\/center><\/font>\n\n\n\n<p>This query helps review the configuration records that control payload behavior.<\/p>\n\n\n\n<p><strong>Step 4 : Create a New Record<\/strong><\/p>\n\n\n\n<p>Create a new record in <strong>GUMU__ERP_Configuration__c<\/strong> with the following details:<\/p>\n\n\n\n<p><strong>Name : <\/strong>ExcludeFieldsPromoteSalesOrderHeader100<\/p>\n\n\n\n<p><strong>Integration Key<\/strong> : Associated<\/p>\n\n\n\n<p><strong>Read_Payload__c<\/strong> : Add the ERP fields that should be excluded from promotion.<\/p>\n\n\n\n<p><strong>Example<\/strong><\/p>\n\n\n\n<p>FOB<br>CustomerPONo<\/p>\n\n\n\n<center><a href=\"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-content\/uploads\/2026\/03\/4-Remove-Mapping.png\" target=\"_blank\" rel=\"noreferrer noopener\"><img decoding=\"async\" class=\"size-full\" style=\"border: 1px solid #A9A9A9; padding: 2px; margin: 2px; align: center;\" src=\"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-content\/uploads\/2026\/03\/4-Remove-Mapping.png\" alt=\"Excluded Fields\"><\/a><\/center><font size=\"2\"><center><i>Excluded Fields<\/i><\/center><\/font>\n\n\n\n<h2 class=\"wp-block-heading\"><strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-red-color\">Naming Rule for Other Mappings<\/mark><\/strong><\/h2>\n\n\n\n<p>For other mappings, follow the naming format below:<\/p>\n\n\n\n<p><strong>ExcludeFieldsPromote(MappingName + ERP)<\/strong><\/p>\n\n\n\n<p>Example:<\/p>\n\n\n\n<p>If the mapping name is:<\/p>\n\n\n\n<p><strong>SalesOrderDetail<\/strong><\/p>\n\n\n\n<p>And the ERP is <strong>Sage 100<\/strong>, the record name should be:<\/p>\n\n\n\n<p><strong>ExcludeFieldsPromoteSalesOrderDetail100<\/strong><\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-red-color\">How It Works<\/mark><\/strong><\/h2>\n\n\n\n<p>The record created in <strong>ERP Configuration<\/strong> stores:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>ERP field names<\/li>\n\n\n\n<li>Associated Integration Key<\/li>\n<\/ul>\n\n\n\n<p>During the promotion process, the system performs the following steps:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>The promotion logic retrieves records from <strong>ERP_Configuration__c<\/strong>.<\/li>\n\n\n\n<li>It reads the fields listed in <strong>Read_Payload__c<\/strong>.<\/li>\n\n\n\n<li>The system checks the generated promotion payload.<\/li>\n\n\n\n<li>If an excluded field is found, the system removes the corresponding <strong>XML tag<\/strong> from the payload.<\/li>\n<\/ol>\n\n\n\n<p><strong>Example<\/strong><\/p>\n\n\n\n<p><strong>Before Exclusion<\/strong><\/p>\n\n\n\n<p>&lt;TermsCode&gt;NET30&lt;\/TermsCode&gt;<br>&lt;FOB&gt;Origin&lt;\/FOB&gt;<br>&lt;CustomerPONo&gt;12345&lt;\/CustomerPONo&gt;<\/p>\n\n\n\n<p><strong>After Exclusion<\/strong><\/p>\n\n\n\n<p>&lt;TermsCode&gt;NET30&lt;\/TermsCode&gt;<\/p>\n\n\n\n<p>The excluded fields are automatically removed from the payload.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-red-color\">Conclusion<\/mark><\/strong><\/h2>\n\n\n\n<p>After applying this configuration:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>The selected fields are removed from the payload.<\/li>\n\n\n\n<li>The fields will not be promoted to the ERP system.<\/li>\n\n\n\n<li>No changes are required in the existing integration code.<\/li>\n<\/ul>\n\n\n\n<p>It is important to note that this configuration works <strong>only for the Salesforce \u2192 ERP (SF \u2192 ERP) tab<\/strong>. The exclusion applies only when records are promoted from Salesforce to the ERP system.<\/p>\n\n\n\n<p>This approach allows users to exclude default mapped fields while keeping the integration logic unchanged<\/p>\n\n\n\n<p>By following the above blog instructions, you will be able to learn <strong>\u201cHow to Exclude Default Mapped Fields in GUMU Without Code Changes in SF to ERP tab\u201c<\/strong>. If you still have queries or any related problems, don\u2019t hesitate to contact us at <a href=\"mailto:salesforce@greytrix.com\" target=\"_blank\" rel=\"noreferrer noopener\">salesforce@greytrix.com<\/a>. More details about our integration product are available on <a href=\"https:\/\/www.greytrix.com\/salesforce-cloud-services\/\" target=\"_blank\" rel=\"noreferrer noopener\">our website<\/a> and <a href=\"https:\/\/appexchange.salesforce.com\/appxListingDetail?listingId=a0N30000000psM5EAI\" target=\"_blank\" rel=\"noreferrer noopener\">Salesforce AppExchange<\/a>.<\/p>\n\n\n\n<p>We hope you may find this blog resourceful and helpful. However, if you still have concerns and need more help, please contact us at <a href=\"mailto:salesforce@greytrix.com\" target=\"_blank\" rel=\"noreferrer noopener\">salesforce@greytrix.com<\/a>.<\/p>\n\n\n\n<p style=\"text-align: justify\"><b>About Us<\/b><\/br>\n<p><a href=\"https:\/\/www.greytrix.com\/\">Greytrix<\/a> \u2013 a globally recognized and one of the oldest Sage Development Partner and a Salesforce Product development partner offers a wide variety of integration products and services to the end users as well as to the Partners and Sage PSG across the globe. We offer Consultation, Configuration, Training and support services in out-of-the-box functionality as well as customizations to incorporate custom business rules and functionalities that require apex code incorporation into the Salesforce platform.<br><br> Greytrix has some unique solutions for Cloud CRM such as <a href=\"\">Salesforce Sage integration<\/a> for <a href=\"https:\/\/www.greytrix.com\/sage-x3-erp\/integration\/\">Sage X3<\/a>, <a href=\"https:\/\/www.greytrix.com\/salesforce-cloud-services\/sage-100-integration\/\">Sage 100<\/a> and <a href=\"https:\/\/www.greytrix.com\/salesforce-cloud-services\/sage-300-integration\/\">Sage 300 (Sage Accpac)<\/a>. We also offer best-in-class Cloud CRM <a href=\"https:\/\/www.greytrix.com\/salesforce-cloud-services\/crm-development\/\">Salesforce customization and development services<\/a> along with services such as Salesforce <a href=\"https:\/\/www.greytrix.com\/salesforce-cloud-services\/data-migration-support\/\">Data Migration<\/a>, <a href=\"https:\/\/www.greytrix.com\/salesforce-cloud-services\/crm-development\/\">Integrated App development<\/a>, Custom App development and Technical Support business partners and end users. Salesforce Cloud CRM integration offered by Greytrix works with Lightning web components and supports standard opportunity workflow. Greytrix GUMU&#x2122; integration for Sage ERP \u2013 Salesforce is a 5-star rated app listed on <a href=\"https:\/\/appexchange.salesforce.com\/appxListingDetail?listingId=a0N30000000psM5EAI\" target=\"_blank\" rel=\"noopener\">Salesforce AppExchange<\/a>.<br> The GUMU&#x2122; Cloud framework by Greytrix forms the backbone of cloud integrations that are managed in real-time for processing and execution of application programs at the click of a button.<br><br> For more information on our Salesforce products and services, contact us at <a href=\"mailto:salesforce@greytrix.com\">salesforce@greytrix.com<\/a>. We will be glad to assist you.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>In some GUMU integration scenarios, certain fields are mapped by default within the integration code. Because these mappings are defined at the code level, users cannot remove or deactivate them directly from the Mapping UI. Even if a user attempts to delete or disable the mapping, it may still remain active because it is embedded\u2026 <span class=\"read-more\"><a href=\"https:\/\/www.greytrix.com\/blogs\/salesforce\/2026\/03\/13\/how-to-exclude-default-mapped-fields-in-gumu-without-code-changes-in-sf-to-erp-tab\/\">Read More &raquo;<\/a><\/span><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[956,2],"tags":[2995,2991,2989,2997,2992,2987,2529,2990,2999,2996,2993,2994,2588,2988,2998],"class_list":["post-12561","post","type-post","status-publish","format-standard","hentry","category-gumu-features","category-gumu-salesforce","tag-erp-promotion-configuration-salesforce","tag-exclude-fields-from-erp-payload","tag-gumu-erp-configuration-object","tag-gumu-integration-settings","tag-gumu-mapping-configuration","tag-gumu-sage-integration","tag-gumu-salesforce-integration","tag-remove-default-mapping-gumu","tag-sage-erp-integration-best-practices","tag-salesforce-erp-mapping-management","tag-salesforce-erp-payload-customization","tag-salesforce-integration-payload-control","tag-salesforce-sage-100-integration-2","tag-salesforce-to-erp-integration","tag-salesforce-to-erp-promotion-control"],"_links":{"self":[{"href":"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-json\/wp\/v2\/posts\/12561","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-json\/wp\/v2\/comments?post=12561"}],"version-history":[{"count":14,"href":"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-json\/wp\/v2\/posts\/12561\/revisions"}],"predecessor-version":[{"id":12580,"href":"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-json\/wp\/v2\/posts\/12561\/revisions\/12580"}],"wp:attachment":[{"href":"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-json\/wp\/v2\/media?parent=12561"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-json\/wp\/v2\/categories?post=12561"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.greytrix.com\/blogs\/salesforce\/wp-json\/wp\/v2\/tags?post=12561"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}