#####
Stock
#####

Get the Stock from a Warehouse
******************************

Obtiene el stock de un almacén

Resource URL
============

.. http:post:: http://api.next-cloud.mx/v1/warehouse/(int:warehouse_id)/stock.(format)

	:param warehouse_id: ID del almacén.
	:param format: json o xml.

	:reqheader Authorization: Token del usuario.

	:query int page: Número de página (default: 0).
	:query int page_length: Tamaño de la página (default: 100).
	:query int only_exist: define si solo traera articulos con existencias (default: True).

	:>json int page: Número de página enviada.
	:>json int page_length: Tamaño de la página.
	:>json int number_page: Número de páginas en total segun el 'page_length'.
	:>json array stock: Lista de artículos con sus existencias.

	:statuscode 200: Ningún error.
	:statuscode 400: Algún parámetro es incorrecto.
	:statuscode 401: Token no válido o no enviado.
	:statuscode 404: Cliente no localizado o el almacen no tiene existencias.
	:statuscode 500: Error.
	
	**stock array**

	:>jsonarr obj article: Objeto del artículo.
	:>jsonarr float stock: Existencias del artículo.
	:>jsonarr float available: Disponibles del artículo.
	:>jsonarr float separated: Apartados del artículo.
	:>jsonarr float to_autorized: la cantidad de articulos que estan en backorder

	**article object**

	:>json string sku: SKU del artículo.
	:>json string name: Nombre del artículo.
	:>json float precio1: Precio 1 del artículo.
	:>json float precio2: Precio 2 del artículo.
	:>json string mon_prec: Moneda en la que se expresa el precio del artículo.
	:>json string upc: UPC registrado en el artículo.
	:>json string num_parte: Número de parte establecido en el artículo.

Example request
===============

.. sourcecode:: http

	GET http://api.next-cloud.mx/v1/warehouse/1/stock.json?page_length=10 HTTP/1.1
	Host: api.next-cloud.mx
	Accept: application/json
	Authorization: Token (token del usuario)

Example Response
================

.. sourcecode:: http

	HTTP/1.1 200 OK
	Vary: Accept
	Content-Type: application/json
	Allow: GET, OPTIONS

.. literalinclude:: example_warehouse_01.json
	:language: json

Example XML
===========

Example request
---------------

.. sourcecode:: http

	GET http://api.next-cloud.mx/v1/warehouse/1/stock.xml?page_length=10 HTTP/1.1
	Host: api.next-cloud.mx
	Accept: application/xml
	Authorization: Token (token del usuario)

Example Response
----------------

.. sourcecode:: http

	HTTP/1.1 200 OK
	Vary: Accept
	Content-Type: application/xml; charset=utf-8
	Allow: GET, OPTIONS

.. literalinclude:: example_warehouse_01.xml
	:language: xml