Histórico da Página

Disponibilizado endpoint para integração das solicitações de materiais e serviços industriais através do método GET, atualização do status de integração através do método PUT e atendimento da solicitação através do método POSTdo cadastro de Centro de Custo com os métodos GET, POST, PUT, PATCH e DELETE.

Estrutura:

GET (Consulta Solicitações de Materiais/Serviços IndustriaisCentro de Custo Industrial)

http:127.0.0.1:8080/api/queryentity/v1/solicitacaoMaterialServicoIndustrialMativcentroCustosIndustriais?page=1&pagesize=2

{
    "hasNext": falsetrue,
    "items": [
        {
            "id": "100000002033"203,
            "instanciacodigoEmpresa": "1",
            "ordemServicocodigo": 260199,
            "sequencia": 1,
            "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",
            "codigoCentroCustoERPdescricao": "30ALIMENTAÇÃO",
            "codigoDepositoERPdescricaoResumida": null,
            "codigoContaERP": null"ALIMENTAÇÃ",
            "tipoMovimento": "S",
            "tipoDocumento": "R",
            "solicitante": referencia": null,
            "codigoEmpresaativo": 1,
            "codigoEmpresaERP": null,
            "codigoFilialERP": null,
            "dataSolicitacao": "2025-07-07T16:27:26.000+00:00",
            "manutencaoInvestimento": "M",
            "inspecaoInterna": "0",
            "inspecaoExterna": "0",
            "detalhamentoInspecao": null,
            "equipeManutencaoSolicitante": "DESTILARIA",
            "comprador": null,
            "codigoContaInvestimento": "2",
            "imprimeBoleto": "0",
            "codigoDepartamentoCusto": null,
            "codigoDivisaoCusto": null,
            "codigoOrdemInvestimentoCusto": null,
            "codigoEmpresaCusto": null,
            "classificacaoSolicitacao": null
        },
        {
            "id": "100000002034"208,
            "instanciacodigoEmpresa": "1",
            "ordemServicocodigo": 260229,
            "sequencia": 1"10",
            "codigoMaterialdescricao": "3271",
ANÁLISE CANA           "codigoMaterialERP": nullDE AÇÚCAR",
            "descricaoMaterialdescricaoResumida": "DESCRIÇÃO DO MATERIAL SOLICITADOANÁLISE CA",
            "descricaoDetalhadaMaterialreferencia": null,
            "unidadeMedidaativo": "PC1",
            "unidadeMedidaERP": "PC",}
            "quantidadeSolicitada": 1,
            "valorUnitarioPrevisto": null,
            "dataNecessidade": "2025-07-05T03:00:00.000+00:00",
            "comentario": null,
            "codigoCentroCusto": "10",
            "codigoCentroCustoERP": "10",
            "codigoDepositoERP": null,
            "codigoContaERP": 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": "0",
            "inspecaoExterna": "0",
            "detalhamentoInspecao"]
}

Parâmetros

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

Observações

• Todos os atributos podem ser usados como parâmetro para a busca.

PUT/PATCH (Modifica Centro de Custo Industrial)

http:127.0.0.1:8080/api/entity/v1/centroCustosIndustriais

Estrutura de dados para envio:

