From 0c543745a5c4a08cc0d4ceec13ee79f97de57cd9 Mon Sep 17 00:00:00 2001 From: doi-shuhei-2024 Date: Mon, 15 Dec 2025 16:37:50 +0900 Subject: [PATCH 01/12] =?UTF-8?q?fix:=20FUND-423=20=E5=9C=A8=E5=BA=AB?= =?UTF-8?q?=E4=B8=80=E8=A6=A7=E5=8F=96=E5=BE=97API=E3=81=AB=E3=83=90?= =?UTF-8?q?=E3=83=AA=E3=82=A8=E3=83=BC=E3=82=B7=E3=83=A7=E3=83=B3=E3=82=92?= =?UTF-8?q?=E8=BF=BD=E5=8A=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- includes/api/inventories.md | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/includes/api/inventories.md b/includes/api/inventories.md index 2f6a4e7..27e8977 100644 --- a/includes/api/inventories.md +++ b/includes/api/inventories.md @@ -22,7 +22,8 @@ 例： https://web.zaico.co.jp/api/v1/inventories/?title=在庫データ&category=物品&place=ZAICO倉庫&code=123456789&optional_attributes_name=担当者&optional_attributes_value=宮下 ``` - +* バリエーションが利用可能なプランの場合、URLにクエリ「include_variant_setting=true」をつけるとバリエーションの設定項目が取得できます。 + + Request + Headers Authorization: Bearer YOUR_TOKEN @@ -237,6 +238,24 @@ + original_filename: `image.jpg` (string) - ファイル名 + url: `https://web.zaico.co.jp/files/image.jpg` (string) - ファイルのURL + created_at: `2022-01-01 09:00:00` (string) - 作成日時 ++ variant_setting_enabled: true (boolean) - バリエーション設定が有効かどうか ++ variant_setting: (array) - バリエーション設定情報 + + () + + variant_setting_item_id: `1` (number) - バリエーション項目ID + + label: `ロット番号` (string) - バリエーションの項目名 + + item_type: `number` (string) - バリエーションのデータ型 + + enabled_deadline_alert: false (boolean) - 期限アラートが有効か + + () + + variant_setting_item_id: `2` (number) - バリエーション項目ID + + label: `拠点` (string) - バリエーションの項目名 + + item_type: `text` (string) - バリエーションのデータ型 + + enabled_deadline_alert: false (boolean) - 期限アラートが有効か + + () + + variant_setting_item_id: `3` (number) - バリエーション項目ID + + label: `利用期限` (string) - バリエーションの項目名 + + item_type: `date` (string) - バリエーションのデータ型 + + enabled_deadline_alert: true (boolean) - 期限アラートが有効か + + deadline_alert_day: `10` (number) - 期限アラート ### InventoryNotFound + code: 404 ( number ) - ステータスコード From c374bcd8a737c983118e4f71f52bcc3208fb919d Mon Sep 17 00:00:00 2001 From: doi-shuhei-2024 Date: Mon, 15 Dec 2025 17:20:53 +0900 Subject: [PATCH 02/12] =?UTF-8?q?fix:=20FUND-423=20=E5=9C=A8=E5=BA=AB?= =?UTF-8?q?=E5=80=8B=E5=88=A5=E5=8F=96=E5=BE=97API=E3=81=AB=E3=83=90?= =?UTF-8?q?=E3=83=AA=E3=82=A8=E3=83=BC=E3=82=B7=E3=83=A7=E3=83=B3=E3=82=92?= =?UTF-8?q?=E8=BF=BD=E5=8A=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- includes/api/inventories.md | 56 +++++++++++++++++++++++++++++++++++-- 1 file changed, 54 insertions(+), 2 deletions(-) diff --git a/includes/api/inventories.md b/includes/api/inventories.md index 27e8977..4418389 100644 --- a/includes/api/inventories.md +++ b/includes/api/inventories.md @@ -33,7 +33,7 @@ + Headers Link: ; rel="first", ; rel="prev", ; rel="next", ; rel="last" Total-Count: 在庫データ件数 - + Attributes (InventoriesViews) + + Attributes (InventoriesIndexViews) @@ -76,6 +76,7 @@ * 在庫データを1件のみ取得します * 棚卸日は設定されている場合のみ表示されます * 発注点は設定されている場合のみ表示されます +* バリエーションが利用可能なプランの場合、URLにクエリ「include_variants=true」をつけるとバリエーションの情報が取得できます。バリエーションのデータが1000件以上ある場合は「variants_page=」でページネーションして取得できます。 ### 注意事項 * 在庫データが無い場合は404を返します @@ -89,7 +90,7 @@ Content-Type: application/json + Response 200 (application/json) - + Attributes (InventoriesViews) + + Attributes (InventoriesShowViews) + Response 404 (application/json) + Attributes (InventoryNotFound) @@ -257,6 +258,57 @@ + enabled_deadline_alert: true (boolean) - 期限アラートが有効か + deadline_alert_day: `10` (number) - 期限アラート +### InventoriesIndexViews(InventoriesViews) + +### InventoriesShowViews(InventoriesViews) ++ variants: - バリエーション情報 + + data: (array) + + () + + items: (array) + + () + + variant_setting_item_id: `1` (number) - バリエーション項目ID + + label: `ロット番号` (string) - バリエーションの項目名 + + value: `100` (string) - バリエーションの値 + + () + + variant_setting_item_id: `2` (number) - バリエーション項目ID + + label: `拠点` (string) - バリエーションの項目名 + + value: `第一倉庫` (string) - バリエーションの値 + + () + + variant_setting_item_id: `3` (number) - バリエーション項目ID + + label: `利用期限` (string) - バリエーションの項目名 + + value: `2025/12/31` - バリエーションの値 + + quantity: `10.0` (number) - 数量 + + logical_quantity: `20.0` (number) - 予定フリー在庫数 + + code: `tw202500000001` (string) - バーコードの値 + + purchase_unit_price: `800.0` (number) - 仕入単価 + + packing_slip_unit_price: `1000.0` (number) - 納品単価 + + created_at: `2025-10-10T15:02:01+09:00` (string) - 作成日 + + updated_at: `2025-10-10T15:02:40+09:00` (string) - 更新日 + + create_user_name: `田村 太郎` (string) - 作成者 + + () + + items: (array) + + () + + variant_setting_item_id: `1` (number) - バリエーション項目ID + + label: `ロット番号` (string) - バリエーションの項目名 + + value: `200` (string) - バリエーションの値 + + () + + variant_setting_item_id: `2` (number) - バリエーション項目ID + + label: `拠点` (string) - バリエーションの項目名 + + value: `第二倉庫` (string) - バリエーションの値 + + () + + variant_setting_item_id: `3` (number) - バリエーション項目ID + + label: `利用期限` (string) - バリエーションの項目名 + + value: `2026/01/31` - バリエーションの値 + + quantity: `15.0` (number) - 数量 + + logical_quantity: `30.0` (number) - 予定フリー在庫数 + + code: `tw202500000002` (string) - バーコードの値 + + purchase_unit_price: `700.0` (number) - 仕入単価 + + packing_slip_unit_price: `900.0` (number) - 納品単価 + + created_at: `2025-10-10T15:05:06+09:00` (string) - 作成日 + + updated_at: `2025-10-10T15:06:12+09:00` (string) - 更新日 + + create_user_name: `田村 太郎` (string) - 作成者 + + total_count: `2` (number) - バリエーションデータの件数 + ### InventoryNotFound + code: 404 ( number ) - ステータスコード + status: `error` ( string ) - ステータス From 33dd29f486a44e98a3d3b377376c44a5997d6001 Mon Sep 17 00:00:00 2001 From: doi-shuhei-2024 Date: Mon, 15 Dec 2025 17:47:50 +0900 Subject: [PATCH 03/12] =?UTF-8?q?fix:=20FUND-423=20=E5=9C=A8=E5=BA=AB?= =?UTF-8?q?=E3=83=87=E3=83=BC=E3=82=BF=E4=BD=9C=E6=88=90API=E3=81=AB?= =?UTF-8?q?=E3=83=90=E3=83=AA=E3=82=A8=E3=83=BC=E3=82=B7=E3=83=A7=E3=83=B3?= =?UTF-8?q?=E3=82=92=E8=BF=BD=E5=8A=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- includes/api/inventories.md | 29 +++++++++++++++++++++++------ 1 file changed, 23 insertions(+), 6 deletions(-) diff --git a/includes/api/inventories.md b/includes/api/inventories.md index 4418389..eb79482 100644 --- a/includes/api/inventories.md +++ b/includes/api/inventories.md @@ -51,6 +51,7 @@ * 変更履歴のメモも一緒に保存することが可能です。詳しくは下記Bodyをご覧ください * 棚卸日はstocktake_attributes: { checked_at: 日付 }で登録・変更が可能です * 発注点を設定することも可能です +* バリエーションが利用可能なプランの場合、在庫データ作成時にバリエーション項目を設定することも可能です + Request + Headers @@ -121,7 +122,7 @@ Authorization: Bearer YOUR_TOKEN Content-Type: application/json + Params - + Attributes (InventoryCreateParams) + + Attributes (InventoryUpdateParams) + Response 200 (application/json) + Attributes (InventoryUpdateSuccessfully) @@ -177,7 +178,7 @@ + status: `success` (string) - 状態 + message: `Data was successfully deleted.` (string) - メッセージ -### InventoryCreateParams +### InventoryUpdateParams + title: `在庫データ` (string, required) - 在庫データタイトル + quantity: 10 (string) - 数量 + unit: `個` (string) - 単位 @@ -203,6 +204,22 @@ + quantity_auto_conversion_by_unit_name: `箱` (string) - 単位換算後の単位名 + quantity_auto_conversion_by_unit_factor: `12` (string) - 単位換算係数 +### InventoryCreateParams(InventoryUpdateParams) ++ variant_setting: (object) + + enabled: true (boolean) - バリエーション設定を有効化するかどうか + + items: (array) - バリエーション項目 + + () + + label: `ロット番号` (string) - バリエーションの項目名 + + item_type: `number` (string) - バリエーションのデータ型 + + () + + label: `拠点` (string) - バリエーションの項目名 + + item_type: `text` (string) - バリエーションのデータ型 + + () + + label: `利用期限` (string) - バリエーションの項目名 + + item_type: `date` (string) - バリエーションのデータ型 + + enabled_deadline_alert: true (boolean) - 期限アラートを有効化するかどうか + + deadline_alert_day: `10` (number) - 期限アラートを何日前に通知するか + ### InventoriesViews + id: 1 (number) - ID + title: `在庫データ` (string) - 在庫データタイトル @@ -245,18 +262,18 @@ + variant_setting_item_id: `1` (number) - バリエーション項目ID + label: `ロット番号` (string) - バリエーションの項目名 + item_type: `number` (string) - バリエーションのデータ型 - + enabled_deadline_alert: false (boolean) - 期限アラートが有効か + + enabled_deadline_alert: false (boolean) - 期限アラートが有効かどうか + () + variant_setting_item_id: `2` (number) - バリエーション項目ID + label: `拠点` (string) - バリエーションの項目名 + item_type: `text` (string) - バリエーションのデータ型 - + enabled_deadline_alert: false (boolean) - 期限アラートが有効か + + enabled_deadline_alert: false (boolean) - 期限アラートが有効かどうか + () + variant_setting_item_id: `3` (number) - バリエーション項目ID + label: `利用期限` (string) - バリエーションの項目名 + item_type: `date` (string) - バリエーションのデータ型 - + enabled_deadline_alert: true (boolean) - 期限アラートが有効か - + deadline_alert_day: `10` (number) - 期限アラート + + enabled_deadline_alert: true (boolean) - 期限アラートが有効かどうか + + deadline_alert_day: `10` (number) - 期限アラートを何日前に通知するか ### InventoriesIndexViews(InventoriesViews) From 1d0216d01393651053ace9c35849ce0e1487d619 Mon Sep 17 00:00:00 2001 From: doi-shuhei-2024 Date: Mon, 15 Dec 2025 18:11:40 +0900 Subject: [PATCH 04/12] =?UTF-8?q?fix:=20FUND-423=20=E5=85=A5=E5=BA=AB?= =?UTF-8?q?=E3=83=87=E3=83=BC=E3=82=BF=E4=BD=9C=E6=88=90API=E3=81=AB?= =?UTF-8?q?=E3=83=90=E3=83=AA=E3=82=A8=E3=83=BC=E3=82=B7=E3=83=A7=E3=83=B3?= =?UTF-8?q?=E3=82=92=E8=BF=BD=E5=8A=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- includes/api/purchases.md | 37 ++++++++++++++++++++++++++++++++++++- 1 file changed, 36 insertions(+), 1 deletion(-) diff --git a/includes/api/purchases.md b/includes/api/purchases.md index d37bef8..4c8826f 100644 --- a/includes/api/purchases.md +++ b/includes/api/purchases.md @@ -168,6 +168,14 @@ HOST: https://web.zaico.co.jp/ * unit_price : 仕入単価 * estimated_purchase_date : 入庫予定日 * etc : 摘要・備考 + * variants : バリエーションデータ + * 以下のパラメータを含むオブジェクトを配列の要素とします + * items : 以下のパラメータを含むオブジェクトを配列の要素とします + * label : バリエーションの項目名 + * value : バリエーションの値 + * quantity : バリエーション毎の入庫数量 + * unit_price : バリエーション毎の仕入単価 + * code : バーコードの値 + Request + Headers @@ -438,9 +446,36 @@ HOST: https://web.zaico.co.jp/ ## CreatePurchaseItem (object) + inventory_id: 1 (number, required) - 在庫データID -+ quantity: 3 (number, required) - 入庫数量 ++ quantity: 25 (number, required) - 入庫数量 + unit_price: 100 (number, optional) - 仕入単価 + estimated_purchase_date: `2019-09-01` (string, optional, nullable) ++ variants: (array) + + () + + items: (array) + + () + + label: `ロット番号` (string) + + value: `100` (string) + + () + + label: `拠点` (string) + + value: `第一倉庫` (string) + + () + + label: `利用期限` (string) + + value: `2025/12/31` (string) + + quantity: `10` (number) + + unit_price: `800` (number) + + () + + items: (array) + + () + + label: `ロット番号` (string) + + value: `200` (string) + + () + + label: `拠点` (string) + + value: `第二倉庫` (string) + + () + + label: `利用期限` (string) + + value: `2026/01/31` (string) + + quantity: `15` (number) + + unit_price: `700` (number) ## UpdatePurchaseItemToPurchased + inventory_id: 1 (number, required) - 在庫データID From 1d47c289db52957e73341a54586210b824ca4f2e Mon Sep 17 00:00:00 2001 From: doi-shuhei-2024 Date: Tue, 16 Dec 2025 10:40:10 +0900 Subject: [PATCH 05/12] =?UTF-8?q?fix:=20FUND-423=20=E5=87=BA=E5=BA=AB?= =?UTF-8?q?=E3=83=87=E3=83=BC=E3=82=BF=E4=BD=9C=E6=88=90API=E3=81=AB?= =?UTF-8?q?=E3=83=90=E3=83=AA=E3=82=A8=E3=83=BC=E3=82=B7=E3=83=A7=E3=83=B3?= =?UTF-8?q?=E3=82=92=E8=BF=BD=E5=8A=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- includes/api/packing_slips.md | 8 ++++++++ includes/api/purchases.md | 29 ++++++++++++++++++++++++++++- 2 files changed, 36 insertions(+), 1 deletion(-) diff --git a/includes/api/packing_slips.md b/includes/api/packing_slips.md index b8e5288..63c4e6a 100644 --- a/includes/api/packing_slips.md +++ b/includes/api/packing_slips.md @@ -180,6 +180,14 @@ * unit_price : 納品単価 * estimated_delivery_date : 出庫予定日 * etc : 摘要・備考 + * variants : バリエーションデータ（登録済みのデータのみ指定できます） + * 以下のパラメータを含むオブジェクトを配列の要素とします + * items : 以下のパラメータを含むオブジェクトを配列の要素とします + * label : バリエーションの項目名 + * value : バリエーションの値 + * quantity : バリエーション毎の入庫数量 + * unit_price : バリエーション毎の仕入単価 + * code : バーコードの値 * shipping_instruction : 発送情報（フルプランのみ設定できます） * to_name : 宛名 * to_name_postfix : 敬称 diff --git a/includes/api/purchases.md b/includes/api/purchases.md index 4c8826f..c52ad5f 100644 --- a/includes/api/purchases.md +++ b/includes/api/purchases.md @@ -394,9 +394,36 @@ HOST: https://web.zaico.co.jp/ ## CreateDelivery (object) + inventory_id: 1 (number, required) - 在庫データID -+ quantity: 3 (number, required) - 出庫数量 ++ quantity: 25 (number, required) - 出庫数量 + unit_price: 100 (number, optional) - 納品単価 + estimated_delivery_date: `2019-09-01` (string, optional, nullable) ++ variants: (array) + + () + + items: (array) + + () + + label: `ロット番号` (string) + + value: `100` (string) + + () + + label: `拠点` (string) + + value: `第一倉庫` (string) + + () + + label: `利用期限` (string) + + value: `2025/12/31` (string) + + quantity: `10` (number) + + unit_price: `800` (number) + + () + + items: (array) + + () + + label: `ロット番号` (string) + + value: `200` (string) + + () + + label: `拠点` (string) + + value: `第二倉庫` (string) + + () + + label: `利用期限` (string) + + value: `2026/01/31` (string) + + quantity: `15` (number) + + unit_price: `700` (number) ## UpdateDeliveryToCompleted + inventory_id: 1 (number, required) - 在庫データID From 567c243d9a8362ffc6e08f24300db3013bcb122d Mon Sep 17 00:00:00 2001 From: doi-shuhei-2024 Date: Wed, 17 Dec 2025 09:13:21 +0900 Subject: [PATCH 06/12] =?UTF-8?q?fix:=20FUND-423=20=E5=85=A5=E5=BA=AB?= =?UTF-8?q?=E7=89=A9=E5=93=81=E3=83=87=E3=83=BC=E3=82=BF=E4=B8=80=E8=A6=A7?= =?UTF-8?q?=E5=8F=96=E5=BE=97=E3=81=AB=E3=83=90=E3=83=AA=E3=82=A8=E3=83=BC?= =?UTF-8?q?=E3=82=B7=E3=83=A7=E3=83=B3=E3=82=92=E8=BF=BD=E5=8A=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- includes/api/purchases.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/includes/api/purchases.md b/includes/api/purchases.md index c52ad5f..39ae368 100644 --- a/includes/api/purchases.md +++ b/includes/api/purchases.md @@ -552,6 +552,23 @@ HOST: https://web.zaico.co.jp/ * etc: 摘要・備考 * created_at: 登録日時 * updated_at: 更新日時 + * variants : バリエーションデータ + * 以下のパラメータを含むオブジェクトを配列の要素とします + * data_key : 在庫毎にバリエーションデータを一意に識別するキー + * quantity : バリエーション明細の入庫数量 + * unit_price : バリエーション明細の仕入単価 + * amount : バリエーション明細の入庫金額 + * unit_snapshot : 単位情報のスナップショット + * 以下のパラメータを含むオブジェクトとします + * factor : まとめ単位の換算係数 + * piece_name : 基本単位の名称 + * box_name : まとめ単位の名称 + * box_quantity : まとめ単位での入庫数量 + * box_unit : まとめ単位の名称 + * items : 以下のパラメータを含むオブジェクトとします + * id : 以下のパラメータを含むオブジェクトとします + * id : バリエーションの項目ID + * value : バリエーションの値 + Parameters + status: `none, not_ordered, ordered, purchased, quotation_requested` (string, optional) - ステータス @@ -590,6 +607,21 @@ HOST: https://web.zaico.co.jp/ + etc: (string) + created_at: `2023-11-16 11:27:24` (string) + updated_at: `2023-11-16 11:27:24` (string) + + variants: (array) + + () + + data_key: 347554bad83fd5dc1624af2c97895e279eef35f8e252231169172d0fd96757df (string) + + quantity: 10.0 (number) + + unit_price: 200.0 (number) + + amount: 2000.0 (number) + + box_quantity: 10.0 (number) + + box_unit: 個 (string) + + items: () + + 2: () + + id: 2 (number) + + value: 第一倉庫 (string) + + 3: () + + id: 3 (number) + + value: 2023/11/30 (string) ## 入庫物品データ削除 [/api/v1/purchases/items/{id}] ### 入庫物品データ削除 [DELETE] From 1fec87f854d5a47a99bdcb5120323b34d70fa414 Mon Sep 17 00:00:00 2001 From: doi-shuhei-2024 Date: Wed, 17 Dec 2025 11:18:33 +0900 Subject: [PATCH 07/12] =?UTF-8?q?fix:=20FUND-423=20=E5=87=BA=E5=BA=AB?= =?UTF-8?q?=E7=89=A9=E5=93=81=E3=83=87=E3=83=BC=E3=82=BF=E4=B8=80=E8=A6=A7?= =?UTF-8?q?=E5=8F=96=E5=BE=97=E3=81=AB=E3=83=90=E3=83=AA=E3=82=A8=E3=83=BC?= =?UTF-8?q?=E3=82=B7=E3=83=A7=E3=83=B3=E3=82=92=E8=BF=BD=E5=8A=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- includes/api/packing_slips.md | 40 +++++++++++++++++++++++++++++++---- 1 file changed, 36 insertions(+), 4 deletions(-) diff --git a/includes/api/packing_slips.md b/includes/api/packing_slips.md index 63c4e6a..3e0acf1 100644 --- a/includes/api/packing_slips.md +++ b/includes/api/packing_slips.md @@ -470,6 +470,23 @@ * date_of_issue: 納品書に記載される出庫日, * created_at: 登録日時 * updated_at: 更新日時 + * variants : バリエーションデータ + * 以下のパラメータを含むオブジェクトを配列の要素とします + * data_key : 在庫毎にバリエーションデータを一意に識別するキー + * quantity : バリエーション明細の出庫数量 + * unit_price : バリエーション明細の納品単価 + * amount : バリエーション明細の出庫金額 + * unit_snapshot : 単位情報のスナップショット + * 以下のパラメータを含むオブジェクトとします + * factor : まとめ単位の換算係数 + * piece_name : 基本単位の名称 + * box_name : まとめ単位の名称 + * box_quantity : まとめ単位での出庫数量 + * box_unit : まとめ単位の名称 + * items : 以下のパラメータを含むオブジェクトとします + * id : 以下のパラメータを含むオブジェクトとします + * id : バリエーションの項目ID + * value : バリエーションの値 + Parameters + status: `before_delivery, during_delivery, completed_delivery`, `completed_delivery` (string, optional) - ステータス @@ -490,10 +507,10 @@ + unit: 台 (string) + unit_price: 100 (string) + status: completed_delivery (string) - + delivery_date: 2021-11-17 (string) + + delivery_date: `2021-11-17` (string) + estimated_delivery_date: (string, nullable) + etc: (string) - + date_of_issue: 2021-11-17 (string) + + date_of_issue: `2021-11-17` (string) + created_at: `2023-11-16 11:27:24` (string) + updated_at: `2023-11-16 11:27:24` (string) + () @@ -504,9 +521,24 @@ + unit: 台 (string) + unit_price: 100 (string) + status: completed_delivery (string) - + delivery_date: 2021-11-17 (string) + + delivery_date: `2021-11-17` (string) + estimated_delivery_date: (string, nullable) + etc: (string) - + date_of_issue: 2021-11-17 (string) + + date_of_issue: `2021-11-17` (string) + created_at: `2023-11-16 11:27:24` (string) + updated_at: `2023-11-16 11:27:24` (string) + + variants: (array) + + () + + data_key: 347554bad83fd5dc1624af2c97895e279eef35f8e252231169172d0fd96757df (string) + + quantity: 3.0 (number) + + unit_price: 100.0 (number) + + amount: 300.0 (number) + + box_quantity: 3.0 (number) + + box_unit: 台 (string) + + items: () + + 4: () + + id: 4 (number) + + value: `20251217-A01-1000` (string) + + 5: () + + id: 5 (number) + + value: 第一倉庫 (string) From 6f9818110a667c4efbffc67219523cd890c9d51f Mon Sep 17 00:00:00 2001 From: doi-shuhei-2024 Date: Wed, 17 Dec 2025 11:22:17 +0900 Subject: [PATCH 08/12] =?UTF-8?q?fix:=20FUND-423=20=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=E6=97=A5=E3=81=A8=E6=A1=88=E5=86=85=E6=96=87=E3=82=92=E4=BF=AE?= =?UTF-8?q?=E6=AD=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- api.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/api.md b/api.md index 030638c..daf1642 100755 --- a/api.md +++ b/api.md @@ -7,14 +7,14 @@ HOST: https://web.zaico.co.jp
バリエーションについて -2024年9月4日にリリースしたバリエーション機能については現在公開APIから操作することはできません。 +2024年9月4日にリリースしたバリエーション機能については、現在一部の公開APIからのみ操作することができます。 -対応時期については決まり次第別途お知らせいたします。 +その他のAPIの対応時期については決まり次第別途お知らせいたします。 ご不便をおかけしますが、ご了承のほどよろしくお願いいたします。
-2025年10月14日更新 +2025年12月18日更新 From 8df6edf399c06b7d38ebff1c7e1fb23aa42cfd41 Mon Sep 17 00:00:00 2001 From: doi-shuhei-2024 Date: Wed, 17 Dec 2025 11:24:08 +0900 Subject: [PATCH 09/12] fix: FUND-423 yarn build --- dist/index.html | 429 ++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 413 insertions(+), 16 deletions(-) diff --git a/dist/index.html b/dist/index.html index cdd28c0..2d57e7c 100644 --- a/dist/index.html +++ b/dist/index.html @@ -1,11 +1,11 @@ zaico API Document Back to top

