Integrações / ERP / Sage 200
Guia de integração do Sage 200 para programação da produção com SkyPlanner APS
Este guia de integração do Sage 200 mostra aos parceiros de negócio e às equipas de TI como ligar o Sage 200 Professional e o seu complemento de fabrico ao SkyPlanner APS. A integração entre o SkyPlanner e o Sage 200 funciona nos dois sentidos:
- Os produtos, as existências em armazém e as encomendas de compra e de venda são importados através da Sage 200 REST API.
- As ordens de fabrico, as operações e os recursos de mão de obra e máquinas são importados do complemento de fabrico.
- As datas planeadas das operações são devolvidas às ordens de fabrico.
- Os registos de tempo dos operadores são devolvidos para imputar o tempo a cada operação.
Durante a implementação inicial, a equipa SkyPlanner configura a integração de acordo com a sua instalação do Sage 200 e presta suporte após a entrada em produção. Este guia destina-se a parceiros e programadores que queiram participar ou desenvolver a integração por conta própria com a REST API documentada do SkyPlanner (referência da API).
Duas fontes num só sistema Sage 200
Uma instalação do Sage 200 numa empresa industrial tem duas camadas, e a integração lê os dados de ambas.
1. A Sage 200 REST API para dados comerciais e de existências. Segundo a Sage, a API “lets your application read and modify data in a Sage 200 site” (permite à sua aplicação ler e modificar dados numa instalação do sistema). Isto abrange clientes, fornecedores, produtos, encomendas de venda e de compra e contas do razão. A referência do Sage 200 Professional (2025.02) agrupa os recursos em Cash Book, Commercials, Financials, General, Nominal, POP, Price Book, Purchases, Sales, SOP e Stock. Os recursos relevantes para a programação são:
| Recurso | Dados que contém |
|---|---|
products | Código, nome, unidade de stock, tipo de artigo na BOM, custo padrão |
warehouse_holdings | quantity_in_stock, quantity_on_order, quantity_allocated_bom, free_stock_available, is_default_manufacturing_warehouse |
pop_orders, pop_order_lines | Encomendas de compra em aberto, line_quantity, requested_delivery_dates |
sop_orders, sop_order_lines | Procura dos clientes, requested_delivery_date, promised_delivery_date |
warehouses, units | Instalações e unidades de medida |
2. O complemento de fabrico para as ordens de fabrico. A API do Sage 200 não tem endpoints para ordens de fabrico, operações ou recursos. As ordens de fabrico residem no Sicon Works Order Processing, no Cim200 ou no antigo módulo Sage 200 Manufacturing. A integração lê as ordens de fabrico, as operações e os recursos pela via suportada pelo complemento, acordada consigo e com o seu parceiro Sage 200 durante a definição do âmbito.
Autenticação e acesso
A API do Sage 200 “uses OAuth 2.0 with OpenID Connect” (utiliza OAuth com OpenID Connect), com o fluxo de concessão por código de autorização. O início de sessão é feito através do Sage ID.
- Adira ao Sage 200 API Developer Programme e solicite as credenciais.
- Associe um Sage ID a um utilizador do Sage 200 com acesso à empresa e às funcionalidades necessárias para os endpoints que utiliza.
- Solicite o âmbito
offline_access; caso contrário, não será emitido um token de atualização. - Envie
Authorization: Bearer <access_token>,X-SiteeX-Companyem cada pedido à base de dados. Ambos os IDs são obtidos em/sites.
URL base do Sage 200 Professional: https://api.columbus.sage.com/uk/sage200extra/accounts/v1. Os pedidos utilizam GET, POST, PUT e DELETE, bem como as opções de consulta OData $filter, $select, $top, $skip, $orderby e $expand.
No Sage 200 Professional, o prestador de suporte do cliente ativa a API. Na lista de verificação da Sage, confirma que “the API is enabled” (a API está ativada) e que “each required user has a Sage ID assigned.” (cada utilizador que necessita de acesso tem um Sage ID atribuído). No Sage 200 Standard, a API está ativada por predefinição.
A validade dos tokens condiciona a conceção da integração. Os tokens de acesso são válidos por 8 horas. Os tokens de atualização são válidos entre 1 e 90 dias, e “The refresh window is measured from the user’s initial sign-in, not from the most recent refresh.” (O período de atualização conta-se a partir do início de sessão inicial do utilizador, não da atualização mais recente.) A Sage afirma que uma nova autenticação “is unavoidable” (é inevitável). Preveja um alerta para renovar o consentimento antes de terminar esse período.
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 passo a passo as primeiras chamadas.
Deteção de alterações
A referência da API do Sage 200 não inclui recursos de webhook ou de subscrição. As alterações são detetadas através de consultas periódicas. Os registos contêm date_time_created e date_time_updated, pelo que cada consulta filtra por date_time_updated com $filter e pagina os resultados com $top e $skip.
Consulte as ordens de fabrico em intervalos de poucos minutos e as existências e linhas de encomendas de compra de hora a hora. O SkyPlanner envia webhooks quando a programação muda, pelo que o envio de dados para o sistema de origem é desencadeado por eventos.
Mapeamento de dados
| Objeto do Sage 200 (origem) | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
products, units (API) | Produtos e materiais | Sage 200 → SkyPlanner | Carregamento seguido de consultas periódicas |
| Componentes da BOM (complemento ou módulo BOM) | Estrutura do produto, subprodutos, materiais por produto | Sage 200 → SkyPlanner | A cada alteração |
| Recursos de mão de obra e máquinas, grupos de recursos (complemento) | Centros de trabalho, grupos de centros de trabalho, pessoal | Sage 200 → SkyPlanner | Carregamento inicial |
| Disponibilidade dos recursos: paragens, manutenção, férias (complemento) | Turnos, ausências | Sage 200 → SkyPlanner | Diariamente |
| Ordens de fabrico e respetivas operações, tempos por operação (complemento) | Ordens e tarefas com etapas, durações e prazos | Sage 200 → SkyPlanner | Em intervalos de poucos minutos |
sop_order_lines: requested_delivery_date, promised_delivery_date (API) | Prazos de entrega aos clientes | Sage 200 → SkyPlanner | Consultas periódicas |
warehouse_holdings: quantity_in_stock, free_stock_available (API) | Saldos de existências | Sage 200 → SkyPlanner | De hora a hora |
pop_order_lines: line_quantity, requested_delivery_dates (API) | Encomendas de compra com data de entrega prevista | Sage 200 → SkyPlanner | De hora a hora |
| Início e fim planeados e recurso da operação da ordem de fabrico | Início e fim planeados e centro de trabalho por operação | SkyPlanner → Sage 200 | A cada alteração, via webhook |
| Imputação de tempos às operações (complemento) | Registos de tempo e confirmações dos operadores | SkyPlanner → Sage 200 | Por confirmação ou por turno |
| Dados de restrições do SkyPlanner | Matriz de tempos de preparação, ferramentas como recursos de capacidade limitada, máquinas e pessoal alternativos | Geridos no SkyPlanner | Implementação inicial |
Modelos de integração
1. Carregamento inicial de dados mestre. Obtenha os produtos e as unidades através da API e, em seguida, os recursos, os grupos de recursos e as operações da BOM através do complemento. Um grupo de recursos com três máquinas idênticas pode corresponder a um grupo de centros de trabalho ou a três centros de trabalho.
2. Sincronização de ordens e encomendas. Leia as ordens de fabrico em aberto e as respetivas operações no complemento, bem como as pop_order_lines em aberto e as warehouse_holdings através da API. A programação verifica tanto as existências como as compras por receber. O MRP continua a propor ordens de fabrico no Sage 200, e o SkyPlanner programa as que criar.
3. Escrita da programação no sistema de origem. Para cada operação que o motor programou ou deslocou, o SkyPlanner devolve à ordem de fabrico o início e o fim planeados e o recurso. O complemento mantém as suas próprias quantidades, afetações e cálculo de custos.
4. Confirmações no chão de fábrica. Os operadores registam o trabalho com o SkyPlanner Mobile Confirmations ou o Production Timer, e os registos de tempo mantêm a programação atualizada. O tempo registado é devolvido e imputado à operação da ordem de fabrico, permitindo que o cálculo de custos no Sage 200 tenha em conta as horas reais.
Se a sua fábrica já regista tempos no Sicon Shop Floor Data Capture ou no Cim200 Shop Floor Data Capture, escolha um único canal de registo.
5. Regras de responsabilidade pelos dados e de resolução de conflitos. Documente-as antes da entrada em produção:
| Dados | Responsável |
|---|---|
| Produtos, BOMs, quantidades das ordens de fabrico, afetações, custos | Sage 200 e o complemento |
| Sequência das operações, horas de início e fim, atribuição de centros de trabalho | SkyPlanner |
| Matriz de tempos de preparação, requisitos de ferramentas e operadores, recursos alternativos | SkyPlanner |
| Registo de tempos | Sage 200, alimentado pelos registos de tempos do SkyPlanner |
A principal fonte de conflitos é o gráfico de capacidade. Se os responsáveis pelo planeamento continuarem a arrastar ordens de fabrico ou operações no Sicon Rough Cut Capacity Planning ou no Cim200 Graphical Scheduler, as datas ficam sob o controlo de dois sistemas. Deixe o SkyPlanner gerir as datas das operações. Com o Autopilot, o SkyPlanner reprograma automaticamente a produção sempre que esta sofre alterações.
Etapas habituais do projeto
A implementação fica normalmente concluída em poucas semanas após o início do acompanhamento inicial. Antes disso, valide o programa de produção durante o período de avaliação gratuita de 30 dias, com uma exportação em CSV ou Excel das ordens de fabrico em aberto. O projeto segue depois estas etapas:
- Definição do âmbito. Confirme o complemento e a respetiva versão, a via de leitura das ordens de fabrico, a via de envio de dados para o sistema de origem, as frequências de sincronização e o canal de registo de tempos.
- Acesso à API. O prestador de suporte ativa a API do Sage 200, associa um Sage ID a um utilizador do Sage 200 e define os acessos às empresas e às funcionalidades.
- Carregamento inicial. Produtos, unidades, recursos, grupos de recursos, operações das BOMs e disponibilidade.
- Sincronização de ordens e encomendas. Ordens de fabrico, linhas de encomendas de compra e existências por consulta periódica, com o alerta para renovar o consentimento.
- Configuração das restrições no SkyPlanner. Matriz de tempos de preparação, ferramentas, número de operadores por tarefa e máquinas ou pessoal alternativos.
- Envio da programação para o sistema de origem. As datas planeadas das operações são escritas nas ordens de fabrico; o registo de tempos é acrescentado nesta etapa.
- Testes em paralelo e entrada em produção. Compare as datas com o plano atual, corrija os dados mestre e só depois ative o envio de dados para o sistema de origem.
O que prever numa integração com o Sage 200
- Módulo descontinuado numa nova versão. O antigo módulo Sage 200 Manufacturing não pode ser utilizado a partir do Sage 200 Professional 2025 R2. Antes de fazer qualquer mapeamento, confirme qual será a solução de fabrico em utilização na entrada em produção.
- Tempos das operações calculados a partir dos custos. O Sicon MRP estima os tempos de mão de obra e de máquina a partir dos elementos de custo das BOMs do Sage 200. Comece por os comparar com os tempos reais de execução.
- Divergências nas rubricas de custo. A Sage avisa que os campos Nominal, Overhead Nominal e Overhead Recovery % têm de coincidir nas operações das BOMs e nas rubricas de custo; caso contrário, “there will be cost discrepancies.” (haverá divergências nos custos).
- Prazo de renovação. O limite máximo de 90 dias conta a partir do primeiro início de sessão. Uma integração que nunca renove o consentimento para no mesmo dia de cada trimestre.
- Instalações com várias empresas. Uma instalação pode incluir várias empresas, pelo que deve enviar o
X-Companycorreto em cada pedido.
Integração com o Sage 200: quem a configura e presta suporte
- A equipa SkyPlanner configura a integração durante o acompanhamento inicial e presta suporte após a entrada em produção.
- O seu parceiro Sage 200 pode participar. O parceiro conhece o seu complemento e ativa a API no Sage 200 Professional.
- Os seus próprios programadores podem desenvolver a integração com a mesma REST API documentada, usando um token de API. Basta um token de API para começar, e a equipa SkyPlanner ajuda sempre que necessário.
Depois de estabelecida a ligação, o motor Arcturus programa a produção com base nas ordens de fabrico atualizadas do Sage 200, e as datas planeadas são escritas nas operações dessas ordens. 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 função do seu processo e das suas necessidades, juntamente com o plano escolhido, para que conheça o custo total antes de começar. Consulte os preços, as funcionalidades e a comparação com o planeamento do próprio Sage 200 em Programação da produção no Sage 200, respeitando a capacidade real das máquinas e do pessoal. Encontra uma visão geral na página do Sage 200 e outros ERPs na área de integrações com ERP.
Opiniões de fabricantes sobre o SkyPlanner
2 hpoupadas por semana
“Com o SkyPlanner, passámos de planear a produção em folhas de cálculo Excel para otimizar a produção em tempo real.”
Kalle Kalliomäki, especialista em cadeia de abastecimento
UTU · Quadros elétricos e aparelhagem de comutação
O planeamento da produção permite poupar 2 horas de trabalho por semana, e uma nova fila de tarefas chega à linha em segundos.
Mais de 1.000 ordens de fabrico programadas automaticamente
“Temos um controlo diferente sobre a produção, e o nosso conhecimento da capacidade está num patamar 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, e toda a organização tem uma visão da produção em tempo real.
Perguntas frequentes
A API do Sage 200 inclui ordens de fabrico?
Não. A API do Sage 200 Professional abrange produtos, existências, encomendas de venda e de compra, dados financeiros e outras áreas, mas não disponibiliza recursos de API para ordens de fabrico ou operações. As ordens de fabrico são obtidas a partir do seu complemento de fabrico, como o Sicon Works Order Processing ou o Cim200, pela via acordada na definição do âmbito.
Quem desenvolve a integração com o Sage 200?
A equipa SkyPlanner configura a integração bidirecional com a sua instalação do Sage 200 durante o acompanhamento inicial e presta suporte após a entrada em produção. O seu parceiro Sage 200 ativa a API e pode participar. Os seus próprios programadores também podem desenvolver a integração com a REST API documentada do SkyPlanner, e basta um token de API para começar.
O Sage 200 pode enviar alterações em tempo real?
A API do Sage 200 não tem webhooks. As existências e as encomendas de compra são consultadas periodicamente com base em date_time_updated, e as ordens de fabrico são lidas a partir do seu complemento de poucos em poucos minutos. No sentido inverso, os webhooks do próprio SkyPlanner enviam as alterações ao programa de produção assim que ocorrem.
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 das suas ordens de fabrico 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.
