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:
{
"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.