Histórico da Página

Disponibilizado endpoint para integração dos movimentos das solicitações de abastecimentos materiais e lubrificações automotivas serviços automotivos através do método GET e PUT para , atualização do status após integração (baixa) realizadade integração através do método PUT e atendimento da solicitação através do método POST.

Estrutura:

Atributos	Descrição	Tamanho	Tipo	Chave Primária	Requerido	Valor Default	Valores Válidos	Observação
id	Id único para rastreamento do registro de ponta a ponta

20

23

STRING

String

S

(lógica)

S

-

Gerado automaticamente quando o registro é inserido na tabela

origem

Origem do registro

Composto pela concatenação dos atributos ordemServico + sequencia + instancia
instancia	Código da instância	5

10

STRING

N

Abastecimento: CS_MNFABAS

Lubrificação: CS_MNFLUBR

-

instancia

ordemServico

Código

Número da

instância

ordem de serviço

5

9

STRING

NUMBER

N

-

boletim

sequencia

Número do boletim

Sequência

10

9

INTEGER

NUMBER

N

-

sequencia

tipoPecaServico

Tipo da Peça/Serviço

Sequência

3

INTEGER

NUMBER

N

-

ordemServico

Número da ordem de serviço

7

codigoMaterial

Código do material no PIMS

12

NUMBER

INTEGER

N

Null

-

Não envia.

-

dataApontamento

codigoMaterialERP

Data

Código do

apontamento

material no ERP

10

25

DATE

STRING

N

-

dataEnvio

descricaoMaterial

Data da coleta

Descrição do

registro

material

10

60

DATE

STRING

N

TRUNC(SYSDATE)

-

codigoMaterial

descricaoDetalhadaMaterial

Código do material

Descrição detalhada do material	150	STRING	N	N	-	-	-
unidadeMedida	Código da unidade de medida no PIMS

12

3

INTEGER

STRING

N

-

codigoMaterialERP

unidadeMedidaERP

Código

do material

da unidade de medida no ERP

25

3

STRING

N

-

quantidade

quantidadeSolicitada

Quantidade

solicitada	9,2	NUMBER	N	N	-	-	-
valorUnitarioPrevisto	Valor unitário previsto	10

12

,3

NUMBER

N

-

unidadeMedidaERP

dataNecessidade

Código da unidade de medida no ERP

Data da necessidade da solicitação	10	DATE	N	N	-	-	-
comentario	Comentário	250

5

STRING

N

-

centroCusto

codigoCentroCusto

Código do centro de custo no PIMS

20

INTEGER

NUMBER

N

-

centroCustoERP

codigoCentroCustoERP

Código do centro de custo no ERP

20

15

INTEGER

STRING	N	N	-	-	-
codigoDepositoERP	Código do depósito do material no ERP	15	STRING	N	N	-	-	-

usuario

codigoContaERP	Código da conta contábil padrão	20	STRING	N	N	-	-	-
tipoMovimento	Tipo do movimento	1	STRING	N	N	-	S = Saída / E = Entrada	-
tipoDocumento	Tipo do documento	1	STRING	N	N	-	R = Requisição de materiais S = Solicitação de compra de materiais ou serviços	-
solicitante	Usuário responsável pelo apontamento

250

10

STRING

N

-

Caso o usuário não esteja preenchido no apontamento:

codigoEmpresa

Código da empresa

5

STRING

N

-

Resgatado a partir do parâmetro do

BioEnergia

Bioenergia

Seção: '

INT_ERP

GERAIS' / Entrada: 'CD_

REQUISITANTE_MNF

EMPRESA'
codigoEmpresaERP	Código da empresa no ERP	250	STRING	N	N	-	-	Resgatado a partir do parâmetro do

BioEnergia

Bioenergia

Seção: 'INT_ERP' / Entrada: 'EMPRESA_ERP'

codigoFilialERP

Código da filial no ERP

250

STRING

N

-

Resgatado a partir do parâmetro do

BioEnergia

