---
title: 'Data interfaces'
description: 'Como a Guper traduz identificadores entre seus sistemas de origem e o modelo de dados interno.'
---

# Data interfaces

A Guper integra com diversos sistemas externos — **Bling, VTEX, Linx, Shopify** e outros. Cada integração é chamada de **Provider**, e dentro de cada provider existem diferentes **Sources** que representam a origem do dado.

Para organizar e padronizar informações vindas desses sistemas, a Guper usa um conceito chamado **Data Interface**. Uma interface atua como um tradutor entre os dados do sistema externo e o formato esperado internamente, garantindo que identificadores de cada plataforma mapeiem para as entidades corretas.

## Como uma interface funciona

Cada interface tem um identificador único dentro da Guper. Quando configurada, ela define um mapeamento entre os dados do sistema de origem e os dados internos da Guper.

**Exemplo:**

- Interface — `xpto1` (identificador único da interface dentro da Guper)
- categoryId — `45asd-5` (ID da categoria no sistema de origem)

Depois de passar pelo tradutor da Guper, o dado é estruturado assim:

```json
{
  "translatedFrom": "xpto1",
  "categoryRefId":  "45asd-5",
  "categoryId":     563
}
```

| Campo | Significado |
|---|---|
| `translatedFrom` | Identifica qual interface realizou a conversão. |
| `categoryRefId` | ID de referência da categoria no sistema externo. |
| `categoryId` | ID padronizado interno reconhecido pela Guper. |

Esse modelo garante que dados de diferentes providers sejam convertidos corretamente e possam ser usados de forma unificada.

## Onde isso aparece

A maioria das requisições da API Guper aceita um campo `interface` na raiz do payload (ex.: `"interface": "generic"` ou `"interface": "vtex"`). Esse campo diz ao engine qual tradutor aplicar nos IDs que você está enviando.
