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 | 12 | NUMBER | S | S | - | - | Gerado automaticamente quando o registro é inserido na tabela | |||||||
instancia | Código da instância | 5 | STRING | N | N | - | - | - | |||||||
ordemServico | Número da ordem de serviço | 7 | INTEGERNUMBER | N | N | - | - | - | |||||||
sequencia | Sequência | 1 | INTEGERNUMBER | N | N | "1"- | - | tipoPecaServico | Tipo da Peça/Serviço | 1 | STRING | N | N | null | -Não envia |
codigoMaterial | Código do material no PIMS | 13 | STRING | N | N | - | - | - | |||||||
codigoMaterialERP | Código do material no ERP | 25 | STRING | N | N | - | - | - | |||||||
descricaoMaterial | Descrição do material | 65 | STRING | N | SN | - | - | - | |||||||
descricaoDetalhadaMaterial | Descrição detalhada do material | 500 | STRING | N | N | - | - | - | |||||||
unidadeMedida | Código da unidade de medida no PIMS | 8 | STRING | N | N | - | - | - | |||||||
unidadeMedidaERP | Código da unidade de medida no ERP | 8 | STRING | N | N | - | - | - | |||||||
quantidadeSolicitada | Quantidade solicitada | 12,4 | NUMBER | N | SN | - | - | - | |||||||
valorUnitarioPrevisto | Valor unitário previsto | 13,2 | NUMBER | N | N | - | - | - | |||||||
dataNecessidade | Data da necessidade da solicitação | 10 | DATE | N | N | - | - | - | |||||||
comentario | Comentário | 2000 | STRING | N | N | - | - | - | |||||||
codigoCentroCusto | Código do centro de custo no PIMS | 20 | INTEGERNUMBER | N | N | - | - | - | |||||||
codigoCentroCustoERP | Código do centro de custo no ERP | 20 | INTEGERNUMBER | N | N | - | - | - | |||||||
codigoDepositoERP | Código do depósito do material no ERP | 15 | STRING | N | N | - | - | 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: Seção: 'INT_ERP' / Entrada: 'DEPOSITO_MATERIAIS Resgatado a partir do parâmetro do BioEnergia Seção: 'INT_ERP' / Entrada: 'DEPOSITO_LUBRIF_INDUSTRIAIS' | |||||||
codigoContaERPcodigoContaContabilERP | Código da conta contábil padrãono ERP | 25 | STRING | N | 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: 'INT_ERP' / Entrada: 'CD_CTA_CTB_MI_MATSERV_APIHUB' | ||||||
tipoMovimento | Tipo do movimento | 1 | 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 Materiaismateriais S = Solicitação de Compra compra de Materiaismateriais X = Solicitação de Compra compra de Serviçosserviços O = Solicitação de Orçamentoorç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 BioEnergiaBioenergia Seção: 'INT_ERP' / Entrada: 'CD_REQUISITANTE_MNFMI' | |||||||
codigoEmpresa | Código da empresa | 2 | INTEGERNUMBER | N | N | - | - | - | |||||||
codigoEmpresaERP | Código da empresa no ERP | 250 | STRING | N | N | - | - | Resgatado a partir do parâmetro do BioEnergiaBioenergia 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 BioEnergiaBioenergia 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 | - | |||||||
origeminspecaoInterna | OrigemInspeção interna | 71 | STRING | N | N | "PIMS-MI"- | 1 = Sim / 0 = Não | - | |||||||
inspecaoExterna | Inspeção externa | 1 | STRING | codigoSistemaVeicular | Código do sistema veicular | 5 | INTEGER | N | Nnull | - | 1 = Sim / 0 = Não envia | codigoSubsistemaVeicular | Código do sub-sistema veicular | 5 | - |
detalhamentoInspecao | Detalhamento da inspeção | 2000 | STRINGINTEGER | N | N | null- | - | Não envia- | codigoComponente | Código do componente | 10 | ||||
equipeManutencaoSolicitante | Equipe de manutenção solicitante | 40 | STRINGINTEGER | N | N | null- | - | Não envia- | |||||||
inspecaoInternacomprador | inspecaoExternaCompradordetalhamentoInspecao | 20 | equipeManutencaoSolicitanteSTRING | compradorN | codigoInvestimentoN | idSolicitacaoMatServInd- | imprimeBoleto- | codigoDepartamentoCusto- | codigoDivisaoCusto | codigoOrdemInvestimentoCusto | codigoEmpresaCusto | classificacaoSolicitacao |
GET (Consulta Solicitações de Materiais/Serviços Industriais)
http:127.0.0.1:8080/query/v1/solicitacaoMaterialServicoIndustrialMativ?page=1&pagesize=2
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 | ||||
|---|---|---|---|---|
| ||||
{
| ||||
| Bloco de código | ||||
| ||||
{ "hasNext": false, "items": [ { "id": "100000002033", "instancia": "1", "ordemServico": 260199, "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": "0", "detalhamentoInspecao": null2", "equipeManutencaoSolicitanteimprimeBoleto": "DESTILARIA0", "compradorcodigoDepartamentoCusto": null, "codigoInvestimentocodigoDivisaoCusto": "2"null, "idSolicitacaoMatServIndcodigoOrdemInvestimentoCusto": 100000002033null, "imprimeBoletocodigoEmpresaCusto": "0"null, "codigoDepartamentoCustoclassificacaoSolicitacao": null, }, "codigoDivisaoCusto": null, { "codigoOrdemInvestimentoCustoid": null"100000002034", "codigoEmpresaCustoinstancia": null"1", "classificacaoSolicitacaoordemServico": null260229, }, {"sequencia": 1, "idcodigoMaterial": "1000000020343271", "instanciacodigoMaterialERP": "1"null, "ordemServicodescricaoMaterial": 260229 "DESCRIÇÃO DO MATERIAL SOLICITADO", "sequenciadescricaoDetalhadaMaterial": 1null, "tipoPecaServicounidadeMedida": null"PC", "codigoMaterialunidadeMedidaERP": "3271PC", "codigoMaterialERPquantidadeSolicitada": null1, "descricaoMaterialvalorUnitarioPrevisto": "DESCRIÇÃO DO MATERIAL SOLICITADO" null, "descricaoDetalhadaMaterialdataNecessidade": null"2025-07-05T03:00:00.000+00:00", "unidadeMedidacomentario": "PC"null, "unidadeMedidaERPcodigoCentroCusto": "PC10", "quantidadeSolicitadacodigoCentroCustoERP": 1"10", "valorUnitarioPrevistocodigoDepositoERP": null, "dataNecessidadecodigoContaContabilERP": "2025-07-05T03:00:00.000+00:00"null, "comentariotipoMovimento": null"S", "codigoCentroCustotipoDocumento": "10R", "codigoCentroCustoERPsolicitante": "10"null, "codigoDepositoERPcodigoEmpresa": null1, "codigoContaERPcodigoEmpresaERP": null, "tipoMovimentocodigoFilialERP": "S"null, "tipoDocumentodataSolicitacao": "R2025-07-07T16:27:26.000+00:00", "solicitantemanutencaoInvestimento": null"M", "codigoEmpresa": 1inspecaoInterna": "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, "inspecaoInterna": "0"codigoOrdemInvestimentoCusto": null, "inspecaoExternacodigoEmpresaCusto": "0"null, "detalhamentoInspecaoclassificacaoSolicitacao": null, } "equipeManutencaoSolicitante": "OFICINA MECANICA", "comprador": null, "codigoInvestimento": "2", "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.
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.
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:
]
} |
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 | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"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
- 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 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 | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"id": "100000002033 | ||||||
| Bloco de código | ||||||
| ||||||
{ "id": "100000002033", "statusERP": "ER", "mensagemIntegracao": "Mensagem de erro indicando o que precisa ser corrigido.", "numeroSolicitacaoCompra": 8875, "numeroPedidoCompra": 952, "dataPrevistaEntrega": "2025-07-10T17:30:45", "compradorstatusERP": "AT"Nome, do Comprador" } |
Observações
- 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.
POST (Atendimento 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 | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"id": "100000002033",
"statusERP": "AT",
"codigoMaterial": "221",
"codigoMaterialERP": null,
"descricaoMaterial": null,
"unidadeMedida": null,
"dataAtendimento": "2025-07-07T17:30:45",
"quantidadeAtendida": 1,
"valorUnitario": 300,
"numeroDocumentoERP": 1234567890,
"sequenciaDocumentoERP": 1
} |
Observações
"codigoMaterial": "221",
"codigoMaterialERP": null,
"descricaoMaterial": null,
"unidadeMedida": null,
"dataAtendimento": "2025-07-07T17:30:45",
"quantidadeAtendida": 1,
"valorUnitario": 300,
"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:
- 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 atendimentoDeverá ser enviado o mesmo id referente ao registro de solicitação que foi capturado no método GET.