Skip to main content
Question

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

  • June 9, 2026
  • 2 replies
  • 17 views
J
Freshman I

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

    2 replies

    hdussa
    Jr Varsity I
    Forum|alt.badge.img+2
    • hdussa
    • Jr Varsity I
    • June 10, 2026

    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 }
        }
      ]
    }

     

    ~ Harish Dussa
      R
      Jr Varsity II
      Forum|alt.badge.img+4
      • Rakshanda
      • Jr Varsity II
      • June 10, 2026

      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.

       

      Rakshanda D || Acumatica MVP 2026 || www.linkedin.com/in/rakshanda-deore-643ba188
        Terms & ConditionsAccessibility statement
        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.
        © 2008 — 2024  Acumatica, Inc. All rights reserved