Introducción
Las API bancarias son servicios ofrecidos por estas entidades bancarias para automatizar consultas (saldos, movimientos bancarios) y autorizaciones (transferencias, e-cheques) para ser realizarlos desde programas o scripts.
Estos servidores suelen tener varias capas de seguridad y métodos complejos. MisDatos (por medio de su instalador WSAFIPFE que tiene una amplia compatibilidad demostrada con decenas de lenguajes y versiones de windows) encapsula esa complejidad en clases con métodos y propiedades estándar del mismo modo que la clase WSAFIFPE.factura encapsula los web service electrónicos de ARCA EX-AFIP.
Como empezar
Para empezar a implementar servicios bancarios primero debe tener en cuenta la guia básica de como empezar el instalador WSAFIPFE y la guia de como empezar técnicamente.
Como empezar técnicamente
Teniendo claro los conceptos generales de como empezar con la interfaz WSAFIPFE del párrafo anterior la interfaz para servicios bancarias funciona bajo los mismos principios teniendo en cuenta las particularidades de las API de automatización bancarias:
Se usa la clase WSAFIPFE.misdatos(y el OCX MisDatosX) incluidos en el instalador WSAFIPFE.
Esta clase tiene un método iniciar con 2 argumentos que generalmente suelen ser el identificador y la clase (o certificado) con el que conectaremos al servidor bancarios (prueba o producción).
Y como figura en la guia toda la operatoria se hace únicamente con 3 acciones básicas: cargando el valor de una propiedad, llamando a un método (con o sin argumentos) o leyendo el valor de una propiedad. Con estas 3 acciones se replica cualquier API o servidor financiero.
Entres los métodos hay 3 básicos que son: objeto.apiCargarPropiedad(...), apiEjecutar(...), apiLeerPropiedad(..). Que básicamente permiten cargar los datos o valores o campos necesarios para ejecutar un método de la interfaz bancaria (por ejemplo el numero de cuenta a consultar). Para luego ejecutar el método propiamente dicha que realiza esa accion y luego ejecutar el método que lee los resultados devueltos por servidor.
Y como es habitual se agregan propiedades comunes como: ultimomensajeerror, archivoxmlenviado, archivoxmlrecibido, etc.
Como es habitual todos los servicios o API bancarios suelen tener un servidor de prueba y uno real o de producción. En el caso de la clase MisDatos aun para el de prueba se debe tener con un archivo de licencia para la interfaz WSAFIPFE que incluya el servicio a usar, pero puede ser un archivo provisorio por lo que puede implementar toda la interfaz antes de compra el servicio.
Y por ultimo todos estos servicios o API de finanzas requiere algún tipo de certificado o clave privada o credencial (ya sea para el modo prueba u homologación, como para el modo real o producción) que debe ser tramitado según cada servidor y debe ser usado para que la interfaz MisDatos pueda lograr la conexión
Teniendo en cuenta esta guia general luego debe seleccionar el proveedor o banco a conectar y tener en cuenta las características propias de cada proveedor (métodos, campos, etc.) que suelen estar en la documentación oficial de cada API o banco y cuya estructura la interfaz WSAFIFPE.misdatos replica tal cual.