Principal Integração ERP (API)
🔗

Integração ERP (API)

Ordens de produção, qualidade, paradas e webhooks.
Allan Costa
Por Allan Costa
• 13 artigos

API mify.app.br: visão geral da integração

Documentação da API de integração entre o Mify e o seu ERP, para plataformas hospedadas em *.mify.app.br. ⚠️ Está na plataforma *.mify.com.br? Esta não é a sua documentação — as rotas e os payloads são diferentes. Veja Integração iMetrics — mify.com.br. URL base https://api-integration-example.mify.app.br/v1 ⚠️ URL de exemplo. api-integration-example não é um domínio real — é um placeholder usado nesta documentação. O domínio real da sua integração é fornecido pelo suporte Mify. Não copie e use a URL acima diretamente. Rotas disponíveis | Recurso | Direção | Documentação | | --- | --- | --- | | Ordem de Produção | ERP ⇄ Mify | Ordem de Produção | | Peças Ruins | ERP → Mify | Qualidade | | Refugo | ERP → Mify | Qualidade | | Retrabalho | ERP → Mify | Qualidade | | Paradas | Mify → ERP | Paradas | Não encontrou a integração que precisa? Também desenvolvemos soluções customizadas sob demanda — entre em contato conosco. Autenticação Nas rotas em que o ERP chama a Mify, autentique via header: x-api-key: 00000000-0000-0000-0000-000000000000 Nas rotas em que o Mify chama o ERP (Ordem de Produção, Webhooks), as credenciais são configuradas no painel da Mify. Sobre rotas POST que na verdade consultam dados Algumas rotas usam o método POST mesmo sendo, na prática, uma consulta (não criam nem alteram nada). Isso acontece porque o GET HTTP não aceita corpo de requisição, e o corpo é usado aqui para permitir mais filtros do que a query string suportaria. Essas rotas têm o prefixo /get logo após /v1 no path (ex.: /v1/get/machine/...) e um aviso na própria página do endpoint. Observações Importantes 1. Todas as datas/horas trafegam no formato ISO 8601 (UTC), ex.: "2025-03-05T16:47:23.731Z". 2. O parâmetro {machine} na URL é o nome da máquina cadastrada na Mify (ex.: RAMA 01). 3. A Ordem de Produção (order) é o código único que vincula qualidade, refugo e retrabalho à produção correta.

Última atualização em Nov 17, 2026

API mify.app.br: ordens de produção

