Referência

Produção

Fichas técnicas (receitas), ordens de produção, centros de trabalho, custo industrial e rastreabilidade por lote. Concluir uma ordem baixa a matéria do stock e dá entrada do produto acabado ao custo apurado, tudo numa só transacção; uma ordem concluída nunca se edita: desfaz-se com um estorno, num documento próprio.

Operação	O que faz
GET `/api/producao/centros`	Os centros de trabalho (máquinas, linhas ou postos) com a capacidade e o custo por hora.
POST `/api/producao/centros`	Cria um centro de trabalho: código, nome, custo por hora, horas por dia, postos e eficiência.
PUT `/api/producao/centros/{id}`	Altera os dados de um centro de trabalho.
PUT `/api/producao/centros/{id}/activo`	Activa ou desactiva um centro de trabalho.
GET `/api/producao/fichas`	As fichas técnicas (receitas) com o artigo que produzem, a versão e o estado.
POST `/api/producao/fichas`	Cria uma ficha técnica em rascunho: o artigo que produz, o rendimento, as linhas de matéria e, se houver, as operações e as outras saídas.
GET `/api/producao/fichas/{id}`	Uma ficha técnica completa: linhas, operações, saídas e o critério de reparto do custo.
PUT `/api/producao/fichas/{id}`	Altera uma ficha em rascunho.
POST `/api/producao/fichas/{id}/activar`	Activa uma ficha técnica: passa a ser a que vale para o artigo.
POST `/api/producao/fichas/{id}/nova-versao`	Cria uma nova versão, em rascunho, a partir de uma ficha existente.
GET `/api/producao/fichas/{id}/simulacao`	Simula quanto custa produzir uma quantidade, ao custo médio de hoje dos insumos, sem escrever nada.
GET `/api/producao/fichas/{id}/arvore`	A árvore de uma produção multinível: o que se precisa de cada insumo, o que o stock do armazém cobre e o que falta (a produzir ou a comprar).
GET `/api/producao/ordens`	As ordens de produção com o estado e as quantidades.
POST `/api/producao/ordens`	Cria uma ordem de produção, em rascunho, a partir de uma ficha técnica e de uma quantidade-alvo.
GET `/api/producao/ordens/{id}`	Uma ordem de produção completa: necessidades, consumos, saídas, custos e variações.
POST `/api/producao/ordens/{id}/planear`	Passa a ordem de rascunho a planeada: fotografa as necessidades de matéria (a partir da versão da ficha) e a política de stock negativo.
POST `/api/producao/ordens/{id}/iniciar`	Passa a ordem de planeada a em execução.
POST `/api/producao/ordens/{id}/concluir`	Conclui a ordem: baixa a matéria (por lote, FIFO), apura o custo industrial e dá entrada do produto acabado ao custo apurado.
POST `/api/producao/ordens/{id}/cancelar`	Cancela uma ordem em rascunho ou planeada, com motivo.
POST `/api/producao/ordens/{id}/estornar`	Estorna uma ordem concluída, num documento próprio: o acabado sai do stock e os insumos voltam ao lote de onde saíram, ao custo a que saíram.
POST `/api/producao/ordens/{id}/custos`	Regista um custo (mão-de-obra, energia, máquina, gastos gerais ou outro) numa ordem.
GET `/api/producao/painel`	O painel da produção: ordens em rascunho, planeadas, em execução, concluídas no mês e atrasadas, e as que estão em curso.
GET `/api/producao/relatorios`	O relatório da produção: por artigo, o que se produziu face ao planeado, o custo por unidade e as variações; e, mês a mês, a quantidade e o custo por unidade.
GET `/api/producao/relatorios/custos-por-centro`	Os custos operacionais (mão-de-obra, energia, máquina…) imputados às ordens, por centro de trabalho e por tipo, no período em que foram registados.
GET `/api/producao/rastreabilidade/lotes/{loteId}`	A rastreabilidade de um lote: de onde veio e para onde foi.

GET/api/producao/centros#

