customers リソースの種類

名前空間: microsoft.graph

重要

Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。

Dynamics 365 Business Central の顧客を表します。

メソッド

メソッド	戻り値の型	説明
顧客を取得する	ユーザー	顧客を取得します。
顧客を作成する	ユーザー	顧客を作成します。
顧客を更新する	ユーザー	顧客を更新します。
顧客を削除する	なし	顧客を削除します。

プロパティ

プロパティ	種類	説明
id	GUID	アイテムの一意の ID です。 編集できません。
number	string	顧客番号。
displayName	string	顧客の名前を指定します。 この名前は、顧客のすべての販売ドキュメントに表示されます。
type	string	顧客の種類として、"Company" または "Person" を指定します。
address	ナビゲーション."Postaladdress	顧客の住所を指定します。 この住所は、お客様のすべてのセールスドキュメントに表示されます。
phoneNumber	string	顧客の電話番号を指定します。
メール	string	顧客の電子メールアドレスを指定します。
Web サイト	string	顧客のホームページのアドレスを指定します。
taxLiable	ブール値	顧客または仕入先が売上税に対して責任を負わないかどうかを指定します。 お客様が納税責任を持つ場合は true に設定します。
taxAreaId	GUID	顧客が属する税エリアを指定します。
taxAreaDisplayName	string	顧客が属する税エリアの表示名を指定します。
taxRegistrationNumber	文字列、最大サイズ20	顧客の税務登録番号を指定します。
currencyId	GUID	顧客が使用する通貨を指定します。
currencyCode	数値	顧客の既定の通貨コード。
paymentTermsId	GUID	顧客が使用する支払い条件を指定します。
paymentMethodId	GUID	顧客が使用する支払い方法を指定します。
shipmentMethodId	GUID	顧客がどの送付方法を使用するかを指定します。
ブロック	string	顧客とのトランザクションを転記できないことを指定します。 顧客がブロックされていない場合は、[ すべて] に設定します。ブロックしない場合は、[空白] に設定します。
対照	数値	顧客が完了した売上に対して支払うべき支払い金額を指定します。 この値は、顧客の残高とも呼ばれます。 読み取り専用です。
overdueAmount	数値	顧客の延滞金額を指定します。
totalSalesExcludingTax	数値	顧客の税を除いた合計売上金額を指定します。
lastModifiedDateTime	日付型	顧客が最後に変更された日付です。 読み取り専用。

リレーションシップ

通貨 (currencyCode) は、[通貨] テーブルに存在している必要があります。

支払い条件 (paymentTerms) は支払い条件テーブルに存在する必要があります。

送付方法 (shipmentMethod) は、送付方法テーブルに存在する必要があります。

支払い方法 ([Cash]) は支払い方法テーブルに存在する必要があります。

税エリア (taxArea) は、税エリアテーブルに存在する必要があります。

JSON 表記

以下は、リソースの JSON 表記です。

{
    "id": "GUID",
    "number": "string",
    "displayName": "string",
    "type": "string",
    "address": NAV.PostalAddress,
    "phoneNumber": "string",
    "email": "string",
    "website": "string",
    "taxLiable": "boolean",
    "taxAreaId": "GUID",
    "taxAreaDisplayName": "string",
    "taxRegistrationNumber": "string",
    "currencyCode": "string",
    "paymentTermsId": "GUID",
    "shipmentMethodId": "GUID",
    "paymentMethodId":  "GUID",
    "blocked": "string",
    "balance": "decimal",
    "overdueAmount": "numeric",
    "totalSalesExcludingTax": "numeric",
    "lastModifiedDateTime": "datetime"
}