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

Prepare-se agora para a remoção. A Odoo programou a remoção de XML-RPC e JSON-RPC no Odoo 22 (outono de 2028 no hemisfério norte) e no Odoo Online 21.1 (inverno de 2027 no hemisfério norte). Desenvolva com JSON-2 para a versão 19.0 e isole o acesso via RPC em um único adaptador para bases de dados mais antigas. Assim, a atualização exigirá uma única alteração. Controladores personalizados com @route(type='jsonrpc') não são afetados pela remoção.

Autenticação

Crie um usuário exclusivo para a integração, com acesso de leitura a Manufacturing e Inventory e permissão de escrita nas ordens de produção. Gere a chave em Preferences > Account Security > New API Key. Na versão 19.0, as chaves têm validade máxima de três meses. Por isso, o middleware precisa de rotação de chaves e de um alerta para falhas de autenticação. Sem esses recursos, uma chave expirada interrompe a sincronização sem que ninguém perceba. No SkyPlanner, a API REST usa JWT, portanto o middleware armazena as duas credenciais.

Cada chamada JSON-2 é executada em sua própria transação SQL. Por isso, uma gravação distribuída entre várias chamadas não é atômica. Faça a gravação por ordem de produção e registre cada resultado.

Eventos

O Odoo envia alterações por meio de regras de automação. Uma regra em mrp.production ou mrp.workorder, com o gatilho Ao criar e editar e a ação “Send Webhook Notification” (Enviar notificação de webhook), envia um POST com os campos selecionados para uma URL. Crie a regra no Studio ou, no modo de desenvolvedor, pelo formulário de regras de automação. Complemente a regra com consultas periódicas usando search_read e write_date para capturar importações e tudo o que ela não detectar. No sentido inverso, os webhooks do SkyPlanner enviam as alterações de programação e de status assim que elas ocorrem.

Os nomes dos campos variam entre as versões. Na 19.0, cada base de dados lista seus modelos, campos e métodos em /doc; nas versões anteriores, use fields_get. Faça o mapeamento com base nessas informações, não de memória.

“ POST /json/2/mrp.workorder/write Authorization: bearer <api-key> {"ids": [4711], "vals": {"date_start": "2026-11-03 06:00:00", "date_finished": "2026-11-03 09:30:00", "workcenter_id": 7}} “

O JSON-2 recebe cada argumento do método pelo nome, além de ids e context, de modo que write(vals) passa a usar a chave vals. Nas versões 16.0 a 18.0, a mesma chamada é executada como execute_kw(db, uid, key, 'mrp.workorder', 'write', [[4711], vals]) via XML-RPC ou JSON-RPC; na 16.0, as chaves são date_planned_start e date_planned_finished. Envie datas e horários em UTC. Siga estas regras para evitar problemas na gravação:

• Envie as duas datas na mesma chamada.
• Inclua workcenter_id somente quando o motor escolher uma máquina alternativa.
• Grave apenas os campos de programação, nunca as quantidades ou as listas de materiais.

A gravação das datas altera a reserva do centro de trabalho no próprio Odoo. Assim, as visualizações de planejamento do Odoo passam a mostrar a programação do SkyPlanner.

Retorno dos dados do chão de fábrica ao Odoo. Os operadores registram o trabalho no SkyPlanner Mobile Confirmations. Para cada confirmação, a integração chama create em mrp.workcenter.productivity (JSON-2: POST /json/2/mrp.workcenter.productivity/create com vals_list). Ela preenche workorder_id, workcenter_id, date_start, date_end e um loss_id do tipo Productive, e o tempo de mão de obra e os custos são lançados no Odoo.

Quando uma operação é concluída, a integração define a quantidade produzida e chama button_finish na ordem de produção. A última ordem de produção deixa a ordem de fabricação pronta para button_mark_done. Cada confirmação é lançada uma única vez, e o ID do registro no Odoo fica salvo junto ao apontamento de tempo do SkyPlanner. Assim, uma nova tentativa de envio do webhook nunca cria um segundo Time Log.

Nas fábricas que usam o aplicativo Enterprise Shop Floor, o fluxo é inverso: o SkyPlanner lê o status da ordem de produção e qty_produced, e o Autopilot reprograma automaticamente quando há alterações na produção.

Responsabilidade pelos dados. Documente as regras antes da entrada em operação:

