（ディーアクト様）ジーニー・たのめーる間システム連携QA表

⚠️ 本ファイルについての注意 元ファイルはExcelをPDFに変換したものです。PDF内の文字コード（フォント）が正しくUnicodeマッピングされておらず、pdftotext等によるテキスト抽出は文字化けして使用できませんでした。そのため、PDFを画像化して目視（OCR的に）で転記しています。なお「①QA一覧」の質問内容については、PDF上では列の表示幅の都合で本文が途中で切れていましたが、大塚商会様より全文のテキストを共有いただいたため、以下は全文を反映しています。

① QA一覧

大塚商会様（長嶋様）より2026/07/23付で受領した質問一覧。仕様書および「【D-ACT案件】大塚商会様向けの外部カタログ設定情報」で即答可能な項目にはご回答内容を記入済み（ご回答日・ご回答者は別途記入）。回答が付いていない項目は、社内確認（エンジニア確認／業務判断）が必要なため保留中。

No	質問日	質問者	質問内容	ご回答内容
01	2026/07/23	大塚商会　長嶋	別紙「注文データの確認」シートに確認項目を記載いたしました。内容のご確認とご回答をお願いいたします。	承知しました。「②注文データの確認」シートに回答しております。
02	2026/07/23	大塚商会　長嶋	No.01に関連する確認で恐縮ですが、OrderInput内のexpectationDeliveryDate（希望納期）には、不正な日付（例えば過去日付など）が入らないようなシステム制御が入っていますでしょうか。また、明細単位で値が設定されるかについてもご教示ください。（例えば１つの注文書の中に３明細含まれていた場合、３明細毎に希望納期が異なる可能性があるかどうか？）	`expectationDeliveryDate`は明細（Detail）単位の項目のため、1注文内の各明細で異なる希望納期を設定することは可能です。また、希望納期には不正な日付は入りません。画面上で本日日付以降の日付のみ入力可能な制御がされています。
03	2026/07/23	大塚商会　長嶋	No.01に関連する確認で恐縮ですが、ご注文情報の重複チェックを行う際のキー情報は、OrderInput内の「orderNumber」が使えますでしょうか？（何らかの理由で同一注文データが複数回送信された場合に重複受注しないよう、たのめーる側で重複受注のチェックを行っており、その際に利用できるキー情報のご確認となります）	`orderNumber`単体ではなく、`orderNumber`と`orderDetailNumber`（注文番号＋注文明細番号）の組み合わせがユニークキーとなります。重複チェックにはこの2項目の組み合わせをご利用ください。
04	2026/07/23	大塚商会　長嶋	OrderInput内の「division」については、弊社では「N:新規」のデータのみ処理が可能となります。（早ければ当日、遅くとも翌日中には商品をお届けするスキームのため、ご注文データ受領後、すぐに配送準備に取り掛かっており、変更や取消をシステムでお受けすることができません）そのため、「U:更新」や「D:取消」については処理対象外とさせていただきたく、ご了承いただけますでしょうか。注文変更や注文取消が必要な場合は、弊社に電話またはメールにてご連絡を頂き、マニュアル対応させていただく運用となります。ご依頼内容や商品、ご連絡いただいたタイミングによって、ご依頼をお受けできない可能性がございます。	（社内確認中）D-ACT案件としてこの運用（U/D非対応・電話/メールでの手動対応）を許容するか、業務判断が必要なため別途回答いたします。
05	2026/07/23	大塚商会　長嶋	1注文データ（1枚の注文書）の最大明細件数は何件でしょうか？（一つのorderNumberに最大何件のorderDetailNumberが紐づきますでしょうか？）	現時点で明細数の制限はございません。
06	2026/07/23	大塚商会　長嶋	たのめーるにおけるチェックアウトの最大明細件数は98件ですが、問題ありませんでしょうか？（例えば50明細までしか処理できない等の制限がないか？）	No.05のとおりJ2側に明細数の制限はないため、98明細でも問題ございません。※なお社内では「横串検索（バックグラウンド検索）経由の場合、J2側は150明細まで追加できてしまい、たのめーる側の98件上限と食い違って後で問題にならないか」という懸念が別途挙がっており、この点は継続して精査中です。
07	2026/07/23	大塚商会　長嶋	仕様書内の「本文」シートにあります「2-4. 内部商品化（API連携）」と「2-5. 内部商品化（SFTP）」については、弊社では商品マスタを外部連携できないため、開発対象外とさせていただけますでしょうか。	問題ございません。今回ご案内した設定情報にも`GetRegistItem`／`RegistItemAdd`等の内部商品化API連携情報は含めておらず、パンチアウト・バックグラウンド検索による連携のみを対象としております。内部商品化（API連携／SFTP）は開発対象外として問題ございません。
08	2026/07/23	大塚商会　長嶋	KeywordSearch内の「sortType」「firstReturnCount」「maxReturnCount」について、他バイヤー様同様の以下仕様であれば対応可能ですが、問題ありませんでしょうか。なお、「excludeKeyword」については対応できません。・sortTypeの「1：価格の安い順」固定・firstReturnCount、maxReturnCountともに300件固定	仕様上、`sortType`・`firstReturnCount`・`maxReturnCount`・`excludeKeyword`はいずれも任意項目のため、固定値設定・`excludeKeyword`非対応とも仕様上は問題ございません。
09	2026/07/23	大塚商会　長嶋	KeywordSearch内の「keywordItemAddURL」、OrderInput内の「DeliverInputURL」「ShipmentInputURL」に設定されるURLについて、他バイヤー様同様に固定化していただくことは可能でしょうか。テスト環境や本番環境など、環境によってURLが異なるのは問題ございません。	可能です。ご案内した設定情報表のとおり、STG環境・本番環境それぞれで固定のURLをご案内しております。
10	2026/07/23	大塚商会　長嶋	OrderInput内の「comment」など、ご注文時に何らかの備考を入力いただいても（例えば配送時は、受付で内線番号ｘｘ番に電話してください。等）システム内にその情報を取り込むことができないため、備考情報について対応が出来かねます。ご了承いただけますでしょうか。	（社内確認中）備考情報が伝わらないことによる業務影響がないか確認の上、別途回答いたします。
11	2026/07/23	大塚商会　長嶋	PunchOutSetUpRequestの「userID」に、利用者を一意に識別できる情報は設定されますでしょうか？「userID」に、利用者を一意に識別できる情報が設定される場合、設定される値の文字種（半角英数字のみ、ハイフンやアンダーバーなどの文字も含まれる等）と最大文字数（こちらは物理上の最大文字数ではなく、運用上想定される最大文字数）についてもご教示いただけますでしょうか。	現時点で本連携では`userID`の連携は行っておりません（設定情報表「追加連携項目」参照。必要な場合はお申し付けくださいという扱いです）。連携が必要になった際に、文字種・最大文字数について改めてご案内いたします。
12	2026/07/23	大塚商会　長嶋	PunchOutOrderMessageやKeywordItemAddに設定するカテゴリ情報について、確認させていただきたい内容を「カテゴリに関する確認」シートに記載いたしました。内容のご確認とご回答をお願いいたします。	承知しました。「④カテゴリに関する確認」に回答しております。
13	2026/07/23	大塚商会　長嶋	PunchOutOrderMessageについて、確認させていただきたい内容を「POOM確認」シートのBR列に記載いたしました。内容のご確認とご回答をお願いいたします。（下記「③ PunchOutOrderMessage項目確認」参照）	承知しました。「③PunchOutOrderMessage項目確認」に回答しております。
14	2026/07/23	大塚商会　長嶋	KeywordItemAddやItemSearch内の「RelateProduct1」～「RelateProduct5」について、設定できない項目のため、項目自体を削除して問題ないでしょうか？	問題ございません。仕様上、`RelateProduct1`～`5`はいずれも任意項目のため、設定なし（項目省略）で問題ございません。
15	2026/07/23	大塚商会　長嶋	PunchOutSetUpRequestとOrderInputの「catalogCode」は、今回のデータ連携で設定されますでしょうか？設定される場合、どのような値が設定されるかご教示お願いいたします。	設定されます。値は「デモ用：`DOTS000`」「検証環境（DACT様用）・本番環境：`DOTS001`」です（設定情報表参照）。
16	2026/07/23	大塚商会　長嶋	弊社から送信する各レスポンスデータ内の「SupplierCode」と「SupplierName」について、貴社からご指定いただくことになっておりましたので、それぞれの値についてご教示お願いいたします。	`SupplierCode`＝`OTS001`、`SupplierName`＝`大塚商会`をご指定ください。なお、こちらの情報は既にお送りしております「【D-ACT案件_大塚商会様】外部カタログ設定情報_20260629.xlsx」にも記載しておりますので、あわせてご確認ください。
17	2026/07/23	大塚商会　長嶋	納期回答情報、出荷情報内の「loginID」、「loginPWD」について、どのような値を設定すべきかご教示いただけますでしょうか。（弊社で指定可能なものでしょうか？）	`loginID`／`loginPWD`は貴社にてご指定いただく項目ではなく、弊社（Jienie）から発行いたします。値は現時点未確定のため、確定次第あらためてご連携いたします。