Os centros de trabalho (máquinas, linhas ou postos) com a capacidade e o custo por hora.

Permissão Producao.FichasLer

apenasActivos (por omissão, verdadeiro) deixa de fora os centros desactivados.

Parâmetros

Nome	Onde	Tipo	Obrigatório
`apenasActivos`	na pesquisa	verdadeiro/falso

Pedido

curl

curl 'https://<endereço-da-API>/api/producao/centros' \
  -H 'X-Api-Key: <a-sua-chave>'

POST/api/producao/centros#

Cria um centro de trabalho: código, nome, custo por hora, horas por dia, postos e eficiência.

Permissão Producao.CentrosEditar
Idempotência aceita Idempotency-Key

Corpo do pedido (JSON · CriarCentroDeTrabalhoCommand)

Campo	Tipo	Obrigatório	Significado
`codigo`	texto	sim	O código curto.
`nome`	texto	sim	O nome.
`custoPorHora`	número ou nulo
`horasPorDia`	número
`postos`	número inteiro
`eficienciaPercentual`	número

Resposta

Devolve 201 com o id do registo criado.

Pedido

curl

curl -X POST 'https://<endereço-da-API>/api/producao/centros' \
  -H 'X-Api-Key: <a-sua-chave>' \
  -H 'Idempotency-Key: <um-GUID-novo>' \
  -H 'Content-Type: application/json' \
  -d '{
  "codigo": "texto",
  "nome": "texto"
}'

PUT/api/producao/centros/{id}#

Altera os dados de um centro de trabalho.

Permissão Producao.CentrosEditar

Devolve 204, sem corpo.

Parâmetros

Nome	Onde	Tipo	Obrigatório
`id`	no caminho	identificador (UUID)	sim

Corpo do pedido (JSON · ActualizarCentroRequest)

Campo	Tipo	Obrigatório	Significado
`codigo`	texto	sim	O código curto.
`nome`	texto	sim	O nome.
`custoPorHora`	número ou nulo
`horasPorDia`	número
`postos`	número inteiro
`eficienciaPercentual`	número

Pedido

curl

curl -X PUT 'https://<endereço-da-API>/api/producao/centros/<id>' \
  -H 'X-Api-Key: <a-sua-chave>' \
  -H 'Content-Type: application/json' \
  -d '{
  "codigo": "texto",
  "nome": "texto"
}'

PUT/api/producao/centros/{id}/activo#

Activa ou desactiva um centro de trabalho.

Permissão Producao.CentrosEditar

Devolve 204, sem corpo.

Parâmetros

Nome	Onde	Tipo	Obrigatório
`id`	no caminho	identificador (UUID)	sim

Corpo do pedido (JSON · DefinirActivoRequest)

Campo	Tipo	Obrigatório	Significado
`activo`	verdadeiro/falso	sim	Se está activo.

Pedido

curl

curl -X PUT 'https://<endereço-da-API>/api/producao/centros/<id>/activo' \
  -H 'X-Api-Key: <a-sua-chave>' \
  -H 'Content-Type: application/json' \
  -d '{
  "activo": false
}'

GET/api/producao/fichas#

As fichas técnicas (receitas) com o artigo que produzem, a versão e o estado.

Permissão Producao.FichasLer

Filtros: filtro (texto), produtoId e estado.

A resposta é uma página: itens e proximoCursor. Ver Paginação.

Parâmetros

Nome	Onde	Tipo
`filtro`	na pesquisa	texto
`produtoId`	na pesquisa	identificador (UUID)
`estado`	na pesquisa	texto
`cursor`	na pesquisa	texto
`tamanho`	na pesquisa	número inteiro

Pedido

curl

curl 'https://<endereço-da-API>/api/producao/fichas' \
  -H 'X-Api-Key: <a-sua-chave>'

POST/api/producao/fichas#

Cria uma ficha técnica em rascunho: o artigo que produz, o rendimento, as linhas de matéria e, se houver, as operações e as outras saídas.

Permissão Producao.FichasEditar
Idempotência aceita Idempotency-Key

