API Movimientos Bancarios

Esta API permite consultar movimientos bancarios registrados en la empresa, incluyendo créditos, débitos, cheques emitidos y transferencias entre cuentas propias. La información corresponde a movimientos previamente generados en el sistema.

La funcionalidad asociada en el sistema se encuentra en Gestión > Comprobantes > Caja y Bancos > Movimientos Bancarios.

Casos de uso

  • Consultar movimientos bancarios por período.
  • Filtrar movimientos por cuenta, banco, moneda o concepto.
  • Controlar conciliaciones bancarias.
  • Integrar información bancaria con sistemas externos.
  • Auditar movimientos financieros.

Endpoint del servicio

Método Query

Permite obtener movimientos bancarios aplicando distintos filtros.

Requisitos previos

  • Acceso habilitado a la API.
  • Definir el período de consulta.
  • Conocer códigos de cuentas, bancos, monedas y conceptos si se requiere filtrado específico.

Parámetros de entrada

ParámetroTipoObligatorioDescripción
MesT(MM)Mes de la consulta.
AnioT(AAAA)Año de la consulta.
FechaDesdeAAAA-MM-DDNoFecha inicial.
FechaHastaAAAA-MM-DDNoFecha final.
ComprobanteTipoN(2)NoTipo de movimiento bancario.
CuentaCodigoN(3)NoCódigo de cuenta bancaria.
BancoCodigoN(3)NoCódigo del banco.
MonedaCodigoN(2)NoCódigo de moneda.
ConceptoCodigoT(10)NoCódigo de concepto.
ComprobanteCodigoN(2)NoCódigo de comprobante.
SerieT(2)NoSerie del comprobante.
NumeroT(3)NoNúmero del comprobante.
LocalCodigoN(3)NoCódigo del local.
CentroCostosCodigoT(10)NoCentro de costos.
ReferenciaT(10)NoReferencia del movimiento.
ClienteProveedorT(10)NoCódigo de cliente o proveedor asociado.
ConciliadoT(1)NoS o N.
PageN(2)Número de página.

Estructura del request

Mes
Anio
FechaDesde
FechaHasta
ComprobanteTipo
CuentaCodigo
BancoCodigo
MonedaCodigo
ConceptoCodigo
ComprobanteCodigo
Serie
Numero
LocalCodigo
CentroCostosCodigo
Referencia
ClienteProveedor
Conciliado
Page

Estructura del response

RegistroId
ComprobanteCodigo
ComprobanteAbreviacion
Fecha
Vencimiento
Serie
Numero
MonedaCodigo
MonedaSimbolo
ClienteProveedor
ProveedorNombre
CuentaCodigo
CuentaNombre
BancoCodigo
BancoNombre
LocalCodigo
CentroCostosCodigo
Referencia
ConceptoCodigo
ConceptoNombre
Descripcion
Conciliado
SubTotal
TotalIVA
Total
Notas
UsuarioCodigo
UsuarioNombre
RegistroHora
RegistroFecha

Campos devueltos

CampoDescripción
RegistroIdIdentificador del movimiento.
ComprobanteCodigoCódigo del comprobante.
FechaFecha del movimiento.
VencimientoFecha de vencimiento.
SerieSerie del comprobante.
NumeroNúmero del comprobante.
MonedaCodigoCódigo de moneda.
MonedaSimboloSímbolo de moneda.
ClienteProveedorCódigo asociado.
ProveedorNombreNombre del proveedor o cliente.
CuentaCodigoCódigo de cuenta bancaria.
CuentaNombreNombre de la cuenta.
BancoCodigoCódigo del banco.
BancoNombreNombre del banco.
ConceptoCodigoCódigo de concepto.
ConceptoNombreNombre del concepto.
DescripcionDescripción del movimiento.
ConciliadoIndica si el movimiento está conciliado.
SubTotalImporte sin impuestos.
TotalIVAImporte de IVA.
TotalImporte total del movimiento.
NotasObservaciones.
UsuarioCodigoUsuario que registró el movimiento.
UsuarioNombreNombre del usuario.
RegistroFechaFecha de registro.
RegistroHoraHora de registro.

Ejemplo de request

{
  "Mes": "03",
  "Anio": "2026",
  "FechaDesde": "",
  "FechaHasta": "",
  "CuentaCodigo": 1,
  "Page": 1
}

Ejemplo de response

[
  {
    "RegistroId": 1001,
    "Fecha": "2026-03-10",
    "CuentaCodigo": 1,
    "CuentaNombre": "Cuenta Corriente",
    "BancoNombre": "Banco Demo",
    "Total": 15000.00,
    "Conciliado": "S"
  }
]

Observaciones

  • La API consulta únicamente movimientos ya registrados.
  • El filtro Conciliado permite identificar movimientos conciliados o pendientes.
  • Se recomienda usar filtros para limitar el volumen de datos.

Consideraciones de integración

  • Paginar resultados mediante el parámetro Page.
  • Evitar consultas masivas sin filtros de fecha.
  • Persistir movimientos ya procesados para evitar reprocesamiento.
  • Validar códigos antes de realizar consultas.
Compartir

API Movimientos Bancarios

O copia el enlace

CONTENIDO