（No.18以降は空欄）

② 注文データの確認

たのめーるで受注処理を行う上で必要な情報と、それらをOrderInput内のどの項目から取得すればよいか大塚商会様が検討したシート。認識相違がないか確認し、F列（正しい取得元データ）への回答を依頼している。

No	項目名	必須/任意	説明	想定している取得元データ	正しい取得元データ
1	会社コード	必須	会社が特定できる半角英数のコード情報	`requestCompanyCode`	想定のとおりで問題ございません。
2	ユーザ注文番号	必須	注文書（注文データ）が特定できるユーザシステム側で管理している注文番号。（一つの注文に複数明細存在する場合は、それらの明細を取りまとめる注文番号）	`orderNumber`	想定のとおりで問題ございません。
3	郵便番号	必須	納品先の郵便番号	`deliveryDestinationPostnumber`	想定のとおりで問題ございません。
4	住所	必須	納品先の住所情報（都道府県、市区町村、字丁目、ビル名、フロアなど）	`deliveryDestinationAddress1～3`	想定のとおりで問題ございません。
5	会社名	必須	納品先の会社名	`deliveryDestinationCompanyName`	想定のとおりで問題ございません。
6	部署名	必須	納品先の部署名	`deliveryDestinationDepartmentName`	想定のとおりで問題ございません。
7	受取担当者名	必須	納品先の受取担当者名	`deliveryDestinationContactUserName`	想定のとおりで問題ございません。
8	電話番号	必須	納品先の電話番号	`deliveryDestinationTelNumber`	想定のとおりで問題ございません。
9	希望納品日	任意	一定の形式であれば問題なし（値が設定される場合の書式：yyyy/mm/dd）	`expectationDeliveryDate`	想定のとおりで問題ございません。※最短希望の場合は空文字（文字列長0）で連携されます。
10	お申込番号	任意	（`PunchOutOrderMessage`内の`SupplierPartID`）	`SupplierPartID`	想定のとおりで問題ございません。
11	数量	必須	発注数量	`orderQuantity`	想定のとおりで問題ございません。
12	単価	必須	（`PunchOutOrderMessage`内の`.../ItemDetail/UnitPrice/Money`に設定）	`orderUnitPrice`	想定のとおりで問題ございません。
13	予備1	任意	納品書の明細単位に印字できる予備エリアがあり、予備1・2ともに半角英数25文字以内であれば印字可能	ご指定があれば右側にご入力ください（印字場所は下記画面コピーをご参照ください）	仕様上は予備項目1＝仕入単価だが、これは商社版のみ対応で標準版では不要
14	予備2	任意	（予備1と同様）	同上	仕様上は予備項目2＝JANコード。商社版ではBHW側の受注案件照会画面に表示する対応済みだが、標準版については再確認中です。

