Páginas filhas
  • API Despesas Gerais

Versões comparadas

Chave

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

...

- Os atributos relacionados a vlTarifa só funciona quando usado para buscar na despesasGeraisERP.

- O atributo codigoEstabelecimento pode ser usado no lugar do codigoEmpresa(dependendo de como o sistema é configurado)- Caso queira usar a instancia para a busca, mas não possua seu valor, é possível deixar o atributo recuperarInstancia true e enviar codigoEmpresaInst ou codigoEstabelecimentoInst (dependendo de como o sistema é configurado). 

Configuração de parâmetros

- O atributo codigoEstabelecimento pode ser usado no lugar do codigoEmpresa(dependendo de como o sistema é configurado).

- O atributo codigoEmpresa informado pode ser erp, então será resgatado o código do bioenergia (dependendo de como o sistema é configurado).

Configuração de parâmetros

-  Entrada: CSTGDG_FILT_EST, -  Entrada: CSTGDG_FILT_EST, Seção: INT_ERP.  Se o valor for 'S' instancia é recuperada usando o codigoEstabelecimento. Se o valor for 'N' instancia é recuperada usando o codigoEmpresa.

...

Bloco de código
languagejava
titleHoras Manutenção Mecânica
collapsetrue
{
    
  "codigoExternocodigoEmpresa": "INSTEX01002",
  "codigoEmpresadataRefer": "EMP012018-04-31",
  "dataRefercodigoCcusto": "2024-09-01"1235556,
  "codigoFunciocodigoCtaCon": 12345"41101003",
  "codigoEquiptoqtValor": "EQUIP123456"0,
  "codigoCcustoqtValorInicial": 1234567890145.36,
  "quantidadeHorasqtValorFinal": 1145.36


} ou uma lista 
 [{
    
  "codigoExterno": "INSTEX01",
  "codigoEmpresa": "EMP01002",
  "dataRefer": "20242014-0904-0130",
  "codigoFunciocodigoCcusto": 1234572108,
  "codigoEquiptocodigoCtaCon": "EQUIP12345641101003",
  "codigoCcustoqtValor": 12345678900,
  "quantidadeHorasqtValorInicial": 1


}, {145.36,
    "qtValorFinal": 145.36,
  "codigoExternoqtValor1": "INSTEX01"null,
  "codigoEmpresaqtValor2": "EMP002"null,
  "dataReferqtValor3": "2024-09-01"null,
  "codigoFuncioqtValor4": 12345null
},
{
  "codigoEquiptocodigoEmpresa": "EQUIP123456281",
  "codigoCcustoinstancia": 1234567890"201",
  "quantidadeHorasdataRefer": 1.5


}]

Estrutura de dados retorno:

Bloco de código
languagejava
titleHoras Manutenção Mecânica
collapsetrue
{
    "codigoExterno": "INSTEX01""2020-10-19",
  "codigoCcusto": 1235556,
    "codigoEmpresacodigoCtaCon": "EMP01ABCPD",
    "dataReferqtValor": "2024-09-01"2600,
    "codigoFuncioqtValor1": 1234512890.5678,
    "codigoEquiptoqtValor2": "EQUIP123456"123890.5678,
    "codigoCcustoqtValor3": 1234567890123450.5678,
    "quantidadeHorasqtValor4": 1123890.5678,
    "instanciavlTarifa1": 15
}]

Estrutura de dados retorno:

