Guia de integração do Business Central para programação da produção com SkyPlanner APS

A integração usa duas interfaces já disponíveis no Business Central:

1. API v2.0 para dados comerciais e de estoque. Ela expõe items, itemVariants, itemLedgerEntries, locations, unitsOfMeasure, salesOrders, salesOrderLines, purchaseOrders, purchaseOrderLines, vendors, customers e employees. Como não inclui entidades de manufatura, os dados de produção vêm pela segunda interface.
2. Serviços Web OData v4 para manufatura. Qualquer página do Business Central pode ser publicada como um serviço Web OData v4 na página Web Services. Escolha o tipo de objeto Page, o ID da página e um nome para o serviço. Em seguida, selecione Published. O endpoint fica disponível sem código AL e sem a necessidade de implantar uma extensão. A integração publica as páginas padrão de ordens de produção liberadas, Prod. Order Routing Lines, centros de trabalho, centros de máquina e roteiros de produção, disponíveis em /ODataV4/Company('{name}')/{ServiceName}.

As páginas publicadas permitem leitura e gravação. Segundo a Microsoft: “If an editable page is exposed as a web service, the data in the underlying table can be accessed and modified by an OData call,” (Se uma página editável for exposta como serviço web, os dados da tabela subjacente poderão ser acessados e modificados por uma chamada OData), com PATCH para atualizações. É assim que as datas planejadas retornam ao Business Central, pela mesma página e com a mesma validação usadas pelo planejador.

Não use SOAP. A Microsoft declarou os serviços web SOAP obsoletos, e a publicação de páginas da interface da Microsoft como SOAP será removida na onda 2 de lançamentos de 2026 (v29).

O Business Central permite criar assinaturas de webhook por meio de POST /api/v2.0/subscriptions para entidades da API v2.0, como items e salesOrders. As regras são:

• A criação de uma assinatura exige um handshake: seu endpoint deve retornar o validationToken com 200 OK.
• As assinaturas expiram após três dias. Renove com PATCH; o handshake será executado novamente.
• As notificações contêm o caminho do recurso, changeType e seu clientState, não o registro completo. O registro é consultado depois.
• As notificações não são imediatas: o Business Central online aguarda 30 segundos após a primeira alteração. Se houver mais de 1.000 registros alterados nesse intervalo, eles chegam em uma única notificação collection.
• O limite é de 200 assinaturas de webhook por ambiente online.

As ordens de produção, as linhas dos roteiros de produção e os pedidos de compra são consultados a cada poucos minutos nas páginas publicadas e em purchaseOrders. Filtrar apenas as ordens e os pedidos em aberto e usar paginação mantém o número de requisições bem abaixo dos limites do Business Central.

O SkyPlanner envia webhooks quando há mudanças de estado ou na programação. Assim, a gravação de dados de volta no Business Central é orientada a eventos.

1. Carga inicial de dados mestres. Obtenha nas páginas publicadas os roteiros de produção e as BOMs de produção com status Certified, além dos centros de trabalho e de máquina. Obtenha os itens e as unidades de medida pela API v2.0. Defina com cuidado o mapeamento de cada centro de trabalho ou de máquina para um centro de trabalho do SkyPlanner: decida se um centro de trabalho com três centros de máquina será representado por um grupo de centros de trabalho ou por três centros de trabalho.

2. Sincronização de ordens. Leia nas páginas publicadas as ordens de produção com status Released (e Firm Planned, caso você as programe), com suas linhas de roteiro e componentes. Leia também as linhas de pedidos de compra em aberto pela API v2.0. O SkyPlanner considera o material encomendado disponível na data de entrega do pedido de compra e atualiza o estoque quando o pedido é marcado como Delivered. Assim, a programação verifica tanto o estoque quanto as compras a receber.

Nunca programe ordens de produção com status Planned. Segundo a Microsoft, o Business Central “deletes them the next time you run planning.” (as exclui na próxima vez que você executar o planejamento). A Planning Worksheet continua propondo suprimentos, e o SkyPlanner programa as ordens firmes de acordo com a capacidade real.

