Histórico da Página

<div class="post">POST</div>
<div class="endereco">/rm/api/TOTVSCustomizacao/CstIntegracaoProtheusAcordo/Inclusao</div>

Efetiva no SGE os acordos efetuados no Protheus. 

A API efetua a criação do acordo, a baixa dos lançamentos originais e a criação dos novos lançamentos gerados pelo acordo, conforme negociação gerada no Protheus.

Tabela Afetada: FLAN, FLANBAIXA, FACORDO, FACORDOREL

Interface RM: TOTVS Educacional | Educacional | Financeiro/Contábil | Contratos | Parcelas | Lançamentos Financeiros (editar o lançamento e acessar o anexo "Acordo")

Authorization - Basic Auth

Username <username>

Password <password>

Body

{
    "IdNegociacaocodColigada": "1003", 
    "CodcoligadaIdLiquidadao": "23|CSI|TESTE|CNI418Parc1&1",
    "NumParcelas": 103,
    "CodCCusto": "1234567893.03.01.03.01",
    "TipoJuros": 0,
    "TaxaJuros": 0,
    "ValorJurosDia": 0.0,
    "DataAcordo": "2022-0106-0114",
    "ValorLiquido": 1500.000,
    "ValorAcordo": 15002499.000,
    "ValorDesconto": 0.01,
    "ValorAcrescimo": 0.0100,
    "LancamentosOriginais": [
     [{
        "idlanIdlan": 22232
    },
    }],{
      "LancamentosAcordoIdlan": 233
    }
  ],
  "LancamentosAcordo": [
    {
      "identificador": "001", 
      "dataPrevisaoBaixa": "2022-07-10", 
      "identificadordataVencimento": "SGE31000",
  "2022-07-10",
      "Valor": 1050.11
    },
    {
      "DataVencimento": "2022-08-10",
      "nossoNumeroValor": "898001212154",1248.89
    },
    "dataVencimento": "2022-06-13",
  {
      "dataPrevisaoBaixaDataVencimento": "2022-0609-1210",
         "valorValor": 1050200.000
    }
  }]
}

Content

• codColigada: Código da Coligada. Enviar 2 para SESI e 3 para SENAI (primary key).
• idLan: Id do Lançamento gerado no SGE (primary key);
• idNegociacaoIdLiquidacao: Chave da negociação/ liquidação do Protheus utilizada para identificar o registro no Log do Processo (pode concatenar vários valores neste campo). O valor enviado será gravado no campo "Observação" do Acordo gerado no SGE. 
• NumParcelas: Número de Parcelas que devem ser geradas pelo Acordo no SGE.
• CodCCusto: Código do Centro de Custo do Acordo
• TipoJuros: Juros Futuros - indica se será informado o percentual ou o valor dos juros. Enviar 0 para informar Taxa e 1 para informar Valor. De acordo com o preenchimento, apenas um campo abaixo deve ser informado:
  • TaxaJuros: Percentual de taxa de juros ao dia do Acordo
  • ValorJurosDia: Valor da taxa de juros ao dia do Acordo
• DataAcordo: Data em que o acordo foi gerado no Protheus.
• ValorLiquido: Valor líquido do Acordo gerado.
• ValorAcordo: Valor total do Acordo gerado.
• ValorDesconto: Valor do desconto do Acordo.
• ValorAcrescimo: Valor do acréscimo do Acordo.

• LancamentosOriginais: lista de lançamentos que darão origem ao acordo. Os lançamentos enviados aqui serão baixados no SGE (tipo de baixa = Por Acordo). 
  • idlan: Identificador do lançamento original do acordo
• LancamentosAcordo: lista de lançamentos que serão gerados pelo Acordo. O número de itens desta lista deve ser igual ao campo NumParcelas. Os lançamentos enviados aqui serão gerados no SGE com status Em Aberto (tabela FLAN).
  • identificador: Número identificador do título do Protheus (chave única, composta por E1_FILIAL + E1_PREFIXO + E1_NUM + E1_PARCELA + E1_TIPO). A informação será armazenada no campo SEGUNDONUMERO do lançamento (FLAN).nossoNumero: Nosso Número do boleto gerado no Protheus, é gravado no boleto associado ao lançamento no RM.
  • dataVencimento: Data de vencimento real (dia útil) do lançamento/boleto (FLAN.DTVENCIMENTO).
  • dataPrevisaoBaixa: Data de previsão de vencimento do lançamento/boleto calculada pelo Protheus. Informação gravada em FLAN.DATAPREVBAIXA.
  • valor: Valor total do boleto/lançamento.

Retorno

{
"Message": "Sucesso ao incluir o Acordo: 22\r\n",
"Status": "Sucesso",  
"StatusCode": 200,  
"IdAcordo": 20,   
"Data": "IdNegociacao": 100, "Codcoligada": 2, "NumParcelas": 10, "CodCCusto": null, "TipoJuros": 0, "TaxaJuros": 0, "ValorJurosDia": 0.0, "DataAcordo": "29/01/2022", "ValorLiquido": 1500.00, "ValorAcordo": 1500.00, "ValorDesconto": 0.0, "ValorAcrescimo": 0.0, "RA": "00000247", "LancamentosOriginais": 
}

Content

• Message: Mensagem de retorno do consumo da requisição;
• Status: Situação do processamento da requisição;
• IdAcordo: Identificador do Acordo gerado no SGE;
• StatusCode: Código de status do processamento da requisição;
• Dados: lista com informações do acordo gerado no SGE 
  • identificador: chave do título do Protheus, enviado na requisição. 
  • idlan: identificador do lançamento gerado no SGE.