TF Fiscal
Documentación

NFC-e offline

Operación y tareas avanzadas

Operación y tareas avanzadas del SDK embebido: cancelación, cancelación por sustitución, consulta y reimpresión del cupón, obtención del XML, exportación mensual de XML para el contador, copia de seguridad y recuperación de un equipo dañado, cierre y reinicio, con ejemplos en Java.

Esta página trata las operaciones del SDK que el software de caja usa en el día a día después de salir a producción: cancelación, cancelación por sustitución, consulta y reimpresión del cupón, obtención y exportación mensual de XML, copia de seguridad y recuperación de un equipo dañado, cierre y reinicio. Al terminar podrá tratar cancelaciones y conciliaciones, y proteger las notas offline cuando la computadora tenga un problema. Requisitos: haber completado el emparejamiento y poder emitir según el tutorial del SDK embebido; en el modo principal y secundario, la copia de seguridad, las exportaciones y otros métodos solo están disponibles en el principal; vea Qué puede hacer el secundario.

1 Cancelación

Cancelar(id, motivo) cancela una nota, con un motivo de 15 a 255 caracteres. El retorno indica hasta dónde llegó la solicitud de cancelación:

RetornoSignificado
SolicitadoEnviada a la plataforma
AgendadoNota offline ya transmitida y aún sin autorizar; se cancela en el momento de la autorización
EnfileiradoLocalCola local: sin red, o la nota offline / sustituta aún no se transmitió; se envía en la misma ronda justo después de la transmisión
  • Resultado final: llega en los eventos CANCELAMENTO_CONCLUIDO / CANCELAMENTO_REJEITADO; si se rechaza, la nota sigue válida; vea Recibir los resultados.
  • Plazo: el plazo de cancelación es el mismo de la nube; vea Cancelar NFC-e. Cómo queda en espera la cancelación de una nota offline antes de la autorización se explica en Notas offline y transmisión.
  • No se puede cancelar: si ya está cancelada o ya hay una cancelación en curso, devuelve 10029822; no reintente.
  • Sustituida por una nota offline: si una nota emitida en línea debe ser sustituida por una nota offline emitida después en esta computadora, use la cancelación por sustitución.

El código de ejemplo de la cancelación está junto con la consulta y la reimpresión; vea Executar en la sección 3.

2 Cancelación por sustitución

Cuándo usarla: una venta ya tiene una nota emitida en línea (la nota original) y luego, sin red en esta computadora, se emitió para la misma venta una nota de contingencia offline (la nota sustituta); por ejemplo, el consumidor pidió una nota nueva con CPF justo cuando no había red. La nota original se cancela por sustitución, indicando la nota offline que la reemplaza. Para la cancelación común, vea la sección 1.

Llame CancelarPorSubstituicao(id de la nota original, clave de la nota sustituta, motivo), motivo de 15 a 255 caracteres. Requisitos:

  • Nota original: nota normal emitida en línea en esta computadora y enviada por la plataforma. Si la nota original es offline, ya está cancelada o ya tiene una cancelación en curso, devuelve 10029822.
  • Nota sustituta: nota de contingencia offline emitida después en esta computadora para la misma empresa; informe su clave de acceso de 44 dígitos (Chave del resultado de la emisión). Si la clave tiene formato inválido, no es de NFC-e, su CNPJ difiere del de la nota original, es igual a la clave de la nota original, o no es una nota offline de esta computadora no rechazada por la plataforma, devuelve 10029845.

Cómo leer el resultado: si la nota sustituta aún no se transmitió (o no hay red), devuelve EnfileiradoLocal: queda en cola en esta computadora y se envía sola cuando la nota sustituta se transmite con éxito; si la nota sustituta ya se transmitió y hay red, se envía directamente a la plataforma. El resultado final siempre llega por eventos: CANCELAMENTO_CONCLUIDO indica que la nota original quedó cancelada; CANCELAMENTO_REJEITADO indica que se rechazó y la nota original sigue válida; trátelo según el motivo del evento. Tras una cancelación exitosa puede obtener el XML de cancelación; vea la sección 3.

