--- title: "Listar detalles de comprobantes contables." method: GET path: "/contabilidad/comprobantecontable/detalles" tags: ["Contabilidad Externa"] --- # Listar detalles de comprobantes contables. `GET /contabilidad/comprobantecontable/detalles` ## Request - Base URL: `https://api.loggro.com/apik/loggro-nomina` - URL: `https://api.loggro.com/apik/loggro-nomina/contabilidad/comprobantecontable/detalles` - Auth: none declared. Required headers: `Authorization` Consultar el listado paginado de detalles de comprobantes contables. Devuelve **una fila por partida contable**, no por comprobante: un comprobante de nómina genera varias filas, una por cada cuenta afectada. Los filtros se envían como `campo=TIPO:valor`. Los tipos admitidos son `EQ`, `NEQ`, `LIKE`, `NLIKE`, `GT`, `LT`, `GTEQ`, `LTEQ`, `DATE`, `IN`, `NIN`, `N` (el campo es nulo) y `NN` (el campo no es nulo). No distinguen mayúsculas de minúsculas, así que `LIKE:` y `like:` son equivalentes. Los tipos `N` y `NN` ignoran el valor que se les pase. Ejemplo: `comprobanteContable.ano=EQ:2026&cuentaImputable.codigo=LIKE:5105`. **Los filtros no reconocidos se descartan en silencio**: no producen error, simplemente no se aplican y la consulta devuelve más registros de los esperados. Esto ocurre cuando el nombre del campo no existe, cuando el campo no es filtrable, y cuando el valor no corresponde a los admitidos en un campo de lista (como `estado`). **El nombre del filtro no coincide con el del campo devuelto.** Por ejemplo, se filtra por `comprobanteContable.ano` pero el campo de la respuesta se llama `anio`; enviar `anio=EQ:2026` no filtra nada. Use únicamente los nombres listados abajo. Los campos `documento` y `documentoImputado` se devuelven en la respuesta pero **no son filtrables**, aunque sí se pueden usar para ordenar. ## Query parameters - `limit` integer - `offset` integer - `sort` string - `comprobanteContable.ano` string - `comprobanteContable.periodo` string - `comprobanteContable.fechaTransaccion` string - `comprobanteContable.numero` string - `comprobanteContable.fuenteContable.codigo` string - `comprobanteContable.estadoComprobante` string - `comprobanteContable.reversado` string - `comprobanteContable.anoReversible` string - `cuentaImputable.codigo` string - `cuentaImputable.nombre` string - `cuentaCodigoAlterno` string - `terceroSecundario.codigo` string - `terceroSecundario.descripcion` string - `tercero.codigo` string - `tercero.descripcion` string - `centro.codigo` string - `centro.descripcion` string - `unidadNegocio.codigo` string - `unidadNegocio.nombre` string - `conceptoContable.descripcion` string - `comentario` string - `tipoTransaccion` string - `elemento1Contable.descripcion` string - `elemento2Contable.descripcion` string - `elemento3Contable.descripcion` string - `centroImputado.descripcion` string - `conceptoContableImputado.descripcion` string - `terceroImputado.descripcion` string ## Headers - `Authorization` string, required ## Response `200` Solicitud exitosa. Nómina devuelve **la respuesta completa de Loggro Contabilidad dentro de `contenido`**, sin desempaquetarla. Por eso las filas quedan en `contenido.contenido` y la paginación en `contenido.metadata.pagination`. Los endpoints de detalle de esta misma sección (detalle de cuenta y detalle de comprobante por número y fuente) sí desempaquetan la respuesta, así que en esos el objeto va directamente en `contenido`. El campo `organizacion` siempre viene vacío: la consulta no lo alimenta. - RespuestaDetallesComprobantesContables: Respuesta del listado de detalles de comprobantes contables. Nómina reenvía la respuesta completa de Loggro Contabilidad dentro de `contenido`, sin desempaquetarla, por lo que las filas quedan un nivel más abajo en `contenido.contenido`. - `contenido` PaginaDetallesComprobantesContables: Respuesta paginada tal como la entrega Loggro Contabilidad. - `contenido` DetalleComprobanteContableDTO[]: Partidas contables que cumplen los filtros de la consulta. - `uuid` string: Identificador único de la partida contable. - `anio` integer: Año del comprobante. Se filtra con `comprobanteContable.ano`. - `periodo` integer: Periodo (mes) del comprobante. Se filtra con `comprobanteContable.periodo`. - `contacto` string: Identificación del contacto (EPS, AFP, caja de compensación, etc.). - `nombreContacto` string: Nombre del contacto. - `comprobante` string: Número del comprobante contable. - `cuenta` string: Código de la cuenta contable imputable. - `nombreCuenta` string: Nombre de la cuenta contable. - `fecha` string, date-time: Fecha de la transacción del comprobante. - `valorDebito` number, double: Valor débito en moneda local. Se ordena con `valorDebitoML`. - `valorCredito` number, double: Valor crédito en moneda local. Se ordena con `valorCreditoML`. - `valorBase` number, double: Valor base en moneda local. Se ordena con `valorBaseML`. - `comentario` string: Comentario de la partida. - `empleado` string: Identificación del empleado. Se filtra con `terceroSecundario.codigo`. - `nombreEmpleado` string: Nombre del empleado. - `fuente` string: Código de la fuente contable que originó el comprobante. `NOMINA-LOGGRO` para los comprobantes de nómina y `PASIVO-LABORAL` para los de pasivos laborales. - `centro` string: Código del centro de costo. - `nombreCentro` string: Descripción del centro de costo. - `elemento1` string: Descripción del elemento contable 1. - `elemento2` string: Descripción del elemento contable 2. - `elemento3` string: Descripción del elemento contable 3. - `unidad` string: Código de la unidad de negocio. - `nombreUnidad` string: Nombre de la unidad de negocio. - `estado` 'EN_PROCESO' | 'PROCESO_IMPUTACION' | 'DEFINITIVO' | 'RETIRADO' | 'EN_MODIFICACION': Estado del comprobante al que pertenece la partida. - `tipoTransaccion` string: Descripción del tipo de transacción que originó la partida. En las anulaciones viene con el prefijo `Anulación`. - `organizacion` string: Siempre viene vacío: la consulta no alimenta este campo. - `cuentaCodigoAlterno` string: Código alterno de la cuenta, usado para la equivalencia con sistemas contables externos. - `concepto` string: Código del concepto contable. Tenga en cuenta que el filtro `conceptoContable.descripcion` opera sobre la descripción, no sobre este código. - `naturaleza` 'DEBITO' | 'CREDITO': Naturaleza contable de la partida. - `documento` string: Documento asociado a la partida. No es filtrable, aunque sí se puede usar para ordenar. - `metadata` MetadataComprobantesContables: Metadatos de la consulta. Además de estas propiedades, la respuesta devuelve un eco de los filtros recibidos, que incluye también los que fueron descartados por no ser válidos, así que no sirve para confirmar qué filtros se aplicaron. - `order` string: Criterio de ordenamiento aplicado a la consulta. - `pagination` PaginacionComprobantesContables: Datos de paginación de la consulta. - `offset` integer: Registro inicial de la página retornada. - `limit` integer: Cantidad máxima de registros de la página, con tope de 100. - `total` integer: Total de partidas que cumplen los filtros, sin paginar. - `error` Error: Clase que representa un error con varios detalles. - `fecha` string: La fecha del error. - `campo` string: El campo asociado con el error. - `codigo` string: El código del error. - `codigoEstado` integer: El código de estado asociado con el error. - `error` string: La descripción del error. - `masInfo` object[]: Información adicional sobre el error. - `mensaje` string - `advertencia` Error: Clase que representa un error con varios detalles. - `fecha` string: La fecha del error. - `campo` string: El campo asociado con el error. - `codigo` string: El código del error. - `codigoEstado` integer: El código de estado asociado con el error. - `error` string: La descripción del error. - `masInfo` object[]: Información adicional sobre el error. - `mensaje` string ## Other responses - `401`: No autorizado para el uso del servicio. - `404`: Loggro Contabilidad respondió `404`. La respuesta no trae cuerpo. Un listado sin resultados **no** devuelve `404`: devuelve `200` con `contenido.contenido` vacío. - `417`: Error de validación de negocio. - `500`: Error interno del servidor. --- [API](https://skmtc.dev/loggro/apis/n-mina-servicios-del-m-dulo-de-n-mina.md) - [All operations](https://skmtc.dev/loggro/apis/n-mina-servicios-del-m-dulo-de-n-mina/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/n-mina-servicios-del-m-dulo-de-n-mina/revisions/50f1d437c8b6?raw)