###################
Balances List
###################

Listar Saldos
******************

Obtiene listado de saldos del cliente en base a los parámetros enviados.

.. include:: /peticion.rst

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

.. http:get:: HOST/v1/customers/balances/?created_at_after=(date:created_at_after)&created_at_before=(date:created_at_before)&customer=(int:customer)

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

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

	:param customer: Identificador del cliente.
	:type warehouse: 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 documento factura.
	:>json string document: Clave del documento factura.
	:>json int folio: Folio de la factura.
	:>json string serie: Serie de factura.
	:>json date created_at: Fecha de creación del documento.
	:>json float total: Total de la factura.
	:>json float balance: Saldo de la factura.


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

.. sourcecode:: http

	GET /v1/customers/balances/?created_at_after=2025-08-01&created_at_before=2025-08-15 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_balances_01.json
	:language: json