TF Fiscal
Documentação

NFC-e offline

Operação e recursos avançados

Operação e recursos avançados do SDK embarcado: cancelamento, cancelamento por substituição, consulta e reimpressão do cupom, obtenção do XML, exportação mensal de XML para o contador, backup e recuperação de computador com defeito, fechar e reiniciar, com exemplos em Java.

Esta página trata das operações do SDK que o PDV usa no dia a dia depois de entrar em produção: cancelamento, cancelamento por substituição, consulta e reimpressão do cupom, obtenção e exportação mensal do XML, backup e recuperação de computador com defeito, fechar e reiniciar. Ao terminar, você saberá tratar cancelamentos e a conferência com o contador e preservar as notas offline quando o computador tiver problema. Pré-requisito: pareamento e emissão já funcionando conforme o tutorial do SDK embarcado; no modo principal e secundário, backup, exportação e métodos semelhantes só existem no principal, veja O que o secundário pode fazer.

1 Cancelamento

Cancelar(id, motivo) cancela uma nota, motivo de 15 a 255 caracteres. O retorno diz até onde o pedido de cancelamento chegou:

RetornoSignificado
SolicitadoEnviado à plataforma
AgendadoNota offline já transmitida e ainda não autorizada; o cancelamento é disparado no momento da autorização
EnfileiradoLocalFila local: sem rede, ou a nota offline / substituta ainda não foi transmitida; enviado na mesma rodada logo após a transmissão
  • Resultado final: chega pelos eventos CANCELAMENTO_CONCLUIDO / CANCELAMENTO_REJEITADO; recusado, a nota continua válida, veja Receber os resultados.
  • Prazo: o prazo de cancelamento é o mesmo da nuvem, veja Cancelar NFC-e. Como fica suspenso o cancelamento de nota offline antes da autorização, veja Notas offline e transmissão.
  • Não pode cancelar: já cancelada ou com cancelamento em andamento devolve 10029822; não tente de novo.
  • Substituída por nota offline: quando uma nota emitida online vai ser substituída por uma nota offline emitida depois neste computador, use o cancelamento por substituição.

O código de exemplo do cancelamento está junto com a consulta e a reimpressão, no Executar da seção 3.

2 Cancelamento por substituição

Quando usar: uma venda já teve a nota emitida online (nota original) e depois, com este computador sem rede, foi emitida para a mesma venda uma nota de contingência offline (nota substituta); por exemplo, o consumidor pediu a nota de novo com CPF bem quando a rede caiu. A nota original é cancelada por substituição, indicando a nota offline que a substitui. Para o cancelamento comum, veja a seção 1.

Chame CancelarPorSubstituicao(id da original, chave da substituta, motivo), motivo de 15 a 255 caracteres. Requisitos:

  • Nota original: nota normal emitida online neste computador e encaminhada pela plataforma. Se a original for offline, já estiver cancelada ou tiver cancelamento em andamento, devolve 10029822.
  • Nota substituta: nota de contingência offline emitida depois neste computador, para a mesma empresa; informe a chave de acesso de 44 dígitos (o Chave do resultado da emissão). Chave com formato inválido, que não seja de NFC-e, com CNPJ diferente da original, igual à chave da original, ou que não seja nota offline deste computador não recusada pela plataforma devolve 10029845.

Como ler o resultado: se a substituta ainda não foi transmitida (ou não há rede), devolve EnfileiradoLocal; o pedido fica na fila do computador e só é enviado sozinho depois que a substituta for transmitida com sucesso. Com a substituta já transmitida e rede disponível, é enviado direto à plataforma. O resultado final sempre chega por evento: CANCELAMENTO_CONCLUIDO indica que a original foi cancelada; CANCELAMENTO_REJEITADO indica recusa, e a original continua válida; trate conforme o motivo do evento. Depois do cancelamento concluído, o XML de cancelamento pode ser lido como na seção 3.

O código abaixo é igual ao cenário 05 do projeto de exemplo: tira a chave do resultado da emissão da nota substituta e pede o cancelamento por substituição da original.

