Catálogo de errores y alertas

📘 Descripción

Este catálogo reúne los errores y alertas que muestran los servicios de xDoc. Sirve para que tu equipo técnico y el Soporte de Gosocket, al ver un error en errTXT, en el Visor de Eventos o en un correo de alerta, sepan qué significa y qué revisar.

Para cada servicio se listan los mensajes más frecuentes, su causa probable y dónde mirar. Los mensajes se copian tal como los muestra xDoc en español. Los textos entre < > se reemplazan por el dato real (archivo, área, instancia, tipo de documento, etc.).

información

Este catálogo no reemplaza la documentación de cada servicio, que tiene su configuración completa.

📍 Dónde aparecen los errores

Cuando un servicio no puede procesar un documento, deja rastro en uno o más de estos lugares. Las carpetas están bajo <instalación>\areas\<área>.

Lugar	Qué contiene	Servicios que lo usan
errTXT de la instancia instances\<instancia>\errTXT	Copia del documento que falló. En Conversión se agrega un XML de detalle con el mismo nombre (por ejemplo, 33_NPG_123.txt y 33_NPG_123.xml) con el código, el tipo, el origen, la fecha y el mensaje del error. En Firmado el detalle queda en <nombre>_sign_error.xml.	Conversión, Firmado, Despacho, Webservice
alerts del área	Archivos alert_<id>.xml pendientes de envío por correo, más una copia del documento o de la respuesta como adjunto. El servicio de Alertas los elimina después de enviarlos.	Todos los que generan alertas (ver Códigos de alerta)
Carpeta toprint del área	Los documentos que no se pudieron imprimir quedan con extensión .err.	Impresión
logs del área	Archivos de texto log*.txt con la traza de conversión: servicio, archivo, fecha, datos del documento y mensaje (OK o el error). Solo se generan si está marcado Generar Trazabilidad de conversión en Configuración → Trazabilidad. Aquí también se guarda una copia del log de eventos cuando se limpia.	Conversión (traza); todos (copia del log de eventos)
Visor de Eventos	Registro principal de errores e información de todos los servicios. Se consulta en xDoc Manager → Visor de Eventos (filtros Servicio: e Instancia:) o en el Visor de Eventos de Windows, en el registro con el nombre del área. El origen de cada evento es Servicio xdoc@<servicio>_<área>, o Servicio xdoc@<servicio>_<área>_<instancia> en los servicios por instancia (Conversión, Firmado, Despacho). El Webservice registra en el registro xdoc@webservice con origen Servicio WebServices_<área>.	Todos
Correo de alerta	Correo enviado por el Servicio de Alertas de xDoc con el Código, Tipo, Origen, Fecha y Hora, Mensaje, Adjunto e Info Adicional de la alerta. Requiere alertas habilitadas, servidor SMTP configurado y destinatarios para el tipo de alerta.	Todos los que generan alertas

🧾 Formato del correo de alerta

Si no se personaliza la plantilla en Configuración → Servicios → Alertas, el correo llega con este formato:

• Asunto: Alerta generada en xDoc para el área: <área>
• Cuerpo: Alerta, Código, Tipo, Fuente, Fecha y Hora, Mensaje, Adjunto e Info Adicional.

El Código identifica qué pasó (ver la tabla siguiente). El Mensaje trae el texto del error. El Adjunto suele ser el documento afectado o la respuesta de la entidad tributaria.

🏷 Códigos de alerta

Cada alerta lleva un código de 6 dígitos. Los 3 primeros dígitos definen el tipo (clasificación). Con ese tipo, el servicio de Alertas elige los destinatarios y la plantilla del correo. Ver Alertas.

Tipos de alerta

Prefijo	Tipo (vista Alertas)	Uso en la versión actual
000	Todas	No es un tipo de error. Los destinatarios de Todas reciben una copia de cualquier alerta.
010	Error de Conversión	Errores de conversión y de validación Schematron (estos últimos, cuando las alertas están habilitadas).
020	Error de firmado	Los servicios estándar no generan alertas con este prefijo. Los errores de firmado llegan con el código 050002.
030	Error de impresión	Errores del servicio de Impresión.
031	Error de despacho	Rechazos de la entidad tributaria y avisos del despacho.
032	Error en webservice	Errores de conversión o de firmado recibidos por Webservice.
040	Disponibilidad, Vencimiento de numeración	Los servicios estándar no generan alertas con este prefijo.
050	Vencimiento de certificado	Certificado por vencer o vencido, y también cualquier error de firmado.
070	Procesamiento de conectores	Errores y avisos de conectores.
080	Pre-procesamiento	Reservado para conectores de pre-procesamiento. Los conectores de xDoc Global no lo usan.
090	Procesamiento finalizado	Reservado para avisos de fin de proceso. Los conectores de xDoc Global no lo usan.

