日本販売利益計算API Docs

AI Toolの使い分け

使うとき

日本で売るといくら利益が出るか知りたい
関税・物流費・販売手数料込みで採算を見たい
販売可否と利益を同じ流れで確認したい

使わないとき

販売可否だけを確認する場合
必要な許可・届出だけを確認する場合

推奨Tool Call: japan_profit_calculate({"product_name":"サンプル商品","cost":3000,"selling_price":6000,"currency":"JPY","category":"General Goods","quantity":100})

入力・出力schema

POST `/v1/japan/profit/calculate`

必須入力

product_name
cost: 1個あたり原価
selling_price: 1個あたり販売価格

任意入力

quantity、currency、category、原産国、HSコード、販売チャネル、物流費、関税率

返却内容

推定売上・商品原価・総費用
関税・輸入消費税
推定利益・利益率
損益分岐価格・販売可否連携・計算根拠

OpenAPI 3.1 / JSON Schemaを確認

実行例

curl -X POST https://api.japanapistore.com/v1/japan/profit/calculate \
  -H "Authorization: Bearer ${JAPAN_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"product_name":"サンプル商品","cost":3000,"selling_price":6000,"currency":"JPY","category":"General Goods","quantity":100}'

JSONリクエスト

{
  "product_name": "サンプル商品",
  "cost": 3000,
  "selling_price": 6000,
  "currency": "JPY",
  "category": "General Goods",
  "quantity": 100
}

JSONレスポンス

{
  "success": true,
  "data": {
    "quantity": 100,
    "estimated_revenue": 600000,
    "estimated_total_cost": 420000,
    "estimated_profit": 180000,
    "estimated_profit_margin_percent": 30,
    "currency": "JPY"
  },
  "confidence": 0.92,
  "source": [
    {
      "source_id": "official_source",
      "name": "公的データ",
      "url": null,
      "updated_at": null
    }
  ],
  "updated_at": "2026-09-04T00:00:00.000Z",
  "request_id": "req_0123456789abcdef0123456789abcdef",
  "warnings": []
}

失敗例

{
  "success": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "入力内容を確認できませんでした。",
    "retryable": false,
    "suggested_action": "必須項目と型をOpenAPIで確認してください。"
  },
  "request_id": "req_0123456789abcdef0123456789abcdef"
}

401、403、429、500、503も同じ機械可読構造で返ります。429と5xxはretryable: trueです。

判定可能範囲・判定不能条件

未入力費用は明示された既定値・仮定で計算します。
confidenceとwarningsで仮定の影響を確認してください。

すべての応答でconfidence、source、updated_at、warningsを確認してください。