diff --git a/.changeset/rotten-shoes-smash.md b/.changeset/rotten-shoes-smash.md new file mode 100644 index 000000000..05b4820ac --- /dev/null +++ b/.changeset/rotten-shoes-smash.md @@ -0,0 +1,5 @@ +--- + +--- + +Data importer app was removed from the repository, this means it will be no longer deployed. diff --git a/.github/labeler.yml b/.github/labeler.yml index bcfc77ed2..7161dd97d 100644 --- a/.github/labeler.yml +++ b/.github/labeler.yml @@ -1,4 +1,3 @@ -"App: Data Importer": "apps/data-importer/**/*" "App: Klaviyo": "apps/klaviyo/**/*" "App: Product Feed": "apps/products-feed/**/*" "App: Search": "apps/search/**/*" diff --git a/CODEOWNERS b/CODEOWNERS index e122a2665..c03ea48f7 100644 --- a/CODEOWNERS +++ b/CODEOWNERS @@ -4,7 +4,6 @@ /apps/avatax @saleor/shopex-js /apps/cms-v2 @saleor/merchant-js -/apps/data-importer @saleor/merchant-js /apps/klaviyo @saleor/merchant-js /apps/products-feed @saleor/merchant-js /apps/search @saleor/merchant-js diff --git a/README.md b/README.md index 9c7c8b5f1..800a246b2 100644 --- a/README.md +++ b/README.md @@ -47,7 +47,6 @@ In the `apps` folder, you will find the following applications: - [avatax](./apps/avatax) - calculates dynamic taxes via AvaTax API - [cms](./apps/cms-v2) - exports products from Saleor to CMS. -- [data-importer](./apps/data-importer) - import data from CSV to Saleor. - [klaviyo](./apps/klaviyo) - send Saleor events to Klaviyo, where you can notify the customers. - [products-feed](./apps/products-feed) - generate products feed XML - [search](./apps/search) - connect Saleor with search engines. diff --git a/apps/data-importer/.env.example b/apps/data-importer/.env.example deleted file mode 100644 index 64db2b15a..000000000 --- a/apps/data-importer/.env.example +++ /dev/null @@ -1,13 +0,0 @@ -# https://getnuvo.com/ -NEXT_PUBLIC_NUVO_LICENSE_KEY= -NEXT_PUBLIC_NUVO_PROD_MODE=false - -APP_LOG_LEVEL=info - -# Local development variables. When developped locally with Saleor inside docker, these can be set to: -# APP_IFRAME_BASE_URL = http://localhost:3000, so Dashboard on host can access iframe -# APP_API_BASE_URL=http://host.docker.internal:3000 - so Saleor can reach App running on host, from the container. -# If developped with tunnels, set this empty, it will fallback to default Next's localhost:3000 -# https://docs.saleor.io/docs/3.x/developer/extending/apps/local-app-development -# APP_IFRAME_BASE_URL= -# APP_API_BASE_URL= \ No newline at end of file diff --git a/apps/data-importer/.eslintrc.cjs b/apps/data-importer/.eslintrc.cjs deleted file mode 100644 index 43b419408..000000000 --- a/apps/data-importer/.eslintrc.cjs +++ /dev/null @@ -1,8 +0,0 @@ -module.exports = { - root: true, - extends: ["saleor"], - parserOptions: { - project: "tsconfig.json", - tsconfigRootDir: __dirname, - }, -}; diff --git a/apps/data-importer/.graphqlrc.yml b/apps/data-importer/.graphqlrc.yml deleted file mode 100644 index b0db306eb..000000000 --- a/apps/data-importer/.graphqlrc.yml +++ /dev/null @@ -1,19 +0,0 @@ -schema: graphql/schema.graphql -documents: [graphql/**/*.graphql, src/**/*.ts, src/**/*.tsx] -extensions: - codegen: - overwrite: true - generates: - generated/graphql.ts: - config: - dedupeFragments: true - plugins: - - typescript - - typescript-operations - - typescript-urql: - documentVariablePrefix: "Untyped" - fragmentVariablePrefix: "Untyped" - - typed-document-node - generated/schema.graphql: - plugins: - - schema-ast diff --git a/apps/data-importer/CHANGELOG.md b/apps/data-importer/CHANGELOG.md deleted file mode 100644 index bd905eb7c..000000000 --- a/apps/data-importer/CHANGELOG.md +++ /dev/null @@ -1,474 +0,0 @@ -# saleor-app-data-importer - -## 1.12.9 - -### Patch Changes - -- fe5d5d5e: Updated @saleor/app-sdk to 0.50.3. This version removes the limitation of body size for the webhook payloads. - -## 1.12.8 - -### Patch Changes - -- 2bc8c187: Now, the flag "bundlePagesExternals" is enabled, this means the cold-starts time were reduced for this app. - -## 1.12.7 - -### Patch Changes - -- 45a47156: Updated @saleor/app-sdk to 0.50.2. No functional changes are introduced - -## 1.12.6 - -### Patch Changes - -- 6fed4b19: Migrate to new newest MacawUI version. Functionally nothing has changed. UI may look a bit different but it will be on par with Dashboard UI. -- Updated dependencies [6fed4b19] - - @saleor/apps-shared@1.11.2 - -## 1.12.5 - -### Patch Changes - -- e38c1417: You can now find how to run and test each app in README file - -## 1.12.4 - -### Patch Changes - -- 17077505: Updated TypeScript version to 4.5.4. -- Updated dependencies [17077505] - - @saleor/sentry-utils@0.2.3 - - @saleor/apps-shared@1.11.1 - -## 1.12.3 - -### Patch Changes - -- fbdbaa28: Remove custom Next.js + Sentry error. It was causing non existing paths to be reported as 500 instead of 404. We catch Sentry errors in implicit anyway in api routes. -- Updated dependencies [fbdbaa28] - - @saleor/sentry-utils@0.2.2 - -## 1.12.2 - -### Patch Changes - -- 2f59041c: Reverted shared Sentry configuration (init() part). It was not working properly - source maps were not properly assigned. Now configuration is not shared, but repeated in every app separately -- Updated dependencies [2f59041c] - - @saleor/sentry-utils@0.2.1 - -## 1.12.1 - -### Patch Changes - -- 0c4ba39f: Update next.js config after Sentry rollback. - -## 1.12.0 - -### Minor Changes - -- c4dcb863: Remove Pino logger library. It was already deprecated but for non migrated apps it was causing build errors. Right now we have one logger - @saleor/app-logger pkg. -- 1a9912f5: Setup Sentry inside Next.js instrumentation file. It ensures that Sentry works properly for serverless environment. - -### Patch Changes - -- 37ecb246: Update pnpm to 9.2.0 version. It means that we also dropped support for Node.js less than 16. -- cc047b1d: Downgraded Sentry package to v7. Previous upgrade to 8.x cause Sentry to conflict with Open Telemetry setup and Sentry was not working -- Updated dependencies [37ecb246] -- Updated dependencies [c4dcb863] -- Updated dependencies [1a9912f5] - - @saleor/sentry-utils@0.2.0 - - @saleor/apps-shared@1.11.0 - -## 1.11.3 - -### Patch Changes - -- 64d88b24: Update packages to ESM. See node [docs](https://nodejs.org/api/esm.html) for more info. -- 5cbd3b63: Updated @saleor/app-sdk package to 0.50.1 -- Updated dependencies [64d88b24] -- Updated dependencies [5cbd3b63] - - @saleor/apps-shared@1.10.3 - -## 1.11.2 - -### Patch Changes - -- 4ffef6be: Update `@sentry/nextjs` to 8.0.0 version. It should help us with attaching additional data to Sentry errors. -- 2604ce1e: Updated Next.js to 14.2.3 -- Updated dependencies [2604ce1e] - - @saleor/apps-shared@1.10.2 - -## 1.11.1 - -### Patch Changes - -- Updated dependencies [f22f2b8a] - - @saleor/apps-shared@1.10.1 - -## 1.11.0 - -### Minor Changes - -- b29318a2: Currently, Dashboard requires from a user to have "MANAGE_APPS" to have access to the apps tab. - Since the release 3.20 Dashboard will allow all users to access to apps tabs without checking permission. - This means that apps will be checking if the user has "MANAGE_APPS" internally and show message "You do not have permission to access this page" if the user does not have the permission. - -### Patch Changes - -- Updated dependencies [b29318a2] - - @saleor/apps-shared@1.10.0 - -## 1.10.5 - -### Patch Changes - -- 29d10d4a: Update Next.js to version 14.1.0. -- Updated dependencies [29d10d4a] - - @saleor/apps-shared@1.9.4 - -## 1.10.4 - -### Patch Changes - -- Updated dependencies [67afe8e4] - - @saleor/apps-shared@1.9.3 - -## 1.10.3 - -### Patch Changes - -- 5f564a0: Updated @saleor/app-sdk to 0.47.2 - -## 1.10.2 - -### Patch Changes - -- 531e7c1: Disabled Sentry tracing and Replays by default - -## 1.10.1 - -### Patch Changes - -- 99f7066: Updated Macaw UI to 1.0.0-pre.7. Removed legacy Material UI dependency from older Macaw. Code was updated to work properly with some API changes -- Updated dependencies [99f7066] - - @saleor/apps-shared@1.9.2 - -## 1.10.0 - -### Minor Changes - -- a50df02: Reduced Sentry traces sample rate to 0.1 - -## 1.9.9 - -### Patch Changes - -- fdabc51: Mapped app-sdk package to root library -- Updated dependencies [fdabc51] - - @saleor/apps-shared@1.9.1 - -## 1.9.8 - -### Patch Changes - -- 148a6d7: Updated Sentry to 7.77.0 - -## 1.9.7 - -### Patch Changes - -- 5dee65a: Updated dependencies: - - @graphql-codegen/cli@5.0.0 -- 2e29699: Updated Sentry package - -## 1.9.6 - -### Patch Changes - -- Updated dependencies [e8660e8] -- Updated dependencies [e8660e8] -- Updated dependencies [e8660e8] -- Updated dependencies [e8660e8] - - @saleor/apps-shared@1.9.0 - -## 1.9.5 - -### Patch Changes - -- a81f061: Updated Macaw to pre-127 -- fcc37e7: Remove clsx package from the projects no longer using it. -- Updated dependencies [2a1385b] -- Updated dependencies [a81f061] -- Updated dependencies [fcc37e7] - - @saleor/apps-shared@1.8.1 - -## 1.9.4 - -### Patch Changes - -- 8b3d961: Updated Macaw UI to pre.118 -- Updated dependencies [8b3d961] -- Updated dependencies [c50797e] - - @saleor/apps-shared@1.8.0 - -## 1.9.3 - -### Patch Changes - -- 261957f: Updated dependencies: vite, vitest, eslint, prettier, dotenv, turbo, syncpack, changesets, lint staged -- Updated dependencies [261957f] - - @saleor/apps-shared@1.7.6 - -## 1.9.2 - -### Patch Changes - -- 2fab86b: Updated graphql package to 16.7.1 and @graphql-codegen related dependencies to the latest version. -- aa6fec1: Updated Macaw UI to pre-106 -- Updated dependencies [aa6fec1] - - @saleor/apps-shared@1.7.5 - -## 1.9.1 - -### Patch Changes - -- 70cb741: Update Zod to 3.21.4 -- e7c2d3a: Updated and ESLint dependencies -- 3c6cd4c: Updated the @saleor/app-sdk package to version 0.41.1. -- Updated dependencies [70cb741] -- Updated dependencies [e7c2d3a] -- Updated dependencies [3c6cd4c] - - @saleor/apps-shared@1.7.4 - -## 1.9.0 - -### Minor Changes - -- a1f083c: Filled "about" field in App Manifest. Dashboard will display it in app details page now. -- 47102ba: Added additional ENV variables (see each app's .env.example), that can overwrite app base URL. This change allows easy apps development using Docker - -### Patch Changes - -- 2d77bca: Updated Next.js to 13.4.8 -- 6299e06: Update @saleor/app-sdk to 0.41.0 -- Updated dependencies [2d77bca] -- Updated dependencies [6299e06] - - @saleor/apps-shared@1.7.3 - -## 1.8.0 - -### Minor Changes - -- 1dead1e: Included dedicated logo and attached it to App's manifest. From Saleor 3.15 the logo will be visible in the Dashboard during and after installation. - -### Patch Changes - -- 860bac4: Updated @saleor/app-sdk to 0.40.1 -- a1ad70e: Updated configuration and dependencies of GraphQL client - urql. - All applications use now unified config for creating the client. Also unused related packages has been removed. -- ec68ed5: Updated Sentry package and config. Set Sentry release to match package.json version. Now Sentry will use semver version instead a commit -- cb6ee29: Updated dependencies -- Updated dependencies [860bac4] -- Updated dependencies [a1ad70e] -- Updated dependencies [cb6ee29] -- Updated dependencies [a1ad70e] - - @saleor/apps-shared@1.7.2 - -## 1.7.6 - -### Patch Changes - -- a8834a1: Unified graphql version to 16.6 -- a8834a1: Unified graphql codegen packages -- a8834a1: Removed unnecessary duplicated dependencies from apps and moved them to shared and root (types, eslint rules) -- a8834a1: Updated dev dependencies - Typescript, Eslint and Turborepo -- Updated dependencies [a8834a1] -- Updated dependencies [a8834a1] -- Updated dependencies [a8834a1] -- Updated dependencies [a8834a1] - - @saleor/apps-shared@1.7.1 - -## 1.7.5 - -### Patch Changes - -- 0c2fc65: Update dev dependencies - Vite and Vitest. These changes will not affect runtime Apps, but can affect tests and builds -- Updated dependencies [0c2fc65] -- Updated dependencies [b75a664] - - @saleor/apps-shared@1.7.0 - -## 1.7.4 - -### Patch Changes - -- 6e69f4f: Update app-sdk to 0.39.1 -- Updated dependencies [6e69f4f] - - @saleor/apps-shared@1.6.1 - -## 1.7.3 - -### Patch Changes - -- Updated dependencies [23b5c70] - - @saleor/apps-shared@1.6.0 - -## 1.7.2 - -### Patch Changes - -- c406318: Updated dep @saleor/app-sdk to 0.38.0 -- Updated dependencies [c406318] - - @saleor/apps-shared@1.5.1 - -## 1.7.1 - -### Patch Changes - -- 8b22b1c: Restored Pino logger packages to each app, to fix failing logs in development. Also updated .env.example to contain up to date APP_LOG_LEVEL variable - -## 1.7.0 - -### Minor Changes - -- 830cfe9: Changed APP_DEBUG env to APP_LOG_LEVEL - -### Patch Changes - -- Updated dependencies [830cfe9] - - @saleor/apps-shared@1.5.0 - -## 1.6.0 - -### Minor Changes - -- 57f6d41: Updated Manifest to contain up to date support, privacy, homepage and author fields - -### Patch Changes - -- 2c0df91: Added lint:fix script, so `eslint --fix` can be run deliberately -- e167e72: Update next.js to 13.3.0 -- 74174c4: Updated @saleor/app-sdk to 0.37.3 -- 2e51890: Update next.js to 13.3.0 -- 2e51890: Update @saleor/app-sdk to 0.37.2 -- 2e51890: Use useDashboardNotification hook from shared package, instead of direct AppBridge usage -- Updated dependencies [2c0df91] -- Updated dependencies [e167e72] -- Updated dependencies [74174c4] -- Updated dependencies [2e51890] -- Updated dependencies [2e51890] -- Updated dependencies [2e51890] - - @saleor/apps-shared@1.4.0 - -## 1.5.1 - -### Patch Changes - -- eca52ad: Replace "export default" with named exports - - @saleor/apps-shared@1.3.0 - -## 1.5.0 - -### Minor Changes - -- 7cb3b89: Added "author" field to the Manifest, set it to Saleor Commerce, so Dashboard can display it too - -### Patch Changes - -- 7cb3b89: Replace apps to avoid AppPermission (use Permission for client permissions) and authData.domain (use saleorApiUrl) -- 7cb3b89: Updated @saleor/app-sdk to 0.37.1 - -## 1.4.3 - -### Patch Changes - -- e93a4dc: Updated GraphQL Code Generator package - -## 1.4.2 - -### Patch Changes - -- dca82bb: Update app-sdk to pre-0.34.0. Update Async Webhooks to use new API - -## 1.4.1 - -### Patch Changes - -- 2755ed2: Added extra padding on top of the app so it has some space between content and dashboard header -- 2755ed2: Change main title header to be smaller - -## 1.4.0 - -### Minor Changes - -- 2d23480: Remove TitleBar component from apps, because it is moved to Dashboard, outside of iframe context -- 3e612ca: App now is configured with Sentry Wizard and will log to sentry if proper env variables are set - -### Patch Changes - -- Updated dependencies [2d23480] - - @saleor/apps-shared@1.3.0 - -## 1.3.0 - -### Minor Changes - -- 289b42f: Breaking change for app maintainers: VercelAPL can no longer be set for the app since it's deprecated and will be removed in app-sdk 0.30.0. As a replacement, we recommend using Upstash APL or implementing your own. - Read more about APLs: https://github.com/saleor/saleor-app-sdk/blob/main/docs/apl.md -- 1da5be3: Add dark mode styling -- 1da5be3: Enable origins check for installation via env variables - - Update app-sdk - - Set Nuvo development mode based on env variables - -### Patch Changes - -- 6327586: Add naive dark mode by inverting colors -- 1da5be3: Add valid icon and color - -## 1.2.0 - -### Minor Changes - -- 1c9b2c4: Change public app names to be more readable - -### Patch Changes - -- Updated dependencies [5fc88ed] - - @saleor/apps-shared@1.2.0 - -## 1.1.3 - -### Patch Changes - -- b874d10: Update @saleor/app-sdk to 0.29.0 -- Updated dependencies [648d99b] - - @saleor/apps-shared@1.1.1 - -## 1.1.2 - -### Patch Changes - -- 9f843b2: Update imports to @saleor/apps-shared -- 9f843b2: Remove generated folders form git history -- Updated dependencies [9f843b2] -- Updated dependencies [9f843b2] -- Updated dependencies [9f843b2] -- Updated dependencies [9f843b2] -- Updated dependencies [9f843b2] - - @saleor/apps-shared@1.1.0 - -## 1.1.1 - -### Patch Changes - -- a641caf: Extract isInIframe to new shared package and use it in apps -- Updated dependencies [a641caf] - - @saleor/apps-shared@1.0.1 - -## 1.1.0 - -### Minor Changes - -- 7aabcdc: Update dependencies diff --git a/apps/data-importer/README.md b/apps/data-importer/README.md deleted file mode 100644 index 154c6b01e..000000000 --- a/apps/data-importer/README.md +++ /dev/null @@ -1,78 +0,0 @@ -
- -
- -
-

Saleor App Data importer

- -

Data Importer uses [Nuvo](https://www.getnuvo.com/) to batch import customers data to Saleor from sources like CSV or Excel

-
- -### How to use this project - -#### Requirements - -- [node v20](https://nodejs.org) -- [pnpm](https://pnpm.io/) -- [ngrok](https://ngrok.com/) -- Saleor Cloud account (free!) or local instance -- [Nuvo](https://www.getnuvo.com/) account - -#### Running app in development mode - -1. Install the dependencies by running the following command in the shell: - -```shell -pnpm install -``` - -2. Create a file named `.env` and use the contents of the [`.env.example`](./.env.example) file as a reference. - -3. Set you `NEXT_PUBLIC_NUVO_LICENSE_KEY` in [`.env`](./.env). [Here](./docs/configuration.md) you can find how to get the key - -4. Start the development server by running the following command in the shell: - -```shell -pnpm dev -``` - -5. Data importer app will be available under `http://localhost:3000` - -6. Tunnel the app by running: - -```shell -ngrok http localhost:3000 -``` - -> [!NOTE] -> See [How to tunnel an app](https://docs.saleor.io/developer/extending/apps/developing-with-tunnels) for more info. - -7. Go to Dashboard, open `Apps` tab and click `Install external app`, provide your tunnel URL with the path for the manifest file. For example `${YOUR_TUNNEL_URL}/api/manifest` - -### How to use - -[Here](./docs/howToUse.md) you can find doc how to use the app - -### Generated schema and typings - -Commands `build` and `dev` would generate schema and typed functions using Saleor's GraphQL endpoint. Commit `generated` folder to your repo as they are necessary for queries and keeping track of the schema changes. - -[Learn more](https://www.graphql-code-generator.com/) about GraphQL code generation. - -### Storing registration data - APL - -During the registration process, Saleor API passes the auth token to the app. With this token, the App can query Saleor API with privileged access (depending on permissions requested during installation). -To store this data, app-template uses a different [APL interface](https://github.com/saleor/saleor-app-sdk/blob/main/docs/apl.md). - -The choice of the APL is done using `APL` environment variable. If the value is not set, FileAPL is used. Available choices: - -- `file`: no additional setup is required. Good choice for local development. Can't be used for multi tenant-apps or be deployed (not intended for production) -- `upstash`: use [Upstash](https://upstash.com/) Redis as storage method. Free account required. Can be used for development and production and supports multi-tenancy. Requires `UPSTASH_URL` and `UPSTASH_TOKEN` environment variables to be set - -If you want to use your own database, you can implement your own APL. [Check the documentation to read more.](https://github.com/saleor/saleor-app-sdk/blob/main/docs/apl.md) - -### Learn more about Saleor Apps - -[Apps guide](https://docs.saleor.io/docs/3.x/developer/extending/apps/key-concepts) - -[Configuring apps in dashboard](https://docs.saleor.io/docs/3.x/dashboard/apps) diff --git a/apps/data-importer/docs/configuration.md b/apps/data-importer/docs/configuration.md deleted file mode 100644 index 4cbb77b8a..000000000 --- a/apps/data-importer/docs/configuration.md +++ /dev/null @@ -1,6 +0,0 @@ -## How to configure the Data importer app - -1. Go to [Nuvo](https://www.getnuvo.com/) and create new account or login -2. Navigate to the `SDK` tab then `Setup` -3. Here you can find your key - ![nuvo-key.png](./images/nuvo-key.png) diff --git a/apps/data-importer/docs/data/example.csv b/apps/data-importer/docs/data/example.csv deleted file mode 100644 index 753815c3a..000000000 --- a/apps/data-importer/docs/data/example.csv +++ /dev/null @@ -1,3 +0,0 @@ -firstName,lastName,email,note,extRef -Anna,Test,anna@saleor.io,note,asz1 -Anna2,Test,anna2@saleor.io,note,asz2 \ No newline at end of file diff --git a/apps/data-importer/docs/howToUse.md b/apps/data-importer/docs/howToUse.md deleted file mode 100644 index 0b0205d01..000000000 --- a/apps/data-importer/docs/howToUse.md +++ /dev/null @@ -1,9 +0,0 @@ -## How to test Data importer app - -1. Take [example](./data/example.csv) file -2. Import it -3. Set mapping - ![field-mapping.png](./images/field-mapping.png) -4. Proceed to the next steps -5. At the end you should see imported clients - ![customers.png](./images/customers.png) diff --git a/apps/data-importer/docs/images/customers.png b/apps/data-importer/docs/images/customers.png deleted file mode 100644 index a1cf0e5b7..000000000 Binary files a/apps/data-importer/docs/images/customers.png and /dev/null differ diff --git a/apps/data-importer/docs/images/field-mapping.png b/apps/data-importer/docs/images/field-mapping.png deleted file mode 100644 index 8706707d3..000000000 Binary files a/apps/data-importer/docs/images/field-mapping.png and /dev/null differ diff --git a/apps/data-importer/docs/images/nuvo-key.png b/apps/data-importer/docs/images/nuvo-key.png deleted file mode 100644 index b2c35d5e6..000000000 Binary files a/apps/data-importer/docs/images/nuvo-key.png and /dev/null differ diff --git a/apps/data-importer/graphql/fragments/.gitkeep b/apps/data-importer/graphql/fragments/.gitkeep deleted file mode 100644 index e69de29bb..000000000 diff --git a/apps/data-importer/graphql/mutations/.gitkeep b/apps/data-importer/graphql/mutations/.gitkeep deleted file mode 100644 index e69de29bb..000000000 diff --git a/apps/data-importer/graphql/mutations/CustomerCreate.graphql b/apps/data-importer/graphql/mutations/CustomerCreate.graphql deleted file mode 100644 index 0e94bfd31..000000000 --- a/apps/data-importer/graphql/mutations/CustomerCreate.graphql +++ /dev/null @@ -1,10 +0,0 @@ -mutation CustomerCreate($input: UserCreateInput!) { - customerCreate(input: $input) { - user { - id - } - errors { - message - } - } -} diff --git a/apps/data-importer/graphql/queries/.gitkeep b/apps/data-importer/graphql/queries/.gitkeep deleted file mode 100644 index e69de29bb..000000000 diff --git a/apps/data-importer/graphql/queries/FetchAppDetails.graphql b/apps/data-importer/graphql/queries/FetchAppDetails.graphql deleted file mode 100644 index b4bad820a..000000000 --- a/apps/data-importer/graphql/queries/FetchAppDetails.graphql +++ /dev/null @@ -1,9 +0,0 @@ -query FetchAppDetails { - app { - id - privateMetadata { - key - value - } - } -} diff --git a/apps/data-importer/graphql/schema.graphql b/apps/data-importer/graphql/schema.graphql deleted file mode 100644 index dcda8874f..000000000 --- a/apps/data-importer/graphql/schema.graphql +++ /dev/null @@ -1,29625 +0,0 @@ -schema { - query: Query - mutation: Mutation - subscription: Subscription -} - -type Query { - """ - Look up a webhook by ID. Requires one of the following permissions: MANAGE_APPS, OWNER. - """ - webhook( - """ - ID of the webhook. - """ - id: ID! - ): Webhook - - """ - List of all available webhook events. - - Requires one of the following permissions: MANAGE_APPS. - """ - webhookEvents: [WebhookEvent!] - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `WebhookEventTypeAsyncEnum` and `WebhookEventTypeSyncEnum` to get available event types." - ) - - """ - Retrieve a sample payload for a given webhook event based on real data. It can be useful for some integrations where sample payload is required. - """ - webhookSamplePayload( - """ - Name of the requested event type. - """ - eventType: WebhookSampleEventTypeEnum! - ): JSONString - - """ - Look up a warehouse by ID. - - Requires one of the following permissions: MANAGE_PRODUCTS, MANAGE_ORDERS, MANAGE_SHIPPING. - """ - warehouse( - """ - ID of an warehouse - """ - id: ID! - ): Warehouse - - """ - List of warehouses. - - Requires one of the following permissions: MANAGE_PRODUCTS, MANAGE_ORDERS, MANAGE_SHIPPING. - """ - warehouses( - filter: WarehouseFilterInput - sortBy: WarehouseSortingInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): WarehouseCountableConnection - - """ - Returns a list of all translatable items of a given kind. - - Requires one of the following permissions: MANAGE_TRANSLATIONS. - """ - translations( - """ - Kind of objects to retrieve. - """ - kind: TranslatableKinds! - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): TranslatableItemConnection - - """ - Lookup a translatable item by ID. - - Requires one of the following permissions: MANAGE_TRANSLATIONS. - """ - translation( - """ - ID of the object to retrieve. - """ - id: ID! - - """ - Kind of the object to retrieve. - """ - kind: TranslatableKinds! - ): TranslatableItem - - """ - Look up a stock by ID - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - stock( - """ - ID of an warehouse - """ - id: ID! - ): Stock - - """ - List of stocks. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - stocks( - filter: StockFilterInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): StockCountableConnection - - """ - Return information about the shop. - """ - shop: Shop! - - """ - Order related settings from site settings. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderSettings: OrderSettings - - """ - Gift card related settings from site settings. - - Requires one of the following permissions: MANAGE_GIFT_CARD. - """ - giftCardSettings: GiftCardSettings! - - """ - Look up a shipping zone by ID. - - Requires one of the following permissions: MANAGE_SHIPPING. - """ - shippingZone( - """ - ID of the shipping zone. - """ - id: ID! - - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): ShippingZone - - """ - List of the shop's shipping zones. - - Requires one of the following permissions: MANAGE_SHIPPING. - """ - shippingZones( - """ - Filtering options for shipping zones. - """ - filter: ShippingZoneFilterInput - - """ - Slug of a channel for which the data should be returned. - """ - channel: String - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): ShippingZoneCountableConnection - - """ - Look up digital content by ID. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - digitalContent( - """ - ID of the digital content. - """ - id: ID! - ): DigitalContent - - """ - List of digital content. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - digitalContents( - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): DigitalContentCountableConnection - - """ - List of the shop's categories. - """ - categories( - """ - Filtering options for categories. - """ - filter: CategoryFilterInput - - """ - Sort categories. - """ - sortBy: CategorySortingInput - - """ - Filter categories by the nesting level in the category tree. - """ - level: Int - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): CategoryCountableConnection - - """ - Look up a category by ID or slug. - """ - category( - """ - ID of the category. - """ - id: ID - - """ - Slug of the category - """ - slug: String - ): Category - - """ - Look up a collection by ID. Requires one of the following permissions to include the unpublished items: MANAGE_ORDERS, MANAGE_DISCOUNTS, MANAGE_PRODUCTS. - """ - collection( - """ - ID of the collection. - """ - id: ID - - """ - Slug of the category - """ - slug: String - - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): Collection - - """ - List of the shop's collections. Requires one of the following permissions to include the unpublished items: MANAGE_ORDERS, MANAGE_DISCOUNTS, MANAGE_PRODUCTS. - """ - collections( - """ - Filtering options for collections. - """ - filter: CollectionFilterInput - - """ - Sort collections. - """ - sortBy: CollectionSortingInput - - """ - Slug of a channel for which the data should be returned. - """ - channel: String - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): CollectionCountableConnection - - """ - Look up a product by ID. Requires one of the following permissions to include the unpublished items: MANAGE_ORDERS, MANAGE_DISCOUNTS, MANAGE_PRODUCTS. - """ - product( - """ - ID of the product. - """ - id: ID - - """ - Slug of the product. - """ - slug: String - - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): Product - - """ - List of the shop's products. Requires one of the following permissions to include the unpublished items: MANAGE_ORDERS, MANAGE_DISCOUNTS, MANAGE_PRODUCTS. - """ - products( - """ - Filtering options for products. - """ - filter: ProductFilterInput - - """ - Sort products. - """ - sortBy: ProductOrder - - """ - Slug of a channel for which the data should be returned. - """ - channel: String - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): ProductCountableConnection - - """ - Look up a product type by ID. - """ - productType( - """ - ID of the product type. - """ - id: ID! - ): ProductType - - """ - List of the shop's product types. - """ - productTypes( - """ - Filtering options for product types. - """ - filter: ProductTypeFilterInput - - """ - Sort product types. - """ - sortBy: ProductTypeSortingInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): ProductTypeCountableConnection - - """ - Look up a product variant by ID or SKU. Requires one of the following permissions to include the unpublished items: MANAGE_ORDERS, MANAGE_DISCOUNTS, MANAGE_PRODUCTS. - """ - productVariant( - """ - ID of the product variant. - """ - id: ID - - """ - Sku of the product variant. - """ - sku: String - - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): ProductVariant - - """ - List of product variants. Requires one of the following permissions to include the unpublished items: MANAGE_ORDERS, MANAGE_DISCOUNTS, MANAGE_PRODUCTS. - """ - productVariants( - """ - Filter product variants by given IDs. - """ - ids: [ID!] - - """ - Slug of a channel for which the data should be returned. - """ - channel: String - - """ - Filtering options for product variant. - """ - filter: ProductVariantFilterInput - - """ - Sort products variants. - """ - sortBy: ProductVariantSortingInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): ProductVariantCountableConnection - - """ - List of top selling products. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - reportProductSales( - """ - Span of time. - """ - period: ReportingPeriod! - - """ - Slug of a channel for which the data should be returned. - """ - channel: String! - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): ProductVariantCountableConnection - - """ - Look up a payment by ID. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - payment( - """ - ID of the payment. - """ - id: ID! - ): Payment - - """ - List of payments. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - payments( - """ - Filtering options for payments. - """ - filter: PaymentFilterInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): PaymentCountableConnection - - """ - Look up a page by ID or slug. - """ - page( - """ - ID of the page. - """ - id: ID - - """ - The slug of the page. - """ - slug: String - ): Page - - """ - List of the shop's pages. - """ - pages( - """ - Sort pages. - """ - sortBy: PageSortingInput - - """ - Filtering options for pages. - """ - filter: PageFilterInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): PageCountableConnection - - """ - Look up a page type by ID. - """ - pageType( - """ - ID of the page type. - """ - id: ID! - ): PageType - - """ - List of the page types. - """ - pageTypes( - """ - Sort page types. - """ - sortBy: PageTypeSortingInput - - """ - Filtering options for page types. - """ - filter: PageTypeFilterInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): PageTypeCountableConnection - - """ - List of activity events to display on homepage (at the moment it only contains order-events). - - Requires one of the following permissions: MANAGE_ORDERS. - """ - homepageEvents( - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): OrderEventCountableConnection - - """ - Look up an order by ID. - """ - order( - """ - ID of an order. - """ - id: ID! - ): Order - - """ - List of orders. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orders( - """ - Sort orders. - """ - sortBy: OrderSortingInput - - """ - Filtering options for orders. - """ - filter: OrderFilterInput - - """ - Slug of a channel for which the data should be returned. - """ - channel: String - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): OrderCountableConnection - - """ - List of draft orders. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - draftOrders( - """ - Sort draft orders. - """ - sortBy: OrderSortingInput - - """ - Filtering options for draft orders. - """ - filter: OrderDraftFilterInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): OrderCountableConnection - - """ - Return the total sales amount from a specific period. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - ordersTotal( - """ - A period of time. - """ - period: ReportingPeriod - - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): TaxedMoney - - """ - Look up an order by token. - """ - orderByToken( - """ - The order's token. - """ - token: UUID! - ): Order @deprecated(reason: "This field will be removed in Saleor 4.0.") - - """ - Look up a navigation menu by ID or name. - """ - menu( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - - """ - ID of the menu. - """ - id: ID - - """ - The menu's name. - """ - name: String - - """ - The menu's slug. - """ - slug: String - ): Menu - - """ - List of the storefront's menus. - """ - menus( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - - """ - Sort menus. - """ - sortBy: MenuSortingInput - - """ - Filtering options for menus. - """ - filter: MenuFilterInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): MenuCountableConnection - - """ - Look up a menu item by ID. - """ - menuItem( - """ - ID of the menu item. - """ - id: ID! - - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): MenuItem - - """ - List of the storefronts's menu items. - """ - menuItems( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - - """ - Sort menus items. - """ - sortBy: MenuItemSortingInput - - """ - Filtering options for menu items. - """ - filter: MenuItemFilterInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): MenuItemCountableConnection - - """ - Look up a gift card by ID. - - Requires one of the following permissions: MANAGE_GIFT_CARD. - """ - giftCard( - """ - ID of the gift card. - """ - id: ID! - ): GiftCard - - """ - List of gift cards. - - Requires one of the following permissions: MANAGE_GIFT_CARD. - """ - giftCards( - """ - Sort gift cards. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - sortBy: GiftCardSortingInput - - """ - Filtering options for gift cards. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - filter: GiftCardFilterInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): GiftCardCountableConnection - - """ - List of gift card currencies. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - - Requires one of the following permissions: MANAGE_GIFT_CARD. - """ - giftCardCurrencies: [String!]! - - """ - List of gift card tags. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - - Requires one of the following permissions: MANAGE_GIFT_CARD. - """ - giftCardTags( - """ - Filtering options for gift card tags. - """ - filter: GiftCardTagFilterInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): GiftCardTagCountableConnection - - """ - Look up a plugin by ID. - - Requires one of the following permissions: MANAGE_PLUGINS. - """ - plugin( - """ - ID of the plugin. - """ - id: ID! - ): Plugin - - """ - List of plugins. - - Requires one of the following permissions: MANAGE_PLUGINS. - """ - plugins( - """ - Filtering options for plugins. - """ - filter: PluginFilterInput - - """ - Sort plugins. - """ - sortBy: PluginSortingInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): PluginCountableConnection - - """ - Look up a sale by ID. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - sale( - """ - ID of the sale. - """ - id: ID! - - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): Sale - - """ - List of the shop's sales. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - sales( - """ - Filtering options for sales. - """ - filter: SaleFilterInput - - """ - Sort sales. - """ - sortBy: SaleSortingInput - - """ - Search sales by name, value or type. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `filter.search` input instead. - """ - query: String - - """ - Slug of a channel for which the data should be returned. - """ - channel: String - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): SaleCountableConnection - - """ - Look up a voucher by ID. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - voucher( - """ - ID of the voucher. - """ - id: ID! - - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): Voucher - - """ - List of the shop's vouchers. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - vouchers( - """ - Filtering options for vouchers. - """ - filter: VoucherFilterInput - - """ - Sort voucher. - """ - sortBy: VoucherSortingInput - - """ - Search vouchers by name or code. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `filter.search` input instead. - """ - query: String - - """ - Slug of a channel for which the data should be returned. - """ - channel: String - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): VoucherCountableConnection - - """ - Look up a export file by ID. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - exportFile( - """ - ID of the export file job. - """ - id: ID! - ): ExportFile - - """ - List of export files. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - exportFiles( - """ - Filtering options for export files. - """ - filter: ExportFileFilterInput - - """ - Sort export files. - """ - sortBy: ExportFileSortingInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): ExportFileCountableConnection - - """ - List of all tax rates available from tax gateway. - """ - taxTypes: [TaxType!] - - """ - Look up a checkout by token and slug of channel. - """ - checkout( - """ - The checkout's ID. - - Added in Saleor 3.4. - """ - id: ID - - """ - The checkout's token. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - token: UUID - ): Checkout - - """ - List of checkouts. - - Requires one of the following permissions: MANAGE_CHECKOUTS. - """ - checkouts( - """ - Sort checkouts. - - Added in Saleor 3.1. - """ - sortBy: CheckoutSortingInput - - """ - Filtering options for checkouts. - - Added in Saleor 3.1. - """ - filter: CheckoutFilterInput - - """ - Slug of a channel for which the data should be returned. - """ - channel: String - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): CheckoutCountableConnection - - """ - List of checkout lines. - - Requires one of the following permissions: MANAGE_CHECKOUTS. - """ - checkoutLines( - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): CheckoutLineCountableConnection - - """ - Look up a channel by ID. - - Requires one of the following permissions: AUTHENTICATED_APP, AUTHENTICATED_STAFF_USER. - """ - channel( - """ - ID of the channel. - """ - id: ID - ): Channel - - """ - List of all channels. - - Requires one of the following permissions: AUTHENTICATED_APP, AUTHENTICATED_STAFF_USER. - """ - channels: [Channel!] - - """ - List of the shop's attributes. - """ - attributes( - """ - Filtering options for attributes. - """ - filter: AttributeFilterInput - - """ - Sorting options for attributes. - """ - sortBy: AttributeSortingInput - - """ - Slug of a channel for which the data should be returned. - """ - channel: String - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): AttributeCountableConnection - - """ - Look up an attribute by ID. - """ - attribute( - """ - ID of the attribute. - """ - id: ID - - """ - Slug of the attribute. - """ - slug: String - ): Attribute - - """ - List of all apps installations - - Requires one of the following permissions: MANAGE_APPS. - """ - appsInstallations: [AppInstallation!]! - - """ - List of the apps. - - Requires one of the following permissions: AUTHENTICATED_STAFF_USER, MANAGE_APPS. - """ - apps( - """ - Filtering options for apps. - """ - filter: AppFilterInput - - """ - Sort apps. - """ - sortBy: AppSortingInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): AppCountableConnection - - """ - Look up an app by ID. If ID is not provided, return the currently authenticated app. - - Requires one of the following permissions: AUTHENTICATED_STAFF_USER AUTHENTICATED_APP. The authenticated app has access to its resources. Fetching different apps requires MANAGE_APPS permission. - """ - app( - """ - ID of the app. - """ - id: ID - ): App - - """ - List of all extensions. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - - Requires one of the following permissions: AUTHENTICATED_STAFF_USER, AUTHENTICATED_APP. - """ - appExtensions( - """ - Filtering options for apps extensions. - """ - filter: AppExtensionFilterInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): AppExtensionCountableConnection - - """ - Look up an app extension by ID. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - - Requires one of the following permissions: AUTHENTICATED_STAFF_USER, AUTHENTICATED_APP. - """ - appExtension( - """ - ID of the app extension. - """ - id: ID! - ): AppExtension - - """ - Returns address validation rules. - """ - addressValidationRules( - """ - Two-letter ISO 3166-1 country code. - """ - countryCode: CountryCode! - - """ - Designation of a region, province or state. - """ - countryArea: String - - """ - City or a town name. - """ - city: String - - """ - Sublocality like a district. - """ - cityArea: String - ): AddressValidationData - - """ - Look up an address by ID. - """ - address( - """ - ID of an address. - """ - id: ID! - ): Address - - """ - List of the shop's customers. - - Requires one of the following permissions: MANAGE_ORDERS, MANAGE_USERS. - """ - customers( - """ - Filtering options for customers. - """ - filter: CustomerFilterInput - - """ - Sort customers. - """ - sortBy: UserSortingInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): UserCountableConnection - - """ - List of permission groups. - - Requires one of the following permissions: MANAGE_STAFF. - """ - permissionGroups( - """ - Filtering options for permission groups. - """ - filter: PermissionGroupFilterInput - - """ - Sort permission groups. - """ - sortBy: PermissionGroupSortingInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): GroupCountableConnection - - """ - Look up permission group by ID. - - Requires one of the following permissions: MANAGE_STAFF. - """ - permissionGroup( - """ - ID of the group. - """ - id: ID! - ): Group - - """ - Return the currently authenticated user. - """ - me: User - - """ - List of the shop's staff users. - - Requires one of the following permissions: MANAGE_STAFF. - """ - staffUsers( - """ - Filtering options for staff users. - """ - filter: StaffUserInput - - """ - Sort staff users. - """ - sortBy: UserSortingInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): UserCountableConnection - - """ - Look up a user by ID or email address. - - Requires one of the following permissions: MANAGE_STAFF, MANAGE_USERS, MANAGE_ORDERS. - """ - user( - """ - ID of the user. - """ - id: ID - - """ - Email address of the user. - """ - email: String - ): User - _entities(representations: [_Any]): [_Entity] - _service: _Service -} - -""" -Webhook. -""" -type Webhook implements Node { - id: ID! - name: String! - - """ - List of webhook events. - """ - events: [WebhookEvent!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `asyncEvents` or `syncEvents` instead." - ) - - """ - List of synchronous webhook events. - """ - syncEvents: [WebhookEventSync!]! - - """ - List of asynchronous webhook events. - """ - asyncEvents: [WebhookEventAsync!]! - app: App! - - """ - Event deliveries. - """ - eventDeliveries( - """ - Event delivery sorter. - """ - sortBy: EventDeliverySortingInput - - """ - Event delivery filter options. - """ - filter: EventDeliveryFilterInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): EventDeliveryCountableConnection - - """ - Target URL for webhook. - """ - targetUrl: String! - - """ - Informs if webhook is activated. - """ - isActive: Boolean! - - """ - Used to create a hash signature with each payload. - """ - secretKey: String - - """ - Used to define payloads for specific events. - """ - subscriptionQuery: String -} - -""" -An object with an ID -""" -interface Node { - """ - The ID of the object. - """ - id: ID! -} - -""" -Webhook event. -""" -type WebhookEvent { - """ - Display name of the event. - """ - name: String! - - """ - Internal name of the event type. - """ - eventType: WebhookEventTypeEnum! -} - -""" -Enum determining type of webhook. -""" -enum WebhookEventTypeEnum { - """ - All the events. - """ - ANY_EVENTS - - """ - A new app installed. - """ - APP_INSTALLED - - """ - An app updated. - """ - APP_UPDATED - - """ - An app deleted. - """ - APP_DELETED - - """ - An app status is changed. - """ - APP_STATUS_CHANGED - - """ - A new category created. - """ - CATEGORY_CREATED - - """ - A category is updated. - """ - CATEGORY_UPDATED - - """ - A category is deleted. - """ - CATEGORY_DELETED - - """ - A new channel created. - """ - CHANNEL_CREATED - - """ - A channel is updated. - """ - CHANNEL_UPDATED - - """ - A channel is deleted. - """ - CHANNEL_DELETED - - """ - A channel status is changed. - """ - CHANNEL_STATUS_CHANGED - - """ - A new gift card created. - """ - GIFT_CARD_CREATED - - """ - A gift card is updated. - """ - GIFT_CARD_UPDATED - - """ - A gift card is deleted. - """ - GIFT_CARD_DELETED - - """ - A gift card status is changed. - """ - GIFT_CARD_STATUS_CHANGED - - """ - A new menu created. - """ - MENU_CREATED - - """ - A menu is updated. - """ - MENU_UPDATED - - """ - A menu is deleted. - """ - MENU_DELETED - - """ - A new menu item created. - """ - MENU_ITEM_CREATED - - """ - A menu item is updated. - """ - MENU_ITEM_UPDATED - - """ - A menu item is deleted. - """ - MENU_ITEM_DELETED - - """ - A new order is placed. - """ - ORDER_CREATED - - """ - An order is confirmed (status change unconfirmed -> unfulfilled) by a staff user using the OrderConfirm mutation. It also triggers when the user completes the checkout and the shop setting `automatically_confirm_all_new_orders` is enabled. - """ - ORDER_CONFIRMED - - """ - Payment is made and an order is fully paid. - """ - ORDER_FULLY_PAID - - """ - An order is updated; triggered for all changes related to an order; covers all other order webhooks, except for ORDER_CREATED. - """ - ORDER_UPDATED - - """ - An order is cancelled. - """ - ORDER_CANCELLED - - """ - An order is fulfilled. - """ - ORDER_FULFILLED - DRAFT_ORDER_CREATED - DRAFT_ORDER_UPDATED - DRAFT_ORDER_DELETED - SALE_CREATED - SALE_UPDATED - SALE_DELETED - - """ - An invoice for order requested. - """ - INVOICE_REQUESTED - - """ - An invoice is deleted. - """ - INVOICE_DELETED - - """ - Invoice has been sent. - """ - INVOICE_SENT - - """ - A new customer account is created. - """ - CUSTOMER_CREATED - - """ - A customer account is updated. - """ - CUSTOMER_UPDATED - - """ - A new collection is created. - """ - COLLECTION_CREATED - - """ - A collection is updated. - """ - COLLECTION_UPDATED - - """ - A collection is deleted. - """ - COLLECTION_DELETED - - """ - A new product is created. - """ - PRODUCT_CREATED - - """ - A product is updated. - """ - PRODUCT_UPDATED - - """ - A product is deleted. - """ - PRODUCT_DELETED - - """ - A new product variant is created. - """ - PRODUCT_VARIANT_CREATED - - """ - A product variant is updated. - """ - PRODUCT_VARIANT_UPDATED - - """ - A product variant is deleted. - """ - PRODUCT_VARIANT_DELETED - PRODUCT_VARIANT_OUT_OF_STOCK - PRODUCT_VARIANT_BACK_IN_STOCK - - """ - A new checkout is created. - """ - CHECKOUT_CREATED - - """ - A checkout is updated. It also triggers all updates related to the checkout. - """ - CHECKOUT_UPDATED - - """ - A new fulfillment is created. - """ - FULFILLMENT_CREATED - - """ - A fulfillment is cancelled. - """ - FULFILLMENT_CANCELED - - """ - User notification triggered. - """ - NOTIFY_USER - - """ - A new page is created. - """ - PAGE_CREATED - - """ - A page is updated. - """ - PAGE_UPDATED - - """ - A page is deleted. - """ - PAGE_DELETED - - """ - A new shipping price is created. - """ - SHIPPING_PRICE_CREATED - - """ - A shipping price is updated. - """ - SHIPPING_PRICE_UPDATED - - """ - A shipping price is deleted. - """ - SHIPPING_PRICE_DELETED - - """ - A new shipping zone is created. - """ - SHIPPING_ZONE_CREATED - - """ - A shipping zone is updated. - """ - SHIPPING_ZONE_UPDATED - - """ - A shipping zone is deleted. - """ - SHIPPING_ZONE_DELETED - TRANSACTION_ACTION_REQUEST - TRANSLATION_CREATED - TRANSLATION_UPDATED - - """ - A new warehouse created. - """ - WAREHOUSE_CREATED - - """ - A warehouse is updated. - """ - WAREHOUSE_UPDATED - - """ - A warehouse is deleted. - """ - WAREHOUSE_DELETED - - """ - A new voucher created. - """ - VOUCHER_CREATED - - """ - A voucher is updated. - """ - VOUCHER_UPDATED - - """ - A voucher is deleted. - """ - VOUCHER_DELETED - - """ - An observability event is created. - """ - OBSERVABILITY - PAYMENT_AUTHORIZE - PAYMENT_CAPTURE - PAYMENT_CONFIRM - PAYMENT_LIST_GATEWAYS - PAYMENT_PROCESS - PAYMENT_REFUND - PAYMENT_VOID - SHIPPING_LIST_METHODS_FOR_CHECKOUT - ORDER_FILTER_SHIPPING_METHODS - CHECKOUT_FILTER_SHIPPING_METHODS -} - -""" -Synchronous webhook event. -""" -type WebhookEventSync { - """ - Display name of the event. - """ - name: String! - - """ - Internal name of the event type. - """ - eventType: WebhookEventTypeSyncEnum! -} - -""" -Enum determining type of webhook. -""" -enum WebhookEventTypeSyncEnum { - PAYMENT_AUTHORIZE - PAYMENT_CAPTURE - PAYMENT_CONFIRM - PAYMENT_LIST_GATEWAYS - PAYMENT_PROCESS - PAYMENT_REFUND - PAYMENT_VOID - SHIPPING_LIST_METHODS_FOR_CHECKOUT - ORDER_FILTER_SHIPPING_METHODS - CHECKOUT_FILTER_SHIPPING_METHODS -} - -""" -Asynchronous webhook event. -""" -type WebhookEventAsync { - """ - Display name of the event. - """ - name: String! - - """ - Internal name of the event type. - """ - eventType: WebhookEventTypeAsyncEnum! -} - -""" -Enum determining type of webhook. -""" -enum WebhookEventTypeAsyncEnum { - """ - All the events. - """ - ANY_EVENTS - - """ - A new app installed. - """ - APP_INSTALLED - - """ - An app updated. - """ - APP_UPDATED - - """ - An app deleted. - """ - APP_DELETED - - """ - An app status is changed. - """ - APP_STATUS_CHANGED - - """ - A new category created. - """ - CATEGORY_CREATED - - """ - A category is updated. - """ - CATEGORY_UPDATED - - """ - A category is deleted. - """ - CATEGORY_DELETED - - """ - A new channel created. - """ - CHANNEL_CREATED - - """ - A channel is updated. - """ - CHANNEL_UPDATED - - """ - A channel is deleted. - """ - CHANNEL_DELETED - - """ - A channel status is changed. - """ - CHANNEL_STATUS_CHANGED - - """ - A new gift card created. - """ - GIFT_CARD_CREATED - - """ - A gift card is updated. - """ - GIFT_CARD_UPDATED - - """ - A gift card is deleted. - """ - GIFT_CARD_DELETED - - """ - A gift card status is changed. - """ - GIFT_CARD_STATUS_CHANGED - - """ - A new menu created. - """ - MENU_CREATED - - """ - A menu is updated. - """ - MENU_UPDATED - - """ - A menu is deleted. - """ - MENU_DELETED - - """ - A new menu item created. - """ - MENU_ITEM_CREATED - - """ - A menu item is updated. - """ - MENU_ITEM_UPDATED - - """ - A menu item is deleted. - """ - MENU_ITEM_DELETED - - """ - A new order is placed. - """ - ORDER_CREATED - - """ - An order is confirmed (status change unconfirmed -> unfulfilled) by a staff user using the OrderConfirm mutation. It also triggers when the user completes the checkout and the shop setting `automatically_confirm_all_new_orders` is enabled. - """ - ORDER_CONFIRMED - - """ - Payment is made and an order is fully paid. - """ - ORDER_FULLY_PAID - - """ - An order is updated; triggered for all changes related to an order; covers all other order webhooks, except for ORDER_CREATED. - """ - ORDER_UPDATED - - """ - An order is cancelled. - """ - ORDER_CANCELLED - - """ - An order is fulfilled. - """ - ORDER_FULFILLED - DRAFT_ORDER_CREATED - DRAFT_ORDER_UPDATED - DRAFT_ORDER_DELETED - SALE_CREATED - SALE_UPDATED - SALE_DELETED - - """ - An invoice for order requested. - """ - INVOICE_REQUESTED - - """ - An invoice is deleted. - """ - INVOICE_DELETED - - """ - Invoice has been sent. - """ - INVOICE_SENT - - """ - A new customer account is created. - """ - CUSTOMER_CREATED - - """ - A customer account is updated. - """ - CUSTOMER_UPDATED - - """ - A new collection is created. - """ - COLLECTION_CREATED - - """ - A collection is updated. - """ - COLLECTION_UPDATED - - """ - A collection is deleted. - """ - COLLECTION_DELETED - - """ - A new product is created. - """ - PRODUCT_CREATED - - """ - A product is updated. - """ - PRODUCT_UPDATED - - """ - A product is deleted. - """ - PRODUCT_DELETED - - """ - A new product variant is created. - """ - PRODUCT_VARIANT_CREATED - - """ - A product variant is updated. - """ - PRODUCT_VARIANT_UPDATED - - """ - A product variant is deleted. - """ - PRODUCT_VARIANT_DELETED - PRODUCT_VARIANT_OUT_OF_STOCK - PRODUCT_VARIANT_BACK_IN_STOCK - - """ - A new checkout is created. - """ - CHECKOUT_CREATED - - """ - A checkout is updated. It also triggers all updates related to the checkout. - """ - CHECKOUT_UPDATED - - """ - A new fulfillment is created. - """ - FULFILLMENT_CREATED - - """ - A fulfillment is cancelled. - """ - FULFILLMENT_CANCELED - - """ - User notification triggered. - """ - NOTIFY_USER - - """ - A new page is created. - """ - PAGE_CREATED - - """ - A page is updated. - """ - PAGE_UPDATED - - """ - A page is deleted. - """ - PAGE_DELETED - - """ - A new shipping price is created. - """ - SHIPPING_PRICE_CREATED - - """ - A shipping price is updated. - """ - SHIPPING_PRICE_UPDATED - - """ - A shipping price is deleted. - """ - SHIPPING_PRICE_DELETED - - """ - A new shipping zone is created. - """ - SHIPPING_ZONE_CREATED - - """ - A shipping zone is updated. - """ - SHIPPING_ZONE_UPDATED - - """ - A shipping zone is deleted. - """ - SHIPPING_ZONE_DELETED - TRANSACTION_ACTION_REQUEST - TRANSLATION_CREATED - TRANSLATION_UPDATED - - """ - A new warehouse created. - """ - WAREHOUSE_CREATED - - """ - A warehouse is updated. - """ - WAREHOUSE_UPDATED - - """ - A warehouse is deleted. - """ - WAREHOUSE_DELETED - - """ - A new voucher created. - """ - VOUCHER_CREATED - - """ - A voucher is updated. - """ - VOUCHER_UPDATED - - """ - A voucher is deleted. - """ - VOUCHER_DELETED - - """ - An observability event is created. - """ - OBSERVABILITY -} - -""" -Represents app data. -""" -type App implements Node & ObjectWithMetadata { - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - - """ - List of the app's permissions. - """ - permissions: [Permission!] - - """ - The date and time when the app was created. - """ - created: DateTime - - """ - Determine if app will be set active or not. - """ - isActive: Boolean - - """ - Name of the app. - """ - name: String - - """ - Type of the app. - """ - type: AppTypeEnum - - """ - Last 4 characters of the tokens. - - Requires one of the following permissions: MANAGE_APPS, OWNER. - """ - tokens: [AppToken!] - - """ - List of webhooks assigned to this app. - - Requires one of the following permissions: MANAGE_APPS, OWNER. - """ - webhooks: [Webhook!] - - """ - Description of this app. - """ - aboutApp: String - - """ - Description of the data privacy defined for this app. - """ - dataPrivacy: String - - """ - Url to details about the privacy policy on the app owner page. - """ - dataPrivacyUrl: String - - """ - Homepage of the app. - """ - homepageUrl: String - - """ - Support page for the app. - """ - supportUrl: String - - """ - Url to iframe with the configuration for the app. - """ - configurationUrl: String - - """ - Url to iframe with the app. - """ - appUrl: String - - """ - Version number of the app. - """ - version: String - - """ - JWT token used to authenticate by thridparty app. - """ - accessToken: String - - """ - App's dashboard extensions. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - extensions: [AppExtension!]! -} - -interface ObjectWithMetadata { - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata -} - -type MetadataItem { - """ - Key of a metadata item. - """ - key: String! - - """ - Value of a metadata item. - """ - value: String! -} - -""" -Metadata is a map of key-value pairs, both keys and values are `String`. - -Example: -``` -{ - "key1": "value1", - "key2": "value2" -} -``` -""" -scalar Metadata - -""" -Represents a permission object in a friendly form. -""" -type Permission { - """ - Internal code for permission. - """ - code: PermissionEnum! - - """ - Describe action(s) allowed to do by permission. - """ - name: String! -} - -""" -An enumeration. -""" -enum PermissionEnum { - MANAGE_USERS - MANAGE_STAFF - IMPERSONATE_USER - MANAGE_APPS - MANAGE_OBSERVABILITY - MANAGE_CHANNELS - MANAGE_DISCOUNTS - MANAGE_PLUGINS - MANAGE_GIFT_CARD - MANAGE_MENUS - MANAGE_ORDERS - MANAGE_PAGES - MANAGE_PAGE_TYPES_AND_ATTRIBUTES - HANDLE_PAYMENTS - MANAGE_PRODUCTS - MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES - MANAGE_SHIPPING - MANAGE_SETTINGS - MANAGE_TRANSLATIONS - MANAGE_CHECKOUTS - HANDLE_CHECKOUTS -} - -""" -The `DateTime` scalar type represents a DateTime -value as specified by -[iso8601](https://en.wikipedia.org/wiki/ISO_8601). -""" -scalar DateTime - -""" -Enum determining type of your App. -""" -enum AppTypeEnum { - """ - Local Saleor App. The app is fully manageable from dashboard. You can change assigned permissions, add webhooks, or authentication token - """ - LOCAL - - """ - Third party external App. Installation is fully automated. Saleor uses a defined App manifest to gather all required information. - """ - THIRDPARTY -} - -""" -Represents token data. -""" -type AppToken implements Node { - id: ID! - - """ - Name of the authenticated token. - """ - name: String - - """ - Last 4 characters of the token. - """ - authToken: String -} - -""" -Represents app data. -""" -type AppExtension implements Node { - id: ID! - - """ - List of the app extension's permissions. - """ - permissions: [Permission!]! - - """ - Label of the extension to show in the dashboard. - """ - label: String! - - """ - URL of a view where extension's iframe is placed. - """ - url: String! - - """ - Place where given extension will be mounted. - """ - mount: AppExtensionMountEnum! - - """ - Type of way how app extension will be opened. - """ - target: AppExtensionTargetEnum! - app: App! - - """ - JWT token used to authenticate by thridparty app extension. - """ - accessToken: String -} - -""" -All places where app extension can be mounted. -""" -enum AppExtensionMountEnum { - PRODUCT_OVERVIEW_CREATE - PRODUCT_OVERVIEW_MORE_ACTIONS - PRODUCT_DETAILS_MORE_ACTIONS - NAVIGATION_CATALOG - NAVIGATION_ORDERS - NAVIGATION_CUSTOMERS - NAVIGATION_DISCOUNTS - NAVIGATION_TRANSLATIONS - NAVIGATION_PAGES - ORDER_DETAILS_MORE_ACTIONS - ORDER_OVERVIEW_CREATE - ORDER_OVERVIEW_MORE_ACTIONS -} - -""" -All available ways of opening an app extension. - - POPUP - app's extension will be mounted as a popup window - APP_PAGE - redirect to app's page -""" -enum AppExtensionTargetEnum { - POPUP - APP_PAGE -} - -type EventDeliveryCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [EventDeliveryCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -""" -The Relay compliant `PageInfo` type, containing data necessary to paginate this connection. -""" -type PageInfo { - """ - When paginating forwards, are there more items? - """ - hasNextPage: Boolean! - - """ - When paginating backwards, are there more items? - """ - hasPreviousPage: Boolean! - - """ - When paginating backwards, the cursor to continue. - """ - startCursor: String - - """ - When paginating forwards, the cursor to continue. - """ - endCursor: String -} - -type EventDeliveryCountableEdge { - """ - The item at the end of the edge. - """ - node: EventDelivery! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -""" -Event delivery. -""" -type EventDelivery implements Node { - id: ID! - createdAt: DateTime! - - """ - Event delivery status. - """ - status: EventDeliveryStatusEnum! - - """ - Webhook event type. - """ - eventType: WebhookEventTypeEnum! - - """ - Event delivery attempts. - """ - attempts( - """ - Event delivery sorter - """ - sortBy: EventDeliveryAttemptSortingInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): EventDeliveryAttemptCountableConnection - - """ - Event payload. - """ - payload: String -} - -enum EventDeliveryStatusEnum { - PENDING - SUCCESS - FAILED -} - -type EventDeliveryAttemptCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [EventDeliveryAttemptCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type EventDeliveryAttemptCountableEdge { - """ - The item at the end of the edge. - """ - node: EventDeliveryAttempt! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -""" -Event delivery attempts. -""" -type EventDeliveryAttempt implements Node { - id: ID! - - """ - Event delivery creation date and time. - """ - createdAt: DateTime! - - """ - Task id for delivery attempt. - """ - taskId: String - - """ - Delivery attempt duration. - """ - duration: Float - - """ - Delivery attempt response content. - """ - response: String - - """ - Response headers for delivery attempt. - """ - responseHeaders: String - - """ - Delivery attempt response status code. - """ - responseStatusCode: Int - - """ - Request headers for delivery attempt. - """ - requestHeaders: String - - """ - Event delivery status. - """ - status: EventDeliveryStatusEnum! -} - -input EventDeliveryAttemptSortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Sort attempts by the selected field. - """ - field: EventDeliveryAttemptSortField! -} - -enum OrderDirection { - """ - Specifies an ascending sort order. - """ - ASC - - """ - Specifies a descending sort order. - """ - DESC -} - -enum EventDeliveryAttemptSortField { - """ - Sort event delivery attempts by created at. - """ - CREATED_AT -} - -input EventDeliverySortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Sort deliveries by the selected field. - """ - field: EventDeliverySortField! -} - -enum EventDeliverySortField { - """ - Sort event deliveries by created at. - """ - CREATED_AT -} - -input EventDeliveryFilterInput { - status: EventDeliveryStatusEnum - eventType: WebhookEventTypeEnum -} - -scalar JSONString - -""" -An enumeration. -""" -enum WebhookSampleEventTypeEnum { - APP_INSTALLED - APP_UPDATED - APP_DELETED - APP_STATUS_CHANGED - CATEGORY_CREATED - CATEGORY_UPDATED - CATEGORY_DELETED - CHANNEL_CREATED - CHANNEL_UPDATED - CHANNEL_DELETED - CHANNEL_STATUS_CHANGED - GIFT_CARD_CREATED - GIFT_CARD_UPDATED - GIFT_CARD_DELETED - GIFT_CARD_STATUS_CHANGED - MENU_CREATED - MENU_UPDATED - MENU_DELETED - MENU_ITEM_CREATED - MENU_ITEM_UPDATED - MENU_ITEM_DELETED - ORDER_CREATED - ORDER_CONFIRMED - ORDER_FULLY_PAID - ORDER_UPDATED - ORDER_CANCELLED - ORDER_FULFILLED - DRAFT_ORDER_CREATED - DRAFT_ORDER_UPDATED - DRAFT_ORDER_DELETED - SALE_CREATED - SALE_UPDATED - SALE_DELETED - INVOICE_REQUESTED - INVOICE_DELETED - INVOICE_SENT - CUSTOMER_CREATED - CUSTOMER_UPDATED - COLLECTION_CREATED - COLLECTION_UPDATED - COLLECTION_DELETED - PRODUCT_CREATED - PRODUCT_UPDATED - PRODUCT_DELETED - PRODUCT_VARIANT_CREATED - PRODUCT_VARIANT_UPDATED - PRODUCT_VARIANT_DELETED - PRODUCT_VARIANT_OUT_OF_STOCK - PRODUCT_VARIANT_BACK_IN_STOCK - CHECKOUT_CREATED - CHECKOUT_UPDATED - FULFILLMENT_CREATED - FULFILLMENT_CANCELED - NOTIFY_USER - PAGE_CREATED - PAGE_UPDATED - PAGE_DELETED - SHIPPING_PRICE_CREATED - SHIPPING_PRICE_UPDATED - SHIPPING_PRICE_DELETED - SHIPPING_ZONE_CREATED - SHIPPING_ZONE_UPDATED - SHIPPING_ZONE_DELETED - TRANSACTION_ACTION_REQUEST - TRANSLATION_CREATED - TRANSLATION_UPDATED - WAREHOUSE_CREATED - WAREHOUSE_UPDATED - WAREHOUSE_DELETED - VOUCHER_CREATED - VOUCHER_UPDATED - VOUCHER_DELETED - OBSERVABILITY -} - -""" -Represents warehouse. -""" -type Warehouse implements Node & ObjectWithMetadata { - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - name: String! - slug: String! - email: String! - isPrivate: Boolean! - address: Address! - - """ - Warehouse company name. - """ - companyName: String! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `Address.companyName` instead." - ) - - """ - Click and collect options: local, all or disabled. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - clickAndCollectOption: WarehouseClickAndCollectOptionEnum! - shippingZones( - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): ShippingZoneCountableConnection! -} - -""" -Represents user address data. -""" -type Address implements Node { - id: ID! - firstName: String! - lastName: String! - companyName: String! - streetAddress1: String! - streetAddress2: String! - city: String! - cityArea: String! - postalCode: String! - - """ - Shop's default country. - """ - country: CountryDisplay! - countryArea: String! - phone: String - - """ - Address is user's default shipping address. - """ - isDefaultShippingAddress: Boolean - - """ - Address is user's default billing address. - """ - isDefaultBillingAddress: Boolean -} - -type CountryDisplay { - """ - Country code. - """ - code: String! - - """ - Country name. - """ - country: String! - - """ - Country tax. - """ - vat: VAT -} - -""" -Represents a VAT rate for a country. -""" -type VAT { - """ - Country code. - """ - countryCode: String! - - """ - Standard VAT rate in percent. - """ - standardRate: Float - - """ - Country's VAT rate exceptions for specific types of goods. - """ - reducedRates: [ReducedRate!]! -} - -""" -Represents a reduced VAT rate for a particular type of goods. -""" -type ReducedRate { - """ - Reduced VAT rate in percent. - """ - rate: Float! - - """ - A type of goods. - """ - rateType: String! -} - -""" -An enumeration. -""" -enum WarehouseClickAndCollectOptionEnum { - DISABLED - LOCAL - ALL -} - -type ShippingZoneCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [ShippingZoneCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type ShippingZoneCountableEdge { - """ - The item at the end of the edge. - """ - node: ShippingZone! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -""" -Represents a shipping zone in the shop. Zones are the concept used only for grouping shipping methods in the dashboard, and are never exposed to the customers directly. -""" -type ShippingZone implements Node & ObjectWithMetadata { - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - name: String! - default: Boolean! - - """ - Lowest and highest prices for the shipping. - """ - priceRange: MoneyRange - - """ - List of countries available for the method. - """ - countries: [CountryDisplay!]! - - """ - List of shipping methods available for orders shipped to countries within this shipping zone. - """ - shippingMethods: [ShippingMethodType!] - - """ - List of warehouses for shipping zone. - """ - warehouses: [Warehouse!]! - - """ - List of channels for shipping zone. - """ - channels: [Channel!]! - - """ - Description of a shipping zone. - """ - description: String -} - -""" -Represents a range of amounts of money. -""" -type MoneyRange { - """ - Lower bound of a price range. - """ - start: Money - - """ - Upper bound of a price range. - """ - stop: Money -} - -""" -Represents amount of money in specific currency. -""" -type Money { - """ - Currency code. - """ - currency: String! - - """ - Amount of money. - """ - amount: Float! -} - -""" -Shipping method are the methods you'll use to get customer's orders to them. They are directly exposed to the customers. -""" -type ShippingMethodType implements Node & ObjectWithMetadata { - """ - Shipping method ID. - """ - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - - """ - Shipping method name. - """ - name: String! - - """ - Shipping method description. - - Rich text format. For reference see https://editorjs.io/ - """ - description: JSONString - - """ - Type of the shipping method. - """ - type: ShippingMethodTypeEnum - - """ - Returns translated shipping method fields for the given language code. - """ - translation( - """ - A language code to return the translation for shipping method. - """ - languageCode: LanguageCodeEnum! - ): ShippingMethodTranslation - - """ - List of channels available for the method. - - Requires one of the following permissions: MANAGE_SHIPPING. - """ - channelListings: [ShippingMethodChannelListing!] - - """ - The price of the cheapest variant (including discounts). - """ - maximumOrderPrice: Money - - """ - The price of the cheapest variant (including discounts). - """ - minimumOrderPrice: Money - - """ - Postal code ranges rule of exclusion or inclusion of the shipping method. - """ - postalCodeRules: [ShippingMethodPostalCodeRule!] - - """ - List of excluded products for the shipping method. - - Requires one of the following permissions: MANAGE_SHIPPING. - """ - excludedProducts( - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): ProductCountableConnection - - """ - Minimum order weight to use this shipping method. - """ - minimumOrderWeight: Weight - - """ - Maximum order weight to use this shipping method. - """ - maximumOrderWeight: Weight - - """ - Maximum number of days for delivery. - """ - maximumDeliveryDays: Int - - """ - Minimal number of days for delivery. - """ - minimumDeliveryDays: Int -} - -""" -An enumeration. -""" -enum ShippingMethodTypeEnum { - PRICE - WEIGHT -} - -type ShippingMethodTranslation implements Node { - id: ID! - - """ - Translation language. - """ - language: LanguageDisplay! - name: String - - """ - Translated description of the shipping method. - - Rich text format. For reference see https://editorjs.io/ - """ - description: JSONString -} - -type LanguageDisplay { - """ - ISO 639 representation of the language name. - """ - code: LanguageCodeEnum! - - """ - Full name of the language. - """ - language: String! -} - -""" -An enumeration. -""" -enum LanguageCodeEnum { - AF - AF_NA - AF_ZA - AGQ - AGQ_CM - AK - AK_GH - AM - AM_ET - AR - AR_AE - AR_BH - AR_DJ - AR_DZ - AR_EG - AR_EH - AR_ER - AR_IL - AR_IQ - AR_JO - AR_KM - AR_KW - AR_LB - AR_LY - AR_MA - AR_MR - AR_OM - AR_PS - AR_QA - AR_SA - AR_SD - AR_SO - AR_SS - AR_SY - AR_TD - AR_TN - AR_YE - AS - AS_IN - ASA - ASA_TZ - AST - AST_ES - AZ - AZ_CYRL - AZ_CYRL_AZ - AZ_LATN - AZ_LATN_AZ - BAS - BAS_CM - BE - BE_BY - BEM - BEM_ZM - BEZ - BEZ_TZ - BG - BG_BG - BM - BM_ML - BN - BN_BD - BN_IN - BO - BO_CN - BO_IN - BR - BR_FR - BRX - BRX_IN - BS - BS_CYRL - BS_CYRL_BA - BS_LATN - BS_LATN_BA - CA - CA_AD - CA_ES - CA_ES_VALENCIA - CA_FR - CA_IT - CCP - CCP_BD - CCP_IN - CE - CE_RU - CEB - CEB_PH - CGG - CGG_UG - CHR - CHR_US - CKB - CKB_IQ - CKB_IR - CS - CS_CZ - CU - CU_RU - CY - CY_GB - DA - DA_DK - DA_GL - DAV - DAV_KE - DE - DE_AT - DE_BE - DE_CH - DE_DE - DE_IT - DE_LI - DE_LU - DJE - DJE_NE - DSB - DSB_DE - DUA - DUA_CM - DYO - DYO_SN - DZ - DZ_BT - EBU - EBU_KE - EE - EE_GH - EE_TG - EL - EL_CY - EL_GR - EN - EN_AE - EN_AG - EN_AI - EN_AS - EN_AT - EN_AU - EN_BB - EN_BE - EN_BI - EN_BM - EN_BS - EN_BW - EN_BZ - EN_CA - EN_CC - EN_CH - EN_CK - EN_CM - EN_CX - EN_CY - EN_DE - EN_DG - EN_DK - EN_DM - EN_ER - EN_FI - EN_FJ - EN_FK - EN_FM - EN_GB - EN_GD - EN_GG - EN_GH - EN_GI - EN_GM - EN_GU - EN_GY - EN_HK - EN_IE - EN_IL - EN_IM - EN_IN - EN_IO - EN_JE - EN_JM - EN_KE - EN_KI - EN_KN - EN_KY - EN_LC - EN_LR - EN_LS - EN_MG - EN_MH - EN_MO - EN_MP - EN_MS - EN_MT - EN_MU - EN_MW - EN_MY - EN_NA - EN_NF - EN_NG - EN_NL - EN_NR - EN_NU - EN_NZ - EN_PG - EN_PH - EN_PK - EN_PN - EN_PR - EN_PW - EN_RW - EN_SB - EN_SC - EN_SD - EN_SE - EN_SG - EN_SH - EN_SI - EN_SL - EN_SS - EN_SX - EN_SZ - EN_TC - EN_TK - EN_TO - EN_TT - EN_TV - EN_TZ - EN_UG - EN_UM - EN_US - EN_VC - EN_VG - EN_VI - EN_VU - EN_WS - EN_ZA - EN_ZM - EN_ZW - EO - ES - ES_AR - ES_BO - ES_BR - ES_BZ - ES_CL - ES_CO - ES_CR - ES_CU - ES_DO - ES_EA - ES_EC - ES_ES - ES_GQ - ES_GT - ES_HN - ES_IC - ES_MX - ES_NI - ES_PA - ES_PE - ES_PH - ES_PR - ES_PY - ES_SV - ES_US - ES_UY - ES_VE - ET - ET_EE - EU - EU_ES - EWO - EWO_CM - FA - FA_AF - FA_IR - FF - FF_ADLM - FF_ADLM_BF - FF_ADLM_CM - FF_ADLM_GH - FF_ADLM_GM - FF_ADLM_GN - FF_ADLM_GW - FF_ADLM_LR - FF_ADLM_MR - FF_ADLM_NE - FF_ADLM_NG - FF_ADLM_SL - FF_ADLM_SN - FF_LATN - FF_LATN_BF - FF_LATN_CM - FF_LATN_GH - FF_LATN_GM - FF_LATN_GN - FF_LATN_GW - FF_LATN_LR - FF_LATN_MR - FF_LATN_NE - FF_LATN_NG - FF_LATN_SL - FF_LATN_SN - FI - FI_FI - FIL - FIL_PH - FO - FO_DK - FO_FO - FR - FR_BE - FR_BF - FR_BI - FR_BJ - FR_BL - FR_CA - FR_CD - FR_CF - FR_CG - FR_CH - FR_CI - FR_CM - FR_DJ - FR_DZ - FR_FR - FR_GA - FR_GF - FR_GN - FR_GP - FR_GQ - FR_HT - FR_KM - FR_LU - FR_MA - FR_MC - FR_MF - FR_MG - FR_ML - FR_MQ - FR_MR - FR_MU - FR_NC - FR_NE - FR_PF - FR_PM - FR_RE - FR_RW - FR_SC - FR_SN - FR_SY - FR_TD - FR_TG - FR_TN - FR_VU - FR_WF - FR_YT - FUR - FUR_IT - FY - FY_NL - GA - GA_GB - GA_IE - GD - GD_GB - GL - GL_ES - GSW - GSW_CH - GSW_FR - GSW_LI - GU - GU_IN - GUZ - GUZ_KE - GV - GV_IM - HA - HA_GH - HA_NE - HA_NG - HAW - HAW_US - HE - HE_IL - HI - HI_IN - HR - HR_BA - HR_HR - HSB - HSB_DE - HU - HU_HU - HY - HY_AM - IA - ID - ID_ID - IG - IG_NG - II - II_CN - IS - IS_IS - IT - IT_CH - IT_IT - IT_SM - IT_VA - JA - JA_JP - JGO - JGO_CM - JMC - JMC_TZ - JV - JV_ID - KA - KA_GE - KAB - KAB_DZ - KAM - KAM_KE - KDE - KDE_TZ - KEA - KEA_CV - KHQ - KHQ_ML - KI - KI_KE - KK - KK_KZ - KKJ - KKJ_CM - KL - KL_GL - KLN - KLN_KE - KM - KM_KH - KN - KN_IN - KO - KO_KP - KO_KR - KOK - KOK_IN - KS - KS_ARAB - KS_ARAB_IN - KSB - KSB_TZ - KSF - KSF_CM - KSH - KSH_DE - KU - KU_TR - KW - KW_GB - KY - KY_KG - LAG - LAG_TZ - LB - LB_LU - LG - LG_UG - LKT - LKT_US - LN - LN_AO - LN_CD - LN_CF - LN_CG - LO - LO_LA - LRC - LRC_IQ - LRC_IR - LT - LT_LT - LU - LU_CD - LUO - LUO_KE - LUY - LUY_KE - LV - LV_LV - MAI - MAI_IN - MAS - MAS_KE - MAS_TZ - MER - MER_KE - MFE - MFE_MU - MG - MG_MG - MGH - MGH_MZ - MGO - MGO_CM - MI - MI_NZ - MK - MK_MK - ML - ML_IN - MN - MN_MN - MNI - MNI_BENG - MNI_BENG_IN - MR - MR_IN - MS - MS_BN - MS_ID - MS_MY - MS_SG - MT - MT_MT - MUA - MUA_CM - MY - MY_MM - MZN - MZN_IR - NAQ - NAQ_NA - NB - NB_NO - NB_SJ - ND - ND_ZW - NDS - NDS_DE - NDS_NL - NE - NE_IN - NE_NP - NL - NL_AW - NL_BE - NL_BQ - NL_CW - NL_NL - NL_SR - NL_SX - NMG - NMG_CM - NN - NN_NO - NNH - NNH_CM - NUS - NUS_SS - NYN - NYN_UG - OM - OM_ET - OM_KE - OR - OR_IN - OS - OS_GE - OS_RU - PA - PA_ARAB - PA_ARAB_PK - PA_GURU - PA_GURU_IN - PCM - PCM_NG - PL - PL_PL - PRG - PS - PS_AF - PS_PK - PT - PT_AO - PT_BR - PT_CH - PT_CV - PT_GQ - PT_GW - PT_LU - PT_MO - PT_MZ - PT_PT - PT_ST - PT_TL - QU - QU_BO - QU_EC - QU_PE - RM - RM_CH - RN - RN_BI - RO - RO_MD - RO_RO - ROF - ROF_TZ - RU - RU_BY - RU_KG - RU_KZ - RU_MD - RU_RU - RU_UA - RW - RW_RW - RWK - RWK_TZ - SAH - SAH_RU - SAQ - SAQ_KE - SAT - SAT_OLCK - SAT_OLCK_IN - SBP - SBP_TZ - SD - SD_ARAB - SD_ARAB_PK - SD_DEVA - SD_DEVA_IN - SE - SE_FI - SE_NO - SE_SE - SEH - SEH_MZ - SES - SES_ML - SG - SG_CF - SHI - SHI_LATN - SHI_LATN_MA - SHI_TFNG - SHI_TFNG_MA - SI - SI_LK - SK - SK_SK - SL - SL_SI - SMN - SMN_FI - SN - SN_ZW - SO - SO_DJ - SO_ET - SO_KE - SO_SO - SQ - SQ_AL - SQ_MK - SQ_XK - SR - SR_CYRL - SR_CYRL_BA - SR_CYRL_ME - SR_CYRL_RS - SR_CYRL_XK - SR_LATN - SR_LATN_BA - SR_LATN_ME - SR_LATN_RS - SR_LATN_XK - SU - SU_LATN - SU_LATN_ID - SV - SV_AX - SV_FI - SV_SE - SW - SW_CD - SW_KE - SW_TZ - SW_UG - TA - TA_IN - TA_LK - TA_MY - TA_SG - TE - TE_IN - TEO - TEO_KE - TEO_UG - TG - TG_TJ - TH - TH_TH - TI - TI_ER - TI_ET - TK - TK_TM - TO - TO_TO - TR - TR_CY - TR_TR - TT - TT_RU - TWQ - TWQ_NE - TZM - TZM_MA - UG - UG_CN - UK - UK_UA - UR - UR_IN - UR_PK - UZ - UZ_ARAB - UZ_ARAB_AF - UZ_CYRL - UZ_CYRL_UZ - UZ_LATN - UZ_LATN_UZ - VAI - VAI_LATN - VAI_LATN_LR - VAI_VAII - VAI_VAII_LR - VI - VI_VN - VO - VUN - VUN_TZ - WAE - WAE_CH - WO - WO_SN - XH - XH_ZA - XOG - XOG_UG - YAV - YAV_CM - YI - YO - YO_BJ - YO_NG - YUE - YUE_HANS - YUE_HANS_CN - YUE_HANT - YUE_HANT_HK - ZGH - ZGH_MA - ZH - ZH_HANS - ZH_HANS_CN - ZH_HANS_HK - ZH_HANS_MO - ZH_HANS_SG - ZH_HANT - ZH_HANT_HK - ZH_HANT_MO - ZH_HANT_TW - ZU - ZU_ZA -} - -""" -Represents shipping method channel listing. -""" -type ShippingMethodChannelListing implements Node { - id: ID! - channel: Channel! - maximumOrderPrice: Money - minimumOrderPrice: Money - price: Money -} - -""" -Represents channel. -""" -type Channel implements Node { - id: ID! - name: String! - isActive: Boolean! - currencyCode: String! - slug: String! - - """ - Whether a channel has associated orders. - - Requires one of the following permissions: MANAGE_CHANNELS. - """ - hasOrders: Boolean! - - """ - Default country for the channel. Default country can be used in checkout to determine the stock quantities or calculate taxes when the country was not explicitly provided. - - Added in Saleor 3.1. - """ - defaultCountry: CountryDisplay! -} - -""" -Represents shipping method postal code rule. -""" -type ShippingMethodPostalCodeRule implements Node { - """ - The ID of the object. - """ - id: ID! - - """ - Start address range. - """ - start: String - - """ - End address range. - """ - end: String - - """ - Inclusion type of the postal code rule. - """ - inclusionType: PostalCodeRuleInclusionTypeEnum -} - -""" -An enumeration. -""" -enum PostalCodeRuleInclusionTypeEnum { - INCLUDE - EXCLUDE -} - -type ProductCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [ProductCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type ProductCountableEdge { - """ - The item at the end of the edge. - """ - node: Product! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -""" -Represents an individual item for sale in the storefront. -""" -type Product implements Node & ObjectWithMetadata { - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - seoTitle: String - seoDescription: String - name: String! - - """ - Description of the product. - - Rich text format. For reference see https://editorjs.io/ - """ - description: JSONString - productType: ProductType! - slug: String! - category: Category - created: DateTime! - updatedAt: DateTime! - chargeTaxes: Boolean! - weight: Weight - defaultVariant: ProductVariant - rating: Float - - """ - Channel given to retrieve this product. Also used by federation gateway to resolve this object in a federated query. - """ - channel: String - - """ - Description of the product. - - Rich text format. For reference see https://editorjs.io/ - """ - descriptionJson: JSONString - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `description` field instead." - ) - - """ - The main thumbnail for a product. - """ - thumbnail( - """ - Size of thumbnail. - """ - size: Int - ): Image - - """ - Lists the storefront product's pricing, the current price and discounts, only meant for displaying. - """ - pricing( - """ - Destination address used to find warehouses where stock availability for this product is checked. If address is empty, uses `Shop.companyAddress` or fallbacks to server's `settings.DEFAULT_COUNTRY` configuration. - """ - address: AddressInput - ): ProductPricingInfo - - """ - Whether the product is in stock and visible or not. - """ - isAvailable( - """ - Destination address used to find warehouses where stock availability for this product is checked. If address is empty, uses `Shop.companyAddress` or fallbacks to server's `settings.DEFAULT_COUNTRY` configuration. - """ - address: AddressInput - ): Boolean - - """ - A type of tax. Assigned by enabled tax gateway - """ - taxType: TaxType - - """ - List of attributes assigned to this product. - """ - attributes: [SelectedAttribute!]! - - """ - List of availability in channels for the product. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - channelListings: [ProductChannelListing!] - - """ - Get a single product media by ID. - """ - mediaById( - """ - ID of a product media. - """ - id: ID - ): ProductMedia - - """ - Get a single product image by ID. - """ - imageById( - """ - ID of a product image. - """ - id: ID - ): ProductImage - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `mediaById` field instead." - ) - - """ - List of variants for the product. Requires the following permissions to include the unpublished items: MANAGE_ORDERS, MANAGE_DISCOUNTS, MANAGE_PRODUCTS. - """ - variants: [ProductVariant!] - - """ - List of media for the product. - """ - media: [ProductMedia!] - - """ - List of images for the product. - """ - images: [ProductImage!] - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `media` field instead." - ) - - """ - List of collections for the product. Requires the following permissions to include the unpublished items: MANAGE_ORDERS, MANAGE_DISCOUNTS, MANAGE_PRODUCTS. - """ - collections: [Collection!] - - """ - Returns translated product fields for the given language code. - """ - translation( - """ - A language code to return the translation for product. - """ - languageCode: LanguageCodeEnum! - ): ProductTranslation - - """ - Date when product is available for purchase. - """ - availableForPurchase: Date - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `availableForPurchaseAt` field to fetch the available for purchase date." - ) - - """ - Date when product is available for purchase. - """ - availableForPurchaseAt: DateTime - - """ - Whether the product is available for purchase. - """ - isAvailableForPurchase: Boolean -} - -""" -Represents a type of product. It defines what attributes are available to products of this type. -""" -type ProductType implements Node & ObjectWithMetadata { - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - name: String! - slug: String! - hasVariants: Boolean! - isShippingRequired: Boolean! - isDigital: Boolean! - weight: Weight - - """ - The product type kind. - """ - kind: ProductTypeKindEnum! - - """ - List of products of this type. - """ - products( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): ProductCountableConnection - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the top-level `products` query with the `productTypes` filter." - ) - - """ - A type of tax. Assigned by enabled tax gateway - """ - taxType: TaxType - - """ - Variant attributes of that product type. - """ - variantAttributes( - """ - Define scope of returned attributes. - """ - variantSelection: VariantAttributeScope - ): [Attribute!] - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `assignedVariantAttributes` instead." - ) - - """ - Variant attributes of that product type with attached variant selection. - - Added in Saleor 3.1. - """ - assignedVariantAttributes( - """ - Define scope of returned attributes. - """ - variantSelection: VariantAttributeScope - ): [AssignedVariantAttribute!] - - """ - Product attributes of that product type. - """ - productAttributes: [Attribute!] - - """ - List of attributes which can be assigned to this product type. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - availableAttributes( - filter: AttributeFilterInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): AttributeCountableConnection -} - -""" -Represents weight value in a specific weight unit. -""" -type Weight { - """ - Weight unit. - """ - unit: WeightUnitsEnum! - - """ - Weight value. - """ - value: Float! -} - -""" -An enumeration. -""" -enum WeightUnitsEnum { - G - LB - OZ - KG - TONNE -} - -""" -An enumeration. -""" -enum ProductTypeKindEnum { - NORMAL - GIFT_CARD -} - -""" -Representation of tax types fetched from tax gateway. -""" -type TaxType { - """ - Description of the tax type. - """ - description: String - - """ - External tax code used to identify given tax group. - """ - taxCode: String -} - -""" -Custom attribute of a product. Attributes can be assigned to products and variants at the product type level. -""" -type Attribute implements Node & ObjectWithMetadata { - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - - """ - The input type to use for entering attribute values in the dashboard. - """ - inputType: AttributeInputTypeEnum - - """ - The entity type which can be used as a reference. - """ - entityType: AttributeEntityTypeEnum - - """ - Name of an attribute displayed in the interface. - """ - name: String - - """ - Internal representation of an attribute name. - """ - slug: String - - """ - The attribute type. - """ - type: AttributeTypeEnum - - """ - The unit of attribute values. - """ - unit: MeasurementUnitsEnum - - """ - List of attribute's values. - """ - choices( - """ - Sort attribute choices. - """ - sortBy: AttributeChoicesSortingInput - - """ - Filtering options for attribute choices. - """ - filter: AttributeValueFilterInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): AttributeValueCountableConnection - - """ - Whether the attribute requires values to be passed or not. Requires one of the following permissions: MANAGE_PAGES, MANAGE_PAGE_TYPES_AND_ATTRIBUTES, MANAGE_PRODUCTS, MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. - """ - valueRequired: Boolean! - - """ - Whether the attribute should be visible or not in storefront. Requires one of the following permissions: MANAGE_PAGES, MANAGE_PAGE_TYPES_AND_ATTRIBUTES, MANAGE_PRODUCTS, MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. - """ - visibleInStorefront: Boolean! - - """ - Whether the attribute can be filtered in storefront. Requires one of the following permissions: MANAGE_PAGES, MANAGE_PAGE_TYPES_AND_ATTRIBUTES, MANAGE_PRODUCTS, MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. - """ - filterableInStorefront: Boolean! - - """ - Whether the attribute can be filtered in dashboard. Requires one of the following permissions: MANAGE_PAGES, MANAGE_PAGE_TYPES_AND_ATTRIBUTES, MANAGE_PRODUCTS, MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. - """ - filterableInDashboard: Boolean! - - """ - Whether the attribute can be displayed in the admin product list. Requires one of the following permissions: MANAGE_PAGES, MANAGE_PAGE_TYPES_AND_ATTRIBUTES, MANAGE_PRODUCTS, MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. - """ - availableInGrid: Boolean! - - """ - The position of the attribute in the storefront navigation (0 by default). Requires one of the following permissions: MANAGE_PAGES, MANAGE_PAGE_TYPES_AND_ATTRIBUTES, MANAGE_PRODUCTS, MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. - """ - storefrontSearchPosition: Int! - - """ - Returns translated attribute fields for the given language code. - """ - translation( - """ - A language code to return the translation for attribute. - """ - languageCode: LanguageCodeEnum! - ): AttributeTranslation - - """ - Flag indicating that attribute has predefined choices. - """ - withChoices: Boolean! - productTypes( - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): ProductTypeCountableConnection! - productVariantTypes( - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): ProductTypeCountableConnection! -} - -""" -An enumeration. -""" -enum AttributeInputTypeEnum { - DROPDOWN - MULTISELECT - FILE - REFERENCE - NUMERIC - RICH_TEXT - SWATCH - BOOLEAN - DATE - DATE_TIME -} - -""" -An enumeration. -""" -enum AttributeEntityTypeEnum { - PAGE - PRODUCT -} - -""" -An enumeration. -""" -enum AttributeTypeEnum { - PRODUCT_TYPE - PAGE_TYPE -} - -""" -An enumeration. -""" -enum MeasurementUnitsEnum { - CM - M - KM - FT - YD - INCH - SQ_CM - SQ_M - SQ_KM - SQ_FT - SQ_YD - SQ_INCH - CUBIC_MILLIMETER - CUBIC_CENTIMETER - CUBIC_DECIMETER - CUBIC_METER - LITER - CUBIC_FOOT - CUBIC_INCH - CUBIC_YARD - QT - PINT - FL_OZ - ACRE_IN - ACRE_FT - G - LB - OZ - KG - TONNE -} - -type AttributeValueCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [AttributeValueCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type AttributeValueCountableEdge { - """ - The item at the end of the edge. - """ - node: AttributeValue! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -""" -Represents a value of an attribute. -""" -type AttributeValue implements Node { - id: ID! - - """ - Name of a value displayed in the interface. - """ - name: String - - """ - Internal representation of a value (unique per attribute). - """ - slug: String - - """ - Represent value of the attribute value (e.g. color values for swatch attributes). - """ - value: String - - """ - Returns translated attribute value fields for the given language code. - """ - translation( - """ - A language code to return the translation for attribute value. - """ - languageCode: LanguageCodeEnum! - ): AttributeValueTranslation - - """ - The input type to use for entering attribute values in the dashboard. - """ - inputType: AttributeInputTypeEnum - - """ - The ID of the attribute reference. - """ - reference: ID - - """ - Represents file URL and content type (if attribute value is a file). - """ - file: File - - """ - Represents the text of the attribute value, includes formatting. - - Rich text format. For reference see https://editorjs.io/ - """ - richText: JSONString - - """ - Represents the boolean value of the attribute value. - """ - boolean: Boolean - - """ - Represents the date value of the attribute value. - """ - date: Date - - """ - Represents the date/time value of the attribute value. - """ - dateTime: DateTime -} - -type AttributeValueTranslation implements Node { - id: ID! - - """ - Translation language. - """ - language: LanguageDisplay! - name: String! - - """ - Attribute value. - - Rich text format. For reference see https://editorjs.io/ - """ - richText: JSONString -} - -type File { - """ - The URL of the file. - """ - url: String! - - """ - Content type of the file. - """ - contentType: String -} - -""" -The `Date` scalar type represents a Date -value as specified by -[iso8601](https://en.wikipedia.org/wiki/ISO_8601). -""" -scalar Date - -input AttributeChoicesSortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Sort attribute choices by the selected field. - """ - field: AttributeChoicesSortField! -} - -enum AttributeChoicesSortField { - """ - Sort attribute choice by name. - """ - NAME - - """ - Sort attribute choice by slug. - """ - SLUG -} - -input AttributeValueFilterInput { - search: String - ids: [ID!] -} - -type AttributeTranslation implements Node { - id: ID! - - """ - Translation language. - """ - language: LanguageDisplay! - name: String! -} - -type ProductTypeCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [ProductTypeCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type ProductTypeCountableEdge { - """ - The item at the end of the edge. - """ - node: ProductType! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -enum VariantAttributeScope { - ALL - VARIANT_SELECTION - NOT_VARIANT_SELECTION -} - -""" -Represents assigned attribute to variant with variant selection attached. - -Added in Saleor 3.1. -""" -type AssignedVariantAttribute { - """ - Attribute assigned to variant. - """ - attribute: Attribute! - - """ - Determines, whether assigned attribute is allowed for variant selection. Supported variant types for variant selection are: ['dropdown', 'boolean', 'swatch', 'numeric'] - """ - variantSelection: Boolean! -} - -type AttributeCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [AttributeCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type AttributeCountableEdge { - """ - The item at the end of the edge. - """ - node: Attribute! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -input AttributeFilterInput { - valueRequired: Boolean - isVariantOnly: Boolean - visibleInStorefront: Boolean - filterableInStorefront: Boolean - filterableInDashboard: Boolean - availableInGrid: Boolean - metadata: [MetadataFilter!] - search: String - ids: [ID!] - type: AttributeTypeEnum - inCollection: ID - inCategory: ID - - """ - Specifies the channel by which the data should be filtered. - - DEPRECATED: this field will be removed in Saleor 4.0. Use root-level channel argument instead. - """ - channel: String -} - -input MetadataFilter { - """ - Key of a metadata item. - """ - key: String! - - """ - Value of a metadata item. - """ - value: String -} - -""" -Represents a single category of products. Categories allow to organize products in a tree-hierarchies which can be used for navigation in the storefront. -""" -type Category implements Node & ObjectWithMetadata { - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - seoTitle: String - seoDescription: String - name: String! - - """ - Description of the category. - - Rich text format. For reference see https://editorjs.io/ - """ - description: JSONString - slug: String! - parent: Category - level: Int! - - """ - Description of the category. - - Rich text format. For reference see https://editorjs.io/ - """ - descriptionJson: JSONString - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `description` field instead." - ) - - """ - List of ancestors of the category. - """ - ancestors( - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): CategoryCountableConnection - - """ - List of products in the category. Requires the following permissions to include the unpublished items: MANAGE_ORDERS, MANAGE_DISCOUNTS, MANAGE_PRODUCTS. - """ - products( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): ProductCountableConnection - - """ - List of children of the category. - """ - children( - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): CategoryCountableConnection - backgroundImage( - """ - Size of the image. - """ - size: Int - ): Image - - """ - Returns translated category fields for the given language code. - """ - translation( - """ - A language code to return the translation for category. - """ - languageCode: LanguageCodeEnum! - ): CategoryTranslation -} - -type CategoryCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [CategoryCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type CategoryCountableEdge { - """ - The item at the end of the edge. - """ - node: Category! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -""" -Represents an image. -""" -type Image { - """ - The URL of the image. - """ - url: String! - - """ - Alt text for an image. - """ - alt: String -} - -type CategoryTranslation implements Node { - id: ID! - - """ - Translation language. - """ - language: LanguageDisplay! - seoTitle: String - seoDescription: String - name: String - - """ - Translated description of the category. - - Rich text format. For reference see https://editorjs.io/ - """ - description: JSONString - - """ - Translated description of the category. - - Rich text format. For reference see https://editorjs.io/ - """ - descriptionJson: JSONString - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `description` field instead." - ) -} - -""" -Represents a version of a product such as different size or color. -""" -type ProductVariant implements Node & ObjectWithMetadata { - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - name: String! - sku: String - product: Product! - trackInventory: Boolean! - quantityLimitPerCustomer: Int - weight: Weight - - """ - Channel given to retrieve this product variant. Also used by federation gateway to resolve this object in a federated query. - """ - channel: String - - """ - List of price information in channels for the product. - - Requires one of the following permissions: AUTHENTICATED_APP, AUTHENTICATED_STAFF_USER. - """ - channelListings: [ProductVariantChannelListing!] - - """ - Lists the storefront variant's pricing, the current price and discounts, only meant for displaying. - """ - pricing( - """ - Destination address used to find warehouses where stock availability for this product is checked. If address is empty, uses `Shop.companyAddress` or fallbacks to server's `settings.DEFAULT_COUNTRY` configuration. - """ - address: AddressInput - ): VariantPricingInfo - - """ - List of attributes assigned to this variant. - """ - attributes( - """ - Define scope of returned attributes. - """ - variantSelection: VariantAttributeScope - ): [SelectedAttribute!]! - - """ - Gross margin percentage value. - """ - margin: Int - - """ - Total quantity ordered. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - quantityOrdered: Int - - """ - Total revenue generated by a variant in given period of time. Note: this field should be queried using `reportProductSales` query as it uses optimizations suitable for such calculations. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - revenue(period: ReportingPeriod): TaxedMoney - - """ - List of images for the product variant. - """ - images: [ProductImage!] - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `media` field instead." - ) - - """ - List of media for the product variant. - """ - media: [ProductMedia!] - - """ - Returns translated product variant fields for the given language code. - """ - translation( - """ - A language code to return the translation for product variant. - """ - languageCode: LanguageCodeEnum! - ): ProductVariantTranslation - - """ - Digital content for the product variant. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - digitalContent: DigitalContent - - """ - Stocks for the product variant. - - Requires one of the following permissions: MANAGE_PRODUCTS, MANAGE_ORDERS. - """ - stocks( - """ - Destination address used to find warehouses where stock availability for this product is checked. If address is empty, uses `Shop.companyAddress` or fallbacks to server's `settings.DEFAULT_COUNTRY` configuration. - """ - address: AddressInput - - """ - Two-letter ISO 3166-1 country code. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `address` argument instead. - """ - countryCode: CountryCode - ): [Stock!] - - """ - Quantity of a product available for sale in one checkout. Field value will be `null` when no `limitQuantityPerCheckout` in global settings has been set, and `productVariant` stocks are not tracked. - """ - quantityAvailable( - """ - Destination address used to find warehouses where stock availability for this product is checked. If address is empty, uses `Shop.companyAddress` or fallbacks to server's `settings.DEFAULT_COUNTRY` configuration. - """ - address: AddressInput - - """ - Two-letter ISO 3166-1 country code. When provided, the exact quantity from a warehouse operating in shipping zones that contain this country will be returned. Otherwise, it will return the maximum quantity from all shipping zones. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `address` argument instead. - """ - countryCode: CountryCode - ): Int - - """ - Preorder data for product variant. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - preorder: PreorderData - created: DateTime! - updatedAt: DateTime! -} - -""" -Represents product varaint channel listing. -""" -type ProductVariantChannelListing implements Node { - id: ID! - channel: Channel! - price: Money - - """ - Cost price of the variant. - """ - costPrice: Money - - """ - Gross margin percentage value. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - margin: Int - - """ - Preorder variant data. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - preorderThreshold: PreorderThreshold -} - -""" -Represents preorder variant data for channel. -""" -type PreorderThreshold { - """ - Preorder threshold for product variant in this channel. - """ - quantity: Int - - """ - Number of sold product variant in this channel. - """ - soldUnits: Int! -} - -""" -Represents availability of a variant in the storefront. -""" -type VariantPricingInfo { - """ - Whether it is in sale or not. - """ - onSale: Boolean - - """ - The discount amount if in sale (null otherwise). - """ - discount: TaxedMoney - - """ - The discount amount in the local currency. - """ - discountLocalCurrency: TaxedMoney - - """ - The price, with any discount subtracted. - """ - price: TaxedMoney - - """ - The price without any discount. - """ - priceUndiscounted: TaxedMoney - - """ - The discounted price in the local currency. - """ - priceLocalCurrency: TaxedMoney -} - -""" -Represents a monetary value with taxes. In cases where taxes were not applied, net and gross values will be equal. -""" -type TaxedMoney { - """ - Currency code. - """ - currency: String! - - """ - Amount of money including taxes. - """ - gross: Money! - - """ - Amount of money without taxes. - """ - net: Money! - - """ - Amount of taxes. - """ - tax: Money! -} - -input AddressInput { - """ - Given name. - """ - firstName: String - - """ - Family name. - """ - lastName: String - - """ - Company or organization. - """ - companyName: String - - """ - Address. - """ - streetAddress1: String - - """ - Address. - """ - streetAddress2: String - - """ - City. - """ - city: String - - """ - District. - """ - cityArea: String - - """ - Postal code. - """ - postalCode: String - - """ - Country. - """ - country: CountryCode - - """ - State or province. - """ - countryArea: String - - """ - Phone number. - """ - phone: String -} - -""" -An enumeration. -""" -enum CountryCode { - AF - AX - AL - DZ - AS - AD - AO - AI - AQ - AG - AR - AM - AW - AU - AT - AZ - BS - BH - BD - BB - BY - BE - BZ - BJ - BM - BT - BO - BQ - BA - BW - BV - BR - IO - BN - BG - BF - BI - CV - KH - CM - CA - KY - CF - TD - CL - CN - CX - CC - CO - KM - CG - CD - CK - CR - CI - HR - CU - CW - CY - CZ - DK - DJ - DM - DO - EC - EG - SV - GQ - ER - EE - SZ - ET - EU - FK - FO - FJ - FI - FR - GF - PF - TF - GA - GM - GE - DE - GH - GI - GR - GL - GD - GP - GU - GT - GG - GN - GW - GY - HT - HM - VA - HN - HK - HU - IS - IN - ID - IR - IQ - IE - IM - IL - IT - JM - JP - JE - JO - KZ - KE - KI - KW - KG - LA - LV - LB - LS - LR - LY - LI - LT - LU - MO - MG - MW - MY - MV - ML - MT - MH - MQ - MR - MU - YT - MX - FM - MD - MC - MN - ME - MS - MA - MZ - MM - NA - NR - NP - NL - NC - NZ - NI - NE - NG - NU - NF - KP - MK - MP - NO - OM - PK - PW - PS - PA - PG - PY - PE - PH - PN - PL - PT - PR - QA - RE - RO - RU - RW - BL - SH - KN - LC - MF - PM - VC - WS - SM - ST - SA - SN - RS - SC - SL - SG - SX - SK - SI - SB - SO - ZA - GS - KR - SS - ES - LK - SD - SR - SJ - SE - CH - SY - TW - TJ - TZ - TH - TL - TG - TK - TO - TT - TN - TR - TM - TC - TV - UG - UA - AE - GB - UM - US - UY - UZ - VU - VE - VN - VG - VI - WF - EH - YE - ZM - ZW -} - -""" -Represents a custom attribute. -""" -type SelectedAttribute { - """ - Name of an attribute displayed in the interface. - """ - attribute: Attribute! - - """ - Values of an attribute. - """ - values: [AttributeValue!]! -} - -enum ReportingPeriod { - TODAY - THIS_MONTH -} - -""" -Represents a product image. -""" -type ProductImage { - """ - The ID of the image. - """ - id: ID! - - """ - The alt text of the image. - """ - alt: String - - """ - The new relative sorting position of the item (from -inf to +inf). 1 moves the item one position forward, -1 moves the item one position backward, 0 leaves the item unchanged. - """ - sortOrder: Int - - """ - The URL of the image. - """ - url( - """ - Size of the image. - """ - size: Int - ): String! -} - -""" -Represents a product media. -""" -type ProductMedia implements Node { - id: ID! - sortOrder: Int - alt: String! - type: ProductMediaType! - oembedData: JSONString! - - """ - The URL of the media. - """ - url( - """ - Size of the image. - """ - size: Int - ): String! -} - -""" -An enumeration. -""" -enum ProductMediaType { - IMAGE - VIDEO -} - -type ProductVariantTranslation implements Node { - id: ID! - - """ - Translation language. - """ - language: LanguageDisplay! - name: String! -} - -type DigitalContent implements Node & ObjectWithMetadata { - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - useDefaultSettings: Boolean! - automaticFulfillment: Boolean! - contentFile: String! - maxDownloads: Int - urlValidDays: Int - - """ - List of URLs for the digital variant. - """ - urls: [DigitalContentUrl!] - - """ - Product variant assigned to digital content. - """ - productVariant: ProductVariant! -} - -type DigitalContentUrl implements Node { - id: ID! - content: DigitalContent! - created: DateTime! - downloadNum: Int! - - """ - URL for digital content. - """ - url: String - - """ - UUID of digital content. - """ - token: UUID! -} - -scalar UUID - -""" -Represents stock. -""" -type Stock implements Node { - id: ID! - warehouse: Warehouse! - productVariant: ProductVariant! - - """ - Quantity of a product in the warehouse's possession, including the allocated stock that is waiting for shipment. - - Requires one of the following permissions: MANAGE_PRODUCTS, MANAGE_ORDERS. - """ - quantity: Int! - - """ - Quantity allocated for orders. - - Requires one of the following permissions: MANAGE_PRODUCTS, MANAGE_ORDERS. - """ - quantityAllocated: Int! - - """ - Quantity reserved for checkouts. - - Requires one of the following permissions: MANAGE_PRODUCTS, MANAGE_ORDERS. - """ - quantityReserved: Int! -} - -""" -Represents preorder settings for product variant. -""" -type PreorderData { - """ - The global preorder threshold for product variant. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - globalThreshold: Int - - """ - Total number of sold product variant during preorder. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - globalSoldUnits: Int! - - """ - Preorder end date. - """ - endDate: DateTime -} - -""" -Represents availability of a product in the storefront. -""" -type ProductPricingInfo { - """ - Whether it is in sale or not. - """ - onSale: Boolean - - """ - The discount amount if in sale (null otherwise). - """ - discount: TaxedMoney - - """ - The discount amount in the local currency. - """ - discountLocalCurrency: TaxedMoney - - """ - The discounted price range of the product variants. - """ - priceRange: TaxedMoneyRange - - """ - The undiscounted price range of the product variants. - """ - priceRangeUndiscounted: TaxedMoneyRange - - """ - The discounted price range of the product variants in the local currency. - """ - priceRangeLocalCurrency: TaxedMoneyRange -} - -""" -Represents a range of monetary values. -""" -type TaxedMoneyRange { - """ - Lower bound of a price range. - """ - start: TaxedMoney - - """ - Upper bound of a price range. - """ - stop: TaxedMoney -} - -""" -Represents product channel listing. -""" -type ProductChannelListing implements Node { - id: ID! - publicationDate: Date - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `publishedAt` field to fetch the publication date." - ) - - """ - The product publication date time. - - Added in Saleor 3.3. - """ - publishedAt: DateTime - isPublished: Boolean! - channel: Channel! - visibleInListings: Boolean! - availableForPurchase: Date - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `availableForPurchaseAt` field to fetch the available for purchase date." - ) - - """ - The product available for purchase date time. - - Added in Saleor 3.3. - """ - availableForPurchaseAt: DateTime - - """ - The price of the cheapest variant (including discounts). - """ - discountedPrice: Money - - """ - Purchase cost of product. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - purchaseCost: MoneyRange - - """ - Range of margin percentage value. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - margin: Margin - - """ - Whether the product is available for purchase. - """ - isAvailableForPurchase: Boolean - - """ - Lists the storefront product's pricing, the current price and discounts, only meant for displaying. - """ - pricing( - """ - Destination address used to find warehouses where stock availability for this product is checked. If address is empty, uses `Shop.companyAddress` or fallbacks to server's `settings.DEFAULT_COUNTRY` configuration. - """ - address: AddressInput - ): ProductPricingInfo -} - -type Margin { - start: Int - stop: Int -} - -""" -Represents a collection of products. -""" -type Collection implements Node & ObjectWithMetadata { - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - seoTitle: String - seoDescription: String - name: String! - - """ - Description of the collection. - - Rich text format. For reference see https://editorjs.io/ - """ - description: JSONString - slug: String! - - """ - Channel given to retrieve this collection. Also used by federation gateway to resolve this object in a federated query. - """ - channel: String - - """ - Description of the collection. - - Rich text format. For reference see https://editorjs.io/ - """ - descriptionJson: JSONString - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `description` field instead." - ) - - """ - List of products in this collection. - """ - products( - """ - Filtering options for products. - """ - filter: ProductFilterInput - - """ - Sort products. - """ - sortBy: ProductOrder - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): ProductCountableConnection - backgroundImage( - """ - Size of the image. - """ - size: Int - ): Image - - """ - Returns translated collection fields for the given language code. - """ - translation( - """ - A language code to return the translation for collection. - """ - languageCode: LanguageCodeEnum! - ): CollectionTranslation - - """ - List of channels in which the collection is available. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - channelListings: [CollectionChannelListing!] -} - -input ProductFilterInput { - isPublished: Boolean - collections: [ID!] - categories: [ID!] - hasCategory: Boolean - attributes: [AttributeInput!] - stockAvailability: StockAvailability - stocks: ProductStockFilterInput - search: String - metadata: [MetadataFilter!] - price: PriceRangeInput - minimalPrice: PriceRangeInput - updatedAt: DateTimeRangeInput - productTypes: [ID!] - giftCard: Boolean - ids: [ID!] - hasPreorderedVariants: Boolean - - """ - Specifies the channel by which the data should be filtered. - - DEPRECATED: this field will be removed in Saleor 4.0. Use root-level channel argument instead. - """ - channel: String -} - -input AttributeInput { - """ - Internal representation of an attribute name. - """ - slug: String! - - """ - Internal representation of a value (unique per attribute). - """ - values: [String!] - - """ - The range that the returned values should be in. - """ - valuesRange: IntRangeInput - - """ - The date/time range that the returned values should be in. - """ - dateTime: DateTimeRangeInput - - """ - The date range that the returned values should be in. In case of date/time attributes, the UTC midnight of the given date is used. - """ - date: DateRangeInput - - """ - The boolean value of the attribute. - """ - boolean: Boolean -} - -input IntRangeInput { - """ - Value greater than or equal to. - """ - gte: Int - - """ - Value less than or equal to. - """ - lte: Int -} - -input DateTimeRangeInput { - """ - Start date. - """ - gte: DateTime - - """ - End date. - """ - lte: DateTime -} - -input DateRangeInput { - """ - Start date. - """ - gte: Date - - """ - End date. - """ - lte: Date -} - -enum StockAvailability { - IN_STOCK - OUT_OF_STOCK -} - -input ProductStockFilterInput { - warehouseIds: [ID!] - quantity: IntRangeInput -} - -input PriceRangeInput { - """ - Price greater than or equal to. - """ - gte: Float - - """ - Price less than or equal to. - """ - lte: Float -} - -input ProductOrder { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Specifies the channel in which to sort the data. - - DEPRECATED: this field will be removed in Saleor 4.0. Use root-level channel argument instead. - """ - channel: String - - """ - Sort product by the selected attribute's values. - Note: this doesn't take translations into account yet. - """ - attributeId: ID - - """ - Sort products by the selected field. - """ - field: ProductOrderField -} - -enum ProductOrderField { - """ - Sort products by name. - """ - NAME - - """ - Sort products by rank. Note: This option is available only with the `search` filter. - """ - RANK - - """ - Sort products by price. - - This option requires a channel filter to work as the values can vary between channels. - """ - PRICE - - """ - Sort products by a minimal price of a product's variant. - - This option requires a channel filter to work as the values can vary between channels. - """ - MINIMAL_PRICE - - """ - Sort products by update date. - """ - LAST_MODIFIED - - """ - Sort products by update date. - """ - DATE - - """ - Sort products by type. - """ - TYPE - - """ - Sort products by publication status. - - This option requires a channel filter to work as the values can vary between channels. - """ - PUBLISHED - - """ - Sort products by publication date. - - This option requires a channel filter to work as the values can vary between channels. - """ - PUBLICATION_DATE - - """ - Sort products by publication date. - - This option requires a channel filter to work as the values can vary between channels. - """ - PUBLISHED_AT - - """ - Sort products by update date. - """ - LAST_MODIFIED_AT - - """ - Sort products by collection. Note: This option is available only for the `Collection.products` query. - - This option requires a channel filter to work as the values can vary between channels. - """ - COLLECTION - - """ - Sort products by rating. - """ - RATING -} - -type CollectionTranslation implements Node { - id: ID! - - """ - Translation language. - """ - language: LanguageDisplay! - seoTitle: String - seoDescription: String - name: String - - """ - Translated description of the collection. - - Rich text format. For reference see https://editorjs.io/ - """ - description: JSONString - - """ - Translated description of the collection. - - Rich text format. For reference see https://editorjs.io/ - """ - descriptionJson: JSONString - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `description` field instead." - ) -} - -""" -Represents collection channel listing. -""" -type CollectionChannelListing implements Node { - id: ID! - publicationDate: Date - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `publishedAt` field to fetch the publication date." - ) - - """ - The collection publication date. - - Added in Saleor 3.3. - """ - publishedAt: DateTime - isPublished: Boolean! - channel: Channel! -} - -type ProductTranslation implements Node { - id: ID! - - """ - Translation language. - """ - language: LanguageDisplay! - seoTitle: String - seoDescription: String - name: String - - """ - Translated description of the product. - - Rich text format. For reference see https://editorjs.io/ - """ - description: JSONString - - """ - Translated description of the product. - - Rich text format. For reference see https://editorjs.io/ - """ - descriptionJson: JSONString - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `description` field instead." - ) -} - -type WarehouseCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [WarehouseCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type WarehouseCountableEdge { - """ - The item at the end of the edge. - """ - node: Warehouse! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -input WarehouseFilterInput { - clickAndCollectOption: WarehouseClickAndCollectOptionEnum - search: String - ids: [ID!] - isPrivate: Boolean -} - -input WarehouseSortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Sort warehouses by the selected field. - """ - field: WarehouseSortField! -} - -enum WarehouseSortField { - """ - Sort warehouses by name. - """ - NAME -} - -type TranslatableItemConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [TranslatableItemEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type TranslatableItemEdge { - """ - The item at the end of the edge. - """ - node: TranslatableItem! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -union TranslatableItem = - ProductTranslatableContent - | CollectionTranslatableContent - | CategoryTranslatableContent - | AttributeTranslatableContent - | AttributeValueTranslatableContent - | ProductVariantTranslatableContent - | PageTranslatableContent - | ShippingMethodTranslatableContent - | SaleTranslatableContent - | VoucherTranslatableContent - | MenuItemTranslatableContent - -type ProductTranslatableContent implements Node { - id: ID! - seoTitle: String - seoDescription: String - name: String! - - """ - Description of the product. - - Rich text format. For reference see https://editorjs.io/ - """ - description: JSONString - - """ - Description of the product. - - Rich text format. For reference see https://editorjs.io/ - """ - descriptionJson: JSONString - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `description` field instead." - ) - - """ - Returns translated product fields for the given language code. - """ - translation( - """ - A language code to return the translation for product. - """ - languageCode: LanguageCodeEnum! - ): ProductTranslation - - """ - Represents an individual item for sale in the storefront. - """ - product: Product - @deprecated( - reason: "This field will be removed in Saleor 4.0. Get model fields from the root level queries." - ) - - """ - List of product attribute values that can be translated. - """ - attributeValues: [AttributeValueTranslatableContent!]! -} - -type AttributeValueTranslatableContent implements Node { - id: ID! - name: String! - - """ - Attribute value. - - Rich text format. For reference see https://editorjs.io/ - """ - richText: JSONString - - """ - Returns translated attribute value fields for the given language code. - """ - translation( - """ - A language code to return the translation for attribute value. - """ - languageCode: LanguageCodeEnum! - ): AttributeValueTranslation - - """ - Represents a value of an attribute. - """ - attributeValue: AttributeValue - @deprecated( - reason: "This field will be removed in Saleor 4.0. Get model fields from the root level queries." - ) -} - -type CollectionTranslatableContent implements Node { - id: ID! - seoTitle: String - seoDescription: String - name: String! - - """ - Description of the collection. - - Rich text format. For reference see https://editorjs.io/ - """ - description: JSONString - - """ - Description of the collection. - - Rich text format. For reference see https://editorjs.io/ - """ - descriptionJson: JSONString - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `description` field instead." - ) - - """ - Returns translated collection fields for the given language code. - """ - translation( - """ - A language code to return the translation for collection. - """ - languageCode: LanguageCodeEnum! - ): CollectionTranslation - - """ - Represents a collection of products. - """ - collection: Collection - @deprecated( - reason: "This field will be removed in Saleor 4.0. Get model fields from the root level queries." - ) -} - -type CategoryTranslatableContent implements Node { - id: ID! - seoTitle: String - seoDescription: String - name: String! - - """ - Description of the category. - - Rich text format. For reference see https://editorjs.io/ - """ - description: JSONString - - """ - Description of the category. - - Rich text format. For reference see https://editorjs.io/ - """ - descriptionJson: JSONString - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `description` field instead." - ) - - """ - Returns translated category fields for the given language code. - """ - translation( - """ - A language code to return the translation for category. - """ - languageCode: LanguageCodeEnum! - ): CategoryTranslation - - """ - Represents a single category of products. - """ - category: Category - @deprecated( - reason: "This field will be removed in Saleor 4.0. Get model fields from the root level queries." - ) -} - -type AttributeTranslatableContent implements Node { - id: ID! - name: String! - - """ - Returns translated attribute fields for the given language code. - """ - translation( - """ - A language code to return the translation for attribute. - """ - languageCode: LanguageCodeEnum! - ): AttributeTranslation - - """ - Custom attribute of a product. - """ - attribute: Attribute - @deprecated( - reason: "This field will be removed in Saleor 4.0. Get model fields from the root level queries." - ) -} - -type ProductVariantTranslatableContent implements Node { - id: ID! - name: String! - - """ - Returns translated product variant fields for the given language code. - """ - translation( - """ - A language code to return the translation for product variant. - """ - languageCode: LanguageCodeEnum! - ): ProductVariantTranslation - - """ - Represents a version of a product such as different size or color. - """ - productVariant: ProductVariant - @deprecated( - reason: "This field will be removed in Saleor 4.0. Get model fields from the root level queries." - ) - - """ - List of product variant attribute values that can be translated. - """ - attributeValues: [AttributeValueTranslatableContent!]! -} - -type PageTranslatableContent implements Node { - id: ID! - seoTitle: String - seoDescription: String - title: String! - - """ - Content of the page. - - Rich text format. For reference see https://editorjs.io/ - """ - content: JSONString - - """ - Content of the page. - - Rich text format. For reference see https://editorjs.io/ - """ - contentJson: JSONString - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `content` field instead." - ) - - """ - Returns translated page fields for the given language code. - """ - translation( - """ - A language code to return the translation for page. - """ - languageCode: LanguageCodeEnum! - ): PageTranslation - - """ - A static page that can be manually added by a shop operator through the dashboard. - """ - page: Page - @deprecated( - reason: "This field will be removed in Saleor 4.0. Get model fields from the root level queries." - ) - - """ - List of page content attribute values that can be translated. - """ - attributeValues: [AttributeValueTranslatableContent!]! -} - -type PageTranslation implements Node { - id: ID! - - """ - Translation language. - """ - language: LanguageDisplay! - seoTitle: String - seoDescription: String - title: String - - """ - Translated content of the page. - - Rich text format. For reference see https://editorjs.io/ - """ - content: JSONString - - """ - Translated description of the page. - - Rich text format. For reference see https://editorjs.io/ - """ - contentJson: JSONString - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `content` field instead." - ) -} - -""" -A static page that can be manually added by a shop operator through the dashboard. -""" -type Page implements Node & ObjectWithMetadata { - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - seoTitle: String - seoDescription: String - title: String! - - """ - Content of the page. - - Rich text format. For reference see https://editorjs.io/ - """ - content: JSONString - publicationDate: Date - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `publishedAt` field to fetch the publication date." - ) - - """ - The page publication date. - - Added in Saleor 3.3. - """ - publishedAt: DateTime - isPublished: Boolean! - slug: String! - pageType: PageType! - created: DateTime! - - """ - Content of the page. - - Rich text format. For reference see https://editorjs.io/ - """ - contentJson: JSONString! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `content` field instead." - ) - - """ - Returns translated page fields for the given language code. - """ - translation( - """ - A language code to return the translation for page. - """ - languageCode: LanguageCodeEnum! - ): PageTranslation - - """ - List of attributes assigned to this product. - """ - attributes: [SelectedAttribute!]! -} - -""" -Represents a type of page. It defines what attributes are available to pages of this type. -""" -type PageType implements Node & ObjectWithMetadata { - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - name: String! - slug: String! - - """ - Page attributes of that page type. - """ - attributes: [Attribute!] - - """ - Attributes that can be assigned to the page type. - - Requires one of the following permissions: MANAGE_PAGES. - """ - availableAttributes( - filter: AttributeFilterInput - - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): AttributeCountableConnection - - """ - Whether page type has pages assigned. - - Requires one of the following permissions: MANAGE_PAGES. - """ - hasPages: Boolean -} - -type ShippingMethodTranslatableContent implements Node { - id: ID! - name: String! - - """ - Description of the shipping method. - - Rich text format. For reference see https://editorjs.io/ - """ - description: JSONString - - """ - Returns translated shipping method fields for the given language code. - """ - translation( - """ - A language code to return the translation for shipping method. - """ - languageCode: LanguageCodeEnum! - ): ShippingMethodTranslation - - """ - Shipping method are the methods you'll use to get customer's orders to them. They are directly exposed to the customers. - - Requires one of the following permissions: MANAGE_SHIPPING. - """ - shippingMethod: ShippingMethodType - @deprecated( - reason: "This field will be removed in Saleor 4.0. Get model fields from the root level queries." - ) -} - -type SaleTranslatableContent implements Node { - id: ID! - name: String! - - """ - Returns translated sale fields for the given language code. - """ - translation( - """ - A language code to return the translation for sale. - """ - languageCode: LanguageCodeEnum! - ): SaleTranslation - - """ - Sales allow creating discounts for categories, collections or products and are visible to all the customers. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - sale: Sale - @deprecated( - reason: "This field will be removed in Saleor 4.0. Get model fields from the root level queries." - ) -} - -type SaleTranslation implements Node { - id: ID! - - """ - Translation language. - """ - language: LanguageDisplay! - name: String -} - -""" -Sales allow creating discounts for categories, collections or products and are visible to all the customers. -""" -type Sale implements Node & ObjectWithMetadata { - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - name: String! - type: SaleType! - startDate: DateTime! - endDate: DateTime - created: DateTime! - updatedAt: DateTime! - - """ - List of categories this sale applies to. - """ - categories( - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): CategoryCountableConnection - - """ - List of collections this sale applies to. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - collections( - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): CollectionCountableConnection - - """ - List of products this sale applies to. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - products( - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): ProductCountableConnection - - """ - List of product variants this sale applies to. - - Added in Saleor 3.1. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - variants( - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): ProductVariantCountableConnection - - """ - Returns translated sale fields for the given language code. - """ - translation( - """ - A language code to return the translation for sale. - """ - languageCode: LanguageCodeEnum! - ): SaleTranslation - - """ - List of channels available for the sale. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - channelListings: [SaleChannelListing!] - - """ - Sale value. - """ - discountValue: Float - - """ - Currency code for sale. - """ - currency: String -} - -enum SaleType { - FIXED - PERCENTAGE -} - -type CollectionCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [CollectionCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type CollectionCountableEdge { - """ - The item at the end of the edge. - """ - node: Collection! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -type ProductVariantCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [ProductVariantCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type ProductVariantCountableEdge { - """ - The item at the end of the edge. - """ - node: ProductVariant! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -""" -Represents sale channel listing. -""" -type SaleChannelListing implements Node { - id: ID! - channel: Channel! - discountValue: Float! - currency: String! -} - -type VoucherTranslatableContent implements Node { - id: ID! - name: String - - """ - Returns translated voucher fields for the given language code. - """ - translation( - """ - A language code to return the translation for voucher. - """ - languageCode: LanguageCodeEnum! - ): VoucherTranslation - - """ - Vouchers allow giving discounts to particular customers on categories, collections or specific products. They can be used during checkout by providing valid voucher codes. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - voucher: Voucher - @deprecated( - reason: "This field will be removed in Saleor 4.0. Get model fields from the root level queries." - ) -} - -type VoucherTranslation implements Node { - id: ID! - - """ - Translation language. - """ - language: LanguageDisplay! - name: String -} - -""" -Vouchers allow giving discounts to particular customers on categories, collections or specific products. They can be used during checkout by providing valid voucher codes. -""" -type Voucher implements Node & ObjectWithMetadata { - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - name: String - code: String! - usageLimit: Int - used: Int! - startDate: DateTime! - endDate: DateTime - applyOncePerOrder: Boolean! - applyOncePerCustomer: Boolean! - onlyForStaff: Boolean! - minCheckoutItemsQuantity: Int - - """ - List of categories this voucher applies to. - """ - categories( - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): CategoryCountableConnection - - """ - List of collections this voucher applies to. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - collections( - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): CollectionCountableConnection - - """ - List of products this voucher applies to. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - products( - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): ProductCountableConnection - - """ - List of product variants this voucher applies to. - - Added in Saleor 3.1. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - variants( - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): ProductVariantCountableConnection - - """ - List of countries available for the shipping voucher. - """ - countries: [CountryDisplay!] - - """ - Returns translated voucher fields for the given language code. - """ - translation( - """ - A language code to return the translation for voucher. - """ - languageCode: LanguageCodeEnum! - ): VoucherTranslation - - """ - Determines a type of discount for voucher - value or percentage - """ - discountValueType: DiscountValueTypeEnum! - - """ - Voucher value. - """ - discountValue: Float - - """ - Currency code for voucher. - """ - currency: String - - """ - Minimum order value to apply voucher. - """ - minSpent: Money - - """ - Determines a type of voucher. - """ - type: VoucherTypeEnum! - - """ - List of availability in channels for the voucher. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - channelListings: [VoucherChannelListing!] -} - -enum DiscountValueTypeEnum { - FIXED - PERCENTAGE -} - -enum VoucherTypeEnum { - SHIPPING - ENTIRE_ORDER - SPECIFIC_PRODUCT -} - -""" -Represents voucher channel listing. -""" -type VoucherChannelListing implements Node { - id: ID! - channel: Channel! - discountValue: Float! - currency: String! - minSpent: Money -} - -type MenuItemTranslatableContent implements Node { - id: ID! - name: String! - - """ - Returns translated menu item fields for the given language code. - """ - translation( - """ - A language code to return the translation for menu item. - """ - languageCode: LanguageCodeEnum! - ): MenuItemTranslation - - """ - Represents a single item of the related menu. Can store categories, collection or pages. - """ - menuItem: MenuItem - @deprecated( - reason: "This field will be removed in Saleor 4.0. Get model fields from the root level queries." - ) -} - -type MenuItemTranslation implements Node { - id: ID! - - """ - Translation language. - """ - language: LanguageDisplay! - name: String! -} - -""" -Represents a single item of the related menu. Can store categories, collection or pages. -""" -type MenuItem implements Node & ObjectWithMetadata { - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - name: String! - menu: Menu! - parent: MenuItem - category: Category - - """ - A collection associated with this menu item. Requires one of the following permissions to include the unpublished items: MANAGE_ORDERS, MANAGE_DISCOUNTS, MANAGE_PRODUCTS. - """ - collection: Collection - - """ - A page associated with this menu item. Requires one of the following permissions to include unpublished items: MANAGE_PAGES. - """ - page: Page - level: Int! - children: [MenuItem!] - - """ - URL to the menu item. - """ - url: String - - """ - Returns translated menu item fields for the given language code. - """ - translation( - """ - A language code to return the translation for menu item. - """ - languageCode: LanguageCodeEnum! - ): MenuItemTranslation -} - -""" -Represents a single menu - an object that is used to help navigate through the store. -""" -type Menu implements Node & ObjectWithMetadata { - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - name: String! - slug: String! - items: [MenuItem!] -} - -enum TranslatableKinds { - ATTRIBUTE - ATTRIBUTE_VALUE - CATEGORY - COLLECTION - MENU_ITEM - PAGE - PRODUCT - SALE - SHIPPING_METHOD - VARIANT - VOUCHER -} - -type StockCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [StockCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type StockCountableEdge { - """ - The item at the end of the edge. - """ - node: Stock! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -input StockFilterInput { - """ - """ - quantity: Float - search: String -} - -""" -Represents a shop resource containing general shop data and configuration. -""" -type Shop { - """ - List of available payment gateways. - """ - availablePaymentGateways( - """ - A currency for which gateways will be returned. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `channel` argument instead. - """ - currency: String - - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): [PaymentGateway!]! - - """ - List of available external authentications. - """ - availableExternalAuthentications: [ExternalAuthentication!]! - - """ - Shipping methods that are available for the shop. - """ - availableShippingMethods( - """ - Slug of a channel for which the data should be returned. - """ - channel: String! - - """ - Address for which available shipping methods should be returned. - """ - address: AddressInput - ): [ShippingMethod!] - - """ - List of all currencies supported by shop's channels. - - Added in Saleor 3.1. - - Requires one of the following permissions: AUTHENTICATED_STAFF_USER, AUTHENTICATED_APP. - """ - channelCurrencies: [String!]! - - """ - List of countries available in the shop. - """ - countries( - """ - A language code to return the translation for. - - DEPRECATED: this field will be removed in Saleor 4.0. - """ - languageCode: LanguageCodeEnum - - """ - Filtering options for countries - """ - filter: CountryFilterInput - ): [CountryDisplay!]! - - """ - Shop's default country. - """ - defaultCountry: CountryDisplay - - """ - Default shop's email sender's name. - - Requires one of the following permissions: MANAGE_SETTINGS. - """ - defaultMailSenderName: String - - """ - Default shop's email sender's address. - - Requires one of the following permissions: MANAGE_SETTINGS. - """ - defaultMailSenderAddress: String - - """ - Shop's description. - """ - description: String - - """ - Shop's domain data. - """ - domain: Domain! - - """ - List of the shops's supported languages. - """ - languages: [LanguageDisplay!]! - - """ - Shop's name. - """ - name: String! - - """ - List of available permissions. - """ - permissions: [Permission!]! - - """ - List of possible phone prefixes. - """ - phonePrefixes: [String!]! - - """ - Header text. - """ - headerText: String - - """ - Include taxes in prices. - """ - includeTaxesInPrices: Boolean! - - """ - Automatically approve all new fulfillments. - - Added in Saleor 3.1. - """ - fulfillmentAutoApprove: Boolean! - - """ - Allow to approve fulfillments which are unpaid. - - Added in Saleor 3.1. - """ - fulfillmentAllowUnpaid: Boolean! - - """ - Display prices with tax in store. - """ - displayGrossPrices: Boolean! - - """ - Charge taxes on shipping. - """ - chargeTaxesOnShipping: Boolean! - - """ - Enable inventory tracking. - """ - trackInventoryByDefault: Boolean - - """ - Default weight unit. - """ - defaultWeightUnit: WeightUnitsEnum - - """ - Returns translated shop fields for the given language code. - """ - translation( - """ - A language code to return the translation for shop. - """ - languageCode: LanguageCodeEnum! - ): ShopTranslation - - """ - Enable automatic fulfillment for all digital products. - - Requires one of the following permissions: MANAGE_SETTINGS. - """ - automaticFulfillmentDigitalProducts: Boolean - - """ - Default number of minutes stock will be reserved for anonymous checkout or null when stock reservation is disabled. - - Added in Saleor 3.1. - - Requires one of the following permissions: MANAGE_SETTINGS. - """ - reserveStockDurationAnonymousUser: Int - - """ - Default number of minutes stock will be reserved for authenticated checkout or null when stock reservation is disabled. - - Added in Saleor 3.1. - - Requires one of the following permissions: MANAGE_SETTINGS. - """ - reserveStockDurationAuthenticatedUser: Int - - """ - Default number of maximum line quantity in single checkout (per single checkout line). - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - - Requires one of the following permissions: MANAGE_SETTINGS. - """ - limitQuantityPerCheckout: Int - - """ - Default number of max downloads per digital content URL. - - Requires one of the following permissions: MANAGE_SETTINGS. - """ - defaultDigitalMaxDownloads: Int - - """ - Default number of days which digital content URL will be valid. - - Requires one of the following permissions: MANAGE_SETTINGS. - """ - defaultDigitalUrlValidDays: Int - - """ - Company address. - """ - companyAddress: Address - - """ - URL of a view where customers can set their password. - """ - customerSetPasswordUrl: String - - """ - List of staff notification recipients. - - Requires one of the following permissions: MANAGE_SETTINGS. - """ - staffNotificationRecipients: [StaffNotificationRecipient!] - - """ - Resource limitations and current usage if any set for a shop - - Requires one of the following permissions: AUTHENTICATED_STAFF_USER. - """ - limits: LimitInfo! - - """ - Saleor API version. - - Requires one of the following permissions: AUTHENTICATED_STAFF_USER, AUTHENTICATED_APP. - """ - version: String! -} - -""" -Available payment gateway backend with configuration necessary to setup client. -""" -type PaymentGateway { - """ - Payment gateway name. - """ - name: String! - - """ - Payment gateway ID. - """ - id: ID! - - """ - Payment gateway client configuration. - """ - config: [GatewayConfigLine!]! - - """ - Payment gateway supported currencies. - """ - currencies: [String!]! -} - -""" -Payment gateway client configuration key and value pair. -""" -type GatewayConfigLine { - """ - Gateway config key. - """ - field: String! - - """ - Gateway config value for key. - """ - value: String -} - -type ExternalAuthentication { - """ - ID of external authentication plugin. - """ - id: String! - - """ - Name of external authentication plugin. - """ - name: String -} - -""" -Shipping methods that can be used as means of shipping for orders and checkouts. -""" -type ShippingMethod implements Node & ObjectWithMetadata { - """ - Unique ID of ShippingMethod available for Order. - """ - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - - """ - Type of the shipping method. - """ - type: ShippingMethodTypeEnum - @deprecated(reason: "This field will be removed in Saleor 4.0.") - - """ - Shipping method name. - """ - name: String! - - """ - Shipping method description. - - Rich text format. For reference see https://editorjs.io/ - """ - description: JSONString - - """ - Maximum delivery days for this shipping method. - """ - maximumDeliveryDays: Int - - """ - Minimum delivery days for this shipping method. - """ - minimumDeliveryDays: Int - - """ - Maximum order weight for this shipping method. - """ - maximumOrderWeight: Weight - @deprecated(reason: "This field will be removed in Saleor 4.0.") - - """ - Minimum order weight for this shipping method. - """ - minimumOrderWeight: Weight - @deprecated(reason: "This field will be removed in Saleor 4.0.") - - """ - Returns translated shipping method fields for the given language code. - """ - translation( - """ - A language code to return the translation for shipping method. - """ - languageCode: LanguageCodeEnum! - ): ShippingMethodTranslation - - """ - The price of selected shipping method. - """ - price: Money! - - """ - Maximum order price for this shipping method. - """ - maximumOrderPrice: Money - - """ - Minimal order price for this shipping method. - """ - minimumOrderPrice: Money - - """ - Describes if this shipping method is active and can be selected. - """ - active: Boolean! - - """ - Message connected to this shipping method. - """ - message: String -} - -input CountryFilterInput { - """ - Boolean for filtering countries by having shipping zone assigned.If 'true', return countries with shipping zone assigned.If 'false', return countries without any shipping zone assigned.If the argument is not provided (null), return all countries. - """ - attachedToShippingZones: Boolean -} - -""" -Represents shop's domain. -""" -type Domain { - """ - The host name of the domain. - """ - host: String! - - """ - Inform if SSL is enabled. - """ - sslEnabled: Boolean! - - """ - Shop's absolute URL. - """ - url: String! -} - -type ShopTranslation implements Node { - id: ID! - - """ - Translation language. - """ - language: LanguageDisplay! - headerText: String! - description: String! -} - -""" -Represents a recipient of email notifications send by Saleor, such as notifications about new orders. Notifications can be assigned to staff users or arbitrary email addresses. -""" -type StaffNotificationRecipient implements Node { - id: ID! - - """ - Returns a user subscribed to email notifications. - """ - user: User - - """ - Returns email address of a user subscribed to email notifications. - """ - email: String - - """ - Determines if a notification active. - """ - active: Boolean -} - -""" -Represents user data. -""" -type User implements Node & ObjectWithMetadata { - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - email: String! - firstName: String! - lastName: String! - isStaff: Boolean! - isActive: Boolean! - - """ - List of all user's addresses. - """ - addresses: [Address!] - - """ - Returns the last open checkout of this user. - """ - checkout: Checkout - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `checkoutTokens` field to fetch the user checkouts." - ) - - """ - Returns the checkout UUID's assigned to this user. - """ - checkoutTokens( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): [UUID!] - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `checkoutIds` instead." - ) - - """ - Returns the checkout ID's assigned to this user. - """ - checkoutIds( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): [ID!] - - """ - List of the user gift cards. - """ - giftCards( - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): GiftCardCountableConnection - - """ - A note about the customer. - - Requires one of the following permissions: MANAGE_USERS, MANAGE_STAFF. - """ - note: String - - """ - List of user's orders. Requires one of the following permissions: MANAGE_STAFF, OWNER. - """ - orders( - """ - Return the elements in the list that come before the specified cursor. - """ - before: String - - """ - Return the elements in the list that come after the specified cursor. - """ - after: String - - """ - Return the first n elements from the list. - """ - first: Int - - """ - Return the last n elements from the list. - """ - last: Int - ): OrderCountableConnection - - """ - List of user's permissions. - """ - userPermissions: [UserPermission!] - - """ - List of user's permission groups. - """ - permissionGroups: [Group!] - - """ - List of user's permission groups which user can manage. - """ - editableGroups: [Group!] - avatar( - """ - Size of the avatar. - """ - size: Int - ): Image - - """ - List of events associated with the user. - - Requires one of the following permissions: MANAGE_USERS, MANAGE_STAFF. - """ - events: [CustomerEvent!] - - """ - List of stored payment sources. - """ - storedPaymentSources( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): [PaymentSource!] - - """ - User language code. - """ - languageCode: LanguageCodeEnum! - defaultShippingAddress: Address - defaultBillingAddress: Address - lastLogin: DateTime - dateJoined: DateTime! - updatedAt: DateTime! -} - -""" -Checkout object. -""" -type Checkout implements Node & ObjectWithMetadata { - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - created: DateTime! - lastChange: DateTime! - user: User - channel: Channel! - billingAddress: Address - shippingAddress: Address - note: String! - discount: Money - discountName: String - translatedDiscountName: String - voucherCode: String - - """ - Shipping methods that can be used with this checkout. - """ - availableShippingMethods: [ShippingMethod!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `shippingMethods` instead." - ) - - """ - Shipping methods that can be used with this checkout. - """ - shippingMethods: [ShippingMethod!]! - - """ - Collection points that can be used for this order. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - availableCollectionPoints: [Warehouse!]! - - """ - List of available payment gateways. - """ - availablePaymentGateways: [PaymentGateway!]! - - """ - Email of a customer. - """ - email: String - - """ - List of gift cards associated with this checkout. - """ - giftCards: [GiftCard!]! - - """ - Returns True, if checkout requires shipping. - """ - isShippingRequired: Boolean! - - """ - The number of items purchased. - """ - quantity: Int! - - """ - Date when oldest stock reservation for this checkout expires or null if no stock is reserved. - - Added in Saleor 3.1. - """ - stockReservationExpires: DateTime - - """ - A list of checkout lines, each containing information about an item in the checkout. - """ - lines: [CheckoutLine!]! - - """ - The price of the shipping, with all the taxes included. - """ - shippingPrice: TaxedMoney! - - """ - The shipping method related with checkout. - """ - shippingMethod: ShippingMethod - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `deliveryMethod` instead." - ) - - """ - The delivery method selected for this checkout. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - deliveryMethod: DeliveryMethod - - """ - The price of the checkout before shipping, with taxes included. - """ - subtotalPrice: TaxedMoney! - - """ - The checkout's token. - """ - token: UUID! - - """ - The sum of the the checkout line prices, with all the taxes,shipping costs, and discounts included. - """ - totalPrice: TaxedMoney! - - """ - Checkout language code. - """ - languageCode: LanguageCodeEnum! - - """ - List of transactions for the checkout. Requires one of the following permissions: MANAGE_CHECKOUTS, HANDLE_PAYMENTS. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - transactions: [TransactionItem!] -} - -""" -A gift card is a prepaid electronic payment card accepted in stores. They can be used during checkout by providing a valid gift card codes. -""" -type GiftCard implements Node & ObjectWithMetadata { - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - - """ - Code in format which allows displaying in a user interface. - """ - displayCode: String! - - """ - Last 4 characters of gift card code. - """ - last4CodeChars: String! - - """ - Gift card code. Can be fetched by a staff member with MANAGE_GIFT_CARD when gift card wasn't yet used and by the gift card owner. - """ - code: String! - created: DateTime! - - """ - The user who bought or issued a gift card. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - createdBy: User - - """ - The customer who used a gift card. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - usedBy: User - - """ - Email address of the user who bought or issued gift card. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - - Requires one of the following permissions: MANAGE_USERS, OWNER. - """ - createdByEmail: String - - """ - Email address of the customer who used a gift card. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - usedByEmail: String - lastUsedOn: DateTime - expiryDate: Date - - """ - App which created the gift card. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - - Requires one of the following permissions: MANAGE_APPS, OWNER. - """ - app: App - - """ - Related gift card product. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - product: Product - - """ - List of events associated with the gift card. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - - Requires one of the following permissions: MANAGE_GIFT_CARD. - """ - events( - """ - Filtering options for gift card events. - """ - filter: GiftCardEventFilterInput - ): [GiftCardEvent!]! - - """ - The gift card tag. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - - Requires one of the following permissions: MANAGE_GIFT_CARD. - """ - tags: [GiftCardTag!]! - - """ - Slug of the channel where the gift card was bought. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - boughtInChannel: String - isActive: Boolean! - initialBalance: Money - currentBalance: Money - - """ - The customer who bought a gift card. - """ - user: User - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `createdBy` field instead." - ) - - """ - End date of gift card. - """ - endDate: DateTime - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `expiryDate` field instead." - ) - - """ - Start date of gift card. - """ - startDate: DateTime - @deprecated(reason: "This field will be removed in Saleor 4.0.") -} - -""" -History log of the gift card. - -Added in Saleor 3.1. - -Note: this API is currently in Feature Preview and can be subject to changes at later point. -""" -type GiftCardEvent implements Node { - id: ID! - - """ - Date when event happened at in ISO 8601 format. - """ - date: DateTime - - """ - Gift card event type. - """ - type: GiftCardEventsEnum - - """ - User who performed the action. Requires one of the following permissions: MANAGE_USERS, MANAGE_STAFF, OWNER. - """ - user: User - - """ - App that performed the action. Requires one of the following permissions: MANAGE_APPS, OWNER. - """ - app: App - - """ - Content of the event. - """ - message: String - - """ - Email of the customer. - """ - email: String - - """ - The order ID where gift card was used or bought. - """ - orderId: ID - - """ - User-friendly number of an order where gift card was used or bought. - """ - orderNumber: String - - """ - The list of gift card tags. - """ - tags: [String!] - - """ - The list of old gift card tags. - """ - oldTags: [String!] - - """ - The gift card balance. - """ - balance: GiftCardEventBalance - - """ - The gift card expiry date. - """ - expiryDate: Date - - """ - Previous gift card expiry date. - """ - oldExpiryDate: Date -} - -""" -An enumeration. -""" -enum GiftCardEventsEnum { - ISSUED - BOUGHT - UPDATED - ACTIVATED - DEACTIVATED - BALANCE_RESET - EXPIRY_DATE_UPDATED - TAGS_UPDATED - SENT_TO_CUSTOMER - RESENT - NOTE_ADDED - USED_IN_ORDER -} - -type GiftCardEventBalance { - """ - Initial balance of the gift card. - """ - initialBalance: Money - - """ - Current balance of the gift card. - """ - currentBalance: Money! - - """ - Previous initial balance of the gift card. - """ - oldInitialBalance: Money - - """ - Previous current balance of the gift card. - """ - oldCurrentBalance: Money -} - -input GiftCardEventFilterInput { - type: GiftCardEventsEnum - orders: [ID!] -} - -""" -The gift card tag. - -Added in Saleor 3.1. - -Note: this API is currently in Feature Preview and can be subject to changes at later point. -""" -type GiftCardTag implements Node { - id: ID! - name: String! -} - -""" -Represents an item in the checkout. -""" -type CheckoutLine implements Node { - id: ID! - variant: ProductVariant! - quantity: Int! - - """ - The unit price of the checkout line, with taxes and discounts. - """ - unitPrice: TaxedMoney! - - """ - The unit price of the checkout line, without discounts. - """ - undiscountedUnitPrice: Money! - - """ - The sum of the checkout line price, taxes and discounts. - """ - totalPrice: TaxedMoney! - - """ - The sum of the checkout line price, without discounts. - """ - undiscountedTotalPrice: Money! - - """ - Indicates whether the item need to be delivered. - """ - requiresShipping: Boolean! -} - -""" -Represents a delivery method chosen for the checkout. `Warehouse` type is used when checkout is marked as "click and collect" and `ShippingMethod` otherwise. - -Added in Saleor 3.1. - -Note: this API is currently in Feature Preview and can be subject to changes at later point. -""" -union DeliveryMethod = Warehouse | ShippingMethod - -""" -Represents a payment transaction. - -Added in Saleor 3.4. - -Note: this API is currently in Feature Preview and can be subject to changes at later point. -""" -type TransactionItem implements Node & ObjectWithMetadata { - """ - The ID of the object. - """ - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - createdAt: DateTime! - modifiedAt: DateTime! - - """ - List of actions that can be performed in the current state of a payment. - """ - actions: [TransactionActionEnum!]! - - """ - Total amount authorized for this payment. - """ - authorizedAmount: Money! - - """ - Total amount refunded for this payment. - """ - refundedAmount: Money! - - """ - Total amount voided for this payment. - """ - voidedAmount: Money! - - """ - Total amount charged for this payment. - """ - chargedAmount: Money! - - """ - Status of transaction. - """ - status: String! - - """ - Type of transaction. - """ - type: String! - - """ - Reference of transaction. - """ - reference: String! - - """ - List of all transaction's events. - """ - events: [TransactionEvent!]! -} - -""" -Represents possible actions on payment transaction. - - The following actions are possible: - CHARGE - Represents the charge action. - REFUND - Represents a refund action. - VOID - Represents a void action. -""" -enum TransactionActionEnum { - CHARGE - REFUND - VOID -} - -""" -Represents transaction's event. -""" -type TransactionEvent implements Node { - """ - The ID of the object. - """ - id: ID! - createdAt: DateTime! - - """ - Status of transaction's event. - """ - status: TransactionStatus! - - """ - Reference of transaction's event. - """ - reference: String! - - """ - Name of the transaction's event. - """ - name: String -} - -""" -An enumeration. -""" -enum TransactionStatus { - PENDING - SUCCESS - FAILURE -} - -type GiftCardCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [GiftCardCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type GiftCardCountableEdge { - """ - The item at the end of the edge. - """ - node: GiftCard! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -type OrderCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [OrderCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type OrderCountableEdge { - """ - The item at the end of the edge. - """ - node: Order! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -""" -Represents an order in the shop. -""" -type Order implements Node & ObjectWithMetadata { - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - created: DateTime! - updatedAt: DateTime! - status: OrderStatus! - - """ - User who placed the order. This field is set only for orders placed by authenticated users. Can be fetched for orders created in Saleor 3.2 and later, for other orders requires one of the following permissions: MANAGE_USERS, MANAGE_ORDERS, OWNER. - """ - user: User - trackingClientId: String! - - """ - Billing address. The full data can be access for orders created in Saleor 3.2 and later, for other orders requires one of the following permissions: MANAGE_ORDERS, OWNER. - """ - billingAddress: Address - - """ - Shipping address. The full data can be access for orders created in Saleor 3.2 and later, for other orders requires one of the following permissions: MANAGE_ORDERS, OWNER. - """ - shippingAddress: Address - shippingMethodName: String - collectionPointName: String - channel: Channel! - - """ - List of shipments for the order. - """ - fulfillments: [Fulfillment!]! - - """ - List of order lines. - """ - lines: [OrderLine!]! - - """ - List of actions that can be performed in the current state of an order. - """ - actions: [OrderAction!]! - - """ - Shipping methods that can be used with this order. - """ - availableShippingMethods: [ShippingMethod!] - @deprecated( - reason: "Use `shippingMethods`, this field will be removed in 4.0" - ) - - """ - Shipping methods related to this order. - """ - shippingMethods: [ShippingMethod!]! - - """ - Collection points that can be used for this order. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - availableCollectionPoints: [Warehouse!]! - - """ - List of order invoices. Can be fetched for orders created in Saleor 3.2 and later, for other orders requires one of the following permissions: MANAGE_ORDERS, OWNER. - """ - invoices: [Invoice!]! - - """ - User-friendly number of an order. - """ - number: String! - - """ - The ID of the order that was the base for this order. - """ - original: ID - - """ - The order origin. - """ - origin: OrderOriginEnum! - - """ - Informs if an order is fully paid. - """ - isPaid: Boolean! - - """ - Internal payment status. - """ - paymentStatus: PaymentChargeStatusEnum! - - """ - User-friendly payment status. - """ - paymentStatusDisplay: String! - - """ - The authorize status of the order. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - authorizeStatus: OrderAuthorizeStatusEnum! - - """ - The charge status of the order. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - chargeStatus: OrderChargeStatusEnum! - - """ - List of transactions for the order. Requires one of the following permissions: MANAGE_ORDERS, HANDLE_PAYMENTS. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - transactions: [TransactionItem!]! - - """ - List of payments for the order. - """ - payments: [Payment!]! - - """ - Total amount of the order. - """ - total: TaxedMoney! - - """ - Undiscounted total amount of the order. - """ - undiscountedTotal: TaxedMoney! - - """ - Shipping method for this order. - """ - shippingMethod: ShippingMethod - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `deliveryMethod` instead." - ) - - """ - Total price of shipping. - """ - shippingPrice: TaxedMoney! - shippingTaxRate: Float! - token: String! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `id` instead." - ) - voucher: Voucher - - """ - List of user gift cards. - """ - giftCards: [GiftCard!]! - displayGrossPrices: Boolean! - customerNote: String! - weight: Weight! - redirectUrl: String - - """ - The sum of line prices not including shipping. - """ - subtotal: TaxedMoney! - - """ - User-friendly order status. - """ - statusDisplay: String! - - """ - Informs whether a draft order can be finalized(turned into a regular order). - """ - canFinalize: Boolean! - - """ - Amount authorized for the order. - """ - totalAuthorized: Money! - - """ - Amount captured by payment. - """ - totalCaptured: Money! - - """ - List of events associated with the order. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - events: [OrderEvent!]! - - """ - The difference between the paid and the order total amount. - """ - totalBalance: Money! - - """ - Email address of the customer. The full data can be access for orders created in Saleor 3.2 and later, for other orders requires one of the following permissions: MANAGE_ORDERS, OWNER. - """ - userEmail: String - - """ - Returns True, if order requires shipping. - """ - isShippingRequired: Boolean! - - """ - The delivery method selected for this checkout. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - deliveryMethod: DeliveryMethod - languageCode: String! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `languageCodeEnum` field to fetch the language code. " - ) - - """ - Order language code. - """ - languageCodeEnum: LanguageCodeEnum! - - """ - Returns applied discount. - """ - discount: Money - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `discounts` field instead." - ) - - """ - Discount name. - """ - discountName: String - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `discounts` field instead." - ) - - """ - Translated discount name. - """ - translatedDiscountName: String - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use the `discounts` field instead. " - ) - - """ - List of all discounts assigned to the order. - """ - discounts: [OrderDiscount!]! - - """ - List of errors that occurred during order validation. - """ - errors: [OrderError!]! -} - -""" -An enumeration. -""" -enum OrderStatus { - DRAFT - UNCONFIRMED - UNFULFILLED - PARTIALLY_FULFILLED - PARTIALLY_RETURNED - RETURNED - FULFILLED - CANCELED -} - -""" -Represents order fulfillment. -""" -type Fulfillment implements Node & ObjectWithMetadata { - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - fulfillmentOrder: Int! - status: FulfillmentStatus! - trackingNumber: String! - created: DateTime! - - """ - List of lines for the fulfillment. - """ - lines: [FulfillmentLine!] - - """ - User-friendly fulfillment status. - """ - statusDisplay: String - - """ - Warehouse from fulfillment was fulfilled. - """ - warehouse: Warehouse -} - -""" -An enumeration. -""" -enum FulfillmentStatus { - FULFILLED - REFUNDED - RETURNED - REPLACED - REFUNDED_AND_RETURNED - CANCELED - WAITING_FOR_APPROVAL -} - -""" -Represents line of the fulfillment. -""" -type FulfillmentLine implements Node { - id: ID! - quantity: Int! - orderLine: OrderLine -} - -""" -Represents order line of particular order. -""" -type OrderLine implements Node { - id: ID! - productName: String! - variantName: String! - productSku: String - productVariantId: String - isShippingRequired: Boolean! - quantity: Int! - quantityFulfilled: Int! - unitDiscountReason: String - taxRate: Float! - digitalContentUrl: DigitalContentUrl - - """ - The main thumbnail for the ordered product. - """ - thumbnail( - """ - Size of thumbnail. - """ - size: Int - ): Image - - """ - Price of the single item in the order line. - """ - unitPrice: TaxedMoney! - - """ - Price of the single item in the order line without applied an order line discount. - """ - undiscountedUnitPrice: TaxedMoney! - - """ - The discount applied to the single order line. - """ - unitDiscount: Money! - - """ - Value of the discount. Can store fixed value or percent value - """ - unitDiscountValue: PositiveDecimal! - - """ - Price of the order line. - """ - totalPrice: TaxedMoney! - - """ - A purchased product variant. Note: this field may be null if the variant has been removed from stock at all. Requires one of the following permissions to include the unpublished items: MANAGE_ORDERS, MANAGE_DISCOUNTS, MANAGE_PRODUCTS. - """ - variant: ProductVariant - - """ - Product name in the customer's language - """ - translatedProductName: String! - - """ - Variant name in the customer's language - """ - translatedVariantName: String! - - """ - List of allocations across warehouses. - - Requires one of the following permissions: MANAGE_PRODUCTS, MANAGE_ORDERS. - """ - allocations: [Allocation!] - - """ - A quantity of items remaining to be fulfilled. - - Added in Saleor 3.1. - """ - quantityToFulfill: Int! - - """ - Type of the discount: fixed or percent - """ - unitDiscountType: DiscountValueTypeEnum -} - -""" -Positive Decimal scalar implementation. - -Should be used in places where value must be positive. -""" -scalar PositiveDecimal - -""" -Represents allocation. -""" -type Allocation implements Node { - id: ID! - - """ - Quantity allocated for orders. - - Requires one of the following permissions: MANAGE_PRODUCTS, MANAGE_ORDERS. - """ - quantity: Int! - - """ - The warehouse were items were allocated. - - Requires one of the following permissions: MANAGE_PRODUCTS, MANAGE_ORDERS. - """ - warehouse: Warehouse! -} - -enum OrderAction { - """ - Represents the capture action. - """ - CAPTURE - - """ - Represents a mark-as-paid action. - """ - MARK_AS_PAID - - """ - Represents a refund action. - """ - REFUND - - """ - Represents a void action. - """ - VOID -} - -""" -Represents an Invoice. -""" -type Invoice implements ObjectWithMetadata & Job & Node { - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - - """ - Job status. - """ - status: JobStatusEnum! - createdAt: DateTime! - updatedAt: DateTime! - message: String - - """ - The ID of the object. - """ - id: ID! - number: String - externalUrl: String - - """ - URL to download an invoice. - """ - url: String -} - -interface Job { - """ - Job status. - """ - status: JobStatusEnum! - - """ - Created date time of job in ISO 8601 format. - """ - createdAt: DateTime! - - """ - Date time of job last update in ISO 8601 format. - """ - updatedAt: DateTime! - - """ - Job message. - """ - message: String -} - -""" -An enumeration. -""" -enum JobStatusEnum { - PENDING - SUCCESS - FAILED - DELETED -} - -""" -An enumeration. -""" -enum OrderOriginEnum { - CHECKOUT - DRAFT - REISSUE -} - -""" -An enumeration. -""" -enum PaymentChargeStatusEnum { - NOT_CHARGED - PENDING - PARTIALLY_CHARGED - FULLY_CHARGED - PARTIALLY_REFUNDED - FULLY_REFUNDED - REFUSED - CANCELLED -} - -""" -Determine a current authorize status for order. - - We treat the order as fully authorized when the sum of authorized and charged funds - cover the order.total. - We treat the order as partially authorized when the sum of authorized and charged - funds covers only part of the order.total - We treat the order as not authorized when the sum of authorized and charged funds is - 0. - - NONE - the funds are not authorized - PARTIAL - the funds that are authorized or charged don't cover fully the order's - total - FULL - the funds that are authorized or charged fully cover the order's total -""" -enum OrderAuthorizeStatusEnum { - NONE - PARTIAL - FULL -} - -""" -Determine the current charge status for the order. - - We treat the order as overcharged when the charged amount is bigger that order.total - We treat the order as fully charged when the charged amount is equal to order.total. - We treat the order as partially charged when the charged amount covers only part of - the order.total - - NONE - the funds are not charged. - PARTIAL - the funds that are charged don't cover the order's total - FULL - the funds that are charged fully cover the order's total - OVERCHARGED - the charged funds are bigger than order's total -""" -enum OrderChargeStatusEnum { - NONE - PARTIAL - FULL - OVERCHARGED -} - -""" -Represents a payment of a given type. -""" -type Payment implements Node & ObjectWithMetadata { - id: ID! - - """ - List of private metadata items. Requires staff permissions to access. - """ - privateMetadata: [MetadataItem!]! - - """ - A single key from private metadata. Requires staff permissions to access. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafield(key: String!): String - - """ - Private metadata. Requires staff permissions to access. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - privateMetafields(keys: [String!]): Metadata - - """ - List of public metadata items. Can be accessed without permissions. - """ - metadata: [MetadataItem!]! - - """ - A single key from public metadata. - - Tip: Use GraphQL aliases to fetch multiple keys. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafield(key: String!): String - - """ - Public metadata. Use `keys` to control which fields you want to include. The default is to include everything. - - Added in Saleor 3.3. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - metafields(keys: [String!]): Metadata - gateway: String! - isActive: Boolean! - created: DateTime! - modified: DateTime! - token: String! - checkout: Checkout - order: Order - paymentMethodType: String! - - """ - IP address of the user who created the payment. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - customerIpAddress: String - - """ - Internal payment status. - """ - chargeStatus: PaymentChargeStatusEnum! - - """ - List of actions that can be performed in the current state of a payment. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - actions: [OrderAction!]! - - """ - Total amount of the payment. - """ - total: Money - - """ - Total amount captured for this payment. - """ - capturedAmount: Money - - """ - List of all transactions within this payment. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - transactions: [Transaction!] - - """ - Maximum amount of money that can be captured. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - availableCaptureAmount: Money - - """ - Maximum amount of money that can be refunded. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - availableRefundAmount: Money - - """ - The details of the card used for this payment. - """ - creditCard: CreditCard -} - -""" -An object representing a single payment. -""" -type Transaction implements Node { - id: ID! - created: DateTime! - payment: Payment! - token: String! - kind: TransactionKind! - isSuccess: Boolean! - error: String - gatewayResponse: JSONString! - - """ - Total amount of the transaction. - """ - amount: Money -} - -""" -An enumeration. -""" -enum TransactionKind { - EXTERNAL - AUTH - PENDING - ACTION_TO_CONFIRM - REFUND - REFUND_ONGOING - CAPTURE - VOID - CONFIRM - CANCEL -} - -type CreditCard { - """ - Card brand. - """ - brand: String! - - """ - First 4 digits of the card number. - """ - firstDigits: String - - """ - Last 4 digits of the card number. - """ - lastDigits: String! - - """ - Two-digit number representing the card’s expiration month. - """ - expMonth: Int - - """ - Four-digit number representing the card’s expiration year. - """ - expYear: Int -} - -""" -History log of the order. -""" -type OrderEvent implements Node { - id: ID! - - """ - Date when event happened at in ISO 8601 format. - """ - date: DateTime - - """ - Order event type. - """ - type: OrderEventsEnum - - """ - User who performed the action. - """ - user: User - - """ - App that performed the action. Requires of of the following permissions: MANAGE_APPS, MANAGE_ORDERS, OWNER. - """ - app: App - - """ - Content of the event. - """ - message: String - - """ - Email of the customer. - """ - email: String - - """ - Type of an email sent to the customer. - """ - emailType: OrderEventsEmailsEnum - - """ - Amount of money. - """ - amount: Float - - """ - The payment reference from the payment provider. - """ - paymentId: String - - """ - The payment gateway of the payment. - """ - paymentGateway: String - - """ - Number of items. - """ - quantity: Int - - """ - Composed ID of the Fulfillment. - """ - composedId: String - - """ - User-friendly number of an order. - """ - orderNumber: String - - """ - Number of an invoice related to the order. - """ - invoiceNumber: String - - """ - List of oversold lines names. - """ - oversoldItems: [String!] - - """ - The concerned lines. - """ - lines: [OrderEventOrderLineObject!] - - """ - The lines fulfilled. - """ - fulfilledItems: [FulfillmentLine!] - - """ - The warehouse were items were restocked. - """ - warehouse: Warehouse - - """ - The transaction reference of captured payment. - """ - transactionReference: String - - """ - Define if shipping costs were included to the refund. - """ - shippingCostsIncluded: Boolean - - """ - The order which is related to this order. - """ - relatedOrder: Order - - """ - The discount applied to the order. - """ - discount: OrderEventDiscountObject - - """ - The status of payment's transaction. - """ - status: TransactionStatus - - """ - The reference of payment's transaction. - """ - reference: String -} - -""" -An enumeration. -""" -enum OrderEventsEnum { - DRAFT_CREATED - DRAFT_CREATED_FROM_REPLACE - ADDED_PRODUCTS - REMOVED_PRODUCTS - PLACED - PLACED_FROM_DRAFT - OVERSOLD_ITEMS - CANCELED - ORDER_MARKED_AS_PAID - ORDER_FULLY_PAID - ORDER_REPLACEMENT_CREATED - ORDER_DISCOUNT_ADDED - ORDER_DISCOUNT_AUTOMATICALLY_UPDATED - ORDER_DISCOUNT_UPDATED - ORDER_DISCOUNT_DELETED - ORDER_LINE_DISCOUNT_UPDATED - ORDER_LINE_DISCOUNT_REMOVED - ORDER_LINE_PRODUCT_DELETED - ORDER_LINE_VARIANT_DELETED - UPDATED_ADDRESS - EMAIL_SENT - CONFIRMED - PAYMENT_AUTHORIZED - PAYMENT_CAPTURED - EXTERNAL_SERVICE_NOTIFICATION - PAYMENT_REFUNDED - PAYMENT_VOIDED - PAYMENT_FAILED - TRANSACTION_EVENT - TRANSACTION_CAPTURE_REQUESTED - TRANSACTION_REFUND_REQUESTED - TRANSACTION_VOID_REQUESTED - INVOICE_REQUESTED - INVOICE_GENERATED - INVOICE_UPDATED - INVOICE_SENT - FULFILLMENT_CANCELED - FULFILLMENT_RESTOCKED_ITEMS - FULFILLMENT_FULFILLED_ITEMS - FULFILLMENT_REFUNDED - FULFILLMENT_RETURNED - FULFILLMENT_REPLACED - FULFILLMENT_AWAITS_APPROVAL - TRACKING_UPDATED - NOTE_ADDED - OTHER -} - -""" -An enumeration. -""" -enum OrderEventsEmailsEnum { - PAYMENT_CONFIRMATION - CONFIRMED - SHIPPING_CONFIRMATION - TRACKING_UPDATED - ORDER_CONFIRMATION - ORDER_CANCEL - ORDER_REFUND - FULFILLMENT_CONFIRMATION - DIGITAL_LINKS -} - -type OrderEventOrderLineObject { - """ - The variant quantity. - """ - quantity: Int - - """ - The order line. - """ - orderLine: OrderLine - - """ - The variant name. - """ - itemName: String - - """ - The discount applied to the order line. - """ - discount: OrderEventDiscountObject -} - -type OrderEventDiscountObject { - """ - Type of the discount: fixed or percent. - """ - valueType: DiscountValueTypeEnum! - - """ - Value of the discount. Can store fixed value or percent value. - """ - value: PositiveDecimal! - - """ - Explanation for the applied discount. - """ - reason: String - - """ - Returns amount of discount. - """ - amount: Money - - """ - Type of the discount: fixed or percent. - """ - oldValueType: DiscountValueTypeEnum - - """ - Value of the discount. Can store fixed value or percent value. - """ - oldValue: PositiveDecimal - - """ - Returns amount of discount. - """ - oldAmount: Money -} - -""" -Contains all details related to the applied discount to the order. -""" -type OrderDiscount implements Node { - id: ID! - type: OrderDiscountType! - name: String - translatedName: String - - """ - Type of the discount: fixed or percent - """ - valueType: DiscountValueTypeEnum! - - """ - Value of the discount. Can store fixed value or percent value - """ - value: PositiveDecimal! - - """ - Explanation for the applied discount. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - reason: String - - """ - Returns amount of discount. - """ - amount: Money! -} - -""" -An enumeration. -""" -enum OrderDiscountType { - VOUCHER - MANUAL -} - -type OrderError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: OrderErrorCode! - - """ - Warehouse ID which causes the error. - """ - warehouse: ID - - """ - List of order line IDs that cause the error. - """ - orderLines: [ID!] - - """ - List of product variants that are associated with the error - """ - variants: [ID!] - - """ - A type of address that causes the error. - """ - addressType: AddressTypeEnum -} - -""" -An enumeration. -""" -enum OrderErrorCode { - BILLING_ADDRESS_NOT_SET - CANNOT_CANCEL_FULFILLMENT - CANNOT_CANCEL_ORDER - CANNOT_DELETE - CANNOT_DISCOUNT - CANNOT_REFUND - CANNOT_FULFILL_UNPAID_ORDER - CAPTURE_INACTIVE_PAYMENT - GIFT_CARD_LINE - NOT_EDITABLE - FULFILL_ORDER_LINE - GRAPHQL_ERROR - INVALID - PRODUCT_NOT_PUBLISHED - PRODUCT_UNAVAILABLE_FOR_PURCHASE - NOT_FOUND - ORDER_NO_SHIPPING_ADDRESS - PAYMENT_ERROR - PAYMENT_MISSING - REQUIRED - SHIPPING_METHOD_NOT_APPLICABLE - SHIPPING_METHOD_REQUIRED - TAX_ERROR - UNIQUE - VOID_INACTIVE_PAYMENT - ZERO_QUANTITY - INVALID_QUANTITY - INSUFFICIENT_STOCK - DUPLICATED_INPUT_ITEM - NOT_AVAILABLE_IN_CHANNEL - CHANNEL_INACTIVE - MISSING_TRANSACTION_ACTION_REQUEST_WEBHOOK -} - -""" -An enumeration. -""" -enum AddressTypeEnum { - BILLING - SHIPPING -} - -type UserPermission { - """ - Internal code for permission. - """ - code: PermissionEnum! - - """ - Describe action(s) allowed to do by permission. - """ - name: String! - - """ - List of user permission groups which contains this permission. - """ - sourcePermissionGroups( - """ - ID of user whose groups should be returned. - """ - userId: ID! - ): [Group!] -} - -""" -Represents permission group data. -""" -type Group implements Node { - id: ID! - name: String! - - """ - List of group users - - Requires one of the following permissions: MANAGE_STAFF. - """ - users: [User!] - - """ - List of group permissions - """ - permissions: [Permission!] - - """ - True, if the currently authenticated user has rights to manage a group. - """ - userCanManage: Boolean! -} - -""" -History log of the customer. -""" -type CustomerEvent implements Node { - id: ID! - - """ - Date when event happened at in ISO 8601 format. - """ - date: DateTime - - """ - Customer event type. - """ - type: CustomerEventsEnum - - """ - User who performed the action. - """ - user: User - - """ - App that performed the action. - """ - app: App - - """ - Content of the event. - """ - message: String - - """ - Number of objects concerned by the event. - """ - count: Int - - """ - The concerned order. - """ - order: Order - - """ - The concerned order line. - """ - orderLine: OrderLine -} - -""" -An enumeration. -""" -enum CustomerEventsEnum { - ACCOUNT_CREATED - PASSWORD_RESET_LINK_SENT - PASSWORD_RESET - EMAIL_CHANGED_REQUEST - PASSWORD_CHANGED - EMAIL_CHANGED - PLACED_ORDER - NOTE_ADDED_TO_ORDER - DIGITAL_LINK_DOWNLOADED - CUSTOMER_DELETED - NAME_ASSIGNED - EMAIL_ASSIGNED - NOTE_ADDED -} - -""" -Represents a payment source stored for user in payment gateway, such as credit card. -""" -type PaymentSource { - """ - Payment gateway name. - """ - gateway: String! - - """ - ID of stored payment method. - """ - paymentMethodId: String - - """ - Stored credit card details if available. - """ - creditCardInfo: CreditCard - - """ - List of public metadata items. - - Added in Saleor 3.1. - - Can be accessed without permissions. - """ - metadata: [MetadataItem!]! -} - -type LimitInfo { - """ - Defines the current resource usage. - """ - currentUsage: Limits! - - """ - Defines the allowed maximum resource usage, null means unlimited. - """ - allowedUsage: Limits! -} - -type Limits { - channels: Int - orders: Int - productVariants: Int - staffUsers: Int - warehouses: Int -} - -""" -Order related settings from site settings. -""" -type OrderSettings { - automaticallyConfirmAllNewOrders: Boolean! - automaticallyFulfillNonShippableGiftCard: Boolean! -} - -""" -Gift card related settings from site settings. -""" -type GiftCardSettings { - """ - The gift card expiry type settings. - """ - expiryType: GiftCardSettingsExpiryTypeEnum! - - """ - The gift card expiry period settings. - """ - expiryPeriod: TimePeriod -} - -""" -An enumeration. -""" -enum GiftCardSettingsExpiryTypeEnum { - NEVER_EXPIRE - EXPIRY_PERIOD -} - -type TimePeriod { - """ - The length of the period. - """ - amount: Int! - - """ - The type of the period. - """ - type: TimePeriodTypeEnum! -} - -""" -An enumeration. -""" -enum TimePeriodTypeEnum { - DAY - WEEK - MONTH - YEAR -} - -input ShippingZoneFilterInput { - search: String - channels: [ID!] -} - -type DigitalContentCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [DigitalContentCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type DigitalContentCountableEdge { - """ - The item at the end of the edge. - """ - node: DigitalContent! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -input CategoryFilterInput { - search: String - metadata: [MetadataFilter!] - ids: [ID!] -} - -input CategorySortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Specifies the channel in which to sort the data. - - DEPRECATED: this field will be removed in Saleor 4.0. Use root-level channel argument instead. - """ - channel: String - - """ - Sort categories by the selected field. - """ - field: CategorySortField! -} - -enum CategorySortField { - """ - Sort categories by name. - """ - NAME - - """ - Sort categories by product count. - """ - PRODUCT_COUNT - - """ - Sort categories by subcategory count. - """ - SUBCATEGORY_COUNT -} - -input CollectionFilterInput { - published: CollectionPublished - search: String - metadata: [MetadataFilter!] - ids: [ID!] - - """ - Specifies the channel by which the data should be filtered. - - DEPRECATED: this field will be removed in Saleor 4.0. Use root-level channel argument instead. - """ - channel: String -} - -enum CollectionPublished { - PUBLISHED - HIDDEN -} - -input CollectionSortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Specifies the channel in which to sort the data. - - DEPRECATED: this field will be removed in Saleor 4.0. Use root-level channel argument instead. - """ - channel: String - - """ - Sort collections by the selected field. - """ - field: CollectionSortField! -} - -enum CollectionSortField { - """ - Sort collections by name. - """ - NAME - - """ - Sort collections by availability. - - This option requires a channel filter to work as the values can vary between channels. - """ - AVAILABILITY - - """ - Sort collections by product count. - """ - PRODUCT_COUNT - - """ - Sort collections by publication date. - - This option requires a channel filter to work as the values can vary between channels. - """ - PUBLICATION_DATE - - """ - Sort collections by publication date. - - This option requires a channel filter to work as the values can vary between channels. - """ - PUBLISHED_AT -} - -input ProductTypeFilterInput { - search: String - configurable: ProductTypeConfigurable - productType: ProductTypeEnum - metadata: [MetadataFilter!] - kind: ProductTypeKindEnum - ids: [ID!] -} - -enum ProductTypeConfigurable { - CONFIGURABLE - SIMPLE -} - -enum ProductTypeEnum { - DIGITAL - SHIPPABLE -} - -input ProductTypeSortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Sort product types by the selected field. - """ - field: ProductTypeSortField! -} - -enum ProductTypeSortField { - """ - Sort products by name. - """ - NAME - - """ - Sort products by type. - """ - DIGITAL - - """ - Sort products by shipping. - """ - SHIPPING_REQUIRED -} - -input ProductVariantFilterInput { - search: String - sku: [String!] - metadata: [MetadataFilter!] - isPreorder: Boolean - updatedAt: DateTimeRangeInput -} - -input ProductVariantSortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Sort productVariants by the selected field. - """ - field: ProductVariantSortField! -} - -enum ProductVariantSortField { - """ - Sort products variants by last modified at. - """ - LAST_MODIFIED_AT -} - -type PaymentCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [PaymentCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type PaymentCountableEdge { - """ - The item at the end of the edge. - """ - node: Payment! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -input PaymentFilterInput { - checkouts: [ID!] -} - -type PageCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [PageCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type PageCountableEdge { - """ - The item at the end of the edge. - """ - node: Page! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -input PageSortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Sort pages by the selected field. - """ - field: PageSortField! -} - -enum PageSortField { - """ - Sort pages by title. - """ - TITLE - - """ - Sort pages by slug. - """ - SLUG - - """ - Sort pages by visibility. - """ - VISIBILITY - - """ - Sort pages by creation date. - """ - CREATION_DATE - - """ - Sort pages by publication date. - - DEPRECATED: this field will be removed in Saleor 4.0. - """ - PUBLICATION_DATE - - """ - Sort pages by publication date. - - DEPRECATED: this field will be removed in Saleor 4.0. - """ - PUBLISHED_AT -} - -input PageFilterInput { - search: String - metadata: [MetadataFilter!] - pageTypes: [ID!] - ids: [ID!] -} - -type PageTypeCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [PageTypeCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type PageTypeCountableEdge { - """ - The item at the end of the edge. - """ - node: PageType! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -input PageTypeSortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Sort page types by the selected field. - """ - field: PageTypeSortField! -} - -enum PageTypeSortField { - """ - Sort page types by name. - """ - NAME - - """ - Sort page types by slug. - """ - SLUG -} - -input PageTypeFilterInput { - search: String -} - -type OrderEventCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [OrderEventCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type OrderEventCountableEdge { - """ - The item at the end of the edge. - """ - node: OrderEvent! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -input OrderSortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Sort orders by the selected field. - """ - field: OrderSortField! -} - -enum OrderSortField { - """ - Sort orders by number. - """ - NUMBER - - """ - Sort orders by creation date. - - DEPRECATED: this field will be removed in Saleor 4.0. - """ - CREATION_DATE - - """ - Sort orders by creation date. - - DEPRECATED: this field will be removed in Saleor 4.0. - """ - CREATED_AT - - """ - Sort orders by last modified at. - """ - LAST_MODIFIED_AT - - """ - Sort orders by customer. - """ - CUSTOMER - - """ - Sort orders by payment. - """ - PAYMENT - - """ - Sort orders by fulfillment status. - """ - FULFILLMENT_STATUS -} - -input OrderFilterInput { - paymentStatus: [PaymentChargeStatusEnum!] - status: [OrderStatusFilter!] - customer: String - created: DateRangeInput - search: String - metadata: [MetadataFilter!] - channels: [ID!] - authorizeStatus: [OrderAuthorizeStatusEnum!] - chargeStatus: [OrderChargeStatusEnum!] - updatedAt: DateTimeRangeInput - isClickAndCollect: Boolean - isPreorder: Boolean - ids: [ID!] - giftCardUsed: Boolean - giftCardBought: Boolean - numbers: [String!] -} - -enum OrderStatusFilter { - READY_TO_FULFILL - READY_TO_CAPTURE - UNFULFILLED - UNCONFIRMED - PARTIALLY_FULFILLED - FULFILLED - CANCELED -} - -input OrderDraftFilterInput { - customer: String - created: DateRangeInput - search: String - metadata: [MetadataFilter!] - channels: [ID!] -} - -type MenuCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [MenuCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type MenuCountableEdge { - """ - The item at the end of the edge. - """ - node: Menu! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -input MenuSortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Sort menus by the selected field. - """ - field: MenuSortField! -} - -enum MenuSortField { - """ - Sort menus by name. - """ - NAME - - """ - Sort menus by items count. - """ - ITEMS_COUNT -} - -input MenuFilterInput { - search: String - slug: [String!] - metadata: [MetadataFilter!] -} - -type MenuItemCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [MenuItemCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type MenuItemCountableEdge { - """ - The item at the end of the edge. - """ - node: MenuItem! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -input MenuItemSortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Sort menu items by the selected field. - """ - field: MenuItemsSortField! -} - -enum MenuItemsSortField { - """ - Sort menu items by name. - """ - NAME -} - -input MenuItemFilterInput { - search: String - metadata: [MetadataFilter!] -} - -input GiftCardSortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Sort gift cards by the selected field. - """ - field: GiftCardSortField! -} - -enum GiftCardSortField { - """ - Sort orders by product. - """ - PRODUCT - - """ - Sort orders by used by. - """ - USED_BY - - """ - Sort orders by current balance. - """ - CURRENT_BALANCE -} - -input GiftCardFilterInput { - isActive: Boolean - metadata: [MetadataFilter!] - tags: [String!] - products: [ID!] - usedBy: [ID!] - used: Boolean - currency: String - currentBalance: PriceRangeInput - initialBalance: PriceRangeInput - code: String -} - -type GiftCardTagCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [GiftCardTagCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type GiftCardTagCountableEdge { - """ - The item at the end of the edge. - """ - node: GiftCardTag! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -input GiftCardTagFilterInput { - search: String -} - -""" -Plugin. -""" -type Plugin { - """ - Identifier of the plugin. - """ - id: ID! - - """ - Name of the plugin. - """ - name: String! - - """ - Description of the plugin. - """ - description: String! - - """ - Global configuration of the plugin (not channel-specific). - """ - globalConfiguration: PluginConfiguration - - """ - Channel-specific plugin configuration. - """ - channelConfigurations: [PluginConfiguration!]! -} - -""" -Stores information about a configuration of plugin. -""" -type PluginConfiguration { - """ - Determines if plugin is active or not. - """ - active: Boolean! - - """ - The channel to which the plugin configuration is assigned to. - """ - channel: Channel - - """ - Configuration of the plugin. - """ - configuration: [ConfigurationItem!] -} - -""" -Stores information about a single configuration field. -""" -type ConfigurationItem { - """ - Name of the field. - """ - name: String! - - """ - Current value of the field. - """ - value: String - - """ - Type of the field. - """ - type: ConfigurationTypeFieldEnum - - """ - Help text for the field. - """ - helpText: String - - """ - Label for the field. - """ - label: String -} - -""" -An enumeration. -""" -enum ConfigurationTypeFieldEnum { - STRING - MULTILINE - BOOLEAN - SECRET - PASSWORD - SECRETMULTILINE - OUTPUT -} - -type PluginCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [PluginCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type PluginCountableEdge { - """ - The item at the end of the edge. - """ - node: Plugin! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -input PluginFilterInput { - statusInChannels: PluginStatusInChannelsInput - search: String - type: PluginConfigurationType -} - -input PluginStatusInChannelsInput { - active: Boolean! - channels: [ID!]! -} - -enum PluginConfigurationType { - PER_CHANNEL - GLOBAL -} - -input PluginSortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Sort plugins by the selected field. - """ - field: PluginSortField! -} - -enum PluginSortField { - NAME - IS_ACTIVE -} - -type SaleCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [SaleCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type SaleCountableEdge { - """ - The item at the end of the edge. - """ - node: Sale! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -input SaleFilterInput { - status: [DiscountStatusEnum!] - saleType: DiscountValueTypeEnum - started: DateTimeRangeInput - search: String - metadata: [MetadataFilter!] - updatedAt: DateTimeRangeInput -} - -enum DiscountStatusEnum { - ACTIVE - EXPIRED - SCHEDULED -} - -input SaleSortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Specifies the channel in which to sort the data. - - DEPRECATED: this field will be removed in Saleor 4.0. Use root-level channel argument instead. - """ - channel: String - - """ - Sort sales by the selected field. - """ - field: SaleSortField! -} - -enum SaleSortField { - """ - Sort sales by name. - """ - NAME - - """ - Sort sales by start date. - """ - START_DATE - - """ - Sort sales by end date. - """ - END_DATE - - """ - Sort sales by value. - - This option requires a channel filter to work as the values can vary between channels. - """ - VALUE - - """ - Sort sales by type. - """ - TYPE - - """ - Sort sales by created at. - """ - CREATED_AT - - """ - Sort sales by last modified at. - """ - LAST_MODIFIED_AT -} - -type VoucherCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [VoucherCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type VoucherCountableEdge { - """ - The item at the end of the edge. - """ - node: Voucher! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -input VoucherFilterInput { - status: [DiscountStatusEnum!] - timesUsed: IntRangeInput - discountType: [VoucherDiscountType!] - started: DateTimeRangeInput - search: String - metadata: [MetadataFilter!] -} - -enum VoucherDiscountType { - FIXED - PERCENTAGE - SHIPPING -} - -input VoucherSortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Specifies the channel in which to sort the data. - - DEPRECATED: this field will be removed in Saleor 4.0. Use root-level channel argument instead. - """ - channel: String - - """ - Sort vouchers by the selected field. - """ - field: VoucherSortField! -} - -enum VoucherSortField { - """ - Sort vouchers by code. - """ - CODE - - """ - Sort vouchers by start date. - """ - START_DATE - - """ - Sort vouchers by end date. - """ - END_DATE - - """ - Sort vouchers by value. - - This option requires a channel filter to work as the values can vary between channels. - """ - VALUE - - """ - Sort vouchers by type. - """ - TYPE - - """ - Sort vouchers by usage limit. - """ - USAGE_LIMIT - - """ - Sort vouchers by minimum spent amount. - - This option requires a channel filter to work as the values can vary between channels. - """ - MINIMUM_SPENT_AMOUNT -} - -""" -Represents a job data of exported file. -""" -type ExportFile implements Node & Job { - id: ID! - - """ - Job status. - """ - status: JobStatusEnum! - - """ - Created date time of job in ISO 8601 format. - """ - createdAt: DateTime! - - """ - Date time of job last update in ISO 8601 format. - """ - updatedAt: DateTime! - - """ - Job message. - """ - message: String - - """ - The URL of field to download. - """ - url: String - - """ - List of events associated with the export. - """ - events: [ExportEvent!] - user: User - app: App -} - -""" -History log of export file. -""" -type ExportEvent implements Node { - """ - The ID of the object. - """ - id: ID! - - """ - Date when event happened at in ISO 8601 format. - """ - date: DateTime! - - """ - Export event type. - """ - type: ExportEventsEnum! - - """ - User who performed the action. Requires one of the following permissions: OWNER, MANAGE_STAFF. - """ - user: User - - """ - App which performed the action. Requires one of the following permissions: OWNER, MANAGE_APPS. - """ - app: App - - """ - Content of the event. - """ - message: String! -} - -""" -An enumeration. -""" -enum ExportEventsEnum { - EXPORT_PENDING - EXPORT_SUCCESS - EXPORT_FAILED - EXPORT_DELETED - EXPORTED_FILE_SENT - EXPORT_FAILED_INFO_SENT -} - -type ExportFileCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [ExportFileCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type ExportFileCountableEdge { - """ - The item at the end of the edge. - """ - node: ExportFile! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -input ExportFileFilterInput { - createdAt: DateTimeRangeInput - updatedAt: DateTimeRangeInput - status: JobStatusEnum - user: String - app: String -} - -input ExportFileSortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Sort export file by the selected field. - """ - field: ExportFileSortField! -} - -enum ExportFileSortField { - STATUS - CREATED_AT - UPDATED_AT - LAST_MODIFIED_AT -} - -type CheckoutCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [CheckoutCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type CheckoutCountableEdge { - """ - The item at the end of the edge. - """ - node: Checkout! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -input CheckoutSortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Sort checkouts by the selected field. - """ - field: CheckoutSortField! -} - -enum CheckoutSortField { - """ - Sort checkouts by creation date. - """ - CREATION_DATE - - """ - Sort checkouts by customer. - """ - CUSTOMER - - """ - Sort checkouts by payment. - """ - PAYMENT -} - -input CheckoutFilterInput { - customer: String - created: DateRangeInput - search: String - metadata: [MetadataFilter!] - channels: [ID!] -} - -type CheckoutLineCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [CheckoutLineCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type CheckoutLineCountableEdge { - """ - The item at the end of the edge. - """ - node: CheckoutLine! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -input AttributeSortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Sort attributes by the selected field. - """ - field: AttributeSortField! -} - -enum AttributeSortField { - """ - Sort attributes by name - """ - NAME - - """ - Sort attributes by slug - """ - SLUG - - """ - Sort attributes by the value required flag - """ - VALUE_REQUIRED - - """ - Sort attributes by the variant only flag - """ - IS_VARIANT_ONLY - - """ - Sort attributes by visibility in the storefront - """ - VISIBLE_IN_STOREFRONT - - """ - Sort attributes by the filterable in storefront flag - """ - FILTERABLE_IN_STOREFRONT - - """ - Sort attributes by the filterable in dashboard flag - """ - FILTERABLE_IN_DASHBOARD - - """ - Sort attributes by their position in storefront - """ - STOREFRONT_SEARCH_POSITION - - """ - Sort attributes based on whether they can be displayed or not in a product grid. - """ - AVAILABLE_IN_GRID -} - -""" -Represents ongoing installation of app. -""" -type AppInstallation implements Node & Job { - id: ID! - - """ - Job status. - """ - status: JobStatusEnum! - - """ - Created date time of job in ISO 8601 format. - """ - createdAt: DateTime! - - """ - Date time of job last update in ISO 8601 format. - """ - updatedAt: DateTime! - - """ - Job message. - """ - message: String - appName: String! - manifestUrl: String! -} - -type AppCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [AppCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type AppCountableEdge { - """ - The item at the end of the edge. - """ - node: App! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -input AppFilterInput { - search: String - isActive: Boolean - type: AppTypeEnum -} - -input AppSortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Sort apps by the selected field. - """ - field: AppSortField! -} - -enum AppSortField { - """ - Sort apps by name. - """ - NAME - - """ - Sort apps by creation date. - """ - CREATION_DATE -} - -type AppExtensionCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [AppExtensionCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type AppExtensionCountableEdge { - """ - The item at the end of the edge. - """ - node: AppExtension! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -input AppExtensionFilterInput { - mount: [AppExtensionMountEnum!] - target: AppExtensionTargetEnum -} - -type AddressValidationData { - countryCode: String! - countryName: String! - addressFormat: String! - addressLatinFormat: String! - allowedFields: [String!]! - requiredFields: [String!]! - upperFields: [String!]! - countryAreaType: String! - countryAreaChoices: [ChoiceValue!]! - cityType: String! - cityChoices: [ChoiceValue!]! - cityAreaType: String! - cityAreaChoices: [ChoiceValue!]! - postalCodeType: String! - postalCodeMatchers: [String!]! - postalCodeExamples: [String!]! - postalCodePrefix: String! -} - -type ChoiceValue { - raw: String - verbose: String -} - -type UserCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [UserCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type UserCountableEdge { - """ - The item at the end of the edge. - """ - node: User! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -input CustomerFilterInput { - dateJoined: DateRangeInput - numberOfOrders: IntRangeInput - placedOrders: DateRangeInput - search: String - metadata: [MetadataFilter!] - updatedAt: DateTimeRangeInput -} - -input UserSortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Sort users by the selected field. - """ - field: UserSortField! -} - -enum UserSortField { - """ - Sort users by first name. - """ - FIRST_NAME - - """ - Sort users by last name. - """ - LAST_NAME - - """ - Sort users by email. - """ - EMAIL - - """ - Sort users by order count. - """ - ORDER_COUNT - - """ - Sort users by created at. - """ - CREATED_AT - - """ - Sort users by last modified at. - """ - LAST_MODIFIED_AT -} - -type GroupCountableConnection { - """ - Pagination data for this connection. - """ - pageInfo: PageInfo! - edges: [GroupCountableEdge!]! - - """ - A total count of items in the collection. - """ - totalCount: Int -} - -type GroupCountableEdge { - """ - The item at the end of the edge. - """ - node: Group! - - """ - A cursor for use in pagination. - """ - cursor: String! -} - -input PermissionGroupFilterInput { - search: String - ids: [ID!] -} - -input PermissionGroupSortingInput { - """ - Specifies the direction in which to sort products. - """ - direction: OrderDirection! - - """ - Sort permission group by the selected field. - """ - field: PermissionGroupSortField! -} - -enum PermissionGroupSortField { - """ - Sort permission group accounts by name. - """ - NAME -} - -input StaffUserInput { - status: StaffMemberStatus - search: String - ids: [ID!] -} - -enum StaffMemberStatus { - """ - User account has been activated. - """ - ACTIVE - - """ - User account has not been activated yet. - """ - DEACTIVATED -} - -type Mutation { - """ - Creates a new webhook subscription. - - Requires one of the following permissions: MANAGE_APPS, AUTHENTICATED_APP. - """ - webhookCreate( - """ - Fields required to create a webhook. - """ - input: WebhookCreateInput! - ): WebhookCreate - - """ - Deletes a webhook subscription. - - Requires one of the following permissions: MANAGE_APPS, AUTHENTICATED_APP. - """ - webhookDelete( - """ - ID of a webhook to delete. - """ - id: ID! - ): WebhookDelete - - """ - Updates a webhook subscription. - - Requires one of the following permissions: MANAGE_APPS. - """ - webhookUpdate( - """ - ID of a webhook to update. - """ - id: ID! - - """ - Fields required to update a webhook. - """ - input: WebhookUpdateInput! - ): WebhookUpdate - - """ - Retries event delivery. - - Requires one of the following permissions: MANAGE_APPS. - """ - eventDeliveryRetry( - """ - ID of the event delivery to retry. - """ - id: ID! - ): EventDeliveryRetry - - """ - Creates new warehouse. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - createWarehouse( - """ - Fields required to create warehouse. - """ - input: WarehouseCreateInput! - ): WarehouseCreate - - """ - Updates given warehouse. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - updateWarehouse( - """ - ID of a warehouse to update. - """ - id: ID! - - """ - Fields required to update warehouse. - """ - input: WarehouseUpdateInput! - ): WarehouseUpdate - - """ - Deletes selected warehouse. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - deleteWarehouse( - """ - ID of a warehouse to delete. - """ - id: ID! - ): WarehouseDelete - - """ - Add shipping zone to given warehouse. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - assignWarehouseShippingZone( - """ - ID of a warehouse to update. - """ - id: ID! - - """ - List of shipping zone IDs. - """ - shippingZoneIds: [ID!]! - ): WarehouseShippingZoneAssign - - """ - Remove shipping zone from given warehouse. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - unassignWarehouseShippingZone( - """ - ID of a warehouse to update. - """ - id: ID! - - """ - List of shipping zone IDs. - """ - shippingZoneIds: [ID!]! - ): WarehouseShippingZoneUnassign - - """ - Creates a new staff notification recipient. - - Requires one of the following permissions: MANAGE_SETTINGS. - """ - staffNotificationRecipientCreate( - """ - Fields required to create a staff notification recipient. - """ - input: StaffNotificationRecipientInput! - ): StaffNotificationRecipientCreate - - """ - Updates a staff notification recipient. - - Requires one of the following permissions: MANAGE_SETTINGS. - """ - staffNotificationRecipientUpdate( - """ - ID of a staff notification recipient to update. - """ - id: ID! - - """ - Fields required to update a staff notification recipient. - """ - input: StaffNotificationRecipientInput! - ): StaffNotificationRecipientUpdate - - """ - Delete staff notification recipient. - - Requires one of the following permissions: MANAGE_SETTINGS. - """ - staffNotificationRecipientDelete( - """ - ID of a staff notification recipient to delete. - """ - id: ID! - ): StaffNotificationRecipientDelete - - """ - Updates site domain of the shop. - - Requires one of the following permissions: MANAGE_SETTINGS. - """ - shopDomainUpdate( - """ - Fields required to update site. - """ - input: SiteDomainInput - ): ShopDomainUpdate - - """ - Updates shop settings. - - Requires one of the following permissions: MANAGE_SETTINGS. - """ - shopSettingsUpdate( - """ - Fields required to update shop settings. - """ - input: ShopSettingsInput! - ): ShopSettingsUpdate - - """ - Fetch tax rates. - - Requires one of the following permissions: MANAGE_SETTINGS. - """ - shopFetchTaxRates: ShopFetchTaxRates - - """ - Creates/updates translations for shop settings. - - Requires one of the following permissions: MANAGE_TRANSLATIONS. - """ - shopSettingsTranslate( - """ - Fields required to update shop settings translations. - """ - input: ShopSettingsTranslationInput! - - """ - Translation language code. - """ - languageCode: LanguageCodeEnum! - ): ShopSettingsTranslate - - """ - Update the shop's address. If the `null` value is passed, the currently selected address will be deleted. - - Requires one of the following permissions: MANAGE_SETTINGS. - """ - shopAddressUpdate( - """ - Fields required to update shop address. - """ - input: AddressInput - ): ShopAddressUpdate - - """ - Update shop order settings. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderSettingsUpdate( - """ - Fields required to update shop order settings. - """ - input: OrderSettingsUpdateInput! - ): OrderSettingsUpdate - - """ - Update gift card settings. - - Requires one of the following permissions: MANAGE_GIFT_CARD. - """ - giftCardSettingsUpdate( - """ - Fields required to update gift card settings. - """ - input: GiftCardSettingsUpdateInput! - ): GiftCardSettingsUpdate - - """ - Manage shipping method's availability in channels. - - Requires one of the following permissions: MANAGE_SHIPPING. - """ - shippingMethodChannelListingUpdate( - """ - ID of a shipping method to update. - """ - id: ID! - - """ - Fields required to update shipping method channel listings. - """ - input: ShippingMethodChannelListingInput! - ): ShippingMethodChannelListingUpdate - - """ - Creates a new shipping price. - - Requires one of the following permissions: MANAGE_SHIPPING. - """ - shippingPriceCreate( - """ - Fields required to create a shipping price. - """ - input: ShippingPriceInput! - ): ShippingPriceCreate - - """ - Deletes a shipping price. - - Requires one of the following permissions: MANAGE_SHIPPING. - """ - shippingPriceDelete( - """ - ID of a shipping price to delete. - """ - id: ID! - ): ShippingPriceDelete - - """ - Deletes shipping prices. - - Requires one of the following permissions: MANAGE_SHIPPING. - """ - shippingPriceBulkDelete( - """ - List of shipping price IDs to delete. - """ - ids: [ID!]! - ): ShippingPriceBulkDelete - - """ - Updates a new shipping price. - - Requires one of the following permissions: MANAGE_SHIPPING. - """ - shippingPriceUpdate( - """ - ID of a shipping price to update. - """ - id: ID! - - """ - Fields required to update a shipping price. - """ - input: ShippingPriceInput! - ): ShippingPriceUpdate - - """ - Creates/updates translations for a shipping method. - - Requires one of the following permissions: MANAGE_TRANSLATIONS. - """ - shippingPriceTranslate( - """ - ShippingMethodType ID or ShippingMethodTranslatableContent ID. - """ - id: ID! - input: ShippingPriceTranslationInput! - - """ - Translation language code. - """ - languageCode: LanguageCodeEnum! - ): ShippingPriceTranslate - - """ - Exclude products from shipping price. - - Requires one of the following permissions: MANAGE_SHIPPING. - """ - shippingPriceExcludeProducts( - """ - ID of a shipping price. - """ - id: ID! - - """ - Exclude products input. - """ - input: ShippingPriceExcludeProductsInput! - ): ShippingPriceExcludeProducts - - """ - Remove product from excluded list for shipping price. - - Requires one of the following permissions: MANAGE_SHIPPING. - """ - shippingPriceRemoveProductFromExclude( - """ - ID of a shipping price. - """ - id: ID! - - """ - List of products which will be removed from excluded list. - """ - products: [ID!]! - ): ShippingPriceRemoveProductFromExclude - - """ - Creates a new shipping zone. - - Requires one of the following permissions: MANAGE_SHIPPING. - """ - shippingZoneCreate( - """ - Fields required to create a shipping zone. - """ - input: ShippingZoneCreateInput! - ): ShippingZoneCreate - - """ - Deletes a shipping zone. - - Requires one of the following permissions: MANAGE_SHIPPING. - """ - shippingZoneDelete( - """ - ID of a shipping zone to delete. - """ - id: ID! - ): ShippingZoneDelete - - """ - Deletes shipping zones. - - Requires one of the following permissions: MANAGE_SHIPPING. - """ - shippingZoneBulkDelete( - """ - List of shipping zone IDs to delete. - """ - ids: [ID!]! - ): ShippingZoneBulkDelete - - """ - Updates a new shipping zone. - - Requires one of the following permissions: MANAGE_SHIPPING. - """ - shippingZoneUpdate( - """ - ID of a shipping zone to update. - """ - id: ID! - - """ - Fields required to update a shipping zone. - """ - input: ShippingZoneUpdateInput! - ): ShippingZoneUpdate - - """ - Assign attributes to a given product type. - - Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. - """ - productAttributeAssign( - """ - The operations to perform. - """ - operations: [ProductAttributeAssignInput!]! - - """ - ID of the product type to assign the attributes into. - """ - productTypeId: ID! - ): ProductAttributeAssign - - """ - Update attributes assigned to product variant for given product type. - - Added in Saleor 3.1. - - Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. - """ - productAttributeAssignmentUpdate( - """ - The operations to perform. - """ - operations: [ProductAttributeAssignmentUpdateInput!]! - - """ - ID of the product type to assign the attributes into. - """ - productTypeId: ID! - ): ProductAttributeAssignmentUpdate - - """ - Un-assign attributes from a given product type. - - Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. - """ - productAttributeUnassign( - """ - The IDs of the attributes to unassign. - """ - attributeIds: [ID!]! - - """ - ID of the product type from which the attributes should be unassigned. - """ - productTypeId: ID! - ): ProductAttributeUnassign - - """ - Creates a new category. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - categoryCreate( - """ - Fields required to create a category. - """ - input: CategoryInput! - - """ - ID of the parent category. If empty, category will be top level category. - """ - parent: ID - ): CategoryCreate - - """ - Deletes a category. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - categoryDelete( - """ - ID of a category to delete. - """ - id: ID! - ): CategoryDelete - - """ - Deletes categories. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - categoryBulkDelete( - """ - List of category IDs to delete. - """ - ids: [ID!]! - ): CategoryBulkDelete - - """ - Updates a category. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - categoryUpdate( - """ - ID of a category to update. - """ - id: ID! - - """ - Fields required to update a category. - """ - input: CategoryInput! - ): CategoryUpdate - - """ - Creates/updates translations for a category. - - Requires one of the following permissions: MANAGE_TRANSLATIONS. - """ - categoryTranslate( - """ - Category ID or CategoryTranslatableContent ID. - """ - id: ID! - input: TranslationInput! - - """ - Translation language code. - """ - languageCode: LanguageCodeEnum! - ): CategoryTranslate - - """ - Adds products to a collection. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - collectionAddProducts( - """ - ID of a collection. - """ - collectionId: ID! - - """ - List of product IDs. - """ - products: [ID!]! - ): CollectionAddProducts - - """ - Creates a new collection. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - collectionCreate( - """ - Fields required to create a collection. - """ - input: CollectionCreateInput! - ): CollectionCreate - - """ - Deletes a collection. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - collectionDelete( - """ - ID of a collection to delete. - """ - id: ID! - ): CollectionDelete - - """ - Reorder the products of a collection. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - collectionReorderProducts( - """ - ID of a collection. - """ - collectionId: ID! - - """ - The collection products position operations. - """ - moves: [MoveProductInput!]! - ): CollectionReorderProducts - - """ - Deletes collections. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - collectionBulkDelete( - """ - List of collection IDs to delete. - """ - ids: [ID!]! - ): CollectionBulkDelete - - """ - Remove products from a collection. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - collectionRemoveProducts( - """ - ID of a collection. - """ - collectionId: ID! - - """ - List of product IDs. - """ - products: [ID!]! - ): CollectionRemoveProducts - - """ - Updates a collection. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - collectionUpdate( - """ - ID of a collection to update. - """ - id: ID! - - """ - Fields required to update a collection. - """ - input: CollectionInput! - ): CollectionUpdate - - """ - Creates/updates translations for a collection. - - Requires one of the following permissions: MANAGE_TRANSLATIONS. - """ - collectionTranslate( - """ - Collection ID or CollectionTranslatableContent ID. - """ - id: ID! - input: TranslationInput! - - """ - Translation language code. - """ - languageCode: LanguageCodeEnum! - ): CollectionTranslate - - """ - Manage collection's availability in channels. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - collectionChannelListingUpdate( - """ - ID of a collection to update. - """ - id: ID! - - """ - Fields required to create or update collection channel listings. - """ - input: CollectionChannelListingUpdateInput! - ): CollectionChannelListingUpdate - - """ - Creates a new product. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productCreate( - """ - Fields required to create a product. - """ - input: ProductCreateInput! - ): ProductCreate - - """ - Deletes a product. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productDelete( - """ - ID of a product to delete. - """ - id: ID! - ): ProductDelete - - """ - Deletes products. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productBulkDelete( - """ - List of product IDs to delete. - """ - ids: [ID!]! - ): ProductBulkDelete - - """ - Updates an existing product. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productUpdate( - """ - ID of a product to update. - """ - id: ID! - - """ - Fields required to update a product. - """ - input: ProductInput! - ): ProductUpdate - - """ - Creates/updates translations for a product. - - Requires one of the following permissions: MANAGE_TRANSLATIONS. - """ - productTranslate( - """ - Product ID or ProductTranslatableContent ID. - """ - id: ID! - input: TranslationInput! - - """ - Translation language code. - """ - languageCode: LanguageCodeEnum! - ): ProductTranslate - - """ - Manage product's availability in channels. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productChannelListingUpdate( - """ - ID of a product to update. - """ - id: ID! - - """ - Fields required to create or update product channel listings. - """ - input: ProductChannelListingUpdateInput! - ): ProductChannelListingUpdate - - """ - Create a media object (image or video URL) associated with product. For image, this mutation must be sent as a `multipart` request. More detailed specs of the upload format can be found here: https://github.com/jaydenseric/graphql-multipart-request-spec - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productMediaCreate( - """ - Fields required to create a product media. - """ - input: ProductMediaCreateInput! - ): ProductMediaCreate - - """ - Reorder the variants of a product. Mutation updates updated_at on product and triggers PRODUCT_UPDATED webhook. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productVariantReorder( - """ - The list of variant reordering operations. - """ - moves: [ReorderInput!]! - - """ - Id of product that variants order will be altered. - """ - productId: ID! - ): ProductVariantReorder - - """ - Deletes a product media. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productMediaDelete( - """ - ID of a product media to delete. - """ - id: ID! - ): ProductMediaDelete - - """ - Deletes product media. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productMediaBulkDelete( - """ - List of product media IDs to delete. - """ - ids: [ID!]! - ): ProductMediaBulkDelete - - """ - Changes ordering of the product media. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productMediaReorder( - """ - IDs of a product media in the desired order. - """ - mediaIds: [ID!]! - - """ - ID of product that media order will be altered. - """ - productId: ID! - ): ProductMediaReorder - - """ - Updates a product media. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productMediaUpdate( - """ - ID of a product media to update. - """ - id: ID! - - """ - Fields required to update a product media. - """ - input: ProductMediaUpdateInput! - ): ProductMediaUpdate - - """ - Creates a new product type. - - Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. - """ - productTypeCreate( - """ - Fields required to create a product type. - """ - input: ProductTypeInput! - ): ProductTypeCreate - - """ - Deletes a product type. - - Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. - """ - productTypeDelete( - """ - ID of a product type to delete. - """ - id: ID! - ): ProductTypeDelete - - """ - Deletes product types. - - Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. - """ - productTypeBulkDelete( - """ - List of product type IDs to delete. - """ - ids: [ID!]! - ): ProductTypeBulkDelete - - """ - Updates an existing product type. - - Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. - """ - productTypeUpdate( - """ - ID of a product type to update. - """ - id: ID! - - """ - Fields required to update a product type. - """ - input: ProductTypeInput! - ): ProductTypeUpdate - - """ - Reorder the attributes of a product type. - - Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. - """ - productTypeReorderAttributes( - """ - The list of attribute reordering operations. - """ - moves: [ReorderInput!]! - - """ - ID of a product type. - """ - productTypeId: ID! - - """ - The attribute type to reorder. - """ - type: ProductAttributeType! - ): ProductTypeReorderAttributes - - """ - Reorder product attribute values. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productReorderAttributeValues( - """ - ID of an attribute. - """ - attributeId: ID! - - """ - The list of reordering operations for given attribute values. - """ - moves: [ReorderInput!]! - - """ - ID of a product. - """ - productId: ID! - ): ProductReorderAttributeValues - - """ - Create new digital content. This mutation must be sent as a `multipart` request. More detailed specs of the upload format can be found here: https://github.com/jaydenseric/graphql-multipart-request-spec - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - digitalContentCreate( - """ - Fields required to create a digital content. - """ - input: DigitalContentUploadInput! - - """ - ID of a product variant to upload digital content. - """ - variantId: ID! - ): DigitalContentCreate - - """ - Remove digital content assigned to given variant. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - digitalContentDelete( - """ - ID of a product variant with digital content to remove. - """ - variantId: ID! - ): DigitalContentDelete - - """ - Update digital content. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - digitalContentUpdate( - """ - Fields required to update a digital content. - """ - input: DigitalContentInput! - - """ - ID of a product variant with digital content to update. - """ - variantId: ID! - ): DigitalContentUpdate - - """ - Generate new URL to digital content. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - digitalContentUrlCreate( - """ - Fields required to create a new url. - """ - input: DigitalContentUrlCreateInput! - ): DigitalContentUrlCreate - - """ - Creates a new variant for a product. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productVariantCreate( - """ - Fields required to create a product variant. - """ - input: ProductVariantCreateInput! - ): ProductVariantCreate - - """ - Deletes a product variant. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productVariantDelete( - """ - ID of a product variant to delete. - """ - id: ID! - ): ProductVariantDelete - - """ - Creates product variants for a given product. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productVariantBulkCreate( - """ - ID of the product to create the variants for. - """ - product: ID! - - """ - Input list of product variants to create. - """ - variants: [ProductVariantBulkCreateInput!]! - ): ProductVariantBulkCreate - - """ - Deletes product variants. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productVariantBulkDelete( - """ - List of product variant IDs to delete. - """ - ids: [ID!]! - ): ProductVariantBulkDelete - - """ - Creates stocks for product variant. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productVariantStocksCreate( - """ - Input list of stocks to create. - """ - stocks: [StockInput!]! - - """ - ID of a product variant for which stocks will be created. - """ - variantId: ID! - ): ProductVariantStocksCreate - - """ - Delete stocks from product variant. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productVariantStocksDelete( - """ - ID of product variant for which stocks will be deleted. - """ - variantId: ID! - warehouseIds: [ID!] - ): ProductVariantStocksDelete - - """ - Update stocks for product variant. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productVariantStocksUpdate( - """ - Input list of stocks to create. - """ - stocks: [StockInput!]! - - """ - ID of a product variant for which stocks will be created. - """ - variantId: ID! - ): ProductVariantStocksUpdate - - """ - Updates an existing variant for product. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productVariantUpdate( - """ - ID of a product variant to update. - """ - id: ID! - - """ - Fields required to update a product variant. - """ - input: ProductVariantInput! - ): ProductVariantUpdate - - """ - Set default variant for a product. Mutation triggers PRODUCT_UPDATED webhook. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productVariantSetDefault( - """ - Id of a product that will have the default variant set. - """ - productId: ID! - - """ - Id of a variant that will be set as default. - """ - variantId: ID! - ): ProductVariantSetDefault - - """ - Creates/updates translations for a product variant. - - Requires one of the following permissions: MANAGE_TRANSLATIONS. - """ - productVariantTranslate( - """ - ProductVariant ID or ProductVariantTranslatableContent ID. - """ - id: ID! - input: NameTranslationInput! - - """ - Translation language code. - """ - languageCode: LanguageCodeEnum! - ): ProductVariantTranslate - - """ - Manage product variant prices in channels. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productVariantChannelListingUpdate( - """ - ID of a product variant to update. - """ - id: ID! - - """ - List of fields required to create or upgrade product variant channel listings. - """ - input: [ProductVariantChannelListingAddInput!]! - ): ProductVariantChannelListingUpdate - - """ - Reorder product variant attribute values. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productVariantReorderAttributeValues( - """ - ID of an attribute. - """ - attributeId: ID! - - """ - The list of reordering operations for given attribute values. - """ - moves: [ReorderInput!]! - - """ - ID of a product variant. - """ - variantId: ID! - ): ProductVariantReorderAttributeValues - - """ - Deactivates product variant preorder. It changes all preorder allocation into regular allocation. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - productVariantPreorderDeactivate( - """ - ID of a variant which preorder should be deactivated. - """ - id: ID! - ): ProductVariantPreorderDeactivate - - """ - Assign an media to a product variant. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - variantMediaAssign( - """ - ID of a product media to assign to a variant. - """ - mediaId: ID! - - """ - ID of a product variant. - """ - variantId: ID! - ): VariantMediaAssign - - """ - Unassign an media from a product variant. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - variantMediaUnassign( - """ - ID of a product media to unassign from a variant. - """ - mediaId: ID! - - """ - ID of a product variant. - """ - variantId: ID! - ): VariantMediaUnassign - - """ - Captures the authorized payment amount. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - paymentCapture( - """ - Transaction amount. - """ - amount: PositiveDecimal - - """ - Payment ID. - """ - paymentId: ID! - ): PaymentCapture - - """ - Refunds the captured payment amount. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - paymentRefund( - """ - Transaction amount. - """ - amount: PositiveDecimal - - """ - Payment ID. - """ - paymentId: ID! - ): PaymentRefund - - """ - Voids the authorized payment. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - paymentVoid( - """ - Payment ID. - """ - paymentId: ID! - ): PaymentVoid - - """ - Initializes payment process when it is required by gateway. - """ - paymentInitialize( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - - """ - A gateway name used to initialize the payment. - """ - gateway: String! - - """ - Client-side generated data required to initialize the payment. - """ - paymentData: JSONString - ): PaymentInitialize - - """ - Check payment balance. - """ - paymentCheckBalance( - """ - Fields required to check payment balance. - """ - input: PaymentCheckBalanceInput! - ): PaymentCheckBalance - - """ - Create transaction for checkout or order. Requires the following permissions: AUTHENTICATED_APP and HANDLE_PAYMENTS. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - transactionCreate( - """ - The ID of the checkout or order. - """ - id: ID! - - """ - Input data required to create a new transaction object. - """ - transaction: TransactionCreateInput! - - """ - Data that defines a transaction event. - """ - transactionEvent: TransactionEventInput - ): TransactionCreate - - """ - Create transaction for checkout or order. Requires the following permissions: AUTHENTICATED_APP and HANDLE_PAYMENTS. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - transactionUpdate( - """ - The ID of the transaction. - """ - id: ID! - - """ - Input data required to create a new transaction object. - """ - transaction: TransactionUpdateInput - - """ - Data that defines a transaction transaction. - """ - transactionEvent: TransactionEventInput - ): TransactionUpdate - - """ - Request an action for payment transaction. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - - Requires one of the following permissions: HANDLE_PAYMENTS, MANAGE_ORDERS. - """ - transactionRequestAction( - """ - Determines the action type. - """ - actionType: TransactionActionEnum! - - """ - Transaction request amount. If empty for refund or capture, maximal possible amount will be used. - """ - amount: PositiveDecimal - - """ - The ID of the transaction. - """ - id: ID! - ): TransactionRequestAction - - """ - Creates a new page. - - Requires one of the following permissions: MANAGE_PAGES. - """ - pageCreate( - """ - Fields required to create a page. - """ - input: PageCreateInput! - ): PageCreate - - """ - Deletes a page. - - Requires one of the following permissions: MANAGE_PAGES. - """ - pageDelete( - """ - ID of a page to delete. - """ - id: ID! - ): PageDelete - - """ - Deletes pages. - - Requires one of the following permissions: MANAGE_PAGES. - """ - pageBulkDelete( - """ - List of page IDs to delete. - """ - ids: [ID!]! - ): PageBulkDelete - - """ - Publish pages. - - Requires one of the following permissions: MANAGE_PAGES. - """ - pageBulkPublish( - """ - List of page IDs to (un)publish. - """ - ids: [ID!]! - - """ - Determine if pages will be published or not. - """ - isPublished: Boolean! - ): PageBulkPublish - - """ - Updates an existing page. - - Requires one of the following permissions: MANAGE_PAGES. - """ - pageUpdate( - """ - ID of a page to update. - """ - id: ID! - - """ - Fields required to update a page. - """ - input: PageInput! - ): PageUpdate - - """ - Creates/updates translations for a page. - - Requires one of the following permissions: MANAGE_TRANSLATIONS. - """ - pageTranslate( - """ - Page ID or PageTranslatableContent ID. - """ - id: ID! - input: PageTranslationInput! - - """ - Translation language code. - """ - languageCode: LanguageCodeEnum! - ): PageTranslate - - """ - Create a new page type. - - Requires one of the following permissions: MANAGE_PAGE_TYPES_AND_ATTRIBUTES. - """ - pageTypeCreate( - """ - Fields required to create page type. - """ - input: PageTypeCreateInput! - ): PageTypeCreate - - """ - Update page type. - - Requires one of the following permissions: MANAGE_PAGE_TYPES_AND_ATTRIBUTES. - """ - pageTypeUpdate( - """ - ID of the page type to update. - """ - id: ID - - """ - Fields required to update page type. - """ - input: PageTypeUpdateInput! - ): PageTypeUpdate - - """ - Delete a page type. - - Requires one of the following permissions: MANAGE_PAGE_TYPES_AND_ATTRIBUTES. - """ - pageTypeDelete( - """ - ID of the page type to delete. - """ - id: ID! - ): PageTypeDelete - - """ - Delete page types. - - Requires one of the following permissions: MANAGE_PAGE_TYPES_AND_ATTRIBUTES. - """ - pageTypeBulkDelete( - """ - List of page type IDs to delete - """ - ids: [ID!]! - ): PageTypeBulkDelete - - """ - Assign attributes to a given page type. - - Requires one of the following permissions: MANAGE_PAGE_TYPES_AND_ATTRIBUTES. - """ - pageAttributeAssign( - """ - The IDs of the attributes to assign. - """ - attributeIds: [ID!]! - - """ - ID of the page type to assign the attributes into. - """ - pageTypeId: ID! - ): PageAttributeAssign - - """ - Unassign attributes from a given page type. - - Requires one of the following permissions: MANAGE_PAGE_TYPES_AND_ATTRIBUTES. - """ - pageAttributeUnassign( - """ - The IDs of the attributes to unassign. - """ - attributeIds: [ID!]! - - """ - ID of the page type from which the attributes should be unassign. - """ - pageTypeId: ID! - ): PageAttributeUnassign - - """ - Reorder the attributes of a page type. - - Requires one of the following permissions: MANAGE_PAGE_TYPES_AND_ATTRIBUTES. - """ - pageTypeReorderAttributes( - """ - The list of attribute reordering operations. - """ - moves: [ReorderInput!]! - - """ - ID of a page type. - """ - pageTypeId: ID! - ): PageTypeReorderAttributes - - """ - Reorder page attribute values. - - Requires one of the following permissions: MANAGE_PAGES. - """ - pageReorderAttributeValues( - """ - ID of an attribute. - """ - attributeId: ID! - - """ - The list of reordering operations for given attribute values. - """ - moves: [ReorderInput!]! - - """ - ID of a page. - """ - pageId: ID! - ): PageReorderAttributeValues - - """ - Completes creating an order. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - draftOrderComplete( - """ - ID of the order that will be completed. - """ - id: ID! - ): DraftOrderComplete - - """ - Creates a new draft order. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - draftOrderCreate( - """ - Fields required to create an order. - """ - input: DraftOrderCreateInput! - ): DraftOrderCreate - - """ - Deletes a draft order. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - draftOrderDelete( - """ - ID of a draft order to delete. - """ - id: ID! - ): DraftOrderDelete - - """ - Deletes draft orders. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - draftOrderBulkDelete( - """ - List of draft order IDs to delete. - """ - ids: [ID!]! - ): DraftOrderBulkDelete - - """ - Deletes order lines. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - draftOrderLinesBulkDelete( - """ - List of order lines IDs to delete. - """ - ids: [ID!]! - ): DraftOrderLinesBulkDelete - @deprecated(reason: "This field will be removed in Saleor 4.0.") - - """ - Updates a draft order. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - draftOrderUpdate( - """ - ID of a draft order to update. - """ - id: ID! - - """ - Fields required to update an order. - """ - input: DraftOrderInput! - ): DraftOrderUpdate - - """ - Adds note to the order. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderAddNote( - """ - ID of the order to add a note for. - """ - order: ID! - - """ - Fields required to create a note for the order. - """ - input: OrderAddNoteInput! - ): OrderAddNote - - """ - Cancel an order. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderCancel( - """ - ID of the order to cancel. - """ - id: ID! - ): OrderCancel - - """ - Capture an order. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderCapture( - """ - Amount of money to capture. - """ - amount: PositiveDecimal! - - """ - ID of the order to capture. - """ - id: ID! - ): OrderCapture - - """ - Confirms an unconfirmed order by changing status to unfulfilled. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderConfirm( - """ - ID of an order to confirm. - """ - id: ID! - ): OrderConfirm - - """ - Creates new fulfillments for an order. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderFulfill( - """ - Fields required to create a fulfillment. - """ - input: OrderFulfillInput! - - """ - ID of the order to be fulfilled. - """ - order: ID - ): OrderFulfill - - """ - Cancels existing fulfillment and optionally restocks items. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderFulfillmentCancel( - """ - ID of a fulfillment to cancel. - """ - id: ID! - - """ - Fields required to cancel a fulfillment. - """ - input: FulfillmentCancelInput - ): FulfillmentCancel - - """ - Approve existing fulfillment. - - Added in Saleor 3.1. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderFulfillmentApprove( - """ - True if stock could be exceeded. - """ - allowStockToBeExceeded: Boolean = false - - """ - ID of a fulfillment to approve. - """ - id: ID! - - """ - True if confirmation email should be send. - """ - notifyCustomer: Boolean! - ): FulfillmentApprove - - """ - Updates a fulfillment for an order. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderFulfillmentUpdateTracking( - """ - ID of a fulfillment to update. - """ - id: ID! - - """ - Fields required to update a fulfillment. - """ - input: FulfillmentUpdateTrackingInput! - ): FulfillmentUpdateTracking - - """ - Refund products. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderFulfillmentRefundProducts( - """ - Fields required to create an refund fulfillment. - """ - input: OrderRefundProductsInput! - - """ - ID of the order to be refunded. - """ - order: ID! - ): FulfillmentRefundProducts - - """ - Return products. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderFulfillmentReturnProducts( - """ - Fields required to return products. - """ - input: OrderReturnProductsInput! - - """ - ID of the order to be returned. - """ - order: ID! - ): FulfillmentReturnProducts - - """ - Create order lines for an order. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderLinesCreate( - """ - ID of the order to add the lines to. - """ - id: ID! - - """ - Fields required to add order lines. - """ - input: [OrderLineCreateInput!]! - ): OrderLinesCreate - - """ - Deletes an order line from an order. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderLineDelete( - """ - ID of the order line to delete. - """ - id: ID! - ): OrderLineDelete - - """ - Updates an order line of an order. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderLineUpdate( - """ - ID of the order line to update. - """ - id: ID! - - """ - Fields required to update an order line. - """ - input: OrderLineInput! - ): OrderLineUpdate - - """ - Adds discount to the order. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderDiscountAdd( - """ - Fields required to create a discount for the order. - """ - input: OrderDiscountCommonInput! - - """ - ID of an order to discount. - """ - orderId: ID! - ): OrderDiscountAdd - - """ - Update discount for the order. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderDiscountUpdate( - """ - ID of a discount to update. - """ - discountId: ID! - - """ - Fields required to update a discount for the order. - """ - input: OrderDiscountCommonInput! - ): OrderDiscountUpdate - - """ - Remove discount from the order. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderDiscountDelete( - """ - ID of a discount to remove. - """ - discountId: ID! - ): OrderDiscountDelete - - """ - Update discount for the order line. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderLineDiscountUpdate( - """ - Fields required to update price for the order line. - """ - input: OrderDiscountCommonInput! - - """ - ID of a order line to update price - """ - orderLineId: ID! - ): OrderLineDiscountUpdate - - """ - Remove discount applied to the order line. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderLineDiscountRemove( - """ - ID of a order line to remove its discount - """ - orderLineId: ID! - ): OrderLineDiscountRemove - - """ - Mark order as manually paid. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderMarkAsPaid( - """ - ID of the order to mark paid. - """ - id: ID! - - """ - The external transaction reference. - """ - transactionReference: String - ): OrderMarkAsPaid - - """ - Refund an order. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderRefund( - """ - Amount of money to refund. - """ - amount: PositiveDecimal! - - """ - ID of the order to refund. - """ - id: ID! - ): OrderRefund - - """ - Updates an order. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderUpdate( - """ - ID of an order to update. - """ - id: ID! - - """ - Fields required to update an order. - """ - input: OrderUpdateInput! - ): OrderUpdate - - """ - Updates a shipping method of the order. Requires shipping method ID to update, when null is passed then currently assigned shipping method is removed. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderUpdateShipping( - """ - ID of the order to update a shipping method. - """ - order: ID! - - """ - Fields required to change shipping method of the order. - """ - input: OrderUpdateShippingInput! - ): OrderUpdateShipping - - """ - Void an order. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderVoid( - """ - ID of the order to void. - """ - id: ID! - ): OrderVoid - - """ - Cancels orders. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - orderBulkCancel( - """ - List of orders IDs to cancel. - """ - ids: [ID!]! - ): OrderBulkCancel - - """ - Delete metadata of an object. To use it, you need to have access to the modified object. - """ - deleteMetadata( - """ - ID or token (for Order and Checkout) of an object to update. - """ - id: ID! - - """ - Metadata keys to delete. - """ - keys: [String!]! - ): DeleteMetadata - - """ - Delete object's private metadata. To use it, you need to be an authenticated staff user or an app and have access to the modified object. - """ - deletePrivateMetadata( - """ - ID or token (for Order and Checkout) of an object to update. - """ - id: ID! - - """ - Metadata keys to delete. - """ - keys: [String!]! - ): DeletePrivateMetadata - - """ - Updates metadata of an object. To use it, you need to have access to the modified object. - """ - updateMetadata( - """ - ID or token (for Order and Checkout) of an object to update. - """ - id: ID! - - """ - Fields required to update the object's metadata. - """ - input: [MetadataInput!]! - ): UpdateMetadata - - """ - Updates private metadata of an object. To use it, you need to be an authenticated staff user or an app and have access to the modified object. - """ - updatePrivateMetadata( - """ - ID or token (for Order and Checkout) of an object to update. - """ - id: ID! - - """ - Fields required to update the object's metadata. - """ - input: [MetadataInput!]! - ): UpdatePrivateMetadata - - """ - Assigns storefront's navigation menus. - - Requires one of the following permissions: MANAGE_MENUS, MANAGE_SETTINGS. - """ - assignNavigation( - """ - ID of the menu. - """ - menu: ID - - """ - Type of the navigation bar to assign the menu to. - """ - navigationType: NavigationType! - ): AssignNavigation - - """ - Creates a new Menu. - - Requires one of the following permissions: MANAGE_MENUS. - """ - menuCreate( - """ - Fields required to create a menu. - """ - input: MenuCreateInput! - ): MenuCreate - - """ - Deletes a menu. - - Requires one of the following permissions: MANAGE_MENUS. - """ - menuDelete( - """ - ID of a menu to delete. - """ - id: ID! - ): MenuDelete - - """ - Deletes menus. - - Requires one of the following permissions: MANAGE_MENUS. - """ - menuBulkDelete( - """ - List of menu IDs to delete. - """ - ids: [ID!]! - ): MenuBulkDelete - - """ - Updates a menu. - - Requires one of the following permissions: MANAGE_MENUS. - """ - menuUpdate( - """ - ID of a menu to update. - """ - id: ID! - - """ - Fields required to update a menu. - """ - input: MenuInput! - ): MenuUpdate - - """ - Creates a new menu item. - - Requires one of the following permissions: MANAGE_MENUS. - """ - menuItemCreate( - """ - Fields required to update a menu item. Only one of `url`, `category`, `page`, `collection` is allowed per item. - """ - input: MenuItemCreateInput! - ): MenuItemCreate - - """ - Deletes a menu item. - - Requires one of the following permissions: MANAGE_MENUS. - """ - menuItemDelete( - """ - ID of a menu item to delete. - """ - id: ID! - ): MenuItemDelete - - """ - Deletes menu items. - - Requires one of the following permissions: MANAGE_MENUS. - """ - menuItemBulkDelete( - """ - List of menu item IDs to delete. - """ - ids: [ID!]! - ): MenuItemBulkDelete - - """ - Updates a menu item. - - Requires one of the following permissions: MANAGE_MENUS. - """ - menuItemUpdate( - """ - ID of a menu item to update. - """ - id: ID! - - """ - Fields required to update a menu item. Only one of `url`, `category`, `page`, `collection` is allowed per item. - """ - input: MenuItemInput! - ): MenuItemUpdate - - """ - Creates/updates translations for a menu item. - - Requires one of the following permissions: MANAGE_TRANSLATIONS. - """ - menuItemTranslate( - """ - MenuItem ID or MenuItemTranslatableContent ID. - """ - id: ID! - input: NameTranslationInput! - - """ - Translation language code. - """ - languageCode: LanguageCodeEnum! - ): MenuItemTranslate - - """ - Moves items of menus. - - Requires one of the following permissions: MANAGE_MENUS. - """ - menuItemMove( - """ - ID of the menu. - """ - menu: ID! - - """ - The menu position data. - """ - moves: [MenuItemMoveInput!]! - ): MenuItemMove - - """ - Request an invoice for the order using plugin. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - invoiceRequest( - """ - Invoice number, if not provided it will be generated. - """ - number: String - - """ - ID of the order related to invoice. - """ - orderId: ID! - ): InvoiceRequest - - """ - Requests deletion of an invoice. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - invoiceRequestDelete( - """ - ID of an invoice to request the deletion. - """ - id: ID! - ): InvoiceRequestDelete - - """ - Creates a ready to send invoice. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - invoiceCreate( - """ - Fields required when creating an invoice. - """ - input: InvoiceCreateInput! - - """ - ID of the order related to invoice. - """ - orderId: ID! - ): InvoiceCreate - - """ - Deletes an invoice. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - invoiceDelete( - """ - ID of an invoice to delete. - """ - id: ID! - ): InvoiceDelete - - """ - Updates an invoice. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - invoiceUpdate( - """ - ID of an invoice to update. - """ - id: ID! - - """ - Fields to use when updating an invoice. - """ - input: UpdateInvoiceInput! - ): InvoiceUpdate - - """ - Send an invoice notification to the customer. - - Requires one of the following permissions: MANAGE_ORDERS. - """ - invoiceSendNotification( - """ - ID of an invoice to be sent. - """ - id: ID! - ): InvoiceSendNotification - - """ - Activate a gift card. - - Requires one of the following permissions: MANAGE_GIFT_CARD. - """ - giftCardActivate( - """ - ID of a gift card to activate. - """ - id: ID! - ): GiftCardActivate - - """ - Creates a new gift card. - - Requires one of the following permissions: MANAGE_GIFT_CARD. - """ - giftCardCreate( - """ - Fields required to create a gift card. - """ - input: GiftCardCreateInput! - ): GiftCardCreate - - """ - Delete gift card. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - - Requires one of the following permissions: MANAGE_GIFT_CARD. - """ - giftCardDelete( - """ - ID of the gift card to delete. - """ - id: ID! - ): GiftCardDelete - - """ - Deactivate a gift card. - - Requires one of the following permissions: MANAGE_GIFT_CARD. - """ - giftCardDeactivate( - """ - ID of a gift card to deactivate. - """ - id: ID! - ): GiftCardDeactivate - - """ - Update a gift card. - - Requires one of the following permissions: MANAGE_GIFT_CARD. - """ - giftCardUpdate( - """ - ID of a gift card to update. - """ - id: ID! - - """ - Fields required to update a gift card. - """ - input: GiftCardUpdateInput! - ): GiftCardUpdate - - """ - Resend a gift card. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - - Requires one of the following permissions: MANAGE_GIFT_CARD. - """ - giftCardResend( - """ - Fields required to resend a gift card. - """ - input: GiftCardResendInput! - ): GiftCardResend - - """ - Adds note to the gift card. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - - Requires one of the following permissions: MANAGE_GIFT_CARD. - """ - giftCardAddNote( - """ - ID of the gift card to add a note for. - """ - id: ID! - - """ - Fields required to create a note for the gift card. - """ - input: GiftCardAddNoteInput! - ): GiftCardAddNote - - """ - Create gift cards. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - - Requires one of the following permissions: MANAGE_GIFT_CARD. - """ - giftCardBulkCreate( - """ - Fields required to create gift cards. - """ - input: GiftCardBulkCreateInput! - ): GiftCardBulkCreate - - """ - Delete gift cards. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - - Requires one of the following permissions: MANAGE_GIFT_CARD. - """ - giftCardBulkDelete( - """ - List of gift card IDs to delete. - """ - ids: [ID!]! - ): GiftCardBulkDelete - - """ - Activate gift cards. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - - Requires one of the following permissions: MANAGE_GIFT_CARD. - """ - giftCardBulkActivate( - """ - List of gift card IDs to activate. - """ - ids: [ID!]! - ): GiftCardBulkActivate - - """ - Deactivate gift cards. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - - Requires one of the following permissions: MANAGE_GIFT_CARD. - """ - giftCardBulkDeactivate( - """ - List of gift card IDs to deactivate. - """ - ids: [ID!]! - ): GiftCardBulkDeactivate - - """ - Update plugin configuration. - - Requires one of the following permissions: MANAGE_PLUGINS. - """ - pluginUpdate( - """ - ID of a channel for which the data should be modified. - """ - channelId: ID - - """ - ID of plugin to update. - """ - id: ID! - - """ - Fields required to update a plugin configuration. - """ - input: PluginUpdateInput! - ): PluginUpdate - - """ - Trigger sending a notification with the notify plugin method. Serializes nodes provided as ids parameter and includes this data in the notification payload. - - Added in Saleor 3.1. - """ - externalNotificationTrigger( - """ - Channel slug. Saleor will send a notification within a provided channel. Please, make sure that necessary plugins are active. - """ - channel: String! - - """ - Input for External Notification Trigger. - """ - input: ExternalNotificationTriggerInput! - - """ - The ID of notification plugin. - """ - pluginId: String - ): ExternalNotificationTrigger - - """ - Creates a new sale. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - saleCreate( - """ - Fields required to create a sale. - """ - input: SaleInput! - ): SaleCreate - - """ - Deletes a sale. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - saleDelete( - """ - ID of a sale to delete. - """ - id: ID! - ): SaleDelete - - """ - Deletes sales. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - saleBulkDelete( - """ - List of sale IDs to delete. - """ - ids: [ID!]! - ): SaleBulkDelete - - """ - Updates a sale. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - saleUpdate( - """ - ID of a sale to update. - """ - id: ID! - - """ - Fields required to update a sale. - """ - input: SaleInput! - ): SaleUpdate - - """ - Adds products, categories, collections to a voucher. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - saleCataloguesAdd( - """ - ID of a sale. - """ - id: ID! - - """ - Fields required to modify catalogue IDs of sale. - """ - input: CatalogueInput! - ): SaleAddCatalogues - - """ - Removes products, categories, collections from a sale. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - saleCataloguesRemove( - """ - ID of a sale. - """ - id: ID! - - """ - Fields required to modify catalogue IDs of sale. - """ - input: CatalogueInput! - ): SaleRemoveCatalogues - - """ - Creates/updates translations for a sale. - - Requires one of the following permissions: MANAGE_TRANSLATIONS. - """ - saleTranslate( - """ - Sale ID or SaleTranslatableContent ID. - """ - id: ID! - input: NameTranslationInput! - - """ - Translation language code. - """ - languageCode: LanguageCodeEnum! - ): SaleTranslate - - """ - Manage sale's availability in channels. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - saleChannelListingUpdate( - """ - ID of a sale to update. - """ - id: ID! - - """ - Fields required to update sale channel listings. - """ - input: SaleChannelListingInput! - ): SaleChannelListingUpdate - - """ - Creates a new voucher. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - voucherCreate( - """ - Fields required to create a voucher. - """ - input: VoucherInput! - ): VoucherCreate - - """ - Deletes a voucher. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - voucherDelete( - """ - ID of a voucher to delete. - """ - id: ID! - ): VoucherDelete - - """ - Deletes vouchers. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - voucherBulkDelete( - """ - List of voucher IDs to delete. - """ - ids: [ID!]! - ): VoucherBulkDelete - - """ - Updates a voucher. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - voucherUpdate( - """ - ID of a voucher to update. - """ - id: ID! - - """ - Fields required to update a voucher. - """ - input: VoucherInput! - ): VoucherUpdate - - """ - Adds products, categories, collections to a voucher. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - voucherCataloguesAdd( - """ - ID of a voucher. - """ - id: ID! - - """ - Fields required to modify catalogue IDs of voucher. - """ - input: CatalogueInput! - ): VoucherAddCatalogues - - """ - Removes products, categories, collections from a voucher. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - voucherCataloguesRemove( - """ - ID of a voucher. - """ - id: ID! - - """ - Fields required to modify catalogue IDs of voucher. - """ - input: CatalogueInput! - ): VoucherRemoveCatalogues - - """ - Creates/updates translations for a voucher. - - Requires one of the following permissions: MANAGE_TRANSLATIONS. - """ - voucherTranslate( - """ - Voucher ID or VoucherTranslatableContent ID. - """ - id: ID! - input: NameTranslationInput! - - """ - Translation language code. - """ - languageCode: LanguageCodeEnum! - ): VoucherTranslate - - """ - Manage voucher's availability in channels. - - Requires one of the following permissions: MANAGE_DISCOUNTS. - """ - voucherChannelListingUpdate( - """ - ID of a voucher to update. - """ - id: ID! - - """ - Fields required to update voucher channel listings. - """ - input: VoucherChannelListingInput! - ): VoucherChannelListingUpdate - - """ - Export products to csv file. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - exportProducts( - """ - Fields required to export product data. - """ - input: ExportProductsInput! - ): ExportProducts - - """ - Export gift cards to csv file. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - - Requires one of the following permissions: MANAGE_GIFT_CARD. - """ - exportGiftCards( - """ - Fields required to export gift cards data. - """ - input: ExportGiftCardsInput! - ): ExportGiftCards - - """ - Upload a file. This mutation must be sent as a `multipart` request. More detailed specs of the upload format can be found here: https://github.com/jaydenseric/graphql-multipart-request-spec - - Requires one of the following permissions: AUTHENTICATED_APP, AUTHENTICATED_STAFF_USER. - """ - fileUpload( - """ - Represents a file in a multipart request. - """ - file: Upload! - ): FileUpload - - """ - Adds a gift card or a voucher to a checkout. - """ - checkoutAddPromoCode( - """ - The ID of the checkout. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - checkoutId: ID - - """ - The checkout's ID. - - Added in Saleor 3.4. - """ - id: ID - - """ - Gift card code or voucher code. - """ - promoCode: String! - - """ - Checkout token. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - token: UUID - ): CheckoutAddPromoCode - - """ - Update billing address in the existing checkout. - """ - checkoutBillingAddressUpdate( - """ - The billing address of the checkout. - """ - billingAddress: AddressInput! - - """ - The ID of the checkout. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - checkoutId: ID - - """ - The checkout's ID. - - Added in Saleor 3.4. - """ - id: ID - - """ - Checkout token. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - token: UUID - ): CheckoutBillingAddressUpdate - - """ - Completes the checkout. As a result a new order is created and a payment charge is made. This action requires a successful payment before it can be performed. In case additional confirmation step as 3D secure is required confirmationNeeded flag will be set to True and no order created until payment is confirmed with second call of this mutation. - """ - checkoutComplete( - """ - The ID of the checkout. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - checkoutId: ID - - """ - The checkout's ID. - - Added in Saleor 3.4. - """ - id: ID - - """ - Client-side generated data required to finalize the payment. - """ - paymentData: JSONString - - """ - URL of a view where users should be redirected to see the order details. URL in RFC 1808 format. - """ - redirectUrl: String - - """ - Determines whether to store the payment source for future usage. - - DEPRECATED: this field will be removed in Saleor 4.0. Use checkoutPaymentCreate for this action. - """ - storeSource: Boolean = false - - """ - Checkout token. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - token: UUID - ): CheckoutComplete - - """ - Create a new checkout. - """ - checkoutCreate( - """ - Fields required to create checkout. - """ - input: CheckoutCreateInput! - ): CheckoutCreate - - """ - Sets the customer as the owner of the checkout. - - Requires one of the following permissions: AUTHENTICATED_APP, AUTHENTICATED_USER. - """ - checkoutCustomerAttach( - """ - The ID of the checkout. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - checkoutId: ID - - """ - ID of customer to attach to checkout. Can be used to attach customer to checkout by staff or app. Requires IMPERSONATE_USER permission. - """ - customerId: ID - - """ - The checkout's ID. - - Added in Saleor 3.4. - """ - id: ID - - """ - Checkout token. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - token: UUID - ): CheckoutCustomerAttach - - """ - Removes the user assigned as the owner of the checkout. - - Requires one of the following permissions: AUTHENTICATED_APP, AUTHENTICATED_USER. - """ - checkoutCustomerDetach( - """ - The ID of the checkout. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - checkoutId: ID - - """ - The checkout's ID. - - Added in Saleor 3.4. - """ - id: ID - - """ - Checkout token. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - token: UUID - ): CheckoutCustomerDetach - - """ - Updates email address in the existing checkout object. - """ - checkoutEmailUpdate( - """ - The ID of the checkout. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - checkoutId: ID - - """ - email. - """ - email: String! - - """ - The checkout's ID. - - Added in Saleor 3.4. - """ - id: ID - - """ - Checkout token. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - token: UUID - ): CheckoutEmailUpdate - - """ - Deletes a CheckoutLine. - """ - checkoutLineDelete( - """ - The ID of the checkout. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - checkoutId: ID - - """ - The checkout's ID. - - Added in Saleor 3.4. - """ - id: ID - - """ - ID of the checkout line to delete. - """ - lineId: ID - - """ - Checkout token. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - token: UUID - ): CheckoutLineDelete - @deprecated( - reason: "DEPRECATED: Will be removed in Saleor 4.0. Use `checkoutLinesDelete` instead." - ) - - """ - Deletes checkout lines. - """ - checkoutLinesDelete( - """ - The checkout's ID. - - Added in Saleor 3.4. - """ - id: ID - - """ - A list of checkout lines. - """ - linesIds: [ID!]! - - """ - Checkout token. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - token: UUID - ): CheckoutLinesDelete - - """ - Adds a checkout line to the existing checkout.If line was already in checkout, its quantity will be increased. - """ - checkoutLinesAdd( - """ - The ID of the checkout. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - checkoutId: ID - - """ - The checkout's ID. - - Added in Saleor 3.4. - """ - id: ID - - """ - A list of checkout lines, each containing information about an item in the checkout. - """ - lines: [CheckoutLineInput!]! - - """ - Checkout token. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - token: UUID - ): CheckoutLinesAdd - - """ - Updates checkout line in the existing checkout. - """ - checkoutLinesUpdate( - """ - The ID of the checkout. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - checkoutId: ID - - """ - The checkout's ID. - - Added in Saleor 3.4. - """ - id: ID - - """ - A list of checkout lines, each containing information about an item in the checkout. - """ - lines: [CheckoutLineUpdateInput!]! - - """ - Checkout token. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - token: UUID - ): CheckoutLinesUpdate - - """ - Remove a gift card or a voucher from a checkout. - """ - checkoutRemovePromoCode( - """ - The ID of the checkout. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - checkoutId: ID - - """ - The checkout's ID. - - Added in Saleor 3.4. - """ - id: ID - - """ - Gift card code or voucher code. - """ - promoCode: String - - """ - Gift card or voucher ID. - """ - promoCodeId: ID - - """ - Checkout token. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - token: UUID - ): CheckoutRemovePromoCode - - """ - Create a new payment for given checkout. - """ - checkoutPaymentCreate( - """ - The ID of the checkout. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - checkoutId: ID - - """ - The checkout's ID. - - Added in Saleor 3.4. - """ - id: ID - - """ - Data required to create a new payment. - """ - input: PaymentInput! - - """ - Checkout token. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - token: UUID - ): CheckoutPaymentCreate - - """ - Update shipping address in the existing checkout. - """ - checkoutShippingAddressUpdate( - """ - The ID of the checkout. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - checkoutId: ID - - """ - The checkout's ID. - - Added in Saleor 3.4. - """ - id: ID - - """ - The mailing address to where the checkout will be shipped. - """ - shippingAddress: AddressInput! - - """ - Checkout token. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - token: UUID - ): CheckoutShippingAddressUpdate - - """ - Updates the shipping method of the checkout. - """ - checkoutShippingMethodUpdate( - """ - The ID of the checkout. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - checkoutId: ID - - """ - The checkout's ID. - - Added in Saleor 3.4. - """ - id: ID - - """ - Shipping method. - """ - shippingMethodId: ID! - - """ - Checkout token. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - token: UUID - ): CheckoutShippingMethodUpdate - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `checkoutDeliveryMethodUpdate` instead." - ) - - """ - Updates the delivery method (shipping method or pick up point) of the checkout. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - checkoutDeliveryMethodUpdate( - """ - Delivery Method ID (`Warehouse` ID or `ShippingMethod` ID). - """ - deliveryMethodId: ID - - """ - The checkout's ID. - - Added in Saleor 3.4. - """ - id: ID - - """ - Checkout token. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - token: UUID - ): CheckoutDeliveryMethodUpdate - - """ - Update language code in the existing checkout. - """ - checkoutLanguageCodeUpdate( - """ - The ID of the checkout. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - checkoutId: ID - - """ - The checkout's ID. - - Added in Saleor 3.4. - """ - id: ID - - """ - New language code. - """ - languageCode: LanguageCodeEnum! - - """ - Checkout token. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `id` instead. - """ - token: UUID - ): CheckoutLanguageCodeUpdate - - """ - Create new order from existing checkout. Requires the following permissions: AUTHENTICATED_APP and HANDLE_CHECKOUTS. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - orderCreateFromCheckout( - """ - ID of a checkout that will be converted to an order. - """ - id: ID! - - """ - Determines if checkout should be removed after creating an order. Default true. - """ - removeCheckout: Boolean = true - ): OrderCreateFromCheckout - - """ - Creates new channel. - - Requires one of the following permissions: MANAGE_CHANNELS. - """ - channelCreate( - """ - Fields required to create channel. - """ - input: ChannelCreateInput! - ): ChannelCreate - - """ - Update a channel. - - Requires one of the following permissions: MANAGE_CHANNELS. - """ - channelUpdate( - """ - ID of a channel to update. - """ - id: ID! - - """ - Fields required to update a channel. - """ - input: ChannelUpdateInput! - ): ChannelUpdate - - """ - Delete a channel. Orders associated with the deleted channel will be moved to the target channel. Checkouts, product availability, and pricing will be removed. - - Requires one of the following permissions: MANAGE_CHANNELS. - """ - channelDelete( - """ - ID of a channel to delete. - """ - id: ID! - - """ - Fields required to delete a channel. - """ - input: ChannelDeleteInput - ): ChannelDelete - - """ - Activate a channel. - - Requires one of the following permissions: MANAGE_CHANNELS. - """ - channelActivate( - """ - ID of the channel to activate. - """ - id: ID! - ): ChannelActivate - - """ - Deactivate a channel. - - Requires one of the following permissions: MANAGE_CHANNELS. - """ - channelDeactivate( - """ - ID of the channel to deactivate. - """ - id: ID! - ): ChannelDeactivate - - """ - Creates an attribute. - """ - attributeCreate( - """ - Fields required to create an attribute. - """ - input: AttributeCreateInput! - ): AttributeCreate - - """ - Deletes an attribute. - - Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. - """ - attributeDelete( - """ - ID of an attribute to delete. - """ - id: ID! - ): AttributeDelete - - """ - Updates attribute. - - Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. - """ - attributeUpdate( - """ - ID of an attribute to update. - """ - id: ID! - - """ - Fields required to update an attribute. - """ - input: AttributeUpdateInput! - ): AttributeUpdate - - """ - Creates/updates translations for an attribute. - - Requires one of the following permissions: MANAGE_TRANSLATIONS. - """ - attributeTranslate( - """ - Attribute ID or AttributeTranslatableContent ID. - """ - id: ID! - input: NameTranslationInput! - - """ - Translation language code. - """ - languageCode: LanguageCodeEnum! - ): AttributeTranslate - - """ - Deletes attributes. - - Requires one of the following permissions: MANAGE_PAGE_TYPES_AND_ATTRIBUTES. - """ - attributeBulkDelete( - """ - List of attribute IDs to delete. - """ - ids: [ID!]! - ): AttributeBulkDelete - - """ - Deletes values of attributes. - - Requires one of the following permissions: MANAGE_PAGE_TYPES_AND_ATTRIBUTES. - """ - attributeValueBulkDelete( - """ - List of attribute value IDs to delete. - """ - ids: [ID!]! - ): AttributeValueBulkDelete - - """ - Creates a value for an attribute. - - Requires one of the following permissions: MANAGE_PRODUCTS. - """ - attributeValueCreate( - """ - Attribute to which value will be assigned. - """ - attribute: ID! - - """ - Fields required to create an AttributeValue. - """ - input: AttributeValueCreateInput! - ): AttributeValueCreate - - """ - Deletes a value of an attribute. - - Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. - """ - attributeValueDelete( - """ - ID of a value to delete. - """ - id: ID! - ): AttributeValueDelete - - """ - Updates value of an attribute. - - Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. - """ - attributeValueUpdate( - """ - ID of an AttributeValue to update. - """ - id: ID! - - """ - Fields required to update an AttributeValue. - """ - input: AttributeValueUpdateInput! - ): AttributeValueUpdate - - """ - Creates/updates translations for an attribute value. - - Requires one of the following permissions: MANAGE_TRANSLATIONS. - """ - attributeValueTranslate( - """ - AttributeValue ID or AttributeValueTranslatableContent ID. - """ - id: ID! - input: AttributeValueTranslationInput! - - """ - Translation language code. - """ - languageCode: LanguageCodeEnum! - ): AttributeValueTranslate - - """ - Reorder the values of an attribute. - - Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. - """ - attributeReorderValues( - """ - ID of an attribute. - """ - attributeId: ID! - - """ - The list of reordering operations for given attribute values. - """ - moves: [ReorderInput!]! - ): AttributeReorderValues - - """ - Creates a new app. Requires the following permissions: AUTHENTICATED_STAFF_USER and MANAGE_APPS. - """ - appCreate( - """ - Fields required to create a new app. - """ - input: AppInput! - ): AppCreate - - """ - Updates an existing app. - - Requires one of the following permissions: MANAGE_APPS. - """ - appUpdate( - """ - ID of an app to update. - """ - id: ID! - - """ - Fields required to update an existing app. - """ - input: AppInput! - ): AppUpdate - - """ - Deletes an app. - - Requires one of the following permissions: MANAGE_APPS. - """ - appDelete( - """ - ID of an app to delete. - """ - id: ID! - ): AppDelete - - """ - Creates a new token. - - Requires one of the following permissions: MANAGE_APPS. - """ - appTokenCreate( - """ - Fields required to create a new auth token. - """ - input: AppTokenInput! - ): AppTokenCreate - - """ - Deletes an authentication token assigned to app. - - Requires one of the following permissions: MANAGE_APPS. - """ - appTokenDelete( - """ - ID of an auth token to delete. - """ - id: ID! - ): AppTokenDelete - - """ - Verify provided app token. - """ - appTokenVerify( - """ - App token to verify. - """ - token: String! - ): AppTokenVerify - - """ - Install new app by using app manifest. Requires the following permissions: AUTHENTICATED_STAFF_USER and MANAGE_APPS. - """ - appInstall( - """ - Fields required to install a new app. - """ - input: AppInstallInput! - ): AppInstall - - """ - Retry failed installation of new app. - - Requires one of the following permissions: MANAGE_APPS. - """ - appRetryInstall( - """ - Determine if app will be set active or not. - """ - activateAfterInstallation: Boolean = true - - """ - ID of failed installation. - """ - id: ID! - ): AppRetryInstall - - """ - Delete failed installation. - - Requires one of the following permissions: MANAGE_APPS. - """ - appDeleteFailedInstallation( - """ - ID of failed installation to delete. - """ - id: ID! - ): AppDeleteFailedInstallation - - """ - Fetch and validate manifest. - - Requires one of the following permissions: MANAGE_APPS. - """ - appFetchManifest(manifestUrl: String!): AppFetchManifest - - """ - Activate the app. - - Requires one of the following permissions: MANAGE_APPS. - """ - appActivate( - """ - ID of app to activate. - """ - id: ID! - ): AppActivate - - """ - Deactivate the app. - - Requires one of the following permissions: MANAGE_APPS. - """ - appDeactivate( - """ - ID of app to deactivate. - """ - id: ID! - ): AppDeactivate - - """ - Create JWT token. - """ - tokenCreate( - """ - Email of a user. - """ - email: String! - - """ - Password of a user. - """ - password: String! - ): CreateToken - - """ - Refresh JWT token. Mutation tries to take refreshToken from the input.If it fails it will try to take refreshToken from the http-only cookie -refreshToken. csrfToken is required when refreshToken is provided as a cookie. - """ - tokenRefresh( - """ - CSRF token required to refresh token. This argument is required when refreshToken is provided as a cookie. - """ - csrfToken: String - - """ - Refresh token. - """ - refreshToken: String - ): RefreshToken - - """ - Verify JWT token. - """ - tokenVerify( - """ - JWT token to validate. - """ - token: String! - ): VerifyToken - - """ - Deactivate all JWT tokens of the currently authenticated user. - - Requires one of the following permissions: AUTHENTICATED_USER. - """ - tokensDeactivateAll: DeactivateAllUserTokens - - """ - Prepare external authentication url for user by custom plugin. - """ - externalAuthenticationUrl( - """ - The data required by plugin to create external authentication url. - """ - input: JSONString! - - """ - The ID of the authentication plugin. - """ - pluginId: String! - ): ExternalAuthenticationUrl - - """ - Obtain external access tokens for user by custom plugin. - """ - externalObtainAccessTokens( - """ - The data required by plugin to create authentication data. - """ - input: JSONString! - - """ - The ID of the authentication plugin. - """ - pluginId: String! - ): ExternalObtainAccessTokens - - """ - Refresh user's access by custom plugin. - """ - externalRefresh( - """ - The data required by plugin to proceed the refresh process. - """ - input: JSONString! - - """ - The ID of the authentication plugin. - """ - pluginId: String! - ): ExternalRefresh - - """ - Logout user by custom plugin. - """ - externalLogout( - """ - The data required by plugin to proceed the logout process. - """ - input: JSONString! - - """ - The ID of the authentication plugin. - """ - pluginId: String! - ): ExternalLogout - - """ - Verify external authentication data by plugin. - """ - externalVerify( - """ - The data required by plugin to proceed the verification. - """ - input: JSONString! - - """ - The ID of the authentication plugin. - """ - pluginId: String! - ): ExternalVerify - - """ - Sends an email with the account password modification link. - """ - requestPasswordReset( - """ - Slug of a channel which will be used for notify user. Optional when only one channel exists. - """ - channel: String - - """ - Email of the user that will be used for password recovery. - """ - email: String! - - """ - URL of a view where users should be redirected to reset the password. URL in RFC 1808 format. - """ - redirectUrl: String! - ): RequestPasswordReset - - """ - Confirm user account with token sent by email during registration. - """ - confirmAccount( - """ - E-mail of the user performing account confirmation. - """ - email: String! - - """ - A one-time token required to confirm the account. - """ - token: String! - ): ConfirmAccount - - """ - Sets the user's password from the token sent by email using the RequestPasswordReset mutation. - """ - setPassword( - """ - Email of a user. - """ - email: String! - - """ - Password of a user. - """ - password: String! - - """ - A one-time token required to set the password. - """ - token: String! - ): SetPassword - - """ - Change the password of the logged in user. - - Requires one of the following permissions: AUTHENTICATED_USER. - """ - passwordChange( - """ - New user password. - """ - newPassword: String! - - """ - Current user password. - """ - oldPassword: String! - ): PasswordChange - - """ - Request email change of the logged in user. - - Requires one of the following permissions: AUTHENTICATED_USER. - """ - requestEmailChange( - """ - Slug of a channel which will be used to notify users. Optional when only one channel exists. - """ - channel: String - - """ - New user email. - """ - newEmail: String! - - """ - User password. - """ - password: String! - - """ - URL of a view where users should be redirected to update the email address. URL in RFC 1808 format. - """ - redirectUrl: String! - ): RequestEmailChange - - """ - Confirm the email change of the logged-in user. - - Requires one of the following permissions: AUTHENTICATED_USER. - """ - confirmEmailChange( - """ - Slug of a channel which will be used to notify users. Optional when only one channel exists. - """ - channel: String - - """ - A one-time token required to change the email. - """ - token: String! - ): ConfirmEmailChange - - """ - Create a new address for the customer. - - Requires one of the following permissions: AUTHENTICATED_USER. - """ - accountAddressCreate( - """ - Fields required to create address. - """ - input: AddressInput! - - """ - A type of address. If provided, the new address will be automatically assigned as the customer's default address of that type. - """ - type: AddressTypeEnum - ): AccountAddressCreate - - """ - Updates an address of the logged-in user. Requires one of the following permissions: MANAGE_USERS, IS_OWNER. - """ - accountAddressUpdate( - """ - ID of the address to update. - """ - id: ID! - - """ - Fields required to update the address. - """ - input: AddressInput! - ): AccountAddressUpdate - - """ - Delete an address of the logged-in user. Requires one of the following permissions: MANAGE_USERS, IS_OWNER. - """ - accountAddressDelete( - """ - ID of the address to delete. - """ - id: ID! - ): AccountAddressDelete - - """ - Sets a default address for the authenticated user. - - Requires one of the following permissions: AUTHENTICATED_USER. - """ - accountSetDefaultAddress( - """ - ID of the address to set as default. - """ - id: ID! - - """ - The type of address. - """ - type: AddressTypeEnum! - ): AccountSetDefaultAddress - - """ - Register a new user. - """ - accountRegister( - """ - Fields required to create a user. - """ - input: AccountRegisterInput! - ): AccountRegister - - """ - Updates the account of the logged-in user. - - Requires one of the following permissions: AUTHENTICATED_USER. - """ - accountUpdate( - """ - Fields required to update the account of the logged-in user. - """ - input: AccountInput! - ): AccountUpdate - - """ - Sends an email with the account removal link for the logged-in user. - - Requires one of the following permissions: AUTHENTICATED_USER. - """ - accountRequestDeletion( - """ - Slug of a channel which will be used to notify users. Optional when only one channel exists. - """ - channel: String - - """ - URL of a view where users should be redirected to delete their account. URL in RFC 1808 format. - """ - redirectUrl: String! - ): AccountRequestDeletion - - """ - Remove user account. - - Requires one of the following permissions: AUTHENTICATED_USER. - """ - accountDelete( - """ - A one-time token required to remove account. Sent by email using AccountRequestDeletion mutation. - """ - token: String! - ): AccountDelete - - """ - Creates user address. - - Requires one of the following permissions: MANAGE_USERS. - """ - addressCreate( - """ - Fields required to create address. - """ - input: AddressInput! - - """ - ID of a user to create address for. - """ - userId: ID! - ): AddressCreate - - """ - Updates an address. - - Requires one of the following permissions: MANAGE_USERS. - """ - addressUpdate( - """ - ID of the address to update. - """ - id: ID! - - """ - Fields required to update the address. - """ - input: AddressInput! - ): AddressUpdate - - """ - Deletes an address. - - Requires one of the following permissions: MANAGE_USERS. - """ - addressDelete( - """ - ID of the address to delete. - """ - id: ID! - ): AddressDelete - - """ - Sets a default address for the given user. - - Requires one of the following permissions: MANAGE_USERS. - """ - addressSetDefault( - """ - ID of the address. - """ - addressId: ID! - - """ - The type of address. - """ - type: AddressTypeEnum! - - """ - ID of the user to change the address for. - """ - userId: ID! - ): AddressSetDefault - - """ - Creates a new customer. - - Requires one of the following permissions: MANAGE_USERS. - """ - customerCreate( - """ - Fields required to create a customer. - """ - input: UserCreateInput! - ): CustomerCreate - - """ - Updates an existing customer. - - Requires one of the following permissions: MANAGE_USERS. - """ - customerUpdate( - """ - ID of a customer to update. - """ - id: ID! - - """ - Fields required to update a customer. - """ - input: CustomerInput! - ): CustomerUpdate - - """ - Deletes a customer. - - Requires one of the following permissions: MANAGE_USERS. - """ - customerDelete( - """ - ID of a customer to delete. - """ - id: ID! - ): CustomerDelete - - """ - Deletes customers. - - Requires one of the following permissions: MANAGE_USERS. - """ - customerBulkDelete( - """ - List of user IDs to delete. - """ - ids: [ID!]! - ): CustomerBulkDelete - - """ - Creates a new staff user. - - Requires one of the following permissions: MANAGE_STAFF. - """ - staffCreate( - """ - Fields required to create a staff user. - """ - input: StaffCreateInput! - ): StaffCreate - - """ - Updates an existing staff user. - - Requires one of the following permissions: MANAGE_STAFF. - """ - staffUpdate( - """ - ID of a staff user to update. - """ - id: ID! - - """ - Fields required to update a staff user. - """ - input: StaffUpdateInput! - ): StaffUpdate - - """ - Deletes a staff user. - - Requires one of the following permissions: MANAGE_STAFF. - """ - staffDelete( - """ - ID of a staff user to delete. - """ - id: ID! - ): StaffDelete - - """ - Deletes staff users. - - Requires one of the following permissions: MANAGE_STAFF. - """ - staffBulkDelete( - """ - List of user IDs to delete. - """ - ids: [ID!]! - ): StaffBulkDelete - - """ - Create a user avatar. Only for staff members. This mutation must be sent as a `multipart` request. More detailed specs of the upload format can be found here: https://github.com/jaydenseric/graphql-multipart-request-spec - - Requires one of the following permissions: AUTHENTICATED_STAFF_USER. - """ - userAvatarUpdate( - """ - Represents an image file in a multipart request. - """ - image: Upload! - ): UserAvatarUpdate - - """ - Deletes a user avatar. Only for staff members. - - Requires one of the following permissions: AUTHENTICATED_STAFF_USER. - """ - userAvatarDelete: UserAvatarDelete - - """ - Activate or deactivate users. - - Requires one of the following permissions: MANAGE_USERS. - """ - userBulkSetActive( - """ - List of user IDs to (de)activate). - """ - ids: [ID!]! - - """ - Determine if users will be set active or not. - """ - isActive: Boolean! - ): UserBulkSetActive - - """ - Create new permission group. - - Requires one of the following permissions: MANAGE_STAFF. - """ - permissionGroupCreate( - """ - Input fields to create permission group. - """ - input: PermissionGroupCreateInput! - ): PermissionGroupCreate - - """ - Update permission group. - - Requires one of the following permissions: MANAGE_STAFF. - """ - permissionGroupUpdate( - """ - ID of the group to update. - """ - id: ID! - - """ - Input fields to create permission group. - """ - input: PermissionGroupUpdateInput! - ): PermissionGroupUpdate - - """ - Delete permission group. - - Requires one of the following permissions: MANAGE_STAFF. - """ - permissionGroupDelete( - """ - ID of the group to delete. - """ - id: ID! - ): PermissionGroupDelete -} - -""" -Creates a new webhook subscription. - -Requires one of the following permissions: MANAGE_APPS, AUTHENTICATED_APP. -""" -type WebhookCreate { - webhookErrors: [WebhookError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [WebhookError!]! - webhook: Webhook -} - -type WebhookError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: WebhookErrorCode! -} - -""" -An enumeration. -""" -enum WebhookErrorCode { - GRAPHQL_ERROR - INVALID - NOT_FOUND - REQUIRED - UNIQUE -} - -input WebhookCreateInput { - """ - The name of the webhook. - """ - name: String - - """ - The url to receive the payload. - """ - targetUrl: String - - """ - The events that webhook wants to subscribe. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `asyncEvents` or `syncEvents` instead. - """ - events: [WebhookEventTypeEnum!] - - """ - The asynchronous events that webhook wants to subscribe. - """ - asyncEvents: [WebhookEventTypeAsyncEnum!] - - """ - The synchronous events that webhook wants to subscribe. - """ - syncEvents: [WebhookEventTypeSyncEnum!] - - """ - ID of the app to which webhook belongs. - """ - app: ID - - """ - Determine if webhook will be set active or not. - """ - isActive: Boolean - - """ - The secret key used to create a hash signature with each payload. - """ - secretKey: String - - """ - Subscription query used to define a webhook payload. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - query: String -} - -""" -Deletes a webhook subscription. - -Requires one of the following permissions: MANAGE_APPS, AUTHENTICATED_APP. -""" -type WebhookDelete { - webhookErrors: [WebhookError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [WebhookError!]! - webhook: Webhook -} - -""" -Updates a webhook subscription. - -Requires one of the following permissions: MANAGE_APPS. -""" -type WebhookUpdate { - webhookErrors: [WebhookError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [WebhookError!]! - webhook: Webhook -} - -input WebhookUpdateInput { - """ - The new name of the webhook. - """ - name: String - - """ - The url to receive the payload. - """ - targetUrl: String - - """ - The events that webhook wants to subscribe. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `asyncEvents` or `syncEvents` instead. - """ - events: [WebhookEventTypeEnum!] - - """ - The asynchronous events that webhook wants to subscribe. - """ - asyncEvents: [WebhookEventTypeAsyncEnum!] - - """ - The synchronous events that webhook wants to subscribe. - """ - syncEvents: [WebhookEventTypeSyncEnum!] - - """ - ID of the app to which webhook belongs. - """ - app: ID - - """ - Determine if webhook will be set active or not. - """ - isActive: Boolean - - """ - Use to create a hash signature with each payload. - """ - secretKey: String - - """ - Subscription query used to define a webhook payload. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - query: String -} - -""" -Retries event delivery. - -Requires one of the following permissions: MANAGE_APPS. -""" -type EventDeliveryRetry { - """ - Event delivery. - """ - delivery: EventDelivery - errors: [WebhookError!]! -} - -""" -Creates new warehouse. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type WarehouseCreate { - warehouseErrors: [WarehouseError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [WarehouseError!]! - warehouse: Warehouse -} - -type WarehouseError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: WarehouseErrorCode! -} - -""" -An enumeration. -""" -enum WarehouseErrorCode { - ALREADY_EXISTS - GRAPHQL_ERROR - INVALID - NOT_FOUND - REQUIRED - UNIQUE -} - -input WarehouseCreateInput { - """ - Warehouse slug. - """ - slug: String - - """ - The email address of the warehouse. - """ - email: String - - """ - Warehouse name. - """ - name: String! - - """ - Address of the warehouse. - """ - address: AddressInput! - - """ - Shipping zones supported by the warehouse. - """ - shippingZones: [ID!] -} - -""" -Updates given warehouse. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type WarehouseUpdate { - warehouseErrors: [WarehouseError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [WarehouseError!]! - warehouse: Warehouse -} - -input WarehouseUpdateInput { - """ - Warehouse slug. - """ - slug: String - - """ - The email address of the warehouse. - """ - email: String - - """ - Warehouse name. - """ - name: String - - """ - Address of the warehouse. - """ - address: AddressInput - - """ - Click and collect options: local, all or disabled. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - clickAndCollectOption: WarehouseClickAndCollectOptionEnum - - """ - Visibility of warehouse stocks. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - isPrivate: Boolean -} - -""" -Deletes selected warehouse. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type WarehouseDelete { - warehouseErrors: [WarehouseError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [WarehouseError!]! - warehouse: Warehouse -} - -""" -Add shipping zone to given warehouse. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type WarehouseShippingZoneAssign { - warehouseErrors: [WarehouseError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [WarehouseError!]! - warehouse: Warehouse -} - -""" -Remove shipping zone from given warehouse. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type WarehouseShippingZoneUnassign { - warehouseErrors: [WarehouseError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [WarehouseError!]! - warehouse: Warehouse -} - -""" -Creates a new staff notification recipient. - -Requires one of the following permissions: MANAGE_SETTINGS. -""" -type StaffNotificationRecipientCreate { - shopErrors: [ShopError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ShopError!]! - staffNotificationRecipient: StaffNotificationRecipient -} - -type ShopError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: ShopErrorCode! -} - -""" -An enumeration. -""" -enum ShopErrorCode { - ALREADY_EXISTS - CANNOT_FETCH_TAX_RATES - GRAPHQL_ERROR - INVALID - NOT_FOUND - REQUIRED - UNIQUE -} - -input StaffNotificationRecipientInput { - """ - The ID of the user subscribed to email notifications.. - """ - user: ID - - """ - Email address of a user subscribed to email notifications. - """ - email: String - - """ - Determines if a notification active. - """ - active: Boolean -} - -""" -Updates a staff notification recipient. - -Requires one of the following permissions: MANAGE_SETTINGS. -""" -type StaffNotificationRecipientUpdate { - shopErrors: [ShopError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ShopError!]! - staffNotificationRecipient: StaffNotificationRecipient -} - -""" -Delete staff notification recipient. - -Requires one of the following permissions: MANAGE_SETTINGS. -""" -type StaffNotificationRecipientDelete { - shopErrors: [ShopError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ShopError!]! - staffNotificationRecipient: StaffNotificationRecipient -} - -""" -Updates site domain of the shop. - -Requires one of the following permissions: MANAGE_SETTINGS. -""" -type ShopDomainUpdate { - """ - Updated shop. - """ - shop: Shop - shopErrors: [ShopError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ShopError!]! -} - -input SiteDomainInput { - """ - Domain name for shop. - """ - domain: String - - """ - Shop site name. - """ - name: String -} - -""" -Updates shop settings. - -Requires one of the following permissions: MANAGE_SETTINGS. -""" -type ShopSettingsUpdate { - """ - Updated shop. - """ - shop: Shop - shopErrors: [ShopError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ShopError!]! -} - -input ShopSettingsInput { - """ - Header text. - """ - headerText: String - - """ - SEO description. - """ - description: String - - """ - Include taxes in prices. - """ - includeTaxesInPrices: Boolean - - """ - Display prices with tax in store. - """ - displayGrossPrices: Boolean - - """ - Charge taxes on shipping. - """ - chargeTaxesOnShipping: Boolean - - """ - Enable inventory tracking. - """ - trackInventoryByDefault: Boolean - - """ - Default weight unit. - """ - defaultWeightUnit: WeightUnitsEnum - - """ - Enable automatic fulfillment for all digital products. - """ - automaticFulfillmentDigitalProducts: Boolean - - """ - Enable automatic approval of all new fulfillments. - - Added in Saleor 3.1. - """ - fulfillmentAutoApprove: Boolean - - """ - Enable ability to approve fulfillments which are unpaid. - - Added in Saleor 3.1. - """ - fulfillmentAllowUnpaid: Boolean - - """ - Default number of max downloads per digital content URL. - """ - defaultDigitalMaxDownloads: Int - - """ - Default number of days which digital content URL will be valid. - """ - defaultDigitalUrlValidDays: Int - - """ - Default email sender's name. - """ - defaultMailSenderName: String - - """ - Default email sender's address. - """ - defaultMailSenderAddress: String - - """ - URL of a view where customers can set their password. - """ - customerSetPasswordUrl: String - - """ - Default number of minutes stock will be reserved for anonymous checkout. Enter 0 or null to disable. - - Added in Saleor 3.1. - """ - reserveStockDurationAnonymousUser: Int - - """ - Default number of minutes stock will be reserved for authenticated checkout. Enter 0 or null to disable. - - Added in Saleor 3.1. - """ - reserveStockDurationAuthenticatedUser: Int - - """ - Default number of maximum line quantity in single checkout. Minimum possible value is 1, default value is 50. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - limitQuantityPerCheckout: Int -} - -""" -Fetch tax rates. - -Requires one of the following permissions: MANAGE_SETTINGS. -""" -type ShopFetchTaxRates { - """ - Updated shop. - """ - shop: Shop - shopErrors: [ShopError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ShopError!]! -} - -""" -Creates/updates translations for shop settings. - -Requires one of the following permissions: MANAGE_TRANSLATIONS. -""" -type ShopSettingsTranslate { - """ - Updated shop settings. - """ - shop: Shop - translationErrors: [TranslationError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [TranslationError!]! -} - -type TranslationError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: TranslationErrorCode! -} - -""" -An enumeration. -""" -enum TranslationErrorCode { - GRAPHQL_ERROR - INVALID - NOT_FOUND - REQUIRED -} - -input ShopSettingsTranslationInput { - headerText: String - description: String -} - -""" -Update the shop's address. If the `null` value is passed, the currently selected address will be deleted. - -Requires one of the following permissions: MANAGE_SETTINGS. -""" -type ShopAddressUpdate { - """ - Updated shop. - """ - shop: Shop - shopErrors: [ShopError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ShopError!]! -} - -""" -Update shop order settings. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type OrderSettingsUpdate { - """ - Order settings. - """ - orderSettings: OrderSettings - orderSettingsErrors: [OrderSettingsError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderSettingsError!]! -} - -type OrderSettingsError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: OrderSettingsErrorCode! -} - -""" -An enumeration. -""" -enum OrderSettingsErrorCode { - INVALID -} - -input OrderSettingsUpdateInput { - """ - When disabled, all new orders from checkout will be marked as unconfirmed. When enabled orders from checkout will become unfulfilled immediately. - """ - automaticallyConfirmAllNewOrders: Boolean - - """ - When enabled, all non-shippable gift card orders will be fulfilled automatically. - """ - automaticallyFulfillNonShippableGiftCard: Boolean -} - -""" -Update gift card settings. - -Requires one of the following permissions: MANAGE_GIFT_CARD. -""" -type GiftCardSettingsUpdate { - """ - Gift card settings. - """ - giftCardSettings: GiftCardSettings - errors: [GiftCardSettingsError!]! -} - -type GiftCardSettingsError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: GiftCardSettingsErrorCode! -} - -""" -An enumeration. -""" -enum GiftCardSettingsErrorCode { - INVALID - REQUIRED - GRAPHQL_ERROR -} - -input GiftCardSettingsUpdateInput { - """ - Defines gift card default expiry settings. - """ - expiryType: GiftCardSettingsExpiryTypeEnum - - """ - Defines gift card expiry period. - """ - expiryPeriod: TimePeriodInputType -} - -input TimePeriodInputType { - """ - The length of the period. - """ - amount: Int! - - """ - The type of the period. - """ - type: TimePeriodTypeEnum! -} - -""" -Manage shipping method's availability in channels. - -Requires one of the following permissions: MANAGE_SHIPPING. -""" -type ShippingMethodChannelListingUpdate { - """ - An updated shipping method instance. - """ - shippingMethod: ShippingMethodType - shippingErrors: [ShippingError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ShippingError!]! -} - -type ShippingError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: ShippingErrorCode! - - """ - List of warehouse IDs which causes the error. - """ - warehouses: [ID!] - - """ - List of channels IDs which causes the error. - """ - channels: [ID!] -} - -""" -An enumeration. -""" -enum ShippingErrorCode { - ALREADY_EXISTS - GRAPHQL_ERROR - INVALID - MAX_LESS_THAN_MIN - NOT_FOUND - REQUIRED - UNIQUE - DUPLICATED_INPUT_ITEM -} - -input ShippingMethodChannelListingInput { - """ - List of channels to which the shipping method should be assigned. - """ - addChannels: [ShippingMethodChannelListingAddInput!] - - """ - List of channels from which the shipping method should be unassigned. - """ - removeChannels: [ID!] -} - -input ShippingMethodChannelListingAddInput { - """ - ID of a channel. - """ - channelId: ID! - - """ - Shipping price of the shipping method in this channel. - """ - price: PositiveDecimal - - """ - Minimum order price to use this shipping method. - """ - minimumOrderPrice: PositiveDecimal - - """ - Maximum order price to use this shipping method. - """ - maximumOrderPrice: PositiveDecimal -} - -""" -Creates a new shipping price. - -Requires one of the following permissions: MANAGE_SHIPPING. -""" -type ShippingPriceCreate { - """ - A shipping zone to which the shipping method belongs. - """ - shippingZone: ShippingZone - shippingMethod: ShippingMethodType - shippingErrors: [ShippingError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ShippingError!]! -} - -input ShippingPriceInput { - """ - Name of the shipping method. - """ - name: String - - """ - Shipping method description. - """ - description: JSONString - - """ - Minimum order weight to use this shipping method. - """ - minimumOrderWeight: WeightScalar - - """ - Maximum order weight to use this shipping method. - """ - maximumOrderWeight: WeightScalar - - """ - Maximum number of days for delivery. - """ - maximumDeliveryDays: Int - - """ - Minimal number of days for delivery. - """ - minimumDeliveryDays: Int - - """ - Shipping type: price or weight based. - """ - type: ShippingMethodTypeEnum - - """ - Shipping zone this method belongs to. - """ - shippingZone: ID - - """ - Postal code rules to add. - """ - addPostalCodeRules: [ShippingPostalCodeRulesCreateInputRange!] - - """ - Postal code rules to delete. - """ - deletePostalCodeRules: [ID!] - - """ - Inclusion type for currently assigned postal code rules. - """ - inclusionType: PostalCodeRuleInclusionTypeEnum -} - -scalar WeightScalar - -input ShippingPostalCodeRulesCreateInputRange { - """ - Start range of the postal code. - """ - start: String! - - """ - End range of the postal code. - """ - end: String -} - -""" -Deletes a shipping price. - -Requires one of the following permissions: MANAGE_SHIPPING. -""" -type ShippingPriceDelete { - """ - A shipping method to delete. - """ - shippingMethod: ShippingMethodType - - """ - A shipping zone to which the shipping method belongs. - """ - shippingZone: ShippingZone - shippingErrors: [ShippingError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ShippingError!]! -} - -""" -Deletes shipping prices. - -Requires one of the following permissions: MANAGE_SHIPPING. -""" -type ShippingPriceBulkDelete { - """ - Returns how many objects were affected. - """ - count: Int! - shippingErrors: [ShippingError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ShippingError!]! -} - -""" -Updates a new shipping price. - -Requires one of the following permissions: MANAGE_SHIPPING. -""" -type ShippingPriceUpdate { - """ - A shipping zone to which the shipping method belongs. - """ - shippingZone: ShippingZone - shippingMethod: ShippingMethodType - shippingErrors: [ShippingError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ShippingError!]! -} - -""" -Creates/updates translations for a shipping method. - -Requires one of the following permissions: MANAGE_TRANSLATIONS. -""" -type ShippingPriceTranslate { - translationErrors: [TranslationError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [TranslationError!]! - shippingMethod: ShippingMethodType -} - -input ShippingPriceTranslationInput { - name: String - - """ - Translated shipping method description. - - Rich text format. For reference see https://editorjs.io/ - """ - description: JSONString -} - -""" -Exclude products from shipping price. - -Requires one of the following permissions: MANAGE_SHIPPING. -""" -type ShippingPriceExcludeProducts { - """ - A shipping method with new list of excluded products. - """ - shippingMethod: ShippingMethodType - shippingErrors: [ShippingError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ShippingError!]! -} - -input ShippingPriceExcludeProductsInput { - """ - List of products which will be excluded. - """ - products: [ID!]! -} - -""" -Remove product from excluded list for shipping price. - -Requires one of the following permissions: MANAGE_SHIPPING. -""" -type ShippingPriceRemoveProductFromExclude { - """ - A shipping method with new list of excluded products. - """ - shippingMethod: ShippingMethodType - shippingErrors: [ShippingError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ShippingError!]! -} - -""" -Creates a new shipping zone. - -Requires one of the following permissions: MANAGE_SHIPPING. -""" -type ShippingZoneCreate { - shippingErrors: [ShippingError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ShippingError!]! - shippingZone: ShippingZone -} - -input ShippingZoneCreateInput { - """ - Shipping zone's name. Visible only to the staff. - """ - name: String - - """ - Description of the shipping zone. - """ - description: String - - """ - List of countries in this shipping zone. - """ - countries: [String!] - - """ - Default shipping zone will be used for countries not covered by other zones. - """ - default: Boolean - - """ - List of warehouses to assign to a shipping zone - """ - addWarehouses: [ID!] - - """ - List of channels to assign to the shipping zone. - """ - addChannels: [ID!] -} - -""" -Deletes a shipping zone. - -Requires one of the following permissions: MANAGE_SHIPPING. -""" -type ShippingZoneDelete { - shippingErrors: [ShippingError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ShippingError!]! - shippingZone: ShippingZone -} - -""" -Deletes shipping zones. - -Requires one of the following permissions: MANAGE_SHIPPING. -""" -type ShippingZoneBulkDelete { - """ - Returns how many objects were affected. - """ - count: Int! - shippingErrors: [ShippingError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ShippingError!]! -} - -""" -Updates a new shipping zone. - -Requires one of the following permissions: MANAGE_SHIPPING. -""" -type ShippingZoneUpdate { - shippingErrors: [ShippingError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ShippingError!]! - shippingZone: ShippingZone -} - -input ShippingZoneUpdateInput { - """ - Shipping zone's name. Visible only to the staff. - """ - name: String - - """ - Description of the shipping zone. - """ - description: String - - """ - List of countries in this shipping zone. - """ - countries: [String!] - - """ - Default shipping zone will be used for countries not covered by other zones. - """ - default: Boolean - - """ - List of warehouses to assign to a shipping zone - """ - addWarehouses: [ID!] - - """ - List of channels to assign to the shipping zone. - """ - addChannels: [ID!] - - """ - List of warehouses to unassign from a shipping zone - """ - removeWarehouses: [ID!] - - """ - List of channels to unassign from the shipping zone. - """ - removeChannels: [ID!] -} - -""" -Assign attributes to a given product type. - -Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. -""" -type ProductAttributeAssign { - """ - The updated product type. - """ - productType: ProductType - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! -} - -type ProductError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: ProductErrorCode! - - """ - List of attributes IDs which causes the error. - """ - attributes: [ID!] - - """ - List of attribute values IDs which causes the error. - """ - values: [ID!] -} - -""" -An enumeration. -""" -enum ProductErrorCode { - ALREADY_EXISTS - ATTRIBUTE_ALREADY_ASSIGNED - ATTRIBUTE_CANNOT_BE_ASSIGNED - ATTRIBUTE_VARIANTS_DISABLED - MEDIA_ALREADY_ASSIGNED - DUPLICATED_INPUT_ITEM - GRAPHQL_ERROR - INVALID - PRODUCT_WITHOUT_CATEGORY - NOT_PRODUCTS_IMAGE - NOT_PRODUCTS_VARIANT - NOT_FOUND - REQUIRED - UNIQUE - VARIANT_NO_DIGITAL_CONTENT - CANNOT_MANAGE_PRODUCT_WITHOUT_VARIANT - PRODUCT_NOT_ASSIGNED_TO_CHANNEL - UNSUPPORTED_MEDIA_PROVIDER - PREORDER_VARIANT_CANNOT_BE_DEACTIVATED -} - -input ProductAttributeAssignInput { - """ - The ID of the attribute to assign. - """ - id: ID! - - """ - The attribute type to be assigned as. - """ - type: ProductAttributeType! - - """ - Whether attribute is allowed in variant selection. Allowed types are: ['dropdown', 'boolean', 'swatch', 'numeric']. - - Added in Saleor 3.1. - """ - variantSelection: Boolean -} - -enum ProductAttributeType { - PRODUCT - VARIANT -} - -""" -Update attributes assigned to product variant for given product type. - -Added in Saleor 3.1. - -Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. -""" -type ProductAttributeAssignmentUpdate { - """ - The updated product type. - """ - productType: ProductType - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! -} - -input ProductAttributeAssignmentUpdateInput { - """ - The ID of the attribute to assign. - """ - id: ID! - - """ - Whether attribute is allowed in variant selection. Allowed types are: ['dropdown', 'boolean', 'swatch', 'numeric']. - - Added in Saleor 3.1. - """ - variantSelection: Boolean! -} - -""" -Un-assign attributes from a given product type. - -Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. -""" -type ProductAttributeUnassign { - """ - The updated product type. - """ - productType: ProductType - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! -} - -""" -Creates a new category. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type CategoryCreate { - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! - category: Category -} - -input CategoryInput { - """ - Category description. - - Rich text format. For reference see https://editorjs.io/ - """ - description: JSONString - - """ - Category name. - """ - name: String - - """ - Category slug. - """ - slug: String - - """ - Search engine optimization fields. - """ - seo: SeoInput - - """ - Background image file. - """ - backgroundImage: Upload - - """ - Alt text for a product media. - """ - backgroundImageAlt: String -} - -input SeoInput { - """ - SEO title. - """ - title: String - - """ - SEO description. - """ - description: String -} - -""" -Variables of this type must be set to null in mutations. They will be replaced with a filename from a following multipart part containing a binary file. See: https://github.com/jaydenseric/graphql-multipart-request-spec. -""" -scalar Upload - -""" -Deletes a category. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type CategoryDelete { - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! - category: Category -} - -""" -Deletes categories. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type CategoryBulkDelete { - """ - Returns how many objects were affected. - """ - count: Int! - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! -} - -""" -Updates a category. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type CategoryUpdate { - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! - category: Category -} - -""" -Creates/updates translations for a category. - -Requires one of the following permissions: MANAGE_TRANSLATIONS. -""" -type CategoryTranslate { - translationErrors: [TranslationError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [TranslationError!]! - category: Category -} - -input TranslationInput { - seoTitle: String - seoDescription: String - name: String - - """ - Translated description. - - Rich text format. For reference see https://editorjs.io/ - """ - description: JSONString -} - -""" -Adds products to a collection. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type CollectionAddProducts { - """ - Collection to which products will be added. - """ - collection: Collection - collectionErrors: [CollectionError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [CollectionError!]! -} - -type CollectionError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - List of products IDs which causes the error. - """ - products: [ID!] - - """ - The error code. - """ - code: CollectionErrorCode! -} - -""" -An enumeration. -""" -enum CollectionErrorCode { - DUPLICATED_INPUT_ITEM - GRAPHQL_ERROR - INVALID - NOT_FOUND - REQUIRED - UNIQUE - CANNOT_MANAGE_PRODUCT_WITHOUT_VARIANT -} - -""" -Creates a new collection. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type CollectionCreate { - collectionErrors: [CollectionError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [CollectionError!]! - collection: Collection -} - -input CollectionCreateInput { - """ - Informs whether a collection is published. - """ - isPublished: Boolean - - """ - Name of the collection. - """ - name: String - - """ - Slug of the collection. - """ - slug: String - - """ - Description of the collection. - - Rich text format. For reference see https://editorjs.io/ - """ - description: JSONString - - """ - Background image file. - """ - backgroundImage: Upload - - """ - Alt text for an image. - """ - backgroundImageAlt: String - - """ - Search engine optimization fields. - """ - seo: SeoInput - - """ - Publication date. ISO 8601 standard. - - DEPRECATED: this field will be removed in Saleor 4.0. - """ - publicationDate: Date - - """ - List of products to be added to the collection. - """ - products: [ID!] -} - -""" -Deletes a collection. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type CollectionDelete { - collectionErrors: [CollectionError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [CollectionError!]! - collection: Collection -} - -""" -Reorder the products of a collection. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type CollectionReorderProducts { - """ - Collection from which products are reordered. - """ - collection: Collection - collectionErrors: [CollectionError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [CollectionError!]! -} - -input MoveProductInput { - """ - The ID of the product to move. - """ - productId: ID! - - """ - The relative sorting position of the product (from -inf to +inf) starting from the first given product's actual position.1 moves the item one position forward, -1 moves the item one position backward, 0 leaves the item unchanged. - """ - sortOrder: Int -} - -""" -Deletes collections. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type CollectionBulkDelete { - """ - Returns how many objects were affected. - """ - count: Int! - collectionErrors: [CollectionError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [CollectionError!]! -} - -""" -Remove products from a collection. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type CollectionRemoveProducts { - """ - Collection from which products will be removed. - """ - collection: Collection - collectionErrors: [CollectionError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [CollectionError!]! -} - -""" -Updates a collection. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type CollectionUpdate { - collectionErrors: [CollectionError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [CollectionError!]! - collection: Collection -} - -input CollectionInput { - """ - Informs whether a collection is published. - """ - isPublished: Boolean - - """ - Name of the collection. - """ - name: String - - """ - Slug of the collection. - """ - slug: String - - """ - Description of the collection. - - Rich text format. For reference see https://editorjs.io/ - """ - description: JSONString - - """ - Background image file. - """ - backgroundImage: Upload - - """ - Alt text for an image. - """ - backgroundImageAlt: String - - """ - Search engine optimization fields. - """ - seo: SeoInput - - """ - Publication date. ISO 8601 standard. - - DEPRECATED: this field will be removed in Saleor 4.0. - """ - publicationDate: Date -} - -""" -Creates/updates translations for a collection. - -Requires one of the following permissions: MANAGE_TRANSLATIONS. -""" -type CollectionTranslate { - translationErrors: [TranslationError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [TranslationError!]! - collection: Collection -} - -""" -Manage collection's availability in channels. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type CollectionChannelListingUpdate { - """ - An updated collection instance. - """ - collection: Collection - collectionChannelListingErrors: [CollectionChannelListingError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [CollectionChannelListingError!]! -} - -type CollectionChannelListingError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: ProductErrorCode! - - """ - List of attributes IDs which causes the error. - """ - attributes: [ID!] - - """ - List of attribute values IDs which causes the error. - """ - values: [ID!] - - """ - List of channels IDs which causes the error. - """ - channels: [ID!] -} - -input CollectionChannelListingUpdateInput { - """ - List of channels to which the collection should be assigned. - """ - addChannels: [PublishableChannelListingInput!] - - """ - List of channels from which the collection should be unassigned. - """ - removeChannels: [ID!] -} - -input PublishableChannelListingInput { - """ - ID of a channel. - """ - channelId: ID! - - """ - Determines if object is visible to customers. - """ - isPublished: Boolean - - """ - Publication date. ISO 8601 standard. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `publishedAt` field instead. - """ - publicationDate: Date - - """ - Publication date time. ISO 8601 standard. - - Added in Saleor 3.3. - """ - publishedAt: DateTime -} - -""" -Creates a new product. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductCreate { - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! - product: Product -} - -input ProductCreateInput { - """ - List of attributes. - """ - attributes: [AttributeValueInput!] - - """ - ID of the product's category. - """ - category: ID - - """ - Determine if taxes are being charged for the product. - """ - chargeTaxes: Boolean - - """ - List of IDs of collections that the product belongs to. - """ - collections: [ID!] - - """ - Product description. - - Rich text format. For reference see https://editorjs.io/ - """ - description: JSONString - - """ - Product name. - """ - name: String - - """ - Product slug. - """ - slug: String - - """ - Tax rate for enabled tax gateway. - """ - taxCode: String - - """ - Search engine optimization fields. - """ - seo: SeoInput - - """ - Weight of the Product. - """ - weight: WeightScalar - - """ - Defines the product rating value. - """ - rating: Float - - """ - ID of the type that product belongs to. - """ - productType: ID! -} - -input AttributeValueInput { - """ - ID of the selected attribute. - """ - id: ID - - """ - The value or slug of an attribute to resolve. If the passed value is non-existent, it will be created. - """ - values: [String!] - - """ - URL of the file attribute. Every time, a new value is created. - """ - file: String - - """ - File content type. - """ - contentType: String - - """ - List of entity IDs that will be used as references. - """ - references: [ID!] - - """ - Text content in JSON format. - """ - richText: JSONString - - """ - Represents the boolean value of the attribute value. - """ - boolean: Boolean - - """ - Represents the date value of the attribute value. - """ - date: Date - - """ - Represents the date/time value of the attribute value. - """ - dateTime: DateTime -} - -""" -Deletes a product. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductDelete { - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! - product: Product -} - -""" -Deletes products. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductBulkDelete { - """ - Returns how many objects were affected. - """ - count: Int! - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! -} - -""" -Updates an existing product. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductUpdate { - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! - product: Product -} - -input ProductInput { - """ - List of attributes. - """ - attributes: [AttributeValueInput!] - - """ - ID of the product's category. - """ - category: ID - - """ - Determine if taxes are being charged for the product. - """ - chargeTaxes: Boolean - - """ - List of IDs of collections that the product belongs to. - """ - collections: [ID!] - - """ - Product description. - - Rich text format. For reference see https://editorjs.io/ - """ - description: JSONString - - """ - Product name. - """ - name: String - - """ - Product slug. - """ - slug: String - - """ - Tax rate for enabled tax gateway. - """ - taxCode: String - - """ - Search engine optimization fields. - """ - seo: SeoInput - - """ - Weight of the Product. - """ - weight: WeightScalar - - """ - Defines the product rating value. - """ - rating: Float -} - -""" -Creates/updates translations for a product. - -Requires one of the following permissions: MANAGE_TRANSLATIONS. -""" -type ProductTranslate { - translationErrors: [TranslationError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [TranslationError!]! - product: Product -} - -""" -Manage product's availability in channels. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductChannelListingUpdate { - """ - An updated product instance. - """ - product: Product - productChannelListingErrors: [ProductChannelListingError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductChannelListingError!]! -} - -type ProductChannelListingError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: ProductErrorCode! - - """ - List of attributes IDs which causes the error. - """ - attributes: [ID!] - - """ - List of attribute values IDs which causes the error. - """ - values: [ID!] - - """ - List of channels IDs which causes the error. - """ - channels: [ID!] - - """ - List of variants IDs which causes the error. - """ - variants: [ID!] -} - -input ProductChannelListingUpdateInput { - """ - List of channels to which the product should be assigned or updated. - """ - updateChannels: [ProductChannelListingAddInput!] - - """ - List of channels from which the product should be unassigned. - """ - removeChannels: [ID!] -} - -input ProductChannelListingAddInput { - """ - ID of a channel. - """ - channelId: ID! - - """ - Determines if object is visible to customers. - """ - isPublished: Boolean - - """ - Publication date. ISO 8601 standard. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `publishedAt` field instead. - """ - publicationDate: Date - - """ - Publication date time. ISO 8601 standard. - - Added in Saleor 3.3. - """ - publishedAt: DateTime - - """ - Determines if product is visible in product listings (doesn't apply to product collections). - """ - visibleInListings: Boolean - - """ - Determine if product should be available for purchase. - """ - isAvailableForPurchase: Boolean - - """ - A start date from which a product will be available for purchase. When not set and isAvailable is set to True, the current day is assumed. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `availableForPurchaseAt` field instead. - """ - availableForPurchaseDate: Date - - """ - A start date time from which a product will be available for purchase. When not set and `isAvailable` is set to True, the current day is assumed. - - Added in Saleor 3.3. - """ - availableForPurchaseAt: DateTime - - """ - List of variants to which the channel should be assigned. - """ - addVariants: [ID!] - - """ - List of variants from which the channel should be unassigned. - """ - removeVariants: [ID!] -} - -""" -Create a media object (image or video URL) associated with product. For image, this mutation must be sent as a `multipart` request. More detailed specs of the upload format can be found here: https://github.com/jaydenseric/graphql-multipart-request-spec - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductMediaCreate { - product: Product - media: ProductMedia - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! -} - -input ProductMediaCreateInput { - """ - Alt text for a product media. - """ - alt: String - - """ - Represents an image file in a multipart request. - """ - image: Upload - - """ - ID of an product. - """ - product: ID! - - """ - Represents an URL to an external media. - """ - mediaUrl: String -} - -""" -Reorder the variants of a product. Mutation updates updated_at on product and triggers PRODUCT_UPDATED webhook. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductVariantReorder { - product: Product - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! -} - -input ReorderInput { - """ - The ID of the item to move. - """ - id: ID! - - """ - The new relative sorting position of the item (from -inf to +inf). 1 moves the item one position forward, -1 moves the item one position backward, 0 leaves the item unchanged. - """ - sortOrder: Int -} - -""" -Deletes a product media. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductMediaDelete { - product: Product - media: ProductMedia - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! -} - -""" -Deletes product media. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductMediaBulkDelete { - """ - Returns how many objects were affected. - """ - count: Int! - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! -} - -""" -Changes ordering of the product media. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductMediaReorder { - product: Product - media: [ProductMedia!] - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! -} - -""" -Updates a product media. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductMediaUpdate { - product: Product - media: ProductMedia - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! -} - -input ProductMediaUpdateInput { - """ - Alt text for a product media. - """ - alt: String -} - -""" -Creates a new product type. - -Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. -""" -type ProductTypeCreate { - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! - productType: ProductType -} - -input ProductTypeInput { - """ - Name of the product type. - """ - name: String - - """ - Product type slug. - """ - slug: String - - """ - The product type kind. - """ - kind: ProductTypeKindEnum - - """ - Determines if product of this type has multiple variants. This option mainly simplifies product management in the dashboard. There is always at least one variant created under the hood. - """ - hasVariants: Boolean - - """ - List of attributes shared among all product variants. - """ - productAttributes: [ID!] - - """ - List of attributes used to distinguish between different variants of a product. - """ - variantAttributes: [ID!] - - """ - Determines if shipping is required for products of this variant. - """ - isShippingRequired: Boolean - - """ - Determines if products are digital. - """ - isDigital: Boolean - - """ - Weight of the ProductType items. - """ - weight: WeightScalar - - """ - Tax rate for enabled tax gateway. - """ - taxCode: String -} - -""" -Deletes a product type. - -Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. -""" -type ProductTypeDelete { - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! - productType: ProductType -} - -""" -Deletes product types. - -Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. -""" -type ProductTypeBulkDelete { - """ - Returns how many objects were affected. - """ - count: Int! - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! -} - -""" -Updates an existing product type. - -Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. -""" -type ProductTypeUpdate { - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! - productType: ProductType -} - -""" -Reorder the attributes of a product type. - -Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. -""" -type ProductTypeReorderAttributes { - """ - Product type from which attributes are reordered. - """ - productType: ProductType - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! -} - -""" -Reorder product attribute values. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductReorderAttributeValues { - """ - Product from which attribute values are reordered. - """ - product: Product - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! -} - -""" -Create new digital content. This mutation must be sent as a `multipart` request. More detailed specs of the upload format can be found here: https://github.com/jaydenseric/graphql-multipart-request-spec - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type DigitalContentCreate { - variant: ProductVariant - content: DigitalContent - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! -} - -input DigitalContentUploadInput { - """ - Use default digital content settings for this product. - """ - useDefaultSettings: Boolean! - - """ - Determines how many times a download link can be accessed by a customer. - """ - maxDownloads: Int - - """ - Determines for how many days a download link is active since it was generated. - """ - urlValidDays: Int - - """ - Overwrite default automatic_fulfillment setting for variant. - """ - automaticFulfillment: Boolean - - """ - Represents an file in a multipart request. - """ - contentFile: Upload! -} - -""" -Remove digital content assigned to given variant. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type DigitalContentDelete { - variant: ProductVariant - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! -} - -""" -Update digital content. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type DigitalContentUpdate { - variant: ProductVariant - content: DigitalContent - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! -} - -input DigitalContentInput { - """ - Use default digital content settings for this product. - """ - useDefaultSettings: Boolean! - - """ - Determines how many times a download link can be accessed by a customer. - """ - maxDownloads: Int - - """ - Determines for how many days a download link is active since it was generated. - """ - urlValidDays: Int - - """ - Overwrite default automatic_fulfillment setting for variant. - """ - automaticFulfillment: Boolean -} - -""" -Generate new URL to digital content. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type DigitalContentUrlCreate { - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! - digitalContentUrl: DigitalContentUrl -} - -input DigitalContentUrlCreateInput { - """ - Digital content ID which URL will belong to. - """ - content: ID! -} - -""" -Creates a new variant for a product. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductVariantCreate { - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! - productVariant: ProductVariant -} - -input ProductVariantCreateInput { - """ - List of attributes specific to this variant. - """ - attributes: [AttributeValueInput!]! - - """ - Stock keeping unit. - """ - sku: String - - """ - Determines if the inventory of this variant should be tracked. If false, the quantity won't change when customers buy this item. - """ - trackInventory: Boolean - - """ - Weight of the Product Variant. - """ - weight: WeightScalar - - """ - Determines if variant is in preorder. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - preorder: PreorderSettingsInput - - """ - Determines maximum quantity of `ProductVariant`,that can be bought in a single checkout. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - quantityLimitPerCustomer: Int - - """ - Product ID of which type is the variant. - """ - product: ID! - - """ - Stocks of a product available for sale. - """ - stocks: [StockInput!] -} - -input PreorderSettingsInput { - """ - The global threshold for preorder variant. - """ - globalThreshold: Int - - """ - The end date for preorder. - """ - endDate: DateTime -} - -input StockInput { - """ - Warehouse in which stock is located. - """ - warehouse: ID! - - """ - Quantity of items available for sell. - """ - quantity: Int! -} - -""" -Deletes a product variant. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductVariantDelete { - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! - productVariant: ProductVariant -} - -""" -Creates product variants for a given product. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductVariantBulkCreate { - """ - Returns how many objects were created. - """ - count: Int! - - """ - List of the created variants. - """ - productVariants: [ProductVariant!]! - bulkProductErrors: [BulkProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [BulkProductError!]! -} - -type BulkProductError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: ProductErrorCode! - - """ - List of attributes IDs which causes the error. - """ - attributes: [ID!] - - """ - List of attribute values IDs which causes the error. - """ - values: [ID!] - - """ - Index of an input list item that caused the error. - """ - index: Int - - """ - List of warehouse IDs which causes the error. - """ - warehouses: [ID!] - - """ - List of channel IDs which causes the error. - """ - channels: [ID!] -} - -input ProductVariantBulkCreateInput { - """ - List of attributes specific to this variant. - """ - attributes: [BulkAttributeValueInput!]! - - """ - Stock keeping unit. - """ - sku: String - - """ - Determines if the inventory of this variant should be tracked. If false, the quantity won't change when customers buy this item. - """ - trackInventory: Boolean - - """ - Weight of the Product Variant. - """ - weight: WeightScalar - - """ - Determines if variant is in preorder. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - preorder: PreorderSettingsInput - - """ - Determines maximum quantity of `ProductVariant`,that can be bought in a single checkout. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - quantityLimitPerCustomer: Int - - """ - Stocks of a product available for sale. - """ - stocks: [StockInput!] - - """ - List of prices assigned to channels. - """ - channelListings: [ProductVariantChannelListingAddInput!] -} - -input BulkAttributeValueInput { - """ - ID of the selected attribute. - """ - id: ID - - """ - The value or slug of an attribute to resolve. If the passed value is non-existent, it will be created. - """ - values: [String!] - - """ - The boolean value of an attribute to resolve. If the passed value is non-existent, it will be created. - """ - boolean: Boolean -} - -input ProductVariantChannelListingAddInput { - """ - ID of a channel. - """ - channelId: ID! - - """ - Price of the particular variant in channel. - """ - price: PositiveDecimal! - - """ - Cost price of the variant in channel. - """ - costPrice: PositiveDecimal - - """ - The threshold for preorder variant in channel. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - preorderThreshold: Int -} - -""" -Deletes product variants. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductVariantBulkDelete { - """ - Returns how many objects were affected. - """ - count: Int! - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! -} - -""" -Creates stocks for product variant. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductVariantStocksCreate { - """ - Updated product variant. - """ - productVariant: ProductVariant - bulkStockErrors: [BulkStockError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [BulkStockError!]! -} - -type BulkStockError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: ProductErrorCode! - - """ - List of attributes IDs which causes the error. - """ - attributes: [ID!] - - """ - List of attribute values IDs which causes the error. - """ - values: [ID!] - - """ - Index of an input list item that caused the error. - """ - index: Int -} - -""" -Delete stocks from product variant. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductVariantStocksDelete { - """ - Updated product variant. - """ - productVariant: ProductVariant - stockErrors: [StockError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [StockError!]! -} - -type StockError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: StockErrorCode! -} - -""" -An enumeration. -""" -enum StockErrorCode { - ALREADY_EXISTS - GRAPHQL_ERROR - INVALID - NOT_FOUND - REQUIRED - UNIQUE -} - -""" -Update stocks for product variant. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductVariantStocksUpdate { - """ - Updated product variant. - """ - productVariant: ProductVariant - bulkStockErrors: [BulkStockError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [BulkStockError!]! -} - -""" -Updates an existing variant for product. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductVariantUpdate { - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! - productVariant: ProductVariant -} - -input ProductVariantInput { - """ - List of attributes specific to this variant. - """ - attributes: [AttributeValueInput!] - - """ - Stock keeping unit. - """ - sku: String - - """ - Determines if the inventory of this variant should be tracked. If false, the quantity won't change when customers buy this item. - """ - trackInventory: Boolean - - """ - Weight of the Product Variant. - """ - weight: WeightScalar - - """ - Determines if variant is in preorder. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - preorder: PreorderSettingsInput - - """ - Determines maximum quantity of `ProductVariant`,that can be bought in a single checkout. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - quantityLimitPerCustomer: Int -} - -""" -Set default variant for a product. Mutation triggers PRODUCT_UPDATED webhook. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductVariantSetDefault { - product: Product - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! -} - -""" -Creates/updates translations for a product variant. - -Requires one of the following permissions: MANAGE_TRANSLATIONS. -""" -type ProductVariantTranslate { - translationErrors: [TranslationError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [TranslationError!]! - productVariant: ProductVariant -} - -input NameTranslationInput { - name: String -} - -""" -Manage product variant prices in channels. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductVariantChannelListingUpdate { - """ - An updated product variant instance. - """ - variant: ProductVariant - productChannelListingErrors: [ProductChannelListingError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductChannelListingError!]! -} - -""" -Reorder product variant attribute values. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductVariantReorderAttributeValues { - """ - Product variant from which attribute values are reordered. - """ - productVariant: ProductVariant - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! -} - -""" -Deactivates product variant preorder. It changes all preorder allocation into regular allocation. - -Added in Saleor 3.1. - -Note: this API is currently in Feature Preview and can be subject to changes at later point. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ProductVariantPreorderDeactivate { - """ - Product variant with ended preorder. - """ - productVariant: ProductVariant - errors: [ProductError!]! -} - -""" -Assign an media to a product variant. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type VariantMediaAssign { - productVariant: ProductVariant - media: ProductMedia - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! -} - -""" -Unassign an media from a product variant. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type VariantMediaUnassign { - productVariant: ProductVariant - media: ProductMedia - productErrors: [ProductError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ProductError!]! -} - -""" -Captures the authorized payment amount. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type PaymentCapture { - """ - Updated payment. - """ - payment: Payment - paymentErrors: [PaymentError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PaymentError!]! -} - -type PaymentError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: PaymentErrorCode! - - """ - List of varint IDs which causes the error. - """ - variants: [ID!] -} - -""" -An enumeration. -""" -enum PaymentErrorCode { - BILLING_ADDRESS_NOT_SET - GRAPHQL_ERROR - INVALID - NOT_FOUND - REQUIRED - UNIQUE - PARTIAL_PAYMENT_NOT_ALLOWED - SHIPPING_ADDRESS_NOT_SET - INVALID_SHIPPING_METHOD - SHIPPING_METHOD_NOT_SET - PAYMENT_ERROR - NOT_SUPPORTED_GATEWAY - CHANNEL_INACTIVE - BALANCE_CHECK_ERROR - CHECKOUT_EMAIL_NOT_SET - UNAVAILABLE_VARIANT_IN_CHANNEL - NO_CHECKOUT_LINES -} - -""" -Refunds the captured payment amount. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type PaymentRefund { - """ - Updated payment. - """ - payment: Payment - paymentErrors: [PaymentError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PaymentError!]! -} - -""" -Voids the authorized payment. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type PaymentVoid { - """ - Updated payment. - """ - payment: Payment - paymentErrors: [PaymentError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PaymentError!]! -} - -""" -Initializes payment process when it is required by gateway. -""" -type PaymentInitialize { - initializedPayment: PaymentInitialized - paymentErrors: [PaymentError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PaymentError!]! -} - -""" -Server-side data generated by a payment gateway. Optional step when the payment provider requires an additional action to initialize payment session. -""" -type PaymentInitialized { - """ - ID of a payment gateway. - """ - gateway: String! - - """ - Payment gateway name. - """ - name: String! - - """ - Initialized data by gateway. - """ - data: JSONString -} - -""" -Check payment balance. -""" -type PaymentCheckBalance { - """ - Response from the gateway. - """ - data: JSONString - paymentErrors: [PaymentError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PaymentError!]! -} - -input PaymentCheckBalanceInput { - """ - An ID of a payment gateway to check. - """ - gatewayId: String! - - """ - Payment method name. - """ - method: String! - - """ - Slug of a channel for which the data should be returned. - """ - channel: String! - - """ - Information about card. - """ - card: CardInput! -} - -input CardInput { - """ - Payment method nonce, a token returned by the appropriate provider's SDK. - """ - code: String! - - """ - Card security code. - """ - cvc: String - - """ - Information about currency and amount. - """ - money: MoneyInput! -} - -input MoneyInput { - """ - Currency code. - """ - currency: String! - - """ - Amount of money. - """ - amount: PositiveDecimal! -} - -""" -Create transaction for checkout or order. Requires the following permissions: AUTHENTICATED_APP and HANDLE_PAYMENTS. - -Added in Saleor 3.4. - -Note: this API is currently in Feature Preview and can be subject to changes at later point. -""" -type TransactionCreate { - transaction: TransactionItem - errors: [TransactionCreateError!]! -} - -type TransactionCreateError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: TransactionCreateErrorCode! -} - -""" -An enumeration. -""" -enum TransactionCreateErrorCode { - INVALID - GRAPHQL_ERROR - NOT_FOUND - INCORRECT_CURRENCY - METADATA_KEY_REQUIRED -} - -input TransactionCreateInput { - """ - Status of the transaction. - """ - status: String! - - """ - Payment type used for this transaction. - """ - type: String! - - """ - Reference of the transaction. - """ - reference: String - - """ - List of all possible actions for the transaction - """ - availableActions: [TransactionActionEnum!] - - """ - Amount authorized by this transaction. - """ - amountAuthorized: MoneyInput - - """ - Amount charged by this transaction. - """ - amountCharged: MoneyInput - - """ - Amount refunded by this transaction. - """ - amountRefunded: MoneyInput - - """ - Amount voided by this transaction. - """ - amountVoided: MoneyInput - - """ - Payment public metadata. - """ - metadata: [MetadataInput!] - - """ - Payment private metadata. - """ - privateMetadata: [MetadataInput!] -} - -input MetadataInput { - """ - Key of a metadata item. - """ - key: String! - - """ - Value of a metadata item. - """ - value: String! -} - -input TransactionEventInput { - """ - Current status of the payment transaction. - """ - status: TransactionStatus! - - """ - Reference of the transaction. - """ - reference: String - - """ - Name of the transaction. - """ - name: String -} - -""" -Create transaction for checkout or order. Requires the following permissions: AUTHENTICATED_APP and HANDLE_PAYMENTS. - -Added in Saleor 3.4. - -Note: this API is currently in Feature Preview and can be subject to changes at later point. -""" -type TransactionUpdate { - transaction: TransactionItem - errors: [TransactionUpdateError!]! -} - -type TransactionUpdateError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: TransactionUpdateErrorCode! -} - -""" -An enumeration. -""" -enum TransactionUpdateErrorCode { - INVALID - GRAPHQL_ERROR - NOT_FOUND - INCORRECT_CURRENCY - METADATA_KEY_REQUIRED -} - -input TransactionUpdateInput { - """ - Status of the transaction. - """ - status: String - - """ - Payment type used for this transaction. - """ - type: String - - """ - Reference of the transaction. - """ - reference: String - - """ - List of all possible actions for the transaction - """ - availableActions: [TransactionActionEnum!] - - """ - Amount authorized by this transaction. - """ - amountAuthorized: MoneyInput - - """ - Amount charged by this transaction. - """ - amountCharged: MoneyInput - - """ - Amount refunded by this transaction. - """ - amountRefunded: MoneyInput - - """ - Amount voided by this transaction. - """ - amountVoided: MoneyInput - - """ - Payment public metadata. - """ - metadata: [MetadataInput!] - - """ - Payment private metadata. - """ - privateMetadata: [MetadataInput!] -} - -""" -Request an action for payment transaction. - -Added in Saleor 3.4. - -Note: this API is currently in Feature Preview and can be subject to changes at later point. - -Requires one of the following permissions: HANDLE_PAYMENTS, MANAGE_ORDERS. -""" -type TransactionRequestAction { - transaction: TransactionItem - errors: [TransactionRequestActionError!]! -} - -type TransactionRequestActionError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: TransactionRequestActionErrorCode! -} - -""" -An enumeration. -""" -enum TransactionRequestActionErrorCode { - INVALID - GRAPHQL_ERROR - NOT_FOUND - MISSING_TRANSACTION_ACTION_REQUEST_WEBHOOK -} - -""" -Creates a new page. - -Requires one of the following permissions: MANAGE_PAGES. -""" -type PageCreate { - pageErrors: [PageError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PageError!]! - page: Page -} - -type PageError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: PageErrorCode! - - """ - List of attributes IDs which causes the error. - """ - attributes: [ID!] - - """ - List of attribute values IDs which causes the error. - """ - values: [ID!] -} - -""" -An enumeration. -""" -enum PageErrorCode { - GRAPHQL_ERROR - INVALID - NOT_FOUND - REQUIRED - UNIQUE - DUPLICATED_INPUT_ITEM - ATTRIBUTE_ALREADY_ASSIGNED -} - -input PageCreateInput { - """ - Page internal name. - """ - slug: String - - """ - Page title. - """ - title: String - - """ - Page content. - - Rich text format. For reference see https://editorjs.io/ - """ - content: JSONString - - """ - List of attributes. - """ - attributes: [AttributeValueInput!] - - """ - Determines if page is visible in the storefront. - """ - isPublished: Boolean - - """ - Publication date. ISO 8601 standard. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `publishedAt` field instead. - """ - publicationDate: String - - """ - Publication date time. ISO 8601 standard. - - Added in Saleor 3.3. - """ - publishedAt: DateTime - - """ - Search engine optimization fields. - """ - seo: SeoInput - - """ - ID of the page type that page belongs to. - """ - pageType: ID! -} - -""" -Deletes a page. - -Requires one of the following permissions: MANAGE_PAGES. -""" -type PageDelete { - pageErrors: [PageError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PageError!]! - page: Page -} - -""" -Deletes pages. - -Requires one of the following permissions: MANAGE_PAGES. -""" -type PageBulkDelete { - """ - Returns how many objects were affected. - """ - count: Int! - pageErrors: [PageError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PageError!]! -} - -""" -Publish pages. - -Requires one of the following permissions: MANAGE_PAGES. -""" -type PageBulkPublish { - """ - Returns how many objects were affected. - """ - count: Int! - pageErrors: [PageError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PageError!]! -} - -""" -Updates an existing page. - -Requires one of the following permissions: MANAGE_PAGES. -""" -type PageUpdate { - pageErrors: [PageError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PageError!]! - page: Page -} - -input PageInput { - """ - Page internal name. - """ - slug: String - - """ - Page title. - """ - title: String - - """ - Page content. - - Rich text format. For reference see https://editorjs.io/ - """ - content: JSONString - - """ - List of attributes. - """ - attributes: [AttributeValueInput!] - - """ - Determines if page is visible in the storefront. - """ - isPublished: Boolean - - """ - Publication date. ISO 8601 standard. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `publishedAt` field instead. - """ - publicationDate: String - - """ - Publication date time. ISO 8601 standard. - - Added in Saleor 3.3. - """ - publishedAt: DateTime - - """ - Search engine optimization fields. - """ - seo: SeoInput -} - -""" -Creates/updates translations for a page. - -Requires one of the following permissions: MANAGE_TRANSLATIONS. -""" -type PageTranslate { - translationErrors: [TranslationError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [TranslationError!]! - page: PageTranslatableContent -} - -input PageTranslationInput { - seoTitle: String - seoDescription: String - title: String - - """ - Translated page content. - - Rich text format. For reference see https://editorjs.io/ - """ - content: JSONString -} - -""" -Create a new page type. - -Requires one of the following permissions: MANAGE_PAGE_TYPES_AND_ATTRIBUTES. -""" -type PageTypeCreate { - pageErrors: [PageError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PageError!]! - pageType: PageType -} - -input PageTypeCreateInput { - """ - Name of the page type. - """ - name: String - - """ - Page type slug. - """ - slug: String - - """ - List of attribute IDs to be assigned to the page type. - """ - addAttributes: [ID!] -} - -""" -Update page type. - -Requires one of the following permissions: MANAGE_PAGE_TYPES_AND_ATTRIBUTES. -""" -type PageTypeUpdate { - pageErrors: [PageError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PageError!]! - pageType: PageType -} - -input PageTypeUpdateInput { - """ - Name of the page type. - """ - name: String - - """ - Page type slug. - """ - slug: String - - """ - List of attribute IDs to be assigned to the page type. - """ - addAttributes: [ID!] - - """ - List of attribute IDs to be assigned to the page type. - """ - removeAttributes: [ID!] -} - -""" -Delete a page type. - -Requires one of the following permissions: MANAGE_PAGE_TYPES_AND_ATTRIBUTES. -""" -type PageTypeDelete { - pageErrors: [PageError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PageError!]! - pageType: PageType -} - -""" -Delete page types. - -Requires one of the following permissions: MANAGE_PAGE_TYPES_AND_ATTRIBUTES. -""" -type PageTypeBulkDelete { - """ - Returns how many objects were affected. - """ - count: Int! - pageErrors: [PageError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PageError!]! -} - -""" -Assign attributes to a given page type. - -Requires one of the following permissions: MANAGE_PAGE_TYPES_AND_ATTRIBUTES. -""" -type PageAttributeAssign { - """ - The updated page type. - """ - pageType: PageType - pageErrors: [PageError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PageError!]! -} - -""" -Unassign attributes from a given page type. - -Requires one of the following permissions: MANAGE_PAGE_TYPES_AND_ATTRIBUTES. -""" -type PageAttributeUnassign { - """ - The updated page type. - """ - pageType: PageType - pageErrors: [PageError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PageError!]! -} - -""" -Reorder the attributes of a page type. - -Requires one of the following permissions: MANAGE_PAGE_TYPES_AND_ATTRIBUTES. -""" -type PageTypeReorderAttributes { - """ - Page type from which attributes are reordered. - """ - pageType: PageType - pageErrors: [PageError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PageError!]! -} - -""" -Reorder page attribute values. - -Requires one of the following permissions: MANAGE_PAGES. -""" -type PageReorderAttributeValues { - """ - Page from which attribute values are reordered. - """ - page: Page - pageErrors: [PageError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PageError!]! -} - -""" -Completes creating an order. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type DraftOrderComplete { - """ - Completed order. - """ - order: Order - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -""" -Creates a new draft order. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type DraftOrderCreate { - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! - order: Order -} - -input DraftOrderCreateInput { - """ - Billing address of the customer. - """ - billingAddress: AddressInput - - """ - Customer associated with the draft order. - """ - user: ID - - """ - Email address of the customer. - """ - userEmail: String - - """ - Discount amount for the order. - """ - discount: PositiveDecimal - - """ - Shipping address of the customer. - """ - shippingAddress: AddressInput - - """ - ID of a selected shipping method. - """ - shippingMethod: ID - - """ - ID of the voucher associated with the order. - """ - voucher: ID - - """ - A note from a customer. Visible by customers in the order summary. - """ - customerNote: String - - """ - ID of the channel associated with the order. - """ - channelId: ID - - """ - URL of a view where users should be redirected to see the order details. URL in RFC 1808 format. - """ - redirectUrl: String - - """ - Variant line input consisting of variant ID and quantity of products. - """ - lines: [OrderLineCreateInput!] -} - -input OrderLineCreateInput { - """ - Number of variant items ordered. - """ - quantity: Int! - - """ - Product variant ID. - """ - variantId: ID! -} - -""" -Deletes a draft order. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type DraftOrderDelete { - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! - order: Order -} - -""" -Deletes draft orders. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type DraftOrderBulkDelete { - """ - Returns how many objects were affected. - """ - count: Int! - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -""" -Deletes order lines. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type DraftOrderLinesBulkDelete { - """ - Returns how many objects were affected. - """ - count: Int! - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -""" -Updates a draft order. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type DraftOrderUpdate { - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! - order: Order -} - -input DraftOrderInput { - """ - Billing address of the customer. - """ - billingAddress: AddressInput - - """ - Customer associated with the draft order. - """ - user: ID - - """ - Email address of the customer. - """ - userEmail: String - - """ - Discount amount for the order. - """ - discount: PositiveDecimal - - """ - Shipping address of the customer. - """ - shippingAddress: AddressInput - - """ - ID of a selected shipping method. - """ - shippingMethod: ID - - """ - ID of the voucher associated with the order. - """ - voucher: ID - - """ - A note from a customer. Visible by customers in the order summary. - """ - customerNote: String - - """ - ID of the channel associated with the order. - """ - channelId: ID - - """ - URL of a view where users should be redirected to see the order details. URL in RFC 1808 format. - """ - redirectUrl: String -} - -""" -Adds note to the order. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type OrderAddNote { - """ - Order with the note added. - """ - order: Order - - """ - Order note created. - """ - event: OrderEvent - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -input OrderAddNoteInput { - """ - Note message. - """ - message: String! -} - -""" -Cancel an order. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type OrderCancel { - """ - Canceled order. - """ - order: Order - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -""" -Capture an order. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type OrderCapture { - """ - Captured order. - """ - order: Order - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -""" -Confirms an unconfirmed order by changing status to unfulfilled. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type OrderConfirm { - order: Order - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -""" -Creates new fulfillments for an order. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type OrderFulfill { - """ - List of created fulfillments. - """ - fulfillments: [Fulfillment!] - - """ - Fulfilled order. - """ - order: Order - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -input OrderFulfillInput { - """ - List of items informing how to fulfill the order. - """ - lines: [OrderFulfillLineInput!]! - - """ - If true, send an email notification to the customer. - """ - notifyCustomer: Boolean - - """ - If true, then allow proceed fulfillment when stock is exceeded. - """ - allowStockToBeExceeded: Boolean = false -} - -input OrderFulfillLineInput { - """ - The ID of the order line. - """ - orderLineId: ID - - """ - List of stock items to create. - """ - stocks: [OrderFulfillStockInput!]! -} - -input OrderFulfillStockInput { - """ - The number of line items to be fulfilled from given warehouse. - """ - quantity: Int! - - """ - ID of the warehouse from which the item will be fulfilled. - """ - warehouse: ID! -} - -""" -Cancels existing fulfillment and optionally restocks items. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type FulfillmentCancel { - """ - A canceled fulfillment. - """ - fulfillment: Fulfillment - - """ - Order which fulfillment was cancelled. - """ - order: Order - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -input FulfillmentCancelInput { - """ - ID of a warehouse where items will be restocked. Optional when fulfillment is in WAITING_FOR_APPROVAL state. - """ - warehouseId: ID -} - -""" -Approve existing fulfillment. - -Added in Saleor 3.1. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type FulfillmentApprove { - """ - An approved fulfillment. - """ - fulfillment: Fulfillment - - """ - Order which fulfillment was approved. - """ - order: Order - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -""" -Updates a fulfillment for an order. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type FulfillmentUpdateTracking { - """ - A fulfillment with updated tracking. - """ - fulfillment: Fulfillment - - """ - Order for which fulfillment was updated. - """ - order: Order - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -input FulfillmentUpdateTrackingInput { - """ - Fulfillment tracking number. - """ - trackingNumber: String - - """ - If true, send an email notification to the customer. - """ - notifyCustomer: Boolean = false -} - -""" -Refund products. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type FulfillmentRefundProducts { - """ - A refunded fulfillment. - """ - fulfillment: Fulfillment - - """ - Order which fulfillment was refunded. - """ - order: Order - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -input OrderRefundProductsInput { - """ - List of unfulfilled lines to refund. - """ - orderLines: [OrderRefundLineInput!] - - """ - List of fulfilled lines to refund. - """ - fulfillmentLines: [OrderRefundFulfillmentLineInput!] - - """ - The total amount of refund when the value is provided manually. - """ - amountToRefund: PositiveDecimal - - """ - If true, Saleor will refund shipping costs. If amountToRefund is providedincludeShippingCosts will be ignored. - """ - includeShippingCosts: Boolean = false -} - -input OrderRefundLineInput { - """ - The ID of the order line to refund. - """ - orderLineId: ID! - - """ - The number of items to be refunded. - """ - quantity: Int! -} - -input OrderRefundFulfillmentLineInput { - """ - The ID of the fulfillment line to refund. - """ - fulfillmentLineId: ID! - - """ - The number of items to be refunded. - """ - quantity: Int! -} - -""" -Return products. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type FulfillmentReturnProducts { - """ - A return fulfillment. - """ - returnFulfillment: Fulfillment - - """ - A replace fulfillment. - """ - replaceFulfillment: Fulfillment - - """ - Order which fulfillment was returned. - """ - order: Order - - """ - A draft order which was created for products with replace flag. - """ - replaceOrder: Order - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -input OrderReturnProductsInput { - """ - List of unfulfilled lines to return. - """ - orderLines: [OrderReturnLineInput!] - - """ - List of fulfilled lines to return. - """ - fulfillmentLines: [OrderReturnFulfillmentLineInput!] - - """ - The total amount of refund when the value is provided manually. - """ - amountToRefund: PositiveDecimal - - """ - If true, Saleor will refund shipping costs. If amountToRefund is providedincludeShippingCosts will be ignored. - """ - includeShippingCosts: Boolean = false - - """ - If true, Saleor will call refund action for all lines. - """ - refund: Boolean = false -} - -input OrderReturnLineInput { - """ - The ID of the order line to return. - """ - orderLineId: ID! - - """ - The number of items to be returned. - """ - quantity: Int! - - """ - Determines, if the line should be added to replace order. - """ - replace: Boolean = false -} - -input OrderReturnFulfillmentLineInput { - """ - The ID of the fulfillment line to return. - """ - fulfillmentLineId: ID! - - """ - The number of items to be returned. - """ - quantity: Int! - - """ - Determines, if the line should be added to replace order. - """ - replace: Boolean = false -} - -""" -Create order lines for an order. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type OrderLinesCreate { - """ - Related order. - """ - order: Order - - """ - List of added order lines. - """ - orderLines: [OrderLine!] - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -""" -Deletes an order line from an order. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type OrderLineDelete { - """ - A related order. - """ - order: Order - - """ - An order line that was deleted. - """ - orderLine: OrderLine - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -""" -Updates an order line of an order. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type OrderLineUpdate { - """ - Related order. - """ - order: Order - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! - orderLine: OrderLine -} - -input OrderLineInput { - """ - Number of variant items ordered. - """ - quantity: Int! -} - -""" -Adds discount to the order. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type OrderDiscountAdd { - """ - Order which has been discounted. - """ - order: Order - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -input OrderDiscountCommonInput { - """ - Type of the discount: fixed or percent - """ - valueType: DiscountValueTypeEnum! - - """ - Value of the discount. Can store fixed value or percent value - """ - value: PositiveDecimal! - - """ - Explanation for the applied discount. - """ - reason: String -} - -""" -Update discount for the order. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type OrderDiscountUpdate { - """ - Order which has been discounted. - """ - order: Order - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -""" -Remove discount from the order. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type OrderDiscountDelete { - """ - Order which has removed discount. - """ - order: Order - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -""" -Update discount for the order line. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type OrderLineDiscountUpdate { - """ - Order line which has been discounted. - """ - orderLine: OrderLine - - """ - Order which is related to the discounted line. - """ - order: Order - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -""" -Remove discount applied to the order line. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type OrderLineDiscountRemove { - """ - Order line which has removed discount. - """ - orderLine: OrderLine - - """ - Order which is related to line which has removed discount. - """ - order: Order - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -""" -Mark order as manually paid. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type OrderMarkAsPaid { - """ - Order marked as paid. - """ - order: Order - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -""" -Refund an order. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type OrderRefund { - """ - A refunded order. - """ - order: Order - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -""" -Updates an order. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type OrderUpdate { - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! - order: Order -} - -input OrderUpdateInput { - """ - Billing address of the customer. - """ - billingAddress: AddressInput - - """ - Email address of the customer. - """ - userEmail: String - - """ - Shipping address of the customer. - """ - shippingAddress: AddressInput -} - -""" -Updates a shipping method of the order. Requires shipping method ID to update, when null is passed then currently assigned shipping method is removed. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type OrderUpdateShipping { - """ - Order with updated shipping method. - """ - order: Order - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -input OrderUpdateShippingInput { - """ - ID of the selected shipping method, pass null to remove currently assigned shipping method. - """ - shippingMethod: ID -} - -""" -Void an order. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type OrderVoid { - """ - A voided order. - """ - order: Order - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -""" -Cancels orders. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type OrderBulkCancel { - """ - Returns how many objects were affected. - """ - count: Int! - orderErrors: [OrderError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [OrderError!]! -} - -""" -Delete metadata of an object. To use it, you need to have access to the modified object. -""" -type DeleteMetadata { - metadataErrors: [MetadataError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [MetadataError!]! - item: ObjectWithMetadata -} - -type MetadataError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: MetadataErrorCode! -} - -""" -An enumeration. -""" -enum MetadataErrorCode { - GRAPHQL_ERROR - INVALID - NOT_FOUND - REQUIRED - NOT_UPDATED -} - -""" -Delete object's private metadata. To use it, you need to be an authenticated staff user or an app and have access to the modified object. -""" -type DeletePrivateMetadata { - metadataErrors: [MetadataError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [MetadataError!]! - item: ObjectWithMetadata -} - -""" -Updates metadata of an object. To use it, you need to have access to the modified object. -""" -type UpdateMetadata { - metadataErrors: [MetadataError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [MetadataError!]! - item: ObjectWithMetadata -} - -""" -Updates private metadata of an object. To use it, you need to be an authenticated staff user or an app and have access to the modified object. -""" -type UpdatePrivateMetadata { - metadataErrors: [MetadataError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [MetadataError!]! - item: ObjectWithMetadata -} - -""" -Assigns storefront's navigation menus. - -Requires one of the following permissions: MANAGE_MENUS, MANAGE_SETTINGS. -""" -type AssignNavigation { - """ - Assigned navigation menu. - """ - menu: Menu - menuErrors: [MenuError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [MenuError!]! -} - -type MenuError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: MenuErrorCode! -} - -""" -An enumeration. -""" -enum MenuErrorCode { - CANNOT_ASSIGN_NODE - GRAPHQL_ERROR - INVALID - INVALID_MENU_ITEM - NO_MENU_ITEM_PROVIDED - NOT_FOUND - REQUIRED - TOO_MANY_MENU_ITEMS - UNIQUE -} - -enum NavigationType { - """ - Main storefront navigation. - """ - MAIN - - """ - Secondary storefront navigation. - """ - SECONDARY -} - -""" -Creates a new Menu. - -Requires one of the following permissions: MANAGE_MENUS. -""" -type MenuCreate { - menuErrors: [MenuError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [MenuError!]! - menu: Menu -} - -input MenuCreateInput { - """ - Name of the menu. - """ - name: String! - - """ - Slug of the menu. Will be generated if not provided. - """ - slug: String - - """ - List of menu items. - """ - items: [MenuItemInput!] -} - -input MenuItemInput { - """ - Name of the menu item. - """ - name: String - - """ - URL of the pointed item. - """ - url: String - - """ - Category to which item points. - """ - category: ID - - """ - Collection to which item points. - """ - collection: ID - - """ - Page to which item points. - """ - page: ID -} - -""" -Deletes a menu. - -Requires one of the following permissions: MANAGE_MENUS. -""" -type MenuDelete { - menuErrors: [MenuError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [MenuError!]! - menu: Menu -} - -""" -Deletes menus. - -Requires one of the following permissions: MANAGE_MENUS. -""" -type MenuBulkDelete { - """ - Returns how many objects were affected. - """ - count: Int! - menuErrors: [MenuError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [MenuError!]! -} - -""" -Updates a menu. - -Requires one of the following permissions: MANAGE_MENUS. -""" -type MenuUpdate { - menuErrors: [MenuError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [MenuError!]! - menu: Menu -} - -input MenuInput { - """ - Name of the menu. - """ - name: String - - """ - Slug of the menu. - """ - slug: String -} - -""" -Creates a new menu item. - -Requires one of the following permissions: MANAGE_MENUS. -""" -type MenuItemCreate { - menuErrors: [MenuError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [MenuError!]! - menuItem: MenuItem -} - -input MenuItemCreateInput { - """ - Name of the menu item. - """ - name: String! - - """ - URL of the pointed item. - """ - url: String - - """ - Category to which item points. - """ - category: ID - - """ - Collection to which item points. - """ - collection: ID - - """ - Page to which item points. - """ - page: ID - - """ - Menu to which item belongs. - """ - menu: ID! - - """ - ID of the parent menu. If empty, menu will be top level menu. - """ - parent: ID -} - -""" -Deletes a menu item. - -Requires one of the following permissions: MANAGE_MENUS. -""" -type MenuItemDelete { - menuErrors: [MenuError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [MenuError!]! - menuItem: MenuItem -} - -""" -Deletes menu items. - -Requires one of the following permissions: MANAGE_MENUS. -""" -type MenuItemBulkDelete { - """ - Returns how many objects were affected. - """ - count: Int! - menuErrors: [MenuError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [MenuError!]! -} - -""" -Updates a menu item. - -Requires one of the following permissions: MANAGE_MENUS. -""" -type MenuItemUpdate { - menuErrors: [MenuError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [MenuError!]! - menuItem: MenuItem -} - -""" -Creates/updates translations for a menu item. - -Requires one of the following permissions: MANAGE_TRANSLATIONS. -""" -type MenuItemTranslate { - translationErrors: [TranslationError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [TranslationError!]! - menuItem: MenuItem -} - -""" -Moves items of menus. - -Requires one of the following permissions: MANAGE_MENUS. -""" -type MenuItemMove { - """ - Assigned menu to move within. - """ - menu: Menu - menuErrors: [MenuError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [MenuError!]! -} - -input MenuItemMoveInput { - """ - The menu item ID to move. - """ - itemId: ID! - - """ - ID of the parent menu. If empty, menu will be top level menu. - """ - parentId: ID - - """ - The new relative sorting position of the item (from -inf to +inf). 1 moves the item one position forward, -1 moves the item one position backward, 0 leaves the item unchanged. - """ - sortOrder: Int -} - -""" -Request an invoice for the order using plugin. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type InvoiceRequest { - """ - Order related to an invoice. - """ - order: Order - invoiceErrors: [InvoiceError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [InvoiceError!]! - invoice: Invoice -} - -type InvoiceError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: InvoiceErrorCode! -} - -""" -An enumeration. -""" -enum InvoiceErrorCode { - REQUIRED - NOT_READY - URL_NOT_SET - EMAIL_NOT_SET - NUMBER_NOT_SET - NOT_FOUND - INVALID_STATUS - NO_INVOICE_PLUGIN -} - -""" -Requests deletion of an invoice. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type InvoiceRequestDelete { - invoiceErrors: [InvoiceError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [InvoiceError!]! - invoice: Invoice -} - -""" -Creates a ready to send invoice. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type InvoiceCreate { - invoiceErrors: [InvoiceError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [InvoiceError!]! - invoice: Invoice -} - -input InvoiceCreateInput { - """ - Invoice number. - """ - number: String! - - """ - URL of an invoice to download. - """ - url: String! -} - -""" -Deletes an invoice. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type InvoiceDelete { - invoiceErrors: [InvoiceError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [InvoiceError!]! - invoice: Invoice -} - -""" -Updates an invoice. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type InvoiceUpdate { - invoiceErrors: [InvoiceError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [InvoiceError!]! - invoice: Invoice -} - -input UpdateInvoiceInput { - """ - Invoice number - """ - number: String - - """ - URL of an invoice to download. - """ - url: String -} - -""" -Send an invoice notification to the customer. - -Requires one of the following permissions: MANAGE_ORDERS. -""" -type InvoiceSendNotification { - invoiceErrors: [InvoiceError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [InvoiceError!]! - invoice: Invoice -} - -""" -Activate a gift card. - -Requires one of the following permissions: MANAGE_GIFT_CARD. -""" -type GiftCardActivate { - """ - Activated gift card. - """ - giftCard: GiftCard - giftCardErrors: [GiftCardError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [GiftCardError!]! -} - -type GiftCardError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: GiftCardErrorCode! - - """ - List of tag values that cause the error. - """ - tags: [String!] -} - -""" -An enumeration. -""" -enum GiftCardErrorCode { - ALREADY_EXISTS - GRAPHQL_ERROR - INVALID - NOT_FOUND - REQUIRED - UNIQUE - EXPIRED_GIFT_CARD - DUPLICATED_INPUT_ITEM -} - -""" -Creates a new gift card. - -Requires one of the following permissions: MANAGE_GIFT_CARD. -""" -type GiftCardCreate { - giftCardErrors: [GiftCardError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [GiftCardError!]! - giftCard: GiftCard -} - -input GiftCardCreateInput { - """ - The gift card tags to add. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - addTags: [String!] - - """ - The gift card expiry date. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - expiryDate: Date - - """ - Start date of the gift card in ISO 8601 format. - - DEPRECATED: this field will be removed in Saleor 4.0. - """ - startDate: Date - - """ - End date of the gift card in ISO 8601 format. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `expiryDate` from `expirySettings` instead. - """ - endDate: Date - - """ - Balance of the gift card. - """ - balance: PriceInput! - - """ - Email of the customer to whom gift card will be sent. - """ - userEmail: String - - """ - Slug of a channel from which the email should be sent. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - channel: String - - """ - Determine if gift card is active. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - isActive: Boolean! - - """ - Code to use the gift card. - - DEPRECATED: this field will be removed in Saleor 4.0. The code is now auto generated. - """ - code: String - - """ - The gift card note from the staff member. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - note: String -} - -input PriceInput { - """ - Currency code. - """ - currency: String! - - """ - Amount of money. - """ - amount: PositiveDecimal! -} - -""" -Delete gift card. - -Added in Saleor 3.1. - -Note: this API is currently in Feature Preview and can be subject to changes at later point. - -Requires one of the following permissions: MANAGE_GIFT_CARD. -""" -type GiftCardDelete { - giftCardErrors: [GiftCardError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [GiftCardError!]! - giftCard: GiftCard -} - -""" -Deactivate a gift card. - -Requires one of the following permissions: MANAGE_GIFT_CARD. -""" -type GiftCardDeactivate { - """ - Deactivated gift card. - """ - giftCard: GiftCard - giftCardErrors: [GiftCardError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [GiftCardError!]! -} - -""" -Update a gift card. - -Requires one of the following permissions: MANAGE_GIFT_CARD. -""" -type GiftCardUpdate { - giftCardErrors: [GiftCardError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [GiftCardError!]! - giftCard: GiftCard -} - -input GiftCardUpdateInput { - """ - The gift card tags to add. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - addTags: [String!] - - """ - The gift card expiry date. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - expiryDate: Date - - """ - Start date of the gift card in ISO 8601 format. - - DEPRECATED: this field will be removed in Saleor 4.0. - """ - startDate: Date - - """ - End date of the gift card in ISO 8601 format. - - DEPRECATED: this field will be removed in Saleor 4.0. Use `expiryDate` from `expirySettings` instead. - """ - endDate: Date - - """ - The gift card tags to remove. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - removeTags: [String!] - - """ - The gift card balance amount. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - balanceAmount: PositiveDecimal -} - -""" -Resend a gift card. - -Added in Saleor 3.1. - -Note: this API is currently in Feature Preview and can be subject to changes at later point. - -Requires one of the following permissions: MANAGE_GIFT_CARD. -""" -type GiftCardResend { - """ - Gift card which has been sent. - """ - giftCard: GiftCard - errors: [GiftCardError!]! -} - -input GiftCardResendInput { - """ - ID of a gift card to resend. - """ - id: ID! - - """ - Email to which gift card should be send. - """ - email: String - - """ - Slug of a channel from which the email should be sent. - """ - channel: String! -} - -""" -Adds note to the gift card. - -Added in Saleor 3.1. - -Note: this API is currently in Feature Preview and can be subject to changes at later point. - -Requires one of the following permissions: MANAGE_GIFT_CARD. -""" -type GiftCardAddNote { - """ - Gift card with the note added. - """ - giftCard: GiftCard - - """ - Gift card note created. - """ - event: GiftCardEvent - errors: [GiftCardError!]! -} - -input GiftCardAddNoteInput { - """ - Note message. - """ - message: String! -} - -""" -Create gift cards. - -Added in Saleor 3.1. - -Note: this API is currently in Feature Preview and can be subject to changes at later point. - -Requires one of the following permissions: MANAGE_GIFT_CARD. -""" -type GiftCardBulkCreate { - """ - Returns how many objects were created. - """ - count: Int! - - """ - List of created gift cards. - """ - giftCards: [GiftCard!]! - errors: [GiftCardError!]! -} - -input GiftCardBulkCreateInput { - """ - The number of cards to issue. - """ - count: Int! - - """ - Balance of the gift card. - """ - balance: PriceInput! - - """ - The gift card tags. - """ - tags: [String!] - - """ - The gift card expiry date. - """ - expiryDate: Date - - """ - Determine if gift card is active. - """ - isActive: Boolean! -} - -""" -Delete gift cards. - -Added in Saleor 3.1. - -Note: this API is currently in Feature Preview and can be subject to changes at later point. - -Requires one of the following permissions: MANAGE_GIFT_CARD. -""" -type GiftCardBulkDelete { - """ - Returns how many objects were affected. - """ - count: Int! - errors: [GiftCardError!]! -} - -""" -Activate gift cards. - -Added in Saleor 3.1. - -Note: this API is currently in Feature Preview and can be subject to changes at later point. - -Requires one of the following permissions: MANAGE_GIFT_CARD. -""" -type GiftCardBulkActivate { - """ - Returns how many objects were affected. - """ - count: Int! - errors: [GiftCardError!]! -} - -""" -Deactivate gift cards. - -Added in Saleor 3.1. - -Note: this API is currently in Feature Preview and can be subject to changes at later point. - -Requires one of the following permissions: MANAGE_GIFT_CARD. -""" -type GiftCardBulkDeactivate { - """ - Returns how many objects were affected. - """ - count: Int! - errors: [GiftCardError!]! -} - -""" -Update plugin configuration. - -Requires one of the following permissions: MANAGE_PLUGINS. -""" -type PluginUpdate { - plugin: Plugin - pluginsErrors: [PluginError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PluginError!]! -} - -type PluginError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: PluginErrorCode! -} - -""" -An enumeration. -""" -enum PluginErrorCode { - GRAPHQL_ERROR - INVALID - PLUGIN_MISCONFIGURED - NOT_FOUND - REQUIRED - UNIQUE -} - -input PluginUpdateInput { - """ - Indicates whether the plugin should be enabled. - """ - active: Boolean - - """ - Configuration of the plugin. - """ - configuration: [ConfigurationItemInput!] -} - -input ConfigurationItemInput { - """ - Name of the field to update. - """ - name: String! - - """ - Value of the given field to update. - """ - value: String -} - -""" -Trigger sending a notification with the notify plugin method. Serializes nodes provided as ids parameter and includes this data in the notification payload. - -Added in Saleor 3.1. -""" -type ExternalNotificationTrigger { - errors: [ExternalNotificationError!]! -} - -type ExternalNotificationError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: ExternalNotificationErrorCodes! -} - -""" -An enumeration. -""" -enum ExternalNotificationErrorCodes { - REQUIRED - INVALID_MODEL_TYPE - NOT_FOUND - CHANNEL_INACTIVE -} - -input ExternalNotificationTriggerInput { - """ - The list of customers or orders node IDs that will be serialized and included in the notification payload. - """ - ids: [ID!]! - - """ - Additional payload that will be merged with the one based on the bussines object ID. - """ - extraPayload: JSONString - - """ - External event type. This field is passed to a plugin as an event type. - """ - externalEventType: String! -} - -""" -Creates a new sale. - -Requires one of the following permissions: MANAGE_DISCOUNTS. -""" -type SaleCreate { - discountErrors: [DiscountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [DiscountError!]! - sale: Sale -} - -type DiscountError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - List of products IDs which causes the error. - """ - products: [ID!] - - """ - The error code. - """ - code: DiscountErrorCode! - - """ - List of channels IDs which causes the error. - """ - channels: [ID!] -} - -""" -An enumeration. -""" -enum DiscountErrorCode { - ALREADY_EXISTS - GRAPHQL_ERROR - INVALID - NOT_FOUND - REQUIRED - UNIQUE - CANNOT_MANAGE_PRODUCT_WITHOUT_VARIANT - DUPLICATED_INPUT_ITEM -} - -input SaleInput { - """ - Voucher name. - """ - name: String - - """ - Fixed or percentage. - """ - type: DiscountValueTypeEnum - - """ - Value of the voucher. - """ - value: PositiveDecimal - - """ - Products related to the discount. - """ - products: [ID!] - variants: [ID!] - - """ - Categories related to the discount. - """ - categories: [ID!] - - """ - Collections related to the discount. - """ - collections: [ID!] - - """ - Start date of the voucher in ISO 8601 format. - """ - startDate: DateTime - - """ - End date of the voucher in ISO 8601 format. - """ - endDate: DateTime -} - -""" -Deletes a sale. - -Requires one of the following permissions: MANAGE_DISCOUNTS. -""" -type SaleDelete { - discountErrors: [DiscountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [DiscountError!]! - sale: Sale -} - -""" -Deletes sales. - -Requires one of the following permissions: MANAGE_DISCOUNTS. -""" -type SaleBulkDelete { - """ - Returns how many objects were affected. - """ - count: Int! - discountErrors: [DiscountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [DiscountError!]! -} - -""" -Updates a sale. - -Requires one of the following permissions: MANAGE_DISCOUNTS. -""" -type SaleUpdate { - discountErrors: [DiscountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [DiscountError!]! - sale: Sale -} - -""" -Adds products, categories, collections to a voucher. - -Requires one of the following permissions: MANAGE_DISCOUNTS. -""" -type SaleAddCatalogues { - """ - Sale of which catalogue IDs will be modified. - """ - sale: Sale - discountErrors: [DiscountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [DiscountError!]! -} - -input CatalogueInput { - """ - Products related to the discount. - """ - products: [ID!] - - """ - Categories related to the discount. - """ - categories: [ID!] - - """ - Collections related to the discount. - """ - collections: [ID!] - - """ - Product variant related to the discount. - - Added in Saleor 3.1. - """ - variants: [ID!] -} - -""" -Removes products, categories, collections from a sale. - -Requires one of the following permissions: MANAGE_DISCOUNTS. -""" -type SaleRemoveCatalogues { - """ - Sale of which catalogue IDs will be modified. - """ - sale: Sale - discountErrors: [DiscountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [DiscountError!]! -} - -""" -Creates/updates translations for a sale. - -Requires one of the following permissions: MANAGE_TRANSLATIONS. -""" -type SaleTranslate { - translationErrors: [TranslationError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [TranslationError!]! - sale: Sale -} - -""" -Manage sale's availability in channels. - -Requires one of the following permissions: MANAGE_DISCOUNTS. -""" -type SaleChannelListingUpdate { - """ - An updated sale instance. - """ - sale: Sale - discountErrors: [DiscountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [DiscountError!]! -} - -input SaleChannelListingInput { - """ - List of channels to which the sale should be assigned. - """ - addChannels: [SaleChannelListingAddInput!] - - """ - List of channels from which the sale should be unassigned. - """ - removeChannels: [ID!] -} - -input SaleChannelListingAddInput { - """ - ID of a channel. - """ - channelId: ID! - - """ - The value of the discount. - """ - discountValue: PositiveDecimal! -} - -""" -Creates a new voucher. - -Requires one of the following permissions: MANAGE_DISCOUNTS. -""" -type VoucherCreate { - discountErrors: [DiscountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [DiscountError!]! - voucher: Voucher -} - -input VoucherInput { - """ - Voucher type: PRODUCT, CATEGORY SHIPPING or ENTIRE_ORDER. - """ - type: VoucherTypeEnum - - """ - Voucher name. - """ - name: String - - """ - Code to use the voucher. - """ - code: String - - """ - Start date of the voucher in ISO 8601 format. - """ - startDate: DateTime - - """ - End date of the voucher in ISO 8601 format. - """ - endDate: DateTime - - """ - Choices: fixed or percentage. - """ - discountValueType: DiscountValueTypeEnum - - """ - Products discounted by the voucher. - """ - products: [ID!] - - """ - Variants discounted by the voucher. - - Added in Saleor 3.1. - """ - variants: [ID!] - - """ - Collections discounted by the voucher. - """ - collections: [ID!] - - """ - Categories discounted by the voucher. - """ - categories: [ID!] - - """ - Minimal quantity of checkout items required to apply the voucher. - """ - minCheckoutItemsQuantity: Int - - """ - Country codes that can be used with the shipping voucher. - """ - countries: [String!] - - """ - Voucher should be applied to the cheapest item or entire order. - """ - applyOncePerOrder: Boolean - - """ - Voucher should be applied once per customer. - """ - applyOncePerCustomer: Boolean - - """ - Voucher can be used only by staff user. - """ - onlyForStaff: Boolean - - """ - Limit number of times this voucher can be used in total. - """ - usageLimit: Int -} - -""" -Deletes a voucher. - -Requires one of the following permissions: MANAGE_DISCOUNTS. -""" -type VoucherDelete { - discountErrors: [DiscountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [DiscountError!]! - voucher: Voucher -} - -""" -Deletes vouchers. - -Requires one of the following permissions: MANAGE_DISCOUNTS. -""" -type VoucherBulkDelete { - """ - Returns how many objects were affected. - """ - count: Int! - discountErrors: [DiscountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [DiscountError!]! -} - -""" -Updates a voucher. - -Requires one of the following permissions: MANAGE_DISCOUNTS. -""" -type VoucherUpdate { - discountErrors: [DiscountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [DiscountError!]! - voucher: Voucher -} - -""" -Adds products, categories, collections to a voucher. - -Requires one of the following permissions: MANAGE_DISCOUNTS. -""" -type VoucherAddCatalogues { - """ - Voucher of which catalogue IDs will be modified. - """ - voucher: Voucher - discountErrors: [DiscountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [DiscountError!]! -} - -""" -Removes products, categories, collections from a voucher. - -Requires one of the following permissions: MANAGE_DISCOUNTS. -""" -type VoucherRemoveCatalogues { - """ - Voucher of which catalogue IDs will be modified. - """ - voucher: Voucher - discountErrors: [DiscountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [DiscountError!]! -} - -""" -Creates/updates translations for a voucher. - -Requires one of the following permissions: MANAGE_TRANSLATIONS. -""" -type VoucherTranslate { - translationErrors: [TranslationError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [TranslationError!]! - voucher: Voucher -} - -""" -Manage voucher's availability in channels. - -Requires one of the following permissions: MANAGE_DISCOUNTS. -""" -type VoucherChannelListingUpdate { - """ - An updated voucher instance. - """ - voucher: Voucher - discountErrors: [DiscountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [DiscountError!]! -} - -input VoucherChannelListingInput { - """ - List of channels to which the voucher should be assigned. - """ - addChannels: [VoucherChannelListingAddInput!] - - """ - List of channels from which the voucher should be unassigned. - """ - removeChannels: [ID!] -} - -input VoucherChannelListingAddInput { - """ - ID of a channel. - """ - channelId: ID! - - """ - Value of the voucher. - """ - discountValue: PositiveDecimal - - """ - Min purchase amount required to apply the voucher. - """ - minAmountSpent: PositiveDecimal -} - -""" -Export products to csv file. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type ExportProducts { - """ - The newly created export file job which is responsible for export data. - """ - exportFile: ExportFile - exportErrors: [ExportError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ExportError!]! -} - -type ExportError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: ExportErrorCode! -} - -""" -An enumeration. -""" -enum ExportErrorCode { - GRAPHQL_ERROR - INVALID - NOT_FOUND - REQUIRED -} - -input ExportProductsInput { - """ - Determine which products should be exported. - """ - scope: ExportScope! - - """ - Filtering options for products. - """ - filter: ProductFilterInput - - """ - List of products IDs to export. - """ - ids: [ID!] - - """ - Input with info about fields which should be exported. - """ - exportInfo: ExportInfoInput - - """ - Type of exported file. - """ - fileType: FileTypesEnum! -} - -enum ExportScope { - """ - Export all products. - """ - ALL - - """ - Export products with given ids. - """ - IDS - - """ - Export the filtered products. - """ - FILTER -} - -input ExportInfoInput { - """ - List of attribute ids witch should be exported. - """ - attributes: [ID!] - - """ - List of warehouse ids witch should be exported. - """ - warehouses: [ID!] - - """ - List of channels ids which should be exported. - """ - channels: [ID!] - - """ - List of product fields witch should be exported. - """ - fields: [ProductFieldEnum!] -} - -enum ProductFieldEnum { - NAME - DESCRIPTION - PRODUCT_TYPE - CATEGORY - PRODUCT_WEIGHT - COLLECTIONS - CHARGE_TAXES - PRODUCT_MEDIA - VARIANT_ID - VARIANT_SKU - VARIANT_WEIGHT - VARIANT_MEDIA -} - -""" -An enumeration. -""" -enum FileTypesEnum { - CSV - XLSX -} - -""" -Export gift cards to csv file. - -Added in Saleor 3.1. - -Note: this API is currently in Feature Preview and can be subject to changes at later point. - -Requires one of the following permissions: MANAGE_GIFT_CARD. -""" -type ExportGiftCards { - """ - The newly created export file job which is responsible for export data. - """ - exportFile: ExportFile - errors: [ExportError!]! -} - -input ExportGiftCardsInput { - """ - Determine which gift cards should be exported. - """ - scope: ExportScope! - - """ - Filtering options for gift cards. - """ - filter: GiftCardFilterInput - - """ - List of gift cards IDs to export. - """ - ids: [ID!] - - """ - Type of exported file. - """ - fileType: FileTypesEnum! -} - -""" -Upload a file. This mutation must be sent as a `multipart` request. More detailed specs of the upload format can be found here: https://github.com/jaydenseric/graphql-multipart-request-spec - -Requires one of the following permissions: AUTHENTICATED_APP, AUTHENTICATED_STAFF_USER. -""" -type FileUpload { - uploadedFile: File - uploadErrors: [UploadError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [UploadError!]! -} - -type UploadError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: UploadErrorCode! -} - -""" -An enumeration. -""" -enum UploadErrorCode { - GRAPHQL_ERROR -} - -""" -Adds a gift card or a voucher to a checkout. -""" -type CheckoutAddPromoCode { - """ - The checkout with the added gift card or voucher. - """ - checkout: Checkout - checkoutErrors: [CheckoutError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [CheckoutError!]! -} - -type CheckoutError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: CheckoutErrorCode! - - """ - List of varint IDs which causes the error. - """ - variants: [ID!] - - """ - List of line Ids which cause the error. - """ - lines: [ID!] - - """ - A type of address that causes the error. - """ - addressType: AddressTypeEnum -} - -""" -An enumeration. -""" -enum CheckoutErrorCode { - BILLING_ADDRESS_NOT_SET - CHECKOUT_NOT_FULLY_PAID - GRAPHQL_ERROR - PRODUCT_NOT_PUBLISHED - PRODUCT_UNAVAILABLE_FOR_PURCHASE - INSUFFICIENT_STOCK - INVALID - INVALID_SHIPPING_METHOD - NOT_FOUND - PAYMENT_ERROR - QUANTITY_GREATER_THAN_LIMIT - REQUIRED - SHIPPING_ADDRESS_NOT_SET - SHIPPING_METHOD_NOT_APPLICABLE - DELIVERY_METHOD_NOT_APPLICABLE - SHIPPING_METHOD_NOT_SET - SHIPPING_NOT_REQUIRED - TAX_ERROR - UNIQUE - VOUCHER_NOT_APPLICABLE - GIFT_CARD_NOT_APPLICABLE - ZERO_QUANTITY - MISSING_CHANNEL_SLUG - CHANNEL_INACTIVE - UNAVAILABLE_VARIANT_IN_CHANNEL - EMAIL_NOT_SET - NO_LINES -} - -""" -Update billing address in the existing checkout. -""" -type CheckoutBillingAddressUpdate { - """ - An updated checkout. - """ - checkout: Checkout - checkoutErrors: [CheckoutError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [CheckoutError!]! -} - -""" -Completes the checkout. As a result a new order is created and a payment charge is made. This action requires a successful payment before it can be performed. In case additional confirmation step as 3D secure is required confirmationNeeded flag will be set to True and no order created until payment is confirmed with second call of this mutation. -""" -type CheckoutComplete { - """ - Placed order. - """ - order: Order - - """ - Set to true if payment needs to be confirmed before checkout is complete. - """ - confirmationNeeded: Boolean! - - """ - Confirmation data used to process additional authorization steps. - """ - confirmationData: JSONString - checkoutErrors: [CheckoutError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [CheckoutError!]! -} - -""" -Create a new checkout. -""" -type CheckoutCreate { - """ - Whether the checkout was created or the current active one was returned. Refer to checkoutLinesAdd and checkoutLinesUpdate to merge a cart with an active checkout. - """ - created: Boolean - @deprecated( - reason: "This field will be removed in Saleor 4.0. Always returns `true`." - ) - checkoutErrors: [CheckoutError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [CheckoutError!]! - checkout: Checkout -} - -input CheckoutCreateInput { - """ - Slug of a channel in which to create a checkout. - """ - channel: String - - """ - A list of checkout lines, each containing information about an item in the checkout. - """ - lines: [CheckoutLineInput!]! - - """ - The customer's email address. - """ - email: String - - """ - The mailing address to where the checkout will be shipped. Note: the address will be ignored if the checkout doesn't contain shippable items. - """ - shippingAddress: AddressInput - - """ - Billing address of the customer. - """ - billingAddress: AddressInput - - """ - Checkout language code. - """ - languageCode: LanguageCodeEnum -} - -input CheckoutLineInput { - """ - The number of items purchased. - """ - quantity: Int! - - """ - ID of the product variant. - """ - variantId: ID! - - """ - Custom price of the item. Can be set only by apps with `HANDLE_CHECKOUTS` permission. When the line with the same variant will be provided multiple times, the last price will be used. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - price: PositiveDecimal -} - -""" -Sets the customer as the owner of the checkout. - -Requires one of the following permissions: AUTHENTICATED_APP, AUTHENTICATED_USER. -""" -type CheckoutCustomerAttach { - """ - An updated checkout. - """ - checkout: Checkout - checkoutErrors: [CheckoutError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [CheckoutError!]! -} - -""" -Removes the user assigned as the owner of the checkout. - -Requires one of the following permissions: AUTHENTICATED_APP, AUTHENTICATED_USER. -""" -type CheckoutCustomerDetach { - """ - An updated checkout. - """ - checkout: Checkout - checkoutErrors: [CheckoutError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [CheckoutError!]! -} - -""" -Updates email address in the existing checkout object. -""" -type CheckoutEmailUpdate { - """ - An updated checkout. - """ - checkout: Checkout - checkoutErrors: [CheckoutError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [CheckoutError!]! -} - -""" -Deletes a CheckoutLine. -""" -type CheckoutLineDelete { - """ - An updated checkout. - """ - checkout: Checkout - checkoutErrors: [CheckoutError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [CheckoutError!]! -} - -""" -Deletes checkout lines. -""" -type CheckoutLinesDelete { - """ - An updated checkout. - """ - checkout: Checkout - errors: [CheckoutError!]! -} - -""" -Adds a checkout line to the existing checkout.If line was already in checkout, its quantity will be increased. -""" -type CheckoutLinesAdd { - """ - An updated checkout. - """ - checkout: Checkout - checkoutErrors: [CheckoutError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [CheckoutError!]! -} - -""" -Updates checkout line in the existing checkout. -""" -type CheckoutLinesUpdate { - """ - An updated checkout. - """ - checkout: Checkout - checkoutErrors: [CheckoutError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [CheckoutError!]! -} - -input CheckoutLineUpdateInput { - """ - The number of items purchased. Optional for apps, required for any other users. - """ - quantity: Int - - """ - ID of the product variant. - """ - variantId: ID! - - """ - Custom price of the item. Can be set only by apps with `HANDLE_CHECKOUTS` permission. When the line with the same variant will be provided multiple times, the last price will be used. - - Added in Saleor 3.1. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - price: PositiveDecimal -} - -""" -Remove a gift card or a voucher from a checkout. -""" -type CheckoutRemovePromoCode { - """ - The checkout with the removed gift card or voucher. - """ - checkout: Checkout - checkoutErrors: [CheckoutError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [CheckoutError!]! -} - -""" -Create a new payment for given checkout. -""" -type CheckoutPaymentCreate { - """ - Related checkout object. - """ - checkout: Checkout - - """ - A newly created payment. - """ - payment: Payment - paymentErrors: [PaymentError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PaymentError!]! -} - -input PaymentInput { - """ - A gateway to use with that payment. - """ - gateway: String! - - """ - Client-side generated payment token, representing customer's billing data in a secure manner. - """ - token: String - - """ - Total amount of the transaction, including all taxes and discounts. If no amount is provided, the checkout total will be used. - """ - amount: PositiveDecimal - - """ - URL of a storefront view where user should be redirected after requiring additional actions. Payment with additional actions will not be finished if this field is not provided. - """ - returnUrl: String - - """ - Payment store type. - - Added in Saleor 3.1. - """ - storePaymentMethod: StorePaymentMethodEnum = NONE - - """ - User public metadata. - - Added in Saleor 3.1. - """ - metadata: [MetadataInput!] -} - -""" -Enum representing the type of a payment storage in a gateway. -""" -enum StorePaymentMethodEnum { - """ - On session storage type. The payment is stored only to be reused when the customer is present in the checkout flow. - """ - ON_SESSION - - """ - Off session storage type. The payment is stored to be reused even if the customer is absent. - """ - OFF_SESSION - - """ - Storage is disabled. The payment is not stored. - """ - NONE -} - -""" -Update shipping address in the existing checkout. -""" -type CheckoutShippingAddressUpdate { - """ - An updated checkout. - """ - checkout: Checkout - checkoutErrors: [CheckoutError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [CheckoutError!]! -} - -""" -Updates the shipping method of the checkout. -""" -type CheckoutShippingMethodUpdate { - """ - An updated checkout. - """ - checkout: Checkout - checkoutErrors: [CheckoutError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [CheckoutError!]! -} - -""" -Updates the delivery method (shipping method or pick up point) of the checkout. - -Added in Saleor 3.1. - -Note: this API is currently in Feature Preview and can be subject to changes at later point. -""" -type CheckoutDeliveryMethodUpdate { - """ - An updated checkout. - """ - checkout: Checkout - errors: [CheckoutError!]! -} - -""" -Update language code in the existing checkout. -""" -type CheckoutLanguageCodeUpdate { - """ - An updated checkout. - """ - checkout: Checkout - checkoutErrors: [CheckoutError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [CheckoutError!]! -} - -""" -Create new order from existing checkout. Requires the following permissions: AUTHENTICATED_APP and HANDLE_CHECKOUTS. - -Added in Saleor 3.2. - -Note: this API is currently in Feature Preview and can be subject to changes at later point. -""" -type OrderCreateFromCheckout { - """ - Placed order. - """ - order: Order - errors: [OrderCreateFromCheckoutError!]! -} - -type OrderCreateFromCheckoutError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: OrderCreateFromCheckoutErrorCode! - - """ - List of variant IDs which causes the error. - """ - variants: [ID!] - - """ - List of line Ids which cause the error. - """ - lines: [ID!] -} - -""" -An enumeration. -""" -enum OrderCreateFromCheckoutErrorCode { - GRAPHQL_ERROR - CHECKOUT_NOT_FOUND - CHANNEL_INACTIVE - INSUFFICIENT_STOCK - VOUCHER_NOT_APPLICABLE - GIFT_CARD_NOT_APPLICABLE - TAX_ERROR - SHIPPING_METHOD_NOT_SET - BILLING_ADDRESS_NOT_SET - SHIPPING_ADDRESS_NOT_SET - INVALID_SHIPPING_METHOD - NO_LINES - EMAIL_NOT_SET - UNAVAILABLE_VARIANT_IN_CHANNEL -} - -""" -Creates new channel. - -Requires one of the following permissions: MANAGE_CHANNELS. -""" -type ChannelCreate { - channelErrors: [ChannelError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ChannelError!]! - channel: Channel -} - -type ChannelError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: ChannelErrorCode! - - """ - List of shipping zone IDs which causes the error. - """ - shippingZones: [ID!] -} - -""" -An enumeration. -""" -enum ChannelErrorCode { - ALREADY_EXISTS - GRAPHQL_ERROR - INVALID - NOT_FOUND - REQUIRED - UNIQUE - CHANNELS_CURRENCY_MUST_BE_THE_SAME - CHANNEL_WITH_ORDERS - DUPLICATED_INPUT_ITEM -} - -input ChannelCreateInput { - """ - isActive flag. - """ - isActive: Boolean - - """ - Name of the channel. - """ - name: String! - - """ - Slug of the channel. - """ - slug: String! - - """ - Currency of the channel. - """ - currencyCode: String! - - """ - Default country for the channel. Default country can be used in checkout to determine the stock quantities or calculate taxes when the country was not explicitly provided. - - Added in Saleor 3.1. - """ - defaultCountry: CountryCode! - - """ - List of shipping zones to assign to the channel. - """ - addShippingZones: [ID!] -} - -""" -Update a channel. - -Requires one of the following permissions: MANAGE_CHANNELS. -""" -type ChannelUpdate { - channelErrors: [ChannelError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ChannelError!]! - channel: Channel -} - -input ChannelUpdateInput { - """ - isActive flag. - """ - isActive: Boolean - - """ - Name of the channel. - """ - name: String - - """ - Slug of the channel. - """ - slug: String - - """ - Default country for the channel. Default country can be used in checkout to determine the stock quantities or calculate taxes when the country was not explicitly provided. - - Added in Saleor 3.1. - """ - defaultCountry: CountryCode - - """ - List of shipping zones to assign to the channel. - """ - addShippingZones: [ID!] - - """ - List of shipping zones to unassign from the channel. - """ - removeShippingZones: [ID!] -} - -""" -Delete a channel. Orders associated with the deleted channel will be moved to the target channel. Checkouts, product availability, and pricing will be removed. - -Requires one of the following permissions: MANAGE_CHANNELS. -""" -type ChannelDelete { - channelErrors: [ChannelError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ChannelError!]! - channel: Channel -} - -input ChannelDeleteInput { - """ - ID of channel to migrate orders from origin channel. - """ - channelId: ID! -} - -""" -Activate a channel. - -Requires one of the following permissions: MANAGE_CHANNELS. -""" -type ChannelActivate { - """ - Activated channel. - """ - channel: Channel - channelErrors: [ChannelError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ChannelError!]! -} - -""" -Deactivate a channel. - -Requires one of the following permissions: MANAGE_CHANNELS. -""" -type ChannelDeactivate { - """ - Deactivated channel. - """ - channel: Channel - channelErrors: [ChannelError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [ChannelError!]! -} - -""" -Creates an attribute. -""" -type AttributeCreate { - attribute: Attribute - attributeErrors: [AttributeError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AttributeError!]! -} - -type AttributeError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: AttributeErrorCode! -} - -""" -An enumeration. -""" -enum AttributeErrorCode { - ALREADY_EXISTS - GRAPHQL_ERROR - INVALID - NOT_FOUND - REQUIRED - UNIQUE -} - -input AttributeCreateInput { - """ - The input type to use for entering attribute values in the dashboard. - """ - inputType: AttributeInputTypeEnum - - """ - The entity type which can be used as a reference. - """ - entityType: AttributeEntityTypeEnum - - """ - Name of an attribute displayed in the interface. - """ - name: String! - - """ - Internal representation of an attribute name. - """ - slug: String - - """ - The attribute type. - """ - type: AttributeTypeEnum! - - """ - The unit of attribute values. - """ - unit: MeasurementUnitsEnum - - """ - List of attribute's values. - """ - values: [AttributeValueCreateInput!] - - """ - Whether the attribute requires values to be passed or not. - """ - valueRequired: Boolean - - """ - Whether the attribute is for variants only. - """ - isVariantOnly: Boolean - - """ - Whether the attribute should be visible or not in storefront. - """ - visibleInStorefront: Boolean - - """ - Whether the attribute can be filtered in storefront. - """ - filterableInStorefront: Boolean - - """ - Whether the attribute can be filtered in dashboard. - """ - filterableInDashboard: Boolean - - """ - The position of the attribute in the storefront navigation (0 by default). - """ - storefrontSearchPosition: Int - - """ - Whether the attribute can be displayed in the admin product list. - """ - availableInGrid: Boolean -} - -input AttributeValueCreateInput { - """ - Represent value of the attribute value (e.g. color values for swatch attributes). - """ - value: String - - """ - Represents the text of the attribute value, includes formatting. - - Rich text format. For reference see https://editorjs.io/ - """ - richText: JSONString - - """ - URL of the file attribute. Every time, a new value is created. - """ - fileUrl: String - - """ - File content type. - """ - contentType: String - - """ - Name of a value displayed in the interface. - """ - name: String! -} - -""" -Deletes an attribute. - -Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. -""" -type AttributeDelete { - attributeErrors: [AttributeError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AttributeError!]! - attribute: Attribute -} - -""" -Updates attribute. - -Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. -""" -type AttributeUpdate { - attribute: Attribute - attributeErrors: [AttributeError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AttributeError!]! -} - -input AttributeUpdateInput { - """ - Name of an attribute displayed in the interface. - """ - name: String - - """ - Internal representation of an attribute name. - """ - slug: String - - """ - The unit of attribute values. - """ - unit: MeasurementUnitsEnum - - """ - IDs of values to be removed from this attribute. - """ - removeValues: [ID!] - - """ - New values to be created for this attribute. - """ - addValues: [AttributeValueUpdateInput!] - - """ - Whether the attribute requires values to be passed or not. - """ - valueRequired: Boolean - - """ - Whether the attribute is for variants only. - """ - isVariantOnly: Boolean - - """ - Whether the attribute should be visible or not in storefront. - """ - visibleInStorefront: Boolean - - """ - Whether the attribute can be filtered in storefront. - """ - filterableInStorefront: Boolean - - """ - Whether the attribute can be filtered in dashboard. - """ - filterableInDashboard: Boolean - - """ - The position of the attribute in the storefront navigation (0 by default). - """ - storefrontSearchPosition: Int - - """ - Whether the attribute can be displayed in the admin product list. - """ - availableInGrid: Boolean -} - -input AttributeValueUpdateInput { - """ - Represent value of the attribute value (e.g. color values for swatch attributes). - """ - value: String - - """ - Represents the text of the attribute value, includes formatting. - - Rich text format. For reference see https://editorjs.io/ - """ - richText: JSONString - - """ - URL of the file attribute. Every time, a new value is created. - """ - fileUrl: String - - """ - File content type. - """ - contentType: String - - """ - Name of a value displayed in the interface. - """ - name: String -} - -""" -Creates/updates translations for an attribute. - -Requires one of the following permissions: MANAGE_TRANSLATIONS. -""" -type AttributeTranslate { - translationErrors: [TranslationError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [TranslationError!]! - attribute: Attribute -} - -""" -Deletes attributes. - -Requires one of the following permissions: MANAGE_PAGE_TYPES_AND_ATTRIBUTES. -""" -type AttributeBulkDelete { - """ - Returns how many objects were affected. - """ - count: Int! - attributeErrors: [AttributeError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AttributeError!]! -} - -""" -Deletes values of attributes. - -Requires one of the following permissions: MANAGE_PAGE_TYPES_AND_ATTRIBUTES. -""" -type AttributeValueBulkDelete { - """ - Returns how many objects were affected. - """ - count: Int! - attributeErrors: [AttributeError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AttributeError!]! -} - -""" -Creates a value for an attribute. - -Requires one of the following permissions: MANAGE_PRODUCTS. -""" -type AttributeValueCreate { - """ - The updated attribute. - """ - attribute: Attribute - attributeErrors: [AttributeError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AttributeError!]! - attributeValue: AttributeValue -} - -""" -Deletes a value of an attribute. - -Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. -""" -type AttributeValueDelete { - """ - The updated attribute. - """ - attribute: Attribute - attributeErrors: [AttributeError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AttributeError!]! - attributeValue: AttributeValue -} - -""" -Updates value of an attribute. - -Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. -""" -type AttributeValueUpdate { - """ - The updated attribute. - """ - attribute: Attribute - attributeErrors: [AttributeError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AttributeError!]! - attributeValue: AttributeValue -} - -""" -Creates/updates translations for an attribute value. - -Requires one of the following permissions: MANAGE_TRANSLATIONS. -""" -type AttributeValueTranslate { - translationErrors: [TranslationError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [TranslationError!]! - attributeValue: AttributeValue -} - -input AttributeValueTranslationInput { - name: String - - """ - Translated text. - - Rich text format. For reference see https://editorjs.io/ - """ - richText: JSONString -} - -""" -Reorder the values of an attribute. - -Requires one of the following permissions: MANAGE_PRODUCT_TYPES_AND_ATTRIBUTES. -""" -type AttributeReorderValues { - """ - Attribute from which values are reordered. - """ - attribute: Attribute - attributeErrors: [AttributeError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AttributeError!]! -} - -""" -Creates a new app. Requires the following permissions: AUTHENTICATED_STAFF_USER and MANAGE_APPS. -""" -type AppCreate { - """ - The newly created authentication token. - """ - authToken: String - appErrors: [AppError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AppError!]! - app: App -} - -type AppError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: AppErrorCode! - - """ - List of permissions which causes the error. - """ - permissions: [PermissionEnum!] -} - -""" -An enumeration. -""" -enum AppErrorCode { - FORBIDDEN - GRAPHQL_ERROR - INVALID - INVALID_STATUS - INVALID_PERMISSION - INVALID_URL_FORMAT - INVALID_MANIFEST_FORMAT - MANIFEST_URL_CANT_CONNECT - NOT_FOUND - REQUIRED - UNIQUE - OUT_OF_SCOPE_APP - OUT_OF_SCOPE_PERMISSION -} - -input AppInput { - """ - Name of the app. - """ - name: String - - """ - List of permission code names to assign to this app. - """ - permissions: [PermissionEnum!] -} - -""" -Updates an existing app. - -Requires one of the following permissions: MANAGE_APPS. -""" -type AppUpdate { - appErrors: [AppError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AppError!]! - app: App -} - -""" -Deletes an app. - -Requires one of the following permissions: MANAGE_APPS. -""" -type AppDelete { - appErrors: [AppError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AppError!]! - app: App -} - -""" -Creates a new token. - -Requires one of the following permissions: MANAGE_APPS. -""" -type AppTokenCreate { - """ - The newly created authentication token. - """ - authToken: String - appErrors: [AppError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AppError!]! - appToken: AppToken -} - -input AppTokenInput { - """ - Name of the token. - """ - name: String - - """ - ID of app. - """ - app: ID! -} - -""" -Deletes an authentication token assigned to app. - -Requires one of the following permissions: MANAGE_APPS. -""" -type AppTokenDelete { - appErrors: [AppError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AppError!]! - appToken: AppToken -} - -""" -Verify provided app token. -""" -type AppTokenVerify { - """ - Determine if token is valid or not. - """ - valid: Boolean! - appErrors: [AppError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AppError!]! -} - -""" -Install new app by using app manifest. Requires the following permissions: AUTHENTICATED_STAFF_USER and MANAGE_APPS. -""" -type AppInstall { - appErrors: [AppError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AppError!]! - appInstallation: AppInstallation -} - -input AppInstallInput { - """ - Name of the app to install. - """ - appName: String - - """ - Url to app's manifest in JSON format. - """ - manifestUrl: String - - """ - Determine if app will be set active or not. - """ - activateAfterInstallation: Boolean = true - - """ - List of permission code names to assign to this app. - """ - permissions: [PermissionEnum!] -} - -""" -Retry failed installation of new app. - -Requires one of the following permissions: MANAGE_APPS. -""" -type AppRetryInstall { - appErrors: [AppError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AppError!]! - appInstallation: AppInstallation -} - -""" -Delete failed installation. - -Requires one of the following permissions: MANAGE_APPS. -""" -type AppDeleteFailedInstallation { - appErrors: [AppError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AppError!]! - appInstallation: AppInstallation -} - -""" -Fetch and validate manifest. - -Requires one of the following permissions: MANAGE_APPS. -""" -type AppFetchManifest { - manifest: Manifest - appErrors: [AppError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AppError!]! -} - -""" -The manifest definition. -""" -type Manifest { - identifier: String! - version: String! - name: String! - about: String - permissions: [Permission!] - appUrl: String - configurationUrl: String - tokenTargetUrl: String - dataPrivacy: String - dataPrivacyUrl: String - homepageUrl: String - supportUrl: String - extensions: [AppManifestExtension!]! -} - -type AppManifestExtension { - """ - List of the app extension's permissions. - """ - permissions: [Permission!]! - - """ - Label of the extension to show in the dashboard. - """ - label: String! - - """ - URL of a view where extension's iframe is placed. - """ - url: String! - - """ - Place where given extension will be mounted. - """ - mount: AppExtensionMountEnum! - - """ - Type of way how app extension will be opened. - """ - target: AppExtensionTargetEnum! -} - -""" -Activate the app. - -Requires one of the following permissions: MANAGE_APPS. -""" -type AppActivate { - appErrors: [AppError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AppError!]! - app: App -} - -""" -Deactivate the app. - -Requires one of the following permissions: MANAGE_APPS. -""" -type AppDeactivate { - appErrors: [AppError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AppError!]! - app: App -} - -""" -Create JWT token. -""" -type CreateToken { - """ - JWT token, required to authenticate. - """ - token: String - - """ - JWT refresh token, required to re-generate access token. - """ - refreshToken: String - - """ - CSRF token required to re-generate access token. - """ - csrfToken: String - - """ - A user instance. - """ - user: User - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! -} - -type AccountError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: AccountErrorCode! - - """ - A type of address that causes the error. - """ - addressType: AddressTypeEnum -} - -""" -An enumeration. -""" -enum AccountErrorCode { - ACTIVATE_OWN_ACCOUNT - ACTIVATE_SUPERUSER_ACCOUNT - DUPLICATED_INPUT_ITEM - DEACTIVATE_OWN_ACCOUNT - DEACTIVATE_SUPERUSER_ACCOUNT - DELETE_NON_STAFF_USER - DELETE_OWN_ACCOUNT - DELETE_STAFF_ACCOUNT - DELETE_SUPERUSER_ACCOUNT - GRAPHQL_ERROR - INACTIVE - INVALID - INVALID_PASSWORD - LEFT_NOT_MANAGEABLE_PERMISSION - INVALID_CREDENTIALS - NOT_FOUND - OUT_OF_SCOPE_USER - OUT_OF_SCOPE_GROUP - OUT_OF_SCOPE_PERMISSION - PASSWORD_ENTIRELY_NUMERIC - PASSWORD_TOO_COMMON - PASSWORD_TOO_SHORT - PASSWORD_TOO_SIMILAR - REQUIRED - UNIQUE - JWT_SIGNATURE_EXPIRED - JWT_INVALID_TOKEN - JWT_DECODE_ERROR - JWT_MISSING_TOKEN - JWT_INVALID_CSRF_TOKEN - CHANNEL_INACTIVE - MISSING_CHANNEL_SLUG - ACCOUNT_NOT_CONFIRMED -} - -""" -Refresh JWT token. Mutation tries to take refreshToken from the input.If it fails it will try to take refreshToken from the http-only cookie -refreshToken. csrfToken is required when refreshToken is provided as a cookie. -""" -type RefreshToken { - """ - JWT token, required to authenticate. - """ - token: String - - """ - A user instance. - """ - user: User - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! -} - -""" -Verify JWT token. -""" -type VerifyToken { - """ - User assigned to token. - """ - user: User - - """ - Determine if token is valid or not. - """ - isValid: Boolean! - - """ - JWT payload. - """ - payload: GenericScalar - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! -} - -""" -The `GenericScalar` scalar type represents a generic -GraphQL scalar value that could be: -String, Boolean, Int, Float, List or Object. -""" -scalar GenericScalar - -""" -Deactivate all JWT tokens of the currently authenticated user. - -Requires one of the following permissions: AUTHENTICATED_USER. -""" -type DeactivateAllUserTokens { - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! -} - -""" -Prepare external authentication url for user by custom plugin. -""" -type ExternalAuthenticationUrl { - """ - The data returned by authentication plugin. - """ - authenticationData: JSONString - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! -} - -""" -Obtain external access tokens for user by custom plugin. -""" -type ExternalObtainAccessTokens { - """ - The token, required to authenticate. - """ - token: String - - """ - The refresh token, required to re-generate external access token. - """ - refreshToken: String - - """ - CSRF token required to re-generate external access token. - """ - csrfToken: String - - """ - A user instance. - """ - user: User - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! -} - -""" -Refresh user's access by custom plugin. -""" -type ExternalRefresh { - """ - The token, required to authenticate. - """ - token: String - - """ - The refresh token, required to re-generate external access token. - """ - refreshToken: String - - """ - CSRF token required to re-generate external access token. - """ - csrfToken: String - - """ - A user instance. - """ - user: User - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! -} - -""" -Logout user by custom plugin. -""" -type ExternalLogout { - """ - The data returned by authentication plugin. - """ - logoutData: JSONString - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! -} - -""" -Verify external authentication data by plugin. -""" -type ExternalVerify { - """ - User assigned to data. - """ - user: User - - """ - Determine if authentication data is valid or not. - """ - isValid: Boolean! - - """ - External data. - """ - verifyData: JSONString - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! -} - -""" -Sends an email with the account password modification link. -""" -type RequestPasswordReset { - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! -} - -""" -Confirm user account with token sent by email during registration. -""" -type ConfirmAccount { - """ - An activated user account. - """ - user: User - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! -} - -""" -Sets the user's password from the token sent by email using the RequestPasswordReset mutation. -""" -type SetPassword { - """ - JWT token, required to authenticate. - """ - token: String - - """ - JWT refresh token, required to re-generate access token. - """ - refreshToken: String - - """ - CSRF token required to re-generate access token. - """ - csrfToken: String - - """ - A user instance. - """ - user: User - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! -} - -""" -Change the password of the logged in user. - -Requires one of the following permissions: AUTHENTICATED_USER. -""" -type PasswordChange { - """ - A user instance with a new password. - """ - user: User - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! -} - -""" -Request email change of the logged in user. - -Requires one of the following permissions: AUTHENTICATED_USER. -""" -type RequestEmailChange { - """ - A user instance. - """ - user: User - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! -} - -""" -Confirm the email change of the logged-in user. - -Requires one of the following permissions: AUTHENTICATED_USER. -""" -type ConfirmEmailChange { - """ - A user instance with a new email. - """ - user: User - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! -} - -""" -Create a new address for the customer. - -Requires one of the following permissions: AUTHENTICATED_USER. -""" -type AccountAddressCreate { - """ - A user instance for which the address was created. - """ - user: User - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! - address: Address -} - -""" -Updates an address of the logged-in user. Requires one of the following permissions: MANAGE_USERS, IS_OWNER. -""" -type AccountAddressUpdate { - """ - A user object for which the address was edited. - """ - user: User - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! - address: Address -} - -""" -Delete an address of the logged-in user. Requires one of the following permissions: MANAGE_USERS, IS_OWNER. -""" -type AccountAddressDelete { - """ - A user instance for which the address was deleted. - """ - user: User - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! - address: Address -} - -""" -Sets a default address for the authenticated user. - -Requires one of the following permissions: AUTHENTICATED_USER. -""" -type AccountSetDefaultAddress { - """ - An updated user instance. - """ - user: User - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! -} - -""" -Register a new user. -""" -type AccountRegister { - """ - Informs whether users need to confirm their email address. - """ - requiresConfirmation: Boolean - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! - user: User -} - -input AccountRegisterInput { - """ - Given name. - """ - firstName: String - - """ - Family name. - """ - lastName: String - - """ - User language code. - """ - languageCode: LanguageCodeEnum - - """ - The email address of the user. - """ - email: String! - - """ - Password. - """ - password: String! - - """ - Base of frontend URL that will be needed to create confirmation URL. - """ - redirectUrl: String - - """ - User public metadata. - """ - metadata: [MetadataInput!] - - """ - Slug of a channel which will be used to notify users. Optional when only one channel exists. - """ - channel: String -} - -""" -Updates the account of the logged-in user. - -Requires one of the following permissions: AUTHENTICATED_USER. -""" -type AccountUpdate { - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! - user: User -} - -input AccountInput { - """ - Given name. - """ - firstName: String - - """ - Family name. - """ - lastName: String - - """ - User language code. - """ - languageCode: LanguageCodeEnum - - """ - Billing address of the customer. - """ - defaultBillingAddress: AddressInput - - """ - Shipping address of the customer. - """ - defaultShippingAddress: AddressInput -} - -""" -Sends an email with the account removal link for the logged-in user. - -Requires one of the following permissions: AUTHENTICATED_USER. -""" -type AccountRequestDeletion { - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! -} - -""" -Remove user account. - -Requires one of the following permissions: AUTHENTICATED_USER. -""" -type AccountDelete { - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! - user: User -} - -""" -Creates user address. - -Requires one of the following permissions: MANAGE_USERS. -""" -type AddressCreate { - """ - A user instance for which the address was created. - """ - user: User - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! - address: Address -} - -""" -Updates an address. - -Requires one of the following permissions: MANAGE_USERS. -""" -type AddressUpdate { - """ - A user object for which the address was edited. - """ - user: User - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! - address: Address -} - -""" -Deletes an address. - -Requires one of the following permissions: MANAGE_USERS. -""" -type AddressDelete { - """ - A user instance for which the address was deleted. - """ - user: User - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! - address: Address -} - -""" -Sets a default address for the given user. - -Requires one of the following permissions: MANAGE_USERS. -""" -type AddressSetDefault { - """ - An updated user instance. - """ - user: User - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! -} - -""" -Creates a new customer. - -Requires one of the following permissions: MANAGE_USERS. -""" -type CustomerCreate { - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! - user: User -} - -input UserCreateInput { - """ - Billing address of the customer. - """ - defaultBillingAddress: AddressInput - - """ - Shipping address of the customer. - """ - defaultShippingAddress: AddressInput - - """ - Given name. - """ - firstName: String - - """ - Family name. - """ - lastName: String - - """ - The unique email address of the user. - """ - email: String - - """ - User account is active. - """ - isActive: Boolean - - """ - A note about the user. - """ - note: String - - """ - User language code. - """ - languageCode: LanguageCodeEnum - - """ - URL of a view where users should be redirected to set the password. URL in RFC 1808 format. - """ - redirectUrl: String - - """ - Slug of a channel which will be used for notify user. Optional when only one channel exists. - """ - channel: String -} - -""" -Updates an existing customer. - -Requires one of the following permissions: MANAGE_USERS. -""" -type CustomerUpdate { - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! - user: User -} - -input CustomerInput { - """ - Billing address of the customer. - """ - defaultBillingAddress: AddressInput - - """ - Shipping address of the customer. - """ - defaultShippingAddress: AddressInput - - """ - Given name. - """ - firstName: String - - """ - Family name. - """ - lastName: String - - """ - The unique email address of the user. - """ - email: String - - """ - User account is active. - """ - isActive: Boolean - - """ - A note about the user. - """ - note: String - - """ - User language code. - """ - languageCode: LanguageCodeEnum -} - -""" -Deletes a customer. - -Requires one of the following permissions: MANAGE_USERS. -""" -type CustomerDelete { - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! - user: User -} - -""" -Deletes customers. - -Requires one of the following permissions: MANAGE_USERS. -""" -type CustomerBulkDelete { - """ - Returns how many objects were affected. - """ - count: Int! - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! -} - -""" -Creates a new staff user. - -Requires one of the following permissions: MANAGE_STAFF. -""" -type StaffCreate { - staffErrors: [StaffError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [StaffError!]! - user: User -} - -type StaffError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: AccountErrorCode! - - """ - A type of address that causes the error. - """ - addressType: AddressTypeEnum - - """ - List of permissions which causes the error. - """ - permissions: [PermissionEnum!] - - """ - List of permission group IDs which cause the error. - """ - groups: [ID!] - - """ - List of user IDs which causes the error. - """ - users: [ID!] -} - -input StaffCreateInput { - """ - Given name. - """ - firstName: String - - """ - Family name. - """ - lastName: String - - """ - The unique email address of the user. - """ - email: String - - """ - User account is active. - """ - isActive: Boolean - - """ - A note about the user. - """ - note: String - - """ - List of permission group IDs to which user should be assigned. - """ - addGroups: [ID!] - - """ - URL of a view where users should be redirected to set the password. URL in RFC 1808 format. - """ - redirectUrl: String -} - -""" -Updates an existing staff user. - -Requires one of the following permissions: MANAGE_STAFF. -""" -type StaffUpdate { - staffErrors: [StaffError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [StaffError!]! - user: User -} - -input StaffUpdateInput { - """ - Given name. - """ - firstName: String - - """ - Family name. - """ - lastName: String - - """ - The unique email address of the user. - """ - email: String - - """ - User account is active. - """ - isActive: Boolean - - """ - A note about the user. - """ - note: String - - """ - List of permission group IDs to which user should be assigned. - """ - addGroups: [ID!] - - """ - List of permission group IDs from which user should be unassigned. - """ - removeGroups: [ID!] -} - -""" -Deletes a staff user. - -Requires one of the following permissions: MANAGE_STAFF. -""" -type StaffDelete { - staffErrors: [StaffError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [StaffError!]! - user: User -} - -""" -Deletes staff users. - -Requires one of the following permissions: MANAGE_STAFF. -""" -type StaffBulkDelete { - """ - Returns how many objects were affected. - """ - count: Int! - staffErrors: [StaffError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [StaffError!]! -} - -""" -Create a user avatar. Only for staff members. This mutation must be sent as a `multipart` request. More detailed specs of the upload format can be found here: https://github.com/jaydenseric/graphql-multipart-request-spec - -Requires one of the following permissions: AUTHENTICATED_STAFF_USER. -""" -type UserAvatarUpdate { - """ - An updated user instance. - """ - user: User - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! -} - -""" -Deletes a user avatar. Only for staff members. - -Requires one of the following permissions: AUTHENTICATED_STAFF_USER. -""" -type UserAvatarDelete { - """ - An updated user instance. - """ - user: User - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! -} - -""" -Activate or deactivate users. - -Requires one of the following permissions: MANAGE_USERS. -""" -type UserBulkSetActive { - """ - Returns how many objects were affected. - """ - count: Int! - accountErrors: [AccountError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [AccountError!]! -} - -""" -Create new permission group. - -Requires one of the following permissions: MANAGE_STAFF. -""" -type PermissionGroupCreate { - permissionGroupErrors: [PermissionGroupError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PermissionGroupError!]! - group: Group -} - -type PermissionGroupError { - """ - Name of a field that caused the error. A value of `null` indicates that the error isn't associated with a particular field. - """ - field: String - - """ - The error message. - """ - message: String - - """ - The error code. - """ - code: PermissionGroupErrorCode! - - """ - List of permissions which causes the error. - """ - permissions: [PermissionEnum!] - - """ - List of user IDs which causes the error. - """ - users: [ID!] -} - -""" -An enumeration. -""" -enum PermissionGroupErrorCode { - ASSIGN_NON_STAFF_MEMBER - DUPLICATED_INPUT_ITEM - CANNOT_REMOVE_FROM_LAST_GROUP - LEFT_NOT_MANAGEABLE_PERMISSION - OUT_OF_SCOPE_PERMISSION - OUT_OF_SCOPE_USER - REQUIRED - UNIQUE -} - -input PermissionGroupCreateInput { - """ - List of permission code names to assign to this group. - """ - addPermissions: [PermissionEnum!] - - """ - List of users to assign to this group. - """ - addUsers: [ID!] - - """ - Group name. - """ - name: String! -} - -""" -Update permission group. - -Requires one of the following permissions: MANAGE_STAFF. -""" -type PermissionGroupUpdate { - permissionGroupErrors: [PermissionGroupError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PermissionGroupError!]! - group: Group -} - -input PermissionGroupUpdateInput { - """ - List of permission code names to assign to this group. - """ - addPermissions: [PermissionEnum!] - - """ - List of users to assign to this group. - """ - addUsers: [ID!] - - """ - Group name. - """ - name: String - - """ - List of permission code names to unassign from this group. - """ - removePermissions: [PermissionEnum!] - - """ - List of users to unassign from this group. - """ - removeUsers: [ID!] -} - -""" -Delete permission group. - -Requires one of the following permissions: MANAGE_STAFF. -""" -type PermissionGroupDelete { - permissionGroupErrors: [PermissionGroupError!]! - @deprecated( - reason: "This field will be removed in Saleor 4.0. Use `errors` field instead." - ) - errors: [PermissionGroupError!]! - group: Group -} - -type Subscription { - """ - Look up subscription event. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - event: Event -} - -interface Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App -} - -union IssuingPrincipal = App | User - -""" -An enumeration. -""" -enum DistanceUnitsEnum { - CM - M - KM - FT - YD - INCH -} - -""" -An enumeration. -""" -enum AreaUnitsEnum { - SQ_CM - SQ_M - SQ_KM - SQ_FT - SQ_YD - SQ_INCH -} - -""" -An enumeration. -""" -enum VolumeUnitsEnum { - CUBIC_MILLIMETER - CUBIC_CENTIMETER - CUBIC_DECIMETER - CUBIC_METER - LITER - CUBIC_FOOT - CUBIC_INCH - CUBIC_YARD - QT - PINT - FL_OZ - ACRE_IN - ACRE_FT -} - -type AppInstalled implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The application the event relates to. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - app: App -} - -type AppUpdated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The application the event relates to. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - app: App -} - -type AppDeleted implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The application the event relates to. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - app: App -} - -type AppStatusChanged implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The application the event relates to. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - app: App -} - -type CategoryCreated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The category the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - category: Category -} - -type CategoryUpdated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The category the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - category: Category -} - -type CategoryDeleted implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The category the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - category: Category -} - -type ChannelCreated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The channel the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - channel: Channel -} - -type ChannelUpdated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The channel the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - channel: Channel -} - -type ChannelDeleted implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The channel the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - channel: Channel -} - -type ChannelStatusChanged implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The channel the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - channel: Channel -} - -type GiftCardCreated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The gift card the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - giftCard: GiftCard -} - -type GiftCardUpdated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The gift card the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - giftCard: GiftCard -} - -type GiftCardDeleted implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The gift card the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - giftCard: GiftCard -} - -type GiftCardStatusChanged implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The gift card the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - giftCard: GiftCard -} - -type MenuCreated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The menu the event relates to. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - menu( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): Menu -} - -type MenuUpdated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The menu the event relates to. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - menu( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): Menu -} - -type MenuDeleted implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The menu the event relates to. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - menu( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): Menu -} - -type MenuItemCreated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The menu item the event relates to. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - menuItem( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): MenuItem -} - -type MenuItemUpdated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The menu item the event relates to. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - menuItem( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): MenuItem -} - -type MenuItemDeleted implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The menu item the event relates to. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - menuItem( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): MenuItem -} - -type OrderCreated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The order the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - order: Order -} - -type OrderUpdated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The order the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - order: Order -} - -type OrderConfirmed implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The order the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - order: Order -} - -type OrderFullyPaid implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The order the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - order: Order -} - -type OrderCancelled implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The order the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - order: Order -} - -type OrderFulfilled implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The order the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - order: Order -} - -type DraftOrderCreated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The order the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - order: Order -} - -type DraftOrderUpdated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The order the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - order: Order -} - -type DraftOrderDeleted implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The order the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - order: Order -} - -type ProductCreated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The product the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - product( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): Product - - """ - The category of the product. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - category: Category -} - -type ProductUpdated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The product the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - product( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): Product - - """ - The category of the product. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - category: Category -} - -type ProductDeleted implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The product the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - product( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): Product - - """ - The category of the product. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - category: Category -} - -type ProductVariantCreated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The product variant the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - productVariant( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): ProductVariant -} - -type ProductVariantUpdated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The product variant the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - productVariant( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): ProductVariant -} - -type ProductVariantOutOfStock implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The product variant the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - productVariant( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): ProductVariant - - """ - Look up a warehouse. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - warehouse: Warehouse -} - -type ProductVariantBackInStock implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The product variant the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - productVariant( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): ProductVariant - - """ - Look up a warehouse. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - warehouse: Warehouse -} - -type ProductVariantDeleted implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The product variant the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - productVariant( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): ProductVariant -} - -type SaleCreated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The sale the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - sale( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): Sale -} - -type SaleUpdated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The sale the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - sale( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): Sale -} - -type SaleDeleted implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The sale the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - sale( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): Sale -} - -type InvoiceRequested implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The invoice the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - invoice: Invoice -} - -type InvoiceDeleted implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The invoice the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - invoice: Invoice -} - -type InvoiceSent implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The invoice the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - invoice: Invoice -} - -type FulfillmentCreated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The fulfillment the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - fulfillment: Fulfillment - - """ - The order the fulfillment belongs to. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - order: Order -} - -type FulfillmentCanceled implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The fulfillment the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - fulfillment: Fulfillment - - """ - The order the fulfillment belongs to. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - order: Order -} - -type CustomerCreated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The user the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - user: User -} - -type CustomerUpdated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The user the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - user: User -} - -type CollectionCreated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The collection the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - collection( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): Collection -} - -type CollectionUpdated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The collection the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - collection( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): Collection -} - -type CollectionDeleted implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The collection the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - collection( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): Collection -} - -type CheckoutCreated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The checkout the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - checkout: Checkout -} - -type CheckoutUpdated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The checkout the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - checkout: Checkout -} - -type PageCreated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The page the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - page: Page -} - -type PageUpdated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The page the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - page: Page -} - -type PageDeleted implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The page the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - page: Page -} - -type ShippingPriceCreated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The shipping method the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - shippingMethod( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): ShippingMethodType - - """ - The shipping zone the shipping method belongs to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - shippingZone( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): ShippingZone -} - -type ShippingPriceUpdated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The shipping method the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - shippingMethod( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): ShippingMethodType - - """ - The shipping zone the shipping method belongs to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - shippingZone( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): ShippingZone -} - -type ShippingPriceDeleted implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The shipping method the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - shippingMethod( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): ShippingMethodType - - """ - The shipping zone the shipping method belongs to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - shippingZone( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): ShippingZone -} - -type ShippingZoneCreated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The shipping zone the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - shippingZone( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): ShippingZone -} - -type ShippingZoneUpdated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The shipping zone the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - shippingZone( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): ShippingZone -} - -type ShippingZoneDeleted implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The shipping zone the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - shippingZone( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): ShippingZone -} - -type TransactionActionRequest implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - Look up a transaction. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - transaction: TransactionItem - - """ - Requested action data. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - action: TransactionAction! -} - -type TransactionAction { - """ - Determines the action type. - """ - actionType: TransactionActionEnum! - - """ - Transaction request amount. Null when action type is VOID. - """ - amount: PositiveDecimal -} - -type TranslationCreated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The translation the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - translation: TranslationTypes -} - -union TranslationTypes = - ProductTranslation - | CollectionTranslation - | CategoryTranslation - | AttributeTranslation - | AttributeValueTranslation - | ProductVariantTranslation - | PageTranslation - | ShippingMethodTranslation - | SaleTranslation - | VoucherTranslation - | MenuItemTranslation - -type TranslationUpdated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The translation the event relates to. - - Added in Saleor 3.2. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - translation: TranslationTypes -} - -type VoucherCreated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The voucher the event relates to. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - voucher( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): Voucher -} - -type VoucherUpdated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The voucher the event relates to. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - voucher( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): Voucher -} - -type VoucherDeleted implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The voucher the event relates to. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - voucher( - """ - Slug of a channel for which the data should be returned. - """ - channel: String - ): Voucher -} - -type WarehouseCreated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The warehouse the event relates to. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - warehouse: Warehouse -} - -type WarehouseUpdated implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The warehouse the event relates to. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - warehouse: Warehouse -} - -type WarehouseDeleted implements Event { - """ - Time of the event. - """ - issuedAt: DateTime - - """ - Saleor version that triggered the event. - """ - version: String - - """ - The user or application that triggered the event. - """ - issuingPrincipal: IssuingPrincipal - - """ - The application receiving the webhook. - """ - recipient: App - - """ - The warehouse the event relates to. - - Added in Saleor 3.4. - - Note: this API is currently in Feature Preview and can be subject to changes at later point. - """ - warehouse: Warehouse -} - -""" -_Any value scalar as defined by Federation spec. -""" -scalar _Any - -""" -_Entity union as defined by Federation spec. -""" -union _Entity = - App - | Address - | User - | Group - | ProductVariant - | Product - | ProductType - | Collection - | Category - | ProductMedia - | PageType - -""" -_Service manifest as defined by Federation spec. -""" -type _Service { - sdl: String -} diff --git a/apps/data-importer/graphql/subscriptions/.gitkeep b/apps/data-importer/graphql/subscriptions/.gitkeep deleted file mode 100644 index e69de29bb..000000000 diff --git a/apps/data-importer/next-env.d.ts b/apps/data-importer/next-env.d.ts deleted file mode 100644 index 4f11a03dc..000000000 --- a/apps/data-importer/next-env.d.ts +++ /dev/null @@ -1,5 +0,0 @@ -/// -/// - -// NOTE: This file should not be edited -// see https://nextjs.org/docs/basic-features/typescript for more information. diff --git a/apps/data-importer/next.config.js b/apps/data-importer/next.config.js deleted file mode 100644 index 73bf2a35b..000000000 --- a/apps/data-importer/next.config.js +++ /dev/null @@ -1,43 +0,0 @@ -// @ts-check - -import { withSentryConfig } from "@sentry/nextjs"; - -const isSentryPropertiesInEnvironment = - process.env.SENTRY_AUTH_TOKEN && process.env.SENTRY_PROJECT && process.env.SENTRY_ORG; - -/** @type {import('next').NextConfig} */ -const nextConfig = { - reactStrictMode: true, - transpilePackages: ["@saleor/apps-shared", "nuvo-react"], - experimental: { - bundlePagesExternals: true - }, - /* - * Ignore opentelemetry warnings - https://github.com/open-telemetry/opentelemetry-js/issues/4173 - * Remove when https://github.com/open-telemetry/opentelemetry-js/pull/4660 is released - */ - /** @type {import('next').NextConfig['webpack']} */ - webpack: (config, { isServer }) => { - if (isServer) { - config.ignoreWarnings = [{ module: /opentelemetry/ }]; - } - return config; - }, -}; - -const configWithSentry = withSentryConfig( - nextConfig, - { - org: process.env.SENTRY_ORG, - project: process.env.SENTRY_PROJECT, - silent: true, - }, - { - hideSourceMaps: true, - widenClientFileUpload: true, - disableLogger: true, - tunnelRoute: "/monitoring", - }, -); - -export default isSentryPropertiesInEnvironment ? configWithSentry : nextConfig; diff --git a/apps/data-importer/package.json b/apps/data-importer/package.json deleted file mode 100644 index 4deb87658..000000000 --- a/apps/data-importer/package.json +++ /dev/null @@ -1,78 +0,0 @@ -{ - "name": "data-importer", - "version": "1.12.9", - "scripts": { - "build": "pnpm generate && next build", - "check-types": "tsc --noEmit", - "deploy": "tsx --require dotenv/config ./scripts/deploy.ts", - "dev": "pnpm generate && NODE_OPTIONS='--inspect' next dev", - "fetch-schema": "curl https://raw.githubusercontent.com/saleor/saleor/${npm_package_saleor_schemaVersion}/saleor/graphql/schema.graphql > graphql/schema.graphql", - "generate": "graphql-codegen", - "lint": "eslint .", - "lint:fix": "eslint --fix .", - "start": "next start", - "test": "vitest" - }, - "dependencies": { - "@opentelemetry/api": "../../node_modules/@opentelemetry/api", - "@opentelemetry/api-logs": "../../node_modules/@opentelemetry/api-logs", - "@opentelemetry/core": "../../node_modules/@opentelemetry/core", - "@opentelemetry/exporter-logs-otlp-http": "../../node_modules/@opentelemetry/exporter-logs-otlp-http", - "@opentelemetry/exporter-trace-otlp-http": "../../node_modules/@opentelemetry/exporter-trace-otlp-http", - "@opentelemetry/instrumentation-http": "../../node_modules/@opentelemetry/instrumentation-http", - "@opentelemetry/instrumentation-winston": "../../node_modules/@opentelemetry/instrumentation-winston", - "@opentelemetry/resources": "../../node_modules/@opentelemetry/resources", - "@opentelemetry/sdk-logs": "../../node_modules/@opentelemetry/sdk-logs", - "@opentelemetry/sdk-node": "../../node_modules/@opentelemetry/sdk-node", - "@opentelemetry/sdk-trace-base": "../../node_modules/@opentelemetry/sdk-trace-base", - "@opentelemetry/sdk-trace-node": "../../node_modules/@opentelemetry/sdk-trace-node", - "@opentelemetry/semantic-conventions": "../../node_modules/@opentelemetry/semantic-conventions", - "@saleor/app-sdk": "link:../../node_modules/@saleor/app-sdk", - "@saleor/apps-shared": "workspace:*", - "@saleor/macaw-ui": "1.1.10", - "@saleor/sentry-utils": "workspace:*", - "@sentry/cli": "../../node_modules/@sentry/cli", - "@sentry/nextjs": "../../node_modules/@sentry/nextjs", - "@urql/exchange-auth": "2.1.4", - "@vitejs/plugin-react": "4.3.1", - "dot-object": "^2.1.4", - "dotenv": "16.3.1", - "graphql": "16.7.1", - "graphql-tag": "2.12.6", - "jose": "^4.11.2", - "jsdom": "^20.0.3", - "next": "14.2.3", - "nuvo-react": "^1.22.1", - "react": "18.2.0", - "react-dom": "18.2.0", - "urql": "4.0.4", - "usehooks-ts": "^2.9.1", - "vite": "5.3.3", - "vitest": "1.6.0", - "zod": "3.21.4" - }, - "devDependencies": { - "@graphql-codegen/cli": "5.0.2", - "@graphql-codegen/introspection": "4.0.3", - "@graphql-codegen/schema-ast": "4.0.2", - "@graphql-codegen/typed-document-node": "5.0.5", - "@graphql-codegen/typescript": "4.0.5", - "@graphql-codegen/typescript-operations": "4.1.3", - "@graphql-codegen/typescript-urql": "4.0.0", - "@graphql-typed-document-node/core": "3.2.0", - "@testing-library/react": "^14.0.0", - "@testing-library/react-hooks": "^8.0.1", - "@types/dot-object": "^2.1.2", - "@types/react": "18.2.5", - "@types/react-dom": "18.2.5", - "eslint": "../../node_modules/eslint", - "eslint-config-saleor": "workspace:*", - "tsx": "4.7.1", - "typescript": "5.5.4" - }, - "private": true, - "saleor": { - "schemaVersion": "3.10" - }, - "type": "module" -} diff --git a/apps/data-importer/public/logo.png b/apps/data-importer/public/logo.png deleted file mode 100644 index 69b7c588f..000000000 Binary files a/apps/data-importer/public/logo.png and /dev/null differ diff --git a/apps/data-importer/saleor-app.ts b/apps/data-importer/saleor-app.ts deleted file mode 100644 index 1142a1e74..000000000 --- a/apps/data-importer/saleor-app.ts +++ /dev/null @@ -1,36 +0,0 @@ -import { SaleorApp } from "@saleor/app-sdk/saleor-app"; -import { APL, FileAPL, SaleorCloudAPL, UpstashAPL } from "@saleor/app-sdk/APL"; - -/** - * By default auth data are stored in the `.auth-data.json` (FileAPL). - * For multi-tenant applications and deployments please use UpstashAPL. - * - * To read more about storing auth data, read the - * [APL documentation](https://github.com/saleor/saleor-app-sdk/blob/main/docs/apl.md) - */ - -export let apl: APL; -switch (process.env.APL) { - case "upstash": - // Require `UPSTASH_URL` and `UPSTASH_TOKEN` environment variables - apl = new UpstashAPL(); - break; - case "saleor-cloud": { - if (!process.env.REST_APL_ENDPOINT || !process.env.REST_APL_TOKEN) { - throw new Error("Rest APL is not configured - missing env variables. Check saleor-app.ts"); - } - - apl = new SaleorCloudAPL({ - resourceUrl: process.env.REST_APL_ENDPOINT, - token: process.env.REST_APL_TOKEN, - }); - - break; - } - default: - apl = new FileAPL(); -} - -export const saleorApp = new SaleorApp({ - apl, -}); diff --git a/apps/data-importer/scripts/deploy.ts b/apps/data-importer/scripts/deploy.ts deleted file mode 100644 index 337d5271c..000000000 --- a/apps/data-importer/scripts/deploy.ts +++ /dev/null @@ -1,8 +0,0 @@ -import { exportSentryReleaseEnvironmentVariable } from "@saleor/sentry-utils"; -import { execSync } from "node:child_process"; - -import packageJson from "../package.json"; - -exportSentryReleaseEnvironmentVariable(packageJson.version); - -execSync("pnpm run build", { stdio: "inherit" }); diff --git a/apps/data-importer/sentry.client.config.ts b/apps/data-importer/sentry.client.config.ts deleted file mode 100644 index a04bc5f38..000000000 --- a/apps/data-importer/sentry.client.config.ts +++ /dev/null @@ -1,16 +0,0 @@ -/* - * This file configures the initialization of Sentry on the browser. - * The config you add here will be used whenever a page is visited. - * https://docs.sentry.io/platforms/javascript/guides/nextjs/ - */ - -import * as Sentry from "@sentry/nextjs"; - -Sentry.init({ - dsn: process.env.NEXT_PUBLIC_SENTRY_DSN, - enableTracing: false, - environment: process.env.ENV, - includeLocalVariables: true, - ignoreErrors: ["TRPCClientError"], - integrations: [], -}); diff --git a/apps/data-importer/sentry.edge.config.ts b/apps/data-importer/sentry.edge.config.ts deleted file mode 100644 index 789ed896e..000000000 --- a/apps/data-importer/sentry.edge.config.ts +++ /dev/null @@ -1,14 +0,0 @@ -import * as Sentry from "@sentry/nextjs"; - -Sentry.init({ - dsn: process.env.NEXT_PUBLIC_SENTRY_DSN, - enableTracing: false, - environment: process.env.ENV, - includeLocalVariables: true, - integrations: [ - Sentry.localVariablesIntegration({ - captureAllExceptions: true, - }), - Sentry.extraErrorDataIntegration(), - ], -}); diff --git a/apps/data-importer/sentry.server.config.ts b/apps/data-importer/sentry.server.config.ts deleted file mode 100644 index 789ed896e..000000000 --- a/apps/data-importer/sentry.server.config.ts +++ /dev/null @@ -1,14 +0,0 @@ -import * as Sentry from "@sentry/nextjs"; - -Sentry.init({ - dsn: process.env.NEXT_PUBLIC_SENTRY_DSN, - enableTracing: false, - environment: process.env.ENV, - includeLocalVariables: true, - integrations: [ - Sentry.localVariablesIntegration({ - captureAllExceptions: true, - }), - Sentry.extraErrorDataIntegration(), - ], -}); diff --git a/apps/data-importer/src/modules/authorization/use-authorized-token.ts b/apps/data-importer/src/modules/authorization/use-authorized-token.ts deleted file mode 100644 index 1903dd42c..000000000 --- a/apps/data-importer/src/modules/authorization/use-authorized-token.ts +++ /dev/null @@ -1,30 +0,0 @@ -import { useAppBridge } from "@saleor/app-sdk/app-bridge"; -import { useEffect, useState } from "react"; -import * as jose from "jose"; - -/** - * use app-sdk - */ -export function useAuthorizedToken(requirePermission: string) { - const [authorized, setAuthorized] = useState(); - - const { appBridgeState } = useAppBridge(); - - useEffect(() => { - if (appBridgeState?.token) { - const decodedToken = jose.decodeJwt(appBridgeState.token); - - try { - const userPermissions = decodedToken.user_permissions as string[]; - - if (userPermissions.includes(requirePermission)) { - setAuthorized(true); - } - } catch (e) { - setAuthorized(false); - } - } - }, [appBridgeState, requirePermission]); - - return authorized; -} diff --git a/apps/data-importer/src/modules/customers/customers-importer-nuvo/customers-columns-model.ts b/apps/data-importer/src/modules/customers/customers-importer-nuvo/customers-columns-model.ts deleted file mode 100644 index 3494910c4..000000000 --- a/apps/data-importer/src/modules/customers/customers-importer-nuvo/customers-columns-model.ts +++ /dev/null @@ -1,128 +0,0 @@ -import { ColumnAPI } from "nuvo-react"; -import { z } from "zod"; - -const customerColumns: ColumnAPI[] = [ - { - label: "Customer first name", - key: "customerCreate.firstName", - columnType: "string", - }, - { - label: "Customer last name", - key: "customerCreate.lastName", - columnType: "string", - }, - { - label: "Customer email", - key: "customerCreate.email", - columnType: "email", - validations: [ - { - validate: "required", - }, - { - validate: "unique", - }, - ], - }, - { - label: "Note", - key: "customerCreate.note", - }, - { - label: "External reference", - key: "customerCreate.externalReference", - description: "ID from another service", - }, -]; - -const generateAddressColumns = (labelNamespace: string, keyNamespace: string): ColumnAPI[] => [ - { - label: `${labelNamespace} -> First name`, - key: `customerCreate.${keyNamespace}.firstName`, - }, - { - label: `${labelNamespace} -> Last name`, - key: `customerCreate.${keyNamespace}.lastName`, - }, - { - label: `${labelNamespace} -> Company name`, - key: `customerCreate.${keyNamespace}.companyName`, - }, - { - label: `${labelNamespace} -> Street address 1`, - key: `customerCreate.${keyNamespace}.streetAddress1`, - }, - { - label: `${labelNamespace} -> Street address 2`, - key: `customerCreate.${keyNamespace}.streetAddress2`, - }, - { - label: `${labelNamespace} -> City`, - key: `customerCreate.${keyNamespace}.city`, - }, - { - label: `${labelNamespace} -> City Area`, - key: `customerCreate.${keyNamespace}.cityArea`, - }, - { - label: `${labelNamespace} -> Postal code`, - key: `customerCreate.${keyNamespace}.postalCode`, - }, - { - label: `${labelNamespace} -> Country`, - key: `customerCreate.${keyNamespace}.country`, - }, - { - label: `${labelNamespace} -> Country Area`, - key: `customerCreate.${keyNamespace}.countryArea`, - }, - { - label: `${labelNamespace} -> Phone`, - key: `customerCreate.${keyNamespace}.phone`, - }, -]; - -// TODO - enable address columns when mapped -const allColumns: ColumnAPI[] = [ - ...customerColumns, - /* - * ...generateAddressColumns("Default Billing Address", "defaultBillingAddress"), - * ...generateAddressColumns("Default Shipping Address", "defaultShippingAddress"), - */ -]; - -export const getCustomersModelColumns = () => allColumns; - -const zodAddressSchema = z - .object({ - firstName: z.string().nullish(), - lastName: z.string().nullish(), - companyName: z.string().nullish(), - streetAddress1: z.string().nullish(), - streetAddress2: z.string().nullish(), - city: z.string().nullish(), - cityArea: z.string().nullish(), - postalCode: z.string().nullish(), - country: z.string().nullish(), - countryArea: z.string().nullish(), - phone: z.string().nullish(), - }) - .nullable(); - -export const getResultModelSchema = () => - z.object({ - customerCreate: z.object({ - firstName: z.string().nullish(), - lastName: z.string().nullish(), - email: z.string(), - note: z.string().nullish(), - externalReference: z.string().nullish(), - /* - * defaultBillingAddress: zodAddressSchema, - * defaultShippingAddress: zodAddressSchema, - */ - }), - }); - -export type CustomerColumnSchema = z.infer>; diff --git a/apps/data-importer/src/modules/customers/customers-importer-nuvo/customers-importer-view.tsx b/apps/data-importer/src/modules/customers/customers-importer-nuvo/customers-importer-view.tsx deleted file mode 100644 index f342be914..000000000 --- a/apps/data-importer/src/modules/customers/customers-importer-nuvo/customers-importer-view.tsx +++ /dev/null @@ -1,318 +0,0 @@ -import { Box, Button, DefaultTheme, Text, useTheme } from "@saleor/macaw-ui"; -import dotObject from "dot-object"; -import dynamic from "next/dynamic"; -import { ConfigureAPI, OnResults, SettingsAPI } from "nuvo-react"; -import { useCallback, useMemo, useState } from "react"; - -import { useAuthorizedToken } from "../../authorization/use-authorized-token"; -import { CustomersImportingResults } from "../customers-results/customers-importing-results"; -import { - CustomerColumnSchema, - getCustomersModelColumns, - getResultModelSchema, -} from "./customers-columns-model"; - -let PassSubmitResult: any; -let RejectSubmitResult: any; - -const NuvoImporter = dynamic( - async () => { - return import("nuvo-react").then((item) => { - PassSubmitResult = item.PassSubmitResult; - RejectSubmitResult = item.RejectSubmitResult; - return item.NuvoImporter; - }); - }, - { - ssr: false, - loading() { - return Loading; - }, - }, -); - -const columns = getCustomersModelColumns(); - -const getNuvoSettings = (theme: DefaultTheme): SettingsAPI => { - const isDarkMode = theme === "defaultDark"; - - const dropdownStyles = { - option: { - color: "#111", - ":hover": { - background: "#eee", - }, - }, - header: { - background: "#fff", - color: "#eee", - }, - root: { - border: `1px solid #eee`, - background: "#fff", - color: "#111", - }, - search: { - root: { - background: "#fff", - color: "#111", - }, - }, - button: { - root: { - background: "#fff", - color: "#111", - maxHeight: "20px", - border: `1px solid #eee`, - }, - }, - } as const; - - return { - columns, - enableExamples: false, - developerMode: process.env.NEXT_PUBLIC_NUVO_PROD_MODE !== "true", - identifier: "customers", - modal: false, - style: { - sheetSelect: { - icon: { filter: isDarkMode ? "invert(1)" : "none" }, - }, - joinSheet: {}, - dialog: { closeIcon: { filter: isDarkMode ? "invert(1)" : "none" } }, - messagePopup: { - closeIcon: { - filter: isDarkMode ? "invert(1)" : "none", - }, - warnIcon: { - filter: isDarkMode ? "invert(1)" : "none", - }, - successIcon: { - filter: isDarkMode ? "invert(1)" : "none", - }, - }, - footer: { - root: { - background: "#fff", - }, - }, - buttons: { - primary: { - background: "black", - color: "#fff", - ":hover": { - backgroundColor: "black", - color: "#fff", - }, - }, - secondary: { - background: "#444", - color: "#fff", - border: "none", - ":hover": { - background: "#444", - color: "#fff", - }, - }, - }, - loader: { - loadAnimationColor: "#111", - content: { - color: "#111", - }, - }, - headerSelect: { - root: { - background: "#fff", - border: "none", - }, - table: { - selectRowColor: "#eee", - th: { - color: "#111", - background: "#fff", - }, - td: { - color: "#111", - background: "#fff", - }, - hoverRowColor: "#eee", - }, - sheetName: { - root: { - display: "none", - }, - }, - }, - columnMatch: { - icon: { - filter: isDarkMode ? "invert(1)" : "none", - }, - notMatchingValue: { - root: { - background: "#eee", - }, - icon: { - filter: isDarkMode ? "invert(1)" : "none", - }, - }, - buttonJoined: { - root: { - background: "#eee", - }, - }, - root: { - background: "#fff", - border: `1px solid #eee`, - }, - columnMatchHeader: { - dropdown: dropdownStyles, - root: { - background: "#fff", - border: `1px solid #eee`, - }, - icon: { - filter: isDarkMode ? "invert(1)" : "none", - }, - }, - columnMatchValue: { - icon: { - filter: isDarkMode ? "invert(1)" : "none", - }, - emptyValue: { - background: "#fff", - color: "#111", - }, - dropdown: dropdownStyles, - root: { - border: `1px solid #eee`, - background: "#fff", - }, - }, - }, - header: { - description: { - display: "none", - }, - title: { - fontSize: "18px", - }, - root: { - // display: "none", - color: "#111", - }, - }, - progressBar: { - icon: { - filter: isDarkMode ? "invert(1)" : "none", - }, - root: { - display: "none", - }, - }, - dropzone: { - icon: { - box: { - filter: "grayscale(1)", - }, - }, - root: { - background: "#fff", - border: "1px dashed #eee", - }, - }, - reviewEntries: { - icon: { - filter: isDarkMode ? "invert(1)" : "none", - }, - root: { - backgroundColor: "#fff", - }, - infoIcon: { - filter: isDarkMode ? "invert(1)" : "none", - }, - moreIcon: { - filter: isDarkMode ? "invert(1)" : "none", - }, - table: { - th: { - backgroundColor: "#fff", - }, - td: { - normal: { - backgroundColor: "#fff", - }, - root: { - backgroundColor: "#fff", - }, - }, - }, - }, - globals: { - fontFamily: "Inter", - backgroundColor: "#fff", - textColor: "#111", - primaryTextColor: "#111", - secondaryTextColor: "#222", - }, - }, - title: "Upload customers to Saleor", - disableExcelTemplate: true, - disableTemplates: true, - allowManualInput: true, - }; -}; - -const licenseKey = process.env.NEXT_PUBLIC_NUVO_LICENSE_KEY as string; - -export const CustomersImporterView = () => { - const authorized = useAuthorizedToken("MANAGE_USERS"); - const saleorTheme = useTheme(); - - const [importedLines, setImportedLines] = useState(null); - - const handleResults: OnResults = useCallback((resultArray) => { - const parsedResult = resultArray.map((row) => - getResultModelSchema().parse(dotObject.object(row)), - ); - - setImportedLines(parsedResult); - }, []); - - const nuvoSettings = useMemo(() => { - return getNuvoSettings(saleorTheme.theme); - }, [saleorTheme]); - - if (authorized === undefined) { - return
Authorizing
; - } - - if (authorized === false) { - return To use this importer you need MANAGER_USERS permission; - } - - if (importedLines) { - return ; - } - - return ( -
- { - return ( - - ); - }} - onResults={handleResults} - licenseKey={licenseKey} - settings={nuvoSettings} - /> -
- ); -}; diff --git a/apps/data-importer/src/modules/customers/customers-results/customer-importing-row.tsx b/apps/data-importer/src/modules/customers/customers-results/customer-importing-row.tsx deleted file mode 100644 index 540282bb8..000000000 --- a/apps/data-importer/src/modules/customers/customers-results/customer-importing-row.tsx +++ /dev/null @@ -1,98 +0,0 @@ -import { actions, useAppBridge } from "@saleor/app-sdk/app-bridge"; -import { Box, Button, CheckboxIcon } from "@saleor/macaw-ui"; -import { useCallback, useEffect } from "react"; -import { useCustomerCreateMutation } from "../../../../generated/graphql"; -import { CustomerColumnSchema } from "../customers-importer-nuvo/customers-columns-model"; - -type Props = { - importedModel: CustomerColumnSchema; - doImport: boolean; -}; - -const ImportedStatus = ({ id }: { id: string }) => { - const { appBridge } = useAppBridge(); - - return ( - - { - appBridge?.dispatch( - actions.Redirect({ - // newContext: true, // open in new context but dashboard has a bug here - to: `/customers/${id}`, - }), - ); - }} - > - Imported with ID {id} - - - ); -}; - -const ErrorStatus = ({ message, onRetry }: { message: string; onRetry(): void }) => { - return ( - - Error importing: {message} - - - ); -}; -const PendingStatus = () => ( - - Importing... - -); - -export const CustomerImportingRow = (props: Props) => { - const [mutationResult, mutate] = useCustomerCreateMutation(); - const triggerMutation = useCallback(() => { - mutate({ - input: { - ...props.importedModel.customerCreate, - // todo map address - defaultShippingAddress: null, - defaultBillingAddress: null, - isActive: false, - }, - }); - }, [props.importedModel, mutate]); - - useEffect(() => { - if ( - props.doImport && - !mutationResult.data && - !mutationResult.error && - !mutationResult.fetching - ) { - triggerMutation(); - } - }, [props.doImport, mutate, mutationResult, triggerMutation]); - - const renderStatus = () => { - if (mutationResult.data?.customerCreate?.user?.id) { - return ; - } - - if (mutationResult.data?.customerCreate?.errors) { - return ( - - ); - } - - if (mutationResult.fetching) { - return ; - } - }; - - return ( - - {props.importedModel.customerCreate.email} - {renderStatus()} - - ); -}; diff --git a/apps/data-importer/src/modules/customers/customers-results/customers-importing-results.tsx b/apps/data-importer/src/modules/customers/customers-results/customers-importing-results.tsx deleted file mode 100644 index 78aa45a25..000000000 --- a/apps/data-importer/src/modules/customers/customers-results/customers-importing-results.tsx +++ /dev/null @@ -1,49 +0,0 @@ -import { Box, Button, Text } from "@saleor/macaw-ui"; -import { useState } from "react"; - -import { CustomerColumnSchema } from "../customers-importer-nuvo/customers-columns-model"; -import { CustomerImportingRow } from "./customer-importing-row"; - -export const CustomersImportingResults = ({ - importedLines, -}: { - importedLines: CustomerColumnSchema[]; -}) => { - const [importingStarted, setImportingStarted] = useState(false); - - return ( -
- - Customers rows from the imported file - - - - Lines will be imported one by one. Failed imports can be retried, but performed operations - must be reverted manually. Users will be set to inactive. - - - Customers will not be informed or notified by this operation. - - - {!importingStarted && ( - - )} - - - {importedLines.map((row) => ( - - ))} - -
- ); -}; diff --git a/apps/data-importer/src/no-ssr-wrapper.tsx b/apps/data-importer/src/no-ssr-wrapper.tsx deleted file mode 100644 index 4917e33a3..000000000 --- a/apps/data-importer/src/no-ssr-wrapper.tsx +++ /dev/null @@ -1,8 +0,0 @@ -import React, { PropsWithChildren } from "react"; -import dynamic from "next/dynamic"; - -const Wrapper = (props: PropsWithChildren<{}>) => {props.children}; - -export const NoSSRWrapper = dynamic(() => Promise.resolve(Wrapper), { - ssr: false, -}); diff --git a/apps/data-importer/src/pages/_app.tsx b/apps/data-importer/src/pages/_app.tsx deleted file mode 100644 index cba9b77b5..000000000 --- a/apps/data-importer/src/pages/_app.tsx +++ /dev/null @@ -1,44 +0,0 @@ -import { AppBridge, AppBridgeProvider } from "@saleor/app-sdk/app-bridge"; -import { RoutePropagator } from "@saleor/app-sdk/app-bridge/next"; -import "@saleor/apps-shared/src/globals.css"; -import "../styles/globals.css"; - -import { AppProps } from "next/app"; -import { useEffect } from "react"; - -import { ThemeProvider } from "@saleor/macaw-ui"; -import { NoSSRWrapper } from "../no-ssr-wrapper"; -import { ThemeSynchronizer } from "@saleor/apps-shared"; - -/** - * Ensure instance is a singleton. - * TODO: This is React 18 issue, consider hiding this workaround inside app-sdk - */ -const appBridgeInstance = typeof window !== "undefined" ? new AppBridge() : undefined; - -function NextApp({ Component, pageProps }: AppProps) { - /** - * Configure JSS (used by MacawUI) for SSR. If Macaw is not used, can be removed. - */ - useEffect(() => { - const jssStyles = document.querySelector("#jss-server-side"); - - if (jssStyles) { - jssStyles?.parentElement?.removeChild(jssStyles); - } - }, []); - - return ( - - - - - - - - - - ); -} - -export default NextApp; diff --git a/apps/data-importer/src/pages/api/manifest.ts b/apps/data-importer/src/pages/api/manifest.ts deleted file mode 100644 index 0624d31ec..000000000 --- a/apps/data-importer/src/pages/api/manifest.ts +++ /dev/null @@ -1,46 +0,0 @@ -import { createManifestHandler } from "@saleor/app-sdk/handlers/next"; -import { AppManifest } from "@saleor/app-sdk/types"; - -import packageJson from "../../../package.json"; - -export default createManifestHandler({ - async manifestFactory({ appBaseUrl }) { - const iframeBaseUrl = process.env.APP_IFRAME_BASE_URL ?? appBaseUrl; - const apiBaseURL = process.env.APP_API_BASE_URL ?? appBaseUrl; - - const manifest: AppManifest = { - about: - "Data Importer allows batch import of shop data to Saleor from sources like CSV or Excel", - appUrl: iframeBaseUrl, - author: "Saleor Commerce", - brand: { - logo: { - default: `${apiBaseURL}/logo.png`, - }, - }, - dataPrivacyUrl: "https://saleor.io/legal/privacy/", - extensions: [ - /** - * Optionally, extend Dashboard with custom UIs - * https://docs.saleor.io/docs/3.x/developer/extending/apps/extending-dashboard-with-apps - */ - ], - homepageUrl: "https://github.com/saleor/apps", - id: "saleor.app.data-importer", - name: "Data Importer", - permissions: ["MANAGE_USERS"], - supportUrl: "https://github.com/saleor/apps/discussions", - tokenTargetUrl: `${apiBaseURL}/api/register`, - version: packageJson.version, - webhooks: [ - /** - * Configure webhooks here. They will be created in Saleor during installation - * Read more - * https://docs.saleor.io/docs/3.x/developer/api-reference/objects/webhook - */ - ], - }; - - return manifest; - }, -}); diff --git a/apps/data-importer/src/pages/api/register.ts b/apps/data-importer/src/pages/api/register.ts deleted file mode 100644 index 4596d1404..000000000 --- a/apps/data-importer/src/pages/api/register.ts +++ /dev/null @@ -1,28 +0,0 @@ -import { createAppRegisterHandler } from "@saleor/app-sdk/handlers/next"; - -import { saleorApp } from "../../../saleor-app"; - -const allowedUrlsPattern = process.env.ALLOWED_DOMAIN_PATTERN; - -/** - * Required endpoint, called by Saleor to install app. - * It will exchange tokens with app, so saleorApp.apl will contain token - */ -export default createAppRegisterHandler({ - apl: saleorApp.apl, - /** - * Prohibit installation from Saleors other than specified by the regex. - * Regex source is ENV so if ENV is not set, all installations will be allowed. - */ - allowedSaleorUrls: [ - (url) => { - if (allowedUrlsPattern) { - const regex = new RegExp(allowedUrlsPattern); - - return regex.test(url); - } - - return true; - }, - ], -}); diff --git a/apps/data-importer/src/pages/importer.tsx b/apps/data-importer/src/pages/importer.tsx deleted file mode 100644 index e737edb31..000000000 --- a/apps/data-importer/src/pages/importer.tsx +++ /dev/null @@ -1,37 +0,0 @@ -import { Box } from "@saleor/macaw-ui"; -import { NextPage } from "next"; -import { ComponentProps } from "react"; -import { CustomersImporterView } from "../modules/customers/customers-importer-nuvo/customers-importer-view"; -import { GraphQLProvider } from "../providers/GraphQLProvider"; -import { useAppBridge } from "@saleor/app-sdk/app-bridge"; -import { Text } from "@saleor/macaw-ui"; - -const ImporterPage: NextPage = () => { - return ( -
- - - -
- ); -}; - -const WrappedPage = (props: ComponentProps) => { - const { appBridgeState } = useAppBridge(); - - if (!appBridgeState) { - return null; - } - - if (appBridgeState.user?.permissions.includes("MANAGE_APPS") === false) { - return You do not have permission to access this page.; - } - - return ( - - - - ); -}; - -export default WrappedPage; diff --git a/apps/data-importer/src/pages/index.tsx b/apps/data-importer/src/pages/index.tsx deleted file mode 100644 index 62e6c7404..000000000 --- a/apps/data-importer/src/pages/index.tsx +++ /dev/null @@ -1,33 +0,0 @@ -import { NextPage } from "next"; -import { useAppBridge } from "@saleor/app-sdk/app-bridge"; -import { useEffect } from "react"; -import { useIsMounted } from "usehooks-ts"; -import { useRouter } from "next/router"; -import { isInIframe } from "@saleor/apps-shared"; -import { Text } from "@saleor/macaw-ui"; - -const IndexPage: NextPage = () => { - const { appBridgeState } = useAppBridge(); - const isMounted = useIsMounted(); - const { replace } = useRouter(); - - useEffect(() => { - if (isMounted() && appBridgeState?.ready) { - replace("/importer"); - } - }, [isMounted, appBridgeState?.ready, replace]); - - if (isInIframe()) { - return Loading - } - - return ( -
-

Saleor Data Importer

-

This is Saleor App that allows importing data from CSV

-

Install app in your Saleor instance and open in with Dashboard

-
- ); -}; - -export default IndexPage; diff --git a/apps/data-importer/src/providers/GraphQLProvider.tsx b/apps/data-importer/src/providers/GraphQLProvider.tsx deleted file mode 100644 index 9bdda65f7..000000000 --- a/apps/data-importer/src/providers/GraphQLProvider.tsx +++ /dev/null @@ -1,15 +0,0 @@ -import { useAppBridge } from "@saleor/app-sdk/app-bridge"; -import { createGraphQLClient } from "@saleor/apps-shared"; -import { PropsWithChildren } from "react"; -import { Provider } from "urql"; - -export function GraphQLProvider(props: PropsWithChildren<{}>) { - const { appBridgeState } = useAppBridge(); - - const client = createGraphQLClient({ - saleorApiUrl: appBridgeState?.saleorApiUrl!, - token: appBridgeState?.token!, - }); - - return ; -} diff --git a/apps/data-importer/src/setup-tests.ts b/apps/data-importer/src/setup-tests.ts deleted file mode 100644 index 5f1e19846..000000000 --- a/apps/data-importer/src/setup-tests.ts +++ /dev/null @@ -1,6 +0,0 @@ -/** - * Add test setup logic here - * - * https://vitest.dev/config/#setupfiles - */ -export {}; diff --git a/apps/data-importer/src/styles/globals.css b/apps/data-importer/src/styles/globals.css deleted file mode 100644 index 9bdd0d0e0..000000000 --- a/apps/data-importer/src/styles/globals.css +++ /dev/null @@ -1,16 +0,0 @@ -body { - font-family: Inter, -apple-system, "system-ui", "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, - "Fira Sans", "Droid Sans", "Helvetica Neue", sans-serif; - color: #111; -} - -code { - background: #f6f8fa; - border: 1px solid #eaeaea; - border-radius: 5px; - display: inline-block; - margin-top: 10px; - padding: 0.75rem; - font-family: Menlo, Monaco, Lucida Console, Liberation Mono, DejaVu Sans Mono, - Bitstream Vera Sans Mono, Courier New, monospace; -} diff --git a/apps/data-importer/tsconfig.json b/apps/data-importer/tsconfig.json deleted file mode 100644 index 3ff0501fd..000000000 --- a/apps/data-importer/tsconfig.json +++ /dev/null @@ -1,20 +0,0 @@ -{ - "compilerOptions": { - "target": "es5", - "lib": ["dom", "dom.iterable", "esnext"], - "allowJs": true, - "skipLibCheck": true, - "strict": true, - "forceConsistentCasingInFileNames": true, - "noEmit": true, - "esModuleInterop": true, - "module": "esnext", - "moduleResolution": "node", - "resolveJsonModule": true, - "isolatedModules": true, - "jsx": "preserve", - "incremental": true - }, - "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", "next.config.js"], - "exclude": ["node_modules"] -} diff --git a/apps/data-importer/turbo.json b/apps/data-importer/turbo.json deleted file mode 100644 index ea046dbee..000000000 --- a/apps/data-importer/turbo.json +++ /dev/null @@ -1,29 +0,0 @@ -{ - "$schema": "https://turbo.build/schema.json", - "extends": ["//"], - "pipeline": { - "build": { - "env": [ - "NODE_ENV", - "APL", - "NEXT_PUBLIC_NUVO_LICENSE_KEY", - "NEXT_PUBLIC_VERCEL_ENV", - "NEXT_PUBLIC_NUVO_PROD_MODE", - "APP_DEBUG", - "SECRET_KEY", - "ALLOWED_DOMAIN_PATTERN", - "REST_APL_ENDPOINT", - "REST_APL_TOKEN", - "NEXT_PUBLIC_VERCEL_ENV", - "VERCEL_URL", - "PORT", - "SENTRY_AUTH_TOKEN", - "APP_IFRAME_BASE_URL", - "APP_API_BASE_URL", - "SENTRY_ORG", - "SENTRY_PROJECT", - "NEXT_PUBLIC_SENTRY_DSN" - ] - } - } -} diff --git a/apps/data-importer/vitest.config.ts b/apps/data-importer/vitest.config.ts deleted file mode 100644 index 1dde5bc44..000000000 --- a/apps/data-importer/vitest.config.ts +++ /dev/null @@ -1,13 +0,0 @@ -import react from "@vitejs/plugin-react"; -import { defineConfig } from "vitest/config"; - -// https://vitejs.dev/config/ -export default defineConfig({ - plugins: [react()], - test: { - passWithNoTests: true, - environment: "jsdom", - setupFiles: "./src/setup-tests.ts", - css: false, - }, -}); diff --git a/cspell.json b/cspell.json index 8b984da9a..7d3d97aa3 100644 --- a/cspell.json +++ b/cspell.json @@ -40,7 +40,6 @@ "Mjml", "Mollie", "Nextjs", - "Nuvo", "opentelemetry", "otel", "OTLP", diff --git a/packages/e2e/tests/apps-installation.spec.ts b/packages/e2e/tests/apps-installation.spec.ts index 4e6c1ea72..8db319a44 100644 --- a/packages/e2e/tests/apps-installation.spec.ts +++ b/packages/e2e/tests/apps-installation.spec.ts @@ -1,5 +1,6 @@ import { Page, test } from "@playwright/test"; import { AppManifest } from "@saleor/app-sdk/types"; + import { assertAppAvailable } from "./assertions/assert-app-available"; import { installTheApp } from "./operations/install-app"; import { logInIntoDashboard } from "./operations/log-in-to-dashboard"; @@ -18,7 +19,6 @@ const apps: string[] = [ "klaviyo", "slack", "invoices", - "data-importer", ].reduce>((urls, appSegment) => { urls.push(`https://${appSegment}.saleor.app`); urls.push(`https://${appSegment}.staging.saleor.app`);