Esta página cobre as duas operações relacionadas à produção: a Mify buscando ordens de produção no ERP, e o ERP consultando as ordens de produção registradas pela Mify. Documentação para a plataforma *.mify.app.br. Se você usa *.mify.com.br, veja Ordem de Produção — mify.com.br. ERP → Mify A Mify busca Ordens de Produção diretamente no ERP para criar os Ordens de Produção correspondentes. O ERP deve expor uma rota GET que a Mify irá chamar periodicamente. A URL e eventuais credenciais são configuradas no painel da Mify. Endpoint (definido pelo ERP) GET https://my-erp.com/api/v1/production-orders Parâmetros de Consulta A Mify pode enviar os parâmetros abaixo na query string. | Parâmetro | Tipo | Obrigatório | Descrição | Exemplo | | --- | --- | --- | --- | --- | | machine | string | Não | Nome da máquina para filtrar as ordens | "RAMA 01" | | order | string | Não | Filtra por uma Ordem de Produção específica | "43892513" | Resposta Esperada (JSON) O ERP deve retornar os campos abaixo para cada Ordem de Produção. A Mify usa esses dados para criar o Ordem de Produção. | Campo | Tipo | Obrigatório | Descrição | | --- | --- | --- | --- | | order | string | Sim | Código único que identifica a produção | | product | string | Sim | Código do produto sendo produzido | | description | string | Não | Descrição do produto | | lote | string | Sim | Código do lote de produção | | idealObjective | string | number | Sim | Quantidade ideal a ser produzida por minuto | | pulseFactor | string | number | Sim | Quantidade de produto contabilizada a cada sinal recebido no Coletor IIoT | | expected | integer | Sim | Quantidade total esperada para a produção | | expectedStart | string | Não | Data prevista de início (ISO 8601 UTC) | | observation | string | null | Não | Informação adicional para a Ordem de Produção | Exemplo de Resposta { "order": "43892513", "product": "4389", "description": "TNT 5D 200mm", "lote": "1969", "idealObjective": "2.68752", "pulseFactor": "0.00000625", "expected": 5000, "expectedStart": "2025-03-05T11:30:00Z", "observation": "" } Observações 1. O campo order deve ser único — é a chave que vincula produção, qualidade, refugo e retrabalho à Ordem de Produção. 2. pulseFactor representa a quantidade de produto contabilizada a cada sinal recebido no Coletor IIoT. 3. expectedStart deve estar no formato ISO 8601 (UTC). Mify → ERP Consulta O ERP consulta a Mify para obter os Ordens de Produção gerados — incluindo quantidade produzida, peças ruins, refugos e retrabalhos. ℹ️ Por que POST numa consulta? Esta rota não cria nem altera nada — é uma consulta. Usamos POST (com /get no path) em vez de GET porque o corpo da requisição permite mais filtros do que a query string suportaria. Endpoint POST https://api-integration-example.mify.app.br/v1/get/machine/RAMA 01/production-order Autenticação x-api-key: 00000000-0000-0000-0000-000000000000 Parâmetros do Corpo (JSON) | Parâmetro | Tipo | Obrigatório | Descrição | Exemplo | | --- | --- | --- | --- | --- | | start | string | Não | Data/hora de início (ISO 8601 UTC) | "2025-03-01T03:00:00Z" | | end | string | Não | Data/hora de término (ISO 8601 UTC) | "2025-03-10T03:00:00Z" | | status | string | Não | Filtro por status da ordem | "pending" | | order | string | Não | Filtro por Ordem de Produção específica | "43892513" | Exemplo de Requisição curl --location 'https://api-integration-example.mify.app.br/v1/get/machine/RAMA 01/production-order' \ --header 'x-api-key: 00000000-0000-0000-0000-000000000000' \ --header 'Content-Type: application/json' \ --data '{ "start": "2025-03-01T03:00:00Z", "end": "2025-03-10T03:00:00Z", "status": "finished", "order": "43892513" }' Estrutura da Resposta (JSON Array) A resposta é um array de objetos, um por Ordem de Produção. | Campo | Tipo | Descrição | | --- | --- | --- | | id | integer | ID único da ordem (interno Mify) | | start | string | Data/hora de início (ISO 8601 UTC) | | end | string | Data/hora de término (ISO 8601 UTC) | | order | string | Ordem de Produção vinculada | | lote | string | Lote de produção | | product | string | Código do produto | | description | string | Descrição do produto | | observation | string | null | Observações adicionais | | status | string | Status da ordem (ex: "finished") | | expected | integer | Quantidade esperada | | produced | integer | Quantidade produzida | | bad | integer | Peças ruins apontadas | | scraps | integer | Refugos apontados | | reworks | integer | Retrabalhos apontados | | pulseFactor | string | Quantidade produzida por pulso | | cycleTime | string | Tempo de ciclo (segundos) | | idealObjective | string | Objetivo ideal por minuto | | realProduction | integer | Produção real por minuto | | runningTimeMs | integer | Tempo de execução (milissegundos) | | measurementUnit | string | Unidade de medida (ex: "mts") | | startedBy | object | null | Usuário que iniciou (contém username) | | finishedBy | object | null | Usuário que finalizou (contém username) | Exemplo de Resposta [ { "id": 9138, "order": "43892513", "expected": 5000, "produced": 202, "product": "4389", "status": "finished", "lote": "1969", "bad": 0, "observation": "", "idealObjective": "2.68752", "pulseFactor": "0.00000625", "description": "TNT 5D 200mm", "startedBy": { "username": "mify.luiz" }, "finishedBy": { "username": "mify.cesar" }, "scraps": 0, "reworks": 0, "start": "2025-03-05T16:47:23.731Z", "end": "2025-03-05T19:00:36.177Z", "cycleTime": "0.0166", "runningTimeMs": 13641125, "realProduction": 0.88, "measurementUnit": "mts" } ] Webhook A Mify pode disparar um webhook para o ERP quando um evento ocorre em um Ordem de Produção. O ERP deve expor uma rota que receberá o POST da Mify. A URL é configurada no painel da Mify. Endpoint (definido pelo ERP) POST https://my-erp.com/api/v1/production-diary/event Eventos que disparam o webhook | Evento | Quando ocorre | | --- | --- | | diary.created | Ordem de Produção criado | | diary.started | Produção iniciada | | diary.paused | Produção pausada | | diary.finished | Produção finalizada | Corpo Enviado (JSON) | Campo | Tipo | Descrição | | --- | --- | --- | | triggerEvent | string | Tipo do evento que disparou o webhook | | machine | string | Nome da máquina | | id | integer | ID único da ordem | | order | string | Ordem de Produção vinculada | | status | string | Status atual da ordem | | produced | integer | Quantidade produzida | | expected | integer | Quantidade esperada | | bad | integer | Peças ruins apontadas | | scraps | integer | Refugos apontados | | reworks | integer | Retrabalhos apontados | | start | string | Data/hora de início (ISO 8601 UTC) | | end | string | null | Data/hora de término (ISO 8601 UTC) | Exemplo do Corpo Enviado { "triggerEvent": "diary.finished", "machine": "RAMA 01", "id": 9138, "order": "43892513", "status": "finished", "produced": 202, "expected": 5000, "bad": 0, "scraps": 0, "reworks": 0, "start": "2025-03-05T16:47:23.731Z", "end": "2025-03-05T19:00:36.177Z" }

