Integração Mify — mify.app.br

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.