Bioenergia Seção: 'INT_ERP' / Entrada: 'FILIAL_ERP'
dataSolicitacao	Data da solicitação	10	DATE	N	N	SYSDATE	-	-
manutencaoInvestimento	Tipo da conta contábil padrão	1	STRING	N	N	"M"	M = Manutenção I = Investimento	-
origem	Origem	7	STRING	N	N	"MANFRO"	-	-
codigoSistemaVeicular	Código do sistema veicular	5	NUMBER	N	N	-	-	-
codigoSubsistemaVeicular	Código do subsistema veicular	5	NUMBER	N	N	-	-	-
codigoComponente	Código do componente	10	NUMBER	N	N	-	-	-
inspecaoInterna	Inspeção interna	1	STRING	N	N	-	-	Não envia
inspecaoExterna	Inspeção externa	1	STRING	N	N	-	-	Não envia
detalhamentoInspecao	Detalhamento da inspeção	2000	STRING	N	N	-	-	Não envia
equipeManutencaoSolicitante	Equipe de manutenção solicitante	40	STRING	N	N	-	-	Não envia
comprador	Comprador	20	STRING	N	N	-	-	Não envia
codigoContaInvestimento	Código da conta de investimento	20	STRING	N	N	-	-	Não envia
idSolicitacaoMatServInd	Identificador do registro de solicitação no PIMS	12	NUMBER	N	N	-	-	Não envia
imprimeBoleto	Imprime boleto	1	NUMBER	N	N	-	-	Não envia
codigoDepartamentoCusto	Código do departamento de custo	6	NUMBER	N	N	-	-	Não envia
codigoDivisaoCusto	Código da divisão de custo	6	NUMBER	N	N	-	-	Não envia
codigoOrdemInvestimentoCusto	Código da ordem de investimento de custo	8	NUMBER	N	N	-	-	Não envia
codigoEmpresaCusto	Código da empresa de custo	2	NUMBER	N	N	-	-	Não envia
classificacaoSolicitacao	Classificação da solicitação	1	STRING	N	N	-	-	Não envia

