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

API mify.app.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.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.