Última atualização em Nov 17, 2026

API mify.app.br: qualidade (peças ruins, refugo e retrabalho)

Permite registrar apontamentos de qualidade por Ordem de Produção. Cada tipo tem sua própria rota, mas compartilham a mesma estrutura de corpo: ordem + quantidade + motivo. Documentação para a plataforma *.mify.app.br. Se você usa *.mify.com.br, veja Qualidade — mify.com.br. | Apontamento | Rota | Campo na Ordem | | --- | --- | --- | | Peças ruins | /bad | bad | | Refugo | /scrap | scraps | | Retrabalho | /rework | reworks | O motivo (reason) deve estar previamente cadastrado na Mify antes de ser utilizado. ERP → Mify O ERP registra apontamentos de qualidade diretamente na API da Mify. Estas são rotas POST reais — criam um apontamento novo a cada chamada. Endpoint — Peças Ruins POST https://api-integration-example.mify.app.br/v1/machine/RAMA 01/bad Endpoint — Refugo POST https://api-integration-example.mify.app.br/v1/machine/RAMA 01/scrap Endpoint — Retrabalho POST https://api-integration-example.mify.app.br/v1/machine/RAMA 01/rework Autenticação x-api-key: 00000000-0000-0000-0000-000000000000 Parâmetros do Corpo (JSON) O corpo é idêntico para as três rotas. | Parâmetro | Tipo | Obrigatório | Descrição | Exemplo | | --- | --- | --- | --- | --- | | order | string | Sim | Ordem de Produção (código único) da ordem a ser apontada | "43892513" | | quantity | integer | Sim | Quantidade impactada | 12 | | reason | string | Sim | Motivo do apontamento (previamente cadastrado na Mify) | "Falha no corte" | Exemplo de Requisição — Peças Ruins curl --location 'https://api-integration-example.mify.app.br/v1/machine/RAMA 01/bad' \ --header 'x-api-key: 00000000-0000-0000-0000-000000000000' \ --header 'Content-Type: application/json' \ --data '{ "order": "43892513", "quantity": 12, "reason": "Falha no corte" }' Exemplo de Requisição — Refugo curl --location 'https://api-integration-example.mify.app.br/v1/machine/RAMA 01/scrap' \ --header 'x-api-key: 00000000-0000-0000-0000-000000000000' \ --header 'Content-Type: application/json' \ --data '{ "order": "43892513", "quantity": 8, "reason": "Material fora de especificação" }' Exemplo de Requisição — Retrabalho curl --location 'https://api-integration-example.mify.app.br/v1/machine/RAMA 01/rework' \ --header 'x-api-key: 00000000-0000-0000-0000-000000000000' \ --header 'Content-Type: application/json' \ --data '{ "order": "43892513", "quantity": 5, "reason": "Reprocesso de bobina" }' Resposta { "order": "43892513", "quantity": 12, "reason": "Falha no corte" } Mify → ERP Webhook A Mify dispara um webhook para o ERP sempre que um apontamento de qualidade é registrado. O ERP deve expor uma rota por tipo de apontamento que a Mify irá chamar. As URLs são configuradas no painel da Mify. Endpoints (definidos pelo ERP) — Peças Ruins POST https://my-erp.com/api/v1/quality/bad Endpoints (definidos pelo ERP) — Refugo POST https://my-erp.com/api/v1/quality/scrap Endpoints (definidos pelo ERP) — Retrabalho POST https://my-erp.com/api/v1/quality/rework Corpo Enviado (JSON) | Campo | Tipo | Descrição | | --- | --- | --- | | triggerEvent | string | Tipo do evento que disparou o webhook | | machine | string | Nome da máquina | | order | string | Ordem de Produção | | quantity | integer | Quantidade apontada | | reason | string | Motivo do apontamento | Exemplo do Corpo Enviado — Retrabalho { "triggerEvent": "quality.rework", "machine": "RAMA 01", "order": "43892513", "quantity": 5, "reason": "Reprocesso de bobina" } Observações 1. O order deve corresponder a uma Ordem de Produção existente na Mify; caso contrário o apontamento é rejeitado. 2. Os valores são refletidos nos campos bad, scraps e reworks da resposta de Ordem de Produção. 3. As URLs do ERP são configuradas no painel da Mify, uma por tipo de apontamento.

Última atualização em Nov 17, 2026

API mify.app.br: paradas