java
import com.tffiscal.nfce.sdk.ResultadoEmissao;
import com.tffiscal.nfce.sdk.Resultados;
import com.tffiscal.nfce.sdk.TfFiscalException;
import com.tffiscal.nfce.sdk.TfFiscalNfce;
public final class NfceSubstituicao {
private NfceSubstituicao() {}
/** Substitui a nota original emitida online pela nota offline substituta emitida depois neste computador; o resultado final chega pelos eventos CANCELAMENTO_*. */
public static Resultados.Cancelamento cancelarOriginal(TfFiscalNfce nfce, String idOriginal, ResultadoEmissao substituta) {
try {
Resultados.Cancelamento c = nfce.cancelarPorSubstituicao(idOriginal, substituta.getChave(),
"Cliente pediu nova nota com CPF", null);
// EnfileiradoLocal: a substituta ainda não foi transmitida; o envio é automático depois da transmissão
System.out.println("Cancelamento por substituicao: " + c.getSituacao());
return c;
} catch (TfFiscalException e) {
// 10029822: a original não é uma nota normal emitida online; 10029845: chave da substituta inválida ou não é nota offline deste computador
System.out.println("Erro " + e.getCodigo() + " " + e.getTipo() + ": " + e.getMessage());
return null;
}
}
}

3 Consultar, reimprimir o cupom e obter o XML

  • Consultar: Consultar(id) devolve o registro local, inclusive de nota offline ainda não transmitida; traz a requisição original Pedido, Transmitida, XmlAutorizadoDisponivel etc.
  • Reimprimir: chame Cupom de novo com o mesmo id.
  • XML autorizado e XML de cancelamento: XmlAutorizado(id) lê o XML autorizado e XmlCancelamento(id) lê o XML de cancelamento depois que o cancelamento foi concluído. Depois da autorização ou do cancelamento, o SDK baixa o XML para o computador sozinho e o guarda por RetencaoXmlDias dias (padrão 90, veja Proxy e dias de retenção do XML). Se não estiver no computador (download ainda não concluído, ou apagado ao fim da retenção), busca na plataforma na hora, de forma síncrona: cada busca do núcleo leva no máximo 30 segundos, e uma chamada do SDK espera no máximo cerca de 120 segundos.

Não chame XmlAutorizado / XmlCancelamento na thread da interface, senão a tela do caixa trava durante a busca na plataforma. Se não conseguir, lança 10029841 (XML autorizado) ou 10029843 (XML de cancelamento): se a nota ainda não foi autorizada ou o cancelamento ainda não foi concluído, espere o evento NOTA_AUTORIZADA ou CANCELAMENTO_CONCLUIDO e leia depois; se já está autorizada e mesmo assim falha, a plataforma ainda não arquivou ou está inacessível no momento; tente mais tarde.

O código abaixo é igual ao cenário 04 do projeto de exemplo: consultar, reimprimir, cancelar e listar as notas do dia acontecem no computador e são chamados direto; a leitura do XML vai para uma thread de segundo plano.

java
import com.tffiscal.nfce.sdk.FormatoCupom;
import com.tffiscal.nfce.sdk.Resultados;
import com.tffiscal.nfce.sdk.SituacaoNota;
import com.tffiscal.nfce.sdk.TfFiscalNfce;
import java.io.IOException;
import java.io.UncheckedIOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.time.LocalDate;
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
public final class NfceOperacoes {
/** Thread de segundo plano só para ler XML: se não estiver no computador, busca na plataforma, em até cerca de 120 segundos; não pode ocupar a thread da interface. */
private static final ExecutorService XML = Executors.newSingleThreadExecutor(r -> {
Thread t = new Thread(r, "nfce-xml");
t.setDaemon(true);
return t;
});
private NfceOperacoes() {}
/** Consulta, reimprime o cupom, cancela e lista as notas do dia; tudo acontece no computador e pode ser chamado na thread da interface. */
public static void executar(TfFiscalNfce nfce, String id) {
SituacaoNota situacao = nfce.consultar(id);
System.out.println("Consultar: " + situacao.getStatus() + ", transmitida " + situacao.isTransmitida()
+ ", XML autorizado disponivel " + situacao.isXmlAutorizadoDisponivel());
// Reimpressão do cupom: peça de novo para o mesmo id
byte[] cupom = nfce.cupom(id, FormatoCupom.ESCPOS_80);
System.out.println("Cupom: " + cupom.length + " bytes");
// Cancelamento: o resultado final chega pelos eventos CANCELAMENTO_CONCLUIDO / CANCELAMENTO_REJEITADO
Resultados.Cancelamento c = nfce.cancelar(id, "Cliente desistiu da compra", null);
System.out.println("Cancelar: " + c.getSituacao() + (c.getMotivo() == null ? "" : " - " + c.getMotivo()));
// Notas locais do dia (página 1, 50 por página)
Resultados.PaginaNotas pagina = nfce.listarNotas(LocalDate.now(), null, 1, null);
System.out.println("Notas de hoje: " + pagina.getItens().size() + (pagina.isTemMais() ? " ou mais" : ""));
}
/** Lê o XML autorizado numa thread de segundo plano e salva uma cópia; o XML autorizado é o documento legal, e o PDV pode guardar uma cópia se precisar. */
public static CompletableFuture<Path> salvarXmlAutorizado(TfFiscalNfce nfce, String id, String chave, Path pasta) {
return CompletableFuture.supplyAsync(
() -> gravar(pasta.resolve("nfe-" + chave + ".xml"), nfce.xmlAutorizado(id, null)), XML);
}
/** Lê o XML de cancelamento numa thread de segundo plano e salva uma cópia; chame depois de receber CANCELAMENTO_CONCLUIDO. */
public static CompletableFuture<Path> salvarXmlCancelamento(TfFiscalNfce nfce, String id, String chave, Path pasta) {
return CompletableFuture.supplyAsync(
() -> gravar(pasta.resolve(chave + "-can.xml"), nfce.xmlCancelamento(id, null)), XML);
}
private static Path gravar(Path arquivo, byte[] conteudo) {
try {
Files.write(arquivo, conteudo);
return arquivo;
} catch (IOException e) {
throw new UncheckedIOException(e);
}
}
}

