Выставленные счета и неоплачиваемые ежедневные оценки API выверки использования версии 2 (GA)
Центр партнеров (недоступен в Azure для государственных организаций или Azure China 21Vianet) применяется к:
Общие сведения об архитектуре
Новый асинхронный API предлагает значительные улучшения в том, как мы обрабатываем доступ к данным выставления счетов и выверки. Этот подход устраняет проблемы, связанные с традиционными синхронными методами, такими как обслуживание длительных подключений и обработка больших пакетов данных. Ниже приведены основные преимущества и механизмы этого API:
Ключевые компоненты
Безопасный доступ с помощью шаблона ключа valet
Шаблон ключа валета обеспечивает безопасный и ограниченный доступ к данным биллинга. Аналогично тому, как служебный ключ позволяет кому-то управлять автомобилем без доступа к багажнику, этот шаблон обеспечивает детализированный контроль доступа. Вместо использования общих учетных данных токен совместного доступа (SAS) предоставляет ограниченный по времени доступ к определённым ресурсам. Этот шаблон снижает риск несанкционированного доступа, настраивая точные сроки действия и разрешения доступа.
Повышение эффективности с помощью асинхронного шаблона ответа на запрос
Подумайте об этом, как о заказе в оживлённом ресторане. Вместо того чтобы ждать у стойки, вы получаете зуммер и можете заниматься другими делами, пока готовится ваш заказ. Когда данные будут готовы, система уведомляет вас.
Асинхронный характер API означает, что вы выполняете запрос и система обрабатывает его в фоновом режиме. Это асинхронный запрос-ответ эффективно использует ресурсы, снижает нагрузку на сервер и минимизирует тайм-ауты и сбои, которые часто встречаются при синхронном извлечении данных.
Гибкость в разрешениях доступа к данным
Маркеры SAS обеспечивают гибкость в управлении разрешениями доступа к данным. Вы можете создавать токены, предоставляющие доступ ко всем атрибутам данных согласования выставленных счетов или ограничить доступ к определенным подмножествам. Эта степень детализации позволяет организациям адаптировать доступ к данным в соответствии с внутренними политиками и нормативными требованиями, повышая безопасность и соответствие требованиям.
Упрощенный рабочий процесс и улучшенное время обработки данных
Шаблон асинхронного ответа на запрос упрощает обработку данных, позволяя динамический доступ вместо фиксированных пакетов из 2000 элементов строки. Такой подход приводит к более быстрым результатам и улучшению времени обработки, упрощая интеграцию данных выставления счетов и выверки в существующие системы и рабочие процессы.
Преимущества
преимущества производительности
Вместо поддержания длительных подключений и обработки фиксированных пакетов новая система позволяет:
Выполните быстрый первоначальный запрос.
Получите маркер безопасного доступа.
Обрабатывайте данные в своём темпе.
Доступ именно к тому, что вам нужно, когда это необходимо.
улучшения безопасности
Шаблон ключа valet, реализованный с помощью маркеров SAS, предоставляет следующие возможности:
Ограниченный доступ по времени.
Ограниченные разрешения.
Устранение общего доступа или хранения постоянных учетных данных.
Мелкозернистое управление доступом.
Архитектурные преимущества
Шаблон асинхронного запроса-ответа действует как личный помощник, который:
Принимает ваш запрос.
Обрабатывает задачу в фоновом режиме.
Уведомляет вас, когда все готово.
Внедрение оптимизированных API для повышения производительности
Использование этих оптимизированных API упрощает рабочий процесс и повышает общую производительность управления данными. Используя безопасный контроль доступа и эффективные механизмы извлечения, вы достигаете лучшие результаты с меньшими усилиями, что приводит к повышению эффективности работы.
В заключение, новый асинхронный API для доступа к данным выставления счетов и выверки через Azure blobs является мощным инструментом. Он обеспечивает безопасный, эффективный доступ к финансовым данным, упрощение рабочих процессов, снижение нагрузки сервера и улучшение времени обработки, все с высоким уровнем безопасности и соответствия требованиям.
Примечание.
Новые API не размещаются на узле API Центра партнеров. Вместо этого вы можете найти их на MS Graph Использовать API Microsoft Graph для экспорта данных о выставлении счетов партнеров. Чтобы получить доступ к этим API, ознакомьтесь со следующими сведениями.
Эти API можно использовать только для общедоступного глобального облака MS Graph. Они пока недоступны для Azure Government или Azure China.
Разрешить приложению получать доступ к данным о выставлении счетов партнера
Чтобы разрешить приложению доступ к данным о выставлении счетов партнера, следуйте этой ссылке и ознакомьтесь с основами проверки подлинности и авторизации MicrosoftGraph. Этот шаг имеет решающее значение, так как это гарантирует, что ваше приложение может безопасно получить доступ к необходимым данным.
Назначьте разрешение PartnerBilling.Read.All
Назначьте разрешение PartnerBilling.Read.All с помощью портала Azure или Центра администрирования Microsoft Entra. Эти действия гарантируют, что ваше приложение имеет необходимый доступ к данным выставления счетов партнера.
- Зарегистрируйте приложение на домашней странице Microsoft Entra в разделе Регистрация приложений.
- Предоставьте необходимое разрешение, перейдя на страницу приложения Microsoft Entra. В разделе разрешений API выберите Добавить разрешение и выберите область PartnerBilling.Read.All.
Общие сведения о различиях между бета-версией и версиями общедоступной версии
Если вы использовали бета-версию, скорее всего, вы найдете переход на общедоступную и интуитивно понятную версию. Чтобы понять обновления и улучшения, рекомендуется сравнить бета-версии и версии общедоступной версии. Общие сведения об этих обновлениях помогают максимизировать новые функции и улучшения, доступные в общедоступной версии.
Внимание
Новая коммерческая ежедневная оценка использования не включает расходы на эти продукты:
- Резервирование Azure
- Экономичный план Azure
- Office
- Dynamics
- Microsoft Power Apps
- Программное обеспечение с бессрочной лицензией
- Подписка на программное обеспечение
- Продукт SaaS, отличный от Майкрософт или Marketplace
Общие сведения и использование конечных точек API
Для асинхронного получения выставленных счетов за новую коммерческую торговлю ежедневно оцененных элементов линии использования мы предлагаем две ключевые конечные точки API. Выполните это упрощенное руководство, чтобы быстро приступить к работе.
Использование конечной точки элемента строки
Во-первых, используйте этот API для получения новых элементов линии использования ежедневной коммерческой торговли . При выполнении запроса вы получаете состояние HTTP 202 и заголовок расположения с URL-адресом. Регулярно опросите этот URL-адрес, пока не получите состояние успешного выполнения и URL-адрес манифеста.
Используйте конечную точку статуса операции
Выполнив следующие действия, вы можете эффективно управлять процессом выверки счетов.
Продолжайте проверять состояние операции, вызывая этот API через регулярные интервалы. Если данные не готовы, ответ включает заголовок Retry-After , указывающий, как долго ждать, прежде чем повторить попытку. После завершения операции вы получите манифест-ресурс со ссылкой на папку для загрузки данных об использовании. Ответ сегментирует файлы, чтобы повысить пропускную способность и разрешить параллелизм ввода-вывода.
Просмотрите схему последовательности данных выверки
Ниже приведена схема последовательности, на которую показано, как скачать данные выверки.
Следуйте последовательности действий пользователя
Ниже приведены шаги последовательности действий пользователя для получения новых коммерческих ежедневных элементов выверки использования:
- отправить запрос
- Проверьте состояние запроса
- Скачивание элементов строки выверки из хранилища BLOB-объектов Azure
Отправка запроса
Отправьте запрос POST в конечную точку API.
Получение необясченных ежедневных строк использования
Получение новых элементов линии ежедневного использования для текущего или последнего календарного месяца или периода выставления счетов.
Примечание.
Вы можете получить доступ к неоплачиваемой ежедневной строке использования с помощью API или портала Центра партнеров. Чтобы обеспечить точность данных, необходимо до 24 часов для их доступности. В зависимости от расположения и времени, когда счетчики сообщают об использовании, могут возникнуть дополнительные задержки.
Сначала мы ставим приоритеты по доставке оплачиваемых ежедневных данных об использовании. Иногда самые последние неоплачиваемые ежедневные данные об использовании могут не отображаться до тех пор, пока выставленные счета за предыдущий месяц не будут доступны. После получения выставленных счетов данных вы сможете получить доступ ко всем обновленным необновленным данным об использовании с начала месяца.
Основные моменты:
- Ожидайте до 24 часов, пока данные станут доступны.
- Возможно, возникнут дополнительные задержки в зависимости от вашего местоположения и времени передачи показаний счетчика.
- Ежедневные оплачиваемые данные об использовании имеют приоритет над неоплаченными данными.
Ваше понимание и терпение ценятся, так как мы стремимся обеспечить наиболее точную и своевременную информацию.
Запрос API
POST https://graph.microsoft.com/v1.0/reports/partners/billing/usage/unbilled/export
Accept: application/json
Content-Type: application/json
{
"currencyCode": "USD",
"billingPeriod": "current",
"attributeSet": "basic"
}
Текст запроса
| Атрибут | Обязательное поле | Type | Описание |
|---|---|---|---|
| attributeSet | False | Строка | Выберите "полный" для всех атрибутов или "базовый" для ограниченного набора. Если значение по умолчанию не указано, значение full. Проверьте список атрибутов в этом разделе. Необязательно. |
| billingPeriod | Истина | Строка | Чтобы получить неучтённое ежедневное использование, используйте "current" для текущего периода выставления счетов или "last" для прошлого периода выставления счетов (аналогично "предыдущий" в API версии 1). Необходимые. |
| currencyCode | Истина | Строка | Код валюты выставления счетов партнера. Необходимые. |
Заголовки запросов
Чтобы запросить заголовки API, см. сведения о надежности и поддержке.
Ответ API
HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14
API обычно отвечает с состоянием HTTP 202. Вы также можете столкнуться с другими статусами в зависимости от ваших запросов. Эти состояния перечислены в разделе состояния ответа API "Стандартный".
| Код | Описание |
|---|---|
| 202 — принято | Ваш запрос был принят. Чтобы проверить состояние запроса, запросите URL-адрес, указанный в заголовке расположения. |
Получение оплачиваемых ежедневных строк использования
Получение новых выставленных счетов за ежедневное выставление счетов за выставление счетов за закрытый период выставления счетов.
Запрос API
POST https://graph.microsoft.com/v1.0/reports/partners/billing/usage/billed/export
{
"invoiceId": "G00012345",
"attributeSet": "full"
}
Параметры запроса
Н/П
Текст запроса
| Атрибут | Обязательное поле | Type | Описание |
|---|---|---|---|
| invoiceId | Истина | Строка | Уникальный идентификатор для каждого счета. Необходимые. |
| attributeSet | False | Строка | Выберите "полный" для всех атрибутов или "базовый" для ограниченного набора. Если значение по умолчанию не указано, значение full. Проверьте список атрибутов в этом разделе. Необязательно. |
Заголовок запроса
Заголовок запроса для API. Дополнительные сведения см. в статье о надежности и поддержке.
Ответ API
Принято HTTP/1.1 202
Расположение: https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14
При использовании API обычно возвращается состояние HTTP 202. Подробнее о других возможных состояниях на основе ваших запросов см. в состояниях.
| Код | Описание |
|---|---|
| 202 — принято | Ваш запрос был принят. Чтобы проверить состояние запроса, запросите URL-адрес, указанный в заголовке расположения. |
Проверка состояния запроса
Чтобы отслеживать состояние запроса, убедитесь, что вы получите ответ HTTP 200, который является стандартным кодом состояния, указывающим на "успешно" или "сбой". В случае успешного выполнения вы найдете URL-адрес манифеста в атрибуте resourceLocation. Этот атрибут предоставляет конечную точку для доступа к необходимым сведениям.
Получение состояния операции
Извлекает состояние запроса.
Запрос API
Параметры запроса
| Имя. | Включение в | Обязательное поле | Type | Описание |
|---|---|---|---|---|
| operationId | URI запроса | Истина | Строка | Уникальный идентификатор для проверки состояния запроса. Необходимые. |
Заголовок запроса
Чтобы запросить заголовки API, см. сведения о надежности и поддержке.
Текст запроса
Недоступно
Состояние ответа
Помимо стандартных состояний HTTP, перечисленных в состояниях ответа API уровня "Стандартный", API также может возвращать следующее состояние HTTP:
| Код | Описание |
|---|---|
| 410 - Ушло | Срок действия ссылки манифеста истекает после заданного времени. Чтобы снова получить ссылку манифеста, отправьте новый запрос. |
Полезные данные ответа
Полезные данные ответа API включают следующие атрибуты:
| Атрибут | Обязательное поле | Описание |
|---|---|---|
| id | Истина | Уникальный идентификатор для каждого ответа. Необходимые. |
| статус | Истина |
Значения и действия: обязательный: не запущено: дождитесь указанного времени в заголовке "Retry-After", затем выполните повторный вызов, чтобы проверить статус. запуск: подождите указанное время в заголовке Retry-After, а затем выполните еще один вызов, чтобы проверить состояние. Выполнено успешно: данные готовы. Извлеките полезные данные манифеста с помощью URI, указанного в resourceLocation. сбой: операция не удалось окончательно. Перезапустите его. |
| createdDateTime | Истина | Время выполнения запроса. Необходимые. |
| lastActionDateTime | Истина | При последнем изменении состояния. Необходимые. |
| resourceLocation | False | Универсальный код ресурса (URI) для полезных данных манифеста. Необязательно. |
| error | False | Сведения о любых ошибках, предоставляемых в формате JSON. Необязательно. Атрибуты включены: сообщение: описание ошибки. код: тип ошибки. |
Объект расположения ресурсов
| Атрибут | Описание |
|---|---|
| id | Уникальный идентификатор манифеста. |
| schemaVersion | Версия схемы манифеста. |
| dataFormat | Формат файла данных выставления счетов. compressedJSON: формат данных, в котором каждый большой двоичный объект представляет собой сжатый файл, содержащий данные в формате строк JSON . Чтобы получить данные из каждого большого двоичного объекта, распаковите его. |
| createdDateTime | Дата и время создания файла манифеста. |
| eTag | Версия данных манифеста. Изменение сведений о выставлении счетов создает новое значение. |
| partnerTenantId | Идентификатор Microsoft Entra клиента партнера. |
| rootDirectory | Корневой каталог файла. |
| sasToken | Маркер SAS (подписанный URL-адресом), позволяющий считывать все файлы в каталоге. |
| partitionType | Делит данные на несколько больших двоичных объектов на основе атрибута partitionValue . Система разделяет секции, превышающие поддерживаемую цифру. По умолчанию данные секционируются на основе количества элементов строки в файле. Избегайте жёсткого кодирования количества строк или размеров файлов, так как они могут измениться. |
| BLOBCount | Общее количество файлов для этого идентификатора клиента партнера. |
| большие двоичные объекты | Массив JSON объектов "BLOB-объектов", содержащий сведения о файле для идентификатора клиента партнера. |
| большой двоичный объект | Объект, содержащий следующие сведения: имя и partitionValue |
| name | Имя большого двоичного объекта. |
| partitionValue | Раздел, содержащий файл. Большой раздел разделён на несколько файлов на основе определённых условий, таких как размер файла или количество записей, при этом каждый файл содержит тот же самый "partitionValue". |
Запрос API
GET <https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14>
Ответ API
Ответ рекомендует ждать 10 секунд, прежде чем повторить попытку при обработке данных.
HTTP/1.1 200 OK
Retry-After: 10
{
"id": "9ab9cb54-d07f-4f52-9ea6-a09d7de52c14",
"createdDateTime": "2022-06-1T10-01-03.4Z",
"lastActionDateTime": "2022-06-1T10-01-05Z",
"status": "running"
}
Запрос API
(через 10 секунд после предыдущего запроса...)
GET <https://graph.microsoft.com/v1.0/reports/partners/billing/operations/9ab9cb54-d07f-4f52-9ea6-a09d7de52c14>
Ответ API
API возвращает состояние "успешно" и универсальный код ресурса (URI) для resourceLocation.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/\$metadata#reports/partners/billing/operations/\$entity",
"@odata.type": "#microsoft.graph.partners.billing.exportSuccessOperation",
"id": "f2170b13-6a8e-47d6-b481-6988490dc0cb",
"createdDateTime": "2023-12-05T21:17:29Z",
"lastActionDateTime": "2023-12-05T21:18:00.8897902Z",
"status": "succeeded",
"resourceLocation": {
"id": "44e8500b-ab92-490e-8ac3-90500a1d3427",
"createdDateTime": "2023-11-06T19:58:47.513Z",
"schemaVersion": "2",
"dataFormat": "compressedJSON",
"partitionType": "default",
"eTag": "RwDrn7fbiTXy6UULE",
"partnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"rootDirectory": "https://adlsreconbuprodeastus201.blob.core.windows.net/path_id",
"sasToken": "{token}",
"blobCount": 1,
"blobs": \[
{
"name": "part-00123-5a93fa5d-749f-48bc-a372-9b021d93c3fa.c000.json.gz",
"partitionValue": "default"
}
\]
}
}
Скачивание элементов линии выверки из хранилища BLOB-объектов Azure
Сначала необходимо получить токен общего доступа (SAS) и определить расположение хранилища блобов. Найдите эти сведения в свойствах sasToken и rootDirectory ответа API на данные манифеста.
Чтобы продолжить, выполните следующие действия.
- Скачайте файл Blob с помощью SDK или инструмента для хранения Azure.
- Распакуируйте файл, который находится в формате JSONLines.
Совет
Ознакомьтесь с примером кода . В нем показано, как скачать и распаковать файл BLOB-объектов Azure в локальную базу данных.
Общие сведения о стандартных состояниях ответа API
Эти состояния HTTP можно получить из ответа API:
| Код | Description |
|---|---|
| 400 – неверный запрос | Запрос отсутствует или содержит неверные данные. Проверьте текст ответа для получения сведений об ошибке. |
| 401 — Unauthorized (Не авторизовано) | Перед первым вызовом требуется проверка подлинности. Проверка подлинности с помощью службы API партнера. |
| 403 — запрещено | У вас нет необходимой авторизации для выполнения запроса. |
| 404 — не найден | Запрошенные ресурсы недоступны с предоставленными входными параметрами. |
| 410 - Ушло | Ссылка манифеста больше не действительна или активна. Отправьте новый запрос. |
| 500 — внутренняя ошибка сервера | API или его зависимости не могут выполнять запрос прямо сейчас. Повторите попытку позже. |
| 5000 — данные недоступны | Система не имеет данных для предоставленных входных параметров. |
Сравнение версий бета-версии и общедоступной версии
Ознакомьтесь со следующей таблицей сравнения, чтобы увидеть различия между бета-версией и общедоступной версией. Если вы используете бета-версию, переход на общедоступную версию, скорее всего, будет легким и простым.
| Важная информация | Бета-версия | Общедоступная версия |
|---|---|---|
| Конечная точка узла API | https://ep-billingreconservice-prod-d5bfczcnfvbqbdhx.z01.azurefd.net/ |
https://graph.microsoft.com/v1.0/reports/partners/billing/usage/ |
| Метод HTTP | POST | POST |
| Необилизованная конечная точка API ежедневного использования | https://ep-billingreconservice-prod-d5bfczcnfvbqbdhx.z01.azurefd.net/v1/unbilledusage |
https://graph.microsoft.com/v1.0/reports/partners/billing/usage/unbilled/export |
| Входные параметры для неоплачиваемого API ежедневного использования | Чтобы указать параметры в запросе API, включите их в строку запроса URL-адреса запроса. Например, чтобы указать параметры периода и currencyCode, добавьте ?period=current¤cyCode=usd его к URL-адресу запроса. |
Чтобы предоставить входные данные, включите объект JSON в текст запроса. Код JSON должен иметь следующие свойства: * currencyCode: ваша валюта выставления счетов. Например, USD. * billingPeriod: период выставления счетов. Например, текущий. Ниже приведен пример объекта JSON, включающего свойства currencyCode и billingPeriod: <br>{<br> "currencyCode": "USD",<br> "billingPeriod": "current"<br>} |
| Конечная точка API использования с выставлением счетов | https://ep-billingreconservice-prod-d5bfczcnfvbqbdhx.z01.azurefd.net/v1/billedusage/invoices/{InvoiceId} |
https://graph.microsoft.com/v1.0/reports/partners/billing/usage/billed/export |
| Входные параметры для оплачиваемого API ежедневного использования | Чтобы указать параметры в запросе API, добавьте идентификатор счета в URL-адрес запроса. Кроме того, можно включить необязательный параметр фрагмента в строку запроса, чтобы получить полный набор атрибутов. Например, чтобы получить полный набор атрибутов, добавьте ?fragment=full его к URL-адресу запроса. |
Чтобы предоставить входные данные, включите объект JSON в текст запроса. Код JSON должен иметь следующие свойства: * invoiceId: уникальный идентификатор счета. Например, G00012345. * attributeSet: атрибуты, которые должны находиться в ответе, например полные. Ниже приведен пример объекта JSON, включающего свойства invoiceId и attributeSet: {<br> "invoiceId": "G00012345",<br> "attributeSet": "full"<br>} |
| Ресурс манифеста | Используйте отдельный метод GET /manifests/{id}, чтобы получить ресурс манифеста. | Используйте метод GET /operations/{Id} для доступа к ресурсу манифеста в resourceLocation. Этот метод экономит время, устраняя необходимость отдельного вызова GET /manifests/{id}. |
| Изменения схемы манифеста | ||
| "id": недоступно | "id": уникальный идентификатор ресурса манифеста. | |
| "версия": доступно | "версия": изменено на "schemaversion". | |
| DataFormat:Available | DataFormat:Available. | |
| "utcCretedDateTime": доступно | UTCCretedDateTime: изменено на "createdDateTime". | |
| "eTag": доступно | "eTag": доступно. | |
| "partnerTenantId": доступно | "partnerTenantId": доступно | |
| "rootFolder": Доступно | RootFolder: изменено на rootDirectory. | |
| "rootFolderSAS": доступно | RootFolderSAS: изменено на sasToken. Это обновление предоставляет только маркер без пути корневого каталога. Чтобы найти каталог, используйте вместо этого свойство rootDirectory. | |
| PartitionType: Available | PartitionType: Доступно. | |
| "BLOBCount": Доступно | "BLOBCount": доступно. | |
| "sizeInBytes": доступно | "sizeInBytes": недоступно. | |
| "Большие двоичные объекты": доступно | "Большие двоичные объекты": доступно. | |
| "Объект BLOB-объектов": Доступно | "Объект BLOB-объектов": доступно. | |
| "name": Available | "name": Доступно. | |
| PartitionValue: Доступно | "partitionValue": доступно. |
Сравнение базовых и полных ежедневных атрибутов выверки использования
Чтобы сравнить атрибуты, возвращаемые API сверки использования для оплаченного или неоплаченного использования, относящиеся к наборам атрибутов "полный" или "базовый", см. в этой таблице. Дополнительные сведения об этих атрибутах и их значениях см. в полях файла ежедневной сверки использования.
| Атрибут | Полностью | Базовая |
|---|---|---|
| PartnerId | yes | yes |
| PartnerName | yes | yes |
| CustomerId | yes | yes |
| CustomerName | yes | Да |
| CustomerDomainName | yes | no |
| CustomerCountry | yes | no |
| MpnId | yes | no |
| Tier2MpnId | yes | no |
| InvoiceNumber | yes | yes |
| ИД продукта | yes | yes |
| SkuId | yes | yes |
| AvailabilityId | yes | no |
| SkuName | yes | yes |
| НаименованиеПродукта | yes | no |
| PublisherName | yes | yes |
| PublisherId | yes | no |
| SubscriptionDescription | yes | no |
| SubscriptionId | yes | yes |
| ChargeStartDate | yes | yes |
| ChargeEndDate | yes | yes |
| UsageDate | yes | yes |
| MeterType | yes | no |
| MeterCategory | yes | no |
| MeterId | yes | no |
| MeterSubCategory | yes | no |
| MeterName | yes | no |
| MeterRegion | yes | no |
| Единица измерения | yes | yes |
| Расположение ресурса | yes | no |
| ConsumedService | yes | no |
| ResourceGroup | yes | no |
| ResourceURI | yes | yes |
| ChargeType | yes | yes |
| UnitPrice | yes | yes |
| Количество | yes | yes |
| UnitType | yes | no |
| BillingPreTaxTotal | yes | yes |
| BillingCurrency | yes | yes |
| ЦенаPreTaxTotal | yes | yes |
| PricingCurrency | yes | yes |
| ServiceInfo1 | yes | no |
| ServiceInfo2 | yes | no |
| Теги | yes | no |
| AdditionalInfo | yes | no |
| EffectiveUnitPrice | yes | yes |
| PCToBCExchangeRate | yes | yes |
| PCToBCExchangeRateDate | yes | no |
| Идентификатор прав | yes | yes |
| НазначениеDescription | yes | no |
| PartnerEarnedCreditPercentage | yes | no |
| CreditPercentage | yes | yes |
| CreditType | yes | yes |
| BenefitOrderID | yes | yes |
| BenefitID | yes | no |
| BenefitType | yes | yes |
Внимание
Запишите эти изменения при переходе из API версии 1 в версию 2.
Каждое имя атрибута начинается с прописной буквы, чтобы обеспечить согласованность с файлом и повысить удобочитаемость.
unitOfMeasure обновляется до Unit. Его значение и ценность остаются неизменными, что упрощает имя атрибута.
resellerMpnId теперь имеет уровень 2MpnId. Значение и значение совпадают.
rateOfPartnerEarnedCredit обновляется до PartnerEarnedCreditPercentage. Новое имя и значение отражают процент вместо дроби, что упрощает понимание. Например, 0,15 теперь составляет 15 %.
rateOfCredit теперь CreditPercentage. Имя и значение изменились, чтобы обеспечить более четкое представление. Например, 1,00 теперь составляет 100 %.
Мы считаем, что эти изменения делают API более интуитивно понятными и удобными для использования.
Пример кода
Если вам нужна помощь по миграции в этот API, обратитесь к ссылке, включающей пример кода C#.
Примеры API Центра партнеров: получение данных о рекогносцировке выставления счетов.