Códigos que generan los servicios

Código	Tipo	Servicio / origen	Significado	Adjunto
010001	Error de Conversión	Conversión xdoc@converter - Error de conversión	El documento no se pudo convertir. El mensaje trae <código>: <descripción> del error.	Archivo de integración (spool)
010099	Error de Conversión	Validación Schematron (Conversión o Firmado) <servicio> - Se detectaron errores durante la validación con Schematron.	El documento no cumple las reglas Schematron configuradas para su tipo. El mensaje lista cada regla incumplida. La alerta se genera cuando las alertas están habilitadas en el área (opción Habilitar alertas).	Sin adjunto
030002	Error de impresión	Impresión xdoc@batchprinter - Error de impresión o - Impresión con XSLT-PCL	El documento no se pudo imprimir (impresión por lote o por XSLT-PCL).	Documento a imprimir
030003	Error de impresión	Impresión xdoc@batchprinter - Impresión de documento	La impresión o la generación del PDF terminó con error.	Documento (.err)
030004	Error de impresión	Impresión xdoc@batchprinter - Tipo de documento no definido	No se pudo identificar el tipo de documento a imprimir.	Documento (.err)
030005	Error de impresión	Impresión xdoc@batchprinter -	Error no previsto durante la impresión.	Documento (.err)
031001	Error de despacho	Despacho xdoc@dispatch, tipo Rechazado por la Entidad Tributaria	La plataforma o la entidad tributaria rechazó el documento. En Info viene el código de rechazo (o [Sin código]).	Respuesta de la entidad o el documento
031001 (Brasil)	Error de despacho	Despacho, tipo El documento superó el tiempo de espera…	El documento no fue autorizado a tiempo y no se envió a impresión.	Respuesta obtenida
031000 a 031003 (Paraguay)	Error de despacho	Despacho SIFEN, origen TaxAuthority	Avisos de SIFEN. Ver Variaciones por país.	Según el caso
032002	Error en webservice	Webservice WebServices Core.asmx - Error de conversión o tipo Firmado	Error de conversión de un documento recibido por Webservice, o certificado vencido al firmar por Webservice.	Documento o certificado
050002	Vencimiento de certificado	Firmado xdoc@batch (tipo Firmado) o xdoc@batchsigner (tipo SignError.Exception)	Tres casos: el certificado está por vencer (alerta diaria), el certificado está vencido, o el documento no se pudo firmar. Se distinguen por el mensaje.	Documento o certificado
070001	Procesamiento de conectores	Conectores (por ejemplo, ExcelToXML, MegaPrint, PackageToPrint)	Un conector terminó con error. También lo usa el conector PackageToPrint para avisar que un archivo está disponible (tipo Procesamiento terminado).	Según el conector

nota

Para recibir los errores de Firmado por correo, define destinatarios en el tipo Vencimiento de certificado (o en Todas). El tipo Error de firmado no recibe alertas en la versión actual.

🧰 Errores por servicio

Los mensajes se agrupan por servicio. En la columna Mensaje se indica dónde aparece: EV = Visor de Eventos, errTXT = XML de detalle en errTXT, Correo = correo de alerta.

🔁 Mensajes comunes a todos los servicios

Mensaje	Causa probable	Qué revisar
Área <área> La ruta de ejecución no coincide con la ruta de instalación. (EV)	El servicio se ejecuta desde una carpeta distinta a la instalación de xDoc (por ejemplo, tras copiar o mover la instalación).	Ruta del ejecutable del servicio en Windows. Reinstalar los servicios del área desde Administración → Servicios.
No se pudo leer el archivo de configuración Config.xml. <detalle> (EV)	El archivo de configuración del área no existe, está dañado o no tiene permisos de lectura.	Archivo cnfg\Config.xml del área. Abrir el área en el Manager y guardar la configuración.
Se excedió el tiempo (<n>s) intentando conectarse con el servidor. (EV)	No hubo respuesta de Gosocket en el tiempo máximo.	Conectividad del servidor hacia Internet, proxy y firewall.
El log de eventos ha sido guardado y limpiado automáticamente. (EV)	El registro de eventos se llenó. xDoc guardó una copia en un archivo <fecha>.log y lo vació.	Los eventos anteriores están en ese archivo, dentro de la carpeta del área.

