Saltar al contenido principal

Overview técnico

:::info Vista rápida del flujo El proceso se divide en 4 etapas: generación en POS, transformación fiscal, envío a nube y respuesta de vuelta al POS. :::

1. Flujo Operativo​

1.1 Generación del Documento​

  • El POS (Simphony) genera una transacción de venta.
  • Simphony envía un archivo XML denominado Payload.
  • La comunicación se realiza vía Socket TCP – Puerto 5500.

1.2 Recepción y Procesamiento​

  • Agente Windows escucha el puerto configurado.
  • Recepciona el XML Payload.
  • Valida estructura y consistencia básica.
  • Realiza la transformación del XML (Payload) al formato DTE (Documento Tributario Electrónico) requerido por el país correspondiente. Esta transformación se basa en un archivo XSLT desarrollado por el equipo de integraciones.

1.3 Envío a la Nube (API SendDocumentToAuthority)​

  • El DTE generado es enviado a Gosocket cloud por medio del API de emisión convencional.
  • El documento es:
    • Validado internamente.
    • Firmado (si aplica).
    • Enviado al ente fiscal correspondiente.

1.4 Respuesta al POS​

Siempre se genera una respuesta hacia Simphony en formato XML que incluye:

  • Estado del documento (Aceptado / Rechazado).
  • Código de respuesta.
  • Mensaje descriptivo.
  • Campos fiscales relevantes solicitados por el cliente para ser guardados en la base de datos local (ejemplo: folio, UUID, CAE, hash, fecha de autorización, montos totales, etc.).

2. Componentes Técnicos​

2.1 Comunicación de Entrada​

  • Protocolo: TCP Socket
  • Puerto: 5500 (configurable)
  • Formato: XML (Payload)

2.2 Transformación​

  • Mapeo de campos Payload → DTE
  • Validaciones:
    • Estructura XML
    • Campos obligatorios
    • Tipos de documento

2.3 Comunicación con la Nube​

  • Protocolo: HTTPS
  • Envío síncrono
  • Recepción de respuesta estructurada

2.4 Comunicación de Salida​

  • Formato: XML (Oracle)
  • Respuesta obligatoria por cada transacción recibida
  • Confirmación de procesamiento exitoso o error

3. Consideraciones Técnicas​

  • El conector Simphony se instala localmente en la infraestructura del cliente.
  • Requiere conectividad saliente a internet.
  • Puede operar en modalidad síncrona.
  • El puerto 5500 debe estar habilitado en firewall local.

4. Proceso de instalación (Agente Windows)​

  • El agente Windows deberá ser solicitado al coordinador del área de integraciones de la compañía, este proveerá la última versión del mismo para la locación solicitada.

  • El empaquetado entregado se deberá colocar en la siguiente ubicación: C:\Consola_GS. Si no existe, se deberá crear.

  • En la raíz de dicho empaquetado encontraremos el archivo "Settings.xml", en el cual se deberán modificar o configurar 4 nodos:

    • /configuration/appSettings/add/@key="CountryId": en la propiedad @value se deberá colocar el código del país en el que se implementa.
    • /configuration/appSettings/add/@key="ApiAuthURL": en la propiedad @value se deberá colocar la URL del API de envío de documentos (SendDocumentToAuthority).
    • /configuration/appSettings/add/@key="ApiKeyUserList": en la propiedad @value irá el API key del cliente.
    • /configuration/appSettings/add/@key="ApiKeyPassList": en la propiedad @value se configurará la contraseña del API key que se use en el paso anterior.

  • Debemos asegurarnos de que en el empaquetado del agente exista la siguiente ruta: C:\Consola_GS\Gosocket.Agent.WinServ\Data\*Código del país a implementar* y dentro de ella las siguientes carpetas.

  • Dentro de la carpeta Xslts se deberán colocar los dos archivos XSLT mencionados anteriormente como parte del proceso de trabajo del agente (default_response.xslt y default_transform.xslt). Estos archivos también son provistos por el coordinador de integraciones de la compañía y, en caso de requerir algún cambio, este deberá ser solicitado con semanas de antelación.

  • Como paso final, solo queda ejecutar el agente (Gosocket.Agent.WinServ.exe) como administrador del equipo. Luego de ello, se puede iniciar también la aplicación de Simphony.

5. Requisitos de Infraestructura​

Servidor​

ComponenteRequisito
🖥️ Sistema operativoWindows Server 2016+
⚙️ Runtime.NET Runtime correspondiente
🧠 Memoria RAM4 GB mínimo
🌐 ConectividadConexión estable a internet

Red​

Regla de redConfiguración requerida
📥 Tráfico entrante (inbound)Puerto 5500 habilitado en la red local
📤 Tráfico saliente (outbound)Puerto 443 habilitado para salida a internet

:::note Recomendación operativa Validar previamente estos requisitos evita errores de conectividad y reduce incidentes durante la puesta en marcha del agente. :::