El código siguiente coincide con el escenario 05 de los proyectos de ejemplo: toma la clave del resultado de la emisión de la nota sustituta y solicita la cancelación por sustitución de la nota 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() {}
/** Sustituye la nota original emitida en línea por la nota sustituta offline emitida después en esta computadora; el resultado final llega en los 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: la nota sustituta aún no se transmitió; se envía sola cuando se transmita con éxito
System.out.println("Cancelamento por substituicao: " + c.getSituacao());
return c;
} catch (TfFiscalException e) {
// 10029822: la nota original no es una nota normal emitida en línea; 10029845: clave de la nota sustituta inválida o no es una nota offline de esta computadora
System.out.println("Erro " + e.getCodigo() + " " + e.getTipo() + ": " + e.getMessage());
return null;
}
}
}

3 Consultar, reimprimir el cupón y obtener el XML

  • Consultar: Consultar(id) devuelve el registro local, también de notas offline aún sin transmitir; incluye la solicitud original Pedido, Transmitida, XmlAutorizadoDisponivel, etc.
  • Reimprimir el cupón: llame Cupom otra vez con el mismo id.
  • XML autorizado y XML de cancelación: XmlAutorizado(id) obtiene el XML autorizado y XmlCancelamento(id) el XML de cancelación una vez concluida la cancelación. Tras la autorización o la cancelación el SDK los descarga a esta computadora y los guarda RetencaoXmlDias días (90 por defecto; vea Proxy y días de retención del XML). Si no están en la computadora (aún no se descargaron, o se borraron al vencer el plazo), se descargan de la red de forma síncrona: cada descarga del núcleo dura hasta 30 segundos y una llamada del SDK espera como máximo unos 120 segundos.

No llame XmlAutorizado / XmlCancelamento en el hilo de la interfaz; de lo contrario la pantalla de la caja se congela mientras se descarga. Si no se obtiene, lanza 10029841 (XML autorizado) o 10029843 (XML de cancelación): si la nota aún no se autorizó o la cancelación aún no concluyó, espere el evento NOTA_AUTORIZADA o CANCELAMENTO_CONCLUIDO y pida de nuevo; si ya está autorizada y aun así no se obtiene, la plataforma todavía no la archivó o no está accesible por el momento; reintente más tarde.

El código siguiente coincide con el escenario 04 de los proyectos de ejemplo: consultar, reimprimir, cancelar y listar las notas del día se resuelve en esta computadora y se llama directamente; la obtención del XML va en un hilo de fondo.

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 {
/** Hilo de fondo dedicado a obtener el XML: si no está local se descarga de la red, hasta unos 120 segundos; no debe ocupar el hilo de la interfaz. */
private static final ExecutorService XML = Executors.newSingleThreadExecutor(r -> {
Thread t = new Thread(r, "nfce-xml");
t.setDaemon(true);
return t;
});
private NfceOperacoes() {}
/** Consulta, reimprime el cupón, cancela y lista las notas del día; todo se resuelve en esta computadora y puede llamarse en el hilo de la interfaz. */
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());
// Reimprimir el cupón: pídalo otra vez con el mismo id
byte[] cupom = nfce.cupom(id, FormatoCupom.ESCPOS_80);
System.out.println("Cupom: " + cupom.length + " bytes");
// Cancelar: el resultado final llega en los 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 locales del día (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" : ""));
}
/** Obtiene el XML autorizado en un hilo de fondo y lo guarda aparte; el XML autorizado es el original legal y el software de caja puede guardar una copia si lo necesita. */
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);
}
/** Obtiene el XML de cancelación en un hilo de fondo y lo guarda aparte; llámelo tras recibir 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);
}
}
}

En la interfaz se obtiene el XML autorizado así, capturando 10029841 para reintentar más tarde. El callback del resultado corre en un hilo de fondo; en interfaces Swing hay que volver al hilo de la interfaz con SwingUtilities.invokeLater antes de actualizar.

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) {
// Aún no autorizada, o no está local y la plataforma no la archivó / no está accesible: reintente más tarde
System.out.println(erro.getCause().getMessage());
}
});

4 Exportación mensual de XML para el contador

Cuándo usarla: a principios de cada mes, para entregar al contador los XML autorizados y de cancelación del mes anterior. ExportarXmls(fecha inicial, fecha final, directorio) exporta las notas de esta computadora del período según la fecha de emisión (fecha local del estado de la empresa), con ambas fechas incluidas.

  • Archivos: un {chave}-nfe.xml por cada nota autorizada y, para las notas canceladas, además un {chave}-can.xml ({chave} es la clave de acceso de 44 dígitos); si en el directorio ya existe un archivo con el mismo nombre, se sobrescribe.
  • Resultado: QuantidadeNotas es la cantidad de notas con al menos un archivo exportado, QuantidadeArquivos es la cantidad de archivos escritos (una nota cancelada cuenta como dos archivos), Arquivos lista todos los archivos escritos y Falhas lista las notas del período sin XML (id de la venta, clave y motivo). Que falte el XML de una nota no interrumpe la exportación.
  • Retención: los XML que no están en la computadora se descargan primero de la red; los que aun así no se obtienen van a Falhas, y el motivo indica si ya se superó el plazo de retención local. Conviene que el período exportado quede dentro de RetencaoXmlDias (vea Proxy y días de retención del XML); de lo contrario hay que descargar nota por nota y tarda más; para notas más antiguas use la consulta en la nube.
  • Sin red: si justo antes de empezar la exportación no se llega a la plataforma, o la primera vez que deja de llegar durante la exportación, el resto de las notas sin XML ya no se buscan en la red y van directamente a Falhas, sin esperar el tiempo agotado de cada una. Para obtener primero, sin red, los archivos que ya están en la computadora, active la opción de exportar solo lo local: exporta solo los XML que ya están en la computadora, sin ninguna conexión, y las notas que falten también van a Falhas. Use la sobrecarga de cinco parámetros exportarXmls(de, ate, diretorio, true, empresaId).
  • Duración: puede requerir descargar nota por nota; el SDK espera como máximo 30 minutos. Llámelo en un hilo de fondo; no espere en el hilo de la interfaz. Si la espera se agota (10029833), el runtime puede seguir escribiendo archivos: no reintente enseguida con el mismo directorio; espere un momento y vuelva a exportar a un directorio nuevo.
  • Errores frecuentes: fecha faltante o con formato inválido devuelve 10029874; directorio sin permiso de escritura devuelve 10029844.

El código siguiente exporta en un hilo de fondo los XML autorizados y de cancelación del mes anterior, y luego lista el resultado y las notas sin 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 en un hilo de fondo los XML autorizados y de cancelación del mes anterior; executor es el pool de hilos de fondo del propio software de caja. */
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);
}
/** Muestra el resultado al terminar la exportación; las notas sin XML se tratan aparte. */
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 Copia de seguridad y recuperación de un equipo dañado

