Documentação da API de Detalhes de Produção

Descrição

Retorna os detalhes dos diários de produção de uma máquina específica ("RAMA 01" no exemplo) dentro de um período de tempo especificado.

Endpoint

POST `https://app.mify.com.br/api/v2/integration/external/machine/RAMA 01/get-production-detail`

Autenticação

x-api-key: 8h4t6248-38df-4470-8f56-831441a723dc

Parâmetros do Corpo (JSON)

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
start	string	Não	Data/hora de início no formato ISO 8601 (UTC)	"2025-03-01T03:00:00Z"
end	string	Não	Data/hora de término no formato ISO 8601 (UTC)	"2025-03-10T03:00:00Z"
status	string	Não	Filtro por status de produção	"pending"
order	string	Não	Número do pedido para filtrar produções específicas	"43892513"

Exemplo de Requisição

curl \--location 'https://app.mify.com.br/api/v2/integration/external/machine/RAMA 01/get-production-detail' \\
\--header 'x-api-key: 8h4t6248-38df-4470-8f56-831441a723dc' \\
\--data '{
    "start": "2025-03-01T03:00:00Z",
    "end": "2025-03-10T03:00:00Z",
    "status": "finished",
    "order": "43892513"
}'

Resposta da Requisição

Estrutura da Resposta (JSON Array)

A resposta é um array de objetos contendo os detalhes completos da produção. Cada objeto possui a seguinte estrutura:

Campo	Tipo	Descrição
id	integer	ID único da produção (interno Mify)
start	string	Data/hora de início (ISO 8601 UTC)
end	string	Data/hora de término (ISO 8601 UTC)
order	string	Ordem de fabricação do pedido associado
lote	string	Número do lote de produção
productId	string	Código do produto produzido
description	string	Descrição do produto produzido
observation	string | null	Observações adicionais sobre a produção
status	string	Status da produção (ex: "finished")
expected	integer	Quantidade total esperada para produção
produced	integer	Quantidade efetivamente produzida
bad	integer	Quantidade de itens defeituosos
scraps	integer	Quantidade de retrabalhos
reworks	integer	Quantidade de refugos
pulseFactor	string	Quantidade produzida a cada pulso que o coletor recebe
cycleTime	string	Tempo de ciclo de produção (segundo)
idealObjective	string	Objetivo ideal de produção (minuto)
realProduction	integer	Dados de produção real (minuto)
runningTimeMs	integer	Tempo de execução (milissegundos)
measurementUnit	string	Unidade de medida da produção (ex: "mts" para metros)
startedBy	object | null	Usuário que iniciou a produção (contém username)
finishedBy	object | null	Usuário que finalizou a produção (contém username)

Exemplo de Resposta

[
  {
    "id": 9138,
    "order": "43892513",
    "expected": 5000,
    "produced": 202,
    "productId": "4389",
    "status": "finished",
    "lote": "1969",
    "bad": 0,
    "observation": "",
    "idealObjective": "2.68752",
    "pulseFactor": "0.00000625",
    "description": "TNT 5D 200mm",
    "startedBy": {
        "username": "mify.luiz"
    },
    "finishedBy": {
        "username": "mify.cesar"
    },
    "scraps": 0,
    "reworks": 0,
    "start": "2025-03-05T16:47:23.731Z",
    "end": "2025-03-05T19:00:36.177Z",
    "cycleTime": "0.0166",
    "runningTimeMs": 13641125,
    "realProduction": 0.88,
    "measurementUnit": "mts"
  }
]