{
	"id": 348,
    "codigoEmpresa": null, 
    "codigoEmpresaERP": 1,
    "codigo": "API123",
    "descricao": "TESTE TA-API-HUB",
    "descricaoResumida": "TESTE TA-A",
    "referencia": null,
            "equipeManutencaoSolicitante"ativo": "OFICINA MECANICA1",
            "comprador": null,
            "codigoContaInvestimento": "2",
            "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" (Erro) ou nulo.

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

...

Estrutura de dados para envioretorno:

{
    "id": "100000002033"348,
    "statusERPdescricao": "ERTESTE TA-API-HUB",
    "mensagemIntegracaodescricaoResumida": "Mensagem de erro indicando o que precisa ser corrigido.TESTE TA-A",
    "numeroSolicitacaoComprareferencia": 8875null,
    "numeroPedidoCompraativo": 952,
    "dataPrevistaEntrega": "2025-07-10T17:30:45",
    "comprador": "Nome do Comprador"
1"
}

Observações

...

• Quando PATCH poderão ser enviados apenas os atributos que necessitam de atualização e os atributos que compõe a chave primária (id ou codigoEmpresa+codigo).
• No caso de PUT deverão ser enviados os atributos que necessitam de atualização, bem como os atributos obrigatórios e os atributos que compõe a chave primária (id ou codigoEmpresa+codigo).
• Caso o atributo codigoEmpresa seja informado, o codigoEmpresaERP será sempre desconsiderado.
• Caso o atributo codigoEmpresaERP seja informado, ele será utilizado para localizar e atribuir o código da empresa no atributo codigoEmpresa.
• O centro de custo será localizado seguindo a seguinte regra:
  • Caso o atributo id esteja informado, o centro de custo será localizado pelo atributo id e os atributos codigoEmpresa/codigoEmpresaERP e codigo serão ignorados mesmo sendo informados.
  • Caso o atributo id não esteja informado, o centro de custo será localizado pelos atributos codigoEmpresa/codigoEmpresaERP e codigo.
• Os atributos codigoEmpresa e codigo não serão alterados mesmo sendo informados.
• Caso o atributo descricao esteja informado e o atributo descricaoResumida não esteja informado, será atribuído o valor do atributo descricao ao atributo descricaoResumida limitado a 10 caracteres.

POST (Insere Centro de Custo Industrial

...

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

http:127.0.0.1:8080/queryapi/entity/v1/solicitacaoMaterialServicoIndustrialMativcentroCustosIndustriais

Estrutura de dados para envio:

{
    "idcodigo": "100000002033api123",
    "statusERPdescricao": "ATTeste ta-API-Hub",
    "codigoMaterialcodigoEmpresaERP": 1
}

Estrutura de dados retorno:

{"221",
    "codigoMaterialERP": null,
    "descricaoMaterialcodigo": null,
    "unidadeMedidaAPI123": null,
    "dataAtendimentodescricao": "2025TESTE TA-07-07T17:30:45API-HUB",
    "quantidadeAtendidaativo": "1",
    "valorUnitariocodigoEmpresa": 300"1",
    "numeroDocumentoERPid": 1234567890"348",
    "sequenciaDocumentoERPdescricaoResumida": 1 "TESTE TA-A"
}

Observações

• Caso os atributos codigoEmpresa e codigoEmpresaERP não forem informados, será utilizado como default o valor definido no parâmetro default-company-ind.
• Caso o atributo codigoEmpresa seja informado, o codigoEmpresaERP será sempre desconsiderado
• 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 codigoEmpresaERP seja informado, o material será localizado pelo atributo codigoMaterial e o atributo codigoMaterialERP será ignorado mesmo sendo informadoele será utilizado para localizar e atribuir o código da empresa no atributo codigoEmpresa.
• Os atributos codigo e descricao deverão ser informados.
• O conteúdo do atributo id será sempre desconsiderado caso informado e gerado um novo.
• Caso o atributo  codigoMaterialERP  descricaoResumida não esteja informado, o material será localizado pelo atributo codigoMaterialERP somente se o atributo codigoMaterial não estiver informado.será atribuído o valor do atributo descricao ao atributo descricaoResumida limitado a 10 caracteres.
• Caso já exista um centro de custo para a chave codigoEmpresa/codigoEmpresaERP+codigo informada não será permitida a inclusão e um aviso será mostrado.

DELETE (Exclui Centro de Custo Industrial)

Disponibilizado endpoint para excluir o Centro de Custo.

Método DELETE:

http:127.0.0.1:8080/api/entity/v1/centroCustosIndustriais

Parâmetros

• Caso o atributo codigoEmpresa seja informado, o codigoEmpresaERP será sempre desconsiderado.
• Caso o atributo codigoEmpresaERP seja informado, ele será utilizado para localizar e atribuir o código da empresa no atributo codigoEmpresa.
• Deverão ser informados os atributos que compõe a chave primária (id ou codigoEmpresa/codigoEmpresaERP+codigo).
• O centro de custo será localizado seguindo a seguinte regra:
  • Caso o atributo id esteja informado, o centro de custo será localizado pelo atributo id e os atributos codigoEmpresa/codigoEmpresaERP e codigo serão ignorados mesmo sendo informados.
  • Caso o atributo id não esteja informado, o centro de custo será localizado pelos atributos codigoEmpresa/codigoEmpresaERP e codigo
• 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
  • .