Consultar análisis de edades CxC por cliente

get

https://api.loggro.com/apik/loggro-facturacion/v1/edades-cxc/cliente

Retorna el detalle del análisis de edades de cuentas por cobrar (CxC) para un cliente específico, desglosado por documento (factura, nota débito, etc.). Solo incluye documentos con saldo pendiente mayor a cero.

Parámetros de identificación del cliente

Se debe enviar uno de los siguientes identificadores (son excluyentes):

Parámetro	Tipo	Descripción
`uuid`	string	UUID del cliente en Loggro (32 chars hex). No enviar junto con `tipoId` o `id`.
`tipoId` + `id`	string	Tipo y número de identificación del cliente. Deben enviarse juntos.

Parámetros de filtro y paginación

Parámetro	Tipo	Obligatorio	Descripción
`establecimientoUuidOCodigo`	string	No	UUID o código del establecimiento a filtrar. Si no se envía, retorna datos de toda la compañía.
`fechaUltimaModificacion`	string	No	Filtra documentos cuyo saldo fue modificado a partir de esta fecha. Formato `dd/MM/yyyy`. No puede ser fecha futura.
`page`	integer	No	Número de página (base 1). No puede ser negativo. Por defecto `1`.
`limit`	integer	No	Máximo de registros por página. No puede ser negativo ni superar `100`. Por defecto `20`.

Reglas de negocio

Al menos uno de los identificadores (uuid o tipoId+id) es obligatorio; si no se envía ninguno, retorna 400.
No se puede enviar uuid junto con tipoId o id; retorna 400.
tipoId e id deben enviarse juntos; si solo se envía uno, retorna 400.
Si el tipoId no existe en el sistema, retorna 400.
Si el cliente no existe, retorna 404.
Si se envía establecimientoUuidOCodigo y no existe, retorna 404.
fechaUltimaModificacion filtra documentos cuyo saldo fue modificado a partir de esa fecha (inclusive).
fechaUltimaModificacion debe tener el formato dd/MM/yyyy; de lo contrario retorna 400.
fechaUltimaModificacion no puede ser una fecha futura; de lo contrario retorna 400.
page no puede ser negativo; de lo contrario retorna 400.
limit no puede ser negativo ni superar 100; de lo contrario retorna 400.
Solo se retornan documentos cuyo saldo pendiente es mayor a cero.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

uuid

string

[0-9A-F]{32}

UUID del cliente en Loggro. Si se envía, no se deben enviar tipoId ni id.

tipoId

string

length ≤ 6

Tipo de identificación del cliente (CC, NIT, PS, DE, etc.). Debe enviarse junto con id.

string

length ≤ 30

Número de identificación del cliente. Debe enviarse junto con tipoId.

establecimientoUuidOCodigo

string

UUID o código del establecimiento a filtrar. Si no se envía, retorna datos de toda la compañía.

fechaUltimaModificacion

string

Filtra documentos cuyo saldo fue modificado a partir de esta fecha. Formato dd/MM/yyyy. No puede ser una fecha futura.

page

integer

≥ 0

Defaults to 1

Número de página (base 1). No puede ser negativo. Por defecto 1.

limit

integer

≤ 100

Defaults to 20

Cantidad máxima de registros a retornar. No puede ser negativo ni superar 100. Por defecto 20.

Responses

400

Identificador del cliente no proporcionado, conflicto entre uuid y tipoId/id, tipoId e id no enviados juntos, page o limit negativos, limit supera 100, o fechaUltimaModificacion tiene formato inválido o es fecha futura.

404

Cliente o establecimiento no encontrado.

500

Error interno del servidor.

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Detalle de edades por cliente obtenido exitosamente.