> For the complete documentation index, see [llms.txt](https://www.apidoc-en.webshippy.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.apidoc-en.webshippy.com/webshippy-api-guide/setting-external-warehouse-inventory.md).

# External Inventory API

With this function you can set stock quantity for products available from external warehouse and name of the external warehouse. Settings can be made for multiple products at once, the data must be listed by product. If a product (SKU) is listed more than once in the submitted data, the last correct data in the list will be saved for the product.

{% hint style="info" %}
For Marketplace use, please go and refer to related [help](https://help.webshippy.com/hu/articles/3768583-sajat-termekek-belistazasa-a-dropshippy-katalogusba) which fields you need to specify
{% endhint %}

| Filtering terms     | Required? | Desciption                                              |
| ------------------- | --------- | ------------------------------------------------------- |
| `apiKey`            | Yes       | API key                                                 |
| `products`          | Yes       | Data to be entered per product                          |
| `sku`               | Yes       | Product's SKU, item number                              |
| `externalQuantity`  | No        | The stock quantity available from an external warehouse |
| `externalWarehouse` | No        | Name of the external warehouse                          |

In case of **XML**:

Url: `https://app.webshippy.com/wspyapi/ExternalWarehouseInventory/xml`

Request:

```
<?xml version="1.0" encoding="utf-8"?>
<request>
    <apiKey>api-key-comes-here</apiKey>
    <products>
        <product>
        <sku>szuperhos-polo-piros-xl</sku>
        <externalQuantity>50</externalQuantity>
        <externalWarehouse>Külső raktár</externalWarehouse>
        </product>
    </products>
    <products>
        <product>
        <sku>cicanaci-one-size</sku>
        <externalQuantity>100</externalQuantity>
        <externalWarehouse>Külső raktár</externalWarehouse>
        </product>
    </products>
</request>
```

Response (example):

```
<?xml version="1.0" encoding="utf-8"?>
<response>
  <status>success</status>
  <message>
    <elem>2 updates successful.</elem>
  </message>
  <products>
    <elem>
      <sku>szuperhos-polo-piros-xl</sku>
      <message>Update successful.</message>
    </elem>
	<elem>
      <sku>cicanaci-one-size</sku>
      <message>Update successful.</message>
    </elem>
  </products>
</response>
```

In case of **JSON**:

Url: `https://app.webshippy.com/wspyapi/ExternalWarehouseInventory/json`

Request:

```
{
  "apiKey": "api-key-comes-here",
  "products": [
    {
      "sku": "szuperhos-polo-piros-xl",
      "externalQuantity": "50",
      "externalWarehouse": "Külső raktár"
    },
    {
      "sku": "cicanaci-one-size",
      "externalQuantity": "100",
      "externalWarehouse": "Külső raktár"
    }
  ]
}
```

Response (example):

```
{
    "status": "success",
    "message": [
        "2 updates successful."
    ],
    "products": [
        {
            "sku": "szuperhos-polo-piros-xl",
            "message": "Update successful."
        },
        {
            "sku": "cicanaci-one-size",
            "message": "Update successful."
        },
    ]
}
```

Additional response possibilities:

* `X updates successful.`
* `X updates successful. Rest Y records caused warning.`
* `No products present`


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://www.apidoc-en.webshippy.com/webshippy-api-guide/setting-external-warehouse-inventory.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.