此页面由 Cloud Translation API 翻译。

管理组织资料

您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。信息

以下部分介绍了组织付款资料，并说明了如何使用界面和 API 进行管理。

组织付款资料简介

在初始创收设置过程中，Apigee Edge 配置团队会设置您的组织付款资料。

您需要修改组织付款资料，以根据需要添加或更新贵组织的相关信息。例如，您可能需要更新结算类型、币种设置或税费模型。

配置贵组织的基本信息，包括：

组织名称、地址和运营国家/地区
结算类型（预付费、后付费或两者兼有），如了解结算类型中所述
结算周期（按比例分配或日历月）
基本币种
贵组织使用的税务模型

您可以使用界面和 API 管理组织付款资料，如以下几个部分所述。

探索“组织付款资料”页面

访问“组织付款资料”页面，如下所述。

Edge

如需使用 Edge 界面访问“组织付款资料”页面，请执行以下操作：

登录 apigee.com/edge。
在左侧导航栏中依次选择发布 > 创收 > 组织付款资料。

系统会显示“组织付款资料”页面。

如图所示，您可以通过“组织付款资料”页面执行以下操作：

查看当前的组织付款资料设置
修改组织付款资料设置，包括：
- 姓名和信息
- 税费和币种
- 条款及条件（如管理条款及条件中所述）

传统边缘（私有云）

如需使用 Classic Edge 界面访问“组织付款资料”页面，请执行以下操作：

登录 http://ms-ip:9000，其中 ms-ip 是管理服务器节点的 IP 地址或 DNS 名称。
在顶部导航栏中依次选择管理 > 组织付款资料。

系统会显示“组织付款资料”页面。

在“组织付款资料”页面中，您可以：

查看当前的组织付款资料设置
修改组织付款资料设置，包括：
- 姓名和信息
- 税费和币种
- 条款及条件（如管理条款及条件中所述）

使用界面修改组织付款资料

如需使用界面修改组织付款资料，请执行以下操作：

访问“组织付款资料”页面。
点击修改。
在名称和信息下，修改组织名称和运营国家/地区。

在税费和币种下，修改以下字段：

字段	说明
税费模型	注意：仅当您设置了收益分成费率方案且想要生成结算凭证时，此字段才适用。收益分成费率方案的税务模型，用于确定所需的结算凭证类型。有效值包括：披露：API 提供方充当开发者的披露代理。从最终用户处收取的总收入（包括销售税）会传递给开发者。API 提供方的佣金以佣金账单的形式向开发者收取。API 提供方不会处理从最终用户收取的销售税，报告销售税是开发者的责任。未披露：API 提供方充当开发者的未披露代理，会扣除从最终用户处收取的税费并将其支付给当地税务部门。开发者向 API 提供方开具账单，收取应归开发者的净收入分成（扣除销售税和 API 提供方的佣金）。混合：API 提供方充当开发者的披露代理。但是，API 提供方可代表开发者向当地税务部门缴纳从其订阅者中收取的销售税。API 提供方将剩余收入转给开发者，然后开具佣金账单。
币种	贵组织支持的货币。对于收益分成、价目表和仅收费方案，系统会使用默认币种作为您的费率方案的币种。在创建费率卡或仅收费方案时，您可以从支持的货币列表中选择要使用的货币。您可以选择为每种币种设置应用开发者可向其预付费账号余额充值的最低金额。如需添加币种，请执行以下操作：点击添加货币。从 Currency（币种）字段的下拉菜单中选择币种。（可选）在最低充值金额字段中，设置应用开发者可向其预付费账号余额添加的最低金额（以指定币种为单位）。点击添加。如有需要，点击相应的单选按钮将其设为默认币种。重复上述步骤以添加其他币种。如需删除币种，请将光标悬停在要删除的币种上，然后点击。警告：您无法删除正在被应用开发者或费率方案使用的币种。

字段

说明

税费模型

注意：仅当您设置了收益分成费率方案且想要生成结算凭证时，此字段才适用。

收益分成费率方案的税务模型，用于确定所需的结算凭证类型。