3. Gravação da programação no Business Central. A página padrão Prod. Order Routing é publicada como um serviço Web OData v4. Para cada operação que o mecanismo programou ou moveu, o SkyPlanner envia um PATCH à linha correspondente do roteiro de produção com o ETag em If-Match. Ele define Starting Date-Time e Ending Date-Time, além de Type e No. quando a operação é transferida para uma máquina alternativa.

O PATCH executa os gatilhos da página e da tabela. Com isso, o Business Central valida os campos com sua própria lógica, exatamente como quando um planejador edita a página Prod. Order Routing. Os campos Starting e Ending Date-Time da linha da ordem de produção são atualizados em seguida. As quantidades, o status e os custos continuam sob responsabilidade do Business Central.

4. Apontamentos do 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 apontamento da produção pode continuar sendo feito no Business Central, pelo Production Journal ou pelo Output Journal.

Se você quiser contabilizar a produção e o consumo de forma totalmente automática, será adicionada uma página de API padrão do Business Central para contabilização no diário de produção. O SkyPlanner passa então a contabilizar o tempo de setup, o tempo de execução e a quantidade produzida por operação. A contabilização atualiza Capacity Ledger Entries, e a produção apontada na última operação do roteiro adiciona o item ao estoque.

Escolha um único canal para contabilizar a produção. Contabilizar tanto pelo SkyPlanner quanto pelo Production Journal do Business Central duplica os lançamentos.

5. Responsabilidade pelos dados e regras de conflito. Documente essas regras antes da entrada em produção:

A principal fonte de conflitos são as ações Refresh e Replan nas ordens de produção. Segundo a Microsoft: “If you use the Refresh action to recalculate production order lines, Business Central deletes the existing production order lines and calculates new lines.” (Se você usar a ação Refresh para recalcular as linhas da ordem de produção, o Business Central excluirá as linhas existentes e calculará novas linhas.) A ação Replan também pode alterar a necessidade de capacidade, e o recálculo de componentes “deletes previous changes in the components.” (exclui as alterações anteriores nos componentes).

Trate uma ordem atualizada por Refresh como uma nova versão, sincronize-a novamente e deixe o SkyPlanner reprogramar. Com o Autopilot, o SkyPlanner reprograma automaticamente quando há mudanças na produção.

• Unidades nos roteiros de produção. Setup Time é definido por ordem de produção, Run Time por item produzido, e cada um tem seu próprio Unit of Measure Code. Wait Time e Move Time não consomem capacidade do centro de trabalho. Se a unidade do centro de trabalho for Days, um dia corresponde a 24 horas, não a um turno de oito horas. Faça a conversão na importação; caso contrário, todas as durações estarão erradas.
• Calendários desatualizados. A capacidade só existe depois de executar Calculate Work Center Calendar para o horizonte de planejamento. Verifique o campo Calendar Entries Available Until antes da carga inicial.
• Capacidade dos centros de máquina oculta. Com Consolidated Calendar desativado, apenas a capacidade própria do centro de trabalho é planejada: “The machine center capacity is excluded.” (A capacidade do centro de máquina é excluída.) Leia a capacidade dos centros de máquina diretamente, em vez de confiar nos totais dos centros de trabalho.
• Capacity e Efficiency. O Business Central calcula a duração como Run Time / Efficiency / Capacity, e os registros calculados do calendário já incluem os dois fatores. Mapeie Efficiency para a eficiência do centro de trabalho no SkyPlanner uma única vez, não duas.
• Alternate Work Center é apenas informativo. Segundo a Microsoft, esse campo “isn’t automatically included in planning processes.” (não é incluído automaticamente nos processos de planejamento). Modele as alternativas explicitamente como centros de trabalho alternativos no SkyPlanner.
• Limites de requisições. Os limites online são aplicados por usuário, e uma entidade de serviço conta como um usuário: 6.000 requisições OData em uma janela móvel de 5 minutos e 5 requisições simultâneas. O tamanho da página é limitado a 20.000 registros, cada $batch a 100 operações, e uma operação atinge o tempo limite após 8 minutos. Exceder a taxa retorna 429. Use lotes, paginação e consultas periódicas apenas das alterações, em vez de recarregar todos os dados.
• Licenciamento. Os recursos de manufatura estão disponíveis apenas na experiência Premium. Usuários do Essentials não podem acessar uma empresa configurada como Premium.