REST API, UCP, Serwer MCP, XML/JSON Feed, Kalendarz i Analityka — wszystko, czego potrzebują agenci AI oraz systemy ERP do integracji z europejskim rynkiem Scopio.
Wszystkie żądania wymagają tokenu Bearer. Wygeneruj swój klucz w Ustawienia konta → Integracje → Klucze API. Format: sk_mkt_...
Authorization: Bearer sk_mkt_YOUR_KEYapplication/jsonhttps://business.scopio.plSzybki test — 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}]'Odpowiedź
{"updated":1,"pending_review":0,"errors":0}Wszystkie metody akceptują parametry EAN + cena + ilość. Wybierz rozwiązanie pasujące do Twojego stosu technologicznego.
Synchronizacja w czasie rzeczywistym przez JSON. Przesyłaj tablicę produktów, do 10 000 na żądanie. EANy w naszym katalogu aktywują się natychmiast.
Wyślij katalog XML. Obsługa uniwersalnych formatów oraz Google Shopping RSS. Idealne dla systemów ERP.
Wskaż nam URL swojego feedu JSON. Będziemy go cyklicznie pobierać i przetwarzać automatycznie.
Prześlij plik Excel. Wymagane kolumny: EAN, Cena, Ilość. Integracja bez pisania kodu.
Zapisz dane serwera FTP raz. Będziemy pobierać Twój plik produktowy (JSON, XML lub CSV) na żądanie.
Standard JSON-RPC 2.0 dla agentów AI. Claude, ChatGPT i Gemini mogą bezpośrednio wywoływać narzędzia bazodanowe.
Kody EAN dopasowane → natychmiast widoczne na rynku
Nieznane kody EAN → w kolejce na weryfikację Google Merchant
Błędy walidacji ze szczegółami dla każdego produktu
Punkt końcowy JSON-RPC 2.0. Claude, ChatGPT, Gemini oraz dowolny inny agent mogą bezpośrednio odpytywać Scopio — bez konieczności ręcznego eksportu danych.
sync_productsPrzesyła tablicę produktów na rynek. Zwraca liczbę zaktualizowanych, oczekujących oraz błędów.
params: {"products": [{"ean": "string", "price": number, "qty": number}]}check_eanSprawdza dostępność kodu EAN w bazie Scopio. Zwraca status: live | pending | unknown.
params: {"ean": "string"}get_offersPobiera aktualnie aktywne oferty sprzedawcy.
params: {}Punkt końcowy
POST /api/seller/products/mcpPrzykładowe żądanie
{
"jsonrpc": "2.0",
"method": "sync_products",
"params": {
"products": [
{"ean":"8721199108286","price":29.99,"qty":10}
]
},
"id": 1
}Odpowiedź
{
"jsonrpc": "2.0",
"result": {"updated":1,"pending_review":0,"errors":0},
"id": 1
}Umożliwia agentom AI automatyczne sprawdzanie wolnych terminów i rezerwowanie spotkań w imieniu klientów.
Pobierz wolne terminy
GET /api/calendar/slots?date=2025-06-15&duration=30Zwraca: [{slot_id, start, end, available}]
Zarezerwuj termin
POST /api/calendar/book{
"slot_id": "...",
"client_name": "Jan Kowalski",
"client_email": "jan@firma.pl",
"service_name": "Demo call",
"duration": 30
}Zobacz, ile razy Claude, ChatGPT, Gemini i inni agenci wchodzili w interakcję z Twoimi produktami.
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}
]
}Skonfiguruj adres URL w swoim panelu. Będziemy wysyłać powiadomienia POST o zdarzeniach (np. order.placed) w czasie rzeczywistym.
Rejestracja webhooka
POST /api/seller/webhooks{
"url": "https://yourshop.pl/scopio-hook",
"events": ["order.placed","product.updated"]
}Zawartość — order.placed
{
"event": "order.placed",
"order_id": "ORD-2026-...",
"ean": "8721199108286",
"qty": 2,
"buyer_country": "DE",
"created_at": "2026-05-26T12:00:00Z"
}Zarządzaj integracją, synchronizuj produkty w standardzie EU GPSR oraz pobieraj zamówienia TikTok Shop.
/api/seller/tiktok/configZwraca status połączenia, nazwę sklepu, region oraz domyślne mapowania GPSR i magazynów.
/api/seller/tiktok/configZapisuje lub aktualizuje konfigurację połączenia z TikTok Shop, szablony wysyłki i ID dokumentów 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/warehousesPobiera listę magazynów z profilu logistycznego TikTok Shop, niezbędnych do synchronizacji stanów magazynowych.
/api/seller/tiktok/syncWymusza natychmiastową synchronizację ofert na TikTok Shop. Automatycznie sprawdza status EAN, tworzy produkt z pełnymi wymogami bezpieczeństwa UE (GPSR) lub aktualizuje ceny i stany.
Lista kodów EAN do zsynchronizowania (opcjonalnie, pusta tablica synchronizuje wszystko).
{
"eans": ["5901234123457", "5901234123464"]
}Odpowiedź
{
"success": true,
"synced_count": 2,
"created": 1,
"updated": 1,
"message": "TikTok EU Sync: 1 created, 1 updated."
}/api/seller/tiktok/ordersZwraca pobrane zamówienia z TikTok Shop. Użyj parametru ?refresh=1, aby odpytać bezpośrednio API TikToka.
Jakiej metody autoryzacji używa Scopio API?
Bearer API Key. Wygeneruj token sk_mkt_... w Ustawieniach konta. Dodaj nagłówek: Authorization: Bearer sk_mkt_...
Które pola są wymagane przy synchronizacji produktów?
Minimum: ean (tekst), price (liczba), qty (liczba całkowita). Przykład: [{"ean":"5901234123457","price":29.99,"qty":10}]
Czy Scopio wspiera protokół UCP (Universal Commerce Protocol)?
Tak. Scopio to pierwsza platforma w Europie wdrażająca standard UCP, umożliwiając agentom AI dynamiczne sprawdzanie ofert i bezproblemowe finalizowanie transakcji.
Jak działa integracja z TikTok Shop?
Jest w pełni automatyczna. Łączysz sklep przez OAuth, wybierasz ustawienia domyślne (dostawa, kategorie, magazyn, profile GPSR) i wywołujesz POST /api/seller/tiktok/sync dla kodów EAN. Scopio zajmie się resztą.
Czy agenci AI mogą rezerwować spotkania w Kalendarzu?
Tak. Endpoint GET /api/calendar/slots zwraca wolne terminy, a POST /api/calendar/book zatwierdza rezerwację spotkania.
Jak śledzić zapytania od robotów AI?
Wywołanie GET /api/seller/analytics zwraca statystyki z ostatnich 30 dni z podziałem na silniki LLM (Claude, ChatGPT, Gemini itp.), widoczne również w Twoim panelu.
Chcesz się zintegrować?
Wygeneruj klucz API, wybierz metodę integracji i wyślij pierwszy produkt. Otrzymasz natychmiastowe potwierdzenie.