注文請書・発注書プラグイン

何のためのプラグインか

法人取引では、注文したことの証跡が紙で要ります。取引先の経理は発注書を、店は注文請書を 綴じます。EC-CUBE が出せるのは納品書だけです。

このプラグインは、受注した事実をそのまま2種類の PDF にします。

これは請求書ではありません

インボイスの登録番号は載せません。 載せると適格請求書に見え、本物の請求書と 二重になります。紙の隅にも「本書は請求書ではありません」と入れています。

適格請求書が要る場合は月締め請求管理を使ってください。

出せる帳票

内容は同じで、宛名と発行者が逆になります。

	宛名	発行者	書き出し
注文請書	注文した会員	店舗	下記のとおり承りました。
発注書	店舗	注文した会員	下記のとおり発注いたします。

2つの出し方

誰が	どこから
会員	マイページ → ご注文履歴 → 詳細。「再注文する」の下に並びます
店	管理画面 → 受注管理 → 受注詳細。「納品書を出力」の隣に並びます

別のタブで開くので、PDF を見て戻ってきたときに履歴を開き直さずに済みます。

会員登録していない受注（管理画面から登録した受注）は会員側の経路では出せないので、 管理画面が唯一の出口です。

出せない受注ではボタンを出しません

状態	理由
購入処理中	まだ注文が成立していません
キャンセル	取り消したものを「承りました」とは書けません
決済処理中	同上

押しても 404 になるボタンは出しません。

取引先アカウント管理を入れている店では

注文詳細で見られる範囲が、そのまま帳票の範囲になります。 会社全体の注文履歴を 見せるアドオン（担当者の権限など）で範囲を広げた会員は、 担当者の注文の帳票も出せます。他社の注文は開けないので、帳票も出ません。 取引先アカウント管理だけなら、取引先の管理者も自分の注文の帳票だけです。

単体で入れた店では、自分の注文だけです。

レイアウトを変える

PHP は要りません。テンプレートを1枚置くだけです。

app/template/<テーマ>/OrderDocument/document.twig

置いてあればそちらが使われ、無ければプラグインのものが使われます。有効化のときに テーマへコピーしません。 コピーする方式だと、プラグインを更新してもテーマに残った 古いテンプレートが使われ続けます。触っていない店は更新に追随します。

注文請書と発注書は同じ1枚を使います。分けたいときは key （acknowledgement / purchase_order）で分岐できます。

宛名と発行者の向きはプラグイン側で決めてから渡しています。 テンプレートを 書き換えても、店が自分宛に「承りました」と書いた紙が出ることはありません。

直したら bin/console cache:clear を実行してください。テンプレートの有無はキャッシュに 載ります。

描いているのはブラウザではありません

PDF は本体が持っている TCPDF で描いています。HTML と CSS の一部しか効きません。

効く	table / td / 罫線 / 背景色 / 文字サイズ・色 / align / img / 改ページ
効かない	flexbox / position / float / CSS の大半

段組みは表で作ります。 罫線は表ではなくセルに付けてください。表に border="1" を 付けてから消そうとしても効かず、空けたいセルに罫線が残ります。

知っておいてほしい仕様

項目	内容
テーブルも設定画面も作りません	受注した事実を書き写すだけで、状態を持ちません。無効化・アンインストールでも何も残りません
金額は受注のものをそのまま写します	計算し直しません。計算すると、本体が値引きや送料をどう積んだかとずれて、受注詳細と紙で数字が合わなくなります
発行者の情報は店舗の基本設定から読みます	名称・住所・電話番号
帳票の種類は増やせます	見積書・検収書・英語版など。レイアウトを変えたいだけなら、この口は要りません

動作要件

項目	内容
EC-CUBE	4.4 系
PHP	8.2 / 8.3
依存プラグイン	なし

PDF の生成には本体が持っている TCPDF を使います。追加でインストールするものはありません。