Contabilidad Externa

Listar detalles de comprobantes contables.

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.

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

Query parameters

limitinteger
Example:100

Cantidad máxima de registros a retornar. Por defecto 20 y con un tope de 100: si se envía un valor mayor, se recorta a 100 sin avisar.

offsetinteger

Registro inicial de la página a retornar.

sortstring
Example:comprobanteContable.numero,-valorDebitoML

Lista de campos separados por coma por los que se ordena, anteponiendo - al campo para orden descendente. Se usan los nombres internos de los campos, que para los valores son valorDebitoML, valorCreditoML y valorBaseML. Si no se envía, el orden por defecto es comprobanteContable.ano,comprobanteContable.periodo,terceroSecundario.descripcion,cuentaImputable.codigo.

comprobanteContable.anostring
Example:EQ:2026

Año del comprobante. Campo devuelto: anio.

comprobanteContable.periodostring
Example:EQ:9

Periodo (mes) del comprobante. Campo devuelto: periodo.

comprobanteContable.fechaTransaccionstring
Example:DATE:2026-09-30

Fecha de la transacción, en formato aaaa-mm-dd. Campo devuelto: fecha.

comprobanteContable.numerostring
Example:LIKE:260917

Número del comprobante. Campo devuelto: comprobante.

comprobanteContable.fuenteContable.codigostring
Example:LIKE:NOMINA-LOGGRO

Fuente contable que originó el comprobante. Use NOMINA-LOGGRO para los comprobantes de nómina y PASIVO-LABORAL para los de pasivos laborales. Campo devuelto: fuente.

comprobanteContable.estadoComprobantestring
Example:EQ:DEFINITIVO

Estado del comprobante. Valores admitidos: EN_PROCESO, PROCESO_IMPUTACION, DEFINITIVO, RETIRADO y EN_MODIFICACION. Si se envía un valor distinto, el filtro se descarta. Campo devuelto: estado.

comprobanteContable.reversadostring
Example:EQ:0

Excluye los comprobantes reversados cuando se envía EQ:0. La pantalla de Loggro lo usa junto con comprobanteContable.anoReversible.

comprobanteContable.anoReversiblestring
Example:N:0

Año del comprobante de reverso. Con el tipo N filtra los registros donde este campo es nulo, es decir, los que no son comprobantes de reverso. El valor que acompaña a N se ignora.

cuentaImputable.codigostring
Example:LIKE:23650501

Código de la cuenta contable. Campo devuelto: cuenta.

cuentaImputable.nombrestring
Example:LIKE:Retención

Nombre de la cuenta contable. Campo devuelto: nombreCuenta.

cuentaCodigoAlternostring
Example:LIKE:2365

Código alterno de la cuenta, usado para la equivalencia con sistemas contables externos. Campo devuelto: cuentaCodigoAlterno.

terceroSecundario.codigostring
Example:LIKE:43786358

Identificación del empleado. Campo devuelto: empleado.

terceroSecundario.descripcionstring
Example:LIKE:Pérez

Nombre del empleado. Campo devuelto: nombreEmpleado.

tercero.codigostring
Example:LIKE:800088702

Identificación del contacto (EPS, AFP, caja de compensación, etc.). Campo devuelto: contacto.

tercero.descripcionstring
Example:LIKE:Suramericana

Nombre del contacto. Campo devuelto: nombreContacto.

centro.codigostring
Example:LIKE:001

Código del centro de costo. Campo devuelto: centro.

centro.descripcionstring
Example:LIKE:Administración

Descripción del centro de costo. Campo devuelto: nombreCentro.

unidadNegocio.codigostring
Example:LIKE:01

Código de la unidad de negocio. Campo devuelto: unidad.

unidadNegocio.nombrestring
Example:LIKE:Principal

Nombre de la unidad de negocio. Campo devuelto: nombreUnidad.

conceptoContable.descripcionstring
Example:LIKE:Retención

Descripción del concepto contable. Tenga en cuenta que el campo devuelto concepto trae el código, no la descripción.

comentariostring
Example:LIKE:nómina

Comentario de la partida. Campo devuelto: comentario.

tipoTransaccionstring
Example:LIKE:Salario

Descripción del tipo de transacción que originó la partida, ej. Salario o Retención en la Fuente. En las anulaciones viene con el prefijo Anulación. Campo devuelto: tipoTransaccion.

elemento1Contable.descripcionstring
Example:LIKE:elemento

Descripción del elemento contable 1. Campo devuelto: elemento1.

elemento2Contable.descripcionstring
Example:LIKE:elemento

Descripción del elemento contable 2. Campo devuelto: elemento2.

elemento3Contable.descripcionstring
Example:LIKE:elemento

Descripción del elemento contable 3. Campo devuelto: elemento3.

centroImputado.descripcionstring
Example:LIKE:Administración

Descripción del centro imputado. Este campo no viene en la respuesta, solo filtra.

conceptoContableImputado.descripcionstring
Example:LIKE:concepto

Descripción del concepto contable imputado. Este campo no viene en la respuesta, solo filtra.

terceroImputado.descripcionstring
Example:LIKE:tercero

Descripción del tercero imputado. Este campo no viene en la respuesta, solo filtra.

Headers

Authorizationstring required

Bearer token para la autorización.

Response

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.

Example response

{
  "contenido": {
    "contenido": [
      {
        "uuid": "95D2A5A014D4829477AC11002A417573",
        "anio": 2026,
        "periodo": 9,
        "contacto": "800088702",
        "nombreContacto": "Compañía Suramericana S.A.",
        "comprobante": "260917",
        "cuenta": "23650501",
        "nombreCuenta": "Retención en la Fuente por Salarios",
        "fecha": "2026-09-30T00:00:00.000+00:00",
        "valorCredito": 125000,
        "comentario": "Comprobante de nómina septiembre 2026",
        "empleado": "43786358",
        "nombreEmpleado": "Pérez Gómez Ana",
        "fuente": "NOMINA-LOGGRO",
        "centro": "001",
        "nombreCentro": "Administración",
        "unidad": "01",
        "nombreUnidad": "Principal",
        "estado": "DEFINITIVO",
        "tipoTransaccion": "Retención en la Fuente",
        "cuentaCodigoAlterno": "2365-05",
        "concepto": "001",
        "naturaleza": "CREDITO",
        "documento": "260917"
      }
    ],
    "metadata": {
      "order": "comprobanteContable.ano,comprobanteContable.periodo",
      "pagination": {
        "limit": 100,
        "total": 1
      }
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.