Upnify Documentación API
ERP · /suite/erp/bancos/buscar/movimientos

Bancos

Buscar movimientos bancarios

GET/suite/erp/bancos/buscar/movimientos

Busca movimientos bancarios por razón social, cuenta, periodo, texto, RFC, monto y conciliación. La respuesta incluye Row-Count.

Rutas alternativas

  • /suite/erp/bancos/buscar/movimientos

Parámetros

NombreTipoValidaciónDescripción
tkRazonSocialStringRequeridoIdentificador de la razón social que se usa para limitar la consulta.
tkBancoCuentaStringIdentificador de la cuenta bancaria.
fechaDateTimeFecha del movimiento que se consulta.
periodoIntegerCódigo del periodo; usa 0 junto con fechaInicio y fechaFin para un rango explícito.
fechaInicioDateTimeFecha inicial del rango cuando periodo es 0.
fechaFinDateTimeFecha final del rango cuando periodo es 0.
textoStringTexto que se busca en conceptos, comentarios o entidades.
situacionIntegerCódigo de situación o tipo por el que se filtra.
rfcStringRFC por el que se filtra el proveedor, empleado o empresa.
montoNumberMonto por el que se filtra o que se registra.
conciliadoIntegerFiltra movimientos conciliados (1) o no conciliados (0).
paginaIntegerNúmero de página. Inicia en 1.
cantidadRegistrosIntegerCantidad máxima de registros por página.

Respuesta

NombreTipoDescripción
indiceNumberPosición del registro dentro del resultado.
tkMovimientoStringIdentificador público del movimiento.
fechaMovimientoDateTimeFecha y hora del movimiento.
tkBancoCuentaStringIdentificador público de la cuenta bancaria.
bancoCuentaStringNombre del banco y cuenta concatenados.
consecutivoNumberValor consecutivo devuelto por la consulta.
tipoMovimientoStringValor tipoMovimiento devuelto por la consulta.
conceptoStringConcepto del movimiento.
abonoNumberImporte abonado.
cargoNumberImporte cargado.
saldoActualNumberSaldo actual.
montoRelacionadoNumberMonto ya relacionado.
sinCfdiNumberValor sinCfdi devuelto por la consulta.
montoDisponibleNumberMonto disponible para relacionar.
monedaNumberCódigo de la moneda.
tipoCambioNumberTipo de cambio aplicado.
comentarioStringComentario del movimiento.
conciliadoNumberIndica si está conciliado.
tkClienteStringIdentificador de la empresa cliente.
empresaStringNombre de la empresa.
proveedorStringNombre del proveedor.
rfcProveedorStringRFC del proveedor.
empleadoStringNombre del empleado.
rfcEmpleadoStringRFC del empleado.
tkFacturaStringIdentificador de la factura.
uuidStringUUID fiscal de la factura.
serieStringSerie de la factura.
folioNumberFolio de la factura o venta.
entidadStringNombre de la entidad relacionada.
excluirNumberIndica si está excluido del flujo.
tipoEntidadNumberTipo de entidad relacionada.

Solicitud

Ejemplo de solicitud: Buscar movimientos bancarios

curl --request GET \
  --url 'https://api.upnify.com/suite/erp/bancos/buscar/movimientos?tkRazonSocial=00000000-0000-4000-8000-000000000010&texto=movimiento&pagina=1&cantidadRegistros=50' \
  --header 'token: 00000000-0000-4000-8000-000000000001'

Respuesta

Respuesta de Buscar movimientos bancarios

JSON
[
  {
    "indice": 1,
    "tkMovimiento": "00000000-0000-4000-8000-000000000012",
    "fechaMovimiento": "2026-01-15T12:00:00",
    "tkBancoCuenta": "00000000-0000-4000-8000-000000000011",
    "bancoCuenta": null,
    "consecutivo": 12,
    "tipoMovimiento": null,
    "concepto": "Movimiento bancario de ejemplo",
    "abono": 1500.5,
    "cargo": 0,
    "saldoActual": 12500.5,
    "montoRelacionado": 500,
    "sinCfdi": 0,
    "montoDisponible": 1000.5,
    "moneda": "MXN",
    "tipoCambio": 1,
    "comentario": "Comentario de ejemplo",
    "conciliado": 1,
    "tkCliente": "00000000-0000-4000-8000-000000000015",
    "empresa": "Empresa de ejemplo",
    "proveedor": "Proveedor de ejemplo",
    "rfcProveedor": "AAA010101AAA",
    "empleado": "Usuario de ejemplo",
    "rfcEmpleado": "BBB010101BBB",
    "tkFactura": "00000000-0000-4000-8000-000000000020",
    "uuid": "00000000-0000-4000-8000-000000000021",
    "serie": "A",
    "folio": 1001,
    "entidad": "Empresa de ejemplo",
    "excluir": 0,
    "tipoEntidad": 1
  }
]