Bloco de código
languagejava
titleHoras Manutenção Mecânica
collapsetrue
"INST01"
} ou uma lista  
{
    "statuscodigoEmpresa": "COMPLETED201",
    "totalRecordsdataRefer": 2"2018-04-30T00:00:00",
    "processedRecordscodigoCcusto": 11235556,
    "failRecordscodigoCtaCon": 1"41101003",
    "resultqtValor": [0,
    "qtValorInicial": 145.36,
   {
 "qtValorFinal": 145.36,
      "qtValor1": 0,
    "recordIdqtValor2": {0,
    "qtValor3": 0,
       "qtValor4": 0,
    "codigoEmpresainstancia": "EMP01201",
} ou uma lista   {
       "status": "COMPLETED",
    "codigoFunciototalRecords": 123462,
    "processedRecords": 1,
       "failRecords": 1,
    "codigoEquiptoresult": "EQUIP123456",[
        {
            "codigoCcustorecordId": 1234567890,{
                "dataRefercodigoEmpresa": "2024-09-01002",
              }  "instancia": null,
                "statuscodigoCtaCon": "SUCCESS41101003",
                "messagecodigoCcusto": null72108,
        },
        {"dataRefer": "2014-04-30"
            "recordId": {},
                "codigoEmpresa"status": "EMP002ERROR",
                "codigoFunciomessage": 12345,
"Código do Centro de Custo inválido"
        },
   "codigoEquipto": "EQUIP123456",
    {
            "codigoCcustorecordId": 1234567890,{
                "dataRefercodigoEmpresa": "2024-09-01204",
            },
     "instancia": "201",
                "statuscodigoCtaCon": "ERRORABCPD",
                "messagecodigoCcusto": "Tamanho1235556,
 inválido para o atributo codigoEmpresa. Máximo: 5"
        }
    ]
}

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.

- É 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.

Configuração de parâmetros

-  Entrada: CSTGDG_FG_CCUST , Seção: INT_ERP.  Se o valor for 'D', o código é erp e será resgatado na tabela CCUSTO  o código do bioenergia. Se o valor for 'P', não há alteração no código informado.

-  Entrada: CSTGDG_FILT_EST, Seção: INT_ERP.  Se o valor for 'S' a instancia é recuperada usando o codigoEstabelecimento. Se o valor for 'N' instancia é recuperada usando o codigoEmpresa.

-  Entrada: FG_EMPR_FILIAL,  Seção: INT_ERP. Se o valor for 'F' é usado o codigoEstabelecimento como o codigoEmpresa. Se o valor for 'E' continua sendo usado o codigoEmpresa.

-  Entrada: FG_INT_EMPRESA,  Seção: CSTG_C. Se o valor for 1, o código é erp e será resgatado na tabela PMMAPPIMS_EXT o código do bioenergia. Se o valor for 2, não há alteração no código informado.

"dataRefer": "2020-10-19T00:00:00"
            },
            "status": "SUCCESS",
            "message": null
        }
    ]
}

Observações

- O atributo codigoCcusto informado pode ser erp, então será resgatado o código do bioenergia (dependendo de como o sistema é configurado).

- Caso  a instancia não seja informada, ela será recuperada através  do codigoEmpresa ou codigoEstabelecimento (dependendo de como o sistema é configurado). 

- O atributo codigoEstabelecimento pode ser usado no lugar do codigoEmpresa(dependendo de como o sistema é configurado).

- O atributo codigoEmpresa informado pode ser erp, então será resgatado o código do bioenergia (dependendo de como o sistema é configurado).

- Dependendo da configuração do sistema o atributo qtValor é calculado (qtValorFinal - qtValorInicial).

- Dependendo da configuração do sistema essas informações também são salvas na tabela CSTG_INTDG_ERP.

- Os atributos relacionados a vlTarifa só são salvos na tabela CSTG_INTDG_ERP.

- A tabela CSTG_INTDG_ERP  pode apenas  ser modificada junto com a CSTG_INTDG, porém é possível realizar o GET.


Configuração de parâmetros

-  Entrada: CSTGDG_FG_CCUST , Seção: INT_ERP.  Se o valor for 'D', o codigoCcusto  é erp e será resgatado na tabela CCUSTO  o código do bioenergia. Se o valor for 'P', não há alteração no código informado.

-  Entrada: CSTGDG_FILT_EST, Seção: INT_ERP.  Se o valor for 'S' a instancia é recuperada usando o codigoEstabelecimento. Se o valor for 'N' instancia é recuperada usando o codigoEmpresa.

