The import process is achieved via exchange of data in CSV files. Files are deposited into a secure S3 bucket (see S3 Bucket Configuration) which trigger instant processing. The mechanism is meant to be a machine-to-machine exchange, where a reference system like a POS or ERP periodically export data to keep BSPK platform in sync.This method presents several benefits:
ETL (Extract, Transform, Load) is a common process for data exchange between systems and will be familiar to system integrators.
It performs at any scale. Initial data ingestion of millions of records is handled in the same way as an incremental change in a single record.
It’s asynchronous and fault tolerant.
Data files are broken down in discreet types. This reduces sending redundant data and clarify the behavior of each operation. Files can contain incremental changes or full data set. Each time a file is processed, the underlying data is created if new or updated its reference exists already.
Data import into BSPK is performed in real-time. New files are detected and processed immediately and concurrently. Sub-minute latency can be achieved if constant data synchronization is necessary or desired.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"BSPK Developers Portal","colors":{"primary":"#171717","light":"#d4a27f","dark":"#171717"},"logo":{"light":"https://mintcdn.com/bspk-e077910a/M_e-8v-SU7FdiAxW/logo/light.svg?fit=max\u0026auto=format\u0026n=M_e-8v-SU7FdiAxW\u0026q=85\u0026s=b5137e53c57326ab951b3cf58b3bd2b2","dark":"https://mintcdn.com/bspk-e077910a/r9DoYji8AsQ9Xhq5/logo/dark.png?fit=max\u0026auto=format\u0026n=r9DoYji8AsQ9Xhq5\u0026q=85\u0026s=8b586e85afe09eeb48dd8897216c20c0"},"favicon":"https://mintcdn.com/bspk-e077910a/r9DoYji8AsQ9Xhq5/favicon.png?fit=max\u0026auto=format\u0026n=r9DoYji8AsQ9Xhq5\u0026q=85\u0026s=53d517af69304679af79466ec82923c1","api":{"playground":{"display":"interactive"}},"background":{"color":{"light":"#fdfdf8","dark":"#09090b"}},"navbar":{"links":[{"href":"mailto:support@bspk.com","label":"Get Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.mintlify.com"}},"footer":{"socials":{"github":"https://github.com/bspk-www","linkedin":"https://www.linkedin.com/company/bspkluxury"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bspk-e077910a","hasAudioNarration":false,"actualSubdomain":"bspk-e077910a","customDomains":["developers.bspk.com"],"gitSource":{"type":"github","owner":"bspk-www","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6ac64d9b4c7e27d998eaaae8","clientVersion":"0.0.4271","searchFilterCounts":[{"language":"default","tag":"Documentation","count":117},{"language":"default","tag":"API Reference","count":57},{"language":"default","tag":"Platform API","count":22},{"language":"default","tag":"Core Data Integration Guide","count":19},{"language":"default","tag":"Import Files Specs","count":17},{"language":"default","tag":"Webhooks","count":12},{"language":"default","tag":"Extraction API","count":11},{"language":"default","tag":"Using the API","count":7},{"language":"default","tag":"Clients","count":7},{"language":"default","tag":"Shopper Addresses","count":6}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"core-data-integration/importing-data","slug":"/core-data-integration/importing-data","pageMetadata":{"title":"Importing Data","description":null,"href":"/core-data-integration/importing-data"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,li:`li`,p:`p`,ul:`ul`,..._provideComponents(),...props.components},{Info}=_components;if(!Info)_missingMdxReference(`Info`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The import process is achieved via exchange of data in CSV files. Files are deposited into a secure S3 bucket (see `,_jsx(_components.a,{href:`/s3-bucket-configuration`,children:`S3 Bucket Configuration`}),`) which trigger instant processing. The mechanism is meant to be a machine-to-machine exchange, where a reference system like a POS or ERP periodically export data to keep BSPK platform in sync.`]}),`\n`,_jsx(_components.p,{children:`This method presents several benefits:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`ETL (Extract, Transform, Load) is a common process for data exchange between systems and will be familiar to system integrators.`}),`\n`,_jsx(_components.li,{children:`It performs at any scale. Initial data ingestion of millions of records is handled in the same way as an incremental change in a single record.`}),`\n`,_jsx(_components.li,{children:`It’s asynchronous and fault tolerant.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`Data files are broken down in discreet types. This reduces sending redundant data and clarify the behavior of each operation. Files can contain incremental changes or full data set. Each time a file is processed, the underlying data is created if new or updated its reference exists already.`}),`\n`,_jsx(Info,{children:_jsx(_components.p,{children:`Data import into BSPK is performed in real-time. New files are detected and processed immediately and concurrently. Sub-minute latency can be achieved if constant data synchronization is necessary or desired.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Importing Data","description":null,"href":"/core-data-integration/importing-data"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"bspk-e077910a","siteName":"BSPK Developers Portal","title":"Importing Data - BSPK Developers Portal","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-18T21:01:41.913Z","originalFileLocation":"core-data-integration/importing-data.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"BSPK Developers Portal\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bspk-e077910a/_u2uKaCzDSXK5Flz/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/bspk-e077910a/_u2uKaCzDSXK5Flz/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bspk-e077910a/_u2uKaCzDSXK5Flz/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bspk-e077910a/_u2uKaCzDSXK5Flz/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bspk-e077910a/_u2uKaCzDSXK5Flz/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bspk-e077910a/_u2uKaCzDSXK5Flz/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bspk-e077910a/_u2uKaCzDSXK5Flz/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bspk-e077910a/_u2uKaCzDSXK5Flz/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bspk-e077910a/_u2uKaCzDSXK5Flz/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Importing Data - BSPK Developers Portal\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"BSPK Developers Portal\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.bspk.com/core-data-integration/importing-data\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bspk-e077910a.mintlify.site/_mintlify/api/og/v2?division=Core+Data+Integration+Guide\u0026amp;title=Importing+Data\u0026amp;theme=5cf8190f47e772cf17b525cc\u0026amp;signature=d86df26bcc3d88eb0a0710e36ae96e873df8881efa8d02ada0b865f7c25c5a28\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Importing Data - BSPK Developers Portal\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bspk-e077910a.mintlify.site/_mintlify/api/og/v2?division=Core+Data+Integration+Guide\u0026amp;title=Importing+Data\u0026amp;theme=5cf8190f47e772cf17b525cc\u0026amp;signature=d86df26bcc3d88eb0a0710e36ae96e873df8881efa8d02ada0b865f7c25c5a28\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/bspk-e077910a/_u2uKaCzDSXK5Flz/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"BSPK Developers Portal\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#171717\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.bspk.com/core-data-integration/importing-data\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/core-data-integration/importing-data.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.bspk.com/#organization\",\"name\":\"BSPK Developers Portal\",\"url\":\"https://developers.bspk.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/bspk-e077910a/M_e-8v-SU7FdiAxW/logo/light.svg?fit=max\u0026auto=format\u0026n=M_e-8v-SU7FdiAxW\u0026q=85\u0026s=b5137e53c57326ab951b3cf58b3bd2b2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.bspk.com#website\",\"name\":\"BSPK Developers Portal\",\"url\":\"https://developers.bspk.com\",\"publisher\":{\"@id\":\"https://developers.bspk.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.bspk.com/core-data-integration/importing-data#webpage\",\"url\":\"https://developers.bspk.com/core-data-integration/importing-data\",\"name\":\"Importing Data\",\"dateModified\":\"2026-09-18T21:01:41.913Z\",\"isPartOf\":{\"@id\":\"https://developers.bspk.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.bspk.com/core-data-integration/importing-data#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.bspk.com/core-data-integration/importing-data#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Core Data Integration Guide\",\"item\":\"https://developers.bspk.com/core-data-integration/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Importing Data\",\"item\":\"https://developers.bspk.com/core-data-integration/importing-data\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://developers.bspk.com/core-data-integration/importing-data#article\",\"headline\":\"Importing Data\",\"name\":\"Importing Data\",\"url\":\"https://developers.bspk.com/core-data-integration/importing-data\",\"mainEntityOfPage\":{\"@id\":\"https://developers.bspk.com/core-data-integration/importing-data#webpage\"},\"dateModified\":\"2026-09-18T21:01:41.913Z\",\"publisher\":{\"@id\":\"https://developers.bspk.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.bspk.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"BSPK Developers Portal\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"BSPK Developers Portal\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/core-data-integration/importing-data.md","siteName":"BSPK Developers Portal","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","tabs":[{"tab":"Documentation","groups":[{"group":"Get Started","pages":[{"title":"Welcome","href":"/welcome"},{"title":"Cloud Platform","href":"/cloud-enabled-saas-platform"},{"title":"Data Security \u0026 Privacy","href":"/data-security-and-privacy"},{"title":"Systems Architecture","href":"/systems-architecture"},{"title":"Integration with BSPK","href":"/integration-with-bspk"}]},{"group":"Core Data Integration Guide","pages":[{"title":"Introduction","description":null,"href":"/core-data-integration/introduction"},{"title":"Importing Data","href":"/core-data-integration/importing-data"},{"title":"Prerequisites for Imports","description":null,"href":"/core-data-integration/pre-reqs-to-import"},{"group":"Import Files Specs","pages":[{"title":"Sample Files","href":"/core-data-integration/sample-files"},{"title":"Store Regions","href":"/core-data-integration/file-types/store-regions"},{"title":"Stores","href":"/core-data-integration/file-types/stores"},{"title":"Sales Associates","href":"/core-data-integration/file-types/sales-associates"},{"title":"Shoppers","href":"/core-data-integration/file-types/shoppers"},{"title":"Shopper Addresses","href":"/core-data-integration/file-types/shopper-address"},{"title":"Products","href":"/core-data-integration/file-types/products"},{"title":"Product Variants","href":"/core-data-integration/file-types/product-variants"},{"title":"Product Prices","href":"/core-data-integration/file-types/product-prices"},{"title":"Product Inventory","href":"/core-data-integration/file-types/product-inventories"},{"title":"Product Images","href":"/core-data-integration/file-types/product-images"},{"title":"Sales","href":"/core-data-integration/file-types/sales"},{"title":"Metafields","href":"/core-data-integration/file-types/metafields"}]},{"title":"Supported ISO 4217 currencies","href":"/core-data-integration/supported-currencies"},{"title":"Supported ISO 639-1 languages","href":"/core-data-integration/supported-languages"},{"title":"Supported ISO 3166 countries","href":"/core-data-integration/supported-countries"}]},{"group":"Special Orders Integration Guide","pages":[{"title":"Introduction","href":"/special-orders-integration/introduction"},{"group":"Import Files Specs","pages":[{"title":"Sample Files","href":"/special-orders-integration/sample-files"},{"title":"Special Orders","href":"/special-orders-integration/file-types/special-orders"},{"title":"Special Order Line Items","href":"/special-orders-integration/file-types/special-order-line-items"},{"title":"Special Order Events","href":"/special-orders-integration/file-types/special-order-events"}]}]},{"group":"S3 Bucket Configuration","pages":[{"title":"S3 Buckets \u0026 Keys Management Guide","href":"/s3-bucket-configuration"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/getting-started"}]}]},{"anchor":"Get Support","icon":"envelope","href":"mailto:support@bspk.com"}]},"basePath":"","title":"Importing Data - BSPK Developers Portal","deploymentId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","buildId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","dynamics":[],"chunks":[]}