Resumo
Para o módulo Registros Contábeis Empresas, os serviços disponibilizamos para os registros de Lançamentos Contábeis, serviço de envio parcial de lotes, que serão processados de forma assíncrona para os Lançamentos Contábeis.
O Fluxo continua sendo permanece semelhante ao envio de modo síncrono, Iniciar envio, Enviar Parcial Lote e Finalizar Envio.
Para o serviço de envio parcial por lote após Após o e-Sfinge Online receber os registros o envio parcial dos registros enviados, 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
Esse serviço continua igual, sendo necessário iniciar a transmissão para receber a "chave do pacote" para ser utilizado no envio parcial.
SUBSTITUIR PRINTS
...
/v5/registroscontabeis/empresas/iniciarEnvio
...
Enviar Parcial em Lote
Esse serviço recebe os dados dos Registros Contábeis e retornará um número de lote, para que possa ser consultado o status de seu processamento.
...
/v5/registroscontabeis/empresas/enviarParcialLote
...
Observação sobre os envios dos lotes:
As Contas Contábeis serão continuarão sendo processadas de forma síncrona, ou seja, qualquer erro inconsistência 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 será devolvido retornará um número de lote)
Retorno:
...
Consultar Por Número de Lote
Serviço responsável por apresentar a situação do lote e os possíveis erros de todo o processamento concatenado.
...
Retorno:
SUBSTITUIR PRINTS
...
/v5/registroscontabeis/empresas/consultarPorNumeroLote/{numeroLote}
...
Quais situações o lote pode assumir?
...
Quando um lote é processado com esse status, a chave de pacote é automaticamente cancelada e todos os lotes enviados anteriormente são descartados (mesmo que processados com status PROCESSADO_SUCESSO), 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_INTERNOe após a correção do dado enviado incorretamente deve ser realizado envio de todos os lotes novamente.
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 (mesmo que processados com status PROCESSADO_SUCESSO), sendo necessário iniciar uma nova remessa através do iniciarEnvio e após a correção do dado enviado incorretamente deve ser realizado envio de todos os lotes novamente.
ABORTADO_ERRO_LOTE_ANTERIOR
Quando um dos lotes anteriores da mesma "chave de pacote" tenha sido processado com uma das situações PROCESSADO_ERRO_NEGOCIO ou PROCESSADO_ERRO_INTERNO.
...
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"
...
Serviços Gerais
Consultar Status dos lotes por chave do pacote
Serviço para consultar todos os lotes enviados uma chave de pacote.
...
??????
Comportamento do timeout.
UMA SEMANA?
...
...
O envio de Registros Contábeis Empresas no modo SÍNCRONO continuará disponível seguindo o mesmo fluxo de sempre:
Iniciar Envio, Enviar Parcial e Finalizar Envio.
...