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:

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

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

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

{
      
	"hasNext": true,
    "items": [
            {
            "id": "MNF0003800000531202400043113100000000111",
            "origeminstancia": "CS_MNFABAS11",
            "instanciaordemServico": "11"431131,
            "boletimsequencia": 3381171,
            "sequenciatipoPecaServico": 1,
            "ordemServicocodigoMaterial": null214697,
            "dataApontamentocodigoMaterialERP": "2024-05-15T03:00:00.000+00:00214697",
            "dataEnviodescricaoMaterial": "2025-06-18T03:00:00.000+00:00MANCAL CONJUNTO DISCO",
            "codigoMaterialdescricaoDetalhadaMaterial": 214687"MANCAL CONJUNTO DISCO ERP",
            "codigoMaterialERPunidadeMedida": "214687UN",
            "quantidadeunidadeMedidaERP": 130.6"UN",
            "unidadeMedidaERPquantidadeSolicitada": "L"1,
            "centroCustovalorUnitarioPrevisto": 114035150761.335,
            "centroCustoERPdataNecessidade": "4.03.5.1502025-07-10T03:00:00.000+00:00",
            "codigoDepositoERPcomentario": "EAM-FPOSTO100039",
            "usuariocodigoCentroCusto": "PIMSCS"114037100,
            "codigoEmpresaERPcodigoCentroCustoERP": "1234.03.7.100",
            "codigoFilialERPcodigoDepositoERP": "456"
        },
        {EAM-FGERAL",
            "idcodigoContaContabilERP": "MNF00038000005362024001.001.001",
            "origemtipoMovimento": "CS_MNFABASS",
            "instanciatipoDocumento": "11R",
            "boletimsolicitante": 338117"HEVERSONCP",
            "sequenciacodigoEmpresa": 6"11",
            "ordemServicocodigoEmpresaERP": null"123",
            "dataApontamentocodigoFilialERP": "2024-05-15T03:00:00.000+00:00456",
            "dataEnviodataSolicitacao": "2025-0607-18T0308T15:0024:0044.000+00:00",
            "codigoMaterialmanutencaoInvestimento": 422286"M",
            "codigoMaterialERPcodigoSistemaVeicular": "422286"100,
            "quantidadecodigoSubsistemaVeicular": 40.3104,
            "unidadeMedidaERPcodigoComponente": "L",8
        }
    "centroCusto": 114035150,
            "centroCustoERP": "4.03.5.150",
            "codigoDepositoERP": "EAM-FPOSTO",
            "usuario": "PIMSCS",
            "codigoEmpresaERP": "123",
            "codigoFilialERP": "456"
        }
    ]
}

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.

]
}

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 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/solicitacaoMaterialServicoMativ

Estrutura de dados para envio:

{
    "id": "00043113100000000111",
    "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 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, 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çoPUT (Atualiza STATUS_INT_ERP para 1 indicando que a integração foi realizada)

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

Estrutura de dados para envio:

{
    "id": "MNF00460000005142024""00043113100000000111",
    "statusERP": "AT",
    "codigoMaterial": 214697,
    "codigoMaterialERP": null,
    "descricaoMaterial": null,
    "dataAtendimento": "2025-07-09T17:30:45",
    "quantidadeAtendida": 1.0000,
    "valorUnitario": 750.0000,
    "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:
  • 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 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.