Permite consultar os registros de parada e produção (rodando/parado) de uma máquina dentro de um período, com filtros opcionais por grupo e tipo. Documentação para a plataforma *.mify.app.br. Se você usa *.mify.com.br, veja Paradas — mify.com.br. Mify → ERP Consulta O ERP consulta a Mify para obter os registros de parada/produção de uma máquina. ℹ️ Por que POST numa consulta? Esta rota não cria nem altera nada — é uma consulta. Usamos POST (com /get no path) em vez de GET porque o corpo da requisição permite mais filtros do que a query string suportaria. Endpoint POST https://api-integration-example.mify.app.br/v1/get/machine/RAMA 01/running Autenticação x-api-key: 00000000-0000-0000-0000-000000000000 Parâmetros do Corpo (JSON) | Parâmetro | Tipo | Obrigatório | Descrição | Exemplo | | --- | --- | --- | --- | --- | | start | string | Não | Data/hora de início (ISO 8601 UTC) | "2025-03-01T03:00:00Z" | | end | string | Não | Data/hora de término (ISO 8601 UTC) | "2025-03-10T03:00:00Z" | | group | string | Não | Filtro por grupo de parada | "MANUTENÇÃO" | | type | string | Não | Filtro por tipo de parada | "MECÂNICA" | Exemplo de Requisição — Com filtros curl --location 'https://api-integration-example.mify.app.br/v1/get/machine/RAMA 01/running' \ --header 'x-api-key: 00000000-0000-0000-0000-000000000000' \ --header 'Content-Type: application/json' \ --data '{ "start": "2025-03-01T03:00:00Z", "end": "2025-03-10T03:00:00Z", "group": "MANUTENÇÃO", "type": "MECÂNICA" }' Exemplo de Requisição — Sem filtros curl --location 'https://api-integration-example.mify.app.br/v1/get/machine/RAMA 01/running' \ --header 'x-api-key: 00000000-0000-0000-0000-000000000000' \ --header 'Content-Type: application/json' \ --data '{ "start": "2025-03-01T03:00:00Z", "end": "2025-03-10T03:00:00Z" }' Estrutura da Resposta (JSON Array) A resposta é um array de registros de rodando/parado. | Campo | Tipo | Descrição | | --- | --- | --- | | machine | string | Nome da máquina | | start | string | Data/hora de início do registro (ISO 8601 UTC) | | end | string | null | Data/hora de término; null se em curso | | durationMs | integer | null | Duração em milissegundos; null se em curso | | event | 0 | 1 | 0 = Parado, 1 = Rodando | | group | string | null | Grupo da parada | | subGroup | string | null | Subgrupo da parada | | type | string | null | Tipo da parada | | subType | string | null | Subtipo da parada | | justification | string | null | Justificativa da parada | | programmed | string | null | Nome da parada programada | | routine | string | null | Nome da parada de rotina | Exemplo de Resposta [ { "machine": "RAMA 01", "start": "2025-03-05T12:31:04.569Z", "end": null, "durationMs": null, "event": 1, "justification": null, "group": null, "subGroup": null, "type": null, "subType": null, "programmed": null, "routine": null }, { "machine": "RAMA 01", "start": "2025-03-07T19:48:34.295Z", "end": "2025-03-07T19:57:14.789Z", "durationMs": 520493, "event": 0, "justification": "Conserto motor cilindro acumulador rama", "group": "MANUTENÇÃO", "subGroup": "MANUTENÇÃO", "type": "MECÂNICA", "subType": "MECÂNICA", "programmed": null, "routine": null } ] Observações 1. Os campos group, subGroup, type, subType, justification, programmed e routine são null quando a parada não foi informada. 2. Registros em andamento têm end e durationMs como null. 3. Paradas informadas sempre terão group + subGroup + type + subType, ou programmed, ou routine. Webhook A Mify dispara um webhook para o ERP quando um evento de parada ocorre em uma máquina. O ERP deve expor uma rota que receberá o POST da Mify. A URL é configurada no painel da Mify. Endpoint (definido pelo ERP) POST https://my-erp.com/api/v1/stops/event Eventos que disparam o webhook | Evento | Quando ocorre | | --- | --- | | stop.started | Máquina parou | | stop.ended | Máquina voltou a rodar | | stop.informed | Parada foi justificada | Corpo Enviado (JSON) | Campo | Tipo | Descrição | | --- | --- | --- | | triggerEvent | string | Tipo do evento que disparou o webhook | | machine | string | Nome da máquina | | start | string | Data/hora de início do registro (ISO 8601 UTC) | | end | string | null | Data/hora de término; null se em curso | | durationMs | integer | null | Duração em milissegundos; null se em curso | | event | 0 | 1 | 0 = Parado, 1 = Rodando | | group | string | null | Grupo da parada | | type | string | null | Tipo da parada | | justification | string | null | Justificativa da parada | Exemplo do Corpo Enviado { "triggerEvent": "stop.informed", "machine": "RAMA 01", "start": "2025-03-07T19:48:34.295Z", "end": "2025-03-07T19:57:14.789Z", "durationMs": 520493, "event": 0, "group": "MANUTENÇÃO", "type": "MECÂNICA", "justification": "Conserto motor cilindro acumulador rama" }

