Quickbooks Online Edition adotou um novo protocolo de integração. Os usuários do Service Billing e do Quickbook Online Edition podem usar os seguintes procedimentos para atualizar a integração ao novo protocolo.
Aviso: A partir de 15 de maio de 2014, o Quickbooks Online Edition não aceitará mais o protocolo antigo. A integração que utiliza o novo protocolo requer um VSA com o patch de versão 6.5.0.12 ou posterior e um VSA v7.0.
Como se conectar ao Quickbooks Online Edition - Para usuários existentes
Não há mais uma chave de conexão como havia na API de integração antiga. Em vez do usuário se conectar pela primeira vez, ele vai até o processo de autorização do OAuth para obter um token de acesso de serviços da Web do Intuit. O VSA armazena com segurança o token de acesso para futuro acesso aos dados da conta do Quickbooks.
Para atualizar a integração:
Faça logon no VSA.
Navegue até o módulo Service Billing.
Selecione Integração contábil > Configuração
Um novo campo, Conexão autorizada, foi adicionado a esta página. O valor para este campo inicialmente será No. Qualquer tentativa de acesso aos dados do Quickbooks Online falhará. Uma mensagem indicará que não há credenciais de conexão disponíveis no momento.
Clique no botão Editar. A caixa de diálogo Editar integração contábil é exibida.
Aceite Quickbooks como Fornecedor contábil.
Aceite Online Edition como Tipo de conexão.
Clique no botão Conectar-se ao Quickbooks. Uma janela é aberta, exibindo o sinal Intuit Quickbooks Online Edition na página.
Insira o nome de usuário e a senha para a conta do Quickbooks Online Edition que deseja integrar com o Service Billing.
Clique no botão Conectar-se. A janela exibe a página Autorização de conta do Quickbooks Online Edition.
Verifique se a conta do Quickbooks exibida é a correta. Se o usuário tiver diversas contas do Quickbooks Online Edition, selecione uma conta a ser integrada com o Service Desk. Não há compatibilidade para diversas contas.
Clique no botão Autorizar. Uma mensagem informando que a conexão foi bem-sucedida é exibida.
Feche a janela.
As configurações para as caixas de seleção Usar classes e Permitir substituições não precisam ser alteradas.
Clique no ícone Salvar. A caixa de diálogo Editar integração contábil é fechada.
O usuário está conectado agora à conta do Quickbooks Online Edition através do Service Billing.
Todas as associações entre objetos do VSA e do Quickbooks Online Edition — clientes, classes, prazos etc — devem funcionar juntas agora, exatamente como era antes.
O usuário não precisa solicitar autorização novamente caso queira se desconectar. Consulte Como se desconectar do Quickbooks Online Edition abaixo.
Como opção, teste a conexão ao clicar no botão Testar no painel de visualização principal.
Uma mensagem indicando o status do teste de conexão é exibida.
Além disso, o painel de visualização principal da página Integração contábil > Configuração deve exibir Yes na configuração Conexão autorizada.
Revise a integração do imposto sobre vendas em Integração do imposto sobre vendas com Quickbooks Online Edition abaixo.
Nota: Os registros de endereço de clientes do Quickbooks são atualizados apenas no Quickbooks quando um novo registro do cliente doService Billing for criado. A partir daí, as informações de endereço do cliente devem ser mantidas nos dois sistemas separadamente.
Como se conectar ao Quickbooks Online Edition - Para novos usuários
O Quickbooks Online Edition utiliza um protocolo Oauth para integração tripla entre o usuário, o Service Billing e a conta do Quickbooks Online Edition do usuário.
Para fazer essa conexão:
Registre-se no QuickBooks Online ®, caso você ainda não o tenha feito.
Faça logon no VSA.
Navegue até o módulo Service Billing.
Selecione Integração contábil > Configuração
Revise a Configuração das tabelas de suporte do Service Billing usadas para integração com um pacote de conta externa.
Clique no botão Editar. A caixa de diálogo Editar integração contábil é exibida.
Selecione Quickbooks como Fornecedor contábil.
Selecione Online Edition como Tipo de conexão.
Clique no botão Conectar-se ao Quickbooks. Uma janela é aberta, exibindo o sinal Intuit Quickbooks Online Edition na página.
Insira o nome de usuário e a senha para a conta do Quickbooks Online Edition que deseja integrar com o Service Billing.
Clique no botão Conectar-se. A janela exibe a página Autorização de conta do Quickbooks Online Edition.
Verifique se a conta do Quickbooks exibida é a correta. Se o usuário tiver diversas contas do Quickbooks Online Edition, selecione uma conta a ser integrada com o Service Desk. Não há compatibilidade para diversas contas.
Clique no botão Autorizar. Uma mensagem informando que a conexão foi bem-sucedida é exibida.
Feche a janela.
Como opção, marque as caixas de seleção Usar classes e Permitir substituições. Consulte Configuração para obter uma descrição dessas caixas de seleção. É possível alterar essas caixas de seleção posteriormente, se desejar.
Clique no ícone Salvar. A caixa de diálogo Editar integração contábil é fechada.
O usuário está conectado agora à conta do Quickbooks Online Edition através do Service Billing.
O usuário não precisa solicitar autorização novamente caso queira se desconectar. Consulte Como se desconectar do Quickbooks Online Edition abaixo.
Como opção, teste a conexão ao clicar no botão Testar no painel de visualização principal.
Uma mensagem indicando o status do teste de conexão é exibida.
Além disso, o painel de visualização principal da página Integração contábil > Configuração deve exibir Yes na configuração Conexão autorizada.
Revise a integração do imposto sobre vendas em Integração do imposto sobre vendas com Quickbooks Online Edition abaixo.
Nota: Os registros de endereço de clientes do Quickbooks são atualizados apenas no Quickbooks quando um novo registro do cliente doService Billing for criado. A partir daí, as informações de endereço do cliente devem ser mantidas nos dois sistemas separadamente.
Como se desconectar do Quickbooks Online Edition
Um usuário pode desconectar temporariamente o Service Billing da sua conta do Quickbooks Online Edition sem alterar qualquer ajuste de conta externa.
Faça logon no VSA.
Navegue até o módulo Service Billing.
Selecione Integração contábil > Configuração
Clique no botão Editar no painel de visualização principal. A caixa de diálogo Editar integração contábil é exibida. Quando conectado à conta do Quickbooks,. o botão Desconectar estará ativado.
Clique no botão Desconectar-se do QB Online.
Confirme que você deseja se desconectar.
Clique em OK na caixa de mensagem Desconexão bem-sucedida.
Clique em Salvar para sair da caixa de diálogo Editar integração contábil.
O Service Billing agora está desconectado da conta do Quickbooks, mas todas as configurações de contabilidade externa permanecem inalteradas. Note que qualquer tentativa de exportar clientes ou faturas para a conta do Quickbooks, assim como qualquer tentativa de recuperar classe, cliente, prazos ou outras informações do Quickbooks, apresentará falha com uma mensagem indicando que a conta não está conectada.
Como alterar o sistema de contabilidade externa no Quickbooks Online Edition
Depois de conectado ao Quickbooks Online Edition como sistema de contabilidade externa, os seletores suspensos Fornecedor contábil e Tipo de conexão serão desativados. Se desejar parar completamente de usar o Quickbooks Online Edition como sistema de contabilidade externa, você deve primeiro se desconectar do Quickbooks Online Edition conforme descrito em Como desconectar-se do Quickbooks Online Edition. Depois que estiver desconectado, os menus suspensos serão ativados novamente para selecionar outro sistema. Se você não desejar mais usar qualquer outro sistema de contabilidade externa, selecione None como Fornecedor contábil e clique no botão Salvar.
Integração de imposto sobre as vendas com o Quickbooks Online Edition
Devido a algumas mudanças no novo protocolo de integração do QBOE API v3, algumas etapas adicionais poderão ser necessárias para incluir corretamente o imposto sobre as vendas em faturas exportadas do Service Billing para o Quickbooks Online Edition. O Service Billing requer que o imposto sobre as vendas padrão seja configurado nos usuários da conta do Quickbooks Online com um valor que corresponda ao valor de imposto sobre as vendas padrão no Service Billing.
Siga as instruções fornecidas pelo Quickbooks para definir o imposto sobre as vendas padrão no Quickbooks Online Edition.
Siga as instruções para definir o imposto sobre as vendas padrão no Service Billing.
Verifique se os dois valores de imposto sobre as vendas coincidem. Por exemplo, se o imposto sobre as vendas for 8,25, verifique se ambos os valores são 8,25.
Isso não evita que um usuário configure o imposto sobre as vendas específico ao cliente, um recurso já compatível no Service Billing. O imposto sobre as vendas ainda será calculado usando a taxa de substituição para o cliente, e o valor de imposto sobre as vendas será enviado para o Quickbooks na fatura. O usuário pode precisar revisar a fatura na sua conta do Quickbooks e verificar se o código de imposto sobre as vendas para a fatura está correto. Se não tiver, os valores de fatura serão corretos, mas o total será sinalizado se o código de imposto selecionado no Quickbooks não corresponder ao valor calculado.
