Histórico da Página

...

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	23	String	S	S	-	-	Composto pela concatenação dos atributos ordemServico + sequencia + instancia
instancia	Código da instância	5	STRING	N	N	-	-	-
ordemServico	Número da ordem de serviço	9	NUMBER	N	N	-	-	-
sequencia	Sequência	9	NUMBER	N	N	-	-	-
tipoPecaServico	Tipo da Peça/Serviço	3	NUMBER	N	N	-	-	-
codigoMaterial	Código do material no PIMS	12	NUMBER	N	N	-	-	-
codigoMaterialERP	Código do material no ERP	25	STRING	N	N	-	-	-
descricaoMaterial	Descrição do material	60	STRING	N	N	-	-	-
descricaoDetalhadaMaterial	Descrição detalhada do material	150	STRING	N	N	-	-	-
unidadeMedida	Código da unidade de medida no PIMS	3	STRING	N	N	-	-	-
unidadeMedidaERP	Código da unidade de medida no ERP	3	STRING	N	N	-	-	-
quantidadeSolicitada	Quantidade solicitada	9,2	NUMBER	N	N	-	-	-
valorUnitarioPrevisto	Valor unitário previsto	10,3	NUMBER	N	N	-	-	-
dataNecessidade	Data da necessidade da solicitação	10	DATE	N	N	-	-	-
comentario	Comentário	250	STRING	N	N	-	-	-
codigoCentroCusto	Código do centro de custo no PIMS	20	NUMBER	N	N	-	-	-
codigoCentroCustoERP	Código do centro de custo no ERP	15	STRING	N	N	-	-	-
codigoDepositoERP	Código do depósito do material no ERP	15	STRING	N	N	-	-	-
codigoContaERPcodigoContaContabilERP	Código da conta contábil padrãono ERP	20	STRING	N	N	-	--	Caso o parâmetro do Bioenergia esteja preenchido: Seção: 'INT_ERP' / Entrada: 'CD_CTA_CTB_MATSERV_APIHUB' Envia o valor do parâmetro e caso não esteja envia o valor preenchido no apontamento.
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	10	STRING	N	N	-	-	-
codigoEmpresa	Código da empresa	5	STRING	N	N	-	-	Resgatado a partir do parâmetro do Bioenergia Seção: 'GERAIS' / Entrada: 'CD_EMPRESA'
codigoEmpresaERP	Código da empresa no ERP	250	STRING	N	N	-	-	Resgatado a partir do parâmetro do Bioenergia Seção: 'INT_ERP' / Entrada: 'EMPRESA_ERP'
codigoFilialERP	Código da filial no ERP	250	STRING	N	N	-	-	Resgatado a partir do parâmetro do 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	-
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	-	-	-
statusERP	Status da solicitação vindo do ERP	1	STRING	N	N	-	-	-
numeroSolicitacaoCompra	Numero da solicitação de compra	10	NUMBER	N	N	-	-	-

GET (Consulta Solicitações de Materiais/Serviços IndustriaisAutomotivos)

http:127.0.0.1:8080/api/query/v1/solicitacaoMaterialServicoMativ?page=1&pagesize=1
http:127.0.0.1:8080/api/query/v1/solicitacaoMaterialServicoMativTodos?page=1&pagesize=21

Bloco de código

language	java
title	Response

