API REST, UCP, Server MCP, feed XML/JSON, Calendario e Analisi — tutto ciò di cui gli agenti IA e i sistemi ERP hanno bisogno per connettersi al mercato europeo Scopio.
Tutti gli endpoint richiedono un token Bearer. Genera la tua chiave in Impostazioni account → Integrazioni → Chiavi API. Formato: sk_mkt_...
Authorization: Bearer sk_mkt_YOUR_KEYapplication/jsonhttps://business.scopio.plTest rapido — curl
curl -X POST \
https://business.scopio.pl/api/seller/products \
-H "Authorization: Bearer sk_mkt_..." \
-H "Content-Type: application/json" \
-d '[{"ean":"8721199108286","price":29.99,"qty":10}]'Risposta
{"updated":1,"pending_review":0,"errors":0}Tutti i metodi accettano EAN + prezzo + quantità. Scegli quello che meglio si adatta al tuo stack tecnologico.
Sincronizzazione JSON in tempo reale. Array di prodotti, fino a 10.000 per richiesta. Gli EAN nel nostro catalogo sono subito online.
Carica il catalogo XML. Formato generico e Google Shopping RSS supportati. Ideale per i sistemi ERP.
Indicaci l'URL del tuo feed JSON. Lo recupereremo e lo analizzeremo automaticamente a intervalli regolari.
Carica un file Excel. Colonne richieste: EAN, Prezzo, Quantità. Nessuna competenza di programmazione richiesta.
Salva le credenziali FTP una volta. Recuperiamo il tuo file di prodotto (JSON, XML o CSV) su richiesta.
Standard JSON-RPC 2.0 per agenti IA. Claude, ChatGPT e Gemini possono chiamare direttamente gli strumenti di database.
EAN abbinati → immediatamente online sul mercato
EAN sconosciuti → messi in coda per la verifica Google Merchant
Errori di validazione con dettagli per ciascun prodotto
Endpoint JSON-RPC 2.0. Claude, ChatGPT, Gemini e qualsiasi altro agente chiamano direttamente gli strumenti Scopio — nessuna esportazione manuale richiesta.
sync_productsTrasmette l'array di prodotti al mercato. Restituisce il numero di prodotti aggiornati, in revisione e con errori.
params: {"products": [{"ean": "string", "price": number, "qty": number}]}check_eanVerifica l'EAN nel catalogo Scopio. Restituisce lo stato: live | pending | unknown.
params: {"ean": "string"}get_offersRecupera le offerte attualmente attive sul mercato per il venditore autenticato.
params: {}Endpoint
POST /api/seller/products/mcpEsempio di richiesta
{
"jsonrpc": "2.0",
"method": "sync_products",
"params": {
"products": [
{"ean":"8721199108286","price":29.99,"qty":10}
]
},
"id": 1
}Risposta
{
"jsonrpc": "2.0",
"result": {"updated":1,"pending_review":0,"errors":0},
"id": 1
}Consente agli agenti IA di verificare la disponibilità e prenotare riunioni in modo autonomo per conto dei clienti.
Ottieni slot disponibili
GET /api/calendar/slots?date=2025-06-15&duration=30Restituisce: [{slot_id, start, end, available}]
Prenota uno slot
POST /api/calendar/book{
"slot_id": "...",
"client_name": "Jan Kowalski",
"client_email": "jan@firma.pl",
"service_name": "Demo call",
"duration": 30
}Scopri quante volte Claude, ChatGPT, Gemini e altri agenti hanno interagito con i tuoi prodotti.
GET /api/seller/analytics{
"total_30d": 142,
"by_type": {
"mcp_query": 98,
"product_query": 31,
"calendar_booking": 13
},
"by_agent": {
"claude": 67,
"chatgpt": 44,
"gemini": 31
},
"trend_7d": [
{"date":"2026-05-20","count":12}, ...
],
"top_products": [
{"ean":"8721199108286","count":23}
]
}Configura un URL di webhook nel tuo pannello. Invieremo notifiche POST sugli eventi (ad esempio, order.placed) in tempo reale.
Registra webhook
POST /api/seller/webhooks{
"url": "https://yourshop.pl/scopio-hook",
"events": ["order.placed","product.updated"]
}Dati utili — order.placed
{
"event": "order.placed",
"order_id": "ORD-2026-...",
"ean": "8721199108286",
"qty": 2,
"buyer_country": "DE",
"created_at": "2026-05-26T12:00:00Z"
}Gestisci le impostazioni di integrazione, sincronizza i prodotti in conformità con la normativa GPSR dell'UE e recupera gli ordini di TikTok Shop.
/api/seller/tiktok/configRestituisce lo stato della connessione, il nome del negozio, la regione e le mappature GPSR e magazzino predefinite.
/api/seller/tiktok/configSalva o aggiorna le impostazioni di connessione di TikTok Shop, i modelli di spedizione e gli ID GPSR.
{
"region": "PL",
"default_category_id": "602123",
"default_warehouse_id": "123456789",
"default_gpsr_manufacturer_id": "mfg_uuid",
"default_gpsr_responsible_person_id": "rp_uuid",
"auto_upload_products": true,
"sync_inventory_realtime": true
}/api/seller/tiktok/warehousesRecupera l'elenco dei magazzini attivi dal tuo profilo logistico TikTok Shop, necessario per gli aggiornamenti delle scorte.
/api/seller/tiktok/syncAvvia la sincronizzazione immediata delle offerte su TikTok Shop. Controlla lo stato dell'EAN, carica le immagini, imposta i dettagli di sicurezza GPSR dell'UE o aggiorna prezzi/stock.
Elenco degli EAN da sincronizzare (opzionale, un array vuoto sincronizza tutti i prodotti).
{
"eans": ["5901234123457", "5901234123464"]
}Risposta
{
"success": true,
"synced_count": 2,
"created": 1,
"updated": 1,
"message": "TikTok EU Sync: 1 created, 1 updated."
}/api/seller/tiktok/ordersRecupera gli ordini memorizzati nella cache di TikTok Shop. Utilizza il parametro ?refresh=1 per forzare l'aggiornamento in tempo reale dall'API di TikTok.
Quale metodo di autenticazione utilizza l'API Scopio?
Chiave API Bearer. Genera la tua chiave sk_mkt_... nel tuo account B2B. Aggiungi l'intestazione: Authorization: Bearer sk_mkt_...
Quali campi del prodotto sono richiesti per la sincronizzazione?
Minimo: ean (stringa), price (numero), qty (intero). Esempio: [{"ean":"5901234123457","price":29.99,"qty":10}]
L'API Scopio supporta l'UCP (Universal Commerce Protocol)?
Sì. Scopio è la prima piattaforma in Europa a implementare lo standard UCP, consentendo agli agenti IA di recuperare offerte in modo dinamico ed eseguire acquisti.
Come funziona l'integrazione di TikTok Shop?
È completamente automatica. Colleghi il tuo negozio tramite OAuth, imposti i valori predefiniti (spedizione, categoria, magazzino, profils GPSR) e chiami POST /api/seller/tiktok/sync con i codici EAN. Scopio fa il resto.
Gli agenti IA possono prenotare riunioni nel calendario?
Sì. La richiesta GET /api/calendar/slots restituisce gli slot liberi, mentre POST /api/calendar/book conferma la prenotazione.
Come monitorare le richieste dei robot IA?
La richiesta GET /api/seller/analytics restituisce le statistiche a 30 giorni suddivise per modello LLM (Claude, ChatGPT, Gemini, ecc.), visibili anche sul tuo dashboard.
Pronto per l'integrazione?
Genera la tua chiave API, scegli il tuo metodo di integrazione e invia il primo prodotto. Risposta istantanea.