🔄 Conversión

Referencia: Conversión y Control de Duplicidad. El archivo queda en errTXT con su XML de detalle y se genera la alerta 010001.

Mensaje	Causa probable	Qué revisar
Instancia <instancia> en el area <área> No pudo convertir el archivo: <archivo> <detalle>. (EV)	Mensaje general de error de conversión. La causa está en <detalle>.	El detalle y el XML de detalle en errTXT.
Instancia <instancia> en el area <área> No pudo convertir el archivo: <archivo>. Tipo de documento no válido. (EV) Tipo de documento no válido. (errTXT)	El prefijo del nombre del archivo no corresponde a ningún tipo de documento definido.	Nombre del archivo (<tipo>_NPG_…) y tipos de documento configurados en el país.
No se encontró ningún conversor de documentos asociados al tipo <tipo>.	El tipo de documento existe, pero no tiene conversor asociado.	Definición del tipo de documento en MessagesTypes.xml. Si es un tipo estándar, contacta a Soporte Gosocket.
Debe especificar las propiedades ConverterClass y ConverterLib en el MessageTypes para el tipo <tipo>.	Definición incompleta del tipo de documento.	MessagesTypes.xml (entrada del tipo).
No se ha encontrado el archivo con la definición de los tipos de documentos. (EV, al iniciar)	Falta el archivo de tipos de documento del país.	Instalación del país y actualización de xDoc.
Plantilla no encontrada. / No se ha podido cargar la plantilla <archivo>.	No existe el template del tipo de documento o tiene errores.	Archivo <tipo>_Template.xml en cnfg del área.
No se pudo cargar el archivo <archivo>.	El archivo de entrada no se pudo leer (bloqueado, vacío o con codificación incorrecta).	Contenido y codificación del spool.
TXTConversionError: <detalle> (errTXT)	Error al convertir un spool de texto con el template.	Alineación del spool con el template (filas y columnas) y el detalle del error.
XSLTConversionError: El tipo de documento <tipo> no tiene ninguna regla asociada para transformación por XSLT. (errTXT)	La conversión por XSLT está activa, pero el tipo no tiene regla XSLT.	Reglas en la vista Conversión / XSLT.
El documento: <archivo>, Tipo: <tipo>, presenta errores de esquema: <errores>.	El XML generado no cumple el esquema oficial del documento.	Campos indicados en <errores> y los datos del spool.
Se detectaron errores durante la validación con Schematron. + lista de reglas (EV; Correo 010099, cuando las alertas están habilitadas)	El documento no cumple reglas de negocio Schematron.	Cada regla listada y los datos del spool.
Faltan campos obligatorios en el grupo <grupo>, campos esperados: <campos>.	El spool no trae campos obligatorios.	Datos enviados por el ERP para ese grupo.
No se encontró folio para este documento. El campo folio/número no puede ser null o 0. / El folio del documento no es válido.	El documento no trae folio o el folio no es válido.	Campo folio del spool y configuración de numeración.
No se pudo actualizar el historial de folios para el tipo de documento <tipo> en la ruta <ruta>.	xDoc no pudo registrar el folio usado.	Permisos de la carpeta cnfg del área y la numeración configurada.
Documento duplicado + archivo, tipo, emisor y folio	El Control de Duplicidad detectó un documento ya convertido con la misma llave.	Si es un reenvío intencional o un duplicado real. Ver Control de Duplicidad.
El documento tipo <tipo>, folio <folio>, RUT <rut>, folio duplicado.	La validación de folio contra Gosocket indica que ese folio ya existe.	Folio del documento y documentos ya emitidos.
Error al tratar de consultar por el documento tipo <tipo>, folio <folio>, RUT <rut>, consultando si el folio existe. <detalle>	No se pudo consultar a Gosocket si el folio ya existe.	Conectividad con Gosocket y el detalle.
Se ha producido en error durante la conversión.	Mensaje general del conversor del país. La causa va a continuación.	El detalle que sigue al mensaje.
Carta Porte: la version '<x>' no esta soportada (se admiten 2.0 y 3.1). (México)	El spool indica una versión de Carta Porte que la conversión no genera.	Campo Versión del complemento Carta Porte en el spool.
Carta Porte: el spool trae IdCCP (3.1) pero no Version. (México)	Se informó el identificador de Carta Porte 3.1 sin indicar la versión.	Campo Versión del complemento Carta Porte en el spool.
Carta Porte 3.1: <sección> aun no esta implementado en el converter (TODO-3.1). (México)	La Carta Porte 3.1 por spool cubre el autotransporte; el transporte marítimo, aéreo y ferroviario, los derechos de paso y los regímenes aduaneros no están disponibles.	La sección que nombra el mensaje. Usar Carta Porte 2.0 para esos casos o quitar esos datos del spool.
CO <tipo>: el documento no trae UUID, SoftwareSecurityCode o QRCode; no se puede calcular el CUFE (Colombia, conversión por XSLT)	La hoja XSLT no entregó los nodos que xDoc completa al calcular el CUFE.	Hoja XSLT del tipo de documento.

