Qualidade — Peças Ruins, Refugo e Retrabalho — mify.app.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.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.