Update Data Kiosk Economics schema
This commit is contained in:
Jack Evoniuk
parent
77558eaeb6
commit
1fb5f849d2
|
|
@ -1,493 +1,339 @@
|
|||
"""
|
||||
A Scalar for the primitive long type.
|
||||
"""
|
||||
scalar Long
|
||||
"""
|
||||
An RFC-3339 compliant Full Date Scalar. Example: "2024-03-15"
|
||||
"""
|
||||
scalar Date
|
||||
|
||||
extend type Query
|
||||
@domainResolver(
|
||||
sdpInstanceType: "amzn1.sdp.1.type.1.DataKiosk.Domain.Analytics_Economics_2024_03_15"
|
||||
) {
|
||||
"""
|
||||
Seller economics queries version 2024_03_15.
|
||||
"""
|
||||
analytics_economics_2024_03_15: Analytics_Economics_2024_03_15
|
||||
schema {
|
||||
query: Query
|
||||
}
|
||||
|
||||
"""
|
||||
A root type for seller economics queries version 2024_03_15.
|
||||
This directive specifies the retention duration of a query containing a
|
||||
particular field. When a query contains multiple fields with different
|
||||
retentions, the shortest (minimum) retention is applied to the query. The
|
||||
retention of a query's resulting documents always matches the retention of the query.
|
||||
"""
|
||||
type Analytics_Economics_2024_03_15 {
|
||||
"""
|
||||
A query to retrieve seller economics data for the seller's account aggregated by date and product identifier. The seller economics data consists of aggregated sales, fees, and cost for selected period.
|
||||
"""
|
||||
economics(
|
||||
"""
|
||||
The start date of the seller economics data to retrieve. The start date must be no more than two years ago. If the provided start date occurs mid-week or mid-month in UTC+0 timezone, the following Sunday for WEEK date granularity or the first day of the next month for MONTH date granularity will be used instead.
|
||||
"""
|
||||
startDate: Date!
|
||||
"""
|
||||
The end date of the seller economics data to retrieve. If the provided end date occurs mid-week or mid-month in UTC+0 timezone, the preceding Saturday for WEEK date granularity or the last day of the previous month for MONTH date granularity will be used instead.
|
||||
"""
|
||||
endDate: Date!
|
||||
"""
|
||||
The marketplace identifiers to retrieve seller economics data for.
|
||||
"""
|
||||
marketplaceIds: [String]!
|
||||
"""
|
||||
Specifies which fee types to breakdown into individual components.
|
||||
"""
|
||||
includeComponentsForFeeTypes: [FeeType]
|
||||
"""
|
||||
Determines how the seller economics data should be aggregated. By default it's aggregated by MSKU and DAY.
|
||||
"""
|
||||
aggregateBy: EconomicsAggregation
|
||||
): [Economics] @supportedAccountTypes(types: [MERCHANT])
|
||||
}
|
||||
directive @resultRetention(
|
||||
"An ISO 8601 duration."
|
||||
duration: String!
|
||||
) on FIELD_DEFINITION
|
||||
|
||||
"""
|
||||
The seller economics data for a given product in the seller's account.
|
||||
"""
|
||||
type Economics {
|
||||
"""
|
||||
The marketplace identifier of the seller economics data.
|
||||
"""
|
||||
marketplaceId: String!
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
The start date of the seller economics data, please note this date may be adjusted to the start of DateGranularity.
|
||||
"""
|
||||
startDate: Date!
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
The end date of the seller economics data, please note this date may be adjusted to the end of DateGranularity.
|
||||
"""
|
||||
endDate: Date!
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
The Amazon Standard Identification Number of the parent product. A parent product appears in our catalog as a non-buyable, generic identifier for a product that has buyable variations (child products).
|
||||
"""
|
||||
parentAsin: String!
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
The Amazon Standard Identification Number of the child product. Child products are unique, sellable products that are related in our catalog to a single, non-sellable parent product. Note: This field is only present when product aggregation is CHILD_ASIN, FNSKU or MSKU.
|
||||
"""
|
||||
childAsin: String
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
The Fulfillment Network Stock Keeping Unit (FNSKU) of the product. Note: This field is only present when product aggregation is FNSKU or MSKU. This field may be null when product aggregation is MSKU and the row is associated with more than one FNSKU.
|
||||
"""
|
||||
fnsku: String
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
The Merchant Stock Keeping Unit (MSKU) of the product. Note: This field is only present when product aggregation is FNSKU or MSKU. This field may be null when product aggregation is FNSKU and the row is associated with more than one MSKU.
|
||||
"""
|
||||
msku: String
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
The sales data for the product within the specified date range.
|
||||
"""
|
||||
sales: Sales!
|
||||
"""
|
||||
The fees applied to the product within the specified date range. Supported fee types can be found [here](https://sellercentral.amazon.com/gp/help/GZ8Y22NL2FSRY8M5.)
|
||||
"""
|
||||
fees: [FeeSummary]!
|
||||
"""
|
||||
The advertising spend data for the product within the specified date range. Supported advertisement charge types can be found [here](https://sellercentral.amazon.com/gp/help/GZ8Y22NL2FSRY8M5).
|
||||
"""
|
||||
ads: [AdSummary]
|
||||
"""
|
||||
The off Amazon cost provided by the seller for this product (per unit). The off Amazon cost can be provided on [SKU Central](https://sellercentral.amazon.com/skucentral?mSku=xxx) and [Revenue Calculator](https://sellercentral.amazon.com/revcal).
|
||||
"""
|
||||
cost: PerUnitCost
|
||||
"""
|
||||
The net proceeds for this product within the specified date range. The value remains unchanged regardless of whether sales, fees, ads, or cost are selected in the query.
|
||||
"""
|
||||
netProceeds: NetProceeds!
|
||||
}
|
||||
|
||||
"""
|
||||
The sales data for a given product in the seller's account within a given date range.
|
||||
"""
|
||||
type Sales {
|
||||
"""
|
||||
The amount of ordered product sales, calculated by multiplying the price of products and the number of units sold for the selected time period.
|
||||
"""
|
||||
orderedProductSales: Amount!
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
The number of units ordered for the selected time period. Example: For an order containing 2 copies of book A and 3 copies of book B, the number of orders is 1, the number of order items is 2 (book A and book B), and the number of units is 5 (2 + 3).
|
||||
"""
|
||||
unitsOrdered: Long!
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
The average price of the units sold in the selected time period, calculated by dividing the orderedProductSales by unitsOrdered for the selected time period. This field will be null when unitsOrdered is 0.
|
||||
"""
|
||||
averageSellingPrice: Amount
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
The amount of refunded product sales for the selected time period, it's counted by refund request time.
|
||||
"""
|
||||
refundedProductSales: Amount!
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
The number of units refunded in the selected time period.
|
||||
"""
|
||||
unitsRefunded: Long!
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
The amount of net product sales, calculated by orderedProductSales - refundedProductSales.
|
||||
"""
|
||||
netProductSales: Amount!
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
The number of net units sold for the selected time period, calculated by unitsOrdered - unitsRefunded.
|
||||
"""
|
||||
netUnitsSold: Long!
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
}
|
||||
|
||||
"""
|
||||
The fees data summary for the seller's account aggregated by transaction event type: charge.
|
||||
"""
|
||||
type FeeSummary {
|
||||
"""
|
||||
Fee type name, for example: "FBA fulfillment fees"
|
||||
"""
|
||||
feeTypeName: String!
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
Charge summary for a fee type.
|
||||
"""
|
||||
charge: Fee
|
||||
}
|
||||
|
||||
"""
|
||||
A fee applied to a given product in the seller's account within a given date range. Fee information can be found [here](https://sellercentral.amazon.com/gp/help/GZ8Y22NL2FSRY8M5).
|
||||
"""
|
||||
type Fee {
|
||||
"""
|
||||
Fee aggregated transaction detail.
|
||||
"""
|
||||
aggregatedDetail: AggregatedDetail!
|
||||
"""
|
||||
A breakdown of the fee into individual components. This field will be null for fee types that cannot be divided into individual components.
|
||||
"""
|
||||
components: [FeeComponent]
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
}
|
||||
|
||||
"""
|
||||
The fee component data applied to a given product in the seller's account within a given date range. It's breakdown of parent fee.
|
||||
"""
|
||||
type FeeComponent {
|
||||
"""
|
||||
Fee component name, for example: "Base fulfillment fee".
|
||||
"""
|
||||
name: String!
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
Fee component aggregated detail.
|
||||
"""
|
||||
aggregatedDetail: AggregatedDetail!
|
||||
}
|
||||
|
||||
"""
|
||||
The advertisements spend data summary for the seller's account aggregated by transaction event type: charge.
|
||||
"""
|
||||
"The advertisements spend data summary for the seller's account aggregated by transaction event type: charge."
|
||||
type AdSummary {
|
||||
"""
|
||||
Advertisement type name, for example: "Sponsored Products charge".
|
||||
"""
|
||||
adTypeName: String!
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
Charge aggregated detail for an advertisement type.
|
||||
"""
|
||||
"Advertisement type name, for example: \"Sponsored Products charge\"."
|
||||
adTypeName: String! @resultRetention(duration : "P30D")
|
||||
"Charge aggregated detail for an advertisement type."
|
||||
charge: AggregatedDetail
|
||||
}
|
||||
|
||||
"""
|
||||
The aggregated transaction detail for the seller's account aggregated by transaction event type and transaction type, for example: charge and "fbaFulfillmentFee".
|
||||
The aggregated transaction detail for the seller's account aggregated by
|
||||
transaction event type and transaction type, for example: charge and
|
||||
"fbaFulfillmentFee".
|
||||
"""
|
||||
type AggregatedDetail {
|
||||
"Amount calculated by rate card."
|
||||
amount: Amount! @resultRetention(duration : "P30D")
|
||||
"""
|
||||
Charged quantity for a given product in the seller's account. When the fee is not charged on a per unit basis, this value may be null or may not be an integer.
|
||||
Final charge amount per unit after promotion and tax are considered. This
|
||||
value is calculated by dividing totalAmount by quantity. This value will be
|
||||
null when quantity is null.
|
||||
"""
|
||||
quantity: Float
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
amountPerUnit: Amount @resultRetention(duration : "P30D")
|
||||
"The promotion amount associated with this transaction type. This value is deducted from amount when computing totalAmount."
|
||||
promotionAmount: Amount! @resultRetention(duration : "P30D")
|
||||
"""
|
||||
Final charge amount after promotion and tax are considered. This value is calculated as amount - promotionAmount + taxAmount.
|
||||
Charged quantity for a given product in the seller's account. When the fee is
|
||||
not charged on a per unit basis, this value may be null or may not be an integer.
|
||||
"""
|
||||
totalAmount: Amount!
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
quantity: Float @resultRetention(duration : "P30D")
|
||||
"The tax amount associated with this transaction type. This value is added to amount when computing totalAmount."
|
||||
taxAmount: Amount! @resultRetention(duration : "P30D")
|
||||
"""
|
||||
Final charge amount per unit after promotion and tax are considered. This value is calculated by dividing totalAmount by quantity. This value will be null when quantity is null.
|
||||
Final charge amount after promotion and tax are considered. This value is
|
||||
calculated as amount - promotionAmount + taxAmount.
|
||||
"""
|
||||
amountPerUnit: Amount
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
Amount calculated by rate card.
|
||||
"""
|
||||
amount: Amount!
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
The promotion amount associated with this transaction type. This value is deducted from amount when computing totalAmount.
|
||||
"""
|
||||
promotionAmount: Amount!
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
The tax amount associated with this transaction type. This value is added to amount when computing totalAmount.
|
||||
"""
|
||||
taxAmount: Amount!
|
||||
@paamRights(
|
||||
require: ["seller_economics_api_view", "seller_economics_mobile_view"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
totalAmount: Amount! @resultRetention(duration : "P30D")
|
||||
}
|
||||
|
||||
"""
|
||||
The item level per unit cost provided by seller. Fields in this type will be null if not provided by the seller.
|
||||
"""
|
||||
type PerUnitCost {
|
||||
"""
|
||||
Cost to manufacture or acquire the product. This value is provided by the seller and is applicable to both Fulfillment by Amazon (FBA) and Merchant Fulfilled Network (MFN) products.
|
||||
"""
|
||||
costOfGoodsSold: Amount
|
||||
@paamRights(
|
||||
require: ["Seller_Provided_Costs_API_Read", "Seller_Provided_Costs_Read"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
Miscellaneous costs not related to this specific product, ex: overhead, etc. This value is provided by the seller and applicable to both Fulfillment by Amazon (FBA) and Merchant Fulfilled Network (MFN) products.
|
||||
"""
|
||||
miscellaneousCost: Amount
|
||||
@paamRights(
|
||||
require: ["Seller_Provided_Costs_API_Read", "Seller_Provided_Costs_Read"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
The item level per unit cost provided by the seller and applicable to Fulfillment by Amazon (FBA) products.
|
||||
"""
|
||||
fbaCost: FbaPerUnitCost
|
||||
"""
|
||||
The item level per unit cost provided by the seller and applicable to Merchant Fulfilled Network (MFN) products.
|
||||
"""
|
||||
mfnCost: MfnPerUnitCost
|
||||
}
|
||||
|
||||
"""
|
||||
The item level per unit cost provided by the seller and applicable to Fulfillment by Amazon (FBA) products. Fields in this type will be null if not provided by the seller.
|
||||
"""
|
||||
type FbaPerUnitCost {
|
||||
"""
|
||||
Cost of shipping the Fulfillment by Amazon (FBA) item to an Amazon fulfillment center. This value is provided by the seller and applicable to Fulfillment by Amazon (FBA) products.
|
||||
"""
|
||||
shippingToAmazonCost: Amount
|
||||
@paamRights(
|
||||
require: ["Seller_Provided_Costs_API_Read", "Seller_Provided_Costs_Read"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
}
|
||||
|
||||
"""
|
||||
The item level per unit cost provided by the seller and applicable to Merchant Fulfilled Network (MFN) products. Fields in this type will be null if not provided by the seller.
|
||||
"""
|
||||
type MfnPerUnitCost {
|
||||
"""
|
||||
Cost of fulfilling an order containing the product, including labor, packing material, shipping to customer, customer service etc. This value is provided by the seller and applicable to Merchant Fulfilled Network (MFN) products.
|
||||
"""
|
||||
fulfillmentCost: Amount
|
||||
@paamRights(
|
||||
require: ["Seller_Provided_Costs_API_Read", "Seller_Provided_Costs_Read"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
Cost to store a single unit of the product per month. This value is provided by the seller and applicable to Merchant Fulfilled Network (MFN) products.
|
||||
"""
|
||||
storageCost: Amount
|
||||
@paamRights(
|
||||
require: ["Seller_Provided_Costs_API_Read", "Seller_Provided_Costs_Read"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
}
|
||||
|
||||
"""
|
||||
The net proceeds for a given product in the seller's account for a given time range. These fields are calculated as sales.netProductSales - sum of fees.charge.totalAmount - sum of ads.charge.totalAmount - (cost of Merchant Fulfilled Network (MFN) products or cost of Fulfillment by Amazon (FBA) products) * sales.netUnitsSold.
|
||||
"""
|
||||
type NetProceeds {
|
||||
"""
|
||||
"Total net proceeds for a given product in the seller's account for a given time range.
|
||||
"""
|
||||
total: Amount
|
||||
@paamRights(
|
||||
require: ["Seller_Provided_Costs_API_Read", "Seller_Provided_Costs_Read"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
"""
|
||||
Net proceeds per unit for a given product in the seller's account for a given time range. This value is calculated by dividing total by sales.netUnitsSold.
|
||||
"""
|
||||
perUnit: Amount
|
||||
@paamRights(
|
||||
require: ["Seller_Provided_Costs_API_Read", "Seller_Provided_Costs_Read"]
|
||||
)
|
||||
@resultRetention(duration: "P30D")
|
||||
}
|
||||
|
||||
"""
|
||||
Monetary amount with the corresponding currency code.
|
||||
"""
|
||||
"Monetary amount with the corresponding currency code."
|
||||
type Amount {
|
||||
"""
|
||||
The amount.
|
||||
"""
|
||||
"The amount."
|
||||
amount: Float!
|
||||
"""
|
||||
Currency code of the amount in ISO 4217 format.
|
||||
"""
|
||||
"Currency code of the amount in ISO 4217 format."
|
||||
currencyCode: String!
|
||||
}
|
||||
|
||||
"""
|
||||
Defines how the seller economics data will be aggregated.
|
||||
"""
|
||||
input EconomicsAggregation {
|
||||
"A root type for seller economics queries version 2024_03_15."
|
||||
type Analytics_Economics_2024_03_15 {
|
||||
"""
|
||||
The product identifier granularity used in aggregation. By default the results will be aggregated by MSKU.
|
||||
A query to retrieve seller economics data for the seller's account aggregated
|
||||
by date and product identifier. The seller economics data consists of
|
||||
aggregated sales, fees, and cost for selected period.
|
||||
"""
|
||||
productId: ProductIdentifierGranularity
|
||||
economics(
|
||||
"Determines how the seller economics data should be aggregated. By default it's aggregated by MSKU and DAY."
|
||||
aggregateBy: EconomicsAggregation,
|
||||
"""
|
||||
The end date of the seller economics data to retrieve. If the provided end
|
||||
date occurs mid-week or mid-month in UTC+0 timezone, the preceding Saturday
|
||||
for WEEK date granularity or the last day of the previous month for MONTH
|
||||
date granularity will be used instead.
|
||||
"""
|
||||
endDate: Date!,
|
||||
"Specifies which fee types to breakdown into individual components."
|
||||
includeComponentsForFeeTypes: [FeeType],
|
||||
"The marketplace identifiers to retrieve seller economics data for."
|
||||
marketplaceIds: [String]!,
|
||||
"""
|
||||
The start date of the seller economics data to retrieve. The start date must
|
||||
be no more than two years ago. If the provided start date occurs mid-week or
|
||||
mid-month in UTC+0 timezone, the following Sunday for WEEK date granularity
|
||||
or the first day of the next month for MONTH date granularity will be used instead.
|
||||
"""
|
||||
startDate: Date!
|
||||
): [Economics]
|
||||
}
|
||||
|
||||
"The seller economics data for a given product in the seller's account."
|
||||
type Economics {
|
||||
"""
|
||||
The date granularity used in aggregation. By default the results will be aggregated by DAY.
|
||||
The advertising spend data for the product within the specified date range.
|
||||
Supported advertisement charge types can be found
|
||||
[here](https://sellercentral.amazon.com/gp/help/GZ8Y22NL2FSRY8M5).
|
||||
"""
|
||||
date: DateGranularity
|
||||
ads: [AdSummary]
|
||||
"""
|
||||
The Amazon Standard Identification Number of the child product. Child products
|
||||
are unique, sellable products that are related in our catalog to a single,
|
||||
non-sellable parent product. Note: This field is only present when product
|
||||
aggregation is CHILD_ASIN, FNSKU or MSKU.
|
||||
"""
|
||||
childAsin: String @resultRetention(duration : "P30D")
|
||||
"""
|
||||
The off Amazon cost provided by the seller for this product (per unit). The
|
||||
off Amazon cost can be provided on [SKU
|
||||
Central](https://sellercentral.amazon.com/skucentral?mSku=xxx) and [Revenue
|
||||
Calculator](https://sellercentral.amazon.com/revcal).
|
||||
"""
|
||||
cost: PerUnitCost
|
||||
"The end date of the seller economics data, please note this date may be adjusted to the end of DateGranularity."
|
||||
endDate: Date! @resultRetention(duration : "P30D")
|
||||
"""
|
||||
The fees applied to the product within the specified date range. Supported fee
|
||||
types can be found
|
||||
[here](https://sellercentral.amazon.com/gp/help/GZ8Y22NL2FSRY8M5.)
|
||||
"""
|
||||
fees: [FeeSummary]!
|
||||
"""
|
||||
The Fulfillment Network Stock Keeping Unit (FNSKU) of the product. Note: This
|
||||
field is only present when product aggregation is FNSKU or MSKU. This field
|
||||
may be null when product aggregation is MSKU and the row is associated with
|
||||
more than one FNSKU.
|
||||
"""
|
||||
fnsku: String @resultRetention(duration : "P30D")
|
||||
"The marketplace identifier of the seller economics data."
|
||||
marketplaceId: String! @resultRetention(duration : "P30D")
|
||||
"""
|
||||
The Merchant Stock Keeping Unit (MSKU) of the product. Note: This field is
|
||||
only present when product aggregation is FNSKU or MSKU. This field may be null
|
||||
when product aggregation is FNSKU and the row is associated with more than one MSKU.
|
||||
"""
|
||||
msku: String @resultRetention(duration : "P30D")
|
||||
"""
|
||||
The net proceeds for this product within the specified date range. The value
|
||||
remains unchanged regardless of whether sales, fees, ads, or cost are selected in the query.
|
||||
"""
|
||||
netProceeds: NetProceeds!
|
||||
"""
|
||||
The Amazon Standard Identification Number of the parent product. A parent
|
||||
product appears in our catalog as a non-buyable, generic identifier for a
|
||||
product that has buyable variations (child products).
|
||||
"""
|
||||
parentAsin: String! @resultRetention(duration : "P30D")
|
||||
"The sales data for the product within the specified date range."
|
||||
sales: Sales!
|
||||
"The start date of the seller economics data, please note this date may be adjusted to the start of DateGranularity."
|
||||
startDate: Date! @resultRetention(duration : "P30D")
|
||||
}
|
||||
|
||||
"""
|
||||
The date granularity used in aggregation.
|
||||
The item level per unit cost provided by the seller and applicable to
|
||||
Fulfillment by Amazon (FBA) products. Fields in this type will be null if not
|
||||
provided by the seller.
|
||||
"""
|
||||
type FbaPerUnitCost {
|
||||
"""
|
||||
Cost of shipping the Fulfillment by Amazon (FBA) item to an Amazon fulfillment
|
||||
center. This value is provided by the seller and applicable to Fulfillment by
|
||||
Amazon (FBA) products.
|
||||
"""
|
||||
shippingToAmazonCost: Amount @resultRetention(duration : "P30D")
|
||||
}
|
||||
|
||||
"""
|
||||
A fee applied to a given product in the seller's account within a given date
|
||||
range. Fee information can be found
|
||||
[here](https://sellercentral.amazon.com/gp/help/GZ8Y22NL2FSRY8M5).
|
||||
"""
|
||||
type Fee {
|
||||
"Fee aggregated transaction detail."
|
||||
aggregatedDetail: AggregatedDetail!
|
||||
"""
|
||||
A breakdown of the fee into individual components. This field will be null for
|
||||
fee types that cannot be divided into individual components.
|
||||
"""
|
||||
components: [FeeComponent] @resultRetention(duration : "P30D")
|
||||
}
|
||||
|
||||
"""
|
||||
The fee component data applied to a given product in the seller's account within
|
||||
a given date range. It's breakdown of parent fee.
|
||||
"""
|
||||
type FeeComponent {
|
||||
"Fee component aggregated detail."
|
||||
aggregatedDetail: AggregatedDetail!
|
||||
"Fee component name, for example: \"Base fulfillment fee\"."
|
||||
name: String! @resultRetention(duration : "P30D")
|
||||
}
|
||||
|
||||
"The fees data summary for the seller's account aggregated by transaction event type: charge."
|
||||
type FeeSummary {
|
||||
"Charge summary for a fee type."
|
||||
charge: Fee
|
||||
"Fee type name, for example: \"FBA fulfillment fees\""
|
||||
feeTypeName: String! @resultRetention(duration : "P30D")
|
||||
}
|
||||
|
||||
"""
|
||||
The item level per unit cost provided by the seller and applicable to Merchant
|
||||
Fulfilled Network (MFN) products. Fields in this type will be null if not
|
||||
provided by the seller.
|
||||
"""
|
||||
type MfnPerUnitCost {
|
||||
"""
|
||||
Cost of fulfilling an order containing the product, including labor, packing
|
||||
material, shipping to customer, customer service etc. This value is provided
|
||||
by the seller and applicable to Merchant Fulfilled Network (MFN) products.
|
||||
"""
|
||||
fulfillmentCost: Amount @resultRetention(duration : "P30D")
|
||||
"""
|
||||
Cost to store a single unit of the product per month. This value is provided
|
||||
by the seller and applicable to Merchant Fulfilled Network (MFN) products.
|
||||
"""
|
||||
storageCost: Amount @resultRetention(duration : "P30D")
|
||||
}
|
||||
|
||||
"""
|
||||
The net proceeds for a given product in the seller's account for a given time
|
||||
range. These fields are calculated as sales.netProductSales - sum of
|
||||
fees.charge.totalAmount - sum of ads.charge.totalAmount - (cost of Merchant
|
||||
Fulfilled Network (MFN) products or cost of Fulfillment by Amazon (FBA)
|
||||
products) * sales.netUnitsSold.
|
||||
"""
|
||||
type NetProceeds {
|
||||
"""
|
||||
Net proceeds per unit for a given product in the seller's account for a given
|
||||
time range. This value is calculated by dividing total by sales.netUnitsSold.
|
||||
"""
|
||||
perUnit: Amount @resultRetention(duration : "P30D")
|
||||
"\"Total net proceeds for a given product in the seller's account for a given time range."
|
||||
total: Amount @resultRetention(duration : "P30D")
|
||||
}
|
||||
|
||||
"The item level per unit cost provided by seller. Fields in this type will be null if not provided by the seller."
|
||||
type PerUnitCost {
|
||||
"""
|
||||
Cost to manufacture or acquire the product. This value is provided by the
|
||||
seller and is applicable to both Fulfillment by Amazon (FBA) and Merchant
|
||||
Fulfilled Network (MFN) products.
|
||||
"""
|
||||
costOfGoodsSold: Amount @resultRetention(duration : "P30D")
|
||||
"The item level per unit cost provided by the seller and applicable to Fulfillment by Amazon (FBA) products."
|
||||
fbaCost: FbaPerUnitCost
|
||||
"The item level per unit cost provided by the seller and applicable to Merchant Fulfilled Network (MFN) products."
|
||||
mfnCost: MfnPerUnitCost
|
||||
"""
|
||||
Miscellaneous costs not related to this specific product, ex: overhead, etc.
|
||||
This value is provided by the seller and applicable to both Fulfillment by
|
||||
Amazon (FBA) and Merchant Fulfilled Network (MFN) products.
|
||||
"""
|
||||
miscellaneousCost: Amount @resultRetention(duration : "P30D")
|
||||
}
|
||||
|
||||
"A root type for queries"
|
||||
type Query {
|
||||
"Seller economics queries version 2024_03_15."
|
||||
analytics_economics_2024_03_15: Analytics_Economics_2024_03_15
|
||||
}
|
||||
|
||||
"The sales data for a given product in the seller's account within a given date range."
|
||||
type Sales {
|
||||
"""
|
||||
The average price of the units sold in the selected time period, calculated by
|
||||
dividing the orderedProductSales by unitsOrdered for the selected time period.
|
||||
This field will be null when unitsOrdered is 0.
|
||||
"""
|
||||
averageSellingPrice: Amount @resultRetention(duration : "P30D")
|
||||
"The amount of net product sales, calculated by orderedProductSales - refundedProductSales."
|
||||
netProductSales: Amount! @resultRetention(duration : "P30D")
|
||||
"The number of net units sold for the selected time period, calculated by unitsOrdered - unitsRefunded."
|
||||
netUnitsSold: Long! @resultRetention(duration : "P30D")
|
||||
"""
|
||||
The amount of ordered product sales, calculated by multiplying the price of
|
||||
products and the number of units sold for the selected time period.
|
||||
"""
|
||||
orderedProductSales: Amount! @resultRetention(duration : "P30D")
|
||||
"The amount of refunded product sales for the selected time period, it's counted by refund request time."
|
||||
refundedProductSales: Amount! @resultRetention(duration : "P30D")
|
||||
"""
|
||||
The number of units ordered for the selected time period. Example: For an
|
||||
order containing 2 copies of book A and 3 copies of book B, the number of
|
||||
orders is 1, the number of order items is 2 (book A and book B), and the
|
||||
number of units is 5 (2 + 3).
|
||||
"""
|
||||
unitsOrdered: Long! @resultRetention(duration : "P30D")
|
||||
"The number of units refunded in the selected time period."
|
||||
unitsRefunded: Long! @resultRetention(duration : "P30D")
|
||||
}
|
||||
|
||||
"The date granularity used in aggregation."
|
||||
enum DateGranularity {
|
||||
"""
|
||||
Seller economics data is aggregated by day against marketplace local time.
|
||||
"""
|
||||
"Seller economics data is aggregated by day against marketplace local time."
|
||||
DAY
|
||||
"""
|
||||
Seller economics data is aggregated by week against marketplace local time, Sunday is the first day of the week.
|
||||
"""
|
||||
WEEK
|
||||
"""
|
||||
Seller economics data is aggregated by month against marketplace local time.
|
||||
"""
|
||||
"Seller economics data is aggregated by month against marketplace local time."
|
||||
MONTH
|
||||
"""
|
||||
Seller economics data is aggregated by the entire date range specified by startDate and endDate.
|
||||
"""
|
||||
"Seller economics data is aggregated by the entire date range specified by startDate and endDate."
|
||||
RANGE
|
||||
"Seller economics data is aggregated by week against marketplace local time, Sunday is the first day of the week."
|
||||
WEEK
|
||||
}
|
||||
|
||||
"""
|
||||
The product identifier granularity used in aggregation.
|
||||
"""
|
||||
enum ProductIdentifierGranularity {
|
||||
"""
|
||||
Seller Economics data is aggregated by parent ASIN.
|
||||
"""
|
||||
PARENT_ASIN
|
||||
"""
|
||||
Seller Economics data is aggregated by child ASIN.
|
||||
"""
|
||||
CHILD_ASIN
|
||||
"""
|
||||
Seller Economics data is aggregated by fulfillment network sku.
|
||||
"""
|
||||
FNSKU
|
||||
"""
|
||||
Seller Economics data is aggregated by merchant sku.
|
||||
"""
|
||||
MSKU
|
||||
}
|
||||
|
||||
"""
|
||||
The fee type used in filter fee components generation.
|
||||
"""
|
||||
"The fee type used in filter fee components generation."
|
||||
enum FeeType {
|
||||
"""
|
||||
Fulfillment by Amazon (FBA) Fulfillment Fees, including base rate and surcharges.
|
||||
"""
|
||||
"Fulfillment by Amazon (FBA) Fulfillment Fees, including base rate and surcharges."
|
||||
FBA_FULFILLMENT_FEE
|
||||
"""
|
||||
Fulfillment by Amazon (FBA) Monthly Inventory Storage Fee, including base rate and surcharges.
|
||||
"""
|
||||
"Fulfillment by Amazon (FBA) Monthly Inventory Storage Fee, including base rate and surcharges."
|
||||
FBA_STORAGE_FEE
|
||||
}
|
||||
|
||||
"The product identifier granularity used in aggregation."
|
||||
enum ProductIdentifierGranularity {
|
||||
"Seller Economics data is aggregated by child ASIN."
|
||||
CHILD_ASIN
|
||||
"Seller Economics data is aggregated by fulfillment network sku."
|
||||
FNSKU
|
||||
"Seller Economics data is aggregated by merchant sku."
|
||||
MSKU
|
||||
"Seller Economics data is aggregated by parent ASIN."
|
||||
PARENT_ASIN
|
||||
}
|
||||
|
||||
"Date"
|
||||
scalar Date
|
||||
|
||||
"Long"
|
||||
scalar Long
|
||||
|
||||
"Defines how the seller economics data will be aggregated."
|
||||
input EconomicsAggregation {
|
||||
"The date granularity used in aggregation. By default the results will be aggregated by DAY."
|
||||
date: DateGranularity
|
||||
"The product identifier granularity used in aggregation. By default the results will be aggregated by MSKU."
|
||||
productId: ProductIdentifierGranularity
|
||||
}
|
||||
|
|
|
|||
Loading…
Reference in New Issue