✍ Firmado

Referencia: Firmado. El documento queda en errTXT, el detalle en <nombre>_sign_error.xml y se genera la alerta 050002.

Mensaje	Causa probable	Qué revisar
No se pudo firmar el archivo: <archivo>. Error <detalle> (EV, errTXT, Correo)	Mensaje general de error de firma. La causa está en <detalle>.	El detalle y el archivo _sign_error.xml.
El certificado <archivo> ha expirado. (Correo) / El certificado configurado ha expirado.	El certificado está vencido. No se firma ningún documento.	Renovar el certificado en Configuración → Servicios → Firmado y reiniciar el servicio.
El certificado <archivo> está próximo a expirar. Fecha Expiración: <fecha> (Correo)	Aviso diario: faltan menos días que los configurados en Alerta diaria.	Gestionar la renovación del certificado.
El formato del archivo de certificado no es el correcto.	El archivo no es un certificado válido o no corresponde al formato esperado.	Archivo .pfx/.p12 (o .cer + .key en México).
No se encontró la llave privada. / No se pudo encontrar la llave privada en el certificado. / CSP no contiene una clave privada	El certificado se exportó sin llave privada, o falta el archivo .key.	Exportar de nuevo el certificado con llave privada.
No se ha definido un algoritmo de firmado para el documento [<archivo>] del tipo [<tipo>]	El tipo de documento no tiene algoritmo de firma definido.	Definición del tipo en MessagesTypes.xml. Contacta a Soporte Gosocket.
El tipo de documento '<tipo>' no tiene asociado ningún firmador.	El tipo de documento no tiene firmador asociado.	Definición del tipo en MessagesTypes.xml.
Este tipo de documento xml no está soportado. / Tipo de documento desconocido.	El XML recibido no corresponde a un tipo que el firmador reconozca.	Origen del archivo en outXML.
Falló la validación del archivo <archivo> utilizando el esquema <esquema>. <detalle>	El documento firmado no cumple el esquema oficial.	Campos del detalle y los datos de origen.
No se pudo firmar el documento json.	Error al firmar un documento JSON (El Salvador).	Certificado del Ministerio de Hacienda y contenido del JSON.
No se pudo determinar la fecha de expiración en el certificado.	No se pudo leer la fecha de vencimiento del certificado (El Salvador).	Archivo de certificado configurado.
Error al intentar agregar QRCodeURL.	No se pudo agregar la URL del código QR al documento.	Configuración de QR del país. Contacta a Soporte Gosocket con el documento.
El archivo de certificado debe contener exactamente 1 certificado de firma y contiene <n> (…utilizables…). (Ecuador)	El archivo trae varios certificados y ninguno es utilizable para firmar, o hay más de uno con la misma fecha de vencimiento.	Que el archivo tenga un certificado de firma vigente con su llave privada; cargar un archivo con solo ese certificado.
No se pudo exportar la llave privada. (Ecuador)	La llave privada del certificado no se pudo leer en el formato que necesita el firmado.	Exportar de nuevo el certificado con su llave privada y probar con otro archivo .pfx.
El valor de 'pa_qrcode_url' no es un formato válido. Use chFE={0}&iAmb={1}&digestValue={2}&jwt={3}. (Panamá)	La URL del código QR configurada no tiene el formato esperado.	Configuración local → Url para el código QR. Se acepta el formato con iAmb y el anterior sin iAmb.

🚚 Despacho

