The Wherehouse Public API is in BETA. Please contact us should you wish to build a feature rich integration dev@wherehouse.co.za.

Wherehouse API

/repricers/batch

Testing

POST

https://api.wherehouse.co.za/v1/repricers/batch/{platform}

Create or update a many repricers. The update job is limited to 10 000 repricer updates per batch. Processes asynchronously and reports feedback on /imports endpoint.

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Path Params

platform

string

required

Platform UID to create/update the reprice for

Body Params application/json

array of:

buybox_approach

string

required

cheapest | quickest

enabled

boolean

required

fixed_fulfilment_fee

integer

required

Your cost to get the item to the customer required when using cost_based approach

min_price

integer

required

preferred_price

integer

required

min_profit

integer

required

Minimum percentage of profit required when using cost_based approach

preferred_profit

integer

required

Ideal percentage of profit required when using cost_based approach

repricer_approach

string

required

fixed | cost_based

Example

[
    {
        "product_code": "APL-IPH-32",
        "buybox_approach": "cheapest",
        "enabled": true,
        "min_price": 3000,
        "preferred_price": 3500,
        "repricer_approach": "fixed"
    },
    {
        "product_code": "APL-IPH-33",
        "buybox_approach": "quickest",
        "enabled": true,
        "fixed_fulfilment_fee": 50,
        "min_profit": 10,
        "preferred_profit": 50,
        "repricer_approach": "cost_based"
    }
]

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.wherehouse.co.za/v1/repricers/batch/' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '[
    {
        "product_code": "APL-IPH-32",
        "buybox_approach": "cheapest",
        "enabled": true,
        "min_price": 3000,
        "preferred_price": 3500,
        "repricer_approach": "fixed"
    },
    {
        "product_code": "APL-IPH-33",
        "buybox_approach": "quickest",
        "enabled": true,
        "fixed_fulfilment_fee": 50,
        "min_profit": 10,
        "preferred_profit": 50,
        "repricer_approach": "cost_based"
    }
]'

Responses

🟢200Success

application/json

Body

status

string

required

queued | in_progress | completed | failed | skipped

created_at

string

required

start_time

string

required

end_time

string

required

integer

required

import_type

string

required

repricer

platform

object (Connector Type)

required

integer

required

logo

string

required

name

string

required

uid

string

required

website

null

required

created

integer

required

Number of items created

invalid

integer

required

Number of invalid items

processed

integer

required

Number of items processed

skipped

integer

required

Number of items skipped

updated

integer

required

Number of items updated

total

integer

required

Number of items submitted

trigger_type

string

required

public_api | csv | xlsx

uid

string

required

updated_at

string

required

Example

{
    "created": 0,
    "created_at": "2025-02-20T12:57:56.265Z",
    "end_time": null,
    "id": 60,
    "import_type": "repricer",
    "invalid": 0,
    "platform": {
        "created_at": "2021-08-24T12:07:27.562Z",
        "id": 1,
        "logo": "https://assets.wherehouse.co.za/connectors/logos/takealot.svg",
        "name": "Takealot",
        "uid": "takealot",
        "updated_at": "2024-11-18T09:43:37.203Z",
        "website": null
    },
    "processed": 0,
    "skipped": 0,
    "start_time": null,
    "status": "queued",
    "total": 2,
    "trigger_type": "public_api",
    "uid": "15147e5d-5ff0-4dd6-a90e-f98569cd1b90",
    "updated": 0,
    "updated_at": "2025-02-20T12:57:56.271Z"
}

/repricers

/imports