Product Downloads and Product Links

Example for JSON-call via Sync-API: POST http://www.mein-shop.de/api/_action/sync

[
    {
        "action": "upsert",
        "entity": "product",
        "payload": [
            {
                "id": "b851fd3085054856b83e1e693b5bbd1b",

               ...

                "acrisDownloads": [
                    {
                        "fileName": "ACRIS_12345_1_DE.pdf",
                        "title": "Benutzerhandbuch",
                        "position": 0,
                        "languages": [
                            {
                                "id": "2fbb5fe2e29a4d70aa5854ce7ce3e20b"
                            }
                        ]
                    },
                    {
                        "fileName": "ACRIS_12345_1_EN.pdf",
                        "title": "Manual",
                        "position": 0,
                        "languages": [
                            {
                                "id": "01896943f9847021b988cede9f40d445"
                            }
                        ]
                    }
                ]
            }
        ]
    }
]

Example for the API pattern of how should be links imported to the product via Sync-API.

[
    {
        "action": "upsert",
        "entity": "product",
        "payload": [
            {
                "id": "b851fd3085054856b83e1e693b5bbd1b",
                "acrisLinks": [
                    {
                        "url": "https://www.acris-ecommerce.at/",
                        "linkTarget": true,
                        "title": "Title for Link",
                        "description": "Description for Link",
                        "position": 1,
                        "languages": [
                            {
                                "id": "2fbb5fe2e29a4d70aa5854ce7ce3e20b"
                            }
                        ]
                    }
                ]
            }
        ]
    }
]

If the downloads have already been uploaded to the media in the Shopware Admin, then I can assign the downloads via API as follows:

{
  "id": "f947b036a41c4be38cdad7fddf13bd1d",

  "acrisDownloads": [
    {
      "mediaId": "11d0ac3beb2e4f738f72732739e108b0",
      "title": "Test file",
      "position": 0,
      "languages": [
        {
          "id": "2fbb5fe2e29a4d70aa5854ce7ce3e20b" 
        },
        {
          "id": "7a6b724e70614488bc10740313df0409" 
        }
      ]
    }
  ]
}

Example of a JSON call for the Sync API (UUID of the product, language and download entry must be known): POST http://www.my-shop.com/api/_action/sync

[
    {
        "key": "write",
        "action": "upsert",
        "entity": "product",
        "payload": [
            {
                "id": "0189f245a8047d0e928c3d3a702eeedc",
                "acrisDownloads": [
                    {
                        "id": "0189f2466f197d7b808601c970f8d034",
                        "title": "Download Title EN (default language)",
                        "description": "Download Description EN (default language)",
                        "translations": [
                            {
                                "languageId": "2fbb5fe2e29a4d70aa5854ce7ce3e20b",
                                "title": "Download Title EN (default language)",
                                "description": "Download Description EN (default language)"
                            },
                            {
                                "languageId": "0189d01b707a7298885830df99fcd93f",
                                "title": "Download Titel DE",
                                "description": "Download Description DE"
                            }
                        ]
                    }
                ]
            }
        ]
    }
]

Example of a JSON call for the Sync API (UUID of the download entry must be known): POST http://www.my-shop.com/api/_action/sync

[
    {
        "action": "delete",
        "payload": [
            {
                "id": "0189f2466f197d7b808601c970f8d034"
            }
        ],
        "entity": "acris_product_download"
    }
]

Yes, a download can be assigned to a download group. This download group in turn can only be made accessible to certain customer groups via a stored rule. Other rules and conditions are also possible here.

The API documentation is available at: https://api-docs.acris.at/#ab6cf374-b77f-4cad-8e67-00f7c6f20636