---
# System prepended metadata

title: 商品マスタ

---

## 概要
このドキュメントは、商品マスタを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",
            "卸１価格": "decimal",
            "卸２価格": "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

