IT-Recht

@sadu-dev/medusa-plugin-itrk

Copy to clipboard@sadu-dev/medusa-plugin-itrk is a Medusa v2 plugin that keeps your storefront legal pages in sync with updates from IT-Recht Kanzlei (Copy to clipboardhttps://www.it-recht-kanzlei.de/), a German legal content provider for ecommerce shops.

In practice, the plugin accepts IT-Recht Kanzlei XML updates, stores the latest document version per sales channel and language, and serves those documents through a store API so your frontend can always show current legal texts (for example terms and conditions, privacy policy, imprint, and withdrawal information).

Maintained by Copy to clipboardSADU Development e.U. at Copy to clipboardhttps://sadu.at.

Compatibility

• Node.js Copy to clipboard>=20
• Medusa packages Copy to clipboard>=2.12.0 <3

What it includes

• Copy to clipboardPOST /integrations/itrk for ITRK XML requests
• Copy to clipboardGET /store/itrk/:doc_type for storefront document retrieval
• A dedicated Copy to clipboarditrk module with persisted legal-document records
• Medusa plugin option validation via exported Zod schema

Install

1
pnpm add @sadu-dev/medusa-plugin-itrk

Then register the plugin in your Medusa backend's Copy to clipboardmedusa-config.ts file at the project root (Copy to clipboard<your-medusa-project>/medusa-config.ts):

1234567891011121314151617181920
import { defineConfig } from "@medusajs/framework/utils"
import type { ItrkPluginOptionsInput } from "@sadu-dev/medusa-plugin-itrk/types"

export default defineConfig({
  plugins: [
    {
      resolve: "@sadu-dev/medusa-plugin-itrk",
      options: {
        token: "your-itrk-token",
        channels: [
          {
            salesChannelId: "sc_...",
            accountId: "account-1",
            accountName: "Main Store",
            languages: ["de", "en"],
            countries: ["DE", "AT"],
            targetUrls: {
              agb: "https://store.example/legal/agb",
              datenschutz: "https://store.example/legal/privacy",
              impressum: "https://store.example/legal/imprint",

Copy to clipboardmeta_shopversion is derived automatically from the installed Copy to clipboard@medusajs/medusa version.

Choose the Copy to clipboardtoken value yourself and enter the same value in both Medusa and IT-Recht Kanzlei. IT-Recht Kanzlei does not issue or generate this token for you.

IT-Recht Kanzlei Setup

When configuring the API URL in IT-Recht Kanzlei, enter only your Medusa backend base URL.

Do not append Copy to clipboard/integrations/itrk manually.

Exported types

• Copy to clipboard@sadu-dev/medusa-plugin-itrk
• Copy to clipboard@sadu-dev/medusa-plugin-itrk/types

The package exports Copy to clipboarditrkPluginOptionsSchema, Copy to clipboardItrkPluginOptions, and Copy to clipboardItrkPluginOptionsInput.

Development

123
pnpm build
pnpm lint
pnpm test:unit

Publishing

The package is built with Medusa's plugin build command before publish:

12
pnpm build
npm publish

The published package contains the built Copy to clipboard.medusa/server output and package metadata only.

License

MIT