Integrações de comércio eletrónico — importação, API e webhook para os seus sistemas
O 4pricing.net não tem conectores nem plugins prontos para ERP, WMS, plataformas de comércio eletrónico ou marketplaces. Os dados são movidos por si, de quatro formas: importação CSV com uma coluna de URL para a lista de produtos monitorizados, API REST para dados em direto, um webhook para alertas push e exportação CSV a pedido da lista de produtos, para BI ou Google Sheets (o histórico de preços lê-se através da API, não da exportação). A plataforma não executa exportações agendadas por si própria — se quiser um ficheiro a horas fixas, chama o endpoint de exportação a partir da sua própria tarefa.
Métodos de integração disponíveis
Não existe um único método correto — depende da sua infraestrutura e do volume do catálogo. Os caminhos mais simples são a importação CSV inicial e a exportação a pedido da lista de produtos, descarregada quando é necessária. As equipas com ERP próprio desenvolvem a ligação por si sobre a API REST ou os webhooks.
- Importação CSV com URL: carrega a lista de ligações diretas às páginas dos produtos que quer acompanhar, até 2000 linhas por importação
- API REST: a sua equipa pode obter dados atualizados a pedido para o seu próprio ERP/WMS, sem exportação intermédia
- Webhook: um URL por conta recebe notificações push de cada alerta de preço que criar
- Exportação CSV a pedido: descarregue a lista de produtos quando precisar, ou automatize-a a partir do seu próprio cron através da API; o histórico lê-se através da API
Importação do catálogo por CSV ou lista de URL
A importação inicial é feita por carregamento de um CSV com linha de cabeçalho e, no mínimo, a coluna url — a ligação para a página do produto no retalhista. Colunas opcionais: name, category, group e role (own ou competitor). Máximo de 2000 linhas por importação; os URL duplicados são ignorados. É o utilizador quem indica o URL de cada produto da concorrência a acompanhar: a plataforma não o procura automaticamente.
Vantagens e limitações
Vantagens
- Importação simples por CSV — não exige conhecimentos técnicos avançados
- API REST totalmente documentada, com OpenAPI, para integrações à medida
- Um URL de webhook por conta, que recebe cada tipo de alerta que criar (limite de preço, descida percentual, reposição de stock, concorrente que baixa abaixo de si, perda do preço mais baixo)
- Exportação CSV a pedido da lista de produtos, automatizável a partir do seu próprio cron através da API
Limitações
- A integração por API exige recursos de desenvolvimento do lado do cliente
- O webhook exige um URL http/https público permanentemente disponível (porta 80/443)
Veredicto rápido
A importação CSV é a forma mais simples de carregar a sua lista de produtos. A API e o webhook destinam-se a equipas com recursos técnicos que pretendem automatizar por si próprias a ligação aos seus sistemas.
Tabela de especificações
| Método | Esforço técnico | Latência dos dados |
|---|---|---|
| CSV manual | Mínimo | No carregamento |
| Exportação a pedido | Mínimo | No momento da transferência |
| API REST | Médio (desenvolvimento) | Da última verificação |
| Webhooks | Médio (desenvolvimento + endpoint) | Após a verificação que dispara o alerta |
Métodos de integração comparados
| Critério | CSV / Exportação | API / Webhooks |
|---|---|---|
| Esforço de implementação | Horas | Dias |
| Latência dos dados | No momento da transferência | Da última verificação |
| Escalabilidade | Limitada pelo trabalho manual | Automatizável pela sua equipa |
Perguntas frequentes
Que formato deve ter o ficheiro CSV para importação?
Uma linha de cabeçalho e, como única coluna obrigatória, url (a ligação da página do produto). Opcionais: name, category, group e role (own ou competitor). Máximo de 2000 linhas por importação; os URL duplicados são ignorados.
Posso integrar o 4pricing com o Google Sheets?
Sim, através da exportação CSV a pedido, que lista os seus produtos (não o histórico de preços). A plataforma não agenda exportações, mas o endpoint de exportação, chamado com o cabeçalho da sua chave de API, pode ser chamado a partir de um simples Apps Script, na periodicidade que definir no Google Sheets.
Quantos webhooks posso configurar e o que enviam?
Existe um URL de webhook por conta, que recebe todos os alertas que criar (assinados por HMAC): preço abaixo de um limite, preço acima de um limite, descida percentual, reposição de stock, um concorrente que baixa abaixo de si e perda da posição de preço mais baixo.
Existe integração nativa com plataformas de comércio eletrónico (WooCommerce, Shopify)?
Não. Não existem plugins nem conectores nativos para o WooCommerce, o Shopify ou outras plataformas de comércio eletrónico. O seu programador pode construir uma ligação sobre a API REST e os webhooks, ou pode usar a exportação CSV com as ferramentas de importação da plataforma: é trabalho a cargo do cliente.