FAQ - Frequently asked questions

To use the easyBox, the mode must be set to BUY_BOX:

$priceSettings->setMode(RepricingItemPriceSettingsDTO::MODE_BUY_BOX);

Furthermore, the easyBox strategy must be set:

$strategyAPI = new eSagu\\Amzn\\RePricing\\V1\\Api\\RepricingItemStrategyApi();
$buyBoxAPI = new eSagu\\Amzn\\RePricing\\V1\\Api\\RepricingBuyBoxSettingsApi();

$itemId = 1337;
$buyBoxSettings = $buyBoxAPI->callList();

$itemStrategy = $strategyAPI->get($itemId);
$itemStrategy->getPriceSettings()->setMode(RepricingItemPriceSettingsDTO::MODE_BUY_BOX);
$itemStrategy->setBuyBoxSettingsId($buyBoxSettings[0]->getId());

$strategyAPI->put($itemId, $settings);

eSagu analyzes your top 10 Amazn competitors and based on that shows you the information for:

• total - number of matching items where the competitors shows on your listings.

• underbid - competitor's number of items that cost less (including shipping) than yours items.

• equal bid - competitor's number of items that match your price.

• overbid - competitors' number of items that cost more (including shipping) than your items.

Our Bulk Edit option is self expanaltory , here you can filter items by SKU, Title, Missing rules etc. and change strategies or apply new rules.
Main purpose of this option is to save your time.

The changes, that are most frequently made with "Bulk edit", are:

• Changing minimum/maximum prices
• Change price option/strategy (optimization/easyBox/customCode/fixed price)
• Changing Price Gaps
• Deactivate items
• Update items without price settings

This often occurs when prices are transmitted as a string rather than an int. A type cast as int usually solves this problem;

$priceSettings->setFixedPrice((int)$dPriceFix);
$priceSettings->setMaxPrice((int)($dPriceFix + 1));
$priceSettings->setMinPrice((int)($dPriceFix - 1));
$priceSettings->setMode(RepricingItemPriceSettingsDTO::MODE_FIXED_PRICE);

The following Python code can be used to decode an existing JWT, reset the exp claim (expiry date) and re-sign the token with the same header information (incl. kid and alg). The aim is a new, valid token with an updated expiry date:

from base64 import urlsafe_b64decode, b64encode 
from json import loads 
import datetime
from jwt import encode, decode
from typing import Dict, Any

def pad_base64url(b64string: str) -> str:
  return b64string + '=' * (-len(b64string) % 4)

def extract_header(jwt_token: str) -> Dict[str, Any]:
  header_b64 = jwt_token.split('.')[0]
  padded_header = pad_base64url(header_b64)
  header_json = urlsafe_b64decode(padded_header)

  return  loads(header_json)

def encode_secret(secret: str) -> bytes:
  return b64encode(secret.encode())

token: str = "eyJraWQiOiI1Zjc.…"
secret: bytes = encode_secret("d4cHsO5QTCt5eZg1…")

payload: Dict[str, Any] = decode(token, secret, algorithms=["HS512"], options={"verify_exp": False})

payload['exp'] = datetime.datetime.utcnow() + datetime.timedelta(hours=1)

new_token: str = encode(payload, secret, headers=extract_header(token), algorithm="HS512")

print(new_token)

This is particularly useful if you want to use short-lived tokens - for security reasons, for example, to deliberately limit the validity period of tokens and thus minimise the risk of theft or misuse.

Unfortunately, when the API client is regenerated, the swagger codegen produces different parameter orders for individual methods. This can happen when new filter options are added.

But you can work around this, as in the following example, by determining the order based on the parameter names and "calling" the method with an associative array, where the keys in the associative array correspond to the names of the individual parameters.

setApiKey('Authorization', JWT_API_TOKEN);
eSagu\\EBay\\RePricing\\V1\\Configuration::getDefaultConfiguration()->setApiKeyPrefix('Authorization', 'Bearer');

$itemApi = new eSagu\\EBay\\RePricing\\V1\\Api\\ItemApi();

$itemsPerPage = 5;
$page = 0;
try {
    do {
        $items = callWithOrderedParams($itemApi, 'callList', [
            'offset'   => $page++ * $itemsPerPage,
            'limit'    => $itemsPerPage,
            'by_title' => \"Turnschuhe\",
        ]);

        $hasMore = count($items) === $itemsPerPage;
        $ebayItemIds = implode(', ', array_map(function (RepricingItemDTO $item) { return $item->getItemId(); }, $items));

        echo \"Page: \\\"$page\\\", Item Ids: \\\"$ebayItemIds\\\"\", PHP_EOL;

    } while ($hasMore);
} catch (Exception $e) {
    echo $e->getMessage(), PHP_EOL;
}

