github.com/r0busta/go-shopify-graphql-model@v0.0.4/schema.graphql (about) 1 """Marks an element of a GraphQL schema as having restricted access.""" 2 directive @accessRestricted( 3 """Explains the reason around this restriction""" 4 reason: String = null 5 ) on FIELD_DEFINITION | OBJECT 6 7 """Amazon Web Services ARN.""" 8 scalar ARN 9 10 """ 11 Represents the access scope permission that is applicable to a merchant's shop, such as `read_orders`. 12 13 """ 14 type AccessScope { 15 """Description of the access scopes enabled on an api permission.""" 16 description: String! 17 18 """A human-friendly string for an access scope.""" 19 handle: String! 20 } 21 22 """Whether all items in the cart are entitled to the discount.""" 23 type AllDiscountItems { 24 """Whether all items are selected. The value is hardcoded to `true`.""" 25 allItems: Boolean! 26 } 27 28 """A version of the API.""" 29 type ApiVersion { 30 """The human-readable name of the version.""" 31 displayName: String! 32 33 """ 34 The unique identifier of an ApiVersion. All supported API versions have a date-based (YYYY-MM) or `unstable` handle. 35 """ 36 handle: String! 37 38 """Whether the version is supported by Shopify.""" 39 supported: Boolean! 40 } 41 42 """A Shopify application.""" 43 type App implements Node { 44 """A unique application API identifier.""" 45 apiKey: String! 46 47 """App store page URL of the app.""" 48 appStoreAppUrl: URL 49 50 """App store page URL of the developer who created the app.""" 51 appStoreDeveloperUrl: URL 52 53 """Banner image for the app.""" 54 banner: Image! 55 56 """Description of the app.""" 57 description: String 58 59 """App's developer name.""" 60 developerName: String 61 62 """Website of the developer who created the app.""" 63 developerUrl: URL! @deprecated(reason: "Use `appStoreDeveloperUrl` instead") 64 65 """Whether the app uses the Embedded App SDK.""" 66 embedded: Boolean! 67 68 """Requirements that must be met before the app can be installed.""" 69 failedRequirements: [FailedRequirement!]! 70 71 """List of app features.""" 72 features: [String!]! 73 74 """Feedback from this app about the store.""" 75 feedback: AppFeedback 76 77 """Handle of the app.""" 78 handle: String 79 80 """Icon that represents the app.""" 81 icon: Image! 82 83 """Globally unique identifier.""" 84 id: ID! 85 86 """Webpage where you can install the app.""" 87 installUrl: URL 88 89 """ 90 Corresponding AppInstallation for this shop and App. 91 Returns null if the App is not installed. 92 93 """ 94 installation: AppInstallation 95 96 """Webpage that the app starts in.""" 97 launchUrl: URL! @deprecated(reason: "Use AppInstallation.launchUrl instead") 98 99 """ 100 Menu items for the app, which also appear as submenu items in left navigation sidebar in the Shopify admin. 101 102 """ 103 navigationItems: [NavigationItem!]! @deprecated(reason: "Use AppInstallation.navigationItems instead") 104 105 """Detailed information about the app pricing.""" 106 pricingDetails: String 107 108 """Summary of the app pricing details.""" 109 pricingDetailsSummary: String! 110 111 """Link to app privacy policy.""" 112 privacyPolicyUrl: URL 113 114 """Whether the app is published.""" 115 published: Boolean! 116 117 """Screenshots of the app.""" 118 screenshots: [Image!]! 119 120 """Whether the app was developed by Shopify.""" 121 shopifyDeveloped: Boolean! 122 123 """Name of the app.""" 124 title: String! 125 126 """ 127 Message that appears when the app is uninstalled. For example: 128 By removing this app, you will no longer be able to publish products to MySocialSite or view this app in your Shopify admin. You can re-enable this channel at any time. 129 130 """ 131 uninstallMessage: String! 132 133 """Webpage where you can uninstall the app.""" 134 uninstallUrl: URL @deprecated(reason: "Use AppInstallation.uninstallUrl instead") 135 } 136 137 """ 138 An auto-generated type for paginating through multiple Apps. 139 140 """ 141 type AppConnection { 142 """A list of edges.""" 143 edges: [AppEdge!]! 144 145 """Information to aid in pagination.""" 146 pageInfo: PageInfo! 147 } 148 149 """ 150 App credits can be applied by the merchant towards future app purchases, subscriptions, or usage records in Shopify. 151 """ 152 type AppCredit implements Node { 153 """The amount that can be used towards future app purchases in Shopify.""" 154 amount: MoneyV2! 155 156 """The date and time when the app credit was created.""" 157 createdAt: DateTime! 158 159 """The description of the app credit.""" 160 description: String! 161 162 """Globally unique identifier.""" 163 id: ID! 164 165 """Whether the app credit is a test transaction.""" 166 test: Boolean! 167 } 168 169 """ 170 An auto-generated type for paginating through multiple AppCredits. 171 172 """ 173 type AppCreditConnection { 174 """A list of edges.""" 175 edges: [AppCreditEdge!]! 176 177 """Information to aid in pagination.""" 178 pageInfo: PageInfo! 179 } 180 181 """Return type for `appCreditCreate` mutation.""" 182 type AppCreditCreatePayload { 183 """The newly created app credit.""" 184 appCredit: AppCredit 185 186 """List of errors that occurred executing the mutation.""" 187 userErrors: [UserError!]! 188 } 189 190 """ 191 An auto-generated type which holds one AppCredit and a cursor during pagination. 192 193 """ 194 type AppCreditEdge { 195 """A cursor for use in pagination.""" 196 cursor: String! 197 198 """The item at the end of AppCreditEdge.""" 199 node: AppCredit! 200 } 201 202 """ 203 An auto-generated type which holds one App and a cursor during pagination. 204 205 """ 206 type AppEdge { 207 """A cursor for use in pagination.""" 208 cursor: String! 209 210 """The item at the end of AppEdge.""" 211 node: App! 212 } 213 214 """ 215 Reports the status of shops and their resources and displays this information 216 within Shopify admin. AppFeedback is used to notify merchants about steps they need to take 217 to set up an app on their store. 218 219 """ 220 type AppFeedback { 221 # """The application associated to the feedback.""" 222 # app: App! 223 224 """A link to where merchants can resolve errors.""" 225 link: Link 226 227 """The feedback message presented to the merchant.""" 228 messages: [UserError!]! 229 } 230 231 """Represents an installed application on a shop.""" 232 type AppInstallation implements Node { 233 """Access scopes granted to an app by a merchant during installation.""" 234 accessScopes: [AccessScope!]! 235 236 """Active subscriptions charged to a shop on a recurring basis.""" 237 activeSubscriptions: [AppSubscription!]! 238 239 """All subscriptions created for a shop.""" 240 allSubscriptions( 241 """Returns up to the first `n` elements from the list.""" 242 first: Int 243 244 """Returns the elements that come after the specified cursor.""" 245 after: String 246 247 """Returns up to the last `n` elements from the list.""" 248 last: Int 249 250 """Returns the elements that come before the specified cursor.""" 251 before: String 252 253 """Reverse the order of the underlying list.""" 254 reverse: Boolean = false 255 256 """Sort the underlying list by the given key.""" 257 sortKey: AppSubscriptionSortKeys = CREATED_AT 258 ): AppSubscriptionConnection! 259 260 """Application which is installed.""" 261 app: App! 262 263 """Channel associated with the installed application.""" 264 channel: Channel @deprecated(reason: "Use `publication` instead") 265 266 """Credits that can be used towards future app purchases.""" 267 credits( 268 """Returns up to the first `n` elements from the list.""" 269 first: Int 270 271 """Returns the elements that come after the specified cursor.""" 272 after: String 273 274 """Returns up to the last `n` elements from the list.""" 275 last: Int 276 277 """Returns the elements that come before the specified cursor.""" 278 before: String 279 280 """Reverse the order of the underlying list.""" 281 reverse: Boolean = false 282 283 """Sort the underlying list by the given key.""" 284 sortKey: AppTransactionSortKeys = CREATED_AT 285 ): AppCreditConnection! 286 287 """Globally unique identifier.""" 288 id: ID! 289 290 """Url used to launch the app.""" 291 launchUrl: URL! 292 293 """One-time purchases to a shop.""" 294 oneTimePurchases( 295 """Returns up to the first `n` elements from the list.""" 296 first: Int 297 298 """Returns the elements that come after the specified cursor.""" 299 after: String 300 301 """Returns up to the last `n` elements from the list.""" 302 last: Int 303 304 """Returns the elements that come before the specified cursor.""" 305 before: String 306 307 """Reverse the order of the underlying list.""" 308 reverse: Boolean = false 309 310 """Sort the underlying list by the given key.""" 311 sortKey: AppTransactionSortKeys = CREATED_AT 312 ): AppPurchaseOneTimeConnection! 313 314 """Publication associated with the installed application.""" 315 publication: Publication 316 317 """Subscriptions charge to a shop on a recurring basis.""" 318 subscriptions: [AppSubscription!]! @deprecated(reason: "Use `activeSubscriptions` instead") 319 320 """Webpage where you can uninstall the app.""" 321 uninstallUrl: URL 322 } 323 324 """Possible categories of an app installation.""" 325 enum AppInstallationCategory { 326 """Sales channel apps.""" 327 CHANNEL 328 329 """Apps that can be used in the POS mobile client.""" 330 POS_EMBEDDED 331 } 332 333 """ 334 An auto-generated type for paginating through multiple AppInstallations. 335 336 """ 337 type AppInstallationConnection { 338 """A list of edges.""" 339 edges: [AppInstallationEdge!]! 340 341 """Information to aid in pagination.""" 342 pageInfo: PageInfo! 343 } 344 345 """ 346 An auto-generated type which holds one AppInstallation and a cursor during pagination. 347 348 """ 349 type AppInstallationEdge { 350 """A cursor for use in pagination.""" 351 cursor: String! 352 353 """The item at the end of AppInstallationEdge.""" 354 node: AppInstallation! 355 } 356 357 """Possible privacy types of an app installation.""" 358 enum AppInstallationPrivacy { 359 PUBLIC 360 PRIVATE 361 } 362 363 """The set of valid sort keys for the AppInstallation query.""" 364 enum AppInstallationSortKeys { 365 """Sort by the `installed_at` value.""" 366 INSTALLED_AT 367 368 """Sort by the `app_title` value.""" 369 APP_TITLE 370 371 """Sort by the `id` value.""" 372 ID 373 374 """ 375 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 376 results by relevance to the search term(s). When no search query is specified, this sort key is not 377 deterministic and should not be used. 378 379 """ 380 RELEVANCE 381 } 382 383 """Defines the pricing model for the app subscription.""" 384 input AppPlanInput { 385 """Usage based billing pricing details.""" 386 appUsagePricingDetails: AppUsagePricingInput 387 388 """Recurring based billing pricing details.""" 389 appRecurringPricingDetails: AppRecurringPricingInput 390 } 391 392 """Defines the app plan the merchant is subscribed to.""" 393 type AppPlanV2 { 394 """Defines the pricing model for the app subscription.""" 395 pricingDetails: AppPricingDetails! 396 } 397 398 """Information about the price charged to a shop every plan period.""" 399 union AppPricingDetails = AppRecurringPricing | AppUsagePricing 400 401 """The billing frequency for the app.""" 402 enum AppPricingInterval { 403 """The merchant is billed for this app annually.""" 404 ANNUAL 405 406 """The merchant is billed for this app every 30 days.""" 407 EVERY_30_DAYS 408 } 409 410 """Services and features purchased once by the store.""" 411 interface AppPurchase { 412 """The date and time when the app purchase was created.""" 413 createdAt: DateTime! 414 415 """The name of the app purchase.""" 416 name: String! 417 418 """The amount to be charged to the store for the app purchase.""" 419 price: MoneyV2! 420 421 """ 422 The status of the app purchase. Possible values include pending, active, declined and cancelled. 423 """ 424 status: AppPurchaseStatus! 425 426 """Whether the app purchase is a test transaction.""" 427 test: Boolean! 428 } 429 430 """Services and features purchased once by a store.""" 431 type AppPurchaseOneTime implements AppPurchase & Node { 432 """The date and time when the app purchase was created.""" 433 createdAt: DateTime! 434 435 """Globally unique identifier.""" 436 id: ID! 437 438 """The name of the app purchase.""" 439 name: String! 440 441 """The amount to be charged to the store for the app purchase.""" 442 price: MoneyV2! 443 444 """ 445 The status of the app purchase. Possible values include pending, active, declined and cancelled. 446 """ 447 status: AppPurchaseStatus! 448 449 """Whether the app purchase is a test transaction.""" 450 test: Boolean! 451 } 452 453 """ 454 An auto-generated type for paginating through multiple AppPurchaseOneTimes. 455 456 """ 457 type AppPurchaseOneTimeConnection { 458 """A list of edges.""" 459 edges: [AppPurchaseOneTimeEdge!]! 460 461 """Information to aid in pagination.""" 462 pageInfo: PageInfo! 463 } 464 465 """Return type for `appPurchaseOneTimeCreate` mutation.""" 466 type AppPurchaseOneTimeCreatePayload { 467 """The newly created app one-time purchase.""" 468 appPurchaseOneTime: AppPurchaseOneTime 469 470 """ 471 The URL where the merchant can approve or decline the app one-time purchase. 472 """ 473 confirmationUrl: URL 474 475 """List of errors that occurred executing the mutation.""" 476 userErrors: [UserError!]! 477 } 478 479 """ 480 An auto-generated type which holds one AppPurchaseOneTime and a cursor during pagination. 481 482 """ 483 type AppPurchaseOneTimeEdge { 484 """A cursor for use in pagination.""" 485 cursor: String! 486 487 """The item at the end of AppPurchaseOneTimeEdge.""" 488 node: AppPurchaseOneTime! 489 } 490 491 """The status of the purchase.""" 492 enum AppPurchaseStatus { 493 """ 494 The app purchase has been approved by the merchant and is ready to be activated by the app. App purchases created through the GraphQL Admin API are activated upon approval. 495 """ 496 ACCEPTED 497 498 """ 499 The app purchase has been activated by the app. Active app purchases are charged to the store and partners receive payouts for active app purchase. 500 """ 501 ACTIVE 502 503 """The app purchase was declined by the merchant.""" 504 DECLINED 505 506 """The app purchase was not accepted within 2 days of being created.""" 507 EXPIRED 508 509 """The app purchase is pending approval by the merchant.""" 510 PENDING 511 } 512 513 """Price charged every interval.""" 514 type AppRecurringPricing { 515 """ 516 Specifies the number of days in a billing cycle of the app subscription. 517 """ 518 interval: AppPricingInterval! 519 520 """The amount to be charged to the store every billing interval.""" 521 price: MoneyV2! 522 } 523 524 """Allows an app to charge per billing interval.""" 525 input AppRecurringPricingInput { 526 """Specifies the billing frequency of the app subscription.""" 527 interval: AppPricingInterval = EVERY_30_DAYS 528 529 """ 530 The amount to be charged to the store every billing interval. The only permitted currency code is USD. 531 """ 532 price: MoneyInput! 533 } 534 535 """ 536 Provides users access to services and/or features for a duration of time. 537 """ 538 type AppSubscription implements Node { 539 """The date and time when the app subscription was created.""" 540 createdAt: DateTime! 541 542 """The date and time when the current app subscription period ends.""" 543 currentPeriodEnd: DateTime 544 545 """Globally unique identifier.""" 546 id: ID! 547 548 """Attaches a plan to an app subscription.""" 549 lineItems: [AppSubscriptionLineItem!]! 550 551 """The name of the app subscription.""" 552 name: String! 553 554 """ 555 The URL where the merchant is redirected after approving the app subscription. 556 """ 557 returnUrl: URL! 558 559 """ 560 The status of the app subscription. Possible values include pending, active, declined, 561 expired, frozen, and cancelled. 562 """ 563 status: AppSubscriptionStatus! 564 565 """Specifies whether the app subscription is a test transaction.""" 566 test: Boolean! 567 568 """The number of days of the free trial.""" 569 trialDays: Int! 570 } 571 572 """Return type for `appSubscriptionCancel` mutation.""" 573 type AppSubscriptionCancelPayload { 574 """The cancelled app subscription.""" 575 appSubscription: AppSubscription 576 577 """List of errors that occurred executing the mutation.""" 578 userErrors: [UserError!]! 579 } 580 581 """ 582 An auto-generated type for paginating through multiple AppSubscriptions. 583 584 """ 585 type AppSubscriptionConnection { 586 """A list of edges.""" 587 edges: [AppSubscriptionEdge!]! 588 589 """Information to aid in pagination.""" 590 pageInfo: PageInfo! 591 } 592 593 """Return type for `appSubscriptionCreate` mutation.""" 594 type AppSubscriptionCreatePayload { 595 """The newly created app subscription.""" 596 appSubscription: AppSubscription 597 598 """The URL where the merchant approves or declines an app subscription.""" 599 confirmationUrl: URL 600 601 """List of errors that occurred executing the mutation.""" 602 userErrors: [UserError!]! 603 } 604 605 """ 606 An auto-generated type which holds one AppSubscription and a cursor during pagination. 607 608 """ 609 type AppSubscriptionEdge { 610 """A cursor for use in pagination.""" 611 cursor: String! 612 613 """The item at the end of AppSubscriptionEdge.""" 614 node: AppSubscription! 615 } 616 617 """Attaches a plan to an app subscription.""" 618 type AppSubscriptionLineItem { 619 """Globally unique identifier.""" 620 id: ID! 621 622 """Defines the pricing model for the app subscription.""" 623 plan: AppPlanV2! 624 625 """Lists the store's usage for a usage pricing plan.""" 626 usageRecords( 627 """Returns up to the first `n` elements from the list.""" 628 first: Int 629 630 """Returns the elements that come after the specified cursor.""" 631 after: String 632 633 """Returns up to the last `n` elements from the list.""" 634 last: Int 635 636 """Returns the elements that come before the specified cursor.""" 637 before: String 638 639 """Reverse the order of the underlying list.""" 640 reverse: Boolean = false 641 642 """Sort the underlying list by the given key.""" 643 sortKey: AppUsageRecordSortKeys = CREATED_AT 644 ): AppUsageRecordConnection! 645 } 646 647 """Allows an app to add more than one plan to an app subscription.""" 648 input AppSubscriptionLineItemInput { 649 """Defines the pricing model for the app subscription.""" 650 plan: AppPlanInput! 651 } 652 653 """Return type for `appSubscriptionLineItemUpdate` mutation.""" 654 type AppSubscriptionLineItemUpdatePayload { 655 """The updated app subscription.""" 656 appSubscription: AppSubscription 657 658 """ 659 The URL where the merchant approves or declines the updated app subscription line item. 660 """ 661 confirmationUrl: URL 662 663 """List of errors that occurred executing the mutation.""" 664 userErrors: [UserError!]! 665 } 666 667 """The set of valid sort keys for the AppSubscription query.""" 668 enum AppSubscriptionSortKeys { 669 """Sort by the `created_at` value.""" 670 CREATED_AT 671 672 """Sort by the `id` value.""" 673 ID 674 675 """ 676 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 677 results by relevance to the search term(s). When no search query is specified, this sort key is not 678 deterministic and should not be used. 679 680 """ 681 RELEVANCE 682 } 683 684 """The status of the app subscription.""" 685 enum AppSubscriptionStatus { 686 """The app subscription is pending approval by the merchant.""" 687 PENDING 688 689 """ 690 The app subscription has been approved by the merchant and is ready to be activated by the app. App subscriptions created through the GraphQL Admin API are activated upon approval. 691 """ 692 ACCEPTED 693 694 """ 695 The app subscription has been activated by the app. Active app subscriptions are charged to the store and partners recieve payouts for active app subscriptions. 696 """ 697 ACTIVE 698 699 """The app subscription was declined by the merchant.""" 700 DECLINED 701 702 """The app subscription was not accepted within 2 days of being created.""" 703 EXPIRED 704 705 """ 706 The app subscription is on hold due to a store subscription non-payment. The charge will re-activate once subscription payments resume. 707 """ 708 FROZEN 709 710 """The app subscription was cancelled by the app.""" 711 CANCELLED 712 } 713 714 """The set of valid sort keys for the AppTransaction query.""" 715 enum AppTransactionSortKeys { 716 """Sort by the `created_at` value.""" 717 CREATED_AT 718 719 """Sort by the `id` value.""" 720 ID 721 722 """ 723 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 724 results by relevance to the search term(s). When no search query is specified, this sort key is not 725 deterministic and should not be used. 726 727 """ 728 RELEVANCE 729 } 730 731 """Defines the usage pricing model for the app subscription.""" 732 type AppUsagePricing { 733 """The total usage records for interval.""" 734 balanceUsed: MoneyV2! 735 736 """The limit a store can be charged for usage based pricing.""" 737 cappedAmount: MoneyV2! 738 739 """Specifies the interval which usage records are applied.""" 740 interval: AppPricingInterval! 741 742 """The terms and conditions for app usage pricing.""" 743 terms: String! 744 } 745 746 """Allows an app to charge a store for usage.""" 747 input AppUsagePricingInput { 748 """The limit a customer can be charged for usage based pricing.""" 749 cappedAmount: MoneyInput! 750 751 """The terms and conditions for app usage.""" 752 terms: String! 753 } 754 755 """Store usage for app subscriptions with usage pricing.""" 756 type AppUsageRecord implements Node { 757 """The date and time when the usage record was created.""" 758 createdAt: DateTime! 759 760 """The description of the app usage record.""" 761 description: String! 762 763 """Globally unique identifier.""" 764 id: ID! 765 766 """ 767 The price of the usage record. The only permitted currency code is USD. 768 """ 769 price: MoneyV2! 770 771 # """Defines the usage pricing plan the merchant is subscribed to.""" 772 # subscriptionLineItem: AppSubscriptionLineItem! 773 } 774 775 """ 776 An auto-generated type for paginating through multiple AppUsageRecords. 777 778 """ 779 type AppUsageRecordConnection { 780 """A list of edges.""" 781 edges: [AppUsageRecordEdge!]! 782 783 """Information to aid in pagination.""" 784 pageInfo: PageInfo! 785 } 786 787 """Return type for `appUsageRecordCreate` mutation.""" 788 type AppUsageRecordCreatePayload { 789 """The newly created app usage record.""" 790 appUsageRecord: AppUsageRecord 791 792 """List of errors that occurred executing the mutation.""" 793 userErrors: [UserError!]! 794 } 795 796 """ 797 An auto-generated type which holds one AppUsageRecord and a cursor during pagination. 798 799 """ 800 type AppUsageRecordEdge { 801 """A cursor for use in pagination.""" 802 cursor: String! 803 804 """The item at the end of AppUsageRecordEdge.""" 805 node: AppUsageRecord! 806 } 807 808 """The set of valid sort keys for the AppUsageRecord query.""" 809 enum AppUsageRecordSortKeys { 810 """Sort by the `created_at` value.""" 811 CREATED_AT 812 813 """Sort by the `id` value.""" 814 ID 815 816 """ 817 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 818 results by relevance to the search term(s). When no search query is specified, this sort key is not 819 deterministic and should not be used. 820 821 """ 822 RELEVANCE 823 } 824 825 """Represents a generic custom attribute.""" 826 type Attribute { 827 """Key or name of the attribute.""" 828 key: String! 829 830 """Value of the attribute.""" 831 value: String 832 } 833 834 """Specifies the input fields required for an attribute.""" 835 input AttributeInput { 836 """Key or name of the attribute.""" 837 key: String! 838 839 """Value of the attribute.""" 840 value: String! 841 } 842 843 """ 844 Automatic discount applications capture the intentions of a discount that was automatically applied. 845 846 """ 847 type AutomaticDiscountApplication implements DiscountApplication { 848 """ 849 The method by which the discount's value is allocated to its entitled items. 850 """ 851 allocationMethod: DiscountApplicationAllocationMethod! 852 853 """ 854 An ordered index that can be used to identify the discount application and indicate the precedence 855 of the discount application for calculations. 856 857 """ 858 index: Int! 859 860 """How the discount amount is distributed on the discounted lines.""" 861 targetSelection: DiscountApplicationTargetSelection! 862 863 """Whether the discount is applied on line items or shipping lines.""" 864 targetType: DiscountApplicationTargetType! 865 866 """The title of the discount application.""" 867 title: String! 868 869 """The value of the discount application.""" 870 value: PricingValue! 871 } 872 873 """The set of valid sort keys for the AutomaticDiscount query.""" 874 enum AutomaticDiscountSortKeys { 875 """Sort by the `created_at` value.""" 876 CREATED_AT 877 878 """Sort by the `id` value.""" 879 ID 880 881 """ 882 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 883 results by relevance to the search term(s). When no search query is specified, this sort key is not 884 deterministic and should not be used. 885 886 """ 887 RELEVANCE 888 } 889 890 """ 891 Basic events chronicle resource activities such as the creation of an article, the fulfillment of an order, or 892 the addition of a product. 893 894 """ 895 type BasicEvent implements Node & Event { 896 """ 897 The name of the app that created the event. Returns null when the event originates from the Shopify admin. 898 """ 899 appTitle: String 900 901 """Whether the event was created by an app.""" 902 attributeToApp: Boolean! 903 904 """Whether the event was caused by an admin user.""" 905 attributeToUser: Boolean! 906 907 """The date and time when the event was created.""" 908 createdAt: DateTime! 909 910 """Whether the event is critical.""" 911 criticalAlert: Boolean! 912 913 """Globally unique identifier.""" 914 id: ID! 915 916 """Human readable text that describes the event.""" 917 message: FormattedString! 918 } 919 920 """ 921 Represents an error that happens during the execution of a billing attempt mutation. 922 """ 923 type BillingAttemptUserError implements DisplayableError { 924 """Error code to uniquely identify the error.""" 925 code: BillingAttemptUserErrorCode 926 927 """Path to the input field which caused the error.""" 928 field: [String!] 929 930 """The error message.""" 931 message: String! 932 } 933 934 """ 935 Possible error codes that could be returned by BillingAttemptUserError. 936 """ 937 enum BillingAttemptUserErrorCode { 938 """Input value is invalid.""" 939 INVALID 940 941 """Input value is blank.""" 942 BLANK 943 944 """Subscription contract does not exist.""" 945 CONTRACT_NOT_FOUND 946 } 947 948 """ 949 An asynchronous long-running operation to fetch data in bulk. 950 951 Bulk operations are created using the `bulkOperationRunQuery` mutation. After they are created, 952 clients should poll the `status` field for updates. When `COMPLETED`, the `url` field contains 953 a link to the data in [JSONL](http://jsonlines.org/) format. 954 955 See the [bulk operations guide](https://help.shopify.com/api/guides/bulk-operations) for more details. 956 957 """ 958 type BulkOperation implements Node { 959 """When the bulk operation was successfully completed.""" 960 completedAt: DateTime 961 962 """When the bulk operation was created.""" 963 createdAt: DateTime! 964 965 """Error code for failed operations.""" 966 errorCode: BulkOperationErrorCode 967 968 """File size in bytes of the file in the `url` field.""" 969 fileSize: UnsignedInt64 970 971 """Globally unique identifier.""" 972 id: ID! 973 974 """ 975 The running count of all objects processed. 976 For example, when fetching all products and their variants, this field counts both products and variants. 977 This field can be used to track operation progress. 978 979 """ 980 objectCount: UnsignedInt64! 981 982 """ 983 URL to partial/incomplete response data (in [JSONL](http://jsonlines.org/) format) returned by a failed operation. 984 Expires **one week** after the operation fails. Returns `null` when there's no data available. 985 986 """ 987 partialDataUrl: URL 988 989 """GraphQL query document specified in `bulkOperationRunQuery`.""" 990 query: String! 991 992 """ 993 The running count of all objects processed at the root of the query. 994 For example, when fetching all products and their variants, this field counts only products. 995 This field can be used to track operation progress. 996 997 """ 998 rootObjectCount: UnsignedInt64! 999 1000 """Status of the bulk operation.""" 1001 status: BulkOperationStatus! 1002 1003 """ 1004 URL to the response data in [JSONL](http://jsonlines.org/) format. 1005 Expires **one week** after the operation completes. 1006 1007 """ 1008 url: URL 1009 } 1010 1011 """Return type for `bulkOperationCancel` mutation.""" 1012 type BulkOperationCancelPayload { 1013 """The bulk operation to be canceled.""" 1014 bulkOperation: BulkOperation 1015 1016 """List of errors that occurred executing the mutation.""" 1017 userErrors: [UserError!]! 1018 } 1019 1020 """Error codes for failed bulk operations.""" 1021 enum BulkOperationErrorCode { 1022 """ 1023 The provided operation `query` returned access denied due to missing 1024 [access scopes](https://help.shopify.com/api/getting-started/authentication/oauth/scopes). 1025 Review the requested object permissions and execute the query as a normal non-bulk GraphQL request to see more details. 1026 1027 """ 1028 ACCESS_DENIED 1029 1030 """ 1031 Operation resulted in partial or incomplete data due to internal server errors during execution. 1032 1033 """ 1034 INTERNAL_SERVER_ERROR 1035 1036 """ 1037 Operation resulted in partial or incomplete data due to query timeouts during execution. 1038 In some cases, timeouts can be avoided by modifying your `query` to select fewer fields. 1039 1040 """ 1041 TIMEOUT 1042 } 1043 1044 """Return type for `bulkOperationRunQuery` mutation.""" 1045 type BulkOperationRunQueryPayload { 1046 """The newly created bulk operation.""" 1047 bulkOperation: BulkOperation 1048 1049 """List of errors that occurred executing the mutation.""" 1050 userErrors: [UserError!]! 1051 } 1052 1053 """Statuses of a bulk operation.""" 1054 enum BulkOperationStatus { 1055 """Operation created.""" 1056 CREATED 1057 1058 """Operation running.""" 1059 RUNNING 1060 1061 """Operation completed.""" 1062 COMPLETED 1063 1064 """Operation canceling.""" 1065 CANCELING 1066 1067 """Operation canceled.""" 1068 CANCELED 1069 1070 """Operation failed.""" 1071 FAILED 1072 1073 """Operation URL has expired.""" 1074 EXPIRED 1075 } 1076 1077 """ 1078 Discount code applications capture the intentions of a discount code at 1079 the time that it is applied onto an order. 1080 1081 """ 1082 type CalculatedAutomaticDiscountApplication implements CalculatedDiscountApplication { 1083 """ 1084 The method by which the discount's value is allocated to its entitled items. 1085 """ 1086 allocationMethod: DiscountApplicationAllocationMethod! 1087 1088 """ 1089 The level at which the discount was applied. 1090 1091 """ 1092 appliedTo: DiscountApplicationLevel! 1093 1094 """ 1095 The description of discount application. Indicates the reason why the discount was applied. 1096 """ 1097 description: String 1098 1099 """Globally unique identifier.""" 1100 id: ID! 1101 1102 """How the discount amount is distributed on the discounted lines.""" 1103 targetSelection: DiscountApplicationTargetSelection! 1104 1105 """Whether the discount is applied on line items or shipping lines.""" 1106 targetType: DiscountApplicationTargetType! 1107 1108 """The value of the discount application.""" 1109 value: PricingValue! 1110 } 1111 1112 """ 1113 An amount discounting the line that has been allocated by an associated discount application. 1114 1115 """ 1116 type CalculatedDiscountAllocation { 1117 """ 1118 The money amount allocated by the discount application in shop and presentment currencies. 1119 """ 1120 allocatedAmountSet: MoneyBag! 1121 1122 """The discount that the allocated amount originated from.""" 1123 discountApplication: CalculatedDiscountApplication! 1124 } 1125 1126 """ 1127 A discount application involved in order editing that might be newly added or have new changes applied. 1128 1129 """ 1130 interface CalculatedDiscountApplication { 1131 """ 1132 The method by which the discount's value is allocated to its entitled items. 1133 """ 1134 allocationMethod: DiscountApplicationAllocationMethod! 1135 1136 """ 1137 The level at which the discount was applied. 1138 1139 """ 1140 appliedTo: DiscountApplicationLevel! 1141 1142 """ 1143 The description of discount application. Indicates the reason why the discount was applied. 1144 """ 1145 description: String 1146 1147 """Globally unique identifier.""" 1148 id: ID! 1149 1150 """How the discount amount is distributed on the discounted lines.""" 1151 targetSelection: DiscountApplicationTargetSelection! 1152 1153 """Whether the discount is applied on line items or shipping lines.""" 1154 targetType: DiscountApplicationTargetType! 1155 1156 """The value of the discount application.""" 1157 value: PricingValue! 1158 } 1159 1160 """ 1161 An auto-generated type for paginating through multiple CalculatedDiscountApplications. 1162 1163 """ 1164 type CalculatedDiscountApplicationConnection { 1165 """A list of edges.""" 1166 edges: [CalculatedDiscountApplicationEdge!]! 1167 1168 """Information to aid in pagination.""" 1169 pageInfo: PageInfo! 1170 } 1171 1172 """ 1173 An auto-generated type which holds one CalculatedDiscountApplication and a cursor during pagination. 1174 1175 """ 1176 type CalculatedDiscountApplicationEdge { 1177 """A cursor for use in pagination.""" 1178 cursor: String! 1179 1180 """The item at the end of CalculatedDiscountApplicationEdge.""" 1181 node: CalculatedDiscountApplication! 1182 } 1183 1184 """ 1185 Discount code applications capture the intentions of a discount code at 1186 the time that it is applied onto an order. 1187 1188 """ 1189 type CalculatedDiscountCodeApplication implements CalculatedDiscountApplication { 1190 """ 1191 The method by which the discount's value is allocated to its entitled items. 1192 """ 1193 allocationMethod: DiscountApplicationAllocationMethod! 1194 1195 """ 1196 The level at which the discount was applied. 1197 1198 """ 1199 appliedTo: DiscountApplicationLevel! 1200 1201 """ 1202 The string identifying the discount code that was used at the time of application. 1203 """ 1204 code: String! 1205 1206 """ 1207 The description of discount application. Indicates the reason why the discount was applied. 1208 """ 1209 description: String 1210 1211 """Globally unique identifier.""" 1212 id: ID! 1213 1214 """How the discount amount is distributed on the discounted lines.""" 1215 targetSelection: DiscountApplicationTargetSelection! 1216 1217 """Whether the discount is applied on line items or shipping lines.""" 1218 targetType: DiscountApplicationTargetType! 1219 1220 """The value of the discount application.""" 1221 value: PricingValue! 1222 } 1223 1224 """The computed properties for a draft order.""" 1225 type CalculatedDraftOrder { 1226 """Order-level discount applied to the draft order.""" 1227 appliedDiscount: DraftOrderAppliedDiscount 1228 1229 """ 1230 The available shipping rates for the draft order. Requires a customer with a valid shipping address and at least one line item. 1231 """ 1232 availableShippingRates: [ShippingRate!]! 1233 1234 """ 1235 Customer who will be sent an invoice for the draft order, if there is one. 1236 """ 1237 customer: Customer 1238 1239 """Line items in the draft order with their computed properties.""" 1240 lineItems: [CalculatedDraftOrderLineItem!]! 1241 1242 """Line item that contains the shipping costs.""" 1243 shippingLine: ShippingLine 1244 1245 """ 1246 Subtotal of the line items and their discounts (does not contain shipping charges or shipping discounts, or taxes). 1247 1248 """ 1249 subtotalPrice: Money! 1250 1251 """Total amount of taxes charged for each line item and shipping line.""" 1252 taxLines: [TaxLine!]! 1253 1254 """ 1255 Total amount of the draft order (includes taxes, shipping charges, and discounts). 1256 """ 1257 totalPrice: Money! 1258 1259 """Total shipping charge for the draft order.""" 1260 totalShippingPrice: Money! 1261 1262 """Total amount of taxes for the draft order.""" 1263 totalTax: Money! 1264 } 1265 1266 """The computed line items for a draft order.""" 1267 type CalculatedDraftOrderLineItem { 1268 """Discount applied to the line item.""" 1269 appliedDiscount: DraftOrderAppliedDiscount 1270 1271 """ 1272 Indicates if this is a product variant line item, or a custom line item. 1273 """ 1274 custom: Boolean! 1275 1276 """List of additional information (metafields) about the line item.""" 1277 customAttributes: [Attribute!]! 1278 1279 """Total price with discounts applied.""" 1280 discountedTotal: MoneyV2! 1281 1282 """Unit price with discounts applied.""" 1283 discountedUnitPrice: MoneyV2! 1284 1285 """ 1286 Name of the service provider who fulfilled the order. 1287 1288 Valid values are either **manual** or the name of the provider. 1289 For example, **amazon**, **shipwire**. 1290 1291 """ 1292 fulfillmentService: FulfillmentService! 1293 1294 """Image associated with the draft order line item.""" 1295 image: Image 1296 1297 """Indicates whether the line item represents the puchase of a gift card.""" 1298 isGiftCard: Boolean! 1299 1300 """Name of the product.""" 1301 name: String! 1302 1303 """ 1304 Total price (without discounts) of the line item, based on the original unit price of the variant x quantity. 1305 1306 """ 1307 originalTotal: MoneyV2! 1308 1309 """Variant price without any discounts applied.""" 1310 originalUnitPrice: MoneyV2! 1311 1312 """Product associated with the draft order line item.""" 1313 product: Product 1314 1315 """Number of variant items requested in the draft order.""" 1316 quantity: Int! 1317 1318 """Whether physical shipping is required for the variant.""" 1319 requiresShipping: Boolean! 1320 1321 """Variant SKU number.""" 1322 sku: String 1323 1324 """Whether the variant is taxable.""" 1325 taxable: Boolean! 1326 1327 """ 1328 Title of the product or variant (this field only applies to custom line items). 1329 """ 1330 title: String! 1331 1332 """Total value of the discount.""" 1333 totalDiscount: MoneyV2! 1334 1335 """Variant associated with the draft order line item.""" 1336 variant: ProductVariant 1337 1338 """Name of the variant.""" 1339 variantTitle: String 1340 1341 """Name of the vendor who made the variant.""" 1342 vendor: String 1343 1344 """Weight unit and value for a draft order line item.""" 1345 weight: Weight 1346 } 1347 1348 """ 1349 A line item involved in order editing that may be newly added or have new changes applied. 1350 1351 """ 1352 type CalculatedLineItem { 1353 """ 1354 The discounts that have been allocated onto the line item by discount applications. 1355 """ 1356 calculatedDiscountAllocations: [CalculatedDiscountAllocation!]! 1357 1358 """List of additional information (metafields) about the line item.""" 1359 customAttributes: [Attribute!]! 1360 1361 """ 1362 The discounts that have been allocated onto the line item by discount applications. 1363 """ 1364 discountAllocations: [DiscountAllocation!]! @deprecated(reason: "Use `calculatedDiscountAllocations` instead") 1365 1366 """ 1367 The total line price after discounts are applied in shop and presentment currencies. 1368 """ 1369 discountedUnitPriceSet: MoneyBag! 1370 1371 """The total number of items that can be edited.""" 1372 editableQuantity: Int! 1373 1374 """The editable quantity prior to any changes made in the current edit.""" 1375 editableQuantityBeforeChanges: Int! 1376 1377 """The total price of editable lines in shop and presentment currencies.""" 1378 editableSubtotalSet: MoneyBag! 1379 1380 """Whether the calculated line item has a staged discount.""" 1381 hasStagedLineItemDiscount: Boolean! 1382 1383 """Globally unique identifier.""" 1384 id: ID! 1385 1386 """The Image object associated to the line item's variant.""" 1387 image: Image 1388 1389 """ 1390 Variant price without any discounts applied in shop and presentment currencies. 1391 """ 1392 originalUnitPriceSet: MoneyBag! 1393 1394 """The total number of items.""" 1395 quantity: Int! 1396 1397 """Whether the line item can be restocked or not.""" 1398 restockable: Boolean! 1399 1400 """Whether the changes on the line item will result in a restock.""" 1401 restocking: Boolean! 1402 1403 """Variant SKU number.""" 1404 sku: String 1405 1406 """A list of changes that affect this line item.""" 1407 stagedChanges: [OrderStagedChange!]! 1408 1409 """Title of the product or variant.""" 1410 title: String! 1411 1412 """ 1413 The total price of uneditable lines in shop and presentment currencies. 1414 """ 1415 uneditableSubtotalSet: MoneyBag! 1416 1417 """ 1418 The product variant associated with this line item. Will be null for custom line items and items whose 1419 variant has been deleted. 1420 1421 """ 1422 variant: ProductVariant 1423 1424 """Name of the variant.""" 1425 variantTitle: String 1426 } 1427 1428 """ 1429 An auto-generated type for paginating through multiple CalculatedLineItems. 1430 1431 """ 1432 type CalculatedLineItemConnection { 1433 """A list of edges.""" 1434 edges: [CalculatedLineItemEdge!]! 1435 1436 """Information to aid in pagination.""" 1437 pageInfo: PageInfo! 1438 } 1439 1440 """ 1441 An auto-generated type which holds one CalculatedLineItem and a cursor during pagination. 1442 1443 """ 1444 type CalculatedLineItemEdge { 1445 """A cursor for use in pagination.""" 1446 cursor: String! 1447 1448 """The item at the end of CalculatedLineItemEdge.""" 1449 node: CalculatedLineItem! 1450 } 1451 1452 """ 1453 Manual discount applications capture the intentions of a discount that was manually created for an order. 1454 1455 """ 1456 type CalculatedManualDiscountApplication implements CalculatedDiscountApplication { 1457 """ 1458 The method by which the discount's value is allocated to its entitled items. 1459 """ 1460 allocationMethod: DiscountApplicationAllocationMethod! 1461 1462 """ 1463 The level at which the discount was applied. 1464 1465 """ 1466 appliedTo: DiscountApplicationLevel! 1467 1468 """ 1469 The description of discount application. Indicates the reason why the discount was applied. 1470 """ 1471 description: String 1472 1473 """Globally unique identifier.""" 1474 id: ID! 1475 1476 """How the discount amount is distributed on the discounted lines.""" 1477 targetSelection: DiscountApplicationTargetSelection! 1478 1479 """Whether the discount is applied on line items or shipping lines.""" 1480 targetType: DiscountApplicationTargetType! 1481 1482 """The value of the discount application.""" 1483 value: PricingValue! 1484 } 1485 1486 """ 1487 An order with edits applied but not saved. 1488 1489 """ 1490 type CalculatedOrder implements Node { 1491 """ 1492 Returns only the new discount applications being added to the order. 1493 1494 """ 1495 addedDiscountApplications( 1496 """Returns up to the first `n` elements from the list.""" 1497 first: Int 1498 1499 """Returns the elements that come after the specified cursor.""" 1500 after: String 1501 1502 """Returns up to the last `n` elements from the list.""" 1503 last: Int 1504 1505 """Returns the elements that come before the specified cursor.""" 1506 before: String 1507 1508 """Reverse the order of the underlying list.""" 1509 reverse: Boolean = false 1510 ): CalculatedDiscountApplicationConnection! 1511 1512 """ 1513 Returns only the new line items being added to the order. 1514 1515 """ 1516 addedLineItems( 1517 """Returns up to the first `n` elements from the list.""" 1518 first: Int 1519 1520 """Returns the elements that come after the specified cursor.""" 1521 after: String 1522 1523 """Returns up to the last `n` elements from the list.""" 1524 last: Int 1525 1526 """Returns the elements that come before the specified cursor.""" 1527 before: String 1528 1529 """Reverse the order of the underlying list.""" 1530 reverse: Boolean = false 1531 ): CalculatedLineItemConnection! 1532 1533 """ 1534 Amount of the order-level discount (does not contain any line item discounts) in shop and presentment currencies. 1535 """ 1536 cartDiscountAmountSet: MoneyBag 1537 1538 """Will be true when the changes have been applied to the order.""" 1539 committed: Boolean! 1540 1541 """Globally unique identifier.""" 1542 id: ID! 1543 1544 """ 1545 Returns all items on the order that existed before starting the edit. 1546 will include any changes that have been made. 1547 1548 """ 1549 lineItems( 1550 """Returns up to the first `n` elements from the list.""" 1551 first: Int 1552 1553 """Returns the elements that come after the specified cursor.""" 1554 after: String 1555 1556 """Returns up to the last `n` elements from the list.""" 1557 last: Int 1558 1559 """Returns the elements that come before the specified cursor.""" 1560 before: String 1561 1562 """Reverse the order of the underlying list.""" 1563 reverse: Boolean = false 1564 1565 """ 1566 Supported filter parameters: 1567 - `editable` 1568 1569 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 1570 for more information about using filters. 1571 1572 """ 1573 query: String 1574 ): CalculatedLineItemConnection! 1575 1576 """The HTML of the customer notification for the order edit.""" 1577 notificationPreviewHtml: HTML 1578 1579 """The customer notification title.""" 1580 notificationPreviewTitle: String! 1581 1582 """The order with changes applied.""" 1583 order: Order! @deprecated(reason: "Use `originalOrder` instead") 1584 1585 """ 1586 The order without any changes applied. 1587 1588 """ 1589 originalOrder: Order! 1590 1591 """ 1592 List of changes made on the order. 1593 1594 """ 1595 stagedChanges( 1596 """Returns up to the first `n` elements from the list.""" 1597 first: Int 1598 1599 """Returns the elements that come after the specified cursor.""" 1600 after: String 1601 1602 """Returns up to the last `n` elements from the list.""" 1603 last: Int 1604 1605 """Returns the elements that come before the specified cursor.""" 1606 before: String 1607 1608 """Reverse the order of the underlying list.""" 1609 reverse: Boolean = false 1610 ): OrderStagedChangeConnection! 1611 1612 """ 1613 The sum of the quantities for the line items that contribute to the order's subtotal. 1614 """ 1615 subtotalLineItemsQuantity: Int! 1616 1617 """ 1618 Subtotal of the line items and their discounts (does not contain shipping costs, shipping discounts) in shop and presentment currencies. 1619 """ 1620 subtotalPriceSet: MoneyBag 1621 1622 """Taxes charged for the line item.""" 1623 taxLines: [TaxLine!]! 1624 1625 """ 1626 Total price of the order less the total amount received from the customer in shop and presentment currencies. 1627 """ 1628 totalOutstandingSet: MoneyBag! 1629 1630 """ 1631 Total amount of the order (includes taxes and discounts) in shop and presentment currencies. 1632 """ 1633 totalPriceSet: MoneyBag! 1634 } 1635 1636 """ 1637 Discount code applications capture the intentions of a discount code at 1638 the time that it is applied onto an order. 1639 1640 """ 1641 type CalculatedScriptDiscountApplication implements CalculatedDiscountApplication { 1642 """ 1643 The method by which the discount's value is allocated to its entitled items. 1644 """ 1645 allocationMethod: DiscountApplicationAllocationMethod! 1646 1647 """ 1648 The level at which the discount was applied. 1649 1650 """ 1651 appliedTo: DiscountApplicationLevel! 1652 1653 """ 1654 The description of discount application. Indicates the reason why the discount was applied. 1655 """ 1656 description: String 1657 1658 """Globally unique identifier.""" 1659 id: ID! 1660 1661 """How the discount amount is distributed on the discounted lines.""" 1662 targetSelection: DiscountApplicationTargetSelection! 1663 1664 """Whether the discount is applied on line items or shipping lines.""" 1665 targetType: DiscountApplicationTargetType! 1666 1667 """The value of the discount application.""" 1668 value: PricingValue! 1669 } 1670 1671 """ 1672 A channel represents an app where you sell a group of products and collections. 1673 A channel can be a platform or marketplace such as Facebook or Pinterest, an online store, or POS. 1674 1675 """ 1676 type Channel implements Node { 1677 """Underlying app used by the channel.""" 1678 app: App! 1679 1680 """ 1681 The collection publications for the list of collections published to the channel. 1682 """ 1683 collectionPublicationsV3( 1684 """Returns up to the first `n` elements from the list.""" 1685 first: Int 1686 1687 """Returns the elements that come after the specified cursor.""" 1688 after: String 1689 1690 """Returns up to the last `n` elements from the list.""" 1691 last: Int 1692 1693 """Returns the elements that come before the specified cursor.""" 1694 before: String 1695 1696 """Reverse the order of the underlying list.""" 1697 reverse: Boolean = false 1698 ): ResourcePublicationConnection! 1699 1700 """The list of collections published to the channel.""" 1701 collections( 1702 """Returns up to the first `n` elements from the list.""" 1703 first: Int 1704 1705 """Returns the elements that come after the specified cursor.""" 1706 after: String 1707 1708 """Returns up to the last `n` elements from the list.""" 1709 last: Int 1710 1711 """Returns the elements that come before the specified cursor.""" 1712 before: String 1713 1714 """Reverse the order of the underlying list.""" 1715 reverse: Boolean = false 1716 ): CollectionConnection! 1717 1718 """Unique identifier for the channel.""" 1719 handle: String! @deprecated(reason: "Use `id` instead") 1720 1721 """Whether the collection is available to the channel.""" 1722 hasCollection( 1723 """Collection ID to check.""" 1724 id: ID! 1725 ): Boolean! 1726 1727 """Globally unique identifier.""" 1728 id: ID! 1729 1730 """Name of the channel.""" 1731 name: String! 1732 1733 """ 1734 Menu items for the channel, which also appear as submenu items in left navigation sidebar in the Shopify admin. 1735 1736 """ 1737 navigationItems: [NavigationItem!]! @deprecated(reason: "Use App.navigationItems instead") 1738 1739 """Home page for the channel.""" 1740 overviewPath: URL @deprecated(reason: "Use App.launchUrl instead") 1741 1742 """The product publications for the products published to the channel.""" 1743 productPublications( 1744 """Returns up to the first `n` elements from the list.""" 1745 first: Int 1746 1747 """Returns the elements that come after the specified cursor.""" 1748 after: String 1749 1750 """Returns up to the last `n` elements from the list.""" 1751 last: Int 1752 1753 """Returns the elements that come before the specified cursor.""" 1754 before: String 1755 1756 """Reverse the order of the underlying list.""" 1757 reverse: Boolean = false 1758 ): ProductPublicationConnection! @deprecated(reason: "Use `productPublicationsV3` instead") 1759 1760 """ 1761 The product publications for the list of products published to the channel. 1762 """ 1763 productPublicationsV3( 1764 """Returns up to the first `n` elements from the list.""" 1765 first: Int 1766 1767 """Returns the elements that come after the specified cursor.""" 1768 after: String 1769 1770 """Returns up to the last `n` elements from the list.""" 1771 last: Int 1772 1773 """Returns the elements that come before the specified cursor.""" 1774 before: String 1775 1776 """Reverse the order of the underlying list.""" 1777 reverse: Boolean = false 1778 ): ResourcePublicationConnection! 1779 1780 """The list of products published to the channel.""" 1781 products( 1782 """Returns up to the first `n` elements from the list.""" 1783 first: Int 1784 1785 """Returns the elements that come after the specified cursor.""" 1786 after: String 1787 1788 """Returns up to the last `n` elements from the list.""" 1789 last: Int 1790 1791 """Returns the elements that come before the specified cursor.""" 1792 before: String 1793 1794 """Reverse the order of the underlying list.""" 1795 reverse: Boolean = false 1796 ): ProductConnection! 1797 1798 """Whether or not this channel supports future publishing.""" 1799 supportsFuturePublishing: Boolean! 1800 } 1801 1802 """ 1803 An auto-generated type for paginating through multiple Channels. 1804 1805 """ 1806 type ChannelConnection { 1807 """A list of edges.""" 1808 edges: [ChannelEdge!]! 1809 1810 """Information to aid in pagination.""" 1811 pageInfo: PageInfo! 1812 } 1813 1814 """ 1815 An auto-generated type which holds one Channel and a cursor during pagination. 1816 1817 """ 1818 type ChannelEdge { 1819 """A cursor for use in pagination.""" 1820 cursor: String! 1821 1822 """The item at the end of ChannelEdge.""" 1823 node: Channel! 1824 } 1825 1826 """The set of valid sort keys for the CodeDiscount query.""" 1827 enum CodeDiscountSortKeys { 1828 """Sort by the `starts_at` value.""" 1829 STARTS_AT 1830 1831 """Sort by the `ends_at` value.""" 1832 ENDS_AT 1833 1834 """Sort by the `title` value.""" 1835 TITLE 1836 1837 """Sort by the `created_at` value.""" 1838 CREATED_AT 1839 1840 """Sort by the `updated_at` value.""" 1841 UPDATED_AT 1842 1843 """Sort by the `id` value.""" 1844 ID 1845 1846 """ 1847 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 1848 results by relevance to the search term(s). When no search query is specified, this sort key is not 1849 deterministic and should not be used. 1850 1851 """ 1852 RELEVANCE 1853 } 1854 1855 """ 1856 Represents a collection of products. 1857 1858 """ 1859 type Collection implements HasMetafields & Node & Publishable & HasPublishedTranslations { 1860 """ 1861 The number of publications a resource is published to without feedback errors. 1862 """ 1863 availablePublicationCount: Int! 1864 1865 """ 1866 The stripped description of the collection, in a single line with HTML tags removed. 1867 """ 1868 description( 1869 """Truncates string after the given length.""" 1870 truncateAt: Int 1871 ): String! 1872 1873 """The description of the collection, complete with HTML formatting.""" 1874 descriptionHtml: HTML! 1875 1876 """ 1877 Information about the collection that's provided through resource feedback. 1878 """ 1879 feedback: ResourceFeedback 1880 1881 """ 1882 A unique human-friendly string for the collection. Automatically generated from the collection's title. 1883 1884 """ 1885 handle: String! 1886 1887 """Whether the collection includes a product.""" 1888 hasProduct( 1889 """The ID of the product to check.""" 1890 id: ID! 1891 ): Boolean! 1892 1893 """Globally unique identifier.""" 1894 id: ID! 1895 1896 """The image associated with the collection.""" 1897 image( 1898 """ 1899 Image width in pixels between 1 and 2048. This argument is deprecated: Use `maxWidth` on `Image.transformedSrc` instead. 1900 """ 1901 maxWidth: Int 1902 1903 """ 1904 Image height in pixels between 1 and 2048. This argument is deprecated: Use `maxHeight` on `Image.transformedSrc` instead. 1905 """ 1906 maxHeight: Int 1907 1908 """ 1909 Crops the image according to the specified region. This argument is deprecated: Use `crop` on `Image.transformedSrc` instead. 1910 """ 1911 crop: CropRegion 1912 1913 """ 1914 Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use `scale` on `Image.transformedSrc` instead. 1915 """ 1916 scale: Int = 1 1917 ): Image 1918 1919 """The ID of the corresponding resource in the REST Admin API.""" 1920 legacyResourceId: UnsignedInt64! 1921 1922 """The metafield associated with the resource.""" 1923 metafield( 1924 """Container for a set of metafields (maximum of 20 characters).""" 1925 namespace: String! 1926 1927 """Identifier for the metafield (maximum of 30 characters).""" 1928 key: String! 1929 ): Metafield 1930 1931 """A paginated list of metafields associated with the resource.""" 1932 metafields( 1933 """Finds all metafields with a specific namespace under the resource.""" 1934 namespace: String 1935 1936 """Returns up to the first `n` elements from the list.""" 1937 first: Int 1938 1939 """Returns the elements that come after the specified cursor.""" 1940 after: String 1941 1942 """Returns up to the last `n` elements from the list.""" 1943 last: Int 1944 1945 """Returns the elements that come before the specified cursor.""" 1946 before: String 1947 1948 """Reverse the order of the underlying list.""" 1949 reverse: Boolean = false 1950 ): MetafieldConnection! 1951 1952 """Returns a private metafield found by namespace and key.""" 1953 privateMetafield( 1954 """The namespace for the private metafield.""" 1955 namespace: String! 1956 1957 """The key for the private metafield.""" 1958 key: String! 1959 ): PrivateMetafield 1960 1961 """List of private metafields.""" 1962 privateMetafields( 1963 """Filter the private metafields by namespace.""" 1964 namespace: String 1965 1966 """Returns up to the first `n` elements from the list.""" 1967 first: Int 1968 1969 """Returns the elements that come after the specified cursor.""" 1970 after: String 1971 1972 """Returns up to the last `n` elements from the list.""" 1973 last: Int 1974 1975 """Returns the elements that come before the specified cursor.""" 1976 before: String 1977 1978 """Reverse the order of the underlying list.""" 1979 reverse: Boolean = false 1980 ): PrivateMetafieldConnection! 1981 1982 """The products that are included in the collection.""" 1983 products( 1984 """Returns up to the first `n` elements from the list.""" 1985 first: Int 1986 1987 """Returns the elements that come after the specified cursor.""" 1988 after: String 1989 1990 """Returns up to the last `n` elements from the list.""" 1991 last: Int 1992 1993 """Returns the elements that come before the specified cursor.""" 1994 before: String 1995 1996 """Reverse the order of the underlying list.""" 1997 reverse: Boolean = false 1998 1999 """Sort the underlying list by the given key.""" 2000 sortKey: ProductCollectionSortKeys = COLLECTION_DEFAULT 2001 2002 """ 2003 This field is only used when the collection is smart. If the collection is custom it returns an error. 2004 Supported filter parameters: 2005 - `title` 2006 - `product_type` 2007 - `vendor` 2008 - `gift_card` 2009 - `created_at` 2010 - `updated_at` 2011 2012 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax). 2013 2014 """ 2015 query: String 2016 ): ProductConnection! 2017 2018 """The number of products included in the collection.""" 2019 productsCount: Int! 2020 2021 """The number of publications a resource is published on.""" 2022 publicationCount( 2023 """ 2024 Include only the resource's publications that are published. If false, then return all the resource's publications including future publications. 2025 """ 2026 onlyPublished: Boolean = true 2027 ): Int! 2028 2029 """The channels where the collection is published.""" 2030 publications( 2031 """ 2032 Whether or not to return only the collection publications that are published. 2033 """ 2034 onlyPublished: Boolean = true 2035 2036 """Returns up to the first `n` elements from the list.""" 2037 first: Int 2038 2039 """Returns the elements that come after the specified cursor.""" 2040 after: String 2041 2042 """Returns up to the last `n` elements from the list.""" 2043 last: Int 2044 2045 """Returns the elements that come before the specified cursor.""" 2046 before: String 2047 2048 """Reverse the order of the underlying list.""" 2049 reverse: Boolean = false 2050 ): CollectionPublicationConnection! @deprecated(reason: "Use `resourcePublications` instead") 2051 2052 """Check to see whether the resource is published to a given channel.""" 2053 publishedOnChannel( 2054 """The ID of the channel to check.""" 2055 channelId: ID! 2056 ): Boolean! @deprecated(reason: "Use `publishedOnPublication` instead") 2057 2058 """ 2059 Check to see whether the resource is published to the calling app's channel. 2060 """ 2061 publishedOnCurrentChannel: Boolean! @deprecated(reason: "Use `publishedOnCurrentPublication` instead") 2062 2063 """ 2064 Check to see whether the resource is published to the calling app's publication. 2065 """ 2066 publishedOnCurrentPublication: Boolean! 2067 2068 """Check to see whether the resource is published to a given publication.""" 2069 publishedOnPublication( 2070 """The ID of the publication to check.""" 2071 publicationId: ID! 2072 ): Boolean! 2073 2074 """The list of resources that are published to a publication.""" 2075 resourcePublications( 2076 """ 2077 Whether to return only the resources that are currently published. If false, then also returns the resources that are scheduled to be published. 2078 2079 """ 2080 onlyPublished: Boolean = true 2081 2082 """Returns up to the first `n` elements from the list.""" 2083 first: Int 2084 2085 """Returns the elements that come after the specified cursor.""" 2086 after: String 2087 2088 """Returns up to the last `n` elements from the list.""" 2089 last: Int 2090 2091 """Returns the elements that come before the specified cursor.""" 2092 before: String 2093 2094 """Reverse the order of the underlying list.""" 2095 reverse: Boolean = false 2096 ): ResourcePublicationConnection! 2097 2098 """ 2099 The list of resources that are either published or staged to be published to a publication. 2100 """ 2101 resourcePublicationsV2( 2102 """ 2103 Whether to return only the resources that are currently published. If false, then also returns the resources that are scheduled or staged to be published. 2104 2105 """ 2106 onlyPublished: Boolean = true 2107 2108 """Returns up to the first `n` elements from the list.""" 2109 first: Int 2110 2111 """Returns the elements that come after the specified cursor.""" 2112 after: String 2113 2114 """Returns up to the last `n` elements from the list.""" 2115 last: Int 2116 2117 """Returns the elements that come before the specified cursor.""" 2118 before: String 2119 2120 """Reverse the order of the underlying list.""" 2121 reverse: Boolean = false 2122 ): ResourcePublicationV2Connection! 2123 2124 """ 2125 The rules used to assign products to the collection. This applies only to smart collections. 2126 2127 """ 2128 ruleSet: CollectionRuleSet 2129 2130 """SEO information for the collection.""" 2131 seo: SEO! 2132 2133 """The order in which the collection's products are sorted.""" 2134 sortOrder: CollectionSortOrder! 2135 2136 """The storefront ID of the collection.""" 2137 storefrontId: StorefrontID! 2138 2139 """The theme template used when viewing this collection in a store.""" 2140 templateSuffix: String 2141 2142 """The title of the collection.""" 2143 title: String! 2144 2145 """The translations associated with the resource.""" 2146 translations( 2147 """Filters translations locale.""" 2148 locale: String! 2149 ): [PublishedTranslation!]! 2150 2151 """The list of channels that the resource is not published to.""" 2152 unpublishedChannels( 2153 """Returns up to the first `n` elements from the list.""" 2154 first: Int 2155 2156 """Returns the elements that come after the specified cursor.""" 2157 after: String 2158 2159 """Returns up to the last `n` elements from the list.""" 2160 last: Int 2161 2162 """Returns the elements that come before the specified cursor.""" 2163 before: String 2164 2165 """Reverse the order of the underlying list.""" 2166 reverse: Boolean = false 2167 ): ChannelConnection! @deprecated(reason: "Use `unpublishedPublications` instead") 2168 2169 """The list of publications that the resource is not published to.""" 2170 unpublishedPublications( 2171 """Returns up to the first `n` elements from the list.""" 2172 first: Int 2173 2174 """Returns the elements that come after the specified cursor.""" 2175 after: String 2176 2177 """Returns up to the last `n` elements from the list.""" 2178 last: Int 2179 2180 """Returns the elements that come before the specified cursor.""" 2181 before: String 2182 2183 """Reverse the order of the underlying list.""" 2184 reverse: Boolean = false 2185 ): PublicationConnection! 2186 2187 """ 2188 The date and time ([ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601)) when the collection was last modified. 2189 2190 """ 2191 updatedAt: DateTime! 2192 } 2193 2194 """Return type for `collectionAddProducts` mutation.""" 2195 type CollectionAddProductsPayload { 2196 """The updated collection.""" 2197 collection: Collection 2198 2199 """List of errors that occurred executing the mutation.""" 2200 userErrors: [UserError!]! 2201 } 2202 2203 """ 2204 An auto-generated type for paginating through multiple Collections. 2205 2206 """ 2207 type CollectionConnection { 2208 """A list of edges.""" 2209 edges: [CollectionEdge!]! 2210 2211 """Information to aid in pagination.""" 2212 pageInfo: PageInfo! 2213 } 2214 2215 """Return type for `collectionCreate` mutation.""" 2216 type CollectionCreatePayload { 2217 """The collection that has been created.""" 2218 collection: Collection 2219 2220 """List of errors that occurred executing the mutation.""" 2221 userErrors: [UserError!]! 2222 } 2223 2224 """Specifies the collection to delete.""" 2225 input CollectionDeleteInput { 2226 """The ID of the collection to be deleted.""" 2227 id: ID! 2228 } 2229 2230 """Return type for `collectionDelete` mutation.""" 2231 type CollectionDeletePayload { 2232 """The ID of the collection that was deleted.""" 2233 deletedCollectionId: ID 2234 2235 """The shop associated with the collection.""" 2236 shop: Shop! 2237 2238 """List of errors that occurred executing the mutation.""" 2239 userErrors: [UserError!]! 2240 } 2241 2242 """ 2243 An auto-generated type which holds one Collection and a cursor during pagination. 2244 2245 """ 2246 type CollectionEdge { 2247 """A cursor for use in pagination.""" 2248 cursor: String! 2249 2250 """The item at the end of CollectionEdge.""" 2251 node: Collection! 2252 } 2253 2254 """Specifies the input fields required to create a collection.""" 2255 input CollectionInput { 2256 """The description of the collection, in HTML format.""" 2257 descriptionHtml: String 2258 2259 """ 2260 A unique human-friendly string for the collection. Automatically generated from the collection's title. 2261 2262 """ 2263 handle: String 2264 2265 """ 2266 Specifies the collection to update or create a new collection if absent. 2267 """ 2268 id: ID 2269 2270 """The image associated with the collection.""" 2271 image: ImageInput 2272 2273 """ 2274 Initial list of collection products. Only valid with `productCreate` and without rules. 2275 """ 2276 products: [ID!] 2277 2278 """ 2279 Initial list of collection publications. Only valid with `productCreate`. This argument is deprecated: Use PublishablePublish instead. 2280 """ 2281 publications: [CollectionPublicationInput!] 2282 2283 """The private metafields to associated with this product.""" 2284 privateMetafields: [PrivateMetafieldInput!] 2285 2286 """ 2287 The rules used to assign products to the collection. 2288 2289 """ 2290 ruleSet: CollectionRuleSetInput 2291 2292 """The theme template used when viewing the collection in a store.""" 2293 templateSuffix: String 2294 2295 """The order in which the collection's products are sorted.""" 2296 sortOrder: CollectionSortOrder 2297 2298 """Required for creating a new collection.""" 2299 title: String 2300 2301 """The metafields to associate with this collection.""" 2302 metafields: [MetafieldInput!] 2303 2304 """SEO information for the collection.""" 2305 seo: SEOInput 2306 2307 """ 2308 Indicates whether a redirect is required after a new handle has been provided. 2309 If true, then the old handle is redirected to the new one automatically. 2310 2311 """ 2312 redirectNewHandle: Boolean = false 2313 } 2314 2315 """Represents the publications where a collection is published.""" 2316 type CollectionPublication { 2317 """The channel where the collection will be published.""" 2318 channel: Channel! @deprecated(reason: "Use `publication` instead") 2319 2320 """The collection to be published on the publication.""" 2321 collection: Collection! 2322 2323 """Whether the publication is published or not.""" 2324 isPublished: Boolean! 2325 2326 """The publication where the collection will be published.""" 2327 publication: Publication! 2328 2329 """The date that the publication was or is going to be published.""" 2330 publishDate: DateTime! 2331 } 2332 2333 """ 2334 An auto-generated type for paginating through multiple CollectionPublications. 2335 2336 """ 2337 type CollectionPublicationConnection { 2338 """A list of edges.""" 2339 edges: [CollectionPublicationEdge!]! 2340 2341 """Information to aid in pagination.""" 2342 pageInfo: PageInfo! 2343 } 2344 2345 """ 2346 An auto-generated type which holds one CollectionPublication and a cursor during pagination. 2347 2348 """ 2349 type CollectionPublicationEdge { 2350 """A cursor for use in pagination.""" 2351 cursor: String! 2352 2353 """The item at the end of CollectionPublicationEdge.""" 2354 node: CollectionPublication! 2355 } 2356 2357 """Specifies the publications to which a collection will be published.""" 2358 input CollectionPublicationInput { 2359 """The ID of the publication.""" 2360 publicationId: ID 2361 2362 """ 2363 The ID of the channel. This argument is deprecated: Use publicationId instead. 2364 """ 2365 channelId: ID 2366 2367 """This argument is deprecated: Use publicationId instead.""" 2368 channelHandle: String 2369 } 2370 2371 """ 2372 Specifies a collection to publish and the sales channels to publish it to. 2373 """ 2374 input CollectionPublishInput { 2375 """The collection to create or update publications for.""" 2376 id: ID! 2377 2378 """The channels where the collection will be published.""" 2379 collectionPublications: [CollectionPublicationInput!]! 2380 } 2381 2382 """Return type for `collectionPublish` mutation.""" 2383 type CollectionPublishPayload { 2384 """The published collection.""" 2385 collection: Collection 2386 2387 """The channels where the collection has been published.""" 2388 collectionPublications: [CollectionPublication!] 2389 2390 """The shop associated with the collection.""" 2391 shop: Shop! 2392 2393 """List of errors that occurred executing the mutation.""" 2394 userErrors: [UserError!]! 2395 } 2396 2397 """Return type for `collectionRemoveProducts` mutation.""" 2398 type CollectionRemoveProductsPayload { 2399 """The asynchronous job removing the products.""" 2400 job: Job 2401 2402 """List of errors that occurred executing the mutation.""" 2403 userErrors: [UserError!]! 2404 } 2405 2406 """Return type for `collectionReorderProducts` mutation.""" 2407 type CollectionReorderProductsPayload { 2408 """The asynchronous job reordering the products.""" 2409 job: Job 2410 2411 """List of errors that occurred executing the mutation.""" 2412 userErrors: [UserError!]! 2413 } 2414 2415 """Represents at rule that's used to assign products to a collection.""" 2416 type CollectionRule { 2417 """ 2418 The attribute that the rule focuses on (for example, `title` or `product_type`). 2419 """ 2420 column: CollectionRuleColumn! 2421 2422 """The value that the operator is applied to (for example, `Hats`).""" 2423 condition: String! 2424 2425 """ 2426 The type of operator that the rule is based on (for example, `equals`, `contains`, or `not_equals`). 2427 2428 """ 2429 relation: CollectionRuleRelation! 2430 } 2431 2432 """ 2433 Specifies the property of a product being used to populate the smart collection. 2434 """ 2435 enum CollectionRuleColumn { 2436 """The `tag` attribute.""" 2437 TAG 2438 2439 """The `title` attribute.""" 2440 TITLE 2441 2442 """The `type` attribute.""" 2443 TYPE 2444 2445 """The `vendor` attribute.""" 2446 VENDOR 2447 2448 """The `variant_price` attribute.""" 2449 VARIANT_PRICE 2450 2451 """The `is_price_reduced` attribute.""" 2452 IS_PRICE_REDUCED 2453 2454 """The `variant_compare_at_price` attribute.""" 2455 VARIANT_COMPARE_AT_PRICE 2456 2457 """The `variant_weight` attribute.""" 2458 VARIANT_WEIGHT 2459 2460 """The `variant_inventory` attribute.""" 2461 VARIANT_INVENTORY 2462 2463 """The `variant_title` attribute.""" 2464 VARIANT_TITLE 2465 } 2466 2467 """ 2468 Collections may use rules to automatically include the matching products. This defines restrictions for a type of rule. 2469 """ 2470 type CollectionRuleConditions { 2471 """Allowed relations of the rule.""" 2472 allowedRelations: [CollectionRuleRelation!]! 2473 2474 """Most commonly used relation for this rule.""" 2475 defaultRelation: CollectionRuleRelation! 2476 2477 """Type of the rule.""" 2478 ruleType: CollectionRuleColumn! 2479 } 2480 2481 """Specifies a rule to associate with a collection.""" 2482 input CollectionRuleInput { 2483 """ 2484 The attribute that the rule focuses on (for example, `title` or `product_type`). 2485 """ 2486 column: CollectionRuleColumn! 2487 2488 """ 2489 The type of operator that the rule is based on (for example, `equals`, `contains`, or `not_equals`). 2490 2491 """ 2492 relation: CollectionRuleRelation! 2493 2494 """The value that the operator is applied to (for example, `Hats`).""" 2495 condition: String! 2496 } 2497 2498 """Specifies the relationship between the `column` and the condition.""" 2499 enum CollectionRuleRelation { 2500 """The attribute contains the condition.""" 2501 CONTAINS 2502 2503 """The attribute ends with the condition.""" 2504 ENDS_WITH 2505 2506 """The attribute is equal to the condition.""" 2507 EQUALS 2508 2509 """The attribute is greater than the condition.""" 2510 GREATER_THAN 2511 2512 """The attribute is not set.""" 2513 IS_NOT_SET 2514 2515 """The attribute is set.""" 2516 IS_SET 2517 2518 """The attribute is less than the condition.""" 2519 LESS_THAN 2520 2521 """The attribute does not contain the condition.""" 2522 NOT_CONTAINS 2523 2524 """The attribute does not equal the condition.""" 2525 NOT_EQUALS 2526 2527 """The attribute starts with the condition.""" 2528 STARTS_WITH 2529 } 2530 2531 """ 2532 The set of rules that are used to determine which products are included in the collection. 2533 """ 2534 type CollectionRuleSet { 2535 """ 2536 Whether products must match any or all of the rules to be included in the collection. 2537 If true, then products must match one or more of the rules to be included in the collection. 2538 If false, then products must match all of the rules to be included in the collection. 2539 2540 """ 2541 appliedDisjunctively: Boolean! 2542 2543 """The rules used to assign products to the collection.""" 2544 rules: [CollectionRule!]! 2545 } 2546 2547 """Specifies a rule set for the collection.""" 2548 input CollectionRuleSetInput { 2549 """ 2550 Whether products must match any or all of the rules to be included in the collection. 2551 If true, then products must match one or more of the rules to be included in the collection. 2552 If false, then products must match all of the rules to be included in the collection. 2553 2554 """ 2555 appliedDisjunctively: Boolean! 2556 2557 """The rules used to assign products to the collection.""" 2558 rules: [CollectionRuleInput!] 2559 } 2560 2561 """The set of valid sort keys for the Collection query.""" 2562 enum CollectionSortKeys { 2563 """Sort by the `title` value.""" 2564 TITLE 2565 2566 """Sort by the `updated_at` value.""" 2567 UPDATED_AT 2568 2569 """Sort by the `id` value.""" 2570 ID 2571 2572 """ 2573 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 2574 results by relevance to the search term(s). When no search query is specified, this sort key is not 2575 deterministic and should not be used. 2576 2577 """ 2578 RELEVANCE 2579 } 2580 2581 """Specifies the sort order for the products in the collection.""" 2582 enum CollectionSortOrder { 2583 """Alphabetically, in ascending order (A - Z).""" 2584 ALPHA_ASC 2585 2586 """Alphabetically, in descending order (Z - A).""" 2587 ALPHA_DESC 2588 2589 """By best-selling products.""" 2590 BEST_SELLING 2591 2592 """By date created, in ascending order (oldest - newest).""" 2593 CREATED 2594 2595 """By date created, in descending order (newest - oldest).""" 2596 CREATED_DESC 2597 2598 """In the order set manually by the merchant.""" 2599 MANUAL 2600 2601 """By price, in ascending order (lowest - highest).""" 2602 PRICE_ASC 2603 2604 """By price, in descending order (highest - lowest).""" 2605 PRICE_DESC 2606 } 2607 2608 """ 2609 Specifies the collection to unpublish and the sales channels to remove it from. 2610 """ 2611 input CollectionUnpublishInput { 2612 """The collection to create or update publications for.""" 2613 id: ID! 2614 2615 """The channels where the collection is published.""" 2616 collectionPublications: [CollectionPublicationInput!]! 2617 } 2618 2619 """Return type for `collectionUnpublish` mutation.""" 2620 type CollectionUnpublishPayload { 2621 """The collection that has been unpublished.""" 2622 collection: Collection 2623 2624 """The shop associated with the collection.""" 2625 shop: Shop! 2626 2627 """List of errors that occurred executing the mutation.""" 2628 userErrors: [UserError!]! 2629 } 2630 2631 """Return type for `collectionUpdate` mutation.""" 2632 type CollectionUpdatePayload { 2633 """The updated collection.""" 2634 collection: Collection 2635 2636 """The asynchronous job updating the products based on the new rule set.""" 2637 job: Job 2638 2639 """List of errors that occurred executing the mutation.""" 2640 userErrors: [UserError!]! 2641 } 2642 2643 """ 2644 Comment events are generated by staff members of a shop. 2645 They are created when a staff member adds a comment to the timeline of an order, draft order, customer, or transfer. 2646 2647 """ 2648 type CommentEvent implements Node & Event { 2649 """ 2650 The name of the app that created the event. Returns null when the event originates from the Shopify admin. 2651 """ 2652 appTitle: String 2653 2654 """The attachments associated with the comment event.""" 2655 attachments: [CommentEventAttachment!]! 2656 2657 """Whether the event was created by an app.""" 2658 attributeToApp: Boolean! 2659 2660 """Whether the event was caused by an admin user.""" 2661 attributeToUser: Boolean! 2662 2663 """ 2664 Whether the comment event can be deleted. If true, then the comment event can be deleted. 2665 """ 2666 canDelete: Boolean! 2667 2668 """ 2669 Whether the comment event can be edited. If true, then the comment event can be edited. 2670 """ 2671 canEdit: Boolean! 2672 2673 """The date and time when the event was created.""" 2674 createdAt: DateTime! 2675 2676 """Whether the event is critical.""" 2677 criticalAlert: Boolean! 2678 2679 """ 2680 Whether the comment event has been edited. If true, then the comment event has been edited. 2681 """ 2682 edited: Boolean! 2683 2684 """The references associated with the comment event.""" 2685 embed: CommentEventEmbed 2686 2687 """Globally unique identifier.""" 2688 id: ID! 2689 2690 """Human readable text that describes the event.""" 2691 message: FormattedString! 2692 2693 """The raw body of the comment event.""" 2694 rawMessage: String! 2695 2696 """The subject of the comment event.""" 2697 subject: CommentEventSubject! 2698 } 2699 2700 """A file attachment associated to a comment event.""" 2701 type CommentEventAttachment { 2702 """ 2703 The file extension of the comment event attachment, indicating the file format. 2704 """ 2705 fileExtension: String 2706 2707 """Globally unique identifier.""" 2708 id: ID! 2709 2710 """The image attached to the comment event.""" 2711 image( 2712 """ 2713 Image width in pixels between 1 and 2048. This argument is deprecated: Use `maxWidth` on `Image.transformedSrc` instead. 2714 """ 2715 maxWidth: Int 2716 2717 """ 2718 Image height in pixels between 1 and 2048. This argument is deprecated: Use `maxHeight` on `Image.transformedSrc` instead. 2719 """ 2720 maxHeight: Int 2721 2722 """ 2723 Crops the image according to the specified region. This argument is deprecated: Use `crop` on `Image.transformedSrc` instead. 2724 """ 2725 crop: CropRegion 2726 2727 """ 2728 Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use `scale` on `Image.transformedSrc` instead. 2729 """ 2730 scale: Int = 1 2731 ): Image 2732 2733 """The filename of the comment event attachment.""" 2734 name: String! 2735 2736 """The size of the attachment.""" 2737 size: Int! 2738 2739 """The URL of the attachment.""" 2740 url: URL! 2741 } 2742 2743 """The main embed of a comment event.""" 2744 union CommentEventEmbed = Customer | DraftOrder | Order | Product | ProductVariant 2745 2746 """The subject line of a comment event.""" 2747 interface CommentEventSubject { 2748 """ 2749 Whether the timeline subject has a timeline comment. If true, then a timeline comment exists. 2750 """ 2751 hasTimelineComment: Boolean! 2752 2753 """Globally unique identifier.""" 2754 id: ID! 2755 } 2756 2757 """Countries that have been defined in shipping zones for the shop.""" 2758 type CountriesInShippingZones { 2759 """Countries that have been defined in shipping zones.""" 2760 countryCodes: [CountryCode!]! 2761 2762 """Whether 'Rest of World' has been defined in any shipping zones.""" 2763 includeRestOfWorld: Boolean! 2764 } 2765 2766 """ISO 3166-1 alpha-2 country codes with some differences.""" 2767 enum CountryCode { 2768 """Afghanistan.""" 2769 AF 2770 2771 """Ã…land Islands.""" 2772 AX 2773 2774 """Albania.""" 2775 AL 2776 2777 """Algeria.""" 2778 DZ 2779 2780 """Andorra.""" 2781 AD 2782 2783 """Angola.""" 2784 AO 2785 2786 """Anguilla.""" 2787 AI 2788 2789 """Antigua & Barbuda.""" 2790 AG 2791 2792 """Argentina.""" 2793 AR 2794 2795 """Armenia.""" 2796 AM 2797 2798 """Aruba.""" 2799 AW 2800 2801 """Ascension Island.""" 2802 AC 2803 2804 """Australia.""" 2805 AU 2806 2807 """Austria.""" 2808 AT 2809 2810 """Azerbaijan.""" 2811 AZ 2812 2813 """Bahamas.""" 2814 BS 2815 2816 """Bahrain.""" 2817 BH 2818 2819 """Bangladesh.""" 2820 BD 2821 2822 """Barbados.""" 2823 BB 2824 2825 """Belarus.""" 2826 BY 2827 2828 """Belgium.""" 2829 BE 2830 2831 """Belize.""" 2832 BZ 2833 2834 """Benin.""" 2835 BJ 2836 2837 """Bermuda.""" 2838 BM 2839 2840 """Bhutan.""" 2841 BT 2842 2843 """Bolivia.""" 2844 BO 2845 2846 """Bosnia & Herzegovina.""" 2847 BA 2848 2849 """Botswana.""" 2850 BW 2851 2852 """Bouvet Island.""" 2853 BV 2854 2855 """Brazil.""" 2856 BR 2857 2858 """British Indian Ocean Territory.""" 2859 IO 2860 2861 """Brunei.""" 2862 BN 2863 2864 """Bulgaria.""" 2865 BG 2866 2867 """Burkina Faso.""" 2868 BF 2869 2870 """Burundi.""" 2871 BI 2872 2873 """Cambodia.""" 2874 KH 2875 2876 """Canada.""" 2877 CA 2878 2879 """Cape Verde.""" 2880 CV 2881 2882 """Caribbean Netherlands.""" 2883 BQ 2884 2885 """Cayman Islands.""" 2886 KY 2887 2888 """Central African Republic.""" 2889 CF 2890 2891 """Chad.""" 2892 TD 2893 2894 """Chile.""" 2895 CL 2896 2897 """China.""" 2898 CN 2899 2900 """Christmas Island.""" 2901 CX 2902 2903 """Cocos (Keeling) Islands.""" 2904 CC 2905 2906 """Colombia.""" 2907 CO 2908 2909 """Comoros.""" 2910 KM 2911 2912 """Congo - Brazzaville.""" 2913 CG 2914 2915 """Congo - Kinshasa.""" 2916 CD 2917 2918 """Cook Islands.""" 2919 CK 2920 2921 """Costa Rica.""" 2922 CR 2923 2924 """Croatia.""" 2925 HR 2926 2927 """Cuba.""" 2928 CU 2929 2930 """Curaçao.""" 2931 CW 2932 2933 """Cyprus.""" 2934 CY 2935 2936 """Czechia.""" 2937 CZ 2938 2939 """Côte d’Ivoire.""" 2940 CI 2941 2942 """Denmark.""" 2943 DK 2944 2945 """Djibouti.""" 2946 DJ 2947 2948 """Dominica.""" 2949 DM 2950 2951 """Dominican Republic.""" 2952 DO 2953 2954 """Ecuador.""" 2955 EC 2956 2957 """Egypt.""" 2958 EG 2959 2960 """El Salvador.""" 2961 SV 2962 2963 """Equatorial Guinea.""" 2964 GQ 2965 2966 """Eritrea.""" 2967 ER 2968 2969 """Estonia.""" 2970 EE 2971 2972 """Eswatini.""" 2973 SZ 2974 2975 """Ethiopia.""" 2976 ET 2977 2978 """Falkland Islands.""" 2979 FK 2980 2981 """Faroe Islands.""" 2982 FO 2983 2984 """Fiji.""" 2985 FJ 2986 2987 """Finland.""" 2988 FI 2989 2990 """France.""" 2991 FR 2992 2993 """French Guiana.""" 2994 GF 2995 2996 """French Polynesia.""" 2997 PF 2998 2999 """French Southern Territories.""" 3000 TF 3001 3002 """Gabon.""" 3003 GA 3004 3005 """Gambia.""" 3006 GM 3007 3008 """Georgia.""" 3009 GE 3010 3011 """Germany.""" 3012 DE 3013 3014 """Ghana.""" 3015 GH 3016 3017 """Gibraltar.""" 3018 GI 3019 3020 """Greece.""" 3021 GR 3022 3023 """Greenland.""" 3024 GL 3025 3026 """Grenada.""" 3027 GD 3028 3029 """Guadeloupe.""" 3030 GP 3031 3032 """Guatemala.""" 3033 GT 3034 3035 """Guernsey.""" 3036 GG 3037 3038 """Guinea.""" 3039 GN 3040 3041 """Guinea-Bissau.""" 3042 GW 3043 3044 """Guyana.""" 3045 GY 3046 3047 """Haiti.""" 3048 HT 3049 3050 """Heard & McDonald Islands.""" 3051 HM 3052 3053 """Vatican City.""" 3054 VA 3055 3056 """Honduras.""" 3057 HN 3058 3059 """Hong Kong SAR.""" 3060 HK 3061 3062 """Hungary.""" 3063 HU 3064 3065 """Iceland.""" 3066 IS 3067 3068 """India.""" 3069 IN 3070 3071 """Indonesia.""" 3072 ID 3073 3074 """Iran.""" 3075 IR 3076 3077 """Iraq.""" 3078 IQ 3079 3080 """Ireland.""" 3081 IE 3082 3083 """Isle of Man.""" 3084 IM 3085 3086 """Israel.""" 3087 IL 3088 3089 """Italy.""" 3090 IT 3091 3092 """Jamaica.""" 3093 JM 3094 3095 """Japan.""" 3096 JP 3097 3098 """Jersey.""" 3099 JE 3100 3101 """Jordan.""" 3102 JO 3103 3104 """Kazakhstan.""" 3105 KZ 3106 3107 """Kenya.""" 3108 KE 3109 3110 """Kiribati.""" 3111 KI 3112 3113 """North Korea.""" 3114 KP 3115 3116 """Kosovo.""" 3117 XK 3118 3119 """Kuwait.""" 3120 KW 3121 3122 """Kyrgyzstan.""" 3123 KG 3124 3125 """Laos.""" 3126 LA 3127 3128 """Latvia.""" 3129 LV 3130 3131 """Lebanon.""" 3132 LB 3133 3134 """Lesotho.""" 3135 LS 3136 3137 """Liberia.""" 3138 LR 3139 3140 """Libya.""" 3141 LY 3142 3143 """Liechtenstein.""" 3144 LI 3145 3146 """Lithuania.""" 3147 LT 3148 3149 """Luxembourg.""" 3150 LU 3151 3152 """Macao SAR.""" 3153 MO 3154 3155 """Madagascar.""" 3156 MG 3157 3158 """Malawi.""" 3159 MW 3160 3161 """Malaysia.""" 3162 MY 3163 3164 """Maldives.""" 3165 MV 3166 3167 """Mali.""" 3168 ML 3169 3170 """Malta.""" 3171 MT 3172 3173 """Martinique.""" 3174 MQ 3175 3176 """Mauritania.""" 3177 MR 3178 3179 """Mauritius.""" 3180 MU 3181 3182 """Mayotte.""" 3183 YT 3184 3185 """Mexico.""" 3186 MX 3187 3188 """Moldova.""" 3189 MD 3190 3191 """Monaco.""" 3192 MC 3193 3194 """Mongolia.""" 3195 MN 3196 3197 """Montenegro.""" 3198 ME 3199 3200 """Montserrat.""" 3201 MS 3202 3203 """Morocco.""" 3204 MA 3205 3206 """Mozambique.""" 3207 MZ 3208 3209 """Myanmar (Burma).""" 3210 MM 3211 3212 """Namibia.""" 3213 NA 3214 3215 """Nauru.""" 3216 NR 3217 3218 """Nepal.""" 3219 NP 3220 3221 """Netherlands.""" 3222 NL 3223 3224 """Netherlands Antilles.""" 3225 AN 3226 3227 """New Caledonia.""" 3228 NC 3229 3230 """New Zealand.""" 3231 NZ 3232 3233 """Nicaragua.""" 3234 NI 3235 3236 """Niger.""" 3237 NE 3238 3239 """Nigeria.""" 3240 NG 3241 3242 """Niue.""" 3243 NU 3244 3245 """Norfolk Island.""" 3246 NF 3247 3248 """North Macedonia.""" 3249 MK 3250 3251 """Norway.""" 3252 NO 3253 3254 """Oman.""" 3255 OM 3256 3257 """Pakistan.""" 3258 PK 3259 3260 """Palestinian Territories.""" 3261 PS 3262 3263 """Panama.""" 3264 PA 3265 3266 """Papua New Guinea.""" 3267 PG 3268 3269 """Paraguay.""" 3270 PY 3271 3272 """Peru.""" 3273 PE 3274 3275 """Philippines.""" 3276 PH 3277 3278 """Pitcairn Islands.""" 3279 PN 3280 3281 """Poland.""" 3282 PL 3283 3284 """Portugal.""" 3285 PT 3286 3287 """Qatar.""" 3288 QA 3289 3290 """Cameroon.""" 3291 CM 3292 3293 """Réunion.""" 3294 RE 3295 3296 """Romania.""" 3297 RO 3298 3299 """Russia.""" 3300 RU 3301 3302 """Rwanda.""" 3303 RW 3304 3305 """St. Barthélemy.""" 3306 BL 3307 3308 """St. Helena.""" 3309 SH 3310 3311 """St. Kitts & Nevis.""" 3312 KN 3313 3314 """St. Lucia.""" 3315 LC 3316 3317 """St. Martin.""" 3318 MF 3319 3320 """St. Pierre & Miquelon.""" 3321 PM 3322 3323 """Samoa.""" 3324 WS 3325 3326 """San Marino.""" 3327 SM 3328 3329 """São Tomé & PrÃncipe.""" 3330 ST 3331 3332 """Saudi Arabia.""" 3333 SA 3334 3335 """Senegal.""" 3336 SN 3337 3338 """Serbia.""" 3339 RS 3340 3341 """Seychelles.""" 3342 SC 3343 3344 """Sierra Leone.""" 3345 SL 3346 3347 """Singapore.""" 3348 SG 3349 3350 """Sint Maarten.""" 3351 SX 3352 3353 """Slovakia.""" 3354 SK 3355 3356 """Slovenia.""" 3357 SI 3358 3359 """Solomon Islands.""" 3360 SB 3361 3362 """Somalia.""" 3363 SO 3364 3365 """South Africa.""" 3366 ZA 3367 3368 """South Georgia & South Sandwich Islands.""" 3369 GS 3370 3371 """South Korea.""" 3372 KR 3373 3374 """South Sudan.""" 3375 SS 3376 3377 """Spain.""" 3378 ES 3379 3380 """Sri Lanka.""" 3381 LK 3382 3383 """St. Vincent & Grenadines.""" 3384 VC 3385 3386 """Sudan.""" 3387 SD 3388 3389 """Suriname.""" 3390 SR 3391 3392 """Svalbard & Jan Mayen.""" 3393 SJ 3394 3395 """Sweden.""" 3396 SE 3397 3398 """Switzerland.""" 3399 CH 3400 3401 """Syria.""" 3402 SY 3403 3404 """Taiwan.""" 3405 TW 3406 3407 """Tajikistan.""" 3408 TJ 3409 3410 """Tanzania.""" 3411 TZ 3412 3413 """Thailand.""" 3414 TH 3415 3416 """Timor-Leste.""" 3417 TL 3418 3419 """Togo.""" 3420 TG 3421 3422 """Tokelau.""" 3423 TK 3424 3425 """Tonga.""" 3426 TO 3427 3428 """Trinidad & Tobago.""" 3429 TT 3430 3431 """Tristan da Cunha.""" 3432 TA 3433 3434 """Tunisia.""" 3435 TN 3436 3437 """Turkey.""" 3438 TR 3439 3440 """Turkmenistan.""" 3441 TM 3442 3443 """Turks & Caicos Islands.""" 3444 TC 3445 3446 """Tuvalu.""" 3447 TV 3448 3449 """Uganda.""" 3450 UG 3451 3452 """Ukraine.""" 3453 UA 3454 3455 """United Arab Emirates.""" 3456 AE 3457 3458 """United Kingdom.""" 3459 GB 3460 3461 """United States.""" 3462 US 3463 3464 """U.S. Outlying Islands.""" 3465 UM 3466 3467 """Uruguay.""" 3468 UY 3469 3470 """Uzbekistan.""" 3471 UZ 3472 3473 """Vanuatu.""" 3474 VU 3475 3476 """Venezuela.""" 3477 VE 3478 3479 """Vietnam.""" 3480 VN 3481 3482 """British Virgin Islands.""" 3483 VG 3484 3485 """Wallis & Futuna.""" 3486 WF 3487 3488 """Western Sahara.""" 3489 EH 3490 3491 """Yemen.""" 3492 YE 3493 3494 """Zambia.""" 3495 ZM 3496 3497 """Zimbabwe.""" 3498 ZW 3499 } 3500 3501 """ 3502 Holds the country specific harmonized system code and the country ISO code. 3503 3504 """ 3505 type CountryHarmonizedSystemCode { 3506 """Country ISO code.""" 3507 countryCode: CountryCode! 3508 3509 """Country specific harmonized system code.""" 3510 harmonizedSystemCode: String! 3511 } 3512 3513 """ 3514 An auto-generated type for paginating through multiple CountryHarmonizedSystemCodes. 3515 3516 """ 3517 type CountryHarmonizedSystemCodeConnection { 3518 """A list of edges.""" 3519 edges: [CountryHarmonizedSystemCodeEdge!]! 3520 3521 """Information to aid in pagination.""" 3522 pageInfo: PageInfo! 3523 } 3524 3525 """ 3526 An auto-generated type which holds one CountryHarmonizedSystemCode and a cursor during pagination. 3527 3528 """ 3529 type CountryHarmonizedSystemCodeEdge { 3530 """A cursor for use in pagination.""" 3531 cursor: String! 3532 3533 """The item at the end of CountryHarmonizedSystemCodeEdge.""" 3534 node: CountryHarmonizedSystemCode! 3535 } 3536 3537 """ 3538 Holds the country specific harmonized system code and the country ISO code. 3539 3540 """ 3541 input CountryHarmonizedSystemCodeInput { 3542 """Country specific harmonized system code.""" 3543 harmonizedSystemCode: String! 3544 3545 """Country ISO code.""" 3546 countryCode: CountryCode! 3547 } 3548 3549 """Specifies the input fields required to create a media object.""" 3550 input CreateMediaInput { 3551 """ 3552 The original source of the media object. May be an external URL or signed upload URL. 3553 """ 3554 originalSource: String! 3555 3556 """The alt text associated to the media.""" 3557 alt: String 3558 3559 """The media content type.""" 3560 mediaContentType: MediaContentType! 3561 } 3562 3563 """The part of the image that should remain after cropping.""" 3564 enum CropRegion { 3565 """Keep the center of the image.""" 3566 CENTER 3567 3568 """Keep the top of the image.""" 3569 TOP 3570 3571 """Keep the bottom of the image.""" 3572 BOTTOM 3573 3574 """Keep the left of the image.""" 3575 LEFT 3576 3577 """Keep the right of the image.""" 3578 RIGHT 3579 } 3580 3581 """Currency codes.""" 3582 enum CurrencyCode { 3583 """United States Dollars (USD).""" 3584 USD 3585 3586 """Euro (EUR).""" 3587 EUR 3588 3589 """United Kingdom Pounds (GBP).""" 3590 GBP 3591 3592 """Canadian Dollars (CAD).""" 3593 CAD 3594 3595 """Afghan Afghani (AFN).""" 3596 AFN 3597 3598 """Albanian Lek (ALL).""" 3599 ALL 3600 3601 """Algerian Dinar (DZD).""" 3602 DZD 3603 3604 """Angolan Kwanza (AOA).""" 3605 AOA 3606 3607 """Argentine Pesos (ARS).""" 3608 ARS 3609 3610 """Armenian Dram (AMD).""" 3611 AMD 3612 3613 """Aruban Florin (AWG).""" 3614 AWG 3615 3616 """Australian Dollars (AUD).""" 3617 AUD 3618 3619 """Barbadian Dollar (BBD).""" 3620 BBD 3621 3622 """Azerbaijani Manat (AZN).""" 3623 AZN 3624 3625 """Bangladesh Taka (BDT).""" 3626 BDT 3627 3628 """Bahamian Dollar (BSD).""" 3629 BSD 3630 3631 """Bahraini Dinar (BHD).""" 3632 BHD 3633 3634 """Burundian Franc (BIF).""" 3635 BIF 3636 3637 """Belize Dollar (BZD).""" 3638 BZD 3639 3640 """Bermudian Dollar (BMD).""" 3641 BMD 3642 3643 """Bhutanese Ngultrum (BTN).""" 3644 BTN 3645 3646 """Bosnia and Herzegovina Convertible Mark (BAM).""" 3647 BAM 3648 3649 """Brazilian Real (BRL).""" 3650 BRL 3651 3652 """Bolivian Boliviano (BOB).""" 3653 BOB 3654 3655 """Botswana Pula (BWP).""" 3656 BWP 3657 3658 """Brunei Dollar (BND).""" 3659 BND 3660 3661 """Bulgarian Lev (BGN).""" 3662 BGN 3663 3664 """Burmese Kyat (MMK).""" 3665 MMK 3666 3667 """Cambodian Riel.""" 3668 KHR 3669 3670 """Cape Verdean escudo (CVE).""" 3671 CVE 3672 3673 """Cayman Dollars (KYD).""" 3674 KYD 3675 3676 """Central African CFA Franc (XAF).""" 3677 XAF 3678 3679 """Chilean Peso (CLP).""" 3680 CLP 3681 3682 """Chinese Yuan Renminbi (CNY).""" 3683 CNY 3684 3685 """Colombian Peso (COP).""" 3686 COP 3687 3688 """Comorian Franc (KMF).""" 3689 KMF 3690 3691 """Congolese franc (CDF).""" 3692 CDF 3693 3694 """Costa Rican Colones (CRC).""" 3695 CRC 3696 3697 """Croatian Kuna (HRK).""" 3698 HRK 3699 3700 """Czech Koruny (CZK).""" 3701 CZK 3702 3703 """Danish Kroner (DKK).""" 3704 DKK 3705 3706 """Dominican Peso (DOP).""" 3707 DOP 3708 3709 """East Caribbean Dollar (XCD).""" 3710 XCD 3711 3712 """Egyptian Pound (EGP).""" 3713 EGP 3714 3715 """Ethiopian Birr (ETB).""" 3716 ETB 3717 3718 """CFP Franc (XPF).""" 3719 XPF 3720 3721 """Fijian Dollars (FJD).""" 3722 FJD 3723 3724 """Gambian Dalasi (GMD).""" 3725 GMD 3726 3727 """Ghanaian Cedi (GHS).""" 3728 GHS 3729 3730 """Guatemalan Quetzal (GTQ).""" 3731 GTQ 3732 3733 """Guyanese Dollar (GYD).""" 3734 GYD 3735 3736 """Georgian Lari (GEL).""" 3737 GEL 3738 3739 """Haitian Gourde (HTG).""" 3740 HTG 3741 3742 """Honduran Lempira (HNL).""" 3743 HNL 3744 3745 """Hong Kong Dollars (HKD).""" 3746 HKD 3747 3748 """Hungarian Forint (HUF).""" 3749 HUF 3750 3751 """Icelandic Kronur (ISK).""" 3752 ISK 3753 3754 """Indian Rupees (INR).""" 3755 INR 3756 3757 """Indonesian Rupiah (IDR).""" 3758 IDR 3759 3760 """Israeli New Shekel (NIS).""" 3761 ILS 3762 3763 """Iraqi Dinar (IQD).""" 3764 IQD 3765 3766 """Jamaican Dollars (JMD).""" 3767 JMD 3768 3769 """Japanese Yen (JPY).""" 3770 JPY 3771 3772 """Jersey Pound.""" 3773 JEP 3774 3775 """Jordanian Dinar (JOD).""" 3776 JOD 3777 3778 """Kazakhstani Tenge (KZT).""" 3779 KZT 3780 3781 """Kenyan Shilling (KES).""" 3782 KES 3783 3784 """Kuwaiti Dinar (KWD).""" 3785 KWD 3786 3787 """Kyrgyzstani Som (KGS).""" 3788 KGS 3789 3790 """Laotian Kip (LAK).""" 3791 LAK 3792 3793 """Latvian Lati (LVL).""" 3794 LVL 3795 3796 """Lebanese Pounds (LBP).""" 3797 LBP 3798 3799 """Lesotho Loti (LSL).""" 3800 LSL 3801 3802 """Liberian Dollar (LRD).""" 3803 LRD 3804 3805 """Lithuanian Litai (LTL).""" 3806 LTL 3807 3808 """Malagasy Ariary (MGA).""" 3809 MGA 3810 3811 """Macedonia Denar (MKD).""" 3812 MKD 3813 3814 """Macanese Pataca (MOP).""" 3815 MOP 3816 3817 """Malawian Kwacha (MWK).""" 3818 MWK 3819 3820 """Maldivian Rufiyaa (MVR).""" 3821 MVR 3822 3823 """Mexican Pesos (MXN).""" 3824 MXN 3825 3826 """Malaysian Ringgits (MYR).""" 3827 MYR 3828 3829 """Mauritian Rupee (MUR).""" 3830 MUR 3831 3832 """Moldovan Leu (MDL).""" 3833 MDL 3834 3835 """Moroccan Dirham.""" 3836 MAD 3837 3838 """Mongolian Tugrik.""" 3839 MNT 3840 3841 """Mozambican Metical.""" 3842 MZN 3843 3844 """Namibian Dollar.""" 3845 NAD 3846 3847 """Nepalese Rupee (NPR).""" 3848 NPR 3849 3850 """Netherlands Antillean Guilder.""" 3851 ANG 3852 3853 """New Zealand Dollars (NZD).""" 3854 NZD 3855 3856 """Nicaraguan Córdoba (NIO).""" 3857 NIO 3858 3859 """Nigerian Naira (NGN).""" 3860 NGN 3861 3862 """Norwegian Kroner (NOK).""" 3863 NOK 3864 3865 """Omani Rial (OMR).""" 3866 OMR 3867 3868 """Panamian Balboa (PAB).""" 3869 PAB 3870 3871 """Pakistani Rupee (PKR).""" 3872 PKR 3873 3874 """Papua New Guinean Kina (PGK).""" 3875 PGK 3876 3877 """Paraguayan Guarani (PYG).""" 3878 PYG 3879 3880 """Peruvian Nuevo Sol (PEN).""" 3881 PEN 3882 3883 """Philippine Peso (PHP).""" 3884 PHP 3885 3886 """Polish Zlotych (PLN).""" 3887 PLN 3888 3889 """Qatari Rial (QAR).""" 3890 QAR 3891 3892 """Romanian Lei (RON).""" 3893 RON 3894 3895 """Russian Rubles (RUB).""" 3896 RUB 3897 3898 """Rwandan Franc (RWF).""" 3899 RWF 3900 3901 """Samoan Tala (WST).""" 3902 WST 3903 3904 """Saudi Riyal (SAR).""" 3905 SAR 3906 3907 """Sao Tome And Principe Dobra (STD).""" 3908 STD 3909 3910 """Serbian dinar (RSD).""" 3911 RSD 3912 3913 """Seychellois Rupee (SCR).""" 3914 SCR 3915 3916 """Singapore Dollars (SGD).""" 3917 SGD 3918 3919 """Sudanese Pound (SDG).""" 3920 SDG 3921 3922 """Syrian Pound (SYP).""" 3923 SYP 3924 3925 """South African Rand (ZAR).""" 3926 ZAR 3927 3928 """South Korean Won (KRW).""" 3929 KRW 3930 3931 """South Sudanese Pound (SSP).""" 3932 SSP 3933 3934 """Solomon Islands Dollar (SBD).""" 3935 SBD 3936 3937 """Sri Lankan Rupees (LKR).""" 3938 LKR 3939 3940 """Surinamese Dollar (SRD).""" 3941 SRD 3942 3943 """Swazi Lilangeni (SZL).""" 3944 SZL 3945 3946 """Swedish Kronor (SEK).""" 3947 SEK 3948 3949 """Swiss Francs (CHF).""" 3950 CHF 3951 3952 """Taiwan Dollars (TWD).""" 3953 TWD 3954 3955 """Thai baht (THB).""" 3956 THB 3957 3958 """Tanzanian Shilling (TZS).""" 3959 TZS 3960 3961 """Trinidad and Tobago Dollars (TTD).""" 3962 TTD 3963 3964 """Tunisian Dinar (TND).""" 3965 TND 3966 3967 """Turkish Lira (TRY).""" 3968 TRY 3969 3970 """Turkmenistani Manat (TMT).""" 3971 TMT 3972 3973 """Ugandan Shilling (UGX).""" 3974 UGX 3975 3976 """Ukrainian Hryvnia (UAH).""" 3977 UAH 3978 3979 """United Arab Emirates Dirham (AED).""" 3980 AED 3981 3982 """Uruguayan Pesos (UYU).""" 3983 UYU 3984 3985 """Uzbekistan som (UZS).""" 3986 UZS 3987 3988 """Vanuatu Vatu (VUV).""" 3989 VUV 3990 3991 """Vietnamese đồng (VND).""" 3992 VND 3993 3994 """West African CFA franc (XOF).""" 3995 XOF 3996 3997 """Yemeni Rial (YER).""" 3998 YER 3999 4000 """Zambian Kwacha (ZMW).""" 4001 ZMW 4002 4003 """Belarusian Ruble (BYN).""" 4004 BYN 4005 4006 """Belarusian Ruble (BYR).""" 4007 BYR @deprecated(reason: "`BYR` is deprecated. Use `BYN` available from version `2021-01` onwards instead.") 4008 4009 """Djiboutian Franc (DJF).""" 4010 DJF 4011 4012 """Eritrean Nakfa (ERN).""" 4013 ERN 4014 4015 """Falkland Islands Pounds (FKP).""" 4016 FKP 4017 4018 """Gibraltar Pounds (GIP).""" 4019 GIP 4020 4021 """Guinean Franc (GNF).""" 4022 GNF 4023 4024 """Iranian Rial (IRR).""" 4025 IRR 4026 4027 """Kiribati Dollar (KID).""" 4028 KID 4029 4030 """Libyan Dinar (LYD).""" 4031 LYD 4032 4033 """Mauritanian Ouguiya (MRU).""" 4034 MRU 4035 4036 """Sierra Leonean Leone (SLL).""" 4037 SLL 4038 4039 """Saint Helena Pounds (SHP).""" 4040 SHP 4041 4042 """Somali Shilling (SOS).""" 4043 SOS 4044 4045 """Tajikistani Somoni (TJS).""" 4046 TJS 4047 4048 """Tongan Pa'anga (TOP).""" 4049 TOP 4050 4051 """Venezuelan Bolivares (VEF).""" 4052 VEF @deprecated(reason: "`VEF` is deprecated. Use `VES` available from version `2020-10` onwards instead.") 4053 4054 """Venezuelan Bolivares (VES).""" 4055 VES 4056 } 4057 4058 """Currency formats.""" 4059 type CurrencyFormats { 4060 """HTML without currency.""" 4061 moneyFormat: FormattedString! 4062 4063 """Email without currency.""" 4064 moneyInEmailsFormat: String! 4065 4066 """HTML with currency.""" 4067 moneyWithCurrencyFormat: FormattedString! 4068 4069 """Email with currency.""" 4070 moneyWithCurrencyInEmailsFormat: String! 4071 } 4072 4073 """Represents a currency setting.""" 4074 type CurrencySetting { 4075 """The currency's ISO code.""" 4076 currencyCode: CurrencyCode! 4077 4078 """The full name of the currency.""" 4079 currencyName: String! 4080 4081 """Flag describing whether the currency is enabled.""" 4082 enabled: Boolean! 4083 4084 """ 4085 Date and time when the exchange rate for the currency was last modified. 4086 """ 4087 rateUpdatedAt: DateTime 4088 } 4089 4090 """ 4091 An auto-generated type for paginating through multiple CurrencySettings. 4092 4093 """ 4094 type CurrencySettingConnection { 4095 """A list of edges.""" 4096 edges: [CurrencySettingEdge!]! 4097 4098 """Information to aid in pagination.""" 4099 pageInfo: PageInfo! 4100 } 4101 4102 """ 4103 An auto-generated type which holds one CurrencySetting and a cursor during pagination. 4104 4105 """ 4106 type CurrencySettingEdge { 4107 """A cursor for use in pagination.""" 4108 cursor: String! 4109 4110 """The item at the end of CurrencySettingEdge.""" 4111 node: CurrencySetting! 4112 } 4113 4114 """ 4115 Represents information about a customer of the shop, such as the customer's contact details, their order 4116 history, and whether they've agreed to receive email marketing. 4117 4118 """ 4119 type Customer implements Node & CommentEventSubject & HasMetafields & LegacyInteroperability & HasEvents { 4120 """Whether the customer has agreed to receive marketing materials.""" 4121 acceptsMarketing: Boolean! 4122 4123 """ 4124 The date and time when the customer consented or objected to receiving marketing material by email. 4125 4126 """ 4127 acceptsMarketingUpdatedAt: DateTime! 4128 4129 """A list of addresses associated with the customer.""" 4130 addresses( 4131 """Truncate the array result to this size.""" 4132 first: Int 4133 ): [MailingAddress!]! 4134 4135 """The average amount that the customer spent per order.""" 4136 averageOrderAmount: Money @deprecated(reason: "Use `averageOrderAmountV2` instead") 4137 4138 """The average amount that the customer spent per order.""" 4139 averageOrderAmountV2: MoneyV2 4140 4141 """ 4142 Whether the merchant can delete the customer from their store. 4143 4144 A customer can be deleted from a store only if they have not yet made an order. After a customer makes an 4145 order, they can't be deleted from a store. 4146 4147 """ 4148 canDelete: Boolean! 4149 4150 """The date and time when the customer was added to the store.""" 4151 createdAt: DateTime! 4152 4153 """The default address associated with the customer.""" 4154 defaultAddress: MailingAddress 4155 4156 """ 4157 The full name of the customer, based on the values for first_name and last_name. If the first_name and 4158 last_name are not available, then this falls back to the customer's email address, and if that is not available, the customer's phone number. 4159 4160 """ 4161 displayName: String! 4162 4163 """The customer's email address.""" 4164 email: String 4165 4166 """A list of events associated with the customer.""" 4167 events( 4168 """Returns up to the first `n` elements from the list.""" 4169 first: Int 4170 4171 """Returns the elements that come after the specified cursor.""" 4172 after: String 4173 4174 """Returns up to the last `n` elements from the list.""" 4175 last: Int 4176 4177 """Returns the elements that come before the specified cursor.""" 4178 before: String 4179 4180 """Reverse the order of the underlying list.""" 4181 reverse: Boolean = false 4182 4183 """Sort the underlying list by the given key.""" 4184 sortKey: EventSortKeys = ID 4185 4186 """ 4187 Supported filter parameters: 4188 - `comments` 4189 - `created_at` 4190 - `subject_type` 4191 - `verb` 4192 4193 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 4194 for more information about using filters. 4195 4196 """ 4197 query: String 4198 ): EventConnection! 4199 4200 """The customer's first name.""" 4201 firstName: String 4202 4203 """Whether the customer has a note associated with them.""" 4204 hasNote: Boolean! 4205 4206 """ 4207 Whether the merchant has added timeline comments about the customer on the customer's page. 4208 4209 """ 4210 hasTimelineComment: Boolean! 4211 4212 """Globally unique identifier.""" 4213 id: ID! 4214 4215 """The image associated with the customer.""" 4216 image( 4217 """ 4218 Image width and height (1 - 2048 pixels) This argument is deprecated: Use `maxWidth` or `maxHeight` on `Image.transformedSrc` instead. 4219 """ 4220 size: Int 4221 ): Image! 4222 4223 """The customer's last name.""" 4224 lastName: String 4225 4226 """The customer's last order.""" 4227 lastOrder: Order 4228 4229 """The ID of the corresponding resource in the REST Admin API.""" 4230 legacyResourceId: UnsignedInt64! 4231 4232 """ 4233 The amount of time since the customer was first added to the store. 4234 4235 Example: 'about 12 years'. 4236 4237 """ 4238 lifetimeDuration: String! 4239 4240 """The customer's locale.""" 4241 locale: String! 4242 4243 """ 4244 The marketing subscription opt-in level (as described by the M3AAWG best practices guideline) that the 4245 customer gave when they consented to receive marketing material by email. 4246 4247 If the customer does not accept email marketing, then this property will be null. 4248 4249 """ 4250 marketingOptInLevel: CustomerMarketingOptInLevel 4251 4252 """The metafield associated with the resource.""" 4253 metafield( 4254 """Container for a set of metafields (maximum of 20 characters).""" 4255 namespace: String! 4256 4257 """Identifier for the metafield (maximum of 30 characters).""" 4258 key: String! 4259 ): Metafield 4260 4261 """A paginated list of metafields associated with the resource.""" 4262 metafields( 4263 """Finds all metafields with a specific namespace under the resource.""" 4264 namespace: String 4265 4266 """Returns up to the first `n` elements from the list.""" 4267 first: Int 4268 4269 """Returns the elements that come after the specified cursor.""" 4270 after: String 4271 4272 """Returns up to the last `n` elements from the list.""" 4273 last: Int 4274 4275 """Returns the elements that come before the specified cursor.""" 4276 before: String 4277 4278 """Reverse the order of the underlying list.""" 4279 reverse: Boolean = false 4280 ): MetafieldConnection! 4281 4282 """A unique identifier for the customer that's used with Multipass login.""" 4283 multipassIdentifier: String 4284 4285 """A note about the customer.""" 4286 note: String 4287 4288 """A list of the customer's orders.""" 4289 orders( 4290 """Returns up to the first `n` elements from the list.""" 4291 first: Int 4292 4293 """Returns the elements that come after the specified cursor.""" 4294 after: String 4295 4296 """Returns up to the last `n` elements from the list.""" 4297 last: Int 4298 4299 """Returns the elements that come before the specified cursor.""" 4300 before: String 4301 4302 """Reverse the order of the underlying list.""" 4303 reverse: Boolean = false 4304 4305 """Sort the underlying list by the given key.""" 4306 sortKey: OrderSortKeys = ID 4307 4308 """ 4309 Supported filter parameters: 4310 - `cart_token` 4311 - `channel_id` 4312 - `chargeback_status` 4313 - `checkout_token` 4314 - `created_at` 4315 - `credit_card_last4` 4316 - `customer_id` 4317 - `delivery_method` 4318 - `discount_code` 4319 - `email` 4320 - `financial_status` 4321 - `fraud_protection_level` 4322 - `fulfillment_location_id` 4323 - `fulfillment_status` 4324 - `location_id` 4325 - `name` 4326 - `processed_at` 4327 - `reference_location_id` 4328 - `return_status` 4329 - `risk_level` 4330 - `sales_channel` 4331 - `source_identifier` 4332 - `source_name` 4333 - `status` 4334 - `tag` 4335 - `test` 4336 - `updated_at` 4337 4338 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 4339 for more information about using filters. 4340 4341 """ 4342 query: String 4343 ): OrderConnection! 4344 4345 """ 4346 The number of orders that the customer has made at the store in their lifetime. 4347 4348 """ 4349 ordersCount: UnsignedInt64! 4350 4351 """A list of the customer's payment methods.""" 4352 paymentMethods( 4353 """Whether to show the customer's revoked payment method.""" 4354 showRevoked: Boolean = false 4355 4356 """Returns up to the first `n` elements from the list.""" 4357 first: Int 4358 4359 """Returns the elements that come after the specified cursor.""" 4360 after: String 4361 4362 """Returns up to the last `n` elements from the list.""" 4363 last: Int 4364 4365 """Returns the elements that come before the specified cursor.""" 4366 before: String 4367 4368 """Reverse the order of the underlying list.""" 4369 reverse: Boolean = false 4370 ): CustomerPaymentMethodConnection! 4371 4372 """The customer's phone number.""" 4373 phone: String 4374 4375 """Returns a private metafield found by namespace and key.""" 4376 privateMetafield( 4377 """The namespace for the private metafield.""" 4378 namespace: String! 4379 4380 """The key for the private metafield.""" 4381 key: String! 4382 ): PrivateMetafield 4383 4384 """List of private metafields.""" 4385 privateMetafields( 4386 """Filter the private metafields by namespace.""" 4387 namespace: String 4388 4389 """Returns up to the first `n` elements from the list.""" 4390 first: Int 4391 4392 """Returns the elements that come after the specified cursor.""" 4393 after: String 4394 4395 """Returns up to the last `n` elements from the list.""" 4396 last: Int 4397 4398 """Returns the elements that come before the specified cursor.""" 4399 before: String 4400 4401 """Reverse the order of the underlying list.""" 4402 reverse: Boolean = false 4403 ): PrivateMetafieldConnection! 4404 4405 """ 4406 Possible subscriber states of a customer defined by their subscription contracts. 4407 """ 4408 productSubscriberStatus: CustomerProductSubscriberStatus! 4409 4410 """The state of the customer's account with the shop.""" 4411 state: CustomerState! 4412 4413 """A list of the customer's subscription contracts.""" 4414 subscriptionContracts( 4415 """Returns up to the first `n` elements from the list.""" 4416 first: Int 4417 4418 """Returns the elements that come after the specified cursor.""" 4419 after: String 4420 4421 """Returns up to the last `n` elements from the list.""" 4422 last: Int 4423 4424 """Returns the elements that come before the specified cursor.""" 4425 before: String 4426 4427 """Reverse the order of the underlying list.""" 4428 reverse: Boolean = false 4429 ): SubscriptionContractConnection! 4430 4431 """A comma separated list of tags that have been added to the customer.""" 4432 tags: [String!]! 4433 4434 """ 4435 Whether the customer is exempt from being charged taxes on their orders. 4436 """ 4437 taxExempt: Boolean! 4438 4439 """The list of tax exemptions applied to the customer.""" 4440 taxExemptions: [TaxExemption!]! 4441 4442 """ 4443 The total amount that the customer has spent on orders in their lifetime. 4444 """ 4445 totalSpent: Money! 4446 4447 """ 4448 The total amount that the customer has spent on orders in their lifetime. 4449 """ 4450 totalSpentV2: MoneyV2! 4451 4452 """The date and time when the customer was last updated.""" 4453 updatedAt: DateTime! 4454 4455 """ 4456 Whether the email address is formatted correctly. This does not 4457 guarantee that the email address actually exists. 4458 4459 """ 4460 validEmailAddress: Boolean! 4461 4462 """ 4463 Whether the customer has verified their email address. Defaults to `true` if the customer is created through the Shopify admin or API. 4464 """ 4465 verifiedEmail: Boolean! 4466 } 4467 4468 """Return type for `customerAddTaxExemptions` mutation.""" 4469 type CustomerAddTaxExemptionsPayload { 4470 """The updated customer.""" 4471 customer: Customer 4472 4473 """List of errors that occurred executing the mutation.""" 4474 userErrors: [UserError!]! 4475 } 4476 4477 """ 4478 An auto-generated type for paginating through multiple Customers. 4479 4480 """ 4481 type CustomerConnection { 4482 """A list of edges.""" 4483 edges: [CustomerEdge!]! 4484 4485 """Information to aid in pagination.""" 4486 pageInfo: PageInfo! 4487 } 4488 4489 """Return type for `customerCreate` mutation.""" 4490 type CustomerCreatePayload { 4491 """The created customer.""" 4492 customer: Customer 4493 4494 """List of errors that occurred executing the mutation.""" 4495 userErrors: [UserError!]! 4496 } 4497 4498 """Represents a card instrument for customer payment method.""" 4499 type CustomerCreditCard { 4500 """The billing address of the card.""" 4501 billingAddress: CustomerCreditCardBillingAddress 4502 4503 """The brand of the card.""" 4504 brand: String! 4505 4506 """Whether the card is about to expire.""" 4507 expiresSoon: Boolean! 4508 4509 """The expiry month of the card.""" 4510 expiryMonth: Int! 4511 4512 """The expiry year of the card.""" 4513 expiryYear: Int! 4514 4515 """The card's BIN number.""" 4516 firstDigits: String 4517 4518 """ 4519 The payment method can be revoked if there are no active subscription contracts. 4520 """ 4521 isRevocable: Boolean! 4522 4523 """The last 4 digits of the card.""" 4524 lastDigits: String! 4525 4526 """The masked card number with only the last 4 digits displayed.""" 4527 maskedNumber: String! 4528 4529 """The name of the card holder.""" 4530 name: String! 4531 } 4532 4533 """The billing address of a credit card payment instrument.""" 4534 type CustomerCreditCardBillingAddress { 4535 """ 4536 The first line of the address. Typically the street address or PO Box number. 4537 """ 4538 address1: String 4539 4540 """The name of the city, district, village, or town.""" 4541 city: String 4542 4543 """The name of the country.""" 4544 country: String 4545 4546 """ 4547 The two-letter code for the country of the address. 4548 For example, US. 4549 4550 """ 4551 countryCode: CountryCode 4552 4553 """The region of the address, such as the province, state, or district.""" 4554 province: String 4555 4556 """ 4557 The two-letter code for the region. 4558 For example, ON. 4559 4560 """ 4561 provinceCode: String 4562 4563 """The zip or postal code of the address.""" 4564 zip: String 4565 } 4566 4567 """Specifies the customer to delete.""" 4568 input CustomerDeleteInput { 4569 """The ID of the customer to delete.""" 4570 id: ID! 4571 } 4572 4573 """Return type for `customerDelete` mutation.""" 4574 type CustomerDeletePayload { 4575 """ID of the deleted customer.""" 4576 deletedCustomerId: ID 4577 4578 """Shop of the deleted customer.""" 4579 shop: Shop! 4580 4581 """List of errors that occurred executing the mutation.""" 4582 userErrors: [UserError!]! 4583 } 4584 4585 """ 4586 An auto-generated type which holds one Customer and a cursor during pagination. 4587 4588 """ 4589 type CustomerEdge { 4590 """A cursor for use in pagination.""" 4591 cursor: String! 4592 4593 """The item at the end of CustomerEdge.""" 4594 node: Customer! 4595 } 4596 4597 """Return type for `customerGenerateAccountActivationUrl` mutation.""" 4598 type CustomerGenerateAccountActivationUrlPayload { 4599 """The newly generated account activation URL.""" 4600 accountActivationUrl: URL 4601 4602 """List of errors that occurred executing the mutation.""" 4603 userErrors: [UserError!]! 4604 } 4605 4606 """ 4607 Provides the fields and values to use when creating or updating a customer. 4608 """ 4609 input CustomerInput { 4610 """ 4611 Whether the customer has consented to receive marketing material via email. 4612 """ 4613 acceptsMarketing: Boolean 4614 4615 """ 4616 The date and time when the customer consented or objected to receiving marketing material by email. Set 4617 whenever the customer consents or objects to marketing material. 4618 4619 """ 4620 acceptsMarketingUpdatedAt: DateTime 4621 4622 """An input that specifies addresses for a customer.""" 4623 addresses: [MailingAddressInput!] 4624 4625 """The unique email address of the customer.""" 4626 email: String 4627 4628 """The customer's first name.""" 4629 firstName: String 4630 4631 """ 4632 Specifies the customer to update, or creates a new customer if one doesn't exist. 4633 """ 4634 id: ID 4635 4636 """The customer's last name.""" 4637 lastName: String 4638 4639 """The customer's locale.""" 4640 locale: String 4641 4642 """ 4643 The marketing subscription opt-in level (as described by the M3AAWG best practices guideline) that was 4644 enabled when the customer consented to receiving marketing material by email. 4645 4646 """ 4647 marketingOptInLevel: CustomerMarketingOptInLevel 4648 4649 """Attaches additional metadata to the customer.""" 4650 metafields: [MetafieldInput!] 4651 4652 """A note about the customer.""" 4653 note: String 4654 4655 """The unique phone number for the customer.""" 4656 phone: String 4657 4658 """The private metafields to associated with this product.""" 4659 privateMetafields: [PrivateMetafieldInput!] 4660 4661 """A comma separated list of tags that have been added to the customer.""" 4662 tags: [String!] 4663 4664 """Whether the customer is exempt from paying taxes on their order.""" 4665 taxExempt: Boolean 4666 4667 """The list of tax exemptions to apply to the customer.""" 4668 taxExemptions: [TaxExemption!] 4669 } 4670 4671 """Represents a customer's activity on a shop's online store.""" 4672 type CustomerJourney { 4673 """The position of the current order within the customer's order history.""" 4674 customerOrderIndex: Int! 4675 4676 """ 4677 The amount of days between first session and order creation date. First session represents first session since the last order, or first session within the 30 day attribution window, if more than 30 days has passed since the last order. 4678 """ 4679 daysToConversion: Int! 4680 4681 """The customer's first session going into the shop.""" 4682 firstVisit: CustomerVisit! 4683 4684 """The last session before an order is made.""" 4685 lastVisit: CustomerVisit 4686 4687 """Events preceding a customer order, such as shop sessions.""" 4688 moments: [CustomerMoment!]! 4689 } 4690 4691 """Represents a customer's activity on a shop's online store.""" 4692 type CustomerJourneySummary { 4693 """ 4694 The position of the current order within the customer's order history. Test orders aren't included. 4695 """ 4696 customerOrderIndex: Int 4697 4698 """ 4699 The number of days between the first session and the order creation date. The first session represents the first session since the last order, or the first session within the 30 day attribution window, if more than 30 days have passed since the last order. 4700 """ 4701 daysToConversion: Int 4702 4703 """The customer's first session going into the shop.""" 4704 firstVisit: CustomerVisit 4705 4706 """The last session before an order is made.""" 4707 lastVisit: CustomerVisit 4708 4709 """The events preceding a customer order, such as shop sessions.""" 4710 moments( 4711 """Returns up to the first `n` elements from the list.""" 4712 first: Int 4713 4714 """Returns the elements that come after the specified cursor.""" 4715 after: String 4716 4717 """Returns up to the last `n` elements from the list.""" 4718 last: Int 4719 4720 """Returns the elements that come before the specified cursor.""" 4721 before: String 4722 4723 """Reverse the order of the underlying list.""" 4724 reverse: Boolean = false 4725 ): CustomerMomentConnection 4726 4727 """ 4728 The total number of customer moments associated with this order. Returns null if the order is still in the process of being attributed. 4729 """ 4730 momentsCount: Int 4731 4732 """ 4733 Whether or not the attributed sessions for the order have been created yet. 4734 """ 4735 ready: Boolean! 4736 } 4737 4738 """ 4739 The valid values for the marketing subscription opt-in active at the time the customer consented to email 4740 marketing. 4741 4742 The levels are defined by [the M3AAWG best practices guideline 4743 document](https://www.m3aawg.org/sites/maawg/files/news/M3AAWG_Senders_BCP_Ver3-2015-02.pdf). 4744 4745 """ 4746 enum CustomerMarketingOptInLevel { 4747 """ 4748 The customer started receiving marketing email(s) after providing their email address, without any 4749 intermediate steps. 4750 4751 """ 4752 SINGLE_OPT_IN 4753 4754 """ 4755 After providing their email address, the customer received a confirmation email which required them to 4756 perform a prescribed action before receiving marketing emails. 4757 4758 """ 4759 CONFIRMED_OPT_IN 4760 4761 """ 4762 The customer receives marketing emails, but the original opt-in process is unknown. 4763 4764 """ 4765 UNKNOWN 4766 } 4767 4768 """Represents events preceding a customer order, such as shop sessions.""" 4769 interface CustomerMoment { 4770 """When the customer moment occurred.""" 4771 occurredAt: DateTime! 4772 } 4773 4774 """ 4775 An auto-generated type for paginating through multiple CustomerMoments. 4776 4777 """ 4778 type CustomerMomentConnection { 4779 """A list of edges.""" 4780 edges: [CustomerMomentEdge!]! 4781 4782 """Information to aid in pagination.""" 4783 pageInfo: PageInfo! 4784 } 4785 4786 """ 4787 An auto-generated type which holds one CustomerMoment and a cursor during pagination. 4788 4789 """ 4790 type CustomerMomentEdge { 4791 """A cursor for use in pagination.""" 4792 cursor: String! 4793 4794 """The item at the end of CustomerMomentEdge.""" 4795 node: CustomerMoment! 4796 } 4797 4798 """All possible instruments for CustomerPaymentMethods.""" 4799 union CustomerPaymentInstrument = CustomerCreditCard 4800 4801 """A customer's payment method.""" 4802 type CustomerPaymentMethod implements Node { 4803 """The customer to whom the payment method belongs.""" 4804 customer: Customer 4805 4806 """The ID of this payment method.""" 4807 id: ID! 4808 4809 """The instrument for this payment method.""" 4810 instrument: CustomerPaymentInstrument 4811 4812 """The time that the payment method was revoked.""" 4813 revokedAt: DateTime 4814 4815 """List Subscription Contracts.""" 4816 subscriptionContracts( 4817 """Returns up to the first `n` elements from the list.""" 4818 first: Int 4819 4820 """Returns the elements that come after the specified cursor.""" 4821 after: String 4822 4823 """Returns up to the last `n` elements from the list.""" 4824 last: Int 4825 4826 """Returns the elements that come before the specified cursor.""" 4827 before: String 4828 4829 """Reverse the order of the underlying list.""" 4830 reverse: Boolean = false 4831 ): SubscriptionContractConnection! 4832 } 4833 4834 """ 4835 An auto-generated type for paginating through multiple CustomerPaymentMethods. 4836 4837 """ 4838 type CustomerPaymentMethodConnection { 4839 """A list of edges.""" 4840 edges: [CustomerPaymentMethodEdge!]! 4841 4842 """Information to aid in pagination.""" 4843 pageInfo: PageInfo! 4844 } 4845 4846 """Return type for `customerPaymentMethodCreditCardCreate` mutation.""" 4847 type CustomerPaymentMethodCreditCardCreatePayload { 4848 """The customer payment method.""" 4849 customerPaymentMethod: CustomerPaymentMethod 4850 4851 """List of errors that occurred executing the mutation.""" 4852 userErrors: [UserError!]! 4853 } 4854 4855 """Return type for `customerPaymentMethodCreditCardUpdate` mutation.""" 4856 type CustomerPaymentMethodCreditCardUpdatePayload { 4857 """The customer payment method.""" 4858 customerPaymentMethod: CustomerPaymentMethod 4859 4860 """List of errors that occurred executing the mutation.""" 4861 userErrors: [UserError!]! 4862 } 4863 4864 """ 4865 An auto-generated type which holds one CustomerPaymentMethod and a cursor during pagination. 4866 4867 """ 4868 type CustomerPaymentMethodEdge { 4869 """A cursor for use in pagination.""" 4870 cursor: String! 4871 4872 """The item at the end of CustomerPaymentMethodEdge.""" 4873 node: CustomerPaymentMethod! 4874 } 4875 4876 """ 4877 Return type for `customerPaymentMethodRemoteCreditCardCreate` mutation. 4878 """ 4879 type CustomerPaymentMethodRemoteCreditCardCreatePayload { 4880 """The customer payment method.""" 4881 customerPaymentMethod: CustomerPaymentMethod 4882 4883 """List of errors that occurred executing the mutation.""" 4884 userErrors: [CustomerPaymentMethodUserError!]! 4885 } 4886 4887 """Return type for `customerPaymentMethodRevoke` mutation.""" 4888 type CustomerPaymentMethodRevokePayload { 4889 """The ID of the revoked customer payment method.""" 4890 revokedCustomerPaymentMethodId: ID 4891 4892 """List of errors that occurred executing the mutation.""" 4893 userErrors: [UserError!]! 4894 } 4895 4896 """Return type for `customerPaymentMethodSendUpdateEmail` mutation.""" 4897 type CustomerPaymentMethodSendUpdateEmailPayload { 4898 """The customer to whom an update payment method email was sent.""" 4899 customer: Customer 4900 4901 """List of errors that occurred executing the mutation.""" 4902 userErrors: [UserError!]! 4903 } 4904 4905 """Represents an error in the input of a mutation.""" 4906 type CustomerPaymentMethodUserError implements DisplayableError { 4907 """Error code to uniquely identify the error.""" 4908 code: CustomerPaymentMethodUserErrorCode 4909 4910 """Path to the input field which caused the error.""" 4911 field: [String!] 4912 4913 """The error message.""" 4914 message: String! 4915 } 4916 4917 """ 4918 Possible error codes that could be returned by CustomerPaymentMethodUserError. 4919 """ 4920 enum CustomerPaymentMethodUserErrorCode { 4921 """Input value is invalid.""" 4922 INVALID 4923 4924 """Input value is not present.""" 4925 PRESENT 4926 4927 """Input value is already taken.""" 4928 TAKEN 4929 } 4930 4931 """ 4932 Possible subscriber states of a customer defined by their subscription contracts. 4933 4934 """ 4935 enum CustomerProductSubscriberStatus { 4936 """ 4937 The customer has at least one active subscription contract. 4938 4939 """ 4940 ACTIVE 4941 4942 """ 4943 The customer's last subscription contract was cancelled and there are no other active or paused 4944 subscription contracts. 4945 4946 """ 4947 CANCELLED 4948 4949 """ 4950 The customer's last subscription contract expired and there are no other active or paused 4951 subscription contracts. 4952 4953 """ 4954 EXPIRED 4955 4956 """ 4957 The customer's last subscription contract failed and there are no other active or paused 4958 subscription contracts. 4959 4960 """ 4961 FAILED 4962 4963 """ 4964 The customer has never had a subscription contract. 4965 4966 """ 4967 NEVER_SUBSCRIBED 4968 4969 """ 4970 The customer has at least one paused subscription contract and there are no other active 4971 subscription contracts. 4972 4973 """ 4974 PAUSED 4975 } 4976 4977 """Return type for `customerRemoveTaxExemptions` mutation.""" 4978 type CustomerRemoveTaxExemptionsPayload { 4979 """The updated customer.""" 4980 customer: Customer 4981 4982 """List of errors that occurred executing the mutation.""" 4983 userErrors: [UserError!]! 4984 } 4985 4986 """Return type for `customerReplaceTaxExemptions` mutation.""" 4987 type CustomerReplaceTaxExemptionsPayload { 4988 """The updated customer.""" 4989 customer: Customer 4990 4991 """List of errors that occurred executing the mutation.""" 4992 userErrors: [UserError!]! 4993 } 4994 4995 """The set of valid sort keys for the CustomerSavedSearch query.""" 4996 enum CustomerSavedSearchSortKeys { 4997 """Sort by the `name` value.""" 4998 NAME 4999 5000 """Sort by the `id` value.""" 5001 ID 5002 5003 """ 5004 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 5005 results by relevance to the search term(s). When no search query is specified, this sort key is not 5006 deterministic and should not be used. 5007 5008 """ 5009 RELEVANCE 5010 } 5011 5012 """The set of valid sort keys for the Customer query.""" 5013 enum CustomerSortKeys { 5014 """Sort by the `name` value.""" 5015 NAME 5016 5017 """Sort by the `location` value.""" 5018 LOCATION 5019 5020 """Sort by the `orders_count` value.""" 5021 ORDERS_COUNT 5022 5023 """Sort by the `last_order_date` value.""" 5024 LAST_ORDER_DATE 5025 5026 """Sort by the `total_spent` value.""" 5027 TOTAL_SPENT 5028 5029 """Sort by the `updated_at` value.""" 5030 UPDATED_AT 5031 5032 """Sort by the `id` value.""" 5033 ID 5034 5035 """ 5036 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 5037 results by relevance to the search term(s). When no search query is specified, this sort key is not 5038 deterministic and should not be used. 5039 5040 """ 5041 RELEVANCE 5042 } 5043 5044 """The valid values for the state of a customer's account with a shop.""" 5045 enum CustomerState { 5046 """The customer declined the email invite to create an account.""" 5047 DECLINED 5048 5049 """ 5050 The customer doesn't have an active account. Customer accounts can be disabled from the Shopify admin at any time. 5051 """ 5052 DISABLED 5053 5054 """The customer has created an account.""" 5055 ENABLED 5056 5057 """The customer has received an email invite to create an account.""" 5058 INVITED 5059 } 5060 5061 """Return type for `customerUpdateDefaultAddress` mutation.""" 5062 type CustomerUpdateDefaultAddressPayload { 5063 """The customer whose address was updated.""" 5064 customer: Customer 5065 5066 """List of errors that occurred executing the mutation.""" 5067 userErrors: [UserError!]! 5068 } 5069 5070 """Return type for `customerUpdate` mutation.""" 5071 type CustomerUpdatePayload { 5072 """The updated customer.""" 5073 customer: Customer 5074 5075 """List of errors that occurred executing the mutation.""" 5076 userErrors: [UserError!]! 5077 } 5078 5079 """Information about a customer's session on a shop's online store.""" 5080 type CustomerVisit implements CustomerMoment & Node { 5081 """Globally unique identifier.""" 5082 id: ID! 5083 5084 """URL of the first page the customer landed on for the session.""" 5085 landingPage: URL 5086 5087 """ 5088 Landing page information with URL linked in HTML. For example, the first page the customer visited was store.myshopify.com/products/1. 5089 """ 5090 landingPageHtml: HTML 5091 5092 """ 5093 Represent actions taken by an app, on behalf of a merchant, 5094 to market Shopify resources such as products, collections, and discounts. 5095 5096 """ 5097 marketingEvent: MarketingEvent 5098 5099 """When the customer moment occurred.""" 5100 occurredAt: DateTime! 5101 5102 """ 5103 Marketing referral code from the link that the customer clicked to visit the store. 5104 Supports the following URL attributes: _ref_, _source_, or _r_. 5105 For example, if the URL is myshopifystore.com/products/slide?ref=j2tj1tn2, then this value is j2tj1tn2. 5106 5107 """ 5108 referralCode: String 5109 5110 """Referral information with URLs linked in HTML.""" 5111 referralInfoHtml: FormattedString! 5112 5113 """ 5114 Webpage where the customer clicked a link that sent them to the online store. 5115 For example, _https://randomblog.com/page1_ or _android-app://com.google.android.gm_. 5116 5117 """ 5118 referrerUrl: URL 5119 5120 """ 5121 Source from which the customer visited the store, such as a platform (Facebook, Google), email, direct, 5122 a website domain, QR code, or unknown. 5123 5124 """ 5125 source: String! 5126 5127 """Describes the source explicitly for first or last session.""" 5128 sourceDescription: String 5129 5130 """Type of marketing tactic.""" 5131 sourceType: MarketingTactic 5132 5133 """ 5134 A set of UTM parameters gathered from the URL parameters of the referrer. 5135 """ 5136 utmParameters: UTMParameters 5137 } 5138 5139 """ 5140 An [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) encoded UTC date string. Example value: `"2019-07-16"`. 5141 5142 """ 5143 scalar Date 5144 5145 """ 5146 An ISO-8601 encoded UTC date time string. Example value: `"2019-07-03T20:47:55Z"`. 5147 """ 5148 scalar DateTime 5149 5150 """Days of the week from Monday to Sunday.""" 5151 enum DayOfTheWeek { 5152 """Monday.""" 5153 MONDAY 5154 5155 """Tuesday.""" 5156 TUESDAY 5157 5158 """Wednesday.""" 5159 WEDNESDAY 5160 5161 """Thursday.""" 5162 THURSDAY 5163 5164 """Friday.""" 5165 FRIDAY 5166 5167 """Saturday.""" 5168 SATURDAY 5169 5170 """Sunday.""" 5171 SUNDAY 5172 } 5173 5174 """ 5175 A signed decimal number, which supports arbitrary precision and is serialized as a string. Example value: `"29.99"`. 5176 """ 5177 scalar Decimal 5178 5179 """ 5180 Deletion events chronicle the destruction of resources (e.g. products and collections). 5181 Once deleted, the deletion event is the only trace of the original's existence, 5182 as the resource itself has been removed and can no longer be accessed. 5183 5184 """ 5185 type DeletionEvent { 5186 """ 5187 The date and time when the deletion event for the related resource was generated. 5188 """ 5189 occurredAt: DateTime! 5190 5191 """The id of the resource that was deleted.""" 5192 subjectId: ID! 5193 5194 """The type of resource that was deleted.""" 5195 subjectType: DeletionEventSubjectType! 5196 } 5197 5198 """ 5199 An auto-generated type for paginating through multiple DeletionEvents. 5200 5201 """ 5202 type DeletionEventConnection { 5203 """A list of edges.""" 5204 edges: [DeletionEventEdge!]! 5205 5206 """Information to aid in pagination.""" 5207 pageInfo: PageInfo! 5208 } 5209 5210 """ 5211 An auto-generated type which holds one DeletionEvent and a cursor during pagination. 5212 5213 """ 5214 type DeletionEventEdge { 5215 """A cursor for use in pagination.""" 5216 cursor: String! 5217 5218 """The item at the end of DeletionEventEdge.""" 5219 node: DeletionEvent! 5220 } 5221 5222 """The set of valid sort keys for the DeletionEvent query.""" 5223 enum DeletionEventSortKeys { 5224 """Sort by the `created_at` value.""" 5225 CREATED_AT 5226 5227 """Sort by the `id` value.""" 5228 ID 5229 5230 """ 5231 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 5232 results by relevance to the search term(s). When no search query is specified, this sort key is not 5233 deterministic and should not be used. 5234 5235 """ 5236 RELEVANCE 5237 } 5238 5239 """The supported subject types of deletion events.""" 5240 enum DeletionEventSubjectType { 5241 COLLECTION 5242 PRODUCT 5243 } 5244 5245 """The service and the countries they are available for.""" 5246 type DeliveryAvailableService { 5247 """The countries the service provider ships to.""" 5248 countries: DeliveryCountryCodesOrRestOfWorld! 5249 5250 """The name of the service.""" 5251 name: String! 5252 } 5253 5254 """Information about a carrier or service provider.""" 5255 type DeliveryCarrierService implements Node { 5256 """Services offered for given destinations.""" 5257 availableServicesForCountries( 5258 """The locations of the possible origins.""" 5259 origins: [ID!] 5260 5261 """The country codes of the destinations.""" 5262 countryCodes: [CountryCode!] 5263 5264 """Use Rest of World as the destination.""" 5265 restOfWorld: Boolean! 5266 ): [DeliveryAvailableService!]! 5267 5268 """The properly formatted name of the service provider, ready to display.""" 5269 formattedName: String 5270 5271 """The logo of the service provider.""" 5272 icon: Image! 5273 5274 """Globally unique identifier.""" 5275 id: ID! 5276 5277 """The name of the service provider.""" 5278 name: String 5279 } 5280 5281 """A carrier services and their set of shop locations that can be used.""" 5282 type DeliveryCarrierServiceAndLocations { 5283 """The carrier service.""" 5284 carrierService: DeliveryCarrierService! 5285 5286 """The locations that support this carrier service.""" 5287 locations: [Location!]! 5288 } 5289 5290 """ 5291 A condition that must pass for a method definition to be applied to an order. 5292 """ 5293 type DeliveryCondition implements Node { 5294 """ 5295 The criteria (weight or price) that the field must meet based on the operator. 5296 """ 5297 conditionCriteria: DeliveryConditionCriteria! 5298 5299 """The field to compare the criteria unit against, using the operator.""" 5300 field: DeliveryConditionField! 5301 5302 """Globally unique identifier.""" 5303 id: ID! 5304 5305 """The operator to compare the field and criteria.""" 5306 operator: DeliveryConditionOperator! 5307 } 5308 5309 """ 5310 The criteria (weight or price) that the field must meet based on the operator. 5311 """ 5312 union DeliveryConditionCriteria = MoneyV2 | Weight 5313 5314 """The field type that the condition will be applied to.""" 5315 enum DeliveryConditionField { 5316 """Condition will check against the total weight of the order.""" 5317 TOTAL_WEIGHT 5318 5319 """Condition will check against the total price of the order.""" 5320 TOTAL_PRICE 5321 } 5322 5323 """The operator to use to determine if the condition passes.""" 5324 enum DeliveryConditionOperator { 5325 """ 5326 The condition will check if the field is greater than or equal to the criteria. 5327 """ 5328 GREATER_THAN_OR_EQUAL_TO 5329 5330 """ 5331 The condition will check if the field is less than or equal to the criteria. 5332 """ 5333 LESS_THAN_OR_EQUAL_TO 5334 } 5335 5336 """A country that is used to define a zone.""" 5337 type DeliveryCountry implements Node { 5338 """ 5339 The ISO 3166-1 alpha-2 country code of this country and a flag indicating Rest Of World. 5340 """ 5341 code: DeliveryCountryCodeOrRestOfWorld! 5342 5343 """Globally unique identifier.""" 5344 id: ID! 5345 5346 """The name of the country.""" 5347 name: String! 5348 5349 """The regions associated with this country.""" 5350 provinces: [DeliveryProvince!]! 5351 5352 """The name of the country, translated based on the user locale.""" 5353 translatedName: String! 5354 } 5355 5356 """A country with the name of the zone.""" 5357 type DeliveryCountryAndZone { 5358 """The country in the delivery zone.""" 5359 country: DeliveryCountry! 5360 5361 """The name of the delivery zone.""" 5362 zone: String! 5363 } 5364 5365 """ 5366 The ISO 3166-1 alpha-2 country code and a flag indicating Rest Of World. 5367 """ 5368 type DeliveryCountryCodeOrRestOfWorld { 5369 """The country code.""" 5370 countryCode: CountryCode 5371 5372 """Indicates if 'Rest of World' is applied.""" 5373 restOfWorld: Boolean! 5374 } 5375 5376 """A list of ISO 3166-1 alpha-2 country codes or the 'Rest of World'.""" 5377 type DeliveryCountryCodesOrRestOfWorld { 5378 """List of applicable country codes.""" 5379 countryCodes: [CountryCode!]! 5380 5381 """Indicates if 'Rest of World' is applied.""" 5382 restOfWorld: Boolean! 5383 } 5384 5385 """Input fields to specify a country.""" 5386 input DeliveryCountryInput { 5387 """The country code of the country.""" 5388 code: CountryCode 5389 5390 """Use Rest of World as the country.""" 5391 restOfWorld: Boolean 5392 5393 """The regions associated with this country.""" 5394 provinces: [DeliveryProvinceInput!] 5395 5396 """Associate all available provinces with this country.""" 5397 includeAllProvinces: Boolean 5398 } 5399 5400 """ 5401 Whether the shop is blocked from converting to full multi-location delivery profiles mode. If the shop is blocked, then the blocking reasons are also returned. 5402 """ 5403 type DeliveryLegacyModeBlocked { 5404 """ 5405 Whether the shop can convert to full multi-location delivery profiles mode. 5406 """ 5407 blocked: Boolean! 5408 5409 """ 5410 The reasons why the shop is blocked from converting to full multi-location delivery profiles mode. 5411 """ 5412 reasons: [DeliveryLegacyModeBlockedReason!] 5413 } 5414 5415 """ 5416 Reasons the shop is blocked from converting to full multi-location delivery profiles mode. 5417 """ 5418 enum DeliveryLegacyModeBlockedReason { 5419 """Multi-Location is disabled.""" 5420 MULTI_LOCATION_DISABLED 5421 5422 """No locations that can fulfill online orders.""" 5423 NO_LOCATIONS_FULFILLING_ONLINE_ORDERS 5424 } 5425 5426 """ 5427 A location group is a collection of active locations that share zone and delivery methods across delivery profiles. 5428 """ 5429 type DeliveryLocationGroup implements Node { 5430 """Globally unique identifier.""" 5431 id: ID! 5432 5433 """List of active locations that are part of this location group.""" 5434 locations( 5435 """Returns up to the first `n` elements from the list.""" 5436 first: Int 5437 5438 """Returns the elements that come after the specified cursor.""" 5439 after: String 5440 5441 """Returns up to the last `n` elements from the list.""" 5442 last: Int 5443 5444 """Returns the elements that come before the specified cursor.""" 5445 before: String 5446 5447 """Reverse the order of the underlying list.""" 5448 reverse: Boolean = false 5449 5450 """Sort the underlying list by the given key.""" 5451 sortKey: LocationSortKeys = NAME 5452 5453 """ 5454 Supported filter parameters: 5455 - `active` 5456 - `address1` 5457 - `address2` 5458 - `city` 5459 - `country` 5460 - `legacy` 5461 - `name` 5462 - `province` 5463 - `zip` 5464 5465 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 5466 for more information about using filters. 5467 5468 """ 5469 query: String 5470 5471 """If true, also include the legacy locations of fulfillment services.""" 5472 includeLegacy: Boolean = false 5473 5474 """If true, also include the locations that are deactivated.""" 5475 includeInactive: Boolean = false 5476 ): LocationConnection! 5477 } 5478 5479 """ 5480 Links a location group and zone with the associated method definitions in a delivery profile. 5481 """ 5482 type DeliveryLocationGroupZone { 5483 """The number of method definitions in this zone.""" 5484 methodDefinitionCounts: DeliveryMethodDefinitionCounts! 5485 5486 """ 5487 The method definitions associated to a zone and location group in a delivery profile. 5488 """ 5489 methodDefinitions( 5490 """Return only eligible or ineligible method definitions.""" 5491 eligible: Boolean 5492 5493 """Return only merchant or participant method definitions.""" 5494 type: DeliveryMethodDefinitionType 5495 5496 """Returns up to the first `n` elements from the list.""" 5497 first: Int 5498 5499 """Returns the elements that come after the specified cursor.""" 5500 after: String 5501 5502 """Returns up to the last `n` elements from the list.""" 5503 last: Int 5504 5505 """Returns the elements that come before the specified cursor.""" 5506 before: String 5507 5508 """Reverse the order of the underlying list.""" 5509 reverse: Boolean = false 5510 5511 """Sort the underlying list by the given key.""" 5512 sortKey: MethodDefinitionSortKeys = ID 5513 ): DeliveryMethodDefinitionConnection! 5514 5515 """The zone associated to a location group in a delivery profile.""" 5516 zone: DeliveryZone! 5517 } 5518 5519 """ 5520 An auto-generated type for paginating through multiple DeliveryLocationGroupZones. 5521 5522 """ 5523 type DeliveryLocationGroupZoneConnection { 5524 """A list of edges.""" 5525 edges: [DeliveryLocationGroupZoneEdge!]! 5526 5527 """Information to aid in pagination.""" 5528 pageInfo: PageInfo! 5529 } 5530 5531 """ 5532 An auto-generated type which holds one DeliveryLocationGroupZone and a cursor during pagination. 5533 5534 """ 5535 type DeliveryLocationGroupZoneEdge { 5536 """A cursor for use in pagination.""" 5537 cursor: String! 5538 5539 """The item at the end of DeliveryLocationGroupZoneEdge.""" 5540 node: DeliveryLocationGroupZone! 5541 } 5542 5543 """ 5544 Input fields for a delivery zone associated to a location group and profile. 5545 """ 5546 input DeliveryLocationGroupZoneInput { 5547 """Globally unique identifier of the Zone.""" 5548 id: ID 5549 5550 """The name of the zone.""" 5551 name: String 5552 5553 """Countries to associate with the zone.""" 5554 countries: [DeliveryCountryInput!] 5555 5556 """Method definitions to create.""" 5557 methodDefinitionsToCreate: [DeliveryMethodDefinitionInput!] 5558 5559 """Method definitions to update.""" 5560 methodDefinitionsToUpdate: [DeliveryMethodDefinitionInput!] 5561 } 5562 5563 """Delivery method.""" 5564 type DeliveryMethod implements Node { 5565 """Globally unique identifier.""" 5566 id: ID! 5567 5568 """The type of the delivery method.""" 5569 methodType: DeliveryMethodType! 5570 } 5571 5572 """ 5573 A method definition describes the delivery rate and the conditions that must be met for the method to be applied. 5574 """ 5575 type DeliveryMethodDefinition implements Node { 5576 """Whether this method definition is active.""" 5577 active: Boolean! 5578 5579 """The description of the method definition.""" 5580 description: String 5581 5582 """Globally unique identifier.""" 5583 id: ID! 5584 5585 """ 5586 The method conditions that must pass for this method definition to be applied to an order. 5587 """ 5588 methodConditions: [DeliveryCondition!]! 5589 5590 """The name of the method definition.""" 5591 name: String! 5592 5593 """ 5594 Provided rate for this method definition, from a rate definition or participant. 5595 """ 5596 rateProvider: DeliveryRateProvider! 5597 } 5598 5599 """ 5600 An auto-generated type for paginating through multiple DeliveryMethodDefinitions. 5601 5602 """ 5603 type DeliveryMethodDefinitionConnection { 5604 """A list of edges.""" 5605 edges: [DeliveryMethodDefinitionEdge!]! 5606 5607 """Information to aid in pagination.""" 5608 pageInfo: PageInfo! 5609 } 5610 5611 """ 5612 Then number of method definitions in a zone, separated into merchant-owned and participant definitions. 5613 """ 5614 type DeliveryMethodDefinitionCounts { 5615 """The number of participant method definitions in the current zone.""" 5616 participantDefinitionsCount: Int! 5617 5618 """The number of merchant-defined method definitions in the current zone.""" 5619 rateDefinitionsCount: Int! 5620 } 5621 5622 """ 5623 An auto-generated type which holds one DeliveryMethodDefinition and a cursor during pagination. 5624 5625 """ 5626 type DeliveryMethodDefinitionEdge { 5627 """A cursor for use in pagination.""" 5628 cursor: String! 5629 5630 """The item at the end of DeliveryMethodDefinitionEdge.""" 5631 node: DeliveryMethodDefinition! 5632 } 5633 5634 """Input fields for a method definition.""" 5635 input DeliveryMethodDefinitionInput { 5636 """ 5637 Globally unique identifier of the method definition. Use only when updating a method definiton. 5638 """ 5639 id: ID 5640 5641 """The name of the method definition.""" 5642 name: String 5643 5644 """The description of the method definition.""" 5645 description: String 5646 5647 """Whether or not to use this method definition during rate calculation.""" 5648 active: Boolean 5649 5650 """A rate definition to apply to the method definition.""" 5651 rateDefinition: DeliveryRateDefinitionInput 5652 5653 """A participant to apply to the method definition.""" 5654 participant: DeliveryParticipantInput 5655 5656 """Weight conditions on the method definition.""" 5657 weightConditionsToCreate: [DeliveryWeightConditionInput!] 5658 5659 """Price conditions on the method definition.""" 5660 priceConditionsToCreate: [DeliveryPriceConditionInput!] 5661 5662 """Conditions on the method definition to update.""" 5663 conditionsToUpdate: [DeliveryUpdateConditionInput!] 5664 } 5665 5666 """The different types of method definitions to filter by.""" 5667 enum DeliveryMethodDefinitionType { 5668 """Static mechant-defined rates.""" 5669 MERCHANT 5670 5671 """Dynamic participant rates.""" 5672 PARTICIPANT 5673 } 5674 5675 """Possible method types that a delivery method can have.""" 5676 enum DeliveryMethodType { 5677 """Shipping delivery method.""" 5678 SHIPPING 5679 5680 """Pick-up delivery method.""" 5681 PICK_UP 5682 5683 """No delivery method.""" 5684 NONE 5685 5686 """ 5687 Retail delivery method represents items delivered immediately in a retail store. 5688 """ 5689 RETAIL 5690 5691 """Local delivery method.""" 5692 LOCAL 5693 } 5694 5695 """ 5696 A carrier-defined rate with possible merchant-defined fixed fee or percentage-of-rate fee. 5697 """ 5698 type DeliveryParticipant implements Node { 5699 """Flag to indicate if new available services should be included.""" 5700 adaptToNewServicesFlag: Boolean! 5701 5702 """Use this carrier service for this participant.""" 5703 carrierService: DeliveryCarrierService! 5704 5705 """The merchant-set fixed fee for this participant.""" 5706 fixedFee: MoneyV2 5707 5708 """Globally unique identifier.""" 5709 id: ID! 5710 5711 """Services offered by the participant and their active status.""" 5712 participantServices: [DeliveryParticipantService!]! 5713 5714 """The merchant-set percentage-of-rate fee for this participant.""" 5715 percentageOfRateFee: Float! 5716 } 5717 5718 """Input fields for a participant.""" 5719 input DeliveryParticipantInput { 5720 """Globally unique identifier of the participant.""" 5721 id: ID 5722 5723 """Global identifier of the carrier service.""" 5724 carrierServiceId: ID 5725 5726 """The merchant-set fixed fee for this participant.""" 5727 fixedFee: MoneyInput 5728 5729 """The merchant-set percentage-of-rate fee for this participant.""" 5730 percentageOfRateFee: Float 5731 5732 """Services offered by the participant and their active status.""" 5733 participantServices: [DeliveryParticipantServiceInput!] 5734 5735 """Flag to indicate if new available services should be included.""" 5736 adaptToNewServices: Boolean 5737 } 5738 5739 """A service provided by a participant.""" 5740 type DeliveryParticipantService { 5741 """If the service is active or not.""" 5742 active: Boolean! 5743 5744 """Name of the service.""" 5745 name: String! 5746 } 5747 5748 """Input fields for a service provided by a participant.""" 5749 input DeliveryParticipantServiceInput { 5750 """Name of the service.""" 5751 name: String! 5752 5753 """If the service is active or not.""" 5754 active: Boolean! 5755 } 5756 5757 """Input fields for the price-based conditions of a method definition.""" 5758 input DeliveryPriceConditionInput { 5759 """The criteria for the price.""" 5760 criteria: MoneyInput 5761 5762 """The operator to use for comparison.""" 5763 operator: DeliveryConditionOperator 5764 } 5765 5766 """ 5767 How many product variants are in a profile. This count is capped at 500. 5768 """ 5769 type DeliveryProductVariantsCount { 5770 """If the count has reached the cap of 500.""" 5771 capped: Boolean! 5772 5773 """The product variant count.""" 5774 count: Int! 5775 } 5776 5777 """A profile for multi-location, per-product delivery.""" 5778 type DeliveryProfile implements Node { 5779 """The number of active shipping rates for the profile.""" 5780 activeMethodDefinitionsCount: Int! 5781 5782 """Whether this is the default profile.""" 5783 default: Boolean! 5784 5785 """Globally unique identifier.""" 5786 id: ID! 5787 5788 """ 5789 Whether this shop has enabled legacy compatibility mode for delivery profiles. 5790 """ 5791 legacyMode: Boolean! 5792 5793 """The number of locations without rates defined.""" 5794 locationsWithoutRatesCount: Int! 5795 5796 """The name of the delivery profile.""" 5797 name: String! 5798 5799 """The number of active origin locations for the profile.""" 5800 originLocationCount: Int! 5801 5802 """ 5803 The number of product variants for this profile. The count for the default profile is not supported and will return -1. 5804 """ 5805 productVariantsCount: Int! @deprecated(reason: "Use `productVariantsCountV2` instead") 5806 5807 """How many product variants are in this profile.""" 5808 productVariantsCountV2: DeliveryProductVariantsCount! 5809 5810 """The products and variants associated with this profile.""" 5811 profileItems( 5812 """Returns up to the first `n` elements from the list.""" 5813 first: Int 5814 5815 """Returns the elements that come after the specified cursor.""" 5816 after: String 5817 5818 """Returns up to the last `n` elements from the list.""" 5819 last: Int 5820 5821 """Returns the elements that come before the specified cursor.""" 5822 before: String 5823 5824 """Reverse the order of the underlying list.""" 5825 reverse: Boolean = false 5826 5827 """ 5828 Sort the underlying list by the given key. This argument is deprecated: Profile item sorting is no longer supported. 5829 """ 5830 sortKey: ProfileItemSortKeys = ID 5831 ): DeliveryProfileItemConnection! 5832 5833 """The location groups and associated zones using this profile.""" 5834 profileLocationGroups: [DeliveryProfileLocationGroup!]! 5835 5836 """Selling Plan Groups associated with the specified Delivery Profile.""" 5837 sellingPlanGroups( 5838 """Returns up to the first `n` elements from the list.""" 5839 first: Int 5840 5841 """Returns the elements that come after the specified cursor.""" 5842 after: String 5843 5844 """Returns up to the last `n` elements from the list.""" 5845 last: Int 5846 5847 """Returns the elements that come before the specified cursor.""" 5848 before: String 5849 5850 """Reverse the order of the underlying list.""" 5851 reverse: Boolean = false 5852 ): SellingPlanGroupConnection! 5853 5854 """ 5855 List of locations that have not been assigned to a location group for this profile. 5856 """ 5857 unassignedLocations: [Location!]! 5858 5859 """The number of countries with active rates to deliver to.""" 5860 zoneCountryCount: Int! 5861 } 5862 5863 """ 5864 An auto-generated type for paginating through multiple DeliveryProfiles. 5865 5866 """ 5867 type DeliveryProfileConnection { 5868 """A list of edges.""" 5869 edges: [DeliveryProfileEdge!]! 5870 5871 """Information to aid in pagination.""" 5872 pageInfo: PageInfo! 5873 } 5874 5875 """ 5876 An auto-generated type which holds one DeliveryProfile and a cursor during pagination. 5877 5878 """ 5879 type DeliveryProfileEdge { 5880 """A cursor for use in pagination.""" 5881 cursor: String! 5882 5883 """The item at the end of DeliveryProfileEdge.""" 5884 node: DeliveryProfile! 5885 } 5886 5887 """Input fields for a delivery profile.""" 5888 input DeliveryProfileInput { 5889 """The name of the profile.""" 5890 name: String 5891 5892 """The location groups associated with the profile.""" 5893 profileLocationGroups: [DeliveryProfileLocationGroupInput!] 5894 5895 """The location groups to be created in the profile.""" 5896 locationGroupsToCreate: [DeliveryProfileLocationGroupInput!] 5897 5898 """The location groups to be updated in the profile.""" 5899 locationGroupsToUpdate: [DeliveryProfileLocationGroupInput!] 5900 5901 """The location groups to be deleted in the profile.""" 5902 locationGroupsToDelete: [ID!] 5903 5904 """The product variant ids to be associated with this profile.""" 5905 variantsToAssociate: [ID!] 5906 5907 """ 5908 The product variant ids to be dissociated from this profile and returned to the default profile. 5909 """ 5910 variantsToDissociate: [ID!] 5911 5912 """Zones to delete.""" 5913 zonesToDelete: [ID!] 5914 5915 """Method definitions to delete.""" 5916 methodDefinitionsToDelete: [ID!] 5917 5918 """Conditions to delete.""" 5919 conditionsToDelete: [ID!] 5920 5921 """The selling plan groups to be associated with this profile.""" 5922 sellingPlanGroupsToAssociate: [ID!] 5923 5924 """The selling plan groups to be dissociated with this profile.""" 5925 sellingPlanGroupsToDissociate: [ID!] 5926 } 5927 5928 """ 5929 A product and the subset of associated variants that are part of this delivery profile. 5930 """ 5931 type DeliveryProfileItem { 5932 """A product associated with this profile.""" 5933 product: Product! 5934 5935 """The product variants associated with this delivery profile.""" 5936 variants( 5937 """Returns up to the first `n` elements from the list.""" 5938 first: Int 5939 5940 """Returns the elements that come after the specified cursor.""" 5941 after: String 5942 5943 """Returns up to the last `n` elements from the list.""" 5944 last: Int 5945 5946 """Returns the elements that come before the specified cursor.""" 5947 before: String 5948 5949 """Reverse the order of the underlying list.""" 5950 reverse: Boolean = false 5951 5952 """ 5953 Sort the underlying list by the given key. This argument is deprecated: Profile item variant sorting is no longer supported. 5954 """ 5955 sortKey: ProductVariantSortKeys = ID 5956 ): ProductVariantConnection! 5957 } 5958 5959 """ 5960 An auto-generated type for paginating through multiple DeliveryProfileItems. 5961 5962 """ 5963 type DeliveryProfileItemConnection { 5964 """A list of edges.""" 5965 edges: [DeliveryProfileItemEdge!]! 5966 5967 """Information to aid in pagination.""" 5968 pageInfo: PageInfo! 5969 } 5970 5971 """ 5972 An auto-generated type which holds one DeliveryProfileItem and a cursor during pagination. 5973 5974 """ 5975 type DeliveryProfileItemEdge { 5976 """A cursor for use in pagination.""" 5977 cursor: String! 5978 5979 """The item at the end of DeliveryProfileItemEdge.""" 5980 node: DeliveryProfileItem! 5981 } 5982 5983 """Links a location group with zones associated to a delivery profile.""" 5984 type DeliveryProfileLocationGroup { 5985 """ 5986 The countries already selected in any zone for the given location group and profile. 5987 """ 5988 countriesInAnyZone: [DeliveryCountryAndZone!]! 5989 5990 """The location group associated to a delivery profile.""" 5991 locationGroup: DeliveryLocationGroup! 5992 5993 """ 5994 The applicable zones associated to a location group and delivery profile. 5995 """ 5996 locationGroupZones( 5997 """Returns up to the first `n` elements from the list.""" 5998 first: Int 5999 6000 """Returns the elements that come after the specified cursor.""" 6001 after: String 6002 6003 """Returns up to the last `n` elements from the list.""" 6004 last: Int 6005 6006 """Returns the elements that come before the specified cursor.""" 6007 before: String 6008 6009 """Reverse the order of the underlying list.""" 6010 reverse: Boolean = false 6011 ): DeliveryLocationGroupZoneConnection! 6012 } 6013 6014 """Input fields for a delivery location group associated to a profile.""" 6015 input DeliveryProfileLocationGroupInput { 6016 """Globally unique identifier of the LocationGroup.""" 6017 id: ID 6018 6019 """The location ids of the locations to be moved to this location group.""" 6020 locations: [ID!] 6021 6022 """Zones to create.""" 6023 zonesToCreate: [DeliveryLocationGroupZoneInput!] 6024 6025 """Zones to update.""" 6026 zonesToUpdate: [DeliveryLocationGroupZoneInput!] 6027 } 6028 6029 """A region that is used to define a zone.""" 6030 type DeliveryProvince implements Node { 6031 """The code of this region.""" 6032 code: String! 6033 6034 """Globally unique identifier.""" 6035 id: ID! 6036 6037 """The name of the region.""" 6038 name: String! 6039 6040 """The name of the region, translated based on the user locale.""" 6041 translatedName: String! 6042 } 6043 6044 """The input fields to specify a region.""" 6045 input DeliveryProvinceInput { 6046 """The code of the region.""" 6047 code: String! 6048 } 6049 6050 """The merchant-defined rate of the DeliveryMethodDefinition.""" 6051 type DeliveryRateDefinition implements Node { 6052 """Globally unique identifier.""" 6053 id: ID! 6054 6055 """The price of this rate.""" 6056 price: MoneyV2! 6057 } 6058 6059 """Input fields for a rate definition.""" 6060 input DeliveryRateDefinitionInput { 6061 """Globally unique identifier of the rate definition.""" 6062 id: ID 6063 6064 """The price of the rate definition.""" 6065 price: MoneyInput! 6066 } 6067 6068 """Rate provided by a rate definition or a participant.""" 6069 union DeliveryRateProvider = DeliveryParticipant | DeliveryRateDefinition 6070 6071 """Delivery shop-level settings.""" 6072 type DeliverySetting { 6073 """ 6074 Whether the shop is blocked from converting to full multi-location delivery profiles mode. If the shop is blocked, then the blocking reasons are also returned. 6075 """ 6076 legacyModeBlocked: DeliveryLegacyModeBlocked! 6077 6078 """ 6079 Enables legacy compatability mode for the multi-location delivery profiles feature. 6080 """ 6081 legacyModeProfiles: Boolean! 6082 } 6083 6084 """Input fields for shop-level delivery settings.""" 6085 input DeliverySettingInput { 6086 """ 6087 Enables legacy compatability mode for the multi-location delivery profiles feature. 6088 """ 6089 legacyModeProfiles: Boolean 6090 } 6091 6092 """Return type for `deliverySettingUpdate` mutation.""" 6093 type DeliverySettingUpdatePayload { 6094 """The updated delivery shop level settings.""" 6095 setting: DeliverySetting 6096 6097 """List of errors that occurred executing the mutation.""" 6098 userErrors: [UserError!]! 6099 } 6100 6101 """Return type for `deliveryShippingOriginAssign` mutation.""" 6102 type DeliveryShippingOriginAssignPayload { 6103 """List of errors that occurred executing the mutation.""" 6104 userErrors: [UserError!]! 6105 } 6106 6107 """Input fields for updating the conditions of a method definition.""" 6108 input DeliveryUpdateConditionInput { 6109 """Globally unique identifier of the condition.""" 6110 id: ID! 6111 6112 """The value of the criteria of the condition.""" 6113 criteria: Float 6114 6115 """The unit of the criteria of the condition.""" 6116 criteriaUnit: String 6117 6118 """The field to use, either total_weight or total_price.""" 6119 field: DeliveryConditionField 6120 6121 """The operator to use for comparison.""" 6122 operator: DeliveryConditionOperator 6123 } 6124 6125 """Input fields for the weight-based conditions of a method definition.""" 6126 input DeliveryWeightConditionInput { 6127 """The criteria for the weight.""" 6128 criteria: WeightInput 6129 6130 """The operator to use for comparison.""" 6131 operator: DeliveryConditionOperator 6132 } 6133 6134 """ 6135 A zone is a geographical area that contains delivery methods within a delivery profile. 6136 """ 6137 type DeliveryZone implements Node { 6138 """The list of countries within the zone.""" 6139 countries: [DeliveryCountry!]! 6140 6141 """Globally unique identifier.""" 6142 id: ID! 6143 6144 """The name of the zone.""" 6145 name: String! 6146 } 6147 6148 """ 6149 Digital wallet, such as Apple Pay, which can be used for accelerated checkouts. 6150 """ 6151 enum DigitalWallet { 6152 """Apple Pay.""" 6153 APPLE_PAY 6154 6155 """Android Pay.""" 6156 ANDROID_PAY 6157 6158 """Google Pay.""" 6159 GOOGLE_PAY 6160 6161 """Shopify Pay.""" 6162 SHOPIFY_PAY 6163 } 6164 6165 """ 6166 An amount discounting the line that has been allocated by an associated discount application. 6167 6168 """ 6169 type DiscountAllocation { 6170 """Money amount allocated by the discount application.""" 6171 allocatedAmount: MoneyV2! @deprecated(reason: "Use `allocatedAmountSet` instead") 6172 6173 """ 6174 Money amount allocated by the discount application in shop and presentment currencies. 6175 """ 6176 allocatedAmountSet: MoneyBag! 6177 6178 """The discount of which this allocated amount originated from.""" 6179 discountApplication: DiscountApplication! 6180 } 6181 6182 """The fixed amount value of a discount.""" 6183 type DiscountAmount { 6184 """The value of the discount.""" 6185 amount: MoneyV2! 6186 6187 """ 6188 If true, then the discount is applied to each of the entitled items. If false, then the amount is split across all of the entitled items. 6189 """ 6190 appliesOnEachItem: Boolean! 6191 } 6192 6193 """Specifies the value of the discount and how it is applied.""" 6194 input DiscountAmountInput { 6195 """The value of the discount.""" 6196 amount: Decimal 6197 6198 """ 6199 If true, then the discount is applied to each of the entitled items. If false, then the amount is split across all of the entitled items. 6200 """ 6201 appliesOnEachItem: Boolean 6202 } 6203 6204 """ 6205 Discount applications capture the intentions of a discount source at 6206 the time of application on an order's line items or shipping lines. 6207 6208 """ 6209 interface DiscountApplication { 6210 """ 6211 The method by which the discount's value is allocated to its entitled items. 6212 """ 6213 allocationMethod: DiscountApplicationAllocationMethod! 6214 6215 """ 6216 An ordered index that can be used to identify the discount application and indicate the precedence 6217 of the discount application for calculations. 6218 6219 """ 6220 index: Int! 6221 6222 """How the discount amount is distributed on the discounted lines.""" 6223 targetSelection: DiscountApplicationTargetSelection! 6224 6225 """Whether the discount is applied on line items or shipping lines.""" 6226 targetType: DiscountApplicationTargetType! 6227 6228 """The value of the discount application.""" 6229 value: PricingValue! 6230 } 6231 6232 """ 6233 The method by which the discount's value is allocated onto its entitled lines. 6234 """ 6235 enum DiscountApplicationAllocationMethod { 6236 """The value is spread across all entitled lines.""" 6237 ACROSS 6238 6239 """The value is applied onto every entitled line.""" 6240 EACH 6241 6242 """The value is specifically applied onto a particular line.""" 6243 ONE @deprecated(reason: "Use ACROSS instead.") 6244 } 6245 6246 """ 6247 An auto-generated type for paginating through multiple DiscountApplications. 6248 6249 """ 6250 type DiscountApplicationConnection { 6251 """A list of edges.""" 6252 edges: [DiscountApplicationEdge!]! 6253 6254 """Information to aid in pagination.""" 6255 pageInfo: PageInfo! 6256 } 6257 6258 """ 6259 An auto-generated type which holds one DiscountApplication and a cursor during pagination. 6260 6261 """ 6262 type DiscountApplicationEdge { 6263 """A cursor for use in pagination.""" 6264 cursor: String! 6265 6266 """The item at the end of DiscountApplicationEdge.""" 6267 node: DiscountApplication! 6268 } 6269 6270 """ 6271 The method by which the discount's value is allocated onto its entitled lines. 6272 """ 6273 enum DiscountApplicationLevel { 6274 """ 6275 The discount was applied at the order level. 6276 Order level discounts are not factored into the discountedUnitPriceSet on line items. 6277 6278 """ 6279 ORDER 6280 6281 """ 6282 The discount was applied at the line level. 6283 Line level discounts are factored into the discountedUnitPriceSet on line items. 6284 6285 """ 6286 LINE 6287 } 6288 6289 """ 6290 Which lines on the order that the discount is allocated over, of the type 6291 defined by the Discount Application's target_type. 6292 6293 """ 6294 enum DiscountApplicationTargetSelection { 6295 """The discount is allocated onto all the lines.""" 6296 ALL 6297 6298 """The discount is allocated onto only the lines it is entitled for.""" 6299 ENTITLED 6300 6301 """The discount is allocated onto explicitly chosen lines.""" 6302 EXPLICIT 6303 } 6304 6305 """ 6306 The type of line (i.e. line item or shipping line) on an order that the discount is applicable towards. 6307 6308 """ 6309 enum DiscountApplicationTargetType { 6310 """The discount applies onto line items.""" 6311 LINE_ITEM 6312 6313 """The discount applies onto shipping lines.""" 6314 SHIPPING_LINE 6315 } 6316 6317 """An automatic discount.""" 6318 union DiscountAutomatic = DiscountAutomaticBasic | DiscountAutomaticBxgy 6319 6320 """Return type for `discountAutomaticActivate` mutation.""" 6321 type DiscountAutomaticActivatePayload { 6322 """The activated automatic discount.""" 6323 automaticDiscountNode: DiscountAutomaticNode 6324 6325 """List of errors that occurred executing the mutation.""" 6326 userErrors: [DiscountUserError!]! 6327 } 6328 6329 """An automatic basic discount.""" 6330 type DiscountAutomaticBasic { 6331 """ 6332 The number of times the discount has been used. This value is updated asynchronously and can be different than the actual usage count. 6333 """ 6334 asyncUsageCount: Int! 6335 6336 """The date and time when the discount was created.""" 6337 createdAt: DateTime! 6338 6339 """ 6340 The qualifying items in an order, the quantity of each one, and the total value of the discount. 6341 """ 6342 customerGets: DiscountCustomerGets! 6343 6344 """ 6345 The date and time when the discount ends. For open-ended discounts, use `null`. 6346 """ 6347 endsAt: DateTime 6348 6349 """ 6350 The minimum subtotal or quantity that's required for the discount to be applied. 6351 """ 6352 minimumRequirement: DiscountMinimumRequirement! 6353 6354 """A short summary of the discount.""" 6355 shortSummary: String! 6356 6357 """The date and time when the discount starts.""" 6358 startsAt: DateTime! 6359 6360 """The status of the discount.""" 6361 status: DiscountStatus! 6362 6363 """A detailed summary of the discount.""" 6364 summary: String! 6365 6366 """The title of the discount.""" 6367 title: String! 6368 6369 """The number of times that the discount has been used.""" 6370 usageCount: Int! @deprecated(reason: "Use `asyncUsageCount` instead") 6371 } 6372 6373 """Return type for `discountAutomaticBasicCreate` mutation.""" 6374 type DiscountAutomaticBasicCreatePayload { 6375 """The created automatic discount.""" 6376 automaticDiscountNode: DiscountAutomaticNode 6377 6378 """List of errors that occurred executing the mutation.""" 6379 userErrors: [DiscountUserError!]! 6380 } 6381 6382 """Specifies input field to create or update automatic basic discount.""" 6383 input DiscountAutomaticBasicInput { 6384 """The title of the discount.""" 6385 title: String 6386 6387 """The date and time when the discount starts.""" 6388 startsAt: DateTime 6389 6390 """ 6391 The date and time when the discount ends. For open-ended discounts, use `null`. 6392 """ 6393 endsAt: DateTime 6394 6395 """ 6396 The minimum subtotal or quantity that's required for the discount to be applied. 6397 """ 6398 minimumRequirement: DiscountMinimumRequirementInput 6399 6400 """ 6401 The qualifying items in an order, the quantity of each one, and the total value of the discount. 6402 """ 6403 customerGets: DiscountCustomerGetsInput 6404 } 6405 6406 """Return type for `discountAutomaticBasicUpdate` mutation.""" 6407 type DiscountAutomaticBasicUpdatePayload { 6408 """The updated automatic discount.""" 6409 automaticDiscountNode: DiscountAutomaticNode 6410 6411 """List of errors that occurred executing the mutation.""" 6412 userErrors: [DiscountUserError!]! 6413 } 6414 6415 """Return type for `discountAutomaticBulkDelete` mutation.""" 6416 type DiscountAutomaticBulkDeletePayload { 6417 """The asynchronous job removing the automatic discounts.""" 6418 job: Job 6419 6420 """List of errors that occurred executing the mutation.""" 6421 userErrors: [DiscountUserError!]! 6422 } 6423 6424 """An automatic BXGY discount.""" 6425 type DiscountAutomaticBxgy implements Node & HasEvents { 6426 """ 6427 The number of times the discount has been used. This value is updated asynchronously and can be different than the actual usage count. 6428 """ 6429 asyncUsageCount: Int! 6430 6431 """The date and time when the discount was created.""" 6432 createdAt: DateTime! 6433 6434 """ 6435 The qualifying items and the quantity of each one that the customer has to buy to be eligible for the discount. 6436 """ 6437 customerBuys: DiscountCustomerBuys! 6438 6439 """ 6440 The qualifying items in an order, the quantity of each one, and the total value of the discount. 6441 """ 6442 customerGets: DiscountCustomerGets! 6443 6444 """ 6445 The date and time when the discount ends. For open-ended discounts, use `null`. 6446 """ 6447 endsAt: DateTime 6448 6449 """The paginated list of events associated with the host subject.""" 6450 events( 6451 """Returns up to the first `n` elements from the list.""" 6452 first: Int 6453 6454 """Returns the elements that come after the specified cursor.""" 6455 after: String 6456 6457 """Returns up to the last `n` elements from the list.""" 6458 last: Int 6459 6460 """Returns the elements that come before the specified cursor.""" 6461 before: String 6462 6463 """Reverse the order of the underlying list.""" 6464 reverse: Boolean = false 6465 6466 """Sort the underlying list by the given key.""" 6467 sortKey: EventSortKeys = ID 6468 6469 """ 6470 Supported filter parameters: 6471 - `comments` 6472 - `created_at` 6473 - `subject_type` 6474 - `verb` 6475 6476 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 6477 for more information about using filters. 6478 6479 """ 6480 query: String 6481 ): EventConnection! 6482 6483 """A legacy unique identifier for the discount.""" 6484 id: ID! @deprecated(reason: "Use DiscountAutomaticNode.id instead.") 6485 6486 """The date and time when the discount starts.""" 6487 startsAt: DateTime! 6488 6489 """The status of the discount.""" 6490 status: DiscountStatus! 6491 6492 """A detailed summary of the discount.""" 6493 summary: String! 6494 6495 """The title of the discount.""" 6496 title: String! 6497 6498 """The number of times that the discount has been used.""" 6499 usageCount: Int! @deprecated(reason: "Use `asyncUsageCount` instead") 6500 6501 """ 6502 The maximum number of times that the discount can be applied to an order. 6503 """ 6504 usesPerOrderLimit: Int 6505 } 6506 6507 """Return type for `discountAutomaticBxgyCreate` mutation.""" 6508 type DiscountAutomaticBxgyCreatePayload { 6509 """The created automatic discount.""" 6510 automaticDiscountNode: DiscountAutomaticNode 6511 6512 """List of errors that occurred executing the mutation.""" 6513 userErrors: [DiscountUserError!]! 6514 } 6515 6516 """Specifies input field to create or update automatic bogo discount.""" 6517 input DiscountAutomaticBxgyInput { 6518 """The date and time when the discount starts.""" 6519 startsAt: DateTime 6520 6521 """ 6522 The date and time when the discount ends. For open-ended discounts, use `null`. 6523 """ 6524 endsAt: DateTime 6525 6526 """The title of the discount.""" 6527 title: String 6528 6529 """ 6530 The maximum number of times that the discount can be applied to an order. 6531 """ 6532 usesPerOrderLimit: UnsignedInt64 6533 6534 """ 6535 The qualifying items and the quantity of each one that the customer has to buy to be eligible for the discount. 6536 """ 6537 customerBuys: DiscountCustomerBuysInput 6538 6539 """ 6540 The qualifying items in an order, the quantity of each one, and the total value of the discount. 6541 """ 6542 customerGets: DiscountCustomerGetsInput 6543 } 6544 6545 """Return type for `discountAutomaticBxgyUpdate` mutation.""" 6546 type DiscountAutomaticBxgyUpdatePayload { 6547 """The updated automatic discount.""" 6548 automaticDiscountNode: DiscountAutomaticNode 6549 6550 """List of errors that occurred executing the mutation.""" 6551 userErrors: [DiscountUserError!]! 6552 } 6553 6554 """ 6555 An auto-generated type for paginating through multiple DiscountAutomatics. 6556 6557 """ 6558 type DiscountAutomaticConnection { 6559 """A list of edges.""" 6560 edges: [DiscountAutomaticEdge!]! 6561 6562 """Information to aid in pagination.""" 6563 pageInfo: PageInfo! 6564 } 6565 6566 """Return type for `discountAutomaticDeactivate` mutation.""" 6567 type DiscountAutomaticDeactivatePayload { 6568 """The deactivated automatic discount.""" 6569 automaticDiscountNode: DiscountAutomaticNode 6570 6571 """List of errors that occurred executing the mutation.""" 6572 userErrors: [DiscountUserError!]! 6573 } 6574 6575 """Return type for `discountAutomaticDelete` mutation.""" 6576 type DiscountAutomaticDeletePayload { 6577 """The deleted automatic discount ID.""" 6578 deletedAutomaticDiscountId: ID 6579 6580 """List of errors that occurred executing the mutation.""" 6581 userErrors: [DiscountUserError!]! 6582 } 6583 6584 """ 6585 An auto-generated type which holds one DiscountAutomatic and a cursor during pagination. 6586 6587 """ 6588 type DiscountAutomaticEdge { 6589 """A cursor for use in pagination.""" 6590 cursor: String! 6591 6592 """The item at the end of DiscountAutomaticEdge.""" 6593 node: DiscountAutomatic! 6594 } 6595 6596 """An automatic discount wrapper node.""" 6597 type DiscountAutomaticNode implements Node & HasEvents { 6598 """An automatic discount.""" 6599 automaticDiscount: DiscountAutomatic! 6600 6601 """The paginated list of events associated with the host subject.""" 6602 events( 6603 """Returns up to the first `n` elements from the list.""" 6604 first: Int 6605 6606 """Returns the elements that come after the specified cursor.""" 6607 after: String 6608 6609 """Returns up to the last `n` elements from the list.""" 6610 last: Int 6611 6612 """Returns the elements that come before the specified cursor.""" 6613 before: String 6614 6615 """Reverse the order of the underlying list.""" 6616 reverse: Boolean = false 6617 6618 """Sort the underlying list by the given key.""" 6619 sortKey: EventSortKeys = ID 6620 6621 """ 6622 Supported filter parameters: 6623 - `comments` 6624 - `created_at` 6625 - `subject_type` 6626 - `verb` 6627 6628 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 6629 for more information about using filters. 6630 6631 """ 6632 query: String 6633 ): EventConnection! 6634 6635 """Globally unique identifier.""" 6636 id: ID! 6637 } 6638 6639 """ 6640 An auto-generated type for paginating through multiple DiscountAutomaticNodes. 6641 6642 """ 6643 type DiscountAutomaticNodeConnection { 6644 """A list of edges.""" 6645 edges: [DiscountAutomaticNodeEdge!]! 6646 6647 """Information to aid in pagination.""" 6648 pageInfo: PageInfo! 6649 } 6650 6651 """ 6652 An auto-generated type which holds one DiscountAutomaticNode and a cursor during pagination. 6653 6654 """ 6655 type DiscountAutomaticNodeEdge { 6656 """A cursor for use in pagination.""" 6657 cursor: String! 6658 6659 """The item at the end of DiscountAutomaticNodeEdge.""" 6660 node: DiscountAutomaticNode! 6661 } 6662 6663 """A code discount.""" 6664 union DiscountCode = DiscountCodeBasic | DiscountCodeBxgy | DiscountCodeFreeShipping 6665 6666 """Return type for `discountCodeActivate` mutation.""" 6667 type DiscountCodeActivatePayload { 6668 """The activated code discount.""" 6669 codeDiscountNode: DiscountCodeNode 6670 6671 """List of errors that occurred executing the mutation.""" 6672 userErrors: [DiscountUserError!]! 6673 } 6674 6675 """ 6676 Discount code applications capture the intentions of a discount code at 6677 the time that it is applied onto an order. 6678 6679 """ 6680 type DiscountCodeApplication implements DiscountApplication { 6681 """ 6682 The method by which the discount's value is allocated to its entitled items. 6683 """ 6684 allocationMethod: DiscountApplicationAllocationMethod! 6685 6686 """ 6687 The string identifying the discount code that was used at the time of application. 6688 """ 6689 code: String! 6690 6691 """ 6692 An ordered index that can be used to identify the discount application and indicate the precedence 6693 of the discount application for calculations. 6694 6695 """ 6696 index: Int! 6697 6698 """How the discount amount is distributed on the discounted lines.""" 6699 targetSelection: DiscountApplicationTargetSelection! 6700 6701 """Whether the discount is applied on line items or shipping lines.""" 6702 targetType: DiscountApplicationTargetType! 6703 6704 """The value of the discount application.""" 6705 value: PricingValue! 6706 } 6707 6708 """A basic code discount.""" 6709 type DiscountCodeBasic { 6710 """Whether the discount can be applied only once per customer.""" 6711 appliesOncePerCustomer: Boolean! 6712 6713 """The number of times that the discount has been used.""" 6714 asyncUsageCount: Int! 6715 6716 """The number of redeem codes for the discount.""" 6717 codeCount: Int! 6718 6719 """A list of redeem codes for the discount.""" 6720 codes( 6721 """Returns up to the first `n` elements from the list.""" 6722 first: Int 6723 6724 """Returns the elements that come after the specified cursor.""" 6725 after: String 6726 6727 """Returns up to the last `n` elements from the list.""" 6728 last: Int 6729 6730 """Returns the elements that come before the specified cursor.""" 6731 before: String 6732 6733 """Reverse the order of the underlying list.""" 6734 reverse: Boolean = false 6735 6736 """Sort the underlying list by the given key.""" 6737 sortKey: DiscountCodeSortKeys = ID 6738 6739 """ 6740 Supported filter parameters: 6741 - `times_used` 6742 6743 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 6744 for more information about using filters. 6745 6746 """ 6747 query: String 6748 6749 """ 6750 ID of an existing saved search. 6751 The search’s query string is used as the query argument. 6752 6753 """ 6754 savedSearchId: ID 6755 ): DiscountRedeemCodeConnection! 6756 6757 """The date and time when the discount was created.""" 6758 createdAt: DateTime! 6759 6760 """ 6761 The qualifying items in an order, the quantity of each one, and the total value of the discount. 6762 """ 6763 customerGets: DiscountCustomerGets! 6764 6765 """The customers that can use the discount.""" 6766 customerSelection: DiscountCustomerSelection! 6767 6768 """ 6769 The date and time when the discount ends. For open-ended discounts, use `null`. 6770 """ 6771 endsAt: DateTime 6772 6773 """Indicates whether there are any timeline comments on the discount.""" 6774 hasTimelineComment: Boolean! 6775 6776 """ 6777 The minimum subtotal or quantity that's required for the discount to be applied. 6778 """ 6779 minimumRequirement: DiscountMinimumRequirement 6780 6781 """ 6782 The number of times a discount applies on recurring purchases (subscriptions). 6783 """ 6784 recurringCycleLimit: Int 6785 6786 """URLs that can be used to share the discount.""" 6787 shareableUrls: [DiscountShareableUrl!]! 6788 6789 """A short summary of the discount.""" 6790 shortSummary: String! 6791 6792 """The date and time when the discount starts.""" 6793 startsAt: DateTime! 6794 6795 """The status of the discount.""" 6796 status: DiscountStatus! 6797 6798 """A detailed summary of the discount.""" 6799 summary: String! 6800 6801 """The title of the discount.""" 6802 title: String! 6803 6804 """The total sales from orders where the discount was used.""" 6805 totalSales: MoneyV2 6806 6807 """The maximum number of times that the discount can be used.""" 6808 usageLimit: Int 6809 } 6810 6811 """Return type for `discountCodeBasicCreate` mutation.""" 6812 type DiscountCodeBasicCreatePayload { 6813 """The created code discount.""" 6814 codeDiscountNode: DiscountCodeNode 6815 6816 """List of errors that occurred executing the mutation.""" 6817 userErrors: [DiscountUserError!]! 6818 } 6819 6820 """Specifies input field to create or update code basic discount.""" 6821 input DiscountCodeBasicInput { 6822 """The title of the discount.""" 6823 title: String 6824 6825 """The date and time when the discount starts.""" 6826 startsAt: DateTime 6827 6828 """ 6829 The date and time when the discount ends. For open-ended discounts, use `null`. 6830 """ 6831 endsAt: DateTime 6832 6833 """ 6834 The maximum number of times that the discount can be used. For open-ended discounts, use `null`. 6835 """ 6836 usageLimit: Int 6837 6838 """Whether the discount can be applied only once per customer.""" 6839 appliesOncePerCustomer: Boolean 6840 6841 """ 6842 The minimum subtotal or quantity that's required for the discount to be applied. 6843 """ 6844 minimumRequirement: DiscountMinimumRequirementInput 6845 6846 """ 6847 The qualifying items in an order, the quantity of each one, and the total value of the discount. 6848 """ 6849 customerGets: DiscountCustomerGetsInput 6850 6851 """The customers that can use the discount.""" 6852 customerSelection: DiscountCustomerSelectionInput 6853 6854 """The code to use the discount.""" 6855 code: String 6856 6857 """ 6858 The number of times a discount applies on recurring purchases (subscriptions). 6859 """ 6860 recurringCycleLimit: Int 6861 } 6862 6863 """Return type for `discountCodeBasicUpdate` mutation.""" 6864 type DiscountCodeBasicUpdatePayload { 6865 """The updated code discount.""" 6866 codeDiscountNode: DiscountCodeNode 6867 6868 """List of errors that occurred executing the mutation.""" 6869 userErrors: [DiscountUserError!]! 6870 } 6871 6872 """Return type for `discountCodeBulkActivate` mutation.""" 6873 type DiscountCodeBulkActivatePayload { 6874 """The asynchronous job that activates the code discounts.""" 6875 job: Job 6876 6877 """List of errors that occurred executing the mutation.""" 6878 userErrors: [DiscountUserError!]! 6879 } 6880 6881 """Return type for `discountCodeBulkDeactivate` mutation.""" 6882 type DiscountCodeBulkDeactivatePayload { 6883 """The asynchronous job that deactivates the code discounts.""" 6884 job: Job 6885 6886 """List of errors that occurred executing the mutation.""" 6887 userErrors: [DiscountUserError!]! 6888 } 6889 6890 """Return type for `discountCodeBulkDelete` mutation.""" 6891 type DiscountCodeBulkDeletePayload { 6892 """The asynchronous job that deletes the code discounts.""" 6893 job: Job 6894 6895 """List of errors that occurred executing the mutation.""" 6896 userErrors: [DiscountUserError!]! 6897 } 6898 6899 """A BXGY code discount.""" 6900 type DiscountCodeBxgy { 6901 """Whether the discount can be applied only once per customer.""" 6902 appliesOncePerCustomer: Boolean! 6903 6904 """The number of times that the discount has been used.""" 6905 asyncUsageCount: Int! 6906 6907 """The number of redeem codes for the discount.""" 6908 codeCount: Int! 6909 6910 """A list of redeem codes for the discount.""" 6911 codes( 6912 """Returns up to the first `n` elements from the list.""" 6913 first: Int 6914 6915 """Returns the elements that come after the specified cursor.""" 6916 after: String 6917 6918 """Returns up to the last `n` elements from the list.""" 6919 last: Int 6920 6921 """Returns the elements that come before the specified cursor.""" 6922 before: String 6923 6924 """Reverse the order of the underlying list.""" 6925 reverse: Boolean = false 6926 6927 """Sort the underlying list by the given key.""" 6928 sortKey: DiscountCodeSortKeys = ID 6929 6930 """ 6931 Supported filter parameters: 6932 - `times_used` 6933 6934 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 6935 for more information about using filters. 6936 6937 """ 6938 query: String 6939 6940 """ 6941 ID of an existing saved search. 6942 The search’s query string is used as the query argument. 6943 6944 """ 6945 savedSearchId: ID 6946 ): DiscountRedeemCodeConnection! 6947 6948 """The date and time when the discount was created.""" 6949 createdAt: DateTime! 6950 6951 """ 6952 The qualifying items and the quantity of each one that the customer has to buy to be eligible for the discount. 6953 """ 6954 customerBuys: DiscountCustomerBuys! 6955 6956 """ 6957 The qualifying items in an order, the quantity of each one, and the total value of the discount. 6958 """ 6959 customerGets: DiscountCustomerGets! 6960 6961 """The customers that can use the discount.""" 6962 customerSelection: DiscountCustomerSelection! 6963 6964 """ 6965 The date and time when the discount ends. For open-ended discounts, use `null`. 6966 """ 6967 endsAt: DateTime 6968 6969 """Indicates whether there are any timeline comments on the discount.""" 6970 hasTimelineComment: Boolean! 6971 6972 """URLs that can be used to share the discount.""" 6973 shareableUrls: [DiscountShareableUrl!]! 6974 6975 """The date and time when the discount starts.""" 6976 startsAt: DateTime! 6977 6978 """The status of the discount.""" 6979 status: DiscountStatus! 6980 6981 """A detailed summary of the discount.""" 6982 summary: String! 6983 6984 """The title of the discount.""" 6985 title: String! 6986 6987 """The total sales from orders where the discount was used.""" 6988 totalSales: MoneyV2 6989 6990 """The maximum number of times that the discount can be used.""" 6991 usageLimit: Int 6992 6993 """ 6994 The maximum number of times that the discount can be applied to an order. 6995 """ 6996 usesPerOrderLimit: Int 6997 } 6998 6999 """Return type for `discountCodeBxgyCreate` mutation.""" 7000 type DiscountCodeBxgyCreatePayload { 7001 """The created code discount.""" 7002 codeDiscountNode: DiscountCodeNode 7003 7004 """List of errors that occurred executing the mutation.""" 7005 userErrors: [DiscountUserError!]! 7006 } 7007 7008 """Specifies input field to create or update a BXGY code discount.""" 7009 input DiscountCodeBxgyInput { 7010 """The title of the discount.""" 7011 title: String 7012 7013 """The date and time when the discount starts.""" 7014 startsAt: DateTime 7015 7016 """ 7017 The date and time when the discount ends. For open-ended discounts, use `null`. 7018 """ 7019 endsAt: DateTime 7020 7021 """ 7022 The qualifying items and the quantity of each one that the customer has to buy to be eligible for the discount. 7023 """ 7024 customerBuys: DiscountCustomerBuysInput 7025 7026 """ 7027 The qualifying items in an order, the quantity of each one, and the total value of the discount. 7028 """ 7029 customerGets: DiscountCustomerGetsInput 7030 7031 """The customers that can use the discount.""" 7032 customerSelection: DiscountCustomerSelectionInput 7033 7034 """The code to use the discount.""" 7035 code: String 7036 7037 """ 7038 The maximum number of times that the discount can be used. For open-ended discounts, use `null`. 7039 """ 7040 usageLimit: Int 7041 7042 """ 7043 The maximum number of times that the discount can be applied to an order. 7044 """ 7045 usesPerOrderLimit: Int 7046 7047 """Whether the discount can be applied only once per customer.""" 7048 appliesOncePerCustomer: Boolean 7049 } 7050 7051 """Return type for `discountCodeBxgyUpdate` mutation.""" 7052 type DiscountCodeBxgyUpdatePayload { 7053 """The updated code discount.""" 7054 codeDiscountNode: DiscountCodeNode 7055 7056 """List of errors that occurred executing the mutation.""" 7057 userErrors: [DiscountUserError!]! 7058 } 7059 7060 """Return type for `discountCodeDeactivate` mutation.""" 7061 type DiscountCodeDeactivatePayload { 7062 """The deactivated code discount.""" 7063 codeDiscountNode: DiscountCodeNode 7064 7065 """List of errors that occurred executing the mutation.""" 7066 userErrors: [DiscountUserError!]! 7067 } 7068 7069 """Return type for `discountCodeDelete` mutation.""" 7070 type DiscountCodeDeletePayload { 7071 """The deleted code discount ID.""" 7072 deletedCodeDiscountId: ID 7073 7074 """List of errors that occurred executing the mutation.""" 7075 userErrors: [DiscountUserError!]! 7076 } 7077 7078 """A free shipping code discount.""" 7079 type DiscountCodeFreeShipping { 7080 """ 7081 Whether the discount applies on regular one-time-purchase shipping lines. 7082 """ 7083 appliesOnOneTimePurchase: Boolean! 7084 7085 """Whether the discount applies on subscription shipping lines.""" 7086 appliesOnSubscription: Boolean! 7087 7088 """Whether the discount can be applied only once per customer.""" 7089 appliesOncePerCustomer: Boolean! 7090 7091 """The number of times that the discount has been used.""" 7092 asyncUsageCount: Int! 7093 7094 """The number of redeem codes for the discount.""" 7095 codeCount: Int! 7096 7097 """A list of redeem codes for the discount.""" 7098 codes( 7099 """Returns up to the first `n` elements from the list.""" 7100 first: Int 7101 7102 """Returns the elements that come after the specified cursor.""" 7103 after: String 7104 7105 """Returns up to the last `n` elements from the list.""" 7106 last: Int 7107 7108 """Returns the elements that come before the specified cursor.""" 7109 before: String 7110 7111 """Reverse the order of the underlying list.""" 7112 reverse: Boolean = false 7113 7114 """Sort the underlying list by the given key.""" 7115 sortKey: DiscountCodeSortKeys = ID 7116 7117 """ 7118 Supported filter parameters: 7119 - `times_used` 7120 7121 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 7122 for more information about using filters. 7123 7124 """ 7125 query: String 7126 7127 """ 7128 ID of an existing saved search. 7129 The search’s query string is used as the query argument. 7130 7131 """ 7132 savedSearchId: ID 7133 ): DiscountRedeemCodeConnection! 7134 7135 """The date and time when the discount was created.""" 7136 createdAt: DateTime! 7137 7138 """The customers that can use the discount.""" 7139 customerSelection: DiscountCustomerSelection! 7140 7141 """A shipping destination that qualifies for the discount.""" 7142 destinationSelection: DiscountShippingDestinationSelection! 7143 7144 """ 7145 The date and time when the discount ends. For open-ended discounts, use `null`. 7146 """ 7147 endsAt: DateTime 7148 7149 """Indicates whether there are any timeline comments on the discount.""" 7150 hasTimelineComment: Boolean! 7151 7152 """ 7153 The maximum shipping price amount accepted to qualify for the discount. 7154 """ 7155 maximumShippingPrice: MoneyV2 7156 7157 """ 7158 The minimum subtotal or quantity that's required for the discount to be applied. 7159 """ 7160 minimumRequirement: DiscountMinimumRequirement 7161 7162 """ 7163 The number of times a discount applies on recurring purchases (subscriptions). 7164 """ 7165 recurringCycleLimit: Int 7166 7167 """URLs that can be used to share the discount.""" 7168 shareableUrls: [DiscountShareableUrl!]! 7169 7170 """A short summary of the discount.""" 7171 shortSummary: String! 7172 7173 """The date and time when the discount starts.""" 7174 startsAt: DateTime! 7175 7176 """The status of the discount.""" 7177 status: DiscountStatus! 7178 7179 """A detailed summary of the discount.""" 7180 summary: String! 7181 7182 """The title of the discount.""" 7183 title: String! 7184 7185 """The total sales from orders where the discount was used.""" 7186 totalSales: MoneyV2 7187 7188 """The maximum number of times that the discount can be used.""" 7189 usageLimit: Int 7190 } 7191 7192 """Return type for `discountCodeFreeShippingCreate` mutation.""" 7193 type DiscountCodeFreeShippingCreatePayload { 7194 """The created code discount.""" 7195 codeDiscountNode: DiscountCodeNode 7196 7197 """List of errors that occurred executing the mutation.""" 7198 userErrors: [DiscountUserError!]! 7199 } 7200 7201 """Specifies input field to create or update free shipping code discount.""" 7202 input DiscountCodeFreeShippingInput { 7203 """The title of the discount.""" 7204 title: String 7205 7206 """The date and time when the discount starts.""" 7207 startsAt: DateTime 7208 7209 """ 7210 The date and time when the discount ends. For open-ended discounts, use `null`. 7211 """ 7212 endsAt: DateTime 7213 7214 """The code to use the discount.""" 7215 code: String 7216 7217 """ 7218 The maximum number of times that the discount can be used. For open-ended discounts, use `null`. 7219 """ 7220 usageLimit: Int 7221 7222 """Whether the discount can be applied only once per customer.""" 7223 appliesOncePerCustomer: Boolean 7224 7225 """ 7226 The minimum subtotal or quantity that's required for the discount to be applied. 7227 """ 7228 minimumRequirement: DiscountMinimumRequirementInput 7229 7230 """The customers that can use the discount.""" 7231 customerSelection: DiscountCustomerSelectionInput 7232 7233 """A list of destinations where the discount will apply.""" 7234 destination: DiscountShippingDestinationSelectionInput 7235 7236 """The maximum shipping price that qualifies for the discount.""" 7237 maximumShippingPrice: Decimal 7238 7239 """ 7240 The number of times a discount applies on recurring purchases (subscriptions). 7241 """ 7242 recurringCycleLimit: Int 7243 7244 """Whether the discount applies on regular one-time-purchase items.""" 7245 appliesOnOneTimePurchase: Boolean 7246 7247 """Whether the discount applies on subscription items.""" 7248 appliesOnSubscription: Boolean 7249 } 7250 7251 """Return type for `discountCodeFreeShippingUpdate` mutation.""" 7252 type DiscountCodeFreeShippingUpdatePayload { 7253 """The updated code discount.""" 7254 codeDiscountNode: DiscountCodeNode 7255 7256 """List of errors that occurred executing the mutation.""" 7257 userErrors: [DiscountUserError!]! 7258 } 7259 7260 """A code discount wrapper node.""" 7261 type DiscountCodeNode implements Node & HasEvents { 7262 """A code discount.""" 7263 codeDiscount: DiscountCode! 7264 7265 """The paginated list of events associated with the host subject.""" 7266 events( 7267 """Returns up to the first `n` elements from the list.""" 7268 first: Int 7269 7270 """Returns the elements that come after the specified cursor.""" 7271 after: String 7272 7273 """Returns up to the last `n` elements from the list.""" 7274 last: Int 7275 7276 """Returns the elements that come before the specified cursor.""" 7277 before: String 7278 7279 """Reverse the order of the underlying list.""" 7280 reverse: Boolean = false 7281 7282 """Sort the underlying list by the given key.""" 7283 sortKey: EventSortKeys = ID 7284 7285 """ 7286 Supported filter parameters: 7287 - `comments` 7288 - `created_at` 7289 - `subject_type` 7290 - `verb` 7291 7292 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 7293 for more information about using filters. 7294 7295 """ 7296 query: String 7297 ): EventConnection! 7298 7299 """Globally unique identifier.""" 7300 id: ID! 7301 } 7302 7303 """ 7304 An auto-generated type for paginating through multiple DiscountCodeNodes. 7305 7306 """ 7307 type DiscountCodeNodeConnection { 7308 """A list of edges.""" 7309 edges: [DiscountCodeNodeEdge!]! 7310 7311 """Information to aid in pagination.""" 7312 pageInfo: PageInfo! 7313 } 7314 7315 """ 7316 An auto-generated type which holds one DiscountCodeNode and a cursor during pagination. 7317 7318 """ 7319 type DiscountCodeNodeEdge { 7320 """A cursor for use in pagination.""" 7321 cursor: String! 7322 7323 """The item at the end of DiscountCodeNodeEdge.""" 7324 node: DiscountCodeNode! 7325 } 7326 7327 """Return type for `discountCodeRedeemCodeBulkDelete` mutation.""" 7328 type DiscountCodeRedeemCodeBulkDeletePayload { 7329 """The asynchronous job that deletes the discount redeem codes.""" 7330 job: Job 7331 7332 """List of errors that occurred executing the mutation.""" 7333 userErrors: [DiscountUserError!]! 7334 } 7335 7336 """The set of valid sort keys for the DiscountCode query.""" 7337 enum DiscountCodeSortKeys { 7338 """Sort by the `code` value.""" 7339 CODE 7340 7341 """Sort by the `created_at` value.""" 7342 CREATED_AT 7343 7344 """Sort by the `id` value.""" 7345 ID 7346 7347 """ 7348 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 7349 results by relevance to the search term(s). When no search query is specified, this sort key is not 7350 deterministic and should not be used. 7351 7352 """ 7353 RELEVANCE 7354 } 7355 7356 """ 7357 A list of collections that the discount can have as a prerequisite or entitlement. 7358 """ 7359 type DiscountCollections { 7360 """ 7361 A list of collections that the discount can have as a prerequisite or entitlement. 7362 """ 7363 collections( 7364 """Returns up to the first `n` elements from the list.""" 7365 first: Int 7366 7367 """Returns the elements that come after the specified cursor.""" 7368 after: String 7369 7370 """Returns up to the last `n` elements from the list.""" 7371 last: Int 7372 7373 """Returns the elements that come before the specified cursor.""" 7374 before: String 7375 7376 """Reverse the order of the underlying list.""" 7377 reverse: Boolean = false 7378 ): CollectionConnection! 7379 } 7380 7381 """Specifies the collections attached to a discount.""" 7382 input DiscountCollectionsInput { 7383 """Specifies list of collection ids to add.""" 7384 add: [ID!] 7385 7386 """Specifies list of collection ids to remove.""" 7387 remove: [ID!] 7388 } 7389 7390 """The shipping destination where the discount applies.""" 7391 type DiscountCountries { 7392 """The codes for the countries where the discount can be used.""" 7393 countries: [CountryCode!]! 7394 7395 """ 7396 Whether the discount is applicable to countries that have not been defined in the shop's shipping zones. 7397 """ 7398 includeRestOfWorld: Boolean! 7399 } 7400 7401 """ 7402 Specifies a list of countries to add or remove from the free shipping discount. 7403 """ 7404 input DiscountCountriesInput { 7405 """ 7406 The country codes to add to the list of countries where the discount applies. 7407 """ 7408 add: [CountryCode!] 7409 7410 """ 7411 The country codes to remove from the list of countries where the discount applies. 7412 """ 7413 remove: [CountryCode!] 7414 7415 """ 7416 Whether the discount code is applicable to countries that have not been defined in the shop's shipping zones. 7417 """ 7418 includeRestOfWorld: Boolean = false 7419 } 7420 7421 """Whether the discount applies to all countries.""" 7422 type DiscountCountryAll { 7423 """Always true when resolved to this type.""" 7424 allCountries: Boolean! 7425 } 7426 7427 """Whether the discount applies to all customers.""" 7428 type DiscountCustomerAll { 7429 """Always true when resolved to this type.""" 7430 allCustomers: Boolean! 7431 } 7432 7433 """The prerequisite items and prerequisite value.""" 7434 type DiscountCustomerBuys { 7435 """The items required for the discount to be applicable.""" 7436 items: DiscountItems! 7437 7438 """The prerequisite value.""" 7439 value: DiscountCustomerBuysValue! 7440 } 7441 7442 """Specifies the prerequisite items and prerequisite quantity.""" 7443 input DiscountCustomerBuysInput { 7444 """The quantity of prerequisite items.""" 7445 value: DiscountCustomerBuysValueInput 7446 7447 """ 7448 The IDs of items that the customer buys. The items can be either collections or products. 7449 """ 7450 items: DiscountItemsInput 7451 } 7452 7453 """The prerequisite quantity required for the discount to be applicable.""" 7454 union DiscountCustomerBuysValue = DiscountPurchaseAmount | DiscountQuantity 7455 7456 """Specifies the prerequisite quantity for the discount.""" 7457 input DiscountCustomerBuysValueInput { 7458 """The quantity of prerequisite items.""" 7459 quantity: UnsignedInt64 7460 7461 """ 7462 The prerequisite purchase amount required for the discount to be applicable. 7463 """ 7464 amount: Decimal 7465 } 7466 7467 """ 7468 The qualifying items in an order, the quantity of each one, and the total value of the discount. 7469 """ 7470 type DiscountCustomerGets { 7471 """Whether the discount applies on regular one-time-purchase items.""" 7472 appliesOnOneTimePurchase: Boolean! 7473 7474 """Whether the discount applies on subscription items.""" 7475 appliesOnSubscription: Boolean! 7476 7477 """The items to which the discount applies.""" 7478 items: DiscountItems! 7479 7480 """Entitled quantity and the discount value.""" 7481 value: DiscountCustomerGetsValue! 7482 } 7483 7484 """ 7485 Specifies the items that will be discounted, the quantity of items that will be discounted, and the value of discount. 7486 """ 7487 input DiscountCustomerGetsInput { 7488 """The quantity of items discounted and the discount value.""" 7489 value: DiscountCustomerGetsValueInput 7490 7491 """ 7492 The IDs of the items that the customer gets. The items can be either collections or products. 7493 """ 7494 items: DiscountItemsInput 7495 7496 """Whether the discount applies on regular one-time-purchase items.""" 7497 appliesOnOneTimePurchase: Boolean 7498 7499 """Whether the discount applies on subscription items.""" 7500 appliesOnSubscription: Boolean 7501 } 7502 7503 """The value of the discount and how it will be applied.""" 7504 union DiscountCustomerGetsValue = DiscountAmount | DiscountOnQuantity | DiscountPercentage 7505 7506 """Specifies the quantity of items discounted and the discount value.""" 7507 input DiscountCustomerGetsValueInput { 7508 """The quantity of the items that are discounted and the discount value.""" 7509 discountOnQuantity: DiscountOnQuantityInput 7510 7511 """ 7512 The percentage value of the discount. Value must be between 0.00 - 1.00. 7513 """ 7514 percentage: Float 7515 7516 """The value of the discount.""" 7517 discountAmount: DiscountAmountInput 7518 } 7519 7520 """ 7521 A list of customer saved searches that contain the customers to whom the discount applies. 7522 """ 7523 type DiscountCustomerSavedSearches { 7524 """ 7525 A list of customer saved searches that contain the customers who can use the discount. 7526 """ 7527 savedSearches: [SavedSearch!]! 7528 } 7529 7530 """ 7531 Specifies which customer saved searches to add to or remove from the discount. 7532 """ 7533 input DiscountCustomerSavedSearchesInput { 7534 """ 7535 A list of customer saved searches to add to the current list of customer saved searches. 7536 """ 7537 add: [ID!] 7538 7539 """ 7540 A list of customer saved searches to remove from the current list of customer saved searches. 7541 """ 7542 remove: [ID!] 7543 } 7544 7545 """The selection of customers who can use this discount.""" 7546 union DiscountCustomerSelection = DiscountCustomerAll | DiscountCustomerSavedSearches | DiscountCustomers 7547 7548 """Specifies the customers who can use this discount.""" 7549 input DiscountCustomerSelectionInput { 7550 """Whether all customers can use this discount.""" 7551 all: Boolean 7552 7553 """The list of customer IDs to add or remove from the list of customers.""" 7554 customers: DiscountCustomersInput 7555 7556 """ 7557 The list of customer saved search IDs to add or remove from the list of customer saved searches. 7558 """ 7559 customerSavedSearches: DiscountCustomerSavedSearchesInput 7560 } 7561 7562 """A list of customers to whom the discount applies.""" 7563 type DiscountCustomers { 7564 """A list of the customers that can use the discount.""" 7565 customers: [Customer!]! 7566 } 7567 7568 """Specifies which customers to add to or remove from the discount.""" 7569 input DiscountCustomersInput { 7570 """ 7571 A list of customers to add to the current list of customers who can use the discount. 7572 """ 7573 add: [ID!] 7574 7575 """ 7576 A list of customers to remove from the current list of customers who can use the discount. 7577 """ 7578 remove: [ID!] 7579 } 7580 7581 """ 7582 The type of discount that will be applied. Currently, only percentage off is supported. 7583 """ 7584 union DiscountEffect = DiscountPercentage 7585 7586 """ 7587 Specifies how the discount will be applied. Currently, only percentage off is supported. 7588 """ 7589 input DiscountEffectInput { 7590 """ 7591 The percentage value of the discount. Value must be between 0.00 - 1.00. 7592 """ 7593 percentage: Float 7594 } 7595 7596 """Possible error codes that could be returned by DiscountUserError.""" 7597 enum DiscountErrorCode { 7598 """Input value is blank.""" 7599 BLANK 7600 7601 """Input value is not present.""" 7602 PRESENT 7603 7604 """Input value should be equal to allowed value.""" 7605 EQUAL_TO 7606 7607 """Input value should be greater than minimum allowed value.""" 7608 GREATER_THAN 7609 7610 """Input value should be greater than or equal to minimum allowed value.""" 7611 GREATER_THAN_OR_EQUAL_TO 7612 7613 """Input value is invalid.""" 7614 INVALID 7615 7616 """Input value should be less or equal to maximum allowed value.""" 7617 LESS_THAN_OR_EQUAL_TO 7618 7619 """Input value should be less than maximum allowed value.""" 7620 LESS_THAN 7621 7622 """Input value is already taken.""" 7623 TAKEN 7624 7625 """Input value is too long.""" 7626 TOO_LONG 7627 7628 """Input value is too short.""" 7629 TOO_SHORT 7630 7631 """Unexpected internal error happened.""" 7632 INTERNAL_ERROR 7633 7634 """Too many arguments provided.""" 7635 TOO_MANY_ARGUMENTS 7636 7637 """Missing a required argument.""" 7638 MISSING_ARGUMENT 7639 7640 """Value is outside allowed range.""" 7641 VALUE_OUTSIDE_RANGE 7642 7643 """Cannot have both minimum subtotal and quantity present.""" 7644 MINIMUM_SUBTOTAL_AND_QUANTITY_RANGE_BOTH_PRESENT 7645 7646 """Exceeded maximum allowed value.""" 7647 EXCEEDED_MAX 7648 7649 """ 7650 Active period overlaps with other automatic discounts. At any given time, only one automatic discount can be active. 7651 """ 7652 ACTIVE_PERIOD_OVERLAP 7653 7654 """Attribute selection contains conflicting settings.""" 7655 CONFLICT 7656 7657 """Value is already present through another selection.""" 7658 IMPLICIT_DUPLICATE 7659 7660 """Input value is already present.""" 7661 DUPLICATE 7662 7663 """Input value is not included in the list.""" 7664 INCLUSION 7665 } 7666 7667 """ 7668 Entitled or prerequisite items on a discount. An item could be either collection or product or product_variant. 7669 7670 """ 7671 union DiscountItems = AllDiscountItems | DiscountCollections | DiscountProducts 7672 7673 """Specifies the items attached to a discount.""" 7674 input DiscountItemsInput { 7675 """The products and product variants that are attached to a discount.""" 7676 products: DiscountProductsInput 7677 7678 """The collections that are attached to a discount.""" 7679 collections: DiscountCollectionsInput 7680 7681 """Whether all items should be selected.""" 7682 all: Boolean 7683 } 7684 7685 """The minimum quantity of items required for the discount to apply.""" 7686 type DiscountMinimumQuantity { 7687 """ 7688 The minimum quantity of items that's required for the discount to be applied. 7689 """ 7690 greaterThanOrEqualToQuantity: UnsignedInt64! 7691 } 7692 7693 """Specifies the quantity minimum requirements for a discount.""" 7694 input DiscountMinimumQuantityInput { 7695 """ 7696 The minimum quantity of items that's required for the discount to be applied. 7697 """ 7698 greaterThanOrEqualToQuantity: UnsignedInt64 7699 } 7700 7701 """The minimum subtotal or quantity requirements for the discount.""" 7702 union DiscountMinimumRequirement = DiscountMinimumQuantity | DiscountMinimumSubtotal 7703 7704 """ 7705 Specifies the quantity or subtotal minimum requirements for a discount. 7706 """ 7707 input DiscountMinimumRequirementInput { 7708 """The minimum required quantity.""" 7709 quantity: DiscountMinimumQuantityInput 7710 7711 """The minimum required subtotal.""" 7712 subtotal: DiscountMinimumSubtotalInput 7713 } 7714 7715 """The minimum subtotal required for the discount to apply.""" 7716 type DiscountMinimumSubtotal { 7717 """The minimum subtotal that's required for the discount to be applied.""" 7718 greaterThanOrEqualToSubtotal: MoneyV2! 7719 } 7720 7721 """Specifies the subtotal minimum requirements for a discount.""" 7722 input DiscountMinimumSubtotalInput { 7723 """The minimum subtotal that's required for the discount to be applied.""" 7724 greaterThanOrEqualToSubtotal: Decimal 7725 } 7726 7727 """ 7728 The quantity of items discounted, the discount value, and how the discount will be applied. 7729 """ 7730 type DiscountOnQuantity { 7731 """The discount's effect on qualifying items.""" 7732 effect: DiscountEffect! 7733 7734 """The number of items being discounted.""" 7735 quantity: DiscountQuantity! 7736 } 7737 7738 """Specifies the quantity of items discounted and the discount value.""" 7739 input DiscountOnQuantityInput { 7740 """The quantity of items that are discounted.""" 7741 quantity: UnsignedInt64 7742 7743 """The percentage value of the discount.""" 7744 effect: DiscountEffectInput 7745 } 7746 7747 """The percentage value of the discount.""" 7748 type DiscountPercentage { 7749 """The percentage value of the discount.""" 7750 percentage: Float! 7751 } 7752 7753 """ 7754 The entitled or prerequisite products and product variants for a discount. 7755 """ 7756 type DiscountProducts { 7757 """ 7758 A list of product variants that the discount can have as a prerequisite or entitlement. 7759 """ 7760 productVariants( 7761 """Returns up to the first `n` elements from the list.""" 7762 first: Int 7763 7764 """Returns the elements that come after the specified cursor.""" 7765 after: String 7766 7767 """Returns up to the last `n` elements from the list.""" 7768 last: Int 7769 7770 """Returns the elements that come before the specified cursor.""" 7771 before: String 7772 7773 """Reverse the order of the underlying list.""" 7774 reverse: Boolean = false 7775 ): ProductVariantConnection! 7776 7777 """ 7778 A list of products that the discount can have as a prerequisite or entitlement. 7779 """ 7780 products( 7781 """Returns up to the first `n` elements from the list.""" 7782 first: Int 7783 7784 """Returns the elements that come after the specified cursor.""" 7785 after: String 7786 7787 """Returns up to the last `n` elements from the list.""" 7788 last: Int 7789 7790 """Returns the elements that come before the specified cursor.""" 7791 before: String 7792 7793 """Reverse the order of the underlying list.""" 7794 reverse: Boolean = false 7795 ): ProductConnection! 7796 } 7797 7798 """Specifies the products and product variants attached to a discount.""" 7799 input DiscountProductsInput { 7800 """Specifies list of product ids to add.""" 7801 productsToAdd: [ID!] 7802 7803 """Specifies list of product ids to remove.""" 7804 productsToRemove: [ID!] 7805 7806 """Specifies list of product variant ids to add.""" 7807 productVariantsToAdd: [ID!] 7808 7809 """Specifies list of product variant ids to remove.""" 7810 productVariantsToRemove: [ID!] 7811 } 7812 7813 """ 7814 The prerequisite purchase amount required for the discount to be applicable. 7815 """ 7816 type DiscountPurchaseAmount { 7817 """Decimal money amount.""" 7818 amount: Decimal! 7819 } 7820 7821 """The quantity of items in discount.""" 7822 type DiscountQuantity { 7823 """The quantity of items.""" 7824 quantity: UnsignedInt64! 7825 } 7826 7827 """A redeem code for a code discount.""" 7828 type DiscountRedeemCode { 7829 """ 7830 The number of times the discount has been used. This value is updated asynchronously and can be different than the actual usage count. 7831 """ 7832 asyncUsageCount: Int! 7833 7834 """The code of a discount.""" 7835 code: String! 7836 7837 """The application that created the discount code.""" 7838 createdBy: App 7839 7840 """Globally unique identifier of the discount redeem code.""" 7841 id: ID! 7842 } 7843 7844 """ 7845 An auto-generated type for paginating through multiple DiscountRedeemCodes. 7846 7847 """ 7848 type DiscountRedeemCodeConnection { 7849 """A list of edges.""" 7850 edges: [DiscountRedeemCodeEdge!]! 7851 7852 """Information to aid in pagination.""" 7853 pageInfo: PageInfo! 7854 } 7855 7856 """ 7857 An auto-generated type which holds one DiscountRedeemCode and a cursor during pagination. 7858 7859 """ 7860 type DiscountRedeemCodeEdge { 7861 """A cursor for use in pagination.""" 7862 cursor: String! 7863 7864 """The item at the end of DiscountRedeemCodeEdge.""" 7865 node: DiscountRedeemCode! 7866 } 7867 7868 """The shareable URL for the discount code.""" 7869 type DiscountShareableUrl { 7870 """ 7871 The image URL of the item (product or collection) to which the discount applies. 7872 """ 7873 targetItemImage: Image 7874 7875 """The type of page that's associated with the URL.""" 7876 targetType: DiscountShareableUrlTargetType! 7877 7878 """The title of the page that's associated with the URL.""" 7879 title: String! 7880 7881 """The URL for the discount code.""" 7882 url: URL! 7883 } 7884 7885 """The page type where shareable URL lands.""" 7886 enum DiscountShareableUrlTargetType { 7887 """The home page type.""" 7888 HOME 7889 7890 """The product page type.""" 7891 PRODUCT 7892 7893 """The collection page type.""" 7894 COLLECTION 7895 } 7896 7897 """The selection of shipping countries to which this discount applies.""" 7898 union DiscountShippingDestinationSelection = DiscountCountries | DiscountCountryAll 7899 7900 """ 7901 Specifies the destinations where the free shipping discount will be applied. 7902 """ 7903 input DiscountShippingDestinationSelectionInput { 7904 """Whether the discount code applies to all countries.""" 7905 all: Boolean = false 7906 7907 """A list of countries where the discount code will apply.""" 7908 countries: DiscountCountriesInput 7909 } 7910 7911 """The status of the discount.""" 7912 enum DiscountStatus { 7913 """The discount is active.""" 7914 ACTIVE 7915 7916 """The discount is expired.""" 7917 EXPIRED 7918 7919 """The discount is scheduled.""" 7920 SCHEDULED 7921 } 7922 7923 """The type of line a subscription discount is applied on.""" 7924 enum DiscountTargetType { 7925 """Line item.""" 7926 LINE_ITEM 7927 7928 """Shipping line.""" 7929 SHIPPING_LINE 7930 } 7931 7932 """The original type of the discount.""" 7933 enum DiscountType { 7934 """Manual discount type.""" 7935 MANUAL 7936 7937 """Code discount type.""" 7938 CODE_DISCOUNT 7939 } 7940 7941 """An error that occurs during the execution of a discount mutation.""" 7942 type DiscountUserError implements DisplayableError { 7943 """Error code to uniquely identify the error.""" 7944 code: DiscountErrorCode 7945 7946 """Extra information about this error.""" 7947 extraInfo: String 7948 7949 """Path to the input field which caused the error.""" 7950 field: [String!] 7951 7952 """The error message.""" 7953 message: String! 7954 } 7955 7956 """Represents an error in the input of a mutation.""" 7957 interface DisplayableError { 7958 """Path to the input field which caused the error.""" 7959 field: [String!] 7960 7961 """The error message.""" 7962 message: String! 7963 } 7964 7965 """The possible statuses of a dispute.""" 7966 enum DisputeStatus { 7967 NEEDS_RESPONSE 7968 UNDER_REVIEW 7969 CHARGE_REFUNDED 7970 ACCEPTED 7971 WON 7972 LOST 7973 } 7974 7975 """The possible types for a dispute.""" 7976 enum DisputeType { 7977 """The dispute has turned into a chargeback.""" 7978 CHARGEBACK 7979 7980 """The dispute is in the inquiry phase.""" 7981 INQUIRY 7982 } 7983 7984 """ 7985 A unique string that represents the address of a Shopify store on the Internet. 7986 """ 7987 type Domain implements Node { 7988 """The host name of the domain (eg: `example.com`).""" 7989 host: String! 7990 7991 """Globally unique identifier.""" 7992 id: ID! 7993 7994 """The localization of the domain, if it does not redirect.""" 7995 localization: DomainLocalization 7996 7997 """Whether SSL is enabled or not.""" 7998 sslEnabled: Boolean! 7999 8000 """The URL of the domain (eg: `https://example.com`).""" 8001 url: URL! 8002 } 8003 8004 """The country and language settings assigned to a domain.""" 8005 type DomainLocalization { 8006 """The ISO codes for the domain’s alternate locales.""" 8007 alternateLocales: [String!]! 8008 8009 """ 8010 The ISO code for the country assigned to the domain, or "*" for a domain set to "Rest of world". 8011 """ 8012 country: String 8013 8014 """The ISO code for the domain’s default locale.""" 8015 defaultLocale: String! 8016 } 8017 8018 """ 8019 Returns unfulfilled line items grouped by their fulfillment service. Each draft fulfillment contains additional information, such as whether the fulfillment requires shipping and whether a shipping label can be printed for it. 8020 8021 """ 8022 type DraftFulfillment { 8023 """Whether a label can be purchased.""" 8024 allowLabelPurchase: Boolean! 8025 8026 """ 8027 The line items (which might correspond to a variant) that are part of this draft fulfillment. 8028 """ 8029 lineItems: [LineItem!]! 8030 8031 """Whether a fulfillment requires shipping.""" 8032 requiresShipping: Boolean! 8033 8034 """The service responsible for fulfilling the fulfillment.""" 8035 service: FulfillmentService! 8036 } 8037 8038 """ 8039 Represents a draft order. Merchants can use draft orders to create orders on behalf of their customers. 8040 8041 """ 8042 type DraftOrder implements Node & HasMetafields & CommentEventSubject & LegacyInteroperability & HasEvents & HasLocalizationExtensionsForDraftOrders { 8043 """Order-level discount applied to the draft order.""" 8044 appliedDiscount: DraftOrderAppliedDiscount 8045 8046 """ 8047 Billing address of the customer. 8048 8049 """ 8050 billingAddress: MailingAddress 8051 8052 """ 8053 Date and time when the draft order converted to a new order, 8054 and the draft order's status changed to **Completed**. 8055 8056 """ 8057 completedAt: DateTime 8058 8059 """Date and time when the draft order was created in Shopify.""" 8060 createdAt: DateTime! 8061 8062 """ 8063 Three letter code for the currency of the store at the time that the invoice is sent. 8064 8065 """ 8066 currencyCode: CurrencyCode! 8067 8068 """ 8069 Custom information added to the draft order on behalf of your customer. 8070 8071 """ 8072 customAttributes: [Attribute!]! 8073 8074 """ 8075 Customer who will be sent an invoice for the draft order, if there is one. 8076 """ 8077 customer: Customer 8078 8079 """Email address of the customer, which is used to send notifications to.""" 8080 email: String 8081 8082 """List of events associated with the draft order.""" 8083 events( 8084 """Returns up to the first `n` elements from the list.""" 8085 first: Int 8086 8087 """Returns the elements that come after the specified cursor.""" 8088 after: String 8089 8090 """Returns up to the last `n` elements from the list.""" 8091 last: Int 8092 8093 """Returns the elements that come before the specified cursor.""" 8094 before: String 8095 8096 """Reverse the order of the underlying list.""" 8097 reverse: Boolean = false 8098 8099 """Sort the underlying list by the given key.""" 8100 sortKey: EventSortKeys = ID 8101 8102 """ 8103 Supported filter parameters: 8104 - `comments` 8105 - `created_at` 8106 - `subject_type` 8107 - `verb` 8108 8109 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 8110 for more information about using filters. 8111 8112 """ 8113 query: String 8114 ): EventConnection! 8115 8116 """Whether the merchant has added timeline comments to the draft order.""" 8117 hasTimelineComment: Boolean! 8118 8119 """Globally unique identifier.""" 8120 id: ID! 8121 8122 """Date and time when the invoice was last emailed to the customer.""" 8123 invoiceSentAt: DateTime 8124 8125 """ 8126 Link to the checkout, which is sent to your customer in the invoice email. 8127 """ 8128 invoiceUrl: URL 8129 8130 """The ID of the corresponding resource in the REST Admin API.""" 8131 legacyResourceId: UnsignedInt64! 8132 8133 """List of the line items in the draft order.""" 8134 lineItems( 8135 """Returns up to the first `n` elements from the list.""" 8136 first: Int 8137 8138 """Returns the elements that come after the specified cursor.""" 8139 after: String 8140 8141 """Returns up to the last `n` elements from the list.""" 8142 last: Int 8143 8144 """Returns the elements that come before the specified cursor.""" 8145 before: String 8146 8147 """Reverse the order of the underlying list.""" 8148 reverse: Boolean = false 8149 ): DraftOrderLineItemConnection! 8150 8151 """List of localization extensions for the resource.""" 8152 localizationExtensions( 8153 """The country codes of the extensions.""" 8154 countryCodes: [CountryCode!] 8155 8156 """The purpose of the extensions.""" 8157 purposes: [LocalizationExtensionPurpose!] 8158 8159 """Returns up to the first `n` elements from the list.""" 8160 first: Int 8161 8162 """Returns the elements that come after the specified cursor.""" 8163 after: String 8164 8165 """Returns up to the last `n` elements from the list.""" 8166 last: Int 8167 8168 """Returns the elements that come before the specified cursor.""" 8169 before: String 8170 8171 """Reverse the order of the underlying list.""" 8172 reverse: Boolean = false 8173 ): LocalizationExtensionConnection! 8174 8175 """The metafield associated with the resource.""" 8176 metafield( 8177 """Container for a set of metafields (maximum of 20 characters).""" 8178 namespace: String! 8179 8180 """Identifier for the metafield (maximum of 30 characters).""" 8181 key: String! 8182 ): Metafield 8183 8184 """A paginated list of metafields associated with the resource.""" 8185 metafields( 8186 """Finds all metafields with a specific namespace under the resource.""" 8187 namespace: String 8188 8189 """Returns up to the first `n` elements from the list.""" 8190 first: Int 8191 8192 """Returns the elements that come after the specified cursor.""" 8193 after: String 8194 8195 """Returns up to the last `n` elements from the list.""" 8196 last: Int 8197 8198 """Returns the elements that come before the specified cursor.""" 8199 before: String 8200 8201 """Reverse the order of the underlying list.""" 8202 reverse: Boolean = false 8203 ): MetafieldConnection! 8204 8205 """ 8206 Unique identifier for the draft order, which is unique within the store. For example, _#D1223_. 8207 8208 """ 8209 name: String! 8210 8211 """Text from an optional note attached to the draft order.""" 8212 note2: String 8213 8214 """Order that was created from this draft order.""" 8215 order: Order 8216 8217 """Returns a private metafield found by namespace and key.""" 8218 privateMetafield( 8219 """The namespace for the private metafield.""" 8220 namespace: String! 8221 8222 """The key for the private metafield.""" 8223 key: String! 8224 ): PrivateMetafield 8225 8226 """List of private metafields.""" 8227 privateMetafields( 8228 """Filter the private metafields by namespace.""" 8229 namespace: String 8230 8231 """Returns up to the first `n` elements from the list.""" 8232 first: Int 8233 8234 """Returns the elements that come after the specified cursor.""" 8235 after: String 8236 8237 """Returns up to the last `n` elements from the list.""" 8238 last: Int 8239 8240 """Returns the elements that come before the specified cursor.""" 8241 before: String 8242 8243 """Reverse the order of the underlying list.""" 8244 reverse: Boolean = false 8245 ): PrivateMetafieldConnection! 8246 8247 """ 8248 Whether or not the Draft Order is ready and can be completed. Draft Orders 8249 may have asynchronous operations that can take time to finish. 8250 """ 8251 ready: Boolean! 8252 8253 """Shipping mailing address of the customer.""" 8254 shippingAddress: MailingAddress 8255 8256 """Line item that contains the shipping costs.""" 8257 shippingLine: ShippingLine 8258 8259 """Status of the draft order.""" 8260 status: DraftOrderStatus! 8261 8262 """ 8263 Subtotal of the line items and their discounts (does not contain shipping charges or shipping discounts, or taxes). 8264 8265 """ 8266 subtotalPrice: Money! 8267 8268 """ 8269 A comma separated list of tags that have been added to the draft order. 8270 """ 8271 tags: [String!]! 8272 8273 """Whether the draft order is tax exempt.""" 8274 taxExempt: Boolean! 8275 8276 """Total amount of taxes charged for each line item and shipping line.""" 8277 taxLines: [TaxLine!]! 8278 8279 """Whether the line item prices include taxes.""" 8280 taxesIncluded: Boolean! 8281 8282 """ 8283 Total amount of the draft order (includes taxes, shipping charges, and discounts). 8284 """ 8285 totalPrice: Money! 8286 8287 """Total shipping charge for the draft order.""" 8288 totalShippingPrice: Money! 8289 8290 """Total amount of taxes for the draft order.""" 8291 totalTax: Money! 8292 8293 """Total weight (grams) of the draft order.""" 8294 totalWeight: UnsignedInt64! 8295 8296 """ 8297 Date and time when the draft order was last changed. 8298 The format is YYYY-MM-DD HH:mm:ss (for example, 2016-02-05 17:04:01). 8299 8300 """ 8301 updatedAt: DateTime! 8302 } 8303 8304 """The order-level discount applied to a draft order.""" 8305 type DraftOrderAppliedDiscount { 8306 """Amount of the order-level discount that is applied to the draft order.""" 8307 amount: Money! @deprecated(reason: "Use `amountV2` instead") 8308 8309 """Amount of money discounted.""" 8310 amountV2: MoneyV2! 8311 8312 """Description of the order-level discount.""" 8313 description: String! 8314 8315 """Name of the order-level discount.""" 8316 title: String 8317 8318 """ 8319 Amount of the order level discount (when value_type is percentage, 8320 the value in this field is the percentage discount). 8321 8322 """ 8323 value: Float! 8324 8325 """Type of the order-level discount.""" 8326 valueType: DraftOrderAppliedDiscountType! 8327 } 8328 8329 """ 8330 The input fields for applying an order-level discount to a draft order. 8331 """ 8332 input DraftOrderAppliedDiscountInput { 8333 """ 8334 The applied amount of the discount. 8335 8336 """ 8337 amount: Money 8338 8339 """ 8340 Reason for the discount. 8341 8342 """ 8343 description: String 8344 8345 """ 8346 Title of the discount. 8347 8348 """ 8349 title: String 8350 8351 """ 8352 The value of the discount. 8353 If the type of the discount is fixed amount, then this is a fixed dollar amount. 8354 If the type is percentage, then this is the percentage. 8355 8356 """ 8357 value: Float! 8358 8359 """ 8360 The type of discount. 8361 8362 """ 8363 valueType: DraftOrderAppliedDiscountType! 8364 } 8365 8366 """The valid discount types that can be applied to a draft order.""" 8367 enum DraftOrderAppliedDiscountType { 8368 """A fixed amount in the store's currency.""" 8369 FIXED_AMOUNT 8370 8371 """A percentage of the order subtotal.""" 8372 PERCENTAGE 8373 } 8374 8375 """Return type for `draftOrderCalculate` mutation.""" 8376 type DraftOrderCalculatePayload { 8377 """The calculated properties for a draft order.""" 8378 calculatedDraftOrder: CalculatedDraftOrder 8379 8380 """List of errors that occurred executing the mutation.""" 8381 userErrors: [UserError!]! 8382 } 8383 8384 """Return type for `draftOrderComplete` mutation.""" 8385 type DraftOrderCompletePayload { 8386 """The completed draft order.""" 8387 draftOrder: DraftOrder 8388 8389 """List of errors that occurred executing the mutation.""" 8390 userErrors: [UserError!]! 8391 } 8392 8393 """ 8394 An auto-generated type for paginating through multiple DraftOrders. 8395 8396 """ 8397 type DraftOrderConnection { 8398 """A list of edges.""" 8399 edges: [DraftOrderEdge!]! 8400 8401 """Information to aid in pagination.""" 8402 pageInfo: PageInfo! 8403 } 8404 8405 """Return type for `draftOrderCreate` mutation.""" 8406 type DraftOrderCreatePayload { 8407 """ 8408 The created draft order. 8409 8410 """ 8411 draftOrder: DraftOrder 8412 8413 """List of errors that occurred executing the mutation.""" 8414 userErrors: [UserError!]! 8415 } 8416 8417 """Specifies the draft order to delete by its ID.""" 8418 input DraftOrderDeleteInput { 8419 """ 8420 The ID of the draft order to delete. 8421 8422 """ 8423 id: ID! 8424 } 8425 8426 """Return type for `draftOrderDelete` mutation.""" 8427 type DraftOrderDeletePayload { 8428 """ 8429 The ID of the deleted draft order. 8430 8431 """ 8432 deletedId: ID 8433 8434 """List of errors that occurred executing the mutation.""" 8435 userErrors: [UserError!]! 8436 } 8437 8438 """ 8439 An auto-generated type which holds one DraftOrder and a cursor during pagination. 8440 8441 """ 8442 type DraftOrderEdge { 8443 """A cursor for use in pagination.""" 8444 cursor: String! 8445 8446 """The item at the end of DraftOrderEdge.""" 8447 node: DraftOrder! 8448 } 8449 8450 """The input fields used to create or update a draft order.""" 8451 input DraftOrderInput { 8452 """ 8453 The discount that will be applied to the draft order. 8454 A draft order line item can have one discount. A draft order can also have one order-level discount. 8455 8456 """ 8457 appliedDiscount: DraftOrderAppliedDiscountInput 8458 8459 """ 8460 The mailing address associated with the payment method. 8461 8462 """ 8463 billingAddress: MailingAddressInput 8464 8465 """ 8466 Customer associated with the draft order. 8467 8468 """ 8469 customerId: ID 8470 8471 """ 8472 Extra information added to the customer. 8473 8474 """ 8475 customAttributes: [AttributeInput!] 8476 8477 """ 8478 The customer's email address. 8479 8480 """ 8481 email: String 8482 8483 """ 8484 Product variant line item or custom line item associated to the draft order. 8485 Each draft order must include at least one line item. 8486 8487 """ 8488 lineItems: [DraftOrderLineItemInput!] 8489 8490 """ 8491 Metafields attached to the draft order. 8492 8493 """ 8494 metafields: [MetafieldInput!] 8495 8496 """The private metafields attached to the draft order.""" 8497 privateMetafields: [PrivateMetafieldInput!] 8498 8499 """ 8500 The localization extensions attached to the draft order. For example, Tax IDs. 8501 """ 8502 localizationExtensions: [LocalizationExtensionInput!] 8503 8504 """ 8505 The text of an optional note that a shop owner can attach to the draft order. 8506 8507 """ 8508 note: String 8509 8510 """ 8511 The mailing address to where the order will be shipped. 8512 8513 """ 8514 shippingAddress: MailingAddressInput 8515 8516 """ 8517 A shipping line object, which details the shipping method used. 8518 8519 """ 8520 shippingLine: ShippingLineInput 8521 8522 """ 8523 A comma separated list of tags that have been added to the draft order. 8524 8525 """ 8526 tags: [String!] 8527 8528 """ 8529 Whether or not taxes are exempt for the draft order. 8530 If false, then Shopify will refer to the taxable field for each line item. 8531 If a customer is applied to the draft order, then Shopify will use the customer's tax exempt field instead. 8532 8533 """ 8534 taxExempt: Boolean 8535 8536 """ 8537 Sent as part of a draft order object to load customer shipping information. 8538 8539 """ 8540 useCustomerDefaultAddress: Boolean 8541 } 8542 8543 """Return type for `draftOrderInvoicePreview` mutation.""" 8544 type DraftOrderInvoicePreviewPayload { 8545 """HTML to preview the draft order invoice email.""" 8546 previewHtml: HTML 8547 8548 """List of errors that occurred executing the mutation.""" 8549 userErrors: [UserError!]! 8550 } 8551 8552 """Return type for `draftOrderInvoiceSend` mutation.""" 8553 type DraftOrderInvoiceSendPayload { 8554 """The draft order an invoice email is sent for.""" 8555 draftOrder: DraftOrder 8556 8557 """List of errors that occurred executing the mutation.""" 8558 userErrors: [UserError!]! 8559 } 8560 8561 """Represents a line item included in a draft order.""" 8562 type DraftOrderLineItem implements Node { 8563 """ 8564 Discount which will be applied to the line item or the overall order. 8565 8566 """ 8567 appliedDiscount: DraftOrderAppliedDiscount 8568 8569 """ 8570 Whether this is a product variant line item, or a custom line item. 8571 If set to true indicates a custom line item. If set to false indicates a product variant line item. 8572 8573 """ 8574 custom: Boolean! 8575 8576 """List of additional information (metafields) about the line item.""" 8577 customAttributes: [Attribute!]! 8578 8579 """ 8580 Line item price after discounts are applied. 8581 8582 """ 8583 discountedTotal: Money! 8584 8585 """ 8586 The `discountedTotal` divided by `quantity`, resulting in the value of the discount per unit. 8587 8588 """ 8589 discountedUnitPrice: Money! 8590 8591 """ 8592 Name of the service provider who fulfilled the order. 8593 8594 Valid values are either **manual** or the name of the provider. 8595 For example, **amazon**, **shipwire**. 8596 8597 """ 8598 fulfillmentService: FulfillmentService! 8599 8600 """ 8601 Weight in grams. Can only be specified if this is a custom line item. 8602 8603 """ 8604 grams: Int @deprecated(reason: "Use `weight` instead") 8605 8606 """Globally unique identifier.""" 8607 id: ID! 8608 8609 """Image associated with the draft order line item.""" 8610 image( 8611 """ 8612 Image width in pixels between 1 and 2048. This argument is deprecated: Use `maxWidth` on `Image.transformedSrc` instead. 8613 """ 8614 maxWidth: Int 8615 8616 """ 8617 Image height in pixels between 1 and 2048. This argument is deprecated: Use `maxHeight` on `Image.transformedSrc` instead. 8618 """ 8619 maxHeight: Int 8620 8621 """ 8622 Crops the image according to the specified region. This argument is deprecated: Use `crop` on `Image.transformedSrc` instead. 8623 """ 8624 crop: CropRegion 8625 8626 """ 8627 Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use `scale` on `Image.transformedSrc` instead. 8628 """ 8629 scale: Int = 1 8630 ): Image 8631 8632 """Whether the line item represents the puchase of a gift card.""" 8633 isGiftCard: Boolean! 8634 8635 """Name of the product.""" 8636 name: String! 8637 8638 """ 8639 Total price (without discounts) of the line item, based on the original unit price of the variant x quantity. 8640 8641 """ 8642 originalTotal: Money! 8643 8644 """Variant price without any discounts applied.""" 8645 originalUnitPrice: Money! 8646 8647 """ 8648 The product corresponding to the line item’s product variant. 8649 8650 """ 8651 product: Product 8652 8653 """Number of variant items requested in the draft order.""" 8654 quantity: Int! 8655 8656 """Whether physical shipping is required for the variant.""" 8657 requiresShipping: Boolean! 8658 8659 """Variant SKU number.""" 8660 sku: String 8661 8662 """ 8663 A list of tax line objects, each of which details the total taxes applicable to the order. 8664 8665 """ 8666 taxLines: [TaxLine!]! 8667 8668 """Whether the variant is taxable.""" 8669 taxable: Boolean! 8670 8671 """ 8672 Title of the product or variant (this field only applies to custom line items). 8673 """ 8674 title: String! 8675 8676 """ 8677 Total value of the discount applied to the line item. 8678 8679 """ 8680 totalDiscount: Money! 8681 8682 """ 8683 Associated variant for the line item. 8684 8685 """ 8686 variant: ProductVariant 8687 8688 """Name of the variant.""" 8689 variantTitle: String 8690 8691 """Name of the vendor who made the variant.""" 8692 vendor: String 8693 8694 """Weight unit and value for a draft order line item.""" 8695 weight: Weight 8696 } 8697 8698 """ 8699 An auto-generated type for paginating through multiple DraftOrderLineItems. 8700 8701 """ 8702 type DraftOrderLineItemConnection { 8703 """A list of edges.""" 8704 edges: [DraftOrderLineItemEdge!]! 8705 8706 """Information to aid in pagination.""" 8707 pageInfo: PageInfo! 8708 } 8709 8710 """ 8711 An auto-generated type which holds one DraftOrderLineItem and a cursor during pagination. 8712 8713 """ 8714 type DraftOrderLineItemEdge { 8715 """A cursor for use in pagination.""" 8716 cursor: String! 8717 8718 """The item at the end of DraftOrderLineItemEdge.""" 8719 node: DraftOrderLineItem! 8720 } 8721 8722 """The input fields used to create a line item for a draft order.""" 8723 input DraftOrderLineItemInput { 8724 """ 8725 Discount which will be applied to the line item. 8726 8727 """ 8728 appliedDiscount: DraftOrderAppliedDiscountInput 8729 8730 """ 8731 Represents a generic custom attribute using a key value pair. 8732 8733 """ 8734 customAttributes: [AttributeInput!] 8735 8736 """ 8737 Ignored when variant ID is provided. This argument is deprecated: Use `weight` instead. 8738 """ 8739 grams: Int 8740 8741 """Ignored when variant ID is provided.""" 8742 originalUnitPrice: Money 8743 8744 """ 8745 The number of products that were purchased. 8746 8747 """ 8748 quantity: Int! 8749 8750 """Ignored when variant ID is provided.""" 8751 requiresShipping: Boolean 8752 8753 """Ignored when variant ID is provided.""" 8754 sku: String 8755 8756 """Ignored when variant ID is provided.""" 8757 taxable: Boolean 8758 8759 """Ignored when variant ID is provided.""" 8760 title: String 8761 8762 """ 8763 The ID of the product variant corresponding to the line item. 8764 Null if custom line item. Required if product variant line item. 8765 8766 """ 8767 variantId: ID 8768 8769 """ 8770 Specifies the weight unit and value inputs. 8771 Ignored when variant ID is provided. 8772 8773 """ 8774 weight: WeightInput 8775 } 8776 8777 """The set of valid sort keys for the DraftOrder query.""" 8778 enum DraftOrderSortKeys { 8779 """Sort by the `number` value.""" 8780 NUMBER 8781 8782 """Sort by the `updated_at` value.""" 8783 UPDATED_AT 8784 8785 """Sort by the `status` value.""" 8786 STATUS 8787 8788 """Sort by the `total_price` value.""" 8789 TOTAL_PRICE 8790 8791 """Sort by the `customer_name` value.""" 8792 CUSTOMER_NAME 8793 8794 """Sort by the `id` value.""" 8795 ID 8796 8797 """ 8798 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 8799 results by relevance to the search term(s). When no search query is specified, this sort key is not 8800 deterministic and should not be used. 8801 8802 """ 8803 RELEVANCE 8804 } 8805 8806 """The valid statuses for a draft order.""" 8807 enum DraftOrderStatus { 8808 """The draft order has been paid.""" 8809 COMPLETED 8810 8811 """An invoice for the draft order has been sent to the customer.""" 8812 INVOICE_SENT 8813 8814 """ 8815 The draft order is open. It has not been paid, and an invoice hasn't been sent. 8816 """ 8817 OPEN 8818 } 8819 8820 """Return type for `draftOrderUpdate` mutation.""" 8821 type DraftOrderUpdatePayload { 8822 """The updated draft order.""" 8823 draftOrder: DraftOrder 8824 8825 """List of errors that occurred executing the mutation.""" 8826 userErrors: [UserError!]! 8827 } 8828 8829 """Represents a single duty for a line item.""" 8830 type Duty implements Node { 8831 """The ISO code of the country of origin of the line item.""" 8832 countryCodeOfOrigin: CountryCode 8833 8834 """The harmonized system code of the line item.""" 8835 harmonizedSystemCode: String 8836 8837 """Globally unique identifier.""" 8838 id: ID! 8839 8840 """The price of the duty for the line item.""" 8841 price: MoneyBag! 8842 8843 """The TaxLine objects connected to the duty for the line item.""" 8844 taxLines: [TaxLine!]! 8845 } 8846 8847 """The attribute editable information.""" 8848 type EditableProperty { 8849 """Whether the attribute is locked for editing.""" 8850 locked: Boolean! 8851 8852 """The reason the attribute is locked for editing.""" 8853 reason: FormattedString 8854 } 8855 8856 """Specifies the fields for an email.""" 8857 input EmailInput { 8858 """Specifies the email subject.""" 8859 subject: String 8860 8861 """Specifies the email recipient.""" 8862 to: String 8863 8864 """Specifies the email sender.""" 8865 from: String 8866 8867 """Specifies the email body.""" 8868 body: String 8869 8870 """Specifies any bcc recipients for the email.""" 8871 bcc: [String!] 8872 8873 """Specifies a custom message to include in the email.""" 8874 customMessage: String 8875 } 8876 8877 """ 8878 Events chronicle resource activities such as the creation of an article, the fulfillment of an order, or the 8879 addition of a product. 8880 8881 """ 8882 interface Event { 8883 """ 8884 The name of the app that created the event. Returns null when the event originates from the Shopify admin. 8885 """ 8886 appTitle: String 8887 8888 """Whether the event was created by an app.""" 8889 attributeToApp: Boolean! 8890 8891 """Whether the event was caused by an admin user.""" 8892 attributeToUser: Boolean! 8893 8894 """The date and time when the event was created.""" 8895 createdAt: DateTime! 8896 8897 """Whether the event is critical.""" 8898 criticalAlert: Boolean! 8899 8900 """Globally unique identifier.""" 8901 id: ID! 8902 8903 """Human readable text that describes the event.""" 8904 message: FormattedString! 8905 } 8906 8907 """Return type for `eventBridgeWebhookSubscriptionCreate` mutation.""" 8908 type EventBridgeWebhookSubscriptionCreatePayload { 8909 """List of errors that occurred executing the mutation.""" 8910 userErrors: [UserError!]! 8911 8912 """The webhook subscription that was created.""" 8913 webhookSubscription: WebhookSubscription 8914 } 8915 8916 """ 8917 Specifies the input fields for an EventBridge webhook subscription. 8918 8919 """ 8920 input EventBridgeWebhookSubscriptionInput { 8921 """ARN of the EventBridge event source.""" 8922 arn: ARN 8923 8924 """The format in which the webhook subscription should send the data.""" 8925 format: WebhookSubscriptionFormat 8926 8927 """The list of fields to be included in the webhook subscription.""" 8928 includeFields: [String!] 8929 8930 """ 8931 The list of namespaces for any metafields that should be included in the webhook subscription. 8932 """ 8933 metafieldNamespaces: [String!] 8934 } 8935 8936 """Return type for `eventBridgeWebhookSubscriptionUpdate` mutation.""" 8937 type EventBridgeWebhookSubscriptionUpdatePayload { 8938 """List of errors that occurred executing the mutation.""" 8939 userErrors: [UserError!]! 8940 8941 """The webhook subscription that was updated.""" 8942 webhookSubscription: WebhookSubscription 8943 } 8944 8945 """ 8946 An auto-generated type for paginating through multiple Events. 8947 8948 """ 8949 type EventConnection { 8950 """A list of edges.""" 8951 edges: [EventEdge!]! 8952 8953 """Information to aid in pagination.""" 8954 pageInfo: PageInfo! 8955 } 8956 8957 """ 8958 An auto-generated type which holds one Event and a cursor during pagination. 8959 8960 """ 8961 type EventEdge { 8962 """A cursor for use in pagination.""" 8963 cursor: String! 8964 8965 """The item at the end of EventEdge.""" 8966 node: Event! 8967 } 8968 8969 """The set of valid sort keys for the Event query.""" 8970 enum EventSortKeys { 8971 """Sort by the `created_at` value.""" 8972 CREATED_AT 8973 8974 """Sort by the `id` value.""" 8975 ID 8976 8977 """ 8978 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 8979 results by relevance to the search term(s). When no search query is specified, this sort key is not 8980 deterministic and should not be used. 8981 8982 """ 8983 RELEVANCE 8984 } 8985 8986 """ 8987 Represents a video hosted outside of Shopify. 8988 8989 """ 8990 type ExternalVideo implements Node & Media { 8991 """A word or phrase to share the nature or contents of a media.""" 8992 alt: String 8993 8994 """The URL.""" 8995 embeddedUrl: URL! 8996 8997 """Globally unique identifier.""" 8998 id: ID! 8999 9000 """The media content type.""" 9001 mediaContentType: MediaContentType! 9002 9003 """Any errors which have occurred on the media.""" 9004 mediaErrors: [MediaError!]! 9005 9006 """The preview image for the media.""" 9007 preview: MediaPreviewImage 9008 9009 """Current status of the media.""" 9010 status: MediaStatus! 9011 } 9012 9013 """Requirements that must be met before an app can be installed.""" 9014 type FailedRequirement { 9015 """ 9016 Action to be taken to resolve a failed requirement, including URL link. 9017 """ 9018 action: NavigationItem 9019 9020 """ 9021 A concise set of copy strings to be displayed to merchants, to guide them in resolving problems your app 9022 encounters when trying to make use of their Shop and its resources. 9023 9024 """ 9025 message: String! 9026 } 9027 9028 """A filter option is one possible value in a search filter.""" 9029 type FilterOption { 9030 """The filter option's label for display purposes.""" 9031 label: String! 9032 9033 """The filter option's value.""" 9034 value: String! 9035 } 9036 9037 """Return type for `flowTriggerReceive` mutation.""" 9038 type FlowTriggerReceivePayload { 9039 """List of errors that occurred executing the mutation.""" 9040 userErrors: [UserError!]! 9041 } 9042 9043 """ 9044 A string containing a strict subset of HTML code. Non-allowed tags will be stripped out. 9045 Allowed tags: 9046 * `a` (allowed attributes: `href`) 9047 * `b` 9048 * `br` 9049 * `em` 9050 * `i` 9051 * `strong` 9052 * `u` 9053 9054 Example value: `"Your current domain is <strong>johns-apparel.myshopify.com</strong>."` 9055 9056 """ 9057 scalar FormattedString 9058 9059 """ 9060 Represents a fulfillment. In Shopify, a fulfillment represents a shipment of one or more items in an order. When an order has been completely fulfilled, it means that all the items that are included in the order have been sent to the customer. There can be more than one fulfillment for an order. 9061 9062 """ 9063 type Fulfillment implements LegacyInteroperability & Node { 9064 """The date and time when the fulfillment was created.""" 9065 createdAt: DateTime! 9066 9067 """The date that this fulfillment was delivered.""" 9068 deliveredAt: DateTime 9069 9070 """Human readable display status for this fulfillment.""" 9071 displayStatus: FulfillmentDisplayStatus 9072 9073 """The estimated date that this fulfillment will arrive.""" 9074 estimatedDeliveryAt: DateTime 9075 9076 """The history of events associated with this fulfillment.""" 9077 events( 9078 """Returns up to the first `n` elements from the list.""" 9079 first: Int 9080 9081 """Returns the elements that come after the specified cursor.""" 9082 after: String 9083 9084 """Returns up to the last `n` elements from the list.""" 9085 last: Int 9086 9087 """Returns the elements that come before the specified cursor.""" 9088 before: String 9089 9090 """Reverse the order of the underlying list.""" 9091 reverse: Boolean = false 9092 9093 """Sort the underlying list by the given key.""" 9094 sortKey: FulfillmentEventSortKeys = HAPPENED_AT 9095 ): FulfillmentEventConnection! 9096 9097 # """List of the fulfillment's line items.""" 9098 # fulfillmentLineItems( 9099 # """Returns up to the first `n` elements from the list.""" 9100 # first: Int 9101 9102 # """Returns the elements that come after the specified cursor.""" 9103 # after: String 9104 9105 # """Returns up to the last `n` elements from the list.""" 9106 # last: Int 9107 9108 # """Returns the elements that come before the specified cursor.""" 9109 # before: String 9110 9111 # """Reverse the order of the underlying list.""" 9112 # reverse: Boolean = false 9113 # ): FulfillmentLineItemConnection! 9114 9115 # """A list of fulfillment orders for the fulfillment.""" 9116 # fulfillmentOrders( 9117 # """Returns up to the first `n` elements from the list.""" 9118 # first: Int 9119 9120 # """Returns the elements that come after the specified cursor.""" 9121 # after: String 9122 9123 # """Returns up to the last `n` elements from the list.""" 9124 # last: Int 9125 9126 # """Returns the elements that come before the specified cursor.""" 9127 # before: String 9128 9129 # """Reverse the order of the underlying list.""" 9130 # reverse: Boolean = false 9131 # ): FulfillmentOrderConnection! 9132 9133 """Globally unique identifier.""" 9134 id: ID! 9135 9136 """The date and time when the fulfillment went into transit.""" 9137 inTransitAt: DateTime 9138 9139 """The ID of the corresponding resource in the REST Admin API.""" 9140 legacyResourceId: UnsignedInt64! 9141 9142 # """The location that the fulfillment was processed at.""" 9143 # location: Location 9144 9145 """Human readable reference identifier for this fulfillment.""" 9146 name: String! 9147 9148 # """The order for which the fulfillment was created.""" 9149 # order: Order! 9150 9151 """Whether any of the line items in the fulfillment require shipping.""" 9152 requiresShipping: Boolean! 9153 9154 # """Fulfillment service associated with the fulfillment.""" 9155 # service: FulfillmentService 9156 9157 """The status of the fulfillment.""" 9158 status: FulfillmentStatus! 9159 9160 """Sum of all line item quantities for the fulfillment.""" 9161 totalQuantity: Int! 9162 9163 """ 9164 Tracking information associated with the fulfillment, 9165 such as the tracking company, tracking number, and tracking URL. 9166 9167 """ 9168 trackingInfo( 9169 """Truncate the array result to this size.""" 9170 first: Int 9171 ): [FulfillmentTrackingInfo!]! 9172 9173 """ 9174 The date and time when the fulfillment was last modified. 9175 9176 """ 9177 updatedAt: DateTime! 9178 } 9179 9180 """Return type for `fulfillmentCancel` mutation.""" 9181 type FulfillmentCancelPayload { 9182 """The canceled fulfillment.""" 9183 fulfillment: Fulfillment 9184 9185 """List of errors that occurred executing the mutation.""" 9186 userErrors: [UserError!]! 9187 } 9188 9189 """ 9190 An auto-generated type for paginating through multiple Fulfillments. 9191 9192 """ 9193 type FulfillmentConnection { 9194 """A list of edges.""" 9195 edges: [FulfillmentEdge!]! 9196 9197 """Information to aid in pagination.""" 9198 pageInfo: PageInfo! 9199 } 9200 9201 """Return type for `fulfillmentCreate` mutation.""" 9202 type FulfillmentCreatePayload { 9203 """The created fulfillment.""" 9204 fulfillment: Fulfillment 9205 9206 """The order for which the fulfillment is created.""" 9207 order: Order 9208 9209 """List of errors that occurred executing the mutation.""" 9210 userErrors: [UserError!]! 9211 } 9212 9213 """Return type for `fulfillmentCreateV2` mutation.""" 9214 type FulfillmentCreateV2Payload { 9215 """The created fulfillment.""" 9216 fulfillment: Fulfillment 9217 9218 """List of errors that occurred executing the mutation.""" 9219 userErrors: [UserError!]! 9220 } 9221 9222 """The display status of a fulfillment.""" 9223 enum FulfillmentDisplayStatus { 9224 """Displayed as **Attempted delivery**.""" 9225 ATTEMPTED_DELIVERY 9226 9227 """Displayed as **Canceled**.""" 9228 CANCELED 9229 9230 """Displayed as **Confirmed**.""" 9231 CONFIRMED 9232 9233 """Displayed as **Delivered**.""" 9234 DELIVERED 9235 9236 """Displayed as **Failure**.""" 9237 FAILURE 9238 9239 """Displayed as **Fulfilled**.""" 9240 FULFILLED 9241 9242 """Displayed as **In transit**.""" 9243 IN_TRANSIT 9244 9245 """Displayed as **Label printed**.""" 9246 LABEL_PRINTED 9247 9248 """Displayed as **Label purchased**.""" 9249 LABEL_PURCHASED 9250 9251 """Displayed as **Label voided**.""" 9252 LABEL_VOIDED 9253 9254 """Displayed as **Marked as fulfilled**.""" 9255 MARKED_AS_FULFILLED 9256 9257 """Displayed as **Not delivered**.""" 9258 NOT_DELIVERED 9259 9260 """Displayed as **Out for delivery**.""" 9261 OUT_FOR_DELIVERY 9262 9263 """Displayed as **Ready for pickup**.""" 9264 READY_FOR_PICKUP 9265 9266 """Displayed as **Picked up**.""" 9267 PICKED_UP 9268 9269 """Displayed as **Submitted**.""" 9270 SUBMITTED 9271 } 9272 9273 """ 9274 An auto-generated type which holds one Fulfillment and a cursor during pagination. 9275 9276 """ 9277 type FulfillmentEdge { 9278 """A cursor for use in pagination.""" 9279 cursor: String! 9280 9281 """The item at the end of FulfillmentEdge.""" 9282 node: Fulfillment! 9283 } 9284 9285 """An event that describes a fulfillment at a time.""" 9286 type FulfillmentEvent implements Node { 9287 """The time at which this fulfillment event happened.""" 9288 happenedAt: DateTime! 9289 9290 """Globally unique identifier.""" 9291 id: ID! 9292 9293 """The status of this fulfillment event.""" 9294 status: FulfillmentEventStatus! 9295 } 9296 9297 """ 9298 An auto-generated type for paginating through multiple FulfillmentEvents. 9299 9300 """ 9301 type FulfillmentEventConnection { 9302 """A list of edges.""" 9303 edges: [FulfillmentEventEdge!]! 9304 9305 """Information to aid in pagination.""" 9306 pageInfo: PageInfo! 9307 } 9308 9309 """ 9310 An auto-generated type which holds one FulfillmentEvent and a cursor during pagination. 9311 9312 """ 9313 type FulfillmentEventEdge { 9314 """A cursor for use in pagination.""" 9315 cursor: String! 9316 9317 """The item at the end of FulfillmentEventEdge.""" 9318 node: FulfillmentEvent! 9319 } 9320 9321 """The set of valid sort keys for the FulfillmentEvent query.""" 9322 enum FulfillmentEventSortKeys { 9323 """Sort by the `happened_at` value.""" 9324 HAPPENED_AT 9325 9326 """Sort by the `id` value.""" 9327 ID 9328 9329 """ 9330 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 9331 results by relevance to the search term(s). When no search query is specified, this sort key is not 9332 deterministic and should not be used. 9333 9334 """ 9335 RELEVANCE 9336 } 9337 9338 """Event status' describe the status of a fulfillment.""" 9339 enum FulfillmentEventStatus { 9340 """A shipping label has been purchased.""" 9341 LABEL_PURCHASED 9342 9343 """A purchased shipping label has been printed.""" 9344 LABEL_PRINTED 9345 9346 """The fulfillment is ready to be picked up.""" 9347 READY_FOR_PICKUP 9348 9349 """The fulfillment is confirmed.""" 9350 CONFIRMED 9351 9352 """The fulfillment is in transit.""" 9353 IN_TRANSIT 9354 9355 """The fulfillment is out for delivery.""" 9356 OUT_FOR_DELIVERY 9357 9358 """A delivery was attempted.""" 9359 ATTEMPTED_DELIVERY 9360 9361 """The fulfillment was successfully delivered.""" 9362 DELIVERED 9363 9364 """The fulfillment request failed.""" 9365 FAILURE 9366 } 9367 9368 """The input fields used to create a fulfillment.""" 9369 input FulfillmentInput { 9370 """The ID of the order to be fulfilled.""" 9371 orderId: ID! 9372 9373 """The line items to be fulfilled.""" 9374 lineItems: [FulfillmentLineItemInput!] 9375 9376 """Tracking numbers associated with the fulfillment.""" 9377 trackingNumbers: [String!] 9378 9379 """The URLs to track the fulfillment.""" 9380 trackingUrls: [String!] 9381 9382 """The name of the tracking company.""" 9383 trackingCompany: String 9384 9385 """ 9386 Whether the customer is notified. 9387 If set to true, a notification is sent when the fulfillment is created. 9388 9389 """ 9390 notifyCustomer: Boolean 9391 9392 """A reference to the shipping method, such as `Free Shipping`.""" 9393 shippingMethod: String 9394 9395 """The ID of the location from which the items will be fulfilled.""" 9396 locationId: ID! 9397 } 9398 9399 """Represents a line item from an order that's included in a fulfillment.""" 9400 type FulfillmentLineItem implements Node { 9401 """The total price after discounts are applied.""" 9402 discountedTotal: Money! @deprecated(reason: "Use `discountedTotalSet` instead") 9403 9404 """ 9405 The total price after discounts are applied in shop and presentment currencies. 9406 """ 9407 discountedTotalSet: MoneyBag! 9408 9409 """Globally unique identifier.""" 9410 id: ID! 9411 9412 """The associated order's line item.""" 9413 lineItem: LineItem! 9414 9415 """The total price before discounts are applied.""" 9416 originalTotal: Money! @deprecated(reason: "Use `originalTotalSet` instead") 9417 9418 """ 9419 The total price before discounts are applied in shop and presentment currencies. 9420 """ 9421 originalTotalSet: MoneyBag! 9422 9423 """Number of line items in the fulfillment.""" 9424 quantity: Int 9425 } 9426 9427 """ 9428 An auto-generated type for paginating through multiple FulfillmentLineItems. 9429 9430 """ 9431 type FulfillmentLineItemConnection { 9432 """A list of edges.""" 9433 edges: [FulfillmentLineItemEdge!]! 9434 9435 """Information to aid in pagination.""" 9436 pageInfo: PageInfo! 9437 } 9438 9439 """ 9440 An auto-generated type which holds one FulfillmentLineItem and a cursor during pagination. 9441 9442 """ 9443 type FulfillmentLineItemEdge { 9444 """A cursor for use in pagination.""" 9445 cursor: String! 9446 9447 """The item at the end of FulfillmentLineItemEdge.""" 9448 node: FulfillmentLineItem! 9449 } 9450 9451 """ 9452 The input fields used to include a line item from an order in a fulfillment. 9453 """ 9454 input FulfillmentLineItemInput { 9455 """The ID of the line item.""" 9456 id: ID! 9457 9458 """The quantity of the line item to be fulfilled.""" 9459 quantity: Int 9460 } 9461 9462 """ 9463 Represents a fulfillment order. In Shopify, a fulfillment order represents a group of one or more items 9464 in an order that are to be fulfilled from the same location. There can be more than one fulfillment order 9465 for an order at a given location. 9466 9467 """ 9468 type FulfillmentOrder implements Node { 9469 """ 9470 The fulfillment order's assigned location. This is the location expected to perform fulfillment. 9471 """ 9472 assignedLocation: FulfillmentOrderAssignedLocation! 9473 9474 """Delivery method of this fulfillment order.""" 9475 deliveryMethod: DeliveryMethod 9476 9477 """The destination where the items should be sent.""" 9478 destination: FulfillmentOrderDestination 9479 9480 """The date and time at which the fulfillment order will be fulfillable.""" 9481 fulfillAt: DateTime 9482 9483 """A list of fulfillments for the fulfillment order.""" 9484 fulfillments( 9485 """Returns up to the first `n` elements from the list.""" 9486 first: Int 9487 9488 """Returns the elements that come after the specified cursor.""" 9489 after: String 9490 9491 """Returns up to the last `n` elements from the list.""" 9492 last: Int 9493 9494 """Returns the elements that come before the specified cursor.""" 9495 before: String 9496 9497 """Reverse the order of the underlying list.""" 9498 reverse: Boolean = false 9499 ): FulfillmentConnection! 9500 9501 """Globally unique identifier.""" 9502 id: ID! 9503 9504 """A list of the fulfillment order's line items.""" 9505 lineItems( 9506 """Returns up to the first `n` elements from the list.""" 9507 first: Int 9508 9509 """Returns the elements that come after the specified cursor.""" 9510 after: String 9511 9512 """Returns up to the last `n` elements from the list.""" 9513 last: Int 9514 9515 """Returns the elements that come before the specified cursor.""" 9516 before: String 9517 9518 """Reverse the order of the underlying list.""" 9519 reverse: Boolean = false 9520 ): FulfillmentOrderLineItemConnection! 9521 9522 """ 9523 A list of locations that the fulfillment order can potentially move to. 9524 """ 9525 locationsForMove( 9526 """Returns up to the first `n` elements from the list.""" 9527 first: Int 9528 9529 """Returns the elements that come after the specified cursor.""" 9530 after: String 9531 9532 """Returns up to the last `n` elements from the list.""" 9533 last: Int 9534 9535 """Returns the elements that come before the specified cursor.""" 9536 before: String 9537 9538 """Reverse the order of the underlying list.""" 9539 reverse: Boolean = false 9540 ): FulfillmentOrderLocationForMoveConnection! 9541 9542 """ 9543 A list of requests sent by the merchant to the fulfillment service for this fulfillment order. 9544 """ 9545 merchantRequests( 9546 """The kind of request the merchant sent.""" 9547 kind: FulfillmentOrderMerchantRequestKind 9548 9549 """Returns up to the first `n` elements from the list.""" 9550 first: Int 9551 9552 """Returns the elements that come after the specified cursor.""" 9553 after: String 9554 9555 """Returns up to the last `n` elements from the list.""" 9556 last: Int 9557 9558 """Returns the elements that come before the specified cursor.""" 9559 before: String 9560 9561 """Reverse the order of the underlying list.""" 9562 reverse: Boolean = false 9563 ): FulfillmentOrderMerchantRequestConnection! 9564 9565 """The order that's associated with the fulfillment order.""" 9566 order: Order! 9567 9568 """The request status of the fulfillment order.""" 9569 requestStatus: FulfillmentOrderRequestStatus! 9570 9571 """The status of the fulfillment order.""" 9572 status: FulfillmentOrderStatus! 9573 9574 """The actions that can be performed on this fulfillment order.""" 9575 supportedActions: [FulfillmentOrderSupportedAction!]! 9576 } 9577 9578 """Return type for `fulfillmentOrderAcceptCancellationRequest` mutation.""" 9579 type FulfillmentOrderAcceptCancellationRequestPayload { 9580 """The fulfillment order whose cancellation request was accepted.""" 9581 fulfillmentOrder: FulfillmentOrder 9582 9583 """List of errors that occurred executing the mutation.""" 9584 userErrors: [UserError!]! 9585 } 9586 9587 """Return type for `fulfillmentOrderAcceptFulfillmentRequest` mutation.""" 9588 type FulfillmentOrderAcceptFulfillmentRequestPayload { 9589 """The fulfillment order whose fulfillment request was accepted.""" 9590 fulfillmentOrder: FulfillmentOrder 9591 9592 """List of errors that occurred executing the mutation.""" 9593 userErrors: [UserError!]! 9594 } 9595 9596 """The actions that can be taken on a fulfillment order.""" 9597 enum FulfillmentOrderAction { 9598 """ 9599 Create a fulfillment for selected line items in the fulfillment order. The corresponding mutation for this action is FulfillmentCreateV2. 9600 """ 9601 CREATE_FULFILLMENT 9602 9603 """ 9604 Send a request for fulfilling selected line items in a fulfillment order to a fulfillment service. The corresponding mutation for this action is FulfillmentOrderSubmitFulfillmentRequest. 9605 """ 9606 REQUEST_FULFILLMENT 9607 9608 """ 9609 Cancel a fulfillment order. The corresponding mutation for this action is FulfillmentOrderCancel. 9610 """ 9611 CANCEL_FULFILLMENT_ORDER 9612 9613 """ 9614 Move a fulfillment order. The corresponding mutation for this action is FulfillmentOrderMove. 9615 """ 9616 MOVE 9617 9618 """ 9619 Send a cancellation request to the fulfillment service of a fulfillment order. The corresponding mutation for this action is FulfillmentOrderSubmitCancellationRequest. 9620 """ 9621 REQUEST_CANCELLATION 9622 9623 """Mark the fulfillment order as open.""" 9624 MARK_AS_OPEN 9625 9626 """ 9627 Open an external URL to initiate the fulfillment process outside Shopify. 9628 """ 9629 EXTERNAL 9630 } 9631 9632 """ 9633 Represents the assigned location of a fulfillment order, which is a snapshot of the location 9634 at which the fulfillment order was created. The assigned location is expected to perform fulfillment. 9635 9636 """ 9637 type FulfillmentOrderAssignedLocation { 9638 """The first line of the address for the location.""" 9639 address1: String 9640 9641 """The second line of the address for the location.""" 9642 address2: String 9643 9644 """The city of the location.""" 9645 city: String 9646 9647 """The two-letter country code of the location.""" 9648 countryCode: CountryCode! 9649 9650 """ 9651 The location where the fulfillment order was created. This can differ from the 9652 `FulfillmentOrderAssignedLocation` if the location was updated since the fulfillment order 9653 was closed. 9654 9655 """ 9656 location: Location 9657 9658 """The name of the location.""" 9659 name: String! 9660 9661 """The phone number of the location.""" 9662 phone: String 9663 9664 """The province of the location.""" 9665 province: String 9666 9667 """The ZIP code of the location.""" 9668 zip: String 9669 } 9670 9671 """The assigment status to be used to filter fulfillment orders.""" 9672 enum FulfillmentOrderAssignmentStatus { 9673 """ 9674 Fulfillment orders for which the merchant has requested cancellation of 9675 the previously accepted fulfillment request. 9676 9677 """ 9678 CANCELLATION_REQUESTED 9679 9680 """ 9681 Fulfillment orders for which the merchant has requested fulfillment. 9682 9683 """ 9684 FULFILLMENT_REQUESTED 9685 9686 """ 9687 Fulfillment orders for which the merchant's fulfillment request has been accepted. 9688 Any number of fulfillments can be created on these fulfillment orders 9689 to completely fulfill the requested items. 9690 9691 """ 9692 FULFILLMENT_ACCEPTED 9693 } 9694 9695 """Return type for `fulfillmentOrderCancel` mutation.""" 9696 type FulfillmentOrderCancelPayload { 9697 """The fulfillment order that was marked as canceled.""" 9698 fulfillmentOrder: FulfillmentOrder 9699 9700 """ 9701 The fulfillment order that was created to replace the canceled fulfillment order. 9702 """ 9703 replacementFulfillmentOrder: FulfillmentOrder 9704 9705 """List of errors that occurred executing the mutation.""" 9706 userErrors: [UserError!]! 9707 } 9708 9709 """Return type for `fulfillmentOrderClose` mutation.""" 9710 type FulfillmentOrderClosePayload { 9711 """The fulfillment order that was marked as incomplete.""" 9712 fulfillmentOrder: FulfillmentOrder 9713 9714 """List of errors that occurred executing the mutation.""" 9715 userErrors: [UserError!]! 9716 } 9717 9718 """ 9719 An auto-generated type for paginating through multiple FulfillmentOrders. 9720 9721 """ 9722 type FulfillmentOrderConnection { 9723 """A list of edges.""" 9724 edges: [FulfillmentOrderEdge!]! 9725 9726 """Information to aid in pagination.""" 9727 pageInfo: PageInfo! 9728 } 9729 9730 """ 9731 Represents the destination where the items should be sent upon fulfillment. 9732 9733 """ 9734 type FulfillmentOrderDestination implements Node { 9735 """The first line of the address of the destination.""" 9736 address1: String 9737 9738 """The second line of the address of the destination.""" 9739 address2: String 9740 9741 """The city of the destination.""" 9742 city: String 9743 9744 """The company of the destination.""" 9745 company: String 9746 9747 """The two-letter country code of the destination.""" 9748 countryCode: CountryCode 9749 9750 """The email of the customer at the destination.""" 9751 email: String 9752 9753 """The first name of the customer at the destination.""" 9754 firstName: String 9755 9756 """Globally unique identifier.""" 9757 id: ID! 9758 9759 """The last name of the customer at the destination.""" 9760 lastName: String 9761 9762 """The phone number of the customer at the destination.""" 9763 phone: String 9764 9765 """The province of the destination.""" 9766 province: String 9767 9768 """The ZIP code of the destination.""" 9769 zip: String 9770 } 9771 9772 """ 9773 An auto-generated type which holds one FulfillmentOrder and a cursor during pagination. 9774 9775 """ 9776 type FulfillmentOrderEdge { 9777 """A cursor for use in pagination.""" 9778 cursor: String! 9779 9780 """The item at the end of FulfillmentOrderEdge.""" 9781 node: FulfillmentOrder! 9782 } 9783 9784 """ 9785 Represents a line item belonging to a fulfillment order. 9786 9787 """ 9788 type FulfillmentOrderLineItem implements Node { 9789 """Globally unique identifier.""" 9790 id: ID! 9791 9792 """The associated order line item.""" 9793 lineItem: LineItem! 9794 9795 """The number of units remaining to be fulfilled.""" 9796 remainingQuantity: Int! 9797 9798 """The total number of units to be fulfilled.""" 9799 totalQuantity: Int! 9800 } 9801 9802 """ 9803 An auto-generated type for paginating through multiple FulfillmentOrderLineItems. 9804 9805 """ 9806 type FulfillmentOrderLineItemConnection { 9807 """A list of edges.""" 9808 edges: [FulfillmentOrderLineItemEdge!]! 9809 9810 """Information to aid in pagination.""" 9811 pageInfo: PageInfo! 9812 } 9813 9814 """ 9815 An auto-generated type which holds one FulfillmentOrderLineItem and a cursor during pagination. 9816 9817 """ 9818 type FulfillmentOrderLineItemEdge { 9819 """A cursor for use in pagination.""" 9820 cursor: String! 9821 9822 """The item at the end of FulfillmentOrderLineItemEdge.""" 9823 node: FulfillmentOrderLineItem! 9824 } 9825 9826 """The input fields used to include a line item from a fulfillment order.""" 9827 input FulfillmentOrderLineItemInput { 9828 """The ID of the fulfillment order line item.""" 9829 id: ID! 9830 9831 """The quantity of the fulfillment order line item.""" 9832 quantity: Int! 9833 } 9834 9835 """ 9836 The input fields used to include the line items of a specified fulfillment order that should be fulfilled. 9837 9838 """ 9839 input FulfillmentOrderLineItemsInput { 9840 """The ID of the fulfillment order.""" 9841 fulfillmentOrderId: ID! 9842 9843 """ 9844 The fulfillment order line items to be fulfilled. 9845 If left blank, all line items of the fulfillment order will be fulfilled. 9846 9847 """ 9848 fulfillmentOrderLineItems: [FulfillmentOrderLineItemInput!] 9849 } 9850 9851 """ 9852 A location that a fulfillment order can potentially move to. 9853 9854 """ 9855 type FulfillmentOrderLocationForMove { 9856 """ 9857 The location being considered as the fulfillment order's new assigned location. 9858 """ 9859 location: Location! 9860 9861 """ 9862 A human-readable string with the reason why the fulfillment order, or some of its line items, can't be 9863 moved to the location. 9864 9865 """ 9866 message: String 9867 9868 """Whether the fulfillment order can be moved to the location.""" 9869 movable: Boolean! 9870 } 9871 9872 """ 9873 An auto-generated type for paginating through multiple FulfillmentOrderLocationForMoves. 9874 9875 """ 9876 type FulfillmentOrderLocationForMoveConnection { 9877 """A list of edges.""" 9878 edges: [FulfillmentOrderLocationForMoveEdge!]! 9879 9880 """Information to aid in pagination.""" 9881 pageInfo: PageInfo! 9882 } 9883 9884 """ 9885 An auto-generated type which holds one FulfillmentOrderLocationForMove and a cursor during pagination. 9886 9887 """ 9888 type FulfillmentOrderLocationForMoveEdge { 9889 """A cursor for use in pagination.""" 9890 cursor: String! 9891 9892 """The item at the end of FulfillmentOrderLocationForMoveEdge.""" 9893 node: FulfillmentOrderLocationForMove! 9894 } 9895 9896 """ 9897 Represents a request made by the merchant to a fulfillment service for a fulfillment order. 9898 9899 """ 9900 type FulfillmentOrderMerchantRequest implements Node { 9901 """Globally unique identifier.""" 9902 id: ID! 9903 9904 """The kind of request made.""" 9905 kind: FulfillmentOrderMerchantRequestKind! 9906 9907 """The optional message that the merchant included in the request.""" 9908 message: String 9909 9910 """ 9911 Additional options requested by the merchant. These depend on the `kind` of the request. 9912 For example, for a `FULFILLMENT_REQUEST`, one option is `notify_customer`, which indicates whether the 9913 merchant intends to notify the customer upon fulfillment. The fulfillment service can then set 9914 `notifyCustomer` when making calls to `FulfillmentCreateV2`. 9915 9916 """ 9917 requestOptions: JSON 9918 9919 """The response from the fulfillment service.""" 9920 responseData: JSON 9921 9922 """The timestamp when the request was made.""" 9923 sentAt: DateTime! 9924 } 9925 9926 """ 9927 An auto-generated type for paginating through multiple FulfillmentOrderMerchantRequests. 9928 9929 """ 9930 type FulfillmentOrderMerchantRequestConnection { 9931 """A list of edges.""" 9932 edges: [FulfillmentOrderMerchantRequestEdge!]! 9933 9934 """Information to aid in pagination.""" 9935 pageInfo: PageInfo! 9936 } 9937 9938 """ 9939 An auto-generated type which holds one FulfillmentOrderMerchantRequest and a cursor during pagination. 9940 9941 """ 9942 type FulfillmentOrderMerchantRequestEdge { 9943 """A cursor for use in pagination.""" 9944 cursor: String! 9945 9946 """The item at the end of FulfillmentOrderMerchantRequestEdge.""" 9947 node: FulfillmentOrderMerchantRequest! 9948 } 9949 9950 """The kinds of request merchants can make to a fulfillment service.""" 9951 enum FulfillmentOrderMerchantRequestKind { 9952 """ 9953 The merchant requested fulfillment for a fulfillment order. 9954 9955 """ 9956 FULFILLMENT_REQUEST 9957 9958 """ 9959 The merchant requested cancellation of an accepted or in-progress fulfillment order. 9960 9961 """ 9962 CANCELLATION_REQUEST 9963 } 9964 9965 """Return type for `fulfillmentOrderMove` mutation.""" 9966 type FulfillmentOrderMovePayload { 9967 """ 9968 A new fulfillment order representing all items that were able to be moved to the new location. 9969 """ 9970 movedFulfillmentOrder: FulfillmentOrder 9971 9972 """ 9973 The fulfillment order that was moved. On success, this fulfillment order will be closed. 9974 """ 9975 originalFulfillmentOrder: FulfillmentOrder 9976 9977 """ 9978 A new fulfillment order representing any items still assigned to the original location. 9979 This is created if all line items on the original fulfillment order could not be moved to the new location 9980 due to not being stocked there. 9981 9982 """ 9983 remainingFulfillmentOrder: FulfillmentOrder 9984 9985 """List of errors that occurred executing the mutation.""" 9986 userErrors: [UserError!]! 9987 } 9988 9989 """Return type for `fulfillmentOrderOpen` mutation.""" 9990 type FulfillmentOrderOpenPayload { 9991 """The fulfillment order that was marked as open.""" 9992 fulfillmentOrder: FulfillmentOrder 9993 9994 """List of errors that occurred executing the mutation.""" 9995 userErrors: [UserError!]! 9996 } 9997 9998 """Return type for `fulfillmentOrderRejectCancellationRequest` mutation.""" 9999 type FulfillmentOrderRejectCancellationRequestPayload { 10000 """The fulfillment order whose cancellation request was rejected.""" 10001 fulfillmentOrder: FulfillmentOrder 10002 10003 """List of errors that occurred executing the mutation.""" 10004 userErrors: [UserError!]! 10005 } 10006 10007 """Return type for `fulfillmentOrderRejectFulfillmentRequest` mutation.""" 10008 type FulfillmentOrderRejectFulfillmentRequestPayload { 10009 """The fulfillment order whose fulfillment request was rejected.""" 10010 fulfillmentOrder: FulfillmentOrder 10011 10012 """List of errors that occurred executing the mutation.""" 10013 userErrors: [UserError!]! 10014 } 10015 10016 """The request status of a fulfillment order.""" 10017 enum FulfillmentOrderRequestStatus { 10018 """ 10019 The initial request status for the newly created fulfillment orders. This is the only valid 10020 request status for fulfillment orders that aren't assigned to a fulfillment service. 10021 10022 """ 10023 UNSUBMITTED 10024 10025 """The merchant requested fulfillment for this fulfillment order.""" 10026 SUBMITTED 10027 10028 """The fulfillment service accepted the merchant's fulfillment request.""" 10029 ACCEPTED 10030 10031 """The fulfillment service rejected the merchant's fulfillment request.""" 10032 REJECTED 10033 10034 """ 10035 The merchant requested a cancellation of the fulfillment request for this fulfillment order. 10036 10037 """ 10038 CANCELLATION_REQUESTED 10039 10040 """ 10041 The fulfillment service accepted the merchant's fulfillment cancellation request. 10042 10043 """ 10044 CANCELLATION_ACCEPTED 10045 10046 """ 10047 The fulfillment service rejected the merchant's fulfillment cancellation request. 10048 10049 """ 10050 CANCELLATION_REJECTED 10051 10052 """ 10053 The fulfillment service closed the fulfillment order without completing it. 10054 """ 10055 CLOSED 10056 } 10057 10058 """Return type for `fulfillmentOrderReschedule` mutation.""" 10059 type FulfillmentOrderReschedulePayload { 10060 """The fulfillment order that was updated to the new fulfill at date.""" 10061 fulfillmentOrder: FulfillmentOrder 10062 10063 """List of errors that occurred executing the mutation.""" 10064 userErrors: [FulfillmentOrderRescheduleUserError!]! 10065 } 10066 10067 """ 10068 An error that occurs during the execution of FulfillmentOrderReschedule. 10069 """ 10070 type FulfillmentOrderRescheduleUserError implements DisplayableError { 10071 """Error code to uniquely identify the error.""" 10072 code: FulfillmentOrderRescheduleUserErrorCode 10073 10074 """Path to the input field which caused the error.""" 10075 field: [String!] 10076 10077 """The error message.""" 10078 message: String! 10079 } 10080 10081 """ 10082 Possible error codes that could be returned by FulfillmentOrderRescheduleUserError. 10083 """ 10084 enum FulfillmentOrderRescheduleUserErrorCode { 10085 """Fulfillment order could not be found.""" 10086 FULFILLMENT_ORDER_NOT_FOUND 10087 } 10088 10089 """The set of valid sort keys for the FulfillmentOrder query.""" 10090 enum FulfillmentOrderSortKeys { 10091 """Sort by the `id` value.""" 10092 ID 10093 10094 """ 10095 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 10096 results by relevance to the search term(s). When no search query is specified, this sort key is not 10097 deterministic and should not be used. 10098 10099 """ 10100 RELEVANCE 10101 } 10102 10103 """The status of a fulfillment order.""" 10104 enum FulfillmentOrderStatus { 10105 """The fulfillment order has been opened.""" 10106 OPEN 10107 10108 """The fulfillment order is being processed.""" 10109 IN_PROGRESS 10110 10111 """The fulfillment order has been cancelled by the merchant.""" 10112 CANCELLED 10113 10114 """The fulfillment order cannot be completed as requested.""" 10115 INCOMPLETE 10116 10117 """The fulfillment order has been completed and closed.""" 10118 CLOSED 10119 10120 """The fulfillment order is scheduled for fulfillment.""" 10121 SCHEDULED 10122 } 10123 10124 """Return type for `fulfillmentOrderSubmitCancellationRequest` mutation.""" 10125 type FulfillmentOrderSubmitCancellationRequestPayload { 10126 """The fulfillment order whose cancellation was requested.""" 10127 fulfillmentOrder: FulfillmentOrder 10128 10129 """List of errors that occurred executing the mutation.""" 10130 userErrors: [UserError!]! 10131 } 10132 10133 """Return type for `fulfillmentOrderSubmitFulfillmentRequest` mutation.""" 10134 type FulfillmentOrderSubmitFulfillmentRequestPayload { 10135 """ 10136 The original fulfillment order intended to request fulfillment for. 10137 10138 """ 10139 originalFulfillmentOrder: FulfillmentOrder 10140 10141 """ 10142 The fulfillment order that was submitted to the fulfillment service. This will be the same as 10143 the original fulfillment order field. The exception to this is partial fulfillment requests or 10144 fulfillment request for cancelled or incomplete fulfillment orders. 10145 10146 """ 10147 submittedFulfillmentOrder: FulfillmentOrder 10148 10149 """ 10150 This field will only be present for partial fulfillment requests. This will represent the new 10151 fulfillment order with the remaining line items not submitted to the fulfillment service. 10152 10153 """ 10154 unsubmittedFulfillmentOrder: FulfillmentOrder 10155 10156 """List of errors that occurred executing the mutation.""" 10157 userErrors: [UserError!]! 10158 } 10159 10160 """ 10161 Represents one of the methods that the fulfillment order supports. 10162 10163 """ 10164 type FulfillmentOrderSupportedAction { 10165 """The action value.""" 10166 action: FulfillmentOrderAction! 10167 10168 """ 10169 The external URL to be used to initiate the fulfillment process outside Shopify. 10170 """ 10171 externalUrl: URL 10172 } 10173 10174 """ 10175 Represents a fulfillment service. A fulfillment service is a third-party service that prepares and ships orders on behalf of the store owner. 10176 10177 """ 10178 type FulfillmentService { 10179 """The callback URL the fulfillment service has registered for requests.""" 10180 callbackUrl: URL 10181 10182 """ 10183 Whether the fulfillment service has opted into fulfillment order based requests. 10184 """ 10185 fulfillmentOrdersOptIn: Boolean! 10186 10187 """Human-readable unique identifier for this fulfillment service.""" 10188 handle: String! 10189 10190 """The ID of the fulfillment service.""" 10191 id: ID! 10192 10193 """ 10194 Whether the fulfillment service tracks product inventory and provides updates to Shopify. 10195 """ 10196 inventoryManagement: Boolean! 10197 10198 """Location associated with the fulfillment service.""" 10199 location: Location 10200 10201 """Whether the fulfillment service supports local deliveries.""" 10202 productBased: Boolean! 10203 10204 """The name of the fulfillment service as seen by merchants.""" 10205 serviceName: String! 10206 10207 """Shipping methods associated with the fulfillment service provider.""" 10208 shippingMethods: [ShippingMethod!]! 10209 10210 """Type associated with the fulfillment service.""" 10211 type: FulfillmentServiceType! 10212 } 10213 10214 """Return type for `fulfillmentServiceCreate` mutation.""" 10215 type FulfillmentServiceCreatePayload { 10216 """The created fulfillment service.""" 10217 fulfillmentService: FulfillmentService 10218 10219 """List of errors that occurred executing the mutation.""" 10220 userErrors: [UserError!]! 10221 } 10222 10223 """Return type for `fulfillmentServiceDelete` mutation.""" 10224 type FulfillmentServiceDeletePayload { 10225 """The ID of the deleted fulfillment service.""" 10226 deletedId: ID 10227 10228 """List of errors that occurred executing the mutation.""" 10229 userErrors: [UserError!]! 10230 } 10231 10232 """The type of a fulfillment service.""" 10233 enum FulfillmentServiceType { 10234 """Fulfillment by gift card.""" 10235 GIFT_CARD 10236 10237 """Manual fulfillment by the merchant.""" 10238 MANUAL 10239 10240 """Fullfillment by a third-party fulfillment service.""" 10241 THIRD_PARTY 10242 } 10243 10244 """Return type for `fulfillmentServiceUpdate` mutation.""" 10245 type FulfillmentServiceUpdatePayload { 10246 """The updated fulfillment service.""" 10247 fulfillmentService: FulfillmentService 10248 10249 """List of errors that occurred executing the mutation.""" 10250 userErrors: [UserError!]! 10251 } 10252 10253 """The status of a fulfillment.""" 10254 enum FulfillmentStatus { 10255 """ 10256 Shopify has created the fulfillment and is waiting for the third-party fulfillment service to transition it to `open` or `success`. 10257 10258 """ 10259 PENDING 10260 10261 """ 10262 The third-party fulfillment service has acknowledged the fulfilment and is processing it. 10263 10264 """ 10265 OPEN 10266 10267 """The fulfillment was completed successfully.""" 10268 SUCCESS 10269 10270 """The fulfillment was canceled.""" 10271 CANCELLED 10272 10273 """There was an error with the fulfillment request.""" 10274 ERROR 10275 10276 """The fulfillment request failed.""" 10277 FAILURE 10278 } 10279 10280 """Represents the tracking information for a fulfillment.""" 10281 type FulfillmentTrackingInfo { 10282 """The name of the tracking company.""" 10283 company: String 10284 10285 """The tracking number of the fulfillment.""" 10286 number: String 10287 10288 """The URLs to track the fulfillment.""" 10289 url: URL 10290 } 10291 10292 """Return type for `fulfillmentTrackingInfoUpdate` mutation.""" 10293 type FulfillmentTrackingInfoUpdatePayload { 10294 """The updated fulfillment with tracking information.""" 10295 fulfillment: Fulfillment 10296 10297 """List of errors that occurred executing the mutation.""" 10298 userErrors: [UserError!]! 10299 } 10300 10301 """Return type for `fulfillmentTrackingInfoUpdateV2` mutation.""" 10302 type FulfillmentTrackingInfoUpdateV2Payload { 10303 """The updated fulfillment with tracking information.""" 10304 fulfillment: Fulfillment 10305 10306 """List of errors that occurred executing the mutation.""" 10307 userErrors: [UserError!]! 10308 } 10309 10310 """ 10311 The input fields used to specify all possible fields for tracking information. 10312 """ 10313 input FulfillmentTrackingInput { 10314 """The tracking number of the fulfillment.""" 10315 number: String 10316 10317 """The URL to track the fulfillment.""" 10318 url: URL 10319 10320 """The name of the tracking company.""" 10321 company: String 10322 } 10323 10324 """The input fields used to create a fulfillment from fulfillment orders.""" 10325 input FulfillmentV2Input { 10326 """ 10327 The fulfillment's tracking information, including a tracking URL, a tracking number, 10328 and the company associated with the fulfillment. 10329 10330 """ 10331 trackingInfo: FulfillmentTrackingInput 10332 10333 """ 10334 Whether the customer is notified. 10335 If set to true, a notification is sent when the fulfillment is created. 10336 10337 """ 10338 notifyCustomer: Boolean = false 10339 10340 """ 10341 Pairs of `fulfillment_order_id` and `fulfillment_order_line_items` that represent the fulfillment 10342 order line items that have to be fulfilled for each fulfillment order. For any given pair, if the 10343 fulfillment order line items are left blank then all the fulfillment order line items of the 10344 associated fulfillment order ID will be fulfilled. 10345 10346 """ 10347 lineItemsByFulfillmentOrder: [FulfillmentOrderLineItemsInput!]! 10348 } 10349 10350 """ 10351 A string containing HTML code. Example value: `"<p>Grey cotton knit sweater.</p>"`. 10352 """ 10353 scalar HTML 10354 10355 """Connector to event records on a compatible host.""" 10356 interface HasEvents { 10357 """The paginated list of events associated with the host subject.""" 10358 events( 10359 """Returns up to the first `n` elements from the list.""" 10360 first: Int 10361 10362 """Returns the elements that come after the specified cursor.""" 10363 after: String 10364 10365 """Returns up to the last `n` elements from the list.""" 10366 last: Int 10367 10368 """Returns the elements that come before the specified cursor.""" 10369 before: String 10370 10371 """Reverse the order of the underlying list.""" 10372 reverse: Boolean = false 10373 10374 """Sort the underlying list by the given key.""" 10375 sortKey: EventSortKeys = ID 10376 10377 """ 10378 Supported filter parameters: 10379 - `comments` 10380 - `created_at` 10381 - `subject_type` 10382 - `verb` 10383 10384 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 10385 for more information about using filters. 10386 10387 """ 10388 query: String 10389 ): EventConnection! 10390 } 10391 10392 """ 10393 Localization extensions associated with the specified resource. For example, the tax id for government invoice. 10394 10395 """ 10396 interface HasLocalizationExtensions { 10397 """List of localization extensions for the resource.""" 10398 localizationExtensions( 10399 """The country codes of the extensions.""" 10400 countryCodes: [CountryCode!] 10401 10402 """The purpose of the extensions.""" 10403 purposes: [LocalizationExtensionPurpose!] 10404 10405 """Returns up to the first `n` elements from the list.""" 10406 first: Int 10407 10408 """Returns the elements that come after the specified cursor.""" 10409 after: String 10410 10411 """Returns up to the last `n` elements from the list.""" 10412 last: Int 10413 10414 """Returns the elements that come before the specified cursor.""" 10415 before: String 10416 10417 """Reverse the order of the underlying list.""" 10418 reverse: Boolean = false 10419 ): LocalizationExtensionConnection! 10420 } 10421 10422 """ 10423 Localization extensions associated with the specified resource. For example, the tax id for government invoice. 10424 10425 """ 10426 interface HasLocalizationExtensionsForDraftOrders { 10427 """List of localization extensions for the resource.""" 10428 localizationExtensions( 10429 """The country codes of the extensions.""" 10430 countryCodes: [CountryCode!] 10431 10432 """The purpose of the extensions.""" 10433 purposes: [LocalizationExtensionPurpose!] 10434 10435 """Returns up to the first `n` elements from the list.""" 10436 first: Int 10437 10438 """Returns the elements that come after the specified cursor.""" 10439 after: String 10440 10441 """Returns up to the last `n` elements from the list.""" 10442 last: Int 10443 10444 """Returns the elements that come before the specified cursor.""" 10445 before: String 10446 10447 """Reverse the order of the underlying list.""" 10448 reverse: Boolean = false 10449 ): LocalizationExtensionConnection! 10450 } 10451 10452 """ 10453 Represents information about the metafields associated to the specified resource. 10454 """ 10455 interface HasMetafields { 10456 """The metafield associated with the resource.""" 10457 metafield( 10458 """Container for a set of metafields (maximum of 20 characters).""" 10459 namespace: String! 10460 10461 """Identifier for the metafield (maximum of 30 characters).""" 10462 key: String! 10463 ): Metafield 10464 10465 """A paginated list of metafields associated with the resource.""" 10466 metafields( 10467 """Finds all metafields with a specific namespace under the resource.""" 10468 namespace: String 10469 10470 """Returns up to the first `n` elements from the list.""" 10471 first: Int 10472 10473 """Returns the elements that come after the specified cursor.""" 10474 after: String 10475 10476 """Returns up to the last `n` elements from the list.""" 10477 last: Int 10478 10479 """Returns the elements that come before the specified cursor.""" 10480 before: String 10481 10482 """Reverse the order of the underlying list.""" 10483 reverse: Boolean = false 10484 ): MetafieldConnection! 10485 10486 """Returns a private metafield found by namespace and key.""" 10487 privateMetafield( 10488 """The namespace for the private metafield.""" 10489 namespace: String! 10490 10491 """The key for the private metafield.""" 10492 key: String! 10493 ): PrivateMetafield 10494 10495 """List of private metafields.""" 10496 privateMetafields( 10497 """Filter the private metafields by namespace.""" 10498 namespace: String 10499 10500 """Returns up to the first `n` elements from the list.""" 10501 first: Int 10502 10503 """Returns the elements that come after the specified cursor.""" 10504 after: String 10505 10506 """Returns up to the last `n` elements from the list.""" 10507 last: Int 10508 10509 """Returns the elements that come before the specified cursor.""" 10510 before: String 10511 10512 """Reverse the order of the underlying list.""" 10513 reverse: Boolean = false 10514 ): PrivateMetafieldConnection! 10515 } 10516 10517 """Published translations associated with the resource.""" 10518 interface HasPublishedTranslations { 10519 """The translations associated with the resource.""" 10520 translations( 10521 """Filters translations locale.""" 10522 locale: String! 10523 ): [PublishedTranslation!]! 10524 } 10525 10526 """Represents an image resource.""" 10527 type Image implements HasMetafields { 10528 """A word or phrase to share the nature or contents of an image.""" 10529 altText: String 10530 10531 """ 10532 The original height of the image in pixels. Returns `null` if the image is not hosted by Shopify. 10533 """ 10534 height: Int 10535 10536 """A unique identifier for the image.""" 10537 id: ID 10538 10539 """The metafield associated with the resource.""" 10540 metafield( 10541 """Container for a set of metafields (maximum of 20 characters).""" 10542 namespace: String! 10543 10544 """Identifier for the metafield (maximum of 30 characters).""" 10545 key: String! 10546 ): Metafield 10547 10548 """A paginated list of metafields associated with the resource.""" 10549 metafields( 10550 """Finds all metafields with a specific namespace under the resource.""" 10551 namespace: String 10552 10553 """Returns up to the first `n` elements from the list.""" 10554 first: Int 10555 10556 """Returns the elements that come after the specified cursor.""" 10557 after: String 10558 10559 """Returns up to the last `n` elements from the list.""" 10560 last: Int 10561 10562 """Returns the elements that come before the specified cursor.""" 10563 before: String 10564 10565 """Reverse the order of the underlying list.""" 10566 reverse: Boolean = false 10567 ): MetafieldConnection! 10568 10569 """ 10570 The location of the original image as a URL. 10571 10572 If there are any existing transformations in the original source URL, they will remain and not be stripped. 10573 10574 """ 10575 originalSrc: URL! 10576 10577 """Returns a private metafield found by namespace and key.""" 10578 privateMetafield( 10579 """The namespace for the private metafield.""" 10580 namespace: String! 10581 10582 """The key for the private metafield.""" 10583 key: String! 10584 ): PrivateMetafield 10585 10586 """List of private metafields.""" 10587 privateMetafields( 10588 """Filter the private metafields by namespace.""" 10589 namespace: String 10590 10591 """Returns up to the first `n` elements from the list.""" 10592 first: Int 10593 10594 """Returns the elements that come after the specified cursor.""" 10595 after: String 10596 10597 """Returns up to the last `n` elements from the list.""" 10598 last: Int 10599 10600 """Returns the elements that come before the specified cursor.""" 10601 before: String 10602 10603 """Reverse the order of the underlying list.""" 10604 reverse: Boolean = false 10605 ): PrivateMetafieldConnection! 10606 10607 """The location of the image as a URL.""" 10608 src: URL! @deprecated(reason: "Previously an image had a single `src` field. This could either return the original image\nlocation or a URL that contained transformations such as sizing or scale.\n\nThese transformations were specified by arguments on the parent field.\n\nNow an image has two distinct URL fields: `originalSrc` and `transformedSrc`.\n\n* `originalSrc` - the original unmodified image URL\n* `transformedSrc` - the image URL with the specified transformations included\n\nTo migrate to the new fields, image transformations should be moved from the parent field to `transformedSrc`.\n\nBefore:\n```graphql\n{\n shop {\n productImages(maxWidth: 200, scale: 2) {\n edges {\n node {\n src\n }\n }\n }\n }\n}\n```\n\nAfter:\n```graphql\n{\n shop {\n productImages {\n edges {\n node {\n transformedSrc(maxWidth: 200, scale: 2)\n }\n }\n }\n }\n}\n```\n") 10609 10610 """ 10611 The location of the transformed image as a URL. 10612 10613 All transformation arguments are considered "best-effort". If they can be applied to an image, they will be. 10614 Otherwise any transformations which an image type does not support will be ignored. 10615 10616 """ 10617 transformedSrc( 10618 """Image width in pixels between 1 and 5760.""" 10619 maxWidth: Int 10620 10621 """Image height in pixels between 1 and 5760.""" 10622 maxHeight: Int 10623 10624 """Crops the image according to the specified region.""" 10625 crop: CropRegion 10626 10627 """ 10628 Image size multiplier for high-resolution retina displays. Must be between 1 and 3. 10629 """ 10630 scale: Int = 1 10631 10632 """ 10633 Best effort conversion of image into content type (SVG -> PNG, Anything -> JGP, Anything -> WEBP are supported). 10634 """ 10635 preferredContentType: ImageContentType 10636 ): URL! 10637 10638 """ 10639 The original width of the image in pixels. Returns `null` if the image is not hosted by Shopify. 10640 """ 10641 width: Int 10642 } 10643 10644 """ 10645 An auto-generated type for paginating through multiple Images. 10646 10647 """ 10648 type ImageConnection { 10649 """A list of edges.""" 10650 edges: [ImageEdge!]! 10651 10652 """Information to aid in pagination.""" 10653 pageInfo: PageInfo! 10654 } 10655 10656 """List of supported image content types.""" 10657 enum ImageContentType { 10658 """A PNG image.""" 10659 PNG 10660 10661 """A JPG image.""" 10662 JPG 10663 10664 """A WEBP image.""" 10665 WEBP 10666 } 10667 10668 """ 10669 An auto-generated type which holds one Image and a cursor during pagination. 10670 10671 """ 10672 type ImageEdge { 10673 """A cursor for use in pagination.""" 10674 cursor: String! 10675 10676 """The item at the end of ImageEdge.""" 10677 node: Image! 10678 } 10679 10680 """Specifies the input fields for an image.""" 10681 input ImageInput { 10682 """Globally unique identifier.""" 10683 id: ID 10684 10685 """A word or phrase to share the nature or contents of an image.""" 10686 altText: String 10687 10688 """The URL of the image. May be a signed upload URL.""" 10689 src: String 10690 } 10691 10692 """Upload parameter of an image.""" 10693 type ImageUploadParameter { 10694 """Parameter name.""" 10695 name: String! 10696 10697 """Parameter value.""" 10698 value: String! 10699 } 10700 10701 """Return type for `inventoryActivate` mutation.""" 10702 type InventoryActivatePayload { 10703 """The newly activated inventory level.""" 10704 inventoryLevel: InventoryLevel 10705 10706 """List of errors that occurred executing the mutation.""" 10707 userErrors: [UserError!]! 10708 } 10709 10710 """Specifies the items and their adjustments.""" 10711 input InventoryAdjustItemInput { 10712 """ID of the inventory item to adjust.""" 10713 inventoryItemId: ID! 10714 10715 """Count by which to adjust the available quantity.""" 10716 availableDelta: Int! 10717 } 10718 10719 """Specifies the fields required to adjust the inventory quantity.""" 10720 input InventoryAdjustQuantityInput { 10721 """ID of the inventory level to adjust.""" 10722 inventoryLevelId: ID! 10723 10724 """Count by which to adjust the available quantity.""" 10725 availableDelta: Int! 10726 } 10727 10728 """Return type for `inventoryAdjustQuantity` mutation.""" 10729 type InventoryAdjustQuantityPayload { 10730 """ 10731 Represents the updated inventory quantity of an inventory item at a specific location. 10732 """ 10733 inventoryLevel: InventoryLevel 10734 10735 """List of errors that occurred executing the mutation.""" 10736 userErrors: [UserError!]! 10737 } 10738 10739 """Return type for `inventoryBulkAdjustQuantityAtLocation` mutation.""" 10740 type InventoryBulkAdjustQuantityAtLocationPayload { 10741 """The updated inventory quantities.""" 10742 inventoryLevels: [InventoryLevel!] 10743 10744 """List of errors that occurred executing the mutation.""" 10745 userErrors: [UserError!]! 10746 } 10747 10748 """Return type for `inventoryDeactivate` mutation.""" 10749 type InventoryDeactivatePayload { 10750 """List of errors that occurred executing the mutation.""" 10751 userErrors: [UserError!]! 10752 } 10753 10754 """ 10755 Represents the goods available to be shipped to a customer. 10756 It holds essential information about the goods, including SKU and whether it is tracked. 10757 10758 """ 10759 type InventoryItem implements Node & LegacyInteroperability { 10760 """The ISO code of the country of origin.""" 10761 countryCodeOfOrigin: CountryCode 10762 10763 """List of country specific harmonized system codes.""" 10764 countryHarmonizedSystemCodes( 10765 """Returns up to the first `n` elements from the list.""" 10766 first: Int 10767 10768 """Returns the elements that come after the specified cursor.""" 10769 after: String 10770 10771 """Returns up to the last `n` elements from the list.""" 10772 last: Int 10773 10774 """Returns the elements that come before the specified cursor.""" 10775 before: String 10776 10777 """Reverse the order of the underlying list.""" 10778 reverse: Boolean = false 10779 ): CountryHarmonizedSystemCodeConnection! 10780 10781 """The date and time when the inventory item was created.""" 10782 createdAt: DateTime! 10783 10784 """The number of inventory items that share the same SKU with this item.""" 10785 duplicateSkuCount: Int! 10786 10787 """The harmonized system code of the item.""" 10788 harmonizedSystemCode: String 10789 10790 """Globally unique identifier.""" 10791 id: ID! 10792 10793 """URL for inventory history web page.""" 10794 inventoryHistoryUrl: URL 10795 10796 """Get the inventory level at a specific location.""" 10797 inventoryLevel( 10798 """ID of the location for which the inventory level is requested.""" 10799 locationId: ID! 10800 ): InventoryLevel 10801 10802 """ 10803 Paginated list of inventory levels for each location that the inventory item is stocked at. 10804 """ 10805 inventoryLevels( 10806 """Returns up to the first `n` elements from the list.""" 10807 first: Int 10808 10809 """Returns the elements that come after the specified cursor.""" 10810 after: String 10811 10812 """Returns up to the last `n` elements from the list.""" 10813 last: Int 10814 10815 """Returns the elements that come before the specified cursor.""" 10816 before: String 10817 10818 """Reverse the order of the underlying list.""" 10819 reverse: Boolean = false 10820 10821 """ 10822 Supported filter parameters: 10823 - `created_at` 10824 - `inventory_group_id` 10825 - `inventory_item_id` 10826 - `updated_at` 10827 10828 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 10829 for more information about using filters. 10830 10831 """ 10832 query: String 10833 ): InventoryLevelConnection! 10834 10835 """The ID of the corresponding resource in the REST Admin API.""" 10836 legacyResourceId: UnsignedInt64! 10837 10838 """The number of locations where this inventory item is stocked.""" 10839 locationsCount: Int! 10840 10841 """The ISO code of the province of origin.""" 10842 provinceCodeOfOrigin: String 10843 10844 """Whether the item requires shipping or not.""" 10845 requiresShipping: Boolean! 10846 10847 """Inventory item SKU.""" 10848 sku: String 10849 10850 """ 10851 Whether the inventory quantities of inventory levels for the item are tracked or not. 10852 """ 10853 tracked: Boolean! 10854 10855 """Whether changes to the inventory item tracked attribute are allowed.""" 10856 trackedEditable: EditableProperty! 10857 10858 """Unit cost associated with the inventory item.""" 10859 unitCost: MoneyV2 10860 10861 """The date and time when the inventory item was updated.""" 10862 updatedAt: DateTime! 10863 10864 """The variant that owns this inventory item.""" 10865 variant: ProductVariant! 10866 } 10867 10868 """ 10869 An auto-generated type for paginating through multiple InventoryItems. 10870 10871 """ 10872 type InventoryItemConnection { 10873 """A list of edges.""" 10874 edges: [InventoryItemEdge!]! 10875 10876 """Information to aid in pagination.""" 10877 pageInfo: PageInfo! 10878 } 10879 10880 """ 10881 An auto-generated type which holds one InventoryItem and a cursor during pagination. 10882 10883 """ 10884 type InventoryItemEdge { 10885 """A cursor for use in pagination.""" 10886 cursor: String! 10887 10888 """The item at the end of InventoryItemEdge.""" 10889 node: InventoryItem! 10890 } 10891 10892 """Inventory items.""" 10893 input InventoryItemInput { 10894 """ 10895 Unit cost associated with the inventory item, the currency is the shop's default currency. 10896 """ 10897 cost: Decimal 10898 10899 """Whether the inventory item is tracked.""" 10900 tracked: Boolean 10901 } 10902 10903 """Inventory items.""" 10904 input InventoryItemUpdateInput { 10905 """ 10906 Unit cost associated with the inventory item, the currency is the shop's default currency. 10907 """ 10908 cost: Decimal 10909 10910 """Whether the inventory item is tracked.""" 10911 tracked: Boolean 10912 10913 """The ISO code of the country of origin.""" 10914 countryCodeOfOrigin: CountryCode 10915 10916 """The ISO code of the province of origin.""" 10917 provinceCodeOfOrigin: String 10918 10919 """The harmonized system code of the inventory item.""" 10920 harmonizedSystemCode: String 10921 10922 """List of country-specific harmonized system codes.""" 10923 countryHarmonizedSystemCodes: [CountryHarmonizedSystemCodeInput!] 10924 } 10925 10926 """Return type for `inventoryItemUpdate` mutation.""" 10927 type InventoryItemUpdatePayload { 10928 """The updated inventory item.""" 10929 inventoryItem: InventoryItem 10930 10931 """List of errors that occurred executing the mutation.""" 10932 userErrors: [UserError!]! 10933 } 10934 10935 """ 10936 Represents the inventory quantity of an inventory item at a specific location. 10937 10938 """ 10939 type InventoryLevel implements Node { 10940 """Quantity of items available at the location.""" 10941 available: Int! 10942 10943 """Whether inventoryDeactivate is allowed for this inventory level.""" 10944 canDeactivate: Boolean! 10945 10946 """The date and time when the inventory level was created.""" 10947 createdAt: DateTime! 10948 10949 """ 10950 Reason why canDeactivate is false, or impact of deactivating the inventory level. 10951 """ 10952 deactivationAlert: String 10953 10954 """ 10955 Reason why canDeactivate is false with URLs linked in HTML, or impact of deactivating the inventory level. 10956 """ 10957 deactivationAlertHtml: FormattedString 10958 10959 """Globally unique identifier.""" 10960 id: ID! 10961 10962 """Quantity of items incoming to the location.""" 10963 incoming: Int! 10964 10965 """Inventory item associated with the inventory level.""" 10966 item: InventoryItem! 10967 10968 """Location associated with the inventory level.""" 10969 location: Location! 10970 10971 """The date and time when the inventory level was updated.""" 10972 updatedAt: DateTime! 10973 } 10974 10975 """ 10976 An auto-generated type for paginating through multiple InventoryLevels. 10977 10978 """ 10979 type InventoryLevelConnection { 10980 """A list of edges.""" 10981 edges: [InventoryLevelEdge!]! 10982 10983 """Information to aid in pagination.""" 10984 pageInfo: PageInfo! 10985 } 10986 10987 """ 10988 An auto-generated type which holds one InventoryLevel and a cursor during pagination. 10989 10990 """ 10991 type InventoryLevelEdge { 10992 """A cursor for use in pagination.""" 10993 cursor: String! 10994 10995 """The item at the end of InventoryLevelEdge.""" 10996 node: InventoryLevel! 10997 } 10998 10999 """Inventory quantity at a specific location.""" 11000 input InventoryLevelInput { 11001 """Sets the quantity available at the location.""" 11002 availableQuantity: Int! 11003 11004 """ID of the location.""" 11005 locationId: ID! 11006 } 11007 11008 """ 11009 A JSON Object. Example value: `{ "key1": "Value 1", "key2": "Value 2", "key3": 3 }` 11010 """ 11011 scalar JSON 11012 11013 """ 11014 A job corresponds to some long running task that the client should poll for status. 11015 """ 11016 type Job { 11017 """This indicates if the job is still queued or has been run.""" 11018 done: Boolean! 11019 11020 """Globally unique identifier.""" 11021 id: ID! 11022 11023 # """ 11024 # This field will only resolve once the job is done. Can be used to ask for object(s) that have been changed by the job. 11025 # """ 11026 # query: QueryRoot 11027 } 11028 11029 """The locale language allowed for Kit Skill.""" 11030 enum KitSkillLocale { 11031 """English language.""" 11032 EN 11033 } 11034 11035 """Return type for `kitSkillTriggerRequest` mutation.""" 11036 type KitSkillTriggerRequestPayload { 11037 """ 11038 Conversation unique identifier sent to Conversation API and returned to app developer. 11039 """ 11040 conversationUid: String 11041 11042 """List of errors that occurred executing the mutation.""" 11043 userErrors: [UserError!]! 11044 } 11045 11046 """ 11047 Interoperability metadata for types that directly correspond to a REST Admin API resource. 11048 For example, on the Product type, LegacyInteroperability returns metadata for the corresponding [Product object](https://help.shopify.com/api/reference/products/product) in the REST Admin API. 11049 11050 """ 11051 interface LegacyInteroperability { 11052 """The ID of the corresponding resource in the REST Admin API.""" 11053 legacyResourceId: UnsignedInt64! 11054 } 11055 11056 """ 11057 The total number of pending orders on a shop if less then a maximum, or that maximum. 11058 The atMax field indicates when this maximum has been reached. 11059 11060 """ 11061 type LimitedPendingOrderCount { 11062 """This is set when the number of pending orders has reached the maximum.""" 11063 atMax: Boolean! 11064 11065 """ 11066 The number of pendings orders on the shop. 11067 Limited to a maximum of 10000. 11068 11069 """ 11070 count: Int! 11071 } 11072 11073 """Represents a single line in a shopping cart.""" 11074 type LineItem implements Node { 11075 """ 11076 Whether the line item's variant has an ID and inventory is managed by Shopify. 11077 """ 11078 canRestock: Boolean! @deprecated(reason: "Use `restockable` instead") 11079 11080 """The subscription contract associated with this line item.""" 11081 contract: SubscriptionContract 11082 11083 """The line item's quantity minus the removed quantity.""" 11084 currentQuantity: Int! 11085 11086 """List of additional information (metafields) about the line item.""" 11087 customAttributes: [Attribute!]! 11088 11089 """ 11090 The discounts that have been allocated onto the line item by discount applications. 11091 """ 11092 discountAllocations: [DiscountAllocation!]! 11093 11094 """The total line price after discounts are applied.""" 11095 discountedTotal: Money! @deprecated(reason: "Use `discountedTotalSet` instead") 11096 11097 """ 11098 The total line price after discounts are applied in shop and presentment currencies. 11099 """ 11100 discountedTotalSet: MoneyBag! 11101 11102 """ 11103 The price of a single variant unit after line item discounts are applied. 11104 """ 11105 discountedUnitPrice: Money! @deprecated(reason: "Use `discountedUnitPriceSet` instead") 11106 11107 """ 11108 The price of a single variant unit after line item discounts are applied in shop and presentment currencies. 11109 """ 11110 discountedUnitPriceSet: MoneyBag! 11111 11112 """The duties associated with the line item.""" 11113 duties: [Duty!]! 11114 11115 """The total number of units to fulfill.""" 11116 fulfillableQuantity: Int! 11117 11118 """ 11119 Name of the service provider who fulfilled the order. 11120 11121 Valid values are either **manual** or the name of the provider. 11122 For example, **amazon**, **shipwire**. 11123 11124 """ 11125 fulfillmentService: FulfillmentService! 11126 11127 """ 11128 The line item's fulfillment status. Returns 'fulfilled' if fulfillableQuantity >= quantity, 11129 'partial' if fulfillableQuantity > 0, and 'unfulfilled' otherwise. 11130 11131 """ 11132 fulfillmentStatus: String! 11133 11134 """Globally unique identifier.""" 11135 id: ID! 11136 11137 """The Image object associated to the line item's variant.""" 11138 image( 11139 """ 11140 Image width in pixels between 1 and 2048. This argument is deprecated: Use `maxWidth` on `Image.transformedSrc` instead. 11141 """ 11142 maxWidth: Int 11143 11144 """ 11145 Image height in pixels between 1 and 2048. This argument is deprecated: Use `maxHeight` on `Image.transformedSrc` instead. 11146 """ 11147 maxHeight: Int 11148 11149 """ 11150 Crops the image according to the specified region. This argument is deprecated: Use `crop` on `Image.transformedSrc` instead. 11151 """ 11152 crop: CropRegion 11153 11154 """ 11155 Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use `scale` on `Image.transformedSrc` instead. 11156 """ 11157 scale: Int = 1 11158 ): Image 11159 11160 """Whether the line item can be edited or not.""" 11161 merchantEditable: Boolean! 11162 11163 """Name of the product.""" 11164 name: String! 11165 11166 """A count of the number of line items that cannot be fulfilled.""" 11167 nonFulfillableQuantity: Int! 11168 11169 """ 11170 Total price (without discounts) of the line item, based on the original unit price of the variant x quantity. 11171 11172 """ 11173 originalTotal: Money! @deprecated(reason: "Use `originalTotalSet` instead") 11174 11175 """ 11176 Total price (without discounts) of the line item, based on the original unit price of the variant x quantity in shop and presentment currencies. 11177 """ 11178 originalTotalSet: MoneyBag! 11179 11180 """Variant price without any discounts applied.""" 11181 originalUnitPrice: Money! @deprecated(reason: "Use `originalUnitPriceSet` instead") 11182 11183 """ 11184 Variant price without any discounts applied in shop and presentment currencies. 11185 """ 11186 originalUnitPriceSet: MoneyBag! 11187 11188 """The Product object associated with this line item's variant.""" 11189 product: Product 11190 11191 """The number of variant items ordered.""" 11192 quantity: Int! 11193 11194 """The line item's quantity minus its refundedQuantity.""" 11195 refundableQuantity: Int! 11196 11197 """Whether physical shipping is required for the variant.""" 11198 requiresShipping: Boolean! 11199 11200 """ 11201 Whether the line item's variant has an ID and inventory is managed by Shopify. 11202 """ 11203 restockable: Boolean! 11204 11205 """The selling plan details associated with the line item.""" 11206 sellingPlan: LineItemSellingPlan 11207 11208 """Variant SKU number.""" 11209 sku: String 11210 11211 """The TaxLine object connected to this line item.""" 11212 taxLines( 11213 """Truncate the array result to this size.""" 11214 first: Int 11215 ): [TaxLine!]! 11216 11217 """Whether the variant is taxable.""" 11218 taxable: Boolean! 11219 11220 """ 11221 Title of the product or variant (this field only applies to custom line items). 11222 """ 11223 title: String! 11224 11225 """The sum of all AppliedDiscounts on this line item.""" 11226 totalDiscount: Money! @deprecated(reason: "Use `totalDiscountSet` instead") 11227 11228 """ 11229 The sum of all AppliedDiscounts on this line item in shop and presentment currencies. 11230 """ 11231 totalDiscountSet: MoneyBag! 11232 11233 """The total discounted value of unfulfilled units.""" 11234 unfulfilledDiscountedTotal: Money! @deprecated(reason: "Use `unfulfilledDiscountedTotalSet` instead") 11235 11236 """ 11237 The total discounted value of unfulfilled units in shop and presentment currencies. 11238 """ 11239 unfulfilledDiscountedTotalSet: MoneyBag! 11240 11241 """The total value before discount of all unfulfilled units.""" 11242 unfulfilledOriginalTotal: Money! @deprecated(reason: "Use `unfulfilledOriginalTotalSet` instead") 11243 11244 """ 11245 The total value before discount of all unfulfilled units in shop and presentment currencies. 11246 """ 11247 unfulfilledOriginalTotalSet: MoneyBag! 11248 11249 """The number of units not yet fulfilled.""" 11250 unfulfilledQuantity: Int! 11251 11252 """The Variant object associated with this line item.""" 11253 variant: ProductVariant 11254 11255 """Name of the variant.""" 11256 variantTitle: String 11257 11258 """Name of the vendor who made the variant.""" 11259 vendor: String 11260 } 11261 11262 """ 11263 An auto-generated type for paginating through multiple LineItems. 11264 11265 """ 11266 type LineItemConnection { 11267 """A list of edges.""" 11268 edges: [LineItemEdge!]! 11269 11270 """Information to aid in pagination.""" 11271 pageInfo: PageInfo! 11272 } 11273 11274 """ 11275 An auto-generated type which holds one LineItem and a cursor during pagination. 11276 11277 """ 11278 type LineItemEdge { 11279 """A cursor for use in pagination.""" 11280 cursor: String! 11281 11282 """The item at the end of LineItemEdge.""" 11283 node: LineItem! 11284 } 11285 11286 """Represents a single line in a shopping cart.""" 11287 type LineItemMutable implements Node { 11288 """ 11289 Whether the line item's variant has an ID and inventory is managed by Shopify. 11290 """ 11291 canRestock: Boolean! @deprecated(reason: "Use `restockable` instead") 11292 11293 """List of additional information (metafields) about the line item.""" 11294 customAttributes: [Attribute!]! 11295 11296 """ 11297 The discounts that have been allocated onto the line item by discount applications. 11298 """ 11299 discountAllocations: [DiscountAllocation!]! 11300 11301 """The total line price after discounts are applied.""" 11302 discountedTotal: Money! @deprecated(reason: "Use `discountedTotalSet` instead") 11303 11304 """ 11305 The total line price after discounts are applied in shop and presentment currencies. 11306 """ 11307 discountedTotalSet: MoneyBag! 11308 11309 """ 11310 The price of a single variant unit after line item discounts are applied. 11311 """ 11312 discountedUnitPrice: Money! @deprecated(reason: "Use `discountedUnitPriceSet` instead") 11313 11314 """ 11315 The price of a single variant unit after line item discounts are applied in shop and presentment currencies. 11316 """ 11317 discountedUnitPriceSet: MoneyBag! 11318 11319 """The total number of units to fulfill.""" 11320 fulfillableQuantity: Int! 11321 11322 """ 11323 Name of the service provider who fulfilled the order. 11324 11325 Valid values are either **manual** or the name of the provider. 11326 For example, **amazon**, **shipwire**. 11327 11328 """ 11329 fulfillmentService: FulfillmentService! 11330 11331 """ 11332 The line item's fulfillment status. Returns 'fulfilled' if fulfillableQuantity >= quantity, 11333 'partial' if fulfillableQuantity > 0, and 'unfulfilled' otherwise. 11334 11335 """ 11336 fulfillmentStatus: String! 11337 11338 """Globally unique identifier.""" 11339 id: ID! 11340 11341 """The Image object associated to the line item's variant.""" 11342 image( 11343 """ 11344 Image width in pixels between 1 and 2048. This argument is deprecated: Use `maxWidth` on `Image.transformedSrc` instead. 11345 """ 11346 maxWidth: Int 11347 11348 """ 11349 Image height in pixels between 1 and 2048. This argument is deprecated: Use `maxHeight` on `Image.transformedSrc` instead. 11350 """ 11351 maxHeight: Int 11352 11353 """ 11354 Crops the image according to the specified region. This argument is deprecated: Use `crop` on `Image.transformedSrc` instead. 11355 """ 11356 crop: CropRegion 11357 11358 """ 11359 Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use `scale` on `Image.transformedSrc` instead. 11360 """ 11361 scale: Int = 1 11362 ): Image 11363 11364 """Whether the line item can be edited or not.""" 11365 merchantEditable: Boolean! 11366 11367 """Name of the product.""" 11368 name: String! 11369 11370 """A count of the number of line items that cannot be fulfilled.""" 11371 nonFulfillableQuantity: Int! 11372 11373 """ 11374 Total price (without discounts) of the line item, based on the original unit price of the variant x quantity. 11375 11376 """ 11377 originalTotal: Money! @deprecated(reason: "Use `originalTotalSet` instead") 11378 11379 """ 11380 Total price (without discounts) of the line item, based on the original unit price of the variant x quantity in shop and presentment currencies. 11381 """ 11382 originalTotalSet: MoneyBag! 11383 11384 """Variant price without any discounts applied.""" 11385 originalUnitPrice: Money! @deprecated(reason: "Use `originalUnitPriceSet` instead") 11386 11387 """ 11388 Variant price without any discounts applied in shop and presentment currencies. 11389 """ 11390 originalUnitPriceSet: MoneyBag! 11391 11392 """The Product object associated with this line item's variant.""" 11393 product: Product 11394 11395 """Number of variant items ordered.""" 11396 quantity: Int! 11397 11398 """The line item's quantity minus its refundedQuantity.""" 11399 refundableQuantity: Int! 11400 11401 """Whether physical shipping is required for the variant.""" 11402 requiresShipping: Boolean! 11403 11404 """ 11405 Whether the line item's variant has an ID and inventory is managed by Shopify. 11406 """ 11407 restockable: Boolean! 11408 11409 """Variant SKU number.""" 11410 sku: String 11411 11412 """The TaxLine object connected to this line item.""" 11413 taxLines( 11414 """Truncate the array result to this size.""" 11415 first: Int 11416 ): [TaxLine!]! 11417 11418 """Whether the variant is taxable.""" 11419 taxable: Boolean! 11420 11421 """ 11422 Title of the product or variant (this field only applies to custom line items). 11423 """ 11424 title: String! 11425 11426 """The sum of all AppliedDiscounts on this line item.""" 11427 totalDiscount: Money! @deprecated(reason: "Use `totalDiscountSet` instead") 11428 11429 """ 11430 The sum of all AppliedDiscounts on this line item in shop and presentment currencies. 11431 """ 11432 totalDiscountSet: MoneyBag! 11433 11434 """The total discounted value of unfulfilled units.""" 11435 unfulfilledDiscountedTotal: Money! @deprecated(reason: "Use `unfulfilledDiscountedTotalSet` instead") 11436 11437 """ 11438 The total discounted value of unfulfilled units in shop and presentment currencies. 11439 """ 11440 unfulfilledDiscountedTotalSet: MoneyBag! 11441 11442 """The total value before discount of all unfulfilled units.""" 11443 unfulfilledOriginalTotal: Money! @deprecated(reason: "Use `unfulfilledOriginalTotalSet` instead") 11444 11445 """ 11446 The total value before discount of all unfulfilled units in shop and presentment currencies. 11447 """ 11448 unfulfilledOriginalTotalSet: MoneyBag! 11449 11450 """The number of units not yet fulfilled.""" 11451 unfulfilledQuantity: Int! 11452 11453 """The Variant object associated with this line item.""" 11454 variant: ProductVariant 11455 11456 """Name of the variant.""" 11457 variantTitle: String 11458 11459 """Name of the vendor who made the variant.""" 11460 vendor: String 11461 } 11462 11463 """ 11464 An auto-generated type for paginating through multiple LineItemMutables. 11465 11466 """ 11467 type LineItemMutableConnection { 11468 """A list of edges.""" 11469 edges: [LineItemMutableEdge!]! 11470 11471 """Information to aid in pagination.""" 11472 pageInfo: PageInfo! 11473 } 11474 11475 """ 11476 An auto-generated type which holds one LineItemMutable and a cursor during pagination. 11477 11478 """ 11479 type LineItemMutableEdge { 11480 """A cursor for use in pagination.""" 11481 cursor: String! 11482 11483 """The item at the end of LineItemMutableEdge.""" 11484 node: LineItemMutable! 11485 } 11486 11487 """Represents the selling plan for a line item.""" 11488 type LineItemSellingPlan { 11489 """The name of the selling plan for display purposes.""" 11490 name: String! 11491 } 11492 11493 """A link to direct users to.""" 11494 type Link implements HasPublishedTranslations { 11495 """A context-sensitive label for the link.""" 11496 label: String! 11497 11498 """The translations associated with the resource.""" 11499 translations( 11500 """Filters translations locale.""" 11501 locale: String! 11502 ): [PublishedTranslation!]! 11503 11504 """The URL that the link visits.""" 11505 url: URL! 11506 } 11507 11508 """A locale.""" 11509 type Locale { 11510 """Locale ISO code.""" 11511 isoCode: String! 11512 11513 """Locale name.""" 11514 name: String! 11515 } 11516 11517 """ 11518 Represents the value captured by a localization extension, like a tax id. 11519 """ 11520 type LocalizationExtension { 11521 """Country ISO 3166-1 alpha-2 code.""" 11522 countryCode: CountryCode! 11523 11524 """The localized extension keys that are allowed.""" 11525 key: LocalizationExtensionKey! 11526 11527 """The purpose of this localization extension.""" 11528 purpose: LocalizationExtensionPurpose! 11529 11530 """The localized extension title.""" 11531 title: String! 11532 11533 """The value of the field.""" 11534 value: String! 11535 } 11536 11537 """ 11538 An auto-generated type for paginating through multiple LocalizationExtensions. 11539 11540 """ 11541 type LocalizationExtensionConnection { 11542 """A list of edges.""" 11543 edges: [LocalizationExtensionEdge!]! 11544 11545 """Information to aid in pagination.""" 11546 pageInfo: PageInfo! 11547 } 11548 11549 """ 11550 An auto-generated type which holds one LocalizationExtension and a cursor during pagination. 11551 11552 """ 11553 type LocalizationExtensionEdge { 11554 """A cursor for use in pagination.""" 11555 cursor: String! 11556 11557 """The item at the end of LocalizationExtensionEdge.""" 11558 node: LocalizationExtension! 11559 } 11560 11561 """ 11562 Specifies the input fields for a LocalizationExtensionInput. 11563 11564 """ 11565 input LocalizationExtensionInput { 11566 """The key for the localization extension.""" 11567 key: LocalizationExtensionKey! 11568 11569 """The localization extension value.""" 11570 value: String! 11571 } 11572 11573 """The key of a localization extension.""" 11574 enum LocalizationExtensionKey { 11575 """Extension key 'tax_credential_br' for country BR.""" 11576 TAX_CREDENTIAL_BR 11577 11578 """Extension key 'shipping_credential_br' for country BR.""" 11579 SHIPPING_CREDENTIAL_BR 11580 11581 """Extension key 'shipping_credential_cn' for country CN.""" 11582 SHIPPING_CREDENTIAL_CN 11583 11584 """Extension key 'tax_credential_it' for country IT.""" 11585 TAX_CREDENTIAL_IT 11586 11587 """Extension key 'tax_email_it' for country IT.""" 11588 TAX_EMAIL_IT 11589 11590 """Extension key 'shipping_credential_kr' for country KR.""" 11591 SHIPPING_CREDENTIAL_KR 11592 } 11593 11594 """The purpose of a localization extension.""" 11595 enum LocalizationExtensionPurpose { 11596 """ 11597 Extensions that are used for shipping purposes, for example, customs clearance. 11598 """ 11599 SHIPPING 11600 11601 """Extensions that are used for taxes purposes, for example, invoicing.""" 11602 TAX 11603 } 11604 11605 """ 11606 Represents the location where the physical good resides. 11607 11608 """ 11609 type Location implements Node & LegacyInteroperability { 11610 """Whether this location can be reactivated.""" 11611 activatable: Boolean! 11612 11613 """The LocationAddress object for location.""" 11614 address: LocationAddress! 11615 11616 """Whether the location address has been verified.""" 11617 addressVerified: Boolean! 11618 11619 """Whether this location can be deactivated.""" 11620 deactivatable: Boolean! 11621 11622 """ 11623 Date and time the location was deactivated (null if location is still active). Following UTC ISO8601 format, e.g.: "2019-04-24T13:42:24Z". 11624 """ 11625 deactivatedAt: String 11626 11627 """Whether this location can be deleted.""" 11628 deletable: Boolean! 11629 11630 """Name of the service provider that fulfills from this location.""" 11631 fulfillmentService: FulfillmentService 11632 11633 """Indicates whether this location can fulfill online orders.""" 11634 fulfillsOnlineOrders: Boolean! 11635 11636 """Indicates whether or not this location has active inventory.""" 11637 hasActiveInventory: Boolean! 11638 11639 """Indicates whether or not this location has unfulfilled orders.""" 11640 hasUnfulfilledOrders: Boolean! 11641 11642 """Globally unique identifier.""" 11643 id: ID! 11644 11645 """A single inventory level for the given inventory item.""" 11646 inventoryLevel( 11647 """ 11648 Specifies the inventory item ID for the inventory level to be returned. 11649 """ 11650 inventoryItemId: ID! 11651 ): InventoryLevel 11652 11653 """ 11654 Paginated list of inventory levels for inventory items stocked at the location. 11655 """ 11656 inventoryLevels( 11657 """Returns up to the first `n` elements from the list.""" 11658 first: Int 11659 11660 """Returns the elements that come after the specified cursor.""" 11661 after: String 11662 11663 """Returns up to the last `n` elements from the list.""" 11664 last: Int 11665 11666 """Returns the elements that come before the specified cursor.""" 11667 before: String 11668 11669 """Reverse the order of the underlying list.""" 11670 reverse: Boolean = false 11671 11672 """ 11673 Supported filter parameters: 11674 - `created_at` 11675 - `inventory_group_id` 11676 - `inventory_item_id` 11677 - `updated_at` 11678 11679 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 11680 for more information about using filters. 11681 11682 """ 11683 query: String 11684 ): InventoryLevelConnection! 11685 11686 """Whether the location is active.""" 11687 isActive: Boolean! 11688 11689 """Whether the location is your primary location for shipping inventory.""" 11690 isPrimary: Boolean! @deprecated(reason: "The concept of a primary location is deprecated, shipsInventory can be used to get a fallback location") 11691 11692 """The ID of the corresponding resource in the REST Admin API.""" 11693 legacyResourceId: UnsignedInt64! 11694 11695 """The name of the location.""" 11696 name: String! 11697 11698 """ 11699 Indicates whether or not this location is used for calculating shipping rates. 11700 """ 11701 shipsInventory: Boolean! 11702 11703 """List of suggested addresses for this location (empty if none).""" 11704 suggestedAddresses: [LocationSuggestedAddress!]! 11705 } 11706 11707 """ 11708 Represents the address of the location. 11709 11710 """ 11711 type LocationAddress { 11712 """The first line of the address for the location.""" 11713 address1: String 11714 11715 """The second line of the address for the location.""" 11716 address2: String 11717 11718 """The city of the location.""" 11719 city: String 11720 11721 """The country of the location.""" 11722 country: String 11723 11724 """The two-letter country code of the location.""" 11725 countryCode: String 11726 11727 """A formatted version of the location address.""" 11728 formatted: [String!]! 11729 11730 """The latitude coordinates of the location.""" 11731 latitude: Float 11732 11733 """The longitude coordinates of the location.""" 11734 longitude: Float 11735 11736 """The phone number of the location.""" 11737 phone: String 11738 11739 """The province of the location.""" 11740 province: String 11741 11742 """ 11743 The code for the region of the address, such as the province, state, or district. 11744 For example QC for Quebec, Canada. 11745 11746 """ 11747 provinceCode: String 11748 11749 """The ZIP code of the location.""" 11750 zip: String 11751 } 11752 11753 """ 11754 An auto-generated type for paginating through multiple Locations. 11755 11756 """ 11757 type LocationConnection { 11758 """A list of edges.""" 11759 edges: [LocationEdge!]! 11760 11761 """Information to aid in pagination.""" 11762 pageInfo: PageInfo! 11763 } 11764 11765 """ 11766 An auto-generated type which holds one Location and a cursor during pagination. 11767 11768 """ 11769 type LocationEdge { 11770 """A cursor for use in pagination.""" 11771 cursor: String! 11772 11773 """The item at the end of LocationEdge.""" 11774 node: Location! 11775 } 11776 11777 """The set of valid sort keys for the Location query.""" 11778 enum LocationSortKeys { 11779 """Sort by the `name` value.""" 11780 NAME 11781 11782 """Sort by the `id` value.""" 11783 ID 11784 11785 """ 11786 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 11787 results by relevance to the search term(s). When no search query is specified, this sort key is not 11788 deterministic and should not be used. 11789 11790 """ 11791 RELEVANCE 11792 } 11793 11794 """ 11795 Represents a suggested address for a location. 11796 11797 """ 11798 type LocationSuggestedAddress { 11799 """The first line of the suggested address.""" 11800 address1: String 11801 11802 """The second line of the suggested address.""" 11803 address2: String 11804 11805 """The city of the suggested address.""" 11806 city: String 11807 11808 """The country of the suggested address.""" 11809 country: String 11810 11811 """The country code of the suggested address.""" 11812 countryCode: CountryCode 11813 11814 """A formatted version of the suggested address.""" 11815 formatted: [String!]! 11816 11817 """The province of the suggested address.""" 11818 province: String 11819 11820 """The province code of the suggested address.""" 11821 provinceCode: String 11822 11823 """The ZIP code of the suggested address.""" 11824 zip: String 11825 } 11826 11827 """ 11828 Represents a customer mailing address. 11829 11830 For example, a customer's default address and an order's billing address are both mailling addresses. 11831 11832 """ 11833 type MailingAddress implements Node { 11834 """ 11835 The first line of the address. Typically the street address or PO Box number. 11836 11837 """ 11838 address1: String 11839 11840 """ 11841 The second line of the address. Typically the number of the apartment, suite, or unit. 11842 11843 """ 11844 address2: String 11845 11846 """ 11847 The name of the city, district, village, or town. 11848 11849 """ 11850 city: String 11851 11852 """ 11853 The name of the customer's company or organization. 11854 11855 """ 11856 company: String 11857 11858 """ 11859 The name of the country. 11860 11861 """ 11862 country: String 11863 11864 """ 11865 The two-letter code for the country of the address. 11866 11867 For example, US. 11868 11869 """ 11870 countryCode: String @deprecated(reason: "Use `countryCodeV2` instead") 11871 11872 """ 11873 The two-letter code for the country of the address. 11874 11875 For example, US. 11876 11877 """ 11878 countryCodeV2: CountryCode 11879 11880 """The first name of the customer.""" 11881 firstName: String 11882 11883 """ 11884 A formatted version of the address, customized by the provided arguments. 11885 """ 11886 formatted( 11887 """Whether to include the customer's name in the formatted address.""" 11888 withName: Boolean = false 11889 11890 """Whether to include the customer's company in the formatted address.""" 11891 withCompany: Boolean = true 11892 ): [String!]! 11893 11894 """A comma-separated list of the values for city, province, and country.""" 11895 formattedArea: String 11896 11897 """Globally unique identifier.""" 11898 id: ID! 11899 11900 """The last name of the customer.""" 11901 lastName: String 11902 11903 """The latitude coordinate of the customer address.""" 11904 latitude: Float 11905 11906 """The longitude coordinate of the customer address.""" 11907 longitude: Float 11908 11909 """ 11910 The full name of the customer, based on firstName and lastName. 11911 11912 """ 11913 name: String 11914 11915 """ 11916 A unique phone number for the customer. 11917 11918 Formatted using E.164 standard. For example, _+16135551111_. 11919 11920 """ 11921 phone: String 11922 11923 """The region of the address, such as the province, state, or district.""" 11924 province: String 11925 11926 """ 11927 The two-letter code for the region. 11928 11929 For example, ON. 11930 11931 """ 11932 provinceCode: String 11933 11934 """The zip or postal code of the address.""" 11935 zip: String 11936 } 11937 11938 """The fields used to create or update a mailing address.""" 11939 input MailingAddressInput { 11940 """ 11941 The first line of the address. Typically the street address or PO Box number. 11942 11943 """ 11944 address1: String 11945 11946 """ 11947 The second line of the address. Typically the number of the apartment, suite, or unit. 11948 11949 """ 11950 address2: String 11951 11952 """ 11953 The name of the city, district, village, or town. 11954 11955 """ 11956 city: String 11957 11958 """ 11959 The name of the customer's company or organization. 11960 11961 """ 11962 company: String 11963 11964 """ 11965 The name of the country. This argument is deprecated: Use `countryCode` instead. 11966 """ 11967 country: String 11968 11969 """The two-letter code for the country of the address.""" 11970 countryCode: CountryCode 11971 11972 """The first name of the customer.""" 11973 firstName: String 11974 11975 """ 11976 This argument is deprecated: Not needed for 90% of mutations, and provided separately where it is needed. 11977 """ 11978 id: ID 11979 11980 """The last name of the customer.""" 11981 lastName: String 11982 11983 """ 11984 A unique phone number for the customer. 11985 11986 Formatted using E.164 standard. For example, _+16135551111_. 11987 11988 """ 11989 phone: String 11990 11991 """ 11992 The region of the address, such as the province, state, or district. This argument is deprecated: Use `provinceCode` instead. 11993 """ 11994 province: String 11995 11996 """ 11997 The code for the region of the address, such as the province, state, or district. 11998 For example QC for Quebec, Canada. 11999 12000 """ 12001 provinceCode: String 12002 12003 """The zip or postal code of the address.""" 12004 zip: String 12005 } 12006 12007 """ 12008 Manual discount applications capture the intentions of a discount that was manually created for an order. 12009 12010 """ 12011 type ManualDiscountApplication implements DiscountApplication { 12012 """ 12013 The method by which the discount's value is allocated to its entitled items. 12014 """ 12015 allocationMethod: DiscountApplicationAllocationMethod! 12016 12017 """The description of the discount application.""" 12018 description: String 12019 12020 """ 12021 An ordered index that can be used to identify the discount application and indicate the precedence 12022 of the discount application for calculations. 12023 12024 """ 12025 index: Int! 12026 12027 """How the discount amount is distributed on the discounted lines.""" 12028 targetSelection: DiscountApplicationTargetSelection! 12029 12030 """Whether the discount is applied on line items or shipping lines.""" 12031 targetType: DiscountApplicationTargetType! 12032 12033 """The title of the discount application.""" 12034 title: String! 12035 12036 """The value of the discount application.""" 12037 value: PricingValue! 12038 } 12039 12040 """ 12041 A marketing activity represents marketing created by an app on behalf of the merchant. 12042 """ 12043 type MarketingActivity implements Node { 12044 """ 12045 The url of the activity listing page of this marketing activity in the marketing section. 12046 """ 12047 activityListUrl: URL 12048 12049 """Amount spent on this marketing activity.""" 12050 adSpend: MoneyV2 12051 12052 """The app which created this marketing activity.""" 12053 app: App! 12054 12055 """Errors generated when app was trying to complete this activity.""" 12056 appErrors: MarketingActivityExtensionAppErrors 12057 12058 """The budget for this marketing activity.""" 12059 budget: MarketingBudget 12060 12061 """The date and time when the marketing activity was created.""" 12062 createdAt: DateTime! 12063 12064 """The form data of the marketing activity.""" 12065 formData: String 12066 12067 """Globally unique identifier.""" 12068 id: ID! 12069 12070 """The broad category of marketing, used for reporting aggregation.""" 12071 marketingChannel: MarketingChannel! 12072 12073 """Associated marketing event of this marketing activity.""" 12074 marketingEvent: MarketingEvent 12075 12076 """ 12077 A contextual description of the marketing activity based on the platform and tactic used. 12078 """ 12079 sourceAndMedium: String! 12080 12081 """ 12082 Status helps to identify if this marketing activity has been completed, queued, failed etc. 12083 """ 12084 status: MarketingActivityStatus! 12085 12086 """StatusBadgeType helps to identify the color of the status badge.""" 12087 statusBadgeType: MarketingActivityStatusBadgeType 12088 12089 """Status label to describe the status of the marketing activity.""" 12090 statusLabel: String! 12091 12092 """ 12093 The [date and time]( 12094 https://help.shopify.com/https://en.wikipedia.org/wiki/ISO_8601 12095 ) when the activity's status last changed. 12096 """ 12097 statusTransitionedAt: DateTime 12098 12099 """The method of marketing used for this marketing activity.""" 12100 tactic: MarketingTactic! 12101 12102 """Expected status set by app in prior to an asynchronous operation.""" 12103 targetStatus: MarketingActivityStatus 12104 12105 """Title of this marketing activity.""" 12106 title: String! 12107 12108 """The date and time when the marketing activity was updated.""" 12109 updatedAt: DateTime! 12110 12111 """The set of UTM parameters being tracked for this marketing activity.""" 12112 utmParameters: UTMParameters 12113 } 12114 12115 """This type combines budget amount and its marketing budget type.""" 12116 input MarketingActivityBudgetInput { 12117 """Budget type for marketing activity.""" 12118 budgetType: MarketingBudgetBudgetType 12119 12120 """Amount of budget for the marketing activity.""" 12121 total: MoneyInput 12122 } 12123 12124 """ 12125 An auto-generated type for paginating through multiple MarketingActivities. 12126 12127 """ 12128 type MarketingActivityConnection { 12129 """A list of edges.""" 12130 edges: [MarketingActivityEdge!]! 12131 12132 """Information to aid in pagination.""" 12133 pageInfo: PageInfo! 12134 } 12135 12136 """Specifies the input fields required to create a marketing activity.""" 12137 input MarketingActivityCreateInput { 12138 """The title of the marketing activity.""" 12139 marketingActivityTitle: String 12140 12141 """The form data in JSON serialized as a string.""" 12142 formData: String 12143 12144 """The ID of the marketing activity extension.""" 12145 marketingActivityExtensionId: ID! 12146 12147 """Encoded context containing marketing campaign id.""" 12148 context: String 12149 12150 """ 12151 Specifies the 12152 [Urchin Traffic Module (UTM) parameters](https://en.wikipedia.org/wiki/UTM_parameters) 12153 that are associated with a related marketing campaign. UTMInput is required for all Marketing 12154 tactics except Storefront App. 12155 12156 """ 12157 utm: UTMInput 12158 12159 """The current state of the marketing activity.""" 12160 status: MarketingActivityStatus! 12161 12162 """The budget for this marketing activity.""" 12163 budget: MarketingActivityBudgetInput 12164 } 12165 12166 """Return type for `marketingActivityCreate` mutation.""" 12167 type MarketingActivityCreatePayload { 12168 """The created marketing activity.""" 12169 marketingActivity: MarketingActivity 12170 12171 """The path to return back to shopify admin from embedded editor.""" 12172 redirectPath: String 12173 12174 """List of errors that occurred executing the mutation.""" 12175 userErrors: [UserError!]! 12176 } 12177 12178 """ 12179 An auto-generated type which holds one MarketingActivity and a cursor during pagination. 12180 12181 """ 12182 type MarketingActivityEdge { 12183 """A cursor for use in pagination.""" 12184 cursor: String! 12185 12186 """The item at the end of MarketingActivityEdge.""" 12187 node: MarketingActivity! 12188 } 12189 12190 """ 12191 The error code resulted from the marketing activity extension integration. 12192 """ 12193 enum MarketingActivityExtensionAppErrorCode { 12194 """The shop/user must be onboarded to use the app.""" 12195 NOT_ONBOARDED_ERROR 12196 12197 """The app has returned validation errors.""" 12198 VALIDATION_ERROR 12199 12200 """The app is not responding or returning unexpected data.""" 12201 API_ERROR 12202 12203 """The app has returned an error when invoking the platform.""" 12204 PLATFORM_ERROR 12205 12206 """The app needs to be installed.""" 12207 INSTALL_REQUIRED_ERROR 12208 } 12209 12210 """ 12211 Represents errors returned from apps when using the marketing activity extension. 12212 """ 12213 type MarketingActivityExtensionAppErrors { 12214 """The app error type.""" 12215 code: MarketingActivityExtensionAppErrorCode! 12216 12217 """The list of errors returned by the app.""" 12218 userErrors: [UserError!]! 12219 } 12220 12221 """The set of valid sort keys for the MarketingActivity query.""" 12222 enum MarketingActivitySortKeys { 12223 """Sort by the `title` value.""" 12224 TITLE 12225 12226 """Sort by the `created_at` value.""" 12227 CREATED_AT 12228 12229 """Sort by the `id` value.""" 12230 ID 12231 12232 """ 12233 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 12234 results by relevance to the search term(s). When no search query is specified, this sort key is not 12235 deterministic and should not be used. 12236 12237 """ 12238 RELEVANCE 12239 } 12240 12241 """ 12242 Status helps to identify if this marketing activity has been completed, queued, failed etc. 12243 """ 12244 enum MarketingActivityStatus { 12245 """This marketing activity is currently running.""" 12246 ACTIVE 12247 12248 """This marketing activity is permanently unavailable.""" 12249 DELETED 12250 12251 """ 12252 This marketing activity was deleted and it was triggered from outside of Shopify. 12253 """ 12254 DELETED_EXTERNALLY 12255 12256 """This marketing activity is disconnected and no longer editable.""" 12257 DISCONNECTED 12258 12259 """This marketing activity is started but not yet created.""" 12260 DRAFT 12261 12262 """This marketing activity is unable to run.""" 12263 FAILED 12264 12265 """This marketing activity has completed running.""" 12266 INACTIVE 12267 12268 """This marketing activity is currently not running.""" 12269 PAUSED 12270 12271 """This marketing activity is pending creation on the app's platform.""" 12272 PENDING 12273 12274 """This marketing activity is scheduled to run.""" 12275 SCHEDULED 12276 12277 """There is no defined status for external marketing activities.""" 12278 UNDEFINED 12279 } 12280 12281 """StatusBadgeType helps to identify the color of the status badge.""" 12282 enum MarketingActivityStatusBadgeType { 12283 """This status badge has type default.""" 12284 DEFAULT 12285 12286 """This status badge has type success.""" 12287 SUCCESS 12288 12289 """This status badge has type attention.""" 12290 ATTENTION 12291 12292 """This status badge has type warning.""" 12293 WARNING 12294 12295 """This status badge has type info.""" 12296 INFO 12297 } 12298 12299 """Specifies the input fields required to update a marketing activity.""" 12300 input MarketingActivityUpdateInput { 12301 """The id for this marketing activity.""" 12302 id: ID! 12303 12304 """ 12305 The ID of the recommendation this marketing activity was created from, if one exists. 12306 """ 12307 marketingRecommendationId: ID 12308 12309 """The title of this marketing activity.""" 12310 title: String 12311 12312 """The budget for this marketing activity.""" 12313 budget: MarketingActivityBudgetInput 12314 12315 """ 12316 The cumulative amount spent on this marketing activity. This argument is deprecated: Use `MarketingEngagementCreate.MarketingEngagementInput.adSpend` GraphQL to send the ad spend. 12317 """ 12318 adSpend: MoneyInput 12319 12320 """The current state of the marketing activity.""" 12321 status: MarketingActivityStatus 12322 12323 """The target state of the marketing activity.""" 12324 targetStatus: MarketingActivityStatus 12325 12326 """The form data of the marketing activity.""" 12327 formData: String 12328 12329 """ 12330 Specifies the 12331 [Urchin Traffic Module (UTM) parameters](https://en.wikipedia.org/wiki/UTM_parameters) 12332 that are associated with a related marketing campaign. UTMInput is required for all Marketing 12333 tactics except Storefront App. This utm param can be only set once and never modified. 12334 12335 """ 12336 utm: UTMInput 12337 12338 """ 12339 A list of the items that were marketed in this marketing activity. Valid types for these items are: 12340 * `Product` 12341 * `Shop` (Must be your current shop). 12342 12343 """ 12344 marketedResources: [ID!] 12345 12346 """ 12347 Encoded context provided by Shopify during the update marketing activity callback. This argument is deprecated: This context is no longer needed by Shopify in the callback. 12348 """ 12349 context: String 12350 12351 """ 12352 Error messages generated when app was trying to complete this activity. 12353 """ 12354 errors: JSON 12355 } 12356 12357 """Return type for `marketingActivityUpdate` mutation.""" 12358 type MarketingActivityUpdatePayload { 12359 """The updated marketing activity.""" 12360 marketingActivity: MarketingActivity 12361 12362 """The path to return back to shopify admin from embedded editor.""" 12363 redirectPath: String 12364 12365 """List of errors that occurred executing the mutation.""" 12366 userErrors: [UserError!]! 12367 } 12368 12369 """ 12370 This type combines budget amount and its marketing budget type. 12371 12372 """ 12373 type MarketingBudget { 12374 """The budget type for a marketing activity.""" 12375 budgetType: MarketingBudgetBudgetType! 12376 12377 """The amount of budget for marketing activity.""" 12378 total: MoneyV2! 12379 } 12380 12381 """The budget type for a marketing activity.""" 12382 enum MarketingBudgetBudgetType { 12383 """A daily budget.""" 12384 DAILY 12385 12386 """A budget for the lifetime of a marketing activity.""" 12387 LIFETIME 12388 } 12389 12390 """ 12391 The available marketing channels for a marketing activity or event. A marketing channel is broad category of marketing, used for reporting aggregation. 12392 12393 """ 12394 enum MarketingChannel { 12395 """Paid search.""" 12396 SEARCH 12397 12398 """Displayed ads.""" 12399 DISPLAY 12400 12401 """Social media.""" 12402 SOCIAL 12403 12404 """Email.""" 12405 EMAIL 12406 12407 """Referral links.""" 12408 REFERRAL 12409 } 12410 12411 """ 12412 Marketing engagement represents customer activity taken on a marketing event. 12413 """ 12414 type MarketingEngagement { 12415 """ 12416 The total ad spend for the day, if the marketing event is a paid ad with a daily spend. 12417 """ 12418 adSpend: MoneyV2 12419 12420 """The total number of clicks on the marketing event for the day.""" 12421 clicksCount: Int 12422 12423 """The total number of comments for the day.""" 12424 commentsCount: Int 12425 12426 """The total number of complaints for the day.""" 12427 complaintsCount: Int 12428 12429 """The total number of fails for the day.""" 12430 failsCount: Int 12431 12432 """The total number of favorites for the day.""" 12433 favoritesCount: Int 12434 12435 """The date time at which the data was fetched.""" 12436 fetchedAt: DateTime 12437 12438 """The total number of impressions for the day.""" 12439 impressionsCount: Int 12440 12441 """ 12442 Whether the engagements are reported as lifetime values rather than daily totals. 12443 """ 12444 isCumulative: Boolean 12445 12446 """The marketing activity related to this engagement.""" 12447 marketingActivity: MarketingActivity! 12448 12449 """The date that these engagements occurred on.""" 12450 occurredOn: Date! 12451 12452 """The total number of sends for the day.""" 12453 sendsCount: Int 12454 12455 """The total number of shares for the day.""" 12456 sharesCount: Int 12457 12458 """The total number of unique clicks for the day.""" 12459 uniqueClicksCount: Int 12460 12461 """The total number of unique views for the day.""" 12462 uniqueViewsCount: Int 12463 12464 """The total number of unsubscribes for the day.""" 12465 unsubscribesCount: Int 12466 12467 """ 12468 The UTC Offset that the app is using to determine which date to allocate spend to. 12469 """ 12470 utcOffset: UtcOffset 12471 12472 """The total number of views for the day.""" 12473 viewsCount: Int 12474 } 12475 12476 """Return type for `marketingEngagementCreate` mutation.""" 12477 type MarketingEngagementCreatePayload { 12478 """The marketing engagement that was created.""" 12479 marketingEngagement: MarketingEngagement 12480 12481 """List of errors that occurred executing the mutation.""" 12482 userErrors: [UserError!]! 12483 } 12484 12485 """ 12486 This object represents marketing engagement input fields for a marketing engagement. 12487 """ 12488 input MarketingEngagementInput { 12489 """The date that these engagements occurred on.""" 12490 occurredOn: Date! 12491 12492 """The total number of impressions for the day.""" 12493 impressionsCount: Int 12494 12495 """The total number of views for the day.""" 12496 viewsCount: Int 12497 12498 """The total number of clicks on the marketing event for the day.""" 12499 clicksCount: Int 12500 12501 """The total number of shares for the day.""" 12502 sharesCount: Int 12503 12504 """The total number of favorites for the day.""" 12505 favoritesCount: Int 12506 12507 """The total number of comments for the day.""" 12508 commentsCount: Int 12509 12510 """The total number of unsubscribes for the day.""" 12511 unsubscribesCount: Int 12512 12513 """The total number of complaints for the day.""" 12514 complaintsCount: Int 12515 12516 """The total number of fails for the day.""" 12517 failsCount: Int 12518 12519 """The total number of sends for the day.""" 12520 sendsCount: Int 12521 12522 """The total number of unique views for the day.""" 12523 uniqueViewsCount: Int 12524 12525 """The total number of unique clicks for the day.""" 12526 uniqueClicksCount: Int 12527 12528 """ 12529 The total ad spend for the day, if the marketing event is a paid ad with a daily spend. 12530 """ 12531 adSpend: MoneyInput 12532 12533 """ 12534 Whether the engagements are reported as lifetime values rather than daily totals. 12535 """ 12536 isCumulative: Boolean 12537 12538 """ 12539 The UTC Offset that the app is using to determine which date to allocate spend to. 12540 """ 12541 utcOffset: UtcOffset 12542 12543 """The date time at which the data was fetched.""" 12544 fetchedAt: DateTime 12545 } 12546 12547 """Represents actions that market a merchant's store or products.""" 12548 type MarketingEvent implements Node & LegacyInteroperability { 12549 """The app that the marketing event is attributed to.""" 12550 app: App! 12551 12552 """The marketing channel used by the marketing event.""" 12553 channel: MarketingChannel 12554 12555 """A human-readable description of the marketing event.""" 12556 description: String 12557 12558 """The date and time when the marketing event ended.""" 12559 endedAt: DateTime 12560 12561 """Globally unique identifier.""" 12562 id: ID! 12563 12564 """The ID of the corresponding resource in the REST Admin API.""" 12565 legacyResourceId: UnsignedInt64! 12566 12567 """The URL where the marketing event can be managed.""" 12568 manageUrl: URL 12569 12570 """The URL where the marketing event can be previewed.""" 12571 previewUrl: URL 12572 12573 """An optional ID that helps Shopify validate engagement data.""" 12574 remoteId: String 12575 12576 """The date and time when the marketing event is scheduled to end.""" 12577 scheduledToEndAt: DateTime 12578 12579 """ 12580 Where the `MarketingEvent` occurred and what kind of content was used. 12581 Because `utmSource` and `utmMedium` are often used interchangeably, this is 12582 based on a combination of `marketingChannel`, `referringDomain`, and `type` to 12583 provide a consistent representation for any given piece of marketing 12584 regardless of the app that created it. 12585 12586 """ 12587 sourceAndMedium: String! 12588 12589 """The date and time when the marketing event started.""" 12590 startedAt: DateTime! 12591 12592 """The display text for the marketing event type.""" 12593 targetTypeDisplayText: String! @deprecated(reason: "Use `sourceAndMedium` instead") 12594 12595 """The marketing event type.""" 12596 type: MarketingTactic! 12597 12598 """The name of the marketing campaign.""" 12599 utmCampaign: String 12600 12601 """ 12602 The medium that the marketing campaign is using. Example values: `cpc`, `banner`. 12603 """ 12604 utmMedium: String 12605 12606 """ 12607 The referrer of the marketing event. Example values: `google`, `newsletter`. 12608 """ 12609 utmSource: String 12610 } 12611 12612 """ 12613 An auto-generated type for paginating through multiple MarketingEvents. 12614 12615 """ 12616 type MarketingEventConnection { 12617 """A list of edges.""" 12618 edges: [MarketingEventEdge!]! 12619 12620 """Information to aid in pagination.""" 12621 pageInfo: PageInfo! 12622 } 12623 12624 """ 12625 An auto-generated type which holds one MarketingEvent and a cursor during pagination. 12626 12627 """ 12628 type MarketingEventEdge { 12629 """A cursor for use in pagination.""" 12630 cursor: String! 12631 12632 """The item at the end of MarketingEventEdge.""" 12633 node: MarketingEvent! 12634 } 12635 12636 """The set of valid sort keys for the MarketingEvent query.""" 12637 enum MarketingEventSortKeys { 12638 """Sort by the `started_at` value.""" 12639 STARTED_AT 12640 12641 """Sort by the `id` value.""" 12642 ID 12643 12644 """ 12645 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 12646 results by relevance to the search term(s). When no search query is specified, this sort key is not 12647 deterministic and should not be used. 12648 12649 """ 12650 RELEVANCE 12651 } 12652 12653 """The available types of marketing event.""" 12654 enum MarketingTactic { 12655 """An abandoned cart recovery email.""" 12656 ABANDONED_CART 12657 12658 """An ad, such as a Facebook ad.""" 12659 AD 12660 12661 """An affiliate link.""" 12662 AFFILIATE 12663 12664 """A link.""" 12665 LINK 12666 12667 """A loyalty program.""" 12668 LOYALTY 12669 12670 """A messaging app, such as Facebook Messenger.""" 12671 MESSAGE 12672 12673 """A newsletter.""" 12674 NEWSLETTER 12675 12676 """A notification in the Shopify admin.""" 12677 NOTIFICATION 12678 12679 """A blog post.""" 12680 POST 12681 12682 """A retargeting ad.""" 12683 RETARGETING 12684 12685 """A transactional email.""" 12686 TRANSACTIONAL 12687 12688 """Search engine optimization.""" 12689 SEO 12690 12691 """A direct visit to the online store.""" 12692 DIRECT 12693 12694 """Popup on merchant's store.""" 12695 STOREFRONT_APP 12696 12697 """A display ad.""" 12698 DISPLAY @deprecated(reason: "`DISPLAY` is deprecated. Use `AD` instead.") 12699 12700 """Paid search.""" 12701 SEARCH @deprecated(reason: "`SEARCH` is deprecated. Use `AD` instead.") 12702 12703 """A follow-up email.""" 12704 FOLLOW_UP @deprecated(reason: "'FOLLOW_UP' is deprecated. Use 'TRANSACTIONAL' instead.") 12705 12706 """A promotional receipt.""" 12707 RECEIPT @deprecated(reason: "'RECEIPT' is deprecated. Use 'TRANSACTIONAL' instead.") 12708 } 12709 12710 """Represents a media interface.""" 12711 interface Media { 12712 """A word or phrase to share the nature or contents of a media.""" 12713 alt: String 12714 12715 """The media content type.""" 12716 mediaContentType: MediaContentType! 12717 12718 """Any errors which have occurred on the media.""" 12719 mediaErrors: [MediaError!]! 12720 12721 """The preview image for the media.""" 12722 preview: MediaPreviewImage 12723 12724 """Current status of the media.""" 12725 status: MediaStatus! 12726 } 12727 12728 """ 12729 An auto-generated type for paginating through multiple Media. 12730 12731 """ 12732 type MediaConnection { 12733 """A list of edges.""" 12734 edges: [MediaEdge!]! 12735 12736 """Information to aid in pagination.""" 12737 pageInfo: PageInfo! 12738 } 12739 12740 """The possible content types for a media object.""" 12741 enum MediaContentType { 12742 """A Shopify hosted video.""" 12743 VIDEO 12744 12745 """An externally hosted video.""" 12746 EXTERNAL_VIDEO 12747 12748 """A 3d model.""" 12749 MODEL_3D 12750 12751 """A Shopify hosted image.""" 12752 IMAGE 12753 } 12754 12755 """ 12756 An auto-generated type which holds one Media and a cursor during pagination. 12757 12758 """ 12759 type MediaEdge { 12760 """A cursor for use in pagination.""" 12761 cursor: String! 12762 12763 """The item at the end of MediaEdge.""" 12764 node: Media! 12765 } 12766 12767 """ 12768 Represents a media error. 12769 12770 """ 12771 type MediaError { 12772 """Code representing the type of error.""" 12773 code: MediaErrorCode! 12774 12775 """Additional details regarding the error.""" 12776 details: String 12777 12778 """Translated error message.""" 12779 message: String! 12780 } 12781 12782 """Error types for media.""" 12783 enum MediaErrorCode { 12784 """Media error has occured for unknown reason.""" 12785 UNKNOWN 12786 12787 """Media could not be processed because the signed url was invalid.""" 12788 INVALID_SIGNED_URL 12789 12790 """ 12791 Media could not be processed because the image could not be downloaded. 12792 """ 12793 IMAGE_DOWNLOAD_FAILURE 12794 12795 """Media could not be processed because the image could not be processed.""" 12796 IMAGE_PROCESSING_FAILURE 12797 12798 """ 12799 Media timed out because it is currently being modified by another operation. 12800 """ 12801 MEDIA_TIMEOUT_ERROR 12802 12803 """ 12804 Media could not be created because the external video could not be found. 12805 """ 12806 EXTERNAL_VIDEO_NOT_FOUND 12807 12808 """ 12809 Media could not be created because the external video is not listed or is private. 12810 """ 12811 EXTERNAL_VIDEO_UNLISTED 12812 12813 """ 12814 Media could not be created because the external video has an invalid aspect ratio. 12815 """ 12816 EXTERNAL_VIDEO_INVALID_ASPECT_RATIO 12817 12818 """Media could not be created because the metadata could not be read.""" 12819 VIDEO_METADATA_READ_ERROR 12820 12821 """Media could not be created because it has an invalid file type.""" 12822 VIDEO_INVALID_FILETYPE_ERROR 12823 12824 """ 12825 Media could not be created because it does not meet the minimum width requirement. 12826 """ 12827 VIDEO_MIN_WIDTH_ERROR 12828 12829 """ 12830 Media could not be created because it does not meet the maximum width requirement. 12831 """ 12832 VIDEO_MAX_WIDTH_ERROR 12833 12834 """ 12835 Media could not be created because it does not meet the minimum height requirement. 12836 """ 12837 VIDEO_MIN_HEIGHT_ERROR 12838 12839 """ 12840 Media could not be created because it does not meet the maximum height requirement. 12841 """ 12842 VIDEO_MAX_HEIGHT_ERROR 12843 12844 """ 12845 Media could not be created because it does not meet the minimum duration requirement. 12846 """ 12847 VIDEO_MIN_DURATION_ERROR 12848 12849 """ 12850 Media could not be created because it does not meet the maximum duration requirement. 12851 """ 12852 VIDEO_MAX_DURATION_ERROR 12853 12854 """Video failed validation.""" 12855 VIDEO_VALIDATION_ERROR 12856 12857 """Model failed validation.""" 12858 MODEL3D_VALIDATION_ERROR 12859 12860 """ 12861 Media could not be created because the model's thumbnail generation failed. 12862 """ 12863 MODEL3D_THUMBNAIL_GENERATION_ERROR 12864 12865 """ 12866 Media could not be created because the model can't be converted to USDZ format. 12867 """ 12868 MODEL3D_GLB_TO_USDZ_CONVERSION_ERROR 12869 12870 """Media could not be created because the model file failed processing.""" 12871 MODEL3D_GLB_OUTPUT_CREATION_ERROR 12872 12873 """ 12874 Media could not be created because the image is an unsupported file type. 12875 """ 12876 UNSUPPORTED_IMAGE_FILE_TYPE 12877 12878 """Media could not be created because the image size is too large.""" 12879 INVALID_IMAGE_FILE_SIZE 12880 } 12881 12882 """ 12883 Represents a Shopify hosted image. 12884 12885 """ 12886 type MediaImage implements Node & Media { 12887 """A word or phrase to share the nature or contents of a media.""" 12888 alt: String 12889 12890 """Globally unique identifier.""" 12891 id: ID! 12892 12893 """The image for the media.""" 12894 image: Image 12895 12896 """The media content type.""" 12897 mediaContentType: MediaContentType! 12898 12899 """Any errors which have occurred on the media.""" 12900 mediaErrors: [MediaError!]! 12901 12902 """The MIME type of the image.""" 12903 mimeType: String 12904 12905 """The preview image for the media.""" 12906 preview: MediaPreviewImage 12907 12908 """Current status of the media.""" 12909 status: MediaStatus! 12910 } 12911 12912 """Represents the preview image for a media.""" 12913 type MediaPreviewImage { 12914 """The preview image for the media.""" 12915 image: Image 12916 12917 """Current status of the preview image.""" 12918 status: MediaPreviewImageStatus! 12919 } 12920 12921 """The possible statuses for a media preview image.""" 12922 enum MediaPreviewImageStatus { 12923 """Preview image is uploaded but not yet processed.""" 12924 UPLOADED 12925 12926 """Preview image is being processed.""" 12927 PROCESSING 12928 12929 """Preview image is ready to be displayed.""" 12930 READY 12931 12932 """Preview image processing has failed.""" 12933 FAILED 12934 } 12935 12936 """The possible statuses for a media object.""" 12937 enum MediaStatus { 12938 """Media has been uploaded but not yet processed.""" 12939 UPLOADED 12940 12941 """Media is being processed.""" 12942 PROCESSING 12943 12944 """Media is ready to be displayed.""" 12945 READY 12946 12947 """Media processing has failed.""" 12948 FAILED 12949 } 12950 12951 """ 12952 Represents an error that happens during execution of a Media query or mutation. 12953 """ 12954 type MediaUserError implements DisplayableError { 12955 """Error code to uniquely identify the error.""" 12956 code: MediaUserErrorCode 12957 12958 """Path to the input field which caused the error.""" 12959 field: [String!] 12960 12961 """The error message.""" 12962 message: String! 12963 } 12964 12965 """Possible error codes that could be returned by MediaUserError.""" 12966 enum MediaUserErrorCode { 12967 """Input value is invalid.""" 12968 INVALID 12969 12970 """Input value is blank.""" 12971 BLANK 12972 12973 """Video validation failed.""" 12974 VIDEO_VALIDATION_ERROR 12975 12976 """Model validation failed.""" 12977 MODEL3D_VALIDATION_ERROR 12978 12979 """Video creation throttle was exceeded.""" 12980 VIDEO_THROTTLE_EXCEEDED 12981 12982 """Model3d creation throttle was exceeded.""" 12983 MODEL3D_THROTTLE_EXCEEDED 12984 12985 """Exceeded the limit of media per product.""" 12986 PRODUCT_MEDIA_LIMIT_EXCEEDED 12987 12988 """Exceeded the limit of media per shop.""" 12989 SHOP_MEDIA_LIMIT_EXCEEDED 12990 12991 """Product does not exist.""" 12992 PRODUCT_DOES_NOT_EXIST 12993 12994 """Media does not exist.""" 12995 MEDIA_DOES_NOT_EXIST 12996 12997 """Media does not exist on the given product.""" 12998 MEDIA_DOES_NOT_EXIST_ON_PRODUCT 12999 13000 """Only one mediaId is allowed per variant-media input pair.""" 13001 TOO_MANY_MEDIA_PER_INPUT_PAIR 13002 13003 """ 13004 Exceeded the maximum number of 100 variant-media pairs per mutation call. 13005 """ 13006 MAXIMUM_VARIANT_MEDIA_PAIRS_EXCEEDED 13007 13008 """Invalid media type.""" 13009 INVALID_MEDIA_TYPE 13010 13011 """Variant specified in more than one pair.""" 13012 PRODUCT_VARIANT_SPECIFIED_MULTIPLE_TIMES 13013 13014 """Variant does not exist on the given product.""" 13015 PRODUCT_VARIANT_DOES_NOT_EXIST_ON_PRODUCT 13016 13017 """Non-ready media are not supported.""" 13018 NON_READY_MEDIA 13019 13020 """Product variant already has attached media.""" 13021 PRODUCT_VARIANT_ALREADY_HAS_MEDIA 13022 13023 """The specified media is not attached to the specified variant.""" 13024 MEDIA_IS_NOT_ATTACHED_TO_VARIANT 13025 13026 """ 13027 Media cannot be modified. It is currently being modified by another operation. 13028 """ 13029 MEDIA_CANNOT_BE_MODIFIED 13030 } 13031 13032 """ 13033 Metafields represent custom metadata attached to a resource. Metafields can be sorted into namespaces and are 13034 composed of keys, values, and value types. 13035 13036 """ 13037 type Metafield implements Node & LegacyInteroperability { 13038 """The date and time when the metafield was created.""" 13039 createdAt: DateTime! 13040 13041 """The description of a metafield.""" 13042 description: String 13043 13044 """Globally unique identifier.""" 13045 id: ID! 13046 13047 """The key name for a metafield.""" 13048 key: String! 13049 13050 """The ID of the corresponding resource in the REST Admin API.""" 13051 legacyResourceId: UnsignedInt64! 13052 13053 """The namespace for a metafield.""" 13054 namespace: String! 13055 13056 """Owner type of a metafield visible to the Storefront API.""" 13057 ownerType: MetafieldOwnerType! 13058 13059 """The date and time when the metafield was updated.""" 13060 updatedAt: DateTime! 13061 13062 """The value of a metafield.""" 13063 value: String! 13064 13065 """Represents the metafield value type.""" 13066 valueType: MetafieldValueType! 13067 } 13068 13069 """ 13070 An auto-generated type for paginating through multiple Metafields. 13071 13072 """ 13073 type MetafieldConnection { 13074 """A list of edges.""" 13075 edges: [MetafieldEdge!]! 13076 13077 """Information to aid in pagination.""" 13078 pageInfo: PageInfo! 13079 } 13080 13081 """Specifies the input fields to delete a metafield.""" 13082 input MetafieldDeleteInput { 13083 """The ID of the metafield to delete.""" 13084 id: ID! 13085 } 13086 13087 """Return type for `metafieldDelete` mutation.""" 13088 type MetafieldDeletePayload { 13089 """The ID of the deleted metafield.""" 13090 deletedId: ID 13091 13092 """List of errors that occurred executing the mutation.""" 13093 userErrors: [UserError!]! 13094 } 13095 13096 """ 13097 An auto-generated type which holds one Metafield and a cursor during pagination. 13098 13099 """ 13100 type MetafieldEdge { 13101 """A cursor for use in pagination.""" 13102 cursor: String! 13103 13104 """The item at the end of MetafieldEdge.""" 13105 node: Metafield! 13106 } 13107 13108 """Specifies the input fields for a metafield.""" 13109 input MetafieldInput { 13110 """The description of the metafield .""" 13111 description: String 13112 13113 """The unique ID of the metafield.""" 13114 id: ID 13115 13116 """The key name of the metafield.""" 13117 key: String 13118 13119 """The namespace for a metafield.""" 13120 namespace: String 13121 13122 """The value of a metafield.""" 13123 value: String 13124 13125 """The value type of a metafield.""" 13126 valueType: MetafieldValueType 13127 } 13128 13129 """Metafield owner types.""" 13130 enum MetafieldOwnerType { 13131 """A metafield owner type.""" 13132 ARTICLE 13133 13134 """A metafield owner type.""" 13135 BLOG 13136 13137 """A metafield owner type.""" 13138 COLLECTION 13139 13140 """A metafield owner type.""" 13141 CUSTOMER 13142 13143 """A metafield owner type.""" 13144 DRAFTORDER 13145 13146 """A metafield owner type.""" 13147 ORDER 13148 13149 """A metafield owner type.""" 13150 PAGE 13151 13152 """A metafield owner type.""" 13153 PRODUCT 13154 13155 """A metafield owner type.""" 13156 PRODUCTIMAGE 13157 13158 """A metafield owner type.""" 13159 PRODUCTVARIANT 13160 13161 """A metafield owner type.""" 13162 SHOP 13163 } 13164 13165 """ 13166 Represents an allowlist record that enables a metafield to be visible to the storefront. 13167 13168 """ 13169 type MetafieldStorefrontVisibility implements Node & LegacyInteroperability { 13170 """The date and time when the allowlist record was created.""" 13171 createdAt: DateTime! 13172 13173 """Globally unique identifier.""" 13174 id: ID! 13175 13176 """Key of a metafield in the visibility allowlist.""" 13177 key: String! 13178 13179 """The ID of the corresponding resource in the REST Admin API.""" 13180 legacyResourceId: UnsignedInt64! 13181 13182 """Namespace of a metafield in the visibility allowlist.""" 13183 namespace: String! 13184 13185 """Owner type of a metafield in the visibility allowlist.""" 13186 ownerType: MetafieldOwnerType! 13187 13188 """The date and time when the allowlist record was updated.""" 13189 updatedAt: DateTime! 13190 } 13191 13192 """ 13193 An auto-generated type for paginating through multiple MetafieldStorefrontVisibilities. 13194 13195 """ 13196 type MetafieldStorefrontVisibilityConnection { 13197 """A list of edges.""" 13198 edges: [MetafieldStorefrontVisibilityEdge!]! 13199 13200 """Information to aid in pagination.""" 13201 pageInfo: PageInfo! 13202 } 13203 13204 """Return type for `metafieldStorefrontVisibilityCreate` mutation.""" 13205 type MetafieldStorefrontVisibilityCreatePayload { 13206 """The metafield storefront visibility that was created.""" 13207 metafieldStorefrontVisibility: MetafieldStorefrontVisibility 13208 13209 """List of errors that occurred executing the mutation.""" 13210 userErrors: [UserError!]! 13211 } 13212 13213 """Return type for `metafieldStorefrontVisibilityDelete` mutation.""" 13214 type MetafieldStorefrontVisibilityDeletePayload { 13215 """The ID of the deleted metafield storefront visibility.""" 13216 deletedMetafieldStorefrontVisibilityId: ID 13217 13218 """List of errors that occurred executing the mutation.""" 13219 userErrors: [UserError!]! 13220 } 13221 13222 """ 13223 An auto-generated type which holds one MetafieldStorefrontVisibility and a cursor during pagination. 13224 13225 """ 13226 type MetafieldStorefrontVisibilityEdge { 13227 """A cursor for use in pagination.""" 13228 cursor: String! 13229 13230 """The item at the end of MetafieldStorefrontVisibilityEdge.""" 13231 node: MetafieldStorefrontVisibility! 13232 } 13233 13234 """ 13235 Specifies the input fields for a MetafieldStorefrontVisibilityInput. 13236 13237 """ 13238 input MetafieldStorefrontVisibilityInput { 13239 """The namespace of the metafield to be visible to the storefront api.""" 13240 namespace: String! 13241 13242 """The key of the metafield to be visible to the storefront api.""" 13243 key: String! 13244 13245 """The core resource ( e.g.: Product ) that owns this metafield.""" 13246 ownerType: MetafieldOwnerType! 13247 } 13248 13249 """Metafield value types.""" 13250 enum MetafieldValueType { 13251 """A string.""" 13252 STRING 13253 13254 """An integer.""" 13255 INTEGER 13256 13257 """A JSON string.""" 13258 JSON_STRING 13259 } 13260 13261 """The set of valid sort keys for the MethodDefinition query.""" 13262 enum MethodDefinitionSortKeys { 13263 """Sort by the `rate_provider_type` value.""" 13264 RATE_PROVIDER_TYPE 13265 13266 """Sort by the `id` value.""" 13267 ID 13268 13269 """ 13270 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 13271 results by relevance to the search term(s). When no search query is specified, this sort key is not 13272 deterministic and should not be used. 13273 13274 """ 13275 RELEVANCE 13276 } 13277 13278 """ 13279 Represents a Shopify hosted 3D model. 13280 13281 """ 13282 type Model3d implements Node & Media { 13283 """A word or phrase to share the nature or contents of a media.""" 13284 alt: String 13285 13286 """The filename of the 3d model.""" 13287 filename: String! 13288 13289 """Globally unique identifier.""" 13290 id: ID! 13291 13292 """The media content type.""" 13293 mediaContentType: MediaContentType! 13294 13295 """Any errors which have occurred on the media.""" 13296 mediaErrors: [MediaError!]! 13297 13298 """The original source for a 3d model.""" 13299 originalSource: Model3dSource 13300 13301 """The preview image for the media.""" 13302 preview: MediaPreviewImage 13303 13304 """The sources for a 3d model.""" 13305 sources: [Model3dSource!]! 13306 13307 """Current status of the media.""" 13308 status: MediaStatus! 13309 } 13310 13311 """ 13312 Represents a source for a Shopify hosted 3d model. 13313 13314 """ 13315 type Model3dSource { 13316 """The filesize of the 3d model.""" 13317 filesize: Int! 13318 13319 """The format of the 3d model.""" 13320 format: String! 13321 13322 """The MIME type of the 3d model.""" 13323 mimeType: String! 13324 13325 """The URL of the 3d model.""" 13326 url: String! 13327 } 13328 13329 """A monetary value string. Example value: `"100.57"`.""" 13330 scalar Money 13331 13332 """ 13333 A collection of monetary values in their respective currencies. 13334 13335 """ 13336 type MoneyBag { 13337 """Amount in presentment currency.""" 13338 presentmentMoney: MoneyV2! 13339 13340 """Amount in shop currency.""" 13341 shopMoney: MoneyV2! 13342 } 13343 13344 """Specifies the fields for a monetary value with currency.""" 13345 input MoneyInput { 13346 """Decimal money amount.""" 13347 amount: Decimal! 13348 13349 """Currency of the money.""" 13350 currencyCode: CurrencyCode! 13351 } 13352 13353 """ 13354 A monetary value with currency. 13355 13356 To format currencies, combine this type's amount and currencyCode fields with your client's locale. 13357 13358 For example, in JavaScript you could use Intl.NumberFormat: 13359 13360 ```js 13361 new Intl.NumberFormat(locale, { 13362 style: 'currency', 13363 currency: currencyCode 13364 }).format(amount); 13365 ``` 13366 13367 Other formatting libraries include: 13368 13369 * iOS - [NumberFormatter](https://developer.apple.com/documentation/foundation/numberformatter) 13370 * Android - [NumberFormat](https://developer.android.com/reference/java/text/NumberFormat.html) 13371 * PHP - [NumberFormatter](http://php.net/manual/en/class.numberformatter.php) 13372 13373 For a more general solution, the [Unicode CLDR number formatting database] is available with many implementations 13374 (such as [TwitterCldr](https://github.com/twitter/twitter-cldr-rb)). 13375 13376 """ 13377 type MoneyV2 { 13378 """Decimal money amount.""" 13379 amount: Decimal! 13380 13381 """Currency of the money.""" 13382 currencyCode: CurrencyCode! 13383 } 13384 13385 """An individual move to perform of an object to a position.""" 13386 input MoveInput { 13387 """The ID of the object to be moved.""" 13388 id: ID! 13389 13390 """The new position of the object in the set, using a 0 based index.""" 13391 newPosition: UnsignedInt64! 13392 } 13393 13394 """A signed upload parameter for uploading an asset to Shopify.""" 13395 type MutationsStagedUploadTargetGenerateUploadParameter { 13396 """The upload parameter name.""" 13397 name: String! 13398 13399 """The upload parameter value.""" 13400 value: String! 13401 } 13402 13403 """ 13404 A default cursor for use in pagination. 13405 The default cursor can be used for next and previous navigation. 13406 13407 """ 13408 interface Navigable { 13409 """A default cursor for use in pagination.""" 13410 defaultCursor: String! 13411 } 13412 13413 """A navigation item, holding basic link attributes.""" 13414 type NavigationItem { 13415 """The unique identifier of the navigation item.""" 13416 id: String! 13417 13418 """The name of the navigation item.""" 13419 title: String! 13420 13421 """The URL of the page that the navigation item links to.""" 13422 url: URL! 13423 } 13424 13425 """An object with an ID to support global identification.""" 13426 interface Node { 13427 """Globally unique identifier.""" 13428 id: ID! 13429 } 13430 13431 """ 13432 Represents an article in an OnlineStoreBlog object. Articles appear in reverse chronological order, with the 13433 most recent entry at the top of the blog's page. A blog can contain any number of articles. 13434 13435 """ 13436 type OnlineStoreArticle implements Node & Navigable & HasPublishedTranslations { 13437 """A default cursor for use in pagination.""" 13438 defaultCursor: String! 13439 13440 """Globally unique identifier.""" 13441 id: ID! 13442 13443 """The translations associated with the resource.""" 13444 translations( 13445 """Filters translations locale.""" 13446 locale: String! 13447 ): [PublishedTranslation!]! 13448 } 13449 13450 """ 13451 Shopify stores come with a built-in blogging engine, allowing a shop to have one or more blogs. Blogs are meant 13452 to be used as a type of magazine or newsletter for the shop, with content that changes over time. 13453 13454 """ 13455 type OnlineStoreBlog implements Node & HasPublishedTranslations { 13456 """Globally unique identifier.""" 13457 id: ID! 13458 13459 """The translations associated with the resource.""" 13460 translations( 13461 """Filters translations locale.""" 13462 locale: String! 13463 ): [PublishedTranslation!]! 13464 } 13465 13466 """A custom page on the Online Store.""" 13467 type OnlineStorePage implements Node & Navigable & HasPublishedTranslations { 13468 """A default cursor for use in pagination.""" 13469 defaultCursor: String! 13470 13471 """Globally unique identifier.""" 13472 id: ID! 13473 13474 """The translations associated with the resource.""" 13475 translations( 13476 """Filters translations locale.""" 13477 locale: String! 13478 ): [PublishedTranslation!]! 13479 } 13480 13481 """Online Store preview URL of the object.""" 13482 interface OnlineStorePreviewable { 13483 """The online store preview URL.""" 13484 onlineStorePreviewUrl: URL 13485 } 13486 13487 """ 13488 An order represents an agreement to do business between a customer and a merchant. 13489 """ 13490 type Order implements Node & CommentEventSubject & HasMetafields & LegacyInteroperability & HasEvents & HasLocalizationExtensions { 13491 """ 13492 Generated messages that appear at the top of an order page in the Shopify admin. 13493 For example, _this is a test order_. 13494 13495 """ 13496 alerts: [ResourceAlert!]! 13497 13498 """ 13499 Mailing address provided by the customer. 13500 Not all orders have mailing addresses. 13501 13502 """ 13503 billingAddress: MailingAddress 13504 13505 """Whether the billing address matches the shipping address.""" 13506 billingAddressMatchesShippingAddress: Boolean! 13507 13508 """Whether the order can be manually marked as paid.""" 13509 canMarkAsPaid: Boolean! 13510 13511 """Whether notifications can be sent to the customer or not.""" 13512 canNotifyCustomer: Boolean! 13513 13514 """ 13515 Reason the order was canceled. 13516 Returns null if the order wasn't canceled. 13517 13518 """ 13519 cancelReason: OrderCancelReason 13520 13521 """ 13522 Date and time when the order was canceled. 13523 Returns null if the order wasn't canceled. 13524 13525 """ 13526 cancelledAt: DateTime 13527 13528 """ 13529 Whether payment for the order can be captured. 13530 Returns true when the customer's credit card has been authorized for payment and the authorization period has not expired. 13531 13532 """ 13533 capturable: Boolean! 13534 13535 """ 13536 Amount of the order-level discount (does not contain any line item discounts). 13537 """ 13538 cartDiscountAmount: Money @deprecated(reason: "Use `cartDiscountAmountSet` instead") 13539 13540 """ 13541 Amount of the order-level discount (does not contain any line item discounts) in shop and presentment currencies. 13542 """ 13543 cartDiscountAmountSet: MoneyBag 13544 13545 """Channel that created the order.""" 13546 channel: Channel @deprecated(reason: "Use `publication` instead") 13547 13548 """The ip address of the client that is associated with this order.""" 13549 clientIp: String 13550 13551 """Whether the order is closed.""" 13552 closed: Boolean! 13553 13554 """ 13555 Date and time when the order closed. 13556 If the order is not closed, then this field is null. 13557 13558 """ 13559 closedAt: DateTime 13560 13561 """Whether inventory has been reserved for the order.""" 13562 confirmed: Boolean! 13563 13564 """Date and time when the order was created in Shopify.""" 13565 createdAt: DateTime! 13566 13567 """ 13568 The currency of the store at the time of the order. 13569 If payment hasn't occurred, then this field is null. 13570 13571 """ 13572 currencyCode: CurrencyCode! 13573 13574 """ 13575 The amount of the order-level discount minus the amounts for line items that have been returned. This doesn't include line item discounts. 13576 """ 13577 currentCartDiscountAmountSet: MoneyBag! 13578 13579 """ 13580 The sum of the quantities for the line items that contribute to the order's subtotal. 13581 """ 13582 currentSubtotalLineItemsQuantity: Int! 13583 13584 """ 13585 The subtotal of line items and their discounts minus the line items that have been returned. This includes order-level discounts, unless the argument with_cart_discount is set to false. This doesn't include shipping costs and shipping discounts. Taxes are not included unless the order is a taxes-included order. 13586 """ 13587 currentSubtotalPriceSet: MoneyBag! 13588 13589 """ 13590 The taxes charged for the order minus the taxes for line items that have been returned. 13591 """ 13592 currentTaxLines: [TaxLine!]! 13593 13594 """ 13595 The total amount discounted from the order (including order-level and line item discounts) minus the amounts for items that have been returned. 13596 """ 13597 currentTotalDiscountsSet: MoneyBag! 13598 13599 """ 13600 The total amount of duties for the order. If duties aren't applicable, then this value is `null`. 13601 """ 13602 currentTotalDutiesSet: MoneyBag 13603 13604 """ 13605 The total amount of the order (including taxes and discounts) minus the amounts for line items that have been returned. 13606 """ 13607 currentTotalPriceSet: MoneyBag! 13608 13609 """ 13610 The total of all taxes applied to the order minus the taxes for line items that have been returned. 13611 """ 13612 currentTotalTaxSet: MoneyBag! 13613 13614 """ 13615 The total weight (grams) of the order minus the weights for line items that have been returned. 13616 """ 13617 currentTotalWeight: UnsignedInt64! 13618 13619 """ 13620 Custom information added to the order by your customer 13621 (Also referred to as note attributes). 13622 13623 """ 13624 customAttributes: [Attribute!]! 13625 13626 """ 13627 Unique identifier of the customer who placed the order. 13628 Not all orders have customers associated with them. 13629 13630 """ 13631 customer: Customer 13632 13633 """Whether the customer agreed to receive marketing materials.""" 13634 customerAcceptsMarketing: Boolean! 13635 13636 """ 13637 Description of the customer's experience with the store leading up to the order. 13638 13639 """ 13640 customerJourney: CustomerJourney @deprecated(reason: "Use `customerJourneySummary` instead") 13641 13642 """ 13643 Description of the customer's experience with the store leading up to the order. 13644 Loaded asynchronously, consumers should poll until the 'ready' field resolves to true. 13645 13646 """ 13647 customerJourneySummary: CustomerJourneySummary 13648 13649 """ 13650 A two-letter or three-letter language code, optionally followed by a region modifier. 13651 Example values could be 'en', 'en-CA', 'en-PIRATE'. 13652 13653 """ 13654 customerLocale: String 13655 13656 """Discounts that have been applied on the order.""" 13657 discountApplications( 13658 """Returns up to the first `n` elements from the list.""" 13659 first: Int 13660 13661 """Returns the elements that come after the specified cursor.""" 13662 after: String 13663 13664 """Returns up to the last `n` elements from the list.""" 13665 last: Int 13666 13667 """Returns the elements that come before the specified cursor.""" 13668 before: String 13669 13670 """Reverse the order of the underlying list.""" 13671 reverse: Boolean = false 13672 ): DiscountApplicationConnection! 13673 13674 """Discount code provided by the customer.""" 13675 discountCode: String 13676 13677 """Primary address of the customer, which is shown on the order.""" 13678 displayAddress: MailingAddress 13679 13680 """ 13681 Financial status of the order that can be shown to the merchant. 13682 This field does not capture all the possible details of an order's financial state and should only be used for display summary purposes. 13683 13684 """ 13685 displayFinancialStatus: OrderDisplayFinancialStatus 13686 13687 """ 13688 Fulfillment status for the order that can be shown to the merchant. 13689 This field does not capture all the possible details of an order's fulfillment state. It should only be used for display summary purposes. 13690 13691 """ 13692 displayFulfillmentStatus: OrderDisplayFulfillmentStatus! 13693 13694 """ 13695 Summary of each dispute associated with the order. Sorted in ascending (ASC) order by ID. 13696 """ 13697 disputes: [OrderDisputeSummary!]! 13698 13699 """ 13700 List of possible fulfilments that can be made for the order (includes line items that can be partially fulfilled). 13701 13702 """ 13703 draftFulfillments: [DraftFulfillment!]! 13704 13705 """Whether the order has had any edits applied or not.""" 13706 edited: Boolean! 13707 13708 """Email address provided by the customer.""" 13709 email: String 13710 13711 """List of internal events associated with the order.""" 13712 events( 13713 """Returns up to the first `n` elements from the list.""" 13714 first: Int 13715 13716 """Returns the elements that come after the specified cursor.""" 13717 after: String 13718 13719 """Returns up to the last `n` elements from the list.""" 13720 last: Int 13721 13722 """Returns the elements that come before the specified cursor.""" 13723 before: String 13724 13725 """Reverse the order of the underlying list.""" 13726 reverse: Boolean = false 13727 13728 """Sort the underlying list by the given key.""" 13729 sortKey: EventSortKeys = ID 13730 13731 """ 13732 Supported filter parameters: 13733 - `comments` 13734 - `created_at` 13735 - `subject_type` 13736 - `verb` 13737 13738 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 13739 for more information about using filters. 13740 13741 """ 13742 query: String 13743 ): EventConnection! 13744 13745 """ 13746 Whether there are items that can be fulfilled. 13747 After an order is completely fulfilled (or completely refunded without any fulfillments) then this field returns false. 13748 13749 """ 13750 fulfillable: Boolean! 13751 13752 """List of fulfillment orders with pagination.""" 13753 fulfillmentOrders( 13754 """ 13755 Whether fulfillment orders requested should be displayed to the merchant. 13756 """ 13757 displayable: Boolean = false 13758 13759 """Returns up to the first `n` elements from the list.""" 13760 first: Int 13761 13762 """Returns the elements that come after the specified cursor.""" 13763 after: String 13764 13765 """Returns up to the last `n` elements from the list.""" 13766 last: Int 13767 13768 """Returns the elements that come before the specified cursor.""" 13769 before: String 13770 13771 """Reverse the order of the underlying list.""" 13772 reverse: Boolean = false 13773 13774 """ 13775 Supported filter parameters: 13776 - `assigned_location_id` 13777 - `status` 13778 13779 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax). 13780 13781 """ 13782 query: String 13783 ): FulfillmentOrderConnection! 13784 13785 # """List of shipments for the order.""" 13786 # fulfillments( 13787 # """Truncate the array result to this size.""" 13788 # first: Int 13789 # ): [Fulfillment!]! 13790 13791 """Whether the order has been paid in full.""" 13792 fullyPaid: Boolean! 13793 13794 """Whether the merchant added timeline comments to the order.""" 13795 hasTimelineComment: Boolean! 13796 13797 """Globally unique identifier.""" 13798 id: ID! 13799 13800 """ 13801 First page of the online store that the customer visited before they submitted the order, for displaying to humans. 13802 """ 13803 landingPageDisplayText: String @deprecated(reason: "Use `customerJourneySummary.lastVisit.landingPageHtml` instead") 13804 13805 """ 13806 First page of the online store that the customer visited before they submitted the order. 13807 """ 13808 landingPageUrl: URL @deprecated(reason: "Use `customerJourneySummary.lastVisit.landingPage` instead") 13809 13810 """The ID of the corresponding resource in the REST Admin API.""" 13811 legacyResourceId: UnsignedInt64! 13812 13813 """List of the order's line items.""" 13814 lineItems( 13815 """Returns up to the first `n` elements from the list.""" 13816 first: Int 13817 13818 """Returns the elements that come after the specified cursor.""" 13819 after: String 13820 13821 """Returns up to the last `n` elements from the list.""" 13822 last: Int 13823 13824 """Returns the elements that come before the specified cursor.""" 13825 before: String 13826 13827 """Reverse the order of the underlying list.""" 13828 reverse: Boolean = false 13829 ): LineItemConnection! 13830 13831 """ 13832 List of the order's line items after any edits. Only available on Developer Preview. 13833 """ 13834 lineItemsMutable( 13835 """Returns up to the first `n` elements from the list.""" 13836 first: Int 13837 13838 """Returns the elements that come after the specified cursor.""" 13839 after: String 13840 13841 """Returns up to the last `n` elements from the list.""" 13842 last: Int 13843 13844 """Returns the elements that come before the specified cursor.""" 13845 before: String 13846 13847 """Reverse the order of the underlying list.""" 13848 reverse: Boolean = false 13849 ): LineItemMutableConnection! @deprecated(reason: "Use `lineItems` instead") 13850 13851 """List of localization extensions for the resource.""" 13852 localizationExtensions( 13853 """The country codes of the extensions.""" 13854 countryCodes: [CountryCode!] 13855 13856 """The purpose of the extensions.""" 13857 purposes: [LocalizationExtensionPurpose!] 13858 13859 """Returns up to the first `n` elements from the list.""" 13860 first: Int 13861 13862 """Returns the elements that come after the specified cursor.""" 13863 after: String 13864 13865 """Returns up to the last `n` elements from the list.""" 13866 last: Int 13867 13868 """Returns the elements that come before the specified cursor.""" 13869 before: String 13870 13871 """Reverse the order of the underlying list.""" 13872 reverse: Boolean = false 13873 ): LocalizationExtensionConnection! 13874 13875 """ 13876 If the order was processed using Shopify POS, then this is its location as provided by the merchant. 13877 13878 """ 13879 location: String @deprecated(reason: "Use `physicalLocation` instead") 13880 13881 """Whether the order can be edited or not.""" 13882 merchantEditable: Boolean! 13883 13884 """A list of reasons of why the order cannot be edited.""" 13885 merchantEditableErrors: [String!]! 13886 13887 """The metafield associated with the resource.""" 13888 metafield( 13889 """Container for a set of metafields (maximum of 20 characters).""" 13890 namespace: String! 13891 13892 """Identifier for the metafield (maximum of 30 characters).""" 13893 key: String! 13894 ): Metafield 13895 13896 """A paginated list of metafields associated with the resource.""" 13897 metafields( 13898 """Finds all metafields with a specific namespace under the resource.""" 13899 namespace: String 13900 13901 """Returns up to the first `n` elements from the list.""" 13902 first: Int 13903 13904 """Returns the elements that come after the specified cursor.""" 13905 after: String 13906 13907 """Returns up to the last `n` elements from the list.""" 13908 last: Int 13909 13910 """Returns the elements that come before the specified cursor.""" 13911 before: String 13912 13913 """Reverse the order of the underlying list.""" 13914 reverse: Boolean = false 13915 ): MetafieldConnection! 13916 13917 """ 13918 Unique identifier for the order that appears on the order. 13919 For example, _#1000_ or _Store1001. 13920 This value is not unique across multiple stores. 13921 13922 """ 13923 name: String! 13924 13925 """ 13926 Net payment for the order, based on the total amount received - total amount refunded. 13927 13928 """ 13929 netPayment: Money! @deprecated(reason: "Use `netPaymentSet` instead") 13930 13931 """ 13932 Net payment for the order, based on the total amount received - total amount refunded in shop and presentment currencies. 13933 """ 13934 netPaymentSet: MoneyBag! 13935 13936 """ 13937 Line items that can't be fulfilled. 13938 For example, because some or all of the items have been refunded, or the item is not one which can be fulfilled, such as a tip. 13939 These line items would be 'lost' if you only considered the line items in draft fulfillments or fulfillments. 13940 13941 """ 13942 nonFulfillableLineItems( 13943 """Returns up to the first `n` elements from the list.""" 13944 first: Int 13945 13946 """Returns the elements that come after the specified cursor.""" 13947 after: String 13948 13949 """Returns up to the last `n` elements from the list.""" 13950 last: Int 13951 13952 """Returns the elements that come before the specified cursor.""" 13953 before: String 13954 13955 """Reverse the order of the underlying list.""" 13956 reverse: Boolean = false 13957 ): LineItemConnection! 13958 13959 """ 13960 Contents of the note associated with the order. 13961 13962 """ 13963 note: String 13964 13965 """ 13966 The total amount of duties prior to any applied edits for the order. If duties aren't applicable, then this value is `null`. 13967 """ 13968 originalTotalDutiesSet: MoneyBag 13969 13970 """ 13971 Total price of the order prior to any applied edits in shop and presentment currencies. 13972 """ 13973 originalTotalPriceSet: MoneyBag! 13974 13975 """ 13976 The payment collection details for an order requiring additional payment. 13977 """ 13978 paymentCollectionDetails: OrderPaymentCollectionDetails! 13979 13980 """ 13981 List of all payment gateways used for the order. 13982 For example, _authorize_net_ and _Cash on Delivery (COD)_. 13983 13984 """ 13985 paymentGatewayNames: [String!]! 13986 13987 """Phone number provided by the customer.""" 13988 phone: String 13989 13990 """ 13991 If the order was processed using Shopify POS, then this is its location as provided by the merchant. 13992 13993 """ 13994 physicalLocation: Location 13995 13996 """The payment currency of the customer for this order.""" 13997 presentmentCurrencyCode: CurrencyCode! 13998 13999 """Returns a private metafield found by namespace and key.""" 14000 privateMetafield( 14001 """The namespace for the private metafield.""" 14002 namespace: String! 14003 14004 """The key for the private metafield.""" 14005 key: String! 14006 ): PrivateMetafield 14007 14008 """List of private metafields.""" 14009 privateMetafields( 14010 """Filter the private metafields by namespace.""" 14011 namespace: String 14012 14013 """Returns up to the first `n` elements from the list.""" 14014 first: Int 14015 14016 """Returns the elements that come after the specified cursor.""" 14017 after: String 14018 14019 """Returns up to the last `n` elements from the list.""" 14020 last: Int 14021 14022 """Returns the elements that come before the specified cursor.""" 14023 before: String 14024 14025 """Reverse the order of the underlying list.""" 14026 reverse: Boolean = false 14027 ): PrivateMetafieldConnection! 14028 14029 """ 14030 Date and time when the order was processed. 14031 When orders are imported from an app, this date and time may not match the date and time when the order was created. 14032 14033 """ 14034 processedAt: DateTime! 14035 14036 """Publication that created the order.""" 14037 publication: Publication 14038 14039 """ 14040 Marketing referral code from the link that the customer clicked to visit your store. 14041 Supports the following URL attributes: _ref_, _source_, or _r_. For example, if the URL is myshopifystore.com/products/slide?ref=j2tj1tn2, then this value is j2tj1tn2. 14042 14043 """ 14044 referralCode: String @deprecated(reason: "Use `customerJourneySummary.lastVisit.referralCode` instead") 14045 14046 """ 14047 Website that sent the customer to your online store. 14048 14049 """ 14050 referrerDisplayText: String @deprecated(reason: "Use `customerJourneySummary.lastVisit.referralInfoHtml` instead") 14051 14052 """ 14053 Webpage where the customer clicked a link that sent them to your online store. 14054 For example, _Google_ or _randomblog.com/page1_. 14055 14056 """ 14057 referrerUrl: URL @deprecated(reason: "Use `customerJourneySummary.lastVisit.referrerUrl` instead") 14058 14059 """ 14060 The difference between suggested and actual refund amounts. A positive value indicates a difference in the merchants favor and a negative value indicates a difference in the customers favor. 14061 """ 14062 refundDiscrepancySet: MoneyBag! 14063 14064 """ 14065 Whether the order can be refunded. 14066 14067 """ 14068 refundable: Boolean! 14069 14070 """ 14071 List of refunds that have been applied to the order. 14072 14073 """ 14074 refunds( 14075 """Truncate the array result to this size.""" 14076 first: Int 14077 ): [Refund!]! 14078 14079 """ 14080 Whether any line item in the order requires physical shipping. 14081 14082 """ 14083 requiresShipping: Boolean! 14084 14085 """ 14086 Whether the order can be restocked. 14087 14088 """ 14089 restockable: Boolean! 14090 14091 """Fraud risk level of the order.""" 14092 riskLevel: OrderRiskLevel! 14093 14094 """The order risks associated with this order.""" 14095 risks( 14096 """Truncate the array result to this size.""" 14097 first: Int 14098 ): [OrderRisk!]! 14099 14100 """Mailing address for shipping provided by the customer.""" 14101 shippingAddress: MailingAddress 14102 14103 """Line item that contains the shipping costs.""" 14104 shippingLine: ShippingLine 14105 14106 """List of line items that contains the shipping costs.""" 14107 shippingLines( 14108 """Returns up to the first `n` elements from the list.""" 14109 first: Int 14110 14111 """Returns the elements that come after the specified cursor.""" 14112 after: String 14113 14114 """Returns up to the last `n` elements from the list.""" 14115 last: Int 14116 14117 """Returns the elements that come before the specified cursor.""" 14118 before: String 14119 14120 """Reverse the order of the underlying list.""" 14121 reverse: Boolean = false 14122 ): ShippingLineConnection! 14123 14124 """ 14125 The sum of the quantities for the line items that contribute to the order's subtotal. 14126 """ 14127 subtotalLineItemsQuantity: Int! 14128 14129 """ 14130 Subtotal of the line items and their discounts (does not contain shipping costs and shipping discounts). 14131 14132 """ 14133 subtotalPrice: Money @deprecated(reason: "Use `subtotalPriceSet` instead") 14134 14135 """ 14136 Subtotal of the line items and their discounts (does not contain shipping costs and shipping discounts) in shop and presentment currencies. 14137 """ 14138 subtotalPriceSet: MoneyBag 14139 14140 """ 14141 The details of the suggested refund. This response can be used to submit a RefundCreate mutation. 14142 """ 14143 suggestedRefund( 14144 """The amount to refund for shipping. Overrides `refundShipping`.""" 14145 shippingAmount: Money 14146 14147 """Whether to refund the full shipping amount.""" 14148 refundShipping: Boolean 14149 14150 """The line items from the order to include in the refund.""" 14151 refundLineItems: [RefundLineItemInput!] 14152 14153 """The duties from the order to include in the refund.""" 14154 refundDuties: [RefundDutyInput!] 14155 14156 """ 14157 Whether a refund for all of the refundable line items on an order should be suggested. 14158 If `true`, the suggested refund will be formed from all refundable line items and will 14159 ignore any passed in `refundLineItems`. 14160 14161 """ 14162 suggestFullRefund: Boolean = false 14163 ): SuggestedRefund 14164 14165 """A comma separated list of tags that have been added to the order.""" 14166 tags: [String!]! 14167 14168 """Taxes charged for the line item.""" 14169 taxLines: [TaxLine!]! 14170 14171 """Whether taxes are included in the subtotal price of the order.""" 14172 taxesIncluded: Boolean! 14173 14174 """ 14175 Whether the order is a test. 14176 Test orders are made using the Shopify Bogus Gateway or a payment provider with test mode enabled. 14177 14178 """ 14179 test: Boolean! 14180 14181 """Amount authorized for the order, that is uncaptured or undercaptured.""" 14182 totalCapturable: Money! @deprecated(reason: "Use `totalCapturableSet` instead") 14183 14184 """ 14185 Amount authorized for the order, that is uncaptured or undercaptured in shop and presentment currencies. 14186 """ 14187 totalCapturableSet: MoneyBag! 14188 14189 """ 14190 Total amount discounted from the order (includes order-level and line item discounts). 14191 """ 14192 totalDiscounts: Money @deprecated(reason: "Use `totalDiscountsSet` instead") 14193 14194 """ 14195 Total amount discounted from the order (includes order-level and line item discounts) in shop and presentment currencies. 14196 """ 14197 totalDiscountsSet: MoneyBag 14198 14199 """Total amount of money not yet authorized for the order.""" 14200 totalOutstandingSet: MoneyBag! 14201 14202 """Total amount of the order (includes taxes and discounts).""" 14203 totalPrice: Money! @deprecated(reason: "Use `totalPriceSet` instead") 14204 14205 """ 14206 Total amount of the order (includes taxes and discounts) in shop and presentment currencies. 14207 """ 14208 totalPriceSet: MoneyBag! 14209 14210 """Total amount received by the customer for the order.""" 14211 totalReceived: Money! @deprecated(reason: "Use `totalReceivedSet` instead") 14212 14213 """ 14214 Total amount received by the customer for the order in shop and presentment currencies. 14215 """ 14216 totalReceivedSet: MoneyBag! 14217 14218 """Total amount refunded for the order.""" 14219 totalRefunded: Money! @deprecated(reason: "Use `totalRefundedSet` instead") 14220 14221 """ 14222 Total amount refunded for the order in shop and presentment currencies. 14223 """ 14224 totalRefundedSet: MoneyBag! 14225 14226 """Total amount refunded for shipping in shop and presentment currencies.""" 14227 totalRefundedShippingSet: MoneyBag! 14228 14229 """Total amount charged for shipping the order.""" 14230 totalShippingPrice: Money! @deprecated(reason: "Use `totalShippingPriceSet` instead") 14231 14232 """ 14233 Total amount charged for shipping the order in shop and presentment currencies. 14234 """ 14235 totalShippingPriceSet: MoneyBag! 14236 14237 """Total of all taxes applied to the order.""" 14238 totalTax: Money @deprecated(reason: "Use `totalTaxSet` instead") 14239 14240 """ 14241 Total of all taxes applied to the order in shop and presentment currencies. 14242 """ 14243 totalTaxSet: MoneyBag 14244 14245 """Total tip amount received for the order.""" 14246 totalTipReceived: MoneyV2! @deprecated(reason: "Use `totalTipReceivedSet` instead") 14247 14248 """Total tip received for the order in shop and presentment currencies.""" 14249 totalTipReceivedSet: MoneyBag! 14250 14251 """Total weight (grams) of the order.""" 14252 totalWeight: UnsignedInt64 14253 14254 """List of all transactions associated with the order.""" 14255 transactions( 14256 """Truncate the array result to this size.""" 14257 first: Int 14258 14259 """ 14260 Filter transactions by whether they are capturable. 14261 If true, then returns only transactions that represent an authorized payment that can be captured. 14262 If false, then returns all transactions. 14263 14264 """ 14265 capturable: Boolean 14266 14267 """ 14268 Filter transactions by whether they are manual payments. 14269 If true, then returns only transactions that are manual payments. If false, then returns all transactions. 14270 14271 """ 14272 manuallyResolvable: Boolean 14273 ): [OrderTransaction!]! 14274 14275 """ 14276 Whether no payments have been made for the order. 14277 If no payments have been made for the order, then this returns true. 14278 14279 """ 14280 unpaid: Boolean! 14281 14282 """Date and time when the order was last modified.""" 14283 updatedAt: DateTime! 14284 } 14285 14286 """ 14287 Represents the reason that the order is being canceled. Valid values are: customer, fraud, inventory, declined, other. 14288 """ 14289 enum OrderCancelReason { 14290 """The customer wanted to cancel the order.""" 14291 CUSTOMER 14292 14293 """The order was fraudulent.""" 14294 FRAUD 14295 14296 """There was insufficient inventory.""" 14297 INVENTORY 14298 14299 """Payment was declined.""" 14300 DECLINED 14301 14302 """Some other reason not listed.""" 14303 OTHER 14304 } 14305 14306 """ 14307 Specifies the authorized transaction to capture and the total amount to capture from it. 14308 """ 14309 input OrderCaptureInput { 14310 """The ID of the order to capture.""" 14311 id: ID! 14312 14313 """The ID of the authorized transaction to capture.""" 14314 parentTransactionId: ID! 14315 14316 """The amount to capture.""" 14317 amount: Money! 14318 14319 """ 14320 The currency (in ISO format) that is used to capture the order. This must be the presentment currency (the currency used by the customer) and is a required field for orders where the currency and presentment currency differ. 14321 """ 14322 currency: CurrencyCode 14323 } 14324 14325 """Return type for `orderCapture` mutation.""" 14326 type OrderCapturePayload { 14327 """The transaction of the capture.""" 14328 transaction: OrderTransaction 14329 14330 """List of errors that occurred executing the mutation.""" 14331 userErrors: [UserError!]! 14332 } 14333 14334 """Specifies an open order to close.""" 14335 input OrderCloseInput { 14336 """The ID of the order to close.""" 14337 id: ID! 14338 } 14339 14340 """Return type for `orderClose` mutation.""" 14341 type OrderClosePayload { 14342 """The closed order.""" 14343 order: Order 14344 14345 """List of errors that occurred executing the mutation.""" 14346 userErrors: [UserError!]! 14347 } 14348 14349 """ 14350 An auto-generated type for paginating through multiple Orders. 14351 14352 """ 14353 type OrderConnection { 14354 """A list of edges.""" 14355 edges: [OrderEdge!]! 14356 14357 """Information to aid in pagination.""" 14358 pageInfo: PageInfo! 14359 } 14360 14361 """Represents the order's current financial status.""" 14362 enum OrderDisplayFinancialStatus { 14363 """Displayed as **Pending**.""" 14364 PENDING 14365 14366 """Displayed as **Authorized**.""" 14367 AUTHORIZED 14368 14369 """Displayed as **Partially paid**.""" 14370 PARTIALLY_PAID 14371 14372 """Displayed as **Partially refunded**.""" 14373 PARTIALLY_REFUNDED 14374 14375 """Displayed as **Voided**.""" 14376 VOIDED 14377 14378 """Displayed as **Paid**.""" 14379 PAID 14380 14381 """Displayed as **Refunded**.""" 14382 REFUNDED 14383 14384 """Displayed as **Expired**.""" 14385 EXPIRED 14386 } 14387 14388 """ 14389 Represents the order's current fulfillment status. Valid values are: unfulfilled, partial, fulfilled, restocked. 14390 """ 14391 enum OrderDisplayFulfillmentStatus { 14392 """Displayed as **Unfulfilled**.""" 14393 UNFULFILLED 14394 14395 """Displayed as **Partially fulfilled**.""" 14396 PARTIALLY_FULFILLED 14397 14398 """Displayed as **Fulfilled**.""" 14399 FULFILLED 14400 14401 """Displayed as **Restocked**.""" 14402 RESTOCKED 14403 14404 """Displayed as **Pending fulfillment**.""" 14405 PENDING_FULFILLMENT 14406 14407 """Displayed as **Open**.""" 14408 OPEN 14409 14410 """Displayed as **In progress**.""" 14411 IN_PROGRESS 14412 14413 """Displayed as **Scheduled**.""" 14414 SCHEDULED 14415 } 14416 14417 """A summary of the important details for a dispute on an order.""" 14418 type OrderDisputeSummary implements Node { 14419 """Globally unique identifier.""" 14420 id: ID! 14421 14422 """The type that the dispute was initiated as.""" 14423 initiatedAs: DisputeType! 14424 14425 """The current status of the dispute.""" 14426 status: DisputeStatus! 14427 } 14428 14429 """ 14430 An auto-generated type which holds one Order and a cursor during pagination. 14431 14432 """ 14433 type OrderEdge { 14434 """A cursor for use in pagination.""" 14435 cursor: String! 14436 14437 """The item at the end of OrderEdge.""" 14438 node: Order! 14439 } 14440 14441 """Return type for `orderEditAddCustomItem` mutation.""" 14442 type OrderEditAddCustomItemPayload { 14443 """The added line item.""" 14444 calculatedLineItem: CalculatedLineItem 14445 14446 """An order with the edits calculated.""" 14447 calculatedOrder: CalculatedOrder 14448 14449 """List of errors that occurred executing the mutation.""" 14450 userErrors: [UserError!]! 14451 } 14452 14453 """Return type for `orderEditAddLineItemDiscount` mutation.""" 14454 type OrderEditAddLineItemDiscountPayload { 14455 """The staged change produced by this mutation.""" 14456 addedDiscountStagedChange: OrderStagedChangeAddLineItemDiscount 14457 14458 """The line item with the discount applied.""" 14459 calculatedLineItem: CalculatedLineItem 14460 14461 """An order with the edits calculated.""" 14462 calculatedOrder: CalculatedOrder 14463 14464 """List of errors that occurred executing the mutation.""" 14465 userErrors: [UserError!]! 14466 } 14467 14468 """Return type for `orderEditAddVariant` mutation.""" 14469 type OrderEditAddVariantPayload { 14470 """The added line item.""" 14471 calculatedLineItem: CalculatedLineItem 14472 14473 """An order with the edits calculated.""" 14474 calculatedOrder: CalculatedOrder 14475 14476 """List of errors that occurred executing the mutation.""" 14477 userErrors: [UserError!]! 14478 } 14479 14480 """The input fields used to add a discount during an order edit.""" 14481 input OrderEditAppliedDiscountInput { 14482 """The description of the discount.""" 14483 description: String 14484 14485 """The value of the discount as a fixed amount.""" 14486 fixedValue: MoneyInput 14487 14488 """The value of the discount as a percentage.""" 14489 percentValue: Float 14490 } 14491 14492 """Return type for `orderEditBegin` mutation.""" 14493 type OrderEditBeginPayload { 14494 """The order that will be edited.""" 14495 calculatedOrder: CalculatedOrder 14496 14497 """List of errors that occurred executing the mutation.""" 14498 userErrors: [UserError!]! 14499 } 14500 14501 """Return type for `orderEditCommit` mutation.""" 14502 type OrderEditCommitPayload { 14503 """The order with changes applied.""" 14504 order: Order 14505 14506 """List of errors that occurred executing the mutation.""" 14507 userErrors: [UserError!]! 14508 } 14509 14510 """Return type for `orderEditRemoveLineItemDiscount` mutation.""" 14511 type OrderEditRemoveLineItemDiscountPayload { 14512 """The line item with the discount removed.""" 14513 calculatedLineItem: CalculatedLineItem 14514 14515 """An order with the edits calculated.""" 14516 calculatedOrder: CalculatedOrder 14517 14518 """List of errors that occurred executing the mutation.""" 14519 userErrors: [UserError!]! 14520 } 14521 14522 """Return type for `orderEditSetQuantity` mutation.""" 14523 type OrderEditSetQuantityPayload { 14524 """The line item with changes calculated.""" 14525 calculatedLineItem: CalculatedLineItem 14526 14527 """An order with the edits calculated.""" 14528 calculatedOrder: CalculatedOrder 14529 14530 """List of errors that occurred executing the mutation.""" 14531 userErrors: [UserError!]! 14532 } 14533 14534 """Specifies the information to be updated on the requested order.""" 14535 input OrderInput { 14536 """The email address associated with the order.""" 14537 email: String 14538 14539 """The ID of the order to update.""" 14540 id: ID! 14541 14542 """The order note.""" 14543 note: String 14544 14545 """A comma separated list of tags that have been added to the order.""" 14546 tags: [String!] 14547 14548 """The shipping address associated with the order.""" 14549 shippingAddress: MailingAddressInput 14550 14551 """ 14552 Custom information to add to the order, represented as a key value pair. Also referred to as note attributes. 14553 14554 """ 14555 customAttributes: [AttributeInput!] 14556 14557 """The metafields to associate with this order.""" 14558 metafields: [MetafieldInput!] 14559 14560 """ 14561 The localization extensions attached to the order. For example, Tax IDs. 14562 """ 14563 localizationExtensions: [LocalizationExtensionInput!] 14564 } 14565 14566 """Specifies the order to mark as paid.""" 14567 input OrderMarkAsPaidInput { 14568 """The ID of the order to mark as paid.""" 14569 id: ID! 14570 } 14571 14572 """Return type for `orderMarkAsPaid` mutation.""" 14573 type OrderMarkAsPaidPayload { 14574 """The order marked as paid.""" 14575 order: Order 14576 14577 """List of errors that occurred executing the mutation.""" 14578 userErrors: [UserError!]! 14579 } 14580 14581 """Specifies a closed order to open.""" 14582 input OrderOpenInput { 14583 """The ID of the order to open.""" 14584 id: ID! 14585 } 14586 14587 """Return type for `orderOpen` mutation.""" 14588 type OrderOpenPayload { 14589 """The opened order.""" 14590 order: Order 14591 14592 """List of errors that occurred executing the mutation.""" 14593 userErrors: [UserError!]! 14594 } 14595 14596 """ 14597 The payment collection details for an order requiring additional payment. 14598 """ 14599 type OrderPaymentCollectionDetails { 14600 """URL allowing additional payments to be collected on the order.""" 14601 additionalPaymentCollectionUrl: URL 14602 } 14603 14604 """Represents a fraud check on an order.""" 14605 type OrderRisk { 14606 """ 14607 Whether the risk level is shown in the Shopify admin. If false, then this order risk is ignored when Shopify determines the overall risk level for the order. 14608 """ 14609 display: Boolean! 14610 14611 """ 14612 The likelihood that an order is fraudulent, based on this order risk. 14613 14614 The level can be set by Shopify risk analysis or by an app. 14615 14616 """ 14617 level: OrderRiskLevel 14618 14619 """The risk message that's shown to the merchant in the Shopify admin.""" 14620 message: String 14621 } 14622 14623 """The likelihood that an order is fraudulent.""" 14624 enum OrderRiskLevel { 14625 """There is a low level of risk that this order is fraudulent.""" 14626 LOW 14627 14628 """There is a medium level of risk that this order is fraudulent.""" 14629 MEDIUM 14630 14631 """There is a high level of risk that this order is fraudulent.""" 14632 HIGH 14633 } 14634 14635 """The set of valid sort keys for the Order query.""" 14636 enum OrderSortKeys { 14637 """Sort by the `created_at` value.""" 14638 CREATED_AT 14639 14640 """Sort by the `customer_name` value.""" 14641 CUSTOMER_NAME 14642 14643 """Sort by the `financial_status` value.""" 14644 FINANCIAL_STATUS 14645 14646 """Sort by the `fulfillment_status` value.""" 14647 FULFILLMENT_STATUS 14648 14649 """Sort by the `order_number` value.""" 14650 ORDER_NUMBER 14651 14652 """Sort by the `processed_at` value.""" 14653 PROCESSED_AT 14654 14655 """Sort by the `total_price` value.""" 14656 TOTAL_PRICE 14657 14658 """Sort by the `updated_at` value.""" 14659 UPDATED_AT 14660 14661 """Sort by the `id` value.""" 14662 ID 14663 14664 """ 14665 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 14666 results by relevance to the search term(s). When no search query is specified, this sort key is not 14667 deterministic and should not be used. 14668 14669 """ 14670 RELEVANCE 14671 } 14672 14673 """ 14674 A change that has been applied to an order. 14675 14676 """ 14677 union OrderStagedChange = OrderStagedChangeAddCustomItem | OrderStagedChangeAddLineItemDiscount | OrderStagedChangeAddShippingLine | OrderStagedChangeAddVariant | OrderStagedChangeDecrementItem | OrderStagedChangeIncrementItem 14678 14679 """ 14680 A newly created custom item. 14681 14682 """ 14683 type OrderStagedChangeAddCustomItem { 14684 """The price of an individual item without any discounts applied.""" 14685 originalUnitPrice: MoneyV2! 14686 14687 """The number of items.""" 14688 quantity: Int! 14689 14690 """The title of the item.""" 14691 title: String! 14692 } 14693 14694 """ 14695 A discount application added as part of an order edit. 14696 14697 """ 14698 type OrderStagedChangeAddLineItemDiscount { 14699 """The description of the discount.""" 14700 description: String! 14701 14702 """A globally unique identifier.""" 14703 id: ID! 14704 14705 """The amount of the discount.""" 14706 value: PricingValue! 14707 } 14708 14709 """ 14710 A new shipping line added as part of an order edit. 14711 14712 """ 14713 type OrderStagedChangeAddShippingLine { 14714 """Shipping line phone number.""" 14715 phone: String 14716 14717 """The presentment title of the shipping line.""" 14718 presentmentTitle: String 14719 14720 """Price of shipping line.""" 14721 price: MoneyV2! 14722 14723 """The title of the shipping line.""" 14724 title: String 14725 } 14726 14727 """ 14728 A new item created from an existing product variant. 14729 14730 """ 14731 type OrderStagedChangeAddVariant { 14732 """The number of items.""" 14733 quantity: Int! 14734 14735 """The product variant of the added item.""" 14736 variant: ProductVariant! 14737 } 14738 14739 """ 14740 An auto-generated type for paginating through multiple OrderStagedChanges. 14741 14742 """ 14743 type OrderStagedChangeConnection { 14744 """A list of edges.""" 14745 edges: [OrderStagedChangeEdge!]! 14746 14747 """Information to aid in pagination.""" 14748 pageInfo: PageInfo! 14749 } 14750 14751 """ 14752 An removal of items from an existing line item on the order. 14753 14754 """ 14755 type OrderStagedChangeDecrementItem { 14756 """The number of items removed.""" 14757 delta: Int! 14758 14759 """The original line item.""" 14760 lineItem: LineItem! 14761 14762 """The intention to restock the removed items.""" 14763 restock: Boolean! 14764 } 14765 14766 """ 14767 An auto-generated type which holds one OrderStagedChange and a cursor during pagination. 14768 14769 """ 14770 type OrderStagedChangeEdge { 14771 """A cursor for use in pagination.""" 14772 cursor: String! 14773 14774 """The item at the end of OrderStagedChangeEdge.""" 14775 node: OrderStagedChange! 14776 } 14777 14778 """ 14779 An addition of items to an existing line item on the order. 14780 14781 """ 14782 type OrderStagedChangeIncrementItem { 14783 """The number of items added.""" 14784 delta: Int! 14785 14786 """The original line item.""" 14787 lineItem: LineItem! 14788 } 14789 14790 """A transaction represents an exchange of money as part of an order.""" 14791 type OrderTransaction implements Node { 14792 """The masked account number associated with the payment method.""" 14793 accountNumber: String 14794 14795 """The amount of money.""" 14796 amount: Money! @deprecated(reason: "Use `amountSet` instead") 14797 14798 """ 14799 The amount and currency of the transaction in shop and presentment currencies. 14800 """ 14801 amountSet: MoneyBag! 14802 14803 """The amount and currency of the transaction.""" 14804 amountV2: MoneyV2! @deprecated(reason: "Use `amountSet` instead") 14805 14806 """Authorization code associated with the transaction.""" 14807 authorizationCode: String 14808 14809 """ 14810 The time when the authorization expires. This field is available only to stores on a Shopify Plus plan and is populated only for Shopify Payments authorizations. 14811 14812 """ 14813 authorizationExpiresAt: DateTime 14814 14815 """Date and time when the transaction was created.""" 14816 createdAt: DateTime! 14817 14818 """A standardized error code, independent of the payment provider.""" 14819 errorCode: OrderTransactionErrorCode 14820 14821 """The transaction fees charged on the order transaction.""" 14822 fees: [TransactionFee!]! 14823 14824 """ 14825 The human-readable payment gateway name used to process the transaction. 14826 """ 14827 formattedGateway: String 14828 14829 """The payment gateway used to process the transaction.""" 14830 gateway: String 14831 14832 """Globally unique identifier.""" 14833 id: ID! 14834 14835 """The kind of transaction.""" 14836 kind: OrderTransactionKind! 14837 14838 """Whether the transaction can be manually captured.""" 14839 manuallyCapturable: Boolean! 14840 14841 """ 14842 Specifies the available amount to refund on the gateway. Only available within SuggestedRefund. 14843 """ 14844 maximumRefundable: Money @deprecated(reason: "Use `maximumRefundableV2` instead") 14845 14846 """ 14847 Specifies the available amount with currency to refund on the gateway. 14848 Only available within SuggestedRefund. 14849 14850 """ 14851 maximumRefundableV2: MoneyV2 14852 14853 """The associated order.""" 14854 order: Order 14855 14856 """ 14857 The associated parent transaction, for example the authorization of a capture. 14858 """ 14859 parentTransaction: OrderTransaction 14860 14861 """Specifies the payment icon to display for this transaction.""" 14862 paymentIcon( 14863 """ 14864 Image width in pixels between 1 and 2048. This argument is deprecated: Use `maxWidth` on `Image.transformedSrc` instead. 14865 """ 14866 maxWidth: Int 14867 14868 """ 14869 Image height in pixels between 1 and 2048. This argument is deprecated: Use `maxHeight` on `Image.transformedSrc` instead. 14870 """ 14871 maxHeight: Int 14872 14873 """ 14874 Crops the image according to the specified region. This argument is deprecated: Use `crop` on `Image.transformedSrc` instead. 14875 """ 14876 crop: CropRegion 14877 14878 """ 14879 Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use `scale` on `Image.transformedSrc` instead. 14880 """ 14881 scale: Int = 1 14882 ): Image 14883 14884 """Specifies the credit card company used to pay for this transaction.""" 14885 paymentMethod: PaymentMethods @deprecated(reason: "Use `paymentIcon` instead") 14886 14887 """Date and time when the transaction was processed.""" 14888 processedAt: DateTime 14889 14890 """ 14891 A transaction receipt attached to the transaction by the gateway. 14892 The value of this field depends on which gateway processed the transaction. 14893 14894 """ 14895 receipt: String @deprecated(reason: "Use `receiptJson` instead") 14896 14897 """The settlement currency.""" 14898 settlementCurrency: CurrencyCode 14899 14900 """ 14901 The rate used when converting the transaction amount to settlement currency. 14902 """ 14903 settlementCurrencyRate: Decimal 14904 14905 """ 14906 Contains all Shopify Payments information related to an order transaction. This field is available only to stores on a Shopify Plus plan. 14907 14908 """ 14909 shopifyPaymentsSet: ShopifyPaymentsTransactionSet 14910 14911 """The status of this transaction.""" 14912 status: OrderTransactionStatus! 14913 14914 """Whether the transaction is a test transaction.""" 14915 test: Boolean! 14916 14917 """ 14918 Specifies the available amount to capture on the gateway. 14919 Only available when an amount is capturable or manually mark as paid. 14920 14921 """ 14922 totalUnsettled: Money @deprecated(reason: "Use `totalUnsettledSet` instead") 14923 14924 """ 14925 Specifies the available amount with currency to capture on the gateway in shop and presentment currencies. 14926 Only available when an amount is capturable or manually mark as paid. 14927 14928 """ 14929 totalUnsettledSet: MoneyBag 14930 14931 """ 14932 Specifies the available amount with currency to capture on the gateway. 14933 Only available when an amount is capturable or manually mark as paid. 14934 14935 """ 14936 totalUnsettledV2: MoneyV2 @deprecated(reason: "Use `totalUnsettledSet` instead") 14937 } 14938 14939 """ 14940 An auto-generated type for paginating through multiple OrderTransactions. 14941 14942 """ 14943 type OrderTransactionConnection { 14944 """A list of edges.""" 14945 edges: [OrderTransactionEdge!]! 14946 14947 """Information to aid in pagination.""" 14948 pageInfo: PageInfo! 14949 } 14950 14951 """ 14952 An auto-generated type which holds one OrderTransaction and a cursor during pagination. 14953 14954 """ 14955 type OrderTransactionEdge { 14956 """A cursor for use in pagination.""" 14957 cursor: String! 14958 14959 """The item at the end of OrderTransactionEdge.""" 14960 node: OrderTransaction! 14961 } 14962 14963 """A standardized error code, independent of the payment provider.""" 14964 enum OrderTransactionErrorCode { 14965 """The card number is incorrect.""" 14966 INCORRECT_NUMBER 14967 14968 """The format of the card number is incorrect.""" 14969 INVALID_NUMBER 14970 14971 """The format of the expiry date is incorrect.""" 14972 INVALID_EXPIRY_DATE 14973 14974 """The format of the CVC is incorrect.""" 14975 INVALID_CVC 14976 14977 """The card is expired.""" 14978 EXPIRED_CARD 14979 14980 """The CVC does not match the card number.""" 14981 INCORRECT_CVC 14982 14983 """The ZIP or postal code does not match the card number.""" 14984 INCORRECT_ZIP 14985 14986 """The address does not match the card number.""" 14987 INCORRECT_ADDRESS 14988 14989 """The entered PIN is incorrect.""" 14990 INCORRECT_PIN 14991 14992 """The card was declined.""" 14993 CARD_DECLINED 14994 14995 """There was an error while processing the payment.""" 14996 PROCESSING_ERROR 14997 14998 """Call the card issuer.""" 14999 CALL_ISSUER 15000 15001 """ 15002 The card has been reported as lost or stolen, and the card issuer has requested that the merchant keep the card and call the number on the back. 15003 15004 """ 15005 PICK_UP_CARD 15006 15007 """There is an error in the gateway or merchant configuration.""" 15008 CONFIG_ERROR 15009 15010 """A real card was used but the gateway was in test mode.""" 15011 TEST_MODE_LIVE_CARD 15012 15013 """ 15014 The gateway or merchant configuration doesn't support a feature, such as network tokenization. 15015 """ 15016 UNSUPPORTED_FEATURE 15017 15018 """There was an unknown error with processing the payment.""" 15019 GENERIC_ERROR 15020 15021 """The payment method is not available in the customer's country.""" 15022 INVALID_COUNTRY 15023 15024 """The amount is either too high or too low for the provider.""" 15025 INVALID_AMOUNT 15026 15027 """The payment method is momentarily unavailable.""" 15028 PAYMENT_METHOD_UNAVAILABLE 15029 15030 """The payment method was invalid.""" 15031 AMAZON_PAYMENTS_INVALID_PAYMENT_METHOD 15032 15033 """The maximum amount has been captured.""" 15034 AMAZON_PAYMENTS_MAX_AMOUNT_CHARGED 15035 15036 """The maximum amount has been refunded.""" 15037 AMAZON_PAYMENTS_MAX_AMOUNT_REFUNDED 15038 15039 """The maximum of 10 authorizations has been captured for an order.""" 15040 AMAZON_PAYMENTS_MAX_AUTHORIZATIONS_CAPTURED 15041 15042 """The maximum of 10 refunds has been processed for an order.""" 15043 AMAZON_PAYMENTS_MAX_REFUNDS_PROCESSED 15044 15045 """The order was canceled, which canceled all open authorizations.""" 15046 AMAZON_PAYMENTS_ORDER_REFERENCE_CANCELED 15047 15048 """The order was not confirmed within three hours.""" 15049 AMAZON_PAYMENTS_STALE 15050 } 15051 15052 """Specifies the information needed to create an order transaction.""" 15053 input OrderTransactionInput { 15054 """The amount of money for this transaction.""" 15055 amount: Money! 15056 15057 """The payment gateway to use for this transaction.""" 15058 gateway: String! 15059 15060 """The kind of transaction.""" 15061 kind: OrderTransactionKind! 15062 15063 """The ID of the order associated with the transaction.""" 15064 orderId: ID! 15065 15066 """ 15067 The ID of the optional parent transaction, for example the authorization of a capture. 15068 """ 15069 parentId: ID 15070 } 15071 15072 """The different kinds of order transactions.""" 15073 enum OrderTransactionKind { 15074 """An authorization and capture performed together in a single step.""" 15075 SALE 15076 15077 """ 15078 A transfer of the money that was reserved during the authorization stage. 15079 """ 15080 CAPTURE 15081 15082 """ 15083 An amount reserved against the cardholder's funding source. 15084 Money does not change hands until the authorization is captured. 15085 15086 """ 15087 AUTHORIZATION 15088 15089 """A cancellation of a pending authorization or capture.""" 15090 VOID 15091 15092 """ 15093 A partial or full return of captured funds to the cardholder. 15094 A refund can happen only after a capture is processed. 15095 15096 """ 15097 REFUND 15098 15099 """Money returned to the customer when they have paid too much.""" 15100 CHANGE 15101 15102 """An authorization for a payment taken with an EMV credit card reader.""" 15103 EMV_AUTHORIZATION 15104 15105 """A suggested refund transaction that can be used to create a refund.""" 15106 SUGGESTED_REFUND 15107 } 15108 15109 """Transaction status' describe the status of a transaction.""" 15110 enum OrderTransactionStatus { 15111 """The transaction succeeded.""" 15112 SUCCESS 15113 15114 """The transaction failed.""" 15115 FAILURE 15116 15117 """The transaction is pending.""" 15118 PENDING 15119 15120 """There was an error while processing the transaction.""" 15121 ERROR 15122 15123 """Awaiting a response.""" 15124 AWAITING_RESPONSE 15125 15126 """The transaction status is unknown.""" 15127 UNKNOWN 15128 } 15129 15130 """Return type for `orderUpdate` mutation.""" 15131 type OrderUpdatePayload { 15132 """The updated order.""" 15133 order: Order 15134 15135 """List of errors that occurred executing the mutation.""" 15136 userErrors: [UserError!]! 15137 } 15138 15139 """Information about pagination in a connection.""" 15140 type PageInfo { 15141 """Indicates if there are more pages to fetch.""" 15142 hasNextPage: Boolean! 15143 15144 """Indicates if there are any pages prior to the current page.""" 15145 hasPreviousPage: Boolean! 15146 } 15147 15148 """List of payment methods used in Shopify.""" 15149 enum PaymentMethods { 15150 VISA 15151 MASTERCARD 15152 DISCOVER 15153 AMERICAN_EXPRESS 15154 DINERS_CLUB 15155 JCB 15156 DANKORT 15157 MAESTRO 15158 FORBRUGSFORENINGEN 15159 PAYPAL 15160 BOGUS 15161 BITCOIN 15162 LITECOIN 15163 DOGECOIN 15164 } 15165 15166 """Represents a payment session.""" 15167 type PaymentSession { 15168 """A globally unique identifier.""" 15169 id: ID! 15170 15171 """The url of the Checkout to redirect the buyer to.""" 15172 redirectUrl: URL! 15173 15174 """The payment status.""" 15175 status: PaymentSessionStatus! 15176 } 15177 15178 """Return type for `paymentSessionReject` mutation.""" 15179 type PaymentSessionRejectPayload { 15180 """The updated payment session.""" 15181 paymentSession: PaymentSession 15182 15183 """List of errors that occurred executing the mutation.""" 15184 userErrors: [UserError!]! 15185 } 15186 15187 """Reason of the payment status.""" 15188 input PaymentSessionRejectionReasonInput { 15189 """The reason code.""" 15190 code: PaymentSessionStatusReasonRejectionCode! 15191 15192 """A custom, localized message for the merchant.""" 15193 merchantMessage: String 15194 } 15195 15196 """Return type for `paymentSessionResolve` mutation.""" 15197 type PaymentSessionResolvePayload { 15198 """The updated payment session.""" 15199 paymentSession: PaymentSession 15200 15201 """List of errors that occurred executing the mutation.""" 15202 userErrors: [UserError!]! 15203 } 15204 15205 """Represents a payment status.""" 15206 type PaymentSessionStatus { 15207 """The payment status code.""" 15208 code: PaymentSessionStatusCode! 15209 15210 """The payment status reason (if applicable).""" 15211 reason: PaymentSessionStatusReason 15212 } 15213 15214 """Payment status codes.""" 15215 enum PaymentSessionStatusCode { 15216 """Payment rejected.""" 15217 REJECTED 15218 15219 """Payment resolved.""" 15220 RESOLVED 15221 } 15222 15223 """Payment status reason.""" 15224 type PaymentSessionStatusReason { 15225 """The reason code.""" 15226 code: PaymentSessionStatusReasonRejectionCode! 15227 15228 """The custom, localized message for the merchant.""" 15229 merchantMessage: String 15230 } 15231 15232 """Payment rejection reason codes.""" 15233 enum PaymentSessionStatusReasonRejectionCode { 15234 """Rejected by risk control.""" 15235 RISKY 15236 15237 """Payment processing failure. No retry.""" 15238 PROCESSING_ERROR 15239 } 15240 15241 """Settings related to payments.""" 15242 type PaymentSettings { 15243 """List of the digital wallets which the shop supports.""" 15244 supportedDigitalWallets: [DigitalWallet!]! 15245 } 15246 15247 """The production configuration of the payments app.""" 15248 type PaymentsAppConfiguration { 15249 """Handle used by the provider.""" 15250 externalHandle: String 15251 15252 """The provider is ready to process merchant's payments.""" 15253 ready: Boolean! 15254 } 15255 15256 """Return type for `paymentsAppConfigure` mutation.""" 15257 type PaymentsAppConfigurePayload { 15258 """The production configuration of the payments app.""" 15259 paymentsAppConfiguration: PaymentsAppConfiguration 15260 15261 """List of errors that occurred executing the mutation.""" 15262 userErrors: [UserError!]! 15263 } 15264 15265 """ 15266 Price rules are a set of conditions, including entitlements and prerequisites, that must be met in order for a discount code to apply. 15267 """ 15268 type PriceRule implements Node & CommentEventSubject & LegacyInteroperability & HasEvents { 15269 """ 15270 The maximum number of times that the price rule can be allocated onto an order. 15271 """ 15272 allocationLimit: Int 15273 15274 """ 15275 The method by which the price rule's value is allocated to its entitled items. 15276 """ 15277 allocationMethod: PriceRuleAllocationMethod! 15278 15279 """The application that created the price rule.""" 15280 app: App 15281 15282 """The date and time when the price rule was created.""" 15283 createdAt: DateTime! 15284 15285 """The customers that can use this price rule.""" 15286 customerSelection: PriceRuleCustomerSelection! 15287 15288 """List of the price rule's discount codes.""" 15289 discountCodes( 15290 """Returns up to the first `n` elements from the list.""" 15291 first: Int 15292 15293 """Returns the elements that come after the specified cursor.""" 15294 after: String 15295 15296 """Returns up to the last `n` elements from the list.""" 15297 last: Int 15298 15299 """Returns the elements that come before the specified cursor.""" 15300 before: String 15301 15302 """Reverse the order of the underlying list.""" 15303 reverse: Boolean = false 15304 15305 """Sort the underlying list by the given key.""" 15306 sortKey: DiscountCodeSortKeys = ID 15307 15308 """ 15309 Supported filter parameters: 15310 - `times_used` 15311 15312 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 15313 for more information about using filters. 15314 15315 """ 15316 query: String 15317 15318 """ 15319 ID of an existing saved search. 15320 The search’s query string is used as the query argument. 15321 15322 """ 15323 savedSearchId: ID 15324 ): PriceRuleDiscountCodeConnection! 15325 15326 """How many discount codes associated with the price rule.""" 15327 discountCodesCount: Int! 15328 15329 """ 15330 The date and time when the price rule ends. For open-ended price rules, use `null`. 15331 """ 15332 endsAt: DateTime 15333 15334 """ 15335 Quantity of prerequisite items required for the price rule to be applicable, compared to quantity of entitled items. 15336 """ 15337 entitlementToPrerequisiteQuantityRatio: PriceRuleEntitlementToPrerequisiteQuantityRatio @deprecated(reason: "Use `prerequisiteToEntitlementQuantityRatio` instead") 15338 15339 """The paginated list of events associated with the price rule.""" 15340 events( 15341 """Returns up to the first `n` elements from the list.""" 15342 first: Int 15343 15344 """Returns the elements that come after the specified cursor.""" 15345 after: String 15346 15347 """Returns up to the last `n` elements from the list.""" 15348 last: Int 15349 15350 """Returns the elements that come before the specified cursor.""" 15351 before: String 15352 15353 """Reverse the order of the underlying list.""" 15354 reverse: Boolean = false 15355 15356 """Sort the underlying list by the given key.""" 15357 sortKey: EventSortKeys = ID 15358 15359 """ 15360 Supported filter parameters: 15361 - `comments` 15362 - `created_at` 15363 - `subject_type` 15364 - `verb` 15365 15366 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 15367 for more information about using filters. 15368 15369 """ 15370 query: String 15371 ): EventConnection! 15372 15373 """A list of the price rule's features.""" 15374 features: [PriceRuleFeature!]! 15375 15376 """Indicates whether there are any timeline comments on the price rule.""" 15377 hasTimelineComment: Boolean! 15378 15379 """Globally unique identifier.""" 15380 id: ID! 15381 15382 """The items to which the price rule applies.""" 15383 itemEntitlements: PriceRuleItemEntitlements! 15384 15385 """The items required for the price rule to be applicable.""" 15386 itemPrerequisites: PriceRuleLineItemPrerequisites! 15387 15388 """The ID of the corresponding resource in the REST Admin API.""" 15389 legacyResourceId: UnsignedInt64! 15390 15391 """Whether the price rule can be applied only once per customer.""" 15392 oncePerCustomer: Boolean! 15393 15394 """ 15395 The number of the entitled items must fall within this range for the price rule to be applicable. 15396 """ 15397 prerequisiteQuantityRange: PriceRuleQuantityRange 15398 15399 """ 15400 The shipping cost must fall within this range for the price rule to be applicable. 15401 """ 15402 prerequisiteShippingPriceRange: PriceRuleMoneyRange 15403 15404 """ 15405 The sum of the entitled items subtotal prices must fall within this range for the price rule to be applicable. 15406 """ 15407 prerequisiteSubtotalRange: PriceRuleMoneyRange 15408 15409 """ 15410 Quantity of prerequisite items required for the price rule to be applicable, compared to quantity of entitled items. 15411 """ 15412 prerequisiteToEntitlementQuantityRatio: PriceRulePrerequisiteToEntitlementQuantityRatio 15413 15414 """URLs that can be used to share the discount.""" 15415 shareableUrls: [PriceRuleShareableUrl!]! 15416 15417 """The shipping lines to which the price rule applies.""" 15418 shippingEntitlements: PriceRuleShippingLineEntitlements! 15419 15420 """The date and time when the price rule starts.""" 15421 startsAt: DateTime! 15422 15423 """The status of the price rule.""" 15424 status: PriceRuleStatus! 15425 15426 """A detailed summary of the price rule.""" 15427 summary: String 15428 15429 """ 15430 The type of lines (line_item or shipping_line) to which the price rule applies. 15431 """ 15432 target: PriceRuleTarget! 15433 15434 """The title of the price rule.""" 15435 title: String! 15436 15437 """The total sales from orders where the price rule was used.""" 15438 totalSales: MoneyV2 15439 15440 """A list of the price rule's features.""" 15441 traits: [PriceRuleTrait!]! @deprecated(reason: "Use `features` instead") 15442 15443 """ 15444 The number of times that the price rule has been used. This value is updated asynchronously and can be different than the actual usage count. 15445 """ 15446 usageCount: Int! 15447 15448 """The maximum number of times that the price rule can be used in total.""" 15449 usageLimit: Int 15450 15451 """A time period during which a price rule is applicable.""" 15452 validityPeriod: PriceRuleValidityPeriod! 15453 15454 """The value of the price rule.""" 15455 value: PriceRuleValue! @deprecated(reason: "Use `valueV2` instead") 15456 15457 """The value of the price rule.""" 15458 valueV2: PricingValue! 15459 } 15460 15461 """Return type for `priceRuleActivate` mutation.""" 15462 type PriceRuleActivatePayload { 15463 """The activated price rule.""" 15464 priceRule: PriceRule 15465 15466 """List of errors that occurred executing the mutation.""" 15467 priceRuleUserErrors: [PriceRuleUserError!]! 15468 15469 """List of errors that occurred executing the mutation.""" 15470 userErrors: [UserError!]! @deprecated(reason: "Use `priceRuleUserErrors` instead") 15471 } 15472 15473 """ 15474 The method by which the price rule's value is allocated to its entitled items. 15475 """ 15476 enum PriceRuleAllocationMethod { 15477 """The value will be applied to each of the entitled items.""" 15478 EACH 15479 15480 """The value will be applied once across the entitled items.""" 15481 ACROSS 15482 } 15483 15484 """ 15485 An auto-generated type for paginating through multiple PriceRules. 15486 15487 """ 15488 type PriceRuleConnection { 15489 """A list of edges.""" 15490 edges: [PriceRuleEdge!]! 15491 15492 """Information to aid in pagination.""" 15493 pageInfo: PageInfo! 15494 } 15495 15496 """Return type for `priceRuleCreate` mutation.""" 15497 type PriceRuleCreatePayload { 15498 """The newly created price rule.""" 15499 priceRule: PriceRule 15500 15501 """The newly created discount code.""" 15502 priceRuleDiscountCode: PriceRuleDiscountCode 15503 15504 """List of errors that occurred executing the mutation.""" 15505 priceRuleUserErrors: [PriceRuleUserError!]! 15506 15507 """List of errors that occurred executing the mutation.""" 15508 userErrors: [UserError!]! @deprecated(reason: "Use `priceRuleUserErrors` instead") 15509 } 15510 15511 """A selection of customers for whom the price rule applies.""" 15512 type PriceRuleCustomerSelection { 15513 """List of customers to whom the price rule applies.""" 15514 customers( 15515 """Returns up to the first `n` elements from the list.""" 15516 first: Int 15517 15518 """Returns the elements that come after the specified cursor.""" 15519 after: String 15520 15521 """Returns up to the last `n` elements from the list.""" 15522 last: Int 15523 15524 """Returns the elements that come before the specified cursor.""" 15525 before: String 15526 15527 """Reverse the order of the underlying list.""" 15528 reverse: Boolean = false 15529 15530 """Sort the underlying list by the given key.""" 15531 sortKey: CustomerSortKeys = ID 15532 15533 """ 15534 Supported filter parameters: 15535 - `accepts_marketing` 15536 - `country` 15537 - `customer_date` 15538 - `email` 15539 - `last_abandoned_order_date` 15540 - `order_date` 15541 - `orders_count` 15542 - `phone` 15543 - `state` 15544 - `tag` 15545 - `total_spent` 15546 - `updated_at` 15547 15548 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax). 15549 15550 """ 15551 query: String 15552 15553 """ 15554 ID of an existing saved search. 15555 The search’s query string is used as the query argument. 15556 15557 """ 15558 savedSearchId: ID 15559 ): CustomerConnection! 15560 15561 """Whether the price rule applies to all customers.""" 15562 forAllCustomers: Boolean! 15563 15564 """ 15565 A list of customer saved searches that contain the customers who can use the price rule. 15566 """ 15567 savedSearches: [SavedSearch!]! 15568 } 15569 15570 """Specifies the input fields to update a price rule customer selection.""" 15571 input PriceRuleCustomerSelectionInput { 15572 """Whether the price rule applies to all customers.""" 15573 forAllCustomers: Boolean = false 15574 15575 """ 15576 List of customer saved searches that contain the customers to whom the price rule applies. No single customer IDs may be present. 15577 """ 15578 savedSearchIds: [ID!] 15579 15580 """ 15581 List of customers to add to the current list of customers to whom the price rule applies. `savedSearchIds` must be empty. 15582 """ 15583 customerIdsToAdd: [ID!] 15584 15585 """ 15586 A list of customers to remove from the current list of customers to whom the price rule applies. 15587 """ 15588 customerIdsToRemove: [ID!] 15589 } 15590 15591 """Return type for `priceRuleDeactivate` mutation.""" 15592 type PriceRuleDeactivatePayload { 15593 """The deactivated price rule.""" 15594 priceRule: PriceRule 15595 15596 """List of errors that occurred executing the mutation.""" 15597 priceRuleUserErrors: [PriceRuleUserError!]! 15598 15599 """List of errors that occurred executing the mutation.""" 15600 userErrors: [UserError!]! @deprecated(reason: "Use `priceRuleUserErrors` instead") 15601 } 15602 15603 """Return type for `priceRuleDelete` mutation.""" 15604 type PriceRuleDeletePayload { 15605 """The id price of the deleted price rule.""" 15606 deletedPriceRuleId: ID 15607 15608 """List of errors that occurred executing the mutation.""" 15609 priceRuleUserErrors: [PriceRuleUserError!]! 15610 15611 """The shop of the deleted price rule.""" 15612 shop: Shop! 15613 15614 """List of errors that occurred executing the mutation.""" 15615 userErrors: [UserError!]! @deprecated(reason: "Use `priceRuleUserErrors` instead") 15616 } 15617 15618 """A discount code of a price rule.""" 15619 type PriceRuleDiscountCode implements Node { 15620 """The application that created the discount code.""" 15621 app: App 15622 15623 """The code to use the discount.""" 15624 code: String! 15625 15626 """Globally unique identifier.""" 15627 id: ID! 15628 15629 """ 15630 The number of times that the price rule has been used. This value is updated asynchronously and can be different than the actual usage count. 15631 """ 15632 usageCount: Int! 15633 } 15634 15635 """ 15636 An auto-generated type for paginating through multiple PriceRuleDiscountCodes. 15637 15638 """ 15639 type PriceRuleDiscountCodeConnection { 15640 """A list of edges.""" 15641 edges: [PriceRuleDiscountCodeEdge!]! 15642 15643 """Information to aid in pagination.""" 15644 pageInfo: PageInfo! 15645 } 15646 15647 """Return type for `priceRuleDiscountCodeCreate` mutation.""" 15648 type PriceRuleDiscountCodeCreatePayload { 15649 """The updated price rule.""" 15650 priceRule: PriceRule 15651 15652 """The newly created discount code.""" 15653 priceRuleDiscountCode: PriceRuleDiscountCode 15654 15655 """List of errors that occurred executing the mutation.""" 15656 priceRuleUserErrors: [PriceRuleUserError!]! 15657 15658 """List of errors that occurred executing the mutation.""" 15659 userErrors: [UserError!]! @deprecated(reason: "Use `priceRuleUserErrors` instead") 15660 } 15661 15662 """ 15663 An auto-generated type which holds one PriceRuleDiscountCode and a cursor during pagination. 15664 15665 """ 15666 type PriceRuleDiscountCodeEdge { 15667 """A cursor for use in pagination.""" 15668 cursor: String! 15669 15670 """The item at the end of PriceRuleDiscountCodeEdge.""" 15671 node: PriceRuleDiscountCode! 15672 } 15673 15674 """Specifies the input fields to manipulate a discount code.""" 15675 input PriceRuleDiscountCodeInput { 15676 """The code to use the discount.""" 15677 code: String 15678 } 15679 15680 """Return type for `priceRuleDiscountCodeUpdate` mutation.""" 15681 type PriceRuleDiscountCodeUpdatePayload { 15682 """The updated price rule.""" 15683 priceRule: PriceRule 15684 15685 """The updated discount code.""" 15686 priceRuleDiscountCode: PriceRuleDiscountCode 15687 15688 """List of errors that occurred executing the mutation.""" 15689 priceRuleUserErrors: [PriceRuleUserError!]! 15690 15691 """List of errors that occurred executing the mutation.""" 15692 userErrors: [UserError!]! @deprecated(reason: "Use `priceRuleUserErrors` instead") 15693 } 15694 15695 """ 15696 An auto-generated type which holds one PriceRule and a cursor during pagination. 15697 15698 """ 15699 type PriceRuleEdge { 15700 """A cursor for use in pagination.""" 15701 cursor: String! 15702 15703 """The item at the end of PriceRuleEdge.""" 15704 node: PriceRule! 15705 } 15706 15707 """ 15708 Quantity of prerequisite items required for the price rule to be applicable, compared to quantity of entitled items. 15709 """ 15710 type PriceRuleEntitlementToPrerequisiteQuantityRatio { 15711 """The quantity of entitlements in the ratio.""" 15712 entitlementQuantity: Int! 15713 15714 """The quantity of prerequisites in the ratio.""" 15715 prerequisiteQuantity: Int! 15716 } 15717 15718 """ 15719 Specifies the quantity of prerequisite items required for the price rule to be applicable, compared to quantity of entitled items. 15720 """ 15721 input PriceRuleEntitlementToPrerequisiteQuantityRatioInput { 15722 """The quantity of entitlements in the ratio.""" 15723 entitlementQuantity: Int 15724 15725 """The quantity of prerequisites in the ratio.""" 15726 prerequisiteQuantity: Int 15727 } 15728 15729 """Possible error codes that could be returned by a price rule mutation.""" 15730 enum PriceRuleErrorCode { 15731 """Input value is blank.""" 15732 BLANK 15733 15734 """Input value should be equal to allowed value.""" 15735 EQUAL_TO 15736 15737 """Input value should be greater than minimum allowed value.""" 15738 GREATER_THAN 15739 15740 """Input value should be greater than or equal to minimum allowed value.""" 15741 GREATER_THAN_OR_EQUAL_TO 15742 15743 """Input value is invalid.""" 15744 INVALID 15745 15746 """Input value should be less than maximum allowed value.""" 15747 LESS_THAN 15748 15749 """Input value should be less or equal to maximum allowed value.""" 15750 LESS_THAN_OR_EQUAL_TO 15751 15752 """Input value is already taken.""" 15753 TAKEN 15754 15755 """Input value is too long.""" 15756 TOO_LONG 15757 15758 """Input value is too short.""" 15759 TOO_SHORT 15760 15761 """Unexpected internal error happened.""" 15762 INTERNAL_ERROR 15763 15764 """Too many arguments provided.""" 15765 TOO_MANY_ARGUMENTS 15766 15767 """Missing a required argument.""" 15768 MISSING_ARGUMENT 15769 15770 """Duplicate customer prerequisite id present.""" 15771 CUSTOMER_PREREQUISITE_DUPLICATE 15772 CANNOT_ENTITLE_COLLECTIONS_WITH_PRODUCTS_OR_VARIANTS 15773 ITEM_ENTITLEMENT_INVALID_TYPE 15774 ITEM_ENTITLEMENTS_DUPLICATE_COLLECTION 15775 ITEM_ENTITLEMENTS_DUPLICATE_PRODUCT 15776 ITEM_ENTITLEMENTS_DUPLICATE_VARIANT 15777 ITEM_ENTITLEMENTS_EXCEEDED_MAX_COLLECTION 15778 ITEM_ENTITLEMENTS_EXCEEDED_MAX_PRODUCT 15779 ITEM_ENTITLEMENTS_EXCEEDED_MAX_VARIANT 15780 ITEM_ENTITLEMENTS_INVALID_COLLECTION 15781 ITEM_ENTITLEMENTS_INVALID_PRODUCT 15782 ITEM_ENTITLEMENTS_INVALID_TARGET_TYPE_OR_SELECTION 15783 ITEM_ENTITLEMENTS_INVALID_VARIANT 15784 ITEM_ENTITLEMENTS_MISSING 15785 VARIANT_ALREADY_ENTITLED_THROUGH_PRODUCT 15786 CANNOT_PREREQUISITE_COLLECTION_WITH_PRODUCT_OR_VARIANTS 15787 ITEM_PREREQUISITES_DUPLICATE_COLLECTION 15788 ITEM_PREREQUISITES_DUPLICATE_PRODUCT 15789 ITEM_PREREQUISITES_DUPLICATE_VARIANT 15790 ITEM_PREREQUISITES_EXCEEDED_MAX 15791 ITEM_PREREQUISITES_INVALID_COLLECTION 15792 ITEM_PREREQUISITES_INVALID_PRODUCT 15793 ITEM_PREREQUISITES_INVALID_TYPE 15794 ITEM_PREREQUISITES_INVALID_VARIANT 15795 ITEM_PREREQUISITES_MISSING 15796 ITEM_PREREQUISITES_MUST_BE_EMPTY 15797 INVALID_TARGET_TYPE_PREREQUISITE_SHIPPING_PRICE_RANGE 15798 SHIPPING_ENTITLEMENTS_DUPLICATE_COUNTRY 15799 SHIPPING_ENTITLEMENTS_EXCEEDED_MAX 15800 SHIPPING_ENTITLEMENTS_INVALID_COUNTRY 15801 SHIPPING_ENTITLEMENTS_INVALID_TARGET_TYPE_OR_SELECTION 15802 SHIPPING_ENTITLEMENTS_MISSING 15803 SHIPPING_ENTITLEMENTS_UNSUPPORTED_DESTINATION_TYPE 15804 BOTH_CUSTOMER_AND_SAVED_SEARCH_PREREQUISITES_SELECTED 15805 CUSTOMER_PREREQUISITES_EXCEEDED_MAX 15806 CUSTOMER_PREREQUISITES_INVALID_SELECTION 15807 CUSTOMER_PREREQUISITES_MISSING 15808 CUSTOMER_SAVED_SEARCH_DUPLICATE 15809 CUSTOMER_SAVED_SEARCH_EXCEEDED_MAX 15810 CUSTOMER_SAVED_SEARCH_INVALID 15811 DISCOUNT_CODE_DUPLICATE 15812 15813 """Exceeds maximum number allowed.""" 15814 EXCEEDED_MAX 15815 BOGO_INVALID_TARGET_SELECTION 15816 BOGO_INVALID_TARGET_TYPE 15817 BOGO_INVALID_VALUE_TYPE 15818 15819 """Allocation limit can only be set on buy one get one type discounts.""" 15820 PRICE_RULE_ALLOCATION_LIMIT_ON_NON_BOGO 15821 15822 """Allocation limit must be a non zero positive number.""" 15823 PRICE_RULE_ALLOCATION_LIMIT_IS_ZERO 15824 15825 """Number of discount codes in the shop has reached its limit.""" 15826 PRICE_RULE_EXCEEDED_MAX_DISCOUNT_CODE 15827 15828 """Number of discounts in the shop has reached its limit.""" 15829 SHOP_EXCEEDED_MAX_PRICE_RULES 15830 15831 """Discount end date must be after the start date.""" 15832 END_DATE_BEFORE_START_DATE 15833 15834 """Percentage value must be between 0 and -100.""" 15835 PRICE_RULE_PERCENTAGE_VALUE_OUTSIDE_RANGE 15836 15837 """ 15838 Only one of minimum subtotal or minimum quantity condition can be defined. 15839 """ 15840 PREREQUISITE_SUBTOTAL_AND_QUANTITY_RANGE_BOTH_PRESENT 15841 15842 """Allocation method must be "across" for the provided target selection.""" 15843 ALLOCATION_METHOD_MUST_BE_ACROSS_FOR_GIVEN_TARGET_SELECTION 15844 15845 """ 15846 Discount must apply on either one time purchase or subscription items, or both. 15847 """ 15848 APPLIES_ON_NOTHING 15849 15850 """ 15851 Recurring cycle limit must be 1 when a discount does not apply on subscription items. 15852 """ 15853 MULTIPLE_RECURRING_CYCLE_LIMIT_FOR_NON_SUBSCRIPTION_ITEMS 15854 } 15855 15856 """A list of features used by the price rule.""" 15857 enum PriceRuleFeature { 15858 """The price rule supports quantity BXGY discounts.""" 15859 BUY_ONE_GET_ONE 15860 15861 """The price rule supports BXGY discounts using custom allocation limit.""" 15862 BUY_ONE_GET_ONE_WITH_ALLOCATION_LIMIT 15863 15864 """The price rule supports bulk discounts.""" 15865 BULK 15866 15867 """The price rule supports specific customers.""" 15868 SPECIFIC_CUSTOMERS 15869 15870 """The price rule supports quantity discounts.""" 15871 QUANTITY_DISCOUNTS 15872 } 15873 15874 """The value of a fixed amount price rule.""" 15875 type PriceRuleFixedAmountValue { 15876 """The monetary value of the price rule.""" 15877 amount: Money! 15878 } 15879 15880 """Specifies the input fields to manipulate a price rule.""" 15881 input PriceRuleInput { 15882 """PriceRuleValidityPeriod for the price rule.""" 15883 validityPeriod: PriceRuleValidityPeriodInput 15884 15885 """Whether the price rule can be applied only once per customer.""" 15886 oncePerCustomer: Boolean = false 15887 15888 """The customers that can use this price rule.""" 15889 customerSelection: PriceRuleCustomerSelectionInput 15890 15891 """The maximum number of times that the price rule can be used in total.""" 15892 usageLimit: Int 15893 15894 """Title of the price rule.""" 15895 title: String 15896 15897 """ 15898 The maximum number of times that the price rule can be allocated onto an order. 15899 """ 15900 allocationLimit: Int 15901 15902 """ 15903 The method by which the price rule's value is allocated to its entitled items. 15904 """ 15905 allocationMethod: PriceRuleAllocationMethod 15906 15907 """The value of the price rule.""" 15908 value: PriceRuleValueInput 15909 15910 """ 15911 The type of lines (line_item or shipping_line) to which the price rule applies. 15912 """ 15913 target: PriceRuleTarget 15914 15915 """ 15916 The sum of the entitled items subtotal prices must fall within this range for the price rule to be applicable. 15917 """ 15918 prerequisiteSubtotalRange: PriceRuleMoneyRangeInput 15919 15920 """ 15921 The number of the entitled items must fall within this range for the price rule to be applicable. 15922 """ 15923 prerequisiteQuantityRange: PriceRuleQuantityRangeInput 15924 15925 """ 15926 The shipping cost must fall within this range for the price rule to be applicable. 15927 """ 15928 prerequisiteShippingPriceRange: PriceRuleMoneyRangeInput 15929 15930 """The items to which the price rule applies.""" 15931 itemEntitlements: PriceRuleItemEntitlementsInput 15932 15933 """The items required for the price rule to be applicable.""" 15934 itemPrerequisites: PriceRuleItemPrerequisitesInput 15935 15936 """The shipping lines to which the price rule applies.""" 15937 shippingEntitlements: PriceRuleShippingEntitlementsInput 15938 15939 """ 15940 Quantity of prerequisite items required for the price rule to be applicable, compared to quantity of entitled items. This argument is deprecated: Use `prerequisiteToEntitlementQuantityRatio` instead. 15941 """ 15942 entitlementToPrerequisiteQuantityRatio: PriceRuleEntitlementToPrerequisiteQuantityRatioInput 15943 15944 """ 15945 Quantity of prerequisite items required for the price rule to be applicable, compared to quantity of entitled items. 15946 """ 15947 prerequisiteToEntitlementQuantityRatio: PriceRulePrerequisiteToEntitlementQuantityRatioInput 15948 } 15949 15950 """ 15951 The items to which this price rule applies. This may be multiple products, product variants, collections or combinations of the aforementioned. 15952 """ 15953 type PriceRuleItemEntitlements { 15954 """The collections to which the price rule applies.""" 15955 collections( 15956 """Returns up to the first `n` elements from the list.""" 15957 first: Int 15958 15959 """Returns the elements that come after the specified cursor.""" 15960 after: String 15961 15962 """Returns up to the last `n` elements from the list.""" 15963 last: Int 15964 15965 """Returns the elements that come before the specified cursor.""" 15966 before: String 15967 15968 """Reverse the order of the underlying list.""" 15969 reverse: Boolean = false 15970 ): CollectionConnection! 15971 15972 """The product variants to which the price rule applies.""" 15973 productVariants( 15974 """Returns up to the first `n` elements from the list.""" 15975 first: Int 15976 15977 """Returns the elements that come after the specified cursor.""" 15978 after: String 15979 15980 """Returns up to the last `n` elements from the list.""" 15981 last: Int 15982 15983 """Returns the elements that come before the specified cursor.""" 15984 before: String 15985 15986 """Reverse the order of the underlying list.""" 15987 reverse: Boolean = false 15988 ): ProductVariantConnection! 15989 15990 """The products to which the price rule applies.""" 15991 products( 15992 """Returns up to the first `n` elements from the list.""" 15993 first: Int 15994 15995 """Returns the elements that come after the specified cursor.""" 15996 after: String 15997 15998 """Returns up to the last `n` elements from the list.""" 15999 last: Int 16000 16001 """Returns the elements that come before the specified cursor.""" 16002 before: String 16003 16004 """Reverse the order of the underlying list.""" 16005 reverse: Boolean = false 16006 ): ProductConnection! 16007 16008 """Whether the price rule applies to all line items.""" 16009 targetAllLineItems: Boolean! 16010 } 16011 16012 """ 16013 Specifies the input fields to update a price rule line item entitlement. 16014 """ 16015 input PriceRuleItemEntitlementsInput { 16016 """Whether the price rule applies to all items.""" 16017 targetAllLineItems: Boolean = false 16018 16019 """The products to which the price rule applies.""" 16020 productIds: [ID!] 16021 16022 """The product variants to which the price rule applies.""" 16023 productVariantIds: [ID!] 16024 16025 """The collections to which the price rule applies.""" 16026 collectionIds: [ID!] 16027 } 16028 16029 """ 16030 Specifies the input fields to update a price rule's item prerequisites. 16031 """ 16032 input PriceRuleItemPrerequisitesInput { 16033 """The products needed for the price rule to be applied.""" 16034 productIds: [ID!] 16035 16036 """The product variants needed for the price rule to be applied.""" 16037 productVariantIds: [ID!] 16038 16039 """The collections needed for the price rule to be applied.""" 16040 collectionIds: [ID!] 16041 } 16042 16043 """ 16044 Single or multiple line item products, product variants or collections required for the price rule to be applicable, can also be provided in combination. 16045 """ 16046 type PriceRuleLineItemPrerequisites { 16047 """The collections required for the price rule to be applicable.""" 16048 collections( 16049 """Returns up to the first `n` elements from the list.""" 16050 first: Int 16051 16052 """Returns the elements that come after the specified cursor.""" 16053 after: String 16054 16055 """Returns up to the last `n` elements from the list.""" 16056 last: Int 16057 16058 """Returns the elements that come before the specified cursor.""" 16059 before: String 16060 16061 """Reverse the order of the underlying list.""" 16062 reverse: Boolean = false 16063 ): CollectionConnection! 16064 16065 """The product variants required for the price rule to be applicable.""" 16066 productVariants( 16067 """Returns up to the first `n` elements from the list.""" 16068 first: Int 16069 16070 """Returns the elements that come after the specified cursor.""" 16071 after: String 16072 16073 """Returns up to the last `n` elements from the list.""" 16074 last: Int 16075 16076 """Returns the elements that come before the specified cursor.""" 16077 before: String 16078 16079 """Reverse the order of the underlying list.""" 16080 reverse: Boolean = false 16081 ): ProductVariantConnection! 16082 16083 """The products required for the price rule to be applicable.""" 16084 products( 16085 """Returns up to the first `n` elements from the list.""" 16086 first: Int 16087 16088 """Returns the elements that come after the specified cursor.""" 16089 after: String 16090 16091 """Returns up to the last `n` elements from the list.""" 16092 last: Int 16093 16094 """Returns the elements that come before the specified cursor.""" 16095 before: String 16096 16097 """Reverse the order of the underlying list.""" 16098 reverse: Boolean = false 16099 ): ProductConnection! 16100 } 16101 16102 """A money range within which the price rule is applicable.""" 16103 type PriceRuleMoneyRange { 16104 """The lower bound of the money range.""" 16105 greaterThan: Money 16106 16107 """The lower bound or equal of the money range.""" 16108 greaterThanOrEqualTo: Money 16109 16110 """The upper bound of the money range.""" 16111 lessThan: Money 16112 16113 """The upper bound or equal of the money range.""" 16114 lessThanOrEqualTo: Money 16115 } 16116 16117 """ 16118 Specifies the input fields to update the money range within which the price rule is applicable. 16119 16120 """ 16121 input PriceRuleMoneyRangeInput { 16122 """The upper bound of the money range.""" 16123 lessThan: Money 16124 16125 """The upper or equal bound of the money range.""" 16126 lessThanOrEqualTo: Money 16127 16128 """The lower bound of the money range.""" 16129 greaterThan: Money 16130 16131 """The lower or equal bound of the money range.""" 16132 greaterThanOrEqualTo: Money 16133 } 16134 16135 """The value of a percent price rule.""" 16136 type PriceRulePercentValue { 16137 """The percent value of the price rule.""" 16138 percentage: Float! 16139 } 16140 16141 """ 16142 Quantity of prerequisite items required for the price rule to be applicable, compared to quantity of entitled items. 16143 """ 16144 type PriceRulePrerequisiteToEntitlementQuantityRatio { 16145 """The quantity of entitlements in the ratio.""" 16146 entitlementQuantity: Int! 16147 16148 """The quantity of prerequisites in the ratio.""" 16149 prerequisiteQuantity: Int! 16150 } 16151 16152 """ 16153 Specifies the quantity of prerequisite items required for the price rule to be applicable, compared to quantity of entitled items. 16154 """ 16155 input PriceRulePrerequisiteToEntitlementQuantityRatioInput { 16156 """The quantity of entitlements in the ratio.""" 16157 entitlementQuantity: Int 16158 16159 """The quantity of prerequisites in the ratio.""" 16160 prerequisiteQuantity: Int 16161 } 16162 16163 """A quantity range within which the price rule is applicable.""" 16164 type PriceRuleQuantityRange { 16165 """The lower bound of the quantity range.""" 16166 greaterThan: Int 16167 16168 """The lower bound or equal of the quantity range.""" 16169 greaterThanOrEqualTo: Int 16170 16171 """The upper bound of the quantity range.""" 16172 lessThan: Int 16173 16174 """The upper bound or equal of the quantity range.""" 16175 lessThanOrEqualTo: Int 16176 } 16177 16178 """ 16179 Specifies the input fields to update the quantity range within which the price rule is applicable. 16180 16181 """ 16182 input PriceRuleQuantityRangeInput { 16183 """The upper bound of the quantity range.""" 16184 lessThan: Int 16185 16186 """The upper or equal bound of the quantity range.""" 16187 lessThanOrEqualTo: Int 16188 16189 """The lower bound of the quantity range.""" 16190 greaterThan: Int 16191 16192 """The lower or equal bound of the quantity range.""" 16193 greaterThanOrEqualTo: Int 16194 } 16195 16196 """Shareable URL for the discount code associated with the price rule.""" 16197 type PriceRuleShareableUrl { 16198 """ 16199 The image URL of the item (product or collection) to which the discount applies. 16200 """ 16201 targetItemImage: Image 16202 16203 """The type of page that's associated with the URL.""" 16204 targetType: PriceRuleShareableUrlTargetType! 16205 16206 """The title of the page that's associated with the URL.""" 16207 title: String! 16208 16209 """The URL for the discount code.""" 16210 url: URL! 16211 } 16212 16213 """Page type where shareable URL lands.""" 16214 enum PriceRuleShareableUrlTargetType { 16215 HOME 16216 PRODUCT 16217 COLLECTION 16218 } 16219 16220 """ 16221 Specifies the input fields to update a price rule shipping entitlement. 16222 """ 16223 input PriceRuleShippingEntitlementsInput { 16224 """Whether the price rule applies to all shipping lines.""" 16225 targetAllShippingLines: Boolean = false 16226 16227 """The codes for the countries to which the price rule applies to.""" 16228 countryCodes: [CountryCode!] 16229 16230 """ 16231 Whether the price rule is applicable to countries that have not been defined in the shop's shipping zones. 16232 """ 16233 includeRestOfWorld: Boolean = false 16234 } 16235 16236 """The shipping lines to which the price rule applies to.""" 16237 type PriceRuleShippingLineEntitlements { 16238 """The codes for the countries to which the price rule applies to.""" 16239 countryCodes: [CountryCode!]! 16240 16241 """ 16242 Whether the price rule is applicable to countries that have not been defined in the shop's shipping zones. 16243 """ 16244 includeRestOfWorld: Boolean! 16245 16246 """Whether the price rule applies to all shipping lines.""" 16247 targetAllShippingLines: Boolean! 16248 } 16249 16250 """The set of valid sort keys for the PriceRule query.""" 16251 enum PriceRuleSortKeys { 16252 """Sort by the `starts_at` value.""" 16253 STARTS_AT 16254 16255 """Sort by the `ends_at` value.""" 16256 ENDS_AT 16257 16258 """Sort by the `title` value.""" 16259 TITLE 16260 16261 """Sort by the `created_at` value.""" 16262 CREATED_AT 16263 16264 """Sort by the `updated_at` value.""" 16265 UPDATED_AT 16266 16267 """Sort by the `id` value.""" 16268 ID 16269 16270 """ 16271 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 16272 results by relevance to the search term(s). When no search query is specified, this sort key is not 16273 deterministic and should not be used. 16274 16275 """ 16276 RELEVANCE 16277 } 16278 16279 """The status of the price rule.""" 16280 enum PriceRuleStatus { 16281 ACTIVE 16282 EXPIRED 16283 SCHEDULED 16284 } 16285 16286 """ 16287 The type of lines (line_item or shipping_line) to which the price rule applies. 16288 """ 16289 enum PriceRuleTarget { 16290 """The price rule applies to line items.""" 16291 LINE_ITEM 16292 16293 """The price rule applies to shipping lines.""" 16294 SHIPPING_LINE 16295 } 16296 16297 """A list of features used by the price rule.""" 16298 enum PriceRuleTrait { 16299 """The price rule supports quantity BXGY discounts.""" 16300 BUY_ONE_GET_ONE 16301 16302 """The price rule supports BXGY discounts using custom allocation limit.""" 16303 BUY_ONE_GET_ONE_WITH_ALLOCATION_LIMIT 16304 16305 """The price rule supports bulk discounts.""" 16306 BULK 16307 16308 """The price rule supports specific customers.""" 16309 SPECIFIC_CUSTOMERS 16310 16311 """The price rule supports quantity discounts.""" 16312 QUANTITY_DISCOUNTS 16313 } 16314 16315 """Return type for `priceRuleUpdate` mutation.""" 16316 type PriceRuleUpdatePayload { 16317 """The updated price rule.""" 16318 priceRule: PriceRule 16319 16320 """The updated discount code.""" 16321 priceRuleDiscountCode: PriceRuleDiscountCode 16322 16323 """List of errors that occurred executing the mutation.""" 16324 priceRuleUserErrors: [PriceRuleUserError!]! 16325 16326 """List of errors that occurred executing the mutation.""" 16327 userErrors: [UserError!]! @deprecated(reason: "Use `priceRuleUserErrors` instead") 16328 } 16329 16330 """ 16331 Represents an error that happens during execution of a price rule mutation. 16332 """ 16333 type PriceRuleUserError implements DisplayableError { 16334 """Error code to uniquely identify the error.""" 16335 code: PriceRuleErrorCode 16336 16337 """Path to the input field which caused the error.""" 16338 field: [String!] 16339 16340 """The error message.""" 16341 message: String! 16342 } 16343 16344 """A time period during which a price rule is applicable.""" 16345 type PriceRuleValidityPeriod { 16346 """The time after which the price rule becomes invalid.""" 16347 end: DateTime 16348 16349 """The time after which the price rule is valid.""" 16350 start: DateTime! 16351 } 16352 16353 """ 16354 Specifies the input fields to update the validity period of a price rule. 16355 """ 16356 input PriceRuleValidityPeriodInput { 16357 """The time after which the price rule is valid.""" 16358 start: DateTime! 16359 16360 """The time after which the price rule becomes invalid.""" 16361 end: DateTime 16362 } 16363 16364 """The value of the price rule.""" 16365 union PriceRuleValue = PriceRuleFixedAmountValue | PriceRulePercentValue 16366 16367 """Specifies the input fields to update a price rule.""" 16368 input PriceRuleValueInput { 16369 """The percentage value of the price rule.""" 16370 percentageValue: Float 16371 16372 """The fixed amount value of the price rule.""" 16373 fixedAmountValue: Money 16374 } 16375 16376 """The value of the percentage pricing object.""" 16377 type PricingPercentageValue { 16378 """The percentage value of the object.""" 16379 percentage: Float! 16380 } 16381 16382 """The value of the pricing object.""" 16383 union PricingValue = MoneyV2 | PricingPercentageValue 16384 16385 """ 16386 Private metafields represent custom metadata that is attached to a resource. 16387 Private metafields are private to the application that creates them on a shop's resources. 16388 16389 """ 16390 type PrivateMetafield implements Node { 16391 """The date and time when the private metafield was created.""" 16392 createdAt: DateTime! 16393 16394 """The id of the private metafield.""" 16395 id: ID! 16396 16397 """The key name for a private metafield.""" 16398 key: String! 16399 16400 """The namespace for a private metafield.""" 16401 namespace: String! 16402 16403 """The date and time when the private metafield was updated.""" 16404 updatedAt: DateTime! 16405 16406 """The value of a private metafield.""" 16407 value: String! 16408 16409 """Represents the private metafield value type.""" 16410 valueType: PrivateMetafieldValueType! 16411 } 16412 16413 """ 16414 An auto-generated type for paginating through multiple PrivateMetafields. 16415 16416 """ 16417 type PrivateMetafieldConnection { 16418 """A list of edges.""" 16419 edges: [PrivateMetafieldEdge!]! 16420 16421 """Information to aid in pagination.""" 16422 pageInfo: PageInfo! 16423 } 16424 16425 """ 16426 Specifies the input fields for a PrivateMetafield. 16427 16428 """ 16429 input PrivateMetafieldDeleteInput { 16430 """The ID of the owning resource.""" 16431 owner: ID 16432 16433 """The namespace for the private metafield.""" 16434 namespace: String! 16435 16436 """The key for the private metafield.""" 16437 key: String! 16438 } 16439 16440 """Return type for `privateMetafieldDelete` mutation.""" 16441 type PrivateMetafieldDeletePayload { 16442 """The ID of private metafield that was deleted.""" 16443 deletedPrivateMetafieldId: ID 16444 16445 """List of errors that occurred executing the mutation.""" 16446 userErrors: [UserError!]! 16447 } 16448 16449 """ 16450 An auto-generated type which holds one PrivateMetafield and a cursor during pagination. 16451 16452 """ 16453 type PrivateMetafieldEdge { 16454 """A cursor for use in pagination.""" 16455 cursor: String! 16456 16457 """The item at the end of PrivateMetafieldEdge.""" 16458 node: PrivateMetafield! 16459 } 16460 16461 """ 16462 Specifies the input fields for a PrivateMetafield. 16463 16464 """ 16465 input PrivateMetafieldInput { 16466 """The owning resource.""" 16467 owner: ID 16468 16469 """The namespace for the private metafield.""" 16470 namespace: String! 16471 16472 """The key for the private metafield.""" 16473 key: String! 16474 16475 """ 16476 The value and value type of the metafield, wrapped in a ValueInput object. 16477 """ 16478 valueInput: PrivateMetafieldValueInput! 16479 } 16480 16481 """Return type for `privateMetafieldUpsert` mutation.""" 16482 type PrivateMetafieldUpsertPayload { 16483 """The private metafield that was created or updated.""" 16484 privateMetafield: PrivateMetafield 16485 16486 """List of errors that occurred executing the mutation.""" 16487 userErrors: [UserError!]! 16488 } 16489 16490 """ 16491 Value Input wraps two fields of Private Metafields into one. Those fields are value and value_type. 16492 16493 """ 16494 input PrivateMetafieldValueInput { 16495 """The value of a private metafield.""" 16496 value: String! 16497 16498 """Represents the private metafield value type.""" 16499 valueType: PrivateMetafieldValueType! 16500 } 16501 16502 """Private Metafield value types.""" 16503 enum PrivateMetafieldValueType { 16504 """A string metafield.""" 16505 STRING 16506 16507 """An integer metafield.""" 16508 INTEGER 16509 16510 """A JSON string metafield.""" 16511 JSON_STRING 16512 } 16513 16514 """ 16515 Represents a product, including information about related collections and product variants. 16516 """ 16517 type Product implements Node & Navigable & HasMetafields & HasPublishedTranslations & Publishable & OnlineStorePreviewable & LegacyInteroperability { 16518 """ 16519 The number of publications a resource is published to without feedback errors. 16520 """ 16521 availablePublicationCount: Int! 16522 16523 """The description of the product, complete with HTML formatting.""" 16524 bodyHtml: String @deprecated(reason: "Use `descriptionHtml` instead") 16525 16526 """A list of the collections that include the product.""" 16527 collections( 16528 """Returns up to the first `n` elements from the list.""" 16529 first: Int 16530 16531 """Returns the elements that come after the specified cursor.""" 16532 after: String 16533 16534 """Returns up to the last `n` elements from the list.""" 16535 last: Int 16536 16537 """Returns the elements that come before the specified cursor.""" 16538 before: String 16539 16540 """Reverse the order of the underlying list.""" 16541 reverse: Boolean = false 16542 16543 """Sort the underlying list by the given key.""" 16544 sortKey: CollectionSortKeys = ID 16545 16546 """ 16547 Supported filter parameters: 16548 - `collection_type` 16549 - `publishable_status` 16550 - `published_status` 16551 - `title` 16552 - `updated_at` 16553 16554 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 16555 for more information about using filters. 16556 16557 """ 16558 query: String 16559 ): CollectionConnection! 16560 16561 """ 16562 The date and time ([ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601)) when the product was created. 16563 16564 """ 16565 createdAt: DateTime! 16566 16567 """A default cursor for use in pagination.""" 16568 defaultCursor: String! 16569 16570 """ 16571 A stripped description of the product, single line with HTML tags removed. 16572 """ 16573 description( 16574 """Truncates string after the given length.""" 16575 truncateAt: Int 16576 ): String! 16577 16578 """The description of the product, complete with HTML formatting.""" 16579 descriptionHtml: HTML! 16580 16581 """ 16582 Stripped description of the product, single line with HTML tags removed. 16583 Truncated to 60 characters. 16584 16585 """ 16586 descriptionPlainSummary: String! @deprecated(reason: "Use `description` instead") 16587 16588 """The featured image for the product.""" 16589 featuredImage: Image 16590 16591 """The featured media for the product.""" 16592 featuredMedia: Media 16593 16594 """ 16595 Information about the product that's provided through resource feedback. 16596 """ 16597 feedback: ResourceFeedback 16598 16599 """The theme template used when viewing the gift card in a store.""" 16600 giftCardTemplateSuffix: String 16601 16602 """A unique human-friendly string of the product's title.""" 16603 handle: String! 16604 16605 """ 16606 Whether the product has only a single variant with the default option and value. 16607 """ 16608 hasOnlyDefaultVariant: Boolean! 16609 16610 """Whether the product has out of stock variants.""" 16611 hasOutOfStockVariants: Boolean! 16612 16613 """Globally unique identifier.""" 16614 id: ID! 16615 16616 """The images associated with the product.""" 16617 images( 16618 """Returns up to the first `n` elements from the list.""" 16619 first: Int 16620 16621 """Returns the elements that come after the specified cursor.""" 16622 after: String 16623 16624 """Returns up to the last `n` elements from the list.""" 16625 last: Int 16626 16627 """Returns the elements that come before the specified cursor.""" 16628 before: String 16629 16630 """Reverse the order of the underlying list.""" 16631 reverse: Boolean = false 16632 16633 """Sort the underlying list by the given key.""" 16634 sortKey: ProductImageSortKeys = POSITION 16635 16636 """ 16637 Image width in pixels between 1 and 2048. This argument is deprecated: Use `maxWidth` on `Image.transformedSrc` instead. 16638 """ 16639 maxWidth: Int 16640 16641 """ 16642 Image height in pixels between 1 and 2048. This argument is deprecated: Use `maxHeight` on `Image.transformedSrc` instead. 16643 """ 16644 maxHeight: Int 16645 16646 """ 16647 Crops the image according to the specified region. This argument is deprecated: Use `crop` on `Image.transformedSrc` instead. 16648 """ 16649 crop: CropRegion 16650 16651 """ 16652 Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use `scale` on `Image.transformedSrc` instead. 16653 """ 16654 scale: Int = 1 16655 ): ImageConnection! 16656 16657 """Whether the product is in a given collection.""" 16658 inCollection( 16659 """The ID of the collection to check.""" 16660 id: ID! 16661 ): Boolean! 16662 16663 """Whether the product is a gift card.""" 16664 isGiftCard: Boolean! 16665 16666 """The ID of the corresponding resource in the REST Admin API.""" 16667 legacyResourceId: UnsignedInt64! 16668 16669 """The media associated with the product.""" 16670 media( 16671 """Returns up to the first `n` elements from the list.""" 16672 first: Int 16673 16674 """Returns the elements that come after the specified cursor.""" 16675 after: String 16676 16677 """Returns up to the last `n` elements from the list.""" 16678 last: Int 16679 16680 """Returns the elements that come before the specified cursor.""" 16681 before: String 16682 16683 """Reverse the order of the underlying list.""" 16684 reverse: Boolean = false 16685 16686 """Sort the underlying list by the given key.""" 16687 sortKey: ProductMediaSortKeys = POSITION 16688 ): MediaConnection! 16689 16690 """Total count of media belonging to a product.""" 16691 mediaCount: Int! 16692 16693 """The metafield associated with the resource.""" 16694 metafield( 16695 """Container for a set of metafields (maximum of 20 characters).""" 16696 namespace: String! 16697 16698 """Identifier for the metafield (maximum of 30 characters).""" 16699 key: String! 16700 ): Metafield 16701 16702 """A paginated list of metafields associated with the resource.""" 16703 metafields( 16704 """Finds all metafields with a specific namespace under the resource.""" 16705 namespace: String 16706 16707 """Returns up to the first `n` elements from the list.""" 16708 first: Int 16709 16710 """Returns the elements that come after the specified cursor.""" 16711 after: String 16712 16713 """Returns up to the last `n` elements from the list.""" 16714 last: Int 16715 16716 """Returns the elements that come before the specified cursor.""" 16717 before: String 16718 16719 """Reverse the order of the underlying list.""" 16720 reverse: Boolean = false 16721 ): MetafieldConnection! 16722 16723 """The online store preview URL.""" 16724 onlineStorePreviewUrl: URL 16725 16726 """ 16727 The online store URL for the product. 16728 A value of `null` indicates that the product is not published to the Online Store sales channel. 16729 16730 """ 16731 onlineStoreUrl: URL 16732 16733 """ 16734 A list of product options. The limit is specified by Shop.resourceLimits.maxProductOptions. 16735 """ 16736 options( 16737 """Truncate the array result to this size.""" 16738 first: Int 16739 ): [ProductOption!]! 16740 16741 """The price range of the product.""" 16742 priceRange: ProductPriceRange! @deprecated(reason: "Deprecated in API version 2020-10. Use `priceRangeV2` instead.") 16743 16744 """The price range of the product with prices formatted as decimals.""" 16745 priceRangeV2: ProductPriceRangeV2! 16746 16747 """Returns a private metafield found by namespace and key.""" 16748 privateMetafield( 16749 """The namespace for the private metafield.""" 16750 namespace: String! 16751 16752 """The key for the private metafield.""" 16753 key: String! 16754 ): PrivateMetafield 16755 16756 """List of private metafields.""" 16757 privateMetafields( 16758 """Filter the private metafields by namespace.""" 16759 namespace: String 16760 16761 """Returns up to the first `n` elements from the list.""" 16762 first: Int 16763 16764 """Returns the elements that come after the specified cursor.""" 16765 after: String 16766 16767 """Returns up to the last `n` elements from the list.""" 16768 last: Int 16769 16770 """Returns the elements that come before the specified cursor.""" 16771 before: String 16772 16773 """Reverse the order of the underlying list.""" 16774 reverse: Boolean = false 16775 ): PrivateMetafieldConnection! 16776 16777 """A list of the channels where the product is published.""" 16778 productPublications( 16779 """Returns up to the first `n` elements from the list.""" 16780 first: Int 16781 16782 """Returns the elements that come after the specified cursor.""" 16783 after: String 16784 16785 """Returns up to the last `n` elements from the list.""" 16786 last: Int 16787 16788 """Returns the elements that come before the specified cursor.""" 16789 before: String 16790 16791 """Reverse the order of the underlying list.""" 16792 reverse: Boolean = false 16793 ): ProductPublicationConnection! @deprecated(reason: "Use `resourcePublications` instead") 16794 16795 """The product type specified by the merchant.""" 16796 productType: String! 16797 16798 """The number of publications a resource is published on.""" 16799 publicationCount( 16800 """ 16801 Include only the resource's publications that are published. If false, then return all the resource's publications including future publications. 16802 """ 16803 onlyPublished: Boolean = true 16804 ): Int! 16805 16806 """A list of the channels where the product is published.""" 16807 publications( 16808 """ 16809 Return only the publications that are published. If false, then return all publications. 16810 """ 16811 onlyPublished: Boolean = true 16812 16813 """Returns up to the first `n` elements from the list.""" 16814 first: Int 16815 16816 """Returns the elements that come after the specified cursor.""" 16817 after: String 16818 16819 """Returns up to the last `n` elements from the list.""" 16820 last: Int 16821 16822 """Returns the elements that come before the specified cursor.""" 16823 before: String 16824 16825 """Reverse the order of the underlying list.""" 16826 reverse: Boolean = false 16827 ): ProductPublicationConnection! @deprecated(reason: "Use `resourcePublications` instead") 16828 16829 """ 16830 The date and time ([ISO 8601 format](http://en.wikipedia.org/wiki/ISO_8601)) when the product was published to the Online Store. 16831 16832 """ 16833 publishedAt: DateTime 16834 16835 """Check to see whether the resource is published to a given channel.""" 16836 publishedOnChannel( 16837 """The ID of the channel to check.""" 16838 channelId: ID! 16839 ): Boolean! @deprecated(reason: "Use `publishedOnPublication` instead") 16840 16841 """ 16842 Check to see whether the resource is published to the calling app's channel. 16843 """ 16844 publishedOnCurrentChannel: Boolean! @deprecated(reason: "Use `publishedOnCurrentPublication` instead") 16845 16846 """ 16847 Check to see whether the resource is published to the calling app's publication. 16848 """ 16849 publishedOnCurrentPublication: Boolean! 16850 16851 """Check to see whether the resource is published to a given publication.""" 16852 publishedOnPublication( 16853 """The ID of the publication to check.""" 16854 publicationId: ID! 16855 ): Boolean! 16856 16857 """Whether the product can only be purchased with a selling plan.""" 16858 requiresSellingPlan: Boolean! 16859 16860 """The list of resources that are published to a publication.""" 16861 resourcePublications( 16862 """ 16863 Whether to return only the resources that are currently published. If false, then also returns the resources that are scheduled to be published. 16864 16865 """ 16866 onlyPublished: Boolean = true 16867 16868 """Returns up to the first `n` elements from the list.""" 16869 first: Int 16870 16871 """Returns the elements that come after the specified cursor.""" 16872 after: String 16873 16874 """Returns up to the last `n` elements from the list.""" 16875 last: Int 16876 16877 """Returns the elements that come before the specified cursor.""" 16878 before: String 16879 16880 """Reverse the order of the underlying list.""" 16881 reverse: Boolean = false 16882 ): ResourcePublicationConnection! 16883 16884 """ 16885 The list of resources that are either published or staged to be published to a publication. 16886 """ 16887 resourcePublicationsV2( 16888 """ 16889 Whether to return only the resources that are currently published. If false, then also returns the resources that are scheduled or staged to be published. 16890 16891 """ 16892 onlyPublished: Boolean = true 16893 16894 """Returns up to the first `n` elements from the list.""" 16895 first: Int 16896 16897 """Returns the elements that come after the specified cursor.""" 16898 after: String 16899 16900 """Returns up to the last `n` elements from the list.""" 16901 last: Int 16902 16903 """Returns the elements that come before the specified cursor.""" 16904 before: String 16905 16906 """Reverse the order of the underlying list.""" 16907 reverse: Boolean = false 16908 ): ResourcePublicationV2Connection! 16909 16910 """Count of selling plan groups associated with the product.""" 16911 sellingPlanGroupCount: Int! 16912 16913 """SEO information of the product.""" 16914 seo: SEO! 16915 16916 """The product status.""" 16917 status: ProductStatus! 16918 16919 """The storefront ID of the product.""" 16920 storefrontId: StorefrontID! 16921 16922 """A comma separated list of tags that have been added to the product.""" 16923 tags: [String!]! 16924 16925 """The theme template used when viewing the product in a store.""" 16926 templateSuffix: String 16927 16928 """The title of the product.""" 16929 title: String! 16930 16931 """The quantity of inventory in stock.""" 16932 totalInventory: Int! 16933 16934 """The number of variants that are associated with the product.""" 16935 totalVariants: Int! 16936 16937 """Whether inventory tracking has been enabled for the product.""" 16938 tracksInventory: Boolean! 16939 16940 """The translations associated with the resource.""" 16941 translations( 16942 """Filters translations locale.""" 16943 locale: String! 16944 ): [PublishedTranslation!]! 16945 16946 """The list of channels that the resource is not published to.""" 16947 unpublishedChannels( 16948 """Returns up to the first `n` elements from the list.""" 16949 first: Int 16950 16951 """Returns the elements that come after the specified cursor.""" 16952 after: String 16953 16954 """Returns up to the last `n` elements from the list.""" 16955 last: Int 16956 16957 """Returns the elements that come before the specified cursor.""" 16958 before: String 16959 16960 """Reverse the order of the underlying list.""" 16961 reverse: Boolean = false 16962 ): ChannelConnection! @deprecated(reason: "Use `unpublishedPublications` instead") 16963 16964 """The list of publications that the resource is not published to.""" 16965 unpublishedPublications( 16966 """Returns up to the first `n` elements from the list.""" 16967 first: Int 16968 16969 """Returns the elements that come after the specified cursor.""" 16970 after: String 16971 16972 """Returns up to the last `n` elements from the list.""" 16973 last: Int 16974 16975 """Returns the elements that come before the specified cursor.""" 16976 before: String 16977 16978 """Reverse the order of the underlying list.""" 16979 reverse: Boolean = false 16980 ): PublicationConnection! 16981 16982 """ 16983 The date and time when the product was last modified. 16984 A product's `updatedAt` value can change for different reasons. For example, if an order 16985 is placed for a product that has inventory tracking set up, then the inventory adjustment 16986 is counted as an update. 16987 16988 """ 16989 updatedAt: DateTime! 16990 16991 """A list of variants associated with the product.""" 16992 variants( 16993 """Returns up to the first `n` elements from the list.""" 16994 first: Int 16995 16996 """Returns the elements that come after the specified cursor.""" 16997 after: String 16998 16999 """Returns up to the last `n` elements from the list.""" 17000 last: Int 17001 17002 """Returns the elements that come before the specified cursor.""" 17003 before: String 17004 17005 """Reverse the order of the underlying list.""" 17006 reverse: Boolean = false 17007 17008 """Sort the underlying list by the given key.""" 17009 sortKey: ProductVariantSortKeys = POSITION 17010 ): ProductVariantConnection! 17011 17012 """The name of the product's vendor.""" 17013 vendor: String! 17014 } 17015 17016 """Specifies product images to append.""" 17017 input ProductAppendImagesInput { 17018 """The ID of the product.""" 17019 id: ID! 17020 17021 """The images to be appended to the product.""" 17022 images: [ImageInput!]! 17023 } 17024 17025 """Return type for `productAppendImages` mutation.""" 17026 type ProductAppendImagesPayload { 17027 """List of new images appended to the product.""" 17028 newImages( 17029 """ 17030 Image width in pixels between 1 and 2048. This argument is deprecated: Use `maxWidth` on `Image.transformedSrc` instead. 17031 """ 17032 maxWidth: Int 17033 17034 """ 17035 Image height in pixels between 1 and 2048. This argument is deprecated: Use `maxHeight` on `Image.transformedSrc` instead. 17036 """ 17037 maxHeight: Int 17038 17039 """ 17040 Crops the image according to the specified region. This argument is deprecated: Use `crop` on `Image.transformedSrc` instead. 17041 """ 17042 crop: CropRegion 17043 17044 """ 17045 Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use `scale` on `Image.transformedSrc` instead. 17046 """ 17047 scale: Int = 1 17048 ): [Image!] 17049 17050 """The product object.""" 17051 product: Product 17052 17053 """List of errors that occurred executing the mutation.""" 17054 userErrors: [UserError!]! 17055 } 17056 17057 """Return type for `productChangeStatus` mutation.""" 17058 type ProductChangeStatusPayload { 17059 """The product object.""" 17060 product: Product 17061 17062 """List of errors that occurred executing the mutation.""" 17063 userErrors: [ProductChangeStatusUserError!]! 17064 } 17065 17066 """An error that occurs during the execution of ProductChangeStatus.""" 17067 type ProductChangeStatusUserError implements DisplayableError { 17068 """Error code to uniquely identify the error.""" 17069 code: ProductChangeStatusUserErrorCode 17070 17071 """Path to the input field which caused the error.""" 17072 field: [String!] 17073 17074 """The error message.""" 17075 message: String! 17076 } 17077 17078 """ 17079 Possible error codes that could be returned by ProductChangeStatusUserError. 17080 """ 17081 enum ProductChangeStatusUserErrorCode { 17082 """Product could not be found.""" 17083 PRODUCT_NOT_FOUND 17084 } 17085 17086 """The set of valid sort keys for the ProductCollection query.""" 17087 enum ProductCollectionSortKeys { 17088 """Sort by the `title` value.""" 17089 TITLE 17090 17091 """Sort by the `price` value.""" 17092 PRICE 17093 17094 """Sort by the `best-selling` value.""" 17095 BEST_SELLING 17096 17097 """Sort by the `created` value.""" 17098 CREATED 17099 17100 """Sort by the `id` value.""" 17101 ID 17102 17103 """Sort by the `manual` value.""" 17104 MANUAL 17105 17106 """Sort by the `collection-default` value.""" 17107 COLLECTION_DEFAULT 17108 17109 """ 17110 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 17111 results by relevance to the search term(s). When no search query is specified, this sort key is not 17112 deterministic and should not be used. 17113 17114 """ 17115 RELEVANCE 17116 } 17117 17118 """ 17119 An auto-generated type for paginating through multiple Products. 17120 17121 """ 17122 type ProductConnection { 17123 """A list of edges.""" 17124 edges: [ProductEdge!]! 17125 17126 """Information to aid in pagination.""" 17127 pageInfo: PageInfo! 17128 } 17129 17130 """Return type for `productCreateMedia` mutation.""" 17131 type ProductCreateMediaPayload { 17132 """The newly created media.""" 17133 media: [Media!] 17134 17135 """List of errors that occurred executing the mutation.""" 17136 mediaUserErrors: [MediaUserError!]! 17137 17138 """The product associated with the media.""" 17139 product: Product 17140 17141 """List of errors that occurred executing the mutation.""" 17142 userErrors: [UserError!]! @deprecated(reason: "Use `mediaUserErrors` instead") 17143 } 17144 17145 """Return type for `productCreate` mutation.""" 17146 type ProductCreatePayload { 17147 """The product object.""" 17148 product: Product 17149 17150 """The shop associated with the product.""" 17151 shop: Shop! 17152 17153 """List of errors that occurred executing the mutation.""" 17154 userErrors: [UserError!]! 17155 } 17156 17157 """Return type for `productDeleteImages` mutation.""" 17158 type ProductDeleteImagesPayload { 17159 """This is an array of IDs of images to delete.""" 17160 deletedImageIds: [ID!]! 17161 17162 """This is the product object.""" 17163 product: Product 17164 17165 """List of errors that occurred executing the mutation.""" 17166 userErrors: [UserError!]! 17167 } 17168 17169 """Specifies the product to delete.""" 17170 input ProductDeleteInput { 17171 """The ID of the product.""" 17172 id: ID! 17173 } 17174 17175 """Return type for `productDeleteMedia` mutation.""" 17176 type ProductDeleteMediaPayload { 17177 """List of media IDs which were deleted.""" 17178 deletedMediaIds: [ID!] 17179 17180 """List of product image IDs which were deleted.""" 17181 deletedProductImageIds: [ID!] 17182 17183 """List of errors that occurred executing the mutation.""" 17184 mediaUserErrors: [MediaUserError!]! 17185 17186 """The product which media was deleted from.""" 17187 product: Product 17188 17189 """List of errors that occurred executing the mutation.""" 17190 userErrors: [UserError!]! @deprecated(reason: "Use `mediaUserErrors` instead") 17191 } 17192 17193 """Return type for `productDelete` mutation.""" 17194 type ProductDeletePayload { 17195 """The ID of the deleted product.""" 17196 deletedProductId: ID 17197 17198 """The shop associated with the product.""" 17199 shop: Shop! 17200 17201 """List of errors that occurred executing the mutation.""" 17202 userErrors: [UserError!]! 17203 } 17204 17205 """Return type for `productDuplicate` mutation.""" 17206 type ProductDuplicatePayload { 17207 """The asynchronous job duplicating the product images.""" 17208 imageJob: Job 17209 17210 """The duplicated product.""" 17211 newProduct: Product 17212 17213 """The user's shop.""" 17214 shop: Shop! 17215 17216 """List of errors that occurred executing the mutation.""" 17217 userErrors: [UserError!]! 17218 } 17219 17220 """ 17221 An auto-generated type which holds one Product and a cursor during pagination. 17222 17223 """ 17224 type ProductEdge { 17225 """A cursor for use in pagination.""" 17226 cursor: String! 17227 17228 """The item at the end of ProductEdge.""" 17229 node: Product! 17230 } 17231 17232 """The set of valid sort keys for the ProductImage query.""" 17233 enum ProductImageSortKeys { 17234 """Sort by the `created_at` value.""" 17235 CREATED_AT 17236 17237 """Sort by the `position` value.""" 17238 POSITION 17239 17240 """Sort by the `id` value.""" 17241 ID 17242 17243 """ 17244 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 17245 results by relevance to the search term(s). When no search query is specified, this sort key is not 17246 deterministic and should not be used. 17247 17248 """ 17249 RELEVANCE 17250 } 17251 17252 """Return type for `productImageUpdate` mutation.""" 17253 type ProductImageUpdatePayload { 17254 """Image updated.""" 17255 image( 17256 """ 17257 Image width in pixels between 1 and 2048. This argument is deprecated: Use `maxWidth` on `Image.transformedSrc` instead. 17258 """ 17259 maxWidth: Int 17260 17261 """ 17262 Image height in pixels between 1 and 2048. This argument is deprecated: Use `maxHeight` on `Image.transformedSrc` instead. 17263 """ 17264 maxHeight: Int 17265 17266 """ 17267 Crops the image according to the specified region. This argument is deprecated: Use `crop` on `Image.transformedSrc` instead. 17268 """ 17269 crop: CropRegion 17270 17271 """ 17272 Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use `scale` on `Image.transformedSrc` instead. 17273 """ 17274 scale: Int = 1 17275 ): Image 17276 17277 """List of errors that occurred executing the mutation.""" 17278 userErrors: [UserError!]! 17279 } 17280 17281 """Specifies the input fields required to create a product.""" 17282 input ProductInput { 17283 """The description of the product, complete with HTML formatting.""" 17284 descriptionHtml: String 17285 17286 """ 17287 A unique human-friendly string for the product. Automatically generated from the product's title. 17288 17289 """ 17290 handle: String 17291 17292 """ 17293 Whether a redirect is required after a new handle has been provided. 17294 If true, then the old handle is redirected to the new one automatically. 17295 17296 """ 17297 redirectNewHandle: Boolean = false 17298 17299 """The SEO information associated with the product.""" 17300 seo: SEOInput 17301 17302 """The product type specified by the merchant.""" 17303 productType: String 17304 17305 """A comma separated list tags that have been added to the product.""" 17306 tags: [String!] 17307 17308 """The theme template used when viewing the product in a store.""" 17309 templateSuffix: String 17310 17311 """Whether the product is a gift card.""" 17312 giftCard: Boolean 17313 17314 """The theme template used when viewing the gift card in a store.""" 17315 giftCardTemplateSuffix: String 17316 17317 """The title of the product.""" 17318 title: String 17319 17320 """The name of the product's vendor.""" 17321 vendor: String 17322 17323 """ 17324 A description of the product. Supports HTML formatting. This argument is deprecated: Use `descriptionHtml` instead. 17325 """ 17326 bodyHtml: String 17327 17328 """The IDs of the collections that this product will be added to.""" 17329 collectionsToJoin: [ID!] 17330 17331 """The IDs of collections that will no longer include the product.""" 17332 collectionsToLeave: [ID!] 17333 17334 """ 17335 Specifies the product to update in productUpdate or creates a new product if absent in productCreate. 17336 """ 17337 id: ID 17338 17339 """The images to associate with the product.""" 17340 images: [ImageInput!] 17341 17342 """The metafields to associate with this product.""" 17343 metafields: [MetafieldInput!] 17344 17345 """The private metafields to associated with this product.""" 17346 privateMetafields: [PrivateMetafieldInput!] 17347 17348 """List of custom product options (maximum of 3 per product).""" 17349 options: [String!] 17350 17351 """ 17352 A list of the channels where the product is published. This argument is deprecated: Use `PublishablePublish` instead. 17353 """ 17354 productPublications: [ProductPublicationInput!] 17355 17356 """ 17357 A list of the channels where the product is published. This argument is deprecated: Use `PublishablePublish` instead. 17358 """ 17359 publications: [ProductPublicationInput!] 17360 17361 """ 17362 Only products with an active status can be published. This argument is deprecated: Use `PublishablePublish` instead. 17363 """ 17364 publishDate: DateTime 17365 17366 """ 17367 Only products with an active status can be published. This argument is deprecated: Use `PublishablePublish` instead. 17368 """ 17369 publishOn: DateTime 17370 17371 """ 17372 Only products with an active status can be published. This argument is deprecated: Use `PublishablePublish` instead. 17373 """ 17374 published: Boolean 17375 17376 """ 17377 Only products with an active status can be published. This argument is deprecated: Use `PublishablePublish` instead. 17378 """ 17379 publishedAt: DateTime 17380 17381 """A list of variants associated with the product.""" 17382 variants: [ProductVariantInput!] 17383 17384 """The status of the product.""" 17385 status: ProductStatus 17386 17387 """ 17388 Whether the product can only be purchased with a selling plan. If set to `true` on an already existing product, then the product will be marked unavailable on channels that don't support subscriptions. 17389 """ 17390 requiresSellingPlan: Boolean 17391 } 17392 17393 """Return type for `productJoinSellingPlanGroups` mutation.""" 17394 type ProductJoinSellingPlanGroupsPayload { 17395 """The product object.""" 17396 product: Product 17397 17398 """List of errors that occurred executing the mutation.""" 17399 userErrors: [SellingPlanGroupUserError!]! 17400 } 17401 17402 """Return type for `productLeaveSellingPlanGroups` mutation.""" 17403 type ProductLeaveSellingPlanGroupsPayload { 17404 """The product object.""" 17405 product: Product 17406 17407 """List of errors that occurred executing the mutation.""" 17408 userErrors: [SellingPlanGroupUserError!]! 17409 } 17410 17411 """The set of valid sort keys for the ProductMedia query.""" 17412 enum ProductMediaSortKeys { 17413 """Sort by the `position` value.""" 17414 POSITION 17415 17416 """Sort by the `id` value.""" 17417 ID 17418 17419 """ 17420 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 17421 results by relevance to the search term(s). When no search query is specified, this sort key is not 17422 deterministic and should not be used. 17423 17424 """ 17425 RELEVANCE 17426 } 17427 17428 """ 17429 Product property names like "Size", "Color", and "Material". 17430 Variants are selected based on permutations of these options. 17431 255 characters limit each. 17432 17433 """ 17434 type ProductOption implements Node & HasPublishedTranslations { 17435 """Globally unique identifier.""" 17436 id: ID! 17437 17438 """The product option’s name.""" 17439 name: String! 17440 17441 """The product option's position.""" 17442 position: Int! 17443 17444 """The translations associated with the resource.""" 17445 translations( 17446 """Filters translations locale.""" 17447 locale: String! 17448 ): [PublishedTranslation!]! 17449 17450 """The corresponding value to the product option name.""" 17451 values: [String!]! 17452 } 17453 17454 """The price range of the product.""" 17455 type ProductPriceRange { 17456 """The highest variant's price.""" 17457 maxVariantPrice: MoneyV2! 17458 17459 """The lowest variant's price.""" 17460 minVariantPrice: MoneyV2! 17461 } 17462 17463 """The price range of the product.""" 17464 type ProductPriceRangeV2 { 17465 """The highest variant's price.""" 17466 maxVariantPrice: MoneyV2! 17467 17468 """The lowest variant's price.""" 17469 minVariantPrice: MoneyV2! 17470 } 17471 17472 """Represents the channels where a product is published.""" 17473 type ProductPublication { 17474 """The channel where the product was or is published.""" 17475 channel: Channel! 17476 17477 """Whether the publication is published or not.""" 17478 isPublished: Boolean! 17479 17480 """The product that was or is going to be published on the channel.""" 17481 product: Product! 17482 17483 """ 17484 The date that the product was or is going to be published on the channel. 17485 """ 17486 publishDate: DateTime 17487 } 17488 17489 """ 17490 An auto-generated type for paginating through multiple ProductPublications. 17491 17492 """ 17493 type ProductPublicationConnection { 17494 """A list of edges.""" 17495 edges: [ProductPublicationEdge!]! 17496 17497 """Information to aid in pagination.""" 17498 pageInfo: PageInfo! 17499 } 17500 17501 """ 17502 An auto-generated type which holds one ProductPublication and a cursor during pagination. 17503 17504 """ 17505 type ProductPublicationEdge { 17506 """A cursor for use in pagination.""" 17507 cursor: String! 17508 17509 """The item at the end of ProductPublicationEdge.""" 17510 node: ProductPublication! 17511 } 17512 17513 """Specifies a publication to which a product will be published.""" 17514 input ProductPublicationInput { 17515 """ID of the publication.""" 17516 publicationId: ID 17517 17518 """ 17519 ID of the channel. This argument is deprecated: Use publicationId instead. 17520 """ 17521 channelId: ID 17522 17523 """This argument is deprecated: Use publicationId instead.""" 17524 channelHandle: String 17525 17526 """The date and time that the product was (or will be) published.""" 17527 publishDate: DateTime 17528 } 17529 17530 """Specifies a product to publish and the channels to publish it to.""" 17531 input ProductPublishInput { 17532 """The product to create or update publications for.""" 17533 id: ID! 17534 17535 """The publication that the product is published to.""" 17536 productPublications: [ProductPublicationInput!]! 17537 } 17538 17539 """Return type for `productPublish` mutation.""" 17540 type ProductPublishPayload { 17541 """The product that has been published.""" 17542 product: Product 17543 17544 """The channels where the product is published.""" 17545 productPublications: [ProductPublication!] @deprecated(reason: "Use Product.publications instead.") 17546 17547 """The user's shop.""" 17548 shop: Shop! 17549 17550 """List of errors that occurred executing the mutation.""" 17551 userErrors: [UserError!]! 17552 } 17553 17554 """Return type for `productReorderImages` mutation.""" 17555 type ProductReorderImagesPayload { 17556 """The asynchronous job reordering the images.""" 17557 job: Job 17558 17559 """List of errors that occurred executing the mutation.""" 17560 userErrors: [UserError!]! 17561 } 17562 17563 """Return type for `productReorderMedia` mutation.""" 17564 type ProductReorderMediaPayload { 17565 """The asynchronous job reordering the media.""" 17566 job: Job 17567 17568 """List of errors that occurred executing the mutation.""" 17569 mediaUserErrors: [MediaUserError!]! 17570 17571 """List of errors that occurred executing the mutation.""" 17572 userErrors: [UserError!]! @deprecated(reason: "Use `mediaUserErrors` instead") 17573 } 17574 17575 """The set of valid sort keys for the Product query.""" 17576 enum ProductSortKeys { 17577 """Sort by the `title` value.""" 17578 TITLE 17579 17580 """Sort by the `product_type` value.""" 17581 PRODUCT_TYPE 17582 17583 """Sort by the `vendor` value.""" 17584 VENDOR 17585 17586 """Sort by the `inventory_total` value.""" 17587 INVENTORY_TOTAL 17588 17589 """Sort by the `updated_at` value.""" 17590 UPDATED_AT 17591 17592 """Sort by the `created_at` value.""" 17593 CREATED_AT 17594 17595 """Sort by the `published_at` value.""" 17596 PUBLISHED_AT 17597 17598 """Sort by the `id` value.""" 17599 ID 17600 17601 """ 17602 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 17603 results by relevance to the search term(s). When no search query is specified, this sort key is not 17604 deterministic and should not be used. 17605 17606 """ 17607 RELEVANCE 17608 } 17609 17610 """The possible product statuses.""" 17611 enum ProductStatus { 17612 """ 17613 The product is ready to sell and is available to customers on the online store, sales channels, and apps. By default, existing products are set to active. 17614 """ 17615 ACTIVE 17616 17617 """ 17618 The product is no longer being sold and isn't available to customers on sales channels and apps. 17619 """ 17620 ARCHIVED 17621 17622 """ 17623 The product isn't ready to sell and is unavailable to customers on sales channels and apps. By default, duplicated and unarchived products are set to draft. 17624 """ 17625 DRAFT 17626 } 17627 17628 """ 17629 Specifies a product to unpublish from a channel and the sales channels to unpublish it from. 17630 """ 17631 input ProductUnpublishInput { 17632 """The ID of the product to create or update publications for.""" 17633 id: ID! 17634 17635 """The channels to unpublish the product from.""" 17636 productPublications: [ProductPublicationInput!]! 17637 } 17638 17639 """Return type for `productUnpublish` mutation.""" 17640 type ProductUnpublishPayload { 17641 """The product that has been unpublished.""" 17642 product: Product 17643 17644 """The user's shop.""" 17645 shop: Shop! 17646 17647 """List of errors that occurred executing the mutation.""" 17648 userErrors: [UserError!]! 17649 } 17650 17651 """Return type for `productUpdateMedia` mutation.""" 17652 type ProductUpdateMediaPayload { 17653 """The updated media.""" 17654 media: [Media!] 17655 17656 """List of errors that occurred executing the mutation.""" 17657 mediaUserErrors: [MediaUserError!]! 17658 17659 """The product which media was updated on.""" 17660 product: Product 17661 17662 """List of errors that occurred executing the mutation.""" 17663 userErrors: [UserError!]! @deprecated(reason: "Use `mediaUserErrors` instead") 17664 } 17665 17666 """Return type for `productUpdate` mutation.""" 17667 type ProductUpdatePayload { 17668 """The updated product.""" 17669 product: Product 17670 17671 """List of errors that occurred executing the mutation.""" 17672 userErrors: [UserError!]! 17673 } 17674 17675 """Represents a product variant.""" 17676 type ProductVariant implements Node & HasMetafields & HasPublishedTranslations & Navigable & LegacyInteroperability { 17677 """Whether the product variant is available for sale.""" 17678 availableForSale: Boolean! 17679 17680 """The value of the barcode associated with the product.""" 17681 barcode: String 17682 17683 """The compare-at price of the variant in the default shop currency.""" 17684 compareAtPrice: Money 17685 17686 """The date and time when the variant was created.""" 17687 createdAt: DateTime! 17688 17689 """A default cursor for use in pagination.""" 17690 defaultCursor: String! 17691 17692 """The delivery profile for the variant.""" 17693 deliveryProfile: DeliveryProfile 17694 17695 """ 17696 Display name of the variant, based on product's title + variant's title. 17697 """ 17698 displayName: String! 17699 17700 """The fulfillment service associated with the product.""" 17701 fulfillmentService: FulfillmentService 17702 17703 """ 17704 Whether changes to the fulfillment service for the product variant are allowed. 17705 """ 17706 fulfillmentServiceEditable: EditableProperty! 17707 17708 """The Harmonized System Code (or HS Tariff Code) for the variant.""" 17709 harmonizedSystemCode: String @deprecated(reason: "Use `InventoryItem.harmonizedSystemCode` instead.") 17710 17711 """Globally unique identifier.""" 17712 id: ID! 17713 17714 """The featured image for the variant.""" 17715 image( 17716 """ 17717 Image width in pixels between 1 and 2048. This argument is deprecated: Use `maxWidth` on `Image.transformedSrc` instead. 17718 """ 17719 maxWidth: Int 17720 17721 """ 17722 Image height in pixels between 1 and 2048. This argument is deprecated: Use `maxHeight` on `Image.transformedSrc` instead. 17723 """ 17724 maxHeight: Int 17725 17726 """ 17727 Crops the image according to the specified region. This argument is deprecated: Use `crop` on `Image.transformedSrc` instead. 17728 """ 17729 crop: CropRegion 17730 17731 """ 17732 Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use `scale` on `Image.transformedSrc` instead. 17733 """ 17734 scale: Int = 1 17735 ): Image 17736 17737 """The inventory item, which is used to query for inventory information.""" 17738 inventoryItem: InventoryItem! 17739 17740 """ 17741 The fulfillment service that tracks the number of items in stock for the product variant. 17742 """ 17743 inventoryManagement: ProductVariantInventoryManagement! @deprecated(reason: "Use tracked attribute on `inventoryItem` instead.") 17744 17745 """ 17746 Whether customers are allowed to place an order for the product variant when it's out of stock. 17747 """ 17748 inventoryPolicy: ProductVariantInventoryPolicy! 17749 17750 """The total sellable quantity of the variant.""" 17751 inventoryQuantity: Int 17752 17753 """The ID of the corresponding resource in the REST Admin API.""" 17754 legacyResourceId: UnsignedInt64! 17755 17756 """The media associated with the product variant.""" 17757 media( 17758 """Returns up to the first `n` elements from the list.""" 17759 first: Int 17760 17761 """Returns the elements that come after the specified cursor.""" 17762 after: String 17763 17764 """Returns up to the last `n` elements from the list.""" 17765 last: Int 17766 17767 """Returns the elements that come before the specified cursor.""" 17768 before: String 17769 17770 """Reverse the order of the underlying list.""" 17771 reverse: Boolean = false 17772 ): MediaConnection! 17773 17774 """The metafield associated with the resource.""" 17775 metafield( 17776 """Container for a set of metafields (maximum of 20 characters).""" 17777 namespace: String! 17778 17779 """Identifier for the metafield (maximum of 30 characters).""" 17780 key: String! 17781 ): Metafield 17782 17783 """A paginated list of metafields associated with the resource.""" 17784 metafields( 17785 """Finds all metafields with a specific namespace under the resource.""" 17786 namespace: String 17787 17788 """Returns up to the first `n` elements from the list.""" 17789 first: Int 17790 17791 """Returns the elements that come after the specified cursor.""" 17792 after: String 17793 17794 """Returns up to the last `n` elements from the list.""" 17795 last: Int 17796 17797 """Returns the elements that come before the specified cursor.""" 17798 before: String 17799 17800 """Reverse the order of the underlying list.""" 17801 reverse: Boolean = false 17802 ): MetafieldConnection! 17803 17804 """ 17805 The order of the product variant in the list of product variants. The first position in the list is 1. 17806 17807 """ 17808 position: Int! 17809 17810 """ 17811 List of prices and compare-at prices in the presentment currencies for this shop. 17812 """ 17813 presentmentPrices( 17814 """The presentment currencies prices should return in.""" 17815 presentmentCurrencies: [CurrencyCode!] 17816 17817 """Returns up to the first `n` elements from the list.""" 17818 first: Int 17819 17820 """Returns the elements that come after the specified cursor.""" 17821 after: String 17822 17823 """Returns up to the last `n` elements from the list.""" 17824 last: Int 17825 17826 """Returns the elements that come before the specified cursor.""" 17827 before: String 17828 17829 """Reverse the order of the underlying list.""" 17830 reverse: Boolean = false 17831 ): ProductVariantPricePairConnection! 17832 17833 """The price of the product variant in the default shop currency.""" 17834 price: Money! 17835 17836 """Returns a private metafield found by namespace and key.""" 17837 privateMetafield( 17838 """The namespace for the private metafield.""" 17839 namespace: String! 17840 17841 """The key for the private metafield.""" 17842 key: String! 17843 ): PrivateMetafield 17844 17845 """List of private metafields.""" 17846 privateMetafields( 17847 """Filter the private metafields by namespace.""" 17848 namespace: String 17849 17850 """Returns up to the first `n` elements from the list.""" 17851 first: Int 17852 17853 """Returns the elements that come after the specified cursor.""" 17854 after: String 17855 17856 """Returns up to the last `n` elements from the list.""" 17857 last: Int 17858 17859 """Returns the elements that come before the specified cursor.""" 17860 before: String 17861 17862 """Reverse the order of the underlying list.""" 17863 reverse: Boolean = false 17864 ): PrivateMetafieldConnection! 17865 17866 """The product that this variant belongs to.""" 17867 product: Product! 17868 17869 """ 17870 Whether a customer needs to provide a shipping address when placing an order for the product variant. 17871 17872 """ 17873 requiresShipping: Boolean! @deprecated(reason: "Use `InventoryItem.requiresShipping` instead.") 17874 17875 """List of product options applied to the variant.""" 17876 selectedOptions: [SelectedOption!]! 17877 17878 """Count of selling plan groups associated with the product variant.""" 17879 sellingPlanGroupCount: Int! 17880 17881 """ 17882 An identifier for the product variant in the shop. Required in order to connect to a fulfillment service. 17883 17884 """ 17885 sku: String 17886 17887 """The storefront ID of the product variant.""" 17888 storefrontId: StorefrontID! 17889 17890 """The tax code for the product variant.""" 17891 taxCode: String 17892 17893 """Whether a tax is charged when the product variant is sold.""" 17894 taxable: Boolean! 17895 17896 """The title of the product variant.""" 17897 title: String! 17898 17899 """The translations associated with the resource.""" 17900 translations( 17901 """Filters translations locale.""" 17902 locale: String! 17903 ): [PublishedTranslation!]! 17904 17905 """ 17906 The date and time (ISO 8601 format) when the product variant was last modified. 17907 17908 """ 17909 updatedAt: DateTime! 17910 17911 """ 17912 The weight of the product variant in the unit system specified with weight_unit. 17913 """ 17914 weight: Float 17915 17916 """ 17917 The unit of measurement that applies to the product variant's weight. If you don't specify a value for weight_unit, then the shop's default unit of measurement is applied. Valid values: `g`, `kg`, `oz`, `lb`. 17918 17919 """ 17920 weightUnit: WeightUnit! 17921 } 17922 17923 """ 17924 Specifies the input fields required to append media to a single variant. 17925 """ 17926 input ProductVariantAppendMediaInput { 17927 """Specifies the variant to which media will be appended.""" 17928 variantId: ID! 17929 17930 """Specifies the media to append to the variant.""" 17931 mediaIds: [ID!]! 17932 } 17933 17934 """Return type for `productVariantAppendMedia` mutation.""" 17935 type ProductVariantAppendMediaPayload { 17936 """The product associated with the variants and media.""" 17937 product: Product 17938 17939 """The product variants that were updated.""" 17940 productVariants: [ProductVariant!] 17941 17942 """List of errors that occurred executing the mutation.""" 17943 userErrors: [MediaUserError!]! 17944 } 17945 17946 """ 17947 An auto-generated type for paginating through multiple ProductVariants. 17948 17949 """ 17950 type ProductVariantConnection { 17951 """A list of edges.""" 17952 edges: [ProductVariantEdge!]! 17953 17954 """Information to aid in pagination.""" 17955 pageInfo: PageInfo! 17956 } 17957 17958 """Return type for `productVariantCreate` mutation.""" 17959 type ProductVariantCreatePayload { 17960 """The product associated with the variant.""" 17961 product: Product 17962 17963 """The successfully created variant.""" 17964 productVariant: ProductVariant 17965 17966 """List of errors that occurred executing the mutation.""" 17967 userErrors: [UserError!]! 17968 } 17969 17970 """Return type for `productVariantDelete` mutation.""" 17971 type ProductVariantDeletePayload { 17972 """ID of the deleted product variant.""" 17973 deletedProductVariantId: ID 17974 17975 """Product of the deleted product variant.""" 17976 product: Product 17977 17978 """List of errors that occurred executing the mutation.""" 17979 userErrors: [UserError!]! 17980 } 17981 17982 """ 17983 Specifies the input fields required to detach media from a single variant. 17984 """ 17985 input ProductVariantDetachMediaInput { 17986 """Specifies the variant from which media will be detached.""" 17987 variantId: ID! 17988 17989 """Specifies the media to detach from the variant.""" 17990 mediaIds: [ID!]! 17991 } 17992 17993 """Return type for `productVariantDetachMedia` mutation.""" 17994 type ProductVariantDetachMediaPayload { 17995 """The product associated with the variants and media.""" 17996 product: Product 17997 17998 """The product variants that were updated.""" 17999 productVariants: [ProductVariant!] 18000 18001 """List of errors that occurred executing the mutation.""" 18002 userErrors: [MediaUserError!]! 18003 } 18004 18005 """ 18006 An auto-generated type which holds one ProductVariant and a cursor during pagination. 18007 18008 """ 18009 type ProductVariantEdge { 18010 """A cursor for use in pagination.""" 18011 cursor: String! 18012 18013 """The item at the end of ProductVariantEdge.""" 18014 node: ProductVariant! 18015 } 18016 18017 """Specifies a product variant to create or update.""" 18018 input ProductVariantInput { 18019 """The value of the barcode associated with the product.""" 18020 barcode: String 18021 18022 """The compare-at price of the variant.""" 18023 compareAtPrice: Money 18024 18025 """The ID of the fulfillment service associated with the variant.""" 18026 fulfillmentServiceId: ID 18027 18028 """The Harmonized System Code (or HS Tariff Code) for the variant.""" 18029 harmonizedSystemCode: String 18030 18031 """ 18032 Specifies the product variant to update or create a new variant if absent. 18033 """ 18034 id: ID 18035 18036 """The ID of the image that's associated with the variant.""" 18037 imageId: ID 18038 18039 """ 18040 The URL of an image to associate with the variant. This field can only be used through mutations that create product images and must match one of the URLs being created on the product. 18041 18042 """ 18043 imageSrc: String 18044 18045 """ 18046 The URL of the media to associate with the variant. This field can only be used in mutations that create media images and must match one of the URLs being created on the product. This field only accepts one value. 18047 """ 18048 mediaSrc: [String!] 18049 18050 """ 18051 The fulfillment service that tracks the number of items in stock for the product variant. If you track the inventory yourself using the admin, then set the value to `shopify`. Valid values: `shopify` or the handle of a fulfillment service that has inventory management enabled. 18052 This argument is deprecated: Use tracked attribute on `inventoryItem` instead. 18053 """ 18054 inventoryManagement: ProductVariantInventoryManagement 18055 18056 """ 18057 Whether customers are allowed to place an order for the product variant when it's out of stock. 18058 """ 18059 inventoryPolicy: ProductVariantInventoryPolicy 18060 18061 """ 18062 Create only field. The inventory quantities at each location where the variant is stocked. 18063 """ 18064 inventoryQuantities: [InventoryLevelInput!] 18065 18066 """Inventory Item associated with the variant, used for unit cost.""" 18067 inventoryItem: InventoryItemInput 18068 18069 """Additional customizable information about the product variant.""" 18070 metafields: [MetafieldInput!] 18071 18072 """The private metafields to associated with this product.""" 18073 privateMetafields: [PrivateMetafieldInput!] 18074 18075 """ 18076 The custom properties that a shop owner uses to define product variants. 18077 """ 18078 options: [String!] 18079 18080 """ 18081 The order of the product variant in the list of product variants. The first position in the list is 1. 18082 18083 """ 18084 position: Int 18085 18086 """The price of the variant.""" 18087 price: Money 18088 18089 """ 18090 Create only required field. Specifies the product on which to create the variant. 18091 """ 18092 productId: ID 18093 18094 """Whether the variant requires shipping.""" 18095 requiresShipping: Boolean 18096 18097 """The SKU for the variant.""" 18098 sku: String 18099 18100 """Whether the variant is taxable.""" 18101 taxable: Boolean 18102 18103 """ 18104 This argument is deprecated: Variant title is not a writable field; it is generated from the selected variant options. 18105 """ 18106 title: String 18107 18108 """The tax code associated with the variant.""" 18109 taxCode: String 18110 18111 """The weight of the variant.""" 18112 weight: Float 18113 18114 """The unit of weight that's used to measure the variant.""" 18115 weightUnit: WeightUnit 18116 } 18117 18118 """The method of inventory tracking for a product variant.""" 18119 enum ProductVariantInventoryManagement { 18120 """Shopify tracks this product variant's inventory.""" 18121 SHOPIFY 18122 18123 """This product variant's inventory is not tracked.""" 18124 NOT_MANAGED 18125 18126 """ 18127 A third-party fulfillment service tracks this product variant's inventory. 18128 """ 18129 FULFILLMENT_SERVICE 18130 } 18131 18132 """ 18133 The inventory policy for a product variant controls whether customers can continue to buy the variant when it 18134 is out of stock. When the value is <code>continue</code>, customers are able to buy the variant when it's out of stock. 18135 When the value is <code>deny</code>, customers can't buy the variant when it's out of stock. 18136 18137 """ 18138 enum ProductVariantInventoryPolicy { 18139 """Stop selling a product variant when it is out of stock.""" 18140 DENY 18141 18142 """Continue selling a product variant when it is out of stock.""" 18143 CONTINUE 18144 } 18145 18146 """Return type for `productVariantJoinSellingPlanGroups` mutation.""" 18147 type ProductVariantJoinSellingPlanGroupsPayload { 18148 """The product variant object.""" 18149 productVariant: ProductVariant 18150 18151 """List of errors that occurred executing the mutation.""" 18152 userErrors: [SellingPlanGroupUserError!]! 18153 } 18154 18155 """Return type for `productVariantLeaveSellingPlanGroups` mutation.""" 18156 type ProductVariantLeaveSellingPlanGroupsPayload { 18157 """The product variant object.""" 18158 productVariant: ProductVariant 18159 18160 """List of errors that occurred executing the mutation.""" 18161 userErrors: [SellingPlanGroupUserError!]! 18162 } 18163 18164 """ 18165 The compare-at price and price of a variant sharing a currency. 18166 18167 """ 18168 type ProductVariantPricePair { 18169 """The compare-at price of the variant with associated currency.""" 18170 compareAtPrice: MoneyV2 18171 18172 """The price of the variant with associated currency.""" 18173 price: MoneyV2! 18174 } 18175 18176 """ 18177 An auto-generated type for paginating through multiple ProductVariantPricePairs. 18178 18179 """ 18180 type ProductVariantPricePairConnection { 18181 """A list of edges.""" 18182 edges: [ProductVariantPricePairEdge!]! 18183 18184 """Information to aid in pagination.""" 18185 pageInfo: PageInfo! 18186 } 18187 18188 """ 18189 An auto-generated type which holds one ProductVariantPricePair and a cursor during pagination. 18190 18191 """ 18192 type ProductVariantPricePairEdge { 18193 """A cursor for use in pagination.""" 18194 cursor: String! 18195 18196 """The item at the end of ProductVariantPricePairEdge.""" 18197 node: ProductVariantPricePair! 18198 } 18199 18200 """The set of valid sort keys for the ProductVariant query.""" 18201 enum ProductVariantSortKeys { 18202 """Sort by the `title` value.""" 18203 TITLE 18204 18205 """Sort by the `name` value.""" 18206 NAME 18207 18208 """Sort by the `sku` value.""" 18209 SKU 18210 18211 """Sort by the `inventory_quantity` value.""" 18212 INVENTORY_QUANTITY 18213 18214 """Sort by the `inventory_management` value.""" 18215 INVENTORY_MANAGEMENT 18216 18217 """Sort by the `inventory_levels.available` value.""" 18218 INVENTORY_LEVELS_AVAILABLE 18219 18220 """Sort by the `inventory_policy` value.""" 18221 INVENTORY_POLICY 18222 18223 """Sort by the `full_title` value.""" 18224 FULL_TITLE 18225 18226 """Sort by the `popular` value.""" 18227 POPULAR 18228 18229 """Sort by the `position` value.""" 18230 POSITION 18231 18232 """Sort by the `id` value.""" 18233 ID 18234 18235 """ 18236 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 18237 results by relevance to the search term(s). When no search query is specified, this sort key is not 18238 deterministic and should not be used. 18239 18240 """ 18241 RELEVANCE 18242 } 18243 18244 """Return type for `productVariantUpdate` mutation.""" 18245 type ProductVariantUpdatePayload { 18246 """The product associated with the variant.""" 18247 product: Product 18248 18249 """The updated variant.""" 18250 productVariant: ProductVariant 18251 18252 """List of errors that occurred executing the mutation.""" 18253 userErrors: [UserError!]! 18254 } 18255 18256 """The set of valid sort keys for the ProfileItem query.""" 18257 enum ProfileItemSortKeys { 18258 """Sort by the `title` value.""" 18259 TITLE 18260 18261 """Sort by the `product_type` value.""" 18262 PRODUCT_TYPE 18263 18264 """Sort by the `vendor` value.""" 18265 VENDOR 18266 18267 """Sort by the `inventory_total` value.""" 18268 INVENTORY_TOTAL 18269 18270 """Sort by the `updated_at` value.""" 18271 UPDATED_AT 18272 18273 """Sort by the `created_at` value.""" 18274 CREATED_AT 18275 18276 """Sort by the `published_at` value.""" 18277 PUBLISHED_AT 18278 18279 """Sort by the `id` value.""" 18280 ID 18281 18282 """ 18283 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 18284 results by relevance to the search term(s). When no search query is specified, this sort key is not 18285 deterministic and should not be used. 18286 18287 """ 18288 RELEVANCE 18289 } 18290 18291 """ 18292 A publication is a group of products and collections that is published to an app. 18293 18294 """ 18295 type Publication implements Node { 18296 """The app associated with the publication.""" 18297 app: App! 18298 18299 """ 18300 The collection publications for the list of collections published to the publication. 18301 """ 18302 collectionPublicationsV3( 18303 """Returns up to the first `n` elements from the list.""" 18304 first: Int 18305 18306 """Returns the elements that come after the specified cursor.""" 18307 after: String 18308 18309 """Returns up to the last `n` elements from the list.""" 18310 last: Int 18311 18312 """Returns the elements that come before the specified cursor.""" 18313 before: String 18314 18315 """Reverse the order of the underlying list.""" 18316 reverse: Boolean = false 18317 ): ResourcePublicationConnection! 18318 18319 """The list of collections published to the publication.""" 18320 collections( 18321 """Returns up to the first `n` elements from the list.""" 18322 first: Int 18323 18324 """Returns the elements that come after the specified cursor.""" 18325 after: String 18326 18327 """Returns up to the last `n` elements from the list.""" 18328 last: Int 18329 18330 """Returns the elements that come before the specified cursor.""" 18331 before: String 18332 18333 """Reverse the order of the underlying list.""" 18334 reverse: Boolean = false 18335 ): CollectionConnection! 18336 18337 """Whether the collection is available to the publication.""" 18338 hasCollection( 18339 """Collection ID to check.""" 18340 id: ID! 18341 ): Boolean! 18342 18343 """Globally unique identifier.""" 18344 id: ID! 18345 18346 """Name of the publication.""" 18347 name: String! 18348 18349 """ 18350 The product publications for the list of products published to the publication. 18351 """ 18352 productPublicationsV3( 18353 """Returns up to the first `n` elements from the list.""" 18354 first: Int 18355 18356 """Returns the elements that come after the specified cursor.""" 18357 after: String 18358 18359 """Returns up to the last `n` elements from the list.""" 18360 last: Int 18361 18362 """Returns the elements that come before the specified cursor.""" 18363 before: String 18364 18365 """Reverse the order of the underlying list.""" 18366 reverse: Boolean = false 18367 ): ResourcePublicationConnection! 18368 18369 """The list of products published to the publication.""" 18370 products( 18371 """Returns up to the first `n` elements from the list.""" 18372 first: Int 18373 18374 """Returns the elements that come after the specified cursor.""" 18375 after: String 18376 18377 """Returns up to the last `n` elements from the list.""" 18378 last: Int 18379 18380 """Returns the elements that come before the specified cursor.""" 18381 before: String 18382 18383 """Reverse the order of the underlying list.""" 18384 reverse: Boolean = false 18385 ): ProductConnection! 18386 18387 """Whether or not this publication supports future publishing.""" 18388 supportsFuturePublishing: Boolean! 18389 } 18390 18391 """ 18392 An auto-generated type for paginating through multiple Publications. 18393 18394 """ 18395 type PublicationConnection { 18396 """A list of edges.""" 18397 edges: [PublicationEdge!]! 18398 18399 """Information to aid in pagination.""" 18400 pageInfo: PageInfo! 18401 } 18402 18403 """ 18404 An auto-generated type which holds one Publication and a cursor during pagination. 18405 18406 """ 18407 type PublicationEdge { 18408 """A cursor for use in pagination.""" 18409 cursor: String! 18410 18411 """The item at the end of PublicationEdge.""" 18412 node: Publication! 18413 } 18414 18415 """Specifies the input fields required to publish a resource.""" 18416 input PublicationInput { 18417 """ 18418 ID of the channel. This argument is deprecated: Use publicationId instead. 18419 """ 18420 channelId: ID 18421 18422 """ID of the publication.""" 18423 publicationId: ID 18424 18425 """ 18426 The date and time that the resource was published. Setting this to a date in the future will schedule 18427 the resource to be published. Only online store channels support future publishing. 18428 18429 """ 18430 publishDate: DateTime 18431 } 18432 18433 """ 18434 Represents a resource that can be published to a channel. 18435 A publishable resource can be either a Product or Collection. 18436 18437 """ 18438 interface Publishable { 18439 """ 18440 The number of publications a resource is published to without feedback errors. 18441 """ 18442 availablePublicationCount: Int! 18443 18444 """The number of publications a resource is published on.""" 18445 publicationCount( 18446 """ 18447 Include only the resource's publications that are published. If false, then return all the resource's publications including future publications. 18448 """ 18449 onlyPublished: Boolean = true 18450 ): Int! 18451 18452 """Check to see whether the resource is published to a given channel.""" 18453 publishedOnChannel( 18454 """The ID of the channel to check.""" 18455 channelId: ID! 18456 ): Boolean! @deprecated(reason: "Use `publishedOnPublication` instead") 18457 18458 """ 18459 Check to see whether the resource is published to the calling app's channel. 18460 """ 18461 publishedOnCurrentChannel: Boolean! @deprecated(reason: "Use `publishedOnCurrentPublication` instead") 18462 18463 """ 18464 Check to see whether the resource is published to the calling app's publication. 18465 """ 18466 publishedOnCurrentPublication: Boolean! 18467 18468 """Check to see whether the resource is published to a given publication.""" 18469 publishedOnPublication( 18470 """The ID of the publication to check.""" 18471 publicationId: ID! 18472 ): Boolean! 18473 18474 """The list of resources that are published to a publication.""" 18475 resourcePublications( 18476 """ 18477 Whether to return only the resources that are currently published. If false, then also returns the resources that are scheduled to be published. 18478 18479 """ 18480 onlyPublished: Boolean = true 18481 18482 """Returns up to the first `n` elements from the list.""" 18483 first: Int 18484 18485 """Returns the elements that come after the specified cursor.""" 18486 after: String 18487 18488 """Returns up to the last `n` elements from the list.""" 18489 last: Int 18490 18491 """Returns the elements that come before the specified cursor.""" 18492 before: String 18493 18494 """Reverse the order of the underlying list.""" 18495 reverse: Boolean = false 18496 ): ResourcePublicationConnection! 18497 18498 """ 18499 The list of resources that are either published or staged to be published to a publication. 18500 """ 18501 resourcePublicationsV2( 18502 """ 18503 Whether to return only the resources that are currently published. If false, then also returns the resources that are scheduled or staged to be published. 18504 18505 """ 18506 onlyPublished: Boolean = true 18507 18508 """Returns up to the first `n` elements from the list.""" 18509 first: Int 18510 18511 """Returns the elements that come after the specified cursor.""" 18512 after: String 18513 18514 """Returns up to the last `n` elements from the list.""" 18515 last: Int 18516 18517 """Returns the elements that come before the specified cursor.""" 18518 before: String 18519 18520 """Reverse the order of the underlying list.""" 18521 reverse: Boolean = false 18522 ): ResourcePublicationV2Connection! 18523 18524 """The list of channels that the resource is not published to.""" 18525 unpublishedChannels( 18526 """Returns up to the first `n` elements from the list.""" 18527 first: Int 18528 18529 """Returns the elements that come after the specified cursor.""" 18530 after: String 18531 18532 """Returns up to the last `n` elements from the list.""" 18533 last: Int 18534 18535 """Returns the elements that come before the specified cursor.""" 18536 before: String 18537 18538 """Reverse the order of the underlying list.""" 18539 reverse: Boolean = false 18540 ): ChannelConnection! @deprecated(reason: "Use `unpublishedPublications` instead") 18541 18542 """The list of publications that the resource is not published to.""" 18543 unpublishedPublications( 18544 """Returns up to the first `n` elements from the list.""" 18545 first: Int 18546 18547 """Returns the elements that come after the specified cursor.""" 18548 after: String 18549 18550 """Returns up to the last `n` elements from the list.""" 18551 last: Int 18552 18553 """Returns the elements that come before the specified cursor.""" 18554 before: String 18555 18556 """Reverse the order of the underlying list.""" 18557 reverse: Boolean = false 18558 ): PublicationConnection! 18559 } 18560 18561 """Return type for `publishablePublish` mutation.""" 18562 type PublishablePublishPayload { 18563 """Resource that has been published.""" 18564 publishable: Publishable 18565 18566 """The user's shop.""" 18567 shop: Shop! 18568 18569 """List of errors that occurred executing the mutation.""" 18570 userErrors: [UserError!]! 18571 } 18572 18573 """Return type for `publishablePublishToCurrentChannel` mutation.""" 18574 type PublishablePublishToCurrentChannelPayload { 18575 """Resource that has been published.""" 18576 publishable: Publishable 18577 18578 """The user's shop.""" 18579 shop: Shop! 18580 18581 """List of errors that occurred executing the mutation.""" 18582 userErrors: [UserError!]! 18583 } 18584 18585 """Return type for `publishableUnpublish` mutation.""" 18586 type PublishableUnpublishPayload { 18587 """Resource that has been unpublished.""" 18588 publishable: Publishable 18589 18590 """The user's shop.""" 18591 shop: Shop! 18592 18593 """List of errors that occurred executing the mutation.""" 18594 userErrors: [UserError!]! 18595 } 18596 18597 """Return type for `publishableUnpublishToCurrentChannel` mutation.""" 18598 type PublishableUnpublishToCurrentChannelPayload { 18599 """Resource that has been unpublished.""" 18600 publishable: Publishable 18601 18602 """The user's shop.""" 18603 shop: Shop! 18604 18605 """List of errors that occurred executing the mutation.""" 18606 userErrors: [UserError!]! 18607 } 18608 18609 """Published translation of a field of a resource.""" 18610 type PublishedTranslation { 18611 """Translation key.""" 18612 key: String! 18613 18614 """Translation locale.""" 18615 locale: String! 18616 18617 """Translation value.""" 18618 value: String 18619 } 18620 18621 """Represents a refund of items or transactions in an order.""" 18622 type Refund implements Node & LegacyInteroperability { 18623 """When the refund was created.""" 18624 createdAt: DateTime 18625 18626 """A list of the order's refunded duties.""" 18627 duties: [RefundDuty!] 18628 18629 """Globally unique identifier.""" 18630 id: ID! 18631 18632 """The ID of the corresponding resource in the REST Admin API.""" 18633 legacyResourceId: UnsignedInt64! 18634 18635 """Note associated with the refund.""" 18636 note: String 18637 18638 """The order associated with the refund.""" 18639 order: Order! 18640 18641 """The RefundLineItem resources attached to the refund.""" 18642 refundLineItems( 18643 """Returns up to the first `n` elements from the list.""" 18644 first: Int 18645 18646 """Returns the elements that come after the specified cursor.""" 18647 after: String 18648 18649 """Returns up to the last `n` elements from the list.""" 18650 last: Int 18651 18652 """Returns the elements that come before the specified cursor.""" 18653 before: String 18654 18655 """Reverse the order of the underlying list.""" 18656 reverse: Boolean = false 18657 ): RefundLineItemConnection! 18658 18659 """Total amount refunded across all the transactions for this refund.""" 18660 totalRefunded: MoneyV2! @deprecated(reason: "Use `totalRefundedSet` instead") 18661 18662 """ 18663 Total amount refunded across all the transactions for this refund in shop and presentment currencies. 18664 """ 18665 totalRefundedSet: MoneyBag! 18666 18667 """Transactions associated with the refund.""" 18668 transactions( 18669 """Returns up to the first `n` elements from the list.""" 18670 first: Int 18671 18672 """Returns the elements that come after the specified cursor.""" 18673 after: String 18674 18675 """Returns up to the last `n` elements from the list.""" 18676 last: Int 18677 18678 """Returns the elements that come before the specified cursor.""" 18679 before: String 18680 18681 """Reverse the order of the underlying list.""" 18682 reverse: Boolean = false 18683 ): OrderTransactionConnection! 18684 18685 """When the refund was last updated.""" 18686 updatedAt: DateTime! 18687 } 18688 18689 """Return type for `refundCreate` mutation.""" 18690 type RefundCreatePayload { 18691 """The order associated with the created refund.""" 18692 order: Order 18693 18694 """The created refund.""" 18695 refund: Refund 18696 18697 """List of errors that occurred executing the mutation.""" 18698 userErrors: [UserError!]! 18699 } 18700 18701 """Represents a refunded duty.""" 18702 type RefundDuty { 18703 """ 18704 Returns the amount of a refunded duty in shop and presentment currencies. 18705 """ 18706 amountSet: MoneyBag! 18707 18708 """ 18709 Returns a Duty resource. This represents the Duty in the non-refund context. 18710 """ 18711 originalDuty: Duty 18712 } 18713 18714 """Specifies the fields required to return duties on a refund.""" 18715 input RefundDutyInput { 18716 """The ID of the duty in the refund.""" 18717 dutyId: ID! 18718 18719 """The type of refund for this duty.""" 18720 refundType: RefundDutyRefundType 18721 } 18722 18723 """The type of refund to perform for a particular refund duty.""" 18724 enum RefundDutyRefundType { 18725 """ 18726 The duty is proportionally refunded based on the quantity of the refunded line item. 18727 """ 18728 PROPORTIONAL 18729 18730 """The duty is fully refunded.""" 18731 FULL 18732 } 18733 18734 """Specifies the fields to create a refund.""" 18735 input RefundInput { 18736 """ 18737 The currency (in ISO format) that is used to refund the order. This must be the presentment currency (the currency used by the customer) and is a required field for orders where the currency and presentment currency differ. 18738 """ 18739 currency: CurrencyCode 18740 18741 """Order ID for which the refund is created.""" 18742 orderId: ID! 18743 18744 """An optional note attached to a refund.""" 18745 note: String 18746 18747 """Whether to send a refund notification to the customer.""" 18748 notify: Boolean 18749 18750 """Specifies how much of the shipping cost to refund.""" 18751 shipping: ShippingRefundInput 18752 18753 """A list of line items to refund.""" 18754 refundLineItems: [RefundLineItemInput!] 18755 18756 """A list of duties to refund.""" 18757 refundDuties: [RefundDutyInput!] 18758 18759 """A list of transactions involved in the refund.""" 18760 transactions: [OrderTransactionInput!] 18761 } 18762 18763 """Represents the details about a refunded line item.""" 18764 type RefundLineItem { 18765 """ 18766 Returns a LineItem resource. This represents the LineItem in the non-refund context. 18767 """ 18768 lineItem: LineItem! 18769 18770 """The inventory restock location.""" 18771 location: Location 18772 18773 """Returns the price of a refunded line item.""" 18774 price: Money! @deprecated(reason: "Use `priceSet` instead") 18775 18776 """ 18777 Returns the price of a refunded line item in shop and presentment currencies. 18778 """ 18779 priceSet: MoneyBag! 18780 18781 """Returns the quantity of a refunded line item.""" 18782 quantity: Int! 18783 18784 """Represents the type of restock for the refunded line item.""" 18785 restockType: RefundLineItemRestockType! 18786 18787 """ 18788 Whether the refunded line item was restocked. Not applicable in the context of a SuggestedRefund. 18789 """ 18790 restocked: Boolean! 18791 18792 """Returns the subtotal price of a refunded line item.""" 18793 subtotal: Money! @deprecated(reason: "Use `subtotalSet` instead") 18794 18795 """ 18796 Returns the subtotal price of a refunded line item in shop and presentment currencies. 18797 """ 18798 subtotalSet: MoneyBag! 18799 18800 """Returns the total tax charged on a refunded line item.""" 18801 totalTax: Money! @deprecated(reason: "Use `totalTaxSet` instead") 18802 18803 """ 18804 Returns the total tax charged on a refunded line item in shop and presentment currencies. 18805 """ 18806 totalTaxSet: MoneyBag! 18807 } 18808 18809 """ 18810 An auto-generated type for paginating through multiple RefundLineItems. 18811 18812 """ 18813 type RefundLineItemConnection { 18814 """A list of edges.""" 18815 edges: [RefundLineItemEdge!]! 18816 18817 """Information to aid in pagination.""" 18818 pageInfo: PageInfo! 18819 } 18820 18821 """ 18822 An auto-generated type which holds one RefundLineItem and a cursor during pagination. 18823 18824 """ 18825 type RefundLineItemEdge { 18826 """A cursor for use in pagination.""" 18827 cursor: String! 18828 18829 """The item at the end of RefundLineItemEdge.""" 18830 node: RefundLineItem! 18831 } 18832 18833 """Specifies the fields required to return line items on a refund.""" 18834 input RefundLineItemInput { 18835 """The ID of the line item in the refund.""" 18836 lineItemId: ID! 18837 18838 """The quantity of the associated line item that was returned.""" 18839 quantity: Int! 18840 18841 """The type of restock for this line item.""" 18842 restockType: RefundLineItemRestockType 18843 18844 """ 18845 The intended location for restocking if `refundType` is not `NO_RESTOCK` 18846 """ 18847 locationId: ID 18848 } 18849 18850 """The type of restock performed for a particular refund line item.""" 18851 enum RefundLineItemRestockType { 18852 """Refund line item was returned.""" 18853 RETURN 18854 18855 """Refund line item was canceled.""" 18856 CANCEL 18857 18858 """ 18859 Refund line item was restocked, without specifically being identified as a return or cancelation. 18860 """ 18861 LEGACY_RESTOCK 18862 18863 """Refund line item was not restocked.""" 18864 NO_RESTOCK 18865 } 18866 18867 """ 18868 Presents information or problems to merchants, with 1 or more actions that they can take. 18869 They can optionally have a specific icon and be dismissed by merchants. 18870 18871 """ 18872 type ResourceAlert { 18873 """ 18874 Buttons in the alert that link to related information. 18875 For example, _View risk assessment_. 18876 18877 """ 18878 actions: [ResourceAlertAction!]! 18879 18880 """Details about the alert.""" 18881 content: HTML! 18882 18883 """ 18884 Unique identifier that appears when an alert is manually closed by the merchant. 18885 Most alerts cannot be manually closed. 18886 18887 """ 18888 dismissibleHandle: String 18889 18890 """Icon that displays with the alert.""" 18891 icon: ResourceAlertIcon 18892 18893 """Indication of how important the alert is.""" 18894 severity: ResourceAlertSeverity! 18895 18896 """The name of the alert.""" 18897 title: String! 18898 } 18899 18900 """An action associated to a resource alert.""" 18901 type ResourceAlertAction { 18902 """Whether the action is primary or not.""" 18903 primary: Boolean! 18904 18905 """Resource for the action to show.""" 18906 show: String 18907 18908 """Action title.""" 18909 title: String! 18910 18911 """Action target URL.""" 18912 url: URL! 18913 } 18914 18915 """The available icons for resource alerts.""" 18916 enum ResourceAlertIcon { 18917 """A checkmark inside a circle.""" 18918 CHECKMARK_CIRCLE 18919 18920 """A lowercase `i` inside a circle.""" 18921 INFORMATION_CIRCLE 18922 } 18923 18924 """The possible severity levels for a resource alert.""" 18925 enum ResourceAlertSeverity { 18926 """Indicates a neutral alert.""" 18927 DEFAULT 18928 18929 """Indicates an informative alert.""" 18930 INFO 18931 18932 """Indicates a warning alert.""" 18933 WARNING 18934 18935 """Indicates a success alert.""" 18936 SUCCESS 18937 18938 """Indicates a critical alert.""" 18939 CRITICAL 18940 ERROR @deprecated(reason: "`ERROR` severity is being deprecated in favour of `WARNING` or `CRITICAL` instead.") 18941 } 18942 18943 """ 18944 Represents feedback from apps about a resource, and the steps required to set up the apps on the shop. 18945 18946 """ 18947 type ResourceFeedback { 18948 """ 18949 Feedback from an app about the steps a merchant needs to take to set up the app on their store. 18950 """ 18951 appFeedback: [AppFeedback!]! @deprecated(reason: "Use `details` instead") 18952 18953 """List of AppFeedback detailing issues regarding a resource.""" 18954 details: [AppFeedback!]! 18955 18956 """Summary of resource feedback pertaining to the resource.""" 18957 summary: String! 18958 } 18959 18960 """A resource limit represents the limits that the resource has.""" 18961 type ResourceLimit { 18962 """Whether or not the resource is available.""" 18963 available: Boolean! 18964 18965 """Quantity available. If null the quantity available is unlimited.""" 18966 quantityAvailable: Int 18967 18968 """Quantity limit of the resource. If null the quantity is unlimited.""" 18969 quantityLimit: Int 18970 18971 """ 18972 Quantity used of the resource. If null the quantity used cannot be retrieved. 18973 """ 18974 quantityUsed: Int 18975 } 18976 18977 """ 18978 A resource publication represents that a resource has been published to a publication. 18979 """ 18980 type ResourcePublication { 18981 """The channel the resource publication is published to.""" 18982 channel: Channel! @deprecated(reason: "Use `publication` instead") 18983 18984 """ 18985 Whether the resource publication is published. Also returns true if the resource publication is scheduled to be published. 18986 If false, then the resource publication is neither published nor scheduled to be published. 18987 18988 """ 18989 isPublished: Boolean! 18990 18991 """The publication the resource publication is published to.""" 18992 publication: Publication! 18993 18994 """ 18995 The date that the resource publication was or is going to be published to the publication. 18996 """ 18997 publishDate: DateTime! 18998 18999 """The resource published to the publication.""" 19000 publishable: Publishable! 19001 } 19002 19003 """ 19004 An auto-generated type for paginating through multiple ResourcePublications. 19005 19006 """ 19007 type ResourcePublicationConnection { 19008 """A list of edges.""" 19009 edges: [ResourcePublicationEdge!]! 19010 19011 """Information to aid in pagination.""" 19012 pageInfo: PageInfo! 19013 } 19014 19015 """ 19016 An auto-generated type which holds one ResourcePublication and a cursor during pagination. 19017 19018 """ 19019 type ResourcePublicationEdge { 19020 """A cursor for use in pagination.""" 19021 cursor: String! 19022 19023 """The item at the end of ResourcePublicationEdge.""" 19024 node: ResourcePublication! 19025 } 19026 19027 """ 19028 A resource publication represents that a resource either has been published or will be published to a publication. 19029 19030 """ 19031 type ResourcePublicationV2 { 19032 """ 19033 Whether the resource publication is published. If true, then the resource publication is published to the publication. 19034 If false, then the resource publication is staged to be published to the publication. 19035 19036 """ 19037 isPublished: Boolean! 19038 19039 """The publication the resource publication is published to.""" 19040 publication: Publication! 19041 19042 """ 19043 The date that the resource publication was or is going to be published to the publication. 19044 """ 19045 publishDate: DateTime 19046 19047 """The resource published to the publication.""" 19048 publishable: Publishable! 19049 } 19050 19051 """ 19052 An auto-generated type for paginating through multiple ResourcePublicationV2s. 19053 19054 """ 19055 type ResourcePublicationV2Connection { 19056 """A list of edges.""" 19057 edges: [ResourcePublicationV2Edge!]! 19058 19059 """Information to aid in pagination.""" 19060 pageInfo: PageInfo! 19061 } 19062 19063 """ 19064 An auto-generated type which holds one ResourcePublicationV2 and a cursor during pagination. 19065 19066 """ 19067 type ResourcePublicationV2Edge { 19068 """A cursor for use in pagination.""" 19069 cursor: String! 19070 19071 """The item at the end of ResourcePublicationV2Edge.""" 19072 node: ResourcePublicationV2! 19073 } 19074 19075 """SEO information.""" 19076 type SEO { 19077 """SEO Description.""" 19078 description: String 19079 19080 """SEO Title.""" 19081 title: String 19082 } 19083 19084 """SEO information.""" 19085 input SEOInput { 19086 """SEO title of the product.""" 19087 title: String 19088 19089 """SEO description of the product.""" 19090 description: String 19091 } 19092 19093 """ 19094 A saved search is a representation of a search query saved in the admin. 19095 """ 19096 type SavedSearch implements Node & LegacyInteroperability { 19097 """The filters of a saved search.""" 19098 filters: [SearchFilter!]! 19099 19100 """Globally unique identifier.""" 19101 id: ID! 19102 19103 """The ID of the corresponding resource in the REST Admin API.""" 19104 legacyResourceId: UnsignedInt64! 19105 19106 """The name of a saved search.""" 19107 name: String! 19108 19109 """ 19110 The query string of a saved search. This includes search terms and filters. 19111 """ 19112 query: String! 19113 19114 """The type of resource this saved search is searching in.""" 19115 resourceType: SearchResultType! 19116 19117 """The search terms of a saved search.""" 19118 searchTerms: String! 19119 } 19120 19121 """ 19122 An auto-generated type for paginating through multiple SavedSearches. 19123 19124 """ 19125 type SavedSearchConnection { 19126 """A list of edges.""" 19127 edges: [SavedSearchEdge!]! 19128 19129 """Information to aid in pagination.""" 19130 pageInfo: PageInfo! 19131 } 19132 19133 """Specifies the fields required to create a saved search.""" 19134 input SavedSearchCreateInput { 19135 """The type of resouce this saved search is searching in.""" 19136 resourceType: SearchResultType! 19137 19138 """A descriptive name of the saved search.""" 19139 name: String! 19140 19141 """ 19142 The query string of a saved search. This includes search terms and filters. 19143 """ 19144 query: String! 19145 } 19146 19147 """Return type for `savedSearchCreate` mutation.""" 19148 type SavedSearchCreatePayload { 19149 """The saved search that was created.""" 19150 savedSearch: SavedSearch 19151 19152 """List of errors that occurred executing the mutation.""" 19153 userErrors: [UserError!]! 19154 } 19155 19156 """Specifies the fields to delete a saved search.""" 19157 input SavedSearchDeleteInput { 19158 """ID of the saved search to delete.""" 19159 id: ID! 19160 } 19161 19162 """Return type for `savedSearchDelete` mutation.""" 19163 type SavedSearchDeletePayload { 19164 """The id of the saved search that was deleted.""" 19165 deletedSavedSearchId: ID 19166 19167 """The shop of the saved search that was deleted.""" 19168 shop: Shop! 19169 19170 """List of errors that occurred executing the mutation.""" 19171 userErrors: [UserError!]! 19172 } 19173 19174 """ 19175 An auto-generated type which holds one SavedSearch and a cursor during pagination. 19176 19177 """ 19178 type SavedSearchEdge { 19179 """A cursor for use in pagination.""" 19180 cursor: String! 19181 19182 """The item at the end of SavedSearchEdge.""" 19183 node: SavedSearch! 19184 } 19185 19186 """Specifies the fields required to update a saved search.""" 19187 input SavedSearchUpdateInput { 19188 """ID of the saved search to update.""" 19189 id: ID! 19190 19191 """A descriptive name of the saved search.""" 19192 name: String 19193 19194 """ 19195 The query string of a saved search. This included search terms and filters. 19196 """ 19197 query: String 19198 } 19199 19200 """Return type for `savedSearchUpdate` mutation.""" 19201 type SavedSearchUpdatePayload { 19202 """The saved search that was updated.""" 19203 savedSearch: SavedSearch 19204 19205 """List of errors that occurred executing the mutation.""" 19206 userErrors: [UserError!]! 19207 } 19208 19209 """ 19210 Script discount applications capture the intentions of a discount that 19211 was created by a Shopify Script for an order's line item or shipping line. 19212 19213 """ 19214 type ScriptDiscountApplication implements DiscountApplication { 19215 """ 19216 The method by which the discount's value is allocated to its entitled items. 19217 """ 19218 allocationMethod: DiscountApplicationAllocationMethod! 19219 19220 """The description of the application as defined by the Script.""" 19221 description: String! @deprecated(reason: "Use `title` instead") 19222 19223 """ 19224 An ordered index that can be used to identify the discount application and indicate the precedence 19225 of the discount application for calculations. 19226 19227 """ 19228 index: Int! 19229 19230 """How the discount amount is distributed on the discounted lines.""" 19231 targetSelection: DiscountApplicationTargetSelection! 19232 19233 """Whether the discount is applied on line items or shipping lines.""" 19234 targetType: DiscountApplicationTargetType! 19235 19236 """The title of the application as defined by the Script.""" 19237 title: String! 19238 19239 """The value of the discount application.""" 19240 value: PricingValue! 19241 } 19242 19243 """ 19244 A script tag represents remote JavaScript code that is loaded into the pages of a shop's storefront or the order status page of checkout. 19245 19246 """ 19247 type ScriptTag implements Node & LegacyInteroperability { 19248 """ 19249 Whether the Shopify CDN can cache and serve the script tag. 19250 If `true`, then the script will be cached and served by the CDN. 19251 The cache expires 15 minutes after the script tag is successfully returned. 19252 If `false`, then the script will be served as is. 19253 19254 """ 19255 cache: Boolean! 19256 19257 """The date and time when the script tag was created.""" 19258 createdAt: DateTime! 19259 19260 """ 19261 The page or pages on the online store that the script should be included. 19262 """ 19263 displayScope: ScriptTagDisplayScope! 19264 19265 """Globally unique identifier.""" 19266 id: ID! 19267 19268 """The ID of the corresponding resource in the REST Admin API.""" 19269 legacyResourceId: UnsignedInt64! 19270 19271 """The URL to the remote script.""" 19272 src: URL! 19273 19274 """The date and time when the script tag was last updated.""" 19275 updatedAt: DateTime! 19276 } 19277 19278 """ 19279 An auto-generated type for paginating through multiple ScriptTags. 19280 19281 """ 19282 type ScriptTagConnection { 19283 """A list of edges.""" 19284 edges: [ScriptTagEdge!]! 19285 19286 """Information to aid in pagination.""" 19287 pageInfo: PageInfo! 19288 } 19289 19290 """Return type for `scriptTagCreate` mutation.""" 19291 type ScriptTagCreatePayload { 19292 """The script tag that was created.""" 19293 scriptTag: ScriptTag 19294 19295 """List of errors that occurred executing the mutation.""" 19296 userErrors: [UserError!]! 19297 } 19298 19299 """Return type for `scriptTagDelete` mutation.""" 19300 type ScriptTagDeletePayload { 19301 """The ID of the deleted script tag.""" 19302 deletedScriptTagId: ID 19303 19304 """List of errors that occurred executing the mutation.""" 19305 userErrors: [UserError!]! 19306 } 19307 19308 """ 19309 The page or pages on the online store where the script should be included. 19310 19311 """ 19312 enum ScriptTagDisplayScope { 19313 """ 19314 Include the script on both the web storefront and the order status page. 19315 """ 19316 ALL 19317 19318 """Include the script only on the order status page.""" 19319 ORDER_STATUS 19320 19321 """Include the script only on the web storefront.""" 19322 ONLINE_STORE 19323 } 19324 19325 """ 19326 An auto-generated type which holds one ScriptTag and a cursor during pagination. 19327 19328 """ 19329 type ScriptTagEdge { 19330 """A cursor for use in pagination.""" 19331 cursor: String! 19332 19333 """The item at the end of ScriptTagEdge.""" 19334 node: ScriptTag! 19335 } 19336 19337 """ 19338 Specifies the input fields for a script tag. 19339 19340 """ 19341 input ScriptTagInput { 19342 """The URL of the remote script.""" 19343 src: URL 19344 19345 """ 19346 The page or pages on the online store where the script should be included. 19347 """ 19348 displayScope: ScriptTagDisplayScope 19349 19350 """ 19351 Whether the Shopify CDN can cache and serve the script tag. 19352 If `true`, then the script will be cached and served by the CDN. 19353 The cache expires 15 minutes after the script tag is successfully returned. 19354 If `false`, then the script will be served as is. 19355 19356 """ 19357 cache: Boolean = false 19358 } 19359 19360 """Return type for `scriptTagUpdate` mutation.""" 19361 type ScriptTagUpdatePayload { 19362 """The script tag that was updated.""" 19363 scriptTag: ScriptTag 19364 19365 """List of errors that occurred executing the mutation.""" 19366 userErrors: [UserError!]! 19367 } 19368 19369 """A filter in a search query represented by a key value pair.""" 19370 type SearchFilter { 19371 """The key of the search filter.""" 19372 key: String! 19373 19374 """The value of the search filter.""" 19375 value: String! 19376 } 19377 19378 """ 19379 A list of search filters along with their specific options in value and label pair for filtering. 19380 """ 19381 type SearchFilterOptions { 19382 """A list of options that can be use to filter product availability.""" 19383 productAvailability: [FilterOption!]! 19384 } 19385 19386 """Represents an individual result returned from a search.""" 19387 type SearchResult { 19388 """Returns the search result description text.""" 19389 description: String 19390 19391 """Returns the Image resource presented to accompany a search result.""" 19392 image: Image 19393 19394 """Returns the ID of the resource returned in the search result.""" 19395 reference: Node! 19396 19397 """Returns the resource title.""" 19398 title: String! 19399 19400 """Returns the absolute URL to the resource in the search result.""" 19401 url: URL! 19402 } 19403 19404 """The connection type for SearchResult.""" 19405 type SearchResultConnection { 19406 """A list of edges.""" 19407 edges: [SearchResultEdge!]! 19408 19409 """Information to aid in pagination.""" 19410 pageInfo: PageInfo! 19411 19412 """Information to aid in pagination.""" 19413 resultsAfterCount: Int! @deprecated(reason: "The provided information is not accurate.") 19414 } 19415 19416 """ 19417 An auto-generated type which holds one SearchResult and a cursor during pagination. 19418 19419 """ 19420 type SearchResultEdge { 19421 """A cursor for use in pagination.""" 19422 cursor: String! 19423 19424 """The item at the end of SearchResultEdge.""" 19425 node: SearchResult! 19426 } 19427 19428 """Specifies the type of resources to be returned from a search.""" 19429 enum SearchResultType { 19430 ORDER 19431 CUSTOMER 19432 PRODUCT 19433 ONLINE_STORE_PAGE 19434 ONLINE_STORE_BLOG 19435 ONLINE_STORE_ARTICLE 19436 COLLECTION 19437 DRAFT_ORDER 19438 PRICE_RULE 19439 19440 """A code discount redeem code.""" 19441 DISCOUNT_REDEEM_CODE 19442 } 19443 19444 """ 19445 Properties used by customers to select a product variant. 19446 Products can have multiple options, like different sizes or colors. 19447 19448 """ 19449 type SelectedOption { 19450 """The product option’s name.""" 19451 name: String! 19452 19453 """The product option’s value.""" 19454 value: String! 19455 } 19456 19457 """ 19458 Represents how a product can be sold and purchased. Selling plans and associated records (selling plan groups 19459 and policies) are deleted 48 hours after a merchant uninstalls their subscriptions app. We recommend backing 19460 up these records if you need to restore them later. 19461 19462 """ 19463 type SellingPlan implements Node { 19464 """Selling plan policy which describes the billing details.""" 19465 billingPolicy: SellingPlanBillingPolicy! 19466 19467 """The date and time when the selling plan was created.""" 19468 createdAt: DateTime! 19469 19470 """Selling plan policy which describes the delivery details.""" 19471 deliveryPolicy: SellingPlanDeliveryPolicy! 19472 19473 """Buyer facing string which describes the selling plan commitment.""" 19474 description: String 19475 19476 """Globally unique identifier.""" 19477 id: ID! 19478 19479 """Buyer facing string which describes the selling plan content.""" 19480 name: String! 19481 19482 """ 19483 The values of all options available on the selling plan. Selling plans are grouped together in Liquid when they are created by the same app, and have the same `selling_plan_group.name` and `selling_plan_group.options` values. 19484 """ 19485 options: [String!]! 19486 19487 """ 19488 Relative position of the selling plan for display. A lower position will be displayed before a higher position. 19489 """ 19490 position: Int 19491 19492 """Selling plan pricing details.""" 19493 pricingPolicies: [SellingPlanPricingPolicy!]! 19494 } 19495 19496 """Represents a selling plan policy anchor.""" 19497 type SellingPlanAnchor { 19498 """ 19499 The day of the anchor. 19500 19501 If `type` is WEEKDAY, then the value must be between 1-7. Shopify interprets 19502 the days of the week according to ISO 8601, where 1 is Monday. 19503 19504 If `type` is not WEEKDAY, then the value must be between 1-31. 19505 19506 """ 19507 day: Int! 19508 19509 """ 19510 The month of the anchor. If type is different than YEARDAY, this field must be null, otherwise it must be 19511 between 1-12. 19512 19513 """ 19514 month: Int 19515 19516 """ 19517 Represents the anchor type, it can be one one of WEEKDAY, MONTHDAY, YEARDAY. 19518 19519 """ 19520 type: SellingPlanAnchorType! 19521 } 19522 19523 """ 19524 Specifies the input fields required to create or update a selling plan anchor. 19525 """ 19526 input SellingPlanAnchorInput { 19527 """ 19528 Represents the anchor type, must be one of WEEKDAY, MONTHDAY, YEARDAY. 19529 19530 """ 19531 type: SellingPlanAnchorType 19532 19533 """ 19534 The day of the anchor. 19535 19536 If `type` is WEEKDAY, then the value must be between 1-7. Shopify interprets 19537 the days of the week according to ISO 8601, where 1 is Monday. 19538 19539 If `type` is not WEEKDAY, then the value must be between 1-31. 19540 19541 """ 19542 day: Int 19543 19544 """ 19545 The month of the anchor. If type is different than YEARDAY, this field must be null, otherwise it must be 19546 between 1-12. 19547 19548 """ 19549 month: Int 19550 } 19551 19552 """Represents the anchor type.""" 19553 enum SellingPlanAnchorType { 19554 """Which day of the week, between 1-7.""" 19555 WEEKDAY 19556 19557 """Which day of the month, between 1-31.""" 19558 MONTHDAY 19559 19560 """ 19561 Which days of the month and year, month between 1-12, and day between 1-31. 19562 """ 19563 YEARDAY 19564 } 19565 19566 """ 19567 Represents the billing frequency associated to the selling plan (for example, bill every week, or bill every 19568 three months). The selling plan billing policy and associated records (selling plan groups, selling plans, pricing 19569 policies, and delivery policy) are deleted 48 hours after a merchant uninstalls their subscriptions app. 19570 We recommend backing up these records if you need to restore them later. 19571 19572 """ 19573 union SellingPlanBillingPolicy = SellingPlanRecurringBillingPolicy 19574 19575 """ 19576 Specifies the input fields required to create or update a billing policy type. 19577 """ 19578 input SellingPlanBillingPolicyInput { 19579 """Recurring billing policy details.""" 19580 recurring: SellingPlanRecurringBillingPolicyInput 19581 } 19582 19583 """ 19584 An auto-generated type for paginating through multiple SellingPlans. 19585 19586 """ 19587 type SellingPlanConnection { 19588 """A list of edges.""" 19589 edges: [SellingPlanEdge!]! 19590 19591 """Information to aid in pagination.""" 19592 pageInfo: PageInfo! 19593 } 19594 19595 """ 19596 Represents the delivery frequency associated to the selling plan (for example, deliver every month, or deliver 19597 every other week). The selling plan delivery policy and associated records (selling plan groups, selling plans, 19598 pricing policies, and billing policy) are deleted 48 hours after a merchant uninstalls their subscriptions app. 19599 We recommend backing up these records if you need to restore them later. 19600 19601 """ 19602 union SellingPlanDeliveryPolicy = SellingPlanRecurringDeliveryPolicy 19603 19604 """Specifies the input fields to create or update a delivery policy.""" 19605 input SellingPlanDeliveryPolicyInput { 19606 """Recurring delivery policy details.""" 19607 recurring: SellingPlanRecurringDeliveryPolicyInput 19608 } 19609 19610 """ 19611 An auto-generated type which holds one SellingPlan and a cursor during pagination. 19612 19613 """ 19614 type SellingPlanEdge { 19615 """A cursor for use in pagination.""" 19616 cursor: String! 19617 19618 """The item at the end of SellingPlanEdge.""" 19619 node: SellingPlan! 19620 } 19621 19622 """Represents a fixed selling plan pricing policy.""" 19623 type SellingPlanFixedPricingPolicy implements SellingPlanPricingPolicyBase { 19624 """The price adjustment type.""" 19625 adjustmentType: SellingPlanPricingPolicyAdjustmentType! 19626 19627 """The price adjustment value.""" 19628 adjustmentValue: SellingPlanPricingPolicyAdjustmentValue! 19629 19630 """ 19631 The date and time when the fixed selling plan pricing policy was created. 19632 """ 19633 createdAt: DateTime! 19634 } 19635 19636 """ 19637 Specifies the input fields required to create or update a fixed selling plan pricing policy. 19638 """ 19639 input SellingPlanFixedPricingPolicyInput { 19640 """ID of the pricing policy.""" 19641 id: ID 19642 19643 """Price adjustment type defined by the policy.""" 19644 adjustmentType: SellingPlanPricingPolicyAdjustmentType 19645 19646 """Price adjustment value defined by the policy.""" 19647 adjustmentValue: SellingPlanPricingPolicyValueInput 19648 } 19649 19650 """ 19651 Represents a selling method (for example, "Subscribe and save" or "Pre-paid"). Selling plan groups 19652 and associated records (selling plans and policies) are deleted 48 hours after a merchant 19653 uninstalls their subscriptions app. We recommend backing up these records if you need to restore them later. 19654 19655 """ 19656 type SellingPlanGroup implements Node { 19657 """The identifier for app, exposed in Liquid and product JSON.""" 19658 appId: String 19659 19660 """ 19661 Whether the given product is directly associated to the selling plan group. 19662 """ 19663 appliesToProduct( 19664 """The ID of the product.""" 19665 productId: ID! 19666 ): Boolean! 19667 19668 """ 19669 Whether the given product variant is directly associated to the selling plan group. 19670 """ 19671 appliesToProductVariant( 19672 """The ID of the product.""" 19673 productVariantId: ID! 19674 ): Boolean! 19675 19676 """ 19677 Whether any of the product variants of the given product are associated to the selling plan group. 19678 19679 """ 19680 appliesToProductVariants( 19681 """The ID of the product.""" 19682 productId: ID! 19683 ): Boolean! 19684 19685 """The date and time when the selling plan group was created.""" 19686 createdAt: DateTime! 19687 19688 """The merchant-facing description of the selling plan group.""" 19689 description: String 19690 19691 """Globally unique identifier.""" 19692 id: ID! 19693 19694 """The merchant-facing label of the selling plan group.""" 19695 merchantCode: String! 19696 19697 """The buyer-facing label of the selling plan group.""" 19698 name: String! 19699 19700 """ 19701 The values of all options available on the selling plan group. Selling plans are grouped together in Liquid when they are created by the same app, and have the same `selling_plan_group.name` and `selling_plan_group.options` values. 19702 """ 19703 options: [String!]! 19704 19705 """The relative position of the selling plan group for display.""" 19706 position: Int 19707 19708 """A count of products associated to the selling plan group.""" 19709 productCount: Int! 19710 19711 """A count of product variants associated to the selling plan group.""" 19712 productVariantCount( 19713 """The ID of the product to scope the count to.""" 19714 productId: ID 19715 ): Int! 19716 19717 """Product variants associated to the selling plan group.""" 19718 productVariants( 19719 """Filters the product variants by a product ID.""" 19720 productId: ID 19721 19722 """Returns up to the first `n` elements from the list.""" 19723 first: Int 19724 19725 """Returns the elements that come after the specified cursor.""" 19726 after: String 19727 19728 """Returns up to the last `n` elements from the list.""" 19729 last: Int 19730 19731 """Returns the elements that come before the specified cursor.""" 19732 before: String 19733 19734 """Reverse the order of the underlying list.""" 19735 reverse: Boolean = false 19736 ): ProductVariantConnection! 19737 19738 """Products associated to the selling plan group.""" 19739 products( 19740 """Returns up to the first `n` elements from the list.""" 19741 first: Int 19742 19743 """Returns the elements that come after the specified cursor.""" 19744 after: String 19745 19746 """Returns up to the last `n` elements from the list.""" 19747 last: Int 19748 19749 """Returns the elements that come before the specified cursor.""" 19750 before: String 19751 19752 """Reverse the order of the underlying list.""" 19753 reverse: Boolean = false 19754 ): ProductConnection! 19755 19756 """Selling plans associated to the selling plan group.""" 19757 sellingPlans( 19758 """Returns up to the first `n` elements from the list.""" 19759 first: Int 19760 19761 """Returns the elements that come after the specified cursor.""" 19762 after: String 19763 19764 """Returns up to the last `n` elements from the list.""" 19765 last: Int 19766 19767 """Returns the elements that come before the specified cursor.""" 19768 before: String 19769 19770 """Reverse the order of the underlying list.""" 19771 reverse: Boolean = false 19772 ): SellingPlanConnection! 19773 19774 """A summary of the policies associated to the selling plan group.""" 19775 summary: String 19776 } 19777 19778 """Return type for `sellingPlanGroupAddProductVariants` mutation.""" 19779 type SellingPlanGroupAddProductVariantsPayload { 19780 """The updated selling plan group.""" 19781 sellingPlanGroup: SellingPlanGroup 19782 19783 """List of errors that occurred executing the mutation.""" 19784 userErrors: [SellingPlanGroupUserError!]! 19785 } 19786 19787 """Return type for `sellingPlanGroupAddProducts` mutation.""" 19788 type SellingPlanGroupAddProductsPayload { 19789 """The updated selling plan group.""" 19790 sellingPlanGroup: SellingPlanGroup 19791 19792 """List of errors that occurred executing the mutation.""" 19793 userErrors: [SellingPlanGroupUserError!]! 19794 } 19795 19796 """ 19797 An auto-generated type for paginating through multiple SellingPlanGroups. 19798 19799 """ 19800 type SellingPlanGroupConnection { 19801 """A list of edges.""" 19802 edges: [SellingPlanGroupEdge!]! 19803 19804 """Information to aid in pagination.""" 19805 pageInfo: PageInfo! 19806 } 19807 19808 """Return type for `sellingPlanGroupCreate` mutation.""" 19809 type SellingPlanGroupCreatePayload { 19810 """The created selling plan group object.""" 19811 sellingPlanGroup: SellingPlanGroup 19812 19813 """List of errors that occurred executing the mutation.""" 19814 userErrors: [SellingPlanGroupUserError!]! 19815 } 19816 19817 """Return type for `sellingPlanGroupDelete` mutation.""" 19818 type SellingPlanGroupDeletePayload { 19819 """The id of the deleted selling plan group object.""" 19820 deletedSellingPlanGroupId: ID 19821 19822 """List of errors that occurred executing the mutation.""" 19823 userErrors: [SellingPlanGroupUserError!]! 19824 } 19825 19826 """ 19827 An auto-generated type which holds one SellingPlanGroup and a cursor during pagination. 19828 19829 """ 19830 type SellingPlanGroupEdge { 19831 """A cursor for use in pagination.""" 19832 cursor: String! 19833 19834 """The item at the end of SellingPlanGroupEdge.""" 19835 node: SellingPlanGroup! 19836 } 19837 19838 """ 19839 Specifies the input fields required to create or update a selling plan group. 19840 """ 19841 input SellingPlanGroupInput { 19842 """Buyer facing label of the selling plan group.""" 19843 name: String 19844 19845 """Identifier for app, exposed in Liquid and product JSON.""" 19846 appId: String 19847 19848 """Merchant facing label of the selling plan group.""" 19849 merchantCode: String 19850 19851 """Merchant facing description of the selling plan group.""" 19852 description: String 19853 19854 """List of selling plans to create.""" 19855 sellingPlansToCreate: [SellingPlanInput!] 19856 19857 """List of selling plans to update.""" 19858 sellingPlansToUpdate: [SellingPlanInput!] 19859 19860 """List of selling plans ids to delete.""" 19861 sellingPlansToDelete: [ID!] 19862 19863 """ 19864 The values of all options available on the selling plan group. Selling plans are grouped together in Liquid when they are created by the same app, and have the same `selling_plan_group.name` and `selling_plan_group.options` values. 19865 """ 19866 options: [String!] 19867 19868 """ 19869 Relative value for display purposes of the selling plan group. A lower position will be displayed before a higher one. 19870 """ 19871 position: Int 19872 } 19873 19874 """Return type for `sellingPlanGroupRemoveProductVariants` mutation.""" 19875 type SellingPlanGroupRemoveProductVariantsPayload { 19876 """The removed product variant ids.""" 19877 removedProductVariantIds: [ID!] 19878 19879 """List of errors that occurred executing the mutation.""" 19880 userErrors: [SellingPlanGroupUserError!]! 19881 } 19882 19883 """Return type for `sellingPlanGroupRemoveProducts` mutation.""" 19884 type SellingPlanGroupRemoveProductsPayload { 19885 """The removed product ids.""" 19886 removedProductIds: [ID!] 19887 19888 """List of errors that occurred executing the mutation.""" 19889 userErrors: [SellingPlanGroupUserError!]! 19890 } 19891 19892 """Specifies resource association with a Selling Plan Group.""" 19893 input SellingPlanGroupResourceInput { 19894 """The IDs of the Variants to add to the Selling Plan Group.""" 19895 productVariantIds: [ID!] 19896 19897 """The IDs of the Products to add to the Selling Plan Group.""" 19898 productIds: [ID!] 19899 } 19900 19901 """The set of valid sort keys for the SellingPlanGroup query.""" 19902 enum SellingPlanGroupSortKeys { 19903 """Sort by the `name` value.""" 19904 NAME 19905 19906 """Sort by the `updated_at` value.""" 19907 UPDATED_AT 19908 19909 """Sort by the `created_at` value.""" 19910 CREATED_AT 19911 19912 """Sort by the `id` value.""" 19913 ID 19914 19915 """ 19916 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 19917 results by relevance to the search term(s). When no search query is specified, this sort key is not 19918 deterministic and should not be used. 19919 19920 """ 19921 RELEVANCE 19922 } 19923 19924 """Return type for `sellingPlanGroupUpdate` mutation.""" 19925 type SellingPlanGroupUpdatePayload { 19926 """The IDs of the deleted Subscription Plans.""" 19927 deletedSellingPlanIds: [ID!] 19928 19929 """The updated Selling Plan Group.""" 19930 sellingPlanGroup: SellingPlanGroup 19931 19932 """List of errors that occurred executing the mutation.""" 19933 userErrors: [SellingPlanGroupUserError!]! 19934 } 19935 19936 """ 19937 Represents a selling plan group custom error. 19938 19939 """ 19940 type SellingPlanGroupUserError implements DisplayableError { 19941 """Error code to uniquely identify the error.""" 19942 code: SellingPlanGroupUserErrorCode 19943 19944 """Path to the input field which caused the error.""" 19945 field: [String!] 19946 19947 """The error message.""" 19948 message: String! 19949 } 19950 19951 """ 19952 Possible error codes that could be returned by SellingPlanGroupUserError. 19953 """ 19954 enum SellingPlanGroupUserErrorCode { 19955 """Input value is not present.""" 19956 PRESENT 19957 19958 """Input value is blank.""" 19959 BLANK 19960 19961 """Input value is invalid.""" 19962 INVALID 19963 19964 """Input value should be greater than minimum allowed value.""" 19965 GREATER_THAN 19966 19967 """Input value should be greater than or equal to minimum allowed value.""" 19968 GREATER_THAN_OR_EQUAL_TO 19969 19970 """Input value should be less than maximum allowed value.""" 19971 LESS_THAN 19972 19973 """Input value should be less or equal to maximum allowed value.""" 19974 LESS_THAN_OR_EQUAL_TO 19975 19976 """Input value is not a number.""" 19977 NOT_A_NUMBER 19978 19979 """Input value is too long.""" 19980 TOO_LONG 19981 19982 """Input value is too short.""" 19983 TOO_SHORT 19984 19985 """Input value is already taken.""" 19986 TAKEN 19987 19988 """Exceeded the selling plan limit (20).""" 19989 SELLING_PLAN_COUNT_UPPER_BOUND 19990 19991 """Must include at least one selling plan.""" 19992 SELLING_PLAN_COUNT_LOWER_BOUND 19993 19994 """ 19995 Selling plan's billing policy max cycles must be greater than min cycles. 19996 """ 19997 SELLING_PLAN_MAX_CYCLES_MUST_BE_GREATER_THAN_MIN_CYCLES 19998 19999 """Selling plan's billing and delivery policies anchors must be equal.""" 20000 SELLING_PLAN_BILLING_AND_DELIVERY_POLICY_ANCHORS_MUST_BE_EQUAL 20001 20002 """Selling plan's billing cycle must be a multiple of delivery cycle.""" 20003 SELLING_PLAN_BILLING_CYCLE_MUST_BE_A_MULTIPLE_OF_DELIVERY_CYCLE 20004 20005 """Selling plan's pricing policies must contain one fixed pricing policy.""" 20006 SELLING_PLAN_PRICING_POLICIES_MUST_CONTAIN_A_FIXED_PRICING_POLICY 20007 20008 """ 20009 Cannot define option2 on this selling plan as there's no label on the parent selling plan group. 20010 """ 20011 SELLING_PLAN_MISSING_OPTION2_LABEL_ON_PARENT_GROUP 20012 20013 """ 20014 Cannot define option3 on this selling plan as there's no label on the parent selling plan group. 20015 """ 20016 SELLING_PLAN_MISSING_OPTION3_LABEL_ON_PARENT_GROUP 20017 20018 """Selling plan's option2 is required because option2 exists.""" 20019 SELLING_PLAN_OPTION2_REQUIRED_AS_DEFINED_ON_PARENT_GROUP 20020 20021 """Selling plan's option3 is required because option3 exists.""" 20022 SELLING_PLAN_OPTION3_REQUIRED_AS_DEFINED_ON_PARENT_GROUP 20023 20024 """Selling plans can't have more than 2 pricing policies.""" 20025 SELLING_PLAN_PRICING_POLICIES_LIMIT 20026 20027 """Product variant does not exist.""" 20028 PRODUCT_VARIANT_DOES_NOT_EXIST 20029 20030 """Product does not exist.""" 20031 PRODUCT_DOES_NOT_EXIST 20032 20033 """Selling plan group does not exist.""" 20034 GROUP_DOES_NOT_EXIST 20035 20036 """Selling plan group could not be deleted.""" 20037 GROUP_COULD_NOT_BE_DELETED 20038 20039 """Could not add the resource to the selling plan group.""" 20040 ERROR_ADDING_RESOURCE_TO_GROUP 20041 20042 """Missing delivery policy.""" 20043 SELLING_PLAN_DELIVERY_POLICY_MISSING 20044 20045 """Missing billing policy.""" 20046 SELLING_PLAN_BILLING_POLICY_MISSING 20047 20048 """Selling plan does not exist.""" 20049 PLAN_DOES_NOT_EXIST 20050 20051 """Selling plan ID must be specified to update.""" 20052 PLAN_ID_MUST_BE_SPECIFIED_TO_UPDATE 20053 20054 """Only one pricing policy type can be defined.""" 20055 ONLY_NEED_ONE_PRICING_POLICY_TYPE 20056 20057 """Only one pricing policy adjustment value type can be defined.""" 20058 ONLY_NEED_ONE_PRICING_POLICY_VALUE 20059 20060 """Pricing policy's adjustment value and adjustment type must match.""" 20061 PRICING_POLICY_ADJUSTMENT_VALUE_AND_TYPE_MUST_MATCH 20062 20063 """Cannot have multiple selling plans with the same name.""" 20064 SELLING_PLAN_DUPLICATE_NAME 20065 20066 """Cannot have multiple selling plans with the same options.""" 20067 SELLING_PLAN_DUPLICATE_OPTIONS 20068 } 20069 20070 """Specifies the input fields to create or update a selling plan.""" 20071 input SellingPlanInput { 20072 """ID of the selling plan.""" 20073 id: ID 20074 20075 """Buyer facing string which describes the selling plan content.""" 20076 name: String 20077 20078 """Buyer facing string which describes the selling plan commitment.""" 20079 description: String 20080 20081 """Selling plan policy which describes the billing details.""" 20082 billingPolicy: SellingPlanBillingPolicyInput 20083 20084 """Selling plan policy which describes the delivery details.""" 20085 deliveryPolicy: SellingPlanDeliveryPolicyInput 20086 20087 """ 20088 Pricing policies which describe the pricing details. Each selling plan 20089 can only contain a maximum of 2 pricing policies. 20090 20091 """ 20092 pricingPolicies: [SellingPlanPricingPolicyInput!] 20093 20094 """ 20095 The values of all options available on the selling plan. Selling plans are grouped together in Liquid when they are created by the same app, and have the same `selling_plan_group.name` and `selling_plan_group.options` values. 20096 """ 20097 options: [String!] 20098 20099 """ 20100 Relative value for display purposes of this plan. A lower position will be displayed before a higher one. 20101 """ 20102 position: Int 20103 } 20104 20105 """Represents valid selling plan interval.""" 20106 enum SellingPlanInterval { 20107 """Day interval.""" 20108 DAY 20109 20110 """Week interval.""" 20111 WEEK 20112 20113 """Month interval.""" 20114 MONTH 20115 20116 """Year interval.""" 20117 YEAR 20118 } 20119 20120 """ 20121 Represents the type of pricing associated to the selling plan (for example, a $10 or 20% discount that is set 20122 for a limited period or that is fixed for the duration of the subscription). Selling plan pricing policies and 20123 associated records (selling plan groups, selling plans, billing policy, and delivery policy) are deleted 48 20124 hours after a merchant uninstalls their subscriptions app. We recommend backing up these records if you need 20125 to restore them later. 20126 20127 """ 20128 union SellingPlanPricingPolicy = SellingPlanFixedPricingPolicy | SellingPlanRecurringPricingPolicy 20129 20130 """Represents a selling plan pricing policy adjustment type.""" 20131 enum SellingPlanPricingPolicyAdjustmentType { 20132 """Percentage off adjustment.""" 20133 PERCENTAGE 20134 20135 """Fixed amount off adjustment.""" 20136 FIXED_AMOUNT 20137 20138 """Price of the policy.""" 20139 PRICE 20140 } 20141 20142 """Represents a selling plan pricing policy adjustment value type.""" 20143 union SellingPlanPricingPolicyAdjustmentValue = MoneyV2 | SellingPlanPricingPolicyPercentageValue 20144 20145 """Represents selling plan pricing policy common fields.""" 20146 interface SellingPlanPricingPolicyBase { 20147 """The price adjustment type.""" 20148 adjustmentType: SellingPlanPricingPolicyAdjustmentType! 20149 20150 """The price adjustment value.""" 20151 adjustmentValue: SellingPlanPricingPolicyAdjustmentValue! 20152 } 20153 20154 """ 20155 Specifies the input fields required to create or update a selling plan pricing policy. 20156 """ 20157 input SellingPlanPricingPolicyInput { 20158 """Recurring pricing policy details.""" 20159 recurring: SellingPlanRecurringPricingPolicyInput 20160 20161 """Fixed pricing policy details.""" 20162 fixed: SellingPlanFixedPricingPolicyInput 20163 } 20164 20165 """ 20166 Represents the percentage value of a selling plan pricing policy percentage type. 20167 """ 20168 type SellingPlanPricingPolicyPercentageValue { 20169 """The percentage value.""" 20170 percentage: Float! 20171 } 20172 20173 """ 20174 Specifies the input fields required to create or update a pricing policy adjustment value. 20175 """ 20176 input SellingPlanPricingPolicyValueInput { 20177 """Defines percentage value.""" 20178 percentage: Float 20179 20180 """Defines fixed value for an fixed amount off or a new policy price.""" 20181 fixedValue: Decimal 20182 } 20183 20184 """Represents a recurring selling plan billing policy.""" 20185 type SellingPlanRecurringBillingPolicy { 20186 """ 20187 Specific anchor dates upon which the billing interval calculations should be made. 20188 """ 20189 anchors: [SellingPlanAnchor!]! 20190 20191 """The date and time when the selling plan billing policy was created.""" 20192 createdAt: DateTime! 20193 20194 """The billing frequency, it can be either: day, week, month or year.""" 20195 interval: SellingPlanInterval! 20196 20197 """The number of intervals between billings.""" 20198 intervalCount: Int! 20199 20200 """Maximum number of billing iterations.""" 20201 maxCycles: Int 20202 20203 """Minimum number of billing iterations.""" 20204 minCycles: Int 20205 } 20206 20207 """ 20208 Specifies the input fields required to create or update a recurring billing policy. 20209 """ 20210 input SellingPlanRecurringBillingPolicyInput { 20211 """The billing frequency, it can be either: day, week, month or year.""" 20212 interval: SellingPlanInterval 20213 20214 """The number of intervals between billings.""" 20215 intervalCount: Int 20216 20217 """ 20218 Specific anchor dates upon which the billing interval calculations should be made. 20219 """ 20220 anchors: [SellingPlanAnchorInput!] 20221 20222 """Minimum number of billing iterations.""" 20223 minCycles: Int 20224 20225 """Maximum number of billing iterations.""" 20226 maxCycles: Int 20227 } 20228 20229 """Represents a recurring selling plan delivery policy.""" 20230 type SellingPlanRecurringDeliveryPolicy { 20231 """ 20232 Specific anchor dates upon which the delivery interval calculations should be made. 20233 """ 20234 anchors: [SellingPlanAnchor!]! 20235 20236 """The date and time when the selling plan delivery policy was created.""" 20237 createdAt: DateTime! 20238 20239 """A buffer period for orders to be included in a cycle.""" 20240 cutoff: Int 20241 20242 """ 20243 Specifies if the delivery policy is merchant or buyer-centric. 20244 Buyer-centric delivery policies state the time when the buyer will receive the goods. 20245 Merchant-centric delivery policies state the time when the fulfillment should be started. 20246 Currently, only merchant-centric delivery policies are supported. 20247 20248 """ 20249 intent: SellingPlanRecurringDeliveryPolicyIntent! 20250 20251 """The delivery frequency, it can be either: day, week, month or year.""" 20252 interval: SellingPlanInterval! 20253 20254 """The number of intervals between deliveries.""" 20255 intervalCount: Int! 20256 20257 """ 20258 Fulfillment or delivery behavior of the first fulfillment when the order is placed before the anchor. The default value for this field is `ASAP`. 20259 """ 20260 preAnchorBehavior: SellingPlanRecurringDeliveryPolicyPreAnchorBehavior! 20261 } 20262 20263 """ 20264 Specifies the input fields to create or update a recurring delivery policy. 20265 """ 20266 input SellingPlanRecurringDeliveryPolicyInput { 20267 """The delivery frequency, it can be either: day, week, month or year.""" 20268 interval: SellingPlanInterval 20269 20270 """The number of intervals between deliveries.""" 20271 intervalCount: Int 20272 20273 """ 20274 Specific anchor dates upon which the delivery interval calculations should be made. 20275 """ 20276 anchors: [SellingPlanAnchorInput!] 20277 20278 """A buffer period for orders to be included in a cycle.""" 20279 cutoff: Int 20280 20281 """ 20282 Intention of this delivery policy, it can be either: delivery or fulfillment. 20283 """ 20284 intent: SellingPlanRecurringDeliveryPolicyIntent 20285 20286 """The pre anchor behavior. It can be either: asap or next.""" 20287 preAnchorBehavior: SellingPlanRecurringDeliveryPolicyPreAnchorBehavior 20288 } 20289 20290 """Possible intentions of a Delivery Policy.""" 20291 enum SellingPlanRecurringDeliveryPolicyIntent { 20292 """ 20293 A merchant-centric delivery policy. Mark this delivery policy to define when the merchant should start fulfillment. 20294 20295 """ 20296 FULFILLMENT_BEGIN 20297 } 20298 20299 """ 20300 Possible fulfillment or delivery behaviors of the first fulfillment when the orderis placed before the anchor. 20301 """ 20302 enum SellingPlanRecurringDeliveryPolicyPreAnchorBehavior { 20303 """ 20304 Orders placed can be fulfilled / delivered immediately. Orders placed inside a cutoff can be fulfilled / delivered at the next anchor. 20305 20306 """ 20307 ASAP 20308 20309 """ 20310 Orders placed can be fulfilled / delivered at the next anchor date. Ordersplaced inside a cutoff will skip the next anchor and can be fulfilled / delivered at the following anchor. 20311 """ 20312 NEXT 20313 } 20314 20315 """Represents a recurring selling plan pricing policy.""" 20316 type SellingPlanRecurringPricingPolicy implements SellingPlanPricingPolicyBase { 20317 """The price adjustment type.""" 20318 adjustmentType: SellingPlanPricingPolicyAdjustmentType! 20319 20320 """The price adjustment value.""" 20321 adjustmentValue: SellingPlanPricingPolicyAdjustmentValue! 20322 20323 """Cycle after which this pricing policy applies.""" 20324 afterCycle: Int 20325 20326 """ 20327 The date and time when the recurring selling plan pricing policy was created. 20328 """ 20329 createdAt: DateTime! 20330 } 20331 20332 """ 20333 Specifies the input fields required to create or update a recurring selling plan pricing policy. 20334 """ 20335 input SellingPlanRecurringPricingPolicyInput { 20336 """ID of the pricing policy.""" 20337 id: ID 20338 20339 """Price adjustment type defined by the policy.""" 20340 adjustmentType: SellingPlanPricingPolicyAdjustmentType 20341 20342 """Price adjustment value defined by the policy.""" 20343 adjustmentValue: SellingPlanPricingPolicyValueInput 20344 20345 """ 20346 Cycle after which the pricing policy applies. If not provided the policy will be applicable from the first cycle. 20347 """ 20348 afterCycle: Int! 20349 } 20350 20351 """ 20352 Represents the shipping details that the customer chose for their order. 20353 """ 20354 type ShippingLine { 20355 """ 20356 A reference to the carrier service that provided the rate. 20357 Present when the rate was computed by a third-party carrier service. 20358 20359 """ 20360 carrierIdentifier: String 20361 20362 """A reference to the shipping method.""" 20363 code: String 20364 20365 """Whether the shipping line is custom or not.""" 20366 custom: Boolean! 20367 20368 """The general classification of the delivery method.""" 20369 deliveryCategory: String 20370 20371 """ 20372 The discounts that have been allocated to the shipping line. 20373 20374 """ 20375 discountAllocations: [DiscountAllocation!]! 20376 20377 """The pre-tax shipping price with discounts applied.""" 20378 discountedPrice: MoneyV2! @deprecated(reason: "Use `discountedPriceSet` instead") 20379 20380 """The pre-tax shipping price with discounts applied.""" 20381 discountedPriceSet: MoneyBag! 20382 20383 """Globally unique identifier.""" 20384 id: ID 20385 20386 """The pre-tax shipping price without any discounts applied.""" 20387 originalPrice: MoneyV2! @deprecated(reason: "Use `originalPriceSet` instead") 20388 20389 """The pre-tax shipping price without any discounts applied.""" 20390 originalPriceSet: MoneyBag! 20391 20392 """The phone number at the shipping address.""" 20393 phone: String 20394 20395 """Returns the price of the shipping line.""" 20396 price: Money! @deprecated(reason: "Use `originalPriceSet` instead") 20397 20398 """ 20399 The fulfillment service requested for the shipping method. 20400 Present if the shipping method requires processing by a third party fulfillment service. 20401 20402 """ 20403 requestedFulfillmentService: FulfillmentService 20404 20405 """ 20406 A unique identifier for the shipping rate. The format can change without notice and is not meant to be shown to users. 20407 """ 20408 shippingRateHandle: String 20409 20410 """Returns the rate source for the shipping line.""" 20411 source: String 20412 20413 """The TaxLine objects connected to this shipping line.""" 20414 taxLines: [TaxLine!]! 20415 20416 """Returns the title of the shipping line.""" 20417 title: String! 20418 } 20419 20420 """ 20421 An auto-generated type for paginating through multiple ShippingLines. 20422 20423 """ 20424 type ShippingLineConnection { 20425 """A list of edges.""" 20426 edges: [ShippingLineEdge!]! 20427 20428 """Information to aid in pagination.""" 20429 pageInfo: PageInfo! 20430 } 20431 20432 """ 20433 An auto-generated type which holds one ShippingLine and a cursor during pagination. 20434 20435 """ 20436 type ShippingLineEdge { 20437 """A cursor for use in pagination.""" 20438 cursor: String! 20439 20440 """The item at the end of ShippingLineEdge.""" 20441 node: ShippingLine! 20442 } 20443 20444 """Specifies the shipping details for the order.""" 20445 input ShippingLineInput { 20446 """Price of the shipping rate.""" 20447 price: Money 20448 20449 """A unique identifier for the shipping rate.""" 20450 shippingRateHandle: String 20451 20452 """Title of the shipping rate.""" 20453 title: String 20454 } 20455 20456 """The shipping method for the delivery.""" 20457 type ShippingMethod { 20458 """A unique code associated with the rate. For example: `expedited_mail`""" 20459 code: String! 20460 20461 """ 20462 A description of the rate, which customers will see at checkout. 20463 For example: `Includes tracking and insurance`. 20464 20465 """ 20466 label: String! 20467 } 20468 20469 """Return type for `shippingPackageDelete` mutation.""" 20470 type ShippingPackageDeletePayload { 20471 """The ID of the deleted shipping package.""" 20472 deletedId: ID 20473 20474 """List of errors that occurred executing the mutation.""" 20475 userErrors: [UserError!]! 20476 } 20477 20478 """Return type for `shippingPackageMakeDefault` mutation.""" 20479 type ShippingPackageMakeDefaultPayload { 20480 """List of errors that occurred executing the mutation.""" 20481 userErrors: [UserError!]! 20482 } 20483 20484 """Return type for `shippingPackageUpdate` mutation.""" 20485 type ShippingPackageUpdatePayload { 20486 """List of errors that occurred executing the mutation.""" 20487 userErrors: [UserError!]! 20488 } 20489 20490 """A shipping rate to be applied to an order.""" 20491 type ShippingRate { 20492 """Human-readable unique identifier for this shipping rate.""" 20493 handle: String! 20494 20495 """Price of this shipping rate.""" 20496 price: MoneyV2! 20497 20498 """Title of this shipping rate.""" 20499 title: String! 20500 } 20501 20502 """Represents the shipping costs refunded on the Refund.""" 20503 type ShippingRefund { 20504 """The monetary value of the shipping fees to be returned.""" 20505 amount: Money! @deprecated(reason: "Use `amountSet` instead") 20506 20507 """ 20508 The monetary value of the shipping fees to be returned in shop and presentment currencies. 20509 """ 20510 amountSet: MoneyBag! 20511 20512 """The maximum amount of shipping fees currently refundable.""" 20513 maximumRefundable: Money! @deprecated(reason: "Use `maximumRefundableSet` instead") 20514 20515 """ 20516 The maximum amount of shipping fees currently refundable in shop and presentment currencies. 20517 """ 20518 maximumRefundableSet: MoneyBag! 20519 20520 """ 20521 The monetary value of the tax allocated to shipping fees to be returned. 20522 """ 20523 tax: Money! @deprecated(reason: "Use `taxSet` instead") 20524 20525 """ 20526 The monetary value of the tax allocated to shipping fees to be returned in shop and presentment currencies. 20527 """ 20528 taxSet: MoneyBag! 20529 } 20530 20531 """Specifies the fields required to return shipping costs on a Refund.""" 20532 input ShippingRefundInput { 20533 """The monetary value of the shipping fees to be returned.""" 20534 amount: Money 20535 20536 """Whether a full refund is provided.""" 20537 fullRefund: Boolean 20538 } 20539 20540 """ 20541 Represents the shop object. 20542 20543 """ 20544 type Shop implements Node & HasPublishedTranslations & HasMetafields { 20545 """Alert message that appears in the Shopify admin.""" 20546 alerts: [ShopAlert!]! 20547 20548 """The token required to query the shop's reports or dashboards.""" 20549 analyticsToken: String! 20550 20551 """Paginated list of fulfillment orders assigned to fulfillment services.""" 20552 assignedFulfillmentOrders( 20553 """ 20554 The assigment status of the fulfillment orders that should be returned. 20555 """ 20556 assignmentStatus: FulfillmentOrderAssignmentStatus 20557 20558 """ 20559 Returns fulfillment orders only for certain locations, specified by a list of location IDs. 20560 """ 20561 locationIds: [ID!] 20562 20563 """Returns up to the first `n` elements from the list.""" 20564 first: Int 20565 20566 """Returns the elements that come after the specified cursor.""" 20567 after: String 20568 20569 """Returns up to the last `n` elements from the list.""" 20570 last: Int 20571 20572 """Returns the elements that come before the specified cursor.""" 20573 before: String 20574 20575 """Reverse the order of the underlying list.""" 20576 reverse: Boolean = false 20577 20578 """Sort the underlying list by the given key.""" 20579 sortKey: FulfillmentOrderSortKeys = ID 20580 ): FulfillmentOrderConnection! 20581 20582 """List of sales channels not currently installed on the shop.""" 20583 availableChannelApps( 20584 """Returns up to the first `n` elements from the list.""" 20585 first: Int 20586 20587 """Returns the elements that come after the specified cursor.""" 20588 after: String 20589 20590 """Returns up to the last `n` elements from the list.""" 20591 last: Int 20592 20593 """Returns the elements that come before the specified cursor.""" 20594 before: String 20595 20596 """Reverse the order of the underlying list.""" 20597 reverse: Boolean = false 20598 ): AppConnection! 20599 20600 """The shop's billing address information.""" 20601 billingAddress: MailingAddress! 20602 20603 """Exposes the number of channels.""" 20604 channelCount: Int! @deprecated(reason: "Use `publicationCount` instead") 20605 20606 """List of the shop's active sales channels.""" 20607 channels( 20608 """Returns up to the first `n` elements from the list.""" 20609 first: Int 20610 20611 """Returns the elements that come after the specified cursor.""" 20612 after: String 20613 20614 """Returns up to the last `n` elements from the list.""" 20615 last: Int 20616 20617 """Returns the elements that come before the specified cursor.""" 20618 before: String 20619 20620 """Reverse the order of the underlying list.""" 20621 reverse: Boolean = false 20622 ): ChannelConnection! @deprecated(reason: "Use `QueryRoot.channels` instead.") 20623 20624 """Specifies whether the shop supports checkouts via Checkout API.""" 20625 checkoutApiSupported: Boolean! 20626 20627 """Return a collection by its handle.""" 20628 collectionByHandle( 20629 """The handle of the collection.""" 20630 handle: String! 20631 ): Collection @deprecated(reason: "Use `QueryRoot.collectionByHandle` instead.") 20632 20633 """List of the shop's collection saved searches.""" 20634 collectionSavedSearches( 20635 """Returns up to the first `n` elements from the list.""" 20636 first: Int 20637 20638 """Returns the elements that come after the specified cursor.""" 20639 after: String 20640 20641 """Returns up to the last `n` elements from the list.""" 20642 last: Int 20643 20644 """Returns the elements that come before the specified cursor.""" 20645 before: String 20646 20647 """Reverse the order of the underlying list.""" 20648 reverse: Boolean = false 20649 ): SavedSearchConnection! @deprecated(reason: "Use `QueryRoot.collectionSavedSearches` instead.") 20650 20651 """List of the shop's collections.""" 20652 collections( 20653 """Returns up to the first `n` elements from the list.""" 20654 first: Int 20655 20656 """Returns the elements that come after the specified cursor.""" 20657 after: String 20658 20659 """Returns up to the last `n` elements from the list.""" 20660 last: Int 20661 20662 """Returns the elements that come before the specified cursor.""" 20663 before: String 20664 20665 """Reverse the order of the underlying list.""" 20666 reverse: Boolean = false 20667 20668 """Sort the underlying list by the given key.""" 20669 sortKey: CollectionSortKeys = ID 20670 20671 """ 20672 Supported filter parameters: 20673 - `collection_type` 20674 - `publishable_status` 20675 - `published_status` 20676 - `title` 20677 - `updated_at` 20678 20679 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 20680 for more information about using filters. 20681 20682 """ 20683 query: String 20684 20685 """ 20686 ID of an existing saved search. 20687 The search’s query string is used as the query argument. 20688 20689 """ 20690 savedSearchId: ID 20691 ): CollectionConnection! @deprecated(reason: "Use `QueryRoot.collections` instead.") 20692 20693 """ 20694 The public-facing contact email address for the shop. 20695 Customers will use this email to communicate with the shop owner. 20696 20697 """ 20698 contactEmail: String! 20699 20700 """Countries that have been defined in shipping zones for the shop.""" 20701 countriesInShippingZones: CountriesInShippingZones! 20702 20703 """The three letter code for the shop's currency.""" 20704 currencyCode: CurrencyCode! 20705 20706 """How currencies are displayed on your store.""" 20707 currencyFormats: CurrencyFormats! 20708 20709 """The currency settings for the shop.""" 20710 currencySettings( 20711 """Returns up to the first `n` elements from the list.""" 20712 first: Int 20713 20714 """Returns the elements that come after the specified cursor.""" 20715 after: String 20716 20717 """Returns up to the last `n` elements from the list.""" 20718 last: Int 20719 20720 """Returns the elements that come before the specified cursor.""" 20721 before: String 20722 20723 """Reverse the order of the underlying list.""" 20724 reverse: Boolean = false 20725 ): CurrencySettingConnection! 20726 20727 """The shop's customer account requirement preference.""" 20728 customerAccounts: ShopCustomerAccountsSetting! 20729 20730 """List of the shop's customer saved searches.""" 20731 customerSavedSearches( 20732 """Returns up to the first `n` elements from the list.""" 20733 first: Int 20734 20735 """Returns the elements that come after the specified cursor.""" 20736 after: String 20737 20738 """Returns up to the last `n` elements from the list.""" 20739 last: Int 20740 20741 """Returns the elements that come before the specified cursor.""" 20742 before: String 20743 20744 """Reverse the order of the underlying list.""" 20745 reverse: Boolean = false 20746 20747 """Sort the underlying list by the given key.""" 20748 sortKey: CustomerSavedSearchSortKeys = ID 20749 20750 """ 20751 Supported filter parameters: 20752 - `name` 20753 20754 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 20755 for more information about using filters. 20756 20757 """ 20758 query: String 20759 ): SavedSearchConnection! @deprecated(reason: "Use `QueryRoot.customerSavedSearches` instead.") 20760 20761 """A list of tags that have been added to customer accounts.""" 20762 customerTags( 20763 """Returns up to the first `n` elements from the list.""" 20764 first: Int! 20765 ): StringConnection! 20766 20767 """Customer accounts associated to the shop.""" 20768 customers( 20769 """Returns up to the first `n` elements from the list.""" 20770 first: Int 20771 20772 """Returns the elements that come after the specified cursor.""" 20773 after: String 20774 20775 """Returns up to the last `n` elements from the list.""" 20776 last: Int 20777 20778 """Returns the elements that come before the specified cursor.""" 20779 before: String 20780 20781 """Reverse the order of the underlying list.""" 20782 reverse: Boolean = false 20783 20784 """Sort the underlying list by the given key.""" 20785 sortKey: CustomerSortKeys = ID 20786 20787 """ 20788 Supported filter parameters: 20789 - `accepts_marketing` 20790 - `country` 20791 - `customer_date` 20792 - `email` 20793 - `last_abandoned_order_date` 20794 - `order_date` 20795 - `orders_count` 20796 - `phone` 20797 - `state` 20798 - `tag` 20799 - `total_spent` 20800 - `updated_at` 20801 20802 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax). 20803 20804 """ 20805 query: String 20806 ): CustomerConnection! @deprecated(reason: "Use `QueryRoot.customers` instead.") 20807 20808 """The shop's meta description used in search engine results.""" 20809 description: String 20810 20811 """The domains configured for the shop.""" 20812 domains: [Domain!]! 20813 20814 """List of the shop's draft order saved searches.""" 20815 draftOrderSavedSearches( 20816 """Returns up to the first `n` elements from the list.""" 20817 first: Int 20818 20819 """Returns the elements that come after the specified cursor.""" 20820 after: String 20821 20822 """Returns up to the last `n` elements from the list.""" 20823 last: Int 20824 20825 """Returns the elements that come before the specified cursor.""" 20826 before: String 20827 20828 """Reverse the order of the underlying list.""" 20829 reverse: Boolean = false 20830 ): SavedSearchConnection! @deprecated(reason: "Use `QueryRoot.draftOrderSavedSearches` instead.") 20831 20832 """A list of tags that have been added to draft orders.""" 20833 draftOrderTags( 20834 """Returns up to the first `n` elements from the list.""" 20835 first: Int! 20836 ): StringConnection! 20837 20838 """List of saved draft orders on the shop.""" 20839 draftOrders( 20840 """Returns up to the first `n` elements from the list.""" 20841 first: Int 20842 20843 """Returns the elements that come after the specified cursor.""" 20844 after: String 20845 20846 """Returns up to the last `n` elements from the list.""" 20847 last: Int 20848 20849 """Returns the elements that come before the specified cursor.""" 20850 before: String 20851 20852 """Reverse the order of the underlying list.""" 20853 reverse: Boolean = false 20854 20855 """Sort the underlying list by the given key.""" 20856 sortKey: DraftOrderSortKeys = ID 20857 20858 """ 20859 Supported filter parameters: 20860 - `created_at` 20861 - `customer_id` 20862 - `status` 20863 - `tag` 20864 - `updated_at` 20865 20866 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 20867 for more information about using filters. 20868 20869 """ 20870 query: String 20871 ): DraftOrderConnection! @deprecated(reason: "Use `QueryRoot.draftOrders` instead.") 20872 20873 """ 20874 The shop owner's email address. 20875 Shopify will use this email address to communicate with the shop owner. 20876 20877 """ 20878 email: String! 20879 20880 """The presentment currencies enabled for the shop.""" 20881 enabledPresentmentCurrencies: [CurrencyCode!]! 20882 20883 """The shop's features.""" 20884 features: ShopFeatures! 20885 20886 """Paginated list of merchant-managed and third-party fulfillment orders.""" 20887 fulfillmentOrders( 20888 """Whether to include closed fulfillment orders.""" 20889 includeClosed: Boolean = false 20890 20891 """Returns up to the first `n` elements from the list.""" 20892 first: Int 20893 20894 """Returns the elements that come after the specified cursor.""" 20895 after: String 20896 20897 """Returns up to the last `n` elements from the list.""" 20898 last: Int 20899 20900 """Returns the elements that come before the specified cursor.""" 20901 before: String 20902 20903 """Reverse the order of the underlying list.""" 20904 reverse: Boolean = false 20905 20906 """Sort the underlying list by the given key.""" 20907 sortKey: FulfillmentOrderSortKeys = ID 20908 20909 """ 20910 Supported filter parameters: 20911 - `assigned_location_id` 20912 - `status` 20913 20914 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax). 20915 20916 """ 20917 query: String 20918 ): FulfillmentOrderConnection! 20919 20920 """List of the shop's installed fulfillment services.""" 20921 fulfillmentServices: [FulfillmentService!]! 20922 20923 """The shop's time zone as defined by the IANA.""" 20924 ianaTimezone: String! 20925 20926 """Globally unique identifier.""" 20927 id: ID! 20928 20929 """List of the shop's inventory items.""" 20930 inventoryItems( 20931 """Returns up to the first `n` elements from the list.""" 20932 first: Int 20933 20934 """Returns the elements that come after the specified cursor.""" 20935 after: String 20936 20937 """Returns up to the last `n` elements from the list.""" 20938 last: Int 20939 20940 """Returns the elements that come before the specified cursor.""" 20941 before: String 20942 20943 """Reverse the order of the underlying list.""" 20944 reverse: Boolean = false 20945 20946 """ 20947 Supported filter parameters: 20948 - `created_at` 20949 - `id` 20950 - `sku` 20951 - `updated_at` 20952 20953 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 20954 for more information about using filters. 20955 20956 """ 20957 query: String 20958 ): InventoryItemConnection! @deprecated(reason: "Use `QueryRoot.inventoryItems` instead.") 20959 20960 """ 20961 The number of pendings orders on the shop. 20962 Limited to a maximum of 10000. 20963 20964 """ 20965 limitedPendingOrderCount: LimitedPendingOrderCount! 20966 20967 """List of active locations of the shop.""" 20968 locations( 20969 """Returns up to the first `n` elements from the list.""" 20970 first: Int 20971 20972 """Returns the elements that come after the specified cursor.""" 20973 after: String 20974 20975 """Returns up to the last `n` elements from the list.""" 20976 last: Int 20977 20978 """Returns the elements that come before the specified cursor.""" 20979 before: String 20980 20981 """Reverse the order of the underlying list.""" 20982 reverse: Boolean = false 20983 20984 """Sort the underlying list by the given key.""" 20985 sortKey: LocationSortKeys = NAME 20986 20987 """ 20988 Supported filter parameters: 20989 - `active` 20990 - `address1` 20991 - `address2` 20992 - `city` 20993 - `country` 20994 - `legacy` 20995 - `name` 20996 - `province` 20997 - `zip` 20998 20999 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 21000 for more information about using filters. 21001 21002 """ 21003 query: String 21004 21005 """If true, also include the legacy locations of fulfillment services.""" 21006 includeLegacy: Boolean = false 21007 21008 """If true, also include the locations that are deactivated.""" 21009 includeInactive: Boolean = false 21010 ): LocationConnection! @deprecated(reason: "Use `QueryRoot.locations` instead.") 21011 21012 """List of a shop's marketing events.""" 21013 marketingEvents( 21014 """Returns up to the first `n` elements from the list.""" 21015 first: Int 21016 21017 """Returns the elements that come after the specified cursor.""" 21018 after: String 21019 21020 """Returns up to the last `n` elements from the list.""" 21021 last: Int 21022 21023 """Returns the elements that come before the specified cursor.""" 21024 before: String 21025 21026 """Reverse the order of the underlying list.""" 21027 reverse: Boolean = false 21028 21029 """Sort the underlying list by the given key.""" 21030 sortKey: MarketingEventSortKeys = ID 21031 21032 """ 21033 Supported filter parameters: 21034 - `app_id` 21035 - `description` 21036 - `started_at` 21037 - `type` 21038 21039 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 21040 for more information about using filters. 21041 21042 """ 21043 query: String 21044 ): MarketingEventConnection! @deprecated(reason: "Use `QueryRoot.marketingEvents` instead.") 21045 21046 """The metafield associated with the resource.""" 21047 metafield( 21048 """Container for a set of metafields (maximum of 20 characters).""" 21049 namespace: String! 21050 21051 """Identifier for the metafield (maximum of 30 characters).""" 21052 key: String! 21053 ): Metafield 21054 21055 """A paginated list of metafields associated with the resource.""" 21056 metafields( 21057 """Finds all metafields with a specific namespace under the resource.""" 21058 namespace: String 21059 21060 """Returns up to the first `n` elements from the list.""" 21061 first: Int 21062 21063 """Returns the elements that come after the specified cursor.""" 21064 after: String 21065 21066 """Returns up to the last `n` elements from the list.""" 21067 last: Int 21068 21069 """Returns the elements that come before the specified cursor.""" 21070 before: String 21071 21072 """Reverse the order of the underlying list.""" 21073 reverse: Boolean = false 21074 ): MetafieldConnection! 21075 21076 """The shop's .myshopify.com domain name.""" 21077 myshopifyDomain: String! 21078 21079 """The shop's name.""" 21080 name: String! 21081 21082 """The navigation settings of the shop.""" 21083 navigationSettings: [NavigationItem!]! 21084 21085 """The prefix that appears before order numbers.""" 21086 orderNumberFormatPrefix: String! 21087 21088 """The suffix that appears after order numbers.""" 21089 orderNumberFormatSuffix: String! 21090 21091 """List of the shop's order saved searches.""" 21092 orderSavedSearches( 21093 """Returns up to the first `n` elements from the list.""" 21094 first: Int 21095 21096 """Returns the elements that come after the specified cursor.""" 21097 after: String 21098 21099 """Returns up to the last `n` elements from the list.""" 21100 last: Int 21101 21102 """Returns the elements that come before the specified cursor.""" 21103 before: String 21104 21105 """Reverse the order of the underlying list.""" 21106 reverse: Boolean = false 21107 ): SavedSearchConnection! @deprecated(reason: "Use `QueryRoot.orderSavedSearches` instead.") 21108 21109 """A list of tags that have been added to orders.""" 21110 orderTags( 21111 """Returns up to the first `n` elements from the list.""" 21112 first: Int! 21113 21114 """Sort type.""" 21115 sort: ShopTagSort = ALPHABETICAL 21116 ): StringConnection! 21117 21118 """List of orders placed on the shop.""" 21119 orders( 21120 """Returns up to the first `n` elements from the list.""" 21121 first: Int 21122 21123 """Returns the elements that come after the specified cursor.""" 21124 after: String 21125 21126 """Returns up to the last `n` elements from the list.""" 21127 last: Int 21128 21129 """Returns the elements that come before the specified cursor.""" 21130 before: String 21131 21132 """Reverse the order of the underlying list.""" 21133 reverse: Boolean = false 21134 21135 """Sort the underlying list by the given key.""" 21136 sortKey: OrderSortKeys = PROCESSED_AT 21137 21138 """ 21139 Supported filter parameters: 21140 - `cart_token` 21141 - `channel_id` 21142 - `chargeback_status` 21143 - `checkout_token` 21144 - `created_at` 21145 - `credit_card_last4` 21146 - `customer_id` 21147 - `delivery_method` 21148 - `discount_code` 21149 - `email` 21150 - `financial_status` 21151 - `fraud_protection_level` 21152 - `fulfillment_location_id` 21153 - `fulfillment_status` 21154 - `location_id` 21155 - `name` 21156 - `processed_at` 21157 - `reference_location_id` 21158 - `return_status` 21159 - `risk_level` 21160 - `sales_channel` 21161 - `source_identifier` 21162 - `source_name` 21163 - `status` 21164 - `tag` 21165 - `test` 21166 - `updated_at` 21167 21168 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 21169 for more information about using filters. 21170 21171 """ 21172 query: String 21173 ): OrderConnection! @deprecated(reason: "Use `QueryRoot.orders` instead.") 21174 21175 """Settings related to payments.""" 21176 paymentSettings: PaymentSettings! 21177 21178 """Number of pending orders on the shop.""" 21179 pendingOrderCount: Int! @deprecated(reason: "Use `limitedPendingOrderCount` instead") 21180 21181 """The shop's plan.""" 21182 plan: ShopPlan! 21183 21184 """List of the shop's price rule saved searches.""" 21185 priceRuleSavedSearches( 21186 """Returns up to the first `n` elements from the list.""" 21187 first: Int 21188 21189 """Returns the elements that come after the specified cursor.""" 21190 after: String 21191 21192 """Returns up to the last `n` elements from the list.""" 21193 last: Int 21194 21195 """Returns the elements that come before the specified cursor.""" 21196 before: String 21197 21198 """Reverse the order of the underlying list.""" 21199 reverse: Boolean = false 21200 ): SavedSearchConnection! @deprecated(reason: "Use `QueryRoot.priceRuleSavedSearches` instead.") 21201 21202 """List of the shop’s price rules.""" 21203 priceRules( 21204 """Returns up to the first `n` elements from the list.""" 21205 first: Int 21206 21207 """Returns the elements that come after the specified cursor.""" 21208 after: String 21209 21210 """Returns up to the last `n` elements from the list.""" 21211 last: Int 21212 21213 """Returns the elements that come before the specified cursor.""" 21214 before: String 21215 21216 """Reverse the order of the underlying list.""" 21217 reverse: Boolean = false 21218 21219 """Sort the underlying list by the given key.""" 21220 sortKey: PriceRuleSortKeys = ID 21221 21222 """ 21223 Supported filter parameters: 21224 - `created_at` 21225 - `discount_type` 21226 - `ends_at` 21227 - `starts_at` 21228 - `status` 21229 - `times_used` 21230 - `updated_at` 21231 21232 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 21233 for more information about using filters. 21234 21235 """ 21236 query: String 21237 21238 """ 21239 ID of an existing saved search. 21240 The search’s query string is used as the query argument. 21241 21242 """ 21243 savedSearchId: ID 21244 ): PriceRuleConnection! @deprecated(reason: "Use `QueryRoot.priceRules` instead.") 21245 21246 """The shop's primary domain name.""" 21247 primaryDomain: Domain! 21248 21249 """Returns a private metafield found by namespace and key.""" 21250 privateMetafield( 21251 """The namespace for the private metafield.""" 21252 namespace: String! 21253 21254 """The key for the private metafield.""" 21255 key: String! 21256 ): PrivateMetafield 21257 21258 """List of private metafields.""" 21259 privateMetafields( 21260 """Filter the private metafields by namespace.""" 21261 namespace: String 21262 21263 """Returns up to the first `n` elements from the list.""" 21264 first: Int 21265 21266 """Returns the elements that come after the specified cursor.""" 21267 after: String 21268 21269 """Returns up to the last `n` elements from the list.""" 21270 last: Int 21271 21272 """Returns the elements that come before the specified cursor.""" 21273 before: String 21274 21275 """Reverse the order of the underlying list.""" 21276 reverse: Boolean = false 21277 ): PrivateMetafieldConnection! 21278 21279 """Return a product by its handle.""" 21280 productByHandle( 21281 """The handle of the product.""" 21282 handle: String! 21283 ): Product @deprecated(reason: "Use `QueryRoot.productByHandle` instead.") 21284 21285 """All images of all products of the shop.""" 21286 productImages( 21287 """Returns up to the first `n` elements from the list.""" 21288 first: Int 21289 21290 """Returns the elements that come after the specified cursor.""" 21291 after: String 21292 21293 """Returns up to the last `n` elements from the list.""" 21294 last: Int 21295 21296 """Returns the elements that come before the specified cursor.""" 21297 before: String 21298 21299 """Reverse the order of the underlying list.""" 21300 reverse: Boolean = false 21301 21302 """Sort the underlying list by the given key.""" 21303 sortKey: ProductImageSortKeys = CREATED_AT 21304 21305 """ 21306 Image width in pixels between 1 and 2048. This argument is deprecated: Use `maxWidth` on `Image.transformedSrc` instead. 21307 """ 21308 maxWidth: Int 21309 21310 """ 21311 Image height in pixels between 1 and 2048. This argument is deprecated: Use `maxHeight` on `Image.transformedSrc` instead. 21312 """ 21313 maxHeight: Int 21314 21315 """ 21316 Crops the image according to the specified region. This argument is deprecated: Use `crop` on `Image.transformedSrc` instead. 21317 """ 21318 crop: CropRegion 21319 21320 """ 21321 Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use `scale` on `Image.transformedSrc` instead. 21322 """ 21323 scale: Int = 1 21324 ): ImageConnection! 21325 21326 """List of the shop's product saved searches.""" 21327 productSavedSearches( 21328 """Returns up to the first `n` elements from the list.""" 21329 first: Int 21330 21331 """Returns the elements that come after the specified cursor.""" 21332 after: String 21333 21334 """Returns up to the last `n` elements from the list.""" 21335 last: Int 21336 21337 """Returns the elements that come before the specified cursor.""" 21338 before: String 21339 21340 """Reverse the order of the underlying list.""" 21341 reverse: Boolean = false 21342 ): SavedSearchConnection! @deprecated(reason: "Use `QueryRoot.productSavedSearches` instead.") 21343 21344 """A list of tags that have been added to products.""" 21345 productTags( 21346 """Returns up to the first `n` elements from the list.""" 21347 first: Int! 21348 ): StringConnection! 21349 21350 """Types added to products.""" 21351 productTypes( 21352 """Returns up to the first `n` elements from the list.""" 21353 first: Int! 21354 ): StringConnection! 21355 21356 """List of the shop's product variants.""" 21357 productVariants( 21358 """Returns up to the first `n` elements from the list.""" 21359 first: Int 21360 21361 """Returns the elements that come after the specified cursor.""" 21362 after: String 21363 21364 """Returns up to the last `n` elements from the list.""" 21365 last: Int 21366 21367 """Returns the elements that come before the specified cursor.""" 21368 before: String 21369 21370 """Reverse the order of the underlying list.""" 21371 reverse: Boolean = false 21372 21373 """Sort the underlying list by the given key.""" 21374 sortKey: ProductVariantSortKeys = ID 21375 21376 """ 21377 Supported filter parameters: 21378 - `barcode` 21379 - `collection` 21380 - `delivery_profile_id` 21381 - `gift_card` 21382 - `inventory_quantity` 21383 - `location_id` 21384 - `managed` 21385 - `managed_by` 21386 - `product_id` 21387 - `product_status` 21388 - `product_type` 21389 - `publishable_status` 21390 - `published_status` 21391 - `sku` 21392 - `tag` 21393 - `taxable` 21394 - `title` 21395 - `updated_at` 21396 - `vendor` 21397 21398 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 21399 for more information about using filters. 21400 21401 """ 21402 query: String 21403 ): ProductVariantConnection! @deprecated(reason: "Use `QueryRoot.productVariants` instead.") 21404 21405 """Vendors added to products.""" 21406 productVendors( 21407 """Returns up to the first `n` elements from the list.""" 21408 first: Int! 21409 ): StringConnection! 21410 21411 """List of the shop's products.""" 21412 products( 21413 """Returns up to the first `n` elements from the list.""" 21414 first: Int 21415 21416 """Returns the elements that come after the specified cursor.""" 21417 after: String 21418 21419 """Returns up to the last `n` elements from the list.""" 21420 last: Int 21421 21422 """Returns the elements that come before the specified cursor.""" 21423 before: String 21424 21425 """Reverse the order of the underlying list.""" 21426 reverse: Boolean = false 21427 21428 """Sort the underlying list by the given key.""" 21429 sortKey: ProductSortKeys = ID 21430 21431 """ 21432 Supported filter parameters: 21433 - `barcode` 21434 - `created_at` 21435 - `delivery_profile_id` 21436 - `error_feedback` 21437 - `gift_card` 21438 - `inventory_total` 21439 - `is_price_reduced` 21440 - `out_of_stock_somewhere` 21441 - `price` 21442 - `product_type` 21443 - `publishable_status` 21444 - `published_status` 21445 - `sku` 21446 - `status` 21447 - `tag` 21448 - `title` 21449 - `updated_at` 21450 - `vendor` 21451 21452 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 21453 for more information about using filters. 21454 21455 """ 21456 query: String 21457 21458 """ 21459 ID of an existing saved search. 21460 The search’s query string is used as the query argument. 21461 21462 """ 21463 savedSearchId: ID 21464 ): ProductConnection! @deprecated(reason: "Use `QueryRoot.products`.") 21465 21466 """Exposes the number of publications.""" 21467 publicationCount: Int! 21468 21469 """Resource limits of a shop.""" 21470 resourceLimits: ShopResourceLimits! 21471 21472 """The URL of the rich text editor.""" 21473 richTextEditorUrl: URL! 21474 21475 """Return admin search results.""" 21476 search( 21477 """The search query to filter by.""" 21478 query: String! 21479 21480 """The search result types to filter by.""" 21481 types: [SearchResultType!] 21482 21483 """Returns up to the first `n` elements from the list.""" 21484 first: Int! 21485 21486 """Returns the elements that come after the specified cursor.""" 21487 after: String 21488 ): SearchResultConnection! 21489 21490 """List of search filter options.""" 21491 searchFilters: SearchFilterOptions! 21492 21493 """Whether the shop has outstanding setup steps.""" 21494 setupRequired: Boolean! 21495 21496 """Countries that the shop ships to.""" 21497 shipsToCountries: [CountryCode!]! 21498 21499 """A list of all policies associated with a shop.""" 21500 shopPolicies: [ShopPolicy!]! 21501 21502 """Shopify Payments account information, including balances and payouts.""" 21503 shopifyPaymentsAccount: ShopifyPaymentsAccount @deprecated(reason: "Use `QueryRoot.shopifyPaymentsAccount` instead.") 21504 21505 """ 21506 Storefront access token of a private application. Scoped per-application. 21507 """ 21508 storefrontAccessTokens( 21509 """Returns up to the first `n` elements from the list.""" 21510 first: Int 21511 21512 """Returns the elements that come after the specified cursor.""" 21513 after: String 21514 21515 """Returns up to the last `n` elements from the list.""" 21516 last: Int 21517 21518 """Returns the elements that come before the specified cursor.""" 21519 before: String 21520 21521 """Reverse the order of the underlying list.""" 21522 reverse: Boolean = false 21523 ): StorefrontAccessTokenConnection! 21524 21525 """The URL of the shop's storefront.""" 21526 storefrontUrl: URL! @deprecated(reason: "Use `url` instead") 21527 21528 """Specifies whether or not taxes are charged for shipping.""" 21529 taxShipping: Boolean! 21530 21531 """ 21532 The setting for whether applicable taxes are included in product prices. 21533 """ 21534 taxesIncluded: Boolean! 21535 21536 """The shop's time zone abbreviation.""" 21537 timezoneAbbreviation: String! 21538 21539 """The shop's time zone offset.""" 21540 timezoneOffset: String! 21541 21542 """The shop's time zone offset expressed in number of minutes.""" 21543 timezoneOffsetMinutes: Int! 21544 21545 """The translations associated with the resource.""" 21546 translations( 21547 """Filters translations locale.""" 21548 locale: String! 21549 ): [PublishedTranslation!]! 21550 21551 """The shop's unit system.""" 21552 unitSystem: UnitSystem! 21553 21554 """All images uploaded to the shop.""" 21555 uploadedImages( 21556 """Returns up to the first `n` elements from the list.""" 21557 first: Int 21558 21559 """Returns the elements that come after the specified cursor.""" 21560 after: String 21561 21562 """Returns up to the last `n` elements from the list.""" 21563 last: Int 21564 21565 """Returns the elements that come before the specified cursor.""" 21566 before: String 21567 21568 """Reverse the order of the underlying list.""" 21569 reverse: Boolean = false 21570 21571 """Sort the underlying list by the given key.""" 21572 sortKey: ShopImageSortKeys = CREATED_AT 21573 21574 """ 21575 Image width in pixels between 1 and 2048. This argument is deprecated: Use `maxWidth` on `Image.transformedSrc` instead. 21576 """ 21577 maxWidth: Int 21578 21579 """ 21580 Image height in pixels between 1 and 2048. This argument is deprecated: Use `maxHeight` on `Image.transformedSrc` instead. 21581 """ 21582 maxHeight: Int 21583 21584 """ 21585 Crops the image according to the specified region. This argument is deprecated: Use `crop` on `Image.transformedSrc` instead. 21586 """ 21587 crop: CropRegion 21588 21589 """ 21590 Image size multiplier for high-resolution retina displays. Must be between 1 and 3. This argument is deprecated: Use `scale` on `Image.transformedSrc` instead. 21591 """ 21592 scale: Int = 1 21593 ): ImageConnection! 21594 21595 """Fetch list of images uploaded to shop by ids.""" 21596 uploadedImagesByIds( 21597 """The ids of uploaded images.""" 21598 imageIds: [ID!]! 21599 ): [Image!]! 21600 21601 """The URL of the shop's storefront.""" 21602 url: URL! 21603 21604 """The shop's primary unit of weight for products and shipping.""" 21605 weightUnit: WeightUnit! 21606 } 21607 21608 """Alert message that appears in the Shopify admin.""" 21609 type ShopAlert { 21610 """Button in the alert that links to related information.""" 21611 action: ShopAlertAction! 21612 21613 """Description of the alert.""" 21614 description: String! 21615 } 21616 21617 """An action associated to a shop alert.""" 21618 type ShopAlertAction { 21619 """Action title.""" 21620 title: String! 21621 21622 """Action target URL.""" 21623 url: URL! 21624 } 21625 21626 """ 21627 Possible branding of a shop. 21628 Branding can be used to define the look of a shop including its styling and logo in the Shopify Admin. 21629 21630 """ 21631 enum ShopBranding { 21632 """Shop has Shopify Gold branding.""" 21633 SHOPIFY_GOLD 21634 21635 """Shop has Shopify Plus branding.""" 21636 SHOPIFY_PLUS 21637 21638 """Shop has Rogers branding.""" 21639 ROGERS 21640 21641 """Shop has Shopify branding.""" 21642 SHOPIFY 21643 } 21644 21645 """ 21646 Represents the shop's customer account requirement preference. 21647 21648 """ 21649 enum ShopCustomerAccountsSetting { 21650 REQUIRED 21651 OPTIONAL 21652 DISABLED 21653 } 21654 21655 """ 21656 Represents the feature set available to the shop. 21657 21658 """ 21659 type ShopFeatures { 21660 """Whether a shop has access to avalara avatax.""" 21661 avalaraAvatax: Boolean! 21662 21663 """Branding of the shop.""" 21664 branding: ShopBranding! 21665 21666 """Whether a shop's storefront can have CAPTCHA protection.""" 21667 captcha: Boolean! 21668 21669 """ 21670 Whether a shop's storefront can have CAPTCHA protection for domains not managed by Shopify. 21671 """ 21672 captchaExternalDomains: Boolean! 21673 21674 """Whether the delivery profiles functionality is enabled for this shop.""" 21675 deliveryProfiles: Boolean! @deprecated(reason: "Delivery profiles are now 100% enabled across Shopify.") 21676 21677 """Whether a shop has access to the dynamic remarketing feature.""" 21678 dynamicRemarketing: Boolean! 21679 21680 """Whether a shop can be migrated to use Shopify subscriptions.""" 21681 eligibleForSubscriptionMigration: Boolean! 21682 21683 """Whether a shop is configured properly to sell subscriptions.""" 21684 eligibleForSubscriptions: Boolean! 21685 21686 """Whether a shop can create gift cards.""" 21687 giftCards: Boolean! 21688 21689 """ 21690 Display Harmonized System codes on products. Used for customs when shipping cross-border. 21691 """ 21692 harmonizedSystemCode: Boolean! 21693 21694 """Whether a shop can enable international domains.""" 21695 internationalDomains: Boolean! 21696 21697 """Whether a shop can enable international price overrides.""" 21698 internationalPriceOverrides: Boolean! 21699 21700 """Whether a shop can enable international price rules.""" 21701 internationalPriceRules: Boolean! 21702 21703 """ 21704 Whether a shop has enabled a legacy subscription gateway to handle older subscriptions. 21705 """ 21706 legacySubscriptionGatewayEnabled: Boolean! 21707 21708 """ 21709 Whether to show the live view. Live view is hidden from merchants that are on a trial or don't have a storefront. 21710 """ 21711 liveView: Boolean! 21712 21713 """Whether the multi-location functionality is enabled for this shop.""" 21714 multiLocation: Boolean! 21715 21716 """Whether a shop has access to the onboarding visual.""" 21717 onboardingVisual: Boolean! 21718 21719 """Whether a shop has access to all reporting features.""" 21720 reports: Boolean! 21721 21722 """Whether the shop has ever had subscription products.""" 21723 sellsSubscriptions: Boolean! 21724 21725 """Whether the shop has a Shopify Plus subscription.""" 21726 shopifyPlus: Boolean! @deprecated(reason: "Use Shop.plan.shopifyPlus instead.") 21727 21728 """ 21729 Whether to show metrics. Metrics are hidden for new merchants until they become meaningful. 21730 """ 21731 showMetrics: Boolean! 21732 21733 """Whether the shop has an online storefront.""" 21734 storefront: Boolean! 21735 } 21736 21737 """The set of valid sort keys for the ShopImage query.""" 21738 enum ShopImageSortKeys { 21739 """Sort by the `created_at` value.""" 21740 CREATED_AT 21741 21742 """Sort by the `id` value.""" 21743 ID 21744 21745 """ 21746 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 21747 results by relevance to the search term(s). When no search query is specified, this sort key is not 21748 deterministic and should not be used. 21749 21750 """ 21751 RELEVANCE 21752 } 21753 21754 """Available locale for a shop.""" 21755 type ShopLocale { 21756 """Locale identifier.""" 21757 locale: String! 21758 21759 """Locale name.""" 21760 name: String! 21761 21762 """Whether or not this is the default locale for the shop.""" 21763 primary: Boolean! 21764 21765 """Whether or not the locale is published.""" 21766 published: Boolean! 21767 } 21768 21769 """Return type for `shopLocaleDisable` mutation.""" 21770 type ShopLocaleDisablePayload { 21771 """The locale identifier that was disabled.""" 21772 locale: String 21773 21774 """List of errors that occurred executing the mutation.""" 21775 userErrors: [UserError!]! 21776 } 21777 21778 """Return type for `shopLocaleEnable` mutation.""" 21779 type ShopLocaleEnablePayload { 21780 """The locale that was enabled.""" 21781 shopLocale: ShopLocale 21782 21783 """List of errors that occurred executing the mutation.""" 21784 userErrors: [UserError!]! 21785 } 21786 21787 """ 21788 Specifies the input fields for a shop locale. 21789 21790 """ 21791 input ShopLocaleInput { 21792 """Specifies the publication state of the locale.""" 21793 published: Boolean 21794 } 21795 21796 """Return type for `shopLocaleUpdate` mutation.""" 21797 type ShopLocaleUpdatePayload { 21798 """The locale that was updated.""" 21799 shopLocale: ShopLocale 21800 21801 """List of errors that occurred executing the mutation.""" 21802 userErrors: [UserError!]! 21803 } 21804 21805 """ 21806 Represents the billing plan of the shop. 21807 21808 """ 21809 type ShopPlan { 21810 """The name of the shop's billing plan.""" 21811 displayName: String! 21812 21813 """Whether the shop is a partner development shop for testing purposes.""" 21814 partnerDevelopment: Boolean! 21815 21816 """Whether the shop has a Shopify Plus subscription.""" 21817 shopifyPlus: Boolean! 21818 } 21819 21820 """ 21821 Policy that a merchant has configured for their store, such as their refund or privacy policy. 21822 """ 21823 type ShopPolicy implements Node & HasPublishedTranslations { 21824 """The text of the policy. The maximum size is 512kb.""" 21825 body: HTML! 21826 21827 """Globally unique identifier.""" 21828 id: ID! 21829 21830 """The translations associated with the resource.""" 21831 translations( 21832 """Filters translations locale.""" 21833 locale: String! 21834 ): [PublishedTranslation!]! 21835 21836 """The shop policy type.""" 21837 type: ShopPolicyType! 21838 21839 """The public URL of the policy.""" 21840 url: URL! 21841 } 21842 21843 """Possible error codes that could be returned by ShopPolicyUserError.""" 21844 enum ShopPolicyErrorCode { 21845 """Input value is too big.""" 21846 TOO_BIG 21847 } 21848 21849 """Specifies the input fields required to update a policy.""" 21850 input ShopPolicyInput { 21851 """The shop policy type.""" 21852 type: ShopPolicyType! 21853 21854 """Policy text, maximum size of 512kb.""" 21855 body: String! 21856 } 21857 21858 """Available shop policy types.""" 21859 enum ShopPolicyType { 21860 """The Refund policy.""" 21861 REFUND_POLICY 21862 21863 """The Shipping policy.""" 21864 SHIPPING_POLICY 21865 21866 """The Privacy policy.""" 21867 PRIVACY_POLICY 21868 21869 """The Terms of service.""" 21870 TERMS_OF_SERVICE 21871 21872 """The Terms of sale.""" 21873 TERMS_OF_SALE 21874 21875 """The Legal notice.""" 21876 LEGAL_NOTICE 21877 } 21878 21879 """Return type for `shopPolicyUpdate` mutation.""" 21880 type ShopPolicyUpdatePayload { 21881 """The shop policy that has been updated.""" 21882 shopPolicy: ShopPolicy 21883 21884 """List of errors that occurred executing the mutation.""" 21885 userErrors: [ShopPolicyUserError!]! 21886 } 21887 21888 """An error that occurs during the execution of a shop policy mutation.""" 21889 type ShopPolicyUserError implements DisplayableError { 21890 """Error code to uniquely identify the error.""" 21891 code: ShopPolicyErrorCode 21892 21893 """Path to the input field which caused the error.""" 21894 field: [String!] 21895 21896 """The error message.""" 21897 message: String! 21898 } 21899 21900 """Resource limits of a shop.""" 21901 type ShopResourceLimits { 21902 """Maximum number of locations allowed.""" 21903 locationLimit: Int! 21904 21905 """Maximum number of product options allowed.""" 21906 maxProductOptions: Int! 21907 21908 """The maximum number of variants allowed per product.""" 21909 maxProductVariants: Int! 21910 21911 """ 21912 Whether the shop has reached the limit of the number of URL redirects it can make for resources. 21913 """ 21914 redirectLimitReached: Boolean! 21915 21916 """ 21917 The maximum number of variants allowed per shop. If the shop has unlimited SKUs, then the quantity used cannot be retrieved. 21918 """ 21919 skuResourceLimits: ResourceLimit! 21920 } 21921 21922 """Possible sort of tags.""" 21923 enum ShopTagSort { 21924 """Alphabetical sort.""" 21925 ALPHABETICAL 21926 21927 """Popularity sort.""" 21928 POPULAR 21929 } 21930 21931 """ 21932 Balance and payout information for a 21933 [Shopify Payments](https://help.shopify.com/manual/payments/shopify-payments/getting-paid-with-shopify-payments) 21934 account. Balance includes all balances for the currencies supported by the shop. 21935 You can also query for a list of payouts, where each payout includes the corresponding currencyCode field. 21936 21937 """ 21938 type ShopifyPaymentsAccount implements Node { 21939 """Whether the Shopify Payments setup is completed.""" 21940 activated: Boolean! 21941 21942 """Current balances in all currencies for the account.""" 21943 balance: [MoneyV2!]! 21944 21945 """All bank accounts configured for the Shopify Payments account.""" 21946 bankAccounts( 21947 """Returns up to the first `n` elements from the list.""" 21948 first: Int 21949 21950 """Returns the elements that come after the specified cursor.""" 21951 after: String 21952 21953 """Returns up to the last `n` elements from the list.""" 21954 last: Int 21955 21956 """Returns the elements that come before the specified cursor.""" 21957 before: String 21958 21959 """Reverse the order of the underlying list.""" 21960 reverse: Boolean = false 21961 ): ShopifyPaymentsBankAccountConnection! 21962 21963 """ 21964 Statement descriptor used for charges. 21965 21966 This is what buyers will see on their credit card or bank statements when making a purchase. 21967 21968 """ 21969 chargeStatementDescriptor: String @deprecated(reason: "Use `chargeStatementDescriptors` instead") 21970 21971 """ 21972 Statement descriptors used for charges. 21973 21974 This is what buyers will see on their credit card or bank statements when making a purchase. 21975 21976 """ 21977 chargeStatementDescriptors: ShopifyPaymentsChargeStatementDescriptor 21978 21979 """The Shopify Payments account country.""" 21980 country: String! 21981 21982 """The default payout currency for the Shopify Payments account.""" 21983 defaultCurrency: CurrencyCode! 21984 21985 """All disputes related to the Shopify Payments account.""" 21986 disputes( 21987 """Returns up to the first `n` elements from the list.""" 21988 first: Int 21989 21990 """Returns the elements that come after the specified cursor.""" 21991 after: String 21992 21993 """Returns up to the last `n` elements from the list.""" 21994 last: Int 21995 21996 """Returns the elements that come before the specified cursor.""" 21997 before: String 21998 21999 """Reverse the order of the underlying list.""" 22000 reverse: Boolean = false 22001 22002 """ 22003 Supported filter parameters: 22004 - `id` 22005 - `initiated_at` 22006 - `status` 22007 22008 See the detailed [search syntax](https://help.shopify.com/api/getting-started/search-syntax) 22009 for more information about using filters. 22010 22011 """ 22012 query: String 22013 ): ShopifyPaymentsDisputeConnection! 22014 22015 """The fraud settings of the Shopify Payments account.""" 22016 fraudSettings: ShopifyPaymentsFraudSettings! 22017 22018 """Globally unique identifier.""" 22019 id: ID! 22020 22021 """The notifications settings for the account.""" 22022 notificationSettings: ShopifyPaymentsNotificationSettings! 22023 22024 """Whether the Shopify Payments account can be onboarded.""" 22025 onboardable: Boolean! 22026 22027 """Payout schedule for the account.""" 22028 payoutSchedule: ShopifyPaymentsPayoutSchedule! 22029 22030 """ 22031 Descriptor used for payouts. 22032 22033 This is what merchants will see on their bank statement when receiving a payout. 22034 22035 """ 22036 payoutStatementDescriptor: String 22037 22038 """ 22039 All current and previous payouts made between the account and the bank account. 22040 """ 22041 payouts( 22042 """Filter the direction of the payout.""" 22043 transactionType: ShopifyPaymentsPayoutTransactionType 22044 22045 """Returns up to the first `n` elements from the list.""" 22046 first: Int 22047 22048 """Returns the elements that come after the specified cursor.""" 22049 after: String 22050 22051 """Returns up to the last `n` elements from the list.""" 22052 last: Int 22053 22054 """Returns the elements that come before the specified cursor.""" 22055 before: String 22056 22057 """Reverse the order of the underlying list.""" 22058 reverse: Boolean = false 22059 ): ShopifyPaymentsPayoutConnection! 22060 22061 """The permitted documents for identity verification.""" 22062 permittedVerificationDocuments: [ShopifyPaymentsVerificationDocument!]! 22063 22064 """The verifications necessary for this account.""" 22065 verifications: [ShopifyPaymentsVerification!]! 22066 } 22067 22068 """ 22069 A bank account that can receive payouts. 22070 22071 """ 22072 type ShopifyPaymentsBankAccount implements Node { 22073 """ 22074 The account number of the bank account. 22075 22076 """ 22077 accountNumber: String! 22078 22079 """ 22080 The last digits of the account number (the rest is redacted). 22081 22082 """ 22083 accountNumberLastDigits: String! 22084 22085 """ 22086 The name of the bank. 22087 22088 """ 22089 bankName: String 22090 22091 """ 22092 The country of the bank. 22093 22094 """ 22095 country: CountryCode! 22096 22097 """The date that the bank account was created.""" 22098 createdAt: DateTime! 22099 22100 """ 22101 The currency of the bank account. 22102 22103 """ 22104 currency: CurrencyCode! 22105 22106 """Globally unique identifier.""" 22107 id: ID! 22108 22109 """ 22110 All current and previous payouts made between the account and the bank account. 22111 """ 22112 payouts( 22113 """Filter the direction of the payout.""" 22114 transactionType: ShopifyPaymentsPayoutTransactionType 22115 22116 """Returns up to the first `n` elements from the list.""" 22117 first: Int 22118 22119 """Returns the elements that come after the specified cursor.""" 22120 after: String 22121 22122 """Returns up to the last `n` elements from the list.""" 22123 last: Int 22124 22125 """Returns the elements that come before the specified cursor.""" 22126 before: String 22127 22128 """Reverse the order of the underlying list.""" 22129 reverse: Boolean = false 22130 ): ShopifyPaymentsPayoutConnection! 22131 22132 """ 22133 The routing number of the bank account. 22134 22135 """ 22136 routingNumber: String! 22137 22138 """ 22139 The status of the bank account. 22140 22141 """ 22142 status: ShopifyPaymentsBankAccountStatus! 22143 } 22144 22145 """ 22146 An auto-generated type for paginating through multiple ShopifyPaymentsBankAccounts. 22147 22148 """ 22149 type ShopifyPaymentsBankAccountConnection { 22150 """A list of edges.""" 22151 edges: [ShopifyPaymentsBankAccountEdge!]! 22152 22153 """Information to aid in pagination.""" 22154 pageInfo: PageInfo! 22155 } 22156 22157 """ 22158 An auto-generated type which holds one ShopifyPaymentsBankAccount and a cursor during pagination. 22159 22160 """ 22161 type ShopifyPaymentsBankAccountEdge { 22162 """A cursor for use in pagination.""" 22163 cursor: String! 22164 22165 """The item at the end of ShopifyPaymentsBankAccountEdge.""" 22166 node: ShopifyPaymentsBankAccount! 22167 } 22168 22169 """The bank account status.""" 22170 enum ShopifyPaymentsBankAccountStatus { 22171 """A bank account that hasn't had any activity and that's not validated.""" 22172 NEW 22173 22174 """It was determined that the bank account exists.""" 22175 VALIDATED 22176 22177 """Bank account validation was successful.""" 22178 VERIFIED 22179 22180 """A payout to the bank account failed.""" 22181 ERRORED 22182 } 22183 22184 """The charge descriptors for a payments account.""" 22185 interface ShopifyPaymentsChargeStatementDescriptor { 22186 """The default charge statement descriptor.""" 22187 default: String 22188 22189 """The prefix of the statement descriptor.""" 22190 prefix: String! 22191 } 22192 22193 """The charge descriptors for a payments account.""" 22194 type ShopifyPaymentsDefaultChargeStatementDescriptor implements ShopifyPaymentsChargeStatementDescriptor { 22195 """The default charge statement descriptor.""" 22196 default: String 22197 22198 """The prefix of the statement descriptor.""" 22199 prefix: String! 22200 } 22201 22202 """ 22203 A dispute occurs when a buyer questions the legitimacy of a charge with their financial institution. 22204 """ 22205 type ShopifyPaymentsDispute implements LegacyInteroperability & Node { 22206 """The total amount disputed by the cardholder.""" 22207 amount: MoneyV2! 22208 22209 """The deadline for evidence submission.""" 22210 evidenceDueBy: Date 22211 22212 """ 22213 The date when evidence was sent. Returns null if evidence has not yet been sent. 22214 """ 22215 evidenceSentOn: Date 22216 22217 """ 22218 The date when this dispute was resolved. Returns null if the dispute is not yet resolved. 22219 """ 22220 finalizedOn: Date 22221 22222 """Globally unique identifier.""" 22223 id: ID! 22224 22225 """The date when this dispute was initiated.""" 22226 initiatedAt: DateTime! 22227 22228 """The ID of the corresponding resource in the REST Admin API.""" 22229 legacyResourceId: UnsignedInt64! 22230 22231 """The order that contains the charge that is under dispute.""" 22232 order: Order 22233 22234 """The reason of the dispute.""" 22235 reasonDetails: ShopifyPaymentsDisputeReasonDetails! 22236 22237 """The current state of the dispute.""" 22238 status: DisputeStatus! 22239 22240 """ 22241 Indicates if this dispute is still in the inquiry phase or has turned into a chargeback. 22242 """ 22243 type: DisputeType! 22244 } 22245 22246 """ 22247 An auto-generated type for paginating through multiple ShopifyPaymentsDisputes. 22248 22249 """ 22250 type ShopifyPaymentsDisputeConnection { 22251 """A list of edges.""" 22252 edges: [ShopifyPaymentsDisputeEdge!]! 22253 22254 """Information to aid in pagination.""" 22255 pageInfo: PageInfo! 22256 } 22257 22258 """ 22259 An auto-generated type which holds one ShopifyPaymentsDispute and a cursor during pagination. 22260 22261 """ 22262 type ShopifyPaymentsDisputeEdge { 22263 """A cursor for use in pagination.""" 22264 cursor: String! 22265 22266 """The item at the end of ShopifyPaymentsDisputeEdge.""" 22267 node: ShopifyPaymentsDispute! 22268 } 22269 22270 """The reason for the dispute provided by the cardholder's bank.""" 22271 enum ShopifyPaymentsDisputeReason { 22272 """The cardholder claims that they didn’t authorize the payment.""" 22273 FRAUDULENT 22274 22275 """ 22276 The dispute is uncategorized, so you should contact the customer for additional details to find out why the payment was disputed. 22277 """ 22278 GENERAL 22279 22280 """ 22281 The customer doesn’t recognize the payment appearing on their card statement. 22282 """ 22283 UNRECOGNIZED 22284 22285 """ 22286 The customer claims they were charged multiple times for the same product or service. 22287 """ 22288 DUPLICATE 22289 22290 """ 22291 The customer claims that you continued to charge them after a subscription was canceled. 22292 """ 22293 SUBSCRIPTION_CANCELLED 22294 22295 """ 22296 The product or service was received but was defective, damaged, or not as described. 22297 """ 22298 PRODUCT_UNACCEPTABLE 22299 22300 """ 22301 The customer claims they did not receive the products or services purchased. 22302 """ 22303 PRODUCT_NOT_RECEIVED 22304 22305 """ 22306 The customer claims that the purchased product was returned or the transaction was otherwise canceled, but you have not yet provided a refund or credit. 22307 """ 22308 CREDIT_NOT_PROCESSED 22309 22310 """The customer account associated with the purchase is incorrect.""" 22311 INCORRECT_ACCOUNT_DETAILS 22312 22313 """The customer's bank account has insufficient funds.""" 22314 INSUFFICIENT_FUNDS 22315 22316 """The customer's bank cannot process the charge.""" 22317 BANK_CANNOT_PROCESS 22318 22319 """ 22320 The customer's bank cannot proceed with the debit since it has not been authorized. 22321 """ 22322 DEBIT_NOT_AUTHORIZED 22323 22324 """ 22325 The customer initiated the dispute, so you should contact the customer for additional details to find out why the payment was disputed. 22326 """ 22327 CUSTOMER_INITIATED 22328 } 22329 22330 """Details regarding a dispute reason.""" 22331 type ShopifyPaymentsDisputeReasonDetails { 22332 """The raw code provided by the payment network.""" 22333 networkReasonCode: String 22334 22335 """The reason for the dispute provided by the cardholder's banks.""" 22336 reason: ShopifyPaymentsDisputeReason! 22337 } 22338 22339 """ 22340 Presents all Shopify Payments information related to an extended authorization. 22341 """ 22342 type ShopifyPaymentsExtendedAuthorization { 22343 """ 22344 The time after which the extended authorization expires. After the expiry, the merchant is unable to capture the payment. 22345 22346 """ 22347 extendedAuthorizationExpiresAt: DateTime! 22348 22349 """ 22350 The time after which capture will incur an additional fee. 22351 22352 """ 22353 standardAuthorizationExpiresAt: DateTime! 22354 } 22355 22356 """The fraud settings of a payments account.""" 22357 type ShopifyPaymentsFraudSettings { 22358 """Decline a charge if there is an AVS failure.""" 22359 declineChargeOnAvsFailure: Boolean! 22360 22361 """Decline a charge if there is an CVC failure.""" 22362 declineChargeOnCvcFailure: Boolean! 22363 } 22364 22365 """The charge descriptors for a Japanese payments account.""" 22366 type ShopifyPaymentsJpChargeStatementDescriptor implements ShopifyPaymentsChargeStatementDescriptor { 22367 """The default charge statement descriptor.""" 22368 default: String 22369 22370 """The charge statement descriptor in kana.""" 22371 kana: String 22372 22373 """The charge statement descriptor in kanji.""" 22374 kanji: String 22375 22376 """The prefix of the statement descriptor.""" 22377 prefix: String! 22378 } 22379 22380 """The notification settings for the account.""" 22381 type ShopifyPaymentsNotificationSettings { 22382 """Receive email notifications when new payouts are sent or payouts fail.""" 22383 payouts: Boolean! 22384 } 22385 22386 """ 22387 Payouts represent the movement of money between a merchant's Shopify 22388 Payments balance and their bank account. 22389 22390 """ 22391 type ShopifyPaymentsPayout implements LegacyInteroperability & Node { 22392 """The bank account for the payout.""" 22393 bankAccount: ShopifyPaymentsBankAccount! 22394 22395 """The total amount and currency of the payout.""" 22396 gross: MoneyV2! @deprecated(reason: "Use `net` instead") 22397 22398 """Globally unique identifier.""" 22399 id: ID! 22400 22401 """ 22402 The exact time when the payout was issued. The payout only contains 22403 balance transactions that were available at this time. 22404 22405 """ 22406 issuedAt: DateTime! 22407 22408 """The ID of the corresponding resource in the REST Admin API.""" 22409 legacyResourceId: UnsignedInt64! 22410 22411 """The total amount and currency of the payout.""" 22412 net: MoneyV2! 22413 22414 """The transfer status of the payout.""" 22415 status: ShopifyPaymentsPayoutStatus! 22416 22417 """The summary of the payout.""" 22418 summary: ShopifyPaymentsPayoutSummary! 22419 22420 """The direction of the payout.""" 22421 transactionType: ShopifyPaymentsPayoutTransactionType! 22422 } 22423 22424 """ 22425 An auto-generated type for paginating through multiple ShopifyPaymentsPayouts. 22426 22427 """ 22428 type ShopifyPaymentsPayoutConnection { 22429 """A list of edges.""" 22430 edges: [ShopifyPaymentsPayoutEdge!]! 22431 22432 """Information to aid in pagination.""" 22433 pageInfo: PageInfo! 22434 } 22435 22436 """ 22437 An auto-generated type which holds one ShopifyPaymentsPayout and a cursor during pagination. 22438 22439 """ 22440 type ShopifyPaymentsPayoutEdge { 22441 """A cursor for use in pagination.""" 22442 cursor: String! 22443 22444 """The item at the end of ShopifyPaymentsPayoutEdge.""" 22445 node: ShopifyPaymentsPayout! 22446 } 22447 22448 """The interval at which payouts are sent to the connected bank account.""" 22449 enum ShopifyPaymentsPayoutInterval { 22450 """Each business day.""" 22451 DAILY 22452 22453 """Each week, on the day of week specified by weeklyAnchor.""" 22454 WEEKLY 22455 22456 """Each month, on the day of month specified by monthlyAnchor.""" 22457 MONTHLY 22458 22459 """Payouts will not be automatically made.""" 22460 MANUAL 22461 } 22462 22463 """The payment schedule for a payments account.""" 22464 type ShopifyPaymentsPayoutSchedule { 22465 """The interval at which payouts are sent to the connected bank account.""" 22466 interval: ShopifyPaymentsPayoutInterval! 22467 22468 """ 22469 The day of the month funds will be paid out. 22470 22471 The value can be any day of the month from the 1st to the 31st. 22472 If the payment interval is set to monthly, this value will be used. 22473 Payouts scheduled between 29-31st of the month are sent on the last day of shorter months. 22474 22475 """ 22476 monthlyAnchor: Int 22477 22478 """ 22479 The day of the week funds will be paid out. 22480 22481 The value can be any weekday from Monday to Friday. 22482 If the payment interval is set to weekly, this value will be used. 22483 22484 """ 22485 weeklyAnchor: DayOfTheWeek 22486 } 22487 22488 """The transfer status of the payout.""" 22489 enum ShopifyPaymentsPayoutStatus { 22490 """ 22491 The payout has been created and had transactions assigned to it, but 22492 it has not yet been submitted to the bank. 22493 22494 """ 22495 SCHEDULED 22496 22497 """The payout has been submitted to the bank.""" 22498 IN_TRANSIT 22499 22500 """The payout has been successfully deposited into the bank.""" 22501 PAID 22502 22503 """The payout has been declined by the bank.""" 22504 FAILED 22505 22506 """The payout has been canceled by Shopify.""" 22507 CANCELED 22508 } 22509 22510 """ 22511 Breakdown of the total fees and gross of each of the different types of transactions associated 22512 with the payout. 22513 22514 """ 22515 type ShopifyPaymentsPayoutSummary { 22516 """Total fees for all adjustments including disputes.""" 22517 adjustmentsFee: MoneyV2! 22518 22519 """Total gross amount for all adjustments including disputes.""" 22520 adjustmentsGross: MoneyV2! 22521 22522 """Total fees for all charges.""" 22523 chargesFee: MoneyV2! 22524 22525 """Total gross amount for all charges.""" 22526 chargesGross: MoneyV2! 22527 22528 """Total fees for all refunds.""" 22529 refundsFee: MoneyV2! 22530 22531 """Total gross amount for all refunds.""" 22532 refundsFeeGross: MoneyV2! 22533 22534 """Total fees for all reserved funds.""" 22535 reservedFundsFee: MoneyV2! 22536 22537 """Total gross amount for all reserved funds.""" 22538 reservedFundsGross: MoneyV2! 22539 22540 """Total fees for all retried payouts.""" 22541 retriedPayoutsFee: MoneyV2! 22542 22543 """Total gross amount for all retried payouts.""" 22544 retriedPayoutsGross: MoneyV2! 22545 } 22546 22547 """The possible transaction types for a payout.""" 22548 enum ShopifyPaymentsPayoutTransactionType { 22549 """The payout is a deposit.""" 22550 DEPOSIT 22551 22552 """The payout is a withdrawal.""" 22553 WITHDRAWAL 22554 } 22555 22556 """ 22557 Presents all Shopify Payments specific information related to an order transaction. 22558 """ 22559 type ShopifyPaymentsTransactionSet { 22560 """ 22561 Contains all fields related to an extended authorization. 22562 22563 """ 22564 extendedAuthorizationSet: ShopifyPaymentsExtendedAuthorization 22565 } 22566 22567 """ 22568 Each subject (individual) of an account has a verification object giving 22569 information about the verification state. 22570 22571 """ 22572 type ShopifyPaymentsVerification implements Node { 22573 """Globally unique identifier.""" 22574 id: ID! 22575 22576 """The status of the verification.""" 22577 status: ShopifyPaymentsVerificationStatus! 22578 22579 """The subject/individual who has to be verified.""" 22580 subject: ShopifyPaymentsVerificationSubject! 22581 } 22582 22583 """A document which can be used to verify an individual.""" 22584 type ShopifyPaymentsVerificationDocument { 22585 """True if the back side of the document is required.""" 22586 backRequired: Boolean! 22587 22588 """True if the front side of the document is required.""" 22589 frontRequired: Boolean! 22590 22591 """The type of the document which can be used for verification.""" 22592 type: ShopifyPaymentsVerificationDocumentType! 22593 } 22594 22595 """The types of possible verification documents.""" 22596 enum ShopifyPaymentsVerificationDocumentType { 22597 """The subject's driver's license.""" 22598 DRIVERS_LICENSE 22599 22600 """A government's identification document of the subject.""" 22601 GOVERNMENT_IDENTIFICATION 22602 22603 """The subject's passport.""" 22604 PASSPORT 22605 } 22606 22607 """The status of a verification.""" 22608 enum ShopifyPaymentsVerificationStatus { 22609 """The verification has been verified.""" 22610 VERIFIED 22611 22612 """The verification has not yet been verified.""" 22613 UNVERIFIED 22614 22615 """ 22616 The verification request has been submitted but a response has not yet been given. 22617 """ 22618 PENDING 22619 } 22620 22621 """ 22622 The verification subject represents an individual that has to be verified. 22623 """ 22624 type ShopifyPaymentsVerificationSubject { 22625 """The family name of the individual to verify.""" 22626 familyName: String! 22627 22628 """The given name of the individual to verify.""" 22629 givenName: String! 22630 } 22631 22632 """Image to be uploaded.""" 22633 input StageImageInput { 22634 """Image resource.""" 22635 resource: StagedUploadTargetGenerateUploadResource! 22636 22637 """Image filename.""" 22638 filename: String! 22639 22640 """Image MIME type.""" 22641 mimeType: String! 22642 22643 """HTTP method to be used by the Staged Upload.""" 22644 httpMethod: StagedUploadHttpMethodType = PUT 22645 } 22646 22647 """Staged media target information.""" 22648 type StagedMediaUploadTarget { 22649 """Parameters of the media to be uploaded.""" 22650 parameters: [StagedUploadParameter!]! 22651 22652 """ 22653 The url to be passed as the original_source for the product create media mutation input. 22654 """ 22655 resourceUrl: URL 22656 22657 """Media URL.""" 22658 url: URL 22659 } 22660 22661 """Possible HTTP method of a staged upload target.""" 22662 enum StagedUploadHttpMethodType { 22663 """The POST HTTP method.""" 22664 POST 22665 22666 """The PUT HTTP method.""" 22667 PUT 22668 } 22669 22670 """Media to be uploaded.""" 22671 input StagedUploadInput { 22672 """Media resource.""" 22673 resource: StagedUploadTargetGenerateUploadResource! 22674 22675 """Media filename.""" 22676 filename: String! 22677 22678 """Media MIME type.""" 22679 mimeType: String! 22680 22681 """HTTP method to be used by the Staged Upload.""" 22682 httpMethod: StagedUploadHttpMethodType = PUT 22683 22684 """ 22685 Size of the file to upload, in bytes. This is required for VIDEO and MODEL_3D resources. 22686 """ 22687 fileSize: UnsignedInt64 22688 } 22689 22690 """Upload parameter of a Media.""" 22691 type StagedUploadParameter { 22692 """Parameter name.""" 22693 name: String! 22694 22695 """Parameter value.""" 22696 value: String! 22697 } 22698 22699 """Staged target information.""" 22700 type StagedUploadTarget { 22701 """Parameters of an image to be uploaded.""" 22702 parameters: [ImageUploadParameter!]! 22703 22704 """Image URL.""" 22705 url: String! 22706 } 22707 22708 """ 22709 Specifies the fields required to generate the URL and parameters needed to upload an asset to Shopify. 22710 """ 22711 input StagedUploadTargetGenerateInput { 22712 """The resource type being uploaded.""" 22713 resource: StagedUploadTargetGenerateUploadResource! 22714 22715 """The filename of the asset being uploaded.""" 22716 filename: String! 22717 22718 """The MIME type of the asset being uploaded.""" 22719 mimeType: String! 22720 22721 """The HTTP method to be used by the staged upload.""" 22722 httpMethod: StagedUploadHttpMethodType = PUT 22723 22724 """The size of the file to upload, in bytes.""" 22725 fileSize: UnsignedInt64 22726 } 22727 22728 """Return type for `stagedUploadTargetGenerate` mutation.""" 22729 type StagedUploadTargetGeneratePayload { 22730 """The signed parameters that can be used to upload the asset.""" 22731 parameters: [MutationsStagedUploadTargetGenerateUploadParameter!]! 22732 22733 """The signed URL where the asset can be uploaded.""" 22734 url: String! 22735 22736 """List of errors that occurred executing the mutation.""" 22737 userErrors: [UserError!]! 22738 } 22739 22740 """Specifies the resource type to receive.""" 22741 enum StagedUploadTargetGenerateUploadResource { 22742 """A timeline event.""" 22743 TIMELINE 22744 22745 """A product image.""" 22746 PRODUCT_IMAGE 22747 22748 """A collection image.""" 22749 COLLECTION_IMAGE 22750 22751 """A shop image.""" 22752 SHOP_IMAGE 22753 22754 """Merchandising::Video resource representation.""" 22755 VIDEO 22756 22757 """Merchandising::Model3d resource representation.""" 22758 MODEL_3D 22759 22760 """Merchandising::Image resource representation.""" 22761 IMAGE 22762 } 22763 22764 """Return type for `stagedUploadTargetsGenerate` mutation.""" 22765 type StagedUploadTargetsGeneratePayload { 22766 """The staged upload targets that were generated.""" 22767 urls: [StagedUploadTarget!] 22768 22769 """List of errors that occurred executing the mutation.""" 22770 userErrors: [UserError!]! 22771 } 22772 22773 """Return type for `stagedUploadsCreate` mutation.""" 22774 type StagedUploadsCreatePayload { 22775 """The staged upload targets that were generated.""" 22776 stagedTargets: [StagedMediaUploadTarget!] 22777 22778 """List of errors that occurred executing the mutation.""" 22779 userErrors: [UserError!]! 22780 } 22781 22782 """ 22783 Token used to delegate unauthenticated access scopes to clients that need to access the unautheticated Storefront API. 22784 22785 """ 22786 type StorefrontAccessToken implements Node { 22787 """List of permissions associated with the token.""" 22788 accessScopes: [AccessScope!]! 22789 22790 """The issued public access token.""" 22791 accessToken: String! 22792 22793 """The date and time when the public access token was created.""" 22794 createdAt: DateTime! 22795 22796 """Globally unique identifier.""" 22797 id: ID! 22798 22799 """ 22800 An arbitrary title for each token determined by the developer, used for reference purposes. 22801 """ 22802 title: String! 22803 22804 """The date and time when the storefront access token was updated.""" 22805 updatedAt: DateTime! 22806 } 22807 22808 """ 22809 An auto-generated type for paginating through multiple StorefrontAccessTokens. 22810 22811 """ 22812 type StorefrontAccessTokenConnection { 22813 """A list of edges.""" 22814 edges: [StorefrontAccessTokenEdge!]! 22815 22816 """Information to aid in pagination.""" 22817 pageInfo: PageInfo! 22818 } 22819 22820 """Return type for `storefrontAccessTokenCreate` mutation.""" 22821 type StorefrontAccessTokenCreatePayload { 22822 """The user's shop.""" 22823 shop: Shop! 22824 22825 """The storefront access token.""" 22826 storefrontAccessToken: StorefrontAccessToken 22827 22828 """List of errors that occurred executing the mutation.""" 22829 userErrors: [UserError!]! 22830 } 22831 22832 """Specifies the input fields to delete a storefront access token.""" 22833 input StorefrontAccessTokenDeleteInput { 22834 """The ID of the storefront access token to delete.""" 22835 id: ID! 22836 } 22837 22838 """Return type for `storefrontAccessTokenDelete` mutation.""" 22839 type StorefrontAccessTokenDeletePayload { 22840 """The ID of the deleted storefront access token.""" 22841 deletedStorefrontAccessTokenId: ID 22842 22843 """List of errors that occurred executing the mutation.""" 22844 userErrors: [UserError!]! 22845 } 22846 22847 """ 22848 An auto-generated type which holds one StorefrontAccessToken and a cursor during pagination. 22849 22850 """ 22851 type StorefrontAccessTokenEdge { 22852 """A cursor for use in pagination.""" 22853 cursor: String! 22854 22855 """The item at the end of StorefrontAccessTokenEdge.""" 22856 node: StorefrontAccessToken! 22857 } 22858 22859 """Specifies the input fields for a storefront access token.""" 22860 input StorefrontAccessTokenInput { 22861 """A title for the storefront access token.""" 22862 title: String! 22863 } 22864 22865 """ 22866 Represents a unique identifier in the Storefront API. A `StorefrontID` value can be used wherever an ID is expected in the Storefront API. 22867 22868 Example value: `"Z2lkOi8vc2hvcGlmeS9Qcm9kdWN0LzEwMDc5Nzg1MTAw"`. 22869 22870 """ 22871 scalar StorefrontID 22872 22873 """ 22874 An auto-generated type for paginating through multiple Strings. 22875 22876 """ 22877 type StringConnection { 22878 """A list of edges.""" 22879 edges: [StringEdge!]! 22880 22881 """Information to aid in pagination.""" 22882 pageInfo: PageInfo! 22883 } 22884 22885 """ 22886 An auto-generated type which holds one String and a cursor during pagination. 22887 22888 """ 22889 type StringEdge { 22890 """A cursor for use in pagination.""" 22891 cursor: String! 22892 22893 """The item at the end of StringEdge.""" 22894 node: String! 22895 } 22896 22897 """Represents an applied code discount.""" 22898 type SubscriptionAppliedCodeDiscount { 22899 """The unique identifier.""" 22900 id: ID! 22901 22902 """The redeem code of the discount that applies on the subscription.""" 22903 redeemCode: String! 22904 22905 """The reason that the discount on the subscription draft is rejected.""" 22906 rejectionReason: SubscriptionDiscountRejectionReason 22907 } 22908 22909 """Record of an execution of the subscription billing schedule.""" 22910 type SubscriptionBillingAttempt implements Node { 22911 """The date and time when the billing attempt was completed.""" 22912 completedAt: DateTime 22913 22914 """The date and time when the billing attempt was created.""" 22915 createdAt: DateTime! 22916 22917 """A code corresponding to a payment error during processing.""" 22918 errorCode: SubscriptionBillingAttemptErrorCode 22919 22920 """A message describing a payment error during processing.""" 22921 errorMessage: String 22922 22923 """Globally unique identifier.""" 22924 id: ID! 22925 22926 """A unique key generated by the client to avoid duplicate payments.""" 22927 idempotencyKey: String! 22928 22929 """ 22930 The URL where the customer needs to be redirected so they can complete the 3D Secure payment flow. 22931 22932 """ 22933 nextActionUrl: URL 22934 22935 """The result of this billing attempt if completed successfully.""" 22936 order: Order 22937 22938 """Whether or not the billing attempt is still processing.""" 22939 ready: Boolean! 22940 22941 """The subscription contract.""" 22942 subscriptionContract: SubscriptionContract! 22943 } 22944 22945 """ 22946 An auto-generated type for paginating through multiple SubscriptionBillingAttempts. 22947 22948 """ 22949 type SubscriptionBillingAttemptConnection { 22950 """A list of edges.""" 22951 edges: [SubscriptionBillingAttemptEdge!]! 22952 22953 """Information to aid in pagination.""" 22954 pageInfo: PageInfo! 22955 } 22956 22957 """Return type for `subscriptionBillingAttemptCreate` mutation.""" 22958 type SubscriptionBillingAttemptCreatePayload { 22959 """The subscription billing attempt.""" 22960 subscriptionBillingAttempt: SubscriptionBillingAttempt 22961 22962 """List of errors that occurred executing the mutation.""" 22963 userErrors: [BillingAttemptUserError!]! 22964 } 22965 22966 """ 22967 An auto-generated type which holds one SubscriptionBillingAttempt and a cursor during pagination. 22968 22969 """ 22970 type SubscriptionBillingAttemptEdge { 22971 """A cursor for use in pagination.""" 22972 cursor: String! 22973 22974 """The item at the end of SubscriptionBillingAttemptEdge.""" 22975 node: SubscriptionBillingAttempt! 22976 } 22977 22978 """ 22979 The possible error codes associated with making billing attempts. The error codes supplement the 22980 `error_message` to provide consistent results and help with dunning management. 22981 22982 """ 22983 enum SubscriptionBillingAttemptErrorCode { 22984 """ 22985 Payment method was not found. 22986 22987 """ 22988 PAYMENT_METHOD_NOT_FOUND 22989 22990 """ 22991 Payment provider is not enabled. 22992 22993 """ 22994 PAYMENT_PROVIDER_IS_NOT_ENABLED 22995 22996 """ 22997 Payment method is invalid. Please update or create a new payment method. 22998 22999 """ 23000 INVALID_PAYMENT_METHOD 23001 23002 """ 23003 There was an unexpected error during the billing attempt. 23004 23005 """ 23006 UNEXPECTED_ERROR 23007 23008 """ 23009 Payment method is expired. 23010 23011 """ 23012 EXPIRED_PAYMENT_METHOD 23013 23014 """ 23015 Payment method was declined by processor. 23016 23017 """ 23018 PAYMENT_METHOD_DECLINED 23019 23020 """ 23021 There was an error during the authentication. 23022 23023 """ 23024 AUTHENTICATION_ERROR 23025 23026 """ 23027 Gateway is in test mode and attempted to bill a live payment method. 23028 23029 """ 23030 TEST_MODE 23031 } 23032 23033 """ 23034 Specifies the fields required to complete a subscription billing attempt. 23035 """ 23036 input SubscriptionBillingAttemptInput { 23037 """A unique key generated by the client to avoid duplicate payments.""" 23038 idempotencyKey: String! 23039 } 23040 23041 """Represents a Subscription Billing Policy.""" 23042 type SubscriptionBillingPolicy { 23043 """ 23044 Specific anchor dates upon which the billing interval calculations should be made. 23045 """ 23046 anchors: [SellingPlanAnchor!]! 23047 23048 """ 23049 The kind of interval that is associated with this schedule (e.g. Monthly, Weekly, etc). 23050 """ 23051 interval: SellingPlanInterval! 23052 23053 """The number of billing intervals between invoices.""" 23054 intervalCount: Int! 23055 23056 """Maximum amount of cycles after which the subscription ends.""" 23057 maxCycles: Int 23058 23059 """Minimum amount of cycles required in the subscription.""" 23060 minCycles: Int 23061 } 23062 23063 """Specifies the input fields for a Subscription Billing Policy.""" 23064 input SubscriptionBillingPolicyInput { 23065 """ 23066 The kind of interval that is associated with this schedule (e.g. Monthly, Weekly, etc). 23067 """ 23068 interval: SellingPlanInterval! 23069 23070 """The number of billing intervals between invoices.""" 23071 intervalCount: Int! 23072 23073 """Minimum amount of cycles required in the subscription.""" 23074 minCycles: Int 23075 23076 """Maximum amount of cycles required in the subscription.""" 23077 maxCycles: Int 23078 23079 """ 23080 Specific anchor dates upon which the billing interval calculations should be made. 23081 """ 23082 anchors: [SellingPlanAnchorInput!] = [] 23083 } 23084 23085 """Represents a Subscription Contract.""" 23086 type SubscriptionContract implements Node { 23087 """The subscription app that this subscription contract is registered to.""" 23088 app: App 23089 23090 """URL of the subscription contract page on the subscription app.""" 23091 appAdminUrl: URL 23092 23093 """ 23094 The list of billing attempts associated with the subscription contract. 23095 """ 23096 billingAttempts( 23097 """Returns up to the first `n` elements from the list.""" 23098 first: Int 23099 23100 """Returns the elements that come after the specified cursor.""" 23101 after: String 23102 23103 """Returns up to the last `n` elements from the list.""" 23104 last: Int 23105 23106 """Returns the elements that come before the specified cursor.""" 23107 before: String 23108 23109 """Reverse the order of the underlying list.""" 23110 reverse: Boolean = false 23111 ): SubscriptionBillingAttemptConnection! 23112 23113 """The billing policy associated with the subscription contract.""" 23114 billingPolicy: SubscriptionBillingPolicy! 23115 23116 """The date and time when the subscription contract was created.""" 23117 createdAt: DateTime! 23118 23119 """The currency used for the subscription contract.""" 23120 currencyCode: CurrencyCode! 23121 23122 """The customer to whom the subscription contract belongs.""" 23123 customer: Customer 23124 23125 """The customer payment method used for the subscription contract.""" 23126 customerPaymentMethod( 23127 """Whether to show the customer's revoked payment method.""" 23128 showRevoked: Boolean = false 23129 ): CustomerPaymentMethod 23130 23131 """The delivery method for each billing of the subscription contract.""" 23132 deliveryMethod: SubscriptionDeliveryMethod 23133 23134 """The delivery policy associated with the subscription contract.""" 23135 deliveryPolicy: SubscriptionDeliveryPolicy! 23136 23137 """The delivery price for each billing of the subscription contract.""" 23138 deliveryPrice: MoneyV2! 23139 23140 """ 23141 The list of subscription discounts associated with the subscription contract. 23142 """ 23143 discounts( 23144 """Returns up to the first `n` elements from the list.""" 23145 first: Int 23146 23147 """Returns the elements that come after the specified cursor.""" 23148 after: String 23149 23150 """Returns up to the last `n` elements from the list.""" 23151 last: Int 23152 23153 """Returns the elements that come before the specified cursor.""" 23154 before: String 23155 23156 """Reverse the order of the underlying list.""" 23157 reverse: Boolean = false 23158 ): SubscriptionManualDiscountConnection! 23159 23160 """Globally unique identifier.""" 23161 id: ID! 23162 23163 """The current status of the last payment.""" 23164 lastPaymentStatus: SubscriptionContractLastPaymentStatus 23165 23166 """The number of lines associated with the subscription contract.""" 23167 lineCount: Int! 23168 23169 """ 23170 The list of subscription lines associated with the subscription contract. 23171 """ 23172 lines( 23173 """Returns up to the first `n` elements from the list.""" 23174 first: Int 23175 23176 """Returns the elements that come after the specified cursor.""" 23177 after: String 23178 23179 """Returns up to the last `n` elements from the list.""" 23180 last: Int 23181 23182 """Returns the elements that come before the specified cursor.""" 23183 before: String 23184 23185 """Reverse the order of the underlying list.""" 23186 reverse: Boolean = false 23187 ): SubscriptionLineConnection! 23188 23189 """The next billing date for the subscription contract.""" 23190 nextBillingDate: DateTime 23191 23192 """The list of orders associated with the subscription contract.""" 23193 orders( 23194 """Returns up to the first `n` elements from the list.""" 23195 first: Int 23196 23197 """Returns the elements that come after the specified cursor.""" 23198 after: String 23199 23200 """Returns up to the last `n` elements from the list.""" 23201 last: Int 23202 23203 """Returns the elements that come before the specified cursor.""" 23204 before: String 23205 23206 """Reverse the order of the underlying list.""" 23207 reverse: Boolean = false 23208 ): OrderConnection! 23209 23210 """The order from which this contract originated.""" 23211 originOrder: Order 23212 23213 """The current status of the subscription contract.""" 23214 status: SubscriptionContractSubscriptionStatus! 23215 23216 """The date and time when the subscription contract was updated.""" 23217 updatedAt: DateTime! 23218 } 23219 23220 """ 23221 An auto-generated type for paginating through multiple SubscriptionContracts. 23222 23223 """ 23224 type SubscriptionContractConnection { 23225 """A list of edges.""" 23226 edges: [SubscriptionContractEdge!]! 23227 23228 """Information to aid in pagination.""" 23229 pageInfo: PageInfo! 23230 } 23231 23232 """Specifies the input fields required to create a Subscription Contract.""" 23233 input SubscriptionContractCreateInput { 23234 """The ID of the customer to associate with the subscription contract.""" 23235 customerId: ID! 23236 23237 """The next billing date for the subscription contract.""" 23238 nextBillingDate: DateTime! 23239 23240 """The currency used for the subscription contract.""" 23241 currencyCode: CurrencyCode! 23242 23243 """The attributes used as input for the Subscription Draft.""" 23244 contract: SubscriptionDraftInput! 23245 } 23246 23247 """Return type for `subscriptionContractCreate` mutation.""" 23248 type SubscriptionContractCreatePayload { 23249 """The Subscription Contract object.""" 23250 draft: SubscriptionDraft 23251 23252 """List of errors that occurred executing the mutation.""" 23253 userErrors: [SubscriptionDraftUserError!]! 23254 } 23255 23256 """ 23257 An auto-generated type which holds one SubscriptionContract and a cursor during pagination. 23258 23259 """ 23260 type SubscriptionContractEdge { 23261 """A cursor for use in pagination.""" 23262 cursor: String! 23263 23264 """The item at the end of SubscriptionContractEdge.""" 23265 node: SubscriptionContract! 23266 } 23267 23268 """ 23269 Possible error codes that could be returned by SubscriptionContractUserError. 23270 """ 23271 enum SubscriptionContractErrorCode { 23272 """Input value is invalid.""" 23273 INVALID 23274 } 23275 23276 """Possible status values of the last payment on a subscription contract.""" 23277 enum SubscriptionContractLastPaymentStatus { 23278 """Successful subscription billing attempt.""" 23279 SUCCEEDED 23280 23281 """Failed subscription billing attempt.""" 23282 FAILED 23283 } 23284 23285 """Return type for `subscriptionContractSetNextBillingDate` mutation.""" 23286 type SubscriptionContractSetNextBillingDatePayload { 23287 """The updated Subscription Contract object.""" 23288 contract: SubscriptionContract 23289 23290 """List of errors that occurred executing the mutation.""" 23291 userErrors: [SubscriptionContractUserError!]! 23292 } 23293 23294 """Possible status values of a subscription.""" 23295 enum SubscriptionContractSubscriptionStatus { 23296 """Active subscription contract.""" 23297 ACTIVE 23298 23299 """Paused subscription contract.""" 23300 PAUSED 23301 23302 """Cancelled subscription contract.""" 23303 CANCELLED 23304 23305 """Expired subscription contract.""" 23306 EXPIRED 23307 23308 """Failed subscription contract.""" 23309 FAILED 23310 } 23311 23312 """Return type for `subscriptionContractUpdate` mutation.""" 23313 type SubscriptionContractUpdatePayload { 23314 """The Subscription Contract object.""" 23315 draft: SubscriptionDraft 23316 23317 """List of errors that occurred executing the mutation.""" 23318 userErrors: [SubscriptionDraftUserError!]! 23319 } 23320 23321 """Represents a Subscription Contract error.""" 23322 type SubscriptionContractUserError implements DisplayableError { 23323 """Error code to uniquely identify the error.""" 23324 code: SubscriptionContractErrorCode 23325 23326 """Path to the input field which caused the error.""" 23327 field: [String!] 23328 23329 """The error message.""" 23330 message: String! 23331 } 23332 23333 """Represents a Subscription Line Pricing Cycle Adjustment.""" 23334 type SubscriptionCyclePriceAdjustment { 23335 """Price adjustment type.""" 23336 adjustmentType: SellingPlanPricingPolicyAdjustmentType! 23337 23338 """Price adjustment value.""" 23339 adjustmentValue: SellingPlanPricingPolicyAdjustmentValue! 23340 23341 """The number of cycles required before this pricing policy applies.""" 23342 afterCycle: Int! 23343 23344 """The computed price after the adjustments applied.""" 23345 computedPrice: MoneyV2! 23346 } 23347 23348 """ 23349 Describes the delivery method to use to get the physical goods to the customer. 23350 """ 23351 union SubscriptionDeliveryMethod = SubscriptionDeliveryMethodShipping 23352 23353 """ 23354 Specifies delivery method fields for a subscription draft. 23355 This is an input union: one, and only one, field can be provided. 23356 The field provided will determine which delivery method is to be used. 23357 23358 Note: Only `shipping` is supported for now, but other inputs will be 23359 added as they become supported in subscriptions. 23360 23361 """ 23362 input SubscriptionDeliveryMethodInput { 23363 """Shipping delivery method input.""" 23364 shipping: SubscriptionDeliveryMethodShippingInput 23365 } 23366 23367 """ 23368 Represents a shipping delivery method: a mailing address and a shipping option. 23369 """ 23370 type SubscriptionDeliveryMethodShipping { 23371 """The address to ship to.""" 23372 address: SubscriptionMailingAddress! 23373 23374 """The details of the shipping method to use.""" 23375 shippingOption: SubscriptionDeliveryMethodShippingOption! 23376 } 23377 23378 """ 23379 Specifies shipping delivery method fields. 23380 23381 This input accepts partial input. When a field is not provided, 23382 its prior value is left unchanged. 23383 23384 """ 23385 input SubscriptionDeliveryMethodShippingInput { 23386 """The address to ship to.""" 23387 address: MailingAddressInput 23388 23389 """The details of the shipping method to use.""" 23390 shippingOption: SubscriptionDeliveryMethodShippingOptionInput 23391 } 23392 23393 """Represents the selected shipping option on a subscription contract.""" 23394 type SubscriptionDeliveryMethodShippingOption { 23395 """The carrier service of the shipping option.""" 23396 carrierService: DeliveryCarrierService 23397 23398 """The code of the shipping option.""" 23399 code: String 23400 23401 """The description of the shipping option.""" 23402 description: String 23403 23404 """The presentment title of the shipping option.""" 23405 presentmentTitle: String 23406 23407 """The title of the shipping option.""" 23408 title: String 23409 } 23410 23411 """Specifies shipping option fields.""" 23412 input SubscriptionDeliveryMethodShippingOptionInput { 23413 """The title of the shipping option.""" 23414 title: String 23415 23416 """The presentment title of the shipping option.""" 23417 presentmentTitle: String 23418 23419 """The description of the shipping option.""" 23420 description: String 23421 23422 """The code of the shipping option.""" 23423 code: String 23424 23425 """The carrier service ID of the shipping option.""" 23426 carrierServiceId: ID 23427 } 23428 23429 """Represents a Subscription Delivery Policy.""" 23430 type SubscriptionDeliveryPolicy { 23431 """ 23432 Specific anchor dates upon which the delivery interval calculations should be made. 23433 """ 23434 anchors: [SellingPlanAnchor!]! 23435 23436 """ 23437 The kind of interval that is associated with this schedule (e.g. Monthly, Weekly, etc). 23438 """ 23439 interval: SellingPlanInterval! 23440 23441 """The number of delivery intervals between deliveries.""" 23442 intervalCount: Int! 23443 } 23444 23445 """Specifies the input fields for a Subscription Delivery Policy.""" 23446 input SubscriptionDeliveryPolicyInput { 23447 """ 23448 The kind of interval that is associated with this schedule (e.g. Monthly, Weekly, etc). 23449 """ 23450 interval: SellingPlanInterval! 23451 23452 """The number of billing intervals between invoices.""" 23453 intervalCount: Int! 23454 23455 """ 23456 Specific anchor dates upon which the delivery interval calculations should be made. 23457 """ 23458 anchors: [SellingPlanAnchorInput!] = [] 23459 } 23460 23461 """Subscription draft discount types.""" 23462 union SubscriptionDiscount = SubscriptionAppliedCodeDiscount | SubscriptionManualDiscount 23463 23464 """Represents what a particular discount reduces from a line price.""" 23465 type SubscriptionDiscountAllocation { 23466 """Allocation amount.""" 23467 amount: MoneyV2! 23468 23469 """Discount that created the allocation.""" 23470 discount: SubscriptionDiscount! 23471 } 23472 23473 """ 23474 An auto-generated type for paginating through multiple SubscriptionDiscounts. 23475 23476 """ 23477 type SubscriptionDiscountConnection { 23478 """A list of edges.""" 23479 edges: [SubscriptionDiscountEdge!]! 23480 23481 """Information to aid in pagination.""" 23482 pageInfo: PageInfo! 23483 } 23484 23485 """ 23486 An auto-generated type which holds one SubscriptionDiscount and a cursor during pagination. 23487 23488 """ 23489 type SubscriptionDiscountEdge { 23490 """A cursor for use in pagination.""" 23491 cursor: String! 23492 23493 """The item at the end of SubscriptionDiscountEdge.""" 23494 node: SubscriptionDiscount! 23495 } 23496 23497 """Represents the subscription lines the discount applies on.""" 23498 type SubscriptionDiscountEntitledLines { 23499 """ 23500 Specify whether the subscription discount will apply on all subscription lines. 23501 """ 23502 all: Boolean! 23503 23504 """ 23505 The list of subscription lines associated with the subscription discount. 23506 """ 23507 lines( 23508 """Returns up to the first `n` elements from the list.""" 23509 first: Int 23510 23511 """Returns the elements that come after the specified cursor.""" 23512 after: String 23513 23514 """Returns up to the last `n` elements from the list.""" 23515 last: Int 23516 23517 """Returns the elements that come before the specified cursor.""" 23518 before: String 23519 23520 """Reverse the order of the underlying list.""" 23521 reverse: Boolean = false 23522 ): SubscriptionLineConnection! 23523 } 23524 23525 """The value of the discount and how it will be applied.""" 23526 type SubscriptionDiscountFixedAmountValue { 23527 """The fixed amount value of the discount.""" 23528 amount: MoneyV2! 23529 23530 """Whether the amount is applied per item.""" 23531 appliesOnEachItem: Boolean! 23532 } 23533 23534 """The percentage value of the discount.""" 23535 type SubscriptionDiscountPercentageValue { 23536 """The percentage value of the discount.""" 23537 percentage: Int! 23538 } 23539 23540 """The reason a discount on a subscription draft was rejected.""" 23541 enum SubscriptionDiscountRejectionReason { 23542 """Discount code is not found.""" 23543 NOT_FOUND 23544 23545 """Discount does not apply to any of the given line items.""" 23546 NO_ENTITLED_LINE_ITEMS 23547 23548 """Quantity of items does not qualify for the discount.""" 23549 QUANTITY_NOT_IN_RANGE 23550 23551 """Purchase amount of items does not qualify for the discount.""" 23552 PURCHASE_NOT_IN_RANGE 23553 23554 """Given customer does not qualify for the discount.""" 23555 CUSTOMER_NOT_ELIGIBLE 23556 23557 """Discount usage limit has been reached.""" 23558 USAGE_LIMIT_REACHED 23559 23560 """Customer usage limit has been reached.""" 23561 CUSTOMER_USAGE_LIMIT_REACHED 23562 23563 """Discount is inactive.""" 23564 CURRENTLY_INACTIVE 23565 23566 """No applicable shipping lines.""" 23567 NO_ENTITLED_SHIPPING_LINES 23568 23569 """Purchase type does not qualify for the discount.""" 23570 INCOMPATIBLE_PURCHASE_TYPE 23571 23572 """Internal error during discount code validation.""" 23573 INTERNAL_ERROR 23574 } 23575 23576 """The value of the discount and how it will be applied.""" 23577 union SubscriptionDiscountValue = SubscriptionDiscountFixedAmountValue | SubscriptionDiscountPercentageValue 23578 23579 """Represents a Subscription Draft.""" 23580 type SubscriptionDraft implements Node { 23581 """The billing policy for the subscription contract.""" 23582 billingPolicy: SubscriptionBillingPolicy! 23583 23584 """The currency used for the subscription contract.""" 23585 currencyCode: CurrencyCode! 23586 23587 """The customer to whom the subscription contract belongs.""" 23588 customer: Customer! 23589 23590 """The customer payment method used for the subscription contract.""" 23591 customerPaymentMethod( 23592 """Whether to show the customer's revoked payment method.""" 23593 showRevoked: Boolean = false 23594 ): CustomerPaymentMethod 23595 23596 """The delivery method for each billing of the subscription contract.""" 23597 deliveryMethod: SubscriptionDeliveryMethod 23598 23599 """The delivery policy for the subscription contract.""" 23600 deliveryPolicy: SubscriptionDeliveryPolicy! 23601 23602 """The delivery price for each billing the subscription contract.""" 23603 deliveryPrice: MoneyV2 23604 23605 """ 23606 The list of subscription discounts which will be associated with the subscription contract. 23607 """ 23608 discounts( 23609 """Returns up to the first `n` elements from the list.""" 23610 first: Int 23611 23612 """Returns the elements that come after the specified cursor.""" 23613 after: String 23614 23615 """Returns up to the last `n` elements from the list.""" 23616 last: Int 23617 23618 """Returns the elements that come before the specified cursor.""" 23619 before: String 23620 23621 """Reverse the order of the underlying list.""" 23622 reverse: Boolean = false 23623 ): SubscriptionDiscountConnection! 23624 23625 """ 23626 The list of subscription discounts to be added to the subscription contract. 23627 """ 23628 discountsAdded( 23629 """Returns up to the first `n` elements from the list.""" 23630 first: Int 23631 23632 """Returns the elements that come after the specified cursor.""" 23633 after: String 23634 23635 """Returns up to the last `n` elements from the list.""" 23636 last: Int 23637 23638 """Returns the elements that come before the specified cursor.""" 23639 before: String 23640 23641 """Reverse the order of the underlying list.""" 23642 reverse: Boolean = false 23643 ): SubscriptionDiscountConnection! 23644 23645 """ 23646 The list of subscription discounts to be removed from the subscription contract. 23647 """ 23648 discountsRemoved( 23649 """Returns up to the first `n` elements from the list.""" 23650 first: Int 23651 23652 """Returns the elements that come after the specified cursor.""" 23653 after: String 23654 23655 """Returns up to the last `n` elements from the list.""" 23656 last: Int 23657 23658 """Returns the elements that come before the specified cursor.""" 23659 before: String 23660 23661 """Reverse the order of the underlying list.""" 23662 reverse: Boolean = false 23663 ): SubscriptionDiscountConnection! 23664 23665 """ 23666 The list of subscription discounts to be updated on the subscription contract. 23667 """ 23668 discountsUpdated( 23669 """Returns up to the first `n` elements from the list.""" 23670 first: Int 23671 23672 """Returns the elements that come after the specified cursor.""" 23673 after: String 23674 23675 """Returns up to the last `n` elements from the list.""" 23676 last: Int 23677 23678 """Returns the elements that come before the specified cursor.""" 23679 before: String 23680 23681 """Reverse the order of the underlying list.""" 23682 reverse: Boolean = false 23683 ): SubscriptionDiscountConnection! 23684 23685 """Globally unique identifier.""" 23686 id: ID! 23687 23688 """ 23689 The list of subscription lines which will be associated with the subscription contract. 23690 """ 23691 lines( 23692 """Returns up to the first `n` elements from the list.""" 23693 first: Int 23694 23695 """Returns the elements that come after the specified cursor.""" 23696 after: String 23697 23698 """Returns up to the last `n` elements from the list.""" 23699 last: Int 23700 23701 """Returns the elements that come before the specified cursor.""" 23702 before: String 23703 23704 """Reverse the order of the underlying list.""" 23705 reverse: Boolean = false 23706 ): SubscriptionLineConnection! 23707 23708 """ 23709 The list of subscription lines to be added to the subscription contract. 23710 """ 23711 linesAdded( 23712 """Returns up to the first `n` elements from the list.""" 23713 first: Int 23714 23715 """Returns the elements that come after the specified cursor.""" 23716 after: String 23717 23718 """Returns up to the last `n` elements from the list.""" 23719 last: Int 23720 23721 """Returns the elements that come before the specified cursor.""" 23722 before: String 23723 23724 """Reverse the order of the underlying list.""" 23725 reverse: Boolean = false 23726 ): SubscriptionLineConnection! 23727 23728 """ 23729 The list of subscription lines to be removed from the subscription contract. 23730 """ 23731 linesRemoved( 23732 """Returns up to the first `n` elements from the list.""" 23733 first: Int 23734 23735 """Returns the elements that come after the specified cursor.""" 23736 after: String 23737 23738 """Returns up to the last `n` elements from the list.""" 23739 last: Int 23740 23741 """Returns the elements that come before the specified cursor.""" 23742 before: String 23743 23744 """Reverse the order of the underlying list.""" 23745 reverse: Boolean = false 23746 ): SubscriptionLineConnection! 23747 23748 """The next billing date for the subscription contract.""" 23749 nextBillingDate: DateTime 23750 23751 """The original subscription contract.""" 23752 originalContract: SubscriptionContract 23753 23754 """ 23755 Available Shipping Options for a given delivery address. Returns NULL for pending requests. 23756 23757 """ 23758 shippingOptions( 23759 """The address to delivery the subscription contract to.""" 23760 deliveryAddress: MailingAddressInput 23761 ): SubscriptionShippingOptionResult 23762 23763 """The current status of the subscription contract.""" 23764 status: SubscriptionContractSubscriptionStatus 23765 } 23766 23767 """Return type for `subscriptionDraftCommit` mutation.""" 23768 type SubscriptionDraftCommitPayload { 23769 """The updated Subscription Contract object.""" 23770 contract: SubscriptionContract 23771 23772 """List of errors that occurred executing the mutation.""" 23773 userErrors: [SubscriptionDraftUserError!]! 23774 } 23775 23776 """Return type for `subscriptionDraftDiscountAdd` mutation.""" 23777 type SubscriptionDraftDiscountAddPayload { 23778 """The added Subscription Discount.""" 23779 discountAdded: SubscriptionManualDiscount 23780 23781 """The Subscription Contract draft object.""" 23782 draft: SubscriptionDraft 23783 23784 """List of errors that occurred executing the mutation.""" 23785 userErrors: [SubscriptionDraftUserError!]! 23786 } 23787 23788 """Return type for `subscriptionDraftDiscountCodeApply` mutation.""" 23789 type SubscriptionDraftDiscountCodeApplyPayload { 23790 """The added subscription discount.""" 23791 appliedDiscount: SubscriptionAppliedCodeDiscount 23792 23793 """The subscription contract draft object.""" 23794 draft: SubscriptionDraft 23795 23796 """List of errors that occurred executing the mutation.""" 23797 userErrors: [SubscriptionDraftUserError!]! 23798 } 23799 23800 """Return type for `subscriptionDraftDiscountRemove` mutation.""" 23801 type SubscriptionDraftDiscountRemovePayload { 23802 """The removed subscription draft discount.""" 23803 discountRemoved: SubscriptionDiscount 23804 23805 """The subscription contract draft object.""" 23806 draft: SubscriptionDraft 23807 23808 """List of errors that occurred executing the mutation.""" 23809 userErrors: [SubscriptionDraftUserError!]! 23810 } 23811 23812 """Return type for `subscriptionDraftDiscountUpdate` mutation.""" 23813 type SubscriptionDraftDiscountUpdatePayload { 23814 """The updated Subscription Discount.""" 23815 discountUpdated: SubscriptionManualDiscount 23816 23817 """The Subscription Contract draft object.""" 23818 draft: SubscriptionDraft 23819 23820 """List of errors that occurred executing the mutation.""" 23821 userErrors: [SubscriptionDraftUserError!]! 23822 } 23823 23824 """ 23825 Possible error codes that could be returned by SubscriptionDraftUserError. 23826 """ 23827 enum SubscriptionDraftErrorCode { 23828 """This line has already been removed.""" 23829 ALREADY_REMOVED 23830 23831 """Input value is not present.""" 23832 PRESENCE 23833 23834 """Subscription draft has been already committed.""" 23835 COMMITTED 23836 23837 """Value is not in range.""" 23838 NOT_IN_RANGE 23839 23840 """The value is not an integer.""" 23841 NOT_AN_INTEGER 23842 23843 """The maximum number of cycles must be greater than the minimum.""" 23844 SELLING_PLAN_MAX_CYCLES_MUST_BE_GREATER_THAN_MIN_CYCLES 23845 23846 """ 23847 The delivery policy interval must be a multiple of the billing policy interval. 23848 """ 23849 DELIVERY_MUST_BE_MULTIPLE_OF_BILLING 23850 23851 """Next billing date is invalid.""" 23852 INVALID_BILLING_DATE 23853 23854 """Must have at least one line.""" 23855 INVALID_LINES 23856 23857 """Discount must have at least one entitled line.""" 23858 NO_ENTITLED_LINES 23859 23860 """The customer doesn't exist.""" 23861 CUSTOMER_DOES_NOT_EXIST 23862 23863 """The payment method customer must be the same as the contract customer.""" 23864 CUSTOMER_MISMATCH 23865 23866 """The delivery method can't be blank if any lines require shipping.""" 23867 DELIVERY_METHOD_REQUIRED 23868 23869 """The after cycle attribute must be unique between cycle discounts.""" 23870 CYCLE_DISCOUNTS_UNIQUE_AFTER_CYCLE 23871 23872 """The adjustment value must the same type as the adjustment type.""" 23873 INVALID_ADJUSTMENT_TYPE 23874 23875 """The adjustment value must be either fixed_value or percentage.""" 23876 INVALID_ADJUSTMENT_VALUE 23877 23878 """ 23879 Another operation updated the contract concurrently as the commit was in progress. 23880 """ 23881 STALE_CONTRACT 23882 23883 """Currency is not enabled.""" 23884 CURRENCY_NOT_ENABLED 23885 23886 """Input value is invalid.""" 23887 INVALID 23888 23889 """Input value is blank.""" 23890 BLANK 23891 23892 """Input value should be greater than minimum allowed value.""" 23893 GREATER_THAN 23894 23895 """Input value should be greater than or equal to minimum allowed value.""" 23896 GREATER_THAN_OR_EQUAL_TO 23897 23898 """Input value should be less than maximum allowed value.""" 23899 LESS_THAN 23900 23901 """Input value should be less or equal to maximum allowed value.""" 23902 LESS_THAN_OR_EQUAL_TO 23903 23904 """Input value is too long.""" 23905 TOO_LONG 23906 23907 """Input value is too short.""" 23908 TOO_SHORT 23909 } 23910 23911 """Return type for `subscriptionDraftFreeShippingDiscountAdd` mutation.""" 23912 type SubscriptionDraftFreeShippingDiscountAddPayload { 23913 """The added subscription free shipping discount.""" 23914 discountAdded: SubscriptionManualDiscount 23915 23916 """The subscription contract draft object.""" 23917 draft: SubscriptionDraft 23918 23919 """List of errors that occurred executing the mutation.""" 23920 userErrors: [SubscriptionDraftUserError!]! 23921 } 23922 23923 """ 23924 Return type for `subscriptionDraftFreeShippingDiscountUpdate` mutation. 23925 """ 23926 type SubscriptionDraftFreeShippingDiscountUpdatePayload { 23927 """The updated Subscription Discount.""" 23928 discountUpdated: SubscriptionManualDiscount 23929 23930 """The Subscription Contract draft object.""" 23931 draft: SubscriptionDraft 23932 23933 """List of errors that occurred executing the mutation.""" 23934 userErrors: [SubscriptionDraftUserError!]! 23935 } 23936 23937 """Specifies the input fields required to create a Subscription Draft.""" 23938 input SubscriptionDraftInput { 23939 """The current status of the subscription contract.""" 23940 status: SubscriptionContractSubscriptionStatus 23941 23942 """The ID of the payment method to be used for the subscription contract.""" 23943 paymentMethodId: ID 23944 23945 """The next billing date for the subscription contract.""" 23946 nextBillingDate: DateTime 23947 23948 """The billing policy for the subscription contract.""" 23949 billingPolicy: SubscriptionBillingPolicyInput 23950 23951 """The delivery policy for the subscription contract.""" 23952 deliveryPolicy: SubscriptionDeliveryPolicyInput 23953 23954 """The shipping price for each renewal the subscription contract.""" 23955 deliveryPrice: Decimal 23956 23957 """The delivery method for the subscription contract.""" 23958 deliveryMethod: SubscriptionDeliveryMethodInput 23959 } 23960 23961 """Return type for `subscriptionDraftLineAdd` mutation.""" 23962 type SubscriptionDraftLineAddPayload { 23963 """The Subscription Contract draft object.""" 23964 draft: SubscriptionDraft 23965 23966 """The added Subscription Line.""" 23967 lineAdded: SubscriptionLine 23968 23969 """List of errors that occurred executing the mutation.""" 23970 userErrors: [SubscriptionDraftUserError!]! 23971 } 23972 23973 """Return type for `subscriptionDraftLineRemove` mutation.""" 23974 type SubscriptionDraftLineRemovePayload { 23975 """ 23976 The list of updated subscription discounts impacted by the removed line. 23977 """ 23978 discountsUpdated: [SubscriptionManualDiscount!] 23979 23980 """The Subscription Contract draft object.""" 23981 draft: SubscriptionDraft 23982 23983 """The removed Subscription Line.""" 23984 lineRemoved: SubscriptionLine 23985 23986 """List of errors that occurred executing the mutation.""" 23987 userErrors: [SubscriptionDraftUserError!]! 23988 } 23989 23990 """Return type for `subscriptionDraftLineUpdate` mutation.""" 23991 type SubscriptionDraftLineUpdatePayload { 23992 """The Subscription Contract draft object.""" 23993 draft: SubscriptionDraft 23994 23995 """The updated Subscription Line.""" 23996 lineUpdated: SubscriptionLine 23997 23998 """List of errors that occurred executing the mutation.""" 23999 userErrors: [SubscriptionDraftUserError!]! 24000 } 24001 24002 """Return type for `subscriptionDraftUpdate` mutation.""" 24003 type SubscriptionDraftUpdatePayload { 24004 """The Subscription Draft object.""" 24005 draft: SubscriptionDraft 24006 24007 """List of errors that occurred executing the mutation.""" 24008 userErrors: [SubscriptionDraftUserError!]! 24009 } 24010 24011 """Represents a Subscription Draft error.""" 24012 type SubscriptionDraftUserError implements DisplayableError { 24013 """Error code to uniquely identify the error.""" 24014 code: SubscriptionDraftErrorCode 24015 24016 """Path to the input field which caused the error.""" 24017 field: [String!] 24018 24019 """The error message.""" 24020 message: String! 24021 } 24022 24023 """ 24024 Specifies the input fields of a subscription free shipping discount on a contract. 24025 """ 24026 input SubscriptionFreeShippingDiscountInput { 24027 """The title associated with the subscription free shipping discount.""" 24028 title: String 24029 24030 """ 24031 The maximum number of times the subscription free shipping discount will be applied on orders. 24032 """ 24033 recurringCycleLimit: Int 24034 } 24035 24036 """Represents a Subscription Line.""" 24037 type SubscriptionLine { 24038 """ 24039 The price per unit for the subscription line in the contract's currency. 24040 """ 24041 currentPrice: MoneyV2! 24042 24043 """List of custom attributes associated to the line item.""" 24044 customAttributes: [Attribute!]! 24045 24046 """Discount allocations.""" 24047 discountAllocations: [SubscriptionDiscountAllocation!]! 24048 24049 """The unique identifier.""" 24050 id: ID! 24051 24052 """Total line price including all discounts.""" 24053 lineDiscountedPrice: MoneyV2! 24054 24055 """Describe the price changes of the line over time.""" 24056 pricingPolicy: SubscriptionPricingPolicy 24057 24058 """The product id associated with the subscription line.""" 24059 productId: ID 24060 24061 """The quantity of the unit selected for the subscription line.""" 24062 quantity: Int! 24063 24064 """Whether physical shipping is required for the variant.""" 24065 requiresShipping: Boolean! 24066 24067 """ 24068 The selling plan ID associated to the line. 24069 24070 Indicates which selling plan was used to create this 24071 contract line initially. The selling plan ID is also used to 24072 find the associated delivery profile. 24073 24074 The subscription contract, subscription line, or selling plan might have 24075 changed. As a result, the selling plan's attributes might not 24076 match the information on the contract. 24077 24078 """ 24079 sellingPlanId: ID 24080 24081 """ 24082 The selling plan name associated to the line. This name describes 24083 the order line items created from this subscription line 24084 for both merchants and customers. 24085 24086 The value can be different from the selling plan's name, because both 24087 the selling plan's name and the subscription line's selling_plan_name 24088 attribute can be updated independently. 24089 24090 """ 24091 sellingPlanName: String 24092 24093 """Variant SKU number of the item associated with the subscription line.""" 24094 sku: String 24095 24096 """Whether the variant is taxable.""" 24097 taxable: Boolean! 24098 24099 """Product title of the item associated with the subscription line.""" 24100 title: String! 24101 24102 """The product variant id associated with the subscription line.""" 24103 variantId: ID 24104 24105 """The image associated with the line item's variant or product.""" 24106 variantImage: Image 24107 24108 """ 24109 Product variant title of the item associated with the subscription line. 24110 """ 24111 variantTitle: String 24112 } 24113 24114 """ 24115 An auto-generated type for paginating through multiple SubscriptionLines. 24116 24117 """ 24118 type SubscriptionLineConnection { 24119 """A list of edges.""" 24120 edges: [SubscriptionLineEdge!]! 24121 24122 """Information to aid in pagination.""" 24123 pageInfo: PageInfo! 24124 } 24125 24126 """ 24127 An auto-generated type which holds one SubscriptionLine and a cursor during pagination. 24128 24129 """ 24130 type SubscriptionLineEdge { 24131 """A cursor for use in pagination.""" 24132 cursor: String! 24133 24134 """The item at the end of SubscriptionLineEdge.""" 24135 node: SubscriptionLine! 24136 } 24137 24138 """ 24139 Specifies the input fields required to add a new subscription line to a contract. 24140 """ 24141 input SubscriptionLineInput { 24142 """The ID of the product variant the subscription line refers to.""" 24143 productVariantId: ID! 24144 24145 """The quantity of the product.""" 24146 quantity: Int! 24147 24148 """The price of the product.""" 24149 currentPrice: Decimal! 24150 24151 """The custom attributes for this subscription line.""" 24152 customAttributes: [AttributeInput!] 24153 24154 """The selling plan for the subscription line.""" 24155 sellingPlanId: ID 24156 24157 """ 24158 The selling plan name for the subscription line. 24159 24160 Defaults to using the selling plan's current name when not specified. 24161 24162 """ 24163 sellingPlanName: String 24164 24165 """Describes expected price changes of the subscription line over time.""" 24166 pricingPolicy: SubscriptionPricingPolicyInput 24167 } 24168 24169 """ 24170 Specifies the input fields required to update a subscription line on a contract. 24171 """ 24172 input SubscriptionLineUpdateInput { 24173 """The ID of the product variant the subscription line refers to.""" 24174 productVariantId: ID 24175 24176 """The quantity of the product.""" 24177 quantity: Int 24178 24179 """The selling plan for the subscription line.""" 24180 sellingPlanId: ID 24181 24182 """The selling plan name for the subscription line.""" 24183 sellingPlanName: String 24184 24185 """The price of the product.""" 24186 currentPrice: Decimal 24187 24188 """The custom attributes for this subscription line.""" 24189 customAttributes: [AttributeInput!] 24190 24191 """Describes expected price changes of the subscription line over time.""" 24192 pricingPolicy: SubscriptionPricingPolicyInput 24193 } 24194 24195 """Represents a Mailing Address on a Subscription.""" 24196 type SubscriptionMailingAddress { 24197 """ 24198 The first line of the address. Typically the street address or PO Box number. 24199 """ 24200 address1: String 24201 24202 """ 24203 The second line of the address. Typically the number of the apartment, suite, or unit. 24204 """ 24205 address2: String 24206 24207 """The name of the city, district, village, or town.""" 24208 city: String 24209 24210 """The name of the customer's company or organization.""" 24211 company: String 24212 24213 """The name of the country.""" 24214 country: String 24215 24216 """ 24217 The two-letter code for the country of the address. 24218 24219 For example, US. 24220 24221 """ 24222 countryCode: CountryCode 24223 24224 """The first name of the customer.""" 24225 firstName: String 24226 24227 """The last name of the customer.""" 24228 lastName: String 24229 24230 """The full name of the customer, based on firstName and lastName.""" 24231 name: String 24232 24233 """ 24234 A unique phone number for the customer. Formatted using E.164 standard. For example, _+16135551111_. 24235 """ 24236 phone: String 24237 24238 """The region of the address, such as the province, state, or district.""" 24239 province: String 24240 24241 """ 24242 The two-letter code for the region. 24243 24244 For example, ON. 24245 24246 """ 24247 provinceCode: String 24248 24249 """The zip or postal code of the address.""" 24250 zip: String 24251 } 24252 24253 """Custom subscription discount.""" 24254 type SubscriptionManualDiscount { 24255 """Entitled line items used to apply the subscription discount on.""" 24256 entitledLines: SubscriptionDiscountEntitledLines! 24257 24258 """The unique identifier.""" 24259 id: ID! 24260 24261 """ 24262 The maximum number of times the subscription discount will be applied on orders. 24263 """ 24264 recurringCycleLimit: Int 24265 24266 """The reason that the discount on the subscription draft is rejected.""" 24267 rejectionReason: SubscriptionDiscountRejectionReason 24268 24269 """Type of line the discount applies on.""" 24270 targetType: DiscountTargetType! 24271 24272 """The title associated with the subscription discount.""" 24273 title: String 24274 24275 """The type of the subscription discount.""" 24276 type: DiscountType! 24277 24278 """The number of times the discount was applied.""" 24279 usageCount: Int! 24280 24281 """The value of the subscription discount.""" 24282 value: SubscriptionDiscountValue! 24283 } 24284 24285 """ 24286 An auto-generated type for paginating through multiple SubscriptionManualDiscounts. 24287 24288 """ 24289 type SubscriptionManualDiscountConnection { 24290 """A list of edges.""" 24291 edges: [SubscriptionManualDiscountEdge!]! 24292 24293 """Information to aid in pagination.""" 24294 pageInfo: PageInfo! 24295 } 24296 24297 """ 24298 An auto-generated type which holds one SubscriptionManualDiscount and a cursor during pagination. 24299 24300 """ 24301 type SubscriptionManualDiscountEdge { 24302 """A cursor for use in pagination.""" 24303 cursor: String! 24304 24305 """The item at the end of SubscriptionManualDiscountEdge.""" 24306 node: SubscriptionManualDiscount! 24307 } 24308 24309 """Represents the subscription lines the discount applies on.""" 24310 input SubscriptionManualDiscountEntitledLinesInput { 24311 """ 24312 Specify whether the subscription discount will apply on all subscription lines. 24313 """ 24314 all: Boolean 24315 24316 """ 24317 The ID of the lines to add to or remove from the subscription discount. 24318 """ 24319 lines: SubscriptionManualDiscountLinesInput 24320 } 24321 24322 """ 24323 Specifies the fixed amount value of the discount and distribution on the lines. 24324 """ 24325 input SubscriptionManualDiscountFixedAmountInput { 24326 """Fixed amount value.""" 24327 amount: Float 24328 24329 """Whether the amount is intended per line item or once per subscription.""" 24330 appliesOnEachItem: Boolean 24331 } 24332 24333 """Specifies the input fields of a subscription discount on a contract.""" 24334 input SubscriptionManualDiscountInput { 24335 """The title associated with the subscription discount.""" 24336 title: String 24337 24338 """Percentage or fixed amount value of the discount.""" 24339 value: SubscriptionManualDiscountValueInput 24340 24341 """ 24342 The maximum number of times the subscription discount will be applied on orders. 24343 """ 24344 recurringCycleLimit: Int 24345 24346 """Entitled line items used to apply the subscription discount on.""" 24347 entitledLines: SubscriptionManualDiscountEntitledLinesInput 24348 } 24349 24350 """Line items that a the discount refers to.""" 24351 input SubscriptionManualDiscountLinesInput { 24352 """The ID of the lines to add to the subscription discount.""" 24353 add: [ID!] 24354 24355 """The ID of the lines to remove from the subscription discount.""" 24356 remove: [ID!] 24357 } 24358 24359 """Specifies the discount value and its distribution.""" 24360 input SubscriptionManualDiscountValueInput { 24361 """The percentage value of the discount. Value must be between 0 - 100.""" 24362 percentage: Int 24363 24364 """Fixed amount input in the currency defined by the subscription.""" 24365 fixedAmount: SubscriptionManualDiscountFixedAmountInput 24366 } 24367 24368 """Represents a Subscription Line Pricing Policy.""" 24369 type SubscriptionPricingPolicy { 24370 """ 24371 The base price per unit for the subscription line in the contract's currency. 24372 """ 24373 basePrice: MoneyV2! 24374 24375 """The adjustments per cycle for the subscription line.""" 24376 cycleDiscounts: [SubscriptionCyclePriceAdjustment!]! 24377 } 24378 24379 """An array containing all pricing changes for each billing cycle.""" 24380 input SubscriptionPricingPolicyCycleDiscountsInput { 24381 """The cycle after which the pricing policy applies.""" 24382 afterCycle: Int! 24383 24384 """The price adjustment type.""" 24385 adjustmentType: SellingPlanPricingPolicyAdjustmentType! 24386 24387 """The price adjustment value.""" 24388 adjustmentValue: SellingPlanPricingPolicyValueInput! 24389 24390 """The computed price after the adjustments are applied.""" 24391 computedPrice: Decimal! 24392 } 24393 24394 """Describes expected price changes of the subscription line over time.""" 24395 input SubscriptionPricingPolicyInput { 24396 """ 24397 The base price per unit for the subscription line in the contract's currency. 24398 """ 24399 basePrice: Decimal! 24400 24401 """An array containing all pricing changes for each billing cycle.""" 24402 cycleDiscounts: [SubscriptionPricingPolicyCycleDiscountsInput!]! 24403 } 24404 24405 """A shipping option to deliver a subscription contract.""" 24406 type SubscriptionShippingOption { 24407 """ 24408 The carrier service that is providing this shipping option. 24409 This field isn't currently supported and returns null. 24410 24411 """ 24412 carrierService: DeliveryCarrierService 24413 24414 """The code of the shipping option.""" 24415 code: String! 24416 24417 """The description of the shipping option.""" 24418 description: String 24419 24420 """If a phone number is required for the shipping option.""" 24421 phoneRequired: Boolean 24422 24423 """The presentment title of the shipping option.""" 24424 presentmentTitle: String 24425 24426 """The price of the shipping option.""" 24427 price: MoneyV2 24428 24429 """The title of the shipping option.""" 24430 title: String! 24431 } 24432 24433 """ 24434 The result of the query to fetch shipping options for the subscription contract. 24435 """ 24436 union SubscriptionShippingOptionResult = SubscriptionShippingOptionResultFailure | SubscriptionShippingOptionResultSuccess 24437 24438 """ 24439 Failure determining available shipping options for delivery of a subscription contract. 24440 """ 24441 type SubscriptionShippingOptionResultFailure { 24442 """Failure reason.""" 24443 message: String 24444 } 24445 24446 """A shipping option for delivery of a subscription contract.""" 24447 type SubscriptionShippingOptionResultSuccess { 24448 """Available shipping options.""" 24449 shippingOptions: [SubscriptionShippingOption!]! 24450 } 24451 24452 """Represents a suggested transaction.""" 24453 type SuggestedOrderTransaction { 24454 """The masked account number associated with the payment method.""" 24455 accountNumber: String 24456 24457 """The amount of the transaction.""" 24458 amount: Money! @deprecated(reason: "Use `amountSet` instead") 24459 24460 """The amount on the order transaction in applicable currencies.""" 24461 amountSet: MoneyBag! 24462 24463 """ 24464 The human-readable payment gateway name used to process the transaction. 24465 """ 24466 formattedGateway: String 24467 24468 """The payment gateway used to process the transaction.""" 24469 gateway: String 24470 24471 """Specifies the kind of the suggested order transaction.""" 24472 kind: SuggestedOrderTransactionKind! 24473 24474 """ 24475 Specifies the available amount to refund on the gateway. Only available within SuggestedRefund. 24476 """ 24477 maximumRefundable: Money @deprecated(reason: "Use `maximumRefundableSet` instead") 24478 24479 """ 24480 Specifies the available amount to refund on the gateway in shop and presentment currencies. Only available within SuggestedRefund. 24481 """ 24482 maximumRefundableSet: MoneyBag 24483 24484 """ 24485 The associated parent transaction, for example the authorization of a capture. 24486 """ 24487 parentTransaction: OrderTransaction 24488 } 24489 24490 """Specifies the kind of the suggested order transaction.""" 24491 enum SuggestedOrderTransactionKind { 24492 """A suggested refund transaction for an order.""" 24493 SUGGESTED_REFUND 24494 } 24495 24496 """ 24497 Represents the suggested refund to be submitted based on the items being returned. 24498 """ 24499 type SuggestedRefund { 24500 """The total monetary value to be refunded.""" 24501 amount: Money! @deprecated(reason: "Use `amountSet` instead") 24502 24503 """ 24504 The total monetary value to be refunded in shop and presentment currencies. 24505 """ 24506 amountSet: MoneyBag! 24507 24508 """The sum of all the discounted prices of the line items being refunded.""" 24509 discountedSubtotalSet: MoneyBag! 24510 24511 """The total monetary value available to refund.""" 24512 maximumRefundable: Money! @deprecated(reason: "Use `maximumRefundableSet` instead") 24513 24514 """ 24515 The total monetary value available to refund in shop and presentment currencies. 24516 """ 24517 maximumRefundableSet: MoneyBag! 24518 24519 """An array of duties that will be refunded to the customer.""" 24520 refundDuties: [RefundDuty!]! 24521 24522 """An array of line items that will be returned to the customer.""" 24523 refundLineItems: [RefundLineItem!]! 24524 24525 """Refund details for shipping costs paid by customer.""" 24526 shipping: ShippingRefund! 24527 24528 """The sum of all the prices of the line items being refunded.""" 24529 subtotal: Money! @deprecated(reason: "Use `subtotalSet` instead") 24530 24531 """ 24532 The sum of all the prices of the line items being refunded in shop and presentment currencies. 24533 """ 24534 subtotalSet: MoneyBag! 24535 24536 """Array of SuggestedOrderTransaction items.""" 24537 suggestedTransactions: [SuggestedOrderTransaction!]! 24538 24539 """ 24540 The total cart discount amount that was applied to all line items in this refund. 24541 """ 24542 totalCartDiscountAmountSet: MoneyBag! 24543 24544 """ 24545 The sum of all the duties being refunded from the order in shop and presentment currencies. Must be positive. 24546 """ 24547 totalDutiesSet: MoneyBag! 24548 24549 """ 24550 The sum of all the taxes being refunded from the order (must be positive) in shop and presentment currencies. 24551 """ 24552 totalTaxSet: MoneyBag! 24553 24554 """ 24555 The sum of all the taxes being refunded from the order (must be positive). 24556 """ 24557 totalTaxes: Money! @deprecated(reason: "Use `totalTaxSet` instead") 24558 } 24559 24560 """Return type for `tagsAdd` mutation.""" 24561 type TagsAddPayload { 24562 """The object that was updated.""" 24563 node: Node 24564 24565 """List of errors that occurred executing the mutation.""" 24566 userErrors: [UserError!]! 24567 } 24568 24569 """Return type for `tagsRemove` mutation.""" 24570 type TagsRemovePayload { 24571 """The object that was updated.""" 24572 node: Node 24573 24574 """List of errors that occurred executing the mutation.""" 24575 userErrors: [UserError!]! 24576 } 24577 24578 """Available customer tax exemptions.""" 24579 enum TaxExemption { 24580 """ 24581 This customer is exempt from specific taxes for holding a valid STATUS_CARD_EXEMPTION in Canada. 24582 """ 24583 CA_STATUS_CARD_EXEMPTION 24584 24585 """ 24586 This customer is exempt from specific taxes for holding a valid RESELLER_EXEMPTION in British Columbia. 24587 """ 24588 CA_BC_RESELLER_EXEMPTION 24589 24590 """ 24591 This customer is exempt from specific taxes for holding a valid RESELLER_EXEMPTION in Manitoba. 24592 """ 24593 CA_MB_RESELLER_EXEMPTION 24594 24595 """ 24596 This customer is exempt from specific taxes for holding a valid RESELLER_EXEMPTION in Saskatchewan. 24597 """ 24598 CA_SK_RESELLER_EXEMPTION 24599 24600 """ 24601 This customer is exempt from specific taxes for holding a valid DIPLOMAT_EXEMPTION in Canada. 24602 """ 24603 CA_DIPLOMAT_EXEMPTION 24604 24605 """ 24606 This customer is exempt from specific taxes for holding a valid COMMERCIAL_FISHERY_EXEMPTION in British Columbia. 24607 """ 24608 CA_BC_COMMERCIAL_FISHERY_EXEMPTION 24609 24610 """ 24611 This customer is exempt from specific taxes for holding a valid COMMERCIAL_FISHERY_EXEMPTION in Manitoba. 24612 """ 24613 CA_MB_COMMERCIAL_FISHERY_EXEMPTION 24614 24615 """ 24616 This customer is exempt from specific taxes for holding a valid COMMERCIAL_FISHERY_EXEMPTION in Nova Scotia. 24617 """ 24618 CA_NS_COMMERCIAL_FISHERY_EXEMPTION 24619 24620 """ 24621 This customer is exempt from specific taxes for holding a valid COMMERCIAL_FISHERY_EXEMPTION in Prince Edward Island. 24622 """ 24623 CA_PE_COMMERCIAL_FISHERY_EXEMPTION 24624 24625 """ 24626 This customer is exempt from specific taxes for holding a valid COMMERCIAL_FISHERY_EXEMPTION in Saskatchewan. 24627 """ 24628 CA_SK_COMMERCIAL_FISHERY_EXEMPTION 24629 24630 """ 24631 This customer is exempt from specific taxes for holding a valid PRODUCTION_AND_MACHINERY_EXEMPTION in British Columbia. 24632 """ 24633 CA_BC_PRODUCTION_AND_MACHINERY_EXEMPTION 24634 24635 """ 24636 This customer is exempt from specific taxes for holding a valid PRODUCTION_AND_MACHINERY_EXEMPTION in Saskatchewan. 24637 """ 24638 CA_SK_PRODUCTION_AND_MACHINERY_EXEMPTION 24639 24640 """ 24641 This customer is exempt from specific taxes for holding a valid SUB_CONTRACTOR_EXEMPTION in British Columbia. 24642 """ 24643 CA_BC_SUB_CONTRACTOR_EXEMPTION 24644 24645 """ 24646 This customer is exempt from specific taxes for holding a valid SUB_CONTRACTOR_EXEMPTION in Saskatchewan. 24647 """ 24648 CA_SK_SUB_CONTRACTOR_EXEMPTION 24649 24650 """ 24651 This customer is exempt from specific taxes for holding a valid CONTRACTOR_EXEMPTION in British Columbia. 24652 """ 24653 CA_BC_CONTRACTOR_EXEMPTION 24654 24655 """ 24656 This customer is exempt from specific taxes for holding a valid CONTRACTOR_EXEMPTION in Saskatchewan. 24657 """ 24658 CA_SK_CONTRACTOR_EXEMPTION 24659 24660 """ 24661 This customer is exempt from specific taxes for holding a valid PURCHASE_EXEMPTION in Ontario. 24662 """ 24663 CA_ON_PURCHASE_EXEMPTION 24664 24665 """ 24666 This customer is exempt from specific taxes for holding a valid FARMER_EXEMPTION in Manitoba. 24667 """ 24668 CA_MB_FARMER_EXEMPTION 24669 24670 """ 24671 This customer is exempt from specific taxes for holding a valid FARMER_EXEMPTION in Nova Scotia. 24672 """ 24673 CA_NS_FARMER_EXEMPTION 24674 24675 """ 24676 This customer is exempt from specific taxes for holding a valid FARMER_EXEMPTION in Saskatchewan. 24677 """ 24678 CA_SK_FARMER_EXEMPTION 24679 } 24680 24681 """ 24682 Represents the information about the tax charged on the associated line item. 24683 """ 24684 type TaxLine { 24685 """The amount of tax to be charged.""" 24686 price: Money! @deprecated(reason: "Use `priceSet` instead") 24687 24688 """The amount of tax to be charged in shop and presentment currencies.""" 24689 priceSet: MoneyBag! 24690 24691 """The tax rate to be applied.""" 24692 rate: Float 24693 24694 """The percentage of the price that the tax rate represents.""" 24695 ratePercentage: Float 24696 24697 """The name of the tax.""" 24698 title: String! 24699 } 24700 24701 """ 24702 A tender transaction represents a transaction which modifies the shop's balance. 24703 """ 24704 type TenderTransaction implements Node { 24705 """The amount and currency of the tender transaction.""" 24706 amount: MoneyV2! 24707 24708 """Globally unique identifier.""" 24709 id: ID! 24710 24711 """Information about the payment method used for this transaction.""" 24712 paymentMethod: String 24713 24714 """Date and time when the transaction was processed.""" 24715 processedAt: DateTime 24716 24717 """The remote gateway reference associated with the tender transaction.""" 24718 remoteReference: String 24719 24720 """Whether the transaction is a test transaction.""" 24721 test: Boolean! 24722 24723 """Information about the payment instrument used for this transaction.""" 24724 transactionDetails: TenderTransactionDetails 24725 } 24726 24727 """ 24728 An auto-generated type for paginating through multiple TenderTransactions. 24729 24730 """ 24731 type TenderTransactionConnection { 24732 """A list of edges.""" 24733 edges: [TenderTransactionEdge!]! 24734 24735 """Information to aid in pagination.""" 24736 pageInfo: PageInfo! 24737 } 24738 24739 """Information about the credit card used for this transaction.""" 24740 type TenderTransactionCreditCardDetails { 24741 """The name of the company that issued the customer's credit card.""" 24742 creditCardCompany: String 24743 24744 """ 24745 The customer's credit card number, with most of the leading digits redacted. 24746 """ 24747 creditCardNumber: String 24748 } 24749 24750 """Information about the payment instrument used for this transaction.""" 24751 union TenderTransactionDetails = TenderTransactionCreditCardDetails 24752 24753 """ 24754 An auto-generated type which holds one TenderTransaction and a cursor during pagination. 24755 24756 """ 24757 type TenderTransactionEdge { 24758 """A cursor for use in pagination.""" 24759 cursor: String! 24760 24761 """The item at the end of TenderTransactionEdge.""" 24762 node: TenderTransaction! 24763 } 24764 24765 """Specifies the fields for tracking information.""" 24766 input TrackingInfoInput { 24767 """The tracking number of the fulfillment.""" 24768 number: String 24769 24770 """The URL to track the fulfillment.""" 24771 url: String 24772 } 24773 24774 """Specifies all possible fields for updating tracking information.""" 24775 input TrackingInfoUpdateInput { 24776 """ 24777 Tracking information consisting of one or more tracking URLs and numbers associated with the fulfillment. 24778 24779 """ 24780 trackingDetails: [TrackingInfoInput!] 24781 24782 """The name of the tracking company.""" 24783 trackingCompany: String 24784 24785 """ 24786 Indicates whether the customer will be notified of this update and future updates for this fulfillment. 24787 24788 """ 24789 notifyCustomer: Boolean 24790 } 24791 24792 """Transaction fee related to an order transaction.""" 24793 type TransactionFee implements Node { 24794 """Amount of the fee.""" 24795 amount: MoneyV2! 24796 24797 """Flat rate charge for a transaction.""" 24798 flatFee: MoneyV2! 24799 24800 """Name of the credit card flat fee.""" 24801 flatFeeName: String 24802 24803 """Globally unique identifier.""" 24804 id: ID! 24805 24806 """Percentage charge.""" 24807 rate: Decimal! 24808 24809 """Name of the credit card rate.""" 24810 rateName: String 24811 24812 """Tax amount charged on the fee.""" 24813 taxAmount: MoneyV2! 24814 24815 """Name of the type of fee.""" 24816 type: String! 24817 } 24818 24819 """Translatable content of a resource's field.""" 24820 type TranslatableContent { 24821 """Digest (hash) of the content.""" 24822 digest: String 24823 24824 """Content key.""" 24825 key: String! 24826 24827 """Content locale.""" 24828 locale: String! 24829 24830 """Content value.""" 24831 value: String 24832 } 24833 24834 """A resource that has translatable fields.""" 24835 type TranslatableResource { 24836 """GID of the resource.""" 24837 resourceId: ID! 24838 24839 """Translatable content.""" 24840 translatableContent: [TranslatableContent!]! 24841 24842 """Translatable content translations.""" 24843 translations( 24844 """Filters translations by locale.""" 24845 locale: String! 24846 24847 """Filters by outdated translations.""" 24848 outdated: Boolean 24849 ): [Translation!]! 24850 } 24851 24852 """ 24853 An auto-generated type for paginating through multiple TranslatableResources. 24854 24855 """ 24856 type TranslatableResourceConnection { 24857 """A list of edges.""" 24858 edges: [TranslatableResourceEdge!]! 24859 24860 """Information to aid in pagination.""" 24861 pageInfo: PageInfo! 24862 } 24863 24864 """ 24865 An auto-generated type which holds one TranslatableResource and a cursor during pagination. 24866 24867 """ 24868 type TranslatableResourceEdge { 24869 """A cursor for use in pagination.""" 24870 cursor: String! 24871 24872 """The item at the end of TranslatableResourceEdge.""" 24873 node: TranslatableResource! 24874 } 24875 24876 """Specifies the type of resources that are translatable.""" 24877 enum TranslatableResourceType { 24878 """Represents a product.""" 24879 PRODUCT 24880 24881 """Represents a product variant.""" 24882 PRODUCT_VARIANT 24883 24884 """Represents an email template.""" 24885 EMAIL_TEMPLATE 24886 24887 """Represents an online store theme.""" 24888 ONLINE_STORE_THEME 24889 24890 """Represents an article.""" 24891 ONLINE_STORE_ARTICLE 24892 24893 """Represents an online store blog.""" 24894 ONLINE_STORE_BLOG 24895 24896 """Represents an online store page.""" 24897 ONLINE_STORE_PAGE 24898 24899 """Represents a collection of products.""" 24900 COLLECTION 24901 24902 """Represents a link to direct users to.""" 24903 LINK 24904 24905 """Represents a metafield.""" 24906 METAFIELD 24907 24908 """Represents an SMS template.""" 24909 SMS_TEMPLATE 24910 24911 """Represents a shop.""" 24912 SHOP 24913 24914 """Represents a shop policy.""" 24915 SHOP_POLICY 24916 24917 """Represents a payment gateway.""" 24918 PAYMENT_GATEWAY 24919 24920 """ 24921 Represents a custom product property name like "Size", "Color", and "Material". 24922 """ 24923 PRODUCT_OPTION 24924 24925 """ 24926 Represents a delivery method definition. For example, "Standard", or "Expedited". 24927 """ 24928 DELIVERY_METHOD_DEFINITION 24929 } 24930 24931 """Translation of a field of a resource.""" 24932 type Translation { 24933 """Translation key.""" 24934 key: String! 24935 24936 """Translation locale.""" 24937 locale: String! 24938 24939 """Marked as outdated.""" 24940 outdated: Boolean! 24941 24942 """Translation value.""" 24943 value: String 24944 } 24945 24946 """Possible error codes that could be returned by TranslationUserError.""" 24947 enum TranslationErrorCode { 24948 """Input value is blank.""" 24949 BLANK 24950 24951 """Input value is invalid.""" 24952 INVALID 24953 24954 """Resource does not exist.""" 24955 RESOURCE_NOT_FOUND 24956 24957 """Too many translation keys for resource.""" 24958 TOO_MANY_KEYS_FOR_RESOURCE 24959 24960 """Translation key is invalid.""" 24961 INVALID_KEY_FOR_MODEL 24962 24963 """Translation value is invalid.""" 24964 FAILS_RESOURCE_VALIDATION 24965 24966 """Translatable content is invalid.""" 24967 INVALID_TRANSLATABLE_CONTENT 24968 24969 """Locale is invalid for the shop.""" 24970 INVALID_LOCALE_FOR_SHOP 24971 24972 """Locale language code is invalid.""" 24973 INVALID_CODE 24974 24975 """Locale code format is invalid.""" 24976 INVALID_FORMAT 24977 } 24978 24979 """ 24980 Provides the fields and values to use when creating or updating a translation. 24981 """ 24982 input TranslationInput { 24983 """The locale of the translation.""" 24984 locale: String! 24985 24986 """The key of the translation.""" 24987 key: String! 24988 24989 """The value of the translation.""" 24990 value: String! 24991 24992 """The digest (hash) of the content being translated.""" 24993 translatableContentDigest: String! 24994 } 24995 24996 """ 24997 Represents an error that happens during the execution of a translation mutation. 24998 """ 24999 type TranslationUserError implements DisplayableError { 25000 """Error code to uniquely identify the error.""" 25001 code: TranslationErrorCode 25002 25003 """Path to the input field which caused the error.""" 25004 field: [String!] 25005 25006 """The error message.""" 25007 message: String! 25008 } 25009 25010 """Return type for `translationsRegister` mutation.""" 25011 type TranslationsRegisterPayload { 25012 """The translations that were created or updated.""" 25013 translations: [Translation!] 25014 25015 """List of errors that occurred executing the mutation.""" 25016 userErrors: [TranslationUserError!]! 25017 } 25018 25019 """Return type for `translationsRemove` mutation.""" 25020 type TranslationsRemovePayload { 25021 """The translations that were deleted.""" 25022 translations: [Translation!] 25023 25024 """List of errors that occurred executing the mutation.""" 25025 userErrors: [TranslationUserError!]! 25026 } 25027 25028 """ 25029 An RFC 3986 and RFC 3987 compliant URI string. 25030 25031 Example value: `"https://johns-apparel.myshopify.com"`. 25032 25033 """ 25034 scalar URL 25035 25036 """ 25037 Specifies the 25038 [Urchin Traffic Module (UTM) parameters](https://en.wikipedia.org/wiki/UTM_parameters) 25039 that are associated with a related marketing campaign. 25040 25041 """ 25042 input UTMInput { 25043 """The name of the UTM campaign.""" 25044 campaign: String! 25045 25046 """The name of the website or application where the referral link exists.""" 25047 source: String! 25048 25049 """The UTM campaign medium.""" 25050 medium: String! 25051 } 25052 25053 """Represents a set of UTM parameters.""" 25054 type UTMParameters { 25055 """The name of a marketing campaign.""" 25056 campaign: String 25057 25058 """ 25059 Identifies specific content in a marketing campaign. Used to differentiate between similar content or links in a marketing campaign to determine which is the most effective. 25060 """ 25061 content: String 25062 25063 """ 25064 The medium of a marketing campaign, such as a banner or email newsletter. 25065 """ 25066 medium: String 25067 25068 """ 25069 The source of traffic to the merchant's store, such as Google or an email newsletter. 25070 """ 25071 source: String 25072 25073 """Paid search terms used by a marketing campaign.""" 25074 term: String 25075 } 25076 25077 """Systems of weights and measures.""" 25078 enum UnitSystem { 25079 """Imperial system of weights and measures.""" 25080 IMPERIAL_SYSTEM 25081 25082 """Metric system of weights and measures.""" 25083 METRIC_SYSTEM 25084 } 25085 25086 """ 25087 An unsigned 64-bit integer. Represents whole numeric values between 0 and 2^64 - 1 encoded as a string of base-10 digits. 25088 25089 Example value: `"50"`. 25090 25091 """ 25092 scalar UnsignedInt64 25093 25094 """Specifies the input fields required to update a media object.""" 25095 input UpdateMediaInput { 25096 """Specifies the media to update.""" 25097 id: ID! 25098 25099 """ 25100 The source from which to update the media preview image. May be an external URL or signed upload URL. 25101 """ 25102 previewImageSource: String 25103 25104 """The alt text associated to the media.""" 25105 alt: String 25106 } 25107 25108 """Represents an error in the input of a mutation.""" 25109 type UserError implements DisplayableError { 25110 """Path to the input field which caused the error.""" 25111 field: [String!] 25112 25113 """The error message.""" 25114 message: String! 25115 } 25116 25117 """ 25118 Time between UTC time and a location's observed time, in the format `"+HH:MM"` or `"-HH:MM"`. 25119 25120 Example value: `"-07:00"`. 25121 25122 """ 25123 scalar UtcOffset 25124 25125 """ 25126 Represents a Shopify hosted video. 25127 25128 """ 25129 type Video implements Node & Media { 25130 """A word or phrase to share the nature or contents of a media.""" 25131 alt: String 25132 25133 """The filename of the video.""" 25134 filename: String! 25135 25136 """Globally unique identifier.""" 25137 id: ID! 25138 25139 """The media content type.""" 25140 mediaContentType: MediaContentType! 25141 25142 """Any errors which have occurred on the media.""" 25143 mediaErrors: [MediaError!]! 25144 25145 """The original source for a video.""" 25146 originalSource: VideoSource 25147 25148 """The preview image for the media.""" 25149 preview: MediaPreviewImage 25150 25151 """The sources for a video.""" 25152 sources: [VideoSource!]! 25153 25154 """Current status of the media.""" 25155 status: MediaStatus! 25156 } 25157 25158 """ 25159 Represents a source for a Shopify hosted video. 25160 25161 """ 25162 type VideoSource { 25163 """The format of the video source.""" 25164 format: String! 25165 25166 """The height of the video.""" 25167 height: Int! 25168 25169 """The video MIME type.""" 25170 mimeType: String! 25171 25172 """The URL of the video.""" 25173 url: String! 25174 25175 """The width of the video.""" 25176 width: Int! 25177 } 25178 25179 """Amazon EventBridge event source.""" 25180 type WebhookEventBridgeEndpoint { 25181 """ARN of this EventBridge event source.""" 25182 arn: ARN! 25183 } 25184 25185 """HTTP endpoint where POST requests will be made to.""" 25186 type WebhookHttpEndpoint { 25187 """URL of webhook endpoint to deliver webhooks to.""" 25188 callbackUrl: URL! 25189 } 25190 25191 """ 25192 Represents a subscription to a webhook. 25193 25194 """ 25195 type WebhookSubscription implements Node & LegacyInteroperability { 25196 """ 25197 URL where the webhook subscription should send the POST request when the event occurs. 25198 """ 25199 callbackUrl: URL! @deprecated(reason: "Use `endpoint` instead") 25200 25201 """The date and time when the webhook subscription was created.""" 25202 createdAt: DateTime! 25203 25204 """Endpoint where webhooks will be delivered to.""" 25205 endpoint: WebhookSubscriptionEndpoint! 25206 25207 """The format in which the webhook subscription should send the data.""" 25208 format: WebhookSubscriptionFormat! 25209 25210 """Globally unique identifier.""" 25211 id: ID! 25212 25213 """The list of fields to be included in the webhook subscription.""" 25214 includeFields: [String!]! 25215 25216 """The ID of the corresponding resource in the REST Admin API.""" 25217 legacyResourceId: UnsignedInt64! 25218 25219 """ 25220 The list of namespaces for any metafields that should be included in the webhook subscription. 25221 """ 25222 metafieldNamespaces: [String!]! 25223 25224 """The type of event that triggers the webhook.""" 25225 topic: WebhookSubscriptionTopic! 25226 25227 """The date and time when the webhook subscription was updated.""" 25228 updatedAt: DateTime! 25229 } 25230 25231 """ 25232 An auto-generated type for paginating through multiple WebhookSubscriptions. 25233 25234 """ 25235 type WebhookSubscriptionConnection { 25236 """A list of edges.""" 25237 edges: [WebhookSubscriptionEdge!]! 25238 25239 """Information to aid in pagination.""" 25240 pageInfo: PageInfo! 25241 } 25242 25243 """Return type for `webhookSubscriptionCreate` mutation.""" 25244 type WebhookSubscriptionCreatePayload { 25245 """List of errors that occurred executing the mutation.""" 25246 userErrors: [UserError!]! 25247 25248 """The webhook subscription that was created.""" 25249 webhookSubscription: WebhookSubscription 25250 } 25251 25252 """Return type for `webhookSubscriptionDelete` mutation.""" 25253 type WebhookSubscriptionDeletePayload { 25254 """The ID of the deleted webhook subscription.""" 25255 deletedWebhookSubscriptionId: ID 25256 25257 """List of errors that occurred executing the mutation.""" 25258 userErrors: [UserError!]! 25259 } 25260 25261 """ 25262 An auto-generated type which holds one WebhookSubscription and a cursor during pagination. 25263 25264 """ 25265 type WebhookSubscriptionEdge { 25266 """A cursor for use in pagination.""" 25267 cursor: String! 25268 25269 """The item at the end of WebhookSubscriptionEdge.""" 25270 node: WebhookSubscription! 25271 } 25272 25273 """Endpoint where webhooks will be delivered.""" 25274 union WebhookSubscriptionEndpoint = WebhookEventBridgeEndpoint | WebhookHttpEndpoint 25275 25276 """The supported formats for webhook subscriptions.""" 25277 enum WebhookSubscriptionFormat { 25278 JSON 25279 XML 25280 } 25281 25282 """ 25283 Specifies the input fields for a webhook subscription. 25284 25285 """ 25286 input WebhookSubscriptionInput { 25287 """ 25288 URL where the webhook subscription should send the POST request when the event occurs. 25289 """ 25290 callbackUrl: URL 25291 25292 """The format in which the webhook subscription should send the data.""" 25293 format: WebhookSubscriptionFormat 25294 25295 """The list of fields to be included in the webhook subscription.""" 25296 includeFields: [String!] 25297 25298 """ 25299 The list of namespaces for any metafields that should be included in the webhook subscription. 25300 """ 25301 metafieldNamespaces: [String!] 25302 } 25303 25304 """The set of valid sort keys for the WebhookSubscription query.""" 25305 enum WebhookSubscriptionSortKeys { 25306 """Sort by the `created_at` value.""" 25307 CREATED_AT 25308 25309 """Sort by the `id` value.""" 25310 ID 25311 25312 """ 25313 During a search (i.e. when the `query` parameter has been specified on the connection) this sorts the 25314 results by relevance to the search term(s). When no search query is specified, this sort key is not 25315 deterministic and should not be used. 25316 25317 """ 25318 RELEVANCE 25319 } 25320 25321 """The supported topics for webhook subscriptions.""" 25322 enum WebhookSubscriptionTopic { 25323 """The webhook topic for `app/uninstalled` events.""" 25324 APP_UNINSTALLED 25325 25326 """The webhook topic for `carts/create` events.""" 25327 CARTS_CREATE 25328 25329 """The webhook topic for `carts/update` events.""" 25330 CARTS_UPDATE 25331 25332 """The webhook topic for `channels/delete` events.""" 25333 CHANNELS_DELETE 25334 25335 """The webhook topic for `checkouts/create` events.""" 25336 CHECKOUTS_CREATE 25337 25338 """The webhook topic for `checkouts/delete` events.""" 25339 CHECKOUTS_DELETE 25340 25341 """The webhook topic for `checkouts/update` events.""" 25342 CHECKOUTS_UPDATE 25343 25344 """The webhook topic for `customer_payment_methods/create` events.""" 25345 CUSTOMER_PAYMENT_METHODS_CREATE 25346 25347 """The webhook topic for `customer_payment_methods/update` events.""" 25348 CUSTOMER_PAYMENT_METHODS_UPDATE 25349 25350 """The webhook topic for `customer_payment_methods/revoke` events.""" 25351 CUSTOMER_PAYMENT_METHODS_REVOKE 25352 25353 """The webhook topic for `collection_listings/add` events.""" 25354 COLLECTION_LISTINGS_ADD 25355 25356 """The webhook topic for `collection_listings/remove` events.""" 25357 COLLECTION_LISTINGS_REMOVE 25358 25359 """The webhook topic for `collection_listings/update` events.""" 25360 COLLECTION_LISTINGS_UPDATE 25361 25362 """The webhook topic for `collection_publications/create` events.""" 25363 COLLECTION_PUBLICATIONS_CREATE 25364 25365 """The webhook topic for `collection_publications/delete` events.""" 25366 COLLECTION_PUBLICATIONS_DELETE 25367 25368 """The webhook topic for `collection_publications/update` events.""" 25369 COLLECTION_PUBLICATIONS_UPDATE 25370 25371 """The webhook topic for `collections/create` events.""" 25372 COLLECTIONS_CREATE 25373 25374 """The webhook topic for `collections/delete` events.""" 25375 COLLECTIONS_DELETE 25376 25377 """The webhook topic for `collections/update` events.""" 25378 COLLECTIONS_UPDATE 25379 25380 """The webhook topic for `customer_groups/create` events.""" 25381 CUSTOMER_GROUPS_CREATE 25382 25383 """The webhook topic for `customer_groups/delete` events.""" 25384 CUSTOMER_GROUPS_DELETE 25385 25386 """The webhook topic for `customer_groups/update` events.""" 25387 CUSTOMER_GROUPS_UPDATE 25388 25389 """The webhook topic for `customers/create` events.""" 25390 CUSTOMERS_CREATE 25391 25392 """The webhook topic for `customers/delete` events.""" 25393 CUSTOMERS_DELETE 25394 25395 """The webhook topic for `customers/disable` events.""" 25396 CUSTOMERS_DISABLE 25397 25398 """The webhook topic for `customers/enable` events.""" 25399 CUSTOMERS_ENABLE 25400 25401 """The webhook topic for `customers/update` events.""" 25402 CUSTOMERS_UPDATE 25403 25404 """The webhook topic for `disputes/create` events.""" 25405 DISPUTES_CREATE 25406 25407 """The webhook topic for `disputes/update` events.""" 25408 DISPUTES_UPDATE 25409 25410 """The webhook topic for `draft_orders/create` events.""" 25411 DRAFT_ORDERS_CREATE 25412 25413 """The webhook topic for `draft_orders/delete` events.""" 25414 DRAFT_ORDERS_DELETE 25415 25416 """The webhook topic for `draft_orders/update` events.""" 25417 DRAFT_ORDERS_UPDATE 25418 25419 """The webhook topic for `fulfillment_events/create` events.""" 25420 FULFILLMENT_EVENTS_CREATE 25421 25422 """The webhook topic for `fulfillment_events/delete` events.""" 25423 FULFILLMENT_EVENTS_DELETE 25424 25425 """The webhook topic for `fulfillments/create` events.""" 25426 FULFILLMENTS_CREATE 25427 25428 """The webhook topic for `fulfillments/update` events.""" 25429 FULFILLMENTS_UPDATE 25430 25431 """The webhook topic for `attributed_sessions/first` events.""" 25432 ATTRIBUTED_SESSIONS_FIRST 25433 25434 """The webhook topic for `attributed_sessions/last` events.""" 25435 ATTRIBUTED_SESSIONS_LAST 25436 25437 """The webhook topic for `order_transactions/create` events.""" 25438 ORDER_TRANSACTIONS_CREATE 25439 25440 """The webhook topic for `orders/cancelled` events.""" 25441 ORDERS_CANCELLED 25442 25443 """The webhook topic for `orders/create` events.""" 25444 ORDERS_CREATE 25445 25446 """The webhook topic for `orders/delete` events.""" 25447 ORDERS_DELETE 25448 25449 """The webhook topic for `orders/edited` events.""" 25450 ORDERS_EDITED 25451 25452 """The webhook topic for `orders/fulfilled` events.""" 25453 ORDERS_FULFILLED 25454 25455 """The webhook topic for `orders/paid` events.""" 25456 ORDERS_PAID 25457 25458 """The webhook topic for `orders/partially_fulfilled` events.""" 25459 ORDERS_PARTIALLY_FULFILLED 25460 25461 """The webhook topic for `orders/updated` events.""" 25462 ORDERS_UPDATED 25463 25464 """The webhook topic for `product_listings/add` events.""" 25465 PRODUCT_LISTINGS_ADD 25466 25467 """The webhook topic for `product_listings/remove` events.""" 25468 PRODUCT_LISTINGS_REMOVE 25469 25470 """The webhook topic for `product_listings/update` events.""" 25471 PRODUCT_LISTINGS_UPDATE 25472 25473 """The webhook topic for `product_publications/create` events.""" 25474 PRODUCT_PUBLICATIONS_CREATE 25475 25476 """The webhook topic for `product_publications/delete` events.""" 25477 PRODUCT_PUBLICATIONS_DELETE 25478 25479 """The webhook topic for `product_publications/update` events.""" 25480 PRODUCT_PUBLICATIONS_UPDATE 25481 25482 """The webhook topic for `products/create` events.""" 25483 PRODUCTS_CREATE 25484 25485 """The webhook topic for `products/delete` events.""" 25486 PRODUCTS_DELETE 25487 25488 """The webhook topic for `products/update` events.""" 25489 PRODUCTS_UPDATE 25490 25491 """The webhook topic for `refunds/create` events.""" 25492 REFUNDS_CREATE 25493 25494 """The webhook topic for `shipping_addresses/create` events.""" 25495 SHIPPING_ADDRESSES_CREATE 25496 25497 """The webhook topic for `shipping_addresses/update` events.""" 25498 SHIPPING_ADDRESSES_UPDATE 25499 25500 """The webhook topic for `shop/update` events.""" 25501 SHOP_UPDATE 25502 25503 """The webhook topic for `tax_services/create` events.""" 25504 TAX_SERVICES_CREATE 25505 25506 """The webhook topic for `tax_services/update` events.""" 25507 TAX_SERVICES_UPDATE 25508 25509 """The webhook topic for `themes/create` events.""" 25510 THEMES_CREATE 25511 25512 """The webhook topic for `themes/delete` events.""" 25513 THEMES_DELETE 25514 25515 """The webhook topic for `themes/publish` events.""" 25516 THEMES_PUBLISH 25517 25518 """The webhook topic for `themes/update` events.""" 25519 THEMES_UPDATE 25520 25521 """The webhook topic for `variants/in_stock` events.""" 25522 VARIANTS_IN_STOCK 25523 25524 """The webhook topic for `variants/out_of_stock` events.""" 25525 VARIANTS_OUT_OF_STOCK 25526 25527 """The webhook topic for `inventory_levels/connect` events.""" 25528 INVENTORY_LEVELS_CONNECT 25529 25530 """The webhook topic for `inventory_levels/update` events.""" 25531 INVENTORY_LEVELS_UPDATE 25532 25533 """The webhook topic for `inventory_levels/disconnect` events.""" 25534 INVENTORY_LEVELS_DISCONNECT 25535 25536 """The webhook topic for `attribution/risk` events.""" 25537 ATTRIBUTION_RISK 25538 25539 """The webhook topic for `inventory_items/create` events.""" 25540 INVENTORY_ITEMS_CREATE 25541 25542 """The webhook topic for `inventory_items/update` events.""" 25543 INVENTORY_ITEMS_UPDATE 25544 25545 """The webhook topic for `inventory_items/delete` events.""" 25546 INVENTORY_ITEMS_DELETE 25547 25548 """The webhook topic for `locations/create` events.""" 25549 LOCATIONS_CREATE 25550 25551 """The webhook topic for `locations/update` events.""" 25552 LOCATIONS_UPDATE 25553 25554 """The webhook topic for `locations/delete` events.""" 25555 LOCATIONS_DELETE 25556 25557 """The webhook topic for `tender_transactions/create` events.""" 25558 TENDER_TRANSACTIONS_CREATE 25559 25560 """The webhook topic for `app_purchases_one_time/update` events.""" 25561 APP_PURCHASES_ONE_TIME_UPDATE 25562 25563 """The webhook topic for `app_subscriptions/update` events.""" 25564 APP_SUBSCRIPTIONS_UPDATE 25565 25566 """The webhook topic for `locales/create` events.""" 25567 LOCALES_CREATE 25568 25569 """The webhook topic for `locales/update` events.""" 25570 LOCALES_UPDATE 25571 25572 """The webhook topic for `domains/create` events.""" 25573 DOMAINS_CREATE 25574 25575 """The webhook topic for `domains/update` events.""" 25576 DOMAINS_UPDATE 25577 25578 """The webhook topic for `domains/destroy` events.""" 25579 DOMAINS_DESTROY 25580 25581 """The webhook topic for `subscription_contracts/create` events.""" 25582 SUBSCRIPTION_CONTRACTS_CREATE 25583 25584 """The webhook topic for `subscription_contracts/update` events.""" 25585 SUBSCRIPTION_CONTRACTS_UPDATE 25586 25587 """The webhook topic for `profiles/create` events.""" 25588 PROFILES_CREATE 25589 25590 """The webhook topic for `profiles/update` events.""" 25591 PROFILES_UPDATE 25592 25593 """The webhook topic for `profiles/delete` events.""" 25594 PROFILES_DELETE 25595 25596 """The webhook topic for `subscription_billing_attempts/success` events.""" 25597 SUBSCRIPTION_BILLING_ATTEMPTS_SUCCESS 25598 25599 """The webhook topic for `subscription_billing_attempts/failure` events.""" 25600 SUBSCRIPTION_BILLING_ATTEMPTS_FAILURE 25601 } 25602 25603 """Return type for `webhookSubscriptionUpdate` mutation.""" 25604 type WebhookSubscriptionUpdatePayload { 25605 """List of errors that occurred executing the mutation.""" 25606 userErrors: [UserError!]! 25607 25608 """The webhook subscription that was updated.""" 25609 webhookSubscription: WebhookSubscription 25610 } 25611 25612 """Represents weight unit and value.""" 25613 type Weight { 25614 """Unit of measurement for `value`.""" 25615 unit: WeightUnit! 25616 25617 """The weight using the unit system specified with `unit`.""" 25618 value: Float! 25619 } 25620 25621 """ 25622 Specifies the weight unit and value inputs. 25623 25624 """ 25625 input WeightInput { 25626 """The weight value using the unit system specified with `weight_unit`.""" 25627 value: Float! 25628 25629 """Unit of measurement for `value`.""" 25630 unit: WeightUnit! 25631 } 25632 25633 """Units of measurement for weight.""" 25634 enum WeightUnit { 25635 """1 kilogram equals 1000 grams.""" 25636 KILOGRAMS 25637 25638 """Metric system unit of mass.""" 25639 GRAMS 25640 25641 """1 pound equals 16 ounces.""" 25642 POUNDS 25643 25644 """Imperial system unit of mass.""" 25645 OUNCES 25646 } 25647 25648 """Return type for `deliveryProfileCreate` mutation.""" 25649 type deliveryProfileCreatePayload { 25650 """The delivery profile that was created.""" 25651 profile: DeliveryProfile 25652 25653 """List of errors that occurred executing the mutation.""" 25654 userErrors: [UserError!]! 25655 } 25656 25657 """Return type for `deliveryProfileRemove` mutation.""" 25658 type deliveryProfileRemovePayload { 25659 """The profile deletion job triggered by the mutation.""" 25660 job: Job 25661 25662 """List of errors that occurred executing the mutation.""" 25663 userErrors: [UserError!]! 25664 } 25665 25666 """Return type for `deliveryProfileUpdate` mutation.""" 25667 type deliveryProfileUpdatePayload { 25668 """The delivery profile that was updated.""" 25669 profile: DeliveryProfile 25670 25671 """List of errors that occurred executing the mutation.""" 25672 userErrors: [UserError!]! 25673 }