Skip to main content
Question

BigCommerce Entity mapping for Sales Order line-level custom field Import vs Export

  • July 16, 2025
  • 5 replies
  • 70 views

plambert
Semi-Pro I
Forum|alt.badge.img+2

I have a question for any Entity mapping expert out there:

 

I’m running into an unusual asymmetry between how the import and export entity mappings are for Sales Orders. We have an Acumatica line-level custom field - AltQuantity for short - which we want to link to the BigCommerce Quantity value of each respective item on a sales order. The Import mapping works as expected, even though the custom field isn’t available from the drop down in the ERP Field column.

Import mapping

I expected the Export mapping to be able to be set up as the mirror of the Import mapping.

expected Export mapping

 

Now, I know I’m getting off the expected path here because I had to type in the Objects and Fields manually without spaces instead of being able to select from a drop down. Surprisingly, it works - well - half works. The system recognizes OrderData.OrderProducts.Quantity just fine and I can map to it normally (ex ‘Sales Order -> Details -> Open Qty’). However, my issue/lack of knowledge is around the “-> Advanced” part and Transactions view of the Sales Order.

I can access the custom field if I use ‘Sales Order -> Advanced Transactions.Usr...’ but mapping it without Details makes it so the first item’s value is populated to every item on the order. However, with ‘Sales Order -> Details -> Advanced Transactions.Usr...’ for the custom field I get the error on sync: “The system failed to convert value PX.Commerce.Core.API.SalesOrderDetail to type Int32 during the mapping processing. Please make sure that custom field mappings are correct.” but I can use a non-custom field like ‘Sales Order -> Details -> Advanced Transactions.OpenQty’, but then, even though it should be at the detail level, it maps the first OpenQty to every item on the order.

 

Can anyone explain what’s going on and how I can export the line-level custom field? The whole process of creating these mappings is rather opaque and undocumented, so if anyone knows of a good resource for learning about this screen’s inner workings then I’d appreciate that, too!

5 replies

kkeating24
Varsity III
Forum|alt.badge.img+1
  • Varsity III
  • July 16, 2025

Probably not super helpful, but I actually opened a case with ACU about this.  my client has a custom field and it’s not being picked up in the export.   It was pushed back to us because it was custom, with ACU saying they could not review it because it was custom.   

I’ll update if we figure out why.  

 


plambert
Semi-Pro I
Forum|alt.badge.img+2
  • Author
  • Semi-Pro I
  • July 16, 2025

Thank you, ​@kkeating24 
After toying with this for a while longer, I suppose my question boils down to: why is there no Sales Order -> Details -> Advanced for Exports like there is for Imports? My custom data is visible but it seems like the functionality is not there at the detail level. Is there something that can be typed in to access that, like with the other hidden objects?


plambert
Semi-Pro I
Forum|alt.badge.img+2
  • Author
  • Semi-Pro I
  • July 17, 2025

I answered my own question after more investigation, though still without solving my problem. Advanced is just an alias for Custom, so entering ‘SalesOrder -> Details -> Custom’ accesses the Advanced Details ERP object. Entering that even populates the value drop-down with values for Transactions:

There it is!

Sadly, even though it appears in the drop-down, on sync it throws an error: “The Transactions.UsrAAQtyAltUOM field is not found. Please check the entity mapping.” So close. I can confirm that the Transactions view exists in the Details context, because Transactions.OrderQty syncs successfully (not on the drop down list).
So these custom fields are available for SalesOrder → Custom.Transactions.Usr… but I don’t think there is a means of accessing them in the Details context so that each line will export its value.


kkeating24
Varsity III
Forum|alt.badge.img+1
  • Varsity III
  • July 17, 2025

RIght, that is the error we received.   you should even be able to see the field in the formula editor, the USR fields, this is for stock items, but should be similar for each entity: 

 

we have our internal development team reviewing why these are not available for use in the export.


Chris Hackett
Community Manager
Forum|alt.badge.img
  • Acumatica Community Manager
  • September 24, 2025

Hi ​@plambert were you able to find a solution? Thank you!