有效值包括：

披露：API 提供方充当开发者的披露代理。从最终用户处收取的总收入（包括销售税）会传递给开发者。API 提供方的佣金以佣金账单的形式向开发者收取。API 提供方不会处理从最终用户收取的销售税，报告销售税是开发者的责任。
未披露：API 提供方充当开发者的未披露代理，会扣除从最终用户处收取的税费并将其支付给当地税务部门。开发者向 API 提供方开具账单，收取应归开发者的净收入分成（扣除销售税和 API 提供方的佣金）。
混合：API 提供方充当开发者的披露代理。但是，API 提供方可代表开发者向当地税务部门缴纳从其订阅者中收取的销售税。API 提供方将剩余收入转给开发者，然后开具佣金账单。

币种

贵组织支持的货币。对于收益分成、价目表和仅收费方案，系统会使用默认币种作为您的费率方案的币种。在创建费率卡或仅收费方案时，您可以从支持的货币列表中选择要使用的货币。您可以选择为每种币种设置应用开发者可向其预付费账号余额充值的最低金额。

如需添加币种，请执行以下操作：

点击添加货币。
从 Currency（币种）字段的下拉菜单中选择币种。
（可选）在最低充值金额字段中，设置应用开发者可向其预付费账号余额添加的最低金额（以指定币种为单位）。
点击添加。
如有需要，点击相应的单选按钮将其设为默认币种。
重复上述步骤以添加其他币种。

如需删除币种，请将光标悬停在要删除的币种上，然后点击。

管理条款及条件，如使用界面管理条款及条件中所述。
点击保存。

使用 API 管理组织付款资料

使用 API 管理组织付款资料，如以下部分所述。

使用 API 查看组织付款资料

通过向 /mint/organizations/{org_name} 发出 GET 请求来查看您的组织付款资料。例如：

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}" \
  -H "Accept: application/json" \
  -u email:password

以下提供了一个响应示例。如需详细了解显示的选项，请参阅 API 的组织付款资料配置属性。

{
    "address" : [ {
      "address1" : "Test address”,
      "city" : "Test City",
      "country" : "US",
      "id" : "test-address",
      "isPrimary" : true,
      "state" : "CA",
      "zip" : "54321"
    } ],
    "approveTrusted" : false,
    "approveUntrusted" : false,
    "billingCycle" : "CALENDAR_MONTH",
    "country" : "US",
    "currency" : "USD",
    "description" : "Test organization",
    "hasBillingAdjustment" : true,
    "hasBroker" : false,
    "hasSelfBilling" : false,
    "hasSeparateInvoiceForProduct" : false,
    "id" : "{org_name}"
    "issueNettingStmt" : false,
    "logoUrl" : " https://dl.dropboxusercontent.com/u/48279818/LOGOS/testorg.jpeg",
    "name" : "myorg",
    "nettingStmtPerCurrency" : false,
    "regNo" : "RegNo-1234-myorg",
    "selfBillingAsExchOrg" : false,
    "selfBillingForAllDev" : false,
    "separateInvoiceForFees" : true,
    "status" : "ACTIVE",
    "supportedBillingType" : "PREPAID",
    "taxModel" : "UNDISCLOSED",
    "taxRegNo" : "TaxRegNo-1234-myorg",
    "timezone" : "UTC"
}

使用 API 修改组织付款资料

通过向 /mint/organizations/{org_name} 发出 PUT 请求来修改组织付款资料。修改组织付款资料时，您需要指定所有组织付款资料属性，而不仅仅是您要修改的属性。

如需修改组织的默认币种，请将 currency 值设置为您要设置为默认币种的受支持币种的 ISO 4217 货币代码。

