Driver ODBC do Quickbooks

Primeiros passos

Instalando o driver ODBC do QuickBooks

1. Faça o download do driver ODBC do QuickBooks para sua plataforma Windows. (Registro obrigatório.)
2. Instale e licencie o driver ODBC do QuickBooks na máquina em que seu aplicativo cliente está instalado.
   Por exemplo, se você deseja analisar dados do QuickBooks no Excel, instale o driver ODBC do QuickBooks na máquina em que o Excel está instalado.
   
   Para fazer isso, execute a distribuição de arquivos que você baixou na etapa anterior e siga as instruções na tela.
   
   O programa de instalação inicia o Easysoft License Manager, porque você não pode usar o driver ODBC do QuickBooks até que uma licença seja obtida.
   
   Os seguintes tipos de licença estão disponíveis:
   
   • Licença de avaliação gratuita por tempo limitado que oferece uso gratuito e irrestrito do produto por um período limitado (geralmente 14 dias).
   • Licença completa se você comprou o produto. Ao comprar o produto, você recebe um código de autorização, que você usa para obter uma licença
3. No Easysoft License Manager, insira seus dados.
   Você DEVE inserir os campos Nome, Endereço de e-mail e Empresa.
   
   O endereço de e-mail DEVE ser o mesmo que o endereço usado para se registrar e fazer download do site da Easysoft ou você não poderá obter licenças de teste.
   
4. Escolha Solicitar Licença.
   Você é solicitado a fornecer um tipo de licença.
   
5. Faça um dos seguintes:
   • Para uma licença de avaliação, clique em Avaliação por tempo limitado e clique em Avançar.
     O License Manager pergunta qual software você está licenciando. Selecione Driver ODBC Easysoft QuickBooks na lista suspensa e clique em Avançar.
     
   • Se você obteve um código de autorização para uma licença adquirida, selecione Licença sem vencimento e clique em Avançar.
     O License Manager solicita seu código de autorização.
     
     Digite o código de autorização e clique em Avançar.
     
6. O License Manager exibe um resumo das informações inseridas e permite que você escolha o método de solicitação de sua licença.
7. Faça um dos seguintes:
   • Escolha Solicitação on-line se sua máquina estiver conectada à Internet e puder fazer conexões de saída para a porta 8884.
     O License Manager então envia uma solicitação ao servidor de licenças Easysoft para ativar sua chave de licença automaticamente. Este é o método mais rápido e faz com que seus dados sejam inseridos imediatamente em nosso banco de dados de suporte.
     
   • As três opções restantes (Solicitação de e-mail, Solicitação de impressão e Solicitação de visualização) são formas de obter uma licença se sua máquina estiver off-line (ou seja, não tiver conexão com a Internet).
     Cada um desses métodos envolve fornecer à Easysoft informações, incluindo o número de sua máquina (um número exclusivo para sua máquina) e aguardar o recebimento de sua chave de licença.
     
     Em vez de enviar seus dados por e-mail para a Easysoft, você pode inseri-los diretamente no site da Easysoft e sua chave de licença será enviada por e-mail automaticamente.
     
     Para usar esse método, clique em Exibir solicitação e visite:
     
     • Página de licença de avaliação
     • Página de licença completa
     
     Na página Licenciamento, insira o número da sua máquina (e o código de autorização para a licença adquirida), clique em Enviar e sua chave de licença será enviada por e-mail para você.
     
     Ao receber a chave de licença, você pode ativá-la clicando duas vezes no anexo de e-mail ou clicando em Enter License na tela principal do License Manager e colando a chave de licença na caixa de diálogo.
     
   • Escolha Concluir para sair do Gerenciador de licenças.
     A instalação está completa.
     

Configurando uma fonte de dados ODBC

%windir%\syswow64\odbcad32.exe

1. Escolha a guia DSN do sistema e, em seguida, escolha Adicionar.
2. Na caixa de diálogo Criar nova fonte de dados, escolha Easysoft ODBC-QuickBooks Desktop Driver e escolha Concluir.
3. Preencha estes campos Caixa de diálogo Easysoft ODBC-QuickBooks Desktop Driver DSN Setup:

   Setting	Valor
   DSN	QuickBooks Desktop
   Modo de conexão	Igual ao QuickBooks
   Nome do aplicativo	EasysoftQuickBooksODBC.
   ID do aplicativo	EasysoftQuickBooksODBC.
   Edição QB	Defina isso para ser igual ao QuickBooks Desktop. Por exemplo, se você tiver a versão americana do QuickBooks, defina QB Edition para US .

