FAQ - Frequently asked questions

How can I activate the easyBox for my items via the API?

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);

What does the ''Amzn - Top competitors'' widget on the dashboard shows?

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.

What can I do with "Bulk Edit"?

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

Server replies with 400 - I am using PHP and get a 400 error when adjusting price changes

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);

PHP API Client - The parameter order of individual methods has changed after an update

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);
}

What is a customCode?

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.

eSagu does not recognize my prime items

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".

Can I protect my account with two-factor authentication?

Yes, just have your smartphone app ready, such as Google Authenticator, and simply go to My AccountLogin 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.

How can I check on the client side if my Token is expired?

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!");
}

What can I filter with Bulk Edit

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

What could be the impact of having different shipping costs scale on my optimized price?

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.

Where can I find my invoices?

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.

What is "Bulk Edit"?

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

How do I add a new user?

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.

Why am I redirected to the German Amazon Seller Central for SP-API OAuth?

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.

How do I change the minimum/maximum prices for my items?

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.

I have new items listed on Amazon but can't find them on eSagu.

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.

What does the price option/strategy "easyBox" do?

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.

How does the process of customCode programming work?

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.

I cannot find my "quantity zero" items

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".

What are the 3 most common customCodes?

  • 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"

What can I do if I cannot see a new service in the menu?

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.

What can I see on the dashboard?

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.