例如，以下 API 调用会将 currency 更新为 USD，并将税费模型设置更新为 HYBRID（更新后的字段在示例中已突出显示）。如需详细了解显示的选项，请参阅 API 的组织付款资料配置属性。

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}" \
  -H "Content-Type: application/json" \
  -d '{
  "address" : [ { 
    "address1" : "Test address”,
    "city" : "Test City",
    "country" : "US",
    "id" : "corp-address",
    "isPrimary" : true,
    "state" : "CA",
    "zip" : "54321"
  } ], 
  "approveTrusted" : false, 
  "approveUntrusted" : false, 
  "billingCycle" : "CALENDAR_MONTH", 
  "country" : "US", 
  "currency" : "USD", 
  "description" : "Test organization", 
  "hasBillingAdjustment" : true, 
  "hasBroker" : false, 
  "hasSelfBilling" : false, 
  "hasSeparateInvoiceForProduct" : false,
  "id" : "myorg", 
  "issueNettingStmt" : false, 
  "logoUrl" : "https://dl.dropboxusercontent.com/u/48279818/LOGOS/testorg.jpeg",
  "name" : "{org_name}", 
  "nettingStmtPerCurrency" : false, 
  "regNo" : "RegNo-1234-myorg", 
  "selfBillingAsExchOrg" : false, 
  "selfBillingForAllDev" : false, 
  "separateInvoiceForFees" : false, 
  "status" : "ACTIVE", 
  "supportedBillingType" : "POSTPAID",
  "taxModel" : "HYBRID", 
  "taxRegNo" : "TaxRegNo-1234-myorg", 
  "timezone" : "UTC" 
}' \

-u email:password

使用 API 配置预付费和后付费结算类型

开发者账号可以配置为使用以下结算类型：预付费、后付费或两者兼有。

采用预付费账号时，开发者需要提前支付 API 使用费。系统会从开发者通过集成付款服务提供商维护的预付款余额中扣除相应资金。开发者必须保持足够的预付款余额才能购买 API。

对于后付费账号，系统会在月底按月（通过账单）向开发者收费。开发者根据账单中包括的方案设置的付款条件支付 API 产品使用费。

如需为贵组织配置预付费和后付费结算类型，请将 supportedBillingType 属性设置为以下值之一，以指明哪些结算类型有效：PREPAID、POSTPAID 或 BOTH。如果您将此值设置为 BOTH，则在您添加应用开发者或公司时，默认值将为 PREPAID。在这种情况下，您可以使用 API 为公司或应用开发者明确设置结算类型，如管理公司和应用开发者中所述。

例如：

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}" \
  -H "Content-Type: application/json" \
  -d '{
  "address" : [ {
    "address1" : "Test address",
    "city" : "Test City",
    "country" : "US",
    "id" : "corp-address",
    "isPrimary" : true,
    "state" : "CA",
    "zip" : "54321"
  } ],
  "approveTrusted" : false,
  "approveUntrusted" : false,
  "billingCycle" : "CALENDAR_MONTH",
  "country" : "US",
  "currency" : "USD",
  "description" : "Test organization",
  "hasBillingAdjustment" : true,
  "hasBroker" : false,
  "hasSelfBilling" : false,
  "hasSeparateInvoiceForProduct" : false,
  "id" : "myorg",
  "issueNettingStmt" : false,
  "logoUrl" : "https://dl.dropboxusercontent.com/u/48279818/LOGOS/testorg.jpeg",
  "name" : "{org_name}",
  "nettingStmtPerCurrency" : false,
  "regNo" : "RegNo-1234-myorg",
  "selfBillingAsExchOrg" : false,
  "selfBillingForAllDev" : false,
  "separateInvoiceForFees" : false,
  "status" : "ACTIVE",
  "supportedBillingType" : "POSTPAID",
  "taxModel" : "HYBRID",
  "taxRegNo" : "TaxRegNo-1234-myorg",
  "timezone" : "UTC"
  }' \
  -u email:password

使用 API 配置结算周期

如需为贵组织配置结算周期，请将 billingCycle 属性设置为以下值之一：

PRORATED：结算金额取决于 API 产品在一个日历月内的使用天数。
CALENDAR_MONTH：结算方式为按月结算。

例如：

