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 a parceiros de negócios e equipes de TI como conectar o Sage 200 Professional e seu complemento de manufatura ao SkyPlanner APS. A integração entre SkyPlanner e Sage 200 é bidirecional:
- Produtos, saldos por depósito, pedidos de compra e pedidos de venda são importados pela Sage 200 REST API.
- Ordens de produção, operações e recursos de mão de obra e máquinas são importados do complemento de manufatura.
- As datas planejadas das operações são enviadas de volta às ordens de produção.
- Os registros de tempo dos operadores retornam para o apontamento de horas em cada operação.
Durante a implantação, a equipe do SkyPlanner configura a integração conforme o seu ambiente Sage 200 e dá suporte após a entrada em produção. Este guia é voltado a parceiros e desenvolvedores que querem participar ou desenvolver por conta própria com a REST API documentada do SkyPlanner (referência da API).
Duas fontes em um único sistema Sage 200
Uma instalação do Sage 200 usada na manufatura tem duas camadas, e a integração lê dados de ambas.
1. A Sage 200 REST API para dados comerciais e de estoque. Segundo a Sage, a API “lets your application read and modify data in a Sage 200 site” (permite que seu aplicativo leia e altere dados nessa instalação). Isso abrange clientes, fornecedores, produtos, pedidos de venda e de compra e contas contábeis. A referência do Sage 200 Professional (2025.02) agrupa seus 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 disponíveis |
|---|---|
products | Código, nome, unidade de estoque, tipo de item da 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 | Pedidos de compra em aberto, line_quantity, requested_delivery_dates |
sop_orders, sop_order_lines | Demanda dos clientes, requested_delivery_date, promised_delivery_date |
warehouses, units | Locais e unidades de medida |
2. O complemento de manufatura para ordens de produção. A API do Sage 200 não tem endpoints para ordens de produção, operações ou recursos. As ordens de produção ficam no Sicon Works Order Processing, no Cim200 ou no módulo legado Sage 200 Manufacturing. A integração lê ordens de produção, operações e recursos pelo meio de acesso compatível com o complemento, acordado com você e seu parceiro Sage 200 na definição de escopo.
Autenticação e acesso
A API do Sage 200 “uses OAuth 2.0 with OpenID Connect” (usa OAuth com OpenID Connect), com o fluxo de concessão por código de autorização. O login é feito pelo Sage ID.
- Inscreva-se no Sage 200 API Developer Programme e solicite as credenciais.
- Vincule um Sage ID a um usuário do Sage 200 com acesso à empresa e às funcionalidades correspondentes aos endpoints utilizados.
- Solicite o escopo
offline_access; caso contrário, nenhum token de atualização será emitido. - Envie
Authorization: Bearer <access_token>,X-SiteeX-Companyem todas as requisições ao banco 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. As requisições usam GET, POST, PUT e DELETE, além das opções de consulta OData $filter, $select, $top, $skip, $orderby e $expand.
No Sage 200 Professional, o prestador de suporte do cliente habilita a API. Na lista de verificação da Sage, ele confirma que “the API is enabled” (a API está habilitada) e que “each required user has a Sage ID assigned.” (cada usuário que precisa de acesso tem um Sage ID atribuído). No Sage 200 Standard, a API já vem habilitada por padrão.
A validade dos tokens influencia o projeto da integração. Os tokens de acesso duram 8 horas. Os tokens de atualização duram entre 1 e 90 dias, e “The refresh window is measured from the user’s initial sign-in, not from the most recent refresh.” (a janela de atualização é contada a partir do login inicial do usuário, não da atualização mais recente). A Sage afirma que a reautenticação “is unavoidable” (é inevitável). Preveja um alerta para renovar o consentimento antes que essa janela termine.
No SkyPlanner, a autenticação na REST API usa um token de API (SkyPlanner Settings > API), e a documentação está em Swagger/OpenAPI. O tutorial de integração orienta as primeiras chamadas.
Detecção de alterações
A referência da API do Sage 200 não inclui recursos de webhook ou assinatura. As alterações são detectadas por consultas periódicas. Os registros contêm date_time_created e date_time_updated; assim, cada consulta usa $filter sobre date_time_updated para filtrar os resultados e $top e $skip para paginá-los.
Consulte as ordens de produção a cada poucos minutos e os saldos de estoque e itens dos pedidos de compra a cada hora. O SkyPlanner envia webhooks quando a programação muda, portanto o envio de dados de volta é acionado por eventos.
Mapeamento de dados
| Objeto do Sage 200 (origem) | Objeto do SkyPlanner | Direção | Frequência |
|---|---|---|---|
products, units (API) | Produtos e materiais | Sage 200 → SkyPlanner | Carga inicial, seguida 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 | Carga inicial |
| Disponibilidade dos recursos: paradas, manutenção, férias e feriados (complemento) | Turnos, ausências | Sage 200 → SkyPlanner | Diariamente |
| Ordens de produção e suas operações, tempos por operação (complemento) | Ordens e operações com etapas, durações e prazos | Sage 200 → SkyPlanner | A cada 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 estoque | Sage 200 → SkyPlanner | A cada hora |
pop_order_lines: line_quantity, requested_delivery_dates (API) | Pedidos de compra com data prevista de entrega | Sage 200 → SkyPlanner | A cada hora |
| Início e término planejados e recurso da operação na ordem de produção | Início e término planejados e centro de trabalho por operação | SkyPlanner → Sage 200 | A cada alteração, via webhook |
| Apontamento de horas por operação (complemento) | Registros de tempo e confirmações dos operadores | SkyPlanner → Sage 200 | A cada confirmação ou por turno |
| Dados de restrições do SkyPlanner | Matriz de tempos de preparação, ferramentas como recursos de capacidade finita, máquinas e pessoal alternativos | Mantidos no SkyPlanner | Durante a implantação |
Padrões de integração
1. Carga inicial de dados mestres. Importe produtos e unidades pela API e, em seguida, recursos, grupos de recursos e operações da BOM pelo complemento. Um grupo de recursos com três máquinas idênticas pode ser representado por um grupo de centros de trabalho ou por três centros de trabalho.
2. Sincronização de ordens. Leia as ordens de produção em aberto com suas operações no complemento, além dos registros em aberto de pop_order_lines e dos dados de warehouse_holdings pela API. A programação verifica tanto o estoque quanto as compras previstas para recebimento. O MRP continua propondo ordens de produção no Sage 200, e o SkyPlanner programa as que você criar.
3. Retorno da programação. Para cada operação que o mecanismo programou ou moveu, o SkyPlanner envia de volta à ordem de produção o início e o término planejados e o recurso. O complemento mantém suas próprias quantidades, alocações e apuração de custos.
4. Confirmações no chão de fábrica. Os operadores registram o trabalho pelo SkyPlanner Mobile Confirmations ou pelo Production Timer, e os registros de tempo mantêm a programação atualizada. O tempo registrado retorna como horas apontadas na operação da ordem de produção, para que a apuração de custos no Sage 200 considere as horas reais.
Se sua fábrica já aponta horas no Sicon Shop Floor Data Capture ou no Cim200 Shop Floor Data Capture, escolha um único canal de apontamento.
5. Responsabilidade pelos dados e regras de conflito. Documente essas regras antes da entrada em produção:
| Dados | Responsável |
|---|---|
| Produtos, BOMs, quantidades das ordens de produção, alocações, custos | Sage 200 e o complemento |
| Sequência das operações, horários de início e término, atribuição de centros de trabalho | SkyPlanner |
| Matriz de tempos de preparação, requisitos de ferramentas e operadores, recursos alternativos | SkyPlanner |
| Apontamento de horas | Sage 200, alimentado pelos registros de tempo do SkyPlanner |
A principal fonte de conflitos é o gráfico de capacidade. Se os planejadores continuarem arrastando ordens de produção ou operações no Sicon Rough Cut Capacity Planning ou no Cim200 Graphical Scheduler, dois sistemas passam a controlar as datas. Deixe o SkyPlanner controlar as datas das operações. Com o Autopilot, o SkyPlanner reprograma automaticamente quando há mudanças na produção.
Etapas típicas do projeto
A implantação normalmente é concluída em semanas após o início do onboarding. Antes disso, valide a programação no teste gratuito de 30 dias com uma exportação em CSV ou Excel das ordens de produção em aberto. O projeto segue estas etapas:
- Definição de escopo. Confirme o complemento e a versão, o método de leitura das ordens de produção, o método de envio dos dados de volta, as frequências de sincronização e o canal de apontamento de horas.
- Acesso à API. O prestador de suporte habilita a API do Sage 200, vincula um Sage ID a um usuário do Sage 200 e define o acesso às empresas e funcionalidades.
- Carga inicial. Produtos, unidades, recursos, grupos de recursos, operações das BOMs e disponibilidade.
- Sincronização de ordens e pedidos. Ordens de produção, linhas de pedidos de compra e estoque por consultas periódicas, com alerta para renovação do consentimento.
- Configuração de restrições no SkyPlanner. Matriz de tempos de preparação, ferramentas, número de operadores por operação e máquinas ou pessoal alternativos.
- Retorno da programação. As datas planejadas das operações são gravadas nas ordens de produção; o apontamento de horas é adicionado nesta etapa.
- Testes em paralelo e entrada em produção. Compare as datas com o plano atual, corrija os dados mestres e só então ative o envio dos dados de volta.
O que considerar ao planejar uma integração com o Sage 200
- Módulo descontinuado na nova versão. O módulo legado Sage 200 Manufacturing não pode ser usado a partir do Sage 200 Professional 2025 R2. Antes de mapear qualquer dado, confirme qual solução de manufatura estará ativa na entrada em produção.
- Tempos de operação estimados a partir dos custos. O Sicon MRP estima os tempos de mão de obra e de máquina com base nos itens de custo das BOMs do Sage 200. Primeiro, confira essas estimativas com os tempos reais de execução.
- Divergências nas categorias de custo. A Sage alerta que Nominal, Overhead Nominal e Overhead Recovery % devem coincidir nas operações das BOMs e nas categorias de custo; caso contrário, “there will be cost discrepancies.” (haverá divergências de custo).
- Prazo de renovação. O prazo máximo de 90 dias é contado a partir do primeiro login. Uma integração que nunca renova o consentimento para de funcionar no mesmo dia a cada trimestre.
- Sites com várias empresas. Um site pode conter várias empresas, por isso envie o
X-Companycorreto em cada requisição.
Integração com o Sage 200: quem configura e dá suporte
- A equipe do SkyPlanner configura a integração durante a implantação e dá suporte após a entrada em produção.
- Seu parceiro comercial Sage 200 pode participar. O parceiro conhece seu complemento e habilita a API no Sage 200 Professional.
- Seus próprios desenvolvedores podem ampliar a integração usando a mesma REST API documentada, com um token de API. Basta um token de API para começar, e a equipe do SkyPlanner ajuda quando necessário.
Com a conexão estabelecida, o mecanismo Arcturus gera a programação a partir das ordens de produção atualizadas do Sage 200, e as datas planejadas são gravadas nas operações dessas ordens. 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, de acordo com seu processo e suas necessidades, junto com o plano, para que você conheça o custo total antes de começar. Consulte os preços, as funcionalidades e compare com o planejamento nativo do Sage 200 em programação da produção no Sage 200 com respeito à capacidade real de máquinas e pessoal. A visão geral está na página do Sage 200, e os demais ERPs estão na central de integrações com ERP.
Avaliações do SkyPlanner por fabricantes
2 heconomizadas por semana
“O SkyPlanner levou nosso planejamento da produção das planilhas de Excel à otimização da produção em tempo real.”
Kalle Kalliomäki, especialista em cadeia de suprimentos
UTU · Quadros elétricos e equipamentos de manobra
O planejamento da produção economiza 2 horas de trabalho por semana, e uma nova fila de operações chega à linha em segundos.
Mais de 1.000 ordens de produção programadas automaticamente
“Temos um novo nível de controle sobre a produção, e nossa compreensão da capacidade está em um patamar completamente diferente.”
Hannu Ryynänen, diretor executivo
Mamec · Misturadores industriais, bombas e fabricação sob contrato de alta tecnologia
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.
Perguntas frequentes
A API do Sage 200 inclui ordens de produção?
Não. A API do Sage 200 Professional abrange produtos, estoque, pedidos de venda e de compra, finanças e outros dados, mas não oferece recursos de ordens de produção ou operações. As ordens de produção vêm do seu complemento de manufatura, como Sicon Works Order Processing ou Cim200, pelo método acordado na definição de escopo.
Quem desenvolve a integração com o Sage 200?
A equipe do SkyPlanner configura a integração bidirecional para o seu ambiente Sage 200 durante a implantação e dá suporte após a entrada em produção. Seu parceiro comercial Sage 200 habilita a API e pode participar. Seus próprios desenvolvedores também podem desenvolver usando 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. O estoque e os pedidos de compra são consultados periodicamente com base em date_time_updated, e as ordens de produção são lidas do seu complemento a cada poucos minutos. No sentido inverso, os webhooks do próprio SkyPlanner enviam as alterações da programação assim que elas ocorrem.
Podemos testar o SkyPlanner antes de desenvolver a integração?
Sim. O teste gratuito de 30 dias permite usar até 20 centros de trabalho e importar suas ordens de produção em CSV ou Excel, sem precisar de cartão de crédito. Inicie o teste ou fale com a equipe de vendas para definir o escopo da integração.