添付の納品書（お買い上げ確認書）サンプル画像について：PDF内には、たのめーるの実際の「納品書（お買い上げ確認書）」の画面サンプルが添付されており、宛先・金額など個人情報/金額に関わる箇所は青塗りでマスキングされている。

サンプルの「貴社明細管理番号／貴社摘要」列（商品明細ごとの右端の列）に、予備1・予備2の印字例が示されている。

商品明細	上段（予備1の例）	下段（予備2の例）
カラー指サック M ピンク3個・ブルー2個 1パック	（値なし）	（値なし）
ゲルインキボールペン…ブラック多色ボールペン用 1パック（3本）	`1234567890`	`ABCDE`
ゲルインキボールペン…レッド多色ボールペン用 1パック（3本）	`AAABBBCCCDDDEEE`	`112233445566`

このように、1商品明細につき「貴社明細管理番号／貴社摘要」欄が2段表示され、上段に予備1、下段に予備2の値がそのまま印字される仕様であることが、サンプルから確認できる（値自体はダミー例であり、実際の運用値ではない）。

③ PunchOutOrderMessage項目確認（POOM確認）

PunchOutOrderMessage（cXML）の項目一覧をもとに、大塚商会様が値の想定を記載し、確認を依頼している項目に絞って転記する（項目定義自体は本仕様書の「2-1-4-2-1. PunchOutOrderMessage」「6-5. PunchOutOrderMessage サンプル」と同一構造のため、そちらを参照）。

