Skip to main content
Solved

CreatePrepaymentInvoiceOK via Contract-Based REST API — "Create button is disabled" (PXActionDisabledException)

  • Jun 9, 2026 3:33 PM UTC
  • 2 replies
  • 70 views
  • Translate All

Hi all,

I'm trying to create a prepayment invoice via the Acumatica Contract-Based REST API. I'm POSTing to:

/entity/BDP/24.200.001/SalesOrder/CreatePrepaymentInvoiceOK

With payload:

{
  "entity": {
    "OrderType": {"value": "SA"},
    "OrderNbr": {"value": "0001170"}
  },
  "parameters": {
    "PrepaymentPct": {"value": 100.00},
    "CuryID": {"value": "GBP"}
  }
}

I'm getting a 500 error: "The Create button is disabled" (PXActionDisabledException). The SO status is fine — I can create the prepayment invoice manually without issue in SO301000 and SO501000.

My understanding is that the Acumatica commerce connector creates prepayment invoices via the API successfully — so there must be a way to do this. Has anyone solved this, or can point me to how the commerce connector achieves it?

Thanks, 

James

Best answer by Rakshanda

Hi ​@jbarnett14 ,

can you please check whether the action is exposed correctly in the custom endpoint,

If CreatePrepaymentInvoiceOK was added to the endpoint from the Sales Order screen, inspect the endpoint definition and compare it with the generated Swagger.

 

View original

2 replies

hdussa
Jr Varsity I
Forum|alt.badge.img+2
  • Jr Varsity I
  • Jun 10, 2026 12:27 AM UTC

Hello ​@jbarnett14 ,

I wasn't able to locate the CreatePrepaymentInvoiceOK action under the Sales Order endpoint tree. Have you tried looking under the Payment endpoint using the OrdersToApply request details instead?


URL:  {{Acumatica_URL}}/entity/Default/{{Version}}/Payment

{
"Type": { "value": "Prepayment" },
"CustomerID": { "value": "CustomerID" },
"PaymentMethod": { "value": "CHECK" },
"CashAccount": { "value": "10200" },
"PaymentAmount": { "value": 999.00 },
"OrdersToApply": [
{
"OrderType": { "value": "SO" },
"OrderNbr": { "value": "SO001234" },
"AppliedToOrder": { "value": 999.00 }
}
]
}

 

Translate

Forum|alt.badge.img+8
  • Jr Varsity II
  • Answer
  • Jun 10, 2026 2:00 PM UTC

Hi ​@jbarnett14 ,

can you please check whether the action is exposed correctly in the custom endpoint,

If CreatePrepaymentInvoiceOK was added to the endpoint from the Sales Order screen, inspect the endpoint definition and compare it with the generated Swagger.

 

Translate