Exibir origem

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:

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

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

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.

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.