Вы находитесь здесь:
Создание заказов и связанных записей
Используйте составной API для создания нескольких записей заказа и связанных записей, включая записи «Назначение использования приложения», «Действие заказа», «Элемент заказа», «Взаимосвязь позиции заказа».
- Ресурс
-
https://yourInstance.salesforce.com/services/data/vXX.X/composite - Образец запроса JSON
-
Этот образец запроса показывает, как создавать заказы.
{ "allOrNone": true, "compositeRequest": [ { "method": "POST", "url": "/services/data/vXX.X/sobjects/Order", "referenceId": "refOrder", "body": { "AccountId": "{{accountId}}", "EffectiveDate": "{{currentDate}}", "Pricebook2Id": "{{standardPricebookId}}", "BillToContactId": "{{contactId}}", "Status": "Draft" } }, { "method": "POST", "url": "/services/data/vXX.X/sobjects/AppUsageAssignment", "referenceId": "refAppTag", "body": { "AppUsageType": "RevenueLifecycleManagement", "RecordId": "@{refOrder.id}" } }, { "method": "POST", "url": "/services/data/vXX.X/sobjects/OrderAction", "referenceId": "refOrderAction", "body": { "OrderId": "@{refOrder.id}", "Type": "New Sale" } }, { "method": "POST", "url": "/services/data/vXX.X/sobjects/OrderItem", "referenceId": "refOrderItem1", "body": { "OrderId": "@{refOrder.id}", "OrderActionId": "@{refOrderAction.id}", "PricebookEntryId": "{{priceBookEntryId1}}", "ServiceDate": "{{currentDate}}", "EndDate": "{{futureDate}}", "PricingTermCount": 12, "Quantity": 10, "UnitPrice": 100, "NetUnitPrice": 100, "TotalLineAmount": 12000, "PeriodBoundary": "AlignToCalendar", "BillingFrequency2": "Monthly" } }, { "method": "POST", "url": "/services/data/vXX.X/sobjects/OrderItem", "referenceId": "refOrderItem2", "body": { "OrderId": "@{refOrder.id}", "OrderActionId": "@{refOrderAction.id}", "PricebookEntryId": "{{priceBookEntryId2}}", "ServiceDate": "{{currentDate1}}", "EndDate": "{{futureDate}}", "PricingTermCount": 11, "Quantity": 5, "UnitPrice": 100, "NetUnitPrice": 100, "TotalLineAmount": 5500, "PeriodBoundary": "AlignToCalendar", "BillingFrequency2": "Monthly" } }, { "method": "POST", "url": "/services/data/vXX.X/sobjects/OrderItemRelationship", "referenceId": "refOrderItemRelationship1", "body": { "MainOrderItemId": "@{refOrderItem1.id}", "AssociatedOrderItemId": "@{refOrderItem2.id}", "AssociatedOrderItemPricing": "NotIncludedInBundlePrice", "ProductRelationshipTypeId": "{{productRelationshipType}}" } } ] }
Рекомендации
Ниже перечислены рекомендации по созданию архивных заказов.
- Вы можете датировать только первичные заказы на продажу.
- Поправки, продления и отмены не могут быть датированы датой.
- При миграции числовых полей важным отличием является наличие 0 или нулевого значения поля. При внесении поправок в актив, соответствующий заказу, значения полей 0 и null обрабатываются по-разному. Если значение поля нулевое, но система задает значение 0, это может рассматриваться как поправка поля и инициировать определенное поведение.
Убедитесь в миграции данных записей и полей.
Записи назначения использования приложения
Запись назначения использования приложения отличает заказы управления доходом от других типов заказов Salesforce. Он также обеспечивает ссылку заказов на связанные действия заказа и позиции заказа.
Каждая запись актива требует записи «Назначение использования приложения».
| Поле назначения использования приложения | Требование |
|---|---|
| AppUsageType | Укажите RevenueLifecycleManagement. |
См. AppUsageAssignment.
Записи заказа
Заказы из предыдущих действий и первичной продажи используются в качестве ссылки для создания заказов посредством ARC API.
| Поле заказа | Требование |
|---|---|
| AccountId | Заказ первичной продажи, созданный составными API, требует AccountId и должен совпадать с AccountId связанного актива. |
| BillToContactId | BillToContactId должен совпадать с ContactId связанного актива. |
| EffectiveDate | Функция effectiveDate должна совпадать с LifecycleStartDate связанного актива и в формате ЧЧ:ММ:СС. Значение EffectiveDate не обязательно должно быть 00:00:00. |
| Pricebook2Id | Pricebook2Id не должен быть нулевым и должен быть связан с продуктом и записью прайс-листа. |
См. Приказ.
Записи действий заказа
Каждая запись действия актива должна иметь связанную запись действия заказа.
| Поле действия заказа | Требование |
|---|---|
| SourceAssetId | SourceAssetId не может быть нулевым для заказов поправки, продления и отмены. |
| Тип | Тип должен совпадать с типом действия актива. |
См. OrderAction.
Записи элементов заказа
Данные значения позиции заказа обязательны.
| Поле элемента заказа | Требование |
|---|---|
| BillingFrequency2 | Укажите значение, соответствующее модели продажи продукта и Evergreen, терминированному или одноразовому активу. |
| EndDate | Укажите дату окончания актива только в формате даты. EndDate не может быть нулевой. |
| PeriodBoundary | Укажите одинаковое значение с PeriodBoundary модели продажи продукта и Evergreen, терминированный или одноразовый актив. |
| PricebookEntryId | Создайте запись прайс-листа в соответствующей модели продажи продукта и продукта и укажите ее. Запрос ARC API не выполняется, если сочетание прайс-листа, продукта и модели продажи продукта для элемента заказа является неточным. |
| PricingTermCount | Продолжительность подписки на актив для терминированного актива. |
| ServiceDate | Дата начала актива находится в формате «Только дата». Если он не предоставлен, используется дата вступления в силу связанного заказа. |
| TotalLineAmount | TotalLineAmount рассчитывается путем умножения количества на количество условий ценообразования и цену единицы продукции. Значение TotalLineAmount отображает TotalLifecycleAmount актива. |
См. OrderItem.
Записи взаимосвязи заказа
| Поле взаимосвязи заказа | Требование |
|---|---|
| AssociatedOrderItemPricing | Укажите тип ценообразования. |
| ProductRelationshipTypeId | Уникальный идентификатор записи, описывающий взаимосвязь между основными и связанными продуктами заказа. |
Чтобы понять влияние создания заказов на потребление кредита события, см. «Управление доходом» «Типы использования для счета».