Na interface, chame assim para ler o XML autorizado; capture 10029841 e tente de novo mais tarde. O callback do resultado roda numa thread de segundo plano; na interface Swing, volte à thread da interface com SwingUtilities.invokeLater antes de atualizar.

java
NfceOperacoes.salvarXmlAutorizado(nfce, id, chave, pastaXml).whenComplete((arquivo, erro) -> {
if (erro == null) {
System.out.println("XML salvo em " + arquivo);
} else if (erro.getCause() instanceof TfFiscalException
&& ((TfFiscalException) erro.getCause()).getCodigo() == 10029841) {
// Ainda não autorizada, ou não está no computador e a plataforma não arquivou / está inacessível: tente mais tarde
System.out.println(erro.getCause().getMessage());
}
});

4 Exportação mensal de XML para o contador

Quando usar: todo início de mês, entregar ao contador os XML autorizados e de cancelamento do mês anterior. ExportarXmls(data inicial, data final, diretório) exporta as notas deste computador no período pela data de emissão (data local do estado da empresa), incluindo as duas datas.

  • Arquivos: um {chave}-nfe.xml por nota autorizada e, para as canceladas, mais um {chave}-can.xml ({chave} é a chave de acesso de 44 dígitos); arquivos com o mesmo nome no diretório são sobrescritos.
  • Resultado: QuantidadeNotas é o número de notas com pelo menos um arquivo exportado, QuantidadeArquivos é o número de arquivos gravados (uma nota cancelada conta como dois arquivos), Arquivos lista todos os arquivos gravados, Falhas lista as notas do período sem XML (id da nota, chave e motivo). A falta de XML de uma nota não interrompe a exportação.
  • Retenção: XML que não está no computador é buscado primeiro na plataforma; o que mesmo assim não vier entra em Falhas, e o motivo diz se passou da retenção do computador. Prefira um período dentro de RetencaoXmlDias (veja Proxy e dias de retenção do XML); senão, a busca é nota a nota e demora mais. Para notas mais antigas, use a consulta na nuvem.
  • Sem rede: se a plataforma estava inacessível logo antes do início da exportação, ou ficar inacessível pela primeira vez durante ela, as demais notas sem XML não tentam mais a rede e entram direto em Falhas, sem esperar o tempo esgotado de cada uma. Para obter primeiro os arquivos que já estão no computador quando estiver sem rede, ligue a opção de exportar só o local: só os XML já presentes no computador são exportados, sem nenhum acesso à rede, e as notas faltantes também entram em Falhas. Use a sobrecarga de cinco parâmetros exportarXmls(de, ate, diretorio, true, empresaId).
  • Duração: pode buscar nota a nota na plataforma; o SDK espera no máximo 30 minutos. Chame numa thread de segundo plano, não espere na thread da interface. Ao estourar a espera (10029833), o runtime pode ainda estar gravando arquivos: não repita logo no mesmo diretório; espere um pouco e exporte de novo para um diretório novo.
  • Erros comuns: data ausente ou com formato inválido devolve 10029874; diretório sem permissão de gravação devolve 10029844.

