Referência

Qualidade da produção

Planos de inspecção, inspecções por lote, quarentena, não conformidades com acções correctivas, instrumentos de medição e certificado de qualidade. Um lote em quarentena fica num armazém à parte até a qualidade o libertar.

Operação	O que faz
GET `/api/producao/qualidade/planos`	Os planos de inspecção: o artigo, o momento da inspecção e os pontos de controlo.
GET `/api/producao/qualidade/planos/{id}`	Um plano de inspecção com os pontos de controlo.
POST `/api/producao/qualidade/planos`	Cria um plano de inspecção para um artigo, num momento (`Recepcao`, `EmProcesso` ou `Final`), com os pontos de controlo.
PUT `/api/producao/qualidade/planos/{id}`	Altera os pontos de controlo, a observação e a exigência de libertação de um plano (esta só vale num plano `Final`).
POST `/api/producao/qualidade/planos/{id}/desactivar`	Desactiva um plano de inspecção.
GET `/api/producao/qualidade/inspeccoes`	As inspecções registadas, com o resultado.
GET `/api/producao/qualidade/inspeccoes/{id}`	Uma inspecção com as medições e o resultado.
POST `/api/producao/qualidade/inspeccoes`	Regista uma inspecção a um plano, com as medições.
GET `/api/producao/qualidade/por-inspeccionar`	O que falta inspeccionar: lotes (ou, nos artigos sem lote, entradas e ordens) com um plano activo e ainda nenhuma inspecção desse momento.
GET `/api/producao/qualidade/lotes`	Os lotes de um artigo que se podem inspeccionar.
GET `/api/producao/qualidade/quarentena/armazens`	Os armazéns, com a indicação de quais são de quarentena.
POST `/api/producao/qualidade/quarentena/armazens`	Cria o armazém «Quarentena» de um estabelecimento, já marcado como tal.
PUT `/api/producao/qualidade/quarentena/armazens/{id}`	Designa um armazém como o de quarentena do seu estabelecimento (um só por estabelecimento), ou retira-lhe a marca.
GET `/api/producao/qualidade/quarentena/lotes`	O que a qualidade tem de decidir ou de mover: os lotes em quarentena e os lotes que reprovaram e ainda estão fora dela.
POST `/api/producao/qualidade/quarentena/lotes/{loteId}/colocar`	Põe um lote (ou parte dele) em quarentena: transfere-o do armazém onde está para o de quarentena do mesmo estabelecimento.
POST `/api/producao/qualidade/quarentena/lotes/{loteId}/libertar`	Liberta um lote da quarentena: só com a última inspecção do lote aprovada, transfere a quantidade para o armazém de destino.
GET `/api/producao/qualidade/quarentena/movimentos`	Os movimentos de qualidade (entradas e saídas de quarentena).
GET `/api/producao/qualidade/nao-conformidades`	As não conformidades, abertas e fechadas.
GET `/api/producao/qualidade/nao-conformidades/{id}`	Uma não conformidade com a causa, as acções correctivas e a decisão.
POST `/api/producao/qualidade/nao-conformidades`	Abre uma não conformidade à mão.
PUT `/api/producao/qualidade/nao-conformidades/{id}/causa`	Regista (ou altera) a causa de uma não conformidade.
POST `/api/producao/qualidade/nao-conformidades/{id}/accoes`	Acrescenta uma acção correctiva, com o responsável e o prazo.
POST `/api/producao/qualidade/nao-conformidades/{id}/accoes/{accaoId}/concluir`	Dá uma acção correctiva por concluída.
POST `/api/producao/qualidade/nao-conformidades/{id}/accoes/{accaoId}/cancelar`	Cancela uma acção correctiva.
POST `/api/producao/qualidade/nao-conformidades/{id}/decisao`	Decide uma não conformidade e cumpre a decisão no stock, tudo ou nada.
GET `/api/producao/qualidade/instrumentos`	Os instrumentos de medição e a validade da calibração de cada um.
POST `/api/producao/qualidade/instrumentos`	Regista um instrumento de medição: código, nome e, se houver, a validade da calibração.
PUT `/api/producao/qualidade/instrumentos/{id}`	Altera o nome, a validade da calibração e a observação de um instrumento, ou desactiva-o.
GET `/api/producao/qualidade/certificado/{loteId}`	O certificado de qualidade de um lote.
GET `/api/producao/qualidade/indicadores`	Os números simples da qualidade num período, com a definição de cada um.

GET/api/producao/qualidade/planos#

Os planos de inspecção: o artigo, o momento da inspecção e os pontos de controlo.

Permissão Producao.QualidadeVer

Filtros: produtoId, momento e apenasActivos (por omissão, verdadeiro).

Parâmetros

Nome	Onde	Tipo
`produtoId`	na pesquisa	identificador (UUID)
`momento`	na pesquisa	texto
`apenasActivos`	na pesquisa	verdadeiro/falso

Pedido

curl

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

GET/api/producao/qualidade/planos/{id}#

Um plano de inspecção com os pontos de controlo.

Permissão Producao.QualidadeVer

Parâmetros

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

Pedido

curl

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

POST/api/producao/qualidade/planos#

Cria um plano de inspecção para um artigo, num momento (Recepcao, EmProcesso ou Final), com os pontos de controlo.

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

Só há um plano activo por artigo e momento. exigeLibertacao só é válido num plano Final: o lote acabado fica em quarentena até ser libertado.

Corpo do pedido (JSON · CriarPlanoDeInspeccaoCommand)

Campo	Tipo	Obrigatório	Significado
`produtoId`	identificador (UUID)	sim	O artigo.
`momento`	texto	sim
`observacao`	texto ou nulo		O texto livre.
`pontos`	lista de objectos	sim
`pontos[].nome`	texto	sim	O nome.
`pontos[].tipo`	texto	sim
`pontos[].minimo`	número ou nulo
`pontos[].maximo`	número ou nulo
`pontos[].unidade`	texto ou nulo
`pontos[].obrigatorio`	verdadeiro/falso
`exigeLibertacao`	verdadeiro/falso

Resposta

Devolve 201 com o id do registo criado.

Pedido

curl

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

PUT/api/producao/qualidade/planos/{id}#

Altera os pontos de controlo, a observação e a exigência de libertação de um plano (esta só vale num plano Final).

Permissão Producao.PlanosDeInspeccaoEditar

Se nenhuma inspecção usou o plano, altera-se no sítio; se já serviu, cria-se uma nova versão e a anterior desactiva-se (o histórico das inspecções não muda). Devolve o id do plano em vigor.

Parâmetros

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

Corpo do pedido (JSON · ActualizarPlanoRequest)

Campo	Tipo	Obrigatório	Significado
`observacao`	texto ou nulo		O texto livre.
`pontos`	lista de objectos	sim
`pontos[].nome`	texto	sim	O nome.
`pontos[].tipo`	texto	sim
`pontos[].minimo`	número ou nulo
`pontos[].maximo`	número ou nulo
`pontos[].unidade`	texto ou nulo
`pontos[].obrigatorio`	verdadeiro/falso
`exigeLibertacao`	verdadeiro/falso

Pedido

curl

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

POST/api/producao/qualidade/planos/{id}/desactivar#

Desactiva um plano de inspecção.

Permissão Producao.PlanosDeInspeccaoEditar

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/qualidade/planos/<id>/desactivar' \
  -H 'X-Api-Key: <a-sua-chave>'

GET/api/producao/qualidade/inspeccoes#

As inspecções registadas, com o resultado.

Permissão Producao.QualidadeVer

Filtros: produtoId, loteId, resultado e momento.

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

Parâmetros

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

Pedido

curl

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

GET/api/producao/qualidade/inspeccoes/{id}#

Uma inspecção com as medições e o resultado.

Permissão Producao.QualidadeVer

Parâmetros

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

Pedido

curl

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

POST/api/producao/qualidade/inspeccoes#

Regista uma inspecção a um plano, com as medições.

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

O resultado (aprovado ou reprovado) calcula-se no servidor, por comparação das medições com os limites do plano; nunca é indicado por quem inspecciona. Não mexe no stock: a quarentena e a libertação são operações à parte. Uma inspecção reprovada abre uma não conformidade sozinha.

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

Corpo do pedido (JSON · RegistarInspeccaoCommand)

