Integrações / ERP / Sage 100
Guia de integração do Sage 100 para planejamento da produção com SkyPlanner APS
Este guia de integração do Sage 100 mostra aos parceiros Sage e às equipes de TI como conectar o Sage 100 ao SkyPlanner APS. Ele abrange os dois produtos com esse nome: o Sage 100 dos Estados Unidos e do Canadá, com Production Management, e o Sage 100 da Alemanha e da Áustria, com Sage 100 Produktion. A integração entre SkyPlanner e Sage 100 funciona nos dois sentidos:
- As ordens de produção, chamadas de work tickets ou Fertigungsaufträge, são importadas com suas etapas ou Arbeitsgänge, junto com centros de trabalho, itens, estoques e pedidos de compra.
- As datas planejadas são enviadas de volta para cada etapa ou Arbeitsgang.
- Os apontamentos de horas dos operadores são enviados de volta como lançamentos de mão de obra (US) ou Rückmeldungen (DE).
A equipe SkyPlanner configura a integração de acordo com o seu ambiente Sage 100 durante a implantação e oferece suporte após a entrada em produção. Este guia é para parceiros e desenvolvedores que desejam participar do processo ou desenvolver a integração por conta própria usando a REST API documentada do SkyPlanner (referência da API).
Sage 100 dos EUA: interfaces de integração
O Sage 100 dos EUA é executado em ambiente local, nas versões Standard, Advanced ou Premium. Suas interfaces de integração ficam no servidor do Sage 100.
Business Object Interface (BOI).
“The Business Objects Interface allows third-party developers with the necessary skills to access Sage 100 programs and applications using Component Object Model (COM).” (A Business Objects Interface permite que desenvolvedores externos com as competências necessárias acessem programas e aplicações do sistema usando Component Object Model (COM).) (Ajuda do Sage 100) O portal de desenvolvedores da Sage a descreve como “Sage 100’s internal API layer, giving you access to the same logic used by the application itself.” (A camada interna de API do sistema, que dá acesso à mesma lógica usada pela própria aplicação.) (developer.sage.com) A BOI é o caminho para gravação: toda criação ou atualização passa pelas mesmas validações aplicadas às ações de um usuário no Sage 100.
ODBC.
O driver ProvideX ODBC lê as tabelas do Sage 100 para gerar relatórios e realizar leituras em lote. Na versão Advanced, há um driver ODBC cliente/servidor disponível. A integração usa ODBC para ler ordens de produção, itens e pedidos de compra em lote, e BOI para gravar dados.
Visual Integrator (VI).
As rotinas de importação e exportação do VI transferem dados entre o Sage 100 e arquivos ou fontes ODBC. Segundo a Sage: “One of the most powerful features of the Visual Integrator module is its ability to directly import data from and export data to an ODBC data source.” (Um dos recursos mais poderosos do módulo Visual Integrator é a capacidade de importar e exportar dados diretamente de e para uma fonte de dados ODBC.) (fonte) O VI faz parte do pacote Essentials e é adequado para a troca de dados por arquivos.
eBusiness Web Services usa SOAP e abrange “the Sage 100 sales order, customer, and customer contact entities.” (As entidades de pedidos de venda, clientes e contatos de clientes do sistema.) (fonte) Ele pode transferir pedidos de venda, enquanto os dados de produção passam por BOI e ODBC.
A integração é executada junto ao Sage 100, com um usuário do Sage 100 que tenha permissão para as tarefas utilizadas nos módulos Production Management, Inventory e Purchase Order. O tráfego de saída segue para a REST API do SkyPlanner via HTTPS.
Sage 100 alemão: interfaces de integração
O Sage 100 alemão usa Microsoft SQL Server, com instalação local ou na versão em nuvem. Segundo a Sage, é possível “Partnerlösungen via API-Schnittstelle ergänzen” (adicionar soluções de parceiros por meio de uma interface de API) (Sage 100). Os complementos de produção listados pela Sage são desenvolvidos com base no Sage AppDesigner e nos objetos de negócio do Sage 100.
A integração segue o mesmo caminho das soluções de parceiros Sage: lê Fertigungsaufträge, Arbeitsgänge, Arbeitsplätze, Ressourcenlisten, Artikel e Bestellungen no banco de dados SQL Server do Sage 100. As datas de Arbeitsgang e as Rückmeldungen são enviadas de volta pelo caminho de gravação definido pelo seu parceiro Sage e pela equipe SkyPlanner na definição de escopo. Assim, os lançamentos seguem a lógica do próprio Sage 100. Seu parceiro Sage confirma a versão (por exemplo, 9.0) e a configuração de acesso.
Autenticação e acesso
| Sistema | Forma de autenticação |
|---|---|
| Sage 100 dos EUA, BOI | Sessão de usuário do Sage 100 no servidor do Sage 100, com permissões de perfil para cada tarefa utilizada |
| Sage 100 dos EUA, ODBC | DSN na instalação do Sage 100, com acesso de leitura |
| Sage 100 alemão | Usuário do Sage 100 para gravação de retorno e acesso de leitura ao SQL Server, conforme acordado com seu parceiro Sage |
| SkyPlanner | Token de API no cabeçalho Authorization-Token, criado no SkyPlanner em Configurações > API |
A REST API do SkyPlanner está documentada em Swagger/OpenAPI. O tutorial de integração mostra passo a passo como fazer as primeiras chamadas.
Detecção de alterações
As alterações no Sage 100 são identificadas por leituras agendadas. Leia as ordens de produção em aberto, ou Fertigungsaufträge, em intervalos curtos, e os estoques e pedidos de compra a cada hora. Filtre por status e data de alteração para que cada leitura traga apenas o que mudou.
O SkyPlanner envia webhooks quando a programação muda. Assim, a gravação de retorno no Sage 100 é acionada por eventos.
Mapeamento de dados
| Sage 100 (US) | Sage 100 (DE) | Objeto no SkyPlanner | Sentido | Frequência |
|---|---|---|---|---|
| Item | Artikel | Produtos e materiais | Sage 100 → SkyPlanner | Carga inicial e, depois, diariamente |
| Bill of Materials, materiais do modelo | Stückliste na Ressourcenliste | Estrutura do produto, subprodutos e materiais por produto | Sage 100 → SkyPlanner | A cada alteração |
| Centro de trabalho: operadores ou máquinas, horas por dia da semana e períodos sem expediente | Arbeitsplatz, Ressource (Mitarbeiter, Maschine) | Centros de trabalho, grupos de centros de trabalho, pessoal e turnos | Sage 100 → SkyPlanner | Carga inicial |
| Etapas do modelo de ordem de produção e códigos de atividade | Arbeitsplan, Arbeitsgänge com Rüst- e Stückzeiten | Etapas do processo com tempos de preparação e execução | Sage 100 → SkyPlanner | A cada alteração |
| Ordem de produção com etapas e prazo de entrega | Fertigungsauftrag com Arbeitsgänge e Liefertermin | Ordens e operações com prazos de entrega | Sage 100 → SkyPlanner | Leitura em intervalos curtos |
| Quantidades em estoque por armazém | Lagerbestand | Saldos de estoque | Sage 100 → SkyPlanner | A cada hora |
| Itens dos pedidos de compra e datas de necessidade | Bestellungen, Liefertermine | Pedidos de compra com data prevista de entrega | Sage 100 → SkyPlanner | A cada hora |
| Itens dos pedidos de venda e datas de entrega prometidas | Kundenaufträge | Prazos de entrega e prioridade do cliente | Sage 100 → SkyPlanner | Leitura em intervalos curtos |
| Datas das etapas da ordem de produção (BOI) | Arbeitsgang-Termine | Início, fim e centro de trabalho planejados por etapa | SkyPlanner → Sage 100 | A cada alteração, via webhook |
| Labor Entry, conclusão da ordem de produção (BOI) | Rückmeldung: tempos e quantidades | Apontamentos de horas e confirmações dos operadores | SkyPlanner → Sage 100 | A cada confirmação ou por turno |
| Não armazenado no Sage 100 | Não armazenado no Sage 100 | Matriz de tempos de preparação, ferramentas como recursos finitos, operadores por operação e centros de trabalho alternativos | Mantido no SkyPlanner | Implantação |
Padrões de integração
1. Carga inicial dos dados mestres. Carregue primeiro os itens e centros de trabalho, depois os modelos ou Arbeitspläne com suas etapas. Um centro de trabalho da versão dos EUA com três máquinas e dois operadores se torna três centros de trabalho, um grupo de centros de trabalho e duas pessoas no SkyPlanner. Cada um passa a ter sua própria linha do tempo.
2. Sincronização de ordens. Leia as ordens de produção em aberto, ou Fertigungsaufträge, com suas etapas, além dos estoques e pedidos de compra em aberto. O SkyPlanner verifica tanto o estoque quanto as entregas previstas antes de programar uma operação. O Sage 100 continua propondo o que produzir, e o SkyPlanner programa as ordens que você libera.
3. Gravação de retorno da programação. Para cada etapa programada ou movida pelo motor, o SkyPlanner envia o início, o fim e o centro de trabalho planejados. No Sage 100 dos EUA, a integração atualiza as datas das etapas da ordem de produção via BOI. No Sage 100 alemão, atualiza as datas de Arbeitsgang pelo caminho estabelecido na definição de escopo. As quantidades, alocações e o cálculo de custos continuam no Sage 100.
4. Apontamentos 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. No Sage 100 dos EUA, o tempo registrado gera uma Labor Entry vinculada à etapa da ordem de produção, e o apontamento final conclui a ordem. No Sage 100 alemão, ele gera uma Rückmeldung com tempos e quantidades. Se sua fábrica já aponta horas no Betriebsdatenerfassung ou em um aplicativo de código de barras, escolha um único canal de apontamento.
5. Responsabilidades e regras para conflitos. Documente essas regras antes da entrada em operação:
| Dados | Responsável |
|---|---|
| Itens, listas de materiais, modelos, quantidades das ordens, custos | Sage 100 |
| Sequência das etapas, horários de início e término, atribuição de centros de trabalho | SkyPlanner |
| Matriz de tempos de preparação, ferramentas, operadores por operação, recursos alternativos | SkyPlanner |
| Mão de obra e Rückmeldungen | Sage 100, alimentado pelos registros de tempo do SkyPlanner |
A principal fonte de conflitos é o uso de um segundo sistema de programação. Se os planejadores continuarem executando o Enhanced Scheduling no Sage 100 dos EUA ou arrastando tarefas na Plantafel do Sage 100 alemão, dois sistemas passarão a controlar as datas. Deixe as datas das etapas sob o controle do SkyPlanner. Com o Autopilot, o SkyPlanner reprograma automaticamente quando há mudanças na produção.
Etapas típicas do projeto
A implementação normalmente é concluída em poucas semanas após o início da implantação. 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 ou dos Fertigungsaufträge. O projeto segue estas etapas:
- Definição de escopo. Confirme o produto (Sage 100 dos EUA ou alemão), a versão e a instalação, as vias de leitura e gravação, as frequências de sincronização e o canal de apontamento de horas.
- Acesso. Seu parceiro Sage configura o usuário do Sage 100, suas permissões e o acesso ao banco de dados.
- Carga inicial. Itens, centros de trabalho, modelos ou Arbeitspläne, listas de materiais e turnos.
- Sincronização de ordens. Sincronização periódica de ordens de produção ou Fertigungsaufträge, pedidos de compra e estoque.
- 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.
- Gravação da programação no Sage 100. Envio das datas planejadas das etapas e, em seguida, dos apontamentos de mão de obra e das Rückmeldungen.
- Testes em paralelo e entrada em operação. Compare as datas com o plano atual, corrija os dados mestres e só então ative a gravação de retorno.
O que considerar ao planejar uma integração com o Sage 100
- Saiba qual Sage 100 você utiliza. O Sage 100 dos EUA e o alemão têm modelos de dados e interfaces diferentes. Informe o produto e a versão já na primeira reunião de definição de escopo.
- Centros de trabalho que agrupam várias máquinas. Na versão dos EUA, cada centro de trabalho é uma unidade de capacidade composta por “one or more persons or machines” (uma ou mais pessoas ou máquinas). Decida, para cada centro de trabalho, se ele será representado no SkyPlanner como um centro de trabalho, vários centros de trabalho ou um grupo.
- Tempos de preparação e execução. Os modelos e os Arbeitspläne contêm os tempos que o SkyPlanner usa na programação. Compare-os com os tempos reais de execução antes da entrada em operação.
- Calendários. Na versão dos EUA, os centros de trabalho contêm as horas disponíveis por dia da semana e os períodos sem expediente. Carregue esses dados como turnos no SkyPlanner e depois adicione os turnos e as ausências de cada operador no SkyPlanner.
- Unidades de medida. As etapas podem ser executadas por peça, por lote ou por hora. Mapeie a unidade de cada etapa.
- Permissões do BOI. O BOI segue o controle de acesso por funções do Sage 100. A falta de permissão para uma tarefa impede a gravação. Teste cada gravação com o usuário da integração.
- Um único responsável pelas datas. Quando o SkyPlanner passar a controlar as datas, desative as execuções paralelas de programação e as movimentações na Plantafel.
Integração com o Sage 100: 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 operação.
- Seu parceiro Sage pode participar. Ele conhece sua versão do Sage 100, configura usuários e permissões e confirma o acesso ao banco de dados.
- Seus próprios desenvolvedores podem ampliar a integração usando a REST API documentada do SkyPlanner. 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 programa a produção com base nas ordens atualizadas do Sage 100, e cada etapa recebe suas datas planejadas. 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 seu plano, de acordo com seus processos e necessidades, para que você conheça o custo total antes de começar. Veja os preços, os recursos e a comparação com o planejamento nativo do Sage 100 em programação com capacidade finita no Sage 100. A visão geral está na página do Sage 100. O Sage 200 e o Sage X3 têm guias próprios nas páginas do Sage 200 e do Sage X3. Outros ERPs estão na central de integrações com ERP.
Avaliações do SkyPlanner por fabricantes
6 mesesde capacidade disponível visível para a equipe de vendas
“O SkyPlanner oferece a base e a confiabilidade para todo o planejamento da produção.”
Anu Järvinen, gerente de produção
Fredman Operations · Papéis para embalagens adequados para contato com alimentos
A equipe de vendas visualiza a capacidade disponível com seis meses de antecedência, e as solicitações de alteração da programação, que levavam uma hora ou mais, são respondidas em segundos.
100%de pontualidade de entrega desde 2021
“O SkyPlanner nos dá visibilidade da capacidade e torna o planejamento previsível.”
Dan Berglund, COO/CFO
Opes Corporation · Indústria química e alimentícia
A pontualidade de entrega se mantém em 100% durante todo o período de uso do SkyPlanner, desde 2021.
Perguntas frequentes
O Sage 100 tem uma REST API para ordens de produção?
O Sage 100 dos EUA disponibiliza sua lógica de negócios pela Business Object Interface, com ODBC para leituras e Visual Integrator para tarefas com arquivos. O SkyPlanner lê as ordens de produção por ODBC e BOI e grava as datas das etapas e os apontamentos de mão de obra por BOI. No Sage 100 alemão, a leitura é feita diretamente no banco de dados SQL Server, e a via de gravação é definida com seu parceiro Sage durante a definição de escopo.
Quem desenvolve a integração com o Sage 100?
A equipe do SkyPlanner configura a integração bidirecional de acordo com o seu ambiente Sage 100 durante a implantação e dá suporte após a entrada em operação. Seu parceiro Sage configura usuários, permissões e acesso ao banco de dados e pode participar do projeto. Seus próprios desenvolvedores também podem usar a REST API documentada do SkyPlanner para desenvolver a integração. Basta um token de API para começar.
Como as datas planejadas são gravadas no Sage 100?
No Sage 100 dos EUA, a integração atualiza por BOI as datas planejadas de cada etapa da ordem de produção e lança Labor Entry a partir dos registros de tempo dos operadores. No Sage 100 alemão, ela atualiza as datas dos Arbeitsgang de cada Fertigungsauftrag e registra Rückmeldungen pela via de gravação definida pelo seu parceiro Sage e pela equipe do SkyPlanner durante a definição de escopo.
O Sage 100 pode enviar alterações em tempo real?
O SkyPlanner captura as alterações do Sage 100 por meio de leituras agendadas: ordens em aberto em intervalos curtos, estoque e pedidos de compra a cada hora. No sentido inverso, os webhooks do SkyPlanner enviam as alterações do planejamento da produçã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 com importações em CSV ou Excel das suas ordens de produção ou dos Fertigungsaufträge, 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.
