Creazione di ordini e record correlati

Risorsa

https://yourInstance.salesforce.com/services/data/vXX.X/composite

Esempio di richiesta JSON

Questo esempio di richiesta illustra come creare ordini.

{
  "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}}"
      }
    }
  ]
}

Considerazioni

Tenere presenti queste considerazioni quando si creano ordini storici.

• È possibile retrodatare solo gli ordini di vendita iniziali.
• Non è possibile retrodatare modifiche, rinnovi e annullamenti.
• Durante la migrazione dei campi numerici, avere 0 o null come valore del campo è una distinzione importante. Quando si modifica un asset corrispondente a un ordine, i valori dei campi 0 e null vengono trattati in modo diverso. Se il valore del campo è nullo ma il sistema imposta il valore su 0, questo potrebbe essere trattato come una modifica del campo e attivare un determinato comportamento.

Assicurarsi di eseguire la migrazione di questi record e campi.

Record assegnazione utilizzo app

Un record Assegnazione utilizzo app distingue gli ordini di Gestione del reddito dagli altri tipi di ordini Salesforce. Assicura inoltre che gli ordini siano collegati alle azioni ordine e alle voci ordine correlate.

Ogni record Asset richiede un record Assegnazione utilizzo app.

Vedere AppUsageAssignment.

Record ordine

Gli ordini di azioni precedenti e di vendita iniziale vengono utilizzati come riferimento per creare ordini utilizzando le API CRF.

Vedere Ordine.

Record azioni ordine

Ogni record Azione asset deve avere un record Azione ordine correlato.

Vedere OrderAction.

Record voce ordine

Questi valori di Voce ordine sono obbligatori.

Vedere OrderItem.

Record relazione con l'ordine

Vedere OrderItemRelationship.

Per capire l'impatto della creazione di ordini sul consumo di credito per gli eventi, vedere Tipi di utilizzo fatturabili di Gestione del reddito.