Conectar Fishbowl: recibir pedidos de venta y de compra, consultar inventario

Apunte Integration a la dirección de su propio Fishbowl Server, inicie sesión con un usuario y contraseña de Fishbowl, apruebe la app de integración una vez en Settings → Integrated Apps en el cliente de Fishbowl, y luego pruebe, mapee y active.

El conector de Fishbowl se conecta al Fishbowl Server que usted mismo opera y trae pedidos de venta y pedidos de compra de Fishbowl Advanced a este sistema, y puede consultar el inventario por número de parte. Ese es todo el alcance: no trae ni envía clientes, y no devuelve inventario ni ningún otro registro a Fishbowl. Como el servidor es suyo, debe ser alcanzable desde este sistema: un servidor que solo responde dentro de su red local, sin ruta pública ni VPN hasta él, no se puede conectar.

Requisitos previos#

• Un Fishbowl Server (Fishbowl Advanced) en funcionamiento cuya dirección sea alcanzable desde este sistema. La dirección del servidor debe ser alcanzable por una ruta pública o una VPN: si la dirección solo funciona dentro de su red local, corrija primero la ruta; ningún conjunto de credenciales conectará a través de una ruta cerrada.
• La dirección web del servidor y el puerto, por ejemplo http://192.168.1.10:80. El puerto 80 es el puerto web habitual; si el 80 ya está en uso en esa máquina, Fishbowl usa 2456 en su lugar: confirme en qué puerto responde su servidor.
• Un nombre de usuario y una contraseña de Fishbowl para iniciar sesión. Use una cuenta de integración dedicada en Fishbowl para esta conexión, para que sus inicios de sesión sean fáciles de reconocer y su contraseña se gestione aparte de las cuentas personales.
• Acceso al cliente de Fishbowl, para que tras el primer inicio de sesión pueda abrir Settings → Integrated Apps y aprobar esta app de integración. Sin esa única aprobación, la prueba responde 403 por correctos que sean los demás valores.

Obtener credenciales#

1. No hay portal en la nube ni clave que generar para Fishbowl. Las credenciales son simplemente el usuario y la contraseña de Fishbowl de la cuenta con la que la conexión inicia sesión: cree primero un usuario de integración dedicado en Fishbowl si aún no tiene uno.
2. Anote la dirección del Fishbowl Server en la forma que pide el paso de completar, por ejemplo http://192.168.1.10:80: la misma dirección y puerto en los que el servidor responde, con 2456 en lugar de 80 si el puerto 80 ya está en uso en esa máquina.
3. Decida ahora el nombre de la app de integración: Docklify Integration, salvo que ya use otro nombre. Ese nombre es el que aparece en el cliente de Fishbowl bajo Settings → Integrated Apps tras el primer inicio de sesión, y es la entrada que aprobará allí.
4. Deje el App ID de lado en la primera configuración. Un App ID solo existe si un administrador asigna un ID numérico a la app aprobada en Integrated Apps: si eso aún no ha ocurrido, no hay nada que buscar todavía.

Completar en Integration#

1. Abra Integration → Marketplace → Fishbowl → Nueva conexión.
2. server_url, obligatorio, Fishbowl server URL: la dirección de su Fishbowl Server, por ejemplo http://192.168.1.10:80. Use el puerto 2456 en lugar de 80 si el puerto 80 está ocupado en esa máquina. La dirección debe ser alcanzable desde este sistema por una ruta pública o VPN.
3. username, obligatorio, Fishbowl username: el nombre de usuario de la cuenta de Fishbowl para la integración, idealmente una cuenta de integración dedicada.
4. password, obligatorio, Fishbowl password: la contraseña de esa misma cuenta de Fishbowl. Es un campo de tipo contraseña y se guarda como secreto.
5. app_name, obligatorio, Integration app name: el nombre decidido en el paso de credenciales, por ejemplo Docklify Integration. Tras el primer inicio de sesión, este nombre aparece en el cliente de Fishbowl bajo Settings → Integrated Apps, donde se aprueba.
6. app_id, opcional, App ID: déjelo vacío en la primera configuración. Complételo solo si un administrador ha asignado un ID numérico a la app aprobada en Integrated Apps y se lo ha entregado.
7. Después haga el paso de aprobación en el orden correcto: guarde la conexión y ejecute Probar la conexión una vez para que el primer inicio de sesión registre la app, abra el cliente de Fishbowl → Settings → Integrated Apps, encuentre la entrada con su app_name y apruébela, y vuelva a probar. La aprobación se hace en el cliente de Fishbowl, no en Integration.

Probar la conexión#

Haga clic en Probar la conexión. La prueba realiza un inicio de sesión real: envía su appName, appId, username y password a POST {server_url}/api/login en su Fishbowl Server, y un token de inicio de sesión devuelto cuenta como aprobado; el resultado muestra qué servidor respondió. Justo después de un inicio correcto, la prueba vuelve a cerrar la sesión. Si falta server_url, la prueba se detiene con MISSING_SERVER_URL; si falta otro campo obligatorio, se detiene con el error de campo faltante correspondiente. Un 401 significa que el usuario o la contraseña fueron rechazados. Un 403 se devuelve como MISSING_SCOPE y significa que la app de integración puede no estar aprobada aún en Settings → Integrated Apps. El inicio de sesión agota el tiempo a los 12 segundos.

