Integrações / ERP / JobBOSS²
Guia de integração do JobBOSS² para programação da produção com o SkyPlanner APS
Este guia de integração do JobBOSS² mostra aos parceiros e às equipas de TI como ligar o JobBOSS² da ECI ao SkyPlanner APS. O SkyPlanner integra-se com o JobBOSS² nos dois sentidos, através das próprias APIs da ECI:
- São importados Orders e Order Line Items, Order Routings, Estimates, Routings e materiais, Work Centers, Employees, Company Calendar, Job Requirements e linhas de encomendas de compra.
- As datas de início e fim planeadas são enviadas de volta para cada etapa de Order Routing.
- Se assim o pretender, os registos de tempo dos operadores podem ser enviados de volta como Time Ticket Details.
- Os webhooks do SkyPlanner enviam as alterações à programação assim que ocorrem.
Durante a implementação inicial, a equipa do SkyPlanner configura a integração de acordo com a configuração do seu JobBOSS² e assegura o suporte após a entrada em produção. Este guia destina-se a parceiros e programadores que queiram participar ou desenvolver as suas próprias soluções com base na REST API documentada do SkyPlanner (referência da API). Uma empresa de produção por encomenda dos EUA já fez precisamente isso:
Interfaces de integração do JobBOSS²
A ECI publica as suas APIs para a indústria, com especificações OpenAPI, no site de documentação das APIs da ECI Manufacturing. Duas são relevantes para a programação da produção:
- JobBOSS² API (v1). Utiliza REST e JSON e é específica do JobBOSS². Permite ler e escrever encomendas, Order Line Items, Order Routings, Estimates, Routings, materiais, Job Requirements, Work Centers, Company Calendar, Employees, encomendas de compra, Time Tickets e Time Ticket Details. A ECI afirma que “is currently only supported for JobBOSS² hosted (Cloud) customers.” (atualmente, só é suportada para clientes com JobBOSS² alojado na nuvem).
- ECI ERP API (v2.1). Uma REST API independente do produto, para Deacom, M1 e JobBOSS². No JobBOSS², abrange tarefas, operações e materiais das tarefas, peças, operações das peças, centros de trabalho, linhas de encomendas de compra e linhas de registos de tempo. A ECI refere que “the actual ERP database could be a cloud hosted ERP or on premises install,” (a base de dados do ERP pode estar alojada na nuvem ou instalada localmente), pelo que esta é a via para o JobBOSS² instalado localmente.
Ambas as APIs seguem as mesmas convenções: expressões de filtragem como lastModDate[gte]=, um parâmetro fields=, sort= e paginação com take e skip, sendo 200 o valor predefinido de take. “All dates submitted to the API are assumed to be in UTC.” (Todas as datas enviadas à API são consideradas em UTC.)
A regra da ECI para ambas é: “All APIs must be activated by ECI before use.” (Todas as APIs têm de ser ativadas pela ECI antes de serem utilizadas.) Faça este pedido ao seu gestor de conta da ECI com antecedência.
Autenticação e acesso
- Utilizadores da API. A integração utiliza um utilizador da API criado na Integration Engine Management Console da ECI. Esse utilizador determina o produto, o cliente e a base de dados a que as chamadas acedem.
- Credenciais de cliente OAuth 2.0. O ID e o segredo do cliente permitem obter um token no endpoint de tokens da Authentication API. Cada chamada envia depois
Authorization: Bearer [token]. - Âmbito de acesso. Conceda ao utilizador da API acesso apenas aos recursos necessários para a tabela de mapeamento abaixo.
Do lado do SkyPlanner, a REST API autentica-se com um token de API (SkyPlanner Settings > API) e está documentada em Swagger/OpenAPI. O tutorial de integração explica passo a passo as primeiras chamadas.
Eventos e consultas periódicas
Nenhuma das APIs da ECI documenta webhooks. Os dados do JobBOSS² são obtidos por consultas periódicas: filtre Order Line Items, Order Routings e linhas de encomendas de compra por lastModDate desde a última execução e use take e skip para a paginação. A frequência é definida para cada unidade de produção: de poucos em poucos minutos para as tarefas e de hora a hora para as existências.
O SkyPlanner envia webhooks quando o estado ou a programação mudam, pelo que o envio de dados de volta é acionado por eventos.
Mapeamento de dados
| Objeto do JobBOSS² (recurso da JobBOSS² API) | Objeto do SkyPlanner | Sentido | Frequência |
|---|---|---|---|
Estimates (/estimates), materiais (/materials) | Produtos, materiais, estrutura do produto | JobBOSS² → SkyPlanner | Carga inicial e, depois, a cada alteração |
Routings (/routings): centro de trabalho, tempo de preparação, tempo de ciclo, dimensão da equipa, máquinas para a tarefa | Etapas do processo com durações e tempos de preparação | JobBOSS² → SkyPlanner | Carga inicial e, depois, a cada alteração |
Work Centers (/work-centers): horas por turno, funcionamento nos turnos 1 a 3, dias de trabalho | Centros de trabalho, grupos de centros de trabalho, eficiências | JobBOSS² → SkyPlanner | Carga inicial; raramente depois |
Company Calendar (/company-calendars), Employees (/employees) | Turnos, dias não úteis, pessoal | JobBOSS² → SkyPlanner | Diariamente, ou gestão dos turnos no SkyPlanner |
Orders e Order Line Items (/order-line-items): número da tarefa, data de entrega, prioridade, quantidade a produzir | Encomendas com datas de entrega e prioridades | JobBOSS² → SkyPlanner | Consultas de poucos em poucos minutos |
Order Routings (/order-routings): etapas da tarefa, estado, horas restantes | Tarefas por etapa do processo | JobBOSS² → SkyPlanner | Consultas de poucos em poucos minutos |
Job Requirements (/job-requirements), linhas de encomendas de compra (/purchase-order-line-items) | Necessidades de materiais, encomendas de compra por data de entrega | JobBOSS² → SkyPlanner | Consultas de hora a hora ou ao executar a programação |
Order Routing: estimatedStartDate, estimatedEndDate, workCenter, employeeCode (PATCH) | Início e fim planeados, máquina e operador por etapa | SkyPlanner → JobBOSS² | A cada alteração da programação, via webhook do SkyPlanner |
| Time Ticket Details (POST): tarefa, etapa, centro de trabalho, funcionário, tempo de preparação, tempo de ciclo, peças concluídas e enviadas para sucata, hora de início e fim | Registos de tempo e confirmações dos operadores | SkyPlanner → JobBOSS² | Por confirmação ou por turno, se essa opção for escolhida |
| Não existe no JobBOSS² | Matriz de tempos de preparação e transição, ferramentas como recursos de capacidade limitada, máquinas e pessoal alternativos | Gerido no SkyPlanner | Configurado durante a implementação inicial |
No JobBOSS² instalado localmente, os mesmos objetos são lidos através dos recursos da ERP API /jobs, /job-operations, /job-materials, /parts, /part-operations, /work-centers e /purchase-order-lines, e os registos de tempo são enviados para /timecard-lines.
Modelos de integração
1. Carga inicial de dados mestre. Leia Estimates, Routings, materiais, Work Centers, Company Calendar e Employees. Defina cuidadosamente o mapeamento dos centros de trabalho: um centro de trabalho com quatro tornos passa a ser um grupo de centros de trabalho ou quatro centros de trabalho, para que o SkyPlanner sequencie o trabalho de cada máquina.
2. Sincronização de tarefas. Leia os Order Line Items em aberto, com os respetivos Order Routings, Job Requirements e 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 as existências quando esta é marcada como Delivered. Exclua as tarefas suspensas e as encerradas.
3. Envio da programação de volta. Quando o motor programa ou desloca uma etapa, um webhook do SkyPlanner aciona um PATCH para /api/v1/orders/{orderNumber}/order-line-items/{itemNumber}/order-routings/{stepNumber}. Este define estimatedStartDate e estimatedEndDate em UTC, bem como workCenter e employeeCode quando o SkyPlanner transfere a etapa para outra máquina ou pessoa. As datas ficam registadas nas etapas das tarefas que o Whiteboard, o Planning Board e o Scheduling Advisor já apresentam.
4. Confirmações na fábrica. Os operadores registam o trabalho com SkyPlanner Mobile Confirmations ou Production Timer, e os registos de tempo mantêm a programação atualizada. Pode escolher se os tempos reais são enviados de volta para o JobBOSS². Se sim, cada confirmação dá origem a um Time Ticket Detail com tempo de preparação, tempo de ciclo e peças. Se não, a recolha de dados continua no JobBOSS² e o SkyPlanner lê o progresso a partir de Order Routings.
5. Responsabilidade pelos dados e regras de conflito. Documente estas regras antes da entrada em produção:
| Dados | Sistema responsável |
|---|---|
| Estimates, Routings, quantidades, datas de entrega, estado da tarefa | JobBOSS² |
| Sequência das etapas, horas de início e fim, máquina e operador por etapa | SkyPlanner |
| Matriz de tempos de preparação e transição, necessidades de ferramentas e operadores, recursos alternativos | SkyPlanner |
| Turnos e dias não úteis | Um único sistema, escolhido na definição do âmbito |
| Registos de tempo, saídas de materiais, receções, cálculo de custos | JobBOSS², com introdução direta ou envio a partir dos registos de tempo do SkyPlanner |
Escolha um único sistema para escrever as datas das etapas das tarefas. O SkyPlanner substitui a reprogramação no Whiteboard para as tarefas que programa: os responsáveis pela programação deslocam o trabalho no SkyPlanner e as datas são enviadas para o JobBOSS².
Etapas típicas do projeto
A implementação fica normalmente concluída em poucas semanas após o início do acompanhamento inicial. Antes disso, valide a programação durante o período de avaliação gratuita de 30 dias, com Work Centers, gamas operatórias e tarefas em aberto exportados do JobBOSS² em CSV ou Excel.
- Mapeamento. Defina a tabela de mapeamento, as regras de responsabilidade pelos dados, as frequências de sincronização e se os registos de tempo são enviados de volta.
- Acesso ECI. Peça à ECI para ativar a JobBOSS² API ou a ERP API e criar o utilizador da API. Se tiver uma empresa de testes disponível, faça os testes nesse ambiente.
- Carregamento inicial. Estimates, Routings, Work Centers, calendário e colaboradores.
- Sincronização de tarefas e encomendas de compra. Consulta periódica com filtros
lastModDate, paginação e novas tentativas em caso de falha. - Configuração de restrições no SkyPlanner. Matriz de tempos de preparação e transição, ferramentas, número de operadores por tarefa e máquinas ou pessoal alternativos.
- Escrita da programação no ERP. Chamadas PATCH a Order Routing a partir dos webhooks do SkyPlanner, além de Time Ticket Details, se essa opção for escolhida.
- Testes em paralelo. Utilize o SkyPlanner em paralelo com o quadro de programação atual, compare datas e corrija os dados mestre.
- Entrada em produção. Ative a escrita no ERP quando os dados coincidirem.
O que prever numa integração com o JobBOSS²
- Alojamento externo ou instalação local. A JobBOSS² API destina-se aos clientes com alojamento externo. As instalações locais utilizam a ERP API, cuja lista de recursos é diferente. Defina a opção no passo 1.
- UTC em todo o lado. A API lê e escreve em UTC. Converta para a hora local da fábrica; caso contrário, um início às 7:00 fica marcado para a hora errada.
- Centros de trabalho nem sempre são máquinas. Um centro de trabalho pode ser uma máquina, um grupo, uma célula ou pessoas. O número de máquinas e a dimensão da equipa em cada operação da gama operatória indicam ao SkyPlanner quantos recursos são necessários nessa operação.
- Serviços externos. As operações com um fornecedor em vez de um centro de trabalho representam lead time, não capacidade interna. Modele-as como operações apenas com duração.
- Operações sobrepostas e sem supervisão. As operações da gama operatória podem estar assinaladas para se sobreporem ou decorrerem sem supervisão. Transfira ambos os indicadores para que o trabalho sem presença de operadores seja planeado corretamente.
- Unidades de tempo. Os tempos de preparação e de ciclo têm as suas próprias unidades, e o tempo em fila é tempo de espera, não tempo de máquina. Converta as unidades na importação; caso contrário, todas as durações ficam erradas.
- Paginação. Por predefinição, cada página contém 200 registos. Utilize paginação em todas as leituras.
Quem configura e presta suporte à integração com o JobBOSS²
- A equipa SkyPlanner configura a integração durante a implementação e presta suporte após a entrada em produção, abrangendo os recursos e as regras de consulta periódica acordados. Cada fábrica utiliza o JobBOSS² de forma diferente, e é aqui que esse conhecimento se aplica.
- O seu parceiro JobBOSS² pode participar. O parceiro conhece a sua configuração e pode tratar da ativação da API e da criação do utilizador da API junto da ECI, em conjunto com a equipa SkyPlanner.
- Os seus próprios programadores podem desenvolver sobre esta base utilizando a REST API do SkyPlanner com um token de API. Basta um token de API para começar, e a equipa SkyPlanner ajuda quando necessário. A documentação está disponível em documentação de integração 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, de acordo com o seu processo e as suas necessidades. Consulte os preços, a programação da produção com JobBOSS² que respeita a capacidade real de máquinas e pessoal, a página do JobBOSS², as funcionalidades do SkyPlanner e a área de integrações ERP.
Fabricantes que utilizam o SkyPlanner
2 hpoupadas por semana
“Com o SkyPlanner, passámos do planeamento da produção em 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 comutação
O planeamento da produção poupa 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 · Produção farmacêutica
A eficiência na produção aumentou 90%, e criar um plano otimizado para três meses, abrangendo todos os centros de trabalho, demora menos de 30 minutos.
Milhares (1.000+)de ordens de fabrico programadas automaticamente
“Temos um controlo diferente sobre a produção, e a nossa compreensão 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, com uma visão da produção em tempo real para toda a organização.
98%de fiabilidade das entregas, face a cerca de 50% anteriormente
“O SkyPlanner tem um papel decisivo na manutenção da fiabilidade das nossas entregas.”
Hannu Lahtinen, diretor-geral
KJH-Comp · Metalomecânica de chapa e fabrico por contrato
A fiabilidade das entregas passou de cerca de 50% para valores que chegam aos 98%, e a programação exige agora um supervisor em vez de dois.
Perguntas frequentes
O JobBOSS² tem uma API?
Sim. A ECI disponibiliza a JobBOSS² API e a ERP API, independente do produto, ambas REST e com especificações OpenAPI. Para os clientes com alojamento externo, a JobBOSS² API lê e escreve encomendas, Order Routings, Estimates, Work Centers, encomendas de compra e Time Tickets.
Como é feita a autenticação da integração no JobBOSS²?
Com credenciais de cliente OAuth 2.0. A ECI ativa a API, é criado um utilizador da API na Integration Engine Management Console e cada chamada inclui um token Bearer.
O JobBOSS² suporta webhooks?
As APIs da ECI não têm webhooks documentados, pelo que a integração consulta periodicamente o JobBOSS² com filtros lastModDate, segundo uma frequência definida para cada fábrica. Os webhooks do próprio SkyPlanner enviam as alterações à programação assim que ocorrem.
Como são escritas as datas planeadas no JobBOSS²?
Por operação da tarefa. O SkyPlanner atualiza cada Order Routing através de PATCH com estimatedStartDate e estimatedEndDate, além de workCenter e employeeCode quando a operação passa para outra máquina ou outro operador.
Um parceiro JobBOSS² deve propor o ECI APS ou o SkyPlanner?
O SkyPlanner, quando o cliente pretende ter em funcionamento, em semanas, uma programação da produção com vários recursos que respeite a capacidade real de máquinas e pessoal. O ECI APS é um complemento separado, baseado no LYNQ. O SkyPlanner liga-se através da JobBOSS² API da própria ECI, planeia mudanças de série, equipas, dispositivos de fixação e materiais, reprograma automaticamente e está disponível a partir de 199 € por mês.
Podemos testar o SkyPlanner antes de desenvolver a integração?
Sim. O teste gratuito de 30 dias permite utilizar até 20 centros de trabalho com importações de ficheiros CSV ou Excel do JobBOSS², sem necessidade de cartão de crédito. Inicie o teste ou fale com a equipa comercial para definir o âmbito da integração.
