Listar detalles de comprobantes contables

Consultar el listado paginado de detalles de comprobantes contables.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Reglas de negocio

  • Este endpoint es un proxy de solo lectura hacia Loggro Contabilidad: nómina no almacena esta información, la consulta al módulo contable y la reenvía.
  • Solo está expuesto en la ruta de integración /ext, a diferencia del resto de servicios de nómina que también responden en la ruta interna.
  • Requiere que el rol tenga habilitado el recurso MENU_REPORTES_CONTABILIDAD_LISTA_COMPROBANTES.
  • Si la organización no tiene contabilidad configurada, la respuesta es un error de validación de negocio (417), no un 404.
  • Si Loggro Contabilidad responde 404, nómina devuelve 404 sin cuerpo. Un listado sin resultados no devuelve 404: devuelve 200 con contenido como lista vacía y total en 0.
  • Si Loggro Contabilidad no responde, el error es también 417 pero con un código distinto al de "sin contabilidad configurada": conviene distinguirlos, porque uno es de configuración y el otro es transitorio.
  • Si el rol no tiene el recurso habilitado, la respuesta es 417, no 403.
Query Params
integer

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.

integer

Registro inicial de la página a retornar.

string

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.

string

Año del comprobante. Campo devuelto: anio.

string

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

string

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

string

Número del comprobante. Campo devuelto: comprobante.

string

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.

string

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.

string

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

string

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.

string

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

string

Nombre de la cuenta contable. Campo devuelto: nombreCuenta.

string

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

string

Identificación del empleado. Campo devuelto: empleado.

string

Nombre del empleado. Campo devuelto: nombreEmpleado.

string

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

string

Nombre del contacto. Campo devuelto: nombreContacto.

string

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

string

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

string

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

string

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

string

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

string

Comentario de la partida. Campo devuelto: comentario.

string

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.

string

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

string

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

string

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

string

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

string

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

string

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

Headers
string
required

Bearer token para la autorización.

Responses

404

Loggro Contabilidad respondió 404. La respuesta no trae cuerpo.

Un listado sin resultados no devuelve 404: devuelve 200 con contenido.contenido vacío.

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json