---
title: 'Visão geral da integração'
description: 'Como a Guper se conecta aos seus sistemas de POS, Ecommerce e ferramentas de downstream.'
---

# Visão geral da integração

A Guper é construída sobre a **arquitetura MACH** — Microservices, API-first, Cloud-native e Headless — com o objetivo de gerar receita para o cliente através dos motores de Loyalty, Promoção e Analytics.

Esta página é uma visão geral de como a plataforma se conecta aos seus sistemas e onde cada API se encaixa.

## POS & Ecommerce

Integrações de POS e Ecommerce se comunicam com a **Integration API**, principalmente pelos endpoints de Checkout (ex.: [Acúmulo por pedido](/docs/{lang}/api-reference/loyalty/checkout/reward-by-order)), enviando os dados do pedido para o Guper Engine.

O **Guper Engine** é o componente central que avalia e aplica as regras de promoção e acúmulo em tempo real. Quando os dados chegam, o engine determina quais regras são elegíveis com base nas condições configuradas e retorna os **efeitos** correspondentes — cashback, pontos, descontos — para a camada de integração, para que sejam aplicados de forma instantânea e fluida durante a navegação e o checkout.

![Visão geral da integração](https://content.pstmn.io/b9730790-1d7f-4482-8711-3ec2950705bd/SW50ZWdyYXRpb24gTGFuZHNjYXBlLmRyYXdpby5wbmc=)

## Data Transfer

A camada de **Data Transfer** mantém seu CRM, ferramentas de BI, data lakes ou qualquer sistema downstream em sincronia com a última atividade de cliente e pedido.

Dois feeds dedicados publicam atualizações em tempo real:

- **Customer Feed** — toda vez que um cliente é criado, atualizado ou marcado.
- **Order Feed** — toda vez que um pedido é criado, modificado, cancelado ou tem acúmulos aplicados.

![Customer e Order feeds](https://content.pstmn.io/ae8e9afb-9c24-4aac-bdc1-df8fd4fe599f/RmVlZC5wbmc=)

As atualizações podem incluir:

- Novo cadastro de cliente ou pedido
- Mudanças de perfil ou status
- Itens adicionados ou removidos de um pedido
- Tags ou audiências adicionadas ou removidas
- Acúmulos ou promoções aplicadas ou revogadas
- E mais

Isso garante um fluxo de dados contínuo para analytics, relatórios e estratégias de engajamento.

## Próximos passos

- Configure seu acesso — veja [Autenticação](/docs/{lang}/guides/authentication).
- Entenda como a Guper mapeia seus dados em [Data Interfaces](/docs/{lang}/guides/interfaces).
