ReturnZap GraphQL API Documentation
Welcome to the ReturnZap API documentation. Here you can find details about all available queries, mutations, and types.
API Endpoints
https://api.returnzap.com/graphql/adminHeaders
# Your authorization token must be included in all requests.
Authorization: Bearer <YOUR_TOKEN_HERE>Version
1.0.0
Introduction
This is the API documentation for ReturnZap. Here you can explore all the available queries, mutations, and data types.
Queries
_debug
Response
Returns a DjangoDebug
Example
Query
query _debug {
_debug {
sql {
...DjangoDebugSQLFragment
}
exceptions {
...DjangoDebugExceptionFragment
}
}
}
Response
{
"data": {
"_debug": {
"sql": [DjangoDebugSQL],
"exceptions": [DjangoDebugException]
}
}
}
adminOrderLookup
Description
Lookup order by order number or email
Response
Returns an AdminOrderLookupResponse
Arguments
| Name | Description |
|---|---|
query - String!
|
Example
Query
query adminOrderLookup($query: String!) {
adminOrderLookup(query: $query) {
orders {
...AdminSearchOrderResultFragment
}
}
}
Variables
{"query": "xyz789"}
Response
{
"data": {
"adminOrderLookup": {
"orders": [AdminSearchOrderResult]
}
}
}
dashboardMetrics
Response
Returns a DashboardMetrics
Example
Query
query dashboardMetrics(
$startDate: DateTime!,
$endDate: DateTime!
) {
dashboardMetrics(
startDate: $startDate,
endDate: $endDate
) {
returnMetrics {
...ReturnsMetricTypeFragment
}
stageMetrics {
...StageMetricTypeFragment
}
policyMetrics {
...PolicyMetricTypeFragment
}
reasonMetrics {
...ReasonMetricTypeFragment
}
actionTakenMetrics {
...ActionTakenMetricTypeFragment
}
mostReturned {
...ReturnProductMetricTypeFragment
}
activeReturns {
...ActiveReturnsMetricTypeFragment
}
startDate
endDate
}
}
Variables
{
"startDate": "2007-12-03T10:15:30Z",
"endDate": "2007-12-03T10:15:30Z"
}
Response
{
"data": {
"dashboardMetrics": {
"returnMetrics": [ReturnsMetricType],
"stageMetrics": [StageMetricType],
"policyMetrics": [PolicyMetricType],
"reasonMetrics": [ReasonMetricType],
"actionTakenMetrics": ActionTakenMetricType,
"mostReturned": ReturnProductMetricType,
"activeReturns": ActiveReturnsMetricType,
"startDate": "2007-12-03T10:15:30Z",
"endDate": "2007-12-03T10:15:30Z"
}
}
}
dashboardReturns
Response
Returns a DashboardResponse
Arguments
| Name | Description |
|---|---|
query - String
|
Default = "" |
stages - [Int]
|
|
status - ArchiveFilter
|
|
returnDate - DateFilterRange
|
|
orderDate - DateFilterRange
|
|
stageUpdatedDate - DateFilterRange
|
|
perPage - Int
|
Default = 25 |
currentPage - Int
|
Default = 0 |
sortBy - String
|
Default = "-returnDate" |
resolvedStatus - [ResolvedStatus]
|
|
returnItemTypes - [String]
|
Example
Query
query dashboardReturns(
$query: String,
$stages: [Int],
$status: ArchiveFilter,
$returnDate: DateFilterRange,
$orderDate: DateFilterRange,
$stageUpdatedDate: DateFilterRange,
$perPage: Int,
$currentPage: Int,
$sortBy: String,
$resolvedStatus: [ResolvedStatus],
$returnItemTypes: [String]
) {
dashboardReturns(
query: $query,
stages: $stages,
status: $status,
returnDate: $returnDate,
orderDate: $orderDate,
stageUpdatedDate: $stageUpdatedDate,
perPage: $perPage,
currentPage: $currentPage,
sortBy: $sortBy,
resolvedStatus: $resolvedStatus,
returnItemTypes: $returnItemTypes
) {
id
returns {
...ReturnFragment
}
totalCount
}
}
Variables
{
"query": "",
"stages": [987],
"status": "ACTIVE",
"returnDate": DateFilterRange,
"orderDate": DateFilterRange,
"stageUpdatedDate": DateFilterRange,
"perPage": 25,
"currentPage": 0,
"sortBy": "-returnDate",
"resolvedStatus": ["RESOLVED"],
"returnItemTypes": ["abc123"]
}
Response
{
"data": {
"dashboardReturns": {
"id": 4,
"returns": [Return],
"totalCount": 123
}
}
}
easyPostCarrierConfig
Response
Returns [EasyPostCarrierConfig]
Example
Query
query easyPostCarrierConfig {
easyPostCarrierConfig {
carrier
displayName
service
serviceDisplayName
width
height
unit
rotate
supportsQrCode
}
}
Response
{
"data": {
"easyPostCarrierConfig": [
{
"carrier": "abc123",
"displayName": "xyz789",
"service": "abc123",
"serviceDisplayName": "abc123",
"width": Decimal,
"height": Decimal,
"unit": "IN",
"rotate": true,
"supportsQrCode": false
}
]
}
}
getBalanceInfo
Description
Get complete balance information for a shop
Response
Returns a BalanceInfoType
Example
Query
query getBalanceInfo {
getBalanceInfo {
tosStatus {
...TOSStatusTypeFragment
}
paymentMethods {
...ShopPaymentMethodFragment
}
balanceSettings {
...BalanceSettingsTypeFragment
}
balance
}
}
Response
{
"data": {
"getBalanceInfo": {
"tosStatus": TOSStatusType,
"paymentMethods": [ShopPaymentMethod],
"balanceSettings": BalanceSettingsType,
"balance": Decimal
}
}
}
getMe
Response
Returns a ShopifyUser
Example
Query
query getMe {
getMe {
id
uuid
accountOwner
email
shopifyId
firstName
lastName
locale
preferredLocale
chatHash
shouldUpdate
shopifyRoles
}
}
Response
{
"data": {
"getMe": {
"id": "4",
"uuid": "abc123",
"accountOwner": false,
"email": "abc123",
"shopifyId": "xyz789",
"firstName": "xyz789",
"lastName": "xyz789",
"locale": "xyz789",
"preferredLocale": "xyz789",
"chatHash": "xyz789",
"shouldUpdate": true,
"shopifyRoles": "abc123"
}
}
}
getMyShop
Response
Returns an AuthenticatedShop
Example
Query
query getMyShop {
getMyShop {
url
portalTheme
portalLanguage
portalFrenchUseAlternative
portalGermanUseAlternative
portalItalianUseAlternative
portalCustomizations
shouldDisplayFeesInPortal
refundPortalDisplayOrder
creditPortalDisplayOrder
exchangePortalDisplayOrder
showPortalSummary
portalExchangeSelectionMethod
portalVisualExchangeType
exchangeUpsellEnabled
exchangeUpsellDiscountPercentage
prepaidShippingFee
paidShippingFee
selfShippingFee
isDefaultFeeEqualsShippingCost
restockingFeeDefinedAsPercentage
defaultRefundFee
defaultExchangeFee
defaultStoreCreditFee
exchangeMethod
isInlineExchangeEnabled
isFullCatalogExchangeEnabled
useConsolidatedOrderExchanges
exchangeSamePriceOnly
isExchangeDifferentialPricingEnabled
allowOutOfStockExchanges
isStoreCreditIncentiveEnabled
storeCreditIncentivePercentage
minStoreCreditIncentiveAmount
maxStoreCreditIncentiveAmount
isStoreCreditIncentiveRoundToNearest
uuid
primaryDomain
isTestShop
isUitestShop
onboardingCompletedAt
needsToEnableExchangeTestDrive
instructions
portalVisualExchangeIncludeCollections
portalVisualExchangeExcludeCollections
isShippingLabelUploadAllowed
barcodeValue
enableCustomRmaNumber
shipFree
shipPay
shipSelf
useShippingByReturnzap
isNoShippingReturnEnabled
isQrCodeEnabled
isCartonizationEnabled
cartonizationLengthUnit
currency
klaviyoApiKey
gorgiasSubdomain
shippingRateSelectLowestRate
shippingRateShowUpToPercentage
useApprovals
requireApprovalForAllReturns
useShopAddressForPosReturns
delayedShopifyReturnCreationEnabled
isRefundIntegrationEnabled
isRestockIntegrationEnabled
returnItemExpirationDays
isReturnItemExpirationEnabled
exchangeIntegration
isExchangeIntegrationEnabled
discountSameProductExchangesToBeEqual
exchangeRoundToZeroIfLteTo
exchangeDaysToReserveStock
carryDiscountForwardType
useExchangeShipmentOrders
exchangeShipmentOrderSuffix
autoProcessExchangesOnCreation
storeCreditIntegration
isStoreCreditIntegrationEnabled
resolvePartialExchangeRefundsToStoreCredit
id
parentUrl
shopifyAdminUrl
primaryFieldBehavior
secondaryFieldBehavior
reauthenticateUrl
hasTestModeReturns
defaultPortalUrl
adminAppUrl
enableRefund
refundDays
refundDaysType
refundCommentsEnabled
refundCommentsRequired
enableExchange
exchangeDays
exchangeDaysType
exchangeCommentsEnabled
exchangeCommentsRequired
exchangeExcludeTags
enableStoreCredit
storeCreditDays
storeCreditDaysType
storeCreditCommentsEnabled
storeCreditCommentsRequired
automatedStoreCreditType
notificationEmailAddress
notificationEmailAttachRma
customerEmailDisplayFromName
customerEmailReplyToAddress
defaultAddress {
...AddressFragment
}
defaultWeight
defaultWeightUnit
international
internationalOriginCountry
internationalCustomsSigner
internationalNonDeliveryOption
internationalExemptionCode
internationalDefaultHarmonizedSystemCode
easypostApiKey
shippoApiKey
stripePublishableKey
stripeSecretKey
subscriptionPlan {
...ShopSubscriptionPlanFragment
}
features
onboardingComplete
installedAt
installDate
returnReasons {
...ReturnReasonFragment
}
stages {
...StageFragment
}
notifications {
...NotificationFragment
}
rules {
...RuleFragment
}
packages {
...PackageTypeFragment
}
dynamicTranslations {
...DynamicTranslationFragment
}
returnIntegration
missingScopes
sendcloudAccounts {
...SendcloudAccountFragment
}
shopifyLocations {
...ShopifyLocationFragment
}
easyPostAccount {
...EasyPostAccountTypeFragment
}
shippoAccount {
...ShippoAccountTypeFragment
}
refField1Source
refField2Source
storeCreditIncentiveType
restockingFeeType
webhookUrl
webhookEvents
questions {
...QuestionFragment
}
stageShipmentStatuses {
...StageShipmentStatusTypeFragment
}
defaultWarehouseForPosReturns
}
}
Response
{
"data": {
"getMyShop": {
"url": "abc123",
"portalTheme": "abc123",
"portalLanguage": "abc123",
"portalFrenchUseAlternative": false,
"portalGermanUseAlternative": true,
"portalItalianUseAlternative": false,
"portalCustomizations": JSONString,
"shouldDisplayFeesInPortal": false,
"refundPortalDisplayOrder": 987,
"creditPortalDisplayOrder": 123,
"exchangePortalDisplayOrder": 123,
"showPortalSummary": false,
"portalExchangeSelectionMethod": "SEARCH",
"portalVisualExchangeType": "NONE",
"exchangeUpsellEnabled": true,
"exchangeUpsellDiscountPercentage": Decimal,
"prepaidShippingFee": Decimal,
"paidShippingFee": Decimal,
"selfShippingFee": Decimal,
"isDefaultFeeEqualsShippingCost": false,
"restockingFeeDefinedAsPercentage": true,
"defaultRefundFee": Decimal,
"defaultExchangeFee": Decimal,
"defaultStoreCreditFee": Decimal,
"exchangeMethod": "COMMENTS",
"isInlineExchangeEnabled": true,
"isFullCatalogExchangeEnabled": true,
"useConsolidatedOrderExchanges": false,
"exchangeSamePriceOnly": true,
"isExchangeDifferentialPricingEnabled": true,
"allowOutOfStockExchanges": false,
"isStoreCreditIncentiveEnabled": true,
"storeCreditIncentivePercentage": 123.45,
"minStoreCreditIncentiveAmount": Decimal,
"maxStoreCreditIncentiveAmount": Decimal,
"isStoreCreditIncentiveRoundToNearest": false,
"uuid": "xyz789",
"primaryDomain": "abc123",
"isTestShop": true,
"isUitestShop": false,
"onboardingCompletedAt": "2007-12-03T10:15:30Z",
"needsToEnableExchangeTestDrive": true,
"instructions": "abc123",
"portalVisualExchangeIncludeCollections": [
"xyz789"
],
"portalVisualExchangeExcludeCollections": [
"abc123"
],
"isShippingLabelUploadAllowed": false,
"barcodeValue": "NONE",
"enableCustomRmaNumber": false,
"shipFree": false,
"shipPay": false,
"shipSelf": false,
"useShippingByReturnzap": false,
"isNoShippingReturnEnabled": true,
"isQrCodeEnabled": false,
"isCartonizationEnabled": true,
"cartonizationLengthUnit": "INCHES",
"currency": "abc123",
"klaviyoApiKey": "xyz789",
"gorgiasSubdomain": "abc123",
"shippingRateSelectLowestRate": false,
"shippingRateShowUpToPercentage": Decimal,
"useApprovals": true,
"requireApprovalForAllReturns": true,
"useShopAddressForPosReturns": true,
"delayedShopifyReturnCreationEnabled": true,
"isRefundIntegrationEnabled": true,
"isRestockIntegrationEnabled": true,
"returnItemExpirationDays": 987,
"isReturnItemExpirationEnabled": true,
"exchangeIntegration": false,
"isExchangeIntegrationEnabled": true,
"discountSameProductExchangesToBeEqual": false,
"exchangeRoundToZeroIfLteTo": Decimal,
"exchangeDaysToReserveStock": 123,
"carryDiscountForwardType": "NONE",
"useExchangeShipmentOrders": true,
"exchangeShipmentOrderSuffix": "xyz789",
"autoProcessExchangesOnCreation": false,
"storeCreditIntegration": true,
"isStoreCreditIntegrationEnabled": false,
"resolvePartialExchangeRefundsToStoreCredit": false,
"id": 4,
"parentUrl": "xyz789",
"shopifyAdminUrl": "xyz789",
"primaryFieldBehavior": "EMAIL_ADDRESS",
"secondaryFieldBehavior": "SHOPIFY_ORDER_NUMBER",
"reauthenticateUrl": "abc123",
"hasTestModeReturns": false,
"defaultPortalUrl": "xyz789",
"adminAppUrl": "xyz789",
"enableRefund": true,
"refundDays": 987,
"refundDaysType": "SINCE_DELIVERY",
"refundCommentsEnabled": true,
"refundCommentsRequired": true,
"enableExchange": true,
"exchangeDays": 987,
"exchangeDaysType": "SINCE_DELIVERY",
"exchangeCommentsEnabled": true,
"exchangeCommentsRequired": false,
"exchangeExcludeTags": ["abc123"],
"enableStoreCredit": false,
"storeCreditDays": 123,
"storeCreditDaysType": "SINCE_DELIVERY",
"storeCreditCommentsEnabled": true,
"storeCreditCommentsRequired": false,
"automatedStoreCreditType": "DISCOUNT_CODE",
"notificationEmailAddress": "xyz789",
"notificationEmailAttachRma": false,
"customerEmailDisplayFromName": "abc123",
"customerEmailReplyToAddress": "xyz789",
"defaultAddress": Address,
"defaultWeight": Decimal,
"defaultWeightUnit": "xyz789",
"international": false,
"internationalOriginCountry": "xyz789",
"internationalCustomsSigner": "xyz789",
"internationalNonDeliveryOption": "abc123",
"internationalExemptionCode": "xyz789",
"internationalDefaultHarmonizedSystemCode": "abc123",
"easypostApiKey": "xyz789",
"shippoApiKey": "abc123",
"stripePublishableKey": "abc123",
"stripeSecretKey": "xyz789",
"subscriptionPlan": ShopSubscriptionPlan,
"features": ["abc123"],
"onboardingComplete": false,
"installedAt": "2007-12-03T10:15:30Z",
"installDate": "2007-12-03T10:15:30Z",
"returnReasons": [ReturnReason],
"stages": [Stage],
"notifications": [Notification],
"rules": [Rule],
"packages": [PackageType],
"dynamicTranslations": [DynamicTranslation],
"returnIntegration": true,
"missingScopes": ["abc123"],
"sendcloudAccounts": [SendcloudAccount],
"shopifyLocations": [ShopifyLocation],
"easyPostAccount": EasyPostAccountType,
"shippoAccount": ShippoAccountType,
"refField1Source": "BLANK",
"refField2Source": "BLANK",
"storeCreditIncentiveType": "ONCE_PER_ITEM",
"restockingFeeType": "ONCE_PER_RETURN",
"webhookUrl": "xyz789",
"webhookEvents": ["RETURN_CREATED"],
"questions": [Question],
"stageShipmentStatuses": [StageShipmentStatusType],
"defaultWarehouseForPosReturns": 4
}
}
}
getPaymentMethod
Description
Get a specific payment method by ID
Response
Returns a ShopPaymentMethod
Arguments
| Name | Description |
|---|---|
paymentMethodId - ID!
|
Example
Query
query getPaymentMethod($paymentMethodId: ID!) {
getPaymentMethod(paymentMethodId: $paymentMethodId) {
id
createdAt
stripePaymentMethodId
paymentMethodType
brand
lastFour
bankName
isActive
isDefault
}
}
Variables
{"paymentMethodId": "4"}
Response
{
"data": {
"getPaymentMethod": {
"id": "a7b25635-2b7c-42da-9fa3-d967ab9051c5",
"createdAt": "2007-12-03T10:15:30Z",
"stripePaymentMethodId": "xyz789",
"paymentMethodType": "BANK_ACCOUNT",
"brand": "xyz789",
"lastFour": "abc123",
"bankName": "xyz789",
"isActive": true,
"isDefault": false
}
}
}
getReturn
Example
Query
query getReturn($returnId: ID!) {
getReturn(returnId: $returnId) {
id
uuid
adminReturn
testMode
returnIntegration
usesConsolidatedOrderExchanges
customerFirstName
customerLastName
customerEmail
rmaNumber
stageLabel
stageUpdatedDate
approvalRequired
approvedAt
rejectedAt
receivedAt
isArchived
expiredAt
shippingMethod
shippedTo
trackingNumber
deliveryDate
deliveryStatus
labelCurrency
shopCurrency
noShippingRequired
feesSentThroughReturnIntegration
defaultRefundFee
defaultStoreCreditFee
originalHandlingFeeCharged
actualHandlingFeeCharged
restockingFeeType
originalRestockingFeeCharged
actualRestockingFeeCharged
shopifyReturnId
shopifyReturnName
shopifyReturnSyncError
shopifyOrderId
shopifyOrderDate
exchangeBalanceDue
exchangeBalancePaidAt
estimatedBalance
shopifyOrderNumber
shopifyOrderUrl
shopifyCustomerUrl
customerAddress {
...ReturnAddressTypeFragment
}
destinationAddress {
...ReturnAddressTypeFragment
}
rmaFormUrl
stageId
systemStage
statusId
statusLabel
labelUrl
qrCodeUrl
labelCost
totalWeightGrams
createdAt
refunds {
...RefundTypeFragment
}
logs {
...ReturnLogFragment
}
next
previous
nextReturn {
...ReturnFragment
}
previousReturn {
...ReturnFragment
}
exchangeOrders {
...ExchangeOrderFragment
}
shipment {
...ShipmentFragment
}
appliedRules
suggestionRefund {
...SuggestionRefundTypeFragment
}
suggestedRefund {
...SuggestedRefundTypeFragment
}
hasValidCustomerPaymentPending
warehouseName
storeCredits {
...StoreCreditTypeFragment
}
externalShippingLabelUrl
items {
...ReturnItemFragment
}
exchangeItems {
...ExchangeItemFragment
}
handlingFeeCharged
restockingFeeCharged
shopifyOrderFulfillments {
...ShopifyFulfillmentTypeFragment
}
shopifyOrderTotalQuantityOrdered
shopifyOrderTotalQuantityReturnItems
shopifyOrderTags
shopifyOrderCustomerTags
shopifyReturnSyncStatus
orderId
orderNumber
orderDate
returnDate
isActive
unitQuantity
returnValueAmount
resolvedStatus
returnItemTypes
returnTypeLabels
}
}
Variables
{"returnId": 4}
Response
{
"data": {
"getReturn": {
"id": 4,
"uuid": "abc123",
"adminReturn": false,
"testMode": true,
"returnIntegration": false,
"usesConsolidatedOrderExchanges": true,
"customerFirstName": "xyz789",
"customerLastName": "xyz789",
"customerEmail": "abc123",
"rmaNumber": "xyz789",
"stageLabel": "xyz789",
"stageUpdatedDate": "2007-12-03T10:15:30Z",
"approvalRequired": true,
"approvedAt": "2007-12-03T10:15:30Z",
"rejectedAt": "2007-12-03T10:15:30Z",
"receivedAt": "2007-12-03T10:15:30Z",
"isArchived": true,
"expiredAt": "2007-12-03T10:15:30Z",
"shippingMethod": "FREE",
"shippedTo": "abc123",
"trackingNumber": "abc123",
"deliveryDate": "2007-12-03T10:15:30Z",
"deliveryStatus": "abc123",
"labelCurrency": "abc123",
"shopCurrency": "xyz789",
"noShippingRequired": false,
"feesSentThroughReturnIntegration": false,
"defaultRefundFee": Decimal,
"defaultStoreCreditFee": Decimal,
"originalHandlingFeeCharged": Decimal,
"actualHandlingFeeCharged": Decimal,
"restockingFeeType": "ONCE_PER_RETURN",
"originalRestockingFeeCharged": Decimal,
"actualRestockingFeeCharged": Decimal,
"shopifyReturnId": "abc123",
"shopifyReturnName": "xyz789",
"shopifyReturnSyncError": "UNKNOWN_ERROR",
"shopifyOrderId": "xyz789",
"shopifyOrderDate": "2007-12-03T10:15:30Z",
"exchangeBalanceDue": Decimal,
"exchangeBalancePaidAt": "2007-12-03T10:15:30Z",
"estimatedBalance": Decimal,
"shopifyOrderNumber": "xyz789",
"shopifyOrderUrl": "abc123",
"shopifyCustomerUrl": "abc123",
"customerAddress": ReturnAddressType,
"destinationAddress": ReturnAddressType,
"rmaFormUrl": "xyz789",
"stageId": 4,
"systemStage": 123,
"statusId": "abc123",
"statusLabel": "xyz789",
"labelUrl": "abc123",
"qrCodeUrl": "abc123",
"labelCost": Decimal,
"totalWeightGrams": Decimal,
"createdAt": "2007-12-03T10:15:30Z",
"refunds": [RefundType],
"logs": [ReturnLog],
"next": "abc123",
"previous": "abc123",
"nextReturn": Return,
"previousReturn": Return,
"exchangeOrders": [ExchangeOrder],
"shipment": Shipment,
"appliedRules": ["abc123"],
"suggestionRefund": SuggestionRefundType,
"suggestedRefund": SuggestedRefundType,
"hasValidCustomerPaymentPending": false,
"warehouseName": "xyz789",
"storeCredits": [StoreCreditType],
"externalShippingLabelUrl": "xyz789",
"items": [ReturnItem],
"exchangeItems": [ExchangeItem],
"handlingFeeCharged": Decimal,
"restockingFeeCharged": Decimal,
"shopifyOrderFulfillments": [
ShopifyFulfillmentType
],
"shopifyOrderTotalQuantityOrdered": 123,
"shopifyOrderTotalQuantityReturnItems": 987,
"shopifyOrderTags": ["abc123"],
"shopifyOrderCustomerTags": [
"abc123"
],
"shopifyReturnSyncStatus": "UNSYNCABLE",
"orderId": "xyz789",
"orderNumber": "abc123",
"orderDate": "2007-12-03T10:15:30Z",
"returnDate": "2007-12-03T10:15:30Z",
"isActive": true,
"unitQuantity": 987,
"returnValueAmount": Decimal,
"resolvedStatus": "RESOLVED",
"returnItemTypes": ["abc123"],
"returnTypeLabels": ["abc123"]
}
}
}
getReturnRule
Example
Query
query getReturnRule($ruleId: ID!) {
getReturnRule(ruleId: $ruleId) {
id
uuid
isActive
name
rule
description
when
conditions {
...ConditionFragment
}
action
actionOption
unit
value
message
warehouseName
warehouseId
destinationCountry
question
questionChoices
questionId
questionChoiceId
windowDays
}
}
Variables
{"ruleId": 4}
Response
{
"data": {
"getReturnRule": {
"id": 4,
"uuid": "abc123",
"isActive": true,
"name": "abc123",
"rule": "xyz789",
"description": "abc123",
"when": "AND",
"conditions": [Condition],
"action": "DENY_RETURN",
"actionOption": "ALL",
"unit": "SHOP_DEFAULT_CURRENCY",
"value": "xyz789",
"message": "abc123",
"warehouseName": "abc123",
"warehouseId": "4",
"destinationCountry": "xyz789",
"question": 4,
"questionChoices": [4],
"questionId": "4",
"questionChoiceId": 4,
"windowDays": 123
}
}
}
ledgerEntries
Description
Get ledger entries with Relay-style pagination
Response
Returns a LedgerConnection
Example
Query
query ledgerEntries(
$before: String,
$after: String,
$first: Int,
$last: Int
) {
ledgerEntries(
before: $before,
after: $after,
first: $first,
last: $last
) {
pageInfo {
...PageInfoFragment
}
edges {
...LedgerEdgeFragment
}
}
}
Variables
{
"before": "abc123",
"after": "abc123",
"first": 987,
"last": 987
}
Response
{
"data": {
"ledgerEntries": {
"pageInfo": PageInfo,
"edges": [LedgerEdge]
}
}
}
maintenanceMode
Response
Returns a Boolean
Example
Query
query maintenanceMode {
maintenanceMode
}
Response
{"data": {"maintenanceMode": true}}
packages
Response
Returns [PackageType]
Example
Query
query packages {
packages {
id
name
type
length
width
height
unit
weight
weightUnit
uuid
}
}
Response
{
"data": {
"packages": [
{
"id": "4",
"name": "abc123",
"type": "xyz789",
"length": 123.45,
"width": 123.45,
"height": 123.45,
"unit": "IN",
"weight": 123.45,
"weightUnit": "GRAMS",
"uuid": "4"
}
]
}
}
returnRules
Response
Returns [Rule]
Example
Query
query returnRules {
returnRules {
id
uuid
isActive
name
rule
description
when
conditions {
...ConditionFragment
}
action
actionOption
unit
value
message
warehouseName
warehouseId
destinationCountry
question
questionChoices
questionId
questionChoiceId
windowDays
}
}
Response
{
"data": {
"returnRules": [
{
"id": 4,
"uuid": "xyz789",
"isActive": false,
"name": "abc123",
"rule": "abc123",
"description": "xyz789",
"when": "AND",
"conditions": [Condition],
"action": "DENY_RETURN",
"actionOption": "ALL",
"unit": "SHOP_DEFAULT_CURRENCY",
"value": "xyz789",
"message": "abc123",
"warehouseName": "xyz789",
"warehouseId": "4",
"destinationCountry": "abc123",
"question": 4,
"questionChoices": [4],
"questionId": "4",
"questionChoiceId": "4",
"windowDays": 123
}
]
}
}
shippoCarrierServiceConfig
Response
Returns [ShippoCarrierServiceConfig]
Example
Query
query shippoCarrierServiceConfig {
shippoCarrierServiceConfig {
carrier
displayName
service
serviceDisplayName
width
height
unit
rotate
}
}
Response
{
"data": {
"shippoCarrierServiceConfig": [
{
"carrier": "xyz789",
"displayName": "xyz789",
"service": "abc123",
"serviceDisplayName": "abc123",
"width": Decimal,
"height": Decimal,
"unit": "IN",
"rotate": true
}
]
}
}
subscriptionPlans
Response
Returns [SubscriptionPlan]
Example
Query
query subscriptionPlans {
subscriptionPlans {
id
uuid
subscriptionType
tiered
name
features
exclusiveFeatures
featuresWouldBeLost
tiers {
...SubscriptionPlanTierTypeFragment
}
price
published
subscribeUrl
}
}
Response
{
"data": {
"subscriptionPlans": [
{
"id": 987,
"uuid": 4,
"subscriptionType": "FREE",
"tiered": false,
"name": "xyz789",
"features": ["ADJUST_RETURN_WINDOWS"],
"exclusiveFeatures": ["ADJUST_RETURN_WINDOWS"],
"featuresWouldBeLost": ["ADJUST_RETURN_WINDOWS"],
"tiers": [SubscriptionPlanTierType],
"price": Decimal,
"published": true,
"subscribeUrl": "abc123"
}
]
}
}
warehouses
Response
Returns [WarehouseType]
Example
Query
query warehouses {
warehouses {
id
name
address {
...AddressTypeFragment
}
}
}
Response
{
"data": {
"warehouses": [
{
"id": 4,
"name": "xyz789",
"address": AddressType
}
]
}
}
Mutations
acceptTos
Description
Accept the Terms of Service for prepaid balance system.
Example
Query
mutation acceptTos($version: String!) {
acceptTos(version: $version) {
shop {
...AuthenticatedShopFragment
}
balanceSettings {
...BalanceSettingsTypeFragment
}
errors {
...GQLErrorTypeFragment
}
}
}
Variables
{"version": "abc123"}
Response
{
"data": {
"acceptTos": {
"shop": AuthenticatedShop,
"balanceSettings": BalanceSettingsType,
"errors": [GQLErrorType]
}
}
}
addPaymentMethod
Description
Add a new payment method using a Stripe payment method ID.
Response
Returns an AddPaymentMethod
Arguments
| Name | Description |
|---|---|
stripePaymentMethodId - String!
|
Example
Query
mutation addPaymentMethod($stripePaymentMethodId: String!) {
addPaymentMethod(stripePaymentMethodId: $stripePaymentMethodId) {
paymentMethods {
...ShopPaymentMethodFragment
}
paymentMethod {
...ShopPaymentMethodFragment
}
success
message
errors {
...GQLErrorTypeFragment
}
}
}
Variables
{"stripePaymentMethodId": "abc123"}
Response
{
"data": {
"addPaymentMethod": {
"paymentMethods": [ShopPaymentMethod],
"paymentMethod": ShopPaymentMethod,
"success": true,
"message": "abc123",
"errors": [GQLErrorType]
}
}
}
archiveReturns
Use updateReturn or returnUpdateStatus mutations instead
Response
Returns an ArchiveReturns
Example
Query
mutation archiveReturns(
$archive: Boolean!,
$returnIds: [ID]!
) {
archiveReturns(
archive: $archive,
returnIds: $returnIds
) {
success
}
}
Variables
{"archive": true, "returnIds": ["4"]}
Response
{"data": {"archiveReturns": {"success": true}}}
completeOnboarding
Response
Returns a CompleteOnboarding
Example
Query
mutation completeOnboarding {
completeOnboarding {
success
shop {
...AuthenticatedShopFragment
}
}
}
Response
{
"data": {
"completeOnboarding": {
"success": false,
"shop": AuthenticatedShop
}
}
}
createSetupIntent
Description
Create a Stripe SetupIntent for linking payment method.
Response
Returns a CreateSetupIntent
Example
Query
mutation createSetupIntent {
createSetupIntent {
setupIntent {
...SetupIntentResponseTypeFragment
}
errors {
...GQLErrorTypeFragment
}
}
}
Response
{
"data": {
"createSetupIntent": {
"setupIntent": SetupIntentResponseType,
"errors": [GQLErrorType]
}
}
}
easyPostAccountUpdate
Response
Returns an EasyPostAccountMutation
Example
Query
mutation easyPostAccountUpdate(
$id: ID!,
$services: String!,
$useIsReturn: Boolean!
) {
easyPostAccountUpdate(
id: $id,
services: $services,
useIsReturn: $useIsReturn
) {
error
easyPostAccount {
...EasyPostAccountTypeFragment
}
}
}
Variables
{
"id": "4",
"services": "abc123",
"useIsReturn": false
}
Response
{
"data": {
"easyPostAccountUpdate": {
"error": "abc123",
"easyPostAccount": EasyPostAccountType
}
}
}
easyPostCarrierUpdate
Response
Returns an EasyPostCarrierMutation
Arguments
| Name | Description |
|---|---|
easyPostCarriers - [EasyPostCarrierUpdateType]!
|
Example
Query
mutation easyPostCarrierUpdate($easyPostCarriers: [EasyPostCarrierUpdateType]!) {
easyPostCarrierUpdate(easyPostCarriers: $easyPostCarriers) {
error
easyPostCarriers {
...EasyPostCarrierTypeFragment
}
}
}
Variables
{"easyPostCarriers": [EasyPostCarrierUpdateType]}
Response
{
"data": {
"easyPostCarrierUpdate": {
"error": "xyz789",
"easyPostCarriers": [EasyPostCarrierType]
}
}
}
exchangeOrderBulkComplete
Use releaseExchangeItems instead
Description
Complete a list of exchange orders in Shopify and update the exchange order status in RZ
Response
Returns a ReleaseExchangeItemsMutation
Example
Query
mutation exchangeOrderBulkComplete(
$exchangeItemIds: [ID!],
$exchangeOrderIds: [ID!],
$returnId: ID,
$returnItemIds: [ID!]
) {
exchangeOrderBulkComplete(
exchangeItemIds: $exchangeItemIds,
exchangeOrderIds: $exchangeOrderIds,
returnId: $returnId,
returnItemIds: $returnItemIds
) {
errors
exchangeOrders {
...ExchangeOrderFragment
}
exchangeItems {
...ExchangeItemFragment
}
return_ {
...ReturnFragment
}
}
}
Variables
{
"exchangeItemIds": ["4"],
"exchangeOrderIds": ["4"],
"returnId": "4",
"returnItemIds": ["4"]
}
Response
{
"data": {
"exchangeOrderBulkComplete": {
"errors": ["abc123"],
"exchangeOrders": [ExchangeOrder],
"exchangeItems": [ExchangeItem],
"return_": Return
}
}
}
generateUploadUrl
Response
Returns an GenerateUploadURL
Example
Query
mutation generateUploadUrl(
$contentType: String!,
$fileName: String!
) {
generateUploadUrl(
contentType: $contentType,
fileName: $fileName
) {
error
url {
...SignedUrlFragment
}
}
}
Variables
{
"contentType": "xyz789",
"fileName": "abc123"
}
Response
{
"data": {
"generateUploadUrl": {
"error": "xyz789",
"url": SignedUrl
}
}
}
loadBalance
Description
Load balance using a saved payment method.
Response
Returns a LoadBalance
Example
Query
mutation loadBalance(
$amount: Decimal!,
$paymentMethodId: ID!
) {
loadBalance(
amount: $amount,
paymentMethodId: $paymentMethodId
) {
success
message
ledgerEntryId
errors {
...GQLErrorTypeFragment
}
}
}
Variables
{"amount": Decimal, "paymentMethodId": 4}
Response
{
"data": {
"loadBalance": {
"success": true,
"message": "xyz789",
"ledgerEntryId": 4,
"errors": [GQLErrorType]
}
}
}
orderInvoiceSend
Response
Returns an OrderInvoiceSend
Example
Query
mutation orderInvoiceSend(
$exchangeOrderId: ID,
$returnId: ID
) {
orderInvoiceSend(
exchangeOrderId: $exchangeOrderId,
returnId: $returnId
) {
errors {
...GQLErrorTypeFragment
}
}
}
Variables
{"exchangeOrderId": null, "returnId": null}
Response
{"data": {"orderInvoiceSend": {"errors": [GQLErrorType]}}}
packageCreate
Response
Returns a PackageCreate
Arguments
| Name | Description |
|---|---|
package - PackageInput!
|
Example
Query
mutation packageCreate($package: PackageInput!) {
packageCreate(package: $package) {
package {
...PackageTypeFragment
}
}
}
Variables
{"package": PackageInput}
Response
{"data": {"packageCreate": {"package": PackageType}}}
packageDelete
Response
Returns a PackageDelete
Arguments
| Name | Description |
|---|---|
id - ID!
|
Example
Query
mutation packageDelete($id: ID!) {
packageDelete(id: $id) {
error
}
}
Variables
{"id": 4}
Response
{
"data": {
"packageDelete": {"error": "abc123"}
}
}
packageUpdate
Response
Returns a PackageUpdate
Arguments
| Name | Description |
|---|---|
package - PackageInput!
|
Example
Query
mutation packageUpdate($package: PackageInput!) {
packageUpdate(package: $package) {
error
package {
...PackageTypeFragment
}
}
}
Variables
{"package": PackageInput}
Response
{
"data": {
"packageUpdate": {
"error": "abc123",
"package": PackageType
}
}
}
questionCreate
Response
Returns a CreateOrUpdateQuestion
Arguments
| Name | Description |
|---|---|
question - QuestionInput!
|
Example
Query
mutation questionCreate($question: QuestionInput!) {
questionCreate(question: $question) {
question {
...QuestionFragment
}
}
}
Variables
{"question": QuestionInput}
Response
{"data": {"questionCreate": {"question": Question}}}
questionDelete
Response
Returns a DeleteQuestion
Arguments
| Name | Description |
|---|---|
questionId - ID!
|
Example
Query
mutation questionDelete($questionId: ID!) {
questionDelete(questionId: $questionId) {
success
}
}
Variables
{"questionId": 4}
Response
{"data": {"questionDelete": {"success": false}}}
questionUpdate
Response
Returns a CreateOrUpdateQuestion
Arguments
| Name | Description |
|---|---|
question - QuestionInput!
|
Example
Query
mutation questionUpdate($question: QuestionInput!) {
questionUpdate(question: $question) {
question {
...QuestionFragment
}
}
}
Variables
{"question": QuestionInput}
Response
{"data": {"questionUpdate": {"question": Question}}}
registerUser
Description
This mutation takes a session token from the frontend and uses it to retrieve more details about the user. Those details are then used to create or update the user's profile.
Response
Returns a RegisterUser
Arguments
| Name | Description |
|---|---|
sessionToken - String
|
The session token from createApp().getSessionToken() |
Example
Query
mutation registerUser($sessionToken: String) {
registerUser(sessionToken: $sessionToken) {
user {
...ShopifyUserFragment
}
}
}
Variables
{"sessionToken": "abc123"}
Response
{"data": {"registerUser": {"user": ShopifyUser}}}
releaseExchangeItems
Description
Release exchange items to be fulfilled.
Response
Returns a ReleaseExchangeItemsMutation
Example
Query
mutation releaseExchangeItems(
$exchangeItemIds: [ID!],
$exchangeOrderIds: [ID!],
$returnId: ID,
$returnItemIds: [ID!]
) {
releaseExchangeItems(
exchangeItemIds: $exchangeItemIds,
exchangeOrderIds: $exchangeOrderIds,
returnId: $returnId,
returnItemIds: $returnItemIds
) {
errors
exchangeOrders {
...ExchangeOrderFragment
}
exchangeItems {
...ExchangeItemFragment
}
return_ {
...ReturnFragment
}
}
}
Variables
{
"exchangeItemIds": ["4"],
"exchangeOrderIds": ["4"],
"returnId": 4,
"returnItemIds": ["4"]
}
Response
{
"data": {
"releaseExchangeItems": {
"errors": ["xyz789"],
"exchangeOrders": [ExchangeOrder],
"exchangeItems": [ExchangeItem],
"return_": Return
}
}
}
resendRmaForm
Response
Returns an ResendRMAForm
Arguments
| Name | Description |
|---|---|
returnId - ID!
|
Example
Query
mutation resendRmaForm($returnId: ID!) {
resendRmaForm(returnId: $returnId) {
error
}
}
Variables
{"returnId": 4}
Response
{
"data": {
"resendRmaForm": {"error": "xyz789"}
}
}
returnApprove
Response
Returns an ApproveReturn
Example
Query
mutation returnApprove(
$customRmaNumber: String,
$externalShippingLabelUrl: String,
$noShippingRequired: Boolean,
$returnId: ID!
) {
returnApprove(
customRmaNumber: $customRmaNumber,
externalShippingLabelUrl: $externalShippingLabelUrl,
noShippingRequired: $noShippingRequired,
returnId: $returnId
) {
error
errorText
return {
...ReturnFragment
}
}
}
Variables
{
"customRmaNumber": "abc123",
"externalShippingLabelUrl": "abc123",
"noShippingRequired": null,
"returnId": 4
}
Response
{
"data": {
"returnApprove": {
"error": "xyz789",
"errorText": "abc123",
"return": Return
}
}
}
returnCreateStoreCredit
Response
Returns a CreateReturnStoreCreditMutation
Example
Query
mutation returnCreateStoreCredit(
$amount: Decimal!,
$handlingFee: Decimal,
$refundShipping: Boolean!,
$restockingFee: Decimal,
$returnItemIds: [ID!]!
) {
returnCreateStoreCredit(
amount: $amount,
handlingFee: $handlingFee,
refundShipping: $refundShipping,
restockingFee: $restockingFee,
returnItemIds: $returnItemIds
) {
error
errorText
return {
...ReturnFragment
}
storeCredit {
...StoreCreditTypeFragment
}
}
}
Variables
{
"amount": Decimal,
"handlingFee": Decimal,
"refundShipping": false,
"restockingFee": Decimal,
"returnItemIds": [4]
}
Response
{
"data": {
"returnCreateStoreCredit": {
"error": "xyz789",
"errorText": "xyz789",
"return": Return,
"storeCredit": StoreCreditType
}
}
}
returnDispose
Description
Dispose a return items in Shopify. This will create disposition for each return item in Shopify. Used for restocking items and for marking items as missing in Return. This action is irreversible, once a return item is disposed it cannot be undone.
Response
Returns a DisposeReturn
Arguments
| Name | Description |
|---|---|
dispositionType - DispositionType!
|
|
returnId - ID!
|
|
returnItemIds - [ID!]!
|
|
shopifyLocationId - ID!
|
Example
Query
mutation returnDispose(
$dispositionType: DispositionType!,
$returnId: ID!,
$returnItemIds: [ID!]!,
$shopifyLocationId: ID!
) {
returnDispose(
dispositionType: $dispositionType,
returnId: $returnId,
returnItemIds: $returnItemIds,
shopifyLocationId: $shopifyLocationId
) {
error
return {
...ReturnFragment
}
}
}
Variables
{
"dispositionType": "MISSING",
"returnId": "4",
"returnItemIds": ["4"],
"shopifyLocationId": 4
}
Response
{
"data": {
"returnDispose": {
"error": "xyz789",
"return": Return
}
}
}
returnExport
Response
Returns a ReturnExport
Arguments
| Name | Description |
|---|---|
filters - FiltersInput
|
|
returnIds - [ID]!
|
If none, filters are used to resolve returns. |
Example
Query
mutation returnExport(
$filters: FiltersInput,
$returnIds: [ID]!
) {
returnExport(
filters: $filters,
returnIds: $returnIds
) {
success
url
}
}
Variables
{
"filters": FiltersInput,
"returnIds": ["4"]
}
Response
{
"data": {
"returnExport": {
"success": false,
"url": "abc123"
}
}
}
returnItemBulkDelete
Description
Delete multiple return items
Response
Returns a ReturnItemBulkDelete
Arguments
| Name | Description |
|---|---|
returnItemIds - [ID]!
|
Example
Query
mutation returnItemBulkDelete($returnItemIds: [ID]!) {
returnItemBulkDelete(returnItemIds: $returnItemIds) {
error
return {
...ReturnFragment
}
}
}
Variables
{"returnItemIds": [4]}
Response
{
"data": {
"returnItemBulkDelete": {
"error": "abc123",
"return": Return
}
}
}
returnItemBulkUpdate
Description
Update multiple return items at once
Response
Returns a ReturnItemBulkUpdate
Arguments
| Name | Description |
|---|---|
returnItemIds - [ID]!
|
|
updateField - ReturnItemBulkUpdateInput!
|
Example
Query
mutation returnItemBulkUpdate(
$returnItemIds: [ID]!,
$updateField: ReturnItemBulkUpdateInput!
) {
returnItemBulkUpdate(
returnItemIds: $returnItemIds,
updateField: $updateField
) {
error
return {
...ReturnFragment
}
}
}
Variables
{
"returnItemIds": ["4"],
"updateField": ReturnItemBulkUpdateInput
}
Response
{
"data": {
"returnItemBulkUpdate": {
"error": "xyz789",
"return": Return
}
}
}
returnItemDelete
Response
Returns a ReturnItemDelete
Arguments
| Name | Description |
|---|---|
id - ID!
|
Example
Query
mutation returnItemDelete($id: ID!) {
returnItemDelete(id: $id) {
error
return {
...ReturnFragment
}
}
}
Variables
{"id": 4}
Response
{
"data": {
"returnItemDelete": {
"error": "abc123",
"return": Return
}
}
}
returnItemManuallyResolveUpdate
Description
Used to update the line items of return isResolved field to true or false
Response
Returns an UpdateResolveReturnItems
Arguments
| Name | Description |
|---|---|
handlingFee - Decimal
|
Handling fee charged for the return |
isResolved - Boolean!
|
Resolved or not, this applies to all the return items |
restockingFee - Decimal
|
Restocking fee charged for the return |
returnId - ID!
|
|
returnItemIds - [ID]!
|
List of return items that should be updated |
Example
Query
mutation returnItemManuallyResolveUpdate(
$handlingFee: Decimal,
$isResolved: Boolean!,
$restockingFee: Decimal,
$returnId: ID!,
$returnItemIds: [ID]!
) {
returnItemManuallyResolveUpdate(
handlingFee: $handlingFee,
isResolved: $isResolved,
restockingFee: $restockingFee,
returnId: $returnId,
returnItemIds: $returnItemIds
) {
error
return {
...ReturnFragment
}
}
}
Variables
{
"handlingFee": Decimal,
"isResolved": false,
"restockingFee": Decimal,
"returnId": 4,
"returnItemIds": [4]
}
Response
{
"data": {
"returnItemManuallyResolveUpdate": {
"error": "abc123",
"return": Return
}
}
}
returnItemMissingUpdate
Description
Used to update the line items of return isMissing field to true or false
Response
Returns an UpdateMissingReturnItems
Example
Query
mutation returnItemMissingUpdate(
$isMissing: Boolean!,
$returnId: ID!,
$returnItemIds: [ID]!
) {
returnItemMissingUpdate(
isMissing: $isMissing,
returnId: $returnId,
returnItemIds: $returnItemIds
) {
error
return {
...ReturnFragment
}
}
}
Variables
{
"isMissing": false,
"returnId": "4",
"returnItemIds": ["4"]
}
Response
{
"data": {
"returnItemMissingUpdate": {
"error": "xyz789",
"return": Return
}
}
}
returnItemUpdate
Response
Returns a ReturnItemUpdate
Arguments
| Name | Description |
|---|---|
id - ID!
|
|
item - ReturnItemUpdateInput!
|
Example
Query
mutation returnItemUpdate(
$id: ID!,
$item: ReturnItemUpdateInput!
) {
returnItemUpdate(
id: $id,
item: $item
) {
error
return {
...ReturnFragment
}
}
}
Variables
{"id": 4, "item": ReturnItemUpdateInput}
Response
{
"data": {
"returnItemUpdate": {
"error": "xyz789",
"return": Return
}
}
}
returnItemUpdateSkipRestock
Response
Returns a ReturnItemUpdateSkipRestock
Example
Query
mutation returnItemUpdateSkipRestock(
$returnItemIds: [ID]!,
$skipRestock: Boolean!
) {
returnItemUpdateSkipRestock(
returnItemIds: $returnItemIds,
skipRestock: $skipRestock
) {
error
return {
...ReturnFragment
}
}
}
Variables
{"returnItemIds": [4], "skipRestock": true}
Response
{
"data": {
"returnItemUpdateSkipRestock": {
"error": "xyz789",
"return": Return
}
}
}
returnLogUpdate
Response
Returns a ReturnLogUpdate
Example
Query
mutation returnLogUpdate(
$comment: String,
$logId: ID,
$returnId: ID!
) {
returnLogUpdate(
comment: $comment,
logId: $logId,
returnId: $returnId
) {
error
return {
...ReturnFragment
}
}
}
Variables
{
"comment": "abc123",
"logId": "4",
"returnId": "4"
}
Response
{
"data": {
"returnLogUpdate": {
"error": "abc123",
"return": Return
}
}
}
returnReceived
Description
Update the return stage to Received. Also, marks missing line items as missing.
Response
Returns a ReceivedReturn
Example
Query
mutation returnReceived(
$missingReturnItemIds: [ID],
$resolvedReturnItemIds: [ID],
$returnId: ID!
) {
returnReceived(
missingReturnItemIds: $missingReturnItemIds,
resolvedReturnItemIds: $resolvedReturnItemIds,
returnId: $returnId
) {
error
return {
...ReturnFragment
}
}
}
Variables
{
"missingReturnItemIds": ["4"],
"resolvedReturnItemIds": [4],
"returnId": 4
}
Response
{
"data": {
"returnReceived": {
"error": "abc123",
"return": Return
}
}
}
returnRefund
Response
Returns a RefundReturn
Example
Query
mutation returnRefund(
$handlingFee: Decimal,
$notifyCustomer: Boolean!,
$refundCurrency: String!,
$refundFullAmount: Decimal!,
$refundShipping: Boolean!,
$restockingFee: Decimal,
$returnId: ID!,
$returnItemIds: [ID!]!
) {
returnRefund(
handlingFee: $handlingFee,
notifyCustomer: $notifyCustomer,
refundCurrency: $refundCurrency,
refundFullAmount: $refundFullAmount,
refundShipping: $refundShipping,
restockingFee: $restockingFee,
returnId: $returnId,
returnItemIds: $returnItemIds
) {
error
return {
...ReturnFragment
}
refund {
...RefundTypeFragment
}
}
}
Variables
{
"handlingFee": Decimal,
"notifyCustomer": true,
"refundCurrency": "abc123",
"refundFullAmount": Decimal,
"refundShipping": true,
"restockingFee": Decimal,
"returnId": 4,
"returnItemIds": [4]
}
Response
{
"data": {
"returnRefund": {
"error": "xyz789",
"return": Return,
"refund": RefundType
}
}
}
returnReject
Response
Returns a RejectReturn
Arguments
| Name | Description |
|---|---|
returnId - ID!
|
Example
Query
mutation returnReject($returnId: ID!) {
returnReject(returnId: $returnId) {
error
return {
...ReturnFragment
}
}
}
Variables
{"returnId": "4"}
Response
{
"data": {
"returnReject": {
"error": "xyz789",
"return": Return
}
}
}
returnRuleActiveToggle
Response
Returns a ReturnRuleActiveToggle
Arguments
| Name | Description |
|---|---|
id - ID!
|
Example
Query
mutation returnRuleActiveToggle($id: ID!) {
returnRuleActiveToggle(id: $id) {
error
}
}
Variables
{"id": "4"}
Response
{
"data": {
"returnRuleActiveToggle": {
"error": "xyz789"
}
}
}
returnRuleCreate
Response
Returns a ReturnRuleCreateOrUpdate
Arguments
| Name | Description |
|---|---|
returnRule - RuleInput!
|
Example
Query
mutation returnRuleCreate($returnRule: RuleInput!) {
returnRuleCreate(returnRule: $returnRule) {
error
returnRule {
...RuleFragment
}
}
}
Variables
{"returnRule": RuleInput}
Response
{
"data": {
"returnRuleCreate": {
"error": "abc123",
"returnRule": Rule
}
}
}
returnRuleDelete
Response
Returns a ReturnRuleDelete
Arguments
| Name | Description |
|---|---|
id - ID!
|
Example
Query
mutation returnRuleDelete($id: ID!) {
returnRuleDelete(id: $id) {
error
}
}
Variables
{"id": "4"}
Response
{
"data": {
"returnRuleDelete": {"error": "xyz789"}
}
}
returnRuleUpdate
Response
Returns a ReturnRuleCreateOrUpdate
Arguments
| Name | Description |
|---|---|
returnRule - RuleInput!
|
Example
Query
mutation returnRuleUpdate($returnRule: RuleInput!) {
returnRuleUpdate(returnRule: $returnRule) {
error
returnRule {
...RuleFragment
}
}
}
Variables
{"returnRule": RuleInput}
Response
{
"data": {
"returnRuleUpdate": {
"error": "abc123",
"returnRule": Rule
}
}
}
returnTransitionStage
Response
Returns a ReturnTransitionStage
Arguments
| Name | Description |
|---|---|
filters - FiltersInput
|
|
returnIds - [ID]!
|
If none, filters are used to resolve returns. |
stageId - ID!
|
Example
Query
mutation returnTransitionStage(
$filters: FiltersInput,
$returnIds: [ID]!,
$stageId: ID!
) {
returnTransitionStage(
filters: $filters,
returnIds: $returnIds,
stageId: $stageId
) {
success
affectedReturnIds
}
}
Variables
{
"filters": FiltersInput,
"returnIds": ["4"],
"stageId": "4"
}
Response
{
"data": {
"returnTransitionStage": {"success": false, "affectedReturnIds": [987]}
}
}
returnUpdateStatus
Response
Returns a ReturnUpdateStatus
Arguments
| Name | Description |
|---|---|
filters - FiltersInput
|
|
isArchived - Boolean!
|
|
returnIds - [ID]!
|
If none, filters are used to resolve returns. |
Example
Query
mutation returnUpdateStatus(
$filters: FiltersInput,
$isArchived: Boolean!,
$returnIds: [ID]!
) {
returnUpdateStatus(
filters: $filters,
isArchived: $isArchived,
returnIds: $returnIds
) {
success
affectedReturnIds
}
}
Variables
{
"filters": FiltersInput,
"isArchived": true,
"returnIds": [4]
}
Response
{"data": {"returnUpdateStatus": {"success": true, "affectedReturnIds": [987]}}}
returnsDelete
Response
Returns a DeleteReturns
Arguments
| Name | Description |
|---|---|
returnIds - [ID]!
|
Example
Query
mutation returnsDelete($returnIds: [ID]!) {
returnsDelete(returnIds: $returnIds) {
success
}
}
Variables
{"returnIds": ["4"]}
Response
{"data": {"returnsDelete": {"success": false}}}
returnsDeleteTestMode
Response
Returns a ReturnsDeleteTestMode
Example
Query
mutation returnsDeleteTestMode {
returnsDeleteTestMode {
success
shop {
...AuthenticatedShopFragment
}
}
}
Response
{
"data": {
"returnsDeleteTestMode": {
"success": true,
"shop": AuthenticatedShop
}
}
}
shippoAccountUpdate
Response
Returns a ShippoAccountMutation
Example
Query
mutation shippoAccountUpdate(
$services: String!,
$useIsReturn: Boolean!
) {
shippoAccountUpdate(
services: $services,
useIsReturn: $useIsReturn
) {
error
account {
...ShippoAccountTypeFragment
}
}
}
Variables
{"services": "xyz789", "useIsReturn": true}
Response
{
"data": {
"shippoAccountUpdate": {
"error": "abc123",
"account": ShippoAccountType
}
}
}
shippoCarrierUpdate
Response
Returns a ShippoAccountCarrierMutation
Arguments
| Name | Description |
|---|---|
carriers - [ShippoCarrierUpdateType]!
|
Example
Query
mutation shippoCarrierUpdate($carriers: [ShippoCarrierUpdateType]!) {
shippoCarrierUpdate(carriers: $carriers) {
error
carriers {
...ShippoAccountCarrierTypeFragment
}
}
}
Variables
{"carriers": [ShippoCarrierUpdateType]}
Response
{
"data": {
"shippoCarrierUpdate": {
"error": "abc123",
"carriers": [ShippoAccountCarrierType]
}
}
}
taxNumbersDelete
Response
Returns a DeleteTaxNumbers
Arguments
| Name | Description |
|---|---|
ids - [ID]!
|
Example
Query
mutation taxNumbersDelete($ids: [ID]!) {
taxNumbersDelete(ids: $ids) {
errors {
...GQLErrorTypeFragment
}
}
}
Variables
{"ids": [4]}
Response
{"data": {"taxNumbersDelete": {"errors": [GQLErrorType]}}}
taxNumbersPut
Response
Returns a PutTaxNumbers
Arguments
| Name | Description |
|---|---|
taxNumbers - [TaxNumberInput]!
|
Example
Query
mutation taxNumbersPut($taxNumbers: [TaxNumberInput]!) {
taxNumbersPut(taxNumbers: $taxNumbers) {
errors {
...GQLErrorTypeFragment
}
taxNumbers {
...TaxNumberOutputFragment
}
}
}
Variables
{"taxNumbers": [TaxNumberInput]}
Response
{
"data": {
"taxNumbersPut": {
"errors": [GQLErrorType],
"taxNumbers": [TaxNumberOutput]
}
}
}
updateBalanceSettings
Description
Update balance settings including auto-recharge configuration.
Response
Returns an UpdateBalanceSettings
Example
Query
mutation updateBalanceSettings(
$autoRechargeAmount: Decimal,
$autoRechargeEnabled: Boolean,
$autoRechargeThreshold: Decimal,
$currency: String
) {
updateBalanceSettings(
autoRechargeAmount: $autoRechargeAmount,
autoRechargeEnabled: $autoRechargeEnabled,
autoRechargeThreshold: $autoRechargeThreshold,
currency: $currency
) {
balanceSettings {
...BalanceSettingsTypeFragment
}
errors {
...GQLErrorTypeFragment
}
}
}
Variables
{
"autoRechargeAmount": Decimal,
"autoRechargeEnabled": false,
"autoRechargeThreshold": Decimal,
"currency": "xyz789"
}
Response
{
"data": {
"updateBalanceSettings": {
"balanceSettings": BalanceSettingsType,
"errors": [GQLErrorType]
}
}
}
updatePaymentMethod
Description
Set a payment method as the default for the shop.
Response
Returns an UpdatePaymentMethod
Example
Query
mutation updatePaymentMethod(
$delete: Boolean!,
$isDefault: Boolean!,
$paymentMethodId: ID!
) {
updatePaymentMethod(
delete: $delete,
isDefault: $isDefault,
paymentMethodId: $paymentMethodId
) {
paymentMethod {
...ShopPaymentMethodFragment
}
success
errors {
...GQLErrorTypeFragment
}
}
}
Variables
{
"delete": true,
"isDefault": false,
"paymentMethodId": "4"
}
Response
{
"data": {
"updatePaymentMethod": {
"paymentMethod": ShopPaymentMethod,
"success": true,
"errors": [GQLErrorType]
}
}
}
updateReturn
Response
Returns an UpdateReturn
Example
Query
mutation updateReturn(
$isArchived: Boolean!,
$returnId: Int!,
$stageId: ID!
) {
updateReturn(
isArchived: $isArchived,
returnId: $returnId,
stageId: $stageId
) {
success
ret {
...ReturnFragment
}
}
}
Variables
{"isArchived": true, "returnId": 123, "stageId": 4}
Response
{
"data": {
"updateReturn": {"success": true, "ret": Return}
}
}
updateSettings
Response
Returns an UpdateSettings
Arguments
| Name | Description |
|---|---|
allowOutOfStockExchanges - Boolean
|
Allow exchanges for out of stock products |
autoProcessExchangesOnCreation - Boolean
|
Automatically process and reserve exchange items from stock when return is created |
automatedStoreCreditType - AutomatedStoreCreditType
|
|
barcodeValue - BarcodeValue
|
|
carryDiscountForwardType - CarryDiscountForwardType
|
|
cartonizationLengthUnit - LengthUnit
|
|
creditPortalDisplayOrder - Int
|
|
customerEmailContent - String
|
|
customerEmailDisplayFromName - String
|
|
customerEmailReplyToAddress - String
|
|
defaultAddress - AddressInput
|
|
defaultExchangeFee - Decimal
|
|
defaultRefundFee - Decimal
|
|
defaultStoreCreditFee - Decimal
|
|
defaultWarehouseForPosReturns - ID
|
|
defaultWeight - Decimal
|
|
defaultWeightUnit - String
|
|
delayedShopifyReturnCreationEnabled - Boolean
|
|
discountSameProductExchangesToBeEqual - Boolean
|
|
dynamicTranslations - [DynamicTranslationInput]
|
|
easypostApiKey - String
|
|
enableCustomRmaNumber - Boolean
|
|
enableExchange - Boolean
|
|
enableRefund - Boolean
|
|
enableStoreCredit - Boolean
|
|
exchangeCommentsEnabled - Boolean
|
|
exchangeCommentsRequired - Boolean
|
|
exchangeDays - Int
|
|
exchangeDaysToReserveStock - Int
|
Number of days to reserve stock for exchange |
exchangeDaysType - DaysType
|
|
exchangeExcludeTags - [String]
|
|
exchangeMethod - ExchangeMethod
|
|
exchangePortalDisplayOrder - Int
|
|
exchangeRoundToZeroIfLteTo - Decimal
|
|
exchangeSamePriceOnly - Boolean
|
Only show product variants with the same price as the original product |
exchangeShipmentOrderSuffix - String
|
|
exchangeUpsellDiscountPercentage - Decimal
|
|
exchangeUpsellEnabled - Boolean
|
|
gorgiasSubdomain - String
|
|
instructions - String
|
|
international - Boolean
|
|
internationalCustomsSigner - String
|
|
internationalDefaultHarmonizedSystemCode - String
|
|
internationalExemptionCode - String
|
|
internationalNonDeliveryOption - String
|
|
internationalOriginCountry - String
|
|
isCartonizationEnabled - Boolean
|
|
isDefaultFeeEqualsShippingCost - Boolean
|
|
isExchangeDifferentialPricingEnabled - Boolean
|
Enable exchange differential pricing. |
isExchangeIntegrationEnabled - Boolean
|
Integration with Shopify Exchange |
isFullCatalogExchangeEnabled - Boolean
|
Enable full catalog exchange |
isInlineExchangeEnabled - Boolean
|
Enable inline exchange on the portal |
isNoShippingReturnEnabled - Boolean
|
|
isQrCodeEnabled - Boolean
|
|
isRefundIntegrationEnabled - Boolean
|
Integration with Shopify Refund |
isRestockIntegrationEnabled - Boolean
|
Integration with Shopify Restock |
isReturnItemExpirationEnabled - Boolean
|
|
isShippingLabelUploadAllowed - Boolean
|
|
isStoreCreditIncentiveEnabled - Boolean
|
|
isStoreCreditIncentiveRoundToNearest - Boolean
|
|
isStoreCreditIntegrationEnabled - Boolean
|
Integration with Shopify Store Credit |
klaviyoApiKey - String
|
|
maxStoreCreditIncentiveAmount - Decimal
|
|
minStoreCreditIncentiveAmount - Decimal
|
|
notificationEmailAddress - String
|
|
notificationEmailAttachRma - Boolean
|
|
notifications - [NotificationInput]
|
|
onboardingComplete - Boolean
|
|
paidShippingFee - Decimal
|
|
portalCustomizations - JSONString
|
|
portalExchangeSelectionMethod - PortalExchangeSelectionMethod
|
|
portalFrenchUseAlternative - Boolean
|
|
portalGermanUseAlternative - Boolean
|
|
portalItalianUseAlternative - Boolean
|
|
portalLanguage - String
|
|
portalTheme - String
|
|
portalVisualExchangeExcludeCollections - [String]
|
|
portalVisualExchangeIncludeCollections - [String]
|
|
portalVisualExchangeType - PortalVisualExchangeType
|
|
prepaidShippingFee - Decimal
|
|
primaryFieldBehavior - PrimaryFieldBehavior
|
|
questions - [QuestionInput]
|
|
refField1Source - RefFieldSource
|
|
refField2Source - RefFieldSource
|
|
refundCommentsEnabled - Boolean
|
|
refundCommentsRequired - Boolean
|
|
refundDays - Int
|
|
refundDaysType - DaysType
|
|
refundPortalDisplayOrder - Int
|
|
requireApprovalForAllReturns - Boolean
|
|
resolvePartialExchangeRefundsToStoreCredit - Boolean
|
|
restockingFeeDefinedAsPercentage - Boolean
|
|
restockingFeeType - RestockingFeeType
|
|
returnItemExpirationDays - Int
|
|
returnReasons - [ReturnReasonInput]
|
|
secondaryFieldBehavior - SecondaryFieldBehavior
|
|
selfShippingFee - Decimal
|
|
shipFree - Boolean
|
|
shipPay - Boolean
|
|
shipSelf - Boolean
|
|
shippingRateSelectLowestRate - Boolean
|
|
shippingRateShowUpToPercentage - Decimal
|
|
shippoApiKey - String
|
|
shouldDisplayFeesInPortal - Boolean
|
|
showPortalSummary - Boolean
|
|
stageShipmentStatuses - [StageShipmentStatusInput]
|
|
stages - [StageInput]
|
|
storeCreditCommentsEnabled - Boolean
|
|
storeCreditCommentsRequired - Boolean
|
|
storeCreditDays - Int
|
|
storeCreditDaysType - DaysType
|
|
storeCreditIncentivePercentage - Float
|
|
storeCreditIncentiveType - StoreCreditIncentiveType
|
|
stripePublishableKey - String
|
|
stripeSecretKey - String
|
|
useApprovals - Boolean
|
|
useConsolidatedOrderExchanges - Boolean
|
|
useExchangeShipmentOrders - Boolean
|
|
useShopAddressForPosReturns - Boolean
|
|
webhookEvents - [WebhookEventType]
|
|
webhookUrl - String
|
Example
Query
mutation updateSettings(
$allowOutOfStockExchanges: Boolean,
$autoProcessExchangesOnCreation: Boolean,
$automatedStoreCreditType: AutomatedStoreCreditType,
$barcodeValue: BarcodeValue,
$carryDiscountForwardType: CarryDiscountForwardType,
$cartonizationLengthUnit: LengthUnit,
$creditPortalDisplayOrder: Int,
$customerEmailContent: String,
$customerEmailDisplayFromName: String,
$customerEmailReplyToAddress: String,
$defaultAddress: AddressInput,
$defaultExchangeFee: Decimal,
$defaultRefundFee: Decimal,
$defaultStoreCreditFee: Decimal,
$defaultWarehouseForPosReturns: ID,
$defaultWeight: Decimal,
$defaultWeightUnit: String,
$delayedShopifyReturnCreationEnabled: Boolean,
$discountSameProductExchangesToBeEqual: Boolean,
$dynamicTranslations: [DynamicTranslationInput],
$easypostApiKey: String,
$enableCustomRmaNumber: Boolean,
$enableExchange: Boolean,
$enableRefund: Boolean,
$enableStoreCredit: Boolean,
$exchangeCommentsEnabled: Boolean,
$exchangeCommentsRequired: Boolean,
$exchangeDays: Int,
$exchangeDaysToReserveStock: Int,
$exchangeDaysType: DaysType,
$exchangeExcludeTags: [String],
$exchangeMethod: ExchangeMethod,
$exchangePortalDisplayOrder: Int,
$exchangeRoundToZeroIfLteTo: Decimal,
$exchangeSamePriceOnly: Boolean,
$exchangeShipmentOrderSuffix: String,
$exchangeUpsellDiscountPercentage: Decimal,
$exchangeUpsellEnabled: Boolean,
$gorgiasSubdomain: String,
$instructions: String,
$international: Boolean,
$internationalCustomsSigner: String,
$internationalDefaultHarmonizedSystemCode: String,
$internationalExemptionCode: String,
$internationalNonDeliveryOption: String,
$internationalOriginCountry: String,
$isCartonizationEnabled: Boolean,
$isDefaultFeeEqualsShippingCost: Boolean,
$isExchangeDifferentialPricingEnabled: Boolean,
$isExchangeIntegrationEnabled: Boolean,
$isFullCatalogExchangeEnabled: Boolean,
$isInlineExchangeEnabled: Boolean,
$isNoShippingReturnEnabled: Boolean,
$isQrCodeEnabled: Boolean,
$isRefundIntegrationEnabled: Boolean,
$isRestockIntegrationEnabled: Boolean,
$isReturnItemExpirationEnabled: Boolean,
$isShippingLabelUploadAllowed: Boolean,
$isStoreCreditIncentiveEnabled: Boolean,
$isStoreCreditIncentiveRoundToNearest: Boolean,
$isStoreCreditIntegrationEnabled: Boolean,
$klaviyoApiKey: String,
$maxStoreCreditIncentiveAmount: Decimal,
$minStoreCreditIncentiveAmount: Decimal,
$notificationEmailAddress: String,
$notificationEmailAttachRma: Boolean,
$notifications: [NotificationInput],
$onboardingComplete: Boolean,
$paidShippingFee: Decimal,
$portalCustomizations: JSONString,
$portalExchangeSelectionMethod: PortalExchangeSelectionMethod,
$portalFrenchUseAlternative: Boolean,
$portalGermanUseAlternative: Boolean,
$portalItalianUseAlternative: Boolean,
$portalLanguage: String,
$portalTheme: String,
$portalVisualExchangeExcludeCollections: [String],
$portalVisualExchangeIncludeCollections: [String],
$portalVisualExchangeType: PortalVisualExchangeType,
$prepaidShippingFee: Decimal,
$primaryFieldBehavior: PrimaryFieldBehavior,
$questions: [QuestionInput],
$refField1Source: RefFieldSource,
$refField2Source: RefFieldSource,
$refundCommentsEnabled: Boolean,
$refundCommentsRequired: Boolean,
$refundDays: Int,
$refundDaysType: DaysType,
$refundPortalDisplayOrder: Int,
$requireApprovalForAllReturns: Boolean,
$resolvePartialExchangeRefundsToStoreCredit: Boolean,
$restockingFeeDefinedAsPercentage: Boolean,
$restockingFeeType: RestockingFeeType,
$returnItemExpirationDays: Int,
$returnReasons: [ReturnReasonInput],
$secondaryFieldBehavior: SecondaryFieldBehavior,
$selfShippingFee: Decimal,
$shipFree: Boolean,
$shipPay: Boolean,
$shipSelf: Boolean,
$shippingRateSelectLowestRate: Boolean,
$shippingRateShowUpToPercentage: Decimal,
$shippoApiKey: String,
$shouldDisplayFeesInPortal: Boolean,
$showPortalSummary: Boolean,
$stageShipmentStatuses: [StageShipmentStatusInput],
$stages: [StageInput],
$storeCreditCommentsEnabled: Boolean,
$storeCreditCommentsRequired: Boolean,
$storeCreditDays: Int,
$storeCreditDaysType: DaysType,
$storeCreditIncentivePercentage: Float,
$storeCreditIncentiveType: StoreCreditIncentiveType,
$stripePublishableKey: String,
$stripeSecretKey: String,
$useApprovals: Boolean,
$useConsolidatedOrderExchanges: Boolean,
$useExchangeShipmentOrders: Boolean,
$useShopAddressForPosReturns: Boolean,
$webhookEvents: [WebhookEventType],
$webhookUrl: String
) {
updateSettings(
allowOutOfStockExchanges: $allowOutOfStockExchanges,
autoProcessExchangesOnCreation: $autoProcessExchangesOnCreation,
automatedStoreCreditType: $automatedStoreCreditType,
barcodeValue: $barcodeValue,
carryDiscountForwardType: $carryDiscountForwardType,
cartonizationLengthUnit: $cartonizationLengthUnit,
creditPortalDisplayOrder: $creditPortalDisplayOrder,
customerEmailContent: $customerEmailContent,
customerEmailDisplayFromName: $customerEmailDisplayFromName,
customerEmailReplyToAddress: $customerEmailReplyToAddress,
defaultAddress: $defaultAddress,
defaultExchangeFee: $defaultExchangeFee,
defaultRefundFee: $defaultRefundFee,
defaultStoreCreditFee: $defaultStoreCreditFee,
defaultWarehouseForPosReturns: $defaultWarehouseForPosReturns,
defaultWeight: $defaultWeight,
defaultWeightUnit: $defaultWeightUnit,
delayedShopifyReturnCreationEnabled: $delayedShopifyReturnCreationEnabled,
discountSameProductExchangesToBeEqual: $discountSameProductExchangesToBeEqual,
dynamicTranslations: $dynamicTranslations,
easypostApiKey: $easypostApiKey,
enableCustomRmaNumber: $enableCustomRmaNumber,
enableExchange: $enableExchange,
enableRefund: $enableRefund,
enableStoreCredit: $enableStoreCredit,
exchangeCommentsEnabled: $exchangeCommentsEnabled,
exchangeCommentsRequired: $exchangeCommentsRequired,
exchangeDays: $exchangeDays,
exchangeDaysToReserveStock: $exchangeDaysToReserveStock,
exchangeDaysType: $exchangeDaysType,
exchangeExcludeTags: $exchangeExcludeTags,
exchangeMethod: $exchangeMethod,
exchangePortalDisplayOrder: $exchangePortalDisplayOrder,
exchangeRoundToZeroIfLteTo: $exchangeRoundToZeroIfLteTo,
exchangeSamePriceOnly: $exchangeSamePriceOnly,
exchangeShipmentOrderSuffix: $exchangeShipmentOrderSuffix,
exchangeUpsellDiscountPercentage: $exchangeUpsellDiscountPercentage,
exchangeUpsellEnabled: $exchangeUpsellEnabled,
gorgiasSubdomain: $gorgiasSubdomain,
instructions: $instructions,
international: $international,
internationalCustomsSigner: $internationalCustomsSigner,
internationalDefaultHarmonizedSystemCode: $internationalDefaultHarmonizedSystemCode,
internationalExemptionCode: $internationalExemptionCode,
internationalNonDeliveryOption: $internationalNonDeliveryOption,
internationalOriginCountry: $internationalOriginCountry,
isCartonizationEnabled: $isCartonizationEnabled,
isDefaultFeeEqualsShippingCost: $isDefaultFeeEqualsShippingCost,
isExchangeDifferentialPricingEnabled: $isExchangeDifferentialPricingEnabled,
isExchangeIntegrationEnabled: $isExchangeIntegrationEnabled,
isFullCatalogExchangeEnabled: $isFullCatalogExchangeEnabled,
isInlineExchangeEnabled: $isInlineExchangeEnabled,
isNoShippingReturnEnabled: $isNoShippingReturnEnabled,
isQrCodeEnabled: $isQrCodeEnabled,
isRefundIntegrationEnabled: $isRefundIntegrationEnabled,
isRestockIntegrationEnabled: $isRestockIntegrationEnabled,
isReturnItemExpirationEnabled: $isReturnItemExpirationEnabled,
isShippingLabelUploadAllowed: $isShippingLabelUploadAllowed,
isStoreCreditIncentiveEnabled: $isStoreCreditIncentiveEnabled,
isStoreCreditIncentiveRoundToNearest: $isStoreCreditIncentiveRoundToNearest,
isStoreCreditIntegrationEnabled: $isStoreCreditIntegrationEnabled,
klaviyoApiKey: $klaviyoApiKey,
maxStoreCreditIncentiveAmount: $maxStoreCreditIncentiveAmount,
minStoreCreditIncentiveAmount: $minStoreCreditIncentiveAmount,
notificationEmailAddress: $notificationEmailAddress,
notificationEmailAttachRma: $notificationEmailAttachRma,
notifications: $notifications,
onboardingComplete: $onboardingComplete,
paidShippingFee: $paidShippingFee,
portalCustomizations: $portalCustomizations,
portalExchangeSelectionMethod: $portalExchangeSelectionMethod,
portalFrenchUseAlternative: $portalFrenchUseAlternative,
portalGermanUseAlternative: $portalGermanUseAlternative,
portalItalianUseAlternative: $portalItalianUseAlternative,
portalLanguage: $portalLanguage,
portalTheme: $portalTheme,
portalVisualExchangeExcludeCollections: $portalVisualExchangeExcludeCollections,
portalVisualExchangeIncludeCollections: $portalVisualExchangeIncludeCollections,
portalVisualExchangeType: $portalVisualExchangeType,
prepaidShippingFee: $prepaidShippingFee,
primaryFieldBehavior: $primaryFieldBehavior,
questions: $questions,
refField1Source: $refField1Source,
refField2Source: $refField2Source,
refundCommentsEnabled: $refundCommentsEnabled,
refundCommentsRequired: $refundCommentsRequired,
refundDays: $refundDays,
refundDaysType: $refundDaysType,
refundPortalDisplayOrder: $refundPortalDisplayOrder,
requireApprovalForAllReturns: $requireApprovalForAllReturns,
resolvePartialExchangeRefundsToStoreCredit: $resolvePartialExchangeRefundsToStoreCredit,
restockingFeeDefinedAsPercentage: $restockingFeeDefinedAsPercentage,
restockingFeeType: $restockingFeeType,
returnItemExpirationDays: $returnItemExpirationDays,
returnReasons: $returnReasons,
secondaryFieldBehavior: $secondaryFieldBehavior,
selfShippingFee: $selfShippingFee,
shipFree: $shipFree,
shipPay: $shipPay,
shipSelf: $shipSelf,
shippingRateSelectLowestRate: $shippingRateSelectLowestRate,
shippingRateShowUpToPercentage: $shippingRateShowUpToPercentage,
shippoApiKey: $shippoApiKey,
shouldDisplayFeesInPortal: $shouldDisplayFeesInPortal,
showPortalSummary: $showPortalSummary,
stageShipmentStatuses: $stageShipmentStatuses,
stages: $stages,
storeCreditCommentsEnabled: $storeCreditCommentsEnabled,
storeCreditCommentsRequired: $storeCreditCommentsRequired,
storeCreditDays: $storeCreditDays,
storeCreditDaysType: $storeCreditDaysType,
storeCreditIncentivePercentage: $storeCreditIncentivePercentage,
storeCreditIncentiveType: $storeCreditIncentiveType,
stripePublishableKey: $stripePublishableKey,
stripeSecretKey: $stripeSecretKey,
useApprovals: $useApprovals,
useConsolidatedOrderExchanges: $useConsolidatedOrderExchanges,
useExchangeShipmentOrders: $useExchangeShipmentOrders,
useShopAddressForPosReturns: $useShopAddressForPosReturns,
webhookEvents: $webhookEvents,
webhookUrl: $webhookUrl
) {
success
error
shop {
...AuthenticatedShopFragment
}
}
}
Variables
{
"allowOutOfStockExchanges": false,
"autoProcessExchangesOnCreation": true,
"automatedStoreCreditType": "DISCOUNT_CODE",
"barcodeValue": "NONE",
"carryDiscountForwardType": "NONE",
"cartonizationLengthUnit": "INCHES",
"creditPortalDisplayOrder": 123,
"customerEmailContent": "xyz789",
"customerEmailDisplayFromName": "xyz789",
"customerEmailReplyToAddress": "xyz789",
"defaultAddress": AddressInput,
"defaultExchangeFee": Decimal,
"defaultRefundFee": Decimal,
"defaultStoreCreditFee": Decimal,
"defaultWarehouseForPosReturns": "4",
"defaultWeight": Decimal,
"defaultWeightUnit": "abc123",
"delayedShopifyReturnCreationEnabled": false,
"discountSameProductExchangesToBeEqual": true,
"dynamicTranslations": [DynamicTranslationInput],
"easypostApiKey": "xyz789",
"enableCustomRmaNumber": false,
"enableExchange": true,
"enableRefund": false,
"enableStoreCredit": false,
"exchangeCommentsEnabled": true,
"exchangeCommentsRequired": false,
"exchangeDays": 123,
"exchangeDaysToReserveStock": 123,
"exchangeDaysType": "SINCE_DELIVERY",
"exchangeExcludeTags": ["abc123"],
"exchangeMethod": "COMMENTS",
"exchangePortalDisplayOrder": 123,
"exchangeRoundToZeroIfLteTo": Decimal,
"exchangeSamePriceOnly": true,
"exchangeShipmentOrderSuffix": "xyz789",
"exchangeUpsellDiscountPercentage": Decimal,
"exchangeUpsellEnabled": false,
"gorgiasSubdomain": "xyz789",
"instructions": "xyz789",
"international": true,
"internationalCustomsSigner": "xyz789",
"internationalDefaultHarmonizedSystemCode": "abc123",
"internationalExemptionCode": "xyz789",
"internationalNonDeliveryOption": "xyz789",
"internationalOriginCountry": "abc123",
"isCartonizationEnabled": false,
"isDefaultFeeEqualsShippingCost": false,
"isExchangeDifferentialPricingEnabled": false,
"isExchangeIntegrationEnabled": false,
"isFullCatalogExchangeEnabled": false,
"isInlineExchangeEnabled": false,
"isNoShippingReturnEnabled": false,
"isQrCodeEnabled": false,
"isRefundIntegrationEnabled": false,
"isRestockIntegrationEnabled": true,
"isReturnItemExpirationEnabled": false,
"isShippingLabelUploadAllowed": true,
"isStoreCreditIncentiveEnabled": false,
"isStoreCreditIncentiveRoundToNearest": true,
"isStoreCreditIntegrationEnabled": true,
"klaviyoApiKey": "xyz789",
"maxStoreCreditIncentiveAmount": Decimal,
"minStoreCreditIncentiveAmount": Decimal,
"notificationEmailAddress": "abc123",
"notificationEmailAttachRma": false,
"notifications": [NotificationInput],
"onboardingComplete": true,
"paidShippingFee": Decimal,
"portalCustomizations": JSONString,
"portalExchangeSelectionMethod": "SEARCH",
"portalFrenchUseAlternative": true,
"portalGermanUseAlternative": true,
"portalItalianUseAlternative": false,
"portalLanguage": "abc123",
"portalTheme": "abc123",
"portalVisualExchangeExcludeCollections": [
"abc123"
],
"portalVisualExchangeIncludeCollections": [
"xyz789"
],
"portalVisualExchangeType": "NONE",
"prepaidShippingFee": Decimal,
"primaryFieldBehavior": "EMAIL_ADDRESS",
"questions": [QuestionInput],
"refField1Source": "BLANK",
"refField2Source": "BLANK",
"refundCommentsEnabled": false,
"refundCommentsRequired": false,
"refundDays": 987,
"refundDaysType": "SINCE_DELIVERY",
"refundPortalDisplayOrder": 987,
"requireApprovalForAllReturns": false,
"resolvePartialExchangeRefundsToStoreCredit": false,
"restockingFeeDefinedAsPercentage": false,
"restockingFeeType": "ONCE_PER_RETURN",
"returnItemExpirationDays": 987,
"returnReasons": [ReturnReasonInput],
"secondaryFieldBehavior": "SHOPIFY_ORDER_NUMBER",
"selfShippingFee": Decimal,
"shipFree": true,
"shipPay": false,
"shipSelf": true,
"shippingRateSelectLowestRate": false,
"shippingRateShowUpToPercentage": Decimal,
"shippoApiKey": "abc123",
"shouldDisplayFeesInPortal": false,
"showPortalSummary": false,
"stageShipmentStatuses": [StageShipmentStatusInput],
"stages": [StageInput],
"storeCreditCommentsEnabled": true,
"storeCreditCommentsRequired": true,
"storeCreditDays": 123,
"storeCreditDaysType": "SINCE_DELIVERY",
"storeCreditIncentivePercentage": 123.45,
"storeCreditIncentiveType": "ONCE_PER_ITEM",
"stripePublishableKey": "xyz789",
"stripeSecretKey": "abc123",
"useApprovals": true,
"useConsolidatedOrderExchanges": false,
"useExchangeShipmentOrders": false,
"useShopAddressForPosReturns": false,
"webhookEvents": ["RETURN_CREATED"],
"webhookUrl": "xyz789"
}
Response
{
"data": {
"updateSettings": {
"success": true,
"error": "xyz789",
"shop": AuthenticatedShop
}
}
}
updateUserPreferences
Description
This mutation updates the user preferences
Response
Returns an UpdateUserPreferences
Arguments
| Name | Description |
|---|---|
preferredLocale - String
|
Optional argument for updating preferred locale setting (e.g. en-US, fr-FR) |
Example
Query
mutation updateUserPreferences($preferredLocale: String) {
updateUserPreferences(preferredLocale: $preferredLocale) {
success
user {
...ShopifyUserFragment
}
}
}
Variables
{"preferredLocale": "xyz789"}
Response
{
"data": {
"updateUserPreferences": {
"success": false,
"user": ShopifyUser
}
}
}
voidShipment
Response
Returns a VoidShipment
Arguments
| Name | Description |
|---|---|
returnId - ID!
|
Example
Query
mutation voidShipment($returnId: ID!) {
voidShipment(returnId: $returnId) {
error
return {
...ReturnFragment
}
}
}
Variables
{"returnId": "4"}
Response
{
"data": {
"voidShipment": {
"error": "xyz789",
"return": Return
}
}
}
warehouseCreate
Response
Returns a WarehouseCreate
Arguments
| Name | Description |
|---|---|
warehouse - WarehouseInput!
|
Example
Query
mutation warehouseCreate($warehouse: WarehouseInput!) {
warehouseCreate(warehouse: $warehouse) {
error
warehouse {
...WarehouseTypeFragment
}
}
}
Variables
{"warehouse": WarehouseInput}
Response
{
"data": {
"warehouseCreate": {
"error": "abc123",
"warehouse": WarehouseType
}
}
}
warehouseDelete
Response
Returns a WarehouseDelete
Arguments
| Name | Description |
|---|---|
id - ID!
|
Example
Query
mutation warehouseDelete($id: ID!) {
warehouseDelete(id: $id) {
error
}
}
Variables
{"id": 4}
Response
{
"data": {
"warehouseDelete": {"error": "abc123"}
}
}
warehouseUpdate
Response
Returns a WarehouseUpdate
Arguments
| Name | Description |
|---|---|
warehouse - WarehouseInput!
|
Example
Query
mutation warehouseUpdate($warehouse: WarehouseInput!) {
warehouseUpdate(warehouse: $warehouse) {
error
warehouse {
...WarehouseTypeFragment
}
}
}
Variables
{"warehouse": WarehouseInput}
Response
{
"data": {
"warehouseUpdate": {
"error": "xyz789",
"warehouse": WarehouseType
}
}
}
Types
AcceptTOS
Description
Accept the Terms of Service for prepaid balance system.
Fields
| Field Name | Description |
|---|---|
shop - AuthenticatedShop
|
|
balanceSettings - BalanceSettingsType
|
|
errors - [GQLErrorType]
|
Example
{
"shop": AuthenticatedShop,
"balanceSettings": BalanceSettingsType,
"errors": [GQLErrorType]
}
ActionTakenMetricType
Example
{
"exchangesCount": 987,
"exchangesAmount": Decimal,
"refundsCount": 123,
"refundsAmount": Decimal,
"storeCreditCount": 987,
"storeCreditAmount": Decimal,
"manuallyResolvedCount": 987,
"manuallyResolvedAmount": Decimal,
"unresolvedCount": 987,
"unresolvedAmount": Decimal
}
ActiveReturnStageMetricType
ActiveReturnsMetricType
Fields
| Field Name | Description |
|---|---|
count - Int
|
|
stage - [ActiveReturnStageMetricType]
|
Example
{"count": 987, "stage": [ActiveReturnStageMetricType]}
AddPaymentMethod
Description
Add a new payment method using a Stripe payment method ID.
Fields
| Field Name | Description |
|---|---|
paymentMethods - [ShopPaymentMethod]
|
|
paymentMethod - ShopPaymentMethod
|
|
success - Boolean
|
|
message - String
|
|
errors - [GQLErrorType]
|
Example
{
"paymentMethods": [ShopPaymentMethod],
"paymentMethod": ShopPaymentMethod,
"success": true,
"message": "xyz789",
"errors": [GQLErrorType]
}
Address
Example
{
"id": 987,
"uuid": "4",
"name": "xyz789",
"company": "xyz789",
"addressLine1": "xyz789",
"addressLine2": "abc123",
"city": "xyz789",
"state": "abc123",
"postalCode": "xyz789",
"country": "abc123",
"phoneNumber": "abc123"
}
AddressInput
Example
{
"uuid": 4,
"name": "abc123",
"company": "xyz789",
"addressLine1": "xyz789",
"addressLine2": "xyz789",
"city": "xyz789",
"state": "abc123",
"postalCode": "xyz789",
"country": "abc123",
"phoneNumber": "abc123"
}
AddressType
Example
{
"id": 4,
"userName": "xyz789",
"company": "abc123",
"street1": "xyz789",
"phone": "xyz789",
"street2": "abc123",
"country": "xyz789",
"city": "xyz789",
"zip": "xyz789",
"state": "xyz789"
}
AdminOrderLookupResponse
Fields
| Field Name | Description |
|---|---|
orders - [AdminSearchOrderResult]!
|
Example
{"orders": [AdminSearchOrderResult]}
AdminSearchOrderResult
ApproveReturn
ArchiveFilter
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"ACTIVE"
ArchiveReturns
Fields
| Field Name | Description |
|---|---|
success - Boolean
|
Example
{"success": false}
AuthenticatedShop
Description
Note, this is different from returnzap.portal.types.PublicShop since we will expose things to an authenticated shop admin that we won't expose to the public portal APIs.
Fields
| Field Name | Description |
|---|---|
url - String!
|
|
portalTheme - String!
|
|
portalLanguage - String!
|
|
portalFrenchUseAlternative - Boolean!
|
Use informal French |
portalGermanUseAlternative - Boolean!
|
Use informal German |
portalItalianUseAlternative - Boolean!
|
Use formal Italian |
portalCustomizations - JSONString!
|
|
shouldDisplayFeesInPortal - Boolean!
|
|
refundPortalDisplayOrder - Int!
|
|
creditPortalDisplayOrder - Int!
|
|
exchangePortalDisplayOrder - Int!
|
|
showPortalSummary - Boolean!
|
|
portalExchangeSelectionMethod - PortalExchangeSelectionMethod
|
|
portalVisualExchangeType - PortalVisualExchangeType
|
|
exchangeUpsellEnabled - Boolean!
|
|
exchangeUpsellDiscountPercentage - Decimal
|
Percentage discount for upsell exchanges |
prepaidShippingFee - Decimal
|
|
paidShippingFee - Decimal
|
|
selfShippingFee - Decimal
|
|
isDefaultFeeEqualsShippingCost - Boolean!
|
|
restockingFeeDefinedAsPercentage - Boolean!
|
|
defaultRefundFee - Decimal
|
|
defaultExchangeFee - Decimal
|
|
defaultStoreCreditFee - Decimal
|
|
exchangeMethod - ExchangeMethod
|
|
isInlineExchangeEnabled - Boolean!
|
Allow the shop customer to exchange items in the portal |
isFullCatalogExchangeEnabled - Boolean!
|
Allow the shop customer to exchange any item in the catalog |
useConsolidatedOrderExchanges - Boolean!
|
|
exchangeSamePriceOnly - Boolean!
|
Only show product variants with the same price as the original product |
isExchangeDifferentialPricingEnabled - Boolean!
|
Allow the shop customer to exchange items with different prices |
allowOutOfStockExchanges - Boolean!
|
Allow exchanges for items that are out of stock |
isStoreCreditIncentiveEnabled - Boolean!
|
|
storeCreditIncentivePercentage - Float!
|
Percentage between 0 and 100 |
minStoreCreditIncentiveAmount - Decimal
|
|
maxStoreCreditIncentiveAmount - Decimal
|
|
isStoreCreditIncentiveRoundToNearest - Boolean!
|
|
uuid - String!
|
|
primaryDomain - String!
|
|
isTestShop - Boolean!
|
|
isUitestShop - Boolean!
|
|
onboardingCompletedAt - DateTime
|
|
needsToEnableExchangeTestDrive - Boolean!
|
|
instructions - String!
|
|
portalVisualExchangeIncludeCollections - [String!]!
|
|
portalVisualExchangeExcludeCollections - [String!]!
|
|
isShippingLabelUploadAllowed - Boolean!
|
|
barcodeValue - BarcodeValue
|
|
enableCustomRmaNumber - Boolean!
|
|
shipFree - Boolean!
|
|
shipPay - Boolean!
|
|
shipSelf - Boolean!
|
|
useShippingByReturnzap - Boolean!
|
|
isNoShippingReturnEnabled - Boolean!
|
|
isQrCodeEnabled - Boolean!
|
|
isCartonizationEnabled - Boolean!
|
|
cartonizationLengthUnit - LengthUnit
|
|
currency - String!
|
The default currency code from Shopify (e.g. USD, CAD) |
klaviyoApiKey - String!
|
|
gorgiasSubdomain - String!
|
The user entered subdomain that we'll use to match with Gorgias accounts once they've completed the OAuth flow. |
shippingRateSelectLowestRate - Boolean!
|
|
shippingRateShowUpToPercentage - Decimal!
|
|
useApprovals - Boolean!
|
|
requireApprovalForAllReturns - Boolean!
|
|
useShopAddressForPosReturns - Boolean!
|
|
delayedShopifyReturnCreationEnabled - Boolean!
|
ReturnZap will not create a return directly in Shopify until the return's stage.create_shopify_return=True or an admin user tries to resolve an item. |
isRefundIntegrationEnabled - Boolean!
|
Integration with Shopify Refund |
isRestockIntegrationEnabled - Boolean!
|
Has the customer enabled integration with Shopify Restock? |
returnItemExpirationDays - Int!
|
For testing, if value is over 10000, we will subtract 10000 and use the remainder as number of minutes, not days. |
isReturnItemExpirationEnabled - Boolean!
|
|
exchangeIntegration - Boolean!
|
Is integration with Shopify Exchange available to the customer. This will eventually be removed in favor for features on the billing plan. |
isExchangeIntegrationEnabled - Boolean!
|
Has the customer enabled integration with Shopify Exchange? |
discountSameProductExchangesToBeEqual - Boolean!
|
If customer is exchanging for another variant of the same product, discount it to the same value as the original variant |
exchangeRoundToZeroIfLteTo - Decimal
|
If the balance due for an exchange is less than or equal to this value, round it to zero. |
exchangeDaysToReserveStock - Int!
|
Number of days to reserve stock for exchange |
carryDiscountForwardType - CarryDiscountForwardType
|
|
useExchangeShipmentOrders - Boolean!
|
If True, we'll create a new exchange order for fulfilling replacement items and place a hold on the original order's fulfillment order. |
exchangeShipmentOrderSuffix - String!
|
By default we will add "-EX" + " |
autoProcessExchangesOnCreation - Boolean!
|
Automatically process and reserve exchange items from stock when return is created |
storeCreditIntegration - Boolean!
|
Is integration with Shopify Store Credit available to the customer?This will eventually be removed in favor for features on the billing plan. |
isStoreCreditIntegrationEnabled - Boolean!
|
Has the customer enabled integration with Shopify Store Credit? |
resolvePartialExchangeRefundsToStoreCredit - Boolean!
|
If True, partial refunds from exchanges are issued to store credit. If False, they are issued as refunds. |
id - ID!
|
|
parentUrl - String
|
|
shopifyAdminUrl - String!
|
|
primaryFieldBehavior - PrimaryFieldBehavior!
|
|
secondaryFieldBehavior - SecondaryFieldBehavior!
|
|
reauthenticateUrl - String
|
Allow the user to reauthenticate with Shopify |
hasTestModeReturns - Boolean
|
|
defaultPortalUrl - String!
|
|
adminAppUrl - String!
|
|
enableRefund - Boolean
|
|
refundDays - Int
|
|
refundDaysType - DaysType
|
|
refundCommentsEnabled - Boolean
|
|
refundCommentsRequired - Boolean
|
|
enableExchange - Boolean
|
|
exchangeDays - Int
|
|
exchangeDaysType - DaysType
|
|
exchangeCommentsEnabled - Boolean
|
|
exchangeCommentsRequired - Boolean
|
|
exchangeExcludeTags - [String]
|
|
enableStoreCredit - Boolean
|
|
storeCreditDays - Int
|
|
storeCreditDaysType - DaysType
|
|
storeCreditCommentsEnabled - Boolean
|
|
storeCreditCommentsRequired - Boolean
|
|
automatedStoreCreditType - AutomatedStoreCreditType
|
|
notificationEmailAddress - String
|
|
notificationEmailAttachRma - Boolean
|
|
customerEmailDisplayFromName - String
|
|
customerEmailReplyToAddress - String
|
|
defaultAddress - Address
|
|
defaultWeight - Decimal
|
|
defaultWeightUnit - String
|
|
international - Boolean
|
|
internationalOriginCountry - String
|
|
internationalCustomsSigner - String
|
|
internationalNonDeliveryOption - String
|
|
internationalExemptionCode - String
|
|
internationalDefaultHarmonizedSystemCode - String
|
|
easypostApiKey - String
|
Use easyPostAccount.apiKey instead |
shippoApiKey - String
|
|
stripePublishableKey - String
|
|
stripeSecretKey - String
|
|
subscriptionPlan - ShopSubscriptionPlan!
|
|
features - [String]
|
|
onboardingComplete - Boolean
|
Use onboarding_completed_at instead |
installedAt - DateTime
|
|
installDate - DateTime
|
Use installed_at instead |
returnReasons - [ReturnReason]
|
|
stages - [Stage]
|
|
notifications - [Notification]
|
|
rules - [Rule]!
|
|
packages - [PackageType]!
|
|
dynamicTranslations - [DynamicTranslation]
|
|
returnIntegration - Boolean
|
|
missingScopes - [String]
|
Missing scopes based on the enable features for the user |
sendcloudAccounts - [SendcloudAccount]
|
|
shopifyLocations - [ShopifyLocation]
|
|
Arguments
|
|
easyPostAccount - EasyPostAccountType
|
|
shippoAccount - ShippoAccountType
|
|
refField1Source - RefFieldSource
|
|
refField2Source - RefFieldSource
|
|
storeCreditIncentiveType - StoreCreditIncentiveType
|
|
restockingFeeType - RestockingFeeType
|
|
webhookUrl - String
|
|
webhookEvents - [WebhookEventType]
|
|
questions - [Question]
|
|
stageShipmentStatuses - [StageShipmentStatusType]
|
|
defaultWarehouseForPosReturns - ID
|
|
Example
{
"url": "abc123",
"portalTheme": "xyz789",
"portalLanguage": "xyz789",
"portalFrenchUseAlternative": false,
"portalGermanUseAlternative": false,
"portalItalianUseAlternative": false,
"portalCustomizations": JSONString,
"shouldDisplayFeesInPortal": true,
"refundPortalDisplayOrder": 987,
"creditPortalDisplayOrder": 123,
"exchangePortalDisplayOrder": 987,
"showPortalSummary": true,
"portalExchangeSelectionMethod": "SEARCH",
"portalVisualExchangeType": "NONE",
"exchangeUpsellEnabled": true,
"exchangeUpsellDiscountPercentage": Decimal,
"prepaidShippingFee": Decimal,
"paidShippingFee": Decimal,
"selfShippingFee": Decimal,
"isDefaultFeeEqualsShippingCost": true,
"restockingFeeDefinedAsPercentage": true,
"defaultRefundFee": Decimal,
"defaultExchangeFee": Decimal,
"defaultStoreCreditFee": Decimal,
"exchangeMethod": "COMMENTS",
"isInlineExchangeEnabled": false,
"isFullCatalogExchangeEnabled": true,
"useConsolidatedOrderExchanges": false,
"exchangeSamePriceOnly": false,
"isExchangeDifferentialPricingEnabled": true,
"allowOutOfStockExchanges": true,
"isStoreCreditIncentiveEnabled": true,
"storeCreditIncentivePercentage": 987.65,
"minStoreCreditIncentiveAmount": Decimal,
"maxStoreCreditIncentiveAmount": Decimal,
"isStoreCreditIncentiveRoundToNearest": false,
"uuid": "xyz789",
"primaryDomain": "xyz789",
"isTestShop": true,
"isUitestShop": false,
"onboardingCompletedAt": "2007-12-03T10:15:30Z",
"needsToEnableExchangeTestDrive": true,
"instructions": "abc123",
"portalVisualExchangeIncludeCollections": [
"xyz789"
],
"portalVisualExchangeExcludeCollections": [
"abc123"
],
"isShippingLabelUploadAllowed": true,
"barcodeValue": "NONE",
"enableCustomRmaNumber": false,
"shipFree": false,
"shipPay": true,
"shipSelf": true,
"useShippingByReturnzap": false,
"isNoShippingReturnEnabled": false,
"isQrCodeEnabled": true,
"isCartonizationEnabled": true,
"cartonizationLengthUnit": "INCHES",
"currency": "xyz789",
"klaviyoApiKey": "xyz789",
"gorgiasSubdomain": "abc123",
"shippingRateSelectLowestRate": true,
"shippingRateShowUpToPercentage": Decimal,
"useApprovals": false,
"requireApprovalForAllReturns": true,
"useShopAddressForPosReturns": false,
"delayedShopifyReturnCreationEnabled": false,
"isRefundIntegrationEnabled": false,
"isRestockIntegrationEnabled": false,
"returnItemExpirationDays": 123,
"isReturnItemExpirationEnabled": true,
"exchangeIntegration": true,
"isExchangeIntegrationEnabled": false,
"discountSameProductExchangesToBeEqual": false,
"exchangeRoundToZeroIfLteTo": Decimal,
"exchangeDaysToReserveStock": 987,
"carryDiscountForwardType": "NONE",
"useExchangeShipmentOrders": false,
"exchangeShipmentOrderSuffix": "xyz789",
"autoProcessExchangesOnCreation": false,
"storeCreditIntegration": false,
"isStoreCreditIntegrationEnabled": false,
"resolvePartialExchangeRefundsToStoreCredit": false,
"id": "4",
"parentUrl": "abc123",
"shopifyAdminUrl": "xyz789",
"primaryFieldBehavior": "EMAIL_ADDRESS",
"secondaryFieldBehavior": "SHOPIFY_ORDER_NUMBER",
"reauthenticateUrl": "abc123",
"hasTestModeReturns": true,
"defaultPortalUrl": "abc123",
"adminAppUrl": "abc123",
"enableRefund": false,
"refundDays": 123,
"refundDaysType": "SINCE_DELIVERY",
"refundCommentsEnabled": true,
"refundCommentsRequired": true,
"enableExchange": false,
"exchangeDays": 123,
"exchangeDaysType": "SINCE_DELIVERY",
"exchangeCommentsEnabled": false,
"exchangeCommentsRequired": true,
"exchangeExcludeTags": ["xyz789"],
"enableStoreCredit": true,
"storeCreditDays": 987,
"storeCreditDaysType": "SINCE_DELIVERY",
"storeCreditCommentsEnabled": false,
"storeCreditCommentsRequired": false,
"automatedStoreCreditType": "DISCOUNT_CODE",
"notificationEmailAddress": "abc123",
"notificationEmailAttachRma": false,
"customerEmailDisplayFromName": "xyz789",
"customerEmailReplyToAddress": "abc123",
"defaultAddress": Address,
"defaultWeight": Decimal,
"defaultWeightUnit": "abc123",
"international": false,
"internationalOriginCountry": "xyz789",
"internationalCustomsSigner": "abc123",
"internationalNonDeliveryOption": "xyz789",
"internationalExemptionCode": "xyz789",
"internationalDefaultHarmonizedSystemCode": "abc123",
"easypostApiKey": "xyz789",
"shippoApiKey": "xyz789",
"stripePublishableKey": "abc123",
"stripeSecretKey": "xyz789",
"subscriptionPlan": ShopSubscriptionPlan,
"features": ["xyz789"],
"onboardingComplete": false,
"installedAt": "2007-12-03T10:15:30Z",
"installDate": "2007-12-03T10:15:30Z",
"returnReasons": [ReturnReason],
"stages": [Stage],
"notifications": [Notification],
"rules": [Rule],
"packages": [PackageType],
"dynamicTranslations": [DynamicTranslation],
"returnIntegration": false,
"missingScopes": ["xyz789"],
"sendcloudAccounts": [SendcloudAccount],
"shopifyLocations": [ShopifyLocation],
"easyPostAccount": EasyPostAccountType,
"shippoAccount": ShippoAccountType,
"refField1Source": "BLANK",
"refField2Source": "BLANK",
"storeCreditIncentiveType": "ONCE_PER_ITEM",
"restockingFeeType": "ONCE_PER_RETURN",
"webhookUrl": "xyz789",
"webhookEvents": ["RETURN_CREATED"],
"questions": [Question],
"stageShipmentStatuses": [StageShipmentStatusType],
"defaultWarehouseForPosReturns": 4
}
AutomatedStoreCreditType
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
Example
"DISCOUNT_CODE"
BalanceInfoType
Fields
| Field Name | Description |
|---|---|
tosStatus - TOSStatusType!
|
|
paymentMethods - [ShopPaymentMethod]
|
|
balanceSettings - BalanceSettingsType
|
|
balance - Decimal!
|
Example
{
"tosStatus": TOSStatusType,
"paymentMethods": [ShopPaymentMethod],
"balanceSettings": BalanceSettingsType,
"balance": Decimal
}
BalanceSettingsType
Fields
| Field Name | Description |
|---|---|
id - UUID!
|
|
autoRechargeEnabled - Boolean!
|
Whether auto-recharge is enabled for this shop |
autoRechargeThreshold - Decimal
|
|
autoRechargeAmount - Decimal
|
|
currency - BalancesShopBalanceSettingsCurrencyChoices!
|
Currency for this shop's balance account |
returnzapProcessingFeePercentage - Decimal!
|
ReturnZap processing fee percentage (e.g., 0.0375 for 3.75%) |
Example
{
"id": "a7b25635-2b7c-42da-9fa3-d967ab9051c5",
"autoRechargeEnabled": true,
"autoRechargeThreshold": Decimal,
"autoRechargeAmount": Decimal,
"currency": "USD",
"returnzapProcessingFeePercentage": Decimal
}
BalancesLedgerEntryCurrencyChoices
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
US Dollar |
|
|
British Pound |
|
|
Euro |
Example
"USD"
BalancesShopBalanceSettingsCurrencyChoices
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
US Dollar |
|
|
British Pound |
|
|
Euro |
Example
"USD"
BarcodeValue
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
Example
"NONE"
BillingPeriodType
Fields
| Field Name | Description |
|---|---|
id - UUID!
|
|
startDate - Date!
|
|
endDate - Date!
|
|
totalReturns - Int!
|
|
totalAmountDue - Decimal!
|
|
usageOverageQuantity - Int!
|
|
usageAmountCharged - Decimal
|
|
usageDescription - String
|
|
usageChargeId - String!
|
|
usageChargedAt - DateTime
|
|
billingPeriodClosedAt - DateTime
|
|
tierCountWhenClosed - Int
|
|
overagePriceWhenClosed - Decimal
|
Example
{
"id": "a7b25635-2b7c-42da-9fa3-d967ab9051c5",
"startDate": "2007-12-03",
"endDate": "2007-12-03",
"totalReturns": 987,
"totalAmountDue": Decimal,
"usageOverageQuantity": 123,
"usageAmountCharged": Decimal,
"usageDescription": "xyz789",
"usageChargeId": "xyz789",
"usageChargedAt": "2007-12-03T10:15:30Z",
"billingPeriodClosedAt": "2007-12-03T10:15:30Z",
"tierCountWhenClosed": 987,
"overagePriceWhenClosed": Decimal
}
Boolean
Description
The Boolean scalar type represents true or false.
Example
true
CarryDiscountForwardType
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"NONE"
CompleteOnboarding
Fields
| Field Name | Description |
|---|---|
success - Boolean
|
|
shop - AuthenticatedShop
|
Example
{"success": true, "shop": AuthenticatedShop}
Condition
Fields
| Field Name | Description |
|---|---|
id - ID!
|
|
uuid - String!
|
|
attr - RuleAttribute!
|
|
op - RuleOperator!
|
|
value - String!
|
|
questionId - ID
|
Use question instead. |
questionChoiceIds - [ID]
|
Use question_choices instead. |
question - ID
|
|
questionType - QuestionType
|
|
questionChoices - [ID]
|
Example
{
"id": "4",
"uuid": "xyz789",
"attr": "NONE",
"op": "EQ",
"value": "xyz789",
"questionId": 4,
"questionChoiceIds": ["4"],
"question": "4",
"questionType": "LONG_TEXT",
"questionChoices": [4]
}
ConditionInput
Fields
| Input Field | Description |
|---|---|
id - ID
|
|
attr - RuleAttribute
|
|
op - RuleOperator
|
|
value - String!
|
|
question - ID
|
|
questionChoices - [ID]
|
Example
{
"id": "4",
"attr": "NONE",
"op": "EQ",
"value": "abc123",
"question": 4,
"questionChoices": ["4"]
}
CreateOrUpdateQuestion
Fields
| Field Name | Description |
|---|---|
question - Question
|
Example
{"question": Question}
CreateReturnStoreCreditMutation
Fields
| Field Name | Description |
|---|---|
error - String
|
|
errorText - String
|
|
return - Return
|
|
storeCredit - StoreCreditType
|
Example
{
"error": "xyz789",
"errorText": "xyz789",
"return": Return,
"storeCredit": StoreCreditType
}
CreateSetupIntent
Description
Create a Stripe SetupIntent for linking payment method.
Fields
| Field Name | Description |
|---|---|
setupIntent - SetupIntentResponseType
|
|
errors - [GQLErrorType]
|
Example
{
"setupIntent": SetupIntentResponseType,
"errors": [GQLErrorType]
}
DashboardMetrics
Fields
| Field Name | Description |
|---|---|
returnMetrics - [ReturnsMetricType]
|
|
stageMetrics - [StageMetricType]
|
|
policyMetrics - [PolicyMetricType]
|
|
reasonMetrics - [ReasonMetricType]
|
|
actionTakenMetrics - ActionTakenMetricType
|
|
mostReturned - ReturnProductMetricType
|
|
activeReturns - ActiveReturnsMetricType
|
|
startDate - DateTime
|
Start date of the dashboard metrics |
endDate - DateTime
|
End date of the dashboard metrics |
Example
{
"returnMetrics": [ReturnsMetricType],
"stageMetrics": [StageMetricType],
"policyMetrics": [PolicyMetricType],
"reasonMetrics": [ReasonMetricType],
"actionTakenMetrics": ActionTakenMetricType,
"mostReturned": ReturnProductMetricType,
"activeReturns": ActiveReturnsMetricType,
"startDate": "2007-12-03T10:15:30Z",
"endDate": "2007-12-03T10:15:30Z"
}
DashboardResponse
Date
Description
The Date scalar type represents a Date value as specified by iso8601.
Example
"2007-12-03"
DateFilterRange
DateTime
Description
The DateTime scalar type represents a DateTime value as specified by iso8601.
Example
"2007-12-03T10:15:30Z"
DaysType
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"SINCE_DELIVERY"
Decimal
Description
The Decimal scalar type represents a python Decimal.
Example
Decimal
DeleteQuestion
Fields
| Field Name | Description |
|---|---|
success - Boolean
|
Example
{"success": true}
DeleteReturns
Fields
| Field Name | Description |
|---|---|
success - Boolean
|
Example
{"success": false}
DeleteTaxNumbers
Fields
| Field Name | Description |
|---|---|
errors - [GQLErrorType]
|
Example
{"errors": [GQLErrorType]}
DisposeReturn
DispositionType
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
Example
"MISSING"
DjangoDebug
Description
Debugging information for the current query.
Fields
| Field Name | Description |
|---|---|
sql - [DjangoDebugSQL]
|
Executed SQL queries for this API query. |
exceptions - [DjangoDebugException]
|
Raise exceptions for this API query. |
Example
{
"sql": [DjangoDebugSQL],
"exceptions": [DjangoDebugException]
}
DjangoDebugException
DjangoDebugSQL
Description
Represents a single database query made to a Django managed DB.
Fields
| Field Name | Description |
|---|---|
vendor - String!
|
The type of database being used (e.g. postrgesql, mysql, sqlite). |
alias - String!
|
The Django database alias (e.g. 'default'). |
sql - String
|
The actual SQL sent to this database. |
duration - Float!
|
Duration of this database query in seconds. |
rawSql - String!
|
The raw SQL of this query, without params. |
params - String!
|
JSON encoded database query parameters. |
startTime - Float!
|
Start time of this database query. |
stopTime - Float!
|
Stop time of this database query. |
isSlow - Boolean!
|
Whether this database query took more than 10 seconds. |
isSelect - Boolean!
|
Whether this database query was a SELECT. |
transId - String
|
Postgres transaction ID if available. |
transStatus - String
|
Postgres transaction status if available. |
isoLevel - String
|
Postgres isolation level if available. |
encoding - String
|
Postgres connection encoding if available. |
Example
{
"vendor": "abc123",
"alias": "abc123",
"sql": "xyz789",
"duration": 987.65,
"rawSql": "xyz789",
"params": "abc123",
"startTime": 123.45,
"stopTime": 123.45,
"isSlow": true,
"isSelect": true,
"transId": "xyz789",
"transStatus": "xyz789",
"isoLevel": "abc123",
"encoding": "abc123"
}
DynamicTranslation
DynamicTranslationInput
Example
{
"uuid": 4,
"language": "abc123",
"model": "RETURN_REASON",
"field": "abc123",
"objUuid": "abc123",
"message": "xyz789",
"delete": false
}
EasyEasyPostCarrierConfigUnitChoices
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
in |
|
|
cm |
Example
"IN"
EasyPostAccountMutation
Fields
| Field Name | Description |
|---|---|
error - String
|
|
easyPostAccount - EasyPostAccountType
|
Example
{
"error": "xyz789",
"easyPostAccount": EasyPostAccountType
}
EasyPostAccountType
Fields
| Field Name | Description |
|---|---|
id - ID!
|
|
shop - AuthenticatedShop
|
|
managedByReturnzap - Boolean!
|
|
apiKey - String!
|
|
useIsReturn - Boolean!
|
|
services - String!
|
Comma delimited list of EasyPost Services |
carriers - [EasyPostCarrierType]
|
Example
{
"id": "4",
"shop": AuthenticatedShop,
"managedByReturnzap": true,
"apiKey": "xyz789",
"useIsReturn": true,
"services": "xyz789",
"carriers": [EasyPostCarrierType]
}
EasyPostCarrierConfig
Example
{
"carrier": "abc123",
"displayName": "xyz789",
"service": "abc123",
"serviceDisplayName": "xyz789",
"width": Decimal,
"height": Decimal,
"unit": "IN",
"rotate": false,
"supportsQrCode": true
}
EasyPostCarrierMutation
Fields
| Field Name | Description |
|---|---|
error - String
|
|
easyPostCarriers - [EasyPostCarrierType]
|
Example
{
"error": "xyz789",
"easyPostCarriers": [EasyPostCarrierType]
}
EasyPostCarrierType
Fields
| Field Name | Description |
|---|---|
id - ID!
|
|
externalId - String!
|
|
easypostAccount - EasyPostAccountType
|
|
shop - AuthenticatedShop!
|
|
name - String!
|
|
active - Boolean!
|
Example
{
"id": 4,
"externalId": "xyz789",
"easypostAccount": EasyPostAccountType,
"shop": AuthenticatedShop,
"name": "abc123",
"active": false
}
EasyPostCarrierUpdateType
ExchangeItem
Fields
| Field Name | Description |
|---|---|
id - ID!
|
|
returnItem - ReturnItem
|
Use returnItemId instead
|
variantId - String!
|
The Shopify variant id for the item the customer wants to exchange |
title - String!
|
Exchange item title |
sku - String!
|
Exchange item sku |
quantity - Int
|
The quantity of the item to exchange |
imageUrl - String!
|
Exchange item image url |
presentmentDiscountedAmount - Decimal
|
Actual variant unit amount customer paid in presentment currency |
presentmentCurrency - String!
|
|
releasedAt - DateTime
|
|
removedAt - DateTime
|
Date removed from consolidated order exchange |
expiredAt - DateTime
|
|
returnItemId - String
|
The id of the return item this is exchanging for |
exchangeOrderId - String
|
The id of the exchange order |
variantList - [String]
|
|
returnItemIsMissing - Boolean
|
Whether the return item is missing |
isResolved - Boolean
|
Whether the exchange item has been resolved |
status - ExchangeOrderStatus
|
Status of the exchange order |
draftOrderId - String
|
The id of the draft order in Shopify |
draftOrderNumber - String
|
The number of the draft order in Shopify |
draftOrderLink - String
|
URL Link to the draft order in Shopify |
completedOrderId - String
|
The id of the completed order in Shopify |
completedOrderNumber - String
|
The number of the completed order in Shopify |
completedOrderLink - String
|
URL Link to the completed order in Shopify |
consolidatedOrderLink - String
|
URL Link to the original order in Shopify |
statusLabel - String
|
Status label for the exchange order Use status instead |
completeOrderLink - String
|
URL Link to the completed order in Shopify |
exchangeVariantId - String
|
The Shopify variant id for the item the customer wants to receive as replacement. Use variantId instead
|
Example
{
"id": "4",
"returnItem": ReturnItem,
"variantId": "xyz789",
"title": "xyz789",
"sku": "xyz789",
"quantity": 123,
"imageUrl": "abc123",
"presentmentDiscountedAmount": Decimal,
"presentmentCurrency": "abc123",
"releasedAt": "2007-12-03T10:15:30Z",
"removedAt": "2007-12-03T10:15:30Z",
"expiredAt": "2007-12-03T10:15:30Z",
"returnItemId": "abc123",
"exchangeOrderId": "abc123",
"variantList": ["abc123"],
"returnItemIsMissing": false,
"isResolved": true,
"status": "DRAFT",
"draftOrderId": "xyz789",
"draftOrderNumber": "xyz789",
"draftOrderLink": "xyz789",
"completedOrderId": "abc123",
"completedOrderNumber": "xyz789",
"completedOrderLink": "abc123",
"consolidatedOrderLink": "xyz789",
"statusLabel": "abc123",
"completeOrderLink": "abc123",
"exchangeVariantId": "xyz789"
}
ExchangeMethod
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"COMMENTS"
ExchangeOrder
Fields
| Field Name | Description |
|---|---|
id - ID!
|
|
created - DateTime
|
|
consolidatedOrderExchange - Boolean!
|
If True, the exchange order is part of a consolidated return. It uses the Shopify return integration instead of Draft order workflow |
status - ExchangeOrderStatus
|
Status of the exchange order |
theReturn - Return
|
|
draftOrderId - String!
|
The Shopify draft order id. Created when the customer requests an exchange |
draftOrderNumber - String!
|
The Shopify draft order number e.g #D66 |
shopifyExchangeShipmentOrderId - String!
|
When we facilitate fulfillment with another order, this is the Shopify order id of that order |
shopifyExchangeShipmentOrderName - String!
|
...and this is the Shopify order name of that order |
completedOrderId - String!
|
The Shopify completed order id. This is only set when the order is completed by the shop |
completedOrderNumber - String!
|
The Shopify completed order number e.g #1218 |
completedOrderAt - DateTime
|
|
invoiceSentAt - DateTime
|
|
exchangeItems - [ExchangeItem!]
|
|
statusLabel - String
|
Status label for the exchange order |
completeOrderLink - String
|
URL Link to the completed order in Shopify |
draftOrderLink - String
|
URL Link to the draft order in Shopify |
consolidatedOrderLink - String
|
URL Link to the original order in Shopify |
Example
{
"id": "4",
"created": "2007-12-03T10:15:30Z",
"consolidatedOrderExchange": true,
"status": "DRAFT",
"theReturn": Return,
"draftOrderId": "xyz789",
"draftOrderNumber": "xyz789",
"shopifyExchangeShipmentOrderId": "xyz789",
"shopifyExchangeShipmentOrderName": "xyz789",
"completedOrderId": "abc123",
"completedOrderNumber": "xyz789",
"completedOrderAt": "2007-12-03T10:15:30Z",
"invoiceSentAt": "2007-12-03T10:15:30Z",
"exchangeItems": [ExchangeItem],
"statusLabel": "xyz789",
"completeOrderLink": "xyz789",
"draftOrderLink": "abc123",
"consolidatedOrderLink": "xyz789"
}
ExchangeOrderStatus
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"DRAFT"
FiltersInput
Fields
| Input Field | Description |
|---|---|
query - String
|
|
stages - [Int]
|
|
status - ArchiveFilter
|
|
returnDate - DateFilterRange
|
|
orderDate - DateFilterRange
|
|
stageUpdatedDate - DateFilterRange
|
|
perPage - Int
|
|
currentPage - Int
|
|
sortBy - String
|
|
resolvedStatus - [ResolvedStatus]
|
|
returnItemTypes - [String]
|
Example
{
"query": "abc123",
"stages": [987],
"status": "ACTIVE",
"returnDate": DateFilterRange,
"orderDate": DateFilterRange,
"stageUpdatedDate": DateFilterRange,
"perPage": 987,
"currentPage": 123,
"sortBy": "abc123",
"resolvedStatus": ["RESOLVED"],
"returnItemTypes": ["xyz789"]
}
Float
Description
The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.
Example
123.45
GQLErrorEnum
Description
Enum for all GQL errors
Important: Prefix all errors with name of the integration (e.g. RZ_, SHOPIFY_, EASYPOST_, etc)
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"RZ_RULES_ERROR"
GQLErrorType
Fields
| Field Name | Description |
|---|---|
errorCode - GQLErrorEnum
|
The code for the error |
message - String
|
Human readable textual error representation (do not use for machine logic) |
traceId - String
|
Trace ID for the error, you can share this with the ReturnZap customer support |
debugTrace - String
|
Debug information for the error We don't send backend debug info to frontend. |
Example
{
"errorCode": "RZ_RULES_ERROR",
"message": "abc123",
"traceId": "xyz789",
"debugTrace": "xyz789"
}
GenerateUploadURL
ID
Description
The ID scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an ID.
Example
4
ImageUploadsSetting
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"DISABLE_IMAGE_UPLOAD"
Int
Description
The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
Example
123
JSONString
Description
Allows use of a JSON String for input / output from the GraphQL schema.
Use of this type is not recommended as you lose the benefits of having a defined, static schema (one of the key benefits of GraphQL).
Example
JSONString
LedgerConnection
Description
Connection type for Ledger with additional fields.
Fields
| Field Name | Description |
|---|---|
pageInfo - PageInfo!
|
Pagination data for this connection. |
edges - [LedgerEdge]!
|
Contains the nodes in this connection. |
Example
{
"pageInfo": PageInfo,
"edges": [LedgerEdge]
}
LedgerEdge
Description
A Relay edge containing a Ledger and its cursor.
Fields
| Field Name | Description |
|---|---|
node - LedgerNode
|
The item at the end of the edge |
cursor - String!
|
A cursor for use in pagination |
Example
{
"node": LedgerNode,
"cursor": "abc123"
}
LedgerEntryType
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"MANUAL_CREDIT"
LedgerNode
Fields
| Field Name | Description |
|---|---|
id - ID!
|
The ID of the object |
createdAt - DateTime!
|
|
amount - Decimal!
|
Amount of this ledger entry (positive if credit, negative if debit) |
currency - BalancesLedgerEntryCurrencyChoices!
|
Currency code |
entryType - LedgerEntryType
|
|
description - String!
|
Human-readable description of this ledger entry |
paymentMethod - ShopPaymentMethod
|
|
settledAt - DateTime
|
When this entry was settled, if null it means it is pending |
Example
{
"id": "4",
"createdAt": "2007-12-03T10:15:30Z",
"amount": Decimal,
"currency": "USD",
"entryType": "MANUAL_CREDIT",
"description": "xyz789",
"paymentMethod": ShopPaymentMethod,
"settledAt": "2007-12-03T10:15:30Z"
}
LengthUnit
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"INCHES"
LoadBalance
Description
Load balance using a saved payment method.
Fields
| Field Name | Description |
|---|---|
success - Boolean
|
|
message - String
|
|
ledgerEntryId - ID
|
|
errors - [GQLErrorType]
|
Example
{
"success": false,
"message": "abc123",
"ledgerEntryId": "4",
"errors": [GQLErrorType]
}
Money
MoneySet
Node
Description
An object with an ID
Fields
| Field Name | Description |
|---|---|
id - ID!
|
The ID of the object |
Possible Types
| Node Types |
|---|
Example
{"id": "4"}
Notification
Example
{
"id": "4",
"emailSubject": "xyz789",
"emailContent": "abc123",
"shouldAttachRmaForm": true,
"isActive": true,
"event": "STAGE_ENTRY",
"uuid": "4",
"stage": Stage
}
NotificationEvent
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"STAGE_ENTRY"
NotificationInput
Example
{
"id": 4,
"event": "STAGE_ENTRY",
"emailSubject": "xyz789",
"emailContent": "xyz789",
"isActive": true,
"shouldAttachRmaForm": false
}
OrderInvoiceSend
Fields
| Field Name | Description |
|---|---|
errors - [GQLErrorType!]!
|
Example
{"errors": [GQLErrorType]}
PackageCreate
Fields
| Field Name | Description |
|---|---|
package - PackageType
|
Example
{"package": PackageType}
PackageDelete
Fields
| Field Name | Description |
|---|---|
error - String
|
Example
{"error": "abc123"}
PackageInput
Fields
| Input Field | Description |
|---|---|
id - ID
|
|
name - String!
|
|
type - String!
|
|
width - Float!
|
|
height - Float!
|
|
length - Float!
|
|
unit - ShopsPackageUnitChoices!
|
|
weight - Float!
|
|
weightUnit - ShopsPackageWeightUnitChoices!
|
Example
{
"id": "4",
"name": "abc123",
"type": "abc123",
"width": 123.45,
"height": 987.65,
"length": 123.45,
"unit": "IN",
"weight": 123.45,
"weightUnit": "GRAMS"
}
PackageType
Fields
| Field Name | Description |
|---|---|
id - ID!
|
|
name - String!
|
|
type - String!
|
|
length - Float
|
|
width - Float
|
|
height - Float
|
|
unit - ShopsPackageUnitChoices!
|
|
weight - Float
|
|
weightUnit - ShopsPackageWeightUnitChoices!
|
|
uuid - ID
|
Example
{
"id": 4,
"name": "xyz789",
"type": "abc123",
"length": 987.65,
"width": 123.45,
"height": 123.45,
"unit": "IN",
"weight": 123.45,
"weightUnit": "GRAMS",
"uuid": 4
}
PackageUpdate
Fields
| Field Name | Description |
|---|---|
error - String
|
|
package - PackageType
|
Example
{
"error": "abc123",
"package": PackageType
}
PageInfo
Description
The Relay compliant PageInfo type, containing data necessary to paginate this connection.
Fields
| Field Name | Description |
|---|---|
hasNextPage - Boolean!
|
When paginating forwards, are there more items? |
hasPreviousPage - Boolean!
|
When paginating backwards, are there more items? |
startCursor - String
|
When paginating backwards, the cursor to continue. |
endCursor - String
|
When paginating forwards, the cursor to continue. |
Example
{
"hasNextPage": false,
"hasPreviousPage": true,
"startCursor": "abc123",
"endCursor": "xyz789"
}
PaymentMethodType
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"BANK_ACCOUNT"
PolicyMetricType
PortalExchangeSelectionMethod
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"SEARCH"
PortalVisualExchangeType
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
Example
"NONE"
PrimaryFieldBehavior
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"EMAIL_ADDRESS"
ProductReasonMetricType
PutTaxNumbers
Fields
| Field Name | Description |
|---|---|
errors - [GQLErrorType]
|
|
taxNumbers - [TaxNumberOutput]
|
Example
{
"errors": [GQLErrorType],
"taxNumbers": [TaxNumberOutput]
}
Question
Fields
| Field Name | Description |
|---|---|
id - UUID!
|
|
questionType - QuestionType
|
|
order - Int!
|
|
text - String!
|
|
isRequired - Boolean!
|
|
dependentOnReturnReason - Boolean!
|
Only show after a return reason is selected |
dependentOnQuestion - Question
|
|
choices - [QuestionChoice]
|
|
dependentOnReturnReasons - [ReturnReason]
|
|
dependentOnQuestionChoices - [QuestionChoice]
|
|
isActive - Boolean
|
Example
{
"id": "a7b25635-2b7c-42da-9fa3-d967ab9051c5",
"questionType": "LONG_TEXT",
"order": 987,
"text": "abc123",
"isRequired": true,
"dependentOnReturnReason": false,
"dependentOnQuestion": Question,
"choices": [QuestionChoice],
"dependentOnReturnReasons": [ReturnReason],
"dependentOnQuestionChoices": [QuestionChoice],
"isActive": false
}
QuestionChoice
QuestionChoiceInput
QuestionInput
Example
{
"id": 4,
"order": 123,
"questionType": "LONG_TEXT",
"text": "xyz789",
"isRequired": true,
"isActive": true,
"deleted": true,
"choices": [QuestionChoiceInput],
"dependentOnReturnReasons": ["4"],
"dependentOnQuestion": "4",
"dependentOnQuestionChoices": ["4"]
}
QuestionType
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"LONG_TEXT"
ReasonMetricType
ReceivedReturn
RefFieldSource
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
Example
"BLANK"
RefundReturn
Fields
| Field Name | Description |
|---|---|
error - String
|
|
return - Return
|
|
refund - RefundType
|
Example
{
"error": "xyz789",
"return": Return,
"refund": RefundType
}
RefundType
Fields
| Field Name | Description |
|---|---|
shopifyRefundId - String!
|
|
presentmentTotalAmountRefunded - Decimal
|
|
presentmentCurrencyCode - String!
|
|
presentmentSubtotalRefundAmount - Decimal
|
|
presentmentTaxRefundAmount - Decimal
|
|
presentmentShippingSubtotalRefundAmount - Decimal
|
|
presentmentShippingTaxRefundAmount - Decimal
|
|
shopTotalAmountRefunded - Decimal
|
|
shopRefundCurrencyCode - String!
|
|
shopSubtotalRefundAmount - Decimal
|
|
shopTaxRefundAmount - Decimal
|
|
shopShippingSubtotalRefundAmount - Decimal
|
|
shopShippingTaxRefundAmount - Decimal
|
|
currencyCode - String
|
Use presentmentCurrencyCode instead
|
totalAmountRefunded - Decimal
|
Use presentmentTotalAmountRefunded instead
|
Example
{
"shopifyRefundId": "xyz789",
"presentmentTotalAmountRefunded": Decimal,
"presentmentCurrencyCode": "abc123",
"presentmentSubtotalRefundAmount": Decimal,
"presentmentTaxRefundAmount": Decimal,
"presentmentShippingSubtotalRefundAmount": Decimal,
"presentmentShippingTaxRefundAmount": Decimal,
"shopTotalAmountRefunded": Decimal,
"shopRefundCurrencyCode": "abc123",
"shopSubtotalRefundAmount": Decimal,
"shopTaxRefundAmount": Decimal,
"shopShippingSubtotalRefundAmount": Decimal,
"shopShippingTaxRefundAmount": Decimal,
"currencyCode": "abc123",
"totalAmountRefunded": Decimal
}
RegisterUser
Description
This mutation takes a session token from the frontend and uses it to retrieve more details about the user. Those details are then used to create or update the user's profile.
Fields
| Field Name | Description |
|---|---|
user - ShopifyUser
|
Example
{"user": ShopifyUser}
RejectReturn
ReleaseExchangeItemsMutation
Fields
| Field Name | Description |
|---|---|
errors - [String]
|
|
exchangeOrders - [ExchangeOrder]
|
Use exchange_items instead |
exchangeItems - [ExchangeItem]
|
|
return_ - Return
|
Example
{
"errors": ["abc123"],
"exchangeOrders": [ExchangeOrder],
"exchangeItems": [ExchangeItem],
"return_": Return
}
ResendRMAForm
Fields
| Field Name | Description |
|---|---|
error - String
|
Example
{"error": "abc123"}
ResolutionStatus
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"AUTO"
ResolvedStatus
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"RESOLVED"
RestockingFeeType
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"ONCE_PER_RETURN"
Return
Fields
| Field Name | Description |
|---|---|
id - ID!
|
|
uuid - String!
|
|
adminReturn - Boolean!
|
|
testMode - Boolean!
|
|
returnIntegration - Boolean!
|
|
usesConsolidatedOrderExchanges - Boolean
|
True if there's at least one exchange that uses consolidated order exchanges. |
customerFirstName - String!
|
|
customerLastName - String!
|
|
customerEmail - String!
|
|
rmaNumber - String!
|
|
stageLabel - String!
|
|
stageUpdatedDate - DateTime
|
|
approvalRequired - Boolean
|
|
approvedAt - DateTime
|
|
rejectedAt - DateTime
|
|
receivedAt - DateTime
|
|
isArchived - Boolean
|
|
expiredAt - DateTime
|
|
shippingMethod - ShippingMethod
|
|
shippedTo - String!
|
|
trackingNumber - String!
|
|
deliveryDate - DateTime
|
|
deliveryStatus - String!
|
|
labelCurrency - String!
|
|
shopCurrency - String!
|
|
noShippingRequired - Boolean!
|
|
feesSentThroughReturnIntegration - Boolean!
|
In issue #1545 we started sending shipping and restocking fees to Shopify when creating a return. |
defaultRefundFee - Decimal
|
|
defaultStoreCreditFee - Decimal
|
|
originalHandlingFeeCharged - Decimal
|
The handling fee charged to the customer when the return was created |
actualHandlingFeeCharged - Decimal
|
The handling fee actually charged to the customer through ReturnZap resolutions |
restockingFeeType - RestockingFeeType
|
|
originalRestockingFeeCharged - Decimal
|
The restocking fee charged to the customer when the return was created |
actualRestockingFeeCharged - Decimal
|
The restocking fee actually charged to the customer through ReturnZap resolutions |
shopifyReturnId - String
|
|
shopifyReturnName - String!
|
|
shopifyReturnSyncError - ReturnSyncError
|
|
shopifyOrderId - String!
|
|
shopifyOrderDate - DateTime
|
|
exchangeBalanceDue - Decimal
|
The balance due for the exchange |
exchangeBalancePaidAt - DateTime
|
|
estimatedBalance - Decimal
|
The estimated amount show to the customer in the portal. If positive, the shop owes the customer this amount. If negative, the customer owes the shop this amount. Added in 2025-04 and not backfilled. |
shopifyOrderNumber - String!
|
|
shopifyOrderUrl - String!
|
|
shopifyCustomerUrl - String!
|
|
customerAddress - ReturnAddressType
|
|
destinationAddress - ReturnAddressType
|
|
rmaFormUrl - String
|
|
stageId - ID
|
|
systemStage - Int
|
|
statusId - String
|
|
statusLabel - String
|
|
labelUrl - String
|
|
qrCodeUrl - String
|
|
labelCost - Decimal
|
|
totalWeightGrams - Decimal
|
|
createdAt - DateTime
|
|
refunds - [RefundType]
|
|
logs - [ReturnLog!]!
|
|
next - String
|
Use nextReturn instead
|
previous - String
|
Use previousReturn instead
|
nextReturn - Return
|
|
previousReturn - Return
|
|
exchangeOrders - [ExchangeOrder!]
|
|
shipment - Shipment
|
|
appliedRules - [String]
|
|
suggestionRefund - SuggestionRefundType
|
Use suggestedRefund instead
|
suggestedRefund - SuggestedRefundType
|
|
hasValidCustomerPaymentPending - Boolean
|
|
warehouseName - String
|
|
storeCredits - [StoreCreditType]
|
|
externalShippingLabelUrl - String
|
|
items - [ReturnItem]
|
|
exchangeItems - [ExchangeItem]
|
|
handlingFeeCharged - Decimal
|
Use (actual|original)_handling_fee_charged instead
|
restockingFeeCharged - Decimal
|
Use (actual|original)_restocking_fee_charged instead
|
shopifyOrderFulfillments - [ShopifyFulfillmentType]
|
|
shopifyOrderTotalQuantityOrdered - Int
|
|
shopifyOrderTotalQuantityReturnItems - Int
|
|
shopifyOrderTags - [String]
|
|
shopifyOrderCustomerTags - [String]
|
|
shopifyReturnSyncStatus - ShopifyReturnSyncStatus
|
|
orderId - String!
|
Use shopifyOrderId instead
|
orderNumber - String!
|
Use shopifyOrderNumber instead
|
orderDate - DateTime
|
Use shopifyOrderDate instead
|
returnDate - DateTime
|
Use createdAt instead
|
isActive - Boolean
|
Use isArchived instead
|
unitQuantity - Int
|
|
returnValueAmount - Decimal
|
Sum of items (item quantity * item discounted amount) |
resolvedStatus - ResolvedStatus
|
Status indicating the resolution state of the return items |
returnItemTypes - [String]
|
List of return item types e.g. ["REFUND", "CREDIT", "EXCHANGE"] |
returnTypeLabels - [String]
|
List of return item type labels e.g. ["Refund", "Store Credit", "Exchange"] |
Example
{
"id": 4,
"uuid": "abc123",
"adminReturn": true,
"testMode": false,
"returnIntegration": false,
"usesConsolidatedOrderExchanges": true,
"customerFirstName": "xyz789",
"customerLastName": "xyz789",
"customerEmail": "abc123",
"rmaNumber": "xyz789",
"stageLabel": "xyz789",
"stageUpdatedDate": "2007-12-03T10:15:30Z",
"approvalRequired": false,
"approvedAt": "2007-12-03T10:15:30Z",
"rejectedAt": "2007-12-03T10:15:30Z",
"receivedAt": "2007-12-03T10:15:30Z",
"isArchived": false,
"expiredAt": "2007-12-03T10:15:30Z",
"shippingMethod": "FREE",
"shippedTo": "xyz789",
"trackingNumber": "abc123",
"deliveryDate": "2007-12-03T10:15:30Z",
"deliveryStatus": "xyz789",
"labelCurrency": "abc123",
"shopCurrency": "xyz789",
"noShippingRequired": false,
"feesSentThroughReturnIntegration": false,
"defaultRefundFee": Decimal,
"defaultStoreCreditFee": Decimal,
"originalHandlingFeeCharged": Decimal,
"actualHandlingFeeCharged": Decimal,
"restockingFeeType": "ONCE_PER_RETURN",
"originalRestockingFeeCharged": Decimal,
"actualRestockingFeeCharged": Decimal,
"shopifyReturnId": "xyz789",
"shopifyReturnName": "xyz789",
"shopifyReturnSyncError": "UNKNOWN_ERROR",
"shopifyOrderId": "abc123",
"shopifyOrderDate": "2007-12-03T10:15:30Z",
"exchangeBalanceDue": Decimal,
"exchangeBalancePaidAt": "2007-12-03T10:15:30Z",
"estimatedBalance": Decimal,
"shopifyOrderNumber": "xyz789",
"shopifyOrderUrl": "xyz789",
"shopifyCustomerUrl": "xyz789",
"customerAddress": ReturnAddressType,
"destinationAddress": ReturnAddressType,
"rmaFormUrl": "xyz789",
"stageId": 4,
"systemStage": 987,
"statusId": "abc123",
"statusLabel": "xyz789",
"labelUrl": "xyz789",
"qrCodeUrl": "xyz789",
"labelCost": Decimal,
"totalWeightGrams": Decimal,
"createdAt": "2007-12-03T10:15:30Z",
"refunds": [RefundType],
"logs": [ReturnLog],
"next": "abc123",
"previous": "abc123",
"nextReturn": Return,
"previousReturn": Return,
"exchangeOrders": [ExchangeOrder],
"shipment": Shipment,
"appliedRules": ["xyz789"],
"suggestionRefund": SuggestionRefundType,
"suggestedRefund": SuggestedRefundType,
"hasValidCustomerPaymentPending": false,
"warehouseName": "xyz789",
"storeCredits": [StoreCreditType],
"externalShippingLabelUrl": "xyz789",
"items": [ReturnItem],
"exchangeItems": [ExchangeItem],
"handlingFeeCharged": Decimal,
"restockingFeeCharged": Decimal,
"shopifyOrderFulfillments": [ShopifyFulfillmentType],
"shopifyOrderTotalQuantityOrdered": 987,
"shopifyOrderTotalQuantityReturnItems": 123,
"shopifyOrderTags": ["xyz789"],
"shopifyOrderCustomerTags": ["abc123"],
"shopifyReturnSyncStatus": "UNSYNCABLE",
"orderId": "xyz789",
"orderNumber": "xyz789",
"orderDate": "2007-12-03T10:15:30Z",
"returnDate": "2007-12-03T10:15:30Z",
"isActive": false,
"unitQuantity": 987,
"returnValueAmount": Decimal,
"resolvedStatus": "RESOLVED",
"returnItemTypes": ["xyz789"],
"returnTypeLabels": ["abc123"]
}
ReturnAddressType
Example
{
"name": "abc123",
"company": "abc123",
"street1": "abc123",
"street2": "xyz789",
"city": "xyz789",
"state": "abc123",
"zip": "abc123",
"phone": "abc123",
"email": "xyz789",
"country": "abc123",
"warehouseId": "4"
}
ReturnExport
ReturnItem
Fields
| Field Name | Description |
|---|---|
id - ID!
|
|
shopifyVariantId - String!
|
|
sku - String!
|
|
productTitle - String!
|
|
variantTitle - String!
|
|
variantDisplayName - String!
|
|
quantity - Int!
|
|
value - Decimal
|
Full unit price in shop currency |
presentmentOriginalAmount - Decimal
|
The variant unit amount without discounts applied in presentment currency |
discountedAmount - Decimal
|
Actual amount customer paid in shop currency |
presentmentDiscountedAmount - Decimal
|
Actual amount customer paid per unit in presentment currency |
presentmentCurrency - String!
|
|
vendor - String!
|
The name of the vendor who made the variant from Shopify. |
returnReason - String!
|
|
comment - String!
|
|
exchangeOrder - ExchangeOrder
|
The exchange order created for this return item |
isMissing - Boolean!
|
Is missing from return package |
isResolvedManually - Boolean!
|
Is resolved manually |
skipRestock - Boolean!
|
Flag indicating whether to temporarily skip restocking for the returned item. This item may be restocked in the future, depending on the disposition status. |
restockingFee - Decimal
|
The current shop restocking fee applied to the item |
handlingFee - Decimal
|
The current shop handling fee applied to the item |
storeCreditIncentiveAmount - Decimal
|
The current shop store credit's incentive amount applied to the item |
expiredAt - DateTime
|
|
actuallyResolvedAt - DateTime
|
Date the admin has resolved this item. |
autoResolvedAt - DateTime
|
Date the system has automatically resolved this item. |
variant - String
|
Use variantTitle instead |
title - String
|
Use variantDisplayName instead |
titleClean - String
|
Use productTitle instead |
returnType - ReturnType
|
|
returnTypeLabel - String
|
|
returnReasonId - Int
|
|
returnReasonLabel - String
|
|
images - [String]
|
|
files - [ReturnItemFileType]
|
|
answers - [ReturnItemAnswerType]
|
|
isRefunded - Boolean
|
|
currency - String
|
Shop currency code e.g. USD |
dispositionType - String
|
Disposition type that was set on the return item on Shopify e.g. restock, missing |
imageUrl - String
|
|
variants - [String!]!
|
|
exchangeItem - ExchangeItem
|
|
resolvedAt - DateTime
|
|
resolutionStatus - ResolutionStatus
|
|
productHsCode - String
|
|
productCountryOfOrigin - String
|
|
totalWeightGrams - Decimal
|
Example
{
"id": 4,
"shopifyVariantId": "xyz789",
"sku": "xyz789",
"productTitle": "xyz789",
"variantTitle": "xyz789",
"variantDisplayName": "abc123",
"quantity": 987,
"value": Decimal,
"presentmentOriginalAmount": Decimal,
"discountedAmount": Decimal,
"presentmentDiscountedAmount": Decimal,
"presentmentCurrency": "xyz789",
"vendor": "abc123",
"returnReason": "xyz789",
"comment": "xyz789",
"exchangeOrder": ExchangeOrder,
"isMissing": true,
"isResolvedManually": true,
"skipRestock": false,
"restockingFee": Decimal,
"handlingFee": Decimal,
"storeCreditIncentiveAmount": Decimal,
"expiredAt": "2007-12-03T10:15:30Z",
"actuallyResolvedAt": "2007-12-03T10:15:30Z",
"autoResolvedAt": "2007-12-03T10:15:30Z",
"variant": "xyz789",
"title": "xyz789",
"titleClean": "xyz789",
"returnType": "REFUND",
"returnTypeLabel": "abc123",
"returnReasonId": 987,
"returnReasonLabel": "xyz789",
"images": ["abc123"],
"files": [ReturnItemFileType],
"answers": [ReturnItemAnswerType],
"isRefunded": false,
"currency": "xyz789",
"dispositionType": "xyz789",
"imageUrl": "xyz789",
"variants": ["abc123"],
"exchangeItem": ExchangeItem,
"resolvedAt": "2007-12-03T10:15:30Z",
"resolutionStatus": "AUTO",
"productHsCode": "xyz789",
"productCountryOfOrigin": "xyz789",
"totalWeightGrams": Decimal
}
ReturnItemAnswerChoiceType
ReturnItemAnswerType
Fields
| Field Name | Description |
|---|---|
id - UUID!
|
|
questionType - QuestionType
|
|
order - Int!
|
|
questionText - String!
|
|
answer - String!
|
|
answerChoices - [ReturnItemAnswerChoiceType]
|
Example
{
"id": "a7b25635-2b7c-42da-9fa3-d967ab9051c5",
"questionType": "LONG_TEXT",
"order": 987,
"questionText": "abc123",
"answer": "xyz789",
"answerChoices": [ReturnItemAnswerChoiceType]
}
ReturnItemBulkDelete
ReturnItemBulkUpdate
ReturnItemBulkUpdateInput
Fields
| Input Field | Description |
|---|---|
returnType - ReturnType!
|
|
returnReason - ID!
|
Example
{
"returnType": "REFUND",
"returnReason": "4"
}
ReturnItemDelete
ReturnItemFileType
ReturnItemUpdate
ReturnItemUpdateInput
Fields
| Input Field | Description |
|---|---|
returnType - ReturnType!
|
|
returnReason - Int
|
|
quantity - Int!
|
|
comment - String!
|
Example
{
"returnType": "REFUND",
"returnReason": 123,
"quantity": 123,
"comment": "abc123"
}
ReturnItemUpdateSkipRestock
ReturnLog
Fields
| Field Name | Description |
|---|---|
id - ID!
|
|
message - String!
|
|
context - ReturnLogContext!
|
|
comment - String!
|
|
type - ReturnLogType!
|
|
messageCode - String
|
|
moment - DateTime!
|
|
returnItems - [ReturnItem!]!
|
|
exchangeItems - [ExchangeItem!]!
|
Example
{
"id": 4,
"message": "xyz789",
"context": ReturnLogContext,
"comment": "abc123",
"type": "LEGACY",
"messageCode": "abc123",
"moment": "2007-12-03T10:15:30Z",
"returnItems": [ReturnItem],
"exchangeItems": [ExchangeItem]
}
ReturnLogContext
Example
{
"id": 4,
"comment": "xyz789",
"userFirstName": "xyz789",
"userLastName": "abc123",
"stageLabel": "xyz789",
"itemsCount": 987,
"externalShipmentId": "xyz789",
"notificationType": "xyz789",
"to": "xyz789",
"shopifyOrderName": "xyz789",
"shopifyOrderId": "xyz789"
}
ReturnLogType
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"LEGACY"
ReturnLogUpdate
ReturnProductDetailMetricType
Fields
| Field Name | Description |
|---|---|
name - String
|
|
count - Int
|
|
url - String
|
|
reasons - [ProductReasonMetricType]
|
Example
{
"name": "xyz789",
"count": 987,
"url": "xyz789",
"reasons": [ProductReasonMetricType]
}
ReturnProductMetricType
Fields
| Field Name | Description |
|---|---|
products - [ReturnProductDetailMetricType]
|
|
variants - [ReturnProductDetailMetricType]
|
Example
{
"products": [ReturnProductDetailMetricType],
"variants": [ReturnProductDetailMetricType]
}
ReturnReason
Fields
| Field Name | Description |
|---|---|
id - Int!
|
|
uuid - ID
|
|
reason - String!
|
|
imageUploads - ImageUploadsSetting
|
|
order - Int
|
Example
{
"id": 987,
"uuid": "4",
"reason": "xyz789",
"imageUploads": "DISABLE_IMAGE_UPLOAD",
"order": 987
}
ReturnReasonInput
ReturnRuleActiveToggle
Fields
| Field Name | Description |
|---|---|
error - String
|
Example
{"error": "abc123"}
ReturnRuleCreateOrUpdate
ReturnRuleDelete
Fields
| Field Name | Description |
|---|---|
error - String
|
Example
{"error": "xyz789"}
ReturnSyncError
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"UNKNOWN_ERROR"
ReturnTransitionStage
ReturnType
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"REFUND"
ReturnUpdateStatus
ReturnsDeleteTestMode
Fields
| Field Name | Description |
|---|---|
success - Boolean
|
|
shop - AuthenticatedShop
|
Example
{"success": false, "shop": AuthenticatedShop}
ReturnsMetricType
Rule
Fields
| Field Name | Description |
|---|---|
id - ID
|
|
uuid - String!
|
|
isActive - Boolean
|
|
name - String!
|
|
rule - String
|
Human readable version. Use description instead. |
description - String
|
Human readable version. |
when - RuleWhen!
|
|
conditions - [Condition]!
|
|
action - RuleAction!
|
|
actionOption - RuleActionOption
|
|
unit - RuleUnit
|
|
value - String
|
|
message - String!
|
|
warehouseName - String
|
|
warehouseId - ID
|
|
destinationCountry - String
|
|
question - ID
|
|
questionChoices - [ID]
|
|
questionId - ID
|
Use question instead. |
questionChoiceId - ID
|
Use question_choices instead. |
windowDays - Int
|
Use value instead. |
Example
{
"id": 4,
"uuid": "abc123",
"isActive": false,
"name": "xyz789",
"rule": "abc123",
"description": "xyz789",
"when": "AND",
"conditions": [Condition],
"action": "DENY_RETURN",
"actionOption": "ALL",
"unit": "SHOP_DEFAULT_CURRENCY",
"value": "xyz789",
"message": "xyz789",
"warehouseName": "xyz789",
"warehouseId": "4",
"destinationCountry": "abc123",
"question": "4",
"questionChoices": [4],
"questionId": 4,
"questionChoiceId": "4",
"windowDays": 987
}
RuleAction
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"DENY_RETURN"
RuleActionOption
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"ALL"
RuleAttribute
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"NONE"
RuleInput
Fields
| Input Field | Description |
|---|---|
id - ID
|
|
name - String!
|
|
isActive - Boolean
|
|
when - RuleWhen!
|
|
conditions - [ConditionInput]!
|
|
action - RuleAction!
|
|
actionOption - RuleActionOption!
|
|
message - String!
|
|
warehouseId - ID
|
|
value - String
|
|
unit - RuleUnit
|
|
question - ID
|
|
questionChoices - [ID]
|
Example
{
"id": 4,
"name": "xyz789",
"isActive": false,
"when": "AND",
"conditions": [ConditionInput],
"action": "DENY_RETURN",
"actionOption": "ALL",
"message": "xyz789",
"warehouseId": 4,
"value": "abc123",
"unit": "SHOP_DEFAULT_CURRENCY",
"question": 4,
"questionChoices": ["4"]
}
RuleOperator
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"EQ"
RuleUnit
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"SHOP_DEFAULT_CURRENCY"
RuleWhen
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"AND"
SecondaryFieldBehavior
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"SHOPIFY_ORDER_NUMBER"
SendcloudAccount
SetupIntentResponseType
Fields
| Field Name | Description |
|---|---|
clientSecret - String!
|
Example
{"clientSecret": "xyz789"}
Shipment
ShipmentStatus
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"UNKNOWN"
ShippingMethod
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"FREE"
ShippoAccountCarrierMutation
Fields
| Field Name | Description |
|---|---|
error - String
|
|
carriers - [ShippoAccountCarrierType]
|
Example
{
"error": "abc123",
"carriers": [ShippoAccountCarrierType]
}
ShippoAccountCarrierType
Example
{
"id": 4,
"account": ShippoAccountType,
"isActive": true,
"shippoObjectId": "abc123",
"shippoCarrier": "xyz789",
"shippoCarrierName": "abc123"
}
ShippoAccountMutation
Fields
| Field Name | Description |
|---|---|
error - String
|
|
account - ShippoAccountType
|
Example
{
"error": "xyz789",
"account": ShippoAccountType
}
ShippoAccountType
Fields
| Field Name | Description |
|---|---|
id - ID!
|
|
shop - AuthenticatedShop
|
|
useIsReturn - Boolean!
|
|
services - String!
|
Comma delimited list of Shippo Services |
carriers - [ShippoAccountCarrierType]
|
Example
{
"id": "4",
"shop": AuthenticatedShop,
"useIsReturn": true,
"services": "xyz789",
"carriers": [ShippoAccountCarrierType]
}
ShippoCarrierServiceConfig
Example
{
"carrier": "abc123",
"displayName": "xyz789",
"service": "abc123",
"serviceDisplayName": "xyz789",
"width": Decimal,
"height": Decimal,
"unit": "IN",
"rotate": false
}
ShippoCarrierUpdateType
ShippoShippoCarrierServiceConfigUnitChoices
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
in |
|
|
cm |
Example
"IN"
ShopPaymentMethod
Fields
| Field Name | Description |
|---|---|
id - UUID!
|
|
createdAt - DateTime!
|
|
stripePaymentMethodId - String!
|
Stripe payment method ID (pm_...) |
paymentMethodType - PaymentMethodType
|
|
brand - String!
|
Card brand (visa, mastercard) or bank name |
lastFour - String!
|
Last 4 digits of card or account number |
bankName - String!
|
Bank name for ACH payments |
isActive - Boolean!
|
Whether this payment method is active and can be used |
isDefault - Boolean!
|
Whether this is the default payment method for auto-recharge |
Example
{
"id": "a7b25635-2b7c-42da-9fa3-d967ab9051c5",
"createdAt": "2007-12-03T10:15:30Z",
"stripePaymentMethodId": "abc123",
"paymentMethodType": "BANK_ACCOUNT",
"brand": "xyz789",
"lastFour": "abc123",
"bankName": "abc123",
"isActive": false,
"isDefault": false
}
ShopSubscriptionPlan
Fields
| Field Name | Description |
|---|---|
id - Int
|
|
uuid - String!
|
|
subscriptionType - SubscriptionType
|
|
price - Decimal
|
|
tiered - Boolean
|
|
tierCount - Int
|
|
overagePrice - Decimal
|
|
customQuoteSubscriptionType - SubscriptionType
|
|
customQuoteTierCount - Int
|
|
customQuoteMonthlyPrice - Decimal
|
|
customQuoteOveragePrice - Decimal
|
|
customQuoteAcceptedAt - DateTime
|
|
name - String
|
|
features - [SubscriptionFeature]
|
|
featuresInUse - [SubscriptionFeature]
|
|
hasValidSubscriptionCharge - Boolean
|
|
forceSelectSubscriptionPlan - Boolean
|
|
freeTrialDaysRemaining - Int
|
|
customQuoteSubscribeUrl - String
|
|
onCustomPlan - Boolean
|
|
billingPeriods - [BillingPeriodType]
|
Example
{
"id": 987,
"uuid": "abc123",
"subscriptionType": "FREE",
"price": Decimal,
"tiered": false,
"tierCount": 987,
"overagePrice": Decimal,
"customQuoteSubscriptionType": "FREE",
"customQuoteTierCount": 987,
"customQuoteMonthlyPrice": Decimal,
"customQuoteOveragePrice": Decimal,
"customQuoteAcceptedAt": "2007-12-03T10:15:30Z",
"name": "xyz789",
"features": ["ADJUST_RETURN_WINDOWS"],
"featuresInUse": ["ADJUST_RETURN_WINDOWS"],
"hasValidSubscriptionCharge": false,
"forceSelectSubscriptionPlan": false,
"freeTrialDaysRemaining": 123,
"customQuoteSubscribeUrl": "abc123",
"onCustomPlan": true,
"billingPeriods": [BillingPeriodType]
}
ShopifyFulfillmentType
Example
{
"id": "xyz789",
"name": "xyz789",
"status": "abc123",
"deliveredAt": "2007-12-03T10:15:30Z",
"totalQuantity": 123,
"trackingInfo": [ShopifyTrackingInfoType]
}
ShopifyLocation
ShopifyReturnSyncStatus
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
Example
"UNSYNCABLE"
ShopifyTrackingInfoType
ShopifyUser
Example
{
"id": 4,
"uuid": "xyz789",
"accountOwner": true,
"email": "xyz789",
"shopifyId": "abc123",
"firstName": "abc123",
"lastName": "xyz789",
"locale": "xyz789",
"preferredLocale": "xyz789",
"chatHash": "xyz789",
"shouldUpdate": false,
"shopifyRoles": "abc123"
}
ShopsPackageUnitChoices
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
in |
|
|
cm |
Example
"IN"
ShopsPackageWeightUnitChoices
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
GRAMS |
|
|
KILOGRAMS |
|
|
OUNCES |
|
|
POUNDS |
Example
"GRAMS"
SignedUrl
Stage
Fields
| Field Name | Description |
|---|---|
id - ID!
|
|
systemStage - SystemStage
|
|
label - String!
|
|
notification - Notification
|
|
createShopifyReturn - Boolean!
|
ReturnZap will create the Shopify return when the return's stage is changed to this one. |
tags - [String!]!
|
Tags to apply to the Shopify Order when return is moved to this stage. |
uuid - ID!
|
|
archived - Boolean!
|
|
shipmentStatus - ShipmentStatus
|
Use shipment_statuses instead. |
shipmentStatuses - [ShipmentStatus]
|
Example
{
"id": "4",
"systemStage": "AUTOMATICALLY_APPROVED",
"label": "abc123",
"notification": Notification,
"createShopifyReturn": true,
"tags": ["abc123"],
"uuid": 4,
"archived": true,
"shipmentStatus": "UNKNOWN",
"shipmentStatuses": ["UNKNOWN"]
}
StageInput
Example
{
"id": "4",
"uuid": "4",
"systemStage": "AUTOMATICALLY_APPROVED",
"label": "xyz789",
"generateLabel": true,
"createShopifyReturn": true,
"tags": ["xyz789"],
"archived": true,
"deleted": true
}
StageMetricType
StageShipmentStatusInput
Fields
| Input Field | Description |
|---|---|
shipmentStatus - ShipmentStatus!
|
|
stageId - ID!
|
Example
{"shipmentStatus": "UNKNOWN", "stageId": 4}
StageShipmentStatusType
Fields
| Field Name | Description |
|---|---|
stage - Stage
|
|
shipmentStatus - ShipmentStatus
|
Example
{"stage": Stage, "shipmentStatus": "UNKNOWN"}
StoreCreditIncentiveType
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
Example
"ONCE_PER_ITEM"
StoreCreditType
Fields
| Field Name | Description |
|---|---|
id - ID!
|
|
created - DateTime
|
|
storeCreditType - AutomatedStoreCreditType
|
|
code - String!
|
|
shopifyId - String!
|
|
amount - Decimal!
|
|
currency - String!
|
|
returnItems - [ReturnItem!]!
|
Example
{
"id": "4",
"created": "2007-12-03T10:15:30Z",
"storeCreditType": "DISCOUNT_CODE",
"code": "abc123",
"shopifyId": "abc123",
"amount": Decimal,
"currency": "abc123",
"returnItems": [ReturnItem]
}
String
Description
The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
Example
"xyz789"
SubscriptionFeature
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"ADJUST_RETURN_WINDOWS"
SubscriptionPlan
Fields
| Field Name | Description |
|---|---|
id - Int!
|
|
uuid - ID!
|
|
subscriptionType - SubscriptionType!
|
|
tiered - Boolean!
|
|
name - String!
|
|
features - [SubscriptionFeature]!
|
|
exclusiveFeatures - [SubscriptionFeature]!
|
|
featuresWouldBeLost - [SubscriptionFeature]!
|
|
tiers - [SubscriptionPlanTierType]!
|
|
price - Decimal
|
Use monthlyPrice on tiers instead |
published - Boolean
|
Only published plans are visible to customers |
subscribeUrl - String
|
Use subscribe_url on tiers instead |
Example
{
"id": 987,
"uuid": "4",
"subscriptionType": "FREE",
"tiered": true,
"name": "xyz789",
"features": ["ADJUST_RETURN_WINDOWS"],
"exclusiveFeatures": ["ADJUST_RETURN_WINDOWS"],
"featuresWouldBeLost": ["ADJUST_RETURN_WINDOWS"],
"tiers": [SubscriptionPlanTierType],
"price": Decimal,
"published": true,
"subscribeUrl": "abc123"
}
SubscriptionPlanTierType
SubscriptionType
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"FREE"
SuggestedRefundType
Fields
| Field Name | Description |
|---|---|
productsSet - MoneySet
|
|
taxesSet - MoneySet
|
|
subtotalSet - MoneySet
|
|
exchangesSet - MoneySet
|
|
shippingSet - MoneySet
|
|
availableForRefundSet - MoneySet
|
|
suggestedRefundSet - MoneySet
|
|
handlingFeeChargedSet - MoneySet
|
|
handlingFeeSuggestedSet - MoneySet
|
|
restockingFeeChargedSet - MoneySet
|
|
restockingFeeSuggestedSet - MoneySet
|
|
storeCreditIncentiveAmountSet - MoneySet
|
Example
{
"productsSet": MoneySet,
"taxesSet": MoneySet,
"subtotalSet": MoneySet,
"exchangesSet": MoneySet,
"shippingSet": MoneySet,
"availableForRefundSet": MoneySet,
"suggestedRefundSet": MoneySet,
"handlingFeeChargedSet": MoneySet,
"handlingFeeSuggestedSet": MoneySet,
"restockingFeeChargedSet": MoneySet,
"restockingFeeSuggestedSet": MoneySet,
"storeCreditIncentiveAmountSet": MoneySet
}
SuggestionRefundType
Fields
| Field Name | Description |
|---|---|
taxesIncluded - Boolean
|
Whether taxes are included in the subtotal price of the order. |
currency - String
|
Currency code e.g. USD |
shopCurrency - String
|
Shop currency code e.g. USD |
discountedSubtotalAmount - Decimal
|
The sum of all the discounted prices of the line items being refunded. |
shopDiscountedSubtotalAmount - Decimal
|
The sum of all the discounted prices of the line items being refunded in Shop currency. |
totalTaxAmount - Decimal
|
Total tax amount on original order |
shopTotalTaxAmount - Decimal
|
Total tax amount on original order in shop currency |
totalTaxAmountForReturnedItems - Decimal
|
Total tax amount for the items being returned |
shopTotalTaxAmountForReturnedItems - Decimal
|
Total tax amount for the items being returned in shop currency |
shippingAmount - Decimal
|
Shipping amount to refund for the selected line items |
shopShippingAmount - Decimal
|
Shipping shop amount to refund for the selected line items |
shippingTaxAmount - Decimal
|
Shipping tax amount to refund for the selected line items |
shopTaxShippingAmount - Decimal
|
Shipping shop tax amount to refund for the selected line items |
shippingTaxAmountForReturnedItems - Decimal
|
Shipping tax amount for the items being returned |
shopShippingTaxAmountForReturnedItems - Decimal
|
Shipping shop tax amount for the items being returned in shop currency |
totalAmount - Decimal
|
Total amount to refund for the selected line items + shipping amount |
shopTotalAmount - Decimal
|
Total shop amount to refund for the selected line items + shipping amount |
suggestedAmountForReturnedItems - Decimal
|
Suggested refund for the returned items |
shopSuggestedAmountForReturnedItems - Decimal
|
Suggested refund for the returned items in shop currency |
Example
{
"taxesIncluded": true,
"currency": "xyz789",
"shopCurrency": "xyz789",
"discountedSubtotalAmount": Decimal,
"shopDiscountedSubtotalAmount": Decimal,
"totalTaxAmount": Decimal,
"shopTotalTaxAmount": Decimal,
"totalTaxAmountForReturnedItems": Decimal,
"shopTotalTaxAmountForReturnedItems": Decimal,
"shippingAmount": Decimal,
"shopShippingAmount": Decimal,
"shippingTaxAmount": Decimal,
"shopTaxShippingAmount": Decimal,
"shippingTaxAmountForReturnedItems": Decimal,
"shopShippingTaxAmountForReturnedItems": Decimal,
"totalAmount": Decimal,
"shopTotalAmount": Decimal,
"suggestedAmountForReturnedItems": Decimal,
"shopSuggestedAmountForReturnedItems": Decimal
}
SystemStage
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"AUTOMATICALLY_APPROVED"
TOSStatusType
Example
{
"accepted": false,
"version": "xyz789",
"timestamp": "2007-12-03T10:15:30Z",
"acceptedByUserId": "4",
"acceptedByName": "abc123",
"acceptedByEmail": "xyz789"
}
TaxNumberInput
Fields
| Input Field | Description |
|---|---|
id - ID
|
|
taxNumberType - TaxNumberType!
|
|
country - String!
|
|
value - String!
|
Example
{
"id": "4",
"taxNumberType": "VAT",
"country": "xyz789",
"value": "abc123"
}
TaxNumberOutput
Fields
| Field Name | Description |
|---|---|
id - UUID!
|
|
taxNumberType - TaxNumberType!
|
|
country - String!
|
|
value - String!
|
|
errors - [GQLErrorType]
|
Example
{
"id": "a7b25635-2b7c-42da-9fa3-d967ab9051c5",
"taxNumberType": "VAT",
"country": "xyz789",
"value": "xyz789",
"errors": [GQLErrorType]
}
TaxNumberType
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"VAT"
TranslatedModel
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"RETURN_REASON"
UUID
Description
Leverages the internal Python implementation of UUID (uuid.UUID) to provide native UUID objects in fields, resolvers and input.
Example
"a7b25635-2b7c-42da-9fa3-d967ab9051c5"
UpdateBalanceSettings
Description
Update balance settings including auto-recharge configuration.
Fields
| Field Name | Description |
|---|---|
balanceSettings - BalanceSettingsType
|
|
errors - [GQLErrorType]
|
Example
{
"balanceSettings": BalanceSettingsType,
"errors": [GQLErrorType]
}
UpdateMissingReturnItems
UpdatePaymentMethod
Description
Set a payment method as the default for the shop.
Fields
| Field Name | Description |
|---|---|
paymentMethod - ShopPaymentMethod
|
|
success - Boolean
|
|
errors - [GQLErrorType]
|
Example
{
"paymentMethod": ShopPaymentMethod,
"success": false,
"errors": [GQLErrorType]
}
UpdateResolveReturnItems
UpdateReturn
UpdateSettings
Fields
| Field Name | Description |
|---|---|
success - Boolean
|
|
error - String
|
|
shop - AuthenticatedShop
|
Example
{
"success": true,
"error": "abc123",
"shop": AuthenticatedShop
}
UpdateUserPreferences
Description
This mutation updates the user preferences
Fields
| Field Name | Description |
|---|---|
success - Boolean
|
|
user - ShopifyUser
|
Example
{"success": true, "user": ShopifyUser}
VoidShipment
WarehouseAddressInput
Example
{
"userName": "abc123",
"company": "abc123",
"street1": "xyz789",
"phone": "xyz789",
"street2": "xyz789",
"country": "abc123",
"city": "xyz789",
"zip": "abc123",
"state": "abc123"
}
WarehouseCreate
Fields
| Field Name | Description |
|---|---|
error - String
|
|
warehouse - WarehouseType
|
Example
{
"error": "abc123",
"warehouse": WarehouseType
}
WarehouseDelete
Fields
| Field Name | Description |
|---|---|
error - String
|
Example
{"error": "abc123"}
WarehouseInput
Fields
| Input Field | Description |
|---|---|
id - ID
|
|
name - String!
|
|
address - WarehouseAddressInput
|
Example
{
"id": 4,
"name": "xyz789",
"address": WarehouseAddressInput
}
WarehouseType
Fields
| Field Name | Description |
|---|---|
id - ID!
|
|
name - String!
|
|
address - AddressType
|
Example
{
"id": 4,
"name": "xyz789",
"address": AddressType
}
WarehouseUpdate
Fields
| Field Name | Description |
|---|---|
error - String
|
|
warehouse - WarehouseType
|
Example
{
"error": "abc123",
"warehouse": WarehouseType
}
WebhookEventType
Description
An enumeration.
Values
| Enum Value | Description |
|---|---|
|
|
|
|
|
Example
"RETURN_CREATED"