Loading
Criar pedidos e registros relacionados

Você está aqui:

  1. Ajuda do Salesforce
  2. Documentação
  3. Gerenciamento de receita da Agentforce

Criar pedidos e registros relacionados

Use a API composta para criar vários registros de Pedido e registros relacionados, incluindo Registros de Atribuição de uso de aplicativo, Ação do pedido, Item do pedido, Relacionamento de item do pedido.

Recurso
https://yourInstance.salesforce.com/services/data/vXX.X/composite
Amostra de solicitação JSON

Esta solicitação de amostra demonstra como criar 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}}"
      }
    }
  ]
}

Considerações

Lembre-se destas considerações ao criar pedidos históricos.

  • Você pode retroceder apenas pedidos de venda inicial.
  • Não é possível retroativar alterações, renovações e cancelamentos.
  • Ao migrar campos numéricos, ter 0 ou nulo como valor de campo é uma distinção importante. Quando você altera um ativo correspondente a um pedido, os valores de campo 0 e nulo são tratados de maneira diferente. Se o valor do campo for nulo, mas o sistema definir o valor como 0, isso poderá ser tratado como uma emenda de campo e acionar determinado comportamento.

Migre esses registros e campos.

Registros de atribuição de uso do aplicativo

Um registro de Atribuição de uso de aplicativo diferencia pedidos de gerenciamento de receita de outros tipos de pedidos do Salesforce. Também garante que os pedidos sejam vinculados às ações do pedido e itens do pedido relacionados.

Cada registro de Ativo requer um registro de Atribuição de uso de aplicativo.

Campo Atribuição de uso do aplicativo Requisito
AppUsageType Especifique RevenueLifecycleManagement.

Consulte AppUsageAssignment.

Registros do pedido

Pedidos de ações anteriores e venda inicial são usados como referência para criar pedidos usando APIs do ARC.

Campo do pedido Requisito
AccountId O pedido de venda inicial criado por APIs compostas precisa de um AccountId e deve ser igual ao AccountId do ativo relacionado.
BillToContactId O BillToContactId deve ser igual ao ContactId do ativo relacionado.
EffectiveDate

O EffectiveDate deve ser igual ao LifecycleStartDate do ativo relacionado e no formato HH:MM:SS.

O valor EffectiveDate não precisa ser 00:00:00.
Pricebook2Id O Pricebook2Id não deve ser nulo e deve estar relacionado ao produto e à entrada do catálogo de preços.

Ver Ordem.

Registros de ação do pedido

Cada registro de Ação do ativo deve ter um registro de Ação do pedido relacionado.

Campo de ação do pedido Requisito
SourceAssetId O SourceAssetId não pode ser nulo para pedidos de emenda, renovação e cancelamento.
Tipo O Tipo deve ser o mesmo que o tipo de AssetAction.

Consulte OrderAction.

Registros de item do pedido

Estes valores de Item do pedido são obrigatórios.

Campo de item do pedido Requisito
BillingFrequency2 Especifique um valor correspondente ao modelo de venda de produto e ao ativo Evergreen, Termed ou de uso único.
EndDate Especifique a data de término do ativo no formato apenas Data. EndDate não pode ser nulo.
PeriodBoundary Especifique o mesmo valor que o PeriodBoundary do modelo de venda de produto e o ativo Evergreen, Termed ou de uso único.
PricebookEntryId

Crie uma entrada do catálogo de preços usando o modelo de venda de produto e produto relevante e especifique-a.

A solicitação da API do ARC falhará se a combinação de catálogo de preços, produto e modelo de venda de produto para um item do pedido estiver imprecisa.
PricingTermCount A duração da assinatura do ativo para um ativo com prazo definido.
ServiceDate A data de início do ativo está no formato apenas Data. Se não for fornecida, a data efetiva do pedido relacionado será usada.
TotalLineAmount

O TotalLineAmount é calculado multiplicando a quantidade pela contagem do prazo de precificação e pelo preço unitário.

O valor TotalLineAmount reflete o TotalLifecycleAmount do ativo.

Consulte OrderItem.

Registros de relacionamento do pedido

Campo de relacionamento do pedido Requisito
AssociatedOrderItemPricing Especifique o tipo de precificação.
ProductRelationshipTypeId O identificador exclusivo do registro que descreve o relacionamento entre os produtos do pedido principais e associados.

Consulte OrderItemRelationship.

Para entender o impacto da criação de pedidos no consumo de crédito de evento, consulte Tipo de uso faturável de gerenciamento de receita.

Consulte também:

 
Carregando
Salesforce Help | Article