Mapping / elegir plantilla#

Elija el mapping estándar de Fishbowl. Cubre pedidos de venta y pedidos de compra en su forma estándar de Fishbowl, y consultas de inventario por número de parte. Tras aprobar la prueba, ejecute una extracción y compare un pedido de venta real lado a lado (número, líneas y cantidades), haga lo mismo con un pedido de compra y contraste el inventario de un número de parte con lo que muestra Fishbowl, antes de activar.

Activar#

Tras activar, la conexión inicia sesión en su Fishbowl Server según la frecuencia definida, trae pedidos de venta y pedidos de compra a este sistema, y lee el inventario por número de parte al consultarlo. Vigile las primeras extracciones en Runs / Logs y compárelas con Fishbowl antes de dejar la conexión sin supervisión; y si la dirección del servidor o la ruta cambian después, actualice server_url y pruebe de nuevo.

Lo que esta conexión no hace: no trae ni envía clientes, y no devuelve inventario, pedidos ni ningún otro registro a Fishbowl. Fishbowl sigue siendo el lugar donde esos registros se gestionan; esta conexión lee pedidos e inventario desde él.

Preguntas frecuentes#

La prueba falla con 403 / MISSING_SCOPE: la app de integración puede no estar aprobada

En esta conexión, 403 tiene un significado específico: la app de integración puede no estar aprobada en Settings → Integrated Apps en el cliente de Fishbowl. El servidor recibió el inicio de sesión, pero la app indicada por su app_name aún no ha sido aprobada, así que el inicio no puede continuar.

Abra el cliente de Fishbowl → Settings → Integrated Apps, encuentre la entrada con el mismo nombre que su app_name y apruébela. Después vuelva a ejecutar Probar la conexión en Integration con los mismos valores: ningún otro campo necesita cambiar.

La prueba falla con 401: usuario o contraseña rechazados

El servidor respondió y la comprobación de la app pasó, pero el propio inicio de sesión en Fishbowl fue rechazado: el par de usuario y contraseña no coincide con una cuenta en ese servidor, o la contraseña se escribió con algo de más o de menos.

Inicie sesión usted mismo en el cliente de Fishbowl con el mismo usuario y contraseña para confirmar que funcionan, preferiblemente con la cuenta de integración dedicada. Después vuelva a introducir username y a pegar password en Integration y pruebe de nuevo.

La prueba se detiene con MISSING_SERVER_URL u otro error de campo faltante

Un campo obligatorio está vacío, así que no se intentó ningún inicio de sesión. MISSING_SERVER_URL significa específicamente que server_url está vacío; los demás errores de campo faltante nombran el campo vacío entre username, password y app_name. app_id es opcional y nunca causa esta detención.

Complete el campo indicado según el paso de completar en Integration (server_url con la dirección completa del servidor, incluido su puerto), deje app_id vacío salvo que un administrador haya asignado uno, guarde y pruebe de nuevo.

La prueba agota el tiempo: el servidor no es alcanzable en absoluto

El inicio de sesión no recibió respuesta en 12 segundos. Con un servidor autoalojado, la razón habitual es la alcanzabilidad: la dirección en server_url solo responde dentro de su red local y no hay ruta pública ni VPN desde este sistema hasta ella, o el puerto de la dirección no es el puerto en el que el servidor responde: 80 y 2456 son los dos a revisar.

Primero confirme que el Fishbowl Server está en funcionamiento y anote la dirección y el puerto exactos en los que responde. Después haga que esa dirección sea alcanzable desde fuera de su red local por una ruta pública o VPN, actualice server_url para que coincida exactamente y pruebe de nuevo. Cambiar el usuario o la contraseña no corregirá un tiempo de espera agotado.

¿Dónde encuentro el App ID antes de la primera configuración?

En ninguna parte: en una primera configuración normalmente aún no existe. Un App ID es un ID numérico que un administrador puede asignar a la app después de que haya sido aprobada en Settings → Integrated Apps, así que buscar uno antes de la aprobación es buscar algo que aún no se ha creado.

Deje app_id vacío y termine primero la configuración y la aprobación. Solo si un administrador asigna después un App ID y se lo entrega, edite la conexión, complete app_id con ese número, guarde y pruebe de nuevo.

Conectado, pero no llegan clientes y nada se escribe de vuelta

Ese es el límite de esta conexión, no un fallo: trae pedidos de venta y pedidos de compra y lee el inventario por número de parte. Los registros de clientes no forman parte de ella en ninguna dirección, y ningún registro de ningún tipo se devuelve a Fishbowl.

Siga gestionando clientes y cambios de stock en el propio Fishbowl. Use esta conexión para el flujo de pedidos: revise un pedido de venta o de compra extraído en Runs / Logs para confirmar que la conexión hace su parte.