Os planejadores deixam de usar os botões Plan e Unplan no Odoo para as ordens de fabricação programadas pelo SkyPlanner. Caso contrário, o Odoo faz suas próprias reservas de horários, sobrepondo as datas do SkyPlanner.

• Campos de data renomeados. Até a versão 16.0, date_planned_start e date_planned_finished armazenavam as datas planejadas, e date_start/date_finished, as realizadas. A partir da 17.0, date_start e date_finished são as datas planejadas. Um mapeamento copiado de um projeto na versão 16.0 lê datas realizadas como planejadas na 17+ sem indicar o erro.
• As datas das ordens de produção são reservas de capacidade. Na versão 19.0, date_start e date_finished em mrp.workorder são calculados a partir de um registro de resource.calendar.leaves (leave_id) no calendário do centro de trabalho. Gravar as datas na ordem de produção atualiza essa reserva. Nunca grave diretamente na tabela de ausências.
• Ordens de produção iniciadas bloqueiam a ação Unplan. O Odoo se recusa a desfazer o planejamento de uma ordem de fabricação quando “Some work orders have already started” (Algumas ordens de produção já foram iniciadas). Ao gravar a programação de volta, ignore as ordens de produção em progress ou done e mova apenas o que ainda não começou.
• As durações variam. As operações configuradas como Computed têm sua duração calculada com base nas últimas ordens de produção (10 por padrão), ajustada por Time Efficiency. Configure-as como Fixed durante o teste ou aceite que os dados de entrada vão variar. As operações pertencem a cada lista de materiais, sem um cadastro compartilhado de roteiros de produção. Por isso, cada lista precisa ser revisada individualmente.
• Calendários com problemas. Todo centro de trabalho precisa de um calendário de horários de trabalho. O programador do próprio Odoo busca disponibilidade até 700 dias à frente e então interrompe o processo com a mensagem “Impossible to plan the workorder” (não é possível programar a ordem de produção). Corrija os calendários antes da primeira carga.
• Unidades de medida. mrp.bom.line tem seu próprio product_uom_id, que pode ser diferente da unidade de estoque do produto. Faça a conversão antes de verificar a disponibilidade de materiais.

É a gravação dos dados de volta no Odoo que faz a integração gerar valor no dia a dia. Quando esse fluxo está em operação:

• As ordens de produção do Odoo recebem datas efetivas para execução. O motor Arcturus AI sequencia todas as ordens de fabricação em aberto em segundos. As datas e os centros de trabalho escolhidos são gravados em mrp.workorder e exibidos nas visualizações de planejamento do Odoo.
• Ninguém reprograma manualmente. O Autopilot reprograma a produção automaticamente quando há mudanças, e o webhook envia as novas datas ao Odoo.
• O chão de fábrica fecha o ciclo. Os operadores apontam o trabalho pelo celular ou tablet com Mobile Confirmations, Production Timer e Quick Log Mode, e os Time Logs são enviados ao Odoo para controle de estoque e custeio. Programação e execução funcionam em uma única ferramenta, tanto no Community quanto no Enterprise.
• A programação considera restrições que o Odoo não considera. Uma matriz de tempos de preparação define as trocas conforme a sequência de cada par de produtos. As ferramentas são recursos de capacidade finita compartilhados entre máquinas, e uma operação pode exigir vários operadores ao mesmo tempo. O motor recorre a máquinas ou profissionais alternativos quando o recurso principal não está disponível. As datas gravadas de volta em mrp.workorder respeitam todas essas restrições.
• A chegada dos materiais orienta a programação. O estoque disponível e os pedidos de compra em aberto no Odoo alimentam a programação baseada em materiais. Os componentes encomendados são considerados disponíveis na data de entrega do pedido de compra, e o estoque é atualizado quando o pedido é marcado como Delivered. Cada operação é verificada em relação ao que está no almoxarifado e ao que está a caminho.

Você pode avaliar a programação antes de qualquer trabalho de integração. Inicie o teste gratuito de 30 dias com arquivos CSV exportados e veja suas próprias ordens de produção do Odoo no Gantt, com até 20 estações de trabalho e sem cartão de crédito. Os preços começam em 199 € por mês, com 5 estações de trabalho incluídas, cobrança mensal e cancelamento a qualquer momento. O orçamento da integração é apresentado antecipadamente, junto com seu plano, de acordo com seu processo e suas necessidades. Assim, você conhece o custo total antes de começar. Veja os recursos e os clientes ou agende uma demonstração.