###############
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:: https://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.
    :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.

    :>json string status: Estado de la orden.
    :>json int folio: Folio de la orden.
    :>json string document: Tipo del documento.
    :>json string observation: Observaciones.
    :>json float discount: Descuento aplicado.
    :>json date creation: Fecha de emisión (dd/mm/yyyy).
    :>json float tax: Impuesto aplicado.
    :>json date delivery: Fecha de entrega (dd/mm/yyyy).
    :>json string currency: Moneda de la orden.
    :>json float amount: Importe sin impuestos.
    :>json string contact: Contacto del proveedor.
    :>json array details: Lista de artículos recibidos.
    :>json int shipment: Número de embarque.
    :>json string provider: Nombre del proveedor.
    :>json string warehouse: Nombre del almacén.
    :>json float total: Importe total (Con impuestos).
    :>json 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 v1/purchase/order/25.json 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_purchase_order_02.json
    :language: json

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

.. sourcecode:: http

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

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

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

.. sourcecode:: http

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

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

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

.. sourcecode:: http

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

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