Histórico da Página

...

Atributos da chave primária simples

codigoDeposito.

Premissa para que a API esteja disponível e funcional

Possuir ativado controle de digitação de depósito de insumo no apontamento de insumos. Esta informação é identificada pelo parâmetro da seção ATRC_INS e entrada FG_DIG_DEP_INS estando com valor 1, que é responsável por disponibilizar a opção de menu contendo o cadastro no módulo Totvs Agro Bioenergia Configuração Central(CFGCEN.EXE). Caso contrário a API retornará a seguinte mensagem: 

"message": "Opção não disponível para parametrização atual".

GET

http:127.0.0.1:8080/entity/v1/depositoInsumos?page=1&pagesize=20

{
    "hasNext": false,
    "items": [
        {
            "codigoDeposito": 1,
            "descricaoDeposito": "Novo depósito fazenda São Geraldo",
            "codigoDepositoERP": "CODERP789012345",
            "codigoOrganizacaoERP": "ORGERP78912345",
            "codigoEmpresaERP": "EMPERP789012345",
            "codigoLocalizacaoERP": null,
            "rowversion": 1
        },
        {
            "codigoDeposito": 2,
            "descricaoDeposito": "Novo depósito fazenda São Lucas",
            "codigoDepositoERP": "123456789",
            "codigoOrganizacaoERP": "ORG_ERP",
            "codigoEmpresaERP": "EMP_ERP",
            "codigoLocalizacaoERP": null,
            "instanciarowversion": 1
   "INST01"     },
        {
            "codigoDeposito": 3,
            "codigoEmpresadescricaoDeposito": "EMP01Novo depósito fazenda São  II",
            "dataRefercodigoDepositoERP": "2024-09-01CODERP78901II",
            "codigoFunciocodigoOrganizacaoERP": 12345"ORGERP789II",
            "codigoEquiptocodigoEmpresaERP": "EQUIP123456EMPERP7890OO",
            "codigoCcustocodigoLocalizacaoERP": 1234567890null,
            "quantidadeHorasrowversion": 1
        }
    ]
}

Parâmetros

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

...

- Todos os atributos podem ser usados como parâmetro para a busca. - Caso seja informado o codigoExterno, será usado como parâmetro, para a busca, a instancia referente a ele no Bioenergia. Essa informação sobrepõe a instancia caso ela seja informada. Ponto de atenção é o atributo codigoLocalizacaoERP que  se estiver com valor vazio(null) então a pesquisa não retornará resultado.

POST

http:127.0.0.1:8080/entity/v1/horasManutencaoMecanica→ depositoInsumos→ cadastra um objeto

http:127.0.0.1:8080/entity/v1/horasManutencaoMecanicadepositoInsumos/batch  → cadastra uma lista do objeto.

...

{
    
  "codigoExternodescricaoDeposito": "INSTEX01",
  "codigoEmpresa": "EMP01Novo depósito fazenda São Geraldo",
    "dataRefercodigoDepositoERP": "2024-09-01CODERP789012345",
  "codigoFuncio": 12345,
  "codigoEquiptocodigoOrganizacaoERP": "EQUIP123456ORGERP78912345",
    "codigoCcustocodigoEmpresaERP": 1234567890,
  "quantidadeHorasEMPERP789012345": 1


} ou uma lista 
[{
    
  "codigoExternodescricaoDeposito": "INSTEX01",
  "codigoEmpresa": "EMP01",
  "dataReferNovo depósito fazenda São Geraldo",
    "codigoDepositoERP": "2024-09-01CODERP789012345",
  "codigoFuncio": 12345,
  "codigoEquiptocodigoOrganizacaoERP": "EQUIP123456ORGERP78912345",
    "codigoCcustocodigoEmpresaERP": 1234567890,
  "quantidadeHorasEMPERP789012345": 1


}, {
    
  "codigoExternodescricaoDeposito": "INSTEX01",
  "codigoEmpresa": "EMP002Novo depósito fazenda São Lucas",
    "dataRefercodigoDepositoERP": "2024-09-01123456789",
  "codigoFuncio": 12345,
  "codigoEquiptocodigoOrganizacaoERP": "EQUIP123456ORG_ERP",
    "codigoCcustocodigoEmpresaERP": 1234567890,
  "quantidadeHoras": 1.5

EMP_ERP"
}]

Estrutura de dados retorno:

