Histórico da Página

...

Disponibilizado endpoint para consulta de Juros e Correções / Adiantamento de Fornecedores e Prestador de Serviço .

Estrutura:

Atributo	Descrição

Tamanho

Tipo	Observação
noContrato	Número do contrato

6

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

3

	Numérico	Unidade vinculada ao contrato
dtIniVig	Data de início da vigência

10

	Data	Formato ISO 8601 (AAAA-MM-DD)
cdClassifContr	Código de classificação do contrato

4

Numérico	Relaciona com tabela de classificação
vlOriginal	Valor original do contrato

12,2

	Numérico	Valor inicial contratado
cdTpAdiant	Código do tipo de adiantamento

3

	Numérico	Ex: 18
fgTipoFavorec	Tipo do favorecido

1

	Texto	Ex: “T”
deTipoFavorec	Descrição do tipo de favorecido

30

Texto

F - Fornecedor

T - Prestador de Serviço

cdTpDesp

Código do tipo de despesa

3

	Numérico	Pode ser nulo
cdSafraDesc	Código da safra de descrição

4

	Numérico	Ex: 2024
fgTpLancto	Tipo de lançamento

1

	Texto	Ex: “P”

contratoJurosCM.dtEvento	Data do Evento	Data	Ex: 2024-10-31T00:00:00
contratoJurosCM.fgHistStatusIntErp	Status de integração	Texto	Ex:

“P”

8;9;r;nulo;A;5;C

contratoJurosCM.

noContratoNúmero do contrato6NuméricoChave de relação com contrato principal

vlEventoAnterior	Evento anterior	Numérico	Valor do Evento anterior
contratoJurosCM.vlEvento	Valor do Evento	Numérico	Valor do Evento
contratoJurosCM.vlJuro	Valor de juros

12,2

Numérico	Juros calculados sobre o contrato
contratoJurosCM.vlCm	Valor de correção monetária

12,2

Numérico	Correção aplicada ao contrato

favorecidoInfo.cdFavorecido	Código do favorecido

6

Numérico	Identificador do prestador ou fornecedor
favorecidoInfo.deFavorecido	Nome do favorecido

50

	Texto	Ex: “TOTVS”
favorecidoInfo.fgTpFornec	Tipo de fornecedor

1

Texto	Ex: “T”
favorecidoInfo.deTpFornec	Descrição do tipo de fornecedor

30

Texto

1 - ACIONISTA

2 - FORNECEDOR

3 - EVENTUAL

4 - PROPRIO

5 - PARCEIRO

favorecidoInfo.fgTpPess

Tipo de pessoa

1

	Texto	“F” (Física) ou “J” (Jurídica)
favorecidoInfo.cdIntErp	Código de integração ERP

20

	Texto	Código de integração no ERP

classificacaoContrato.cdClassifContr	Código da classificação do contrato

4

Numérico	Ex: 200
classificacaoContrato.deClassifContr	Descrição da classificação do contrato

50

	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:

“T”

"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

...

Bloco de código

language	java
title	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":10000010000,
         "cdTpAdiant":18,
         "fgTipoFavorec":"T",
         "deTipoFavorec":"Prestador de Serviço",
         "cdTpDesp":null,
         "cdSafraDesc":2024,
         "fgTpLancto":"P",                      
         "contratoJurosCM": [
            {
              "dtEvento": "2024-10-31T00:00:00",
              "noContratofgHistStatusIntErp":40 "C",
              "vlEventoAnterior": 728.88,
              "vlJurovlEvento":3742 728.4888,
              "vlJuro": 0,
              "vlCm":2024.72 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

...

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
{ "statusIntegracao": "S", "instancia": 1, "noContrato": 1, "codigoEmpresa": "1", "dataGerCorrErp": "2023-01-01T00:00:00" }

Parâmetros Obrigatórios

instancia: Código da Instância.
cdEmpresa: Código da Empresa.
cdContrato: Código do Contrato.

Dica

title	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
{ "fgStatusIntErp": "1", "instancia": 1, "noContrato": 74, "cdEmpresa": "1" }

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

Dica

title	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
{ "instancia": "1", "cdEmpresa": "1", "noContrato": 2, "fgHistStatusIntErp": "C" }

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.

Dica

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

Páginas filhas

Versões comparadas

Versão antiga 5

Nova versão Atual

Chave

Parâmetros Obrigatórios

Atualizar status de integração - Integração da API de Juros e Correções

Parâmetros Obrigatórios

Parâmetros Obrigatórios

Parâmetro

Parâmetros Obrigatórios

Parâmetro