Campo	Tipo	Obrigatório	Significado
`planoId`	identificador (UUID)	sim
`loteId`	identificador (UUID) ou nulo		O lote, quando o artigo controla validade.
`ordemId`	identificador (UUID) ou nulo
`entradaId`	identificador (UUID) ou nulo
`medicoes`	lista de objectos	sim
`medicoes[].pontoId`	identificador (UUID)	sim
`medicoes[].valor`	número ou nulo		O valor.
`medicoes[].passou`	verdadeiro/falso ou nulo
`observacao`	texto ou nulo		O texto livre.
`instrumentoId`	identificador (UUID) ou nulo

Resposta

Devolve 201 com o id do registo criado.

Erros específicos

IDEMPOTENCIA_CONFLITO — além dos gerais.

Pedido

curl

curl -X POST 'https://<endereço-da-API>/api/producao/qualidade/inspeccoes' \
  -H 'X-Api-Key: <a-sua-chave>' \
  -H 'Idempotency-Key: <um-GUID-novo>' \
  -H 'Content-Type: application/json' \
  -d '{
  "planoId": "00000000-0000-0000-0000-000000000000",
  "medicoes": [
    {
      "pontoId": "00000000-0000-0000-0000-000000000000"
    }
  ]
}'

GET/api/producao/qualidade/por-inspeccionar#

O que falta inspeccionar: lotes (ou, nos artigos sem lote, entradas e ordens) com um plano activo e ainda nenhuma inspecção desse momento.

Permissão Producao.QualidadeVer

momento filtra o momento do plano; dias limita a antiguidade do que se olha.

Parâmetros

Nome	Onde	Tipo	Obrigatório
`momento`	na pesquisa	texto
`dias`	na pesquisa	número inteiro

Pedido

curl

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

GET/api/producao/qualidade/lotes#

Os lotes de um artigo que se podem inspeccionar.

Permissão Producao.QualidadeVer

produtoId é obrigatório.

Parâmetros

Nome	Onde	Tipo	Obrigatório
`produtoId`	na pesquisa	identificador (UUID)	sim

Pedido

curl

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

GET/api/producao/qualidade/quarentena/armazens#

Os armazéns, com a indicação de quais são de quarentena.

Permissão Producao.QualidadeVer

Pedido

curl

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

POST/api/producao/qualidade/quarentena/armazens#

Cria o armazém «Quarentena» de um estabelecimento, já marcado como tal.

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

lojaId é opcional quando a chave só tem um estabelecimento. Se o estabelecimento já tem um armazém de quarentena, ou um armazém com esse nome, o pedido diz-o.

Corpo do pedido (JSON · CriarArmazemRequest)

Campo	Tipo	Obrigatório	Significado
`lojaId`	identificador (UUID) ou nulo		O estabelecimento.

Resposta

Devolve 201 com o id do registo criado.

Pedido

curl

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

PUT/api/producao/qualidade/quarentena/armazens/{id}#

Designa um armazém como o de quarentena do seu estabelecimento (um só por estabelecimento), ou retira-lhe a marca.

Permissão Producao.QuarentenaGerir

emQuarentena. A marca só se retira com o armazém vazio: o que lá estivesse passaria a vender-se sem decisão da qualidade.

Devolve 204, sem corpo.

Parâmetros

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

Corpo do pedido (JSON · QuarentenaDoArmazemRequest)

Campo	Tipo	Obrigatório
`emQuarentena`	verdadeiro/falso	sim

Pedido

curl

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

GET/api/producao/qualidade/quarentena/lotes#

O que a qualidade tem de decidir ou de mover: os lotes em quarentena e os lotes que reprovaram e ainda estão fora dela.

Permissão Producao.QualidadeVer

situacao filtra por situação. Só leitura.

Parâmetros

Nome	Onde	Tipo	Obrigatório
`situacao`	na pesquisa	texto

Pedido

curl

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

POST/api/producao/qualidade/quarentena/lotes/{loteId}/colocar#

Põe um lote (ou parte dele) em quarentena: transfere-o do armazém onde está para o de quarentena do mesmo estabelecimento.

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

armazemOrigemId é obrigatório; sem quantidade, vai tudo o que está nesse armazém.

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

