Histórico da Página

...

tipoPecaServicousuario

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

12

NUMBER

S

-

Gerado automaticamente quando o registro é inserido na tabela

instancia

Código da instância

5

STRING

N

-

ordemServico

Número da ordem de serviço

7

INTEGERNUMBER

N

-

sequencia

Sequência

1

INTEGERNUMBER

N

"1"

-

Data do apontamento

1

STRING

N

null

-

Não envia

codigoMaterial

Código do material no PIMS

13

STRING

N

-

codigoMaterialERP

Código do material no ERP

25

STRING

N

-

descricaoMaterial

Descrição do material

65

STRING

N

-

descricaoDetalhadaMaterial

Descrição detalhada do material

500

STRING

N

-

unidadeMedida

Código da unidade de medida no PIMS

8

STRING

N

-

unidadeMedidaERP

Código da unidade de medida no ERP

8

STRING

N

-

quantidadeSolicitada

Quantidade solicitada

12,4

NUMBER

N

-

valorUnitarioPrevisto

Valor unitário previsto

13,2

NUMBER

N

-

dataNecessidade

Data da necessidade da solicitação

10

DATE

N

-

comentario

Comentário

2000

STRING

N

-

codigoCentroCusto

Código do centro de custo no PIMS

20

INTEGERNUMBER

N

-

codigoCentroCustoERP

Código do centro de custo no ERP

20

INTEGERNUMBER

N

-

codigoDepositoERP

Código do depósito do material no ERP

15

STRING

N

N-

-

Usuário responsável pelo apontamento

250

STRING

N

-

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

Resgatado

Caso o campo código do almoxarifado/depósito esteja preenchido no apontamento ele será enviado e caso não esteja será enviado o valor default resgatado a partir do parâmetro do

BioEnergia

Bioenergia:

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

CD

DEPOSITO_

REQUISITANTE

MATERIAIS_

MNF

INDUSTRIAIS'

codigoEmpresaERPcodigoContaContabilERP

Código da empresa conta contábil no ERP

25025

STRING

N

-

Caso o campo código da conta contábil esteja preenchido no apontamento ele será enviado e caso não esteja será enviado o valor default resgatado a partir do parâmetro do Bioenergia:

Seção: '

Resgatado a partir do parâmetro do BioEnergia

Seção: '

INT_ERP' / Entrada: '

EMPRESA_ERP

CD_CTA_CTB_MI_MATSERV_APIHUB'

codigoFilialERP

Código da filial no ERP

tipoMovimento

Tipo do movimento

1250

STRING

N

-

S = Saída / E = Entrada

-

Resgatado a partir do parâmetro do BioEnergia

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

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

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

tipoDocumento	Tipo do documento	1	STRING	N	N	-	R = Requisição de materiais S = Solicitação de compra de materiais X = Solicitação de compra de serviços O = Solicitação de orçamento	-
solicitante	Usuário responsável pelo apontamento	250	STRING	N	N	-	-	Caso o usuário não esteja preenchido no apontamento: Resgatado a partir do parâmetro do Bioenergia Seção: 'INT_ERP' / Entrada: 'CD_REQUISITANTE_MI'
codigoEmpresa	Código da empresa	2	NUMBER	N	N	-	-	-
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 = Manutenção I = Investimento	-
inspecaoInterna	Inspeção interna	1	STRING	N	N	-	1 = Sim / 0 = Não	-
inspecaoExterna	Inspeção externa	1	STRING	N	N	-	1 = Sim / 0 = Não	-
detalhamentoInspecao	Detalhamento da inspeção	2000	STRING	N	N	-	-	-
equipeManutencaoSolicitante	Equipe de manutenção solicitante	40	STRING	N	N	-	-	-
comprador	Comprador	20	STRING	N	N	-	-	-
codigoContaInvestimento	Código da conta de investimento	20	STRING	N	N	-	-	-
imprimeBoleto	Imprime boleto	1	NUMBER	N	N	-	1 = Sim / 0 = Não	-
codigoDepartamentoCusto	Código do departamento de custo	6	NUMBER	N	N	-	-	-
codigoDivisaoCusto	Código da divisão de custo	6	NUMBER	N	N	-	-	-
codigoOrdemInvestimentoCusto	Código da ordem de investimento de custo	8	NUMBER	N	N	-	-	-
codigoEmpresaCusto	Código da empresa de custo	2	NUMBER	N	N	-	-	-
classificacaoSolicitacao	Classificação da solicitação	1	STRING	N	N	-	1 = Cotação urgente 2 = Cotação normal 3 = Com orçamento 7 = Contrato	-

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

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

