Integrações / ERP / JobBOSS²
Guia de integração do JobBOSS² para programação da produção com SkyPlanner APS
Este guia de integração do JobBOSS² mostra a parceiros e equipes de TI como conectar o JobBOSS², da ECI, ao SkyPlanner APS. A integração entre SkyPlanner e JobBOSS² é bidirecional e usa as próprias APIs da ECI:
- O SkyPlanner recebe Orders e Order Line Items, Order Routings, Estimates, Routings e materiais, Work Centers, Employees, Company Calendar, Job Requirements e itens de pedidos de compra.
- As datas planejadas de início e término são enviadas de volta para cada etapa de Order Routing.
- Se você optar por isso, os apontamentos de tempo dos operadores podem ser enviados de volta como Time Ticket Details.
- Os webhooks do SkyPlanner enviam as alterações na programação assim que elas ocorrem.
A equipe do SkyPlanner configura a integração de acordo com o seu ambiente JobBOSS² durante a implantação e presta suporte após a entrada em produção. Este guia é voltado a parceiros e desenvolvedores que querem participar desse trabalho ou desenvolver por conta própria com a REST API documentada do SkyPlanner (referência da API). Uma fábrica de produção sob encomenda nos EUA já fez exatamente isso:
Interfaces de integração do JobBOSS²
A ECI publica suas APIs para manufatura, com especificações OpenAPI, no site Documentação das APIs de manufatura da ECI. Duas delas são relevantes para a programação:
- JobBOSS² API (v1). Usa REST e JSON e é específica para o JobBOSS². Permite ler e gravar pedidos, Order Line Items, Order Routings, Estimates, Routings, materiais, Job Requirements, Work Centers, Company Calendar, Employees, pedidos de compra, Time Tickets e Time Ticket Details. A ECI informa que ela “is currently only supported for JobBOSS² hosted (Cloud) customers.” (atualmente só tem suporte para clientes do JobBOSS² hospedado na nuvem).
- ECI ERP API (v2.1). Uma REST API independente de produto para Deacom, M1 e JobBOSS². No JobBOSS², abrange ordens de produção, operações e materiais das ordens, peças, operações das peças, centros de trabalho, itens de pedidos de compra e linhas de apontamentos de tempo. A ECI observa que “the actual ERP database could be a cloud hosted ERP or on premises install,” (o banco de dados do ERP pode estar hospedado na nuvem ou em uma instalação local), portanto essa é a opção para o JobBOSS² instalado localmente.
As duas APIs seguem as mesmas convenções: expressões de filtro como lastModDate[gte]=, o parâmetro fields=, sort= e paginação com take e skip, sendo 200 o valor padrão de take. “All dates submitted to the API are assumed to be in UTC.” (Todas as datas enviadas à API são consideradas como estando em UTC.)
A regra da ECI vale para ambas: “All APIs must be activated by ECI before use.” (Todas as APIs devem ser ativadas pela ECI antes do uso.) Solicite isso ao seu gerente de conta da ECI logo no início.
Autenticação e acesso
- Usuários de API. A integração usa um usuário de API criado no Integration Engine Management Console da ECI. Esse usuário determina a qual produto, cliente e banco de dados as chamadas são direcionadas.
- Credenciais de cliente OAuth 2.0. O ID e o segredo do cliente são usados para obter um token no endpoint de token da Authentication API. Cada chamada envia então
Authorization: Bearer [token]. - Escopo. Conceda ao usuário de API acesso apenas aos recursos necessários para a tabela de mapeamento abaixo.
No SkyPlanner, a REST API usa um token de API para autenticação (SkyPlanner Settings > API) e está documentada em Swagger/OpenAPI. O tutorial de integração orienta você nas primeiras chamadas.
Eventos e consultas periódicas
Nenhuma das duas APIs da ECI documenta webhooks. Os dados do JobBOSS² são consultados periodicamente: filtre Order Line Items, Order Routings e itens de pedidos de compra por lastModDate desde a última execução e faça a paginação com take e skip. A frequência é definida para cada fábrica: de intervalos de poucos minutos para as ordens de produção a consultas de hora em hora para o estoque.
O SkyPlanner envia webhooks quando o estado ou a programação muda. Assim, o envio de dados de volta é orientado a eventos.
Mapeamento de dados
| Objeto do JobBOSS² (recurso da JobBOSS² API) | Objeto do SkyPlanner | Direção | 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 setup, tempo de ciclo, tamanho da equipe, máquinas para a operação | Etapas do processo com durações e tempos de setup | JobBOSS² → SkyPlanner | Carga inicial e, depois, a cada alteração |
Work Centers (/work-centers): horas por turno, funcionamento nos turnos de 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 sem expediente, pessoal | JobBOSS² → SkyPlanner | Diariamente, ou gestão dos turnos no SkyPlanner |
Orders e Order Line Items (/order-line-items): número da ordem de produção, data de entrega, prioridade, quantidade a produzir | Pedidos com datas de entrega e prioridades | JobBOSS² → SkyPlanner | Consultas a cada poucos minutos |
Order Routings (/order-routings): etapas da ordem de produção, status, horas restantes | Operações por etapa do processo | JobBOSS² → SkyPlanner | Consultas a cada poucos minutos |
Job Requirements (/job-requirements), itens de pedidos de compra (/purchase-order-line-items) | Necessidades de materiais, pedidos de compra por data de entrega | JobBOSS² → SkyPlanner | Consultas de hora em hora ou ao executar a programação |
Campos de Order Routing: estimatedStartDate, estimatedEndDate, workCenter, employeeCode (PATCH) | Início e término planejados, máquina e operador por etapa | SkyPlanner → JobBOSS² | A cada alteração na programação, via webhook do SkyPlanner |
| Time Ticket Details (POST): ordem de produção, etapa, centro de trabalho, funcionário, tempo de setup, tempo de ciclo, peças concluídas e refugadas, horários de início e término | Apontamentos de tempo e confirmações dos operadores | SkyPlanner → JobBOSS² | A cada confirmação ou turno, se essa opção for escolhida |
| Não disponível no JobBOSS² | Matriz de tempos de preparação, ferramentas como recursos de capacidade finita, máquinas e pessoal alternativos | Mantidos no SkyPlanner | Configurados durante a implantação |
No JobBOSS² instalado localmente, os mesmos objetos são lidos pelos recursos da ERP API /jobs, /job-operations, /job-materials, /parts, /part-operations, /work-centers e /purchase-order-lines, e os apontamentos de tempo são enviados para /timecard-lines.
Padrões de integração
1. Carga inicial de dados mestres. Leia Estimates, Routings, materiais, Work Centers, Company Calendar e Employees. Planeje bem o mapeamento dos centros de trabalho: um centro com quatro tornos se torna um grupo de centros de trabalho ou quatro centros de trabalho, para que o SkyPlanner sequencie a produção de cada máquina.
2. Sincronização das ordens de produção. Leia os Order Line Items em aberto com seus Order Routings, Job Requirements e itens de pedidos de compra em aberto. O SkyPlanner considera o material comprado como disponível na data de entrega do pedido de compra e atualiza o estoque quando o pedido é marcado como Delivered. Ignore ordens suspensas e encerradas.
3. Retorno da programação. Quando o mecanismo aloca ou move uma etapa, um webhook do SkyPlanner dispara um PATCH para /api/v1/orders/{orderNumber}/order-line-items/{itemNumber}/order-routings/{stepNumber}. A chamada define estimatedStartDate e estimatedEndDate em UTC, além de workCenter e employeeCode quando o SkyPlanner transfere a etapa para outra máquina ou pessoa. As datas são gravadas nas etapas das ordens de produção que Whiteboard, Planning Board e Scheduling Advisor já exibem.
4. Confirmações no chão de fábrica. Os operadores registram o trabalho com SkyPlanner Mobile Confirmations ou Production Timer, e os apontamentos de tempo mantêm a programação atualizada. Você escolhe se os tempos reais serão enviados de volta ao JobBOSS². Se sim, cada confirmação se torna um Time Ticket Detail com tempo de setup, tempo de ciclo e peças. Se não, a coleta de dados permanece no JobBOSS², e o SkyPlanner lê o andamento em Order Routings.
5. Responsabilidade pelos dados e regras de conflito. Documente essas regras antes da entrada em produção:
| Dados | Sistema responsável |
|---|---|
| Estimates, Routings, quantidades, datas de entrega, status das ordens de produção | JobBOSS² |
| Sequência das etapas, horários de início e término, máquina e operador por etapa | SkyPlanner |
| Matriz de tempos de preparação, requisitos de ferramentas e operadores, recursos alternativos | SkyPlanner |
| Turnos e dias sem expediente | Um único sistema, escolhido na definição de escopo |
| Apontamentos de tempo, baixas de materiais, recebimentos, custeio | JobBOSS², com dados inseridos nele ou enviados a partir dos apontamentos de tempo do SkyPlanner |
Defina um único sistema para gravar as datas das etapas das ordens de produção. O SkyPlanner substitui a reprogramação no Whiteboard para as operações que programa. Assim, os planejadores movem as operações no SkyPlanner, e as datas são enviadas ao JobBOSS².
Etapas típicas do projeto
A implementação normalmente é concluída em semanas após o início da implantação. Antes disso, valide a programação no teste grátis de 30 dias com Work Centers, roteiros de produção e ordens de produção 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 apontamentos de tempo serão enviados de volta.
- Acesso pela ECI. Peça à ECI que ative a JobBOSS² API ou a ERP API e crie o usuário da API. Se você tiver uma empresa de testes em sandbox, use-a para validar a integração.
- Carga inicial. Estimates, Routings, Work Centers, calendário e funcionários.
- Sincronização de ordens de produção e pedidos de compra. Consultas periódicas com filtros por
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 operação e máquinas ou operadores alternativos.
- Gravação da programação no ERP. Chamadas PATCH para Order Routing a partir dos webhooks do SkyPlanner, além de Time Ticket Details, se essa opção for escolhida.
- Testes em paralelo. Use o SkyPlanner em paralelo com o quadro atual, compare as datas e corrija os dados mestres.
- Entrada em produção. Ative a gravação dos dados no ERP quando eles estiverem consistentes entre os sistemas.
O que considerar ao planejar uma integração com JobBOSS²
- Ambiente hospedado ou local. A JobBOSS² API atende aos clientes do ambiente hospedado. As instalações locais usam a ERP API, que tem uma lista de recursos diferente. Defina qual API usar na etapa 1.
- UTC em toda a integração. A API lê e grava horários em UTC. Converta para o horário da fábrica; caso contrário, um início às 7:00 será registrado no horário errado.
- Máquinas agrupadas em centros de trabalho. Um centro de trabalho pode representar uma máquina, um grupo, uma célula ou pessoas. O número de máquinas e o tamanho da equipe em cada etapa do roteiro de produção informam ao SkyPlanner quantos recursos essa etapa exige.
- Serviços terceirizados. Etapas vinculadas a um fornecedor, em vez de um centro de trabalho, representam lead time, não consumo da sua capacidade. Modele-as como etapas que consideram apenas o tempo.
- Etapas sobrepostas e sem operador. As etapas do roteiro de produção podem ser marcadas para ocorrer em sobreposição ou funcionar sem acompanhamento de um operador. Transfira as duas marcações para que a produção sem operadores seja planejada corretamente.
- Unidades de tempo. Os tempos de setup e de ciclo têm unidades próprias, e o tempo de fila é espera, não tempo de máquina. Converta as unidades na importação; caso contrário, todas as durações ficarão erradas.
- Paginação. Por padrão, cada página contém 200 registros. Use paginação em todas as leituras.
Quem configura e dá suporte à integração com JobBOSS²
- A equipe SkyPlanner configura a integração durante a implantação e dá suporte após a entrada em produção, conforme os recursos e as regras de consulta periódica acordados. Cada fábrica usa o JobBOSS² de uma forma, e é nessa configuração que esse conhecimento é aplicado.
- Seu parceiro JobBOSS² pode participar. Ele conhece sua configuração e pode providenciar com a ECI a ativação da API e a criação do usuário da API, em conjunto com a equipe SkyPlanner.
- Seus desenvolvedores também podem ampliar a integração usando a REST API do SkyPlanner com um token de API. Basta um token de API para começar, e a equipe SkyPlanner ajuda quando necessário. A documentação está em documentação de integração do SkyPlanner.
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 plano, de acordo com seu processo e suas necessidades. Confira os preços, a programação da produção com JobBOSS² que respeita a capacidade real de máquinas e equipes, a página do JobBOSS², as funcionalidades do SkyPlanner e a central de integrações com ERP.
Indústrias que usam o SkyPlanner
2 heconomizadas por semana
“Com o SkyPlanner, nosso planejamento da produção saiu das planilhas do Excel para a otimização da produção em tempo real.”
Kalle Kalliomäki, especialista em cadeia de suprimentos
UTU · Painéis 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.
+90%de eficiência na produção
“A eficiência na produção aumentou 90%.”
Abdul Rucyinga, diretor de TI
Laboratory & Allied · Indústria farmacêutica
A eficiência na produção aumentou 90%, e a criação de um plano otimizado de três meses para todos os centros de trabalho leva menos de 30 minutos.
Mais de 1.000 ordens de produção programadas automaticamente
“Agora temos outro controle sobre a produção, e nossa compreensão da capacidade está em um nível completamente diferente.”
Hannu Ryynänen, CEO
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.
98%de pontualidade de entrega, ante cerca de 50%
“O SkyPlanner tem um papel decisivo na manutenção da nossa pontualidade de entrega.”
Hannu Lahtinen, diretor-geral
KJH-Comp · Fabricação de componentes em chapa metálica e fabricação sob contrato
A pontualidade de entrega passou de cerca de 50% para até 98%, e a programação agora exige um supervisor em vez de dois.
Perguntas frequentes
O JobBOSS² tem uma API?
Sim. A ECI disponibiliza a JobBOSS² API e a ERP API, que é independente de produto. Ambas são REST e têm especificações OpenAPI. A JobBOSS² API lê e grava ordens, Order Routings, Estimates, Work Centers, pedidos de compra e Time Tickets para clientes do ambiente hospedado.
Como a integração se autentica no JobBOSS²?
Com o fluxo de credenciais de cliente do OAuth 2.0. A ECI ativa a API, um usuário da API é criado no Integration Engine Management Console e cada chamada inclui um token Bearer.
O JobBOSS² oferece suporte a webhooks?
As APIs da ECI não documentam webhooks. Por isso, a integração consulta o JobBOSS² periodicamente com filtros por lastModDate, em intervalos definidos para cada fábrica. Os webhooks do próprio SkyPlanner enviam as alterações na programação assim que elas ocorrem.
Como as datas planejadas são gravadas de volta no JobBOSS²?
Por etapa da operação. O SkyPlanner atualiza cada Order Routing por PATCH com estimatedStartDate e estimatedEndDate, além de workCenter e employeeCode quando a etapa é transferida para outra máquina ou outro operador.
Um parceiro JobBOSS² deve propor ECI APS ou SkyPlanner?
SkyPlanner, quando o cliente quer colocar em funcionamento, em semanas, a programação da produção com múltiplos recursos e respeito à capacidade real de máquinas e equipes. O ECI APS é um complemento separado, baseado no LYNQ. O SkyPlanner se conecta pela JobBOSS² API da própria ECI, planeja trocas de produção, equipes, dispositivos de fixação e materiais, refaz o planejamento automaticamente e custa a partir de 199 € por mês.
Podemos testar o SkyPlanner antes de desenvolver a integração?
Sim. O teste grátis de 30 dias permite usar até 20 centros de trabalho, com importações do JobBOSS² por CSV ou Excel, sem necessidade de cartão de crédito. Inicie o teste ou fale com a equipe comercial para definir o escopo da integração.
