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 05/22/25 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 05/23/25 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
    ------------------------------



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

    Posted 05/24/25 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 05/25/25 03:24 PM
    Edited by Aiman Ansari 05/25/25 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
    ------------------------------



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

    Posted 05/27/25 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