-  Entrada: FG_EMPR_FILIAL-  Entrada: CSTGDG_TAM_CTA,  Seção: INT_ERP. O valor define o tamanho do codigoCtaCon, se for maior do que o esperado ele é cortadoSe o valor for 'F' é usado o codigoEstabelecimento como o codigoEmpresa. Se o valor for 'E' continua sendo usado o codigoEmpresa.

-  Entrada: CSTGDGFG_DEBINT_CRED EMPRESA,  Seção: INTCSTG_ERPC.   Se o valor for 1 continua sendo usado o codigoEmpresa, o código é erp e será resgatado na tabela PMMAPPIMS_EXT o código do bioenergia. Se o valor for 2 o atributo qtValor será calculado usando qtValorInicial e qtValorFinal (qtValorFinal - qtValorInicial  )

Image Removed

ele é chamado de debito e crédito mudo o nome?

PUT

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

http:127.0.0.1:8080/entity/v1/horasManutencaoMecanica/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.

- 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.

...

, não há alteração no código informado.

-  Entrada: CSTGDG_TAM_CTA,  Seção: INT_ERP. O valor define o tamanho do codigoCtaCon, se for maior do que o esperado ele é cortado.

-  Entrada: CSTGDG_DEB_CRED ,  Seção: INT_ERP. Se o valor for 1, continua sendo usado o qtValor. Se o valor for 2 o atributo qtValor será calculado usando qtValorInicial e qtValorFinal (qtValorFinal - qtValorInicial)

Image Added

ele é chamado de debito e crédito mudo o nome?

-  Entrada: FG_CSTG_INTDG_ERP ,  Seção: INT_ERP. Se o valor for 'S' as informações também serão salvas na tabela CSTG_INTDG_ERP. Se o valor for 'N' as informações são salvas apenas na CSTG_INTDG

PUT

http:127.0.0.1:8080/entity/v1/despesasGerais→ atualiza um objeto

http:127.0.0.1:8080/entity/v1/horasManutencaoMecanica

Observações

- É obrigatório informar os atributos que formam a chave primária.

/despesasGerais/batch  → atualiza uma lista de objeto.

Observações

- O atributo codigoCcusto informado pode ser erp, então será resgatado o código do bioenergia (dependendo de como o sistema é configurado).

- Caso  a instancia não seja informada, ela será recuperada através  do codigoEmpresa ou codigoEstabelecimento (dependendo de como o sistema é configurado). 

- O atributo codigoEstabelecimento pode ser usado no lugar do codigoEmpresa(dependendo de como o sistema é configurado).

- O atributo codigoEmpresa informado pode ser erp, então será resgatado o código do bioenergia (dependendo de como o sistema é configurado).

- Dependendo da configuração do sistema o atributo qtValor é calculado (qtValorFinal - qtValorInicial).

- Dependendo da configuração do sistema o atributo qtValor é somado com o valor existente no banco, e essa soma que será o novo qtValor .

- Dependendo da configuração do sistema essas informações também são atualizadas na tabela CSTG_INTDG_ERP.

- Os atributos relacionados a vlTarifa só são atualizadas na tabela CSTG_INTDG_ERP.

- A tabela CSTG_INTDG_ERP  pode apenas  ser modificada junto com a CSTG_INTDG, porém é possível realizar o GET.


Configuração de parâmetros

-  Entrada: CSTGDG_FG_CCUST , Seção: INT_ERP.  Se o valor for 'D', o codigoCcusto  é erp e será resgatado na tabela CCUSTO  o código do bioenergia. Se o valor for 'P', não há alteração no código informado.

-  Entrada: CSTGDG_FILT_EST, Seção: INT_ERP.  Se o valor for 'S' a instancia é recuperada usando o codigoEstabelecimento. Se o valor for 'N' instancia é recuperada usando o codigoEmpresa.

-  Entrada: FG_EMPR_FILIAL,  Seção: INT_ERP. Se o valor for 'F' é usado o codigoEstabelecimento como o codigoEmpresa. Se o valor for 'E' continua sendo usado o codigoEmpresa.