Última atualização em Nov 17, 2026

API mify.com.br: visão geral da integração

Documentação da API de integração entre o iMetrics e o seu ERP, para plataformas hospedadas em *.mify.com.br. ⚠️ Está na plataforma *.mify.app.br? Esta não é a sua documentação — as rotas e os payloads são diferentes. Veja Integração iMetrics — mify.app.br. URL base https://app.mify.com.br/api/v2/integration/external Rotas disponíveis | Recurso | Direção | Documentação | | --- | --- | --- | | Ordem de Produção | ERP ⇄ iMetrics | Ordem de Produção | | Peças Ruins | ERP → iMetrics | Qualidade | | Refugo | ERP → iMetrics | Qualidade | | Retrabalho | ERP → iMetrics | Qualidade | | Paradas | iMetrics → ERP | Paradas | Autenticação Nas rotas em que o ERP chama o iMetrics, autentique via header: x-api-key: 00000000-0000-0000-0000-000000000000 Nas rotas em que o iMetrics chama o ERP (Ordem de Produção, Webhooks), as credenciais são configuradas no painel do iMetrics. Sobre rotas POST que na verdade consultam dados Algumas rotas usam o método POST mesmo sendo, na prática, uma consulta (não criam nem alteram nada). Isso acontece porque o GET HTTP não aceita corpo de requisição, e o corpo é usado aqui para permitir mais filtros do que a query string suportaria. Nesta plataforma essas rotas já indicam isso pelo próprio nome (ex.: get-production-detail, get-running). Observações Importantes 1. Todas as datas/horas trafegam no formato ISO 8601 (UTC), ex.: "2025-03-05T16:47:23.731Z". 2. O parâmetro {machine} na URL é o nome da máquina cadastrada no iMetrics (ex.: RAMA 01). 3. A Ordem de Produção (order) é o código único que vincula qualidade, refugo e retrabalho à produção correta.

Última atualização em Nov 17, 2026

API mify.com.br: ordens de produção

