Product Attributes

When integrating with the Logistics Plus Warehouse API, product attributes can be utilized to provide additional properties that describe a product, such as batch, serial numbers, and expiry dates. Your representative will provide any configured product attributes in your integration packet. If you need to create additional attributes for your products, please reach out to your Logistics Plus representative who can assist you in setting up the necessary attributes.

Using Product Attributes in Receives

Product attributes are useful in receives for telling us key information about your product prior to it arriving in the warehouse. This product attribute will carry fully through inventory once the receive is finalized, so that you are able to more easily tell which specific products are being impacted at each moment. An example of this would be an order placed to your supplier. The supplier tells you that the product will be shipping with the batch number 1234 and serial number ABC1234. Sending these allows the warehouse to confirm prior to finalization that the correct batch and serial number were received.

Product attributes are set using the part attributes field on receive lines.

Example Request

{
    "warehouseCode": "CLW",
    "primaryReference": "SHP-000001",
    "shipFromAddress": {
        "address": {
            "organization": "John Smith",
            "addressLine1": "1234 Main Street",
            "country": "USA",
            "state": "CA",
            "city": "Los Angeles",
            "postalCode": "90012"
        }
    },
    "receiveLines": [
        {
            "externalLineReference": "1000",
            "productCode": "901-00004",
            "quantity": 1,
            "quantityUnit": "UNT",
            "partAttributes": [
                {
                    "key": "SERIAL NUMBER",
                    "value": "S0000000001"
                }
            ],
            "palletId": "P0000000001"
        },
        {
            "externalLineReference": "1000",
            "productCode": "901-00004",
            "quantity": 1,
            "quantityUnit": "UNT",
            "partAttributes": [
                {
                    "key": "SERIAL NUMBER",
                    "value": "S0000000002"
                }
            ],
            "palletId": "P0000000001"
        }
    ]
}

Using Product Attributes in Orders

After a receive is finalized and the inventory becomes available for the product, an order can be placed against it. There are two options for product attributes when sending orders.

1. Sending the order without the product attribute value(s). This will allow the LP operations team to pick the product and capture the product attributes so that you know what was shipped. This is useful when there is no specific batch/serial number that needs to be sent on an order but you need to know which one was shipped.
2. Sending in the order with the product attribute value(s). This guarantees that the product with the specific attribute value(s) is picked by the warehousing team. This is useful for shipping exact pallets or serialized items when required.

Product attributes are set using the part attributes field on order lines.

Example Request

{
  "warehouseCode": "CLW",
  "primaryReference": "12345678910",
  "shipToAddress": {
    "address": {
      "organization": "John Smith",
      "addressLine1": "1234 Main Street",
      "country": "USA",
      "state": "CA",
      "city": "Los Angeles",
      "postalCode": "90012"
    }
  },
  "orderLines": [
    {
            "externalLineReference": "1000",
            "productCode": "901-00004",
            "quantity": 1,
            "quantityUnit": "UNT",
            "partAttributes": [
                {
                    "key": "SERIAL NUMBER",
                    "value": "S0000000002"
                }
            ]
    }
  ],
  "additionalReferences": null,
  "note": "BEST RATE - FEDEX OR UPS - 2DAY"
}