Maximo

Maximo

Come for answers, stay for best practices. All we're missing is you.

 View Only

  • 1.  Unable to Implement POST API for MXAPIRECEIPT in eMaximo

    Posted Thu May 22, 2025 02:04 PM

    Hi all,

    I'm struggling to implement the POST API for the MXAPIRECEIPT object structure in eMaximo to create a new receipt record. I initially tried a GET request to retrieve specific PO data, but not able to do proper call, now that I need a proper POST call to create a record. Below are the details of my setup and the issues I'm facing.

    My Current API Call

    Questions

    Is POST /maxrest/rest/os/mxapireceipt the correct endpoint for creating a new receipt in MXAPIRECEIPT?

    Any example to get EXTERNALREFID of specific PO Number?

    Any example of a working POST API call for MXAPIRECEIPT would be greatly appreciated!

    Please suggest me workaround for this.



    ------------------------------
    Rudra Uppe
    ------------------------------


  • 2.  RE: Unable to Implement POST API for MXAPIRECEIPT in eMaximo

    Posted Fri May 23, 2025 09:18 AM

    Hello,

    It doesn't look like you are sending all of the required data to make a successful POST. As an example, if you were to capture the traffic from the Maximo Mobile Inventory Receiving application when receiving an item, you would see a body like so:
    {
        "ponum": "226708",
        "orgid": "MYORG",
        "siteid": "BEDFORD",
        "positeid": "BEDFORD",
        "polinenum": 1,
        "itemnum": "123456",
        "itemsetid": "ITEMSET",
        "linetype": "ITEM",
        "receiptquantity": 2,
        "inspectionrequired": true,
        "rotating": false,
        "actualdate": "2025-05-23T08:07:00-05:00",
        "externalrefid": "98787fa002",
        "sourcesysid": "INVRECEIVE",
        "issuetype": "RECEIPT",
        "tolot": "493d7bdf"
    }

    Specifically in your error, it says that you have not provided an externalrefid. This data will be stored in the MATRECTRANS table.

    Wes Ellis



    ------------------------------
    Wesley Ellis
    ------------------------------

    Original Message


  • 3.  RE: Unable to Implement POST API for MXAPIRECEIPT in eMaximo

    Posted Sat May 24, 2025 01:28 AM

    Hello Wesley,

    Thank you for the clarification.

    If you could provide me with the Get API Request that allows me to retrieve the externalrefid for a specific PO Number, it would certainly resolve my issue.

    Thanks once again.



    ------------------------------
    Rudra Uppe
    ------------------------------

    Original Message


  • 4.  RE: Unable to Implement POST API for MXAPIRECEIPT in eMaximo

    Posted Sun May 25, 2025 03:24 PM
    Edited by Aiman Ansari Sun May 25, 2025 03:46 PM
     Hi Rudra,

    1. Yes, this is correct endpoint for creating a new receipt. The object structure - MXAPIRECEIPT uses a nonpersistent object to support both material and service receipts.
     2. Sample payload:
     {
                "issuetype": "RECEIPT",
                "ponum": "20009",
                "porevisionnum": 0,
                "polinenum": 1,
                "siteid": "BEDFORD",
                "positeid": "BEDFORD",
                "itemnum": "D600",
                "itemsetid": "SET1",
                "tostoreloc": "HARDWARE",
                "receiptquantity": 5,           
                "externalrefid":"1126r5",
                "sourcesysid":"xyz"
            }
    3. Please make sure the ponum, polinenum, and positeid fields are correctly filled in. The purchase order must be approved before receipts can be processed.
    4. The EXTERNALREFID and SOURCESYSID fields are mandatory and needs to be provided in your payload. When including externalrefid, you must also provide a sourcesysid that identifies the external system submitting the transaction.
     
    You can find an explanation for this OS with some good examples for different issue types and inspection types here- Receipt Objects - MATRECTRANS and SERVRECTRANS

    Hope this answers your query. Kindly let me know in case of any further questions.



    ------------------------------
    Aiman Ansari
    Maximo Consultant
    ZNAPZ B.V.
    Breda
    ------------------------------

    Original Message


  • 5.  RE: Unable to Implement POST API for MXAPIRECEIPT in eMaximo

    Posted Tue May 27, 2025 12:49 AM

    Hello Aiman,

    Thank you for the clarification.

    If you could provide me with the Get API Request that allows me to retrieve the externalrefid for a specific PO Number, it would certainly resolve my issue.

    Thanks once again



    ------------------------------
    Rudra Uppe
    ------------------------------

    Original Message


Related Content