Produkt Downloads & Produkt Links

Hier ist ein API-Muster, wie Links über die Sync-API zum Produkt importiert werden sollten.

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

Beispiel eines JSON-Aufruf für die 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"
                            }
                        ]
                    }
                ]
            }
        ]
    }
]

Wenn die Downloads bereits in den Medien im Shopware Admin hochgeladen wurden, dann ich eine Zuordnung der Downloads via API wie folgt möglich:

{
  "id": "f947b036a41c4be38cdad7fddf13bd1d",

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

Beispiel eines JSON-Aufruf für die Sync-API (UUID des Produktes, der Sprache und des Download Eintrages müssen bekannt sein): POST http://www.mein-shop.de/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"
                            }
                        ]
                    }
                ]
            }
        ]
    }
]

Beispiel eines JSON-Aufruf für die Sync-API (UUID des Download Eintrages muss bekannt sein): POST http://www.mein-shop.de/api/_action/sync

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

Ja. Ein Download kann einer Download Gruppe zugeordnet werden. Diese Download Gruppe wiederum kann nur für bestimmte Kundengruppen über eine hinterlegte Regel zugänglich gemacht werden. Auch andere Regeln und Bedingungen sind hier denkbar.

Die API Dokumentation ist erreichbar unter: https://api-docs.acris.at/#ab6cf374-b77f-4cad-8e67-00f7c6f20636