Entrar
.md

Data interfaces

Guper se integra con muchos sistemas externos — Bling, VTEX, Linx, Shopify y otros. Cada integración se llama Provider, y dentro de cada provider existen distintos Sources que representan el origen del dato.

Para organizar y estandarizar la información que viene de estos sistemas, Guper usa un concepto llamado Data Interface. Una interface actúa como traductor entre los datos del sistema externo y el formato esperado internamente, garantizando que los identificadores de cada plataforma se mapeen a las entidades correctas.

Cómo funcionan las interfaces

Cada interface tiene un identificador único dentro de Guper. Cuando se configura, define un mapeo entre los datos del sistema de origen y los datos internos de Guper.

Ejemplo:

  • Interface — xpto1 (identificador único de la interface dentro de Guper)
  • categoryId — 45asd-5 (ID de categoría en el sistema de origen)

Después de pasar por el traductor de Guper, el dato queda estructurado así:

{
  "translatedFrom": "xpto1",
  "categoryRefId":  "45asd-5",
  "categoryId":     563
}
Campo Significado
translatedFrom Identifica qué interface realizó la conversión.
categoryRefId ID de referencia de la categoría en el sistema externo.
categoryId ID estandarizado interno reconocido dentro de Guper.

Este modelo asegura que los datos provenientes de distintos providers se conviertan correctamente y puedan usarse de forma unificada.

Dónde lo verás

La mayoría de las solicitudes de la API de Guper aceptan un campo interface en la raíz del payload (por ejemplo, "interface": "generic" o "interface": "vtex"). Ese campo le indica al engine qué traductor aplicar a los IDs que estás enviando.