###############
PURCHASE ORDERS
###############

Get information about one or many purchase orders
*************************************************

Obtiene información y el detalle de artículos recibidos de una o varias ordenes

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

.. http:get:: http://api.next-cloud.mx/v1/purchase/order/(int:order_id).(format)

	:param order_id: Folio de la orden.
	:param format: json o xml.

	:reqheader Authorization: Token del usuario.

	:query date start_date: Fecha inicial de consulta (yyyy-MM-dd).
	:query date end_date: Fecha final de consulta (yyyy-MM-dd).

	: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.

	:>jsonarr string status: Estado actual de la orden.
	:>jsonarr int folio: Número de folio de la orden.
	:>jsonarr string document: Tipo del documento.
	:>jsonarr string observation: Observaciones de la orden.
	:>jsonarr float discount: Descuento aplicado.
	:>jsonarr date creation: Fecha de emisión (dd/mm/yyyy).
	:>jsonarr float tax: Impuesto aplicado.
	:>jsonarr date delivery: Fecha de entrega (dd/mm/yyyy).
	:>jsonarr string currency: Moneda en la que se expresa la orden.
	:>jsonarr float amount: Importe antes de impuestos.
	:>jsonarr string contact: Contacto del proveedor.
	:>jsonarr array details: Lista de artículos recibidos en la orden.
	:>jsonarr int shipment: Número de embarque.
	:>jsonarr string provider: Nombre del proveedor.
	:>jsonarr string warehouse: Nombre del almacén donde se recibe la orden.
	:>jsonarr float total: Importe total (Con impuestos).
	:>jsonarr string order_number: Número de orden (número de pedido)

	**details**

	:>json string sku: SKU del artículo.
	:>json float received: Cantidad recibida del artículo.
	:>json string sku_description: Descripción del artículo.
	:>json float requested: Cantidad solicitada del artículo.

Example request (one order)
===========================

.. sourcecode:: http

	GET http://api.next-cloud.mx/v1/purchase/order/25.json
	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_purchase_order_02.json
	:language: json

Example request (date range)
============================

.. sourcecode:: http

	GET http://api.next-cloud.mx/v1/purchase/order/0.json?start_date=2019-01-02&end_date=2019-01-02
	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_purchase_order_01.json
	:language: json

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

Example request (one order)
===========================

.. sourcecode:: http

	GET http://api.next-cloud.mx/v1/purchase/order/25.xml
	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/xml; charset=utf-8
	Allow: GET, OPTIONS

.. literalinclude:: example_purchase_order_02.xml
	:language: xml

Example request (date range)
============================

.. sourcecode:: http

	GET http://api.next-cloud.mx/v1/purchase/order/0.xml?start_date=2019-01-02&end_date=2019-01-02
	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/xml; charset=utf-8
	Allow: GET, OPTIONS

.. literalinclude:: example_purchase_order_01.xml
	:language: xml