Só um rascunho se edita; a ficha activa-se à parte e nunca se edita depois: uma alteração é uma nova versão.

Corpo do pedido (JSON · CriarFichaTecnicaCommand)

Campo	Tipo	Obrigatório	Significado
`codigo`	texto	sim	O código curto.
`nome`	texto	sim	O nome.
`produtoId`	identificador (UUID)	sim	O artigo.
`rendimento`	número	sim
`linhas`	lista de objectos	sim
`linhas[].produtoId`	identificador (UUID)	sim	O artigo.
`linhas[].quantidade`	número	sim	A quantidade.
`linhas[].quebraPercentual`	número
`linhas[].unidadeId`	identificador (UUID) ou nulo
`linhas[].factor`	número
`linhas[].opcional`	verdadeiro/falso
`observacao`	texto ou nulo		O texto livre.
`operacoes`	lista de objectos ou nulo
`operacoes[].nome`	texto	sim	O nome.
`operacoes[].centroDeTrabalhoId`	identificador (UUID) ou nulo
`operacoes[].tempoDePreparacaoMinutos`	número
`operacoes[].tempoDeExecucaoMinutos`	número
`saidas`	lista de objectos ou nulo
`saidas[].produtoId`	identificador (UUID)	sim	O artigo.
`saidas[].tipo`	texto	sim
`saidas[].quantidade`	número	sim	A quantidade.
`saidas[].valorUnitarioReferencia`	número ou nulo
`criterio`	texto ou nulo
`valorDeReferenciaDoPrincipal`	número ou nulo

Resposta

Devolve 201 com o id do registo criado.

Pedido

curl

curl -X POST 'https://<endereço-da-API>/api/producao/fichas' \
  -H 'X-Api-Key: <a-sua-chave>' \
  -H 'Idempotency-Key: <um-GUID-novo>' \
  -H 'Content-Type: application/json' \
  -d '{
  "codigo": "texto",
  "nome": "texto",
  "produtoId": "00000000-0000-0000-0000-000000000000",
  "rendimento": 0,
  "linhas": [
    {
      "produtoId": "00000000-0000-0000-0000-000000000000",
      "quantidade": 0
    }
  ]
}'

GET/api/producao/fichas/{id}#

Uma ficha técnica completa: linhas, operações, saídas e o critério de reparto do custo.

Permissão Producao.FichasLer

Parâmetros

Nome	Onde	Tipo	Obrigatório
`id`	no caminho	identificador (UUID)	sim

Pedido

curl

curl 'https://<endereço-da-API>/api/producao/fichas/<id>' \
  -H 'X-Api-Key: <a-sua-chave>'

PUT/api/producao/fichas/{id}#

Altera uma ficha em rascunho.

Permissão Producao.FichasEditar

Só um rascunho se altera: uma ficha activa tem de passar por uma nova versão.

Devolve 204, sem corpo.

Parâmetros

Nome	Onde	Tipo	Obrigatório
`id`	no caminho	identificador (UUID)	sim

Corpo do pedido (JSON · ActualizarFichaRequest)

Campo	Tipo	Obrigatório	Significado
`codigo`	texto	sim	O código curto.
`nome`	texto	sim	O nome.
`produtoId`	identificador (UUID)	sim	O artigo.
`rendimento`	número	sim
`linhas`	lista de objectos	sim
`linhas[].produtoId`	identificador (UUID)	sim	O artigo.
`linhas[].quantidade`	número	sim	A quantidade.
`linhas[].quebraPercentual`	número
`linhas[].unidadeId`	identificador (UUID) ou nulo
`linhas[].factor`	número
`linhas[].opcional`	verdadeiro/falso
`observacao`	texto ou nulo		O texto livre.
`operacoes`	lista de objectos ou nulo
`operacoes[].nome`	texto	sim	O nome.
`operacoes[].centroDeTrabalhoId`	identificador (UUID) ou nulo
`operacoes[].tempoDePreparacaoMinutos`	número
`operacoes[].tempoDeExecucaoMinutos`	número
`saidas`	lista de objectos ou nulo
`saidas[].produtoId`	identificador (UUID)	sim	O artigo.
`saidas[].tipo`	texto	sim
`saidas[].quantidade`	número	sim	A quantidade.
`saidas[].valorUnitarioReferencia`	número ou nulo
`criterio`	texto ou nulo
`valorDeReferenciaDoPrincipal`	número ou nulo