zaico API Document

このドキュメントはZAICO APIの機能と使うために必要なパラメータなどを説明するものです。

バリエーションについて -

2024年9月4日にリリースしたバリエーション機能については現在公開APIから操作することはできません。

-

対応時期については決まり次第別途お知らせいたします。

+

2024年9月4日にリリースしたバリエーション機能については、現在一部の公開APIからのみ操作することができます。

+

その他のAPIの対応時期については決まり次第別途お知らせいたします。

ご不便をおかけしますが、ご了承のほどよろしくお願いいたします。

-

2024年11月27日更新

+

2025年12月18日更新

認証

認証について

GET

概要

@@ -50,6 +50,9 @@

概要

POST/api/v1/inventories

処理概要

@@ -264,6 +297,9 @@

注意事項 


 
    
@@ -524,6 +595,87 @@ 
    Example URI
    GET&
     "original_filename": "image.jpg",
     "url": "https://web.zaico.co.jp/files/image.jpg",
     "created_at": "2022-01-01 09:00:00"
+  },
+  "variant_setting_enabled": true,
+  "variant_setting": [
+    {
+      "variant_setting_item_id": 1,
+      "label": "ロット番号",
+      "item_type": "number",
+      "enabled_deadline_alert": false
+    },
+    {
+      "variant_setting_item_id": 2,
+      "label": "拠点",
+      "item_type": "text",
+      "enabled_deadline_alert": false
+    },
+    {
+      "variant_setting_item_id": 3,
+      "label": "利用期限",
+      "item_type": "date",
+      "enabled_deadline_alert": true,
+      "deadline_alert_day": 10
+    }
+  ],
+  "variants": {
+    "data": [
+      {
+        "items": [
+          {
+            "variant_setting_item_id": 1,
+            "label": "ロット番号",
+            "value": "100"
+          },
+          {
+            "variant_setting_item_id": 2,
+            "label": "拠点",
+            "value": "第一倉庫"
+          },
+          {
+            "variant_setting_item_id": 3,
+            "label": "利用期限",
+            "value": "2025/12/31"
+          }
+        ],
+        "quantity": 10,
+        "logical_quantity": 20,
+        "code": "tw202500000001",
+        "purchase_unit_price": 800,
+        "packing_slip_unit_price": 1000,
+        "created_at": "2025-10-10T15:02:01+09:00",
+        "updated_at": "2025-10-10T15:02:40+09:00",
+        "create_user_name": "田村 太郎"
+      },
+      {
+        "items": [
+          {
+            "variant_setting_item_id": 1,
+            "label": "ロット番号",
+            "value": "200"
+          },
+          {
+            "variant_setting_item_id": 2,
+            "label": "拠点",
+            "value": "第二倉庫"
+          },
+          {
+            "variant_setting_item_id": 3,
+            "label": "利用期限",
+            "value": "2026/01/31"
+          }
+        ],
+        "quantity": 15,
+        "logical_quantity": 30,
+        "code": "tw202500000002",
+        "purchase_unit_price": 700,
+        "packing_slip_unit_price": 900,
+        "created_at": "2025-10-10T15:05:06+09:00",
+        "updated_at": "2025-10-10T15:06:12+09:00",
+        "create_user_name": "田村 太郎"
+      }
+    ],
+    "total_count": 2
   }
 }