O código abaixo exporta, numa thread de segundo plano, os XML autorizados e de cancelamento do mês anterior e depois lista o resultado e as notas sem XML:

java
import com.tffiscal.nfce.sdk.Resultados;
import com.tffiscal.nfce.sdk.TfFiscalNfce;
import java.nio.file.Path;
import java.time.LocalDate;
import java.util.Map;
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.Executor;
public final class NfceContador {
private NfceContador() {}
/** Exporta numa thread de segundo plano os XML autorizados e de cancelamento do mês anterior; executor é o pool de threads de segundo plano do próprio PDV. */
public static CompletableFuture<Resultados.ExportacaoXml> exportarMesAnterior(TfFiscalNfce nfce, Path pasta, Executor executor) {
LocalDate primeiroDoMes = LocalDate.now().withDayOfMonth(1);
LocalDate de = primeiroDoMes.minusMonths(1);
LocalDate ate = primeiroDoMes.minusDays(1);
return CompletableFuture.supplyAsync(() -> nfce.exportarXmls(de, ate, pasta, null), executor);
}
/** Lista o resultado depois da exportação; notas sem XML precisam de tratamento à parte. */
public static void mostrar(Resultados.ExportacaoXml r) {
System.out.println("XML exportados: " + r.getQuantidadeNotas() + " notas, " + r.getQuantidadeArquivos()
+ " arquivos, falhas " + r.getFalhas().size());
for (Map<String, Object> falha : r.getFalhas()) {
System.out.println(" " + falha.get("id") + " " + falha.get("chave") + ": " + falha.get("motivo"));
}
}
}

5 Backup e recuperação de computador com defeito

Antes da transmissão, o diretório de dados deste computador guarda o único original legal das notas offline. No dia a dia são duas tarefas: fazer backup criptografado periódico e deixar a equipe da loja saber que caminho seguir quando o computador tiver problema.

Backup periódico

Backup(arquivo de destino, senha) criptografa a base local inteira num único arquivo de backup, e a emissão pode continuar enquanto isso.

  • Senha: pelo menos 8 caracteres; abaixo disso, devolve 10029817, e vazia devolve 10029874. A chave é derivada da senha com PBKDF2-SHA256, e a base inteira é criptografada com AES-256-GCM; nem o SDK nem a plataforma guardam a senha: sem a senha, o backup não pode ser restaurado. Guarde-a separada do arquivo de backup. Não escreva a senha no programa nem em parâmetros de linha de comando; o código de exemplo desta seção, assim como o cenário 05 do projeto de exemplo, lê a senha da variável de ambiente TFFISCAL_BACKUP_SENHA.
  • Arquivo: se o arquivo de destino já existir, devolve 10029844; por isso coloque a hora no nome do arquivo. Uma falha durante a gravação não deixa arquivo incompleto.
  • Resultado: Arquivo (caminho do arquivo), Bytes (tamanho), VersaoBanco (versão da estrutura da base local) e Sha256 (resumo do arquivo).
  • Onde restaurar: a chave do dispositivo no backup é protegida pela proteção de dados do Windows: só pode ser restaurado no mesmo computador e com o mesmo usuário do Windows que geraram o backup. Para trocar de computador o backup não serve; é obrigatório parear de novo.

Qual caminho seguir quando o computador falha

SituaçãoCaminho
O computador vai ser trocado ou não tem conserto, e não dá tempo de transmitir as notas offline neste computadorCaminho 1: exportar o pacote de pendentes e entregar à plataforma
A base local se perdeu ou se corrompeu no mesmo computador, e há um backup criptografado deste computadorCaminho 2: restaurar o backup neste computador

