Conector do QuickBooks Criar Atividades¶

Antes de poder criar novos dados do QuickBooks a partir do Jitterbit, você precisará criar um endpoint do QuickBooks no Jitterbit Studio (consulte QuickBooks Connector OAuth 1.0a - Create Endpoint ou Conector QuickBooks 2.0 - Criar Endpoint). Agora que o Jitterbit tem acesso à sua instância do QuickBooks Online, você pode realizar quatro atividades principais com seus dados do QuickBooks : Consultar, Criar, Atualizar ou Excluir.

Esta página se concentra na criação de novos dados do QuickBooks, usando um exemplo de criação de um novo cliente do QuickBooks por meio de um arquivo XML por meio do Jitterbit. Essas etapas são divididas em iniciar a atividade Criar, definir os componentes da Operação e implantar e executar a Operação.

Criando uma Operação de Criação do QuickBooks¶

1. Dentro do seu projeto dentro do Jitterbit Studio, existem várias maneiras de iniciar uma nova atividade QuickBooks Create. Cada uma das opções a seguir iniciará o QuickBooks Create Wizard para guiá-lo durante o processo.

   • Vá para Arquivo > Novo > Conectores > Novo QuickBooks Criar.
   • Na árvore à esquerda em Conectores, clique com o botão direito do mouse na categoria QuickBooks e selecione Criar Novo QuickBooks.
   • Na árvore à esquerda em Conectores, clique duas vezes na categoria QuickBooks, clique com o botão direito do mouse em QuickBooks Create Activities e selecione New QuickBooks Create.
   • Na barra de ferramentas superior, clique no ícone do conector (peça de quebra-cabeça laranja) . No pop-up, selecione QuickBooks e, em seguida, selecione QuickBooks Create.

2. A tela Endpoint do QuickBooks Create Wizard solicita que você selecione o endpoint no qual gostaria de criar novos dados. Você já deve ter configurado endpoints em QuickBooks Connector OAuth 1.0a - Create Endpoint ou Conector QuickBooks 2.0 - Criar Endpoint. Selecione o endpoint apropriado, por exemplo, um sandbox ou endpoint de produção. Clique em Avançar quando terminar.

   Nota

   O exemplo usado nesta documentação cria um novo cliente em uma conta sandbox do QuickBooks. Para acessar seu sandbox, vá para https://developer.intuit.com/ e entre na sua conta do QuickBooks Online. Uma vez conectado, vá para Docs & Tools > Sandbox > Go to company para o sandbox que você deseja usar.

   

3. A tela Objeto do Assistente de Criação do QuickBooks solicita que você selecione o Objeto no qual gostaria de criar novos dados. Neste exemplo, usamos a API de Contabilidade durante a criação do aplicativo QuickBooks Online e assim tem apenas um Objeto para selecionar: Contabilidade. Clique no Objeto e em Avançar para continuar.

4. A tela Componentes do Assistente de criação de QuickBooks exibe todos os componentes que estão disponíveis para novos dados a serem criados em sua instância de QuickBooks conectada. Para este passo a passo, criaremos um novo Cliente e, portanto, selecionaremos o componente Cliente. Em seguida, clique no botão Concluir.

5. O Jitterbit Studio prosseguirá com a criação de uma estrutura de solicitação e resposta da API do QuickBooks que permitirá que os dados sejam criados em sua instância conectada do QuickBooks Online. Uma nova aba deve aparecer no Studio chamada QuickBooks Create Activities. Você pode renomear sua atividade de criação aqui, se desejar; no exemplo, o nosso é chamado de "Customer QuickBooks Create".

   Clique no ícone + na extremidade direita das exibições de estrutura de solicitação e resposta para expandir todos os elementos dentro de cada estrutura. Com cada lado agora expandido, você deve ver uma tela semelhante à imagem mostrada abaixo.

6. Em seguida, na mesma tela, clique no botão Criar Operação localizado em Usar em uma Integração no canto superior direito. Isso criará a operação Jitterbit que criará novos dados do cliente no QuickBooks.

7. Uma nova aba deve abrir no Studio chamada Operações, contendo uma representação gráfica da atividade Criar. Salve sua operação clicando no ícone de disco único para salvar apenas esta operação ou no ícone de vários discos para salvar todas as alterações em seu projeto de integração. Você deve ver o asterisco na aba Operações e o título da Operação desaparecer, pois sua nova atividade Criar agora é criada e salva em seu projeto.

Definindo os Componentes da Operação¶

Agora precisamos definir os outros componentes da Operação que aparecem na representação gráfica, incluindo Origem, Solicitação, Resposta e Destino. Para fins deste passo a passo, fornecemos os seguintes exemplos para referência acima: Jitterpak QuickBooksExample.jpk e os arquivos correspondentes em QuickBooksSampleRequestFiles.zip .