{
    "codigoExternocodigoDeposito": "INSTEX013",
    "codigoEmpresadescricaoDeposito": "EMP01",
Novo depósito fazenda São "dataRefer": II"2024-09-01",
    "codigoFunciocodigoDepositoERP": 12345"CODERP78901II",
    "codigoEquiptocodigoOrganizacaoERP": "EQUIP123456ORGERP789II",
    "codigoCcustocodigoEmpresaERP": 1234567890,
    "quantidadeHorasEMPERP7890OO": 1,
    "instanciarowversion": "INST01"1
} ou uma lista  
 {
    "status": "COMPLETED",
    "totalRecords": 2,
    "processedRecords": 12,
    "failRecords": 10,
    "result": [
        {
            "recordId": {
                "codigoEmpresacodigoDeposito": "EMP011",
                "codigoFuncio": 12346,
                "codigoEquipto": "EQUIP123456",
                "codigoCcusto": 1234567890,
                "dataRefer": "2024-09-01"
            },
            "status": "SUCCESS",
            "message": null
        },
        {
            "recordId": {
                "codigoEmpresacodigoDeposito": "EMP002",
                "codigoFuncio": 12345,
                "codigoEquipto": "EQUIP123456",
                "codigoCcusto": 1234567890,
                "dataRefer": "2024-09-01"2"
            },
            "status": "ERRORSUCCESS",
            "message": "Tamanho inválido para o atributo codigoEmpresa. Máximo: 5"null
        }
    ]
}

Observações

- Caso seja informado o codigoExterno, será cadastrado a instancia referente a ele no Bioenergia. Essa informação sobrepõe a instancia caso ela seja informada.

- O codigoCcusto e o codigoEquipto não podem estar zerados ou nulos simultaneamente. Ex: caso o codigoCcusto seja zero o codigoEquipto deve existir.

O atributo codigoDeposito terá seu valor ignorado caso seja enviado pois: 

- A geração do código do depósito é controlada pelo parâmetro da seção INT_ERP e entrada FG_GERCOD_DEPOSITO que possui dois, e somente dois, valores válidos: 1-Mesmo código ERP/2-Sequencial(último do banco+1).

    Para uso do valor 1(Mesmo código ERP) há duas restrições: o código do ERP deve possuir no máximo 8 caracteres e ser composto somente por dígitos numéricos pois o código do depósito Bioenergia é do tipo numérico e tamanho máximo de 8. As mensagens de validação a seguir poderão aparecer caso sejam necessárias:

      a) "Inserção não permitida pois o código de depósito ERP excedeu o tamanho de 8 caracteres impossibilitando seu uso como código do depósito, tamanho atual XXX", onde no lugar de XXX será demonstrada a quantidade de caracteres que o código de depósito ERP enviado possui.

      b) "Inserção não permitida pois o código de depósito ERP necessita possuir somente dígitos numéricos em sua composição, impossibilitando seu uso como código do depósito".

      Desta forma indicamos avaliar se o valor 1 de controle da geração de código é adequada no momento da implantação e do uso da API. 

     Para uso do valor 2(Sequencial(último do banco+1)) não há restrições pois a API gerenciará a busca do código adequado liberando assim o atributo código de depósito no ERP para ter sua capacidade total de 15 caracteres.

    Caso o parâmetro da seção INT_ERP e entrada FG_GERCOD_DEPOSITO não exista na base de dados do Bioenergia ou estiver com valor numérico menor que 1 ou maior que 2, será adotado pela API o valor padrão 1-Mesmo código ERP para a geração do código de depósito no Bioenergia.

- O atributo codigoLocalizacaoERP não é obrigatório enviar- É verificado se o codigoEmpresa referencia uma empresa consolidada.

- O retorno do cadastro em lista é uma lista com a pk do objeto, status e mensagem. Em caso de erro é registrado no status e na mensagem o ocorrido.

- Caso seja enviado valor maior que o tamanho máximo dos atributos, estes terão seus conteúdos recortados não impedindo a conclusão da ação.

PUT

http:127.0.0.1:8080/entity/v1/horasManutencaoMecanica→ depositoInsumos→ atualiza um objeto

http:127.0.0.1:8080/entity/v1/horasManutencaoMecanicadepositoInsumos/batch  → atualiza uma lista de objeto.

Observações

- Caso seja informado o codigoExterno, será cadastrado a instancia referente a ele no Bioenergia. Essa informação sobrepõe a instancia caso ela seja informadaÉ obrigatório informar o atributo codigoDepositoERP filtrando único valor.

- O atributo codigoDeposito terá seu valor ignorado caso seja enviado pois será recuperado automaticamente de acordo com o atributo obrigatório codigoDepositoERP.

- O retorno do update em lista é uma lista com a pk do objeto, status e mensagem. Em caso de erro é registrado no status e na mensagem o ocorrido.

- Caso seja enviado valor maior que o tamanho máximo dos atributos, estes terão seus conteúdos recortados não impedindo a conclusão da ação.

DELETE

http:127.0.0.1:8080/entity/v1/horasManutencaoMecanicadepositoInsumos

Observações

- É obrigatório informar os atributos que formam a chave primária.o atributo codigoDepositoERP filtrando único valor ou o atributo codigoDeposito filtrando único valor. 

- O atributo codigoDeposito tem precedência para efetuar a deleção caso os dois atributos obrigatórios sejam informados simultâneamente.

- Demais campos que forem informados serão desprezados- Caso seja informado o codigoExterno, será usado como parâmetro, para a deleção, a instancia referente a ele no Bioenergia. Essa informação sobrepõe a instancia caso ela seja informada.