\/**
 * @param mixed $apiInstance
 * @param string $methodName
 * @param array $paramsAssoc
 * @return mixed
 * @throws \\ReflectionException
 *\/
function callWithOrderedParams($apiInstance, $methodName, $paramsAssoc)
{
    $params = [];
    foreach ((new \\ReflectionMethod($apiInstance, $methodName))->getParameters() as $refParam) {
        $params[$refParam->name] = null;
    }

    foreach ($paramsAssoc as $key => $val) {
        if (array_key_exists($key, $params)) {
            $params[$key] = $val;
            continue;
        }

        $className = get_class($apiInstance);
        $methodParams = implode(', ', array_map(function ($p) { return \"\\$$p\"; }, array_keys($params)));

        throw new InvalidArgumentException(\"Param \\\"$key\\\" is not present in \\\"$className->$methodName($methodParams)\\\"!\");
    }

    return call_user_func_array([$apiInstance, $methodName], $params);
}

For this purpose we have an extra filter option in "Bulk edit" - "All without price rules", which will filter all of your new listed items last imported into your eSagu account.

This is no problem, you simply need to create a separate API key for each eSagu service.

If you have more than one country with us, e.g. Amzn DE and UK, you must also create a separate key for each country.

The customCode is an individual code offered by us at the customer's request.
It will be developed and programmend by our IT department in relation to your intended pricing option/strategy.

So that our system knows your item is a prime item, you need to add the shipping group under "Strategy > Global Settings > Merchant shipping groups > Prime merchant shipping groups".

Yes, just have your smartphone app ready, such as Google Authenticator, and simply go to My Account → Login data to Set Up Two-Factor Authentication to set this up.

Please remember to print out the list of one-time passwords and keep it in a safe place in case you do not have access to your smartphone.

In this short example in PHP the exp header of the token would be read and checked if its expiration date has passed.

$token = 'PLACE_YOUR_JWT_HERE';

$tokenPayload = json_decode(base64_decode(explode('.', $token)[1]), true);
if ($tokenPayload['exp'] < time()) {
 throw new RuntimeException("Token \"{$tokenPayload['sub']}\" is expired!");
}

With "Bulk Edit" you can set different filters to edit a desired quantity of articles. In the first step you can choose whether you want to filter all articles, articles without price rules or specific articles.

If you select the button "Filter", you can filter by:

• Title
• SKU
• Price range
• Shipping type
• Price option
• Price status
• Item condition
• Include quantity 0 items
• Item without pricing rules
• Item without competitor

Please have a look in our CSV manual at Common errors.

If you have multiple shipping scales, you may not have the correct optimized price because the scale is not clearly defined.

For example, the shipping costs are free up to a price of £ 10,00 and for prices above £ 10,00 a shipping fee of £ 3,00 is charged.

The price gap is set up £ 0.05 against the cheapest competitor, and there is a competitor whose price is £ 11.00.

That means we need to send a price of £ 10.95 (full price including the shipping costs).

According to the shipping cost scale, If we calculate £ 10.95 (full price) then we need to add £ 3.00 shipping and the price will be £ 13.95, which is not correct.

On the other hand since £ 10.95 is above the scale shipping, if we subtract £ 3.00 shipping, we come to £ 7.95, and any price below £10.00 is free of shipping.

In order to change it, please check your shipping costs scale in eSagu, or even better change your shipping costs to free shipping on Amazon.

This occurs when CDiscount didn't grant the authorization (API access) to eSagu.

Make sure to follow these steps to be able to use eSagu Re-pricing for CDiscount : Create a Cdiscount API account

In My Account you will find a tab with Invoices. There you can request each of your invoices to be sent on your e-mail.

The "Bulk Edit" option allows you to filter and edit multiple items at the same time.

In My Account you will find a tab User. There you can add a add new user. Here you can also limit the access rights of the new user. The new user gets a link via Email where he can set his password.

In My Account you will find a tab Email. There you can change your "invoice e-mail".

When setting up OAuth for the Selling Partner API (SP-API), you might be redirected to the German Amazon Seller Central. This occurs because Amazon operates a unified account system, allowing you to use the same login credentials across different regional marketplaces. This redirection is a standard part of the process and does not impact your ability to use the SP-API. Your account access and functionality remain the same, regardless of the Amazon marketplace region.

If a price outside the min-max range was uploaded to Amazon, it is likely not due to eSagu Repricing for Amazon. Possible reasons include:

• Your Enterprise Resource Planning (ERP) system, might have uploaded the price.
• A promotional price set on Amazon could be affecting the item. When a promotional price is set, the normal price is ignored and displayed as striked through.
• A price range change in our system that Amazon is slow to process. When the price range is updated, Amazon may take longer to reflect these changes, causing temporary discrepancies.

Ensure all systems are synchronized and check for active promotions on Amazon. If the problem persists, contact your support team for further assistance.

In My Account there is a blue button on the upper right side Add another account. Please click and follow the steps.

There are three ways to do this:

• You change your minimum/maximum prices for each item separately by changing numbers below the strategy and saving changes by clicking on the floppy disc icon - save button, on the right-handed side, or in the top right corner.
• You change your minimum/maximum prices with easyEdit.
• You change your minimum/maximum prices by CSV import.

It often takes some time until the newly listed item appears everywhere on Amazon and our software can find it in the Amazon reports.

First we recommend to wait one to two hours, that's how long it can take at Amazon.

If the item still does not appear on eSagu, we recommend to download one of the requested reports named "Active Listings Report" at Inventory -> Inventory Reports in sellercentral. If you find the ASIN\/SKU here in the report, please contact our Support and if the item is not in here, you have to contact the Amazon Support or list the item (under a different SKU) again.

The "easyBox" is a Buy Box optimization strategy.
This strategy is increasing your price while you own the Buy Box. There are two sub-strategies: "easyBox Hold", which increases your price every few hours, depending on how you set it up, and "easyBox Margin", that increases your price every two minutes until certain point, and after that waits for few hours to increase your price again, depedning on the settings.

This is mostly caused by eBay API token issues, please navigate to My Account ⇢ OAuth Token and click on Renew token to renew your token once. Please be patient and wait a couple of hours ☕, updating the ebay stock is a time-consuming task even with a working API token.

Navigate to Forgot password and follow the steps below.

Main Account:

• Wait for one hour, as the update might take some time.
• Log out and log back in to refresh the display.

Subaccount:

• Follow the same steps as the main account: wait for one hour and/or log out, and log back in.
• Have the main account check if the permissions are correctly set.

Ensure all permissions are properly configured, and repeat the steps if necessary.

Competitors can be excluded in the „Exclusion“ tab by entering them in the blacklist. "Exclusion" tab is under "Price optimization" tab on Strategy page.

If you set the filter by-quantity-greater-zero to false quantity 0 items will not be hidden.

We have created a step by step manual for you here: How to: Delete Amazon minimum and maximum prices

You develop an idea. You discuss this with your account manager. He will forward it as a software story to our IT department. Our IT department will then evaluate your idea in terms of feasibility, effort and costs and you will receive a cost estimate from your account manager with details of the cost and time required to create your custom code.

Yes, upon receipt of payment, the IT department will start programming and finalize your customCode.

Items without stock (quantity zero) are hidden by default, but you can show these items by using the filter "Do not hide quantity 0 items".

If your price upload was processed by Amazon but the price update is slow to appear online, it might be due to delays for Low Engagement ASINs. Amazon prioritizes listings based on ASIN engagement levels. Products with lower engagement, such as a used book, may experience longer delays, sometimes around 96 minutes. Please contact Amazon Support to find out if your item is affected. Currently, Amazon does not provide an API in order to automate this process at eSagu.

With "Optimization", your prices are compared with the cheapest competitor within your minimum\/maximum prices.

This strategy doesn't increase your price when you get the BuyBox.

No, we use the FBA quantities for informational purposes only, so we display the quantity in the frontend or offer filtering and sorting functions based on the quantity.

• customCode - By sales figures Your prices are optimized according to the sales figures of your items in last 7 days.
• customCode - exclusion below minimum price Your prices will only be optimised against offers above the minimum price.
• customCode - Prime first Your items are comparing the price against cheapest Prime offer first. If there are no Prime competitors, items follow normal rules from "Optimization"

This happens when the service (e.g. HelpDesk or our RePricing) has been set up from another browser / computer.

As the browser session data is updated every hour, you can now simply wait or if you do not want to wait, simply log out once and log in again.

On your dashboard you can see:

• Your turnover in € or the respective national currency
• Your top competitors
• Your best selling products
• When price changes were made
• On which days and at what time items were sold within the last 30 days

If you have multiple services such as Amazon UK and DE, they can be added and customized individually.