Blog

Objetivo

Permite consultar ordens de produção, incluindo composição planejada, produções executadas, matérias-primas consumidas, lotes utilizados e custos da ordem.

Rota

GET /v1/ordemProducao_getall

Parâmetros

Parâmetro	Tipo	Descrição
Page	Integer	Número da página.
PageSize	Integer	Quantidade de registros por página.
CodigoEmpresa	String	Código da empresa.
CodigoFilial	String	Código da filial.
NumeroOrdem	Integer	Número da ordem de produção.
AnoOrdem	Integer	Ano da ordem de produção.
CodigoProduto	String	Código do produto.
TipoOrdem	String	Código do tipo da ordem.
StatusOrdem	String	Código do status da ordem.

Parâmetros obrigatórios

codigoEmpresa e codigoFilial são obrigatórios

Entretanto, quando o parâmetro NumeroOrdem for informado, o parâmetro AnoOrdem também deverá ser enviado. Caso contrário, a API retornará uma validação informando a obrigatoriedade dessa combinação.

Exemplo de requisição

GET /v1/ordemProducao_getall?Page=1&PageSize=50&CodigoEmpresa=1&CodigoFilial=1&NumeroOrdem=575&AnoOrdem=2026

Estrutura do retorno

{
  "pageSize": 50,
  "currentPage": 1,
  "maxPageSize": 200,
  "totalPages": 1,
  "totalItens": 1,
  "data": [
    {
      "codigoEmpresa": "1",
      "codigoFilial": "1",
      "nomeFilial": "Filial 1",
      "numeroOrdem": 575,
      "anoOrdem": 2026,
      "codigoProduto": "B1",
      "descricaoProduto": "Produto acabado",
      "unidadeMedida": "UN",
      "codigoFormula": 1,
      "descricaoFormula": "Fórmula padrão",
      "dataDigitacao": "2026-07-14",
      "dataEntrega": "2026-07-14",
      "nomeSetorProdutivo": "Produção",
      "quantidadeProduzir": 5,
      "quantidadeProduzida": 5,
      "quantidadeCarga": 0,
      "statusOrdem": {
        "codigo": "B",
        "descricao": "Aberta"
      },
      "tipoOrdem": {
        "codigo": "P",
        "descricao": "Produção"
      },
      "numeroLote": null,
      "observacao": null,
      "custoTotalMaterial": 0,
      "custoTotalEmbalagem": 0,
      "custoTotalMaoObra": 0,
      "custoTotalOrdem": 0,
      "custoUnitarioOrdem": 0,
      "composicaoOrdem": [],
      "producoesExecutadas": []
    }
  ]
}

Campos principais

Campo	Descrição
codigoEmpresa	Código da empresa da ordem.
codigoFilial	Código da filial da ordem.
nomeFilial	Nome da filial.
numeroOrdem	Número da ordem de produção.
anoOrdem	Ano da ordem.
codigoProduto	Código do produto produzido.
descricaoProduto	Descrição do produto.
unidadeMedida	Unidade de medida.
codigoFormula	Código da fórmula utilizada.
descricaoFormula	Descrição da fórmula.
dataDigitacao	Data de digitação da ordem.
dataEntrega	Data de entrega informada.
nomeSetorProdutivo	Setor responsável pela produção.
quantidadeProduzir	Quantidade prevista para produção.
quantidadeProduzida	Quantidade já produzida.
quantidadeCarga	Quantidade de carga da ordem.
statusOrdem	Código e descrição do status.
tipoOrdem	Código e descrição do tipo da ordem.
numeroLote	Número do lote, quando houver.
observacao	Observação cadastrada.
custoTotalMaterial	Custo total de materiais.
custoTotalEmbalagem	Custo total de embalagens.
custoTotalMaoObra	Custo total de mão de obra.
custoTotalOrdem	Custo total da ordem.
custoUnitarioOrdem	Custo unitário da ordem.
composicaoOrdem	Composição planejada da ordem.
producoesExecutadas	Produções já executadas.

Composição planejada

Campo	Descrição
codigoMateriaPrima	Código da matéria-prima.
descricaoMateriaPrima	Descrição da matéria-prima.
unidadeMateriaPrima	Unidade de medida.
quantidadeUsar	Quantidade prevista para uso.

Produção executada

Campo	Descrição
dataProducao	Data da produção.
quantidadeProduzida	Quantidade produzida.
tipoLancamento	Tipo do lançamento.
composicao	Matérias-primas utilizadas.

Lotes utilizados

Campo	Descrição
numeroLoteUsado	Número do lote.
dataValidadeLote	Data de validade.
quantidadeUsadaLote	Quantidade utilizada.