(al final de este documento encontrarás un video tutorial explicando el paso a paso)


bFiskur permite decir las diferencias entre lo que tu tienes registrado en el SAT y el ERP, para eso es necesario alimentar a bFiskur con la información que tienes en tu ERP. Hay varios métodos para alimentar a bFiskur con tus datos, si tienes duda de cual debes de usar consulta con tu ejecutivo bFiskur, el te ayudará a seleccionar el método mas adecuado. Los métodos son:

  1. A través de un correo electrónico. Es un método manual que requiere el envío de correos por parte del usuario y es el más sencillo. Basta con preparar un archivo de datos y enviarlo por correo. En automático el archivo será recibido por un robot que se encargará de validar la información y añadirla a tu bóveda.
  2. Usando un conector para sincronizar tu ERP directamente con bFiskur. Es un método automático pero requiere que la base de datos del ERP sea accesible a través de un driver ODBC para que bFiskur pueda extraer los datos. Es un excelente método cuando quieres que la información se sincronice sin intervención humana.
  3. Enviar la información al Web Service de bFiskur. Es un método para enviar información de ERPs cuyo acceso directo a la base de datos está bloqueado, como lo puede ser SAP. Este método permite enviar la información ya sea usando layouts o enviando los XMLs individuales de cada CFDI.
  4. Desarrollar su propio Web Service para enviar la información a bfiskur, para más información puede consultar  este documento Especificaciones para el Desarrollo del Web Service para Integración con el ERP


Este documento se refiere específicamente al método 3: Enviar la información al Web Service de bFiskur.


Enviando Layouts a bFiskur a través de bFiskur

Los pasos para enviar la información a bFiskur mediante el web service son


Paso 1: Preparar los archivos o layouts con la información a enviar

Antes de que cualquier cosa, lo primero es preparar los layouts de datos, que no son otra cosa que archivos con información, que transmitirás a bFiskur. Lo mejor es que desarrolles un proceso, para que día con día, tu ERP genere estos layouts de manera automática. Puedes encontrar aquí las especificaciones de que debe contener cada archivo o layout:

Recuerda que los layouts o archivos puede ser en formato CSV o XLSX.


IMPORTANTE: La carga y remplazo de información en bFiskur se realiza en base al rango de fechas contenido en el layout. Si incluyes un CFDI del 1 de Enero del 2023 y un CFDI del 15 de Febrero del 2023, entonces bFiskur borrará primero toda la información existente entre esas 2 fechas y la remplazará por la nueva que viene en el archivo que estás enviando.


Paso 2: Colocarlos en un folder

Una vez que tengas los archivos deberás colocarlos en un folder cualquiera. Por ejemplo: C:\bFiskur\


No necesariamente tienes que tener todos los archivos, a lo mejor solo tienes el archivo de nomina o el de recibidos. En el paso 4 verás como enviar estos archivos de manera individual usando CURL (Paso3).


Paso 3: Descargar la herramienta CURL.EXE y colocar dicha herramienta en el mismo folder

El envío de información de los layouts se hace llamando al Web Service mediante CURL que una herramienta de línea de comandos y una biblioteca de software que se utiliza para realizar transferencias de datos a través de diferentes protocolos de red. Si usted está trabajando y haciendo el envío desde un servidor LINUX este comando ya está disponible de manera natural; pero si usted está trabajando en un servidor o maquina con sistema operativo Windows esta herramienta no viene disponible de manera natural y deberá instalar esta herramienta descargándola de la red.


Nosotros recomendamos el uso de esta versión que es de código abierto y gratuito: CURL


Los pasos para instalarla son:

En mi caso el contenido del folder es el siguiente:



La aplicación mostrada CURl.EXE será la herramienta ejecutar para hacer el envío de información por lo que debe asegurarse que debe de tener los permisos necesarios para ejecutar ese comando con el usuario de Windows que utilizará para hacer el envío


