Loading
Создание заказов и связанных записей

Создание заказов и связанных записей

Используйте составной 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 Уникальный идентификатор записи, описывающий взаимосвязь между основными и связанными продуктами заказа.

См. OrderItemRelationship.

Чтобы понять влияние создания заказов на потребление кредита события, см. «Управление доходом» «Типы использования для счета».

 
Загрузка
Salesforce Help | Article