Páginas filhas
  • API Centro de Custo (Manutenção Industrial)

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

  • 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)

...

Bloco de código
languagejava
titleBody
collapsetrue
{
    "idcodigo": "100000002033ABC123",
    "statusERPsaldo": "ER",
    "mensagemIntegracao": "Mensagem de erro indicando o que precisa ser corrigido.",
    "numeroSolicitacaoCompra": 8875,50
}

Estrutura de dados retorno:

Bloco de código
languagejava
titleResponse
collapsetrue
{
    "numeroPedidoCompracodigo": 952,
    "dataPrevistaEntrega": "2025-07-10T17:30:45"ABC123",
    "compradorsaldo": "Nome do Comprador"50
}

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 (conforme exemplo acima).
  • No caso de PUT deverão ser enviados os atributos necessários/obrigatórios e os atributos que compõe a chave primária.
  • A chave estrangeira composta da Família/Grupo será validada pelo banco de dados apenas se os dois campos forem informados.
  • A Família poderá ser informada sem o Grupo porém o Grupo não poderá ser informado sem a Família.
  • Validação da conta contábil (atributo "contaERP"):
    • Caso o parâmetro geral do PIMSMI CON_CTACONTAB for diferente de '1' e o parâmetro "CCONTABIL" da seção "GERAL" também for diferente de '1' não será acatada a conta contábil informada sendo zerado o atributo antes da gravação.
    • Caso o parâmetro "C.CONTABIL" da seção "OS_MATPREVISTO" for diferente de '1' o código da conta contábil informada será validada na tabela do bioenergia através de um sinônimo entre os owners e caso a conta for inválida será mostrada uma mensagem ao usuário e abortada a gravação
  • 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 (Insere Centro de Custo Industrial)

...

Bloco de código
languagejava
titleBody
collapsetrue
{
    "codigo": "ABC123",
    "tipo": null,
    "codigoEmpresa": null,
    "descricao": "MATERIAL TESTE API-HUB",
    "descricaoDetalhada": null,
    "codigoAlmoxarifado": null,
    "descricaoAlmoxarifado": null,
    "codigoUnidadeMedida": "UN",
    "familia": 1,
    "grupo": 10,
    "precoUltimaCompra": null,
    "situacao": null,
    "saldo": null,
    "vidaUtil": null,
    "estocavel": null,
    "idcompra": null,
    "integraERP": null,
    "100000002033precoMedioUnitario": null,
    "statusERPultimaAtualizacao": null,
    "ATultimaCompra": null,
    "codigoMateriallocalizacao": "221"null,
    "categoria": null,
    "codigoMaterialERPcodigoERP": null,
    "descricaoMaterialcontaERP": null,
    "unidadeMedidagestaoEstoque": null
}

Estrutura de dados retorno:

Bloco de código
languagejava
titleResponse
collapsetrue
{
    "codigo": "ABC123",
    "tipo": "M",
    "codigoEmpresa": "1",
    "dataAtendimentodescricao": "2025-07-07T17:30:45"MATERIAL TESTE API-HUB",
    "descricaoDetalhada": null,
    "codigoAlmoxarifado": null,
    "descricaoAlmoxarifado": null,
    "codigoUnidadeMedida": "UN",
    "familia": 1,
    "grupo": 10,
    "precoUltimaCompra": 0,
    "quantidadeAtendidasituacao": "1",
    "saldo": 0,
    "vidaUtil": 0,
    "valorUnitarioestocavel": 300null,
    "numeroDocumentoERPcompra": 1234567890null,
    "sequenciaDocumentoERPintegraERP": "1",
    "precoMedioUnitario": 0,
    "ultimaAtualizacao": null,
    "ultimaCompra": null,
    "localizacao": null,
    "categoria": null,
    "codigoERP": null,
    "contaERP": null,
    "gestaoEstoque": null
}

Observações

...

  • 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.
  • o Código da Empresa não for enviado, será utilizado o valor definido no parâmetro default-company-ind.
  • A chave estrangeira composta da Família/Grupo será validada pelo banco de dados apenas se os dois campos forem informados.
  • A Família poderá ser informada sem o Grupo porém o Grupo não poderá ser informado sem a Família.
  • Validação da conta contábil (atributo "contaERP"):
    • Caso o parâmetro geral do PIMSMI CON_CTACONTAB for diferente de '1' e o parâmetro "CCONTABIL" da seção "GERAL" também for diferente de '1' não será acatada a conta contábil informada sendo zerado o atributo antes da gravação.
    • Caso o parâmetro "C.CONTABIL" da seção "OS_MATPREVISTO" for diferente de '1' o código da conta contábil informada será validada na tabela do bioenergia através de um sinônimo entre os owners e caso a conta for inválida será mostrada uma mensagem ao usuário e abortada a gravação
    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
    • .


DELETE (Exclui Centro de Custo Industrial)

Disponibilizado endpoint para excluir o Centro de Custo.

Método DELETE:

http:127.0.0.1:8080/entity/v1/centroCustosIndustriais

...