curl -X PUT "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}" \
  -H "Content-Type: application/json" \
  -d '{
    "address" : [ {
      "address1" : "Test address",
      "city" : "Test City",
      "country" : "US",
      "id" : "corp-address",
      "isPrimary" : true,
      "state" : "CA",
      "zip" : "54321"
    } ],
    "approveTrusted" : false,
    "approveUntrusted" : false,
    "billingCycle" : "CALENDAR_MONTH",
    "country" : "US",
    "currency" : "USD",
    "description" : "Test organization",
    "hasBillingAdjustment" : true,
    "hasBroker" : false,
    "hasSelfBilling" : false,
    "hasSeparateInvoiceForProduct" : false,
    "id" : "myorg",
    "issueNettingStmt" : false,
    "logoUrl" : "https://dl.dropboxusercontent.com/u/48279818/LOGOS/testorg.jpeg",
    "name" : "{org_name}",
    "nettingStmtPerCurrency" : false,
    "regNo" : "RegNo-1234-myorg",
    "selfBillingAsExchOrg" : false,
    "selfBillingForAllDev" : false,
    "separateInvoiceForFees" : false,
    "status" : "ACTIVE",
    "supportedBillingType" : "POSTPAID",
    "taxModel" : "HYBRID",
    "taxRegNo" : "TaxRegNo-1234-myorg",
    "timezone" : "UTC"
  }' \
  -u email:password

API 的组织付款资料配置属性

借助组织付款资料，您可以使用 API 设置以下配置属性。