Parâmetros

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

Corpo do pedido (JSON · ColocarEmQuarentenaRequest)

Campo	Tipo	Obrigatório	Significado
`armazemOrigemId`	identificador (UUID)	sim
`quantidade`	número ou nulo		A quantidade.
`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/qualidade/quarentena/lotes/<loteId>/colocar' \
  -H 'X-Api-Key: <a-sua-chave>' \
  -H 'Idempotency-Key: <um-GUID-novo>' \
  -H 'Content-Type: application/json' \
  -d '{
  "armazemOrigemId": "00000000-0000-0000-0000-000000000000"
}'

POST/api/producao/qualidade/quarentena/lotes/{loteId}/libertar#

Liberta um lote da quarentena: só com a última inspecção do lote aprovada, transfere a quantidade para o armazém de destino.

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

armazemDeQuarentenaId é obrigatório. Sem armazemDestinoId, vai para o armazém de destino da ordem que produziu o lote ou, se não veio de uma ordem, para o armazém predefinido do estabelecimento; sem quantidade, vai tudo.

Usa a transferência de stock, por isso quem liberta precisa também da permissão de movimentar stock.

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

Parâmetros

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

Corpo do pedido (JSON · LibertarLoteRequest)

Campo	Tipo	Obrigatório	Significado
`armazemDeQuarentenaId`	identificador (UUID)	sim
`armazemDestinoId`	identificador (UUID) ou nulo
`quantidade`	número ou nulo		A quantidade.
`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/qualidade/quarentena/lotes/<loteId>/libertar' \
  -H 'X-Api-Key: <a-sua-chave>' \
  -H 'Idempotency-Key: <um-GUID-novo>' \
  -H 'Content-Type: application/json' \
  -d '{
  "armazemDeQuarentenaId": "00000000-0000-0000-0000-000000000000"
}'

GET/api/producao/qualidade/quarentena/movimentos#

Os movimentos de qualidade (entradas e saídas de quarentena).

Permissão Producao.QualidadeVer

loteId limita a um lote e quantos (por omissão 100) ao número de linhas.

Parâmetros

Nome	Onde	Tipo	Obrigatório
`loteId`	na pesquisa	identificador (UUID)
`quantos`	na pesquisa	número inteiro

Pedido

curl

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

GET/api/producao/qualidade/nao-conformidades#

As não conformidades, abertas e fechadas.

Permissão Producao.QualidadeVer

Filtros: estado, produtoId e loteId.

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)
`loteId`	na pesquisa	identificador (UUID)
`cursor`	na pesquisa	texto
`tamanho`	na pesquisa	número inteiro

Pedido

curl

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

GET/api/producao/qualidade/nao-conformidades/{id}#

Uma não conformidade com a causa, as acções correctivas e a decisão.

Permissão Producao.QualidadeVer

Parâmetros

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

Pedido

curl

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

POST/api/producao/qualidade/nao-conformidades#

Abre uma não conformidade à mão.

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

As que nascem de uma inspecção reprovada abrem-se sozinhas. produtoId e descricao são obrigatórios; loteId, quantidade e causa são opcionais.

Corpo do pedido (JSON · AbrirNaoConformidadeCommand)

Campo	Tipo	Obrigatório	Significado
`produtoId`	identificador (UUID)	sim	O artigo.
`descricao`	texto	sim	A descrição.
`loteId`	identificador (UUID) ou nulo		O lote, quando o artigo controla validade.
`quantidade`	número ou nulo		A quantidade.
`causa`	texto ou nulo

Resposta

Devolve 201 com o id do registo criado.

Pedido

curl

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

PUT/api/producao/qualidade/nao-conformidades/{id}/causa#

Regista (ou altera) a causa de uma não conformidade.

Permissão Producao.NaoConformidadesGerir

Devolve 204, sem corpo.

Parâmetros

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

Corpo do pedido (JSON · CausaRequest)

Campo	Tipo	Obrigatório
`causa`	texto ou nulo

Pedido

curl

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

POST/api/producao/qualidade/nao-conformidades/{id}/accoes#

Acrescenta uma acção correctiva, com o responsável e o prazo.

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

Parâmetros

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

Corpo do pedido (JSON · NovaAccaoRequest)

