Add attachment to Purchase Receipt item via PUT request

Hi @Ivan 

Please try like below sample
 

Instanceurl/entity/Default/20.200.001/PurchaseReceipt/Receipt/PR001557/files/Image.jpg

Hi @Ivan 

You are trying to attach the image to the details tab?

If yes, Rest API won't support it.  We can attach a file on the summary level. But grid level means you need to create a screen and custom endpoint.

Please refer the below ticket

Add Files to Salesorder line item using REST API | Community (acumatica.com)

@Ivan You can use the following REST endpoint to attach to the Purchase Receipt header. You can test it with Postman. If you're still having issues I can be more specific about how to do this.

If you want to attach to individual PO Lines, this isn’t available for REST API yet, but it will be in 2022 R2 based on the current API preview.

"/PurchaseReceipt/{ids}/files/{filename}": {
      "put": {
        "tags": [
          "PurchaseReceipt"
        ],
        "summary": "Attaches a file to a record.",
        "operationId": "PurchaseReceipt_PutFile",
        "consumes": [],
        "produces": [
          "application/json",
          "text/json"
        ],
        "parameters": [
          {
            "name": "ids",
            "in": "path",
            "description": "The values of the key fields of the record.",
            "required": true,
            "type": "array",
            "items": {
              "type": "string"
            },
            "collectionFormat": "pipes"
          },
          {
            "name": "filename",
            "in": "path",
            "description": "The name of the file that you are going to attach with the extension.",
            "required": true,
            "type": "string"
          }
        ],
        "responses": {
          "204": {
            "description": "The file is successfully attached.",
            "headers": {
              "Location": {
                "description": "A URL that can be used to retrieve the file from the system.",
                "type": "string",
                "format": "uri"
              }
            }
          },
          "401": {
            "description": "The user is not logged in to the system.",
            "schema": {
              "$ref": "#/definitions/HttpError"
            }
          },
          "500": {
            "description": "Internal server error.",
            "schema": {
              "$ref": "#/definitions/HttpError"
            }
          }
        }
      }

@Ivan This one was a little tricky. Acumatica has done a bad job of documenting these endpoints. I think the new file api coming out in the next release will help with some of these problems.

I tested this myself and here is what you have to do. There was a hint in this thread, but it was specific to a different type of documents (Bills), so not directly applicable to this use case.

In the GUI for POs, you can see that there are three types of POs (Normal, Blanket and Standard). So the correct url format to post looks like this, where PurchaseOrder is the top-level endpoint, Normal is the type of Purchase Order (could be blanket, for example), 000029 is the PO number, and then the other parts should be obvious.

https://hostname/instancedirectory/entity/Default/18.200.001/PurchaseOrder/Normal/000029/files/test.xlsx

You will need to PUT to that endpoint with binary encoding. I have tested it with Postman and it works.

Let me know if that fixes your problem. It looks like your doing this via curl or a programming language, which is fine, but I would highly recommend learning Postman and testing with that first. It will save you a lot of time when working with Acumatica, because it is often the case that these rest endpoints are extensions of the DACs, and so they tend to be a little weird compared to your normal REST API. It’ a lot faster to prototype in Postman vs. writing code first.

@rosenjon 

I did not understand what is the difference between example that you have provided https://myhost/subdirectory/entity/Default/18.200.001/PurchaseReceipt/Receipt/000033/files/test.xlsx and example, provided by @jinin  - Instanceurl/entity/Default/20.200.001/PurchaseReceipt/Receipt/PR001557/files/Image.jpg

I receive same error

This is my code 

string att = "C:\Test\image.jpg”;

                               if (!File.Exists(att))
                                continue;
                            FileInfo fileInfo = new FileInfo(att);
                            string tempAttMethod = "";

//here tempAttMethod  variable is equal entity/ARTSEndpoint/18.200.001/PurchaseReceipt/Receipt/PR001286/files/po1.jpg
                 tempAttMethod = string.Concat(method, "/", type, "/", refNmbr, "/files/", fileInfo.Name);

              //CreateApiCall just performs PUT request
                            using (StreamReader sr = new StreamReader(fileInfo.FullName))
                            {
                                WebClientHelper.CreateApiCall(HttpClient, WebClientHelper.HttpMethod.Put, out var respContentAttach, streamContent: new StreamContent(sr.BaseStream), method: tempAttMethod);
                            }

LIke I said, way easier to test with Postman (also because it is easier to compare calls than between everyone’s custom code). 

//here tempAttMethod  variable is equal entity/ARTSEndpoint/18.200.001/PurchaseReceipt/Receipt/PR001286/files/po1.jpg                 tempAttMethod = string.Concat(method, "/", type, "/", refNmbr, "/files/", fileInfo.Name);

If you look closely, the /PurchaseReceipt/Receipt/PR001286/files/po1.jpg is not correct.

It should be /PurchaseReceipt/Receipt/001286/files/po1.jpg

I would try that first. There may be other problems with your code...but that is the starting point. What happens when you remove the PR?

Did you make the change that I suggested? Please post the relevant code again.

Yes. Hope this is the only difference, I removed PR

same error in code and in postman

I just hide our acumatica address. If I execute this it will even not being processed

Here the url is corrected in your code.

string att = "C:\Test\image.jpg”;

                               if (!File.Exists(att))
                                continue;
                            FileInfo fileInfo = new FileInfo(att);
                            string tempAttMethod = "";

//here tempAttMethod  variable is equal ARTSEndpoint/entity/Default/18.200.001/PurchaseReceipt/Receipt/001286/files/po1.jpg
                 tempAttMethod = string.Concat(method, "/", type, "/", refNmbr, "/files/", fileInfo.Name);



              //CreateApiCall just performs PUT request
                            using (StreamReader sr = new StreamReader(fileInfo.FullName))
                            {
                                WebClientHelper.CreateApiCall(HttpClient, WebClientHelper.HttpMethod.Put, out var respContentAttach, streamContent: new StreamContent(sr.BaseStream), method: tempAttMethod);
                            }

No problem, glad you got it fixed. Please mark my answer as the solution, I don’t usually ask, but I worked for this one 🤣