Qualidade — Peças Ruins, Refugo e Retrabalho — mify.com.br

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.