Getnet DocsGetnet Docs

Connector y flujos de comunicación

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 página describe cómo se establece, se mantiene y se finaliza la comunicación entre el sistema de automatización comercial y el terminal TPV.

¿Qué es el Connector?

El Connector es un objeto que devuelven CreateHttp, CreateUsb o CreateCloud. Es el elemento central que coordina todo el intercambio de mensajes con el TPV. También garantiza el orden de ejecución correcto de las operaciones del TPV Integrado.

La abstracción del Connector

Un Connector se crea mediante uno de los métodos de fábrica (factory methods) compatibles:

  • CreateHttp
  • CreateUsb
  • CreateCloud

Sea cual sea el transporte subyacente, el Connector expone el mismo conjunto de funciones de operación del dispositivo. También garantiza un ciclo de vida de comunicación consistente.

Descripción general del flujo de comunicación

Cada interacción del TPV Integrado sigue un flujo determinista:

  1. Creación del Connector — El sistema de automatización establece un canal de transporte y recibe una instancia de Connector.
  2. Validación del terminal — El comando Polling se ejecuta para verificar que el terminal está disponible y listo.
  3. Ejecución de la operación — Se invocan operaciones de negocio como Sale, Refund o GetReports.
  4. Manejo de la respuesta — El terminal devuelve una respuesta estructurada con el resultado de la operación.
  5. Cierre de la conexión — El sistema de automatización libera los recursos llamando a Close.

Una operación a la vez

El Connector procesa una operación a la vez. Envías un comando y esperas su respuesta antes de enviar el siguiente comando.

No inicies una segunda operación mientras el terminal todavía procesa la primera. Esta regla mantiene alineada la secuencia de comandos y respuestas, y evita estados en conflicto en el terminal.

Flujo de comandos y respuestas

Cada comando produce una sola respuesta estructurada. La respuesta lleva el resultado de la operación y un payload que depende del tipo de operación:

  • ReportDetails devuelve los datos de los reportes y de las operaciones de turno.
  • ReceiptContent devuelve el contenido imprimible de las operaciones de venta, reembolso y voucher.
  • AccountingDate devuelve la fecha contable que el terminal aplica a la transacción.

Lees estos campos de la respuesta para confirmar el resultado y definir tu siguiente paso.

Independencia del transporte y ciclo de vida de la conexión

Aunque los mecanismos de comunicación difieren entre las conexiones USB, de red y en la nube, el flujo lógico sigue siendo idéntico. Están disponibles los mismos comandos, se esperan los mismos parámetros y se devuelven las mismas estructuras de respuesta. Esto permite a los integradores cambiar de modelo de transporte sin modificar la lógica de negocio.

Cuando se cierra el Connector, se liberan todos los recursos asignados, la instancia del Connector deja de ser válida y se rechaza la ejecución de comandos adicionales. Se debe crear un nuevo Connector para reanudar la comunicación con el terminal TPV.

Recursos relacionados

  • Modelos de conexión — Métodos de creación para USB, red y nube.
  • Arquitectura del TPV — Cómo encaja el Connector en la arquitectura general.
  • Inicio rápido — Creación del connector, Polling, Sale, Close.
  • Para conocer los detalles de la creación del connector, Close y Polling, consulta los Conceptos principales y las Guías de conexión.