Skip to content


Tech Tuesday: SOP with Header Level Taxes

This week’s Tech Tuesday will give an example of how to do a SOP Transaction with header level taxes. The most common scenario we run into is allowing the sales transaction to use the default tax engine inside of GP.  However, the second most common request is how to import a sales transaction with header level taxes.   When using header level taxes you have one tax amount that applies to the entire transaction.  This means that in the source file the tax amount will need to be the same for every line of the transaction.  The grouping that we place on the “Create Sales Transaction” mapping will cause the amount to only get entered 1 time on the header.  Here is a screenshot of what my sample file looks like, I have 1 invoice in this file with 2 line items on it.  My total tax amount will be $13.89 to a single tax detail USASTE-PS6N0

When we create the mapping, I am selecting Invoice_Number as my key field.  I will also be grouping by my Invoice_Number field so that both line items get assigned to the same transaction.  My data source will look like this when I have selected it. 

When mapping the header information, your grouping should always be on the same field as you selected for your key field, in my case I have selected Invoice_Number.  The mapping of the Create sales transaction is the same as any other standard SOP mapping, however, there are a few fields that you need to pay special attention to for header level taxes.  You need to map the Tax Schedule to the Tax Schedule mapping, the Total Tax Amount to the Tax amount mapping, and you need to set Header level taxes to a local constant of 1.  This tells the eConnect node that I am bringing in a single tax amount on my sales document.  In my example here I have allowing the document total to be calculated, and I am pulling the next default document number from Dynamics GP by using a GP Rolling Column in my mapping, here is a screenshot of all the fields I have mapped in my Create sales transaction mapping.

The next mapping will be the line item mapping.  When mapping the line item, you do not want to group this mapping because you want all the line items with the same invoice number to end up being on the same sales invoice inside of Dynamics GP.  The only tax specific field in the line item mapping is the tax schedule needs to be mapped to the Tax schedule ID mapping, here is a screenshot of what my Add line item mapping looks like.

The last mapping is the Add line tax detail.  This is the mapping that will get your taxes added to the document.  Since we are using header level taxes, we only want the total tax amount to go in one time.  This means that we need to group the Add line tax detail mapping by the same exact fields as our Create sales transaction mapping.  So is this mapping I am also grouping by the Invoice_Number just like I did in my header mapping. 

The most important field in this entire mapping is the Sequence Number field.  When you are using line item taxes, this tells the eConnect procedure which tax goes with which line item.  When you are using header level taxes, you need to set this to a local constant of 0.  This is what tells the eConnect procedure that it’s a header level tax, so it only will expect to receive one tax amount, here is what a screenshot of my Add line tax detail mapping looks like. 

Now when I run my map, I get one document with 2 line items on it.  My document total is set to automatically calculate, so it’s summing my extended prices, and adding my tax amount to it.  This is what my sales document looks like after I import it. 

If I expand my tax detail, I can see that I have 1 tax amount that applies to the entire document. 

I have also attached a copy of my CSV source file, and my SmartConnect map so that you can import it into your system and run the map yourself. 


  1. Katie on May 23, 2017 at 11:02 am

    This is a great article, thank you! We use the tax engine to calculate our taxes but we have found that GP rounds tax details intermediately. Each of our locations has a tax schedule that includes the local and state tax, while our POS system calculates a single tax percentage. This creates discrepancies between the two systems.

    Do you know of any way to prevent this from happening?

    PS. In case it helps to have numbers, below is an example where a transaction has a price of $25.46 and the location has an 8.4% sales tax (6.5% state tax and 1.9% local tax).

    Amount received in POS system:
    25.46 * 1.084 = 27.60

    In GP:
    25.46 + (25.46 * 0.065) + (25.46 * 0.019) =
    25.46 + 1.65 + 0.48 = 27.59

    GP’s rounding decreased the total by $0.01.

  2. Patrick Roth on May 23, 2017 at 10:59 pm

    With SmartConnect/eConnect, you integrate just the one tax detail and set it however you want since you are the one providing the information.

    If you are asking about how to change GP to make it calculate like you want, that really isn’t a question for eOne. However, the solution would seem to do the same as your POS is. Instead of making multiple tax details, just make the one detail for your 8.4% total sum.

  3. Brent on January 24, 2019 at 10:09 am

    Hi Patrick,

    I’m wondering what I can do if the file has a mixture of Invoices with and without Tax amounts. I tried to push in an Invoice with no Tax and thus no Tax Detail ID. The integration errors because the Invoice Tax Detail has a mapping, but there is nothing to really pass to this specific node.

    Can the Tax Detail node get skipped if the Tax amount is 0 or the Tax Detail ID is blank?
    Or, once this is mapped the data has to be provided?

    Thank you.


  4. Patrick Roth on January 25, 2019 at 8:27 am

    If a node is mapped it will execute for every row of data.
    You can make SC skip that row by using the Restriction button on that mapped node and put in whatever condition you need for that. So something like:

    if _TAXAMOUNT > 0 or _TAXDETAILID “” then
    return true
    return false
    end if

  5. Shmuel on March 24, 2020 at 3:54 pm

    HI, Great article. I want to use header level taxes but we don’t use tax schedules. Is that possible?

  6. Lisa Sorensen on November 11, 2020 at 6:14 pm

    This article is great but what if we don’t have the Tax Detail ID in the source file. We are only provided the Tax Schedule ID, not the detail. How can we use the node without having the TAX DETAIL ID?

  7. Patrick Roth on November 16, 2020 at 9:32 am


    The node/stored proc takes a tax detail id, not a tax schedule. So that is what you would need to provide.

    So to use this, you would need to either hard code the tax detail or else “look it up” by perhaps using a MSSQL Lookup in SmartConnect to find that tax detail.

Leave a Comment


Tech Tuesday: Building My First Matrix Report
Overcoming the Top Challenges of Zendesk Integration
Accessing Historical Dynamics GP Data in NetSuite: Using Popdock
Popdock's Top 10 New Features
New Webinar: Getting Started with Matrix Reporting in Popdock


2016 SmartConnect Integration Bootcamps
Tech Tues: Automatically refreshing Pivot Tables in Excel Refreshable Reports
Happy Thanksgiving from the eOne team!
2017 SmartConnect Integration Bootcamps
New Releases of Extender and SmartList Builder



Business Central CRM D365 Business Central Dynamics 365 dynamics crm Dynamics GP Dynamics NAV Econnect Employee Spotlight eone eOne News error Error Message Events Excel Excel Report Builder Extender Flexicoder GP integration Map Microsoft dynamics crm Microsoft Dynamics GP Navigation List Builder Office Relationships Partner All Hands Call Popdock promotions release SalesForce SmartConnect SmartConnect Bootcamp SmartConnect Maps SmartConnect Office Hours SmartList SmartList Builder SmartPost SmartView SQL Tech Tuesday Templates training Zendesk

Integrate & Automate without Any Code.

SmartList Data has Never Been Faster.

The Easiest Way to Report on GP Data.