Integrações / ERP / monday.com
Guia de integração do monday.com para programação da produção com SkyPlanner APS
Este guia de integração do monday.com mostra a parceiros e equipes de TI como conectar os quadros do monday.com ao SkyPlanner APS. A integração do SkyPlanner com o monday.com funciona nos dois sentidos:
- O SkyPlanner recebe itens de pedidos com produto, quantidade, data de entrega, prioridade e status.
- O início e o término planejados são gravados em uma coluna Timeline, e o centro de trabalho fica em uma coluna própria.
- O progresso registrado pelos operadores no chão de fábrica atualiza a coluna Status.
- Os webhooks do SkyPlanner enviam as alterações na programação assim que elas ocorrem.
A equipe do SkyPlanner configura a integração com seus quadros durante a implantação inicial e oferece suporte após a entrada em produção. Este guia é voltado a parceiros e desenvolvedores que querem participar desse processo ou desenvolver por conta própria usando a REST API documentada do SkyPlanner (referência da API).
A API da plataforma monday.com
O monday.com disponibiliza uma GraphQL API em POST https://api.monday.com/v2. Novas versões são lançadas trimestralmente, e você fixa a versão a ser usada com o cabeçalho API-Version. As descontinuações são anunciadas com pelo menos seis meses de antecedência. (Versionamento da API)
Objetos usados em uma integração para programação da produção:
- Boards e groups, frequentemente usados para organizar etapas ou semanas.
- Items e subitems. Um item geralmente representa um pedido ou uma operação, e os subitens contêm as operações.
- Column values: Status, Date, Timeline, Numbers, People, Dependency, Time Tracking, Connect Boards e Mirror.
- Webhooks para eventos de alteração.
As leituras usam items_page dentro de um quadro ou grupo. A página padrão contém 25 itens, e “the maximum is 500.” (esse é o limite máximo). Para continuar, use next_items_page; “each cursor will expire 60 minutes after the first request.” (cada cursor expira após esse prazo, contado a partir da primeira requisição). Filtre com query_params para ler apenas pedidos em aberto. (items_page)
As gravações usam create_item, create_subitem, change_column_value e change_multiple_column_values. A última atualiza várias colunas de um item em uma única chamada, exatamente o que é necessário para gravar a programação de volta no monday.com.
Para grandes cargas de dados, a API oferece ingest_items e backfill_items a partir da versão 2026-07. Você envia um CSV para uma URL pré-assinada e consulta periodicamente o status do processamento. (Importação em massa)
Autenticação
O monday.com aceita três tipos de token:
- Token pessoal de API. “Each token is unique to a user” (cada token é exclusivo de um usuário) e tem as permissões desse usuário. É uma boa opção para uma prova de conceito.
- Token de aplicativo com escopos de permissão, para um aplicativo de integração.
- OAuth por meio de
auth.monday.com/oauth2/authorizee/oauth2/token, com escopos comoboards:read,boards:write,webhooks:readewebhooks:write.
Use um token de aplicativo ou OAuth no ambiente de produção. Um token pessoal deixa de funcionar quando seu proprietário o regenera. (Autenticação)
No SkyPlanner, a REST API usa um token de API para autenticação (SkyPlanner Settings > API) e está documentada em Swagger/OpenAPI. Um token de API é suficiente para começar, e o tutorial de integração orienta você nas primeiras chamadas.
Webhooks e reconciliação
Crie uma assinatura com create_webhook(board_id, url, event, config). Uma integração para programação da produção precisa dos seguintes eventos:
create_itemecreate_subitempara novos pedidos e operações.change_column_valueouchange_specific_column_valuepara alterações na data de entrega, na quantidade ou na prioridade.change_status_column_valuepara alterações de status feitas por usuários.item_archived,item_deletedeitem_moved_to_specific_grouppara pedidos cancelados ou concluídos.
A URL de recebimento deve responder a um token de desafio quando o webhook é criado. Em caso de falha na entrega, as tentativas seguem a regra “retry once a minute for 30 minutes,” (tentar novamente uma vez por minuto durante esse período) e depois param. Por isso, a integração também faz leituras periódicas de reconciliação com items_page e um filtro para itens atualizados recentemente. (Webhooks)
No sentido inverso, o SkyPlanner envia webhooks quando o estado ou a programação muda. O serviço de integração os recebe e grava as novas datas no monday.com. Assim, a gravação de retorno é acionada por eventos.
Mapeamento de dados
O monday.com não tem um objeto padrão para pedidos, por isso os IDs das colunas são mapeados por conta. Esta é a configuração típica:
| Objeto do monday.com | Objeto do SkyPlanner | Direção | Frequência |
|---|---|---|---|
| Item no quadro de produção: Name, Numbers (quantidade), Date (data de entrega), Status ou Dropdown (prioridade) | Pedido com produto, quantidade, data de entrega e prioridade | monday.com → SkyPlanner | Webhook na criação e na alteração, além de reconciliação |
| Subitens ou itens em um quadro vinculado via Connect Boards | Etapas do processo com suas durações | monday.com → SkyPlanner | Junto com o pedido |
| Itens em um quadro de produtos (Mirror para dados do produto) | Produtos e estrutura do produto | monday.com → SkyPlanner | Carga inicial e, depois, a cada alteração |
| Itens em um quadro de estoque ou materiais, se esses dados forem mantidos no monday.com | Materiais e saldos de estoque | monday.com → SkyPlanner | Leitura agendada |
| Itens em um quadro de pedidos de compra com data prevista de entrega | Material a receber, disponível na data de entrega | monday.com → SkyPlanner | Webhook ou leitura agendada |
| Pessoas e equipes | Pessoal, se os operadores forem incluídos na programação | monday.com → SkyPlanner | Carga inicial |
| Não mantidos no monday.com | Centros de trabalho, turnos, matriz de tempos de preparação, ferramentas e máquinas alternativas | Mantidos no SkyPlanner | Configurados durante a implantação inicial |
| Coluna Timeline | Início e término planejados | SkyPlanner → monday.com | A cada alteração na programação, via webhook do SkyPlanner |
| Coluna Status, Dropdown ou Text | Centro de trabalho atribuído | SkyPlanner → monday.com | A cada alteração na programação |
| Coluna Status (por exemplo, Em produção, Concluído) | Progresso das operações registrado no Mobile Confirmations | SkyPlanner → monday.com | A cada confirmação |
Padrões de integração
1. Carga inicial de dados mestres. Leia produtos, materiais e pedidos em aberto com items_page. Crie centros de trabalho, turnos e restrições no SkyPlanner ou importe esses dados do Excel. Defina desde o início se as operações serão subitens ou ficarão em um quadro vinculado.
2. Sincronização de pedidos. Os webhooks do quadro de produção enviam itens novos e alterados ao SkyPlanner como pedidos. Se você acompanha pedidos de compra em um quadro, o SkyPlanner considera o material comprado disponível na data de entrega e atualiza o estoque quando o pedido de compra é marcado como Entregue.
3. Gravação da programação no monday.com. Para cada pedido que o mecanismo programa ou move, a integração chama change_multiple_column_values. Ela grava o início e o término planejados na coluna Timeline e preenche a coluna do centro de trabalho. Uma chamada por item mantém baixo o número de requisições.
4. Progresso no chão de fábrica. Os operadores registram o trabalho com Mobile Confirmations, Production Timer ou Quick Log Mode. Os apontamentos de tempo mantêm a programação atualizada, e o rótulo correspondente de Status é enviado de volta ao quadro. Assim, a equipe de vendas acompanha o progresso sem precisar perguntar.
5. Responsabilidade pelos dados e regras para conflitos. Documente essas definições antes da entrada em produção:
| Dados | Responsável |
|---|---|
| Pedido, cliente, quantidade, data de entrega, prioridade | monday.com |
| Sequência das operações, início e término, centro de trabalho | SkyPlanner |
| Turnos, preparações, ferramentas, máquinas alternativas | SkyPlanner |
| Rótulos de Status para indicar o progresso | O SkyPlanner grava, o monday.com exibe |
A principal fonte de conflitos é a edição manual da coluna Timeline pelos usuários. Defina que apenas o SkyPlanner pode gravar nessa coluna ou trate a edição manual como uma solicitação e deixe o SkyPlanner refazer a programação. O Autopilot refaz a programação 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, você pode usar seus próprios dados no teste gratuito de 30 dias: exporte o quadro de produção para Excel e importe-o no SkyPlanner.
- Análise dos quadros. Mapeie quadros, grupos, IDs de colunas e rótulos de status e verifique o plano do monday.com.
- Mapeamento e responsabilidade pelos dados. Defina a tabela de mapeamento, as regras de responsabilidade e as frequências de sincronização.
- Configuração das restrições no SkyPlanner. Centros de trabalho, turnos, matriz de tempos de preparação, ferramentas e máquinas alternativas.
- Sincronização de pedidos. Webhooks, leitura para conciliação e gerenciamento de tokens.
- Gravação de retorno. Colunas Timeline, centro de trabalho e status.
- Testes em paralelo. Execute o SkyPlanner em paralelo com o quadro atual, compare as datas e corrija os dados.
- Entrada em produção. Ative a gravação de retorno quando as datas coincidirem.
O que considerar ao planejar uma integração com o monday.com
- Cada conta organiza os pedidos de uma forma. Um quadro por cliente, operações como itens ou subitens, máquinas em colunas People ou Status. Mapeie os IDs das colunas de cada conta, nunca pelo título da coluna.
- Limites dos planos. Free, Basic e Standard permitem 1.000 chamadas de API por dia, Pro permite 10.000 e Enterprise, 25.000. Use webhooks para as alterações e faça a gravação de retorno em lote com
change_multiple_column_values. (limites de requisições) - Há um limite para os quadros conectados. O Basic permite uma conexão com quadro e o Standard, cinco, o que limita a vinculação de quadros de operações ou produtos. (limites do Connect Boards)
- Fixe a versão da API. As versões mudam a cada trimestre. Antes da versão 2026-04, os quadros com vários níveis não eram incluídos na consulta padrão de quadros.
- Expiração do cursor. Um cursor de
items_pagetem validade de 60 minutos. Rotinas longas de conciliação devem reiniciar sem inconsistências. - Limites dos webhooks. A URL pode ter no máximo 255 caracteres, e as novas tentativas param após 30 minutos. O receptor deve ser idempotente.
- Unidades e durações. As colunas Numbers não indicam unidades. Defina se a duração será em minutos ou horas antes da primeira importação.
Integração com o monday.com: quem configura e dá suporte
O trabalho envolve mapear seus quadros e colunas, além de configurar as restrições que o monday.com não armazena: centros de trabalho, turnos, matriz de tempos de preparação, ferramentas e máquinas alternativas.
- A equipe SkyPlanner configura a integração durante a implantação e dá suporte após a entrada em produção. Cada empresa estrutura seus quadros de uma forma, e é nessa etapa que essa experiência é aplicada.
- Seu parceiro monday.com pode participar. Ele conhece seus quadros e automações e pode revisar o mapeamento das colunas e a configuração do token.
- Seus próprios desenvolvedores podem ampliar a integração usando a REST API documentada 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 pública do produto está na documentação do SkyPlanner.
O SkyPlanner custa a partir de 199 € por mês, com 5 centros de trabalho incluídos e cobrança mensal. A integração é orçada antecipadamente de acordo com seu processo e suas necessidades, junto com o plano, para que você saiba o custo total antes de começar. Veja a comparação com as visualizações nativas do monday.com em programação da produção com o monday.com, respeitando a capacidade real de máquinas e equipes. A visão geral está na página do monday.com, e os demais sistemas estão na central de integrações com ERP.
Avaliações de fabricantes sobre o SkyPlanner
2 heconomizadas por semana
“Com o SkyPlanner, nosso planejamento da produção passou 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 · Fabricação de produtos farmacêuticos
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.
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 próprias para contato com alimentos
A equipe de vendas vê a capacidade disponível com seis meses de antecedência, e as solicitações de alteração na programação que levavam uma hora ou mais são respondidas em segundos.
Perguntas frequentes
Qual API do monday.com a integração usa?
A API da plataforma monday.com, uma API GraphQL em api.monday.com/v2 com a versão fixada no cabeçalho API-Version. As leituras usam items_page, as gravações usam change_multiple_column_values, e os webhooks notificam as alterações.
O que precisamos configurar no monday.com?
O acesso e duas colunas. O administrador do monday.com autoriza uma única vez um token OAuth ou de aplicativo com escopo definido, e o quadro recebe uma coluna Timeline e uma coluna de centro de trabalho para a gravação de retorno. Seus quadros e automações permanecem como estão.
De qual plano do monday.com precisamos?
Os limites diários de chamadas de API aumentam conforme o plano: 1.000 no Standard e nos planos inferiores, 10.000 no Pro e 25.000 no Enterprise. Pro ou Enterprise são adequados para uma sincronização bidirecional com alterações frequentes. A equipe SkyPlanner verifica seu plano e seus volumes ao revisar os quadros.
O monday.com pode enviar alterações em tempo real?
Sim. Os webhooks são acionados quando há criação de itens, alterações em colunas e mudanças de status. Uma leitura periódica de reconciliação permite identificar as alterações cujas notificações não foram entregues mesmo após a janela de novas tentativas de 30 minutos do monday.com.
Como as datas planejadas são gravadas de volta no monday.com?
Com change_multiple_column_values em cada item. A coluna Timeline recebe as datas planejadas de início e término, e as colunas de centro de trabalho e status são atualizadas na mesma chamada.
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 uma exportação do seu quadro em Excel, 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.