Referencia: Despacho. Si el documento es rechazado, queda una copia en errTXT (sin XML de detalle) y se genera la alerta 031001. Si falla la conexión con Gosocket, el documento no avanza: permanece en signXML y se vuelve a intentar en el siguiente ciclo.

Mensaje	Causa probable	Qué revisar
Tipo Rechazado por la Entidad Tributaria, mensaje con la descripción del rechazo (Correo 031001)	La plataforma o la entidad tributaria rechazó el documento.	La descripción y el código en Info. El adjunto trae la respuesta. Corregir los datos de origen y reenviar. En la versión actual el mensaje puede comenzar con [Sin mensaje]; la descripción del rechazo viene a continuación.
Instancia <instancia> en el area <área>. + Documento Enviado a Gosocket. + Code, Success, ID, Descripcion (EV, información)	Registro de cada envío con la respuesta de Gosocket.	Revisar Success, Descripcion y Messages del documento.
Instancia <instancia> en el area <área>. + API: <dirección>. <código HTTP>. <motivo> (EV)	Gosocket respondió con un error HTTP (por ejemplo, 401 credenciales, 500 error del servidor).	Credenciales de despacho y estado del servicio de Gosocket. El documento se reintenta.
Instancia <instancia> en el area <área>. + Se excedió el tiempo (<n>s) intentando conectarse con el servidor. (EV)	Sin respuesta de Gosocket a tiempo.	Conectividad, proxy y firewall.
Ocurrió un error despachando el archivo <archivo> en el área <área>, instancia <instancia>. (EV)	Error al procesar un archivo antes o después del envío.	El detalle, permisos de las carpetas y el archivo en signXML.
Ocurrió un error chequeando archivos pendientes en el área <área>, instancia <instancia>. (EV)	Error al revisar documentos pendientes de respuesta.	El detalle y la conectividad.
Ocurrió un error inicializando el servicio. (EV)	El servicio no pudo iniciar (configuración o credenciales).	Configuración de Despacho y el detalle del evento.
No se ha encontrado el archivo con la definición de los tipos de documentos. (EV)	Falta el archivo de tipos de documento del país.	Instalación del país.
La respuesta obtenida no contiene un mensaje XML SOAP	La respuesta del servidor no tiene el formato esperado.	Proxy o equipo intermedio que altere la respuesta.
Error enviando comentario a Gosocket	No se pudo registrar un comentario del documento en Gosocket.	Conectividad y el detalle.
El documento superó el tiempo de espera para su aprobación por la autoridad fiscal y no se envió a impresión. (Brasil, Correo 031001)	La SEFAZ no devolvió la autorización a tiempo.	Estado del documento en Gosocket.
No se encontró la transformación para el registro del sello fiscal del documento despachado. (El Salvador)	Falta la transformación para guardar el sello fiscal.	Instalación del país. Contacta a Soporte Gosocket.
El archivo ya no existe; se deja de reintentar su envío: <ruta> (EV, advertencia)	Otro proceso movió o eliminó el archivo de signXML antes de enviarlo.	Qué proceso lo movió o eliminó; si era un documento pendiente, volver a generarlo. El envío de los demás documentos continúa.

📥 Recepción

Referencia: Recepción. Los errores se registran en el Visor de Eventos con el formato Área <área> + mensaje. No generan alertas por correo.

Mensaje	Causa probable	Qué revisar
Error descargando documentos: + detalle (EV)	No se pudo obtener la lista de documentos recibidos.	Conectividad y credenciales de Recepción.
Error descargando documentos:Se excedió el tiempo (<n>s) intentando conectarse con el servidor. (EV)	Sin respuesta de Gosocket a tiempo.	Conectividad, proxy y firewall.
Error guardando documento recibido ID: <id> (EV)	El documento se descargó, pero no se pudo guardar.	Espacio en disco y permisos de la carpeta rcv del área.
Error guardando guía de remisión recibida ID: <id> (EV)	La guía se descargó, pero no se pudo guardar.	Espacio en disco y permisos de la carpeta rcv.
Error confirmando documentos recibidos / Error confirmando guías recibidas (EV)	No se pudo confirmar a Gosocket la descarga. Los documentos pueden volver a descargarse.	Conectividad. Revisar duplicados en rcv.
Error al procesar los documentos. Error en backup de documento (EV)	No se pudo guardar el respaldo del documento recibido.	Carpeta de respaldo, espacio y permisos.
Error al procesar las guías de remisión. Error en backup de guías de remisión (EV)	No se pudo guardar el respaldo de la guía.	Carpeta de respaldo, espacio y permisos.
Error descargando los mensajes desde Inbox (EV)	No se pudieron descargar los mensajes (acuses) de Inbox.	Conectividad y credenciales.
Error al confirmar los mensajes a Inbox (EV)	No se pudo confirmar la descarga de mensajes.	Conectividad.
Error procesando archivo MsgBatch (EV)	Un lote de mensajes no se pudo procesar.	Archivos .err en la carpeta rcv del área.

