Print SO Invoice via REST API call

​@AllenVaughn , The first thing I would do is change your PUT to a POST. Actions need to be a POST. 

Hi ​@AllenVaughn 

You are attempting to call the PrintInvoice action on an AR Invoice (SO Invoice) through a custom REST endpoint. The error Invalid URI structure is usually caused not by the JSON, but by an incorrect URL or incorrect action setup in the endpoint.

It’s also important to understand that the standard PrintInvoice action does not accept a printer parameter — it either returns a PDF or prints using the user’s default settings / DeviceHub. If you need to choose a printer, you must implement a custom action.

1️⃣ Correct URI Structure for Actions

The standard REST URL format for calling an action is:

PUT /entity/{EndpointName}/{Version}/{Entity}/{Key}/action/{ActionName}

Example for AR Invoice:

PUT /entity/Default/22.200.001/ARInvoice/Invoice/AR006006/action/PrintInvoice

If you call the action without passing the key in the URL, then you must supply the entity object in the JSON body, and the URL becomes:

PUT /entity/Default/22.200.001/ARInvoice/PrintInvoice

Your JSON is valid:

{
  "entity": {
    "DocType": { "value": "Invoice" },
    "ReferenceNbr": { "value": "AR006006" }
  }
}

So the Invalid URI structure error indicates that your endpoint URL or entity/action mapping is incorrect, not the payload.

2️⃣ Why You Cannot Specify a Printer in Standard PrintInvoice

To print to a specific printer, you must:

1.  Create a custom action on ARInvoiceEntry (ex: PrintToDevice)
2.  Add a parameter like PrinterName
3.  Use ReportPrinterJobManager.PrintReport() or PXReportPrinter.Print()
4.  Publish the action in your custom endpoint
5.  Call it via REST API

3️⃣ Example Custom Action That Accepts a Printer Name

public class ARInvoiceEntry_Extension : PXGraphExtension<ARInvoiceEntry>
{
    public PXAction<ARInvoice> PrintToPrinter;
    [PXButton, PXUIField(DisplayName = "Print to Printer")]
    public IEnumerable printToPrinter(PXAdapter adapter, string printerName)
    {
        var invoice = Base.Document.Current;
        var parameters = new Dictionary<string, string>
        {
            ["ARInvoice.DocType"] = invoice.DocType,
            ["ARInvoice.RefNbr"] = invoice.RefNbr
        };

        ReportPrinterJobManager.PrintReport(
            reportID: "AR641000",
            parameters: parameters,
            printerName: printerName
        );

        return adapter.Get();
    }
}

After exposing this in your custom endpoint, the JSON request becomes:

{
  "entity": {
    "DocType": { "value": "Invoice" },
    "ReferenceNbr": { "value": "AR006006" }
  },
  "parameters": {
    "PrinterName": { "value": "HP_LaserJet_01" }
  }
}

4️⃣ Alternative: Download PDF Instead of Printing

If your goal is to print outside Acumatica, it is easier to call the report directly:

POST /entity/Default/22.200.001/report/AR641000

{
  "parameters": [
    { "name": "DocType", "value": "Invoice" },
    { "name": "RefNbr", "value": "AR006006" }
  ]
}

This returns a PDF file, which you can print however you like.

Summary

I hope this will be of assistance. 

​@AllenVaughn 

In my previous post, the type and URL of the action call were incorrectly specified.
This is how it should look correctly:
 

POST http://<Base endpoint URL>/SOInvoice/PrintInvoice 

​@aleksejslusar19  Looks exactly like the solution I need.  I’ll give it a go and see how it works.

Thank you for all your help.

Allen Vaughn

I’m trying to call the report directly as shown in the last example in your Summary, but I don’t have an entity in an endpoint labeled ‘report’.  Am I reading that incorrectly?  What am I missing?

Never mind.  I created a new Report entity in my custom endpoint and when I do a post to that endpoint with the supplied entity it returns the location to download the PDF in the Location header of the response.  I can now retrieve a PDF of the invoice.

Thank you for pointing me in the right direction.

Another question:  This report process takes a while to generate a new report on the invoice.  Since this invoice is an already existing invoice, is there not some way to go directly to a URL of the PDF copy of an existing invoice or does it regenerate the entire invoice on every request?

If I’m simply wanting to reprint an existing invoice, surely the invoice isn’t generated entirely again just to simply print another copy.

I've checked, and it looks like the PDF is only available for a single download