名称	说明	默认值	是否必需？
`address`	组织的地址，其中可以包含街道地址、城市、州/省/直辖市/自治区、邮政编码、国家/地区，以及指明这是否为组织的主要地址。	不适用	否
`approveTrusted`	此标志不起作用。	不适用	否
`approveUntrusted`	此标志不起作用。	不适用	否
`billingCycle`	结算周期。可以是以下值之一：按比例：结算金额取决于 API 产品在日历月内的使用天数。 CALENDAR_MONTH：按月结算。请参阅使用 API 配置结算周期。	不适用	是
`country`	组织的运营国家/地区的 ISO 3166-2 代码，例如巴西的 BR。	不适用	是
`currency`	组织使用的“基准”或会计币种的 ISO 4217 代码（例如 USD 代表美元）。对于收益分成方案：系统会使用您指定的货币。对于费率卡（收费模式）方案：与收益分成方案相同。不过，您可以将币种设置更改为组织支持的任何币种。对于仅收费方案：您可以将币种设置更改为组织支持的任何币种。	不适用	是
`description`	对组织的简要说明。	不适用	否
`hasBillingAdjustment`	用于指定是否启用调整的标志。如果启用此功能，您可以调整 API 服务为您的 API 产品记录的流量详细信息。此值可以是以下任一值： true：已启用调整。 false：未启用调整。	不适用	否
`hasBroker`	用于指定收入是基于净收入还是毛收入的标志。值可以是以下任一值： true：收入以净收入为依据。 false：收入不是基于净收入。	不适用	否
`hasSelfBilling`	用于指示创收功能生成自助结算账单，而不是收益分成对账单的标志。自助结算账单是一种财务文档，其中详细说明了应用开发者应付的金额。它充当代表应用开发者向 API 提供方开具的账单。此值可以是以下任一项： true：生成自行结算账单，而不是收益分成对账单。 false：停用自行结算账单。	不适用	否
`hasSeparateInvoiceForProduct`	用于指定是否为每个 API 产品生成单独的账单的标志。此值可以是以下任一项： true：系统会为每个 API 产品生成单独的账单。 false：系统不会为每个 API 产品生成单独的账单。	不适用	否
`id`	组织的 ID。	不适用	否
`issueNettingStmt`	用于指定在创建结算凭证时是否生成对冲对账单。此值可以是以下任一项： true：在创建结算凭证时生成对冲对账单。 false：创建结算凭证时不会生成对冲对账单。	不适用	否
`logoUrl`	组织徽标的网址。	不适用	否
`name`	组织名称。	不适用	是
`netPaymentAdviceNote`	净付款通知单。	不适用	否
`nettingStmtPerCurrency`	用于指定是否为所使用的每种币种生成单独的对冲对账单的标志。此值可以是以下任一项： true：系统会为使用的每种货币生成单独的对冲对账单。 false：系统不会为所使用的每种币种生成单独的对冲对账单。	不适用	否
`regNo`	组织的注册号。您为此媒体资源输入的编号会显示在结算凭证底部。	不适用	否
`selfBillingAsExchOrg`	如果已启用自行结算账单，则表示是否已为广告交易平台组织启用。此值可以是以下任一项： true：为广告交易平台组织启用了自助结算账单。 false：不允许广告交易平台组织自行开具账单。	不适用	否
`selfBillingForAllDev`	如果已启用自助账单功能，则表示是否已为所有应用开发者启用该功能。默认情况下，系统仅为与 API 提供方签署了协议的应用开发者生成自助结算账单。此值可以是以下任一项： true：为所有应用开发者启用自助账单功能。否：并非所有应用开发者都可以启用自助账单功能。	false	否
`separateInvoiceForFees`	用于指定是否为费用单独发布账单的标志。此值可以是以下任一项： true：系统会为费用单独开具账单。 false：不单独针对费用开具账单。	false	是
`status`	组织的状态。有效值包括：有效：组织账号已注册用于创收，可供使用。无效：组织账号已注册用于创收，但无法使用。	不适用	否
`supportedBillingType`	用于结算的开发者付款模式。可以是以下值之一： PREPAID：开发者提前支付 API 产品使用费。使用 API 产品时将从开发者的余额中扣除相应资金。开发者必须保持足够的预付款余额才能购买 API 产品。后付费：按月结算（通过账单）API 产品使用费的开发者。开发者根据账单中包括的方案设置的付款条件支付 API 产品使用费。 BOTH：支持任一结算类型。默认值为“PREPAID”。请参阅使用 API 配置预付费和后付费结算类型。	PREPAID	是
`taxModel`	注意：仅当您设置了收益分成费率方案且想要生成结算凭证时，此字段才适用。收益分成费率方案的税务模型，用于确定所需的结算凭证类型。有效值包括：披露：API 提供方充当开发者的披露代理。从最终用户处收取的总收入（包括销售税）会传递给开发者。API 提供方的佣金以佣金账单的形式向开发者收取。API 提供方不会处理从最终用户收取的销售税，报告销售税是开发者的责任。未披露：API 提供方充当开发者的未披露代理，会扣除从最终用户处收取的税费并将其支付给当地税务部门。开发者向 API 提供方开具账单，收取应归开发者的净收入分成（扣除销售税和 API 提供方的佣金）。混合：API 提供方充当开发者的披露代理。但是，API 提供方可代表开发者向当地税务部门缴纳从其订阅者中收取的销售税。API 提供方将剩余收入转给开发者，然后开具佣金账单。	不适用	是
`taxNexus`	组织在税务方面注册的国家/地区。注意：如果税收关联是美国，您需要提供您出于税务目的注册的所有州的其他信息。您在首次购买创收功能时，会在配置调查问卷中提供此类信息。	不适用	否
`taxRegNo`	组织的税务登记号或增值税 (VAT) 登记号（如适用）。此属性为可选属性，因为税务登记号或增值税登记号并非适用于所有国家/地区。您为此参数输入的编号会显示在结算凭证底部。	不适用	否
`transactionRelayURL`	可将事务转发到的其他系统（例如数据仓库）的网址。	不适用	否
`timezone`	组织运营的时区标识符，例如 America/New_York 或 Europe/Paris。系统还支持时区缩写，例如 UTC、EST（东部标准时间）或 CET（中欧时间）。警告：更新组织付款资料中的时区设置时，请务必谨慎。更改时区设置可能会影响基于日期和时间的事件，例如费率方案的开始和结束时间以及通知的发送时间。警告：不支持东部标准时间 (EEST)。请改用 UTC。	不适用	是

替换公司或应用开发者的变现资料设置

使用界面或 API 替换公司或应用开发者的变现资料设置，如以下部分所述：