Pedido

curl

curl -X PUT 'https://<endereço-da-API>/api/producao/fichas/<id>' \
  -H 'X-Api-Key: <a-sua-chave>' \
  -H 'Content-Type: application/json' \
  -d '{
  "codigo": "texto",
  "nome": "texto",
  "produtoId": "00000000-0000-0000-0000-000000000000",
  "rendimento": 0,
  "linhas": [
    {
      "produtoId": "00000000-0000-0000-0000-000000000000",
      "quantidade": 0
    }
  ]
}'

POST/api/producao/fichas/{id}/activar#

Activa uma ficha técnica: passa a ser a que vale para o artigo.

Permissão Producao.FichasActivar

Só há uma ficha activa por artigo: a anterior passa a obsoleta. Na activação confere-se que o artigo e os insumos ainda são válidos e que não há ciclos entre fichas.

Devolve 204, sem corpo.

Parâmetros

Nome	Onde	Tipo	Obrigatório
`id`	no caminho	identificador (UUID)	sim

Pedido

curl

curl -X POST 'https://<endereço-da-API>/api/producao/fichas/<id>/activar' \
  -H 'X-Api-Key: <a-sua-chave>'

POST/api/producao/fichas/{id}/nova-versao#

Cria uma nova versão, em rascunho, a partir de uma ficha existente.

Permissão Producao.FichasEditar

Parâmetros

Nome	Onde	Tipo	Obrigatório
`id`	no caminho	identificador (UUID)	sim

Resposta

Devolve 201 com o id do registo criado.

Pedido

curl

curl -X POST 'https://<endereço-da-API>/api/producao/fichas/<id>/nova-versao' \
  -H 'X-Api-Key: <a-sua-chave>'

GET/api/producao/fichas/{id}/simulacao#

Simula quanto custa produzir uma quantidade, ao custo médio de hoje dos insumos, sem escrever nada.

Permissão Producao.CustosVer

quantidade é obrigatória; custoOperacional (opcional) soma um custo que a ficha não conhece. Mostra custos, por isso exige a permissão de os ver.

Parâmetros

Nome	Onde	Tipo	Obrigatório
`id`	no caminho	identificador (UUID)	sim
`quantidade`	na pesquisa	número	sim
`custoOperacional`	na pesquisa	número

Pedido

curl

curl 'https://<endereço-da-API>/api/producao/fichas/<id>/simulacao' \
  -H 'X-Api-Key: <a-sua-chave>'

GET/api/producao/fichas/{id}/arvore#

A árvore de uma produção multinível: o que se precisa de cada insumo, o que o stock do armazém cobre e o que falta (a produzir ou a comprar).

Permissão Producao.FichasLer

quantidade é obrigatória; armazemId (opcional) escolhe o armazém cujo stock se confere. Só leitura; mostra stock, por isso exige também a permissão de o ver.

Parâmetros

Nome	Onde	Tipo	Obrigatório
`id`	no caminho	identificador (UUID)	sim
`quantidade`	na pesquisa	número	sim
`armazemId`	na pesquisa	identificador (UUID)

Pedido

curl

curl 'https://<endereço-da-API>/api/producao/fichas/<id>/arvore' \
  -H 'X-Api-Key: <a-sua-chave>'

GET/api/producao/ordens#

As ordens de produção com o estado e as quantidades.

Permissão Producao.OrdensLer

Filtros: estado e produtoId.

A resposta é uma página: itens e proximoCursor. Ver Paginação.

Parâmetros

Nome	Onde	Tipo
`estado`	na pesquisa	texto
`produtoId`	na pesquisa	identificador (UUID)
`cursor`	na pesquisa	texto
`tamanho`	na pesquisa	número inteiro