Caminho 1: computador com defeito antes da transmissão. Se o computador ainda liga mas não consegue mais transmitir pela rede (por exemplo, precisa ser trocado na hora), use ExportarPendentes(diretório) para exportar todas as notas offline assinadas e ainda não transmitidas e entregar à plataforma, que transmite em nome da loja:

  1. Chame ExportarPendentes depois de Iniciar normalmente. Ele só exporta e não muda o estado do computador, e as notas continuam na fila de transmissão do computador. Cada chamada cria, no diretório de destino, um subdiretório com o nome do momento da exportação (UTC), dividido em diretórios por dispositivo, com até 500 notas por pacote:

    text
    {diretorio}/pendentes-20261111-150000/{dispositivoId}/pacote-001/manifesto.json
    /pacote-001/{chave}.xml
    /pacote-002/…

    {diretorio} é o diretório de destino informado, {dispositivoId} é o identificador do dispositivo e {chave} é a chave de acesso de 44 dígitos.

  2. Cada manifesto manifesto.json registra o dispositivo a que pertence, e cada nota fica no manifesto junto com o XML assinado, podendo ser entregue direto à plataforma para importação; o {chave}.xml no mesmo diretório é o mesmo XML assinado, para conferência manual. Manifestos no resultado lista todos os manifestos; sem notas pendentes, Quantidade é 0 e Manifestos vem vazio, e não é preciso entregar nada à plataforma.

  3. Compacte num único zip o subdiretório pendentes-… inteiro desta exportação e entregue à operação da plataforma, que o envia direto em «Importar pacote de pendentes», sem descompactar nem separar por pacote ou por dispositivo. Com várias empresas pareadas no computador, o zip tem vários diretórios de dispositivo; a operação filtra por dispositivo e envia em lotes.

  4. Desative este dispositivo antigo na plataforma e gere um novo código de pareamento para parear o computador novo. Não copie o diretório de dados para o computador novo (10029827).

Diretório sem permissão de gravação devolve 10029844. Se o computador não liga mais, fale com a plataforma.

Caminho 2: há backup criptografado. Se no mesmo computador o disco foi trocado ou a base local se corrompeu ou foi apagada por engano, RestaurarBackup(configuração, arquivo de backup, senha) a substitui pela base do backup:

  1. Antes, salve as notas offline emitidas depois do backup, que não estão nele: se a base antiga ainda dá partida, chame Iniciar normalmente, exporte o pacote de pendentes como no caminho 1 e entregue à plataforma, e depois chame Encerrar.
  2. RestaurarBackup é um método estático, chamado antes de Iniciar: não inicia o motor nem acessa a rede, e usa a mesma configuração de Iniciar. Se ainda houver um motor rodando sobre o diretório de dados (inclusive uma instância deste programa em que não se chamou Encerrar), devolve 10029828; chame Encerrar e depois restaure.
  3. Senha errada ou arquivo de backup alterado ou corrompido devolvem 10029846, sem distinguir os dois casos; backup gerado por uma versão mais nova do SDK devolve 10029842. Em caso de falha, a base original fica intacta.
  4. Com sucesso, a base original é guardada no diretório de dados, num arquivo cujo nome começa com nfce.db.antes-restauracao-, e CopiaAnterior no resultado traz o caminho (vazio quando não havia base); VersaoBanco é a versão da estrutura da base restaurada e, se for inferior à do SDK atual, é atualizada automaticamente na próxima partida.
  5. Depois, chame Iniciar normalmente. A numeração e a licença do backup param no momento do backup; por isso, cada empresa primeiro passa por um realinhamento: a emissão offline fica suspensa (devolve 10029811) e a emissão online sincroniza uma vez com a plataforma antes de pegar um número. Quando chega uma nova licença, a numeração da série do dispositivo pula 50 números para a frente, um único salto compartilhado pelas notas online e offline; os números pulados são inutilizados automaticamente junto à plataforma (o resultado chega pelo evento NUMERO_INUTILIZADO) e depois a emissão online e offline segue normal. Assim não há números repetidos, mesmo que notas emitidas depois do backup já tenham sido entregues ao consumidor. Até o realinhamento terminar não dá para emitir sem alcançar a plataforma; depois de restaurar, conecte à rede o quanto antes e chame SincronizarAgora para começar a sincronização na hora.

Chamar em uma thread de segundo plano

Backup, RestaurarBackup e ExportarPendentes leem e gravam muitos arquivos, e o SDK espera no máximo 30 minutos; em programas com interface, chame numa thread de segundo plano, como na seção 3. Ao estourar a espera (10029833), o runtime pode ainda estar gravando arquivos: não repita logo com o mesmo arquivo ou diretório; espere um pouco e use um nome de arquivo ou diretório novo.