Antes de la transmisión, el directorio de datos de esta computadora guarda el único original legal de las notas offline. En el día a día hay que hacer dos cosas: copias de seguridad cifradas periódicas, y que el personal de la tienda sepa qué vía seguir cuando la computadora tiene un problema.

Copias periódicas

Backup(archivo de destino, contraseña) cifra toda la base local en un archivo de copia de seguridad, y se puede seguir emitiendo al mismo tiempo.

  • Contraseña: al menos 8 caracteres; si es más corta devuelve 10029817 y, si está vacía, 10029874. La clave se deriva de la contraseña con PBKDF2-SHA256 y toda la base se cifra con AES-256-GCM; ni el SDK ni la plataforma guardan la contraseña: si se pierde la contraseña, la copia de seguridad no se puede restaurar; guárdela separada del archivo de copia de seguridad. No escriba la contraseña en el programa ni en los parámetros de línea de comandos: el código de ejemplo de esta sección, igual que el escenario 05 del proyecto de ejemplo, la lee de la variable de entorno TFFISCAL_BACKUP_SENHA.
  • Archivo: si el archivo de destino ya existe devuelve 10029844; por eso incluya la hora en el nombre. Una falla durante la escritura no deja un archivo incompleto.
  • Resultado: Arquivo (ruta del archivo), Bytes (tamaño), VersaoBanco (versión de estructura de la base local) y Sha256 (resumen del archivo).
  • Alcance de la restauración: la clave del dispositivo dentro de la copia de seguridad está protegida por la protección de datos de Windows: solo se puede restaurar en la misma computadora y con el mismo usuario de Windows que generaron la copia de seguridad. Al cambiar de computadora la copia de seguridad no sirve: hay que emparejar de nuevo.