🖨 Impresión

Referencia: Impresión. El documento queda en toprint con extensión .err y se generan las alertas 030002 a 030005.

Mensaje	Causa probable	Qué revisar
El archivo <archivo> no pudo ser impreso. Error: <detalle> (EV, Correo 030002)	Error al enviar el documento a la impresora.	Impresora configurada, conexión y el detalle.
El archivo <archivo> no pudo ser impreso. Error <detalle> (EV, Correo 030005)	Error no previsto al imprimir.	El detalle del error. Si se repite, contacta a Soporte Gosocket.
xdoc@batchprinter - Impresión de documento <archivo> + errores (EV, Correo 030003)	La impresión o el PDF terminó con errores.	Regla de impresión, plantilla y el texto del error.
El tipo de documento para el documento <archivo> no está definido. (EV, Correo 030004)	No se identificó el tipo de documento a imprimir.	Contenido del XML y tipos de documento del país.
No se encontró ninguna plantilla asociada al documento <archivo>. La plantilla no existe<ruta>	No hay plantilla de impresión para el documento.	Reglas de Impresión y plantillas en cnfg.
No se ha encontrado el archivo de plantilla Jasper: <ruta>.	Falta el archivo .jrxml de la plantilla.	Ruta de la plantilla en la regla de impresión.
Ya existe un PDF con nombre <archivo> en la ruta <ruta>	El PDF ya se había generado.	Si es una reimpresión, mover o eliminar el PDF anterior.
Error al paquetizar PDF. <detalle>.	No se pudo armar el paquete de PDF.	El detalle, espacio en disco y permisos.
No se ha encontrado el archivo con la definición de los tipos de documentos. (EV, al iniciar)	Falta el archivo de tipos de documento del país.	Instalación del país.
Se ha producido un error con el formato de los archivo de comandos de reimpresión. …	El archivo de comandos de reimpresión no tiene el formato [RUT];[TipoDoc];[Folio].	Contenido del archivo de comandos.
Se ha producido un error descargando el documento desde el server para su reimpresión	No se pudo descargar de Gosocket el documento a reimprimir.	Conectividad y datos del documento.

📄 Paginado

Referencia: Paginado. Los errores se registran en el Visor de Eventos. No generan alertas por correo.

Mensaje	Causa probable	Qué revisar
Área <área> + No se pudo paginar el archivo: <archivo> + detalle (EV)	Error al separar el spool en documentos.	El detalle y el spool de entrada.
No se pudo paginar el archivo: <archivo> + No se encontró la plantilla <tipo>_Template.xml (EV)	Falta el template del tipo de documento.	Archivo <tipo>_Template.xml en cnfg.
No se pudo paginar el archivo: <archivo> + La plantilla no contiene el elemento fin de documento. (EV)	El template no define dónde termina cada documento.	Elemento de fin de documento en el template.
Tipo de documento no definido para el spool <archivo> (EV)	El prefijo del spool no corresponde a un tipo definido. El spool se mueve a la carpeta alerts.	Nombre del spool y tipos de documento.
El spool <archivo> no cumple el formato de trazabilidad de lotes (TDC_NPG_IDLOTE<extensión>). (EV)	La trazabilidad de lotes está activa, pero el nombre no incluye el ID de lote.	Nombre del spool que genera el ERP.
No se pudo actualizar el historial de folios para el tipo de documento <tipo> en la ruta <ruta>. <detalle> (EV)	Con autonumeración, no se pudo registrar el folio asignado.	Carpeta CAF del área y numeración disponible.
Error paginando el archivo: <archivo> (EV)	Error al escribir los documentos paginados.	Permisos y espacio de la carpeta printed.
No se ha encontrado el archivo con la definición de los tipos de documento. (EV, al iniciar)	Falta el archivo de tipos de documento.	Instalación del país.

