Histórico da Página

...

Chave de relação com contrato principal

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.noContrato	Número do contrato	Numérico	dtEvento	Data do Evento	Data	Ex: 2024-10-31T00:00:00
contratoJurosCM.fgHistStatusIntErp	Status de integração	Texto	Ex: 'S'
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

...

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":10000,
         "cdTpAdiant":18,
         "fgTipoFavorec":"T",
         "deTipoFavorec":"Prestador de Serviço",
         "cdTpDesp":null,
         "cdSafraDesc":2024,
         "fgTpLancto":"P",                      
         "contratoJurosCM": [
            {
               "noContrato":40"dtEvento": "2024-10-31T00:00:00",
              "fgHistStatusIntErp": "C",
              "vlEventoAnterior": "vlJuro":3742.48728.88,
              "vlEvento": 728.88,
              "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
            }
        ]
      }
   ]
}

...

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

...

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 34

Nova versão 35

Chave

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

Parâmetro

Parâmetros Obrigatórios

Parâmetro