docs: DEV-8994 v1非メンテ告知の追加と更新時必須仕様の追記

api.md

@@ -10,14 +10,32 @@ HOST: https://web.zaico.co.jp
   font-size: 12px;
   font-weight: normal;
 }
+.v1-deprecation-notice {
+  background-color: #fff8e1;
+  border-left: 4px solid #ffc107;
+  padding: 12px 16px;
+  margin: 16px 0;
+  border-radius: 4px;
+}
+.v1-deprecation-notice .notice-title {
+  font-weight: bold;
+  font-size: 1.05em;
+  display: block;
+  margin-bottom: 8px;
+}
 </style>
 
 # zaico API Document
 このドキュメントはZAICO APIの機能と使うために必要なパラメータなどを説明するものです。
 
-新しい公開API v2のドキュメントは[こちら](https://public-docs.zaico.co.jp/public-api-v2-doc/openapi.html)をご覧ください。
+<div class="v1-deprecation-notice">
+<span class="notice-title">⚠ 重要なお知らせ</span>
+zaico API v1 は今後、大きな機能追加・メンテナンスを予定しておりません。<br>
+新規ご利用の際は<strong>公開API v2</strong>のご利用をご検討ください。<br>
+公開API v2 ドキュメントは<a href="https://public-docs.zaico.co.jp/public-api-v2-doc/openapi.html">こちら</a>をご覧ください。
+</div>
 
-2025年12月18日更新
+2026年6月15日更新
 
 <!-- include(includes/authorization.md) -->
 

dist/index.html

@@ -7,10 +7,29 @@
   font-size: 12px;
   font-weight: normal;
 }
+.v1-deprecation-notice {
+  background-color: #fff8e1;
+  border-left: 4px solid #ffc107;
+  padding: 12px 16px;
+  margin: 16px 0;
+  border-radius: 4px;
+}
+.v1-deprecation-notice .notice-title {
+  font-weight: bold;
+  font-size: 1.05em;
+  display: block;
+  margin-bottom: 8px;
+}
 </style>
 <h1 id="header-zaico-api-document">zaico API Document <a class="permalink" href="#header-zaico-api-document" aria-hidden="true">¶</a></h1>
 <p>このドキュメントはZAICO APIの機能と使うために必要なパラメータなどを説明するものです。</p>
-<p>2025年12月18日更新</p>
+<div class="v1-deprecation-notice">
+<span class="notice-title">⚠ 重要なお知らせ</span>
+zaico API v1 は今後、大きな機能追加・メンテナンスを予定しておりません。<br>
+新規ご利用の際は<strong>公開API v2</strong>のご利用をご検討ください。<br>
+公開API v2 ドキュメントは<a href="https://public-docs.zaico.co.jp/public-api-v2-doc/openapi.html">こちら</a>をご覧ください。
+</div>
+<p>2026年6月15日更新</p>
 <section id="認証" class="resource-group"><h2 class="group-heading">認証 <a href="#認証" class="permalink">&para;</a></h2><h2 id="header-認証について">認証について <a class="permalink" href="#header-認証について" aria-hidden="true">¶</a></h2>
 <h3 id="header-get">GET <a class="permalink" href="#header-get" aria-hidden="true">¶</a></h3>
 <h4 id="header-概要">概要 <a class="permalink" href="#header-概要" aria-hidden="true">¶</a></h4>
@@ -2840,7 +2859,21 @@ <h4>Example URI</h4><div class="definition"><span class="method get">GET</span>&
 <li>出庫済在庫の状態を更新することはできません</li>
 </ul>
 </li>
-<li>delivery_date : 出庫日</li>
+<li>delivery_date : 出庫日
+<ul>
+<li>statusによって必須かどうか変わります</li>
+<li>status=completed_delivery
+<ul>
+<li>delivery_dateが必須</li>
+</ul>
+</li>
+<li>status=before_delivery
+<ul>
+<li>delivery_dateは不要</li>
+</ul>
+</li>
+</ul>
+</li>
 <li>estimated_delivery_date : 出庫予定日</li>
 <li>etc : 摘要・備考</li>
 </ul>
@@ -3659,7 +3692,7 @@ <h4 id="header-処理概要-20">処理概要 <a class="permalink" href="#header-
 <li>statusによって必須かどうか変わります</li>
 <li>status=purchased
 <ul>
-<li>purcahse_dateが必須</li>
+<li>purchase_dateが必須</li>
 </ul>
 </li>
 <li>status=not_ordered
@@ -4170,7 +4203,21 @@ <h4>Example URI</h4><div class="definition"><span class="method get">GET</span>&
 <li>入庫済在庫の状態を更新することはできません</li>
 </ul>
 </li>
-<li>purchase_date : 入庫日</li>
+<li>purchase_date : 入庫日
+<ul>
+<li>statusによって必須かどうか変わります</li>
+<li>status=purchased
+<ul>
+<li>purchase_dateが必須</li>
+</ul>
+</li>
+<li>status=not_ordered
+<ul>
+<li>purchase_dateは不要</li>
+</ul>
+</li>
+</ul>
+</li>
 <li>estimated_purchase_date : 入庫予定日</li>
 <li>etc : 摘要・備考</li>
 </ul>
@@ -5689,7 +5736,7 @@ <h4>Example URI</h4><div class="definition"><span class="method post">POST</span
       "<span class="hljs-attribute">description</span>": <span class="hljs-value"><span class="hljs-string">"エラー内容"</span>
     </span>}
   </span>}
-</span>}</code></pre><div style="height: 1px;"></div></div></div></div></div></section></div></div></div><p style="text-align: center;" class="text-muted">Generated by&nbsp;<a href="https://github.com/danielgtaylor/aglio" class="aglio">aglio</a>&nbsp;on 18 Feb 2026</p><script>/* eslint-env browser */
+</span>}</code></pre><div style="height: 1px;"></div></div></div></div></div></section></div></div></div><p style="text-align: center;" class="text-muted">Generated by&nbsp;<a href="https://github.com/danielgtaylor/aglio" class="aglio">aglio</a>&nbsp;on 15 Jun 2026</p><script>/* eslint-env browser */
 /* eslint quotes: [2, "single"] */
 'use strict';
 

includes/api/packing_slips.md

@@ -374,6 +374,11 @@
                   出庫前在庫を出庫済に更新すると **対象の在庫データの数量を減少します**
                 * 出庫済在庫の状態を更新することはできません
             * delivery_date : 出庫日
+                * statusによって必須かどうか変わります
+                * status=completed_delivery
+                    * delivery_dateが必須
+                * status=before_delivery
+                    * delivery_dateは不要
             * estimated_delivery_date : 出庫予定日
             * etc : 摘要・備考
     * shipping_instruction : 発送情報（フルプランのみ設定できます）

includes/api/purchases.md

@@ -159,7 +159,7 @@ HOST: https://web.zaico.co.jp/
     * purchase_date : 入庫日
         * statusによって必須かどうか変わります
         * status=purchased
-            * purcahse_dateが必須
+            * purchase_dateが必須
         * status=not_ordered
             * purchase_dateは不要
     * memo : 入庫メモ
@@ -338,6 +338,11 @@ HOST: https://web.zaico.co.jp/
                   入庫前在庫を入庫済に更新すると **対象の在庫データの数量を増加します**
                 * 入庫済在庫の状態を更新することはできません
             * purchase_date : 入庫日
+                * statusによって必須かどうか変わります
+                * status=purchased
+                    * purchase_dateが必須
+                * status=not_ordered
+                    * purchase_dateは不要
             * estimated_purchase_date : 入庫予定日
             * etc : 摘要・備考