概要

本ガイドでは、DEXTRE Merchant APIを利用した「製品(Product)」作成のリクエスト例を示します。

環境例を前提としたサンプルになりますので、自社環境に合わせて適宜ご調整ください。

APIドキュメント

https://docs.dextre.app/merchant-api/#tag/product/operation/createProduct

ご利用にあたっての前提・準備

• マーチャント(メーカー)環境にて、ブランドが登録されていることを確認してください。
  • 存在しない場合はご登録ください。
• 対象ブランドにて、必要なSKUプロパティ、SKUテンプレートが登録されていることを確認してください。
  • 存在しない場合はご登録ください。
  • SKUプロパティやSKUテンプレートについてはこちらをご覧ください。

環境例

• マーチャント(メーカー)で有効化しているコア設定
  • 言語
    • 日本語(ja)
    • 英語(en)
  • 通貨
    • 日本円(JPY)
    • アメリカ合衆国ドル(USD)
  • 取引条件コード
    • 掛け率取引(kakeritsu_transaction)
    • EXW(exw)

リクエスト例 (curl)

curl -X POST '<https://api.dextre.app/v1/merchant/brands/{ブランドのID(brandId)}/products>' \\
-H 'X-Merchant-API-Version: 使用するAPIのバージョン(betaなど)' \\
-H 'X-Merchant-API-Key: マーチャントごとに発行された専用APIキー(sk_live_...)' \\
-d '{"modelNumber":"ブランド内で一意な品番","localizedNames":[{"languageCode":"ja","text":"製品名"},{"languageCode":"en","text":"Product Name"}],"skuTemplateId":"SKUテンプレートのID","prices":[{"transactionTermCode":"kakeritsu_transaction","currencyCode":"JPY","unitPrice":1000},{"transactionTermCode":"kakeritsu_transaction","currencyCode":"USD","unitPrice":0},{"transactionTermCode":"exw","currencyCode":"JPY","unitPrice":0},{"transactionTermCode":"exw","currencyCode":"USD","unitPrice":10}],"skus":[{"skuNumber":"製品内で一意なSKU番号","components":[{"skuPropertyId":"SKUプロパティのID 1","skuPropertyVariantId":"SKUプロパティのバリアントID 1"},{"skuPropertyId":"SKUプロパティのID 2","skuPropertyVariantId":"SKUプロパティのバリアントID 2"}],"prices":[{"transactionTermCode":"kakeritsu_transaction","currencyCode":"JPY","unitPrice":1500},{"transactionTermCode":"kakeritsu_transaction","currencyCode":"USD","unitPrice":0},{"transactionTermCode":"exw","currencyCode":"JPY","unitPrice":0},{"transactionTermCode":"exw","currencyCode":"USD","unitPrice":15}]}]}'

リクエストボディ例 (必須フィールドのみ指定した場合)

{
	"modelNumber": "ブランド内で一意な品番",
	"localizedNames": [
		{
			"languageCode": "ja",
			"text": "製品名"
		},
		{
			"languageCode": "en",
			"text": "Product Name"
		}
	],
	"skuTemplateId": "SKUテンプレートのID",
	"prices": [
		{
			"transactionTermCode": "kakeritsu_transaction",
			"currencyCode": "JPY",
			"unitPrice": 1000
		},
		{
			"transactionTermCode": "kakeritsu_transaction",
			"currencyCode": "USD",
			"unitPrice": 0
		},
		{
			"transactionTermCode": "exw",
			"currencyCode": "JPY",
			"unitPrice": 0
		},
		{
			"transactionTermCode": "exw",
			"currencyCode": "USD",
			"unitPrice": 10
		}
	],
	"skus": [
		{
			"skuNumber": "製品内で一意なSKU番号",
			"components": [
				{
					"skuPropertyId": "SKUプロパティのID 1",
					"skuPropertyVariantId": "SKUプロパティのバリアントID 1"
				},
				{
					"skuPropertyId": "SKUプロパティのID 2",
					"skuPropertyVariantId": "SKUプロパティのバリアントID 2"
				}
			],
			"prices": [
				{
					"transactionTermCode": "kakeritsu_transaction",
					"currencyCode": "JPY",
					"unitPrice": 1500
				},
				{
					"transactionTermCode": "kakeritsu_transaction",
					"currencyCode": "USD",
					"unitPrice": 0
				},
				{
					"transactionTermCode": "exw",
					"currencyCode": "JPY",
					"unitPrice": 0
				},
				{
					"transactionTermCode": "exw",
					"currencyCode": "USD",
					"unitPrice": 15
				}
			]
		}
	]
}

pricesについて補足

• 環境例を前提とすると、2通貨・2取引条件の組み合わせで単価を設定する必要があるため、配列の要素数は4になる。