Pedido

curl

curl 'https://<endereço-da-API>/api/producao/ordens' \
  -H 'X-Api-Key: <a-sua-chave>'

POST/api/producao/ordens#

Cria uma ordem de produção, em rascunho, a partir de uma ficha técnica e de uma quantidade-alvo.

Permissão Producao.OrdensCriar
Idempotência aceita Idempotency-Key

Opcionais: o estabelecimento, os armazéns de origem e de destino, o início e o fim planeados, a origem e a ordem-mãe (quando a ordem serve outra de nível acima).

Corpo do pedido (JSON · CriarOrdemDeProducaoCommand)

Campo	Tipo	Obrigatório	Significado
`fichaTecnicaId`	identificador (UUID)	sim
`quantidadeAlvo`	número	sim
`lojaId`	identificador (UUID) ou nulo		O estabelecimento.
`armazemOrigemId`	identificador (UUID) ou nulo
`armazemDestinoId`	identificador (UUID) ou nulo
`inicioPlaneado`	data (AAAA-MM-DD) ou nulo
`fimPlaneado`	data (AAAA-MM-DD) ou nulo
`origem`	texto ou nulo
`ordemMaeId`	identificador (UUID) ou nulo

Resposta

Devolve 201 com o id do registo criado.

Pedido

curl

curl -X POST 'https://<endereço-da-API>/api/producao/ordens' \
  -H 'X-Api-Key: <a-sua-chave>' \
  -H 'Idempotency-Key: <um-GUID-novo>' \
  -H 'Content-Type: application/json' \
  -d '{
  "fichaTecnicaId": "00000000-0000-0000-0000-000000000000",
  "quantidadeAlvo": 0
}'

GET/api/producao/ordens/{id}#

Uma ordem de produção completa: necessidades, consumos, saídas, custos e variações.

Permissão Producao.OrdensLer

Os custos só vêm a quem tem a permissão de os ver (a quem não tem, vêm vazios).

Parâmetros

Nome	Onde	Tipo	Obrigatório
`id`	no caminho	identificador (UUID)	sim

Pedido

curl

curl 'https://<endereço-da-API>/api/producao/ordens/<id>' \
  -H 'X-Api-Key: <a-sua-chave>'

POST/api/producao/ordens/{id}/planear#

Passa a ordem de rascunho a planeada: fotografa as necessidades de matéria (a partir da versão da ficha) e a política de stock negativo.

Permissão Producao.OrdensPlanear

Uma ficha sem insumos não se planeia.

Devolve 204, sem corpo.

Parâmetros

Nome	Onde	Tipo	Obrigatório
`id`	no caminho	identificador (UUID)	sim

Pedido

curl

curl -X POST 'https://<endereço-da-API>/api/producao/ordens/<id>/planear' \
  -H 'X-Api-Key: <a-sua-chave>'

POST/api/producao/ordens/{id}/iniciar#

Passa a ordem de planeada a em execução.

Permissão Producao.OrdensIniciar

Devolve 204, sem corpo.

Parâmetros

Nome	Onde	Tipo	Obrigatório
`id`	no caminho	identificador (UUID)	sim

Pedido

curl

curl -X POST 'https://<endereço-da-API>/api/producao/ordens/<id>/iniciar' \
  -H 'X-Api-Key: <a-sua-chave>'

POST/api/producao/ordens/{id}/concluir#

Conclui a ordem: baixa a matéria (por lote, FIFO), apura o custo industrial e dá entrada do produto acabado ao custo apurado.

Permissão Producao.OrdensConcluir
Idempotência aceita Idempotency-Key

quantidadeProduzida é a que realmente se produziu: maior que zero e dentro do alvo mais a tolerância. A matéria baixa na proporção da ficha. lote indica o lote do acabado (já existente ou novo) e outrasSaidas as saídas da ficha (co-produtos, subprodutos, desperdícios), entre as quais o custo se reparte.

Tudo se grava numa só transacção: ou há consumos, saída e custos, ou não há nada.

