Getnet DocsGetnet Docs

Conectando mediante red – Wi-Fi / Ethernet (CreateHttp)

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page
Connect to CursorUse these docs in CursorConnect to VS CodeUse these docs in VS Code

Esta guía explica cómo conectar un TPV Integrado a través de una red mediante la comunicación HTTP.

Cuándo usar la conexión de red

Usa una conexión de red cuando:

  • El terminal TPV y el sistema de automatización estén en la misma red local
  • Esté disponible la conectividad Wi-Fi o Ethernet
  • Se requiera una ubicación física flexible de los dispositivos

Este es el modelo de conexión más común para las implementaciones del TPV Integrado.

Antes de comenzar

Antes de conectar a través de la red, asegúrate de que:

  • El terminal TPV esté encendido y configurado para el modo TPV Integrado
  • El terminal sea accesible a través de la red
  • La biblioteca del TPV Integrado esté disponible en tu aplicación
  • Las políticas de firewall o de red permitan la comunicación HTTP

Paso 1: Crear el HTTP Connector

Para establecer la conexión, crea un Connector usando CreateHttp.

Parámetros

ParámetroTipoObligatorioDescripción
hostnamestringSíNombre de host, IPv4 o IPv6 del terminal TPV
portintNoPuerto TCP (por defecto: 8080)

Ejemplo

Connector connector = Connector.CreateHttp("192.168.0.10");

En este punto, el canal de comunicación está inicializado, pero el terminal aún no ha sido validado.

Paso 2: Validar el terminal

Valida el terminal con el comando Polling antes de ejecutar cualquier operación:

var pollingResult = connector.PollingAsync();

Procede solo si la respuesta de Polling indica que está listo.

Paso 3: Ejecutar operaciones

Una vez validado, el Connector se puede usar para ejecutar operaciones como:

  • Sale
  • Refund
  • GetReports

Las operaciones se procesan secuencialmente.

Paso 4: Cerrar la conexión

Después de finalizar todas las operaciones, cierra el Connector:

connector.Close();

La instancia del Connector no se puede reutilizar después del cierre.

Consideraciones de la conexión de red

  • La inestabilidad de la red puede requerir una reconexión
  • El Polling debe ejecutarse nuevamente después de reconectar
  • Los parámetros de configuración pueden afectar el comportamiento de reconexión

Siguientes pasos