Integração iMetrics — mify.com.br

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.