# External Inventory API

### Külső raktárkészlet beállítása

Ezzel a funkcióval lehet beállítani a termékekhez külső raktárról elérhető készlet mennyiségét és a külső raktár megnevezését. A beállításokat egyszerre több termékhez is el lehet végezni, az adatokat termékenkénti felsorolásban kell megadni. Ha egy termék (SKU) többször is szerepel a beküldött adatok között, akkor a felsorolásban utoljára szereplő helyes adatok kerülnek mentésre a termékhez.

{% hint style="info" %}
Marketplace felhasználás esetén keresd fel a kapcsolódó [help](https://help.webshippy.com/hu/articles/3768583-sajat-termekek-belistazasa-a-dropshippy-katalogusba) anyagjainkat is.
{% endhint %}

| Mező                | Kötelező? | Leírás                                         |
| ------------------- | --------- | ---------------------------------------------- |
| `apiKey`            | Igen      | Az API kulcs.                                  |
| `products`          | Igen      | A felvinni kívánt adatok termékenként.         |
| `sku`               | Igen      | A termék SKU-ja (cikkszáma).                   |
| `externalQuantity`  | Igen      | A külső raktárról elérhető készlet mennyisége. |
| `externalWarehouse` | Nem       | A külső raktár megnevezése.                    |

**XML** esetén:

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

Kérés:

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

Válasz (példa):

```
<?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>
```

**JSON** esetén:

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

Kérés:

```
{
  "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"
    }
  ]
}
```

Válasz (példa):

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

További válaszlehetőségek:

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


---

# Agent Instructions: 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://apidoc.webshippy.com/webaruhaz-integraciok/external-inventory-api.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.