A política de ciclo de vida vale a partir da versão 2.62.0.0, cuja data de liberação ainda será definida. Ver a política de ciclo de vida →
Qual versão você tem?
Digite a versão que você tem instalada, por exemplo 2.61.0.0: informamos o que há de novo e até quando ela tem suporte.
v2.61.1.0
Correção
Versão de melhorias sobre a 2.61.0.0 para Peru, El Salvador, Chile, Guatemala e Paraguai: maior precisão no preço unitário, emissão mais completa de “Otros documentos”, referências e guias, nomes de localização nos documentos de El Salvador, descrições de várias linhas mais fiéis no Chile, um conector da Guatemala mais resiliente e processamento dos eventos de cancelamento do Paraguai.
Destaques
Peru: o preço líquido unitário admite até 10 casas decimais, como a SUNAT permite, e há melhor suporte a guias de remessa, retenções, percepções e baixas por TXT.
El Salvador: são emitidas todas as linhas de “Otros documentos”, as referências são informadas uma única vez e os documentos incluem os nomes de departamento, município e distrito.
Chile: nova opção para unir ao item o texto que segue sua descrição (desativada por padrão).
Guatemala: o conector com o provedor de certificação é mais resiliente: espera cada vez mais entre tentativas se rejeita as credenciais e avisa com um alerta.
Paraguai: os eventos de cancelamento perante a SIFEN são processados.
Esta versão, liberada em outubro de 2026, terá suporte por 6 meses e se sobreporá à 2.62.0.0 quando esta for liberada.
· 14 alterações em 5 áreas
Peru2
Preço líquido unitário com até 10 casas decimais, o máximo que a SUNAT admite.
Melhor suporte a guias de remessa, retenções, percepções e comunicações de baixa por arquivo TXT. Uma guia sem data de início do transporte é emitida sem o período de transporte.
El Salvador4
São emitidas todas as linhas de “Otros documentos” do arquivo TXT.
Documentos com dois ou mais dados de transporte: cada um mantém seus próprios dados.
Documentos com várias referências: o “outro documento” do cabeçalho é informado uma única vez, não importa quantas referências tenha.
Nomes de localização: os documentos enviados à plataforma incluem o nome do departamento, do município e do distrito do emissor e do receptor, além de seus códigos.
Chile2
Descrição de várias linhas com texto posterior: nova caixa de seleção “Conversión multilíneas posterior” no Manager, desativada por padrão. Com a descrição multilinha ativa, o texto sem valor que segue um item se une a esse item, mesmo que a primeira linha do detalhe seja um título sem valor.
Se você não ativar a caixa de seleção, o comportamento é o mesmo de sempre.
Guatemala4
Adendo comercial: o valor “Mercadería” do tipo de adendo gera o adendo, igual ao WMM.
Conector com o provedor de certificação: mais resiliente a rejeições de credenciais ou falhas na entrega do token; espera cada vez mais tempo entre tentativas (5, 15, 30, 60, 120 e 240 minutos), avisa com um alerta e se recupera sozinho ao corrigir as credenciais.
Os documentos com mais de 7 dias em reprocessamento são avisados em um único alerta agrupado.
O certificado emitido é guardado de forma segura antes de ser entregue, para poder recuperá-lo se o salvamento falhar.
Paraguai2
Eventos de cancelamento perante a SIFEN: são processados, e a resposta da autoridade é buscada na pasta onde é guardada.
Se a resposta da autoridade não existir, o evento passa para a pasta de erros com uma mensagem clara.
v2.61.0.0
Versão
Assinatura de documentos renovada e mais robusta, envio à autoridade tributária que se recupera sozinho diante de falhas, avisos de nova versão diretamente no Manager e melhorias de conversão e desempenho.
Destaques
Assinatura digital renovada, com melhor gerenciamento de certificados, também para o Brasil.
O envio à autoridade tributária se recupera sozinho após uma queda ou intermitência (Paraguai e Guatemala), sem reiniciar serviços.
O Manager avisa você das novas versões com uma notificação do Windows, sem depender de outro aplicativo.
Atualizar é mais seguro: a atualização mantém a configuração do Web Service e o Web Service encontra sozinho o que precisa para assinar.
· 31 alterações em 8 áreas
Assinatura e certificados7
Motor de assinatura digital renovado, mais moderno e seguro. Inclui a assinatura de documentos do Brasil.
Carga do certificado mais confiável: melhor seleção da chave e validação do número de série.
Equador: são admitidos arquivos de certificado que contêm vários certificados.
Alertas por e-mail mais confiáveis, com um componente de envio renovado.
Código QR dos documentos: valida-se seu endereço e melhora-se sua geração.
Validações adicionais ao receber documentos por Web Service.
O documento é assinado com um formato padronizado.
Esquemas e validações2
Esquemas de vários países atualizados.
Melhorias na validação dos documentos antes de enviá-los.
Conversão de documentos6
Bolívia: o dado adicional do total do documento agora é mantido.
México: melhorias na conversão de documentos.
Guatemala: os tipos de documento FPEQ, FCAP, RDON e RECI ficam alinhados com o que o esquema da SAT define.
As transformações dos campos do mapeamento são aplicadas em um único momento.
Ao converter com modelo, o documento original recebido é mantido, e um valor padrão foi ajustado.
Panamá: os eventos 98 e 99 não são emitidos pelo xDoc, por isso já não aparecem como opção.
Web Service e atualização3
Os caracteres especiais (acentos e símbolos) são mantidos na conversão por modelo, no envio de arquivos e na carga de folios (CAF).
A atualização mantém a configuração do Web Service ao mudar de versão.
O Web Service encontra sozinho os componentes de assinatura do Panamá, da República Dominicana, do Peru, da Colômbia e da Guatemala: não é preciso copiá-los manualmente.
Envio à autoridade tributária5
Respostas do envio mais claras e envio mais estável.
Se um arquivo da fila já não existe, o envio o ignora e segue com os demais documentos.
Paraguai (SIFEN): as respostas com erro ou em formato inesperado encerram suas conexões com a autoridade tributária. Depois de uma queda, o envio se recupera sozinho, sem reiniciar serviços. A leitura da resposta tem um tempo máximo de espera por tentativa e, no modo por lotes, o ciclo termina ao esgotar as tentativas e passa para o lote seguinte.
Paraguai: a diferença horária configurável admite de -12 a 14 horas.
Guatemala (MegaPrint): os documentos que ficaram pendentes por uma intermitência do certificador são reenviados automaticamente. Se a falha foi de conexão, de tempo de espera ou um erro temporário, tenta-se novamente a cada 5 minutos sem limite de tentativas; um documento inválido ou rejeitado passa para a pasta de erros após 3 tentativas. Só são reenviados documentos com menos de 7 dias, até 20 por ciclo; os mais antigos ficam para revisão manual.
Desempenho1
Os conectores de Excel processam as planilhas com mais rapidez.
Serviço de relatórios (Jasper)4
O serviço encontra o Java sozinho mesmo que a configuração do equipamento esteja incompleta ou incorreta: usa o JDK 17 ou superior instalado no Windows (o de versão mais alta).
Só são aceitos caminhos absolutos de unidades locais; os caminhos relativos e os de rede são descartados.
Quando usa o JDK instalado no Windows, deixa um aviso no registro de eventos da área indicando qual Java escolheu.
Se não encontrar nenhum Java, o erro indica onde procurou.
Notificações do Manager3
O aviso de nova versão e os avisos de conexão com a API são exibidos pelo próprio Manager como uma notificação do Windows, sem depender de um aplicativo externo. Ao clicar na notificação ou no ícone, abre-se a janela de atualização do menu “Actualizar”, centralizada na tela.
Com o Assistente de foco ativado, ou com as notificações desativadas para o aplicativo, o Windows não exibe a notificação e nenhum aviso é recebido; o aviso de nova versão se repete cada vez que o Manager é aberto enquanto houver uma versão pendente. A caixa de seleção “Notificar la pérdida/recuperación de conexión con la API de Gosocket” continua controlando os avisos de conexão.
Enquanto o aviso de nova versão não for atendido, o ícone permanece na área de notificação (“Actualización disponible”); o aviso de conexão remove o ícone após 30 segundos.
v2.60.2.0
Correção
Versão de melhorias sobre a 2.60.1.0 com quatro melhorias: as transformações de campos do mapeamento (por exemplo, formatar uma data) entregam o valor esperado, como na 2.59; a atualização mantém a configuração do Web Service; o Web Service assina sem passos manuais adicionais; e o XML da Guatemala é entregue em uma única linha.
Destaques
As transformações de campos, como formatar uma data, entregam o valor esperado para quem usa a 2.60.0.0 ou a 2.60.1.0.
Ao atualizar, a configuração do Web Service é mantida.
Panamá e Peru assinam por Web Service sem copiar arquivos manualmente.
· 8 alterações em 4 áreas
Mapeamento: as transformações de campo são aplicadas uma única vez3
As transformações de cada campo do mapeamento são aplicadas em um único momento, de modo que, por exemplo, a data 20261204 com transformações para inserir hifens resulta em 2026-12-04. Aplica-se a quem usa as versões 2.60.0.0 ou 2.60.1.0.
Um campo cujo valor no arquivo de entrada contém apenas espaços é tratado como vazio.
Se você usa a 2.60.0.0 ou a 2.60.1.0 e seu mapeamento inclui transformações de campos (por exemplo, datas), recomendamos atualizar para a 2.60.2.0. A 2.59.0.0 entrega o mesmo resultado esperado.
Atualização: a configuração do Web Service é mantida2
O atualizador mantém a configuração do Web Service que a instalação já tem, por exemplo o caminho do Web Service.
Recomendação: antes de atualizar, guardar uma cópia da configuração do Web Service e compará-la depois.
Web Service: assinatura sem passos manuais1
O Web Service encontra sozinho os componentes de assinatura da instalação, igual aos demais serviços. Não é preciso copiá-los manualmente. Testado com Panamá e Peru.
Guatemala: o XML sai em uma única linha2
O modelo unificado da Guatemala entrega o XML em uma única linha, com o mesmo conteúdo, que é o formato esperado pelo certificador.
Se você tem um modelo próprio que gera o XML com recuos, ajuste-o para que saia em uma única linha.
v2.60.1.0
Correção
Versão de melhorias sobre a 2.60.0.0 com duas melhorias: o Web Service explica qual dado falta em uma requisição e o serviço de alertas envia os e-mails com um componente renovado.
Destaques
Se a uma requisição falta um dado, o Web Service informa qual.
Os alertas por e-mail são enviados com um componente de envio renovado.
· 5 alterações em 2 áreas
Web Service: mensagem clara quando falta um dado3
O Web Service verifica os dados obrigatórios antes de processar a requisição e, se faltar algum (por exemplo o tipo de documento ou o conteúdo), responde com uma mensagem clara que indica qual.
Falta o tipo de documento: “Convert: Tipo de documento no especificado.”. Falta o conteúdo ou vem mal formado: “Convert: No se especificó el contenido del documento.”. Uma requisição correta é convertida igual a antes.
Cada requisição deve trazer quatro dados: área, senha, tipo de documento e conteúdo do documento.
Alertas: envio de e-mails com um componente renovado2
A partir da 2.60.1.0, o serviço de alertas monta os e-mails com um componente de e-mail renovado.
Se você usa a 2.59 ou a 2.60.0.0 e quer receber os alertas por e-mail, atualize para a 2.60.1.0, reinicie o serviço de alertas e verifique se o servidor de e-mail (SMTP) da instalação está configurado no xDoc Manager.
As datas correspondem ao pacote de cada versão. Para dúvidas sobre uma instalação específica, entre em contato com o suporte da Gosocket.
