Conectar o Fishbowl: receber pedidos de venda e de compra, consultar estoque

Aponte o Integration para o endereço do seu próprio Fishbowl Server, entre com um usuário e senha do Fishbowl, aprove o app de integração uma vez em Settings → Integrated Apps no cliente do Fishbowl, e depois teste, mapeie e ative.

O conector do Fishbowl se conecta ao Fishbowl Server que você mesmo opera e traz pedidos de venda e pedidos de compra do Fishbowl Advanced para este sistema, e pode consultar o estoque por número de peça. Esse é todo o escopo: não traz nem envia clientes, e não devolve estoque nem nenhum outro registro ao Fishbowl. Como o servidor é seu, ele precisa ser alcançável a partir deste sistema: um servidor que só responde dentro da sua rede local, sem rota pública ou VPN até ele, não pode ser conectado.

Pré-requisitos#

• Um Fishbowl Server (Fishbowl Advanced) em funcionamento cujo endereço seja alcançável a partir deste sistema. O endereço do servidor precisa ser alcançável por uma rota pública ou uma VPN: se o endereço só funciona dentro da sua rede local, corrija a rota primeiro; nenhum conjunto de credenciais vai conectar por uma rota fechada.
• O endereço web do servidor e a porta, por exemplo http://192.168.1.10:80. A porta 80 é a porta web usual; se a 80 já estiver em uso naquela máquina, o Fishbowl usa 2456: confirme em qual porta seu servidor responde.
• Um usuário e uma senha do Fishbowl para entrar. Use uma conta de integração dedicada no Fishbowl para esta conexão, para que seus logins sejam fáceis de reconhecer e sua senha seja gerenciada separadamente das contas pessoais.
• Acesso ao cliente do Fishbowl, para que após o primeiro login você possa abrir Settings → Integrated Apps e aprovar este app de integração. Sem essa única aprovação, o teste responde 403 por mais corretos que estejam os demais valores.

Obter credenciais#

1. Não há portal na nuvem nem chave para gerar no Fishbowl. As credenciais são simplesmente o usuário e a senha do Fishbowl da conta com a qual a conexão entra: crie primeiro um usuário de integração dedicado no Fishbowl se ainda não tiver um.
2. Anote o endereço do Fishbowl Server no formato que a etapa de preencher pede, por exemplo http://192.168.1.10:80: o mesmo endereço e porta em que o servidor responde, com 2456 em vez de 80 se a porta 80 já estiver em uso naquela máquina.
3. Decida agora o nome do app de integração: Docklify Integration, a menos que você já use outro nome. Esse nome é o que aparece no cliente do Fishbowl em Settings → Integrated Apps após o primeiro login, e é a entrada que você vai aprovar ali.
4. Deixe o App ID de lado na primeira configuração. Um App ID só existe se um administrador atribuir um ID numérico ao app aprovado em Integrated Apps: se isso ainda não aconteceu, não há nada para procurar ainda.

Preencher no Integration#

1. Abra Integration → Marketplace → Fishbowl → Nova conexão.
2. server_url, obrigatório, Fishbowl server URL: o endereço do seu Fishbowl Server, por exemplo http://192.168.1.10:80. Use a porta 2456 em vez de 80 se a porta 80 estiver ocupada naquela máquina. O endereço precisa ser alcançável a partir deste sistema por uma rota pública ou VPN.
3. username, obrigatório, Fishbowl username: o usuário da conta do Fishbowl para a integração, idealmente uma conta de integração dedicada.
4. password, obrigatório, Fishbowl password: a senha dessa mesma conta do Fishbowl. É um campo do tipo senha e é guardado como segredo.
5. app_name, obrigatório, Integration app name: o nome decidido na etapa de credenciais, por exemplo Docklify Integration. Após o primeiro login, esse nome aparece no cliente do Fishbowl em Settings → Integrated Apps, onde você o aprova.
6. app_id, opcional, App ID: deixe vazio na primeira configuração. Preencha apenas se um administrador tiver atribuído um ID numérico ao app aprovado em Integrated Apps e o tiver passado a você.
7. Depois faça a etapa de aprovação na ordem certa: salve a conexão e execute Testar a conexão uma vez para que o primeiro login registre o app, abra o cliente do Fishbowl → Settings → Integrated Apps, encontre a entrada com seu app_name e aprove, e volte a testar. A aprovação é feita no cliente do Fishbowl, não no Integration.

Testar a conexão#

Clique em Testar a conexão. O teste realiza um login real: envia seu appName, appId, username e password para POST {server_url}/api/login no seu Fishbowl Server, e um token de login retornado conta como aprovado; o resultado mostra qual servidor respondeu. Logo após um login bem-sucedido, o teste sai novamente. Se server_url estiver ausente, o teste para com MISSING_SERVER_URL; se outro campo obrigatório estiver ausente, para com o erro de campo ausente correspondente. Um 401 significa que o usuário ou a senha foi recusado. Um 403 é retornado como MISSING_SCOPE e significa que o app de integração pode ainda não estar aprovado em Settings → Integrated Apps. O login expira após 12 segundos.