⚖ Balanceo

Referencia: Balanceo. Los errores se registran en el Visor de Eventos. No generan alertas por correo.

Mensaje	Causa probable	Qué revisar
Área: <área> + No existen instancias definidas para esta área. (EV)	El área no tiene instancias activas donde repartir los documentos.	Instancias del área y su estado.
Área: <área> + ruta del archivo + detalle (EV)	No se pudo mover un documento a inTXTtoXML de una instancia (archivo bloqueado o duplicado).	El archivo en printed y la carpeta de la instancia.
Área: <área> + No se pudo leer el archivo de configuración Config.xml. <detalle> (EV)	Configuración del área dañada o sin permisos.	cnfg\Config.xml.

🔌 Conectores

Referencia: Conectores. Los errores se registran en el Visor de Eventos con origen Servicio xdoc@connector_<área>. Cada conector tiene además sus propios mensajes (ver la ficha del conector).

Mensaje	Causa probable	Qué revisar
Área: <área> + Error ejecutando el conector <conector> (EV)	El conector terminó con error.	Eventos anteriores del mismo conector (traen el detalle) y su configuración.
Área: <área> + Se ha ejecutado el conector <conector> (EV, información)	Registro normal de ejecución.	Sirve para confirmar que el conector corre.
Área: <área> + No se pudo leer el archivo de configuración Config.xml (EV)	Configuración del área dañada o sin permisos.	cnfg\Config.xml.
SFTPConnector: Error general [<archivo>] <detalle> (EV)	Error de conexión o transferencia SFTP.	Servidor, puerto, credenciales y permisos de la carpeta remota.
ConvertExcelToXML.IOException / ConvertExcelToXML.Exception (Correo 070001)	El conector de Excel no pudo leer o transformar el archivo.	Archivo Excel abierto por otro programa, formato y hoja esperada.
MegaPrintConnector.Exception (Correo 070001)	Error en la comunicación con MegaPrint (Guatemala).	Credenciales, conectividad y el mensaje de error.
Archivo <archivo> disponible en la carpeta <carpeta> del servidor (Correo 070001, tipo Procesamiento terminado)	Aviso de PackageToPrint: el paquete quedó disponible. No es un error.	Nada; confirma la entrega.
Connector SAPRFCConnectorIn: Error / SAPRFCConnectorOut: Error / SAPRFCConnectorOut: Error al cargar el xml (EV)	Error en la comunicación con SAP o en el documento recibido.	Conexión RFC, destino SAP y el detalle.
Error procesando documento: <documento> en SAP >> <detalle> (log del conector)	SAP devolvió un error al procesar un documento.	El documento en SAP y el detalle.
Duplicado según secuencia <secuencia>.	El conector detectó un archivo ya procesado.	Si el reenvío es intencional.

🔔 Alertas

Referencia: Alertas. Errores del propio servicio de Alertas (EV, origen Servicio xdoc@alert_<área>).

Mensaje	Causa probable	Qué revisar
Área: <área> No se ha podido notificar de la alerta vía correo electrónico: <detalle>	Falló el envío por SMTP. La alerta queda en alerts y se reintenta.	Servidor SMTP, puerto, usuario, proxy y acceso de red.
Área: <área> Error procesando la alerta.	El archivo de alerta está dañado o no tiene el formato esperado.	El archivo alert_*.xml en alerts.
Área: <área> Error procesando la alerta, no se pudo eliminar archivo: <archivo>. / …no se pudo eliminar el adjunto <archivo>.	El correo se envió, pero el archivo quedó bloqueado.	Permisos de la carpeta alerts o antivirus.

⚙ Cómo investigar un error paso a paso

1. Ubica el documento. Busca el archivo por su nombre en xDoc Manager → Documentos (nodo Errores de la instancia) o directamente en errTXT. Si no está, revisa signXML (despacho pendiente), toprint (.err) o alerts.
2. Lee el detalle. Abre el XML de detalle (mismo nombre en Conversión; _sign_error.xml en Firmado). Anota el código, el origen y el mensaje.
3. Revisa el Visor de Eventos. En Visor de Eventos, filtra por Servicio: e Instancia:, y busca eventos de error cercanos a la hora del problema.
4. Busca el mensaje en este catálogo. Identifica el servicio y la causa probable. Si es una alerta, usa el Código del correo y la tabla Códigos de alerta.
5. Corrige la causa. Por lo general, los errores de datos se corrigen en el ERP y se reenvían. Los errores de configuración se corrigen en el Manager y requieren reiniciar el servicio.
6. Verifica. Una vez reenviado el documento, confirma en el Visor de Eventos que el error no se repite.