-  Entrada: FG_INT_EMPRESA,  Seção: CSTG_C. Se o valor for 1, o código é erp e será resgatado na tabela PMMAPPIMS_EXT o código do bioenergia. Se o valor for 2, não há alteração no código informado.

-  Entrada: CSTGDG_TAM_CTA,  Seção: INT_ERP. O valor define o tamanho do codigoCtaCon, se for maior do que o esperado ele é cortado.

-  Entrada: CSTGDG_DEB_CRED ,  Seção: INT_ERP. Se o valor for 1, continua sendo usado o qtValor. Se o valor for 2 o atributo qtValor será calculado usando qtValorInicial e qtValorFinal (qtValorFinal - qtValorInicial)

Image Added

ele é chamado de debito e crédito mudo o nome?

-  Entrada: CSTGDG_FG_SOMA,  Seção: INT_ERP. Se o valor for 'S' será feita a soma do valor informado com o valor existente do banco, e o resultado será gravado. Se o valor for 'N' o valor informado que será gravado.

-  Entrada: FG_CSTG_INTDG_ERP ,  Seção: INT_ERP. Se o valor for 'S' as informações também serão atualizadas na tabela CSTG_INTDG_ERP. Se o valor for 'N' as informações são atualizadas apenas na CSTG_INTDG.


DELETE

http:127.0.0.1:8080/entity/v1/despesasGerais

Parâmetros

  • recuperarInstancia: Usado para quando se quer recuperar a instancia por outros parâmetros.

Observações

- Os atributos podem ser usados como parâmetro para a deleção.

- Todos os parâmetros podem ser informados através de um único ou de um intervalo, mas um mesmo parâmetro não pode ser informado das duas formas simultaneamente. Ex: pode ser informado a dataRefer ou  dataReferInicial e dataReferFinal.

- É obrigatório informar a dataRefer ou seu intervalo para efetuar a deleção.

- Os atributos relacionados a vlTarifa não podem ser usados.

- Caso queira usar a instancia para a deleção, mas não possua seu valor, é possível deixar o atributo recuperarInstancia true e enviar codigoEmpresaInst ou codigoEstabelecimentoInst (dependendo de como o sistema é configurado). 

- Caso a instancia seja recuperada não é possível passar um intervalo de codigoEmpresaInst ou codigoEstabelecimentoInst.

- O atributo codigoEstabelecimento pode ser usado no lugar do codigoEmpresa(dependendo de como o sistema é configurado).

- O atributo codigoEmpresa informado pode ser erp, então será resgatado o código do bioenergia (dependendo de como o sistema é configurado).

- Dependendo da configuração do sistema essas informações também são deletadas na tabela CSTG_INTDG_ERP.

- A tabela CSTG_INTDG_ERP  pode apenas  ser modificada junto com a CSTG_INTDG, porém é possível realizar o GET.

Configuração de parâmetros

-  Entrada: CSTGDG_FILT_EST, Seção: INT_ERP.  Se o valor for 'S' instancia é recuperada usando o codigoEstabelecimento. Se o valor for 'N' instancia é recuperada usando o codigoEmpresa.

-  Entrada: FG_EMPR_FILIAL,  Seção: INT_ERP. Se o valor for 'F' é usado o codigoEstabelecimento como o codigoEmpresa. Se o valor for 'E' continua sendo usado o codigoEmpresa.

-  Entrada: FG_INT_EMPRESA,  Seção: CSTG_C. Se o valor for 1, o código é erp e será resgatado na tabela PMMAPPIMS_EXT o código do bioenergia. Se o valor for 2, não há alteração no código informado.

-  Entrada: FG_CSTG_INTDG_ERP ,  Seção: INT_ERP. Se o valor for 'S' as informações também serão deletadas na tabela CSTG_INTDG_ERP. Se o valor for 'N' as informações são deletadas apenas na CSTG_INTDG- 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.