Mapping / escolher modelo#

Escolha o mapping padrão do Fishbowl. Ele cobre pedidos de venda e pedidos de compra na sua forma padrão do Fishbowl, e consultas de estoque por número de peça. Depois que o teste aprovar, execute uma extração e confira um pedido de venda real lado a lado (número, linhas e quantidades), faça o mesmo com um pedido de compra e compare o estoque de um número de peça com o que o Fishbowl mostra, antes de ativar.

Ativar#

Após ativar, a conexão entra no seu Fishbowl Server na frequência definida, traz pedidos de venda e pedidos de compra para este sistema, e lê o estoque por número de peça ao consultá-lo. Acompanhe as primeiras extrações em Runs / Logs e compare com o Fishbowl antes de deixar a conexão sem supervisão; e se o endereço do servidor ou a rota mudar depois, atualize server_url e teste novamente.

O que esta conexão não faz: não traz nem envia clientes, e não devolve estoque, pedidos nem nenhum outro registro ao Fishbowl. O Fishbowl continua sendo o lugar onde esses registros são gerenciados; esta conexão lê pedidos e estoque dele.

Perguntas frequentes#

O teste falha com 403 / MISSING_SCOPE: o app de integração pode não estar aprovado

Nesta conexão, 403 tem um significado específico: o app de integração pode não estar aprovado em Settings → Integrated Apps no cliente do Fishbowl. O servidor recebeu o login, mas o app indicado pelo seu app_name ainda não foi aprovado, então o login não pode continuar.

Abra o cliente do Fishbowl → Settings → Integrated Apps, encontre a entrada com o mesmo nome do seu app_name e aprove. Depois execute Testar a conexão novamente no Integration com os mesmos valores: nenhum outro campo precisa mudar.

O teste falha com 401: usuário ou senha recusados

O servidor respondeu e a verificação do app passou, mas o próprio login no Fishbowl foi recusado: o par de usuário e senha não corresponde a uma conta naquele servidor, ou a senha foi digitada com algo a mais ou a menos.

Entre você mesmo no cliente do Fishbowl com o mesmo usuário e senha para confirmar que funcionam, preferivelmente com a conta de integração dedicada. Depois reinsira username e cole password novamente no Integration e teste de novo.

O teste para com MISSING_SERVER_URL ou outro erro de campo ausente

Um campo obrigatório está vazio, então nenhum login foi tentado. MISSING_SERVER_URL significa especificamente que server_url está vazio; os outros erros de campo ausente nomeiam o campo vazio entre username, password e app_name. app_id é opcional e nunca causa esta parada.

Preencha o campo indicado conforme a etapa de preencher no Integration (server_url com o endereço completo do servidor, incluindo a porta), deixe app_id vazio a menos que um administrador tenha atribuído um, salve e teste novamente.

O teste expira: o servidor não é alcançável de jeito nenhum

O login não recebeu resposta em 12 segundos. Com um servidor auto-hospedado, o motivo usual é a alcançabilidade: o endereço em server_url só responde dentro da sua rede local e não há rota pública ou VPN deste sistema até ele, ou a porta do endereço não é a porta em que o servidor responde: 80 e 2456 são as duas a verificar.

Primeiro confirme que o Fishbowl Server está em funcionamento e anote o endereço e a porta exatos em que ele responde. Depois torne esse endereço alcançável de fora da sua rede local por uma rota pública ou VPN, atualize server_url para corresponder exatamente e teste novamente. Mudar o usuário ou a senha não vai corrigir um tempo esgotado.

Onde encontro o App ID antes da primeira configuração?

Em lugar nenhum: numa primeira configuração ele normalmente ainda não existe. Um App ID é um ID numérico que um administrador pode atribuir ao app depois que ele foi aprovado em Settings → Integrated Apps, então procurar um antes da aprovação é procurar algo que ainda não foi criado.

Deixe app_id vazio e conclua primeiro a configuração e a aprovação. Só se um administrador atribuir depois um App ID e o passar a você, edite a conexão, preencha app_id com esse número, salve e teste novamente.

Conectado, mas nenhum cliente chega e nada é escrito de volta

Esse é o limite desta conexão, não uma falha: ela traz pedidos de venda e pedidos de compra e lê o estoque por número de peça. Registros de clientes não fazem parte dela em nenhuma direção, e nenhum registro de qualquer tipo é devolvido ao Fishbowl.

Continue gerenciando clientes e alterações de estoque no próprio Fishbowl. Use esta conexão para o fluxo de pedidos: confira um pedido de venda ou de compra extraído em Runs / Logs para confirmar que a conexão está fazendo a parte dela.