4.31A realistic developer flow

Requirement:

Receive a customer. If valid, upsert Account and all Contacts. Return useful business result.

Architecture:

POST /customers
      ↓
Validate input
      ↓
vars.originalRequest
      ↓
Transform Account
      ↓
Upsert Account
      ↓
Get Account ID
      ↓
Transform contacts[]
      ↓
Upsert Contacts
      ↓
Inspect per-record results
      ↓
Transform response

Possible success:

{
  "customerId": "C001",
  "salesforceAccountId": "001ABC",
  "contactsProcessed": 3,
  "status": "SUCCESS"
}

Partial failure:

{
  "customerId": "C001",
  "salesforceAccountId": "001ABC",
  "contactsProcessed": 2,
  "contactsFailed": 1,
  "status": "PARTIAL_SUCCESS"
}

Notice:

HTTP operation succeeded

does not automatically equal:

business transaction completely succeeded

This distinction will matter when we cover error handling.