Campo	Tipo	Obrigatório	Significado
`descricao`	texto	sim	A descrição.
`responsavel`	texto ou nulo
`prazo`	data (AAAA-MM-DD) ou nulo

Resposta

Devolve 201 com o id do registo criado.

Pedido

curl

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

POST/api/producao/qualidade/nao-conformidades/{id}/accoes/{accaoId}/concluir#

Dá uma acção correctiva por concluída.

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

Ao concluir a última, uma não conformidade já decidida fecha-se.

Devolve 204, sem corpo.

Parâmetros

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

Corpo do pedido (JSON · NotasRequest)

Campo	Tipo	Obrigatório
`notas`	texto ou nulo

Pedido

curl

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

POST/api/producao/qualidade/nao-conformidades/{id}/accoes/{accaoId}/cancelar#

Cancela uma acção correctiva.

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

Devolve 204, sem corpo.

Parâmetros

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

Corpo do pedido (JSON · NotasRequest)

Campo	Tipo	Obrigatório
`notas`	texto ou nulo

Pedido

curl

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

POST/api/producao/qualidade/nao-conformidades/{id}/decisao#

Decide uma não conformidade e cumpre a decisão no stock, tudo ou nada.

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

decisao: LibertarComConcessao (liberta o lote para venda mesmo com a inspecção reprovada, com motivo e a permissão própria da concessão), Reprocessar (o lote fica em quarentena até uma nova inspecção aprovada), Abater (sai do stock como perda, por uma saída manual) ou Encerrar (sem mexer no stock). motivo é obrigatório.

Cada passo de stock usa a operação que já existe, por isso quem decide precisa também das permissões dela.

Devolve 204, sem corpo.

Parâmetros

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

Corpo do pedido (JSON · DecisaoRequest)

Campo	Tipo	Obrigatório
`decisao`	texto	sim
`motivo`	texto	sim

Pedido

curl

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

GET/api/producao/qualidade/instrumentos#

Os instrumentos de medição e a validade da calibração de cada um.

Permissão Producao.QualidadeVer

apenasActivos (por omissão, verdadeiro).

Parâmetros

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

Pedido

curl

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

POST/api/producao/qualidade/instrumentos#

Regista um instrumento de medição: código, nome e, se houver, a validade da calibração.

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

Corpo do pedido (JSON · CriarInstrumentoCommand)

Campo	Tipo	Obrigatório	Significado
`codigo`	texto	sim	O código curto.
`nome`	texto	sim	O nome.
`validadeDaCalibracao`	data (AAAA-MM-DD) ou nulo
`observacao`	texto ou nulo		O texto livre.

Resposta

Devolve 201 com o id do registo criado.

Pedido

curl

curl -X POST 'https://<endereço-da-API>/api/producao/qualidade/instrumentos' \
  -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/qualidade/instrumentos/{id}#

Altera o nome, a validade da calibração e a observação de um instrumento, ou desactiva-o.

Permissão Producao.InstrumentosEditar

O código não muda.

Devolve 204, sem corpo.

Parâmetros

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

Corpo do pedido (JSON · ActualizarInstrumentoRequest)

Campo	Tipo	Obrigatório	Significado
`nome`	texto	sim	O nome.
`validadeDaCalibracao`	data (AAAA-MM-DD) ou nulo
`observacao`	texto ou nulo		O texto livre.
`activo`	verdadeiro/falso		Se está activo.

Pedido

curl

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

GET/api/producao/qualidade/certificado/{loteId}#

O certificado de qualidade de um lote.

Permissão Producao.QualidadeVer

Sem validade fiscal: é um registo da qualidade da empresa, que a empresa assina por fora se o cliente o exigir.

Parâmetros

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

Pedido

curl

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

GET/api/producao/qualidade/indicadores#

Os números simples da qualidade num período, com a definição de cada um.

Permissão Producao.QualidadeVer

dias (por omissão 90) é o período. A «aprovação à primeira» é a parte dos lotes cuja primeira inspecção, no período, aprovou; não são os indicadores da ISO 22400.

Parâmetros

Nome	Onde	Tipo	Obrigatório
`dias`	na pesquisa	número inteiro

Pedido

curl

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