Partner Services Stock Examples

AddStockOrder Request

AddStockOrderRequest - Stock Order (match by outletID and supplierName).

This is a minimal example of a stock order submission where we are matching on outletID and supplierName to resolve the applicable outlet and supplier. The first item (PROD0001) is submitted based on supplier product code (The specified supplier must have a mapping to this supplier product code for a single PLU in the PowerEPOS system). The TaxGroupName line item field is omitted in this example which means that the default tax group for that product as configured in the PowerEPOS system will be applied to this line item.

{
    "orderID": "23A2211A-121C-4522-A212-11DAF0A33477",
    "outletID": "3f49efe7-ea42-4f21-8718-7e6ce9a33512",
    "currencyCode": "AUD",
    "supplierName": "My Supplier",
    "supplierInvoiceNumber": "INV0001",
    "supplierInvoiceDate": "2025-08-04",
    "applicationClientName": "My Stock Integration",
    "applicationClientVersion": "1.0",
    "lineItems": [
        {
            "lineItemID": "23A2211A-121C-4522-A212-947A599CD331",
            "type": 1,
            "supplierProductCode": "PROD0001",
            "description": "Supplier PLU 0001",
        }
    ]
}

AddStockOrderRequest - Stock Order (match by outletName and supplierName).

This is a minimal example of a stock order submission where we are matching on outletName and supplierName to resolve the applicable outlet and supplier. The first item (PROD0001) is submitted based on supplier product code (The specified supplier must have a mapping to this supplier product code for a single PLU in the PowerEPOS system). The TaxGroupName line item field is included in this example which means that the tax group will be matched from the PowerEPOS configuration and applied to that item instead of its default.

{
    "orderID": "23A2211A-121C-4522-A212-11DAF0A33477",
    "outletName": "My Restaurant",
    "currencyCode": "AUD",
    "supplierName": "My Supplier",
    "supplierInvoiceNumber": "INV0001",
    "supplierInvoiceDate": "2025-08-04",
    "applicationClientName": "My Stock Integration",
    "applicationClientVersion": "1.0",
    "lineItems": [
        {
            "lineItemID": "23A2211A-121C-4522-A212-947A599CD331",
            "type": 1,
            "supplierProductCode": "PROD0001",
            "description": "Supplier PLU 0001",
            "taxGroupName": "GST Free",
        }
    ]
}

Note: the AddStockOrderRequest model contains a number of Total_xx fields. These fields are optional and if provided they are only used to validate that the systems internal total calculations match the provided values. If there is a mismatch then stock order submission will fail and the appropriate error will be returned.