Schemas
TheftDto
idSalesforce Investigation record Id
investigationTypeInvestigation type picklist value (e.g. External Theft, Internal Theft). Immutable after create.
incidentDateDate of the incident (YYYY-MM-DD)
incidentTimeTime of the incident as string (HH:MM)
primaryLocationIdSalesforce Id of the primary location record. Send this or locationNumber; if both are sent they must name the same location.
locationNumberLocation Number of the primary location, the location's unique external id. Returned on every response (null when the case has no location). On POST and PUT it names the primary location instead of primaryLocationId; it resolves through the Location Number lookup, which ignores letter case, surrounding whitespace and apostrophes and falls back to the unpadded number. A number that matches no location, or several, returns 422 NATURAL_KEY_NOT_FOUND. If primaryLocationId is also sent it must name the same location, or the API returns 400 INVARIANT_VIOLATION.
reportedAtWhen the case was reported: the record's creation time (read-only). Ignored on writes. Null in a MAPPED org whose mapping does not provide it.
statusCase status picklist value (Open, Closed, Pending Assignment, Pending Approval)
incidentTypeThe Incident Type value the org stores, returned as stored. On a write without incidentTypeKey, the value is stored as given and is never validated against the org's values. Sent together with incidentTypeKey, it is kept only when it already belongs to that key.
incidentTypeKeyThe domain Incident Type key the stored incidentType belongs to, for example shoplifting or robbery; null when the stored value belongs to no key. Returned on every response that carries detail. On a write, the package stores the org value the key maps to: A key with no mapping is stored as incidentTypeLabel, or as the key itself when no label is sent. A request that sends both keeps incidentType when it already belongs to the key, so a body read from a GET and sent back unchanged keeps the stored value; otherwise the key wins. The package ships a fixed default map from the domain's base list of keys to their labels (shoplifting is stored as Shoplifting, robbery as Robbery).
incidentTypeLabelWrite only, ignored on a response. The value to store when incidentTypeKey has no mapping in the org.
methodPrimaryPrimary theft method picklist value
methodSecondarySecondary theft method picklist value
narrativeFree-text narrative description of the incident.
Tenant-owned case values, keyed by the domain property key from the case mapping, never a Salesforce field API name. Values are strings. POST writes them on the Investigation in the same request. A key that is not a custom property returns 422 CUSTOM_PROPERTY_NOT_DEFINED. A required key that is blank or absent on POST returns 422 CUSTOM_PROPERTY_REQUIRED. A value that is not a string, a value that does not convert, a value for a field the user cannot create, or a DML rejection of the field, returns 422 CUSTOM_PROPERTY_NOT_WRITABLE. Those refusals name the key in field, not the field API name, and do not include the value. GET returns the stored values as strings, or an empty object when the case has none. PUT ignores this field and does not change stored values. Required keys are enforced only on POST.
initialCaseValueInitial estimated value of the case. Immutable after create.
currencyIsoCodeISO 4217 currency code that all monetary fields are denominated in. In a response, every detail carries it and it is never null: the Estimated Loss currency, else the promissory amount currency, else the case's own currency. In a POST or PUT body it is optional: omit it or send null to keep the default. POST and PUT refuse a code the org cannot hold with 422 CURRENCY_NOT_SUPPORTED: a single-currency org holds only its own currency, a multi-currency org holds its active currencies.
totalCaseValueTotal calculated value of all stolen items (read-only rollup)
totalItemsTotal number of items involved in the case (read-only rollup)
totalCaseValueRecoveredTotal value recovered (read-only rollup)
uuidExternal UUID for cross-system reference and unique across cases. New values are stored in lower case and looked up in lower and upper case, so a value that differs only in letter case is the same uuid, except for a stored mixed-case value, which is a known gap. A POST that repeats a stored uuid returns 409 DUPLICATE_UUID with the stored case's id. Immutable after create: an update that repoints it at a different value is rejected with 400 IMMUTABLE_FIELD. A PUT that sets a uuid held by another case is rejected with 409 DUPLICATE_UUID.
investigatorIdSalesforce User Id of the assigned investigator
priorityCase priority picklist value, as stored. Open-set: not enumerated. Omitting it on an update keeps the stored value.
outcomeCase outcome picklist value, as stored. Open-set: not enumerated. Omitting it on an update keeps the stored value.
caseReportCase report, as rich text (HTML). Omitting it on an update keeps the stored value.
executiveSummaryExecutive summary, as rich text (HTML). Omitting it on an update keeps the stored value.
investigationPlanInvestigation plan, as rich text (HTML). Omitting it on an update keeps the stored value.
promissoryAmountPromissory note amount
damagesDamages picklist value
damageDescriptionFree-text description of damages
actionsTakenActions taken during the incident
preventativeActionsPreventative actions recommended
policeNotifiedYes/No picklist indicating if police were notified
policeNotifiedTimeDatetime when police were notified (ISO 8601)
policeArrivalTimeDatetime when police arrived (ISO 8601)
policeDepartmentName of the police department
policeOfficerNameName of the responding police officer
policeOfficerBadgeNumberBadge number of the responding police officer
policeReportNumberPolice report number
policeDispositionPolice disposition picklist value
concealmentLocationLocation where items were concealed
concealmentMethodHow the items were concealed, as reported. Any text is accepted.
pointOfEntryHow the offender got into the location, free text up to 100 characters. Accepted on any Investigation Type.
reportDateDate the incident was reported
reportTimeTime the incident was reported (HH:mm:ss)
closedDateTimeDate/time the case was closed (read-only)
incidentNumberAuto-generated incident number (read-only)
People associated with this case (suspects, witnesses, employees, law enforcement, and so on). Ordered by Salesforce Id ascending as an insertion-order proxy. Round-trips on GET, PUT, and POST. The insert, update, and delete-orphan cascade applies on PUT.
Body-shape semantics:
- An omitted field preserves the existing children (no-op).
- An empty array deletes all children.
- An explicit null is treated as omitted (no-op).
- An unknown id in the payload (a stale client cache) is rejected as
BAD_REQUEST.
POST entries must omit id. Concurrency is last-write-wins. PATCH for surgical updates is deferred.
Vehicles associated with this case.
Body-shape semantics:
- An omitted field preserves the existing junctions (no-op).
- An empty array deletes all junctions.
- An explicit null is treated as omitted (no-op).
Each entry supplies a vehicleId, reported vehicle details such as plate, plateState and vin, or both. The reported details are stored on the involvement, and a reported plate or VIN never links a Vehicle; only a vehicleId does. A vehicleId that names no Vehicle returns 422 NATURAL_KEY_NOT_FOUND. vehicleId is immutable after create, and a change is rejected with 400 IMMUTABLE_FIELD. A PUT may list a stored vehicle by involvementId alone, and the API updates that row.
Items associated with this case.
Body-shape semantics:
- An omitted field preserves the existing junctions (no-op).
- An empty array deletes all junctions.
- An explicit null is treated as omitted (no-op).
A non-empty array replaces the set. sku and itemId are optional but encouraged, and each entry needs at least one reported detail (sku, itemId, notes, quantity, valueAtIncident, category, upc, serialNumber, unitType, condition, itemName, merchandiseCategory, merchandiseType, brand, department, stockNumber or unitCost); an entry with none returns 400 INVARIANT_VIOLATION. On an entry that is being reported (one that names no stored case item by id or involvementId), a sku that matches exactly one Item, exactly after trimming and ignoring case, links that Item; a SKU that matches none or several is stored unlinked. A stored entry, however you name it, is never matched by SKU: its link changes only when you send an itemId. An itemId that names no Item returns 422 NATURAL_KEY_NOT_FOUND, and on a new entry an itemId and sku that name different Items return 400 INVARIANT_VIOLATION. itemId is immutable after create, and a change is rejected with 400 IMMUTABLE_FIELD. A PUT may list a stored item by involvementId alone, and the API updates that row.
InvolvedPersonDto
personRoleRole of the person in this case.
idSalesforce Id of the underlying junction record, assigned by Salesforce on insert. Omit on POST to create a new junction. Not the caller identifier of the involvement, which is involvementId.
personIdSalesforce Id of the linked Person record. Optional: an involvement may be described only by inline attributes. When supplied, the lookup is stored and any inline description sent on the same request is stored on the involvement too (hybrid storage); the description is never copied onto the Person. On a case POST or PUT, an id that names no Person returns 422 NATURAL_KEY_NOT_FOUND with field personId. Immutable after create.
employeeIdThe Salesforce Contact Id of an employee. On a canonical org, the API finds the Person attached to that employee, or creates one, and writes it as personId. Naming the same employee again reuses that Person. Inline description fields sent with employeeId are stored on the same involvement. The submitted employeeId is not stored on the involvement itself; reads return the Person's employee link as personPreview.employeeId. An unknown Contact id returns 422 NATURAL_KEY_NOT_FOUND with field employeeId and writes nothing. When personId is also supplied, both must name the same Person; otherwise the request is rejected with 400 INVARIANT_VIOLATION. On an org configured for inline person data, no Person is created: employeeId is written to the junction's own employee link as an ordinary inline attribute.
employeeNumberEmployee Number of the employee, as an alternative to employeeId (write-only; never returned). Every number in the request resolves in one call; the employee is then handled exactly as if employeeId had been sent. A number that matches no employee, or several, returns 422 NATURAL_KEY_NOT_FOUND with field employeeNumber and the value sent. If employeeId is also sent it must name the same employee, or the API returns 400 INVARIANT_VIOLATION.
displayNamePerson display name. Inline-detail attribute — set on create, returned on read. Reports only a value stored on the involvement itself; the referenced Person's own value appears under personPreview. A value the org has no field on the involvement for is rejected with 400 INVARIANT_VIOLATION, with or without a personId or employeeId. Writable only on orgs configured to store person details inline.
personTypePerson type (EMPLOYEE or EXTERNAL). Inline-detail attribute — set on create, returned on read. Reports only a value stored on the involvement itself; the referenced Person's own value appears under personPreview. A value the org has no field on the involvement for is rejected with 400 INVARIANT_VIOLATION, with or without a personId or employeeId. Writable only on orgs configured to store person details inline.
firstNamePerson's first name. Stored on the involvement itself, beside the optional Person link: set on create, returned on read whether or not personId is set.
middleNamePerson's middle name. Stored on the involvement itself, beside the optional Person link, as the person was reported: set on create, returned on read whether or not personId is set. The referenced Person's own value appears only under personPreview.
lastNamePerson's last name. Stored on the involvement itself, beside the optional Person link: set on create, returned on read whether or not personId is set.
aliasPerson's alias or nickname. Stored on the involvement itself, beside the optional Person link, as the person was reported: set on create, returned on read whether or not personId is set. The referenced Person's own value appears only under personPreview.
dateOfBirthPerson's date of birth. Stored on the involvement itself, beside the optional Person link: set on create, returned on read whether or not personId is set.
sexPerson's sex. Stored on the involvement itself, beside the optional Person link, as the person was reported: set on create, returned on read whether or not personId is set. The referenced Person's own value appears only under personPreview.
ethnicityPerson's ethnicity. Stored on the involvement itself, beside the optional Person link, as the person was reported: set on create, returned on read whether or not personId is set. The referenced Person's own value appears only under personPreview.
emailPerson's email address. Stored on the involvement itself, beside the optional Person link, as the person was reported: set on create, returned on read whether or not personId is set. The referenced Person's own value appears only under personPreview.
phonePerson's phone number. Stored on the involvement itself, beside the optional Person link, as the person was reported: set on create, returned on read whether or not personId is set. The referenced Person's own value appears only under personPreview.
streetStreet address. Stored on the involvement itself, beside the optional Person link, as the person was reported: set on create, returned on read whether or not personId is set. The referenced Person's own value appears only under personPreview.
cityCity. Stored on the involvement itself, beside the optional Person link, as the person was reported: set on create, returned on read whether or not personId is set. The referenced Person's own value appears only under personPreview.
stateState or province. Stored on the involvement itself, beside the optional Person link, as the person was reported: set on create, returned on read whether or not personId is set. The referenced Person's own value appears only under personPreview.
postalCodePostal code. Stored on the involvement itself, beside the optional Person link, as the person was reported: set on create, returned on read whether or not personId is set. The referenced Person's own value appears only under personPreview.
countryCountry. Stored on the involvement itself, beside the optional Person link, as the person was reported: set on create, returned on read whether or not personId is set. The referenced Person's own value appears only under personPreview.
heightPerson's height, as free text. Stored on the involvement itself, beside the optional Person link, as the person was reported: set on create, returned on read whether or not personId is set. The referenced Person's own value appears only under personPreview.
weightPerson's weight. Stored on the involvement itself, beside the optional Person link, as the person was reported: set on create, returned on read whether or not personId is set. The referenced Person's own value appears only under personPreview.
eyeColorPerson's eye color. Stored on the involvement itself, beside the optional Person link, as the person was reported: set on create, returned on read whether or not personId is set. The referenced Person's own value appears only under personPreview.
hairColorPerson's hair color. Stored on the involvement itself, beside the optional Person link, as the person was reported: set on create, returned on read whether or not personId is set. The referenced Person's own value appears only under personPreview.
clothingFree-text description of clothing worn. Stored on the involvement itself, beside the optional Person link, as the person was reported: set on create, returned on read whether or not personId is set. The referenced Person's own value appears only under personPreview.
identifyingFeaturesFree-text description of identifying features such as scars or tattoos. Stored on the involvement itself, beside the optional Person link, as the person was reported: set on create, returned on read whether or not personId is set. The referenced Person's own value appears only under personPreview.
externalIdExternal system identifier for the person. Inline-detail attribute — set on create, returned on read. Reports only a value stored on the involvement itself; the referenced Person's own value appears under personPreview. A value the org has no field on the involvement for is rejected with 400 INVARIANT_VIOLATION, with or without a personId or employeeId. Writable only on orgs configured to store person details inline.
thinkLPIdThinkLP-assigned identifier for the person. Inline-detail attribute — set on create, returned on read. Reports only a value stored on the involvement itself; the referenced Person's own value appears under personPreview. A value the org has no field on the involvement for is rejected with 400 INVARIANT_VIOLATION, with or without a personId or employeeId. Writable only on orgs configured to store person details inline.
identificationNumberIdentification number as the person reported it. Stored on the involvement itself with identificationType: set on create, returned on read.
identificationTypeKind of identification identificationNumber holds, for example Driver's License, stored as reported. It is left blank when a number is sent without a type. Stored on the involvement itself: set on create, returned on read.
physicalDescriptionFree-text physical description of the person, for an Incident that cannot name them. Stored on the involvement itself, beside the optional Person link: set on create, returned on read whether or not personId is set. Maximum 32768 characters. Never copied onto a Person.
involvementIdCaller-minted identifier of this involvement (for example a UUID v4), reused unchanged on retry. Stored on the junction's unique ThinkLPId column, which holds at most 36 characters, and returned on every read. Immutable after create: an update that sends a different value for a stored involvement returns 400 IMMUTABLE_FIELD; a value that differs only in case is the same value, and the stored spelling is kept. A value already held by another involvement, on this case or any other, or repeated inside one request, returns 409 DUPLICATE_INVOLVEMENT_ID; the comparison ignores case. Differs from id, the Salesforce record id that Salesforce assigns when the involvement is inserted: the caller mints involvementId before the record exists and resends it on retry, so a retried request is recognised and an update can find the stored involvement without the Salesforce id. Distinct from thinkLPId, which is an attribute of the Person.
Read-only preview of the referenced Person. Returned as null when the underlying Person is deleted, archived, or FLS-stripped for the running user (graceful degradation). The InvolvedPerson record itself is still valid case data.
isIdentityConfirmedInvestigator-confirmed identity flag.
actionTakenFree-text description of action taken with this person.
chargesFiledTri-state charges-filed status (Yes / No / Pending). Backed by the ThinkLP__ChargesFiled__c picklist. Independent of apprehensionDateTime.
apprehensionDateTimeWhen the person was apprehended.
notesFree-text investigator notes about this person.
readyForCivilRecoveryTrigger flag set by investigator to request civil-recovery workflow.
civilRecoveryCreatedStamped by downstream workflow when the civil-recovery record is created. Read-only on write. The API ignores any value you send.
PersonPreviewDto
displayNamePerson first name + last name composition.
personTypeEMPLOYEE when the underlying Person has a populated employee Contact lookup, EXTERNAL otherwise.
firstNameThe referenced Person's first name.
middleNameThe referenced Person's middle name.
lastNameThe referenced Person's last name.
aliasThe referenced Person's alias.
dateOfBirthThe referenced Person's date of birth.
sexThe referenced Person's sex.
ethnicityThe referenced Person's ethnicity.
emailThe referenced Person's email.
phoneThe referenced Person's phone.
streetThe referenced Person's street.
cityThe referenced Person's city.
stateThe referenced Person's state.
postalCodeThe referenced Person's postal code.
countryThe referenced Person's country.
heightThe referenced Person's height.
weightThe referenced Person's weight.
eyeColorThe referenced Person's eye color.
hairColorThe referenced Person's hair color.
clothingThe referenced Person's clothing.
identifyingFeaturesThe referenced Person's identifying features.
externalIdThe referenced Person's external id.
thinkLPIdThe referenced Person's think l p id.
employeeIdThe referenced Person's employee id.
InvolvedVehicleDto
idSalesforce record id of the Investigation_Vehicle__c junction row, assigned by Salesforce on insert. Null on POST cascade entry (new junction). Differs from involvementId, which the caller mints.
involvementIdCaller-minted identifier of this involvement (for example a UUID v4), reused unchanged on retry. Stored on the junction's unique ThinkLPId column, which holds at most 36 characters, and returned on every read. Immutable after create: an update that sends a different value for a stored involvement returns 400 IMMUTABLE_FIELD; a value that differs only in case is the same value, and the stored spelling is kept. A value already held by another involvement, on this case or any other, or repeated inside one request, returns 409 DUPLICATE_INVOLVEMENT_ID; the comparison ignores case.
vehicleIdCanonical Vehicle id. Optional: link a Vehicle only when you know it. An id that names no Vehicle returns 422 NATURAL_KEY_NOT_FOUND. A reported plate or VIN never sets it. Immutable after create.
platePlate number as reported. Stored on the involvement and returned on read.
plateStateIssuing state for the plate, as reported. A state outside the supported list returns 400 INVARIANT_VIOLATION naming plateState.
vinVehicle identification number as reported, stored as free text. Not unique on the involvement, and never links a Vehicle.
makeVehicle make as reported.
modelVehicle model as reported.
yearVehicle model year as reported, carried as a string.
colorVehicle color as reported.
styleVehicle body style as reported.
descriptionFree-text description of the vehicle.
externalIdSource-system identifier for the vehicle. The default involvement has no column for it, so a value sent on write is rejected with 400 INVARIANT_VIOLATION unless the org maps it.
notesCase-side mutable context for the junction.
Read-only preview of the referenced Vehicle. Returned as null when no Vehicle is linked, or when the underlying Vehicle is deleted, archived, or FLS-stripped.
VehiclePreviewDto
plateplateStatePlate issuing-state code (e.g. CA).
makemodelyearVehicle model year, carried as a string.
colorCaseItemDto
idSalesforce record id of the Case_Item__c junction row, assigned by Salesforce on insert. Null on POST cascade entry (new junction). Differs from involvementId, which the caller mints.
involvementIdCaller-minted identifier of this involvement (for example a UUID v4), reused unchanged on retry. At most 36 characters for a new or changed value; a value already stored on the case item is accepted unchanged whatever its length, and returned on every read. Immutable after create: an update that sends a different value for a stored involvement returns 400 IMMUTABLE_FIELD; a value that differs only in case is the same value, and the stored spelling is kept. A value already held by another involvement, on this case or any other, or repeated inside one request, returns 409 DUPLICATE_INVOLVEMENT_ID; the comparison ignores case.
itemIdCanonical Item id. Optional: on a new case item a sku that matches exactly one Item sets it for you; a stored case item is never linked by SKU. An id that names no Item returns 422 NATURAL_KEY_NOT_FOUND, and on a new case item an id and a sku that name different Items return 400 INVARIANT_VIOLATION. Immutable after create.
skuSKU as the incident reported it, stored as sent. Optional but encouraged. Matched against the Item catalog exactly after trimming and ignoring case, on SKU only and not UPC; on a new case item one match links that Item, no match or several leave the row unlinked, and a stored case item is never matched.
quantityQuantity of items involved in the incident.
conditionRecovery Status of the item: recovered, damaged or not recovered. Open-set: the org stores the value its value mapping gives each, and a value no row maps is stored and read back as sent.
valueAtIncidentAssessed value of the item at the time of the incident.
categoryItem category (e.g. Electronics, Apparel, Grocery). Open-set — not enumerated.
notesCase-side mutable context for the junction.
upcUniversal Product Code for the involved item.
serialNumberSerial number of the involved item.
unitTypeUnit type of the involved item (e.g. Each, Pair, Case).
itemNameName of the item as the incident reported it. Stored on the case item as sent.
merchandiseCategoryMerchandise category as reported. Any text is accepted, subject to any restriction the org places on the picklist.
merchandiseTypeMerchandise type as reported. Any text is accepted, subject to any restriction the org places on the picklist.
brandBrand as reported, free text.
departmentDepartment the item belongs to, as stored. Open-set: not enumerated.
stockNumberStock number the retailer assigns the item, stored as sent.
unitCostCost of one unit to the retailer.
totalPriceTotal price of the line, calculated by the platform. Returned on a load and ignored on writes.
totalCostTotal cost of the line, calculated by the platform. Returned on a load and ignored on writes.
attributedToSalesforce id of a saved involved person on this case that the item is attributed to. To name a person reported in the same request, send attributedToInvolvementId instead. An id that is not an involved person on this case is refused with 400 INVARIANT_VIOLATION. Removing the attributed person from the case, by detaching it or by a PUT that leaves it out and omits caseItems, clears the attribution. To change or clear an attribution, change or clear both attributedTo and attributedToInvolvementId: clearing only attributedTo while sending the loaded attributedToInvolvementId keeps the attribution.
attributedToInvolvementIdThe involvementId of the involved person the item is attributed to, whether that person is in the same request or already on the case. It is resolved to attributedTo when the case is saved, in the same all-or-nothing save as the persons. A value that no involved person on this case holds is refused with 400 INVARIANT_VIOLATION. When attributedTo is also sent, both must name the same person or the request is refused with 400 INVARIANT_VIOLATION. A loaded case returns both attributedTo and attributedToInvolvementId for an attributed item. To change or clear an attribution, change or clear both fields: clearing only attributedTo while sending the loaded attributedToInvolvementId keeps the attribution, and repointing attributedTo while sending the old attributedToInvolvementId is refused.
Read-only preview of the referenced Item. Returned as null when the underlying Item is deleted, archived, or FLS-stripped.
ItemPreviewDto
nameItem display name.
skuStock-keeping unit identifier.
categoryItem category.
FieldSpec
nameDomain property name (e.g. narrative).
labelDisplay label.
typeField type (e.g. string, boolean, date, picklist, reference).
requiredreadOnlyPopulated by theft and person. Null for vehicle, item, and location.
createablePopulated by vehicle, item, and location. Null for theft and person.
updateablePopulated by vehicle, item, and location. Null for theft and person.
sectionreferenceToFor reference fields, the related SObject API name.
Structured picklist options.
Dependent-picklist option sets keyed by controlling value (theft only).
controllingFieldNamelayoutHintFieldSpecOption
labelDisplay label. Equal to value.
valueThe org value to send for the field. For an Incident Type it is the value to send as incidentType.
keyThe domain key the value belongs to. Several values may share one key, such as Robbery-Armed and Robbery-Unarmed for robbery. Null when the value maps to no key, and on options listed from a picklist field no value mapping row covers.
TheftEnvelope
The theft case body.
Field specifications for the case's classification context, including the incidentTypeKey picklist described on /theft-cases/field-specs
derivedKeysKeys of detail derived from another field (incidentTypeKey from incidentType, locationNumber from primaryLocationId). A client that sends detail back on a PUT leaves them out, so a stale copy cannot contradict an edit to the field it was derived from.
CustomPropertySpec
keyDomain property key. Never a Salesforce field API name.
labelMapping label, or the field label when the mapping label is blank.
typeField type from the describe, using the same words as fieldSpecs.
requiredTrue when POST /theft-cases must send a value.
Picklist options from the field describe, when the field has them.
StandardError
codeMachine-readable error code
messageHuman-readable error message
idPresent with DUPLICATE_UUID on a POST: the id of the case that already holds the uuid
fieldPresent with NATURAL_KEY_NOT_FOUND, NATURAL_KEY_AMBIGUOUS, INCIDENT_TYPE_NOT_MAPPED and the CUSTOM_PROPERTY_* codes: the request field whose value did not resolve (locationNumber, employeeNumber, employeeId, externalId, personId, vehicleId, vin, plate, itemId, sku or incidentTypeKey), or the custom property key that failed. Custom property refusals do not include value.
valuePresent with NATURAL_KEY_NOT_FOUND and NATURAL_KEY_AMBIGUOUS: the value that did not resolve, as the caller sent it
idsPresent with NATURAL_KEY_AMBIGUOUS: the ids of the records the key matches, for Salesforce-side callers. A caller outside Salesforce settles the ambiguity with a more specific natural key.