You are using an unsupported browser. Please update your browser to the latest version on or before July 31, 2020.
close
You are viewing the article in preview mode. It is not live at the moment.
Repair Orders API
print icon
RepairOrders API

The primary tables available in MYPOS for Repairs are RepairOrders and RepairOrderItems. Obtain the Auth token in the normal way for the database and then :

If you know a specific Service Order Number you can retrieve it via

End Point: https://api.myposconnect.com/api/v2/repairorders/item?sServiceOrder={serviceordernumber}

Verb: GET

Example Call 1: https://api.myposconnect.com/api/v2/repairorders/item?sServiceOrder=8140953649

Return Codes: 200 for success, with the body containing the JSON for the sale items. For other possible (more general) return codes please see API Build Basics

Important: Replace the “{serviceordernumber}” marker in the given endpoint URL with a valid service order number

If you know a specific Serial Number you can retrieve it via

End Point: https://api.myposconnect.com/api/v2/repairorders?filt_serialnumber_str={serialnumber}

NOTICE This end point differs from the Service order number retrieval above, this is because there maybe more than one service order for a serial number.

Verb: GET

Example Call 1: https://api.myposconnect.com/api/v2/repairorders?filt_serialnumber_str=ABC-DE-FGH999J

Return Codes: 200 for success, with the body containing the JSON for the sale items. For other possible (more general) return codes please see API Build Basics

Important: Replace the “{serialnumber}” marker in the given endpoint URL with a valid serial number. A null return means no repairs for that serial number.

If you want to retrieve all Service Orders, regardless of status

End Point: https://api.myposconnect.com/api/v2/repairorders

NOTICE This end point differs from the Service order number retrieval above, this is because there maybe more than one service order for a serial number.

Verb: GET

Example Call 1: https://api.myposconnect.com/api/v2/repairorders

Return Codes: 200 for success, with the body containing the JSON for the sale items. For other possible (more general) return codes please see API Build Basics

Example JSON Object

Example Repair Order list

   [
         {
       "customSortRowNumber": 1,
       "liTotalCount": 90,
       "repairOrderId": "b6be807e-3467-4c8f-95a0-94f329d4f228",
       "bpid": "5551234567",
       "serviceOrder": "8155555555",
       "status": "Repair Complete",
       "caseId": "",
       "customerId": "66d2fd01-41fa-4d7a-8c87-53a23290b250",
       "model": "ABC-123",
       "serialNumber": "ABC-DE-FGH999X",
       "purchaseDate": "2022-11-11T12:00:00",
       "warrantyEndsDate": "2027-11-11T12:00:00",
       "warrantyId": "0000000000000000000000000000003000000017",
       "faultReported": "Device not turning ON",
       "technicianComments": "Customer washed it in the bath.",
       "safetyCheck": false,
       "lastCRMDateUTCIntoMYPOS": null,
       "lastCRMDateUTCOutFromMYPOS": "2022-11-11T01:11:00",
       "cC_001": null,
       "cC_002": null,
       "cC_003": null,
       "cC_004": null,
       "cC_005": null,
       "cC_006": null,
       "cC_007": null,
       "cC_008": null,
       "cC_009": null,
       "cC_010": null,
       "lastEditUser": "5555",
       "creationUser": "5555",
       "lastEditDevice": "9999",
       "creationDevice": "9999",
       "lastEditDate": "2022-11-11T13:11:40.86",
       "creationDate": "2022-11-11T12:23:02.157",
       "creationDateUTC": "2022-11-11T12:23:00",
       "lastEditDateUTC": "2022-11-11T01:11:00",
       "externalId": 10001419,
       "lastSendStatus": "Repair Complete",
       "productDescription": null,
       "storeName": " The Repair Shop",
       "lastEditUserName": "John Smith",
       "lastEditDeviceName": "Repair Shop Tablet1",
       "creationUserName": "John Smith",
       "creationDeviceName": "Repair Shop Tablet1"
       }
       ]

To get all of the item details, safety checks and fault codes

Once you have the repair, from either the Service Order Number or from the Serial Number you will have the repairOrderId

To retrieve all the details for a Service Order including the items and safety checks

End Point: https://api.myposconnect.com/api/v2/repairorders/{repairorderid}

Verb: GET

Example Call 1: https://api.myposconnect.com/api/v2/repairorders/xx0x3410-3171-4749-89xx-08f06x40xxxx

Return Codes: 200 for success, with the body containing the JSON for the sale items. For other possible (more general) return codes please see API Build Basics

To retrieve the sales receipt related to a Service Order

End Point: https://api.myposconnect.com/api/v2/saleitems/receipt-detailed?uiRepairOrderId={repairorderid}

Verb: GET

Example Call 1: https://api.myposconnect.com/api/v2/saleitems/receipt-detailed?uiRepairOrderId=xx0x3410-3171-4749-89xx-08f06x40xxxx

Return Codes: 200 for success, with the body containing the JSON for the sale items. For other possible (more general) return codes please see API Build Basics

A Null return will indicate no sales for that service order id.

Feedback
0 out of 0 found this helpful

scroll to top icon