Esta página cobre as duas operações relacionadas à produção: o iMetrics buscando ordens de produção no ERP, e o ERP consultando as ordens de produção registradas pelo iMetrics. Documentação para a plataforma *.mify.com.br. Se você usa *.mify.app.br, veja Ordem de Produção — mify.app.br. ERP → iMetrics O iMetrics busca Ordens de Produção diretamente no ERP para criar os Ordens de Produção correspondentes. O ERP deve expor uma rota GET que o iMetrics irá chamar periodicamente. A URL e eventuais credenciais são configuradas no painel do iMetrics. Endpoint (definido pelo ERP) GET https://my-erp.com/api/v1/production-orders Parâmetros de Consulta O iMetrics pode enviar os parâmetros abaixo na query string. | Parâmetro | Tipo | Obrigatório | Descrição | Exemplo | | --- | --- | --- | --- | --- | | machine | string | Não | Nome da máquina para filtrar as ordens | "RAMA 01" | | order | string | Não | Filtra por uma Ordem de Produção específica | "43892513" | Resposta Esperada (JSON) O ERP deve retornar os campos abaixo para cada Ordem de Produção. O iMetrics usa esses dados para criar o Ordem de Produção. | Campo | Tipo | Obrigatório | Descrição | | --- | --- | --- | --- | | order | string | Sim | Código único que identifica a produção | | productId | string | Sim | Código do produto sendo produzido | | description | string | Não | Descrição do produto | | lote | string | Sim | Código do lote de produção | | idealObjective | string | number | Sim | Quantidade ideal a ser produzida por minuto | | pulseFactor | string | number | Sim | Quantidade de produto contabilizada a cada sinal recebido no Coletor IIoT | | expected | integer | Sim | Quantidade total esperada para a produção | | expectedStart | string | Não | Data prevista de início (ISO 8601 UTC) | | observation | string | null | Não | Informação adicional para a Ordem de Produção | Exemplo de Resposta { "order": "43892513", "productId": "4389", "description": "TNT 5D 200mm", "lote": "1969", "idealObjective": "2.68752", "pulseFactor": "0.00000625", "expected": 5000, "expectedStart": "2025-03-05T11:30:00Z", "observation": "" } Observações 1. O campo order deve ser único — é a chave que vincula produção, qualidade, refugo e retrabalho à Ordem de Produção. 2. pulseFactor representa a quantidade de produto contabilizada a cada sinal recebido no Coletor IIoT. 3. expectedStart deve estar no formato ISO 8601 (UTC). iMetrics → ERP Consulta O ERP consulta o iMetrics para obter os Ordens de Produção gerados — incluindo quantidade produzida, peças ruins, refugos e retrabalhos. ℹ️ Por que POST numa consulta? Esta rota não cria nem altera nada — é uma consulta. Usamos POST em vez de GET porque o corpo da requisição permite mais filtros do que a query string suportaria. Nesta plataforma isso já fica indicado pelo nome da rota: get-production-detail. Endpoint POST https://app.mify.com.br/api/v2/integration/external/machine/RAMA 01/get-production-detail Autenticação x-api-key: 00000000-0000-0000-0000-000000000000 Parâmetros do Corpo (JSON) | Parâmetro | Tipo | Obrigatório | Descrição | Exemplo | | --- | --- | --- | --- | --- | | start | string | Não | Data/hora de início (ISO 8601 UTC) | "2025-03-01T03:00:00Z" | | end | string | Não | Data/hora de término (ISO 8601 UTC) | "2025-03-10T03:00:00Z" | | status | string | Não | Filtro por status da ordem | "pending" | | order | string | Não | Filtro por Ordem de Produção específica | "43892513" | Exemplo de Requisição curl --location 'https://app.mify.com.br/api/v2/integration/external/machine/RAMA 01/get-production-detail' \ --header 'x-api-key: 00000000-0000-0000-0000-000000000000' \ --header 'Content-Type: application/json' \ --data '{ "start": "2025-03-01T03:00:00Z", "end": "2025-03-10T03:00:00Z", "status": "finished", "order": "43892513" }' Estrutura da Resposta (JSON Array) A resposta é um array de objetos, um por Ordem de Produção. | Campo | Tipo | Descrição | | --- | --- | --- | | id | integer | ID único da ordem (interno Mify) | | start | string | Data/hora de início (ISO 8601 UTC) | | end | string | Data/hora de término (ISO 8601 UTC) | | order | string | Ordem de Produção vinculada | | lote | string | Lote de produção | | productId | string | Código do produto | | description | string | Descrição do produto | | observation | string | null | Observações adicionais | | status | string | Status da ordem (ex: "finished") | | expected | integer | Quantidade esperada | | produced | integer | Quantidade produzida | | bad | integer | Peças ruins apontadas | | scraps | integer | Refugos apontados | | reworks | integer | Retrabalhos apontados | | pulseFactor | string | Quantidade produzida por pulso | | cycleTime | string | Tempo de ciclo (segundos) | | idealObjective | string | Objetivo ideal por minuto | | realProduction | integer | Produção real por minuto | | runningTimeMs | integer | Tempo de execução (milissegundos) | | measurementUnit | string | Unidade de medida (ex: "mts") | | startedBy | object | null | Usuário que iniciou (contém username) | | finishedBy | object | null | Usuário que finalizou (contém username) | Exemplo de Resposta [ { "id": 9138, "order": "43892513", "expected": 5000, "produced": 202, "productId": "4389", "status": "finished", "lote": "1969", "bad": 0, "observation": "", "idealObjective": "2.68752", "pulseFactor": "0.00000625", "description": "TNT 5D 200mm", "startedBy": { "username": "mify.luiz" }, "finishedBy": { "username": "mify.cesar" }, "scraps": 0, "reworks": 0, "start": "2025-03-05T16:47:23.731Z", "end": "2025-03-05T19:00:36.177Z", "cycleTime": "0.0166", "runningTimeMs": 13641125, "realProduction": 0.88, "measurementUnit": "mts" } ] Webhook O iMetrics pode disparar um webhook para o ERP quando um evento ocorre em um Ordem de Produção. O ERP deve expor uma rota que receberá o POST do iMetrics. A URL é configurada no painel do iMetrics. Endpoint (definido pelo ERP) POST https://my-erp.com/api/v1/production-diary/event Eventos que disparam o webhook | Evento | Quando ocorre | | --- | --- | | diary.created | Ordem de Produção criado | | diary.started | Produção iniciada | | diary.paused | Produção pausada | | diary.finished | Produção finalizada | Corpo Enviado (JSON) | Campo | Tipo | Descrição | | --- | --- | --- | | triggerEvent | string | Tipo do evento que disparou o webhook | | machine | string | Nome da máquina | | id | integer | ID único da ordem | | order | string | Ordem de Produção vinculada | | status | string | Status atual da ordem | | produced | integer | Quantidade produzida | | expected | integer | Quantidade esperada | | bad | integer | Peças ruins apontadas | | scraps | integer | Refugos apontados | | reworks | integer | Retrabalhos apontados | | start | string | Data/hora de início (ISO 8601 UTC) | | end | string | null | Data/hora de término (ISO 8601 UTC) | Exemplo do Corpo Enviado { "triggerEvent": "diary.finished", "machine": "RAMA 01", "id": 9138, "order": "43892513", "status": "finished", "produced": 202, "expected": 5000, "bad": 0, "scraps": 0, "reworks": 0, "start": "2025-03-05T16:47:23.731Z", "end": "2025-03-05T19:00:36.177Z" }

Última atualização em Nov 17, 2026

API mify.com.br: qualidade (peças ruins, refugo e retrabalho)

