---
title: 'Data interfaces'
description: 'Cómo Guper traduce identificadores entre tus sistemas de origen y su modelo de datos interno.'
---

# 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í:

```json
{
  "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.