• Fonte: No exemplo, o seguinte XML é uma solicitação de entrada para criar um novo cliente com os valores de campo fornecidos abaixo:

  CustomerCreateRequest.xml

  <?xml version="1.0" encoding="utf-8"?>
  <ns:INPUT xmlns:ns="urn:qboln-res:document:qboln:oln:functions">
    <Customer>
       <GivenName>Peter1</GivenName>
      <MiddleName></MiddleName>
      <FamilyName>Hynes1</FamilyName>
      <CompanyName>Soft Tech1</CompanyName>
      <DisplayName>Soft Tech1</DisplayName>
      <PrintOnCheckName>SoftTech LLC</PrintOnCheckName>
      <Active>true</Active>
      <PrimaryPhone>
        <FreeFormNumber>7678907676</FreeFormNumber>
        <Default>true</Default>
      </PrimaryPhone>
      <Mobile>
        <FreeFormNumber>8678907676</FreeFormNumber>
      </Mobile>
      <Fax>
         <FreeFormNumber>9678907676</FreeFormNumber>
        <Default>true</Default>
      </Fax>
      <PrimaryEmailAddr>
        <Address>softtech@test.com</Address>
        <Default>true</Default>
      </PrimaryEmailAddr>
      <WebAddr>
        <URI>http://stech.com</URI>
        <Default>true</Default>
      </WebAddr>
      <BillAddr>
        <Line1>456 Chinna Street</Line1>
        <City>Tracy</City>
        <Country>USA</Country>
        <CountryCode>011</CountryCode>
        <CountrySubDivisionCode>767</CountrySubDivisionCode>
        <PostalCode>95391</PostalCode>
        <PostalCodeSuffix>7878</PostalCodeSuffix>
        <Note>Billing Address</Note>
      </BillAddr>
      <ShipAddr>
        <Line1>456 Chinna Street</Line1>
        <City>Tracy</City>
        <Country>str1234</Country>
        <CountryCode>USA</CountryCode>
        <CountrySubDivisionCode>767</CountrySubDivisionCode>
        <PostalCode>95391</PostalCode>
        <PostalCodeSuffix>7878</PostalCodeSuffix>
        <Note>Shipping Address</Note>
      </ShipAddr>
    </Customer>
  </ns:INPUT>
  

  Para usar o arquivo XML, primeiro clique duas vezes no ícone Fonte e selecione um novo tipo de fonte. Para este exemplo, estamos usando um Agente Privado com arquivos locais habilitados e, assim, selecione um Tipo de "Arquivo local" e, em seguida, Navegue até o local. Se estiver usando os arquivos de exemplo, a Pasta é 'C:\projects\quickbooks' e Obter arquivos é 'CustomerCreateRequest.xml'.

• Alvo: Clique duas vezes no ícone Alvo. No exemplo, enviaremos os novos dados do QuickBooks para um arquivo XML para garantir que ele foi criado. Para isso, selecionaremos novamente um Tipo de "Arquivo Local" e Navegar até um local no Agente Privado onde queremos salvar os dados. No exemplo, a Pasta é 'C:\projects\quickbooks' e o Filename é 'CustomerCreateResponse.xml'.

• Request: Clique duas vezes no ícone Request e selecione Create New Transformação. Ou clique no botão Criar solicitação na aba Criar atividades do QuickBooks. Isso abrirá o Assistente de Transformação, que orientará você na criação da solicitação.

  1. Na primeira tela, Nome, selecione o tipo de fonte usado acima. Para o exemplo, escolhemos XML. Deixe o Alvo como padrão.
  2. Na próxima tela, Fonte, selecione o botão para Selecionar uma estrutura XML existente. No menu suspenso, selecione "Esquemas do QuickBooks ". Em seguida, selecione 'QuickBooksCreateRequest.xsd' para usar como seu arquivo de estrutura. Na tela seguinte, clique em Concluir.

  3. A aba Transformações deve abrir onde você pode concluir seu mapeamento. Clique no + na parte inferior de cada lado da Origem e do lado Alvo para expandir os itens em cada árvore. Em seguida, clique no ícone Mapa automático que aparece abaixo do lado Alvo da árvore:

     

     Sua tela de mapeamento agora deve ser semelhante à abaixo:

     