No	記載箇所（タグ階層）	大塚商会様からの質問・コメント	回答（案）
1	Message > PunchOutOrderMessage > Header > Total > Money（属性:currency）	合計金額について、税抜価格合計の想定ですが、認識合ってますでしょうか？	税込・税抜の別は`Extrinsic`「`taxClass`」の設定値により判断されます。固定の想定はなく、`taxClass`に正しい値を設定いただければ問題ございません。
2	ItemIn > ItemDetail > UnitPrice > Money（属性:currency）	発注単価について、発注単価（税抜）の想定ですが、認識合ってますでしょうか？	No.1と同様、`taxClass`の設定値により判断されます。
3	ItemIn > ItemDetail > Extrinsic（name=SupplierCode）	サプライヤコードについて、こちらの項目は何らかの固定値を設定する形でしょうか？	固定値で問題ございません。値は`OTS001`をご設定ください。
4	ItemIn > ItemDetail > Extrinsic（name=SupplierName）	サプライヤ名について、こちらの項目は何らかの固定値を設定する形でしょうか？	固定値で問題ございません。値は`大塚商会`をご設定ください。
5	ItemIn > ItemDetail > Extrinsic（name=purchaseUnitQuantityPerCarton）	購入単位入数について、「1」固定にて問題ありませんでしょうか？	仕様上、数値項目としての制約はないため「1」固定で問題ございません。
6	ItemIn > ItemDetail > Extrinsic（name=quantityUnitCode）	数量単位区分について、購入単位区分と同値を設定する形で問題ありませんでしょうか？	仕様上、いずれも任意の項目のため、`purchaseUnitCode`と同値を設定いただく形で問題ございません。
7	ItemIn > ItemDetail > Extrinsic（name=quantityUnitName）	数量単位名について、購入単位名と同値を設定する形で問題ありませんでしょうか？	No.6と同様、`purchaseUnitName`と同値で問題ございません。
8	ItemIn > ItemDetail > Extrinsic（name=quantityPerCarton）	数量単位入数について、「1」固定にて問題ありませんでしょうか？	No.5と同様、「1」固定で問題ございません。
9	ItemIn > ItemDetail > Extrinsic（name=greenItem）	グリーン品規格について、オン（対象桁を1）に設定、問題ございませんでしょうか？ ※参考（元シート注記）：ご利用企業様毎にグリーン対象の規格を事前に登録いただきます。チェックアウト後、カタログモールのカート内では登録されているグリーン規格のみをグリーン品としてお客様に表示します。登録されていない規格については、グリーン品の表示はおこないません。また、貴社サイト上ではグリーンマークが表示されていても、この値が設定されていない場合には、カタログモール上ではグリーン品の表示はおこないません。	該当する桁を1に設定する形自体は問題ございません。ただし実際にグリーン品として表示されるかは、ご利用企業（バイヤー企業）様側で当該規格が事前登録されているかどうかによります（元シート注記のとおりです）。
10	ItemIn > ItemDetail > Extrinsic（name=postageFlag）	送料区分（別途費用分）について、「0」固定にて問題ありませんでしょうか？	送料等の別途費用が発生する商品を取り扱われない前提であれば、「0」固定で問題ございません。
11	ItemIn > ItemDetail > Extrinsic（name=optionalItem6）	予備項目6（UNSPSCコード）について、弊社ではUNSPSCコードを管理していないため、設定なしで問題ないでしょうか？	問題ございません。仕様上`optionalItem6`は任意項目のため、設定なしで問題ございません。