Permite registrar apontamentos de qualidade por Ordem de Produção. Cada tipo tem sua própria rota, mas compartilham a mesma estrutura de corpo: ordem + quantidade + motivo. Documentação para a plataforma *.mify.com.br. Se você usa *.mify.app.br, veja Qualidade — mify.app.br. | Apontamento | Rota | Campo na Ordem | | --- | --- | --- | | Peças ruins | /report-bad | bad | | Refugo | /report-scrap | scraps | | Retrabalho | /report-rework | reworks | O motivo (reason) deve estar previamente cadastrado no iMetrics antes de ser utilizado. ERP → iMetrics O ERP registra apontamentos de qualidade diretamente na API do iMetrics. Estas são rotas POST reais — criam um apontamento novo a cada chamada. Endpoint — Peças Ruins POST https://app.mify.com.br/api/v2/integration/external/machine/RAMA 01/report-bad Endpoint — Refugo POST https://app.mify.com.br/api/v2/integration/external/machine/RAMA 01/report-scrap Endpoint — Retrabalho POST https://app.mify.com.br/api/v2/integration/external/machine/RAMA 01/report-rework Autenticação x-api-key: 00000000-0000-0000-0000-000000000000 Parâmetros do Corpo (JSON) O corpo é idêntico para as três rotas. | Parâmetro | Tipo | Obrigatório | Descrição | Exemplo | | --- | --- | --- | --- | --- | | order | string | Sim | Ordem de Produção (código único) da ordem a ser apontada | "43892513" | | quantity | integer | Sim | Quantidade impactada | 12 | | reason | string | Sim | Motivo do apontamento (previamente cadastrado no iMetrics) | "Falha no corte" | Exemplo de Requisição — Peças Ruins curl --location 'https://app.mify.com.br/api/v2/integration/external/machine/RAMA 01/report-bad' \ --header 'x-api-key: 00000000-0000-0000-0000-000000000000' \ --header 'Content-Type: application/json' \ --data '{ "order": "43892513", "quantity": 12, "reason": "Falha no corte" }' Exemplo de Requisição — Refugo curl --location 'https://app.mify.com.br/api/v2/integration/external/machine/RAMA 01/report-scrap' \ --header 'x-api-key: 00000000-0000-0000-0000-000000000000' \ --header 'Content-Type: application/json' \ --data '{ "order": "43892513", "quantity": 8, "reason": "Material fora de especificação" }' Exemplo de Requisição — Retrabalho curl --location 'https://app.mify.com.br/api/v2/integration/external/machine/RAMA 01/report-rework' \ --header 'x-api-key: 00000000-0000-0000-0000-000000000000' \ --header 'Content-Type: application/json' \ --data '{ "order": "43892513", "quantity": 5, "reason": "Reprocesso de bobina" }' Resposta { "order": "43892513", "quantity": 12, "reason": "Falha no corte" } iMetrics → ERP Webhook O iMetrics dispara um webhook para o ERP sempre que um apontamento de qualidade é registrado. O ERP deve expor uma rota por tipo de apontamento que o iMetrics irá chamar. As URLs são configuradas no painel do iMetrics. Endpoints (definidos pelo ERP) — Peças Ruins POST https://my-erp.com/api/v1/quality/bad Endpoints (definidos pelo ERP) — Refugo POST https://my-erp.com/api/v1/quality/scrap Endpoints (definidos pelo ERP) — Retrabalho POST https://my-erp.com/api/v1/quality/rework Corpo Enviado (JSON) | Campo | Tipo | Descrição | | --- | --- | --- | | triggerEvent | string | Tipo do evento que disparou o webhook | | machine | string | Nome da máquina | | order | string | Ordem de Produção | | quantity | integer | Quantidade apontada | | reason | string | Motivo do apontamento | Exemplo do Corpo Enviado — Retrabalho { "triggerEvent": "quality.rework", "machine": "RAMA 01", "order": "43892513", "quantity": 5, "reason": "Reprocesso de bobina" } Observações 1. O order deve corresponder a uma Ordem de Produção existente no iMetrics; caso contrário o apontamento é rejeitado. 2. Os valores são refletidos nos campos bad, scraps e reworks da resposta de Ordem de Produção. 3. As URLs do ERP são configuradas no painel do iMetrics, uma por tipo de apontamento.

Última atualização em Nov 17, 2026

API mify.com.br: paradas