Schema
{
   "$schema": "http://json-schema.org/draft-04/schema#",
@@ -667,6 +819,27 @@ 
Example URI
GET&
           "description": "作成日時"
         }
       }
+    },
+    "variant_setting_enabled": {
+      "type": "boolean",
+      "description": "バリエーション設定が有効かどうか"
+    },
+    "variant_setting": {
+      "type": "array",
+      "description": "バリエーション設定情報"
+    },
+    "variants": {
+      "type": "object",
+      "properties": {
+        "data": {
+          "type": "array"
+        },
+        "total_count": {
+          "type": "number",
+          "description": "バリエーションデータの件数"
+        }
+      },
+      "description": "バリエーション情報"
     }
   }
 }
Response  404
HideShow
Headers
Content-Type: application/json
Body
{
@@ -1753,6 +1926,7 @@ 
Example URI
DELETE
 
 
  • memo : 出庫メモ
    • 
+
  • note: 納品書備考
    • 
 
  • created_at : 出庫データ作成日
    • 
 
  • updated_at : 出庫データ更新日
    • 
 
  • deliveries : 出庫データに登録している在庫データ一覧
@@ -1958,6 +2132,7 @@ 
    Example URI
    GET&
 
 
    • 
 
  • memo : 出庫メモ
    • 
+
  • note: 納品書備考
    • 
 
  • deliveries : 対象となる在庫データの配列
 
      
 
    • 以下のパラメータを含むオブジェクトを配列の要素とします
@@ -1967,6 +2142,23 @@ 
      Example URI
      GET&
 
    • unit_price : 納品単価
      • 
 
    • estimated_delivery_date : 出庫予定日
      • 
 
    • etc : 摘要・備考
      • 
+
    • variants : バリエーションデータ（登録済みのデータのみ指定できます）
+
        
+
      • 以下のパラメータを含むオブジェクトを配列の要素とします
+
          
+
        • items : 以下のパラメータを含むオブジェクトを配列の要素とします
+
            
+
          • label : バリエーションの項目名
            • 
+
          • value : バリエーションの値
            • 
+
          
+
          • 
+
        • quantity : バリエーション毎の入庫数量
          • 
+
        • unit_price : バリエーション毎の仕入単価
          • 
+
        • code : バーコードの値
          • 
+
        
+
        • 
+
      
+
      • 
 
    
 
    • 
 
@@ -2015,9 +2207,47 @@ 
    Example URI
    POSTdeliveries": [
     {
       "inventory_id": 1,
-      "quantity": 3,
+      "quantity": 25,
       "unit_price": 100,
-      "estimated_delivery_date": "2019-09-01"
+      "estimated_delivery_date": "2019-09-01",
+      "variants": [
+        {
+          "items": [
+            {
+              "label": "ロット番号",
+              "value": "100"
+            },
+            {
+              "label": "拠点",
+              "value": "第一倉庫"
+            },
+            {
+              "label": "利用期限",
+              "value": "2025/12/31"
+            }
+          ],
+          "quantity": 10,
+          "unit_price": 800
+        },
+        {
+          "items": [
+            {
+              "label": "ロット番号",
+              "value": "200"
+            },
+            {
+              "label": "拠点",
+              "value": "第二倉庫"
+            },
+            {
+              "label": "利用期限",
+              "value": "2026/01/31"
+            }
+          ],
+          "quantity": 15,
+          "unit_price": 700
+        }
+      ]
     }
   ],
   "shipping_instruction": {
@@ -2194,6 +2424,7 @@ 
    Example URI
    POST
 
 
  • memo : 出庫メモ
    • 
+
  • note: 納品書備考
    • 
 
  • created_at : 出庫データ作成日
    • 
 
  • updated_at : 出庫データ更新日
    • 
 
  • deliveries : 出庫データに登録している在庫データ一覧
@@ -2529,6 +2760,7 @@ 
    Example URI
    GET&
 
  • num : 出庫データ番号（ユーザーが任意に設定できる番号）
    • 
 
  • customer_name : 取引先名
    • 
 
  • memo : 出庫メモ
    • 
+
  • note: 納品書備考
    • 
 
  • deliveries : 対象となる在庫データの配列
 
      
 
    • 以下のパラメータを含むオブジェクトを配列の要素とします
@@ -2841,6 +3073,41 @@ 
      Example URI
      DELETEdate_of_issue: 納品書に記載される出庫日,
      • 
 
    • created_at: 登録日時
      • 
 
    • updated_at: 更新日時
      • 
+
    • variants : バリエーションデータ
+
        
+
      • 以下のパラメータを含むオブジェクトを配列の要素とします
+
          
+
        • data_key : 在庫毎にバリエーションデータを一意に識別するキー
          • 
+
        • quantity : バリエーション明細の出庫数量
          • 
+
        • unit_price : バリエーション明細の納品単価
          • 
+
        • amount : バリエーション明細の出庫金額
          • 
+
        • unit_snapshot : 単位情報のスナップショット
+
            
+
          • 以下のパラメータを含むオブジェクトとします
+
              
+
            • factor : まとめ単位の換算係数
              • 
+
            • piece_name : 基本単位の名称
              • 
+
            • box_name : まとめ単位の名称
              • 
+
            
+
            • 
+
          
+
          • 
+
        • box_quantity : まとめ単位での出庫数量
          • 
+
        • box_unit : まとめ単位の名称
          • 
+
        • items : 以下のパラメータを含むオブジェクトとします
+
            
+
          • id : 以下のパラメータを含むオブジェクトとします
+
              
+
            • id : バリエーションの項目ID
              • 
+
            • value : バリエーションの値
              • 
+
            
+
            • 
+
          
+
          • 
+
        
+
        • 
+
      
+
      • 
 
    
 
    • 
 
@@ -2865,10 +3132,10 @@ 
    Example URI
    GET&
     "unit": "台",
     "unit_price": "100",
     "status": "completed_delivery",
-    "delivery_date": "2021",
+    "delivery_date": "2021-11-17",
     "estimated_delivery_date": "Hello, world!",
     "etc": "Hello, world!",
-    "date_of_issue": "2021",
+    "date_of_issue": "2021-11-17",
     "created_at": "2023-11-16 11:27:24",
     "updated_at": "2023-11-16 11:27:24"
   },