上記11件はすべて「2-1-4-2-1. PunchOutOrderMessage」セクション内の項目。以前の版で記載していたpurchaseUnitCode「1固定」、taxClass「0固定」、orderLot「1固定」、minOrderQuantity「1固定」、postageFlagの「ごく少数の商品で別途費用が発生する可能性」というコメントは、再確認の結果誤り（該当項目には「？」を含む質問なし、または質問内容の取り違え）だったため削除・訂正した。

上記以外の項目（payloadID、timestamp、Credential/Identity、BuyerCookie、ItemID/SupplierPartID、Description、UnitOfMeasure、ManufacturerPartID、ManufacturerName、LeadTime、itemSummary、itemSpec1～3、purchaseUnitCode、largeCategorycode/name、middleCategorycode/name、smallCategorycode/name、taxClass、regularPrice、orderLot、minOrderQuantity、itemURL1～3、productURL、casNo、optionalItem1～5、optionalItem7～20等）には、大塚商会様からのコメント・質問は付与されていなかった。

④ カテゴリに関する確認

弊社（たのめーる）の商品分類は、最上位階層の「種別」カテゴリから最下層の「小分類」カテゴリまで最大4階層の構造になっており、商品は第2～第4階層のいずれかの商品分類に所属する。

第1階層の分類コード以外は、それぞれの分類コードだけでなく、上位の分類コードと合わせることで商品分類を特定できる。例：第1階層の種別コード「01」だけでは「コピー用紙」という分類は特定できるが、第2階層の大分類コード「01」だけでは「普通紙」という分類は特定できない。種別コード「01」と大分類コード「01」を組み合わせた「0101」で初めて「普通紙」が特定できる。

分類コード例

種別コード	種別名	大分類コード	大分類名	中分類コード	中分類名	小分類コード	小分類名
01	コピー用紙	01	普通紙	01	特選普通紙

商品分類仕様に基づく3商品の設定例（大塚商会様が想定している設定値）

	種別コード	種別名	大分類コード	大分類名	中分類コード	中分類名	小分類コード	小分類名
商品A	01	コピー用紙	03	カラーコピー専用紙
商品B	01	コピー用紙	01	普通紙	01	特選普通紙
商品C	05	文具・事務用品	01	筆記具	01	油性ボールペン	02	ノック式ボールペン

弊社（たのめーる）が想定している設定値

	largeCategorycode	largeCategoryname	middleCategorycode	middleCategoryname	smallCategorycode	smallCategoryname
商品A	`01`	コピー用紙	`"01"-"03"`	`"コピー用紙"-"カラーコピー用紙"`	設定なし	設定なし
商品B	`01`	コピー用紙	`"01"-"01"`	`"コピー用紙"-"普通紙"`	`"01"-"01"-"01"`	`"コピー用紙"-"普通紙"-"特選普通紙"`
商品C	`05`	文具・事務用品	`"05"-"01"`	`"文具・事務用品"-"筆記具"`	`"05"-"01"-"01"-"02"`	`"文具・事務用品"-"筆記具"-"油性ボールペン"-"ノック式ボールペン"`

補足（要確認事項）

各Category情報についてcXMLとJSONで仕様が少し異なると想定している（各コード・名称のダブルクォートの囲み方）。商品C（ノック式ボールペンに所属する商品）の場合の想定値は以下のとおり。認識齟齬がないか確認依頼あり。

