Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
StatuscolourGreen

Status
colourGreen
title5.4.0

A pass-through API to Claims (when configured) which allows the Claims' "Part Update PartsUpdate Order" API to be called.     


Panel
borderColorgrey
bgColorwhitesmoke
borderStylesolid

On this page:

Table of Contents
maxLevel2

Related pages:


Resource URL Summary

Panel
borderColorgrey
bgColorwhitesmoke
borderStylesolid

Pass Through Call to Claims "Parts UpdateOrderPartsUpdateOrder" API

POST /up/v5/parts/updateOrder

Include Page
_Default HTTP Headers
_Default HTTP Headers


Enablements

To enable this feature, the tenant's sysconfig needs to be updated:

Code Block
languagejs
{
    "Providers": {
        "Claims": {
            "Features": {
                "queryEntitlement": {
                    "Endpoint": "services/product/v1/checkentitlement"
                },
                "queryCustomerApptInfo": {
                    "Endpoint": "services/customer/v2/newcallnumber"
                },
                "updatePartsOrder": {
                    "Endpoint": "services/part/v1/updateorder"
                }
            },

            "UserId": "CASEYSHSAP",
            "Password": "--Redacted--",
            "ManufacturerNumber": "S900"
        },
    }
}

API Specifics


Panel
borderColor#D3D3D3

Pass Through Call to Claims "Parts UpdateOrder" API

This RESTified API will perform a pass-through call to the Claims sub-system's "Part Update Order" API (when configured).

URL

Panel
borderColorgrey
bgColorwhitesmoke
borderStylesolid

POST /up/v5/claims

HTTP Request Body

This request requires a JSON object supplied in the HTTP request body, which defines the parameters that will be passed through to the ServiceDispatch "Update Order" APi.

UpdateOrder Object Format

Code Block
languagejs
{
    "callNumber": "0007084-97757435",
    "orderSequence": 0,
    "parts": [
        {
            "PartNumber": "285442",
            "PartSequence": 0,
            "OrderDate": "20231114",
            "Status": "Shipping",
            "BackorderQuantity": 1,
            "BackorderDate": "20231117",
            "ShipQuantity": 1,
            "ShipDate": "20231119",
            "ShipMethod": "Ground",
            "ShipCarrier": "UPS",
            "TrackingNumber": "1ZTESTING12345"
        },
        {
            "PartNumber": "285999",
            "PartSequence": 0,
            "OrderDate": "",
            "Status": "Shipped",
            "BackorderQuantity": 0,
            "BackorderDate": "",
            "ShipQuantity": 1,
            "ShipDate": "20231125",
            "ShipMethod": "Express",
            "ShipCarrier": "FEDEX",
            "TrackingNumber": "1ZTESTING12346"
        }
    ]
}

UpdateOrder Object Properties

PartSequence
PropertyTypeRequired?DescriptionServiceClaims Field Mapping
callNumberstringYes

Pass through parameter to the ServiceClaims "UpdateOrder " API.

callNumber
orderSequencestringYesPass through parameter to the ServiceClaims "UpdateOrder " API.orderSequence
partsarraystringYesPass through parameter to the ServiceClaims "UpdateOrder " API.parts

PartNumberarraystringYesPass through parameter to the ServiceDispatch "Submit Claim" API.RequiredPartsThe part number ordered.PartNumber

PartSequencestringYesThe sequence of the parts ordered.PartSequence

OrderDatestringYesThe date the part was ordered.OrderDate

Statusstring

PartNumber

BackorderQuantitystring

PartNumber

BackorderDatestring

PartNumber

StatusShipQuantitystring

PartNumber

ShipDatestring

PartNumber

ShipMethodstring



ShipCarrierstring



TrackingNumberstring


HTTP Response

Success

On success, a JSON-formatted version of the ServiceDispatch "Submit Claim" API response will be returned.

SubmitClaim Response Object Format

Code Block
languagejs
{
    "Success": true,
    "Code": 0,
    "Message": "OK",
    "Payload": {
        "ResponseCode": "OK"
    }
}

SubmitClaim Response Object Properties

PropertyTypeDescriptionServiceDispatch Field Mapping
SuccessbooleanPass through parameter from the ServiceDispatch "Submit Claim" API.Success  
CodeintegerPass through parameter from the ServiceDispatch "Submit Claim" API.Code
MessagestringPass through parameter from the ServiceDispatch "Submit Claim" API.Message
PayloadobjectPass through parameter from the ServiceDispatch "Submit Claim" API.Payload

TotalClaimsReceivedintegerPass through parameter from the ServiceDispatch "Submit Claim" API.TotalClaimsReceived

TransactionIdstringPass through parameter from the ServiceDispatch "Submit Claim" API.TransactionId

ResponseCodestringPass through parameter from the ServiceDispatch "Submit Claim" API.ResponseCode

TotalClaimsProcessedSuccessfullyintegerPass through parameter from the ServiceDispatch "Submit Claim" API.TotalClaimsProcessedSuccessfully

ClaimsarrayPass through parameter from the ServiceDispatch "Submit Claim" API.Claims


ClaimTransactionIdstringPass through parameter from the ServiceDispatch "Submit Claim" API.ClaimTransactionId


ClaimResponseCodestringPass through parameter from the ServiceDispatch "Submit Claim" API.ClaimResponseCode


ServiceCenterNumberstringPass through parameter from the ServiceDispatch "Submit Claim" API.ServiceCenterNumber


ClaimStatusDescriptionstringPass through parameter from the ServiceDispatch "Submit Claim" API.ClaimStatusDescription


ManufacturerNamestringPass through parameter from the ServiceDispatch "Submit Claim" API.ManufacturerName


ServiceCenterLocationCodestringPass through parameter from the ServiceDispatch "Submit Claim" API.ServiceCenterLocationCode


TypestringPass through parameter from the ServiceDispatch "Submit Claim" API.Type


ClaimBatchNumberintegerPass through parameter from the ServiceDispatch "Submit Claim" API.ClaimBatchNumber


ClaimSequenceNumberintegerPass through parameter from the ServiceDispatch "Submit Claim" API.ClaimSequenceNumber


ClaimStatusCodestringPass through parameter from the ServiceDispatch "Submit Claim" API.ClaimStatusCode


ClaimNumberstringPass through parameter from the ServiceDispatch "Submit Claim" API.ClaimNumber


ErrorsarrayPass through parameter from the ServiceDispatch "Submit Claim" API.Errors



ErrorDescriptionstringPass through parameter from the ServiceDispatch "Submit Claim" API.ErrorDescription



PartNumberstringPass through parameter from the ServiceDispatch "Submit Claim" API.PartNumber

TotalClaimsNotProcessedSuccessfullyintegerPass through parameter from the ServiceDispatch "Submit Claim" API.TotalClaimsNotProcessedSuccessfully

Error

On error, a JSON-formatted version of the ServiceDispatch "Submit Claim" API response will be returned.

Code Block
languagejs
{
    "name": "GeneralError",
    "message": "Error",
    "code": 400,
    "className": "general-error",
    "data": {
        "Success": false,
        "Code": 8,
        "Message": "BadRequest: Error ocurred while querying the Claim!"
    }
}


Return Codes

In addition to the Standard Return Codes, and the ServiceDispatch Error codes, individual API calls made have unique codes found on their individual pages.