Integração de dados
Visão geral
O Sipru é um copiloto de vendas para o balconista: durante o atendimento, ele sugere substitutos, cross-sell e upsell, e recompensa o vendedor em Sipru Points pelos produtos de maior margem e giro.
Este guia cobre o envio de dados — como o seu catálogo, as suas lojas e o seu histórico de venda chegam até a Sipru. É o que alimenta as recomendações: sem dado não há o que sugerir.
Para a integração em que o vendedor sai da cotação do seu ERP e cai no catálogo Sipru já autenticado, veja Integração ERP.
O que é preciso antes de começar
O onboarding com o time da Sipru entrega três coisas, e nenhuma delas está nesta documentação porque são específicas do seu parceiro:
- o bucket de destino;
- a Service Account com permissão de escrita nele;
- o seu identificador de parceiro, que nomeia a sua pasta.
Ver Suporte para iniciar.
Por onde começar
Responda três perguntas e você sabe exatamente o que fazer.
1. Você consegue exportar CSV do seu sistema?
Sim — é o caminho mais curto. Siga para a pergunta 2.
Não, ou não sei — peça um conector dedicado. O time da Sipru constrói e opera um extrator ligado direto ao seu banco ou ERP, e você não escreve código. Pode parar de ler aqui e escrever para sipru@sipru.ai.
2. Você já falou com o time da Sipru?
Não — comece por aí, porque três coisas só saem do onboarding e sem elas não há como enviar nada: o bucket de destino, a Service Account com permissão de escrita, e o seu identificador de parceiro.
Sim, já tenho as credenciais — siga para a pergunta 3.
3. Que dado você tem para mandar primeiro?
Sempre nesta ordem, porque as entidades se referenciam:
| Ordem | Entidade | Por quê |
|---|---|---|
| 1º | Lojas | todas as outras apontam para location_code |
| 2º | Produtos | todas as outras apontam para product_code |
| 3º | Orders | é o histórico que alimenta as recomendações |
| depois | Inventory, Preços | enriquecem, mas não bloqueiam |
Mandar venda antes de loja e produto faz as linhas serem recusadas por referência inexistente.
O caminho completo
- Monte o CSV seguindo o dicionário de dados.
- Nomeie o arquivo começando pela entidade — é o nome que define o que ele é.
- Deposite no bucket, pelo SDK ou arrastando no WinSCP.
- Passe a checklist antes de cada envio.
Não há confirmação a receber: os arquivos são processados assim que chegam. Se algo não aparecer, o nome do arquivo é o primeiro lugar para olhar.
Arquitetura
Os dados do parceiro chegam por dois caminhos, e ambos convergem para o mesmo pipeline de processamento e enriquecimento.
Os dois caminhos
Arquivo CSV no Cloud Storage. Você deposita arquivos em um bucket dedicado e eles são processados assim que chegam. É o caminho padrão e o mais usado.
→ Envio por arquivo CSV · Dicionário de dados
Conector dedicado. Se você não tem equipe para montar a exportação, o time da Sipru constrói e opera um extrator ligado direto ao seu sistema.
Qual dos dois escolher
| Se você… | use |
|---|---|
| já consegue exportar CSV do seu sistema | arquivo CSV |
| precisa de carga completa periódica | arquivo CSV |
| exporta em outro formato, ou só tem o banco | conector dedicado |
| não tem equipe técnica disponível | conector dedicado |
Se o seu ERP exporta com outros nomes, o time configura um mapeamento de colunas específico para o seu parceiro no momento do onboarding — você manda o CSV do jeito que o seu sistema já gera. O que não pode faltar é o dado; o nome da coluna a gente resolve.