Envie Idempotency-Key: repetir o pedido não o executa duas vezes. Ver Idempotência.

Parâmetros

Nome	Onde	Tipo	Obrigatório
`id`	no caminho	identificador (UUID)	sim

Corpo do pedido (JSON · ConcluirOrdemRequest)

Campo	Tipo	Obrigatório	Significado
`quantidadeProduzida`	número	sim
`lote`	objecto ou nulo
`lote.loteId`	identificador (UUID) ou nulo		O lote, quando o artigo controla validade.
`lote.novoLoteDescricao`	texto ou nulo
`lote.novoLoteValidade`	data e hora (ISO 8601) ou nulo
`outrasSaidas`	lista de objectos ou nulo
`outrasSaidas[].produtoId`	identificador (UUID)	sim	O artigo.
`outrasSaidas[].quantidade`	número ou nulo		A quantidade.
`outrasSaidas[].lote`	objecto ou nulo
`outrasSaidas[].lote.loteId`	identificador (UUID) ou nulo		O lote, quando o artigo controla validade.
`outrasSaidas[].lote.novoLoteDescricao`	texto ou nulo
`outrasSaidas[].lote.novoLoteValidade`	data e hora (ISO 8601) ou nulo

Erros específicos

IDEMPOTENCIA_CONFLITO — além dos gerais.

Pedido

curl

curl -X POST 'https://<endereço-da-API>/api/producao/ordens/<id>/concluir' \
  -H 'X-Api-Key: <a-sua-chave>' \
  -H 'Idempotency-Key: <um-GUID-novo>' \
  -H 'Content-Type: application/json' \
  -d '{
  "quantidadeProduzida": 0
}'

POST/api/producao/ordens/{id}/cancelar#

Cancela uma ordem em rascunho ou planeada, com motivo.

Permissão Producao.OrdensCancelar
Idempotência aceita Idempotency-Key

motivo é obrigatório. Uma ordem em execução não se cancela: conclui-se (com a quantidade realmente produzida) e, se for preciso, estorna-se.

Devolve 204, sem corpo.

Parâmetros

Nome	Onde	Tipo	Obrigatório
`id`	no caminho	identificador (UUID)	sim

Corpo do pedido (JSON · MotivoRequest)

Campo	Tipo	Obrigatório
`motivo`	texto ou nulo

Pedido

curl

curl -X POST 'https://<endereço-da-API>/api/producao/ordens/<id>/cancelar' \
  -H 'X-Api-Key: <a-sua-chave>' \
  -H 'Idempotency-Key: <um-GUID-novo>' \
  -H 'Content-Type: application/json' \
  -d '{}'

POST/api/producao/ordens/{id}/estornar#

Estorna uma ordem concluída, num documento próprio: o acabado sai do stock e os insumos voltam ao lote de onde saíram, ao custo a que saíram.

Permissão Producao.OrdensEstornar
Idempotência aceita Idempotency-Key

motivo é obrigatório. Só se o produto acabado ainda estiver disponível: se já foi vendido ou movido, o estorno é recusado e diz porquê. A ordem passa a estornada; nunca se edita.

Envie Idempotency-Key: repetir o pedido não o executa duas vezes. Ver Idempotência.

Parâmetros

Nome	Onde	Tipo	Obrigatório
`id`	no caminho	identificador (UUID)	sim

Corpo do pedido (JSON · MotivoRequest)

Campo	Tipo	Obrigatório
`motivo`	texto ou nulo

Erros específicos

IDEMPOTENCIA_CONFLITO — além dos gerais.

Pedido

curl

curl -X POST 'https://<endereço-da-API>/api/producao/ordens/<id>/estornar' \
  -H 'X-Api-Key: <a-sua-chave>' \
  -H 'Idempotency-Key: <um-GUID-novo>' \
  -H 'Content-Type: application/json' \
  -d '{}'

POST/api/producao/ordens/{id}/custos#

Regista um custo (mão-de-obra, energia, máquina, gastos gerais ou outro) numa ordem.

