国内仕入価格改定・商品利益影響照合

仕入先から届いた価格改定表を商品台帳へ照合し、商品別の価格差・適用日・利益変化・要確認理由を JSON / CSV で返します。日本国内の EC・卸・小売の業務を自動化する開発者・代行者向けです。

US$0.20／有効照合を含む通知1文書。商品行数への課金はありません。

料金の数え方

• 最終結果に matched または matched_cost_only を1行以上含み、結果が保存された文書を1件とします。イベント名は document-processed。
• 全件が要確認、未照合、読取り失敗、または空の文書は文書料金0です。
• 一部の商品だけ照合できた通知も1文書です。付随する要確認行に追加料金はありません。
• 値上げがなく「変更なし」と確認できた文書、原価のみ計算できた文書も対象です。
• 起動料・Dataset行課金・プラットフォーム使用量の上乗せは設定しません。10文書なら文書料金は最大US$2です。
• 保存・課金済みの結果があれば、その後の別処理の失敗だけで料金が自動取消しになるわけではありません。新しい実行としてやり直すと、条件を満たす文書は再び課金対象です。
• 実行前に最大料金を設定してください。料金上限不足なら明示的に停止し、勝手に上限を上げません。課金状態は BILLING で確認できます。

対応範囲

入力	対応
JSON	明示した通知行と台帳行
CSV	UTF-8/BOM、または指定したCP932。列対応必須
XLSX	シート名・見出し行・列対応必須。数式は実行しない
テキストPDF	teji_2025_08、hermosa_2026 の固定2様式のみ

画像・スキャンOCR、汎用PDF、商品名だけの推測一致、未知の単位換算は対応しません。同じメーカーでも別レイアウトは保証しません。

入力上限は1ファイル5MB、PDF30ページ、10通知、台帳10,000行です。照合組み合わせ数にも上限があるため、上限エラー時は重複に注意して分割してください。任意URLや手元のパスを直接読み込む機能はありません。ファイルは content_base64 に入れます。

すぐ試す：架空の1通知

ApifyのInputをJSON表示にし、以下を入力してください。税抜・1個単位で旧原価100、新原価120、売価150、販売手数料10%、送料5。利益は30→10になります。このサンプルは有効照合を含み、文書料金US$0.20の対象です。実企業の取引条件ではありません。

{
  "schema_version": "0.1",
  "margin_threshold": "0.2",
  "documents": [
    {
      "document_id": "D1",
      "supplier_id": "S1",
      "format": "rows",
      "defaults": {
        "price_basis": "purchase",
        "tax_basis": "exclusive",
        "tax_rate": "0.1",
        "units_per_price": "1",
        "base_unit": "piece",
        "currency": "JPY"
      },
      "rows": [
        {
          "mpn": "A",
          "name": "same",
          "old_price": "100",
          "new_price": "120",
          "effective_date": "2027-01-01"
        }
      ]
    }
  ],
  "ledger_rows": [
    {
      "row_id": "R1",
      "supplier_id": "S1",
      "mpn": "A",
      "name": "same",
      "cost": "100",
      "cost_tax_basis": "exclusive",
      "cost_units": "1",
      "sale": "150",
      "sale_tax_basis": "exclusive",
      "sale_units": "1",
      "currency": "JPY",
      "base_unit": "piece",
      "fee_rate": "0.1",
      "fee_basis": "net_sale",
      "shipping_net_per_base": "5"
    }
  ]
}

自分のファイルを入力する

通知の format を csv または xlsx とし、rows の代わりに content_base64 と columns を指定します。台帳は ledger_rows と ledger_file のどちらか一方だけです。columns の左側は下記の契約フィールド名、右側は実際の見出し名です。JAN・品番・台帳行IDは文字列を使い、先頭0を保持してください。

import base64, json
from pathlib import Path

def encoded(path):
    return base64.b64encode(Path(path).read_bytes()).decode("ascii")

payload = {
  "schema_version": "0.1",
  "documents": [{
    "document_id": "supplier-2027-01",
    "supplier_id": "S1",
    "format": "csv",
    "encoding": "utf-8-sig",
    "content_base64": encoded("notice.csv"),
    "columns": {"mpn": "品番", "old_price": "旧価格", "new_price": "新価格", "effective_date": "適用日"},
    "defaults": {"price_basis": "purchase", "tax_basis": "exclusive", "tax_rate": "0.1", "units_per_price": "1", "base_unit": "piece", "currency": "JPY"}
  }],
  "ledger_file": {
    "format": "csv",
    "encoding": "utf-8-sig",
    "content_base64": encoded("ledger.csv"),
    "columns": {"row_id": "台帳ID", "supplier_id": "仕入先", "mpn": "品番", "cost": "原価", "sale": "売価"},
    "defaults": {"cost_tax_basis": "exclusive", "cost_units": "1", "sale_tax_basis": "exclusive", "sale_units": "1", "base_unit": "piece", "currency": "JPY"}
  }
}
Path("input.json").write_text(json.dumps(payload, ensure_ascii=False), encoding="utf-8")

この例の税区分・入数・価格種別は仮の条件です。自社の原本に合わせて変更してください。XLSXの場合は format: "xlsx"、sheet: "価格表"、header_row: 1 を指定し、base64にExcelを入れます。台帳側も同じ指定方法です。結合見出しや数式セルは、値を確定した別コピーにしてから利用してください。

PDFの場合は format: "pdf"、profile: "teji_2025_08" または "hermosa_2026"、content_base64、document_id、supplier_id を指定します。税・入数・適用日は確認済みの値だけを defaults へ入れます。メーカー原本は配布していません。

計算に必要な意味づけ

