Modo pacote: gravar como mensagens ou como pacotes
Escolha, por interface, se cada documento lido vira uma mensagem ou se as páginas lidas viram pacotes com vários documentos — e quando usar cada um.
Quando escolher cada modo
Como mensagens (padrão): quando o documento é uma transação de negócio com rastreio individual (pedido, NF-e, fatura, ASN); quando há confirmação por documento (CONTRL, 997, protocolo da NF-e); quando o erro e o reenvio precisam ser individuais; quando o destino recebe um a um (RFC IDoc, API por documento) ou não é idempotente (cria um registro a cada envio); em tempo real; em volume pequeno ou médio; quando a auditoria e a evidência são por documento.
Como pacotes: volume muito alto e repetitivo (estoque, preço, promoção, cadastro, carga de vendas); destino idempotente (upsert); cargas em lote; quando os relatórios por soma bastam.
A mesma empresa usa os dois, por interface.
Página e pacote
A página é quanto a leitura pede por vez (no OData, 50 por padrão). O Tamanho do pacote (documentos) é quanto vai numa mensagem. O pacote se enche até o teto: as páginas da leitura se juntam e a que não cabe inteira se divide entre dois pacotes; o tamanho não passa do limite de registros por execução nem de 5.000 documentos ou 4 MB (o que fechar primeiro); vale 5.000 documentos quando o campo fica vazio. A página maior que o pacote não é recusada: o Lefia a divide sozinho em vários pacotes, e a posição de leitura só avança depois de todos gravados. A tela mostra o efetivo, por exemplo "cada pacote terá até 5.000 documentos ou 4 MB (o que fechar primeiro), juntando páginas da leitura de 500". No fim de cada execução o que sobrou vira um pacote menor — nada espera a próxima execução.
Leitura sem sobreposição
No modo pacote cada leitura começa exatamente onde a anterior terminou. Não há releitura "por segurança": um registro confirmado na origem com atraso entra no próximo pacote e sai uma vez. Se a execução cair no meio, a próxima reconhece o pacote já gravado e não o envia de novo. Trocar o modo não reentrega nada. O modo pacote exige leitura incremental por cursor (não vale para leitura completa a cada execução, entidade com parâmetros nem Oracle).
Documento com erro
Um documento que o mapeamento barra não derruba o pacote: ele fica de fora e os outros seguem. O detalhe da mensagem no Monitor mostra "N documentos (pacote), k com erro". Depois de corrigir o que barrou, use Reenviar só os k com erro: sai um pacote novo só com eles; os já entregues não voltam. Um documento que espera um valor da tabela de referência da empresa não é erro: os outros seguem e ele fica retido num pacote à parte, que sai sozinho quando o valor é salvo. A versão nova de um documento nunca sai antes da anterior que ainda está retida.
O que muda nos relatórios
Relatórios, consolidados, a cobrança por documento e a tela de Execuções contam os documentos de cada pacote (com erro, pulados e duplicados à parte). O pacote é a unidade, como no SAP PI/PO e no CPI: não há busca, detalhe nem evidência por documento, os relatórios de Negócio somam o conteúdo dos documentos do pacote, mas a conversão pedido → fatura e a conciliação por documento não os mostram, e a duplicata de negócio vale só dentro do próprio pacote — o mesmo documento em dois pacotes não é detectado. Num destino não idempotente isso pode duplicar registros: use o modo mensagens.
Histórico de versões
- 1.6.6
Correção no pacote grande demais para um envio só, que sai em partes. Antes, quando uma parte levava dois documentos e só um deles já tinha uma versão mais nova entregue, a parte inteira ficava parada com erro, e o outro documento, que podia sair, esperava alguém reprocessar. Agora só o documento com a versão mais nova fica de fora, com o erro e o motivo; o outro sai normalmente. A versão antiga continua nunca chegando depois da nova.
09/11/2026 · updated
- 1.6.4
Correção no pacote grande demais para um envio só, que sai em partes. Antes, uma parte decidida de novo podia ficar parada inteira por causa de um documento que esperava outro cadastro, segurando os documentos já liberados, e duas versões do mesmo documento em partes diferentes podiam chegar fora de ordem, ficando a versão antiga por último. Agora a parte segue com os documentos liberados e só os que esperam ficam para depois, e as versões do mesmo documento saem sempre na ordem, com a mais nova por último.
09/11/2026 · updated
- 1.6.3
Correção no pacote relido com o mesmo nome (leitura completa, Reler período, janela de dias) quando um documento da faixa muda na origem. Antes, o pacote relido podia deixar de enviar um documento, mandar a versão velha de outro depois da nova, ou sair antes de um pacote lido entre as duas versões. Agora os documentos que já saíram por outro pacote são reconhecidos pelo próprio documento, não pela posição, e a versão relida é sempre tratada como a mais nova: as anteriores saem antes e ela por último. A separação dos documentos que esperam também ficou protegida contra duas decisões ao mesmo tempo, sem documento enviado duas vezes.
09/11/2026 · updated
- 1.6.2
Correção na retenção por documento do modo pacote. (1) Ordem: numa interface sem dependência de outra, a versão nova de um documento podia sair antes da versão anterior que estava retida, e a anterior, liberada depois, sobrescrevia a nova no destino. Agora toda interface em modo pacote confere a versão anterior de cada documento: a nova espera num pacote à parte e sai sozinha logo depois da anterior. (2) Tabela de referência (DE-PARA): um valor faltando para alguns documentos retinha o pacote inteiro. Agora os documentos mapeados seguem e só os que esperam a tabela ficam retidos, num pacote à parte; ao salvar parte dos valores, os documentos que já os têm seguem. Os documentos retidos não contam como erro do pacote. Nenhum documento se perde nem sai duas vezes.
09/11/2026 · updated
- 1.4.0
Retenção por documento no modo pacote. Quando alguns documentos de um pacote esperam outra interface (ordem entre integrações), o pacote segue com os documentos livres. Os que esperam vão para um pacote à parte, retido, que sai sozinho quando o que eles esperam for confirmado, por partes ou inteiro. Antes, um documento retinha o pacote inteiro, e quem dependia dele esperava em cascata. A versão nova de um documento retido nunca sai antes dela. Nenhum documento se perde nem sai duas vezes, e os relatórios e a cobrança contam cada documento uma vez, no pacote em que ele saiu.
09/11/2026 · updated
- 1.6.10
Limpeza dos dados de controle do modo pacote. Quando um pacote antigo saía pela retenção e a mesma página já tinha sido lida de novo, o registro das chaves do pacote antigo ficava para sempre e a leitura seguinte conferia pacotes que já não existiam. Agora ele sai junto, e a leitura confere só o que ainda existe.
09/11/2026 · updated
- 1.6.9
Correção na leitura em modo pacote. Quando o serviço de origem falhava por um instante ao informar sua estrutura (por exemplo, uma queda de rede), a leitura era recusada como se faltasse configuração. Agora ela tenta de novo sozinha, como já acontecia no modo mensagens. Se o serviço recusar o acesso de vez, a mensagem diz isso com clareza, em vez de culpar a chave da entidade.
09/11/2026 · updated
- 1.6.8
Correção no pacote em que alguns documentos esperam outra integração. Quando o pacote separado para esperar ficava livre só em parte e se dividia de novo, ele podia ser enviado duas vezes, com o mesmo conteúdo, em dois lotes seguidos. Agora ele sai uma vez só, e o documento que ainda espera continua no seu próprio pacote até poder sair.
09/11/2026 · updated
- 1.6.7
Correção no pacote que sai em partes depois de ter documentos separados por retenção. Antes, um documento cortado entre duas partes podia ser dado como "versão mais antiga" dele mesmo: a parte ficava parada com erro e o destino não recebia os registros dela. Agora as partes de um mesmo pacote nunca se bloqueiam pelo mesmo documento; uma versão mais nova de verdade continua impedindo a mais antiga de chegar depois.
09/11/2026 · updated
- 1.6.5
Os relatórios do modo pacote ficaram bem mais baratos de manter, com os mesmos números. A parte de cada pacote nos relatórios de negócio passou a ser guardada de forma compacta (uma linha por gravação, não uma por produto), e o reprocesso grava só o que mudou: reprocessar um pacote com o mesmo conteúdo não regrava nada. Num teste com o volume da rodada de 06/11, a escrita no banco caiu cerca de 70% e o tempo cerca de 27%. Pacote grande projetado em etapas agora entra nos relatórios de uma vez, no fim: enquanto isso, a tela mostra a projeção anterior e conta o pacote como pendente, em vez de mostrá-lo pela metade.
09/11/2026 · updated
- 1.6.1
Correção na retenção por documento do modo pacote. Um pacote decidido quando todos os documentos esperavam outra interface ficava retido inteiro e continuava assim mesmo depois que a maior parte do que ele esperava foi confirmada: os documentos já livres ficavam presos com os poucos que ainda esperavam, e quem dependia deles esperava em cascata. Agora, quando parte do que o pacote espera é confirmada, ele é decidido de novo e se divide: os documentos livres seguem e os que ainda esperam vão para um pacote à parte. Os pacotes que já estavam presos assim saem sozinhos na próxima varredura das retidas. Nenhum documento se perde nem sai duas vezes, e a ordem de cada documento é mantida.
09/11/2026 · updated
- 1.3.1
Correção: no modo pacote, um documento já enviado não sai de novo no pacote seguinte quando a leitura do S/4 (OData V2, data e hora com fração além do milissegundo) precisa reler os documentos do mesmo milissegundo. Antes, o último documento de um pacote podia voltar como o primeiro do seguinte. O documento alterado na origem continua saindo de novo, como sempre. O modo mensagens não muda.
09/11/2026 · updated
- 1.6.0
Leitura mais rápida quando várias interfaces leem do mesmo SAP: até aqui elas liam uma de cada vez, e na rodada de 06/11 a espera pela vez somou 41% do tempo de leitura do cadastro de produto. Agora o mesmo servidor aceita duas leituras ao mesmo tempo por padrão (de 1 a 4, no avançado da leitura OData da integração), e a espera pela vez deixa de ser confundida com lentidão da origem pelo ajuste automático do tamanho da página. No modo pacote, a leitura também deixa de baixar de novo o pacote que acabou de gravar para pô-lo na fila (cerca de 1 s por pacote).
09/11/2026 · updated
- 1.5.0
Modo pacote: o pacote passa a se encher até o teto (5.000 documentos ou 4 MB, o que fechar primeiro). Antes ele era feito de páginas inteiras da leitura, e como a página é medida em bytes (cerca de 3 MB) contra um pacote de 4 MB, cada página virava um pacote: no cadastro de produto da JAU, com cerca de 46 KB por documento, os pacotes saíam com ~62 documentos quando cabiam ~86. Agora a página que não cabe inteira é dividida entre dois pacotes; com os dados reais da rodada de 06/11 o Produto passa de 544 para 391 pacotes. A retomada depois de uma queda continua sem perder nem repetir documento, inclusive o começo de página que já saiu no pacote anterior. Vale para OData (com e sem parâmetros) e REST. O tamanho configurado não é mais arredondado para páginas inteiras.
09/11/2026 · updated
- 1.3.0
No modo pacote, os lotes da conexão passam a sair em paralelo, com o mesmo número automático do modo mensagens (até quatro ao mesmo tempo). Pacotes com documentos diferentes saem juntos; as versões e as partes de um mesmo documento continuam saindo na ordem, também durante reenvios e depois de o destino ficar fora do ar. O mesmo documento é reconhecido pela mesma regra do modo mensagens: a chave de negócio da duplicata, o identificador na base de conhecimento ou o número do documento; quando a chave de algum documento não pode ser lida, o pacote sai um por vez. As partes de um pacote dividido pelo tamanho máximo do corpo saem em paralelo quando não dividem nenhum documento. A interface com Ordem de chegada continua com um lote por vez.
09/11/2026 · updated
- 1.2.0
Conexão de destino com tamanho máximo do corpo (opcional, em bytes), em REST, Webhook, SOAP, AS2, OData e Kafka. O destino real recusa corpo acima do limite dele (erro 413); com o campo preenchido, o corpo mapeado que passa do limite é dividido em várias mensagens irmãs, cada uma dentro do limite e medida no corpo real que vai ao destino (JSON, XML, IDoc, EDIFACT ou X12), sem irmã a mais. A parte que esperava a tabela de referência é medida de novo quando sai e se divide se precisar. O registro que sozinho passa do limite falha com o motivo claro na mensagem, sem tentar de novo. No envio em lote, o lote fecha antes da mensagem que faria o corpo do POST passar do limite; o lote já montado que passa e que nunca saiu é desfeito e remontado dentro do limite; o que pode ter chegado ao destino vai para conferência, nunca remontado (não duplica).
29/10/2026 · updated
- 1.1.0
Modo pacote: a página da leitura maior que o pacote (por exemplo $top de 30.000 com pacote de 10.000) deixa de ser recusada ou de exigir ajuste manual: o Lefia a divide sozinho em vários pacotes (cada um dentro do teto de documentos e de bytes) e a posição de leitura só avança depois de todos gravados; a retomada depois de uma queda no meio da página não repete pacote já gravado. O teto de documentos por execução vale inteiro (não encolhe a cada pacote), o que tirava a execução em erro de configuração e a deixava lendo poucas dezenas de documentos por vez. O padrão do pacote passa a ser 5.000 documentos ou 4 MB, o que fechar primeiro.
29/10/2026 · updated
- 1.0.0
Modo pacote por interface. No bloco de execução da integração dá para escolher gravar o que se lê como mensagens (o de sempre, um documento por mensagem) ou como pacotes: as páginas lidas viram uma mensagem com vários documentos, mapeada e entregue de uma vez, até o "Tamanho do pacote" escolhido (desde a 1.5.0 o pacote se enche até o teto, dividindo a página que não cabe; a tela mostra o tamanho efetivo). Vale para leituras incrementais por cursor de OData e REST/HTTP. No destino, JSON e XML recebem a lista; EDIFACT, X12 e IDoc recebem vários documentos no mesmo intercâmbio. Um documento com erro não derruba o pacote: fica de fora, os outros seguem, e no detalhe da mensagem dá para reenviar só os com erro. Relatórios, consolidados, a cobrança por documento e a tela de execuções contam os documentos de cada pacote. O pacote é a unidade, como no SAP PI/PO e no CPI: não há busca nem evidência por documento, e a duplicata vale só dentro do pacote.
22/10/2026 · new