GET (Consulta Solicitações de Materiais/Serviços IndustriaisGET (Consulta Abastecimentos e Lubrificantes Automotivos consumidos para baixa no ERP)

http:127.0.0.1:8080/query/v1/baixaConsumiveisMativsolicitacaoMaterialServicoMativ?page=1&pagesize=2

Bloco de código

language	java
title	Response

{
    "hasNext": truefalse,
    "items": [
        {
            "id": "MNF00038000005312024"100000002033",
            "instancia": "1",
            "ordemServico": 260199,
            "sequencia": 1,
            "tipoPecaServico": null,
            "codigoMaterial": "221",
            "codigoMaterialERP": null,
            "origemdescricaoMaterial": "CS_MNFABAS"DESCRIÇÃO DO MATERIAL SOLICITADO",
            "descricaoDetalhadaMaterial": null,
            "instanciaunidadeMedida": "11PC",
            "boletimunidadeMedidaERP": 338117"PC",
            "sequenciaquantidadeSolicitada": 1,
            "ordemServicovalorUnitarioPrevisto": null,
            "dataApontamentodataNecessidade": "20242025-0507-15T0305T03:00:00.000+00:00",
            "comentario": null,
            "codigoCentroCusto": "30",
            "codigoCentroCustoERP": "30",
            "codigoDepositoERP": null,
            "codigoContaERP": null,
            "tipoMovimento": "S",
            "tipoDocumento": "R",
            "solicitante": null,
            "dataEnvio"codigoEmpresa": 1,
            "codigoEmpresaERP": null,
            "codigoFilialERP": null,
            "dataSolicitacao": "2025-0607-18T0307T16:0027:0026.000+00:00",
            "codigoMaterialmanutencaoInvestimento": "M",
            "origem": "PIMS-MI",
            "codigoSistemaVeicular": 214687null,
            "codigoMaterialERPcodigoSubsistemaVeicular": null,
            "214687codigoComponente": null,
            "quantidadeinspecaoInterna": 130.6"0",
            "unidadeMedidaERPinspecaoExterna": "L0",
            "centroCustodetalhamentoInspecao": 114035150null,
            "centroCustoERPequipeManutencaoSolicitante": "4.03.5.150""DESTILARIA",
            "comprador": null,
            "codigoDepositoERPcodigoContaInvestimento": "2",
      "EAM-FPOSTO"      "idSolicitacaoMatServInd": 100000002033,
            "usuarioimprimeBoleto": "0",
            "PIMSCScodigoDepartamentoCusto": null,
            "codigoEmpresaERPcodigoDivisaoCusto": null,
     "123"       "codigoOrdemInvestimentoCusto": null,
            "codigoFilialERPcodigoEmpresaCusto": null,
      "456"      "classificacaoSolicitacao": null
        },
        {
            "id": "100000002034",
            "instancia": "1",
            "ordemServico": 260229,
            "sequencia": 1,
            "tipoPecaServico": null,
       "MNF00038000005362024"     "codigoMaterial": "3271",
            "codigoMaterialERP": null,
            "origemdescricaoMaterial": "DESCRIÇÃO DO MATERIAL "CS_MNFABAS"SOLICITADO",
            "descricaoDetalhadaMaterial": null,
            "instanciaunidadeMedida": "11PC",
            "boletimunidadeMedidaERP": 338117"PC",
            "sequenciaquantidadeSolicitada": 61,
            "ordemServicovalorUnitarioPrevisto": null,
            "dataApontamentodataNecessidade": "20242025-0507-15T0305T03:00:00.000+00:00",
            "comentario": null,
            "codigoCentroCusto": "10",
            "codigoCentroCustoERP": "10",
            "codigoDepositoERP": null,
            "dataEnvio"codigoContaERP": null,
            "tipoMovimento": "S",
            "tipoDocumento": "R",
            "solicitante": null,
            "codigoEmpresa": 1,
            "codigoEmpresaERP": null,
            "codigoFilialERP": null,
            "dataSolicitacao": "2025-0607-18T0307T16:0027:0026.000+00:00",
            "manutencaoInvestimento": "M",
            "origem": "PIMS-MI",
            "codigoMaterialcodigoSistemaVeicular": 422286null,
            "codigoMaterialERPcodigoSubsistemaVeicular": null,
     "422286"       "codigoComponente": null,
            "quantidadeinspecaoInterna": 40.3"0",
            "unidadeMedidaERPinspecaoExterna": "L0",
            "centroCustodetalhamentoInspecao": 114035150null,
            "centroCustoERPequipeManutencaoSolicitante": "OFICINA "4.03.5.150"MECANICA",
            "comprador": null,
            "codigoDepositoERPcodigoContaInvestimento": "EAM-FPOSTO""2",
            "idSolicitacaoMatServInd": 100000002034,
            "usuarioimprimeBoleto": "PIMSCS""0",
            "codigoDepartamentoCusto": null,
            "codigoEmpresaERPcodigoDivisaoCusto": null,
            "123codigoOrdemInvestimentoCusto": null,
            "codigoFilialERPcodigoEmpresaCusto": null,
   "456"         "classificacaoSolicitacao": null
        }
    ]
}

Parâmetros

page: Número da página.
pagesize: Quantidade máxima de registros por página.

Observações

Abastecimentos
- O material/combustível informado no apontamento deve estar cadastrado e deve estar classificado como exporta = 'S'.
- O grupo de material do material/combustível informado no apontamento deve estar cadastrado e deve estar classificado como exporta = 'S'.
- O ponto de abastecimento informado no apontamento deve estar cadastrado e deve estar classificado como exporta = 'S'.
- O centro de custo do equipamento informado no apontamento deve estar cadastrado.
- A quantidade informada no apontamento deve ser maior que zero.
- Serão considerados apenas apontamentos desbloqueados.
Lubrificações
- O material/lubrificante informado no apontamento deve estar cadastrado e deve estar classificado como exporta = 'S'.
- O grupo de material do material/lubrificante informado no apontamento deve estar cadastrado e deve estar classificado como exporta = 'S'.
- O ponto de lubrificação informado no apontamento deve estar cadastrado e deve estar classificado como exporta = 'S'.
- O centro de custo do equipamento informado no apontamento deve estar cadastrado.
- A quantidade informada no apontamento deve ser maior que zero.
- Serão considerados apenas movimentos de troca e/ou remonta, desconsiderando movimentos de limpeza.

O usuário deverá disponibilizar a solicitação para o ERP.
Serão disponibilizados registros de solicitação cujo status de integração seja igual a "ER" ou nulo.

PUT (Atualiza o status da Solicitação de Material/Serviço)

http:127.0.0.1:8080/query/v1/solicitacaoMaterialServicoIndustrialMativ

Estrutura de dados para envio:

Bloco de código

language	java
title	Body
collapse	true

{
    "id": "100000002033",
    "statusERP": "ER",
    "mensagemIntegracao": "Mensagem de erro indicando o que precisa ser corrigido.",
    "numeroSolicitacaoCompra": 8875,
    "numeroPedidoCompra": 952,
    "dataPrevistaEntrega": "2025-07-10T17:30:45",
    "comprador": "Nome do Comprador"
}

Observações

Deverá ser informado o mesmo id referente ao registro de solicitação que foi capturado no método GET.
Caso seja informado o atributo statusERP = null ou em branco, será atribuído "NP" como valor default.
Quando o atributo statusERP informado for igual a "ER" indicando um erro, além da atualização dos demais campos informados, o campo OSP_ENVIADO será atualizado para "0" para que o registro não apareça mais no GET, o usuário efetue a devida correção e disponibilize esse registro novamente para o ERP.
Os atributos mensagemIntegracao, numeroSolicitacaoCompra, numeroPedidoCompra, dataPrevistaEntrega e comprador são de envio opcional.

POST (Atendimento da Solicitação de Material/ServiçoPUT (Atualiza STATUS_INT_ERP para 1 indicando que a integração foi realizada)

http:127.0.0.1:8080/query/v1/baixaConsumiveisMativsolicitacaoMaterialServicoIndustrialMativ

Estrutura de dados para envio:

Bloco de código

language	java
title	Body
collapse	true

{
    "id": "100000002033",
    "statusERP": "AT",
    "codigoMaterial": "221",
    "codigoMaterialERP": null,
    "descricaoMaterial": null,
    "unidadeMedida": "MNF00460000005142024" null,
    "dataAtendimento": "2025-07-07T17:30:45",
    "quantidadeAtendida": 1,
    "valorUnitario": 300,
    "numeroDocumentoERP": 1234567890,
    "sequenciaDocumentoERP": 1 
}

Observações

Deverá ser enviado informado o mesmo id referente ao registro que foi baixado para que o sistema atualize o status. Com isso, o registro não estará mais disponível em novas consultas GETde solicitação que foi capturado no método GET.
O atributo statusERP deverá ser informado.
O material será localizado seguindo a seguinte regra:
- Um dos atributos codigoMaterial e codigoMaterialERP deverá ser informado.
- Caso o atributo codigoMaterial esteja informado e o atributo codigoMaterialERP esteja nulo, o material será localizado pelo atributo codigoMaterial.
- Caso os atributos codigoMaterial e codigoMaterialERP estejam informados, o material será localizado pelo atributo codigoMaterial.
- Caso o atributo codigoMaterial esteja nulo e o atributo codigoMaterialERP esteja informado, o material será localizado pelo atributo codigoMaterialERP.
O atributo descricaoMaterial é opcional. Caso informado, será acatado e gravado na tabela de atendimento com a descrição enviada e caso nulo manterá a descrição do PIMS.
O atributo unidadeMedida é opcional. Caso informado, será acatado e gravado na tabela de atendimento com a unidade de medida enviada e caso nulo manterá a unidade de medida do PIMS.
O atributo dataAtendimento deverá ser informado.
O atributo quantidadeAtendida deverá ser informado.
O atributo valorUnitario deverá ser informado.
Os atributos numeroDocumentoERP e sequenciaDocumentoERP são de envio opcional.
Após a inserção do registro de atendimento, o status de integração da solicitação correspondente será atualizado para o mesmo valor do atributo statusERP informado no atendimento.

Páginas filhas

Versões comparadas

Versão antiga 1

Nova versão 2

Chave

Parâmetros