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.