UNRELEASED¶
Rascunho acumulado em develop. A nota publicada desta versão nasce só na tag (CHANGELOG.md e docs/release-notes/v*.md).
Adicionado¶
- Contrato do resultado único da importação IPL: o mesmo fechamento, os mesmos relatórios e os mesmos erros na API Java e na lambda.
docs/desenvolvimento/paridade_importacao_ipl.md. BatchDTOexpõeiplSourceFile(ct_lote.arquivo_ipl) econsolidated(derivado dect_calendario.consolidadoda competência). Digitação/API de lote não sobrescrevem o nome do arquivo.
Corrigido¶
- Reprocessamento IPL com consolidação OK: reports ativos em
error/(*.REPORT.csv,ERRO_CONSOLIDATION_*,ERRO_*) são arquivados emhistory/{arquivo}/{importId}/e removidos da caixa ativa. O mensal continua com append (linha do tempo porImportId); a UI deixa de mostrar erro vigente quando a falha era de configuração e o arquivo passou depois. - Import IPL S3:
ImportIdpassa a ir nos CSVs (mensal, REPORT, CHANGES, ERRO); pastasAWS_S3_IMPORTED_FOLDER/AWS_S3_ERROR_FOLDER/AWS_S3_REPORTS_FOLDERligam no Spring; reports no bucket de report emimported/·error/·changes/; mensal na raiz da pasta de report; removido o marcador.CHANNEL; IPL ok/erro usam as pastas configuradas (sem…/files/fixo). - Cálculo de cota: quando o indicador do calendário não tem dia livre (
indexOf('0') == -1), deixa de montar a data inválidaYYYYMM-1(NumberFormatException). Resolve o dia do saldo viaCalendarIndicator.quotaBalanceDay(primeiro livre na convenção legada, ou último processado/encerrado). - Consolidação manual do mês: após recalcular saldos, a marcação
ct_lote.consolidadopassa a avançar dia a dia na mesma passada (antes só o primeiro dia batido recebia ✓). Lotes divergentes continuam bloqueando os dias seguintes; divergência de lanctos no documento também é excluída da lista de candidatos. - Listagem/upload IPL (
ImportIplServiceImpl) usaaws.s3.region(AWS_DEFAULT_REGION) noS3Client. Antes o SDK caía noDefaultAwsRegionProviderChaine exigiaAWS_REGION. - Na importação/gravação de lançamento, se o movimento é no dia N e os dias anteriores ainda estão livres (
0) no calendário, esses dias passam a*(processados). Assim, consolidar o dia 2 sem lançamento no dia 1 não deixa o dia 1 livre e evitaSEM DIA LIVREno cálculo de cota. - A listagem de
/admin/import-ipl/filespercorre os bucketsAWS_S3_BUCKET,AWS_S3_ERROR_BUCKET,AWS_S3_IMPORT_BUCKETeAWS_S3_REPORT_BUCKET(quando distintos) nas pastas de origem, importados, erro e relatório. O download recebe o bucket de origem do arquivo. - Monitor e upload IPL (
AWS_S3_BUCKET_NAME) passam a usar, se vazios,IMPORT_MONITOR_BUCKET, depoisAWS_S3_BUCKETeECOSIF_S3_FILE. - Falhas de S3 (
put/copy/delete) na importação IPL são registradas sem gerar 500 na API. OPOST /importMovimentcaptura exceções e tenta gravar a rejeição;IllegalStateException(ex.: bucket ausente) responde 400 com a mensagem. - A subida do
ecosif-movimentsexigeAWS_DEFAULT_REGIONeAWS_S3_BUCKET.AWS_ACCESS_KEY_IDeAWS_SECRET_ACCESS_KEYsão opcionais. Valor vazio ou só uma das duas é removido do ambiente. Com as duas preenchidas, o S3 usa a chave estática. Sem as duas, usa a task role do ECS. Se a chave estática for recusada, inclusive comAccessDenied, o processo passa a usar a task role até o restart. Timeout emput,copyoudeletenão repete a operação. A task definition precisa de task role quando esse caminho for usado. POST /importMoviment/{empresa}/{filial}/{arquivo}lê a data da linha IPL como YYMMDD no século 20. Rejeita o arquivo quando há mais de uma data de movimento ou quando essa data não é a do nome (FUNDO_YYYYMMDD.IPL).- O corpo do IPL é partido por CR/LF nos bytes e decodificado por linha: UTF-8 só quando já tem 156 caracteres válidos; senão CP1252/Latin-1/IBM860 (1 byte = 1 char). Assim arquivos Windows com ç/ã (ex.:
57447_20261002.IPL) não encolhem nas linhas 1/7/19. Espaços do layout não são removidos antes da validação de tamanho. - O lote novo da importação IPL grava
usuario_iddo usuário autenticado. O valor-1violava a chave estrangeirafk_ct_lote_usuario. - A limpeza dos saldos diários na consolidação executa o
DELETEcomo atualização. Antes, a consulta sem resultado marcava a transação para rollback. - Quando o IPL já está na raiz do bucket, a importação copia essa chave para
imported/files/ouimportError/files/e apaga a origem. Quando a chamada traz só o conteúdo, o corpo é gravado direto na pasta de destino, sem criar objeto na raiz. - Sem documento, o lote informa a quantidade de lançamentos do arquivo, e débito e crédito com duas casas. O digitado do lote fica com a mesma quantidade, para a consolidação não parar na diferença 7 x 1. O log registra o início e o resultado da consolidação.
Alterado¶
- O primeiro bloco do nome IPL (
FUNDO_YYYYMMDD.IPL) aceita de 5 a 8 caracteres alfanuméricos. Antes o limite era 5 a 6. POST /importMoviment/{empresa}/{filial}/{arquivo}sempre responde em texto. Aceite: HTTP 200 eImportação aceita: {arquivo}. Recusa: HTTP 400 e o motivo (nome, corpo, data, empresa, filial, linha ou lote). Falha inesperada: HTTP 500 e a mensagem. Cada chamada recebe umimportId(cabeçalhoX-Import-Ide sufixo do corpo). O log registra as etapasrecebido,validado,linhas,gravacao,lote,lancamentos,consolidacao,cota,fechamentoes3com esse id e o nome do arquivo.- Monitor de importação (
/admin/import-monitor): filas SQS e janelas Dynamo só aparecem quando configuradas; sem elas o modo éAPI(DB+S3). Cada arquivo trazchannel(API/LAMBDA/UNKNOWN); a importação Java grava o marcadorimported/reports/details/{arquivo}.CHANNEL. Flush/clear de janela respondemDISABLEDquando o pipeline não está habilitado. POST /importMovimentrecusa, antes de gravar lançamento, nome fora do padrão, linha inválida e empresa ou filial inexistentes no cadastro. Empresa e filial são as da URL. OCT32.LDnão é lido. O CSV vai paraimportError/ERRO_{arquivo}.csvcom;, e o IPL paraimportError/files/. Cabeçalho de layout é ignorado. Refs: #117.- O lote gravado é o próximo número da competência (
000001,000002…), marcado com o nome do arquivo. Reimportar o mesmo arquivo reutiliza esse lote. O documento fica000001e o textoImport:{arquivo}. Lançamento tipo 2 grava débito e crédito. Refs: #118. - Lote já existente segue
loteencerraelanencerra: as duas desligadas recusam o arquivo; sólanencerraexige o mesmo dia e substitui o código; sóloteencerrazera o dia de referência e não apaga código existente; as duas ligadas substituem o lançamento. Refs: #119. - No fim da gravação, e antes da consolidação, nasce
imported/reports/details/{arquivo}.REPORT.csvcom uma linha por lançamento.ConsolidationeQuotaficam--.imported/reports/{arquivo}.CHANGES.csvsó nasce se houve substituição. Refs: #120. - Depois da gravação, com ao menos uma linha inserida, a consolidação percorre os meses pendentes até a competência, calcula a cota e fecha o dia no
ult_diado calendário. Mês já consolidado não recalcula cota nem fechamento. Não há mais fechamento marcado como falho e em seguida como sucesso. Refs: #121. - No fim da consolidação o
.REPORT.csvé reescrito comConsolidationeQuota. Uma linha é acrescentada emimported/reports/{fundo}_{YYYYMM}_report.csv. Exceção gravaimportError/ERRO_CONSOLIDATION_{arquivo}.csve manda o IPL paraimportError/files/. O IPL só vai paraimported/files/quando a consolidação conclui. Refs: #122. - Os testes de paridade conferem o fechamento, os relatórios dos dois pontos e o CSV de erro: lote novo, segundo arquivo do mês, as quatro combinações de flags, falha de consolidação e as recusas anteriores à gravação. Onde não há
.REPORT.csv, o teste também não encontra esse arquivo. Refs: #123.
Removido¶
Breaking Changes¶
POST /importMoviment/**deixa de ser público. A chamada semAuthorization: Bearerresponde 401. O token é o de serviço a serviço (client_credentials Entra ou Itaú STS), comECOSIF_API_TOKEN_MODEhíbrido ou gateway Azure,ECOSIF_ENABLE_AZURE_APP_ONLY=truee vínculo emidentity_provider_link.