Permitir que o driver ODBC do QuickBooks acesse o QuickBooks

1. Inicie o QuickBooks Desktop se ainda não estiver em execução.
2. No seu aplicativo, conecte-se à sua nova fonte de dados do QuickBooks.
3. Quando você se conecta pela primeira vez, o QuickBooks solicita que você permita que o driver ODBC do QuickBooks acesse seus dados do QuickBooks. Na caixa de diálogo QuickBooks - Aplicativo sem certificado, escolha "Sim, sempre permitir acesso mesmo se o QuickBooks não estiver em execução". Escolha "Permitir que este aplicativo acesse dados pessoais, como números de CPF e informações de cartão de crédito do cliente". Escolha Continuar.
   A caixa de diálogo Confirmar para continuar é exibida.
   
4. Escolha Sim.
   A caixa de diálogo Confirmação de acesso é exibida.
   
5. Em seu aplicativo, tente uma consulta de amostra. Por exemplo:

   select top 10 * from vendor
   

Conectando seu aplicativo ao QuickBooks

• Aplicativos de 64 bits
• Acesso
• Excel
• Oráculo®
• SQL Server

Aplicativos de 64 bits

Microsoft Access

1. Abra seu banco de dados do Microsoft Access.
2. Faça um dos seguintes:
   • Para o Microsoft Access 2003 e versões anteriores, no menu Arquivo, escolha Obter dados externos> Vincular tabelas.
     A caixa de diálogo Link é exibida.
     
   • Para o Microsoft Access 2007, na guia Dados Externos, escolha Mais> Banco de Dados ODBC.
     O assistente Obter dados externos é iniciado.
     
   • Para o Microsoft Access 2010 e posterior, na guia Dados externos, escolha Banco de dados ODBC.
     O assistente Obter dados externos é iniciado.
     
3. Faça um dos seguintes:
   • Para o Microsoft Access 2003 e versões anteriores, escolha Bancos de dados ODBC na lista Arquivos do tipo.
   • Para o Microsoft Access 2007 e posterior, escolha Vincular à fonte de dados criando uma tabela vinculada e, em seguida, escolha OK.
   
   A caixa de diálogo Selecionar fonte de dados é exibida.
   
4. Escolha sua fonte de dados ODBC na lista Fonte de dados da máquina e escolha OK.
   A caixa de diálogo Vincular tabelas é exibida.
   
5. Escolha a tabela que você deseja vincular e escolha OK.
6. Escolha a tabela vinculada no Microsoft Access e, em seguida, escolha RETURN para trabalhar com os dados vinculados.

Conectando o Excel ao QuickBooks

1. Faça um dos seguintes:
   • Para Excel 2007 e posterior, na guia Dados, escolha Obter Dados Externos. No grupo De outras fontes, escolha Do Microsoft Query.
   • Para Excel 2003 e versões anteriores, no menu Dados, escolha Importar dados externos e, em seguida, escolha Nova consulta de banco de dados.
   
   O comando New Database Query usa o Microsoft Query para importar dados. O Microsoft Query é um recurso opcional, que por padrão não está instalado. Se você não tiver o Microsoft Query instalado, escolher New Database Query solicitará que você o instale. Para fazer isso, no Painel de Controle, escolha Programas e Recursos (ou Adicionar ou Remover Programas). Escolha Microsoft Office (se você instalou o Excel como parte do Office) ou Microsoft Excel e, em seguida, escolha Alterar. Siga as instruções na tela. Selecione Escolher personalização avançada de aplicativos durante o assistente de instalação se esta opção estiver presente para sua versão do Office/Excel. O Microsoft Query está localizado em Ferramentas do Office.
   
   Depois de instalar o Microsoft Query, repita a etapa 1.
   