@@ -2880,12 +3147,32 @@ 
    Example URI
    GET&
     "unit": "台",
     "unit_price": "100",
     "status": "completed_delivery",
-    "delivery_date": "2021",
+    "delivery_date": "2021-11-17",
     "estimated_delivery_date": "Hello, world!",
     "etc": "Hello, world!",
-    "date_of_issue": "2021",
+    "date_of_issue": "2021-11-17",
     "created_at": "2023-11-16 11:27:24",
-    "updated_at": "2023-11-16 11:27:24"
+    "updated_at": "2023-11-16 11:27:24",
+    "variants": [
+      {
+        "data_key": "347554bad83fd5dc1624af2c97895e279eef35f8e252231169172d0fd96757df",
+        "quantity": 3,
+        "unit_price": 100,
+        "amount": 300,
+        "box_quantity": 3,
+        "box_unit": "台",
+        "items": {
+          "4": {
+            "id": 4,
+            "value": "20251217-A01-1000"
+          },
+          "5": {
+            "id": 5,
+            "value": "第一倉庫"
+          }
+        }
+      }
+    ]
   }
 ]
    Schema
    {
   "$schema": "http://json-schema.org/draft-04/schema#",
@@ -3104,6 +3391,23 @@ 
    Example URI
    GET&
 
  • unit_price : 仕入単価
    • 
 
  • estimated_purchase_date : 入庫予定日
    • 
 
  • etc : 摘要・備考
    • 
+
  • variants : バリエーションデータ
+
      
+
    • 以下のパラメータを含むオブジェクトを配列の要素とします
+
        
+
      • items : 以下のパラメータを含むオブジェクトを配列の要素とします
+
          
+
        • label : バリエーションの項目名
          • 
+
        • value : バリエーションの値
          • 
+
        
+
        • 
+
      • quantity : バリエーション毎の入庫数量
        • 
+
      • unit_price : バリエーション毎の仕入単価
        • 
+
      • code : バーコードの値
        • 
+
      
+
      • 
+
    
+
    • 
 
 
 
@@ -3119,9 +3423,47 @@ 
    Example URI
    POSTpurchase_items": [
     {
       "inventory_id": 1,
-      "quantity": 3,
+      "quantity": 25,
       "unit_price": 100,
-      "estimated_purchase_date": "2019-09-01"
+      "estimated_purchase_date": "2019-09-01",
+      "variants": [
+        {
+          "items": [
+            {
+              "label": "ロット番号",
+              "value": "100"
+            },
+            {
+              "label": "拠点",
+              "value": "第一倉庫"
+            },
+            {
+              "label": "利用期限",
+              "value": "2025/12/31"
+            }
+          ],
+          "quantity": 10,
+          "unit_price": 800
+        },
+        {
+          "items": [
+            {
+              "label": "ロット番号",
+              "value": "200"
+            },
+            {
+              "label": "拠点",
+              "value": "第二倉庫"
+            },
+            {
+              "label": "利用期限",
+              "value": "2026/01/31"
+            }
+          ],
+          "quantity": 15,
+          "unit_price": 700
+        }
+      ]
     }
   ]
 }
    Schema
    {
@@ -3586,6 +3928,41 @@ 
    Example URI
    DELETEetc: 摘要・備考
 
  • created_at: 登録日時
    • 
 
  • updated_at: 更新日時
    • 
+
  • variants : バリエーションデータ
+
      
+
    • 以下のパラメータを含むオブジェクトを配列の要素とします
+
        
+
      • data_key : 在庫毎にバリエーションデータを一意に識別するキー
        • 
+
      • quantity : バリエーション明細の入庫数量
        • 
+
      • unit_price : バリエーション明細の仕入単価
        • 
+
      • amount : バリエーション明細の入庫金額
        • 
+
      • unit_snapshot : 単位情報のスナップショット
+
          
+
        • 以下のパラメータを含むオブジェクトとします
+
            
+
          • factor : まとめ単位の換算係数
            • 
+
          • piece_name : 基本単位の名称
            • 
+
          • box_name : まとめ単位の名称
            • 
+
          
+
          • 
+
        
+
        • 
+
      • box_quantity : まとめ単位での入庫数量
        • 
+
      • box_unit : まとめ単位の名称
        • 
+
      • items : 以下のパラメータを含むオブジェクトとします
+
          
+
        • id : 以下のパラメータを含むオブジェクトとします
+
            
+
          • id : バリエーションの項目ID
            • 
+
          • value : バリエーションの値
            • 
+
          
+
          • 
+
        
+
        • 
+
      
+
      • 
+
    
+
    • 
 
 
 
@@ -3628,7 +4005,27 @@ 
    Example URI
    GET&
     "estimated_purchase_date": "Hello, world!",
     "etc": "Hello, world!",
     "created_at": "2023-11-16 11:27:24",
-    "updated_at": "2023-11-16 11:27:24"
+    "updated_at": "2023-11-16 11:27:24",
+    "variants": [
+      {
+        "data_key": "347554bad83fd5dc1624af2c97895e279eef35f8e252231169172d0fd96757df",
+        "quantity": 10,
+        "unit_price": 200,
+        "amount": 2000,
+        "box_quantity": 10,
+        "box_unit": "個",
+        "items": {
+          "2": {
+            "id": 2,
+            "value": "第一倉庫"
+          },
+          "3": {
+            "id": 3,
+            "value": "2023/11/30"
+          }
+        }
+      }
+    ]
   }
 ]
    Schema
    {
   "$schema": "http://json-schema.org/draft-04/schema#",
@@ -4621,7 +5018,7 @@ 
    Example URI
    POSTdescription": "エラー内容"
     }
   }
-}

    Generated by aglio on 25 Apr 2025