###################
List Orders
###################

Listar Pedidos
******************

Obtiene listado de pedidos en base a los parámetros enviados.

.. include:: /peticion.rst

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

.. http:get:: HOST/v1/orders/?created_at_after=(date:created_at_after)&created_at_before=(date:created_at_before)&warehouse=(int:warehouse)&store=(int:store)&customer=(int:customer)

	:param created_at_after: (opcional) Fecha inicial del rango de creación (formato YYYY-MM-DD).
	:type created_at_after: date

	:param created_at_before: (opcional) Fecha final del rango de creación (formato YYYY-MM-DD).
	:type created_at_before: date

	:param warehouse: (opcional) Identificador del almacén. Ej: 1.
	:type warehouse: int

	:param store: (opcional) Identificador de la tienda. Ej: 1.
	:type store: int

	:param customer: (opcional) Identificador del cliente. Ej: 1.
	:type customer: int

	:param page: (optional) Identificador de la pagina consultada.
	:type page: int

	:param page_size: (opcional) Total de resultados por pagina (por defecto son 100).
	:type page_size: int

	:reqheader Authorization: Token del usuario.
	:reqheader Content-Type: Define el formato en el que se envian los datos por el body.

	:>json int count: Total de resultados obtenidos por la consulta.
	:>json string next: Página siguiente de resultados.
	:>json string previous: Página anterior de resultados.
	:>json obj result: Objeto con resultados de la consulta.

	:statuscode 200: Ningún error.
	:statuscode 400: Algún parámetro es incorrecto.
	:statuscode 401: Token no válido o no enviado.
	:statuscode 404: El recurso no existe.

	**result object**:

	:>json int id: Identificador del pedido.
	:>json string document: Clave del documento factura.
	:>json int folio: Folio de la factura.
	:>json string serie: Serie de factura.
	:>json int customer: Identificador del cliente.
	:>json string status: Clave de estado del pedido.
	:>json int warehouse: Identificador del almacén.
	:>json int store: Identificador de la tienda.
	:>json float total: Total del pedido.
	:>json date created_at: Fecha de creación del documento.


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

.. sourcecode:: http

	GET /v1/orders/?created_at_after=2025-01-01&created_at_before=2025-05-30&warehouse=1&store=1&customer=1 HTTP/1.1
	Host: api.next-cloud.mx
	Accept: application/json
	Content-Type: application/json
	Authorization: Token ( token del usuario )

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

.. sourcecode:: http

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

.. literalinclude:: example_orders_01.json
	:language: json