feat: adds marketplace launch date (#557)

Adds a `launchDate` property to each marketplace indicating an ISO date, rounded up to the start of the month, when the marketplace was launched.
ScaleLeap · May 8, 2023 · 4e037d8 · 4e037d8
1 parent 28de409
commit 4e037d8
Show file tree

Hide file tree

Showing 24 changed files with 56 additions and 0 deletions.
diff --git a/src/amazon-marketplace.ts b/src/amazon-marketplace.ts
@@ -298,6 +298,18 @@ export interface AmazonMarketplace {
    */
   readonly webServiceUri: string
 
+  /**
+   * Date when the marketplace launched in UTC.
+   *
+   * Because we only know which monthly the marketplaces were launched.
+   * So, we suppose that they were launched on the first day of the month.
+   * @see https://en.wikipedia.org/wiki/Amazon_(company)#Amazon.com
+   *
+   * @example
+   * '2023-05-01'
+   */
+  readonly launchDate: string
+
   /**
    * [Amazon Advertising](https://advertising.amazon.com/API/docs/v2/guides/supported_features).
    */

diff --git a/src/marketplaces/ae.ts b/src/marketplaces/ae.ts
@@ -19,6 +19,7 @@ export const AE = new AmazonMarketplace({
   sellerCentralUri: 'https://sellercentral.amazon.ae',
   vendorCentralUri: 'https://vendorcentral.amazon.me',
   webServiceUri: 'https://mws.amazonservices.ae',
+  launchDate: '2019-05-01',
   advertising: {
     countryCode: AmazonMarketplaceAdvertisingCountryCode.AE,
     region: marketplaceAdvertisingRegions.EU,

diff --git a/src/marketplaces/au.ts b/src/marketplaces/au.ts
@@ -19,6 +19,7 @@ export const AU = new AmazonMarketplace({
   sellerCentralUri: 'https://sellercentral.amazon.com.au',
   vendorCentralUri: 'https://vendorcentral.amazon.com.au',
   webServiceUri: 'https://mws.amazonservices.com.au',
+  launchDate: '2017-11-01',
   advertising: {
     countryCode: AmazonMarketplaceAdvertisingCountryCode.AU,
     region: marketplaceAdvertisingRegions.FE,

diff --git a/src/marketplaces/be.ts b/src/marketplaces/be.ts
@@ -24,6 +24,7 @@ export const BE = new AmazonMarketplace({
   sellerCentralUri: 'https://sellercentral.amazon.com.be',
   vendorCentralUri: 'https://vendorcentral.amazon.com.be',
   webServiceUri: 'https://mws-eu.amazonservices.com',
+  launchDate: '2022-10-01',
   advertising: europeanAdvertisingFactory(
     AmazonMarketplaceAdvertisingCountryCode.BE,
     AmazonMarketplaceAdvertisingTimeZone.EUROPE_BRUSSELS,

diff --git a/src/marketplaces/br.ts b/src/marketplaces/br.ts
@@ -19,6 +19,7 @@ export const BR = new AmazonMarketplace({
   sellerCentralUri: 'https://sellercentral.amazon.com.br',
   vendorCentralUri: 'https://vendorcentral.amazon.com.br',
   webServiceUri: 'https://mws.amazonservices.com',
+  launchDate: '2012-12-01',
   advertising: {
     countryCode: AmazonMarketplaceAdvertisingCountryCode.BR,
     region: marketplaceAdvertisingRegions.NA,

diff --git a/src/marketplaces/ca.ts b/src/marketplaces/ca.ts
@@ -23,6 +23,7 @@ export const CA = new AmazonMarketplace({
   webServiceUri: 'https://mws.amazonservices.ca',
   sellerCentralUri: 'https://sellercentral.amazon.ca',
   vendorCentralUri: amazonVendorCentralUriFactory(AmazonMarketplaceCountryCode.CA),
+  launchDate: '2002-06-01',
   advertising: {
     countryCode: AmazonMarketplaceAdvertisingCountryCode.CA,
     region: marketplaceAdvertisingRegions.NA,

diff --git a/src/marketplaces/cn.ts b/src/marketplaces/cn.ts
@@ -13,4 +13,5 @@ export const CN = new AmazonMarketplace({
   name: 'China',
   uri: 'https://www.amazon.cn',
   webServiceUri: 'https://mws.amazonservices.com.cn',
+  launchDate: '2004-09-01',
 })
diff --git a/src/marketplaces/de.ts b/src/marketplaces/de.ts
@@ -20,6 +20,7 @@ export const DE = new AmazonMarketplace({
   sellerCentralUri: europeanSellerCentralUriFactory(),
   vendorCentralUri: amazonVendorCentralUriFactory(AmazonMarketplaceCountryCode.DE),
   webServiceUri: 'https://mws-eu.amazonservices.com',
+  launchDate: '1998-10-01',
   advertising: europeanAdvertisingFactory(AmazonMarketplaceAdvertisingCountryCode.DE),
   sellingPartner: {
     region: sellingPartnerRegions.EU,

diff --git a/src/marketplaces/eg.ts b/src/marketplaces/eg.ts
@@ -18,6 +18,7 @@ export const EG = new AmazonMarketplace({
   uri: 'https://www.amazon.eg',
   vendorCentralUri: 'https://vendorcentral.amazon.me',
   webServiceUri: 'https://mws-eu.amazonservices.com',
+  launchDate: '2021-09-01',
   advertising: {
     countryCode: AmazonMarketplaceAdvertisingCountryCode.EG,
     region: marketplaceAdvertisingRegions.EU,

diff --git a/src/marketplaces/es.ts b/src/marketplaces/es.ts
@@ -19,6 +19,7 @@ export const ES = new AmazonMarketplace({
   uri: 'https://www.amazon.es',
   webServiceUri: 'https://mws-eu.amazonservices.com',
   sellerCentralUri: europeanSellerCentralUriFactory(),
+  launchDate: '2011-09-01',
   vendorCentralUri: amazonVendorCentralUriFactory(AmazonMarketplaceCountryCode.ES),
   advertising: europeanAdvertisingFactory(AmazonMarketplaceAdvertisingCountryCode.ES),
   sellingPartner: {

diff --git a/src/marketplaces/fr.ts b/src/marketplaces/fr.ts
@@ -18,6 +18,7 @@ export const FR = new AmazonMarketplace({
   name: 'France',
   uri: 'https://www.amazon.fr',
   webServiceUri: 'https://mws-eu.amazonservices.com',
+  launchDate: '2000-08-01',
   sellerCentralUri: europeanSellerCentralUriFactory(),
   vendorCentralUri: amazonVendorCentralUriFactory(AmazonMarketplaceCountryCode.FR),
   advertising: europeanAdvertisingFactory(AmazonMarketplaceAdvertisingCountryCode.FR),

diff --git a/src/marketplaces/gb.ts b/src/marketplaces/gb.ts
@@ -25,6 +25,7 @@ export const GB = new AmazonMarketplace({
   sellerCentralUri: europeanSellerCentralUriFactory(),
   vendorCentralUri: 'https://vendorcentral.amazon.co.uk',
   webServiceUri: DE.webServiceUri,
+  launchDate: '1998-10-01',
   advertising: {
     countryCode: AmazonMarketplaceAdvertisingCountryCode.UK,
     region: marketplaceAdvertisingRegions.EU,

diff --git a/src/marketplaces/in.ts b/src/marketplaces/in.ts
@@ -19,6 +19,7 @@ export const IN = new AmazonMarketplace({
   sellerCentralUri: 'https://sellercentral.amazon.in',
   vendorCentralUri: 'https://vendorcentral.amazon.in',
   webServiceUri: 'https://mws.amazonservices.in',
+  launchDate: '2013-06-01',
   advertising: {
     countryCode: AmazonMarketplaceAdvertisingCountryCode.IN,
     region: marketplaceAdvertisingRegions.EU,

diff --git a/src/marketplaces/it.ts b/src/marketplaces/it.ts
@@ -20,6 +20,7 @@ export const IT = new AmazonMarketplace({
   sellerCentralUri: europeanSellerCentralUriFactory(),
   vendorCentralUri: amazonVendorCentralUriFactory(AmazonMarketplaceCountryCode.IT),
   webServiceUri: 'https://mws-eu.amazonservices.com',
+  launchDate: '2010-11-01',
   advertising: europeanAdvertisingFactory(AmazonMarketplaceAdvertisingCountryCode.DE),
   sellingPartner: {
     region: sellingPartnerRegions.EU,

diff --git a/src/marketplaces/jp.ts b/src/marketplaces/jp.ts
@@ -19,6 +19,7 @@ export const JP = new AmazonMarketplace({
   sellerCentralUri: 'https://sellercentral.amazon.co.jp',
   vendorCentralUri: 'https://vendorcentral.amazon.co.jp',
   webServiceUri: 'https://mws.amazonservices.jp',
+  launchDate: '2000-11-01',
   advertising: {
     countryCode: AmazonMarketplaceAdvertisingCountryCode.JP,
     region: marketplaceAdvertisingRegions.FE,

diff --git a/src/marketplaces/mx.ts b/src/marketplaces/mx.ts
@@ -19,6 +19,7 @@ export const MX = new AmazonMarketplace({
   sellerCentralUri: 'https://sellercentral.amazon.com.mx',
   vendorCentralUri: 'https://vendorcentral.amazon.com.mx',
   webServiceUri: 'https://mws.amazonservices.com.mx',
+  launchDate: '2013-08-01',
   advertising: {
     countryCode: AmazonMarketplaceAdvertisingCountryCode.MX,
     region: marketplaceAdvertisingRegions.NA,

diff --git a/src/marketplaces/nl.ts b/src/marketplaces/nl.ts
@@ -21,6 +21,7 @@ export const NL = new AmazonMarketplace({
   sellerCentralUri: 'https://sellercentral.amazon.nl',
   vendorCentralUri: amazonVendorCentralUriFactory(AmazonMarketplaceCountryCode.NL),
   webServiceUri: DE.webServiceUri,
+  launchDate: '2014-11-01',
   advertising: europeanAdvertisingFactory(
     AmazonMarketplaceAdvertisingCountryCode.NL,
     AmazonMarketplaceAdvertisingTimeZone.EUROPE_AMSTERDAM,

diff --git a/src/marketplaces/pl.ts b/src/marketplaces/pl.ts
@@ -20,6 +20,7 @@ export const PL = new AmazonMarketplace({
   sellerCentralUri: 'https://sellercentral.amazon.pl',
   vendorCentralUri: amazonVendorCentralUriFactory(AmazonMarketplaceCountryCode.PL),
   webServiceUri: 'https://mws-eu.amazonservices.com',
+  launchDate: '2021-03-01',
   advertising: {
     countryCode: AmazonMarketplaceAdvertisingCountryCode.PL,
     region: marketplaceAdvertisingRegions.EU,

diff --git a/src/marketplaces/sa.ts b/src/marketplaces/sa.ts
@@ -18,6 +18,7 @@ export const SA = new AmazonMarketplace({
   uri: 'https://www.amazon.sa',
   sellerCentralUri: 'https://sellercentral.amazon.sa',
   webServiceUri: 'https://mws-eu.amazonservices.com',
+  launchDate: '2020-06-01',
   advertising: {
     // UNDEFINED by Amazon
     bids: {

diff --git a/src/marketplaces/se.ts b/src/marketplaces/se.ts
@@ -20,6 +20,7 @@ export const SE = new AmazonMarketplace({
   sellerCentralUri: 'https://sellercentral.amazon.se',
   vendorCentralUri: amazonVendorCentralUriFactory(AmazonMarketplaceCountryCode.SE),
   webServiceUri: 'https://mws-eu.amazonservices.com',
+  launchDate: '2020-10-01',
   advertising: {
     countryCode: AmazonMarketplaceAdvertisingCountryCode.SE,
     region: marketplaceAdvertisingRegions.EU,

diff --git a/src/marketplaces/sg.ts b/src/marketplaces/sg.ts
@@ -19,6 +19,7 @@ export const SG = new AmazonMarketplace({
   sellerCentralUri: 'https://sellercentral.amazon.sg',
   vendorCentralUri: 'https://vendorcentral.amazon.com.sg',
   webServiceUri: 'https://mws-fe.amazonservices.com',
+  launchDate: '2017-07-01',
   advertising: {
     countryCode: AmazonMarketplaceAdvertisingCountryCode.SG,
     region: marketplaceAdvertisingRegions.FE,

diff --git a/src/marketplaces/tr.ts b/src/marketplaces/tr.ts
@@ -19,6 +19,7 @@ export const TR = new AmazonMarketplace({
   sellerCentralUri: 'https://sellercentral.amazon.com.tr',
   vendorCentralUri: 'https://vendorcentral.amazon.com.tr',
   webServiceUri: 'https://mws-eu.amazonservices.com',
+  launchDate: '2018-09-01',
   advertising: {
     countryCode: AmazonMarketplaceAdvertisingCountryCode.TR,
     region: marketplaceAdvertisingRegions.EU,

diff --git a/src/marketplaces/us.ts b/src/marketplaces/us.ts
@@ -19,6 +19,7 @@ export const US = new AmazonMarketplace({
   sellerCentralUri: 'https://sellercentral.amazon.com',
   vendorCentralUri: 'https://vendorcentral.amazon.com',
   webServiceUri: 'https://mws.amazonservices.com',
+  launchDate: '1995-07-01',
   advertising: {
     countryCode: AmazonMarketplaceAdvertisingCountryCode.US,
     region: marketplaceAdvertisingRegions.NA,

diff --git a/test/__snapshots__/marketplaces.test.ts.snap b/test/__snapshots__/marketplaces.test.ts.snap
@@ -26,6 +26,7 @@ AmazonMarketplace {
   "countryCode": "AE",
   "currency": "AED",
   "id": "A2VIGQ35RCS4UG",
+  "launchDate": "2019-05-01",
   "name": "United Arab Emirates",
   "sellerCentralUri": "https://sellercentral.amazon.ae",
   "sellingPartner": {
@@ -71,6 +72,7 @@ AmazonMarketplace {
   "countryCode": "AU",
   "currency": "AUD",
   "id": "A39IBJ37TRP1C6",
+  "launchDate": "2017-11-01",
   "name": "Australia",
   "sellerCentralUri": "https://sellercentral.amazon.com.au",
   "sellingPartner": {
@@ -116,6 +118,7 @@ AmazonMarketplace {
   "countryCode": "BE",
   "currency": "EUR",
   "id": "AMEN7PMS3EDWL",
+  "launchDate": "2022-10-01",
   "name": "Belgium",
   "sellerCentralUri": "https://sellercentral.amazon.com.be",
   "sellingPartner": {
@@ -161,6 +164,7 @@ AmazonMarketplace {
   "countryCode": "BR",
   "currency": "BRL",
   "id": "A2Q3Y263D00KWC",
+  "launchDate": "2012-12-01",
   "name": "Brazil",
   "sellerCentralUri": "https://sellercentral.amazon.com.br",
   "sellingPartner": {
@@ -206,6 +210,7 @@ AmazonMarketplace {
   "countryCode": "CA",
   "currency": "CAD",
   "id": "A2EUQ1WTGCTBG2",
+  "launchDate": "2002-06-01",
   "name": "Canada",
   "sellerCentralUri": "https://sellercentral.amazon.ca",
   "sellingPartner": {
@@ -230,6 +235,7 @@ AmazonMarketplace {
   "countryCode": "CN",
   "currency": "CNY",
   "id": "AAHKV2X7AFYLW",
+  "launchDate": "2004-09-01",
   "name": "China",
   "timeZone": "Asia/Shanghai",
   "uri": "https://www.amazon.cn",
@@ -263,6 +269,7 @@ AmazonMarketplace {
   "countryCode": "DE",
   "currency": "EUR",
   "id": "A1PA6795UKMFR9",
+  "launchDate": "1998-10-01",
   "name": "Germany",
   "sellerCentralUri": "https://sellercentral-europe.amazon.com",
   "sellingPartner": {
@@ -308,6 +315,7 @@ AmazonMarketplace {
   "countryCode": "EG",
   "currency": "EGP",
   "id": "ARBP9OOSHTCHU",
+  "launchDate": "2021-09-01",
   "name": "Egypt",
   "sellingPartner": {
     "region": AmazonSellingPartnerApiRegion {
@@ -351,6 +359,7 @@ AmazonMarketplace {
   "countryCode": "ES",
   "currency": "EUR",
   "id": "A1RKKUPIHCS9HS",
+  "launchDate": "2011-09-01",
   "name": "Spain",
   "sellerCentralUri": "https://sellercentral-europe.amazon.com",
   "sellingPartner": {
@@ -396,6 +405,7 @@ AmazonMarketplace {
   "countryCode": "FR",
   "currency": "EUR",
   "id": "A13V1IB3VIYZZH",
+  "launchDate": "2000-08-01",
   "name": "France",
   "sellerCentralUri": "https://sellercentral-europe.amazon.com",
   "sellingPartner": {
@@ -441,6 +451,7 @@ AmazonMarketplace {
   "countryCode": "GB",
   "currency": "GBP",
   "id": "A1F83G8C2ARO7P",
+  "launchDate": "1998-10-01",
   "name": "United Kingdom",
   "sellerCentralUri": "https://sellercentral-europe.amazon.com",
   "sellingPartner": {
@@ -486,6 +497,7 @@ AmazonMarketplace {
   "countryCode": "IN",
   "currency": "INR",
   "id": "A21TJRUUN4KGV",
+  "launchDate": "2013-06-01",
   "name": "India",
   "sellerCentralUri": "https://sellercentral.amazon.in",
   "sellingPartner": {
@@ -531,6 +543,7 @@ AmazonMarketplace {
   "countryCode": "IT",
   "currency": "EUR",
   "id": "APJ6JRA9NG5V4",
+  "launchDate": "2010-11-01",
   "name": "Italy",
   "sellerCentralUri": "https://sellercentral-europe.amazon.com",
   "sellingPartner": {
@@ -576,6 +589,7 @@ AmazonMarketplace {
   "countryCode": "JP",
   "currency": "JPY",
   "id": "A1VC38T7YXB528",
+  "launchDate": "2000-11-01",
   "name": "Japan",
   "sellerCentralUri": "https://sellercentral.amazon.co.jp",
   "sellingPartner": {
@@ -621,6 +635,7 @@ AmazonMarketplace {
   "countryCode": "MX",
   "currency": "MXN",
   "id": "A1AM78C64UM0Y8",
+  "launchDate": "2013-08-01",
   "name": "Mexico",
   "sellerCentralUri": "https://sellercentral.amazon.com.mx",
   "sellingPartner": {
@@ -666,6 +681,7 @@ AmazonMarketplace {
   "countryCode": "NL",
   "currency": "EUR",
   "id": "A1805IZSGTT6HS",
+  "launchDate": "2014-11-01",
   "name": "Netherlands",
   "sellerCentralUri": "https://sellercentral.amazon.nl",
   "sellingPartner": {
@@ -711,6 +727,7 @@ AmazonMarketplace {
   "countryCode": "PL",
   "currency": "PLN",
   "id": "A1C3SOZRARQ6R3",
+  "launchDate": "2021-03-01",
   "name": "Poland",
   "sellerCentralUri": "https://sellercentral.amazon.pl",
   "sellingPartner": {
@@ -756,6 +773,7 @@ AmazonMarketplace {
   "countryCode": "SA",
   "currency": "SAR",
   "id": "A17E79C6D8DWNP",
+  "launchDate": "2020-06-01",
   "name": "Saudi Arabia",
   "sellerCentralUri": "https://sellercentral.amazon.sa",
   "sellingPartner": {
@@ -799,6 +817,7 @@ AmazonMarketplace {
   "countryCode": "SE",
   "currency": "SEK",
   "id": "A2NODRKZP88ZB9",
+  "launchDate": "2020-10-01",
   "name": "Sweden",
   "sellerCentralUri": "https://sellercentral.amazon.se",
   "sellingPartner": {
@@ -844,6 +863,7 @@ AmazonMarketplace {
   "countryCode": "SG",
   "currency": "SGD",
   "id": "A19VAU5U5O7RUS",
+  "launchDate": "2017-07-01",
   "name": "Singapore",
   "sellerCentralUri": "https://sellercentral.amazon.sg",
   "sellingPartner": {
@@ -889,6 +909,7 @@ AmazonMarketplace {
   "countryCode": "TR",
   "currency": "TRY",
   "id": "A33AVAJ2PDY3EV",
+  "launchDate": "2018-09-01",
   "name": "Turkey",
   "sellerCentralUri": "https://sellercentral.amazon.com.tr",
   "sellingPartner": {
@@ -934,6 +955,7 @@ AmazonMarketplace {
   "countryCode": "US",
   "currency": "USD",
   "id": "ATVPDKIKX0DER",
+  "launchDate": "1995-07-01",
   "name": "United States",
   "sellerCentralUri": "https://sellercentral.amazon.com",
   "sellingPartner": {