http://w.atwiki.jp/zuora_ja/ zuora_ja @ ウィキ ja 2016-12-04T01:35:27+09:00 1480782927 https://w.atwiki.jp/zuora_ja/pages/2.html **メニュー -[[[翻訳] ZUORA API REFERENCE (V1.0.0)]] &link_editmenu(text=ここを編集) 2016-12-04T01:35:27+09:00 1480782927 https://w.atwiki.jp/zuora_ja/pages/12.html <p>Download OpenAPI (fka Swagger) specification:<a href="https://jp.zuora.com/wp-content/themes/zuora/css/swagger.yaml">here</a></p> <h1>はじめに</h1> <p>Zuora REST APIのリファレンスへようこそ！</p> <p>RESTは、HTTPとJSON技術の日常を使用して迅速な開発に向いているウェブ・サービス・プロトコルです。</p> <p>Zuora REST APIは、業務とリソースの広範なセットを提供します：</p> <ul><li>店頭統合は、あなたのウェブサイトからのWebを有効にします。</li> <li>サポート加入者のサインアップとセルフサービスのアカウント管理。</li> <li>収益モデルのカスタム収益のルールでのプロセスのスケジュール。</li> <li>Zuoraオブジェクトモデル内のほとんどのオブジェクトの操作を有効にします。</li> </ul><h2>エンドポイント</h2> <p>Zuora REST APIは、以下のエンドポイントを介して提供されます。</p> <p>テナントRESTエンドポイントのベースURL<br /> 生産https://rest.zuora.com/v1<br /> APIサンドボックスhttps://rest.apisandbox.zuora.com/v1</p> <p>生産エンドポイントユーザデータは、ライブへのアクセスを提供します。 APIのサンドボックスのテナントは、実世界のデータに影響を与えることなく、あなたのコードをテストするには良い場所です。それを使用するには、APIのサンドボックスのテナントをプロビジョニングする必要があります - 必要に応じてあなたのZuoraの担当者があなたを助けることができます。</p> <h2>APIへのアクセス</h2> <p>あなたはテナントZuoraをお持ちの場合は、すでにAPIへのアクセス権を持っています。</p> <p> あなたはテナントZuoraを持っていない場合は、https://www.zuora.com/resource/zuora-test-driveに移動し、生産テストドライブのテナントにサインアップします。テナントは、このような試料の製品カタログなどのシード・データ、付属しています。</p> <p>私たちはあなたのAPIがAPIのユーザにコールを発信するために特別に作成することをお勧めします。このアカウントでZuora UIにログインしないでください。定期的にセキュリティ機能を有効にUIにログインすると、最終的にはAPIで失敗認証が発生する可能性があり、アカウントのパスワードを、有効期限が切れます。それはそれらの命令に記載されているように権限を持っていない限り、ユーザーの役割がZuora REST APIの書き込みアクセスサービスへの書き込みアクセス権を持っていないことに注意してください。</p> <h1>認証</h1> <p>認証する3つの方法があります。</p> <p>ユーザー名とパスワードを使用してください。認証ヘッダー内の各リクエストに含めます：</p> <ul><li>apiAccessKeyId</li> <li>apiSecretAccessKey</li> <li> 実体またはエンティティ名（のみZuoraマルチエンティティのために。詳細については、「エンティティIDとエンティティ名」を下記を参照してください。）</li> </ul><p>認可クッキーを使用してください。クッキーは、[管理]&gt; [セキュリティポリシー]&gt; [セッションタイムアウトで指定された期間のためのREST APIへの呼び出しを行うようにユーザーに許可します。クッキーの有効期限は、REST APIにこの期間を持つすべての呼び出し後にリセットされます。クッキーを取得するには、次の情報をREST API接続リソースのユーザーを呼び出します。</p> <ul><li>ID</li> <li>パスワード</li> <li> IDのエンティティまたはエンティティ名（のみZuoraマルチエンティティのため。詳細については、以下の「エンティティIDとエンティティ名」を参照してください。）</li> <li> CORS対応のAPIの場合のみ：各要求を持つユーザーを認証し、再要求ヘッダに「単一使用」トークンを含めます。詳細については、下記を参照してください。</li> </ul><h2>idとエンティティのエンティティ名</h2> <p>パラメータは実体識別子とエンティティ名Zuoraマルチエンティティのために使用されています。</p> <p> 実体識別子とエンティティ名のパラメータは、IDとあなたがそれぞれ、アクセスしたいエンティティの名前を指定します。あなたは、エンティティへのアクセス権限を持たなければならないことに注意してください。あなたは、RESTのGET呼び出しを介してエンティティIDのエンティティとエンティティ名を取得することができます。</p> <p>あなたがアクセスしたエンティティに表示するエンティティ名実体または認証のパラメータを指定することができます。</p> <ul><li>実体識別子とエンティティ名の両方が認証に指定されている場合は、エラーが発生します。</li> <li>エンティティ名が認証に指定されているどちらの実体は、あなたのユーザーアカウントが作成されたエンティティにログインします場合。</li> </ul><p>詳細については、APIユーザー認証を参照してください。</p> <h2>対応CORSのためのトークン認証APIの</h2> <p>CORS機構はZuora REST APIに可能Zuoraに直接送信された全てのクレジットカード情報とセキュリティ情報と、顧客のブラウザから直接作られて呼び出します。これは、あなたのPCIコンプライアンスの負担を最小限に抑え、あなたの支払フォーム上に実装高度な検証を可能にし、お支払いフォームがちょうどあなたのウェブサイトの他の部分のように見えます。</p> <p>セキュリティ上の理由から、代わりにCORSのためのAPI要求を経由して、クッキーを使用するのは、認証トークンを使用します。</p> <p> 認証トークンの方法は、あなたの顧客のブラウザから発信する必要があり要求で使用するために設計されています。それは、既存のクッキー認証機構への交換と考えるべきではありません。</p> <p>Zuora REST CORS CORSがどのように動作するかの詳細については、を参照してください、あなたはZuora REST APIに実装され、顧客のコールを開始することができますか。認証トークンを返すHMAC方式でのHMAC署名の詳細を参照してください。</p> <h1>要求と応答</h1> <h2>要求ID</h2> <p> アカウントまたはサブスクリプション（accountKey、アカウントキー、subscriptionKey、サブスクリプション・キー）のための「キー」を入力するように要求一般的なルールとして、あなたは、現在のいずれかまたはエンティティのID番号を提供することができます。</p> <h2>HTTPリクエストボディ</h2> <p>あなたのリクエストに付随するパラメータやデータの大部分は、HTTPリクエストのボディに含まれることになります。</p> <p>Zuora REST APIは、HTTP要求本体にJSONを受け入れます。その他のデータ形式（例えば、XML）がサポートされていません。</p> <h2>リクエストのテスト</h2> <p>Zuora REST APIをテストするために、このようなカール、ポストマン、またはAdvanced RESTクライアントとして、サードパーティのクライアントを使用してください。</p> <p>あなたはZuoraテナントからZuora REST APIのAPIのサンドボックスまたは生産をテストすることができます。生産に接続する場合は、あなたが生きて製造年月日、サンプルまたはテストデータのない日付で作業していることに注意してください。</p> <h2>クレジットカードを使用したテスト</h2> <p> 遅かれ早かれ、おそらくクレジットカードを必要とする一部のトランザクションをテストする必要があります。これを処理する際の方法については、ペイメントゲートウェイでライブ行く参照してください。</p> <h2>エラー処理</h2> <p>レスポンスおよびエラー・コードは、応答とエラーに詳述されています。</p> <h1>PAGINATION</h1> <p> （GETメソッドを使用して）情報を取得する場合、任意のページサイズのクエリパラメータは、行の最大数が応答で返すように設定します。最大値は40です。この値が空または無効である場合は、より大きな値を40として処理され、10に一般的にデフォルト値をPAGESIZE。</p> <p>最大行数のデフォルト値は、メソッドレベルで取得上書きすることができます。</p> <p> 複数の行が使用可能な場合、応答は次のページを要求するためのURLが含まれているボニー要素が含まれます。この値が提供されていない場合、それ以上の行が用意されています。いいえ、「前のページ」の要素が明示的に提供されていません。後方支援するためのページングは​​、前回のコールを使用しています。</p> <h2>配列のサイズ</h2> <p>日付をページ分割されていない項目については、REST APIは、最大300行の配列をサポートしています。したがって、例えば、顧客口座数千人を取得繰り返さページ付けすることができますが、300以下の料金プランの配列内の任意のアカウントが返されます。</p> <h2>APIバージョン</h2> <p>Zuora REST APIは、バージョンを制御しています。 Zuora REST APIのバージョンは、変更は下位互換性があることを保証します。メジャーとマイナーバージョンの変更の命名を管理するためにZuoraを使用します。 RESTリクエストでバージョンを指定することで、あなたは関係なく、APIの将来の変更の自然な応答を得ることができます。</p> <h2>メジャーバージョン</h2> <p>REST APIのメジャーバ<span style="font-size:13px;">ージョン番号は、REST URLに表示されます。現在、Zuoraメジャーバージョンのみv1のをサポートしています。たとえば、POSTがhttps://rest.zuora.com/v1/subscriptions。</span></p> <h2>マイナーバージョン</h2> <p>小さな変化を制御するためのREST APIのZuoraマイナーバージョンを使用しています。例えば、REST方式のフィールドは廃止され、新しいフィールドがそれを置き換えるために使用されます。</p> <p> RESTの方法のいくつかのフィールドは、マイナーバージョンでサポートされています。フィールドがマイナーバージョンで注目されていない場合、このフィールドは、マイナーすべてのバージョンで利用可能です。フィールドがマイナーバージョンで注目されている場合、このバージョンは、制御フィールドです。あなたはエラーなしプロセ​​スにリクエストヘッダにサポートされているマイナーバージョンを指定する必要があります。</p> <p> フィールドは、バージョン管理にある場合は、最大値またはマイナーバージョン最小マイナーバージョンと、またはそれらの両方のいずれかです。あなただけの最小値と最大値のマイナーバージョン間のマイナーで、このフィールドのバージョンを使用することができます。たとえば、フィールドにinvoiceCollect購読POSTメソッドは、バージョン管理であり、その最大値は189.0マイナーバージョンです。あなただけのマイナーバージョン189.0またはそれ以前に、このフィールドを使用することができます。</p> <p>サポートされているマイナーバージョンはサポートされているフィールドとそのマイナーバージョンについてはZuora REST APIのマイナーバージョン履歴を参照して、シリアルではありません。フィールドまたは機能は、マイナーバージョン番号が必要な場合、当社のREST APIドキュメントでは、我々は、説明フィールドにあることに注意します。</p> <p> あなただけがフィールドは、マイナーバージョンが必要です使用する場合、バージョン番号を指定する必要があります。マイナーバージョンを指定するには、通話要求のためのマイナーバージョン番号にリクエストヘッダにzuoraバージョンのパラメータを設定します。例えば、196.0はマイナーバージョン収集分野です。 POSTメソッドは、このフィールドのサブスクリプションを使用する場合は、リクエストヘッダに196.0 zuoraバージョンにパラメータを設定します。 zuoraパラメータは大文字と小文字が区別されたバージョンです。</p> <p>マイナーバージョンは、リクエストヘッダに指定されていない場合、すべてのフィールドのREST APIの場合、デフォルトでは、Zuoraはあなたの統合を壊す回避するために、REST APIの最低限のマイナーバージョンを使用します。</p> <h1>ZUORAオブジェクトモデル</h1> <p>次の図は、キーオブジェクトZuoraの高レベルのビューを提供します。サイズを変更するには、新しいタブで開くには画像をクリックしてください。</p> <p><img alt="" src="https://www.zuora.com/wp-content/uploads/2016/11/ZuoraERD.jpeg" style="width:800px;height:579px;" /></p> <h1>行動</h1> <p> アクションは、自然の中でのバッチな操作です。たとえば、「更新」、「作成」「削除」、およびその他の操作は、一度に50個のオブジェクトへの変更を可能にします。その日が、その後の「queryMore」操作によって返される追加ページを必要とする前に、「クエリ」の操作は、一度に戻って2000年の結果までのレコードが返されます。</p> <h2>修正します</h2> <p>このようなサブスクリプションをアップグレードするように、変更するサブスクリプションのコールを改正使用します。</p> <p>コールを改正：</p> <ul><li>オブジェクトの改正をサポート</li> <li>非同期処理ではありません</li> </ul><h2>境界</h2> <h3>コールごとのオブジェクト</h3> <p>10オブジェクト改正まで。</p> <h3>システムレート制限</h3> <p>10分の時間ウィンドウごとのテナント1,000のコール。</p> <p>あなたが近づくか、この制限を超える場合は、429エラーが表示されます。マルチスレッドを使用すると、より迅速に、この限界に近づくようになります。</p> <h2>エラー</h2> <p>改正回のコールで、あなたの改正の目的の一つが失敗した場合、全体の呼び出しは失敗します。</p> <h2>必要なフィールド</h2> <p>次のフィールドは、常にこのコールのために必要とされています。</p> <ul><li>Amendment.Type</li> <li>Amendment.Name</li> <li>Amendment.SubscriptionId</li> </ul><h1>会計CODES</h1> <h2>会計コードを作成します。</h2> <p>REST APIを介して新しい会計コードを作成する方法lýsirこのリファレンス。会計コードはすぐにそれが作成されているようにアクティブになります。</p> <h2>前提条件</h2> <p> あなたがテナントにZ-ファイナンスを有効にしている場合は、許可Z-ファイナンス会計コードを作成している必要があります。Z-ファイナンスの役割を参照してください。</p> <h1>会計期間</h1> <h2>閉じる会計期間</h2> <p>会計期間会計期間のIDで閉じます。</p> <h2>前提条件</h2> <p> あなたのテナントにZuoraファイナンスを有効にする必要があります。あなたは、ユーザー権限の管理閉じるプロセスと実行残高試算表を持っている必要があります。役割ファイナンスを参照してください。制限</p> <ul><li>会計期間はすでにクローズすることはできません。</li> <li>会計期間は、試算表を実行するプロセスにすることはできません。</li> <li>すべては、以前の会計期間をクローズする必要があります。</li> <li> 会計期間に必要な何のアクション項目があってはなりません。会計期間の詳細については、トランザクションを閉じる前に、リコンサイルを参照してください。</li> </ul><h2>注釈</h2> <p> あなたが会計期間にZuoraを閉じると、自動的にその期間の試算表を実行しています。正常な応答のみ会計期間は終了いたしましたことを意味し、それは裁判のバランスが正常に完了しているとは限りません。</p> <h1>ソーリー</h1> <h2>アカウントを作成します</h2> <p>クレジットカードのお支払い方法、請求先に連絡し、販売-する連絡オプションで顧客アカウントを作成する方法lýsirこのREST APIリファレンス。リクエストとレスポンスフィールドの説明とサンプルコードが提供されています。そのサブスクリプションのサブスクリプション、請求書を作成し、オプション、およびデフォルト支払方法を通じて支払いを収集するために、このメソッドを使用します。トランザクションはアトミックです。何らかの理由でいずれかの部分が失敗した場合、トランザクション全体がロールバックされます。</p> <p> このAPIの呼び出しは、CORSが有効になっているので、あなたは、コールを呼び出すために、クライアント側のJavaScriptを使用することができます。詳細については、CORS Zuora RESTのページをご覧ください。</p> <h2>注釈</h2> <ol><li>アカウントがアクティブな状態で作成されます。</li> <li> 要求は、構造のいずれかのクレジットカードまたはhpmCreditCardPaymentMethodIdフィールド（両方ではない）を提供する必要があります。このアカウントのために提供されるものは、デフォルトの支払方法になります。クレジットカードが拒否されたかの情報が確認できない場合は、アカウントが作成されません。</li> <li>このコールが自動支払いに設定すると、顧客のアカウントが自動的に作成されます。</li> <li> workEmailまたはpersonalEmailのいずれかが指定されている場合、そのアカウントのメール配信設定は自動的にtrueに設定されています。どちらのフィールドが指定されている場合（それが存在する場合、workEmailメールアドレスに行き、その場合、あるいはpersonalEmail。）、電子メールの配信設定は自動的にfalseに設定されています。</li> </ol><h2>customerAcceptanceDateとserviceActivationDateのデフォルト値</h2> <p>デフォルト値はcustomerAcceptanceDateとserviceActivationDateために次のように設定されています。</p> <ul><li>serviceActivationDate（SA）が指定されていませんserviceActivationDate（SA）を指定しました</li> <li>customerAcceptanceDate（CA）SAは、通話要求で指定された値を使用します。使用するCA CAはコール要求でコール要求に値の値を使用し、SAは、デフォルトとしてCEを使用しています</li> <li> customerAcceptanceDate（CA）SAは、通話要求に指定されていない値を使用します。デフォルトSAとCAがデフォルトとしてCEを使用するようにCAは、SAを使用します</li> </ul><h1><span style="font-size:13px;">改正</span></h1> <h2>キーによって改正を取得</h2> <p>指定したサブスクリプションの改正に関する詳細な情報を取得します。</p> <h1>添付ファイル</h1> <h2>添付ファイルを追加</h2> <p> アカウント、サブスクリプション、または請求書にドキュメントを添付するマルチパート/フォームデータファイルに添付ファイルを追加REST要求を使用してください。</p> <h1>CATALOG</h1> <h2>製品カタログを入手</h2> <p>すべての製品、機能、およびそれらに対応する料金プラン、料金を含め、全体の製品カタログを取得する方法をlýsirこのREST APIリファレンス。製品は、フィールドUpdatedDate上の新しい順に返されます。</p> <p>REST APIは、製品、製品の料金プランと料金の作成や更新をサポートしていません。これらのタスクは、WebベースのUIで、またはSOAP APIを介して行うことができます。</p> <p>料金プランと料金レートの計画では、REST APIは、最大配列サイズを持っています。詳細については、配列サイズを参照してください。</p> <h1>充電収益の概要</h1> <h2>CRS要約電荷数によって詳細を取得</h2> <p>数要約料収入を指定することで、要約料収入の詳細を取得する方法lýsirこのREST APIリファレンス。応答は、電荷収入サマリー項目に関連付けられたすべての収益が含まれています。</p> <h1>通信プロファイル</h1> <h2>CRUD：CommunicationProfileを取得</h2> <h1>CONNECTIONS</h1> <h2>Zuora REST APIサービスへの接続を確立</h2> <p>有効なユーザーの資格情報に基づいてZuora REST APIサービスへの接続を確立します。</p> <p>これは、ユーザーを認証し、REST APIへの後続の呼び出しを許可するために使われているAPI呼び出しのセッションクッキーを返します。接続への呼び出しは、データにアクセスするためにZuora REST APIを使用する前に必要な最初のステップです。</p> <p>資格情報は、APIサービスにアクセスする権限を持つユーザーアカウントに属している必要があります。</p> <p>他の場所で述べたように、強く、APIの活動ZuoraはZuora UIへのログインに使用したアカウントに使用されることはありませんことをお勧めします。アカウントがUIにログインするために使用されると、それはAPIを使用した場合、最終的に認証の失敗につながる可能性が定期的に強制的にパスワードを変更した場合、対象となる場合があります。</p> <h1>お問い合わせ</h1> <p>CRUD：連絡先を作<span style="font-size:13px;">成</span></p> <h1>クレジットバランスの調整</h1> <p>CRUD：CreditBalanceAdjustmentを取得</p> <h1>CUSTOMの為替レート</h1> <h2>カスタム外国為替レートを取得します。</h2> <p> この機能は、限られた入手可能です。あなたは機能へのアクセス権を持っているしたい場合は、Zuoraグローバルサポートにリクエストを送信してください。</p> <p> 外国為替相場Zuoraからどのようにlýsirカスタムクエリへのこの参照。カスタムプロバイダを使用し、輸入外国為替レート質量作用と速度の為替レートをアップロードする場合にのみ、あなたは、為替レートを照会するために、このAPIメソッドを使用することができます。あなたは為替レートのプロバイダのデフォルトの為替レートを取得したい場合は、OANDAは、データソースの輸出のために外貨換算を参照してください。</p> <p>Zuoraで通貨換算の詳細については、外貨換算を参照してください。</p> <h1>輸出</h1> <p>CRUD：エクスポートを作成します。</p> <h1>特長</h1> <p>CRUD：フィーチャーを取得</p> <h1>ファイルを取得</h1> <h2>ファイルを取得</h2> <p> そのファイルIDを指定することでファイルを取得します。あなたは、期間会計などの収入の詳細を報告する報告書、ならびにこのようなPDFファイルの請求書などの他のファイルを取得することができます。</p> <h3>例</h3> <p>"：$のUSER_NAME apiAccessKeyId" -Hカール-H -iによる「apiSecretAccessKey：$ PASSWORD "<br /> -H「同意する：アプリケーション/ pdf "を<br /> -X GET https://apisandbox-api.zuora.com/rest/v1/files/2c92c08c55534cf00155581fb474314d<br /> -o /Users/jsmith/Downloads/invoiceFile1.pdf<br /> 請求書のPDFは/ユーザ/ JSMITH /ダウンロードと名付けinvoiceFile1.pdfにダウンロードされます。</p> <h3>ファイルサイズの制限</h3> <p>最大エクスポートファイルのサイズは2047メガバイトです。あなたはこの制限を越える大規模なデータ要求がある場合は、Zuora 403 HTTPレスポンスコードで次のようになります。</p> <p>&lt;セキュリティ：最大オブジェクトサイズ&gt; 2047メガバイト</p> <p>追加の支援が必要な場合はZuoraグローバルサポートにリクエストを送信します。</p> <p>私たちは、大きなファイルの最適化があなたのためのオプションがあるかどうかを判断するためにあなたと一緒に作業することができます。</p> <h1>HMAC署名</h1> <h2>戻りHMAC署名</h2> <p>有効CORS API呼び出しを処理するために使用される署名とトークン値を返す方法lýsirこのユニークなREST APIリファレンス。</p> <h1>ホステッドPAGES</h1> <h2>ホストされたページを返します</h2> <p>コールは、支払いページhostedpages具体的に構成メタデータ、ページID、ページのバージョン、お支払い方法の種類を返します。</p> <p>REST支払いページ用のバージョン固有および一般的な要求は次のとおりです。</p> <ul><li>支払いページ1.0コンフィギュレーション情報の要求： / hostedpages GETバージョン= 1？</li> <li>支払いページ2.0設定情報の要求： / hostedpages GETバージョン= 2？</li> <li>支払いページのすべてのバージョンの要求設定情報：GET / hostedpages</li> </ul><h2>注釈</h2> <p> あなたは、対応するテナントの設定は、例えば、リクエストパラメータが無効に設定する支払いページのバージョン2.0を2に設定し、有効にしていない場合は、エラーが表示されます。</p> <h1>輸入</h1> <p>CRUD：インポートを取得</p> <h1>請求書の調整</h1> <p>CRUD：InvoiceAdjustmentを作成します。</p> <h1>請求書の調整のITEM</h1> <p>CRUD：InvoiceItemAdjustmentを取得</p> <h1>請求書ITEMS</h1> <p>CRUD：InvoiceItemを取得</p> <h1>請求書の支払い</h1> <p>CRUD：InvoicePaymentを作成します。</p> <h1>請求書SPLITアイテム</h1> <p>CRUD：InvoiceSplitItemを取得</p> <h1>請求書スプリット</h1> <p>CRUD：InvoiceSplitを取得</p> <h1>請求書</h1> <p>CRUD：請求書を作成します。</p> <h1>JOURNALの実行</h1> <h2>ジャーナルランを作成します。</h2> <p>ジャーナルランを作成する方法lýsirこのREST APIリファレンス。リクエストとレスポンスフィールドの説明とサンプルコードが提供されています。</p> <h1>MASSアップデータ</h1> <h2>質量作用の実行</h2> <p>REST APIを介して質量アクションを実行する方法lýsirこのリファレンス。質量アクションを実行する方法の詳細は、マスアップデータを参照してください。</p> <p>このAPIメソッドを使用して、あなたが実行したい質量作用に関するデータを持つ.csvファイルを含むmultipart / form-dataリクエストを送信します。 Zuoraは、鍵を返し、その後、非同期質量作用を処理します。あなたは質量作用の結果の詳細を取得するためにキーを使用することができます。</p> <h1>通知履歴</h1> <h2>吹き出し通知履歴を取得</h2> <p>通知履歴を取得する方法のための吹き出しlýsirこのREST APIリファレンス。</p> <p>詳細については、通知とコールアウトを参照してくださいし、作成と編集通知。</p> <h1>OPERATIONS</h1> <h2>請求書および収集</h2> <p>請求書を生成し、指定したアカウントの支払いを収集します。</p> <p> この方法では、請求書に生成することができます請求書を生成し、支払いを収集し、あるいは単に指定された既存の請求書に支払いを収集します。顧客のデフォルトのお支払い方法が使用され、全額が原因で収集されます。操作は、指定したパラメータに依存します</p> <p>その顧客のために生成された1つ以上の新しい請求書を作成し、請求書（複数可）でのお支払いを収集するには、フィールド空invoiceIdを残します。<br /> 既存の請求書でのお支払いを収集するには、請求書のIDを指定します。<br /> 操作はアトミックです。いずれかの部分が失敗した場合、操作全体がロールバックされます。</p> <h2>注釈</h2> <p>サブスクリプションの非常に高い数を持つアカウントでこのメソッドを使用するときにタイムアウトが発生することがあります。</p> <h1>お支払い方法のスナップショット</h1> <p>CRUD：PaymentMethodSnapshotを取得</p> <h1>お支払方法トランザクションログ</h1> <p>CRUD：PaymentMethodTransactionLogを取得</p> <h1>支払い方法</h1> <h2>お支払い方法を作成します。</h2> <p>顧客アカウントの新しいクレジットカードの支払方法を作成する方法lýsirこのREST APIリファレンス。</p> <h2>注釈</h2> <p>このAPIの呼び出しは、CORSを有効になっています。コールを呼び出すために、クライアント側のJavaScriptを使用してください。 CORS Zuora RESTはより多くの情報を参照してください。</p> <h1>支払トランザクションログ</h1> <p>CRUD：PaymentTransactionLogを取得</p> <h1>支払い</h1> <p>CRUD：お支払いを作成します。</p> <h1>製品の特徴</h1> <p>CRUD：ProductFeatureを取得</p> <h1>製品料金プランは、充電を階層</h1> <p>CRUD：ProductRatePlanChargeTierを取得</p> <h1>製品料金プラン料金</h1> <p>CRUD：ProductRatePlanChargeを取得</p> <h1>製品料金プラン</h1> <p>CRUD：ProductRatePlanを作成します。</p> <h1>製品</h1> <p>CRUD：製品を作成します。</p> <h1>QUOTES文献</h1> <h2>文書の引用符を生成します</h2> <p> 文書の呼び出しは、引用文書を生成し、URLはドキュメントを生成し返します。あなたは直接返されたURLを介して生成された引用のファイルにアクセスすることができます。</p> <p>文書はZuoraの声から電話を使用する必要があります。</p> <h2>ファイルサイズの制限</h2> <p>最大エクスポートファイルのサイズは2047メガバイトです。セキュリティ：最大オブジェクトサイズ&gt; 2047メガバイト がこの上限を超える大規模なデータ要求がある場合は、Zuora 403 HTTPレスポンスコードで次のようになります</p> <p>追加の支援が必要な場合はZuoraグローバルサポートにリクエストを送信します。</p> <p>私たちは、大きなファイルの最適化があなたのためのオプションがあるかどうかを判断するためにあなたと一緒に作業することができます。</p> <h1>料金プランティアチャージ</h1> <p>CRUD：RatePlanChargeTierを取得</p> <h1>料金プランの料金</h1> <p>CRUD：RatePlanChargeを取得</p> <h1>料金プラン</h1> <p>CRUD：RatePlanを取得</p> <h1>請求書返金支払い</h1> <p>CRUD：RefundInvoicePaymentを取得</p> <h1>払い戻しトランザクションログ</h1> <p>CRUD：RefundTransactionLogを取得</p> <h1>返金</h1> <p>CRUD：払い戻しを作成します。</p> <h1>収益EVENTS</h1> <h2>収益のイベントの詳細を取得します。</h2> <p>イベントlýsirこのREST APIリファレンス番号を指定して、収益イベントによって収入を得る方法を詳しく説明します。リクエストとレスポンスフィールドの説明とサンプルコードが提供されています。</p> <h1>収益ITEMS</h1> <h2>数要約料収入によって収入項目を取得</h2> <p>数要約料収入を指定することで、収益の要約料収入の各項目の詳細を取得する方法lýsirこのREST APIリファレンス。リクエストとレスポンスフィールドの説明とサンプルコードが提供されています。</p> <h1>収益RULES</h1> <h2>料金に関連付けられているルールを取得します。</h2> <p>購読料のIDに関連付けられた電荷を指定することで、収益認識ルールを取得する方法lýsirこのREST APIリファレンス。リクエストとレスポンスフィールドの説明とサンプルコードが提供されています。</p> <h1>収益のスケジュール</h1> <h2>収益のスケジュール項目（日付範囲によって分布）のための請求書を作成します。</h2> <p>請求書の項目の収益スケジュールを作成し、開始日と終了日を指定することで、収益認識を配布する方法については、このlýsirREST APIリファレンス。</p> <h1>RSAの署名</h1> <h2>RSA署名を生成します</h2> <p>RESTのAPI 2.0は、支払いページCORS（クロスオリジンリソースの共有）を有効に使用されるため、デジタル署名を必要としています。 POST rsa_signatures呼び出しが生成され、デジタル署名のために必要なトークンを返し、支払いページ2.0を形成します。あなたは支払いページ2.0にアクセスするためのクライアントのためにそれを生成した署名を渡す必要があります。</p> <p><span style="font-size:13px;">あなたは2.0支払いページを実装する際RESTこのサービスにのみ使用してください。</span></p> <h1>SETTINGS</h1> <h2>収入の自動化の開始日を取得します。</h2> <p>収入の自動化の開始日を取得する方法lýsirこのREST APIリファレンス。リクエストとレスポンスフィールドの説明とサンプルコードが提供されています。</p> <h1>製品は、サブスクリプション特長</h1> <p>CRUD：SubscriptionProductFeatureを取得</p> <h1>SUBSCRIPTIONS</h1> <h2>プレビューサブスクリプション</h2> <p>プレビューモードで新しいサブスクリプションを作成する方法lýsirREST APIリファレンス。この呼び出しは、有効な顧客アカウントを必要としません。アカウントを作成する前に、潜在的な顧客に完全な詳細および電荷を有する新しいサブスクリプションのプレビューを表示するために、または既存の顧客に料金をすべてコミットする前にプレビューでサブスクリプションをさせるために使用することができます。</p> <h2>注釈</h2> <ul><li>デフォルト値はcustomerAcceptanceDateとserviceActivationDateために次のように設定されています。</li> <li>serviceActivationDate（SA）が指定されていません</li> <li>serviceActivationDate（SA）を指定しました</li> <li>customerAcceptanceDate（CA）SAは、通話要求で指定された値を使用します。</li> <li>使用するCA CAはコール要求でコール要求に値の値を使用し、SAは、デフォルトとしてCEを使用しています</li> <li>customerAcceptanceDate（CA）SAは、通話要求に指定されていない値を使用します。</li> <li>デフォルトSAとCAがデフォルトとしてCEを使用するようにCAは、SAを使用します</li> </ul><h1>要約仕訳</h1> <p>仕訳の概要を作成します。</p> <p>手動仕訳入力の要約を作成する方法lýsirこのREST APIリファレンス。リクエストとレスポンスフィールドの説明とサンプルコードが提供されています。</p> <h2>必要条件</h2> <ol><li>借方の1.の合計が要約仕訳にクレジットの合計に等しくなければなりません。</li> <li>以下のあなたが外国通貨換算を使用する場合にのみ適用されます。</li> </ol><ul><li> あなたは異なる通貨を持つジャーナルファイル名を指定して実行集計取引中に設定している場合は「はい」、通貨の価値は、あなたのテナントの自国通貨と同じフィールドである必要があります。つまり、あなたの家の通貨を使用して仕訳を作成する必要があります。</li> <li> 会計期間のすべての仕訳は、すべて集約され、またはすべての非凝集のいずれかでなければなりません。あなたは、同じ会計期間に集約し、非凝集仕訳のミックスを持つことはできません。</li> </ul><p>集計通貨の詳細については外貨換算の要約仕訳を参照してください。</p> <h1>課税ITEMS</h1> <p>CRUD：TaxationItemを作成します。</p> <h1>取引</h1> <p>請求書を取得します</p> <p>請求書のために指定されたアカウントを取得します。請求書はupdatedDateによって新しい順に返されます。</p> <h1>測定単位</h1> <p>CRUD：UnitOfMeasureを作成します。</p> <h1>USAGE</h1> <h2>ポストの使用状況</h2> <p>CSV形式の1つ以上のアカウントのデータ使用量を転記またはインポートする方法lýsirこのREST APIリファレンス。何のパスまたはクエリパラメータはありません。日付は、HTTP multipart / form-dataのPOSTメソッドを使用して、ユーザーのテナントに適用uploadeです。</p> <h2>これはどのようにREST APIコールワークス</h2> <p> アップロードファイルの内容は、UIのインポートツールで使用される形式に従わなければなりません。これは、対応する拡張子.csvファイルでカンマ区切り値（CSV）ファイルである必要があります。ファイルサイズが4メガバイトを超えてはなりません。テンプレートファイルの使用状況をダウンロードするには、ここをクリックしてください。</p> <p> アップロードが完了すると、実際にファイルの内容を処理する前に、theAPIは、受信したファイルのバイト数と、インポート・プロセスの状態を確認するためのURLを含む応答を返します。そのURLにある5つの可能な結果のキャンセル、完了、保留、処理を表示し、失敗した）のみ完了ステータスは、インポートが成功したことを示しています。操作はアトミックです。すべてのレコードが失敗した場合、ファイルは拒否されます。その場合に、全体のインポートはロールバックされ、すべての記憶されたデータは元の状態に戻されます。</p> <p> 現在のインポートのステータスを表示するには、そのようなステップは、インポートが失敗した可能性が理由の詳細を提供する追加POSTMAN.Thisなどのツールを使用してcheckImportStatus応答によって得られたステータスのURLを入力します。</p> <p>アップロードが正常に終了した後の情報を管理するには、WebベースのUIを使用しています。</p> <h2>アップロードファイル形式</h2> <ul><li>アップロードファイルには、次の見出しを使用します：</li> <li> このフィールドがあるとして彼らが提示されているACCOUNT_IDがACCOUNT_IDは、このような、口座番号やカスタムとして、例えば、口座番号、デフォルトのアカウント番号、A00000001を入力します。、それは現在のアカウントIDアカウント名が誰であるかではありません。</li> <li><span style="font-size:13px;">はい</span></li> <li>UOMは、測定単位を入力します。これは、測定の単位をカスタマイズする&gt; Z-課金設定]で設定されている使用のためのUOMと一致する必要があります。</li> <li>はい</li> <li>数量数量を入力します。</li> <li>はい</li> <li> STARTDATEは、使用の開始日を入力します。このアイテムの請求書の日付は、サービスの期間は関連する使用に請求され決定されます。日付の形式は、現在のユーザーのロケールに基づいています。デフォルトの日付書式：MM / DD / YYY</li> <li>はい</li> <li> ENDDATEは、使用の終了日を入力します。この使用法は、課金のための計算に使用され、オプションであるされていません。日付の形式は、現在のユーザーのロケールに基づいています。デフォルトの日付書式：MM / DD / YYYY</li> <li>はい</li> <li> サブスクリプション番号または名前SUBSCRIPTION_IDサブスクリプションを入力します。あなたはZuoraアプリケーションでサブスクリプションを作成した場合、数Zuoraは-S00000001と同様の形式で自動的に作成されました。このフィールドに値を提供しない場合は、指定されたため、関連用法は、メジャーのこのアカウント・ユニットを使用するすべてのサブスクリプションに追加されます。あなたのアカウントに複数のサブスクリプションを持つことができますし、使用状況の二重または三重カウントをしたくない場合は、各サブスクリプションの充電または使用記録にIDを指定する必要があります。</li> <li>はい</li> <li> CHARGE_IDは電荷数（ない充電名）を入力します。あなたは、例えば、C-00000001、あなたの料金プラン、あなたのサブスクリプションに追加して、個々の料金を表示すると、充電IDを見ることができます。追加情報については、製品およびレートプランの追加を参照してください。あなたのアカウントに複数のサブスクリプションを持つことができますし、使用状況の二重または三重カウントをしたくない場合は、各利用記録の特定のサブスクリプションの充電またはIDを指定する必要があります。これは、サブスクリプション料金プランにチャージ番号]フィールドに関連しています。</li> <li>はい</li> <li>説明担当の説明を入力します。</li> <li>いいえ</li> </ul><p> </p> <p>original<a href="https://www.zuora.com/developer/api-reference/"><span style="font-size:13px;">www.zuora.com</span></a><br /><span style="font-size:13px;">translate by</span><a class="r-igYtI6H_6KSo" href="https://cloud.google.com/translate/?hl=ja&amp;utm_source=google&amp;utm_medium=cpc&amp;utm_campaign=2015-q1-cloud-japac-jp-translate-bkws-freetrial-jap&amp;utm_term=google%20translate%20api" id="vs0p1c0" style="font-size:13px;color:rgb(102,0,153);text-decoration:none;">Google Translate API‎</a><span style="font-size:13px;"> </span></p> 2016-12-04T01:23:12+09:00 1480782192 https://w.atwiki.jp/zuora_ja/pages/1.html **@wikiへようこそ -ウィキはみんなで気軽にホームページ編集できるツールです。 -このページは自由に編集することができます。 -メールで送られてきたパスワードを用いてログインすることで、各種変更（サイト名、トップページ、メンバー管理、サイドページ、デザイン、ページ管理、等）することができます **まずはこちらをご覧ください。 -[[@wikiの基本操作>>http://www1.atwiki.jp/guide/pages/11.html]] -[[編集モード・構文一覧表>>http://www1.atwiki.jp/guide/pages/137.html]] -[[@wikiの設定・管理>>http://www1.atwiki.jp/guide/pages/36.html]] **分からないことは？ -[[@wiki ご利用ガイド>>http://atwiki.jp/guide/]] -[[よくある質問>>http://www1.atwiki.jp/guide/pages/21.html]] -[[@wiki更新情報>>http://www1.atwiki.jp/guide/pages/143.html]] -[[@wikiへのお問合せフォーム>>http://atwiki.jp/helpdesk]] 等をご活用ください **[[アットウィキモードでの編集方法>>http://www1.atwiki.jp/guide/pages/226.html#id_6861418f]] -[[文字入力>>http://www1.atwiki.jp/guide/pages/228.html]] -[[画像入力>>http://www1.atwiki.jp/guide/pages/230.html]] -[[表組み>>http://www1.atwiki.jp/guide/pages/914.html]] **[[ワープロモードでの編集方法>>http://www1.atwiki.jp/guide/pages/226.html#id_a14c0938]] -[[文字入力>>http://www1.atwiki.jp/guide/pages/2644.html]] -[[画像入力>>http://www1.atwiki.jp/guide/pages/2645.html]] -[[表組み>>http://www1.atwiki.jp/guide/pages/2646.html]] **その他にもいろいろな機能満載！！ -[[@wikiプラグイン一覧>>http://www1.atwiki.jp/guide/pages/264.html]] -[[@wikiかんたんプラグイン入力サポート>>http://www1.atwiki.jp/guide/pages/648.html]] **バグ・不具合を見つけたら？ 要望がある場合は？ お手数ですが、[[お問合せフォーム>>http://atwiki.jp/helpdesk]]からご連絡ください。 2016-11-28T17:39:58+09:00 1480322398 https://w.atwiki.jp/zuora_ja/pages/3.html **更新履歴 #recent(20) &link_editmenu2(text=ここを編集) 2016-11-28T17:39:58+09:00 1480322398 https://w.atwiki.jp/zuora_ja/pages/4.html * ニュース @wikiのwikiモードでは #news(興味のある単語) と入力することで、あるキーワードに関連するニュース一覧を表示することができます 詳しくはこちらをご覧ください。 ＝＞http://www1.atwiki.jp/guide/pages/266.html#id_542badf7 ----- たとえば、#news(ゲーム)と入力すると以下のように表示されます。 #news(ゲーム) 2016-11-28T17:39:58+09:00 1480322398 https://w.atwiki.jp/zuora_ja/pages/5.html * 更新履歴 @wikiのwikiモードでは #recent(数字) と入力することで、wikiのページ更新履歴を表示することができます。 詳しくはこちらをご覧ください。 ＝＞http://www1.atwiki.jp/guide/pages/269.html#id_bf9eaeba ----- たとえば、#recent(20)と入力すると以下のように表示されます。 #recent(20) 2016-11-28T17:39:58+09:00 1480322398 https://w.atwiki.jp/zuora_ja/pages/6.html * アーカイブ @wikiのwikiモードでは #archive_log() と入力することで、特定のウェブページを保存しておくことができます。 詳しくはこちらをご覧ください。 ＝＞http://www1.atwiki.jp/guide/pages/921.html#id_2d967d6e ----- たとえば、#archive_log()と入力すると以下のように表示されます。 保存したいURLとサイト名を入力して"アーカイブログ"をクリックしてみよう #archive_log() 2016-11-28T17:39:58+09:00 1480322398 https://w.atwiki.jp/zuora_ja/pages/7.html *RSSを取り込んで一覧表示(rss) #rss(ここにＲＳＳのＵＲＬ) もしくは #rss(ここにＲＳＳのＵＲＬを入力) と入力することで指定したＲＳＳを取り込んで一覧表示します。 詳しくはこちらをご覧ください。 ＝＞http://www1.atwiki.jp/guide/pages/269.html#id_a0e79757 ---- たとえば、#rss(http://www1.atwiki.jp/guide/rss10_new.xml) と入力すると以下のように表示されます。 #rss(http://www1.atwiki.jp/guide/rss10_new.xml) 2016-11-28T17:39:58+09:00 1480322398 https://w.atwiki.jp/zuora_ja/pages/8.html * 動画(youtube) @wikiのwikiモードでは #video(動画のURL) と入力することで、動画を貼り付けることが出来ます。 詳しくはこちらをご覧ください。 ＝＞http://www1.atwiki.jp/guide/pages/801.html#id_30dcdc73 また動画のURLはYoutubeのURLをご利用ください。 ＝＞http://www.youtube.com/ ----- たとえば、#video(http://youtube.com/watch?v=kTV1CcS53JQ)と入力すると以下のように表示されます。 #video(http://youtube.com/watch?v=kTV1CcS53JQ) 2016-11-28T17:39:58+09:00 1480322398 https://w.atwiki.jp/zuora_ja/pages/9.html @wikiにはいくつかの便利なプラグインがあります。 ----- #ls ----- これ以外のプラグインについては@wikiガイドをご覧ください =>http://atwiki.jp/guide/ 2016-11-28T17:39:58+09:00 1480322398