Qué camino seguir cuando falla el equipo

SituaciónVía a seguir
Hay que reemplazar la computadora o no tiene arreglo, y las notas offline no alcanzan a transmitirse desde ellaVía 1: exportar el paquete de pendientes y entregarlo a la plataforma
En la misma computadora la base local se perdió o se dañó, y hay una copia de seguridad cifrada de esta computadoraVía 2: restaurar la copia de seguridad en esta computadora

Vía 1: computadora dañada antes de transmitir. Si la computadora todavía enciende pero ya no puede conectarse para transmitir (por ejemplo, hay que reemplazarla de inmediato), exporte con ExportarPendentes(directorio) todas las notas offline firmadas y no transmitidas, y entréguelas a la plataforma para que las transmita en su nombre:

  1. Después de Iniciar como siempre, llame ExportarPendentes. Solo exporta, sin cambiar el estado de la computadora, y esas notas siguen en la cola de transmisión de la computadora. Cada llamada crea en el directorio de destino un subdirectorio nuevo con el nombre del momento de la exportación (UTC), con un directorio por dispositivo y hasta 500 notas por paquete:

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

    {diretorio} es el directorio de destino pasado en la llamada, {dispositivoId} es el identificador del dispositivo y {chave} es la clave de acceso de 44 dígitos.

  2. Cada manifiesto manifesto.json registra el dispositivo al que pertenece e incluye cada nota junto con su XML firmado, y puede entregarse directamente a la plataforma para importarlo; el {chave}.xml del mismo directorio es el mismo XML firmado, para consulta manual. Manifestos del resultado lista todos los manifiestos; si no hay notas pendientes de transmisión, Quantidade es 0 y Manifestos está vacío, y no hace falta entregar nada a la plataforma.

  3. Comprima en un solo zip todo el subdirectorio pendentes-… de esta exportación y entréguelo al equipo de operación de la plataforma, que lo sube directamente en «Importar paquete de pendientes», sin descomprimirlo ni separarlo por paquete o por dispositivo. Si en esta computadora se emparejaron varias empresas, el zip contiene varios directorios de dispositivo; el equipo de operación filtra por dispositivo y los envía por tandas.

  4. Desactive el dispositivo anterior en la plataforma y empareje la computadora nueva con un código de emparejamiento nuevo. No copie el directorio de datos a la computadora nueva (10029827).

Un directorio sin permiso de escritura devuelve 10029844. Si la computadora ya no enciende, contacte a la plataforma.

Vía 2: hay una copia de seguridad cifrada. Si en la misma computadora se cambió el disco, o la base local se dañó o se borró por error, use RestaurarBackup(configuración, archivo de copia de seguridad, contraseña) para volver a la base de la copia de seguridad:

  1. Primero proteja las notas offline emitidas después de la copia de seguridad, que no están en ella: si la base anterior todavía inicia, llame Iniciar como siempre, exporte el paquete de pendientes según la vía 1 y entréguelo a la plataforma, y luego llame Encerrar.
  2. RestaurarBackup es un método estático y se llama antes de Iniciar: no inicia el motor ni se conecta a la red, y usa la misma configuración que Iniciar. Si todavía hay un motor en ejecución sobre el directorio de datos (incluida una instancia de este programa en la que no se llamó Encerrar), devuelve 10029828; llame Encerrar y luego restaure.
  3. Si la contraseña es incorrecta o el archivo de copia de seguridad fue modificado o está dañado devuelve 10029846, sin distinguir entre ambos casos; si la copia de seguridad viene de una versión más nueva del SDK devuelve 10029842. Si falla, la base original queda intacta.
  4. Si tiene éxito, la base original se guarda aparte en el directorio de datos, con un nombre que empieza por nfce.db.antes-restauracao-, y CopiaAnterior del resultado da la ruta (vacío si antes no había base); VersaoBanco es la versión de estructura de la base local restaurada; si es inferior a la del SDK actual, se actualiza sola en el próximo inicio.
  5. Después llame Iniciar como siempre. Los números y las licencias de la copia de seguridad quedaron en el momento de la copia, por eso cada empresa primero pasa por un realineamiento: la emisión offline se suspende (devuelve 10029811) y la emisión en línea se sincroniza una vez con la plataforma antes de tomar un número. Cuando llega una licencia nueva, la numeración de la serie del dispositivo salta 50 números hacia adelante, un único salto compartido por las notas en línea y offline; los números saltados se declaran inutilizados automáticamente ante la plataforma (el resultado llega por el evento NUMERO_INUTILIZADO) y luego la emisión en línea y offline siguen con normalidad. Así no se repiten números aunque las notas emitidas después de la copia de seguridad ya se hayan entregado a los consumidores. Hasta terminar el realineamiento no se puede emitir sin llegar a la plataforma; después de restaurar conéctese cuanto antes y llame SincronizarAgora para iniciar la sincronización de inmediato.

