Herramientas de usuario

Herramientas del sitio


conector

Diferencias

Muestra las diferencias entre dos versiones de la página.

Enlace a la vista de comparación

Ambos lados, revisión anterior Revisión previa
Próxima revisión
Revisión previa
conector [2014/12/19 22:40]
[Servidor de correo]
conector [2022/09/06 20:01] (actual)
[Conector iTimbre]
Línea 2: Línea 2:
  
 {{:​conector:​conector.jpg?​nolink&​234x168}} {{:​conector:​conector.jpg?​nolink&​234x168}}
 +
 +**Acceda a la siguiente liga para descargar el conector:**
 +
 +[[https://​www.itimbre.com/​downloads/​Conector-iTimbre.zip|Descargar conector última versión 3.3]].
 +
 +[[https://​www.itimbre.com/​Descargas/​Conector 4.0.zip|Descargar conector última versión 4.0.]]
  
 ===== Información General ===== ===== Información General =====
Línea 115: Línea 121:
 === Opciones === === Opciones ===
  
-== Notificaciones ==+{{:​conector:​conector-configuracion-opciones.png?​nolink&​473x506}} 
 + 
 +En esta pestaña se configuran la mayoría de opciones de propósito general del Conector iTimbre 
 + 
 +== Notificaciones ​de error y Notificaciones de timbrado exitoso ​== 
 + 
 +Cuando se timbra correctamente un comprobante u ocurre un error durante el procesamiento de un archivo, el Conector brinda opciones para notificar al usuario de una o varias maneras. La opción seleccionada para notificar el timbrado exitoso se aplica también a las cancelaciones exitosas. Estas opciones son: 
 + 
 +  * Ninguna / Sin notificaciones en la pantalla: Se omite completamente la notificación en la pantalla de la computadora. Esta opción es generalmente no recomendada ya que no proporciona indicio ninguno del estado del procesamiento que lleva a cabo el Conector. 
 +  * Área de notificaciones:​ Se muestra un popup no obstrusivo en el área de notificaciones de la barra de tareas con el mensaje de éxito o error. Esta opción es recomendable cuando por lo general el Conector estará procesando grandes volúmenes de archivos simultáneos. 
 +  * Diálogo: Se muestra un cuadro de mensaje en la pantalla que requerirá la atención del usuario. 
 +  * Ventana: Esta opción, disponible solamente para el timbrado exitoso, muestra detalles de la operación en una ventana especial la cual muestra el PDF (si se obtiene) y el XML del comprobante timbrado y, para el caso de las cancelaciones,​ muestra un resumen detallado del resultado de la operación. 
 + 
 +Adicionalmente,​ los errores pueden ser notificados via correo electrónico seleccionando la opción correspondiente.
  
 == Obtener Formato imprimible (PDF) == == Obtener Formato imprimible (PDF) ==
  
-== Envío Automático ​==+Haciendo uso de esta opción se solicita la obtención del PDF del comprobante el cual será guardado en la carpeta de facturas timbradas junto con su correspondiente archivo .XML. 
 + 
 +Solo el servicio de timbrado mediante una cuenta del software de facturación de iTimbre soporta esta opción. Si se utiliza el timbrado directo esta opción es ignorada. 
 + 
 +== Enviar facturas al receptor automáticamente ​== 
 + 
 +El Conector permite enviar los comprobantes timbrados al cliente. 
 + 
 +Si se utiliza el timbrado directo, el único método soportado es enviarlos desde el conector. 
 + 
 +Si se utiliza una cuenta de software de facturación de iTimbre se puede utilizar la opción "​Respetar la configuración de la cuenta en el servidor"​. 
 + 
 +  * **Respetar la configuración de la cuenta en el servidor:​** ​ Las cuentas de software de facturación cuentan con una opción para enviar automáticamente al receptor los comprobantes que se timbren desde el sistema. Esta opción delega la desición de enviar la factura al receptor respetando la configuración de la cuenta. 
 +Cuando se decide enviar los comprobantes al cliente o respetar la configuración de la cuenta para enviar o no las facturas al cliente se habilitan otras opciones relacionadas:​ 
 + 
 +  * Desde dónde enviar las facturas 
 +      * Sólo desde el conector: los comprobantes siempre se envian desde el Conector. 
 +      * Intentar desde el servidor y luego desde el conector: se intenta enviar los comprobantes timbrados desde el servidor de iTimbre y en caso de no poderse por alguna razón, se intenta el envío desde el Conector. 
 +  * Mostrar ventana de envío si el receptor no tiene dirección de correo: Si esta opción se activa, cuando se timbre un comprobante y se desconozca la dirección de correo del receptor, se abrirá una ventana para enviar el correo electrónico. Esta operación requiere la intervención del usuario y el procesamiento de los archivos restantes es detenido hasta que dicha ventana se cierre y se concluya el procesamiento del archivo actual. 
 +  * Enviar copia al correo de notificaciones:​ Esta opción permite enviar al correo de notificaciones una copia de todos los correos enviados a los receptores de los comprobantes.
  
 == Opciones de inicio == == Opciones de inicio ==
 +
 +  * **Vigilar carpeta de entrada automáticamente al inicio del programa:​** ​ Esta opción define si al ejecutarse el programa del Conector este debe comenzar a vigilar y procesar automáticamente los archivos de las carpetas de entrada.
 +  * **Iniciar minimizado hacia el área de notificaciones del sistema:​** ​ Por defecto, al ejecutar el programa del Conector se muestra la ventana principal dle programa. Esta opción permite que la ventana principal no se muestre y solo se cargue el icono del Conector en el área de notificaciones.
  
 === Avanzado === === Avanzado ===
 +
 +{{:​conector:​conector-configuracion-avanzado.png?​nolink&​473x506}}
 +
 +Algunas de las opciones que se configuran en esta pestaña pueden presentar cierto grado de complejidad para su comprención,​ aunque han sido presentadas de la manera más sencilla posible.
  
 == Codificación de archivos == == Codificación de archivos ==
 +
 +Los archivos de texto tiene una codificación específica entre muchas disponibles. A la hora de leer el contenido de los archivos de texto es pereciso interpretarlos con la codificación correcta, de lo contrario algunos caracteres como la ñ y las vocales con tílde podrían perderse en el proceso. La codificación de un archivo depende el programa que los generó.
 +
 +Esta opción permite seleccionar la codificación utilizada para leer los archivos de las carpetas de entrada.
 +
 +Las codificaciones más comunes son:
 +
 +  * 1252 : Windows-1252 (es la codificación por defecto de Windows y también del Conector)
 +  * 437 : IBM437
 +  * 65001 : utf-8
  
 == Servicios == == Servicios ==
  
-== Formato del nombre de archivos ​finales ​==+En esta sección se definen las URLs de los servicios de timbrado que utilizará el conector. Solo bajo situaciones excepcionales se utilizará un valor direfente al "​Servicio predeterminado"​. No modifique esta opción a menos que esté seguro de lo que está haciendo. 
 + 
 +== Formato del nombre de archivos ​de la factura ​== 
 + 
 +El formato del nombre de los archivos de las facturas puede ser especificado haciendo uso de las siguientes etiquetas representativas:​ 
 + 
 +  * **<​rfc_emisor>​** ​ : RFC del emisor 
 +  * **<​rfc_cliente>​** ​ : RFC del Receptor 
 +  * **<​serie>​** ​ : Serie de la factura 
 +  * **<​folio>​** ​ : Folio de la factura 
 +  * **<​fecha[:​ formato]>​** ​ : Fecha y formato de fecha (Ej.: <​fecha>,​ <fecha: dd-MM-yyyy>​) 
 +  * **<​nombre_original>​** ​ : Nombre original del archivo procesado:​ 
 +Cualquier otro caracter adicional será incluido literalmente en el nombre de los archivos de la factura. 
 + 
 +== Título de la instancia == 
 + 
 +Nombre de la instancia actual del conector el cual se muestra en la ventana principal y al mover el puntero del mouse por encima del ícono del Conector en el área de notificaciones. Esta opción es especialmente útil en entornos donde se ejecuten varios conectores simultáneamente ya que permite asgnarles nombre diferentes e identificarlos rápidamente moviendo el puntero del mouse por encima del ícono del área de notificaciones. 
 + 
 +==== Configuración personalizada (avanzado) ==== 
 + 
 +La configuración personalizada del Conector está diseñada para adaptarse a los requerimientos especiales de los clientes, de ahí su nombre de personalizada. Esta configuración no está disponible desde una ventada de configuración,​ por lo que su uso solo es propicio para personal técnico y generalmente es establecido por el personal de iTimbre. 
 + 
 +La configuración personalizada se guarda en un archivo en formato XML ubicado en **<​Carpeta_de_instalacion_del_conector><​nowiki>​\</​nowiki>​personalizados<​nowiki>​\</​nowiki>​cgf.xml**. Es importante tener respaldo de este archivo y asegurarse de que sea restablecido con todas sus modificaciones cuando se realicen actualizaciones al Conector iTimbre, pues si se reemplaza por el archivo por defecto el Conector puede dejar de funcionar como se espera. 
 + 
 +Las siguientes secciones explican detalles técnicos de sobre el archivo de configuración personalizada que puede ser no relevante para el usuario comun del Conector iTimbre. 
 + 
 +=== Ejemplo de archivo de configuración personalizado === 
 + 
 +<​file>​ 
 +<?xml version="​1.0"​ encoding="​utf-8"​ ?> 
 +<​Configuracion>​ 
 +  <​Procesadores restringir="​true">​ 
 +    <​Procesador id="​standard-cfdf-csv"​ regExp="​(?​i).*\.csv$">​ 
 +      <​!--<​Ajustes>​ 
 +        <​Propiedad nombre="​BranchId">​1</​Propiedad>​ 
 +      </​Ajustes>​-->​ 
 +    </​Procesador>​ 
 +    <​Procesador id="​standard-cfdf-json"​ regExp="​(?​i).*\.json$"​ /> 
 +    <​!--<​Procesador id="​standard-cfdf-cfd22"​ regExp="​(?​i).*\.xml$">​ 
 +      <​Ajustes>​ 
 +        <​Propiedad nombre="​overrideSystemDecimals">​si</​Propiedad>​ 
 +      </​Ajustes>​ 
 +    </​Procesador>​-->​ 
 +    <​Procesador id="​standard-cfdf-cfd32"​ regExp="​(?​i).*\.xml$">​ 
 +      <​!--<​Ajustes>​ 
 +        <​Propiedad nombre="​LoadFromDb">​true</​Propiedad>​ 
 +        <​Propiedad nombre="​IncludeStamps">​true</​Propiedad>​ 
 +      </​Ajustes>​-->​ 
 +    </​Procesador>​ 
 +    <​!--<​Procesador id="​standard-portal-cfd32"​ regExp="​(?​i).*\.xml$"​ />​-->​ 
 +    <​!--<​Procesador id="​file-splitter"​ regExp="​(?​i).*\.txt$">​ 
 +      <​Ajustes>​ 
 +        <​Propiedad nombre="​SplitRegex">​RegimenFiscal</​Propiedad>​ 
 +        <​Propiedad nombre="​OutputExtension">​.csv</​Propiedad>​ 
 +      </​Ajustes>​ 
 +    </​Procesador>​-->​ 
 + 
 +    <!-- Procesadores de cancelaciones --> 
 + 
 +    <​Procesador id="​cancellation-cfdf-csv"​ regExp="​(?​i).*\.csv$"​ context="​cancellation"/>​ 
 +  </​Procesadores>​ 
 +</​Configuracion>​ 
 +</​file>​ 
 +=== Estructura del archivo de configuracion personalizado === 
 + 
 +El archivo de configuración por defecto incluye los procesadores de propósito general más comunmente utilizados por los clientes. Un procesador es un componente de software que se encarga de procesar los archivos de alguna manera específica acorde al formato de su contenido. 
 + 
 +El archivo de configuración personalizada define el conjunto de procesadores que se podran utilizar y como se identifican los archivos que debe procesar cada uno de ellos. Esta identificación se realiza en base al nombre del archivo a procesar.
  
-==== Configuración en línea ====+=== El nodo Procesador ​===
  
 ===== Servicio ===== ===== Servicio =====
conector.1419028825.txt.gz · Última modificación: 2016/01/05 23:15 (editor externo)