PHPackages sas/esd - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. sas/esd ActiveShopware-platform-plugin sas/esd ======= ESD / Download plugin 2.0.0(2y ago)2985[9 issues](https://github.com/Shape-and-Shift/shopware-esd/issues)[3 PRs](https://github.com/Shape-and-Shift/shopware-esd/pulls)proprietaryJavaScriptCI failing Since Aug 25Pushed 1mo ago1 watchersCompare [ Source](https://github.com/Shape-and-Shift/shopware-esd)[ Packagist](https://packagist.org/packages/sas/esd)[ RSS](/packages/sas-esd/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (6)Versions (51)Used By (0) ESD / Product downloads for Shopware 6 ====================================== [](#esd--product-downloads-for-shopware-6) You can finally offer digital downloads to your customers. After purchasing an ESD / download product, the customer will be able to download the product within his account within a new download section. Installation ------------ [](#installation) Go to your project root folder and execute the following commands: `cd custom/plugins` `git clone git@github.com:Shape-and-Shift/shopware-esd.git SasEsd` `bin/console plugin:refresh && bin/console plugin:install SasEsd --activate` The plugin is now installed and activated. Setup of an ESD product ----------------------- [](#setup-of-an-esd-product) Each product will have a new tab called **ESD** where you can upload a file and/or assign serial numbers. A product will automaticlly be an ESD product if one of those cases are true. [![](https://camo.githubusercontent.com/d18b4a3bfe9276b9978ac5c6ec3d2bd30651bceb4f36532bf483b22b7d332aa2/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539323230343039352f455344253230446f63732f42696c6473636869726d666f746f5f323032302d30362d31355f756d5f30392e35322e33325f7375736372782e706e67)](https://camo.githubusercontent.com/d18b4a3bfe9276b9978ac5c6ec3d2bd30651bceb4f36532bf483b22b7d332aa2/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539323230343039352f455344253230446f63732f42696c6473636869726d666f746f5f323032302d30362d31355f756d5f30392e35322e33325f7375736372782e706e67) All files which will be uploaded here are **private** which means they're not visible within the Media Manager, or available to the public. ### Serial numbers [](#serial-numbers) If you check the toggle **Enable serial numbers** a new card will be visible where you can create or import your serial numbers. [![](https://camo.githubusercontent.com/01207530fb645b6ca3fcb17ababb31369ab0f1394595af614679676d711c10c9/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539323230343330382f455344253230446f63732f42696c6473636869726d666f746f5f323032302d30362d31355f756d5f30392e35372e35355f6b666e6a356a2e706e67)](https://camo.githubusercontent.com/01207530fb645b6ca3fcb17ababb31369ab0f1394595af614679676d711c10c9/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539323230343330382f455344253230446f63732f42696c6473636869726d666f746f5f323032302d30362d31355f756d5f30392e35372e35355f6b666e6a356a2e706e67) #### Manually import serial numbers [](#manually-import-serial-numbers) If you want to manually add serial numbers a modal will be opened where you can type in your serial numbers manually. Each new line is a new serial number. [![](https://camo.githubusercontent.com/2ac352dcc390937b22c3df4e78de9138f6bd7d2d969ee8f3d4808e9e2fcc10d4/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539323230343535342f455344253230446f63732f42696c6473636869726d666f746f5f323032302d30362d31355f756d5f31302e30322e32375f6a796a6f30302e706e67)](https://camo.githubusercontent.com/2ac352dcc390937b22c3df4e78de9138f6bd7d2d969ee8f3d4808e9e2fcc10d4/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539323230343535342f455344253230446f63732f42696c6473636869726d666f746f5f323032302d30362d31355f756d5f31302e30322e32375f6a796a6f30302e706e67) After clicking the button **import serial numbers** those will be directly listed within the serial number table. [![](https://camo.githubusercontent.com/61be6e8d91f0620d6d7f2096799614a4299f99ea6f12554086e870cd6f4527bc/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539323230343539342f455344253230446f63732f42696c6473636869726d666f746f5f323032302d30362d31355f756d5f31302e30332e30355f6a35396a616d2e706e67)](https://camo.githubusercontent.com/61be6e8d91f0620d6d7f2096799614a4299f99ea6f12554086e870cd6f4527bc/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539323230343539342f455344253230446f63732f42696c6473636869726d666f746f5f323032302d30362d31355f756d5f31302e30332e30355f6a35396a616d2e706e67) If a customer now buys the ESD article the next free serial number will be assigned to the customer. [![](https://camo.githubusercontent.com/960b19dd9736f510a2760e3a750916070a02b378c76257136e1946975830c7b1/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539323230343639332f455344253230446f63732f42696c6473636869726d666f746f5f323032302d30362d31355f756d5f31302e30342e33315f77706b6e6b682e706e67)](https://camo.githubusercontent.com/960b19dd9736f510a2760e3a750916070a02b378c76257136e1946975830c7b1/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539323230343639332f455344253230446f63732f42696c6473636869726d666f746f5f323032302d30362d31355f756d5f31302e30342e33315f77706b6e6b682e706e67) Storefront customer Account --------------------------- [](#storefront-customer-account) Within the storefront the customer will have a new menu entry called **Downloads**where all ESD products will be listed. [![](https://camo.githubusercontent.com/963c693778097866d1998259e568e5b0d762944ec694d39b5eb0f545f32ca0cc/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539323230333637352f455344253230446f63732f42696c6473636869726d666f746f5f323032302d30362d31355f756d5f30392e34362e31325f613677706f6c2e706e67)](https://camo.githubusercontent.com/963c693778097866d1998259e568e5b0d762944ec694d39b5eb0f545f32ca0cc/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539323230333637352f455344253230446f63732f42696c6473636869726d666f746f5f323032302d30362d31355f756d5f30392e34362e31325f613677706f6c2e706e67) To manually create or import serial numbers from a CSV file, just click on of the buttons which fits your needs. [![](https://camo.githubusercontent.com/faacfc062e5738a9348bb92b50f19d8e5d54f849298e041964bd91bf137567e6/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539323230343433342f455344253230446f63732f42696c6473636869726d666f746f5f323032302d30362d31355f756d5f30392e35392e35395f7569693971772e706e67)](https://camo.githubusercontent.com/faacfc062e5738a9348bb92b50f19d8e5d54f849298e041964bd91bf137567e6/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539323230343433342f455344253230446f63732f42696c6473636869726d666f746f5f323032302d30362d31355f756d5f30392e35392e35395f7569693971772e706e67) Only ESD products where the payment status is set to **paid** will be listed here **or**if the ESD product is for free e.g €0,00 If the ESD product contains a serial number, it will also be listed. [![](https://camo.githubusercontent.com/148f3fda6557064cfac6a0987201d8dafb82307cd4be6f09fff67da32cb45c13/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539323230333636352f455344253230446f63732f42696c6473636869726d666f746f5f323032302d30362d31355f756d5f30392e34372e33325f6c75696767372e706e67)](https://camo.githubusercontent.com/148f3fda6557064cfac6a0987201d8dafb82307cd4be6f09fff67da32cb45c13/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539323230333636352f455344253230446f63732f42696c6473636869726d666f746f5f323032302d30362d31355f756d5f30392e34372e33325f6c75696767372e706e67) Tax rates --------- [](#tax-rates) You might want to have different tax rates depending on the country where the buyer comes from. Within the administration go to `settings->tax` and add your new tax-group, for example "ESD tax rates". Now you add the different countries with it's tax rates. For example you can add Germany with a 19% tax rate. You also have to choose a default tax rate. So if you're not logged in for example and therefore don't have a shipping country yet, you will see the default tax rate. **Please double check the VAT rates, to be 100% sure those are correct.** [![](https://camo.githubusercontent.com/8c79f07361cfef3ae96b182fc35328a1ec49c20aa7f639a3988159eadd903c3d/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539323230323732322f455344253230446f63732f42696c6473636869726d666f746f5f323032302d30362d31355f756d5f30392e32392e32375f6e646d6a696b2e706e67)](https://camo.githubusercontent.com/8c79f07361cfef3ae96b182fc35328a1ec49c20aa7f639a3988159eadd903c3d/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539323230323732322f455344253230446f63732f42696c6473636869726d666f746f5f323032302d30362d31355f756d5f30392e32392e32375f6e646d6a696b2e706e67) You need to assign this **ESD tax group** to your article. Go to your ESD product and select the **ESD** tax group within the price section. [![](https://camo.githubusercontent.com/52e616eaac07d4c3a2fa13a3fd72e9f01a4c368af02553046d5bf37dd03c5e98/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539323230323732332f455344253230446f63732f42696c6473636869726d666f746f5f323032302d30362d31355f756d5f30392e33302e35395f69756d7261702e706e67)](https://camo.githubusercontent.com/52e616eaac07d4c3a2fa13a3fd72e9f01a4c368af02553046d5bf37dd03c5e98/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539323230323732332f455344253230446f63732f42696c6473636869726d666f746f5f323032302d30362d31355f756d5f30392e33302e35395f69756d7261702e706e67) Now: If your shop is based for example in Germany ( 19% VAT ) and a customer from Portugal ( 23% VAT ) is ordering an ESD article within your shop - The ESD product will be taxed with the 23% VAT from Portugal, and not with 19% from Germany. [![](https://camo.githubusercontent.com/ccb700659d646597ce1c45d40cd97336777cbdaee38c635d98232f63bf7fa288/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539323230333231352f455344253230446f63732f42696c6473636869726d666f746f5f323032302d30362d31355f756d5f30392e33382e35395f7561676b63312e706e67)](https://camo.githubusercontent.com/ccb700659d646597ce1c45d40cd97336777cbdaee38c635d98232f63bf7fa288/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539323230333231352f455344253230446f63732f42696c6473636869726d666f746f5f323032302d30362d31355f756d5f30392e33382e35395f7561676b63312e706e67) Add serial numbers via API endpoint ----------------------------------- [](#add-serial-numbers-via-api-endpoint) Thanks to the new concept of Shopware 6 it's easy peasy to create new serial numbers with the API. You just have to make a **POST** request to the API endpoint `/api/v2/sas-product-esd-serial`. Within the `body` you need three parameters. - `esdId` which is the ID of the ESD article - `serial` which represents the actual serial number - `id` which has to be a random generated UUID Full **POST** example to the endpoint `/api/v2/sas-product-esd-serial`: ``` { "esdId":"e60281b55f584ccf87d722f51af8499b", "serial":"testAPI", "id":"a695aac053234fd3a6ab79e57a4229fb" } ``` So a fully working request would look like this example with Postman [![](https://camo.githubusercontent.com/30292842b5f6b63d8a406cbf4698ff620de14091e95a3ae591c5e36db1bf037c/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539333738353532392f42696c6473636869726d666f746f5f323032302d30372d30335f756d5f31362e35382e32325f706e7a6371692e706e67)](https://camo.githubusercontent.com/30292842b5f6b63d8a406cbf4698ff620de14091e95a3ae591c5e36db1bf037c/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539333738353532392f42696c6473636869726d666f746f5f323032302d30372d30335f756d5f31362e35382e32325f706e7a6371692e706e67) Be sure to have a valid oauth token to be able to make requests to the admin API [![](https://camo.githubusercontent.com/36149cebd18b27eebc7ebb8388125620125d99ff1e0ecde6f5aef84682feee32/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539333738353533302f42696c6473636869726d666f746f5f323032302d30372d30335f756d5f31362e35382e33395f6466357670722e706e67)](https://camo.githubusercontent.com/36149cebd18b27eebc7ebb8388125620125d99ff1e0ecde6f5aef84682feee32/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313539333738353533302f42696c6473636869726d666f746f5f323032302d30372d30335f756d5f31362e35382e33395f6466357670722e706e67)Add your digital media to the product ------------------------------------- [](#add-your-digital-media-to-the-product) To add the digital media to the product, we will use the [Bulk Edit API](https://shopware.stoplight.io/docs/admin-api/adminapi.json/paths/~1_action~1sync/post) to do it. First, we need to upload a media file if it doesn't exist in our store, you can take a look at the Admin-API how to add a media file [here](https://shopware.stoplight.io/docs/admin-api/c5267f85b987c-create-a-new-media-resources). After finished adding the media you've got the mediaId, we will use it to add to the product through the Bulk Edit API with my example below. Full **POST** example to the endpoint `/api/_action/sync`: ``` [ { "key": "write", "action": "upsert", "entity": "product", "payload": [ { "id": "d930fd29db604957bc18f98530e06c47", "versionId": "0fa91ce3e96a4bc2be4bd9ce752c3425", "esd": { "id": "4b3f70ce628949fcb6d4e8a2d295f5cc", "esdMedia": [ { "mediaId": "01bb489a85e14f1085cf814c110f5f85" } ] } } ] } ] ``` Explain: - `payload.id` is productId - `payload.versionId` is product.versionId - `esd.id` is the esd id of this product, and if your product doesn't have it, you can generate a new one - `esd.esdMedia.mediaId` is the media ID you want to add to the product So a fully working request would look like this example with testing tool [![](https://camo.githubusercontent.com/5695096d94761928f0103c776f8d8c68147a5b68c1b01e6c21d3c9239eb7f522/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f646c70347764336e672f696d6167652f75706c6f61642f76313633303239333437312f53637265656e73686f745f66726f6d5f323032312d30382d33305f31302d31362d33325f69756b69776d2e706e67)](https://camo.githubusercontent.com/5695096d94761928f0103c776f8d8c68147a5b68c1b01e6c21d3c9239eb7f522/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f646c70347764336e672f696d6167652f75706c6f61642f76313633303239333437312f53637265656e73686f745f66726f6d5f323032312d30382d33305f31302d31362d33325f69756b69776d2e706e67) A practice for creating a product with digital media attached``` [ { "key": "write", "action": "upsert", "entity": "product", "payload": [ { "id": "d47aa1700fa248e5b147861c54aab3f5", "taxId": "c4ccbc056e41461bbd0f07a1f68d7013", "featureSetId": "4a6d48155744418e889cdc6ba132df79", "price": [ { "currencyId": "b7d2554b0ce847cd82f3ac9bd1c0dfca", "net": 84.033613445378, "linked": true, "gross": 100 } ], "productNumber": "SW10000", "stock": 100, "active": true, "purchasePrices": [ { "currencyId": "b7d2554b0ce847cd82f3ac9bd1c0dfca", "net": 0, "linked": true, "gross": 0 } ], "name": "esd product", "visibilities": [ { "id": "8480748ab62a43e89d674eef687c8bab", "productId": "d47aa1700fa248e5b147861c54aab3f5", "salesChannelId": "f864c45dcb0c4e8bba36287f9bd29a0a", "visibility": 30 } ], "esd": { "id": "7921470085d740ec88f0daa912a93d70", "esdMedia": [ { "mediaId": "01bb489a85e14f1085cf814c110f5f85" } ] } } ] } ] ``` Re-Send ESD mail for an order ----------------------------- [](#re-send-esd-mail-for-an-order) In version `1.2.11` we added the ability to send the ESD mail again from an order. Just go to your order and scroll a bit down until the **ESD Mail Service** section, to send the mail again to your customer [![](https://camo.githubusercontent.com/9881d73e8a4546dbc93e968863b80a3a7c6da42b6395d36e186a0913ec1f2875/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313630373237313436342f455344253230446f63732f42696c6473636869726d666f746f5f323032302d31322d30365f756d5f31382e31302e32325f70676c316b342e706e67)](https://camo.githubusercontent.com/9881d73e8a4546dbc93e968863b80a3a7c6da42b6395d36e186a0913ec1f2875/68747470733a2f2f7265732e636c6f7564696e6172792e636f6d2f6474676468376e6f7a2f696d6167652f75706c6f61642f76313630373237313436342f455344253230446f63732f42696c6473636869726d666f746f5f323032302d31322d30365f756d5f31382e31302e32325f70676c316b342e706e67)*send the ESD mail again* ### Health Score 42 — FairBetter than 90% of packages Maintenance54 Moderate activity, may be stable Popularity16 Limited adoption so far Community19 Small or concentrated contributor base Maturity68 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~63 days Recently: every ~269 days Total 33 Last Release 49d ago Major Versions 1.6.3 → 2.0.02023-10-07 2.x-dev → 3.x-dev2025-05-26 3.x-dev → 4.0.1.x-dev2026-03-30 ### Community Maintainers ![](https://www.gravatar.com/avatar/8253bf879c9d31a84ae4aa2b02d25b21554aba9909d85dfef43835103f58fbeb?d=identicon)[Christopher Dosin](/maintainers/Christopher%20Dosin) --- Top Contributors [![ChristopherDosin](https://avatars.githubusercontent.com/u/8193345?v=4)](https://github.com/ChristopherDosin "ChristopherDosin (106 commits)")[![hungmac-sw](https://avatars.githubusercontent.com/u/60767402?v=4)](https://github.com/hungmac-sw "hungmac-sw (65 commits)")[![vunguyenshapeandshift](https://avatars.githubusercontent.com/u/99628995?v=4)](https://github.com/vunguyenshapeandshift "vunguyenshapeandshift (16 commits)")[![huytdq94](https://avatars.githubusercontent.com/u/9761062?v=4)](https://github.com/huytdq94 "huytdq94 (7 commits)")[![nguyenngon95](https://avatars.githubusercontent.com/u/43599834?v=4)](https://github.com/nguyenngon95 "nguyenngon95 (6 commits)")[![patrickleo175](https://avatars.githubusercontent.com/u/144329952?v=4)](https://github.com/patrickleo175 "patrickleo175 (5 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")[![ermindedicss](https://avatars.githubusercontent.com/u/85760616?v=4)](https://github.com/ermindedicss "ermindedicss (2 commits)")[![bpv-wh](https://avatars.githubusercontent.com/u/60095542?v=4)](https://github.com/bpv-wh "bpv-wh (2 commits)")[![GM-Alex](https://avatars.githubusercontent.com/u/1454864?v=4)](https://github.com/GM-Alex "GM-Alex (1 commits)")[![crisalder2806](https://avatars.githubusercontent.com/u/24885765?v=4)](https://github.com/crisalder2806 "crisalder2806 (1 commits)")[![arosenhagen](https://avatars.githubusercontent.com/u/50462?v=4)](https://github.com/arosenhagen "arosenhagen (1 commits)")[![s-bessing](https://avatars.githubusercontent.com/u/4758319?v=4)](https://github.com/s-bessing "s-bessing (1 commits)") --- Tags digital-downloadesdshopwareshopware-pluginshopware6shopware6-plugindownloadesd ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StyleECS Type Coverage Yes ### Embed Badge ![Health badge](/badges/sas-esd/health.svg) ``` [![Health](https://phpackages.com/badges/sas-esd/health.svg)](https://phpackages.com/packages/sas-esd) ``` ### Alternatives [shopware/production 178190.0k](/packages/shopware-production)[kiener/mollie-payments-plugin Mollie Payments 6257.6k](/packages/kiener-mollie-payments-plugin)[werkstattl/openblogware OpenBlogware: A Blog Module for Shopware 6. 415.7k](/packages/werkstattl-openblogware)[unzerdev/shopware6 Unzer payment integration for Shopware 6 1125.6k](/packages/unzerdev-shopware6)[adyen/adyen-shopware6 Official Shopware 6 Plugin to connect to Payment Service Provider Adyen 23111.2k](/packages/adyen-adyen-shopware6)[basecom/sw6-fixtures-plugin basecom Fixtures Plugin 18185.5k](/packages/basecom-sw6-fixtures-plugin) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)