{
      
	"hasNext": falsetrue,
    "items": [
            {
            "id": "10000000203300043113100000000111",
            "instancia": "111",
            "ordemServico": 260199431131,
            "sequencia": 1,
            "tipoPecaServico": null1,
            "codigoMaterial": "221"214697,
            "codigoMaterialERP": null"214697",
            "descricaoMaterial": "DESCRIÇÃOMANCAL DOCONJUNTO MATERIAL SOLICITADODISCO",
            "descricaoDetalhadaMaterial": null "MANCAL CONJUNTO DISCO ERP",
            "unidadeMedida": "PCUN",
            "unidadeMedidaERP": "PCUN",
            "quantidadeSolicitada": 1,
            "valorUnitarioPrevisto": null761.335,
            "dataNecessidade": "2025-07-05T0310T03:00:00.000+00:00",
            "comentario": null"100039",
            "codigoCentroCusto": "30"114037100,
            "codigoCentroCustoERP": "304.03.7.100",
            "codigoDepositoERP": null,
            "codigoContaERP": null"EAM-FGERAL",
            "tipoMovimentocodigoContaContabilERP": "S",
            "tipoDocumento": "R",
            "solicitante": null,
            "codigoEmpresa": 1,
            "codigoEmpresaERP": null,
            "codigoFilialERP": null,
            "dataSolicitacao": "2025-07-07T16:27:26.000+00:00",
            "manutencaoInvestimento": "M",
            "origem": "PIMS-MI",
            "codigoSistemaVeicular": null,
            "codigoSubsistemaVeicular": null,
            "codigoComponente": null,
            "inspecaoInterna": "0",
            "inspecaoExterna": "0",
            "detalhamentoInspecao": null,
            "equipeManutencaoSolicitante": "DESTILARIA",
            "comprador": null,
            "codigoContaInvestimento": "2",
            "idSolicitacaoMatServInd": 100000002033,
            "imprimeBoleto": "0",
            "codigoDepartamentoCusto": null,
            "codigoDivisaoCusto": null,
            "codigoOrdemInvestimentoCusto": null,
            "codigoEmpresaCusto": null,
            "classificacaoSolicitacao": null
        },
        {
            "id": "100000002034",
            "instancia": "1",
            "ordemServico": 260229,
            "sequencia": 1,
            "tipoPecaServico": null,
            "codigoMaterial": "3271",
            "codigoMaterialERP": null,
            "descricaoMaterial": "DESCRIÇÃO DO MATERIAL SOLICITADO",
            "descricaoDetalhadaMaterial": null,
            "unidadeMedida": "PC",
            "unidadeMedidaERP": "PC",
            "quantidadeSolicitada": 1,
            "valorUnitarioPrevisto": null,
            "dataNecessidade": "2025-07-05T03:00:00.000+00:00001.001.001",
            "comentariotipoMovimento": null,
            "codigoCentroCusto": "10"S",
            "codigoCentroCustoERPtipoDocumento": "10R",
            "codigoDepositoERPsolicitante": null,
            "codigoContaERPHEVERSONCP": null,
            "tipoMovimentocodigoEmpresa": "S11",
            "tipoDocumentocodigoEmpresaERP": "R123",
            "solicitantecodigoFilialERP": null,
            "codigoEmpresa456": 1,
            "codigoEmpresaERP": null,
            "codigoFilialERP": null,
            "dataSolicitacao": "2025-07-07T1608T15:2724:2644.000+00:00",
            "manutencaoInvestimento": "M",
            "origem": "PIMS-MI",
            "codigoSistemaVeicular": null100,
            "codigoSubsistemaVeicular": null104,
            "codigoComponente": null,
            "inspecaoInterna": "0",
            "inspecaoExterna": "0",
            "detalhamentoInspecao": null,
            "equipeManutencaoSolicitante": "OFICINA MECANICA",
            "comprador": null,
            "codigoContaInvestimento": "2",
       8
     "idSolicitacaoMatServInd": 100000002034,
            "imprimeBoleto": "0",
            "codigoDepartamentoCusto": null,
            "codigoDivisaoCusto": null,
            "codigoOrdemInvestimentoCusto": null,
            "codigoEmpresaCusto": null,
            "classificacaoSolicitacao": null
        }
    ]
}

Parâmetros

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

...

O usuário deverá disponibilizar a solicitação para integração com o ERP.
Serão disponibilizados registros de solicitação cujo status de integração seja igual a "ER" (Erro) ou nulo.
Para a url 'solicitacaoMaterialServicoMativTodos' poderá ser passado os atributos (statusERP, numeroSolicitacaoCompra e codigoMaterialERP) como parâmetros

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

http:127.0.0.1:8080/api/query/v1/solicitacaoMaterialServicoIndustrialMativsolicitacaoMaterialServicoMativ

Estrutura de dados para envio:

Bloco de código

language	java
title	Body
collapse	true

{
    "id": "10000000203300043113100000000111",
    "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

Esse método deverá ser chamado para cada registro capturado no método GET, sinalizando que o mesmo foi recebido pelo ERP, só então o registro deixará de ser enviado no método GET.
Deverá ser informado o mesmo id referente ao registro de solicitação que foi capturado no método GET.
Caso não seja informado o atributo statusERP= null ou em branco, será atribuído o valor "NP" (Não Processado pelo ERP) como valor default, ainda assim o registro deixará de ser enviado no método GET.
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, a solicitação será liberada para que o usuário efetue a devida correção e disponibilize esse registro novamente para o ERP, somente então o registro será enviado novamente no método GET.
Os atributos mensagemIntegracao, numeroSolicitacaoCompra, numeroPedidoCompra, dataPrevistaEntrega e comprador são de envio opcional.

...

POST (Atendimento da Solicitação de Material/Serviço)

http:127.0.0.1:8080/api/query/v1/solicitacaoMaterialServicoIndustrialMativsolicitacaoMaterialServicoMativ

Estrutura de dados para envio:

Bloco de código

language	java
title	Body
collapse	true

{
    "id": "10000000203300043113100000000111",
    "statusERP": "AT",
    "codigoMaterial": "221"214697,
    "codigoMaterialERP": null,
    "descricaoMaterial": null,
    "unidadeMedida": null,
    "dataAtendimento": "2025-07-07T1709T17:30:45",
    "quantidadeAtendida": 1.0000,
    "valorUnitario": 300750.0000,
    "numeroDocumentoERP": 1234567890,
    "sequenciaDocumentoERP": 1 
}

Observações

Deverá ser informado o mesmo id referente ao registro de solicitação que foi capturado no método GET.
O atributo statusERP deverá ser informado.
O material será localizado seguindo a seguinte regra:
- Um Caso não seja informado um dos atributos codigoMaterial e codigoMaterialERP deverá ser informadoou codigoMaterialERP, o material será recuperado da solicitação referente ao id enviado.
- 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.
- e o atributo codigoMaterialERP será ignorado mesmo sendo informado.
- Caso Caso o atributo codigoMaterial esteja nulo e o atributo codigoMaterialERP esteja informado, o material será localizado pelo atributo codigoMaterialERP somente se o atributo codigoMaterial não estiver informado.
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 PIMSmaterial informado ou recuperado.
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 3

Nova versão Atual

Chave

Parâmetros