• Resposta: Clique duas vezes no ícone Resposta e selecione Criar nova Transformação. Ou clique no botão Criar resposta na aba Criar atividades do QuickBooks. Isso abrirá o Assistente de Transformação, que orientará você na criação da Resposta.

  1. Na primeira tela, Nome, selecione o tipo de Alvo usado acima. Para o exemplo, escolhemos XML. Deixe a Fonte como padrão.
  2. Na próxima tela, Fonte, selecione o botão para Selecionar uma estrutura XML existente. No menu suspenso, selecione "Esquemas do QuickBooks ". Em seguida, selecione 'QuickBooksCreateResponse.xsd' para usar como seu arquivo de estrutura. Na tela seguinte, clique em Concluir.

  3. A aba Transformações deve abrir onde você pode concluir seu mapeamento. Clique no + na parte inferior de cada lado da Origem e do lado Alvo para expandir os itens em cada árvore. Clique e arraste a pasta "SAÍDA" do lado esquerdo (lado Origem) para a pasta "SAÍDA" do lado direito (lado Destino). Sua tela de mapeamento agora deve ser semelhante à abaixo.

     

Implantando e Executando a Operação¶

Com a atividade QuickBooks Create configurada, estamos prontos para implantar e executar a operação.

Na aba Operações, clique em Implantar ícone. Em seguida, clique em Executar para colocar a Operação na fila para execução.

Na parte inferior da tela, o monitor de Operação deve indicar que sua Operação foi executada com sucesso. Caso contrário, você pode clicar duas vezes no ícone Status para visualizar as mensagens de log.

Agora você também deve ver os dados recém-criados da saída do QuickBooks para o destino especificado. Para o exemplo, o arquivo agora é criado em 'C:\projects\quickbooks\CustomerCreateResponse.xml':

<ns:OUTPUT xmlns:ns="urn:qboln-res:document:qboln:oln:functions">
    <ns:Customer>
        <ns:Id>58</ns:Id>
        <ns:SyncToken>0</ns:SyncToken>
        <ns:MetaData>
            <ns:CreateTime>2016-10-04T13:44:06-06:00</ns:CreateTime>
            <ns:LastUpdatedTime>2016-10-04T13:44:06-06:00</ns:LastUpdatedTime>
        </ns:MetaData>
        <ns:GivenName>Peter1</ns:GivenName>
        <ns:FamilyName>Hynes1</ns:FamilyName>
        <ns:FullyQualifiedName>Soft Tech1</ns:FullyQualifiedName>
        <ns:CompanyName>Soft Tech1</ns:CompanyName>
        <ns:DisplayName>Soft Tech1</ns:DisplayName>
        <ns:PrintOnCheckName>SoftTech LLC</ns:PrintOnCheckName>
        <ns:Active>1</ns:Active>
        <ns:PrimaryPhone>
            <ns:FreeFormNumber>7678907676</ns:FreeFormNumber>
        </ns:PrimaryPhone>
        <ns:Mobile>
            <ns:FreeFormNumber>8678907676</ns:FreeFormNumber>
        </ns:Mobile>
        <ns:Fax>
            <ns:FreeFormNumber>9678907676</ns:FreeFormNumber>
        </ns:Fax>
        <ns:PrimaryEmailAddr>
            <ns:Address>softtech@test.com</ns:Address>
        </ns:PrimaryEmailAddr>
        <ns:WebAddr>
            <ns:URI>http://stech.com</ns:URI>
        </ns:WebAddr>
        <ns:DefaultTaxCodeRef>2</ns:DefaultTaxCodeRef>
        <ns:Taxable>1</ns:Taxable>
        <ns:BillAddr>
            <ns:Id>96</ns:Id>
            <ns:Line1>456 Chinna Street</ns:Line1>
            <ns:City>Tracy</ns:City>
            <ns:Country>USA</ns:Country>
            <ns:CountrySubDivisionCode>767</ns:CountrySubDivisionCode>
            <ns:PostalCode>95391</ns:PostalCode>
        </ns:BillAddr>
        <ns:ShipAddr>
            <ns:Id>97</ns:Id>
            <ns:Line1>456 Chinna Street</ns:Line1>
            <ns:City>Tracy</ns:City>
            <ns:Country>str1234</ns:Country>
            <ns:CountrySubDivisionCode>767</ns:CountrySubDivisionCode>
            <ns:PostalCode>95391</ns:PostalCode>
        </ns:ShipAddr>
        <ns:Job>0</ns:Job>
        <ns:BillWithParent>0</ns:BillWithParent>
        <ns:Balance>0</ns:Balance>
        <ns:BalanceWithJobs>0</ns:BalanceWithJobs>
        <ns:CurrencyRef name="United States Dollar">USD</ns:CurrencyRef>
        <ns:PreferredDeliveryMethod>Print</ns:PreferredDeliveryMethod>
    </ns:Customer>
</ns:OUTPUT>

Além disso, ao verificar sua conta do QuickBooks, você deve encontrar o novo cliente criado.