Usted está aquí:
Crear pedidos y registros relacionados
Utilice la API compuesta para crear múltiples registros de Pedido y registros relacionados, incluyendo registros Asignación de uso de aplicación, Acción de pedido, Artículo de pedido, Relación de artículo de pedido.
- Recurso
-
https://yourInstance.salesforce.com/services/data/vXX.X/composite - Muestra de solicitud JSON
Esta solicitud de ejemplo demuestra cómo crear pedidos.
{ "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}}" } } ] }
Consideraciones
Tenga en cuenta estas consideraciones cuando cree pedidos históricos.
- Solo puede retrotraer pedidos de venta inicial.
- No puede retrotraer las modificaciones, renovaciones y cancelaciones.
- Al migrar campos numéricos, tener 0 o nulo como valor de campo es una distinción importante. Cuando modifica un activo correspondiente a un pedido, los valores de campo 0 y nulo se tratan de forma diferente. Si el valor del campo es nulo pero el sistema establece el valor en 0, esto podría tratarse como una modificación de campo y desencadenar cierto comportamiento.
Asegúrese de migrar estos registros y campos.
Registros de asignación de uso de aplicación
Un registro Asignación de uso de aplicación diferencia los pedidos Revenue Cloud de otros tipos de pedidos de Salesforce. También se asegura de que los pedidos vinculan a las acciones de pedido relacionadas y los artículos de pedido.
Cada registro Activo requiere un registro Asignación de uso de aplicación.
| Campo Asignación de uso de aplicación | Requisito |
|---|---|
| AppUsageType | Especifique RevenueLifecycleManagement. |
Consulte AppUsageAssignment.
Registros de pedidos
Los pedidos de acciones anteriores y la venta inicial se utilizan como referencia para crear pedidos utilizando las API de ARC.
| Campo Pedido | Requisito |
|---|---|
| AccountId | El pedido de venta inicial creado por API compuestas necesita un AccountId y debe ser el mismo que el AccountId del activo relacionado. |
| BillToContactId | BillToContactId debe ser el mismo que ContactId del activo relacionado. |
| EffectiveDate | EffectiveDate debe ser el mismo que LifecycleStartDate del activo relacionado y en el formato HH:MM:SS. El valor EffectiveDate no necesita ser 00:00:00. |
| Pricebook2Id | Pricebook2Id no debe ser nulo y debe estar relacionado con la entrada de producto y lista de precios. |
Consulte Order.
Registros de acciones de pedidos
Cada registro Acción de activo debe tener un registro Acción de pedido relacionado.
| Campo Acción de pedido | Requisito |
|---|---|
| SourceAssetId | SourceAssetId no puede ser nulo para pedidos de modificación, renovación y cancelación. |
| Tipo | El Tipo debe ser el mismo que el tipo de AssetAction. |
Consulte OrderAction.
Registros de artículos de pedido
Estos valores de Artículo de pedido son obligatorios.
| Campo Artículo de pedido | Requisito |
|---|---|
| BillingFrequency2 | Especifique un valor que coincida con el modelo de venta de producto y el activo Evergreen, termin o onetime. |
| EndDate | Especifique la fecha de finalización del activo solo en el formato Fecha. La Fecha de finalización no puede ser nula. |
| Límite de periodo | Especifique el mismo valor que el PeriodBoundary del modelo de venta de producto y el activo Evergreen, termed o one-time. |
| PricebookEntryId | Cree una entrada de lista de precios desde el producto relevante y el modelo de venta de producto, y especifíquela. La solicitud de API de ARC falla si la combinación de lista de precios, producto y modelo de venta de producto para un artículo de pedido es imprecisa. |
| PricingTermCount | La longitud de suscripción de activo para un activo denominado. |
| ServiceDate | La fecha de inicio del activo solo tiene el formato Fecha. Si no se proporciona, se utiliza la fecha efectiva del pedido relacionado. |
| TotalLineAmount | TotalLineAmount se calcula multiplicando la cantidad por el recuento de condiciones de precios y el precio unitario. El valor TotalLineAmount refleja el TotalLifecycleAmount del activo. |
Consulte OrderItem.
Registros de relaciones de pedidos
| Campo Relación de pedido | Requisito |
|---|---|
| AssociatedOrderItemPricing | Especifique el tipo de precios. |
| ProductRelationshipTypeId | El identificador exclusivo del registro que describe la relación entre los productos de pedido principales y asociados. |
Consulte OrderItemRelationship.
