Inventory Advice (IA)

Our GAN and SC signals will keep you up to date on how your stock is moving in and out of our fulfilment facility. But we understand that, from time to time, you might want to get an up to date list of your inventory. We provide you with a service to do just that:

Get a list of your inventory

Get a list of your inventory

GET https://dataflo.pchintl.com/api/v1/IA

Parameters

PartNumbersList Optional. If you want to retrieve the inventory details for a specific part (or parts) only, then you can include a list of part numbers here. Separate them by commas, for example, SK5482-01, SK5482-02, SK5482-03. If you omit this field, then we will return the inventory details for ALL your parts.
WarehousesList Optional. We have a number of warehouses on multiple levels in our fulfilment facility. Most of these are used for general storage, and some have a special purpose, such as the MRB warehouse which is used for the management of defective stock. Each warehouse has a code, for example "MRB". Our fulfilment analysts will give you more details.

If you want to retrieve the inventory details for all the parts in a specific warehouse, then you can include the list of warehouses here, separated by commas, for example, "3C, 4C, 5C".
IncludeReceiptDetails Optional. This is a "true" or "false" value. If set to true, we will include the details of the receipts for the stock. Will default to false if omitted.
IncludeWarehouseDetails Optional. This is a "true" or "false" value. If set to true, we will return the details of the warehouse(s) where the stock is stored. Will default to false if omitted.

Example response body

JSON | XML
{
    "Inventory": [
        {
            "PN": "SK5482-01",
            "Desc": "Headset for a mobile phone",
            "UPC": "852067005340",
            "PrimarySupplierCode": "DXG",
            "PrimarySupplierName": "DXG",
            "PhysAvail": 200,
            "OnOrder": 0,
            "Reserved": 0,
            "TotalOnHand": 200,
            "MRB": 0,
            "Receipts": [
                {
                    "PO": "098339215",
                    "LN": "1",
                    "DateReceived": "2016-03-03T16:27:00Z",
                    "Owner": "PCH",
                    "PhysAvail": 200,
                    "OnOrder": 0,
                    "Reserved": 0,
                    "TotalOnHand": 200
                }
            ],
            "WHDetails": [
                {
                    "WH": "M3C",
                    "PhysAvail": 200,
                    "OnOrder": 0,
                    "Reserved": 0,
                    "TotalOnHand": 200
                }
            ]
        }
    ]
}

Request body

PN This is the part number.
Desc
UPC
PrimarySupplierCode
PrimarySupplierName
These 4 fields contain additional details of the part, as per the records that we have in our warehouse management system, and includes:

  • A description of the part
  • The UPC of the part
  • The code of the primary supplier of this part
  • The name of the primary supplier of this part
The next 5 fields contains the details of the inventory levels for this part.
PhysAvail This is the number of parts that are physically available for delivery orders.
OnOrder This is the number of items that have been ordered, but have not yet been delivered at the fulfilment facility.
Reserved This is the number of items that are reserved for open delivery orders.
TotalOnHand This is the total number of parts on hand.
MRB This is the number of parts in the MRB warehouse, which is a special warehouse that is used to manage defective stock. Parts in this warehouse are not available for delivery orders.

Receipts

This section will only be included if your request has a value of "true" for the parameter IncludeReceiptDetails, and contains the details of the receipts for the stock.

PO This is the number of the purchase order.
LN This is the line number on the purchase order.
DateReceived This is the date when the parts were received, in UTC format.
Owner This field indicates who the owner of the stock is.

Stock ownership in PCH is handled as follows: When the stock arrives at our fulfilment facility, it is owned by the supplier. After the stock has been in our warehouse for a certain period of time, ownership is transferred from the supplier to you. This is called ageing.

Our fulfilment team will always keep an eye on the age of your stock and will notify you when ownership is transferred.
PhysAvail
OnOrder
Reserved
TotalOnHand
Same as above.

WHDetails

This section will only be included if your request has a value of "true" for the parameter IncludeWarehouseDetails, and contains the details of the warehouse(s) where the stock is stored

WH This is the code of the warehouse where the stock is located.
PhysAvail
OnOrder
Reserved
TotalOnHand
Same as above.