2. Na caixa de diálogo Escolher fonte de dados, escolha a fonte de dados do driver ODBC do QuickBooks na lista e escolha OK.
3. No Assistente de consulta, escolha as colunas que contêm os dados que você deseja recuperar e clique em Avançar.
4. Se você quiser retornar um subconjunto dos dados, use a tela Filtrar dados para filtrar os resultados de sua consulta (isso é o equivalente a um SQL WHERE cláusula) e clique em Avançar.
5. Se você quiser alterar a ordem de classificação de seus dados, use a tela Ordem de classificação para classificar os resultados de sua consulta (isso é o equivalente a um ORDER BY SQL cláusula) e clique em Avançar.
6. No menu Arquivo, escolha Retornar dados para o Excel.
7. Escolha um local para os dados em sua planilha quando solicitado.

Conectando Oracle® ao QuickBooks

1. Na fonte de dados do Driver ODBC do QuickBooks, ative O aplicativo é um serviço.
2. Crie um arquivo init DG4ODBC. Para fazer isso, mude para o %ORACLE_HOME%\hs\admin diretório. Crie uma cópia do arquivo initdg4odbc.ora . Nomeie o novo arquivo initquickbooks.ora .
   Observação Nestas instruções, substitua %ORACLE_HOME% pelo local do seu diretório Oracle® HOME. Por exemplo, C:\oraclexe\app\oracle\product\11.2.0\server .
   
3. Certifique-se de que estes parâmetros e valores estejam presentes em seu arquivo init:

   HS_FDS_CONNECT_INFO = my_quickbooks_odbc_dsn
   

   
   Substitua my_quickbooks_odbc_dsn com o nome de uma fonte de dados do driver ODBC do QuickBooks que se conecta ao servidor QuickBooks de destino. Por exemplo
   

   HS_FDS_CONNECT_INFO = "32-bit QuickBooks System"
   

4. Comente a linha que permite o rastreamento DG4ODBC. Por exemplo:

   #HS_FDS_TRACE_LEVEL = <trace_level>
   

5. Adicionar uma entrada a %ORACLE_HOME%\network\admin\listener.ora que cria um SID_NAME para DG4ODBC. Por exemplo:

   SID_LIST_LISTENER =
    (SID_LIST =
      (SID_DESC=
        (SID_NAME=quickbooks)
        (ORACLE_HOME=%ORACLE_HOME%)
        (PROGRAM=dg4odbc)
      )
    )
   

6. Adicione uma entrada DG4ODBC a %ORACLE_HOME%\network\admin\tnsnames.ora que especifica o SID_NAME criado na etapa anterior. Por exemplo:

   QUICKBOOKS =
     (DESCRIPTION =
       (ADDRESS = (PROTOCOL = TCP)(HOST = oracle_host)(PORT = 1521))
       (CONNECT_DATA =
         (SID = quickbooks)
       )
       (HS = OK)
     )
   

   
   Substitua oracle_host com o nome do host de sua máquina Oracle®.
   
7. Inicie (ou reinicie) o Oracle® Listener:

   cd %ORACLE_HOME%\bin
   lsnrctl stop
   lsnrctl start
   

8. Conecte-se ao seu banco de dados Oracle® no SQL*Plus.
9. No SQL*Plus, crie um link de banco de dados para o servidor QuickBooks de destino. Por exemplo:

   CREATE PUBLIC DATABASE LINK quickbookslink CONNECT TO "dummyuser" IDENTIFIED BY "password" USING 'quickbooks';
   

10. Tente consultar seus dados do QuickBooks. Por exemplo:

    SELECT * FROM "PurchaseOrder"@QUICKBOOKSLINK;
    

Observações

• Se você tiver problemas para se conectar ao QuickBooks do Oracle®, ative o rastreamento DG4ODBC e verifique os arquivos de rastreamento gravados no %ORACLE_HOME%\hs\trace diretório. Para habilitar o rastreamento DG4ODBC, adicione a linha HS_FDS_TRACE_LEVEL = DEBUG para initquickbooks.ora e, em seguida, inicie/reinicie o ouvinte Oracle®. Se o trace diretório não existe, crie-o.
• Se você habilitar o rastreamento do ODBC Driver Manager, mas não obtiver um arquivo de rastreamento ou um arquivo de rastreamento vazio, altere o local do arquivo de rastreamento para o diretório TEMP do Windows. Por exemplo, C:\Windows\Temp\SQL.log .

