Acumatica REST API Endpoint Action Call fails

Question

** NOTE: Any StackOverflow question that is critical of Acumatica will get down-voted.

I am trying to get a REST Web-Service-Endpoint Action working.

Extending the Default endpoint, I added an Action CreateShipmentAction.

URL: .../17.200.001/SalesOrder/CreateShipmentAction
SEND: {'entity':{'OrderNbr':{'value':'ME050225'},'OrderType':{'value':'SO'}},'parameters':{'value':null}}
METHOD: post

and this works fine.

Following the same procedure, I added CancelPurchaseOrderAction to Purchase Order.

URL: .../17.200.001/PurchaseOrder/CancelPurchaseOrderAction
SEND: {'entity':{'OrderNbr':{'value':'ME006802'},'OrderType':{'value':'DP'}},'parameters':{'value':null}}
METHOD: post

fails with "The Cancel Order button is disabled". Manually checking the PurchaseOrder, the Cancel-Order button is active via the website.

If I change the 'entity' OrderNbr to

SEND: {'entity':{'OrderNbr':{'value':'xxxME006802'},'OrderType':{'value':'DP'}},'parameters':{'value':null}}

which shouldn't match anything, I get the same error. It's like my 'entity' for the PurchaseOrder is not formatted correctly.

I would look up the necessary formatting for the 'entity' of PurchaseOrder in the Acumatica documentation, but I can't find any documentation. The VIEW_ENDPOINT_SERVICE documents do not spell this out either, which I think they should (else why have an API if the parameters are not defined...)

Could you show us how you define both action in the endpoint by adding their definition as images? — samol518
Definition images added. Adding the Actions was done very simply. These are defined under the appropriate endpoint Action area (SalesOrder, PurchaseOrder). If I can guess the correct entity data fields, I can get other endpoint actions to work (both Default and added). Just not PurchaseOrder. Version 2018R1. — J. McNerney
The only difference I can note is that the SalesOrder already had Actions defined. I just added some. The PurchaseOrder had no Actions, so the ones I created were the 1st. — J. McNerney
> Any StackOverflow question that is critical of Acumatica will get down-voted - Your question appear complete and well put together, don't let that voting system affect your workflow if you can ignore it. — Hugues Beauséjour

samol518 samol518 · Accepted Answer · 2019-06-05T14:13:25

One thing for sure is that when dealing with Acumatica Web Service, you need to work with the screen in the browser as well.

The Web Service can only do the same thing that are possible to do on the screen.

So if you go to the Purchase Order Screen and look at the record is the Cancel Order button enabled?

I notice something when I was testing this is that for the Sales Order and the Purchase Order, the same steps will not enable both actions. At least with the default settings one is getting when using the Sales Demo Data provided with the installer.

For the Sales Order, the record only need to not be "On Hold" in order for the action Create Shipment to be enabled.

Though for the Purchase Order, you not only need to not be "On Hold", you also need to have used the Approve action before the Cancel button gets enabled.

If I were to use the Cancel Order action before these were done, I was getting the same error as you are noting in your question but once these steps were done I was able to Cancel the Order properly.

The Request that I used were to following

Sales Order

.../entity/DefaultPlus/17.200.001/SalesOrder/CreateShipmentAction
{
    "entity":
    {
        "OrderType":{"value":"SO"},
        "OrderNbr":{"value":"SO004264"}
    },
    "parameters":
    {
        "ShipmentDate":{"value":"06/05/2019"},
        "WarehouseID":{"value":"RETAIL"}
    }
}

Purchase Order

.../entity/DefaultPlus/17.200.001/PurchaseOrder/CancelPurchaseOrderAction
{
    "entity":
    {
        "Type":{"value":"Normal"},
        "OrderNbr":{"value":"PO000701"}
    }
}

Acumatica REST API Endpoint Action Call fails

2 Answers