Тип ресурса customers

Статья
04/04/2024

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Представляет клиента в Dynamics 365 Business Central.

Методы

Метод	Возвращаемый тип	Описание
Получение клиентов	Клиентов	Возвращает клиента.
Создание клиентов	Клиентов	Создает клиента.
Обновление клиентов	Клиентов	Обновления клиента.
Удаление клиентов	none	Удаляет клиента.

Свойства

Свойство	Тип	Описание
id	Глобальный уникальный идентификатор (GUID)	Уникальный идентификатор элемента. Не редактируемый.
число	string	Номер клиента.
displayName	string	Указывает имя клиента. Это имя будет отображаться во всех документах по продажам для клиента.
type	string	Указывает тип клиента, который может быть "Company" или "Person".
address	NAV. PostalAddress	Указывает адрес клиента. Этот адрес будет отображаться во всех документах по продажам для клиента.
phoneNumber	string	Указывает номер телефона клиента.
email	строка	Указывает адрес электронной почты клиента.
веб-сайт	string	Указывает адрес домашней страницы клиента.
Налогообязанный	логический	Указывает, несет ли клиент или поставщик ответственность за налог с продаж. Установите значение true , если клиент несет налоговую ответственность.
taxAreaId	Глобальный уникальный идентификатор (GUID)	Указывает, к какой налоговой области относится клиент.
taxAreaDisplayName	string	Укажите отображаемое имя налоговой области, к которой принадлежит клиент.
taxRegistrationNumber	строка, максимальный размер 20	Указать номер налогового учета клиента.
currencyId	Глобальный уникальный идентификатор (GUID)	Указывает, какую валюту использует клиент.
currencyCode	Числовые	Код валюты по умолчанию для клиента.
paymentTermsId	Глобальный уникальный идентификатор (GUID)	Указывает, какой срок оплаты использует клиент.
paymentMethodId	Глобальный уникальный идентификатор (GUID)	Указывает, какой метод оплаты использует клиент.
shipmentMethodId	Глобальный уникальный идентификатор (GUID)	Указывает метод доставки, используемый клиентом.
Заблокирован	string	Указывает, что транзакции с клиентом не могут быть размещены. Задайте значение Все, если клиент заблокирован, установите значение пустое, если не заблокировано.
Баланс	Числовые	Указывает сумму платежа, которую клиент должен за завершенные продажи. Это значение также называется балансом клиента. Только для чтения.
overdueAmount	Числовые	Указывает просроченную сумму клиента.
totalSalesExcludingTax	Числовые	Указывает общую сумму продаж без учета налога клиента.
lastModifiedDateTime	datetime	Дата последнего изменения клиента. Только для чтения.

Связи

В таблице Currencyies должен существовать элемент Currency(currencyCode).

В таблице Условия оплаты должен существовать срок оплаты(paymentTerms).

Метод отправки (shipmentMethod) должен существовать в таблице Метод отправки.

Метод оплаты (paymentMethod) должен существовать в таблице Метод оплаты.

В таблице Налоговая область (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"
}