Integrações / ERP / Acumatica Cloud ERP
Guia de integração do Acumatica para programação da produção com SkyPlanner APS
Este guia de integração do Acumatica mostra a parceiros e equipes de TI como conectar o Acumatica Cloud ERP (Manufacturing Edition) ao SkyPlanner APS. A integração entre SkyPlanner e Acumatica funciona nos dois sentidos:
- O SkyPlanner recebe ordens de produção com suas operações, centros de trabalho, máquinas, ferramentas, turnos, itens de estoque e pedidos de compra.
- As datas planejadas de início e término são gravadas nas operações da ordem de produção, e a ordem é firmada.
- Os apontamentos de tempo dos operadores retornam como lançamentos de mão de obra e movimentação.
- Os webhooks do SkyPlanner enviam as alterações na programação assim que elas ocorrem.
A equipe do SkyPlanner configura a integração de acordo com o seu ambiente Acumatica durante a implantação e oferece suporte após a entrada em produção. Este guia é voltado a parceiros e desenvolvedores que querem participar desse trabalho ou desenvolver suas próprias soluções com a REST API documentada do SkyPlanner (referência da API).
Interfaces de integração do Acumatica
A integração usa interfaces que já fazem parte do Acumatica. Nada é instalado na instância.
- REST API baseada em contrato. Os endpoints são versionados e acompanham cada versão do produto. O endpoint Manufacturing (por exemplo, 26.200.001 para 2026 R2) expõe
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntryeMaterialEntry. O endpoint Default abrangeStockItem,PurchaseOrdereSalesOrder. As URLs seguem o padrão{instance}/entity/{Endpoint}/{version}/{Entity}. - Ações no mesmo endpoint.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntryeReleaseMaterialEntryexecutam a mesma lógica dos botões nas telas. - OData. Qualquer Generic Inquiry (SM208000) pode ser exposta via OData. Uma Generic Inquiry com as operações de produção em aberto e suas datas é a forma mais rápida de fazer a leitura em lote.
- Notificações push (SM302000). Baseadas em uma Generic Inquiry ou em uma consulta nativa, enviam as linhas inseridas e excluídas para uma URL que você configura.
- Cenários de importação e exportação com provedores CSV e Excel para cargas em lote.
As entidades e ações estão listadas em Web Service Endpoints (SM207000) e no repositório do cliente REST do Acumatica.
Autenticação e limites
O Acumatica usa OAuth 2.0 e OpenID Connect por meio de aplicações cliente cadastradas em Connected Applications (SM303010). Os fluxos documentados são Authorization Code, Implicit, Resource Owner Password Credentials e Hybrid. Para uma integração entre servidores, cadastre um usuário exclusivo para a integração, com perfis de acesso que concedam apenas as permissões necessárias, e use Authorization Code com um token de atualização ou Resource Owner Password Credentials.
Sua licença define os limites: a License Monitoring Console (SM604000) mostra a quantidade permitida de requisições de API por minuto e de usuários de API.
No SkyPlanner, a REST API usa um token de API para autenticação (SkyPlanner Settings > API) e está documentada em Swagger/OpenAPI. O tutorial de integração orienta você nas primeiras chamadas.
Mapeamento de dados
| Objeto do Acumatica (endpoint / formulário) | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
StockItem (Default; Stock Items IN202500) | Produtos e materiais | Acumatica → SkyPlanner | Carga inicial, depois apenas as alterações |
BillOfMaterial (AM208000): materiais, operações | Estrutura do produto, subprodutos, materiais por produto | Acumatica → SkyPlanner | Carga inicial, depois a cada alteração |
| Operações da BOM: Setup, Run, Machine, Queue, Finish, Move Time | Etapas do processo com durações e tempos de preparação e desmontagem | Acumatica → SkyPlanner | Carga inicial, depois a cada alteração |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | Centros de trabalho, grupos de centros de trabalho, eficiências, centros de trabalho alternativos | Acumatica → SkyPlanner | Carga inicial, raramente depois |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Turnos e capacidade de mão de obra | Acumatica → SkyPlanner | Diariamente, ou turnos mantidos no SkyPlanner |
Tool (AM205500) | Ferramentas como recursos de capacidade limitada | Acumatica → SkyPlanner | Carga inicial |
ProductionOrder com OrderOperationDetail (Planned, Released, In Process) | Ordens e tarefas com prazos, prioridade de execução e necessidades de materiais | Acumatica → SkyPlanner | Notificação push ou consulta periódica em intervalos de poucos minutos |
Linhas de PurchaseOrder (Default) | Pedidos de compra com data prevista de entrega | Acumatica → SkyPlanner | Consulta a cada hora ou ao executar a programação |
| Quantidades dos itens por depósito | Saldos de estoque | Acumatica → SkyPlanner | Consulta a cada hora ou ao executar a programação |
OrderOperationDetail: StartDate, EndDate, WorkCenter | Início, término e centro de trabalho planejados por operação | SkyPlanner → Acumatica | A cada alteração na programação, via webhook do SkyPlanner |
Ação FirmProductionOrder | Impede que o Acumatica APS altere as datas gravadas | SkyPlanner → Acumatica | Após cada gravação de retorno |
LaborEntry, MoveEntry com ações de liberação | Apontamentos de tempo, quantidades concluídas, confirmações dos operadores | SkyPlanner → Acumatica | A cada confirmação ou por turno |
| Não disponível no Acumatica | Matriz de tempos de preparação, operadores identificados por nome, tarefas com vários operadores | Mantidos no SkyPlanner | Configurados durante a implantação |
Padrões de integração
1. Carga inicial de dados mestres. Leia primeiro os centros de trabalho, máquinas, ferramentas, turnos e calendários. Depois, leia os itens de estoque e as listas de materiais. Defina como mapear um centro de trabalho com várias máquinas: um grupo de centros de trabalho em que cada máquina é um centro de trabalho, ou um único centro de trabalho. O campo Basis for Capacity do Acumatica indica qual modelo a fábrica adota.
2. Sincronização de ordens. Leia as ordens de produção com as operações da própria ordem, não da BOM. As operações são copiadas para a ordem, e é nela que os planejadores fazem alterações. Configure uma notificação push para uma Generic Inquiry de ordens e operações em aberto, ou consulte-a periodicamente. Leia também as linhas em aberto dos pedidos de compra. O SkyPlanner considera o material comprado disponível na data de entrega do pedido de compra e atualiza o estoque quando o pedido é marcado como Delivered.
3. Gravação da programação no Acumatica. Para cada operação programada ou reprogramada pelo mecanismo, o SkyPlanner grava StartDate e EndDate em OrderOperationDetail, além do centro de trabalho quando a operação é transferida para um centro alternativo. Em seguida, chama FirmProductionOrder. Segundo o Acumatica: “When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.” (Ao executar a programação das ordens de produção respeitando a capacidade real de máquinas e equipes, o sistema não reprograma as ordens de produção firmadas.) (fonte)
4. Confirmações do chão de fábrica. Os operadores registram o trabalho com SkyPlanner Mobile Confirmations ou Production Timer. Os apontamentos de tempo se tornam documentos LaborEntry (tempo e quantidade concluída por operação) ou MoveEntry (somente quantidade), liberados com a ação correspondente. Se o chão de fábrica já faz os apontamentos no Acumatica, por meio de Labor (AM301000) ou Shop Floor Kiosk, o progresso é enviado no sentido inverso. Escolha um canal, nunca os dois.
5. Responsabilidade pelos dados e regras de conflito. Documente essas regras antes da entrada em produção:
| Dados | Responsável |
|---|---|
| Itens de estoque, BOMs, quantidades, status das ordens, custeio | Acumatica |
| Sequência das operações, horários de início e término, alocação aos centros de trabalho | SkyPlanner |
| Matriz de tempos de preparação, ferramentas, requisitos de operadores, alternativas | SkyPlanner |
| Turnos e ausências | Um único sistema, escolhido na definição de escopo |
| Lançamentos de mão de obra e movimentação | Acumatica, com lançamentos gerados a partir dos apontamentos de tempo do SkyPlanner ou inseridos no chão de fábrica |
A principal fonte de conflito é o próprio APS do Acumatica. O Rough Cut Planning ou o APS Maintenance Process podem recalcular as datas de ordens programadas pelo SkyPlanner. Marcar como firme cada ordem gravada impede isso. Exclua também as ordens já programadas das execuções do APS.
Etapas típicas do projeto
A implementação normalmente é concluída em poucas semanas após o início da implantação. Antes disso, o teste gratuito de 30 dias usa seus próprios dados. Exporte os centros de trabalho e as ordens de produção abertas com suas operações de uma Generic Inquiry para o Excel, importe os dados e valide a programação.
- Mapeamento. Defina a tabela de mapeamento, as regras de responsabilidade pelos dados, as frequências de sincronização e o canal de apontamento de mão de obra.
- Acesso. Registre a aplicação conectada, crie o usuário de integração e os perfis de acesso e confirme a versão do endpoint em Web Service Endpoints. Comece pelo ambiente de testes.
- Carga inicial. Centros de trabalho, máquinas, ferramentas, turnos, itens de estoque e BOMs.
- Sincronização de ordens. Ordens de produção, operações e pedidos de compra por notificações push ou consultas periódicas.
- Configuração de restrições no SkyPlanner. Matriz de tempos de preparação, operadores identificados por nome, trabalhos com vários operadores e alternativas.
- Gravação de retorno. Datas das operações, marcação de ordens como firmes e apontamentos de mão de obra ou movimentação.
- Execução em paralelo. Compare as datas do SkyPlanner com o plano atual e corrija os dados mestres.
- Entrada em produção. Ative a gravação de retorno quando os dados estiverem consistentes.
O que considerar ao planejar uma integração com o Acumatica
- Saiba qual mecanismo APS está ativo. Classic e Optimized armazenam as configurações separadamente, e apenas um deles pode estar habilitado. Verifique Enable/Disable Features (CS100000) antes da primeira gravação de retorno.
- Fixe a versão do endpoint. A versão faz parte da URL. Cada atualização do sistema adiciona uma nova versão, por isso repita os testes a cada atualização.
- Atualização de operações. Alguns campos das operações são somente leitura via REST, e o status da ordem também importa. Teste a sequência de gravação de retorno para ordens com status Released e In Process em um ambiente de testes.
- Unidades e campos de tempo. O tempo de execução é definido por Run Units, e o tempo de máquina, por Machine Units. Os tempos de fila e movimentação “affect the calculated schedule but do not occupy work center capacity.” (afetam a programação calculada, mas não ocupam a capacidade do centro de trabalho). Faça as conversões com cuidado na importação.
- Disponibilidade de materiais. O Classic APS exige que todos os materiais estejam disponíveis na quantidade total. O SkyPlanner planeja com base no estoque e nas datas de chegada dos pedidos de compra. Defina qual resultado os planejadores devem seguir.
- Limites da API. A quantidade de requisições por minuto depende da licença. Use leituras incrementais e notificações push, não recargas completas.
Quem configura e dá suporte à integração com o Acumatica
- A equipe do SkyPlanner configura a integração durante a implantação e dá suporte após a entrada em produção. Cada fábrica usa o Acumatica de uma forma, e esse conhecimento é aplicado à configuração.
- Seu parceiro Acumatica pode participar. Ele conhece suas personalizações, Generic Inquiries e perfis de acesso. O SkyPlanner fornece a REST API, a documentação Swagger/OpenAPI e os webhooks.
- Seus próprios desenvolvedores podem criar a integração usando a mesma REST API com um token de API. Basta um token de API para começar, e a equipe do SkyPlanner ajuda quando necessário. A Laboratory & Allied seguiu esse caminho com o SAP Business One: sua equipe interna de TI desenvolveu a maior parte da integração por conta própria, com ajuda do SkyPlanner.
O SkyPlanner custa a partir de 199 € por mês, com 5 centros de trabalho incluídos e cobrança mensal. O orçamento da integração é apresentado antecipadamente, junto com o plano, de acordo com seu processo e suas necessidades. Assim, você conhece o custo total antes de começar. Veja a comparação com o próprio APS do Acumatica em programação da produção no Acumatica com capacidade finita, a visão geral na página do Acumatica e outros sistemas na central de integrações com ERP.
Depoimentos de fabricantes sobre o SkyPlanner
2 heconomizadas por semana
“Com o SkyPlanner, nosso planejamento da produção saiu das planilhas do Excel para a otimização da produção em tempo real.”
Kalle Kalliomäki, especialista em cadeia de suprimentos
UTU · Painéis elétricos e equipamentos de manobra
O planejamento da produção economiza 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 por TI
Laboratory & Allied · Fabricação de produtos farmacêuticos
A eficiência na produção aumentou 90%, e criar um plano otimizado de três meses para todos os centros de trabalho leva menos de 30 minutos.
1.000+ ordens de produção programadas automaticamente
“Agora temos outra forma de controlar a produção, e nossa compreensão da capacidade está em um patamar completamente diferente.”
Hannu Ryynänen, CEO
Mamec · Misturadores industriais, bombas e fabricação de alta tecnologia sob contrato
Milhares de ordens de produção são programadas automaticamente, com uma visão da produção em tempo real para toda a organização.
99,2%de pontualidade de entrega
“O SkyPlanner trouxe visibilidade para identificar gargalos e tornou a gestão da produção mais clara.”
Toni Tuori, gerente de produção
Piristeel · Sistemas de segurança para telhados e de águas pluviais
A pontualidade de entrega chegou a 99,2% neste ano, e a programação economiza até quatro horas de trabalho por dia.
Perguntas frequentes
A API do Acumatica inclui ordens de produção?
Sim. O endpoint Manufacturing da REST API baseada em contratos disponibiliza ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine, Tool e apontamentos de mão de obra e movimentação, além de ações como FirmProductionOrder.
Quem desenvolve a integração com o Acumatica?
A equipe do SkyPlanner configura a integração bidirecional de acordo com seu ambiente Acumatica durante a implantação e dá suporte após a entrada em produção. Seu parceiro Acumatica ou seus próprios desenvolvedores também podem desenvolver usando a REST API documentada do SkyPlanner. Basta um token de API para começar.
Precisamos do Acumatica APS para esta integração?
Não. No Acumatica, a programação com capacidade finita é executada pelo formulário Rough Cut Planning, e o Classic APS planeja com capacidade infinita as ordens cujo término está além de 120 dias (fonte). O próprio SkyPlanner cria a programação detalhada respeitando a capacidade disponível, a partir de ordens de produção, operações, centros de trabalho, máquinas e ferramentas. Por isso, a integração funciona com ou sem o APS habilitado, que, segundo a Acumatica, “is subject to licensing” (está sujeito a licenciamento). O Autopilot mantém a programação atualizada, e os operadores registram o trabalho com Mobile Confirmations.
Como impedir que o Acumatica APS sobrescreva as datas do SkyPlanner?
O SkyPlanner marca cada ordem de produção como firme após gravar as datas de suas operações. A programação com capacidade finita do Acumatica não reprograma ordens firmes.
O Acumatica pode enviar alterações em tempo real?
Sim. As notificações push (SM302000) de uma Generic Inquiry enviam as linhas alteradas para uma URL assim que as mudanças ocorrem. Os próprios webhooks do SkyPlanner enviam as alterações da programação no sentido inverso.
Qual autenticação a integração deve usar?
OAuth 2.0 por meio de um cliente registrado em Connected Applications (SM303010), com um usuário exclusivo para a integração e perfis com os privilégios mínimos necessários. O fluxo é confirmado para sua instância durante a definição de escopo.
Podemos testar o SkyPlanner antes de desenvolver a integração?
Sim. O teste gratuito de 30 dias permite usar até 20 centros de trabalho, com importações de Excel ou CSV a partir de uma Generic Inquiry do Acumatica, sem necessidade de cartão de crédito. Inicie o teste ou fale com a equipe de vendas para definir o escopo da integração.