información

En Documentos → Errores, los archivos .txt de errTXT se muestran como Archivo en Conflicto y los .xml como Error de conversión, aunque el .xml sea un documento que falló en Firmado o en Despacho. Revisa el nombre del archivo y su detalle para saber en qué etapa falló.

🧪 Ejemplos

Ejemplo 1: correo de rechazo en despacho

• Código: 031001 · Tipo: Rechazado por la Entidad Tributaria · Fuente: xdoc@dispatch
• Mensaje: descripción del rechazo · Info Adicional: código de rechazo · Adjunto: respuesta de la entidad
• Qué hacer: leer la descripción, corregir el dato en el origen y reenviar. El documento rechazado queda en errTXT.

Ejemplo 2: documento en errTXT por tipo no válido

• Visor de Eventos: Instancia 01 en el area FACTURAS No pudo convertir el archivo: 99_NPG_001.txt. Tipo de documento no válido.
• Causa: el prefijo 99 no es un tipo de documento definido.
• Qué hacer: corregir el nombre del archivo que genera el ERP.

Ejemplo 3: certificado por vencer

• Código: 050002 · Tipo: Firmado · Mensaje: El certificado <archivo> está próximo a expirar. Fecha Expiración: <fecha>
• Qué hacer: solicitar al cliente el certificado renovado y cargarlo en Firmado antes del vencimiento.

🌎 Variaciones por país

País	Particularidad
Paraguay	El despacho a SIFEN genera alertas con origen TaxAuthority: 031000 (error al leer o procesar un documento, lote o evento), 031001 (error al enviar a SIFEN), 031002 (documento, lote o evento aprobado) y 031003 (rechazado o no procesado). Se activan en Configuración local con Generar alertas de operaciones fallidas y Generar alertas de operaciones exitosas. Las aprobaciones llegan con tipo Error aunque no son errores; guíate por el mensaje. Si SIFEN no responde a la consulta de un lote, el servicio registra la falla (y, si las alertas de operaciones fallidas están activas, puede generar 031000), pasa al siguiente lote y vuelve a consultar ese lote en el ciclo siguiente.
Brasil	Alerta 031001 cuando el documento supera el tiempo de espera de autorización y no se envía a impresión.
El Salvador	Mensajes propios de firma JSON y del sello fiscal (ver Firmado y Despacho).
Todos	Los conversores de cada país tienen mensajes propios de validación de campos (por ejemplo, NFe en Brasil o CFDI en México). Estos mensajes aparecen en el detalle del error de conversión.

🧭 Consideraciones de implementación

• Habilita las alertas en Configuración → Servicios → Alertas y define destinatarios al menos en Todas. Para los errores de firmado, usa el tipo Vencimiento de certificado.
• Configura el servidor SMTP en Configuración de conectividad…. Sin SMTP, las alertas no se envían.
• Recepción, Paginado, Balanceo y el servicio de Conectores registran sus errores en el Visor de Eventos; supervísalos allí además del correo.
• Revisa periódicamente errTXT de cada instancia y la carpeta alerts; si se acumulan archivos, hay errores sin atender o alertas sin destinatario.
• Para investigar conversiones, activa Generar Trazabilidad de conversión en Configuración → Trazabilidad durante el diagnóstico.
• Antes de limpiar el Visor de Eventos desde el Manager, acepta guardar el log para conservar el historial.

📦 Qué informar a Soporte Gosocket

Si el error no se resuelve con este catálogo, contacta a Soporte Gosocket con estos insumos (sanitizados, sin datos de contribuyentes ni credenciales):

1. País, área, instancia y versión de xDoc.
2. Servicio afectado y hora aproximada del error.
3. Texto completo del evento del Visor de Eventos (origen y mensaje).
4. El XML de detalle de errTXT o el correo de alerta (código, tipo, origen y mensaje).
5. El documento de entrada (spool o XML) con datos de prueba o anonimizados, y el template o regla involucrada.
6. Qué cambió antes del error (actualización, certificado, configuración) y si se repite con otros documentos.

nota

No envíes certificados, contraseñas, archivos Config.xml completos ni documentos reales de clientes sin sanitizar. Usa datos de prueba o anonimizados.