■cXML（PunchOutOrderMessage）の設定例

<Extrinsic name="largeCategorycode">05</Extrinsic>
<Extrinsic name="largeCategoryname">文具・事務用品</Extrinsic>
<Extrinsic name="middleCategorycode">"05"-"01"</Extrinsic>
<Extrinsic name="middleCategoryname">"文具・事務用品"-"筆記具"</Extrinsic>
<Extrinsic name="smallCategorycode">"05"-"01"-"01"-"02"</Extrinsic>
<Extrinsic name="smallCategoryname">"文具・事務用品"-"筆記具"-"油性ボールペン"-"ノック式ボールペン"</Extrinsic>

■JSON（KeywordItemAdd）の設定例

"largeCategorycode": "05",
"largeCategoryname": "文具・事務用品",
"middleCategorycode": "05-01",
"middleCategoryname": "文具・事務用品-筆記具",
"smallCategorycode": "05-01-01-02",
"smallCategoryname": "文具・事務用品-筆記具-油性ボールペン-ノック式ボールペン",

回答（案）

仕様書のサンプル（KeywordItemAddのJSON例）では、カテゴリコードは二重引用符を値の中に含めず、ハイフンのみで連結した文字列になっています（例："smallCategorycode": "99-99-99-99"）。

ご提示いただいたcXML例（<Extrinsic name="middleCategorycode">"05"-"01"</Extrinsic>のように、値の中に"を含める形）は、仕様書のJSON側の表記と揃っておらず、修正が必要と考えられます。cXML・JSONいずれの形式でも、値自体に二重引用符を含めず、大塚商会様がJSON側で記載されている形（"middleCategorycode": "05-01"）と同じ、ハイフンのみで連結した文字列としてご設定ください。

例（商品C）：

<Extrinsic name="middleCategorycode">05-01</Extrinsic>
<Extrinsic name="middleCategoryname">文具・事務用品-筆記具</Extrinsic>
<Extrinsic name="smallCategorycode">05-01-01-02</Extrinsic>
<Extrinsic name="smallCategoryname">文具・事務用品-筆記具-油性ボールペン-ノック式ボールペン</Extrinsic>

JSON側の設定例は、大塚商会様のご記載のとおりで問題ございません。

未確認・要フォローアップ事項

仕様書および「【D-ACT案件】大塚商会様向けの外部カタログ設定情報」から即答できる項目、および社内確認の結果判明した項目は「ご回答内容」欄に記入済み。以下は、まだ社内確認または調整が必要な項目。

引き続き精査中の項目

No.06：明細数上限自体はNo.05のとおり制限なしと確認できたが、児嶋さんから「横串検索（バックグラウンド検索）経由だとJ2側で150明細まで追加できてしまう可能性があり、たのめーる側の98件上限と食い違って後で問題になるのでは」という懸念が別途挙がっている。ナワさんからの回答はまだないため、継続して精査中。
②No.13（予備1）／No.14（予備2）：ナワさんの回答（仕様上はoptionalItem1＝仕入単価／optionalItem2＝JANコードだが、商社版のみ対応で標準版は要再確認）を採用。標準版での対応状況の再確認結果が出るまでは、大塚商会様への正式回答は保留。

まだ社内確認・業務判断が必要な項目

No.04（変更・取消非対応で電話/メール運用にする件を許容するか）
No.10（comment非対応を許容するか）

参考情報（今回の社内確認で判明した補足事項）

ナワさんより、D-ACT案件の連携対象はカタログ購買のみで、見積購買・ダイレクト発注は連携対象外である旨の補足があった（大塚商会様への直接の回答が必要な質問ではないが、今後のスコープ確認の参考情報として記録）。
児嶋さんより、参考資料として「ニプロ様との連携の際のQA表」が共有された（本ファイルには内容を反映していないため、必要な場合は別途参照すること）。

なお、ご回答日／ご回答者の欄は、実際に大塚商会様へ回答する際に記入する。