Consulta Juros e Correções / Adiantamento de Fornecedores e Prestador de Serviço
Disponibilizado endpoint para consulta de Juros e Correções / Adiantamento de Fornecedores e Prestador de Serviço .
Estrutura:
| Atributo | Descrição | Tipo | Observação |
|---|---|---|---|
| noContrato | Número do contrato | Numérico | Identificador principal do contrato |
| cdEmpresa | Código da Empresa | Texto | Identificador da Empresa |
| fgStatusIntErp | Status Integração Erp | Texto | Identificador de Status |
| cdUnidInd | Código da unidade industrial | Numérico | Unidade vinculada ao contrato |
| dtIniVig | Data de início da vigência | Data | Formato ISO 8601 (AAAA-MM-DD) |
| cdClassifContr | Código de classificação do contrato | Numérico | Relaciona com tabela de classificação |
| vlOriginal | Valor original do contrato | Numérico | Valor inicial contratado |
| cdTpAdiant | Código do tipo de adiantamento | Numérico | Ex: 18 |
| fgTipoFavorec | Tipo do favorecido | Texto | Ex: “T” |
| deTipoFavorec | Descrição do tipo de favorecido | Texto | F - Fornecedor T - Prestador de Serviço |
| cdTpDesp | Código do tipo de despesa | Numérico | Pode ser nulo |
| cdSafraDesc | Código da safra de descrição | Numérico | Ex: 2024 |
| fgTpLancto | Tipo de lançamento | Texto | Ex: “P” |
| contratoJurosCM.dtEvento | Data do Evento | Data | Ex: 2024-10-31T00:00:00 |
| contratoJurosCM.fgHistStatusIntErp | Status de integração | Texto | Ex: 8;9;r;nulo;A;5;C |
| contratoJurosCM.vlEventoAnterior | Evento anterior | Numérico | Valor do Evento anterior |
| contratoJurosCM.vlEvento | Valor do Evento | Numérico | Valor do Evento |
| contratoJurosCM.vlJuro | Valor de juros | Numérico | Juros calculados sobre o contrato |
| contratoJurosCM.vlCm | Valor de correção monetária | Numérico | Correção aplicada ao contrato |
| favorecidoInfo.cdFavorecido | Código do favorecido | Numérico | Identificador do prestador ou fornecedor |
| favorecidoInfo.deFavorecido | Nome do favorecido | Texto | Ex: “TOTVS” |
| favorecidoInfo.fgTpFornec | Tipo de fornecedor | Texto | Ex: “T” |
| favorecidoInfo.deTpFornec | Descrição do tipo de fornecedor | Texto | 1 - ACIONISTA 2 - FORNECEDOR 3 - EVENTUAL 4 - PROPRIO 5 - PARCEIRO |
| favorecidoInfo.fgTpPess | Tipo de pessoa | Texto | “F” (Física) ou “J” (Jurídica) |
| favorecidoInfo.cdIntErp | Código de integração ERP | Texto | Código de integração no ERP |
| classificacaoContrato.cdClassifContr | Código da classificação do contrato | Numérico | Ex: 200 |
| classificacaoContrato.deClassifContr | Descrição da classificação do contrato | Texto | Ex: “TESTE” |
| classificacaoContrato.fgTipoFavorec | Tipo de favorecido (classificação) | Texto | Ex: “T” |
| rateioEntreFavorecidos.cdFavorecido | Código do favorecido do rateio | Numérico | Ex: 1 |
| rateioEntreFavorecidos.deFavorecido | Descrição do favorecido do rateio | Texto | Ex: "TOTVS" |
| rateioEntreFavorecidos.cdErp | Código erp do favorecido do rateio | Texto | Ex: "12345" |
| rateioEntreFavorecidos.valorPgto | Valor pago ao favorecido do rateio | Numérico | Ex: 0.75 |
| rateioEntreFavorecidos.percentualPgto | Percentual pago ao favorecido do rateio | Numérico | Ex: 7500.00 |
Método GET:
http:127.0.0.1:8080/api/query/v1/jurosCorrecoesAdiantFornec
Estrutura de dados:
Juros e Correções / Adiantamento de Fornecedores e Prestador de Serviço
{
"hasNext":false,
"items":[
{
"noContrato":40,
"cdEmpresa":1,
"fgStatusIntErp": null,
"cdUnidInd":1,
"dtIniVig":"2024-09-30",
"cdClassifContr":200,
"vlOriginal":10000,
"cdTpAdiant":18,
"fgTipoFavorec":"T",
"deTipoFavorec":"Prestador de Serviço",
"cdTpDesp":null,
"cdSafraDesc":2024,
"fgTpLancto":"P",
"contratoJurosCM": [
{
"dtEvento": "2024-10-31T00:00:00",
"fgHistStatusIntErp": "C",
"vlEventoAnterior": 728.88,
"vlEvento": 728.88,
"vlJuro": 0,
"vlCm": 0
}
],
"favorecidoInfo":[
{
"cdFavorecido":47018,
"deFavorecido":"TOTVS",
"fgTpFornec":"T",
"deTpFornec":"TRANSPORTA",
"fgTpPess":"F",
"cdIntErp":"47018"
}
],
"classificacaoContrato":[
{
"cdClassifContr":200,
"deClassifContr":"TESTE",
"fgTipoFavorec":"T"
}
],
"rateioEntreFavorecidos": [
{
"cdFavorecido": 79903,
"deFavorecido": "TOTVS",
"cdErp": "79903",
"percentualPgto": 0.25,
"valorPgto": 2500.00
},
{
"cdFavorecido": 2619,
"deFavorecido": "JOHN DOE",
"cdErp": "2619",
"percentualPgto": 0.75,
"valorPgto": 7500.00
}
]
}
]
}
Parâmetros Obrigatórios
- instancia: Código da Instância.
- dtIniVigencia: Data Inicial
- dtVencimento: Data Final
Parâmetros Opcionais
- cdUnidInd: Código da Unidade Industrial.
- cdUpnivel1: Código de Fazenda.
- noContrato: Número do contrato
- cdEmpresa: Código da Empresa
- tipoFavorecido: Tipo de Favorecido
- fgStatusIntErp: Status Integração Erp
- fgHistStatusIntErp: Status Integração ERP referente ao bloco de Juros e correções
Atualizar status de integração - Integração da API de Juros e Correções
Disponibilizado endpoint para atualizar status de integração dos registros relacionados ao Integração da API de Juros e Correções.
Método PUT:
http:127.0.0.1:8080/api/query/v1/atualizaCfParam
| Body da Requisição - Status Integração |
|---|
{ |
Parâmetros Obrigatórios
- instancia: Código da Instância.
- cdEmpresa: Código da Empresa.
- cdContrato: Código do Contrato.
Bloqueio da Reversão de Processamentos que apresentem registros já integrados com outros sistemas
Com o objetivo de assegurar a consistência das informações integradas com outros sistemas, foi desenvolvido uma nova funcionalidade dentro da aplicação Configuração Central (CFGCEN / TOTVS Agro Bioenergia), onde será possível realizar o cadastro de rotinas executadas pelo TOTVS Agro Bioenergia e indicar os possíveis “status de integração” vindos de sistemas externos (que estejam integrados ao TOTVS Agro Bioenergia).
Esta operação é realizada especificamente para os processamentos do módulo COFINANC, garantindo que registros financeiros já integrados com sistemas externos respeitem as regras de bloqueio definidas, evitando inconsistências e divergências de informações.
Para cada status indicado, será possível apontar se será permitido ou não a reversão do processo em questão.
Visando possibilitar a indicação de diferentes cadastros para diferentes processamentos disponíveis em nosso sistema, foram criados parâmetros específicos para cada rotina, onde o usuário deverá determinar qual cadastro deverá ser consultado no momento de realizar a reversão do processamento.
Importante: caso um ou mais registros apresentem um status onde esteja apontado o impedimento para reversão, o processamento será interrompido, impedindo a execução da reversão para todos os registros envolvidos.
Parâmetro "Código do cadastro de controle de status para Financeiro (COFINANC)"
Seção: COFINANC
Entrada: CD_CAD_STATUS_INT_FINANC
Para mais detalhes sobre a funcionalidade citada acima, acesse a página Cadastro de Bloqueio de Movimentações via API.
Atualizar status de integração - Integração da API de Adiantamento
Disponibilizado endpoint para atualizar status de integração dos registros relacionados ao Integração da API de Adiantamento.
Método PUT:
http:127.0.0.1:8080/api/query/v1/adiantamentoFornec
| Body da Requisição - Status Integração |
|---|
{ |
Parâmetros Obrigatórios
- instancia: Código da Instância.
- codigoEmpresa: Código da Empresa.
- fgStatusIntErp: Status de Integração.
- noContrato: Número do contrato
Bloqueio da Reversão de Processamentos de Adiantamento de Fornecedores e Prestadores de Serviços com Registros Já Integrados
Com o objetivo de assegurar a consistência das informações de adiantamento de fornecedores e prestadores de serviços integradas com outros sistemas, foi desenvolvida uma nova funcionalidade dentro da aplicação Configuração Central (CFGCEN / TOTVS Agro Bioenergia). Essa funcionalidade permite o cadastro de rotinas executadas pelo TOTVS Agro Bioenergia, possibilitando indicar os possíveis status de integração provenientes de sistemas externos que possuam integração com o produto.
Essa operação é realizada especificamente para os processamentos de adiantamento do módulo COFINANC, garantindo que registros financeiros de adiantamentos já integrados com sistemas externos respeitem as regras de bloqueio previamente definidas, evitando inconsistências e divergências de informações entre os sistemas.
Para cada status de integração cadastrado, será possível definir se a reversão do adiantamento será permitida ou não, de acordo com as regras de negócio estabelecidas.
Com o intuito de possibilitar a utilização de diferentes cadastros de controle de status para diferentes processamentos disponíveis no sistema, foram criados parâmetros específicos por rotina. Dessa forma, o usuário deverá informar qual cadastro será consultado no momento da tentativa de reversão do processamento de adiantamento.
Importante: caso um ou mais registros de adiantamento apresentem um status configurado com impedimento de reversão, o processamento será imediatamente interrompido, não sendo permitida a reversão para nenhum dos registros envolvidos na operação.
Parâmetro
Código do cadastro de controle de status para Adiantamento
Seção: COFINANC
Entrada: CD_CAD_STATUS_INT_ADIANT
Para mais detalhes sobre a funcionalidade citada acima, acesse a página Cadastro de Bloqueio de Movimentações via API.
Atualizar status de integração - Integração da API de Juros e correções
Disponibilizado endpoint para atualizar status de integração dos registros relacionados ao Integração da API de Juros e Correções.
Método PUT:
http:127.0.0.1:8080/api/query/v1/jurosCorrecoesAdiantFornec
| Body da Requisição - Status Integração Juros e Correções |
|---|
{ |
Parâmetros Obrigatórios
- instancia: Código da Instância.
- cdEmpresa: Código da Empresa.
- noContrato: Número do contrato
- fgHistStatusIntErp: Status de Integração.
Bloqueio da Reversão de Processamentos de Adiantamento de Fornecedores e Prestadores de Serviços com Registros Já Integrados
Com o objetivo de assegurar a consistência das informações de adiantamento de fornecedores e prestadores de serviços integradas com outros sistemas, foi desenvolvida uma nova funcionalidade dentro da aplicação Configuração Central (CFGCEN / TOTVS Agro Bioenergia). Essa funcionalidade permite o cadastro de rotinas executadas pelo TOTVS Agro Bioenergia, possibilitando indicar os possíveis status de integração provenientes de sistemas externos que possuam integração com o produto.
Essa operação é realizada especificamente para os processamentos de Juros e Correções do módulo COFINANC, garantindo que registros financeiros de juros e correções já integrados com sistemas externos respeitem as regras de bloqueio previamente definidas, evitando inconsistências e divergências de informações entre os sistemas.
Para cada status de integração cadastrado, será possível definir se a reversão do adiantamento será permitida ou não, de acordo com as regras de negócio estabelecidas.
Com o intuito de possibilitar a utilização de diferentes cadastros de controle de status para diferentes processamentos disponíveis no sistema, foram criados parâmetros específicos por rotina. Dessa forma, o usuário deverá informar qual cadastro será consultado no momento da tentativa de reversão do processamento de adiantamento.
Importante: caso um ou mais registros de adiantamento apresentem um status configurado com impedimento de reversão, o processamento será imediatamente interrompido, não sendo permitida a reversão para nenhum dos registros envolvidos na operação.
Parâmetro
Código do cadastro de controle de status para Adiantamento
Seção: COFINANC
Entrada: CD_CAD_STATUS_INT_JUR_CM
Para mais detalhes sobre a funcionalidade citada acima, acesse a página Cadastro de Bloqueio de Movimentações via API.
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas