# STO01 - Import a stock file

Import a .csv file to update stock for offers, either globally or per warehouse.
Returns an import identifier to track the status of the import and retrieve an error report if applicable.
Call FrequencyRecommended usage: Every 5 minutes when stock needs updatingMaximum usage: Once per minute

Endpoint: POST /api/offers/stock/imports

## Query parameters:

  - `shop_id` (integer)
    Use this parameter when your user has access to several shops. If not specified, the shop_id from your default shop will be used.

## Request fields (multipart/form-data):

  - `file` (string, required)
    Import CSV file to upload. Use multipart/form-data with name file.
Csv format:

"offer-sku";"quantity";"warehouse-code";"update-delete"

    1 line = 1 offer quantity
    List quantities per warehouse for the same offer together
    If warehouse-code is not provided, the quantity provided for the offer-sku will be considered as a global one

## Response 201 fields (application/json):

  - `import_id` (string)
    Offer stock import identifier