Principal Integração ERP (API) API mify.com.br: qualidade (peças ruins, refugo e retrabalho)

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

Última atualização em Nov 17, 2026

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.