--- title: "BigCommerce Konektor" description: "Kompletan vodič za integraciju BigCommercea za sinkronizaciju kupaca, narudžbi, proizvoda i podataka web-trgovine s Brevom putem Taja." url: https://tajo.io/hr/docs/connectors/ecommerce/bigcommerce/ markdown: https://tajo.io/hr/docs/connectors/ecommerce/bigcommerce.md lang: hr-HR robots: noindex --- Zatražite rani pristup Unesite ime i poslovnu adresu e-pošte. Poslat ćemo vam poveznicu za potvrdu zahtjeva za pristup Taju. # BigCommerce Konektor Status konektora: U izradi Gradi se. Još nije provjereno. | Izvorno polje | Odredišno polje | Primjer vrijednosti | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Povežite svoju BigCommerce trgovinu s Brevom putem Taja za potpunu sinkronizaciju e-commerce podataka. Sinkronizirajte kupce, narudžbe, proizvode i događaje košarice za pokretanje ciljanih marketinških kampanja, oporavka napuštenih košarica i automatizacija nakon kupnje. ## Pregled | Svojstvo | Vrijednost | | --- | --- | | **Platforma** | BigCommerce | | **Kategorija** | E-commerce | | **Složenost postavljanja** | Srednje | | **Službena integracija** | Ne | | **Sinkronizirani podaci** | Kupci, Narudžbe, Proizvodi, Košarice | | **Dostupne vještine** | 10 | ## Značajke - **Sinkronizacija kupaca** - Sinkronizacija podataka o kupcima u stvarnom vremenu s Brevo kontaktima - **Praćenje narudžbi** - Događaji životnog ciklusa narudžbi za tokove marketinga nakon kupnje - **Sinkronizacija kataloga proizvoda** - Sinkronizacija proizvoda za e-mail preporuke i dinamički sadržaj - **Napuštanje košarice** - Praćenje i oporavak napuštenih košarica automatiziranim e-mailovima - **Podrška za više web-trgovina** - Povežite više BigCommerce web-trgovina - **Ažuriranja putem webhookova** - Ažuriranja podataka u stvarnom vremenu putem BigCommerce webhookova - **Prilagođena polja** - Mapiranje BigCommerce prilagođenih polja na Brevo atribute kontakata - **Praćenje zaliha** - Sinkronizacija razina zaliha za obavijesti o ponovnoj dostupnosti ## Preduvjeti Prije nego što počnete, osigurajte da imate: 1. BigCommerce trgovinu s pristupom vlasnika ili administratora 2. BigCommerce API račun s odgovarajućim OAuth opsezima 3. Vaš Store Hash (pronađen u URL-u vaše trgovine ili API vjerodajnicama) 4. Brevo račun s API pristupom 5. Tajo račun s API vjerodajnicama ## Autentifikacija ### Vjerodajnice API računa BigCommerce koristi OAuth-based API račune. Kreirajte ih u vašoj BigCommerce upravljačkoj ploči pod **Postavke > API > API Računi**. Primit ćete: - **Client ID** - Identifikator vaše aplikacije - **Client Secret** - Tajna vaše aplikacije (pohranite sigurno) - **Access Token** - Koristi se za API autentifikaciju - **Store Hash** - Vaš jedinstveni identifikator trgovine ```bash curl https://api.bigcommerce.com/stores/{store_hash}/v3/catalog/products \ -H "X-Auth-Token: YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -H "Accept: application/json" ``` ### Potrebni OAuth opsezi | Opseg | Pristup | Namjena | | --- | --- | --- | | `store_v2_customers` | Čitanje | Sinkronizacija podataka o kupcima | | `store_v2_orders` | Čitanje | Praćenje događaja narudžbi | | `store_v2_products` | Čitanje | Sinkronizacija kataloga proizvoda | | `store_cart` | Čitanje | Praćenje napuštenih košarica | | `store_v2_information` | Čitanje | Konfiguracija trgovine | | `store_v2_content` | Čitanje | Sadržaj web-trgovine | ## Konfiguracija ### Osnovna konfiguracija ```yaml connectors: bigcommerce: enabled: true store_hash: "your-store-hash" access_token: "your-access-token" client_id: "your-client-id" # Opcije sinkronizacije podataka sync: customers: true orders: true products: true carts: true inventory: false # Dodjela Brevo popisa lists: all_customers: 40 buyers: 41 abandoned_cart: 42 ``` ### Mapiranje polja kupaca Mapirajte polja kupaca BigCommercea na Brevo atribute: ```yaml customer_mapping: email: email first_name: FIRSTNAME last_name: LASTNAME phone: SMS company: COMPANY # Polja adrese addresses[0].city: CITY addresses[0].state: STATE addresses[0].country: COUNTRY addresses[0].zip: ZIP # E-commerce metrike orders_count: ORDER_COUNT total_spent: TOTAL_SPENT date_created: SIGNUP_DATE # Grupa kupaca customer_group_id: CUSTOMER_GROUP ``` ### Konfiguracija webhookova ```yaml webhooks: - scope: "store/customer/created" destination: "customer_created" - scope: "store/customer/updated" destination: "customer_updated" - scope: "store/order/created" destination: "order_placed" - scope: "store/order/updated" destination: "order_updated" - scope: "store/order/statusUpdated" destination: "order_status_changed" - scope: "store/cart/created" destination: "cart_created" - scope: "store/cart/updated" destination: "cart_updated" - scope: "store/cart/abandoned" destination: "cart_abandoned" - scope: "store/inventory/updated" destination: "inventory_changed" ``` ## API krajnje točke | Metoda | Krajnja točka | Opis | | --- | --- | --- | | `GET` | `/v3/customers` | Popis kupaca | | `POST` | `/v3/customers` | Kreiraj kupce | | `PUT` | `/v3/customers` | Ažuriraj kupce | | `GET` | `/v2/orders` | Popis narudžbi | | `GET` | `/v2/orders/{id}` | Dohvati detalje narudžbe | | `GET` | `/v3/catalog/products` | Popis proizvoda | | `GET` | `/v3/catalog/products/{id}` | Dohvati detalje proizvoda | | `GET` | `/v3/catalog/products/{id}/variants` | Popis varijanti proizvoda | | `GET` | `/v3/carts` | Popis košarica | | `GET` | `/v3/abandoned-carts` | Popis napuštenih košarica | | `POST` | `/v3/hooks` | Kreiraj webhook | | `GET` | `/v3/catalog/categories` | Popis kategorija | ## Primjeri koda ### Inicijalizacija BigCommerce konektora ```javascript import { TajoClient } from '@tajo/sdk'; const tajo = new TajoClient({ apiKey: process.env.TAJO_API_KEY, brevoApiKey: process.env.BREVO_API_KEY }); // Povežite BigCommerce trgovinu await tajo.connectors.connect('bigcommerce', { storeHash: process.env.BC_STORE_HASH, accessToken: process.env.BC_ACCESS_TOKEN, clientId: process.env.BC_CLIENT_ID }); ``` ### Dohvaćanje i sinkronizacija kupaca ```javascript // Dohvatite kupce iz BigCommercea const response = await fetch( `https://api.bigcommerce.com/stores/${STORE_HASH}/v3/customers?limit=250`, { headers: { 'X-Auth-Token': ACCESS_TOKEN, 'Content-Type': 'application/json' } } ); const { data, meta } = await response.json(); // data: [{ id, email, first_name, last_name, phone, ... }] // meta.pagination: { total, count, per_page, current_page, total_pages } ``` ### Rukovanje webhook događajima ```javascript // Handler za BigCommerce webhookove app.post('/webhooks/bigcommerce', async (req, res) => { const { scope, store_id, data } = req.body; // Verificirajte da webhook dolazi iz vaše trgovine if (store_id !== process.env.BC_STORE_HASH) { return res.status(401).send('Unauthorized'); } // Proslijedite Taju await tajo.connectors.handleWebhook('bigcommerce', { topic: scope, payload: data }); res.status(200).send('OK'); }); ``` ### Sinkronizacija kataloga proizvoda ```javascript // Potpuna sinkronizacija kataloga proizvoda await tajo.connectors.sync('bigcommerce', { type: 'full', resources: ['products'], includeVariants: true, includeImages: true }); // Provjera statusa sinkronizacije const status = await tajo.connectors.status('bigcommerce'); console.log(status); // { // connected: true, // lastSync: '2024-01-15T10:30:00Z', // customersCount: 8200, // ordersCount: 4500, // productsCount: 620 // } ``` ## Ograničenja brzine | Plan | Ograničenje | Detalji | | --- | --- | --- | | **Standard** | 150 zahtjeva/30 sek | Po trgovini | | **Plus** | 300 zahtjeva/30 sek | Po trgovini | | **Pro** | 450 zahtjeva/30 sek | Po trgovini | | **Enterprise** | Neograničeno | Prilagođena ograničenja | Dodatna ograničenja: | Resurs | Ograničenje | | --- | --- | | **Webhookovi** | 100 po trgovini | | **Po stranici** | Maks. 250 zapisa | | **Istovremeni zahtjevi** | Ovisno o planu | Zaglavlja ograničenja brzine Pratite zaglavlja `X-Rate-Limit-Requests-Left` i `X-Rate-Limit-Time-Reset-Ms` kako biste upravljali korištenjem API-ja unutar ograničenja. ## Rješavanje problema | Problem | Uzrok | Rješenje | | --- | --- | --- | | `401 Unauthorized` | Nevažeći pristupni token | Regenerirajte API vjerodajnice u BigCommerce administraciji | | `403 Forbidden` | Nedostaje OAuth opseg | Provjerite opsege API računa i dodajte potrebne dozvole | | Webhookovi se ne pokreću | Dostignut limit webhookova | Provjerite broj webhookova (maks. 100) i uklonite nekorištene | | Nedostaju događaji košarice | Skripte za praćenje nisu učitane | Verificirajte skriptu za praćenje na BigCommerce web-trgovini | | Proizvodi nisu sinkronizirani | Predmemorija kataloga | Pokrenite ručnu sinkronizaciju ili pričekajte ažuriranja webhookova | | `429 Too Many Requests` | Premašeno ograničenje brzine | Implementirajte redoslijed zahtjeva s praćenjem zaglavlja ograničenja brzine | | Nedostaju grupe kupaca | V2 vs V3 API | Grupe kupaca koriste V2 API; provjerite verziju krajnje točke | ## Preporučene prakse 1. **Koristite V3 API gdje je moguće** - V3 API nudi bolju paginaciju, filtriranje i JSON odgovore 2. **Pratite zaglavlja ograničenja brzine** - Pratite `X-Rate-Limit-Requests-Left` kako biste izbjegli prekoračenje limita 3. **Registrirajte webhookove za sinkronizaciju u stvarnom vremenu** - Koristite webhookove umjesto anketiranja za ažuriranja kupaca i narudžbi 4. **Skupna ažuriranja kupaca** - Koristite V3 skupne krajnje točke za kupce za velike sinkronizacije podataka 5. **Uključite varijante u sinkronizaciju proizvoda** - Sinkronizacija varijanti proizvoda za točno praćenje zaliha 6. **Postavite webhookove za napuštene košarice** - Kritično za automatizaciju e-maila za oporavak košarice 7. **Koristite paginaciju** - Uvijek paginirajte krajnje točke za popise; maks. 250 zapisa po stranici ## Sigurnost - **OAuth autentifikacija tokenom** - Siguran API pristup temeljen na tokenu - **Opsežene dozvole** - API računi ograničeni na specifične opsege podataka - **Samo HTTPS** - Sva API komunikacija šifrirana putem TLS-a - **Verifikacija webhookova** - Verificirajte izvor webhookova koristeći store hash - **PCI DSS usklađenost** - BigCommerce sigurno rukuje podacima o plaćanju - **SOC 2 Type II** - BigCommerce platforma je SOC 2 certificirana ## Povezani resursi - [Shopify Konektor](https://tajo.io/hr/docs/connectors/ecommerce/shopify) - [WooCommerce Konektor](https://tajo.io/hr/docs/connectors/ecommerce/woocommerce) - [Vještina sinkronizacije korisnika](https://tajo.io/hr/docs/skills/data-sync/customer-sync) - [Vještina napuštene košarice](https://tajo.io/hr/docs/skills/email-marketing/abandoned-cart)