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:
| Retorno | Significado |
|---|---|
Solicitado | Enviada a la plataforma |
Agendado | Nota offline ya transmitida y aún sin autorizar; se cancela en el momento de la autorización |
EnfileiradoLocal | Cola 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 (
Chavedel 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, devuelve10029845.
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.
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 éxitoSystem.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 computadoraSystem.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 originalPedido,Transmitida,XmlAutorizadoDisponivel, etc. - Reimprimir el cupón: llame
Cupomotra vez con el mismoid. - XML autorizado y XML de cancelación:
XmlAutorizado(id)obtiene el XML autorizado yXmlCancelamento(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 guardaRetencaoXmlDiasdí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.
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 idbyte[] 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_REJEITADOResultados.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.
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 tardeSystem.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.xmlpor 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:
QuantidadeNotases la cantidad de notas con al menos un archivo exportado,QuantidadeArquivoses la cantidad de archivos escritos (una nota cancelada cuenta como dos archivos),Arquivoslista todos los archivos escritos yFalhaslista 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 deRetencaoXmlDias(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 aFalhas. Use la sobrecarga de cinco parámetrosexportarXmls(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 devuelve10029844.
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:
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
10029817y, 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 entornoTFFISCAL_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) ySha256(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ón | Vía a seguir |
|---|---|
| Hay que reemplazar la computadora o no tiene arreglo, y las notas offline no alcanzan a transmitirse desde ella | Ví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 computadora | Ví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:
-
Después de
Iniciarcomo siempre, llameExportarPendentes. 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. -
Cada manifiesto
manifesto.jsonregistra 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}.xmldel mismo directorio es el mismo XML firmado, para consulta manual.Manifestosdel resultado lista todos los manifiestos; si no hay notas pendientes de transmisión,Quantidadees 0 yManifestosestá vacío, y no hace falta entregar nada a la plataforma. -
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. -
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:
- 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
Iniciarcomo siempre, exporte el paquete de pendientes según la vía 1 y entréguelo a la plataforma, y luego llameEncerrar. RestaurarBackupes un método estático y se llama antes deIniciar: no inicia el motor ni se conecta a la red, y usa la misma configuración queIniciar. 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), devuelve10029828; llameEncerrary luego restaure.- 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 devuelve10029842. Si falla, la base original queda intacta. - Si tiene éxito, la base original se guarda aparte en el directorio de datos, con un nombre que empieza por
nfce.db.antes-restauracao-, yCopiaAnteriordel resultado da la ruta (vacío si antes no había base);VersaoBancoes 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. - Después llame
Iniciarcomo 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 (devuelve10029811) 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 llameSincronizarAgorapara 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:
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 inmediatonfce.sincronizarAgora();return nfce;}}
6 Cierre y reinicio
- Cierre: antes de salir llame
Encerrar(equivale aclose). 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
Iniciarcomo siempre, sin volver a emparejar. Al arrancar el núcleo sincroniza enseguida; si aún hay notas por transmitir o eventos sin confirmar, llegaPENDENCIAS_NA_INICIALIZACAOy 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
Consultaro reenvíeEmitircon el mismoid; no se emite otra nota. - Caída del runtime: el SDK lo reinicia solo (eventos
RUNTIME_FALHOUyRUNTIME_REINICIADO); las llamadas en curso fallan con10029832; reintente con el mismoid. - 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.
