## 概要
このドキュメントは、商品マスタをSalesforceに登録するための仕様を提供します。
## ベースドメイン
- Sandbox
- https://sacaici--dxddev.sandbox.my.salesforce-sites.com/services/apexrest
- 本番(想定)
- https://sacaici.my.salesforce-sites.com/services/apexrest
## エンドポイント
- **URL**: `/api/v1/products/*`
- **HTTPメソッド**: PUT
## 認証
- Headerに下記を含めてください。
- POS-Signature : こちらの発行したトークン
## リクエスト
- 後述のJson形式で送付
### ヘッダー
- `Content-Type`: `application/json`
- `POS-Signature` : `[Salesforce発行トークン]`
### ボディ
リクエストボディはJSON形式で、以下の内容を含む必要があります。
```json
{
"Records": [
{
"商品コード": "string",
"バーコード": "string",
"商品名": "string",
"仕入先コード": "string",
"仕入先名": "string",
"部門コード": "string",
"部門名": "string",
"標準価格": "decimal",
"標準税額": "decimal",
"税区分": "string",
"税率": "integer",
"原価": "decimal",
"カラーコード": "string",
"色名": "string",
"サイズコード": "string",
"サイズ名": "string",
"ブランドコード": "string",
"ブランド名": "string",
"卸1価格": "decimal",
"卸2価格": "decimal",
"年度コード": "string",
"シーズンコード": "string",
"シーズン名": "string",
"SKU": "string",
"原産国": "string",
"原産国コード": "string",
"税計算区分": "string",
"免税区分": "string",
"商品管理区分": "string",
"登録日時": "string (DateTime)",
"登録者名": "string",
"更新日時": "string (DateTime)",
"更新者名": "string",
"配信日時": "string (DateTime, optional)"
}
]
}
```
## レスポンス
### 成功時
- **ステータスコード**: 200 OK
- **ボディ**:
```json
{
"status": "success",
"message": "取込に成功しました。"
}
```
### エラー時
- **ステータスコード**: 500
- **ボディ**:
```json
{
"status" : "failed",
"message" : "連携に失敗したデータが存在します。[ex.getMessage]",
"errorrecords" : [
{
"商品コード" : "000001",
"バーコード" : "000000"
},
{
"商品コード" : "000002",
"バーコード" : "000001"
},
{
"商品コード" : "000003",
"バーコード" : "000002"
},
]
}
```
## 作者
- **作成者**: 合同会社UndertheEdge
- **最終更新日**: 2025/01