Autofixa Stock & Price direct updates

The purpose of this doc is to outline the needs calls for stock and price updates for the Autofixa project

As part of the Storesome project we want to literally copy the Stock and Price calls that are currently working for Storesome and make sure they work for Autofixa market marketplaces as well. The calls in general are very simple (SKU and Qty or SKU and Price) so please refer to the general doc for Storesome Stock and Price management and see only the differences and API calls below

For both flows there are two differences:

1. SKU - for Autofixa we should use Item > MPN instead of Item > SKU
2. We should prepare different models for limits - for Autofixa for the moment we should be sending only 10 at a time in a single call

New: Additional differences found:

• Call URL is different
• Success response returns “true”

Stock

API Docs: https://autofixa-test-seller-api.azurewebsites.net/index.html

API Call: PUT /api/offer/bulk-quantity

Example:

[
  {
    "sku": "string",
    "quantity": 0
  }
]

Mapping:

Response examples:

Success

true

Note: expectation is if all passed SKUs in the call are successfully updated we will receive in the body of the call the above example

Error

"[{\"Key\":\"44300000000\",\"Value\":\"Product with SKU 44300000000 doesn't exist.\"}]""

Note: expectation is if an item from the call is not successfully updating on Autofixa we will receive an error with a Key pointing to the SKU we are passing and Value as the issue it has that we need to store against this item

Additional Info:

• Everything from the general stock abstraction should work: Stock Update general requirements
• Limit: up to 10 per single call but should be easy to change as Autofixa change and provide us with the option for more

Price

API Docs: https://autofixa-test-seller-api.azurewebsites.net/index.html

API Call: PUT /api/offer/bulk-price

Example:

[
  {
    "sku": "string",
    "normalPrice": 0,
    "salePrice": 0,
    "saleStartDate": "2022-02-14T07:41:31.346Z",
    "saleEndDate": "2022-02-14T07:41:31.346Z"
  }
]

Mapping:

OR Item Account > RRP | In the cases we have both StartPrice and RRP we want to send RRP as price and the StartPrice in the following Storesome field “salePrice”. If we don’t have an RRP we want to send only “price” in the “normalPrice” field and ignore all other fields | | salePrice | Item Account > Start Price* | Conditional - see “price” Also if Promotions are ready they should take over here | | saleStartDate | Item Account Storesome > StartDate OR DEFAULT (NOW) | Conditional - see “price” | | saleEndDate | Item Account Storesome > EndDate OR DEFAULT (NOW+2years) | Conditional - see “price” |

Response examples:

Success

true

Note: expectation is if all passed SKUs in the call are successfully updated we will receive in the body of the call the above example

Error

"[{\"Key\":\"4430000000\",\"Value\":\"Normal price can not be lower than special price.\"}]"

Note: expectation is if an item from the call is not successfully updating on Autofixa we will receive an error with a Key pointing to the SKU we are passing and Value as the issue it has that we need to store as error against this item

Additional Info:

• Everything from the general price abstraction should work: Price Update General requirements
• Limit: up to 10 per single call but should be easy to change as Autofixa change and provide us with the option for more