Bloco de código

language	java
title	Response

{
    "hasNext": false,
    "items": [
        {

Bloco de código

language	java
title	Response

{
    "hasNext": false,
    "items": [
        {
            "id": "100000002033",
            "instanciaid": "1100000002033",
            "ordemServicoinstancia": 260199"1",
            "sequenciaordemServico": 1260199,
            "tipoPecaServicosequencia": null1,
            "codigoMaterial": "221",
            "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:00",
            "comentario": null,
            "codigoCentroCusto": "30",
            "codigoCentroCustoERP": "30",
            "codigoDepositoERP": null,
            "codigoContaERPcodigoContaContabilERP": null,
            "tipoMovimento": "S",
            "tipoDocumento": "R",
            "solicitante": null,
            "codigoEmpresa": 1,
            "codigoEmpresaERP": null,
            "codigoFilialERP": null,
            "dataSolicitacao": "2025-07-07T16:27:26.000+00:00",
            "manutencaoInvestimento": "M",
            "origeminspecaoInterna": "PIMS-MI0",
            "codigoSistemaVeicularinspecaoExterna": null"0",
            "codigoSubsistemaVeiculardetalhamentoInspecao": null,
            "codigoComponenteequipeManutencaoSolicitante": null"DESTILARIA",
            "inspecaoInternacomprador": "0"null,
            "inspecaoExternacodigoContaInvestimento": "02",
            "detalhamentoInspecaoimprimeBoleto": null"0",
            "equipeManutencaoSolicitantecodigoDepartamentoCusto": "DESTILARIA"null,
            "compradorcodigoDivisaoCusto": null,
            "codigoInvestimentocodigoOrdemInvestimentoCusto": "2"null,
            "idSolicitacaoMatServIndcodigoEmpresaCusto": 100000002033null,
            "imprimeBoletoclassificacaoSolicitacao": "0",null
        },
     "codigoDepartamentoCusto": null,   {
            "codigoDivisaoCustoid": null"100000002034",
            "codigoOrdemInvestimentoCustoinstancia": null"1",
            "codigoEmpresaCustoordemServico": null260229,
            "classificacaoSolicitacaosequencia": null1,
        },
        {"codigoMaterial": "3271",
            "idcodigoMaterialERP": "100000002034"null,
            "instanciadescricaoMaterial": "1DESCRIÇÃO DO MATERIAL SOLICITADO",
            "ordemServicodescricaoDetalhadaMaterial": 260229null,
            "sequenciaunidadeMedida": 1"PC",
            "tipoPecaServicounidadeMedidaERP": null"PC",
            "codigoMaterialquantidadeSolicitada": "3271"1,
            "codigoMaterialERPvalorUnitarioPrevisto": null,
            "descricaoMaterialdataNecessidade": "DESCRIÇÃO DO MATERIAL SOLICITADO2025-07-05T03:00:00.000+00:00",
            "descricaoDetalhadaMaterialcomentario": null,
            "unidadeMedidacodigoCentroCusto": "PC10",
            "unidadeMedidaERPcodigoCentroCustoERP": "PC10",
            "quantidadeSolicitadacodigoDepositoERP": 1null,
            "valorUnitarioPrevistocodigoContaContabilERP": null,
            "dataNecessidadetipoMovimento": "2025-07-05T03:00:00.000+00:00",
            "comentario": nullS",
            "codigoCentroCustotipoDocumento": "10R",
            "codigoCentroCustoERPsolicitante": "10"null,
            "codigoDepositoERPcodigoEmpresa": null1,
            "codigoContaERPcodigoEmpresaERP": null,
            "tipoMovimentocodigoFilialERP": "S"null,
            "tipoDocumentodataSolicitacao": "R2025-07-07T16:27:26.000+00:00",
            "solicitantemanutencaoInvestimento": null"M",
            "codigoEmpresainspecaoInterna": 1"0",
            "codigoEmpresaERPinspecaoExterna": null"0",
            "codigoFilialERPdetalhamentoInspecao": null,
            "dataSolicitacaoequipeManutencaoSolicitante": "2025-07-07T16:27:26.000+00:00OFICINA MECANICA",
            "manutencaoInvestimentocomprador": "M"null,
            "origemcodigoContaInvestimento": "PIMS-MI2",
            "codigoSistemaVeicularimprimeBoleto": null"0",
            "codigoSubsistemaVeicularcodigoDepartamentoCusto": null,
            "codigoComponentecodigoDivisaoCusto": null,
            "inspecaoInternacodigoOrdemInvestimentoCusto": "0"null,
            "inspecaoExternacodigoEmpresaCusto": "0"null,
            "detalhamentoInspecaoclassificacaoSolicitacao": null,
        }
    "equipeManutencaoSolicitante": "OFICINA MECANICA",
            "comprador": null,
        ]
}

Parâmetros

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

Observações

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" (Erro) ou nulo.

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

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

Estrutura de dados para envio:

Bloco de código

language	java
title	Body
collapse	true

{
    "codigoInvestimentoid": "2",
            "idSolicitacaoMatServInd": 100000002034,
  100000002033",
      "statusERP": "ER",
    "imprimeBoletomensagemIntegracao": "0",
Mensagem de erro indicando o que precisa ser corrigido.",
    "codigoDepartamentoCustonumeroSolicitacaoCompra": null8875,
    "numeroPedidoCompra": 952,
       "codigoDivisaoCustodataPrevistaEntrega": null"2025-07-10T17:30:45",
    "comprador": "Nome do      "codigoOrdemInvestimentoCusto": null,
            "codigoEmpresaCusto": null,
            "classificacaoSolicitacao": null
        }
    ]
}

Parâmetros

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

Observações

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.

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, será atribuído "NP" (Não Processado pelo ERP)como valor default.
Quando o atributo statusERP informado for igual a "ER" indicando um erro, além da atualização dos demais campos informados, 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 PUT (Atualiza o status da Solicitação de Material/Serviço)

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

...

Bloco de código

language	java
title	Body
collapse	true	true

{
    "id": "100000002033",
    "statusERP": "AT",{
    "idcodigoMaterial": "2028221",
    "statusERPcodigoMaterialERP": "ER"null,
    "mensagemIntegracaodescricaoMaterial": null,
  "Mensagem de erro indicando o que precisa ser corrigido."unidadeMedida": null,
    "dataAtendimento": "2025-07-07T17:30:45",
    "numeroSolicitacaoCompraquantidadeAtendida": 88751,
    "numeroPedidoCompravalorUnitario": 952300,
    "dataPrevistaEntreganumeroDocumentoERP": "2025-07-10T17:30:45"1234567890,
    "compradorsequenciaDocumentoERP": "Nome do Comprador"
}

Observações

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:
- Caso não seja informado um dos atributos codigoMaterial ou codigoMaterialERP, o material será recuperado da solicitação referente ao id enviado.
- Caso o atributo codigoMaterial esteja informado, o material será localizado pelo atributo codigoMaterial e o atributo codigoMaterialERP será ignorado mesmo sendo informado.
- Caso 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 material recuperada da solicitação.
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 recuperada da solicitação.
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
Deverá ser enviado o mesmo id referente ao registro de solicitação que foi capturado no método GET.
Caso seja enviado o statusERP = null ou em branco, será atribuído "NP" como valor default.
Quando o statusERP enviado for igual a "ER" indicando um erro, além da atualização dos demais campos enviados, o campo OSP_ENVIADO será atualizado para "0" para que quando for efetuada a correção o usuário disponibilize novamente esse registro para o ERP.
Os atributos mensagemIntegracao, numeroSolicitacaoCompra, numeroPedidoCompra, dataPrevistaEntrega e comprador são de envio opcional.

Páginas filhas

Versões comparadas

Versão antiga 6

Nova versão Atual

Chave

Parâmetros

Parâmetros