📘
Page number
The replacements page could be starting in number 1.
"page" : 1

InstaLeap Picker App requires a way to query products on your catalog/inventory in order to provide substitutions when an item can't be found in the picking center. There are two cases that should be covered by this endpoint:

A picker found a similar item to the original, and they scan the barcode (or manually enter the number) to add it to the item list. In this case, the endpoint should be capable of performing a search with that SKU.
A picker wants to search for alternatives to the current product. In this case, the endpoint should have the ability to show similar items to the term searched.

Example payload that the client needs to respond

{
  "search_results": [
    {
      "id": "string",
      "name": "string",
      "photo_url": "string",
      "unit": "string",
      "sub_unit": "string",
      "quantity": 1,
      "sub_quantity": 1,
      "price": 1.5,
      "weight": 1.0,
      "volume": 1.0,
      "available_lots": [
        "string"
      ],
      "comment": "string",
      "attributes": {
        "category": "value",
        "location": "string"
      },
      "barcodes": [
        "000000000000",
        "000000000000"
      ],
      "quantity_found_limits": {
        "max": 1,
        "min": 0
      },
      "price_details": {},
      "claim_information": {
        "max_time_to_claim_in_hours": 1,
        "available_claim_actions": [
          "REFUND",
          "SUBSTITUTE",
          "COLLECT_AND_REFUND",
          "COLLECT_AND_SUBSTITUTE",
          "REJECT",
          "REJECTION_NOT_ALLOWED"
        ]
      }
    }
  ],
  "page": 1,
  "next": 1
}

Authentication:

For integration simplicity, we suggest using a bearer token to authenticate InstaLeap in your systems.