Shopify

Descrizione

Connettore enterprise per Shopify — la piattaforma e-commerce leader mondiale per SMB e mid-market (fondata 2006 a Ottawa, IPO 2015, 5M+ merchant attivi che processano $230B+ GMV annuo, base installata particolarmente forte in USA/EU/AUS per direct-to-consumer brands e drop-shipping store) via Admin REST API 2024-01 ufficiale. Quattro operazioni atomiche coprono il core retail flow: getOrder (recupera ordine specifico by orderId con tutti i line_items + customer + shipping_address + payment_status + fulfillment_status — pattern essenziale per ingest ordini downstream verso ERP/gestionale italiano); createOrder (crea ordine manualmente o conferma un draft order precedentemente preparato — utile per use case omnichannel B2B dove l'ordine arriva via email o telefono e va inserito in Shopify after-the-fact per consistency del data warehouse); listProducts (catalogo paginated fino a 250 item/request con cursor-based pagination per merchant con migliaia di SKU); createProduct (pubblica nuovo prodotto con multiple variants size/color, immagini galleria, metadata SEO, pricing tier-based per region o customer type, inventory tracking). Auth via Custom App Access Token (formato shpat_xxxxxxxx generato dall'admin Shopify in Apps → Develop apps → Configure Admin API scopes — granular permission read_orders, write_orders, read_products, write_products per least-privilege) usato come header X-Shopify-Access-Token stored nel vault integration FlowForge. Multi-shop supportato (agency che gestisce 10 store Shopify diversi di N customer brand). Validation enterprise pre-API: shopDomain validato sintatticamente come regex strict per matching solo *.myshopify.com (anti injection di dominio arbitrario nel URL builder, evita classic SSRF via user-controlled shopDomain). Pipeline standard FlowForge: SSRF-safe gateway, circuit-breaker per-host dedicato (un outage su un shop NON blocca workflow di altri shop), retry exponential backoff su 5xx e 429 transitori. Rate limit Shopify: 2 req/sec sustained for Basic/Shopify plan, 4 req/sec for Advanced/Plus — il nodo gestisce header X-Shopify-Shop-Api-Call-Limit con throttle anticipato a 80% del cap per evitare hard 429. Output: { orderId?, order? (con full object structure Shopify), products? (array paginated con cursor next_page_info), productId?, count? (totalCount when available), pageCursor? }. Use case enterprise italiani: sincronizza ordini Shopify verso gestionale italiano o Odoo per contabilità + magazzino unified (webhook order.created → workflow → action_odoo_create_lead in sale.order); crea automatic prodotti da feed XML fornitore (RSS o sftp drop → parse → loop → createProduct con immagini); notifica team su nuovo ordine via Slack/email con order summary + link al admin Shopify; popola CRM HubSpot/Salesforce con customer al checkout per nurturing post-acquisto; genera fattura elettronica italiana SDI all'evasione dell'ordine (collega con il modulo SDI/PEC del workflow stack); dashboard vendite real-time con metriche aggregate (cron orario + listProducts + per-product analytics + push su Google Sheets management).

⚙️ Parametri di configurazione

Campi mostrati nell’editor quando si configura il nodo. Generati direttamente dal NodeDefconfigFields.

💡 Esempio configurazione

Snippet JSON del nodo come compare nel workflow. I valori sono derivati daidefaultValue e dai parametri required.

{
  "id": "node-community_shopify-1",
  "defId": "community_shopify",
  "label": "Shopify",
  "config": {
    "operation": "getOrder",
    "limit": 50
  }
}

🔗 Nodi correlati nella stessa categoria