Conectando o SQL Server ao QuickBooks

1. Instale o na máquina em que você instalou o driver ODBC do QuickBooks.
   Instale o Cliente e o Servidor. Para obter informações sobre como instalar, licenciar e testar o , consulte a documentação.
   
2. Abra o Administrador ODBC de 64 bits, que é a única versão deste aplicativo acessível por meio do Painel de controle> Ferramentas administrativas ou se houver dois, conterá 64 bits em seu nome.
3. Escolha a guia DSN do sistema e escolha Adicionar.
   A caixa de diálogo DSN da ponte ODBC-ODBC é exibida
   
4. Na caixa Nome, insira "OOBQuickBooks". Escolha a guia Servidor.
5. Na caixa Servidores, digite "localhost:8888".
6. Nas caixas Nome de usuário e Senha, digite seu nome de usuário e senha do Windows para esta máquina. Escolha a guia DSN de destino.
7. Na caixa TargetDSN, insira o nome da fonte de dados do driver ODBC do QuickBooks.

• Na fonte de dados do Driver ODBC do QuickBooks, ative O aplicativo é um serviço.

Servidor vinculado

1. No Microsoft SQL Server Management Studio, conecte-se à instância do SQL Server na qual deseja criar o servidor vinculado.
   Você precisa fazer logon com uma conta que seja membro da função de servidor fixa sysadmin do SQL Server para criar um servidor vinculado.
   
2. Clique com o botão direito do mouse em Objetos de Servidor. No menu pop-up, escolha Novo> Servidor vinculado.
3. Na caixa Servidor vinculado, digite "QUICKBOOKS".
4. Na lista de provedores, escolha Microsoft OLE DB Provider for ODBC Drivers.
5. Na caixa Fonte de dados, digite o nome da fonte de dados e escolha OK. (Se você ainda não configurou uma fonte de dados, consulte estas instruções. Você precisa usar o por esse motivo.)
6. Escolha a página Segurança.
7. Escolha Ser feito usando este contexto de segurança.
8. Digite seu nome de usuário e senha do QuickBooks nos espaços fornecidos. Escolha OK.
   O SQL Server verifica o servidor vinculado testando a conexão.
   
   • Se você receber o erro "O driver especificado não pôde ser carregado devido ao erro de sistema 126:o módulo especificado não pôde ser encontrado", escolha Sim quando solicitado se deseja manter o servidor vinculado. Você precisa reiniciar sua instância do SQL Server antes de poder usar o servidor vinculado. Se o SQL Server já estava em execução quando você instalou os drivers ODBC do Easysoft, ele não terá a versão mais recente da variável de ambiente System PATH. O programa de instalação do driver Easysoft ODBC adiciona entradas para o driver ao PATH do sistema. Reiniciar a instância disponibiliza essas alterações para o SQL Server, permitindo que ele carregue o driver ODBC do QuickBooks.
   • Se você cometer um erro ao especificar a fonte de dados, receberá o erro "Nome da fonte de dados não encontrado e nenhum driver padrão especificado. Se você receber esse erro, escolha Não quando solicitado se deseja manter o servidor vinculado e editar o valor na caixa Fonte de dados.
9. Você pode consultar seus dados do QuickBooks usando um:
   • Nome da tabela de quatro partes em uma consulta distribuída.
     Um nome de tabela de quatro partes tem o formato:
     
     server_name .[database_name ].[nome_do_esquema ].table_name .
     
     Para QuickBooks, você precisa omitir o nome e o esquema do banco de dados. Por exemplo:
     

     SELECT * from QUICKBOOKS...vendor
     

   • Consulta de passagem em uma função OPENQUERY. Por exemplo:

     SELECT * FROM OPENQUERY(QUICKBOOKS, 'SELECT * FROM vendor')
     

     
     O SQL Server envia consultas de passagem como cadeias de caracteres de consulta não interpretadas para o driver ODBC do QuickBooks. Isso significa que o SQL Server não aplica nenhum tipo de lógica à consulta nem tenta estimar o que essa consulta fará.