Inventaire

Obtenir des articles

GET /inventory/items[/name/{#name}][/kind/#{kind}][/unit_price_operator/#{unit_price_operator}][/unit_price/#{unit_price}][/qty_operator/#{qty_operator}][/qty/#{qty}][/stock_operator/#{stock_operator}][/stock/#{stock}]

Arguments de l'URI

Argument	Type	Requis	Valeur/Description
name	string		Un nom ou code.
kind	integer		Type d'article. Voir les valeurs possibles de kind.
unit_price_operator	string		Voir les valeurs possibles de operator.
unit_price	double		Un prix unitaire.
qty_operator	string		Voir les valeurs possibles de operator.
qty	double		Une quantité.
stock_operator	string		Voir les valeurs possibles de operator.
stock	double		Une quantité de stock.

Exemple de requête avec cURL

	
curl -u #:#{password}'\
-H 'User-Agent: #{user_agent}'\
-X GET https://#{subdomain}.iscriba.com/api/inventory/items/unit_price_operator/gteq/unit_price/100
	

Exemple de réponse XML

HTTP Status: 200 OK

<?xml version="1.0" encoding="utf-8"?>
<xml>
	<items>
		<item>
		...
		</item>
		<item>
		...
		</item>
	</items>
</xml>
	

Haut

---

Obtenir un article

GET /inventory/item/id/#{item_id}

Arguments de l'URI

Argument	Type	Requis	Valeur
id	integer	oui	Le #{item_id} de l'article que vous souhaitez obtenir.

Exemple de requête avec cURL

curl -u #:#{password}'\
-H 'User-Agent: #{user_agent}'\
-X GET https://#{subdomain}.iscriba.com/api/inventory/item/id/1
	

Exemple de réponse XML

HTTP Status: 200 OK

<?xml version="1.0" encoding="utf-8"?>
<xml>
	<item>
		<item_id>1</item_id>
		<name>Article</name>
		<kind>1</kind>
		<description>Description Article</description>
		<unit_price>100</unit_price>
		<qty>1</qty>
		<manage_stock>0</manage_stock>
		<stock>0</stock>
	</item>
</xml>
	

Haut

---

Créer un article

POST /inventory/item

Champs de la requête

Champ	Type	Requis	Description
name	string	oui	Un nom ou code.
kind	integer	oui	Type d'article. Voir les valeurs possibles de kind.
description	string	oui	Une description.
unit_price	double	oui	Un prix unitaire.
qty	double	oui	Une quantité.
manage_stock	boolean	oui	Gestion du stock.
stock	double	oui (si manage_stock = 1)	Une quantité en stock.

Exemple de requête avec cURL

curl -u #:#{password}'\
-H 'User-Agent: #{user_agent}'\
-d "name=Article&kind=1&description=Description Article&unit_price=10.50&qty=1&manage_stock=1&stock=10"\
https://#{subdomain}.iscriba.com/api/inventory/item
	

Exemple de réponse XML

HTTP Status: 201 Created

<?xml version="1.0" encoding="utf-8"?>
<xml>
	<item_id>1</item_id>
</xml>	
	

Haut

---

Modifier un article

PUT /inventory/item/id/#{item_id}

Arguments de l'URI

Argument	Type	Requis	Valeur
id	integer	oui	Le #{item_id} de l'article que vous souhaitez modifier.

Champs de la requête

Identiques à créer un article excepté qu'aucun champ n'est requis.

Exemple de requête avec cURL

curl -u #:#{password}'\
-H 'User-Agent: #{user_agent}'\
-X PUT\
-d "kind=2&unit_price=12.50&stock=5"\
https://#{subdomain}.iscriba.com/api/inventory/item/id/1
	

Exemple de réponse XML

HTTP Response: 200 OK

<?xml version="1.0" encoding="utf-8"?>
<xml>
	<item_id>1</item_id>
</xml>	
	

Haut

---

Supprimer un article

DELETE /inventory/item/id/#{item_id}

Arguments de l'URI

Argument	Type	Requis	Valeur
id	integer	oui	Le #{item_id} de l'article que vous souhaitez supprimer.

Exemple de requête avec cURL

curl -u #:#{password}'\
-H 'User-Agent: #{user_agent}'\
-X DELETE https://#{subdomain}.iscriba.com/api/inventory/item/id/1
	

Exemple de réponse XML

HTTP Response: 200 OK

<?xml version="1.0" encoding="utf-8"?>
<xml>
	<item_id>1</item_id>
</xml>	
	

Haut

---