API Consulta de Asientos

Esta API permite consultar y listar asientos contables previamente generados en la empresa. La información expuesta corresponde a movimientos ya registrados en el sistema y equivale funcionalmente a la consulta disponible en Contabilidad > Asientos.

Casos de uso

  • Consultar asientos contables por ejercicio y rango de fechas.
  • Filtrar asientos por tipo de asiento.
  • Integrar movimientos contables con sistemas externos de auditoría, reporting o conciliación.
  • Obtener detalle de cuentas, importes, centros, referencias y contactos asociados a cada asiento.

Endpoint del servicio

Método Lista

Permite recuperar asientos contables ya generados, aplicando filtros por ejercicio, período y tipo de asiento.

Requisitos previos

  • Contar con acceso habilitado a la API.
  • Disponer de un código de ejercicio contable válido.
  • Conocer el código de tipo de asiento si se requiere filtrado específico.

Parámetros de entrada

ParámetroTipoObligatorioDescripción
EjercicioN(2)Código del ejercicio contable. Valor máximo admitido: 10.
FechaInicioFechaNoFecha inicial del rango de consulta, en formato AAAAMMDD.
FechaFinFechaNoFecha final del rango de consulta, en formato AAAAMMDD.
TipoAsientoT(3)NoCódigo del tipo de asiento. Si se envía vacío, se incluyen todos los tipos de asiento.

Estructura del request

Ejercicio
FechaInicio
FechaFin
TipoAsiento

Ejemplo de request

{
  "Ejercicio": 1,
  "FechaInicio": "20260101",
  "FechaFin": "20260131",
  "TipoAsiento": ""
}

Estructura del response

Numero
Fecha
Cuenta
CuentaNombre
Concepto
Moneda
MonedaSimbolo
Debe
Haber
Tipo
TipoNombre
Cotizacion
Centro
CentroNombre
Referencia
Local
Contacto
ContactoRazonSocial
RUT
Tributo

Campos devueltos

CampoDescripción
NumeroNúmero del asiento contable.
FechaFecha del asiento.
CuentaCódigo de la cuenta contable.
CuentaNombreNombre de la cuenta contable.
ConceptoConcepto o descripción del movimiento.
MonedaCódigo de la moneda del asiento.
MonedaSimboloSímbolo de la moneda.
DebeImporte imputado al debe.
HaberImporte imputado al haber.
TipoCódigo del tipo de asiento.
TipoNombreNombre del tipo de asiento.
CotizacionCotización aplicada a la moneda del asiento.
CentroCódigo del centro de costos.
CentroNombreNombre del centro de costos.
ReferenciaCódigo o dato de referencia asociado.
LocalCódigo del local asociado al asiento.
ContactoCódigo del contacto vinculado.
ContactoRazonSocialRazón social del contacto.
RUTRUT asociado al movimiento.
TributoCódigo o identificador tributario asociado.

Ejemplo de response

[
  {
    "Numero": 1542,
    "Fecha": "20260115",
    "Cuenta": "1.1.01",
    "CuentaNombre": "Caja",
    "Concepto": "Cobranza contado",
    "Moneda": 1,
    "MonedaSimbolo": "$",
    "Debe": 15000.00,
    "Haber": 0.00,
    "Tipo": "ING",
    "TipoNombre": "Ingreso",
    "Cotizacion": 1.00,
    "Centro": "ADM",
    "CentroNombre": "Administración",
    "Referencia": "REF001",
    "Local": 1,
    "Contacto": "C00045",
    "ContactoRazonSocial": "Cliente Demo S.A.",
    "RUT": "214567890012",
    "Tributo": 0
  }
]

Observaciones

  • La API consulta únicamente asientos ya generados en el sistema.
  • Si TipoAsiento se envía vacío, la consulta incluye todos los tipos de asiento.
  • Para conocer los tipos de asiento disponibles, se debe consultar la API de configuración de tipos de asiento.

Consideraciones de integración

  • Se recomienda filtrar por rango de fechas para reducir el volumen de datos.
  • Validar previamente el ejercicio contable antes de ejecutar la consulta.
  • Usar el campo TipoAsiento cuando se requiera segmentación funcional de los movimientos.
Compartir

API Consulta de Asientos

O copia el enlace

CONTENIDO