Permissão Producao.CustosEditar
Idempotência aceita Idempotency-Key

tipo (MaoDeObra, Energia, Maquina, GastosGerais ou Outro), e descricao são obrigatórios. Indique o valor (diferente de zero) ou, sem ele, as horas: o valor calcula-se como horas × taxa, e a taxa omissa é o custo por hora do centroDeTrabalhoId. Sem valor, sem taxa e sem centro com custo por hora, devolve 400. Exige a permissão de editar custos.

Parâmetros

Nome	Onde	Tipo	Obrigatório
`id`	no caminho	identificador (UUID)	sim

Corpo do pedido (JSON · CustoDaOrdemRequest)

Campo	Tipo	Obrigatório	Significado
`tipo`	texto	sim
`descricao`	texto	sim	A descrição.
`valor`	número ou nulo		O valor.
`horas`	número ou nulo
`taxa`	número ou nulo		A taxa, em percentagem.
`centroDeTrabalhoId`	identificador (UUID) ou nulo

Resposta

Devolve 201 com o id do registo criado.

Pedido

curl

curl -X POST 'https://<endereço-da-API>/api/producao/ordens/<id>/custos' \
  -H 'X-Api-Key: <a-sua-chave>' \
  -H 'Idempotency-Key: <um-GUID-novo>' \
  -H 'Content-Type: application/json' \
  -d '{
  "tipo": "texto",
  "descricao": "texto"
}'

GET/api/producao/painel#

O painel da produção: ordens em rascunho, planeadas, em execução, concluídas no mês e atrasadas, e as que estão em curso.

Permissão Producao.OrdensLer

Pedido

curl

curl 'https://<endereço-da-API>/api/producao/painel' \
  -H 'X-Api-Key: <a-sua-chave>'

GET/api/producao/relatorios#

O relatório da produção: por artigo, o que se produziu face ao planeado, o custo por unidade e as variações; e, mês a mês, a quantidade e o custo por unidade.

Permissão Producao.OrdensLer

de e ate limitam o período; produtoId limita a um artigo. Só contam as ordens concluídas. Os custos só vêm a quem tem a permissão de os ver.

Parâmetros

Nome	Onde	Tipo
`de`	na pesquisa	data (AAAA-MM-DD)
`ate`	na pesquisa	data (AAAA-MM-DD)
`produtoId`	na pesquisa	identificador (UUID)

Pedido

curl

curl 'https://<endereço-da-API>/api/producao/relatorios' \
  -H 'X-Api-Key: <a-sua-chave>'

GET/api/producao/relatorios/custos-por-centro#

Os custos operacionais (mão-de-obra, energia, máquina…) imputados às ordens, por centro de trabalho e por tipo, no período em que foram registados.

Permissão Producao.CustosVer

de e ate limitam o período (por omissão, o mês corrente; no máximo 36 meses). Não conta as ordens canceladas; os custos sem centro aparecem como «Sem centro». Exige a permissão de ver custos.

Parâmetros

Nome	Onde	Tipo	Obrigatório
`de`	na pesquisa	data (AAAA-MM-DD)
`ate`	na pesquisa	data (AAAA-MM-DD)

Pedido

curl

curl 'https://<endereço-da-API>/api/producao/relatorios/custos-por-centro' \
  -H 'X-Api-Key: <a-sua-chave>'

GET/api/producao/rastreabilidade/lotes/{loteId}#

A rastreabilidade de um lote: de onde veio e para onde foi.

Permissão Producao.RastreabilidadeVer

sentido: tras (de onde veio), frente (para onde foi) ou ambos (por omissão). profundidade limita os níveis percorridos.

Parâmetros

Nome	Onde	Tipo	Obrigatório
`loteId`	no caminho	identificador (UUID)	sim
`sentido`	na pesquisa	texto
`profundidade`	na pesquisa	número inteiro

Pedido

curl

curl 'https://<endereço-da-API>/api/producao/rastreabilidade/lotes/<loteId>' \
  -H 'X-Api-Key: <a-sua-chave>'