Sistema de Integração Hiper-Nuvemshop

API REST para sincronização automática entre ERP Hiper e Nuvemshop

📡 Endpoints Disponíveis
Use estes endpoints para sincronizar dados entre Hiper e Nuvemshop
POST /api/sync/products

Sincroniza todos os produtos do Hiper para a Nuvemshop (nome, SKU, preço, estoque, peso, dimensões, imagens)

POST /api/sync/stock-prices

Atualiza estoque e preços de todos os produtos mapeados

POST /api/webhook/nuvemshop

Webhook para receber pedidos da Nuvemshop (configure no painel da Nuvemshop)

GET /api/logs?limit=50

Retorna os logs recentes de sincronização

GET /api/mapping?limit=100

Retorna o mapeamento entre produtos do Hiper e Nuvemshop

GET /api/health

Health check da API

⚙️ Configuração
Configure as credenciais via variáveis de ambiente

HIPER_API_URL

URL base da API do Hiper

HIPER_API_KEY

Chave de segurança do Hiper (obtida em Vendas → Loja Virtual)

NUVEMSHOP_STORE_ID

ID da sua loja na Nuvemshop

NUVEMSHOP_ACCESS_TOKEN

Access token da API Nuvemshop

🚀 Exemplo de Uso
# Sincronizar produtos
curl -X POST https://hipernuvem-nyhgds2p.manus.space/api/sync/products

# Sincronizar estoque e preços
curl -X POST https://hipernuvem-nyhgds2p.manus.space/api/sync/stock-prices

# Ver logs
curl https://hipernuvem-nyhgds2p.manus.space/api/logs?limit=10
📚 Documentação Completa

Consulte o arquivo API_GUIDE.md no repositório para documentação detalhada de todos os endpoints, exemplos de integração e troubleshooting.

API de Sincronização Hiper-Nuvemshop

Desenvolvido para automatizar a transferência de dados entre sistemas