I use the Default/Shipment endpoint to save shipment information to Acumatica via REST API. If the order cannot be shipped in full (or other common errors), I get a failure to save the shipment record and the only message returned by Acumatica will say “Order SO X cannot be shipped in full. Check Trace for more details.”How can I check trace for more details? I have tried: Request Profiler I can see the returned Exception here if I turn on logging, but the exception is too late to tell me where the problem is. System Monitor Logging in as the API user and looking at the Trace page there Guzzle request to /Scripts/Trace/index.html This just returns the HTML for a deferred script unless I want to get into browser emulation just to get a usable error message Shipments can be 80+ lines, so trying to replicate the problem by hand in Acumatica is not working well.

Solved

REST API "Check Trace for more details"

1 year ago
Oct 23, 2025 4:15 PM UTC
7 replies
200 views
Translate All

PBSA
Jr Varsity III

I use the Default/Shipment endpoint to save shipment information to Acumatica via REST API. If the order cannot be shipped in full (or other common errors), I get a failure to save the shipment record and the only message returned by Acumatica will say “Order SO X cannot be shipped in full. Check Trace for more details.”

How can I check trace for more details? I have tried:

Request Profiler
- I can see the returned Exception here if I turn on logging, but the exception is too late to tell me where the problem is.
System Monitor
Logging in as the API user and looking at the Trace page there
Guzzle request to /Scripts/Trace/index.html
- This just returns the HTML for a deferred script unless I want to get into browser emulation just to get a usable error message

Shipments can be 80+ lines, so trying to replicate the problem by hand in Acumatica is not working well.

Best answer by zherring

If you have access, I would create a graph extension for shipments and hook into the RowPersisting event or possibly other events (troubleshoot what event the exception is coming from). Then you can do a try/catch and throw the actual error.

Hope this helps!

View original

Dmitrii Naumov
Community Manager
1 year ago
Oct 23, 2025 4:28 PM UTC

@PBSA could you please send an example of your payload for shipment creation?

Translate

PBSA
Author
Jr Varsity III
1 year ago
Oct 23, 2025 4:38 PM UTC

@Dmitrii Naumov Here is the a sample payload (I’ve remove the middle 74 Detail objects):

{
    "Type": {
        "value": "I"
    },
    "CustomerID": {
        "value": "CUSTOMERNAME"
    },
    "Location": {
        "value": "MAIN"
    },
    "WarehouseID": {
        "value": "WH1"
    },
    "Operation": {
        "value": "Issue"
    },
    "ShipmentDate": {
        "value": "2025-10-23"
    },
    "Details": [
        {
            "rowNumber": 1,
            "OrderType": {
                "value": "SO"
            },
            "OrderNbr": {
                "value": "188544"
            },
            "OrderLineNbr": {
                "value": "1"
            },
            "ShippedQty": {
                "value": 48
            },
            "Allocations": [
                {
                    "rowNumber": 1,
                    "InventoryID": {
                        "value": "323504"
                    },
                    "LocationID": {
                        "value": "P:25052114"
                    },
                    "LotSerialNbr": {
                        "value": "25051132"
                    },
                    "Qty": {
                        "value": 48
                    },
                    "UOM": {
                        "value": "EA"
                    }
                }
            ]
        },
        ...
        {
            "rowNumber": 76,
            "OrderType": {
                "value": "SO"
            },
            "OrderNbr": {
                "value": "188544"
            },
            "OrderLineNbr": {
                "value": "151"
            },
            "ShippedQty": {
                "value": 18
            },
            "Allocations": [
                {
                    "rowNumber": 1,
                    "InventoryID": {
                        "value": "011733"
                    },
                    "LocationID": {
                        "value": "P:25052114"
                    },
                    "LotSerialNbr": {
                        "value": ""
                    },
                    "Qty": {
                        "value": 18
                    },
                    "UOM": {
                        "value": "EA"
                    }
                }
            ]
        }
    ],
    "custom": {
        "Document": {
            "UsrEmployeeID": {
                "value": "2222"
            }
        }
    },
    "Owner": {
        "value": 525363
    }
}

This program posts dozens of shipments a day successfully. Typically when they throw errors like this, there is some soft allocation disagreement that can be easily fixed if it can be found.

Translate

Chris Hackett
Acumatica Community Manager
11 months ago
Nov 6, 2025 7:13 PM UTC

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

Translate

Chris ~ Let us know how we're doing: https://forms.office.com/r/xmJUdZ1QE5 - A member helped you, please *Like* their post. A member provided an answer to your question, please mark it as *Best Answer*.

PBSA
Author
Jr Varsity III
11 months ago
Nov 6, 2025 9:00 PM UTC

@Chris Hackett No, I haven't.

Translate

+12

jinin
Pro I
11 months ago
Nov 21, 2025 7:05 PM UTC

Hi @PBSA,

Could you please try with a simple request and check if it’s working for you?

{

"CustomerID": {

"value": "CUST001349"

"WarehouseID": {

"value": "WHOLESALE"

"ShipmentDate": {

"value": "2025-11-22"

"Type": {

"value": "Shipment"

"Details": [

{

"InventoryID": {

"value": "AACOMPUT01"

"OrderedQty": {

"value": 1

"Description": {

"value": "Computer"

"OrderType": {

"value": "SO"

"OrderNbr": {

"value": "000586"

}

]

}

Translate

Jini N

PBSA
Author
Jr Varsity III
9 months ago
Jan 8, 2026 10:05 PM UTC

@jinin I’m not sure what I am looking for with the sample request you provided. My requests in this program generally work. The problem is that sometimes a single line is not allocated correctly and I cannot tell via API which line is the problem. As I stated before, “This program posts dozens of shipments a day successfully. Typically when they throw errors like this, there is some soft allocation disagreement that can be easily fixed if it can be found.”

Translate

zherring
Varsity I
Answer
8 months ago
Jan 31, 2026 2:53 PM UTC

Hope this helps!

Translate

About Acumatica ERP system

Acumatica Cloud ERP provides the best business management solution for transforming your company to thrive in the new digital economy. Built on a future-proof platform with open architecture for rapid integrations, scalability, and ease of use, Acumatica delivers unparalleled value to small and midmarket organizations. Connected Business. Delivered.

Sign up

Social Login

Login to the community

Social Login