Guía de Envío de XMLs a bFiskur® via Web Service

bFiskur® le permite identificar discrepancias entre sus registros del SAT y su ERP. Para lograrlo, es necesario alimentar la plataforma con su información interna. Uno de los métodos más eficientes es el envío de archivos XML comprimidos mediante nuestro Web Service.

? Nota: Al final de este documento encontrarás un video tutorial con el paso a paso detallado.

Consideraciones Importantes antes de empezar

• Tamaño Máximo: El archivo .zip (o archivos .xls, .xlsx, .csv) no debe exceder los 20 MB. Si tiene un volumen alto de XMLs, divídalos en varios archivos zip.
• Actualización de Datos: La información se reemplaza basada en el UUID de cada XML. Si envía el mismo CFDI dos veces, prevalecerá el último recibido.
• Rango de Fechas: Al enviar información vía archivos, los datos se actualizan según el rango de fechas que contengan los XMLs procesados.

Flujo de Trabajo (Paso a Paso)

Paso 1: Preparar el archivo comprimido (.zip)

Recolecte los XMLs correspondientes a la empresa y el rango de fechas que desea conciliar. Colóquelos en una carpeta y genére un archivo .zip.

• Asegúrese de que el nombre del zip no contenga espacios ni caracteres especiales.

Paso 2: Configurar la carpeta de trabajo

Cree una carpeta local en su equipo o servidor donde centralizará el proceso.

• Ejemplo: C:\bFiskur\EnvioDatos\
• Coloque aquí el archivo .zip creado en el paso anterior.

Paso 3: Descargar e instalar CURL.EXE

El envío se realiza mediante cURL, una herramienta de línea de comandos para transferencia de datos.

• Linux: Ya está incluido de forma nativa.
• Windows: Debe descargarse manualmente.

Instrucciones para Windows:

1. Descargue la versión oficial de cURL aquí.
2. Extraiga el contenido del zip descargado.
3. Copie el archivo curl.exe (ubicado usualmente en la carpeta \bin) y péguelo en su carpeta de trabajo (C:\bFiskur\EnvioDatos\).

Paso 4: Crear el archivo de ejecución (.BAT)

Deberá crear un archivo de procesamiento por lotes (Batch) que automatice el envío.

1. Abra el Bloc de Notas.
2. Copie y pegue la siguiente línea de comando (asegúrese de que sea una sola línea):
   
   
   
   
3. Reemplace los valores entre corchetes por su información real:
   • [archivo]: Nombre de su zip (ej. facturas_marzo.zip).
   • [usuario]: Correo configurado en la sección "Empresas" de bFiskur para carga ERP.
   • [contraseña]: Contraseña configurada en la sección "Empresas" para carga ERP.
   • [repository] y [repositoryid]: Solicite estos valores a su contacto de soporte técnico.
4. Guarde el archivo con el nombre EnviarDatos.bat en la misma carpeta donde están el zip y el curl.exe.

curl --insecure -o "response.html" -F xmlDocs=@[archivo] -F TipoXML=Recibidos -F usuario=[usuario] -F password=[contraseña] -F repository=[repository] -F repositoryid=[id_repository] https://bfiskurapp.bitam.com/fbm/bfiskurERPCarga/service.php

? Solución de Problemas Comunes

Si al ejecutar el archivo .BAT no ves reflejada la información o recibes un error en el archivo response.html, revisa los siguientes puntos:

1. El comando se cierra inmediatamente

Causa: Algún parámetro está mal escrito o falta el archivo curl.exe.

Solución: Agrega la palabra PAUSE en una nueva línea al final de tu archivo .BAT. Esto mantendrá la ventana abierta para que puedas leer el mensaje de error de Windows.

2. Error: "curl no se reconoce como un comando interno o externo"

Causa: El archivo curl.exe no está en la misma carpeta que el archivo .BAT.

Solución: Asegúrate de que ambos archivos convivan en la misma ruta (ej. C:\bFiskur\).

3. El archivo response.html muestra error de autenticación

Causa: El usuario o la contraseña para la carga del ERP son incorrectos.

Solución: Verifica estos datos en la configuración de la empresa dentro de la plataforma bFiskur. Recuerda que no siempre son los mismos que usas para iniciar sesión en el portal.

4. Error por tamaño de archivo

Causa: El archivo .zip excede los 30 MB.

Solución: Divide los XMLs en dos o más carpetas y genera archivos .zip independientes (ej. parte1.zip y parte2.zip). Deberás ejecutar el envío por cada archivo.

5. Error de conexión o "Timeout"

Causa: Restricciones de red o firewall de la empresa.

Solución: Asegúrate de tener permisos para realizar peticiones de salida a la URL: https://bfiskurapp.bitam.com. Si estás en un servidor corporativo, consulta con tu equipo de TI.

6. Caracteres especiales en el nombre del archivo

Causa: El uso de espacios, acentos o "ñ" en el nombre del .zip.

Solución: Renombra tu archivo a algo simple como carga_01.zip y actualiza el nombre dentro del archivo .BAT.