Resumo
Para o módulo Registros Contábeis Empresas, disponibilizamos para os Lançamentos Contábeis serviço de envio parcial de lotes, que serão processados de forma assíncrona.
O Fluxo continua sendo Iniciar envio, Enviar Parcial Lote e Finalizar Envio.
Para o serviço de envio parcial por lote após o e-Sfinge Online receber os registros será gerado um número de lote e adicionado esses registros em uma fila de processamento, com esse número de lote a aplicação das empresas pode consultar o status de processamento.
Será possível enviar quantos lotes forem necessários para uma chave de pacote iniciada.
Serviços da API https://virtual.testing.tce.sc.gov.br/esfingeonline/swagger-ui.html
Iniciar Envio
/v5/registroscontabeis/empresas/iniciarEnvio
Enviar Parcial em Lote
/v5/registroscontabeis/empresas/enviarParcialLote
Retorno:
Observação sobre os envios dos lotes:
As Contas Contábeis continuarão sendo processadas de forma síncrona, ou seja, qualquer erro que tiver em alguma conta irá gerar um erro de regra de negócio, a remessa irá ser cancelada automaticamente e os lançamentos contábeis não irão para a fila de processamento (não retornará um número de lote)
Consultar Por Número de Lote
/v5/registroscontabeis/empresas/consultarPorNumeroLote/{numeroLote}
Serviço responsável por apresentar a situação do lote e os possíveis erros de todo o processamento concatenado.
Retorno:
SUBSTITUIR PRINTS
Quais situações o lote pode assumir?
RECEBIDO
Lote foi recebido pelo e-Sfinge Online e está aguardando processamento.
EM_PROCESSAMENTO
Lote sendo processado pelo e-Sfinge Online.
PROCESSADO_SUCESSO
Todos os registros do lote foram processados com sucesso.
PROCESSADO_ERRO_NEGOCIO
Foram processados os registros e concatenados os erros de negócio encontrados pelo e-Sfinge Online.
Quando um lote é processado com esse status, a chave de pacote é automaticamente cancelada e todos os lotes enviados anteriormente são descartados, sendo necessário iniciar uma nova remessa através do iniciarEnvio.
ABORTADO_ERRO_LOTE_ANTERIOR
Quando um dos lotes anteriores da mesma "chave de pacote" tenha sido processado com a situação PROCESSADO_ERRO_NEGOCIO ou PROCESSADO_ERRO_INTERNO
PROCESSADO_ERRO_INTERNO
Algo inesperado aconteceu no processamento do lote, código da remessa foi cancelado. Favor abrir chamado para nosso helpdesk com o detalhe do erro e identificador da remessa.
Quando um lote é processado com esse status, a chave de pacote é automaticamente cancelada e todos os lotes enviados anteriormente são descartados, sendo necessário iniciar uma nova remessa através do iniciarEnvio.
Finalizar Envio
Serviço igual aos outros módulos, porem somente é possível finalizar uma transmissão depois que todos os lotes enviados estiverem na situação "PROCESSADO_SUCESSO"
??????
Comportamento do timeout.
UMA SEMANA?
O timeout do pacote do tributário é de 72h sem recebimento de pacotes ou chamada da Descartar SubAssunto. A cada chamada destes endppoint o timeout será resetado.