Integrações / ERP / QuickBooks Online
Guia de integração do QuickBooks Online para programação da produção com SkyPlanner APS
Este guia de integração do QuickBooks Online mostra a ProAdvisors, consultores e equipas de TI como ligar o QuickBooks Online ao SkyPlanner APS. O SkyPlanner integra-se com o QuickBooks Online nos dois sentidos através da Accounting API da Intuit:
- O SkyPlanner recebe clientes, artigos com as respetivas quantidades em stock, orçamentos aceites, encomendas de compra em aberto e funcionários.
- A data de conclusão planeada é enviada para o QuickBooks e registada como data de expedição de cada orçamento.
- As encomendas concluídas são enviadas para o QuickBooks como faturas associadas aos respetivos orçamentos, as horas registadas como registos de tempo e as alterações de stock como ajustes de inventário.
- Os webhooks do QuickBooks notificam o SkyPlanner das alterações, e os webhooks do SkyPlanner enviam as alterações à programação assim que ocorrem.
O QuickBooks Online é um software de contabilidade, pelo que não contém máquinas, gamas operatórias nem ordens de produção. Os centros de trabalho, as etapas do processo, os turnos e os tempos de preparação são geridos no SkyPlanner. A equipa do SkyPlanner configura a integração com a sua empresa no QuickBooks durante a implementação inicial e presta apoio após a entrada em produção. Este guia destina-se a parceiros e programadores que pretendam participar no projeto ou desenvolver as suas próprias soluções com a REST API documentada do SkyPlanner (documentação de referência da API).
A Accounting API do QuickBooks Online
O QuickBooks Online é um único produto na nuvem com arquitetura multi-tenant, e todas as empresas utilizam a mesma Accounting API. Trata-se de uma REST API, na versão v3. Cada chamada dirige-se a uma empresa através do respetivo realm ID: https://quickbooks.api.intuit.com/v3/company/{realmId}/{entity}. Os testes utilizam um servidor sandbox separado. Os pedidos e as respostas estão em JSON, e o parâmetro minorversion seleciona a versão do esquema. (fonte)
As entidades necessárias para a programação:
- Dados mestre:
Customer,Item(Inventory, NonInventory, Service),Employee,Vendor. - Procura:
Estimate(TxnStatus Accepted, linhas,ShipDate) e, para unidades que faturam antecipadamente,InvoiceouSalesReceipt. - Aprovisionamento:
PurchaseOrder(POStatus Open, linhas com artigos e quantidades),Bill. - Envio para o QuickBooks:
Estimate,Invoice,TimeActivity,InventoryAdjustment.
As leituras utilizam o endpoint de consulta, por exemplo select * from Estimate where MetaData.LastUpdatedTime > '2026-10-01'. As atualizações podem ser parciais, pelo que o SkyPlanner envia apenas os campos que altera. A Accounting API não dispõe de entidades para encomendas de venda, gamas operatórias, centros de trabalho ou ordens de produção.
Autenticação e limites
A Accounting API utiliza OAuth 2.0 com o fluxo de código de autorização e o âmbito com.intuit.quickbooks.accounting. Um administrador do QuickBooks inicia sessão uma vez e aprova o acesso. A aplicação passa então a dispor de um token de acesso de curta duração, enviado como Authorization: Bearer, e de um token de renovação que é substituído a cada renovação. (fonte)
A Intuit limita as chamadas por empresa, por minuto e por segundo, e devolve HTTP 429 quando uma aplicação ultrapassa esses limites. O App Partner Program da Intuit também contabiliza algumas chamadas à API por mês, consoante o nível do parceiro. Ambos os mecanismos estão descritos na página da Intuit sobre limites e controlo de chamadas. Os webhooks, a captura de alterações de dados e as atualizações parciais mantêm uma integração de programação da produção confortavelmente dentro desses limites.
Do lado do SkyPlanner, a REST API autentica-se com um token de API no cabeçalho Authorization-Token (SkyPlanner Settings > API) e está documentada em Swagger/OpenAPI. O tutorial de integração explica passo a passo as primeiras chamadas.
Webhooks e captura de alterações de dados
Os webhooks do QuickBooks notificam a aplicação quando os dados de uma empresa ligada são alterados. “Webhooks automatically notify you whenever data changes in your end-user’s QuickBooks Online company files.” (Os webhooks notificam automaticamente sempre que os dados da empresa do utilizador final são alterados no QuickBooks Online.) (fonte) As entidades relevantes para a programação:
Customer,Item,EmployeeEstimate,Invoice,SalesReceiptPurchaseOrder,BillTimeActivity
As operações incluem Create, Update, Delete, Merge e Void. Uma notificação contém o nome da entidade, o ID, a operação e a data e hora da última atualização, não o registo completo. O destinatário lê o registo posteriormente.
A captura de alterações de dados (GET /cdc?entities=...&changedSince=...) devolve tudo o que mudou desde uma determinada marca temporal, mas apenas dentro de um período recente. O SkyPlanner utiliza-a para uma reconciliação noturna, pelo que a perda de um webhook nunca deixa uma encomenda desatualizada. A entidade TimeActivity não é abrangida pela captura de alterações de dados, pelo que a sua reconciliação é feita através de uma consulta. (fonte)
Mapeamento de dados
| Objeto do QuickBooks Online | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
Customer | Cliente (external_identifier, delivery_priority) | QuickBooks → SkyPlanner | Carga inicial e, depois, a cada webhook |
Item (Inventory, NonInventory, Service) com QtyOnHand | Produtos e materiais, stock | QuickBooks → SkyPlanner | Carga inicial e, depois, a cada webhook |
Estimate (Accepted), linhas, ShipDate | Encomenda (external_order_number, delivery_date), tarefas por linha | QuickBooks → SkyPlanner | Em tempo real, por webhook |
Invoice ou SalesReceipt (unidades que faturam antecipadamente) | Encomenda e tarefas | QuickBooks → SkyPlanner | Em tempo real, por webhook |
PurchaseOrder (Open), linhas | Material a receber (encomendas de compra de produtos) | QuickBooks → SkyPlanner | Em tempo real, por webhook |
Employee | Pessoal | QuickBooks → SkyPlanner | Carga inicial e, depois, a cada webhook |
Estimate.ShipDate (atualização parcial) | Conclusão planeada | SkyPlanner → QuickBooks | Quando a programação é alterada |
Invoice com LinkedTxn para o Estimate | Encomenda concluída | SkyPlanner → QuickBooks | Quando a encomenda é concluída |
TimeActivity (EmployeeRef, CustomerRef, ItemRef, horas) | Mobile Confirmations, registos de tempo | SkyPlanner → QuickBooks | À medida que o trabalho é registado |
InventoryAdjustment | Entrada de produtos acabados e consumo de materiais | SkyPlanner → QuickBooks | Quando a encomenda é concluída |
| Não existe no QuickBooks | Centros de trabalho, etapas do processo, turnos, ausências, matriz de tempos de preparação, ferramentas, número de operadores, centros de trabalho alternativos | Gerido no SkyPlanner | Configurado durante a implementação inicial |
Modelos de integração
1. Carga inicial de dados mestre. Percorra, página a página, os clientes, artigos, funcionários e encomendas de compra em aberto através do endpoint de consulta. Crie os clientes no SkyPlanner com o ID do QuickBooks em external_identifier e os produtos e materiais com o ID do artigo como chave. Em seguida, configure o que não existe no QuickBooks: centros de trabalho, etapas do processo por produto, turnos, ausências e tempos de preparação. A importação por CSV ou Excel é a via mais rápida para as etapas do processo.
2. Sincronização de encomendas. Subscreva os webhooks de Estimate, Invoice, Item e PurchaseOrder. Quando um orçamento passa ao estado Accepted, o SkyPlanner lê-o e cria uma encomenda com o número do orçamento em external_order_number e a data de expedição em delivery_date. Cada linha dá origem a tarefas que seguem as etapas do processo do produto. As linhas de encomendas de compra em aberto passam a material a receber, pelo que as tarefas aguardam a entrega. A captura noturna de alterações de dados recupera qualquer evento perdido.
3. Envio da programação e dos dados de conclusão para o QuickBooks. Quatro chamadas registam os resultados no QuickBooks:
- Uma atualização parcial de
EstimategravaShipDate, para que a data prometida no QuickBooks acompanhe o plano. - Quando a encomenda é concluída, POST
/invoicecria a fatura com as linhas do orçamento e umLinkedTxnpara esse orçamento. A Intuit permite associar uma fatura por orçamento, pelo que as entregas parciais são acordadas durante a definição do âmbito. - POST
/timeactivityregista as horas de cada operador, associando-as ao funcionário, ao cliente e a um artigo de serviço. As horas faturáveis podem depois ser adicionadas à fatura no QuickBooks. - POST
/inventoryadjustmentaumenta o stock de produtos acabados e reduz o dos materiais consumidos. A Intuit disponibiliza esta entidade no QuickBooks Online Plus e Advanced nos EUA. (fonte)
4. Confirmações no chão de fábrica. Os operadores registam o trabalho com SkyPlanner Mobile Confirmations, Production Timer ou Quick Log Mode. O progresso atualiza de imediato a programação, e o Autopilot reprograma o restante trabalho. As horas são enviadas para o QuickBooks como registos de tempo. Se a unidade continuar a utilizar o QuickBooks Time para o processamento salarial, escolha um único canal para as horas das tarefas durante a definição do âmbito.
5. Responsabilidade pelos dados e regras de conflito. Documente estas regras antes da entrada em produção:
| Dados | Sistema responsável |
|---|---|
| Clientes, artigos, preços, orçamentos, encomendas de compra, faturas, contabilidade | QuickBooks Online |
| Centros de trabalho, etapas do processo, turnos, ausências, matriz de tempos de preparação, ferramentas, recursos alternativos | SkyPlanner |
| Sequência das tarefas, horas de início e fim, centro de trabalho de cada tarefa | SkyPlanner |
| Data de expedição do orçamento | SkyPlanner, com gravação no QuickBooks |
| Fatura de encomendas concluídas, horas das tarefas, ajuste de produtos acabados | O SkyPlanner cria; o QuickBooks assume a gestão após o lançamento |
Etapas habituais do projeto
A implementação fica normalmente concluída em poucas semanas após o início do acompanhamento inicial. Antes disso, o período de avaliação gratuita de 30 dias utiliza os seus próprios dados, exportados do QuickBooks: clientes, produtos e orçamentos em aberto.
O projeto inclui as seguintes etapas:
- Ligação. Um administrador do QuickBooks autoriza o SkyPlanner através do ecrã OAuth 2.0 da Intuit.
- Documento que inicia a produção. Defina se a produção é iniciada por orçamentos aceites, faturas ou recibos de venda.
- Mapeamento. Estabeleça a tabela de correspondências, as chaves dos artigos, os artigos de serviço para mão de obra e as regras que determinam qual o sistema responsável por cada dado.
- Carregamento inicial. Clientes, artigos, funcionários e encomendas de compra em aberto.
- Modelo de produção. Centros de trabalho, operações por produto, turnos, matriz de tempos de preparação, ferramentas e número de operadores no SkyPlanner.
- Sincronização por eventos. Webhooks para orçamentos, artigos e encomendas de compra, complementados pela captura noturna de alterações aos dados.
- Gravação no QuickBooks. Primeiro a data de expedição, depois as faturas, os registos de tempo e os ajustes de inventário.
- Testes em paralelo e entrada em produção. Compare as datas do SkyPlanner com o seu plano atual, peça ao contabilista que verifique as primeiras faturas e os primeiros ajustes e, em seguida, ative a gravação no QuickBooks.
O que prever numa integração com o QuickBooks Online
- As encomendas de venda permanecem nos ecrãs do QuickBooks. Os planos Plus e Advanced dispõem de encomendas de venda na aplicação, mas a integração lê os orçamentos aceites ou, nas empresas que faturam antes de produzir, as faturas. Defina um único evento de início, para que todas as encomendas entrem da mesma forma.
- O QuickBooks não tem gamas operatórias. Mantenha as operações de cada produto no SkyPlanner, associadas à chave do artigo no QuickBooks.
- Uma única fatura associada a cada orçamento. As entregas parciais exigem uma regra, como um orçamento por entrega.
- Ajustes de inventário conforme o plano e a região. Nos EUA, os planos Plus e Advanced permitem estes ajustes. Nas restantes regiões, defina com o seu contabilista como registar os produtos acabados no QuickBooks.
- Ordens de fabrico do Intuit Enterprise Suite. Se as utilizar, decida qual o sistema responsável pelo fabrico e pelas reservas de componentes.
- Os conjuntos de artigos só podem ser lidos pela API. Não é possível criar artigos do tipo Group através da API, pelo que os conjuntos devem ser mantidos no QuickBooks.
- Rotação do token de atualização. Guarde o token de atualização mais recente após cada renovação; caso contrário, a ligação é interrompida.
Integração com o QuickBooks Online: quem configura e presta assistência
O trabalho abrange os seus artigos, orçamentos, encomendas de compra e a passagem do trabalho concluído para a faturação. Acrescenta os dados que o QuickBooks não contém: centros de trabalho, operações, turnos, matriz de tempos de preparação, ferramentas, número de operadores e recursos alternativos.
- A equipa SkyPlanner configura a integração durante o acompanhamento inicial e presta assistência após a entrada em produção. Cada empresa configura os artigos, os orçamentos e o inventário de forma diferente no QuickBooks, e é aqui que esse conhecimento se aplica.
- O seu QuickBooks ProAdvisor ou parceiro de integração pode desenvolver a integração. O SkyPlanner disponibiliza a REST API, documentação Swagger/OpenAPI e webhooks.
- Os seus próprios programadores podem desenvolver a integração com um token de API. Basta um token de API para começar, e a equipa SkyPlanner presta apoio quando necessário. A documentação do produto, incluindo as encomendas de compra e a API de produtos e materiais, encontra-se na documentação do SkyPlanner.
O SkyPlanner está disponível a partir de 199 € por mês, com 5 centros de trabalho incluídos e faturação mensal. O orçamento da integração é apresentado antecipadamente, de acordo com os seus processos e necessidades e em conjunto com o seu plano, para que conheça o custo total antes de começar. Consulte os preços, as funcionalidades e saiba o que o QuickBooks oferece por si só em O QuickBooks tem programação da produção? Encontra uma visão geral na página do QuickBooks Online e os restantes sistemas em todas as integrações.
Opiniões de fabricantes sobre o SkyPlanner
2 hpoupadas por semana
“Com o SkyPlanner, passámos do planeamento da produção em folhas de cálculo Excel para a otimização da produção em tempo real.”
Kalle Kalliomäki, especialista em cadeia de abastecimento
UTU · Quadros elétricos e aparelhagem de manobra
O planeamento da produção permite poupar 2 horas de trabalho por semana, e uma nova fila de trabalho chega à linha em segundos.
+90%de eficiência na produção
“A eficiência na produção aumentou 90%.”
Abdul Rucyinga, responsável de TI
Laboratory & Allied · Fabrico de produtos farmacêuticos
A eficiência na produção aumentou 90%, e a criação de um plano otimizado de três meses para todos os centros de trabalho demora menos de 30 minutos.
100%de fiabilidade das entregas desde 2021
“O SkyPlanner dá-nos visibilidade sobre a capacidade e torna o planeamento previsível.”
Dan Berglund, COO/CFO
Opes Corporation · Indústria química e alimentar
A fiabilidade das entregas tem sido de 100% durante todo o período de utilização do SkyPlanner, desde 2021.
Mais de 1 000ordens de fabrico programadas automaticamente
“Temos um controlo diferente sobre a produção, e o nosso conhecimento da capacidade está num nível completamente diferente.”
Hannu Ryynänen, diretor executivo
Mamec · Misturadores industriais, bombas e fabrico por contrato de alta tecnologia
Milhares de ordens de fabrico são programadas automaticamente, com uma visão da produção em tempo real para toda a organização.
Perguntas frequentes
O QuickBooks Online tem uma API para dados de produção?
O QuickBooks Online disponibiliza a Accounting API, uma REST API com OAuth 2.0. Abrange clientes, artigos, orçamentos, faturas, encomendas de compra, registos de tempo e ajustes de inventário. Os dados de produção, como os centros de trabalho e as operações, ficam no SkyPlanner.
O SkyPlanner pode gravar dados no QuickBooks Online?
Sim. O SkyPlanner grava a data de expedição planeada em cada orçamento, cria uma fatura associada ao orçamento quando a encomenda é concluída, lança as horas registadas como registos de tempo e regista os produtos acabados e os materiais consumidos como ajustes de inventário nos planos Plus e Advanced dos EUA.
O QuickBooks Online envia alterações em tempo real?
Sim. Os webhooks do QuickBooks abrangem clientes, artigos, orçamentos, faturas, encomendas de compra e registos de tempo. O SkyPlanner lê cada registo alterado e faz uma reconciliação noturna através da captura de alterações aos dados.
De onde vêm as gamas operatórias e as máquinas, se o QuickBooks não as tem?
Do SkyPlanner. Configura os centros de trabalho, as operações por produto, os turnos e os tempos de preparação uma única vez, manualmente ou através da importação de um ficheiro CSV ou Excel. Cada operação fica associada ao artigo do QuickBooks, pelo que os novos orçamentos são programados automaticamente.
Podemos testar o SkyPlanner antes de desenvolver a integração?
Sim. A avaliação gratuita de 30 dias permite utilizar até 20 centros de trabalho, com importação de dados do QuickBooks em CSV ou Excel, sem necessidade de cartão de crédito. Inicie a avaliação ou fale com a equipa comercial para definir o âmbito da integração.
