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 aos parceiros e às equipas de TI como ligar 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 as respetivas operações, centros de trabalho, máquinas, ferramentas, turnos, artigos de stock e encomendas de compra.
- As datas de início e fim planeadas são gravadas nas operações da ordem de produção e a ordem é fixada.
- Os registos de tempos dos operadores são enviados de volta como lançamentos de mão de obra e de movimentação.
- Os webhooks do SkyPlanner enviam as alterações à programação assim que ocorrem.
Durante a implementação inicial, a equipa SkyPlanner configura a integração de acordo com a sua configuração do Acumatica e presta assistência após a entrada em produção. Este guia destina-se a parceiros e programadores que queiram participar ou desenvolver, por conta própria, soluções com base na REST API documentada do SkyPlanner (referência da API).
Interfaces de integração do Acumatica
A integração utiliza interfaces que já fazem parte do Acumatica. Não é instalado nada na instância.
- REST API baseada em contratos. Os endpoints têm versões que acompanham as versões do produto. O endpoint Manufacturing (por exemplo, 26.200.001 para 2026 R2) disponibiliza
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntryeMaterialEntry. O endpoint Default abrangeStockItem,PurchaseOrdereSalesOrder. Os URLs seguem o formato{instance}/entity/{Endpoint}/{version}/{Entity}. - Ações no mesmo endpoint.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntryeReleaseMaterialEntryexecutam a mesma lógica que os botões nos ecrãs. - OData. Qualquer Generic Inquiry (SM208000) pode ser disponibilizada através de OData. Uma Generic Inquiry das operações de produção em aberto, com as respetivas datas, é a forma mais rápida de ler dados em massa.
- Notificações push (SM302000). Com base numa Generic Inquiry ou numa consulta predefinida, enviam as linhas inseridas e eliminadas para um URL configurado por si.
- Cenários de importação e exportação com fornecedores de dados CSV e Excel para carregamentos em massa.
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 utiliza OAuth 2.0 e OpenID Connect através de aplicações cliente registadas em Connected Applications (SM303010). Os fluxos documentados são Authorization Code, Implicit, Resource Owner Password Credentials e Hybrid. Para uma integração com um servidor, registe um utilizador dedicado à integração com funções que concedam apenas os privilégios necessários e utilize Authorization Code com um token de atualização ou Resource Owner Password Credentials.
A sua licença define os limites: a License Monitoring Console (SM604000) mostra o número permitido de pedidos à API por minuto e de utilizadores da API.
Do lado do SkyPlanner, a REST API utiliza um token de API para autenticação (SkyPlanner Settings > API) e está documentada em Swagger/OpenAPI. O tutorial de integração explica as primeiras chamadas, passo a passo.
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 | Carregamento inicial; depois, apenas alterações |
BillOfMaterial (AM208000): materiais, operações | Estrutura do produto, subprodutos, materiais por produto | Acumatica → SkyPlanner | Carregamento 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 | Carregamento 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 | Carregamento inicial; raramente depois |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Turnos e capacidade do pessoal | Acumatica → SkyPlanner | Diariamente, ou turnos geridos no SkyPlanner |
Tool (AM205500) | Ferramentas como recursos com disponibilidade limitada | Acumatica → SkyPlanner | Carregamento inicial |
ProductionOrder com OrderOperationDetail (Planned, Released, In Process) | Ordens e trabalhos com prazos, prioridade de execução e necessidades de materiais | Acumatica → SkyPlanner | Notificação push ou consulta periódica de poucos em poucos minutos |
Linhas de PurchaseOrder (Default) | Encomendas de compra com data de entrega prevista | Acumatica → SkyPlanner | Consulta periódica, de hora a hora ou ao executar a programação |
| Quantidades de artigos por armazém | Saldos de stock | Acumatica → SkyPlanner | Consulta periódica, de hora a hora ou ao executar a programação |
OrderOperationDetail: StartDate, EndDate, WorkCenter | Início, fim e centro de trabalho planeados por operação | SkyPlanner → Acumatica | A cada alteração da programação, através de um webhook do SkyPlanner |
Ação FirmProductionOrder | Impede que o Acumatica APS altere as datas gravadas | SkyPlanner → Acumatica | Após cada gravação de dados no Acumatica |
LaborEntry, MoveEntry com ações de libertação | Registos de tempos, quantidades concluídas, confirmações dos operadores | SkyPlanner → Acumatica | Por confirmação ou por turno |
| Não existe no Acumatica | Matriz de tempos de preparação, operadores identificados por nome, trabalhos com vários operadores | Geridos no SkyPlanner | Configurados durante a implementação inicial |
Padrões de integração
1. Carregamento inicial dos dados mestre. Comece por ler os centros de trabalho, máquinas, ferramentas, turnos e calendários. Depois, leia os artigos de stock e as listas de materiais. Decida 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 a lógica utilizada pela fábrica.
2. Sincronização de ordens. Leia as ordens de produção com as respetivas operações a partir da ordem, não da BOM. As operações são copiadas para a ordem e é aí que os responsáveis pelo planeamento as alteram. Configure uma notificação push para uma Generic Inquiry das ordens e operações em aberto ou consulte-a periodicamente. Leia também as linhas de encomendas de compra em aberto. O SkyPlanner considera o material encomendado disponível na data de entrega da encomenda de compra e atualiza o stock quando esta é marcada como Delivered.
3. Escrita da programação no Acumatica. Para cada operação que o motor programou ou deslocou, o SkyPlanner grava StartDate e EndDate em OrderOperationDetail, bem como o centro de trabalho quando o trabalho passa para um centro alternativo. Em seguida, chama FirmProductionOrder. 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 das máquinas e do pessoal, o sistema não reprograma as ordens de produção fixadas.) (fonte)
4. Confirmações no chão de fábrica. Os operadores registam o trabalho com SkyPlanner Mobile Confirmations ou Production Timer. Os registos de tempos dão origem a documentos LaborEntry (tempo e quantidade concluída por operação) ou MoveEntry (apenas quantidade), libertados com a ação correspondente. Se o chão de fábrica já regista a produção no Acumatica, através de Labor (AM301000) ou Shop Floor Kiosk, os dados de progresso circulam no sentido inverso. Escolha um único canal, nunca os dois.
5. Responsabilidade pelos dados e regras de conflito. Documente-as antes da entrada em produção:
| Dados | Sistema responsável |
|---|---|
| Artigos de stock, BOMs, quantidades, estado das ordens, cálculo de custos | Acumatica |
| Sequência das operações, horas de início e fim, atribuição de 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 do âmbito |
| Lançamentos de mão de obra e de movimentação | Acumatica, com lançamentos a partir dos registos de tempos do SkyPlanner ou introduzidos no chão de fábrica |
A principal fonte de conflitos é o próprio APS do Acumatica. O Rough Cut Planning ou o APS Maintenance Process podem recalcular as datas das ordens programadas pelo SkyPlanner. Fixar cada ordem após a gravação impede que isso aconteça. Exclua também as ordens já programadas das execuções do APS.
Etapas habituais do projeto
A implementação fica normalmente concluída em poucas semanas após o início do acompanhamento inicial. Antes disso, pode utilizar os seus próprios dados no período experimental gratuito de 30 dias. Exporte os centros de trabalho e as ordens de produção em aberto, com as respetivas operações, de uma Generic Inquiry para Excel. Importe esses 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 registo da mão de obra.
- Acesso. Registe a aplicação ligada, crie o utilizador de integração e os respetivos perfis de acesso e confirme a versão do endpoint em Web Service Endpoints. Comece num ambiente de testes.
- Carregamento inicial. Centros de trabalho, máquinas, ferramentas, turnos, artigos de stock e listas de materiais.
- Sincronização de ordens. Ordens de produção, operações e encomendas de compra, por notificações push ou consulta periódica.
- Configuração de restrições no SkyPlanner. Matriz de tempos de preparação, operadores identificados, trabalhos com vários operadores e alternativas.
- Gravação de dados no ERP. Datas das operações, fixação de ordens e registos de mão de obra ou de movimentação.
- Funcionamento em paralelo. Compare as datas do SkyPlanner com o plano atual e corrija os dados mestre.
- Entrada em produção. Ative a gravação de dados no ERP assim que os dados coincidirem.
O que prever numa integração com o Acumatica
- Confirme qual o motor APS ativo. O Classic e o Optimized guardam as configurações separadamente, e apenas um pode estar ativo. Verifique Enable/Disable Features (CS100000) antes da primeira gravação de dados no ERP.
- Fixe a versão do endpoint. A versão faz parte do URL. Cada atualização do software acrescenta uma nova versão, pelo que deve repetir os testes a cada atualização.
- Atualização de operações. Alguns campos das operações são apenas de leitura via REST, e o estado da ordem também conta. Teste a sequência de gravação de dados no ERP para ordens nos estados Released e In Process num 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 espera e de movimentação “affect the calculated schedule but do not occupy work center capacity.” (afetam a programação calculada, mas não ocupam capacidade do centro de trabalho). Faça as conversões com cuidado ao importar.
- Disponibilidade de materiais. O Classic APS exige que todos os materiais estejam disponíveis na totalidade. O SkyPlanner planeia com base no stock e nas encomendas de compra a receber, por data. Defina qual dos resultados os responsáveis pelo planeamento devem seguir.
- Limites da API. O número de pedidos por minuto depende da licença. Utilize leituras incrementais e notificações push, não recarregamentos completos.
Quem configura e dá suporte à integração com o Acumatica
- A equipa do SkyPlanner configura a integração durante o acompanhamento inicial e dá suporte após a entrada em produção. Cada fábrica utiliza o Acumatica de forma diferente, e é aqui que esse conhecimento é aplicado.
- O seu parceiro Acumatica pode participar. O parceiro conhece as suas personalizações, Generic Inquiries e perfis de acesso. O SkyPlanner disponibiliza a REST API, documentação Swagger/OpenAPI e webhooks.
- Os seus próprios programadores também podem desenvolver a integração com a mesma REST API e um token de API. Basta um token de API para começar, e a equipa do SkyPlanner ajuda quando necessário. A Laboratory & Allied seguiu esta via com o SAP Business One: a sua equipa interna de TI desenvolveu a integração em grande parte de forma autónoma, com a ajuda 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, em conjunto com o seu plano e de acordo com os seus processos e necessidades, para que conheça o custo total antes de começar. Compare o APS do próprio Acumatica em programação da produção no Acumatica com respeito pela capacidade real de máquinas e pessoal, consulte a visão geral na página do Acumatica e descubra outros sistemas na área de integrações ERP.
Opiniões de fabricantes sobre o SkyPlanner
2 hpoupadas por semana
“Com o SkyPlanner, o nosso planeamento da produção passou das 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 · Indústria farmacêutica
A eficiência na produção aumentou 90%, e criar um plano otimizado de três meses para todos os centros de trabalho demora menos de 30 minutos.
1.000 e maisordens de trabalho programadas automaticamente
“Temos um controlo diferente da 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 trabalho são programadas automaticamente, e toda a organização tem uma visão da produção em tempo real.
99,2%de fiabilidade das entregas
“O SkyPlanner deu-nos visibilidade para identificar estrangulamentos e tornou a gestão da produção mais clara.”
Toni Tuori, responsável de produção
Piristeel · Sistemas de segurança para coberturas e de águas pluviais
A fiabilidade das entregas atingiu 99,2% este ano, e a programação permite poupar 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 registos de mão de obra e de movimentação, além de ações como FirmProductionOrder.
Quem desenvolve a integração com o Acumatica?
A equipa do SkyPlanner configura a integração bidirecional de acordo com a sua configuração do Acumatica durante o acompanhamento inicial e dá suporte após a entrada em produção. O seu parceiro Acumatica ou os seus próprios programadores também podem desenvolver a integração com a REST API documentada do SkyPlanner. Basta um token de API para começar.
É necessário ter o Acumatica APS para esta integração?
Não. No Acumatica, a programação que respeita a capacidade real de máquinas e pessoal é executada no formulário Rough Cut Planning, e o Classic APS planeia com capacidade ilimitada as ordens cuja conclusão ultrapassa os 120 dias (fonte). O próprio SkyPlanner cria a programação detalhada, respeitando a capacidade real, a partir das ordens de produção, operações, centros de trabalho, máquinas e ferramentas. Assim, a integração funciona com ou sem o APS ativo, que, segundo o Acumatica, “is subject to licensing” (está sujeito a licenciamento). O Autopilot mantém a programação atualizada, e os operadores registam o trabalho com Mobile Confirmations.
Como impedir que o Acumatica APS substitua as datas do SkyPlanner?
O SkyPlanner fixa cada ordem de produção depois de gravar as datas das respetivas operações. Ao programar a produção respeitando a capacidade real, o Acumatica não reprograma ordens fixadas.
O Acumatica pode enviar alterações em tempo real?
Sim. As notificações push (SM302000) de uma Generic Inquiry enviam as linhas alteradas para um URL assim que ocorrem alterações. Os webhooks do próprio SkyPlanner enviam as alterações à programação no sentido inverso.
Que autenticação deve utilizar a integração?
OAuth 2.0 através de um cliente registado em Connected Applications (SM303010), com um utilizador dedicado à integração e perfis de acesso com os privilégios mínimos necessários. O fluxo é confirmado para a sua instância durante a definição do âmbito.
Podemos testar o SkyPlanner antes de desenvolver a integração?
Sim. O período experimental gratuito de 30 dias permite utilizar até 20 centros de trabalho, com importações em Excel ou CSV a partir de uma Generic Inquiry do Acumatica, sem necessidade de cartão de crédito. Inicie o período experimental ou fale com a equipa comercial para definir o âmbito da integração.