Permite consultar os registros de parada e produção (rodando/parado) de uma máquina dentro de um período, com filtros opcionais por grupo e tipo. Documentação para a plataforma *.mify.com.br. Se você usa *.mify.app.br, veja Paradas — mify.app.br. iMetrics → ERP Consulta O ERP consulta o iMetrics para obter os registros de parada/produção de uma máquina. ℹ️ Por que POST numa consulta? Esta rota não cria nem altera nada — é uma consulta. Usamos POST em vez de GET porque o corpo da requisição permite mais filtros do que a query string suportaria. Nesta plataforma isso já fica indicado pelo nome da rota: get-running. Endpoint POST https://app.mify.com.br/api/v2/integration/external/machine/RAMA 01/get-running Autenticação x-api-key: 00000000-0000-0000-0000-000000000000 Parâmetros do Corpo (JSON) | Parâmetro | Tipo | Obrigatório | Descrição | Exemplo | | --- | --- | --- | --- | --- | | start | string | Não | Data/hora de início (ISO 8601 UTC) | "2025-03-01T03:00:00Z" | | end | string | Não | Data/hora de término (ISO 8601 UTC) | "2025-03-10T03:00:00Z" | | group | string | Não | Filtro por grupo de parada | "MANUTENÇÃO" | | type | string | Não | Filtro por tipo de parada | "MECÂNICA" | Exemplo de Requisição — Com filtros curl --location 'https://app.mify.com.br/api/v2/integration/external/machine/RAMA 01/get-running' \ --header 'x-api-key: 00000000-0000-0000-0000-000000000000' \ --header 'Content-Type: application/json' \ --data '{ "start": "2025-03-01T03:00:00Z", "end": "2025-03-10T03:00:00Z", "group": "MANUTENÇÃO", "type": "MECÂNICA" }' Exemplo de Requisição — Sem filtros curl --location 'https://app.mify.com.br/api/v2/integration/external/machine/RAMA 01/get-running' \ --header 'x-api-key: 00000000-0000-0000-0000-000000000000' \ --header 'Content-Type: application/json' \ --data '{ "start": "2025-03-01T03:00:00Z", "end": "2025-03-10T03:00:00Z" }' Estrutura da Resposta (JSON Array) A resposta é um array de registros de rodando/parado. | Campo | Tipo | Descrição | | --- | --- | --- | | machine | string | Nome da máquina | | start | string | Data/hora de início do registro (ISO 8601 UTC) | | end | string | null | Data/hora de término; null se em curso | | durationMs | integer | null | Duração em milissegundos; null se em curso | | event | 0 | 1 | 0 = Parado, 1 = Rodando | | group | string | null | Grupo da parada | | subGroup | string | null | Subgrupo da parada | | type | string | null | Tipo da parada | | subType | string | null | Subtipo da parada | | justification | string | null | Justificativa da parada | | programmed | string | null | Nome da parada programada | | routine | string | null | Nome da parada de rotina | Exemplo de Resposta [ { "machine": "RAMA 01", "start": "2025-03-05T12:31:04.569Z", "end": null, "durationMs": null, "event": 1, "justification": null, "group": null, "subGroup": null, "type": null, "subType": null, "programmed": null, "routine": null }, { "machine": "RAMA 01", "start": "2025-03-07T19:48:34.295Z", "end": "2025-03-07T19:57:14.789Z", "durationMs": 520493, "event": 0, "justification": "Conserto motor cilindro acumulador rama", "group": "MANUTENÇÃO", "subGroup": "MANUTENÇÃO", "type": "MECÂNICA", "subType": "MECÂNICA", "programmed": null, "routine": null } ] Observações 1. Os campos group, subGroup, type, subType, justification, programmed e routine são null quando a parada não foi informada. 2. Registros em andamento têm end e durationMs como null. 3. Paradas informadas sempre terão group + subGroup + type + subType, ou programmed, ou routine. Webhook O iMetrics dispara um webhook para o ERP quando um evento de parada ocorre em uma máquina. O ERP deve expor uma rota que receberá o POST do iMetrics. A URL é configurada no painel do iMetrics. Endpoint (definido pelo ERP) POST https://my-erp.com/api/v1/stops/event Eventos que disparam o webhook | Evento | Quando ocorre | | --- | --- | | stop.started | Máquina parou | | stop.ended | Máquina voltou a rodar | | stop.informed | Parada foi justificada | Corpo Enviado (JSON) | Campo | Tipo | Descrição | | --- | --- | --- | | triggerEvent | string | Tipo do evento que disparou o webhook | | machine | string | Nome da máquina | | start | string | Data/hora de início do registro (ISO 8601 UTC) | | end | string | null | Data/hora de término; null se em curso | | durationMs | integer | null | Duração em milissegundos; null se em curso | | event | 0 | 1 | 0 = Parado, 1 = Rodando | | group | string | null | Grupo da parada | | type | string | null | Tipo da parada | | justification | string | null | Justificativa da parada | Exemplo do Corpo Enviado { "triggerEvent": "stop.informed", "machine": "RAMA 01", "start": "2025-03-07T19:48:34.295Z", "end": "2025-03-07T19:57:14.789Z", "durationMs": 520493, "event": 0, "group": "MANUTENÇÃO", "type": "MECÂNICA", "justification": "Conserto motor cilindro acumulador rama" }

Última atualização em Nov 17, 2026