Variable vendorNetPureProductMarginReportConst
vendorNetPureProductMarginReport: {
definitions: {
NetPureProductMarginAggregateDetails: {
description: "Describes the aggregated net pure product margin for ASINs in the vendor's account.";
examples: readonly [
{
endDate: "2021-06-12";
netPureProductMargin: 0.1234;
startDate: "2021-06-06";
},
];
properties: {
endDate: {
description: "The end date of the aggregated data.";
examples: readonly ["2021-06-12"];
format: "date";
type: "string";
};
netPureProductMargin: {
description: "A measure of Amazon's profitability considering Amazon's wholesale cost and vendor-funded cooperative marketing funds: (Product Revenue – Product COGS – Vendor Funded Coop) / Product Revenue. The value is a fraction with values between 0 and 1. To represent as a percentage, multiply the value by 100.";
examples: readonly [0.1234];
type: "number";
};
startDate: {
description: "The start date of the aggregated data.";
examples: readonly ["2021-06-06"];
format: "date";
type: "string";
};
};
required: readonly ["startDate", "endDate", "netPureProductMargin"];
type: "object";
};
NetPureProductMarginDetailsByAsin: {
description: "Describes the aggregated ASIN-level net pure product margin for ASINs in the vendor's account.";
examples: readonly [
{
endDate: "2021-06-12";
netPureProductMargin: 0.1234;
startDate: "2021-06-06";
},
];
properties: {
asin: {
description: "The Amazon Standard Identification Number.";
examples: readonly ["B123456789"];
type: "string";
};
endDate: {
description: "The end date of the aggregated ASIN-level data.";
examples: readonly ["2021-06-12"];
format: "date";
type: "string";
};
netPureProductMargin: {
description: "A measure of Amazon's profitability considering Amazon's wholesale cost and vendor-funded cooperative marketing funds: (Product Revenue – Product COGS – Vendor Funded Coop) / Product Revenue. The value is a fraction with values between 0 and 1. To represent as a percentage, multiply the value by 100.";
examples: readonly [0.1234];
type: "number";
};
startDate: {
description: "The start date of the aggregated ASIN-level data.";
examples: readonly ["2021-06-06"];
format: "date";
type: "string";
};
};
required: readonly [
"startDate",
"endDate",
"asin",
"netPureProductMargin",
];
type: "object";
};
};
description: "The Net Pure Product Margin report shares data with vendors on Amazon's profit margin selling the vendor's items both at an aggregated level (across the vendor's entire catalog of items) and at a per-ASIN level. Data is available at different date range aggregation levels: DAY, WEEK, MONTH, QUARTER, YEAR. Requests can span multiple date range periods.";
examples: readonly [
{
netPureProductMarginAggregate: readonly [
{
endDate: "2021-06-12";
netPureProductMargin: 0.1234;
startDate: "2021-06-06";
},
{
endDate: "2021-06-19";
netPureProductMargin: 0.1234;
startDate: "2021-06-13";
},
];
netPureProductMarginByAsin: readonly [
{
asin: "B123456789";
endDate: "2021-06-12";
netPureProductMargin: 0.1234;
startDate: "2021-06-06";
},
{
asin: "B987654321";
endDate: "2021-06-12";
netPureProductMargin: 0.1234;
startDate: "2021-06-06";
},
{
asin: "B123456789";
endDate: "2021-06-19";
netPureProductMargin: 0.1234;
startDate: "2021-06-13";
},
{
asin: "B987654321";
endDate: "2021-06-19";
netPureProductMargin: 0.1234;
startDate: "2021-06-13";
},
];
reportSpecification: {
dataEndTime: "2021-06-19";
dataStartTime: "2021-06-06";
lastUpdatedDate: "2021-06-20";
marketplaceIds: readonly ["ATVPDKIKX0DER"];
reportOptions: { reportPeriod: "WEEK" };
reportType: "GET_VENDOR_NET_PURE_PRODUCT_MARGIN_REPORT";
};
},
];
properties: {
netPureProductMarginAggregate: {
items: { $ref: "#/definitions/NetPureProductMarginAggregateDetails" };
type: "array";
};
netPureProductMarginByAsin: {
items: { $ref: "#/definitions/NetPureProductMarginDetailsByAsin" };
type: "array";
};
reportSpecification: {
description: "The report summary including the specified reporting date range and the last updated date in the input.";
examples: readonly [
{
dataEndTime: "2021-06-19";
dataStartTime: "2021-06-06";
lastUpdatedDate: "2021-06-20";
marketplaceIds: readonly ["ATVPDKIKX0DER"];
reportOptions: { reportPeriod: "WEEK" };
reportType: "GET_VENDOR_NET_PURE_PRODUCT_MARGIN_REPORT";
},
];
properties: {
dataEndTime: {
description: "Determines the end date of the report - the time component is ignored. For WEEK, MONTH, QUARTER and YEAR reportPeriods, this value must correspond to the last day in the specified reportPeriod. For example, dataEndTime must be a Saturday for the WEEK reportPeriod.";
examples: readonly ["2021-06-19"];
format: "date";
type: "string";
};
dataStartTime: {
description: "Determines the start date of the report - the time component is ignored. For WEEK, MONTH, QUARTER and YEAR reportPeriods, this value must correspond to the first day in the specified reportPeriod. For example, dataStartTime must be a Sunday for the WEEK reportPeriod.";
examples: readonly ["2021-06-06"];
format: "date";
type: "string";
};
lastUpdatedDate: {
description: "The date when the report was last updated. Follows the <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> Date format of YYYY-MM-DD.";
examples: readonly ["2021-06-20"];
format: "date";
type: "string";
};
marketplaceIds: {
description: "This parameter must match the marketplaceId of the vendor account. Each vendor account belongs to only one marketplaceId.";
examples: readonly [readonly ["ATVPDKIKX0DER"]];
items: { type: "string" };
type: "array";
};
reportOptions: {
description: "Report options specifying parameters such as reportPeriod.";
properties: {
reportPeriod: {
description: "Determines the period by which data in the report is aggregated. Valid values are: DAY, WEEK, MONTH, QUARTER, YEAR.";
enum: readonly ["DAY", "WEEK", "MONTH", "QUARTER", "YEAR"];
type: "string";
};
};
required: readonly ["reportPeriod"];
type: "object";
};
reportType: {
description: "The report type.";
enum: readonly ["GET_VENDOR_NET_PURE_PRODUCT_MARGIN_REPORT"];
type: "string";
};
};
required: readonly [
"reportType",
"reportOptions",
"lastUpdatedDate",
"dataStartTime",
"dataEndTime",
"marketplaceIds",
];
type: "object";
};
};
required: readonly [
"reportSpecification",
"netPureProductMarginAggregate",
"netPureProductMarginByAsin",
];
type: "object";
} = ...
Type declaration
Readonly
definitions: {
NetPureProductMarginAggregateDetails: {
description: "Describes the aggregated net pure product margin for ASINs in the vendor's account.";
examples: readonly [
{
endDate: "2021-06-12";
netPureProductMargin: 0.1234;
startDate: "2021-06-06";
},
];
properties: {
endDate: {
description: "The end date of the aggregated data.";
examples: readonly ["2021-06-12"];
format: "date";
type: "string";
};
netPureProductMargin: {
description: "A measure of Amazon's profitability considering Amazon's wholesale cost and vendor-funded cooperative marketing funds: (Product Revenue – Product COGS – Vendor Funded Coop) / Product Revenue. The value is a fraction with values between 0 and 1. To represent as a percentage, multiply the value by 100.";
examples: readonly [0.1234];
type: "number";
};
startDate: {
description: "The start date of the aggregated data.";
examples: readonly ["2021-06-06"];
format: "date";
type: "string";
};
};
required: readonly ["startDate", "endDate", "netPureProductMargin"];
type: "object";
};
NetPureProductMarginDetailsByAsin: {
description: "Describes the aggregated ASIN-level net pure product margin for ASINs in the vendor's account.";
examples: readonly [
{
endDate: "2021-06-12";
netPureProductMargin: 0.1234;
startDate: "2021-06-06";
},
];
properties: {
asin: {
description: "The Amazon Standard Identification Number.";
examples: readonly ["B123456789"];
type: "string";
};
endDate: {
description: "The end date of the aggregated ASIN-level data.";
examples: readonly ["2021-06-12"];
format: "date";
type: "string";
};
netPureProductMargin: {
description: "A measure of Amazon's profitability considering Amazon's wholesale cost and vendor-funded cooperative marketing funds: (Product Revenue – Product COGS – Vendor Funded Coop) / Product Revenue. The value is a fraction with values between 0 and 1. To represent as a percentage, multiply the value by 100.";
examples: readonly [0.1234];
type: "number";
};
startDate: {
description: "The start date of the aggregated ASIN-level data.";
examples: readonly ["2021-06-06"];
format: "date";
type: "string";
};
};
required: readonly [
"startDate",
"endDate",
"asin",
"netPureProductMargin",
];
type: "object";
};
}
Readonly
description: "The Net Pure Product Margin report shares data with vendors on Amazon's profit margin selling the vendor's items both at an aggregated level (across the vendor's entire catalog of items) and at a per-ASIN level. Data is available at different date range aggregation levels: DAY, WEEK, MONTH, QUARTER, YEAR. Requests can span multiple date range periods."
Readonly
examples: readonly [
{
netPureProductMarginAggregate: readonly [
{
endDate: "2021-06-12";
netPureProductMargin: 0.1234;
startDate: "2021-06-06";
},
{
endDate: "2021-06-19";
netPureProductMargin: 0.1234;
startDate: "2021-06-13";
},
];
netPureProductMarginByAsin: readonly [
{
asin: "B123456789";
endDate: "2021-06-12";
netPureProductMargin: 0.1234;
startDate: "2021-06-06";
},
{
asin: "B987654321";
endDate: "2021-06-12";
netPureProductMargin: 0.1234;
startDate: "2021-06-06";
},
{
asin: "B123456789";
endDate: "2021-06-19";
netPureProductMargin: 0.1234;
startDate: "2021-06-13";
},
{
asin: "B987654321";
endDate: "2021-06-19";
netPureProductMargin: 0.1234;
startDate: "2021-06-13";
},
];
reportSpecification: {
dataEndTime: "2021-06-19";
dataStartTime: "2021-06-06";
lastUpdatedDate: "2021-06-20";
marketplaceIds: readonly ["ATVPDKIKX0DER"];
reportOptions: { reportPeriod: "WEEK" };
reportType: "GET_VENDOR_NET_PURE_PRODUCT_MARGIN_REPORT";
};
},
]
Readonly
properties: {
netPureProductMarginAggregate: {
items: { $ref: "#/definitions/NetPureProductMarginAggregateDetails" };
type: "array";
};
netPureProductMarginByAsin: {
items: { $ref: "#/definitions/NetPureProductMarginDetailsByAsin" };
type: "array";
};
reportSpecification: {
description: "The report summary including the specified reporting date range and the last updated date in the input.";
examples: readonly [
{
dataEndTime: "2021-06-19";
dataStartTime: "2021-06-06";
lastUpdatedDate: "2021-06-20";
marketplaceIds: readonly ["ATVPDKIKX0DER"];
reportOptions: { reportPeriod: "WEEK" };
reportType: "GET_VENDOR_NET_PURE_PRODUCT_MARGIN_REPORT";
},
];
properties: {
dataEndTime: {
description: "Determines the end date of the report - the time component is ignored. For WEEK, MONTH, QUARTER and YEAR reportPeriods, this value must correspond to the last day in the specified reportPeriod. For example, dataEndTime must be a Saturday for the WEEK reportPeriod.";
examples: readonly ["2021-06-19"];
format: "date";
type: "string";
};
dataStartTime: {
description: "Determines the start date of the report - the time component is ignored. For WEEK, MONTH, QUARTER and YEAR reportPeriods, this value must correspond to the first day in the specified reportPeriod. For example, dataStartTime must be a Sunday for the WEEK reportPeriod.";
examples: readonly ["2021-06-06"];
format: "date";
type: "string";
};
lastUpdatedDate: {
description: "The date when the report was last updated. Follows the <a href='https://developer-docs.amazon.com/sp-api/docs/iso-8601'>ISO 8601</a> Date format of YYYY-MM-DD.";
examples: readonly ["2021-06-20"];
format: "date";
type: "string";
};
marketplaceIds: {
description: "This parameter must match the marketplaceId of the vendor account. Each vendor account belongs to only one marketplaceId.";
examples: readonly [readonly ["ATVPDKIKX0DER"]];
items: { type: "string" };
type: "array";
};
reportOptions: {
description: "Report options specifying parameters such as reportPeriod.";
properties: {
reportPeriod: {
description: "Determines the period by which data in the report is aggregated. Valid values are: DAY, WEEK, MONTH, QUARTER, YEAR.";
enum: readonly ["DAY", "WEEK", "MONTH", "QUARTER", "YEAR"];
type: "string";
};
};
required: readonly ["reportPeriod"];
type: "object";
};
reportType: {
description: "The report type.";
enum: readonly ["GET_VENDOR_NET_PURE_PRODUCT_MARGIN_REPORT"];
type: "string";
};
};
required: readonly [
"reportType",
"reportOptions",
"lastUpdatedDate",
"dataStartTime",
"dataEndTime",
"marketplaceIds",
];
type: "object";
};
}
Readonly
required: readonly [
"reportSpecification",
"netPureProductMarginAggregate",
"netPureProductMarginByAsin",
]
Readonly
type: "object"