Paso 4: Preparar un BATCH que ejecute la herramienta CURL con ciertos parámetros para que se realize el envío

Ahora lo que sigue es preparar un archivo BAT que contenga el llamado a CURL.EXE y le pase como parámetros los archivos a enviar junto con la información de seguridad necesaria para que bFiskur reciba los archivos. Recuerde que un BATCH no es otra cosa que un archivo de texto sin formato, guardados con la extensión .BAT que contienen un conjunto de instrucciones.

Los pasos para crear el archivo batch son:

  • Con el bloc de notas cree un archivo vacío y grábelo con la extensión BAT en el mismo folder donde están los ZIPs conteniendo los layouts y el archivo CURL.EXE. 
  • Utilice un nombre que le permita identificar el archivo fácilmente, por ejemplo: EnviarDatos.BAT
  • Evite utilizar espacios en el nombre del archivo o caracteres especiales o vocales con acentos.
  • El contenido del .BAT sería el siguiente:


curl --insecure -o "upload.html" -F file=@[archivo] -F sheet=[hojadedatos] -F userEmail=[usuario] -F userPassword=[contraseña] https://kpionline5.bitam.com/artus/gen903/xls_loader_bfiskur/loadservice.php

Este es el contenido del archivo a generar. Haga los siguientes remplazos por información real:


[archivo] = utilice el nombre real del archivo, el nombre del archivo no debe tener espacios, debe tener extension csv o xlsx

[hojadedatos]=el nombre de la hoja conteniendo los datos, ej. Sheet1$

[usuario]=utilice aquí el valor capturado en Correo para carga ERP que definió en empresas

[Contraseña]=ponga aqui el valor capturado en Contraseña carga ERP que definió en empresas.


Un ejemplo más real sería:


curl --insecure -o "upload.html" -F file=@Recibidos2.xls -F sheet=Worksheet$ -F userEmail=xxxxxxx@xxxxx.com -F userPassword=xxxxxxxxxxx https://kpionline5.bitam.com/artus/gen903/xls_loader_bfiskur/loadservice.php

Nota: el usuario y password mostrado aquí son ficticios y no corresponde


IMPORTANTE: Al copiar el comando en el archivo BAT asegúrese que todo quede en una sola línea



Paso 5: Ejecute el BATCH desde la línea de comando y revise el resultado.


Ahora abra una linea de comando y ejecute el BAT escribiendo el nombre del archivo bat como se muestra en la siguiente imagen.



Una vez que termine la ejecución si el comando está bien armado y los archivos necesarios están presentes la información será transmitida a bFiskur. Para revisar que los archivos fueron recibidos puede dirigirse a la respectiva bóveda para verificar que la información haya sido recibida.


Conciliación de documentos XML mediante WEB Service : esta opcion su proceso de carga es muy similar , solo que en lugar de colocar el archivos xlsx o csv en la carpeta seria colocar el archivo comprimido (.zip) con los documentos xml de cada tipo de documentos divido en 2 grupo (Recibidos y Emitidos)


Colocar en cada grupo los siguientes tipos de documento:


Emitidos.zip (Documentos emitidos, Complementos de pagos Clientes, Nomina) 

Recibidos.zip (Documentos recibidos, Complementos de pagos proveedores) 



Ejemplo, para documentos emitidos:


 curl -o "response.html" -F xmlDocs=@Emitidos.zip -F TipoXML=Emitidos -F usuario=[usuario fiskur] -F password=[contraseña] https://kpionline5.bitam.com/fbm/bfiskurERPCarga/service.php 


Ejemplo, para documentos recibidos: 


curl -o "response.html" -F xmlDocs=@Recibidos.zip -F TipoXML=Recibidos -F usuario=[usuario fiskur] -F password=[contraseña] https://kpionline5.bitam.com/fbm/bfiskurERPCarga/service.php

 

Video tutorial de como cargar datos via web service