フィールド	意味
supplier_id	通知と台帳で同じ仕入先ID。同メーカーでも取引条件が異なれば分ける
price_basis	purchase＝仕入単価、list＝定価、retail＝販売価格
tax_basis / cost_tax_basis / sale_tax_basis	exclusive＝税抜、inclusive＝税込。税込なら対応するtax_rateも明示
units_per_price / cost_units / sale_units	価格が何基準単位分か。10個箱価格なら10
base_unit	piece等。異なる意味の単位を自動換算しない
purchase_factor / factor_basis	定価・上代から原価換算する時の確認済み掛率と基準。例0.6とlist
fee_rate / fee_basis	税抜売上に対する料率。非ゼロならfee_basis＝net_sale
shipping_net_per_base / fixed_fee_net_per_base	税抜・基準単位あたりの費用。未指定0
effective_date	YYYY-MM-DD。根拠のない日付を補完しない

公開された定価は実際の仕入原価ではありません。利益は売価から原価と指定した費用を引いた商品単位の試算で、固定費・人件費等を含む会計上の純利益ではありません。未指定の送料・手数料を0と扱うので、実際の費用があれば入力してください。

出力と判断

OUTPUT は結果全体のJSONです。results に通知行、documents に文書の抽出結果、ledger_unmatched に台帳側未照合が入ります。Datasetは通知側の結果行です。全体を機械連携する場合はDatasetだけでなくOUTPUTを使ってください。

CSVは ALL_RESULTS_CSV、REVIEWS_CSV、NOTICE_UNMATCHED_CSV、LEDGER_UNMATCHED_CSV の4種類です。課金状態は別レコード BILLING です。

• matched：条件を満たす照合と利益試算。
• matched_cost_only：原価まで計算。売価がないなどの理由で利益は未算出。
• review：人の確認が必要。reasons を確認。
• unmatched：通知に対応する台帳が確認できない。
• run_state: partial：処理が動いても、確認事項や失敗文書が残る。成功ステータスをそのまま無人の台帳変更許可にしない。

flags の loss_after_change、margin_below_threshold は売価を検討する目印です。row_id で台帳へ戻せます。台帳側未照合を「改定なし」と解釈しないでください。CSVは式注入対策により文字列先頭へアポストロフィが付く場合があります。機械連携にはJSONを推奨します。

よくある要確認・失敗

• purchase_terms_required：上代と原価を区別し、確認済み掛率を入力。
• tax_basis_unknown / unit_mismatch_or_missing：税・入数・単位を明示。
• old_cost_mismatch：既に改定済みか、仕入先や入数が違わないか確認。
• identifier_conflict / ambiguous_ledger_match：JANと品番の矛盾や台帳の重複を解消。名称で決めない。
• missing_or_duplicate_header：列名が完全一致するか、同名列がないか確認。
• identifier_must_be_string：識別子を文字列として保存。失われた先頭0は復元しない。
• pdf_table_layout_changed：対応外のPDF様式。明示列指定のCSVへ変換して利用。
• comparison_limit_exceeded_split_batch：同一商品・日付の重複に注意して分割。

API・n8n

ApifyのAPIタブで同期OUTPUTエンドポイントを取得してください。HTTP POSTで入力JSONを送り、認証はHeader Authの Authorization: Bearer <自分のAPIキー> を使います。キーをURL・ワークフロー本文・問い合わせへ貼らないでください。

同期APIの指定例は outputRecordKey=OUTPUT&timeout=120&memory=1024&maxTotalChargeUsd=0.2 です。これは課金対象1通知の例です。複数通知では料金を確認して上限を自分で指定してください。

n8nのHTTP Requestノードで実行後、run_state、documents、results、ledger_unmatched を分岐します。HTTP成功だけで全商品処理成功としないでください。自動再試行は推奨しません。通信切断時は先の実行が続いている可能性があるため、ApifyのRunsを確認してから再実行してください。新しい実行は別の課金単位です。

データ・サポート・制限

入力と結果はApifyに保存されます。ゼロ保持ではなく、保持期間はアカウント設定等に従います。保存ID・取得リンクを第三者へ共有しないでください。n8nにも入力・結果が保存され得ます。機密資料を使う前に、利用権限と両サービスの保持・アクセス条件を確認してください。

外部LLM/OCRへの送信、任意URL取得、販売管理・台帳・ECの自動更新はありません。利用者自身が結果を確認して次工程へ渡します。

問い合わせはStoreのIssuesから、入力形式・エラー理由・バージョン・匿名化した最小例を送ってください。秘密情報や台帳全体は送らないでください。新しいPDF様式への無期限対応や応答時間保証はありません。

検証は公開PDF2様式と架空台帳、CSV/XLSX、実n8n接続で実施しています。任意PDFや実顧客の全データに対する精度、実際の時間短縮、継続利用は保証しません。入力契約は0.1です。新しい版へ切り替える場合は、利用者の代表入力で事前確認してください。

English summary

Match Japanese supplier price revisions to a ledger using supplier-scoped exact JAN/product codes. Export effective dates, changes, review reasons and conditional purchase-cost/profit impact. Supports explicitly mapped CSV/XLSX, normalized JSON and only two named text-PDF profiles; no general OCR or fuzzy auto-matching.

Price: US$0.20 per saved notice document containing at least one matched or matched_cost_only row. All-review, unmatched-only, empty and extraction-failed documents have no document fee. No startup, per-row or usage surcharge. Unchanged-price valid matches are billable; mixed documents are billed once. A new successful run may be charged again. Set your run spending limit. Public list prices are not assumed to be actual purchase costs; explicit terms, tax and units are required.

Outputs are persisted on Apify, not zero-retention. No automated master updates. Treat storage IDs and result links as sensitive. Use the self-contained JSON sample above for your first run and inspect partial/error statuses before downstream use.