Llamar desde un hilo en segundo plano

Backup, RestaurarBackup y ExportarPendentes leen y escriben muchos archivos; el SDK espera como máximo 30 minutos; en programas con interfaz llámelos en un hilo de fondo, igual que en la sección 3. Si la espera se agota (10029833), el runtime puede seguir escribiendo archivos: no reintente enseguida con el mismo archivo o directorio; espere un momento y use un nombre de archivo o un directorio nuevo.

El código siguiente muestra, en orden, la copia de seguridad periódica, la exportación del paquete de pendientes de la vía 1 y, en la vía 2, la restauración de la copia de seguridad seguida del inicio y la sincronización inmediata:

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() {}
/** La contraseña de la copia de seguridad se lee de una variable de entorno, no se escribe en el programa ni en la línea de comandos. */
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;
}
/** Copia de seguridad cifrada periódica de la base local; si el archivo de destino ya existe, se rechaza (10029844), por eso el nombre lleva la hora. Llámelo en un hilo de fondo. */
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;
}
/** Vía 1: exporta las notas offline firmadas y no transmitidas; comprima en un zip todo el directorio pendentes-… de esta exportación y entréguelo a la plataforma. Llámelo en un hilo de fondo. */
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);
}
}
/** Vía 2: restaura la copia de seguridad cifrada antes de iniciar, luego inicia y sincroniza de inmediato. Llámelo en un hilo de fondo. */
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) {
// Contraseña incorrecta o copia de seguridad dañada; la base original no se modificó
System.out.println("Senha incorreta ou backup corrompido");
}
throw e;
}
TfFiscalNfce nfce = TfFiscalNfce.iniciar(config);
// La emisión offline queda suspendida hasta obtener una licencia nueva; sincroniza de inmediato
nfce.sincronizarAgora();
return nfce;
}
}

6 Cierre y reinicio

  • Cierre: antes de salir llame Encerrar (equivale a close). Espera que terminen las emisiones en curso y luego cierra, como máximo unos 15 segundos; no mate el proceso. Durante el cierre no hay transmisión.
  • Reinicio: llame Iniciar como siempre, sin volver a emparejar. Al arrancar el núcleo sincroniza enseguida; si aún hay notas por transmitir o eventos sin confirmar, llega PENDENCIAS_NA_INICIALIZACAO y los eventos sin confirmar se reenvían después.
  • Tras una caída: todas las notas emitidas están en el directorio de datos. Si no sabe si una venta se emitió, llame Consultar o reenvíe Emitir con el mismo id; no se emite otra nota.
  • Caída del runtime: el SDK lo reinicia solo (eventos RUNTIME_FALHOU y RUNTIME_REINICIADO); las llamadas en curso fallan con 10029832; reintente con el mismo id.
  • Actualización y downgrade: al actualizar el software de caja, actualice el SDK y el runtime juntos; el directorio de datos se conserva tal cual. Si se reinstala una versión anterior, la base local es más nueva que el programa y el inicio se rechaza (10029842): actualice de nuevo a una versión no inferior a la última usada; no borre el directorio de datos.