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