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 | NUMBER | N | N | - | - | - | ||||
sequencia | Sequência | 1 | NUMBER | 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 | NUMBER | N | N | - | - | - | ||||
codigoCentroCustoERP | Código do centro de custo no ERP | 20 | NUMBER | N | N | - | - | - | ||||
codigoDepositoERP | Código do depósito do material no ERP | 15 | STRING | N | N | - | - | 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 BioEnergiaBioenergia: Seção: 'INT_ERP' / Entrada: 'DEPOSITO_LUBRIFMATERIAIS_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 | 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 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 BioEnergiaBioenergia Seção: 'INT_ERP' / Entrada: 'CD_REQUISITANTE_MNFMI' | ||||
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 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 | NUMBER | N | Nnull | - | Não envia | |
codigoSubsistemaVeicular | Código do sub-sistema veicular | 5 | NUMBER | N | N | null | - | Não envia | ||||
1 = Sim / 0 = Não | - | |||||||||||
detalhamentoInspecao | Detalhamento da inspeção | 2000 | STRING | N | N | - | - | - | ||||
equipeManutencaoSolicitante | Equipe de manutenção solicitante | 40 | STRING | codigoComponente | Código do componente | 10 | NUMBER | N | N | null- | - | Não envia- |
inspecaoInternacomprador | Inspeção internaComprador | 120 | STRING | N | N | - | 1 = Sim / 0 = Não- | - | inspecaoExterna | Inspeção externa | ||
codigoContaInvestimento | Código da conta de investimento | 201 | STRING | N | N | - | 1 = Sim / 0 = Não- | - | detalhamentoInspecao | Detalhamento da inspeção | 2000 | |
imprimeBoleto | Imprime boleto | 1 | NUMBERSTRING | N | N | -- | 1 = Sim / 0 = Não | - | ||||
equipeManutencaoSolicitantecodigoDepartamentoCusto | Equipe de manutenção solicitante | 40 | Código do departamento de custo | 6 | NUMBERSTRING | N | N | - | - | - | ||
codigoDivisaoCusto | Código da divisão de custo | 6 | NUMBER | comprador | Comprador | 20 | STRING | N | N | - | - | - |
codigoContaInvestimentocodigoOrdemInvestimentoCusto | Código da conta ordem de investimento de custo | 208 | STRINGNUMBER | N | N | - | - | - | ||||
codigoEmpresaCusto | Código da empresa de custo | 2 | idSolicitacaoMatServInd | Identificador do registro de solicitação no PIMS | 12 | NUMBER | N | N | - | - | - | |
classificacaoSolicitacao | Classificação da solicitação | imprimeBoleto | Imprime boleto | 1 | NUMBERSTRING | 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 | - |
GET (Consulta Solicitações de Materiais/Serviços Industriais)
http:127.0.0.1:8080/query/v1/solicitacaoMaterialServicoIndustrialMativ?page=1&pagesize=2
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 | ||||
|---|---|---|---|---|
| ||||
{
"hasNext": false,
"items": [ | ||||
| Bloco de código | ||||
| ||||
{ "hasNext": false, "items": [ { "id": "100000002033", "instancia": "1", "ordemServico": 260199, "sequencia": 1,{ "tipoPecaServico": null, "codigoMaterialid": "221100000002033", "codigoMaterialERPinstancia": null"1", "descricaoMaterialordemServico": "DESCRIÇÃO DO MATERIAL SOLICITADO"260199, "descricaoDetalhadaMaterialsequencia": null1, "unidadeMedidacodigoMaterial": "PC221", "unidadeMedidaERPcodigoMaterialERP": "PC"null, "quantidadeSolicitadadescricaoMaterial": 1 "DESCRIÇÃO DO MATERIAL SOLICITADO", "valorUnitarioPrevistodescricaoDetalhadaMaterial": null, "dataNecessidadeunidadeMedida": "2025-07-05T03:00:00.000+00:00PC", "comentariounidadeMedidaERP": null"PC", "codigoCentroCustoquantidadeSolicitada": "30"1, "codigoCentroCustoERPvalorUnitarioPrevisto": "30"null, "codigoDepositoERPdataNecessidade": null"2025-07-05T03:00:00.000+00:00", "codigoContaERPcomentario": null, "tipoMovimentocodigoCentroCusto": "S30", "tipoDocumentocodigoCentroCustoERP": "R30", "solicitantecodigoDepositoERP": null, "codigoEmpresacodigoContaContabilERP": 1null, "codigoEmpresaERPtipoMovimento": null"S", "codigoFilialERPtipoDocumento": null"R", "dataSolicitacaosolicitante": "2025-07-07T16:27:26.000+00:00"null, "manutencaoInvestimentocodigoEmpresa": "M"1, "origemcodigoEmpresaERP": "PIMS-MI"null, "codigoSistemaVeicularcodigoFilialERP": null, "codigoSubsistemaVeicular": null"dataSolicitacao": "2025-07-07T16:27:26.000+00:00", "codigoComponentemanutencaoInvestimento": null"M", "inspecaoInterna": "0", "inspecaoExterna": "0", "detalhamentoInspecao": null, "equipeManutencaoSolicitante": "DESTILARIA", "comprador": null, "codigoInvestimentocodigoContaInvestimento": "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:00", "comentario": null, "codigoCentroCusto": "10", "codigoCentroCustoERP": "10", "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", "inspecaoInterna": "origem"0", "inspecaoExterna": "PIMS-MI0", "codigoSistemaVeiculardetalhamentoInspecao": null, "codigoSubsistemaVeicularequipeManutencaoSolicitante": "OFICINA MECANICA", "comprador": null, "codigoComponentecodigoContaInvestimento": null"2", "inspecaoInternaimprimeBoleto": "0", "inspecaoExternacodigoDepartamentoCusto": "0"null, "detalhamentoInspecaocodigoDivisaoCusto": null, "equipeManutencaoSolicitantecodigoOrdemInvestimentoCusto": "OFICINA MECANICA"null, "compradorcodigoEmpresaCusto": null, "codigoInvestimentoclassificacaoSolicitacao": "2",null } "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:
| 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
- 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:
]
} |
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",
"statusERP": "AT",
"codigoMaterial": "221",
"codigoMaterialERP": null,
"descricaoMaterial": null,
"unidadeMedida": null,
"dataAtendimento": "2025-07-07T17:30:45 | ||||||
| Bloco de código | ||||||
| ||||||
{ "id": "100000002033", "statusERPquantidadeAtendida": "AT"1, "codigoMaterialvalorUnitario": "221"300, "codigoMaterialERPnumeroDocumentoERP": null1234567890, "descricaoMaterial": null, "unidadeMedida": null, "dataAtendimento": "2025-07-07T17:30:45", "quantidadeAtendida": 1, "valorUnitario": 300, "numeroDocumentoERP": 1234567890, "sequenciaDocumentoERP": 1 } |
Observações
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.