Bancos

Cuentas bancarias - Movimientos

GET/suite/erp/bancos/cuentas/:tkBancoCuenta/movimientos

Obtiene los movimientos de una cuenta bancaria con filtros de periodo, texto, situación y conciliación. La respuesta incluye Row-Count.

Parámetros

Nombre	Tipo	Descripción
`tkRazonSocial`	varchar	Identificador de la razón social que se usa para limitar la consulta.
`tkBancoCuenta`	varchar	Identificador de la cuenta bancaria.
`periodo`	int	Código del periodo; usa `0` junto con `fechaInicio` y `fechaFin` para un rango explícito.
`fechaInicio`	datetime	Fecha inicial del rango cuando `periodo` es `0`.
`fechaFin`	datetime	Fecha final del rango cuando `periodo` es `0`.
`texto`	varchar	Texto que se busca en conceptos, comentarios o entidades.
`situacion`	int	Código de situación o tipo por el que se filtra.
`conciliado`	int	Filtra movimientos conciliados (`1`) o no conciliados (`0`).
`pagina`	int	Número de página. Inicia en 1.
`cantidadRegistros`	int	Cantidad máxima de registros por página.

Respuesta

Nombre	Tipo	Descripción
`indice`	Number	Posición del registro dentro del resultado.
`tkMovimiento`	String	Identificador público del movimiento.
`tkBancoCuenta`	String	Identificador público de la cuenta bancaria.
`bancoCuenta`	String	Nombre del banco y cuenta concatenados.
`consecutivo`	Number	Valor consecutivo devuelto por la consulta.
`fechaMovimiento`	DateTime	Fecha y hora del movimiento.
`concepto`	String	Concepto del movimiento.
`abono`	Number	Importe abonado.
`cargo`	Number	Importe cargado.
`saldoActual`	Number	Saldo actual.
`moneda`	Number	Código de la moneda.
`tipoCambio`	Number	Tipo de cambio aplicado.
`comentario`	String	Comentario del movimiento.
`metaData`	String	Metadatos serializados.
`conciliado`	Number	Indica si está conciliado.
`tipoMovimiento`	String	Valor tipoMovimiento devuelto por la consulta.
`archivos`	String	Archivos asociados, serializados en JSON.
`montoRelacionado`	Number	Monto ya relacionado.
`sinCfdi`	Number	Valor sinCfdi devuelto por la consulta.
`montoDisponible`	Number	Monto disponible para relacionar.
`tkCliente`	String	Identificador de la empresa cliente.
`empresa`	String	Nombre de la empresa.
`entidad`	String	Nombre de la entidad relacionada.
`tipoEntidad`	Number	Tipo de entidad relacionada.
`tkProveedor`	String	Identificador del proveedor.
`proveedor`	String	Nombre del proveedor.
`rfcProveedor`	String	RFC del proveedor.
`tkEmpleado`	String	Identificador del empleado.
`empleado`	String	Nombre del empleado.
`rfcEmpleado`	String	RFC del empleado.
`tkFactura`	String	Identificador de la factura.
`uuid`	String	UUID fiscal de la factura.
`serie`	String	Serie de la factura.
`folio`	Number	Folio de la factura o venta.
`excluir`	Number	Indica si está excluido del flujo.
`tieneArchivos`	Number	Indica si existen archivos asociados.
`tieneCxc`	Number	Indica si tiene CxC relacionada.
`tieneCxp`	Number	Indica si tiene CxP relacionada.

Solicitud

curl --request GET \
  --url 'https://api.upnify.com/suite/erp/bancos/cuentas/00000000-0000-4000-8000-000000000011/movimientos?tkRazonSocial=00000000-0000-4000-8000-000000000010&periodo=0&fechaInicio=2026-01-01&fechaFin=2026-01-31&pagina=1&cantidadRegistros=50' \
  --header 'token: 00000000-0000-4000-8000-000000000001'const enviarSolicitud = async () => {
const response = await fetch("https://api.upnify.com/suite/erp/bancos/cuentas/00000000-0000-4000-8000-000000000011/movimientos?tkRazonSocial=00000000-0000-4000-8000-000000000010&periodo=0&fechaInicio=2026-01-01&fechaFin=2026-01-31&pagina=1&cantidadRegistros=50", {
  method: "GET",
  headers: {
    token: "00000000-0000-4000-8000-000000000001",
  }
});

const resultado = await response.json();
console.log(resultado);
};

enviarSolicitud();// Node.js 18 o posterior
const response = await fetch("https://api.upnify.com/suite/erp/bancos/cuentas/00000000-0000-4000-8000-000000000011/movimientos?tkRazonSocial=00000000-0000-4000-8000-000000000010&periodo=0&fechaInicio=2026-01-01&fechaFin=2026-01-31&pagina=1&cantidadRegistros=50", {
  method: "GET",
  headers: {
    token: "00000000-0000-4000-8000-000000000001",
  }
});

const resultado = await response.json();
console.log(resultado);import requests

response = requests.get(
    "https://api.upnify.com/suite/erp/bancos/cuentas/00000000-0000-4000-8000-000000000011/movimientos?tkRazonSocial=00000000-0000-4000-8000-000000000010&periodo=0&fechaInicio=2026-01-01&fechaFin=2026-01-31&pagina=1&cantidadRegistros=50",
    headers={"token": "00000000-0000-4000-8000-000000000001"}
)
response.raise_for_status()
resultado = response.json()package main

import (
  "encoding/json"
  "net/http"
)

func main() {
  request, err := http.NewRequest(http.MethodGet, "https://api.upnify.com/suite/erp/bancos/cuentas/00000000-0000-4000-8000-000000000011/movimientos?tkRazonSocial=00000000-0000-4000-8000-000000000010&periodo=0&fechaInicio=2026-01-01&fechaFin=2026-01-31&pagina=1&cantidadRegistros=50", nil)
  if err != nil { panic(err) }
  request.Header.Set("token", "00000000-0000-4000-8000-000000000001")
  response, err := http.DefaultClient.Do(request)
  if err != nil { panic(err) }
  defer response.Body.Close()
  var resultado any
  if err := json.NewDecoder(response.Body).Decode(&resultado); err != nil { panic(err) }
}using System.Net.Http;

using var client = new HttpClient();
using var request = new HttpRequestMessage(
    HttpMethod.Get,
    "https://api.upnify.com/suite/erp/bancos/cuentas/00000000-0000-4000-8000-000000000011/movimientos?tkRazonSocial=00000000-0000-4000-8000-000000000010&periodo=0&fechaInicio=2026-01-01&fechaFin=2026-01-31&pagina=1&cantidadRegistros=50"
);
request.Headers.Add("token", "00000000-0000-4000-8000-000000000001");
using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var resultado = await response.Content.ReadAsStringAsync();

Respuesta

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

Cuentas bancarias - Movimientos

Parámetros

Respuesta

Solicitud

Ejemplo de solicitud: Cuentas bancarias - Movimientos

Respuesta

Respuesta de Cuentas bancarias - Movimientos