O código abaixo mostra, em sequência, o backup periódico, a exportação do pacote de pendentes do caminho 1 e a restauração do backup do caminho 2, seguida da partida e da sincronização imediata:

java
import com.tffiscal.nfce.sdk.Configuracao;
import com.tffiscal.nfce.sdk.Resultados;
import com.tffiscal.nfce.sdk.TfFiscalException;
import com.tffiscal.nfce.sdk.TfFiscalNfce;
import java.nio.file.Path;
public final class NfceContingencia {
private NfceContingencia() {}
/** A senha do backup é lida da variável de ambiente, sem ficar escrita no programa nem na linha de comando. */
public static String senhaBackup() {
String senha = System.getenv("TFFISCAL_BACKUP_SENHA");
if (senha == null || senha.isEmpty()) {
throw new IllegalStateException("Defina TFFISCAL_BACKUP_SENHA (minimo 8 caracteres)");
}
return senha;
}
/** Backup criptografado periódico da base local; arquivo de destino já existente é recusado (10029844), por isso o nome leva a hora. Chame numa thread de segundo plano. */
public static Resultados.Backup backup(TfFiscalNfce nfce, Path pasta) {
Resultados.Backup bak = nfce.backup(pasta.resolve("caixa-" + System.currentTimeMillis() + ".bak"), senhaBackup());
System.out.println("Backup: " + bak.getArquivo() + " (" + bak.getBytes() + " bytes, sha256 " + bak.getSha256() + ")");
return bak;
}
/** Caminho 1: exporta as notas offline assinadas e não transmitidas; compacte num zip o diretório pendentes-… inteiro desta exportação e entregue à plataforma. Chame numa thread de segundo plano. */
public static void exportarPendentes(TfFiscalNfce nfce, Path pasta) {
Resultados.ExportacaoPendentes pend = nfce.exportarPendentes(pasta);
System.out.println("Pendentes exportados: " + pend.getQuantidade());
for (String manifesto : pend.getManifestos()) {
System.out.println(" manifesto " + manifesto);
}
}
/** Caminho 2: restaura a partir do backup criptografado antes de iniciar, depois dá partida e sincroniza na hora. Chame numa thread de segundo plano. */
public static TfFiscalNfce restaurarEIniciar(Configuracao config, Path arquivoBackup) {
try {
Resultados.Restauracao r = TfFiscalNfce.restaurarBackup(config, arquivoBackup, senhaBackup());
System.out.println("Backup restaurado: versao do banco " + r.getVersaoBanco() + ", copia anterior " + r.getCopiaAnterior());
} catch (TfFiscalException e) {
if (e.getCodigo() == 10029846) {
// Senha errada ou arquivo de backup corrompido; a base original não foi alterada
System.out.println("Senha incorreta ou backup corrompido");
}
throw e;
}
TfFiscalNfce nfce = TfFiscalNfce.iniciar(config);
// A emissão offline fica suspensa até obter nova licença; sincroniza uma rodada na hora
nfce.sincronizarAgora();
return nfce;
}
}

6 Fechar e reiniciar

  • Fechar: antes de sair, chame Encerrar (equivale a close). Ele espera a emissão em andamento terminar e então fecha, em no máximo cerca de 15 segundos; não force o fim do processo. Fechado, não há transmissão.
  • Reiniciar: chame Iniciar normalmente; não precisa parear de novo. Na inicialização o núcleo sincroniza uma rodada; se ainda houver notas a transmitir ou eventos não confirmados, chega PENDENCIAS_NA_INICIALIZACAO, e os eventos não confirmados são reenviados em seguida.
  • Depois de uma queda: as notas emitidas estão todas no diretório de dados. Na dúvida se uma venda foi emitida, chame Consultar ou reenvie Emitir com o mesmo id; não sai nota repetida.
  • Runtime terminou inesperadamente: o SDK reinicia sozinho (eventos RUNTIME_FALHOU e RUNTIME_REINICIADO); chamadas em andamento falham com 10029832 e basta repetir com o mesmo id.
  • Atualização e downgrade: ao atualizar o PDV, atualize o SDK e o runtime juntos; o diretório de dados fica como está. Se uma versão antiga for reinstalada, a base local mais nova que o programa recusa a partida (10029842); basta voltar a uma versão não inferior à última usada, sem apagar o diretório de dados.