Summary
This mapping collection brings NCR Counterpoint users into iPaaS.com as employees. A user iPaaS.com does not yet hold is added; a user it already holds is updated. It carries the user's name, split into its given and family parts, and an e-mail address for them.
Deleted Record Support
This family does not itself carry deletions. Where a separate Delete collection exists for this entity it handles removals from Counterpoint to iPaaS.com; otherwise a removal in Counterpoint is not propagated. See NCR Counterpoint Known Limitations.
Mapping Collection Status
Status: Enabled. No mapping filter is applied.
Trigger Events: see Transfer Methods in the collection description; automatic transfers require the relevant Outbound/Inbound Data Flow subscriptions to be enabled.
Supported Child Collections
Add/Update NCR Counterpoint User Address TO iPaaS.com: carries the user's address and phone details as part of the user's transfer. NCR Counterpoint holds those details on the user record itself rather than as a separate address record, so they transfer with the user and not independently of them.
System Caveats
NCR Counterpoint Caveats
Counterpoint holds one combined name, iPaaS.com holds two: NCR Counterpoint records a user's name as a single value rather than as separate given and family names, so this collection splits it on the last space. A user recorded as a single word transfers as a first name with no last name, which iPaaS.com accepts. The split is a starting point rather than a parsing rule that fits every name — a user recorded as "Mary Anne Smith" transfers as first name "Mary Anne" and last name "Smith", and a user recorded as "Juan Carlos de la Cruz" transfers as first name "Juan Carlos de la" and last name "Cruz". Subscribers or their MiSP whose Counterpoint users follow a different naming convention should adjust the two name mappings together, so that they stay consistent with each other — editing only one of them either duplicates part of the name across both fields or drops part of it entirely.
An e-mail address is not required on a Counterpoint user: Counterpoint permits the field to be empty, which is why the fallback below exists.
iPaaS.com Caveats
A user with no e-mail address transfers with their name in its place: iPaaS.com requires an e-mail address on every employee and NCR Counterpoint does not require one on a user, so this collection is shipped with a fallback that supplies the user's combined name when no address is recorded. The fallback is deliberate — it is what allows users to transfer at all from a system that does not require the field — but a user with no address in Counterpoint therefore arrives in iPaaS.com with a name where an e-mail address is expected. The transfer succeeds, but the resulting value is not a working address and is not suitable for sending mail to. iPaaS.com also expects employee e-mail addresses to distinguish one employee from another, so two Counterpoint users who both lack an address and happen to share the same name produce the same value. Subscribers who want genuine addresses on their iPaaS.com employees should populate the e-mail address against the user in NCR Counterpoint before the transfer runs, rather than relying on the fallback.
Integration Flow
No records are transferred as prerequisites for this collection. The records it references are expected to exist already.
The record is sent to iPaaS.com, where subsequent transfers are routed by the external ID recorded on transfer.
Child records transfer as part of the same transfer — the collections listed under Supported Child Collections above.
Mappings
Add/Update NCR Counterpoint User TO iPaaS.com
Mapping Type | Source Field (NCR Counterpoint) | Destination Field (iPaaS.com) | Description |
Dynamic Formula |
| FirstName | See detail. This is a conditionally required field. |
Dynamic Formula |
| LastName | See detail. This is a conditionally required field. |
Dynamic Formula |
| EmailAddress | Required. IPaaS.com rejects the employee without it, and will not accept a null or empty value. |
FirstName — Dynamic Formula
Source:
if (NAM.Contains(" ")) { return NAM.Substring(0, NAM.LastIndexOf(" "));}
else {return NAM;}Destination: FirstName
This is a conditionally required field. iPaaS.com requires that at least one of FirstName or LastName is supplied, and rejects the employee if both are missing. NCR Counterpoint holds a user's name as a single combined value rather than as separate given and family names, so this mapping splits it. The formula looks for a space in the combined name. If it finds one, it returns everything before the last space. If the name contains no space at all, it returns the whole name unchanged.
Because NCR Counterpoint always populates the user name, this mapping always produces a value, and it is what satisfies the requirement that at least one name field is present. A single-word name therefore transfers as a first name with no last name, which iPaaS.com accepts.
Splitting on the last space is a starting point, not a parsing rule that fits every name. A user recorded as "Mary Anne Smith" transfers as first name "Mary Anne" and last name "Smith"; a user recorded as "Juan Carlos de la Cruz" transfers as first name "Juan Carlos de la" and last name "Cruz". Subscribers or their MiSP whose Counterpoint users follow a different naming convention should adjust this formula and the LastName formula together, so that the two stay consistent with each other.
NCR Counterpoint stores the combined name as text of up to 40 characters and always supplies it. Subscribers replacing this mapping with a different formula are not held to that length by iPaaS.com.
LastName — Dynamic Formula
Source:
if (NAM.Contains(" ")) { return NAM.Substring(NAM.LastIndexOf(" ") + 1);}
else {return "";}Destination: LastName
This is a conditionally required field. iPaaS.com requires that at least one of FirstName or LastName is supplied. This mapping is the second half of the name split described under FirstName, and it is not independently required, because FirstName always produces a value.
The formula looks for a space in the combined NCR Counterpoint user name. If it finds one, it returns everything after the last space. If the name contains no space, it returns an empty value, and the employee transfers with a first name only.
Subscribers or their MiSP changing this formula should change the FirstName formula in the same collection at the same time. The two divide one Counterpoint value between them, and editing only one of them either duplicates part of the name across both fields or drops part of it entirely.
EmailAddress — Dynamic Formula
Source: if ( IsEmpty(EMAIL_ADRS_1)) { return NAM;} else { return EMAIL_ADRS_1;} · Destination: EmailAddress
This is a required field — iPaaS.com rejects the employee without it, and will not accept a null or empty value. This is the difference this mapping exists to bridge: iPaaS.com requires an email address on every employee, and NCR Counterpoint does not require one on a user.
The formula reads the user's first email address. When NCR Counterpoint holds one, it is passed through unchanged. When the user has no email address recorded, the formula falls back to the user's combined name so that the required field is populated and the transfer succeeds.
Subscribers and their MiSP should understand what that fallback means in practice. A user with no email address in NCR Counterpoint arrives in iPaaS.com with a name where an email address is expected. The transfer succeeds, but the resulting value is not a working address and is not suitable for sending mail to. iPaaS.com also expects employee email addresses to distinguish one employee from another, so two Counterpoint users who both lack an email address and happen to share the same name produce the same value here.
The fallback is deliberate — it is what allows users to transfer at all from a system that does not require the field. Subscribers who want genuine addresses on their iPaaS.com employees should populate the email address against the user in NCR Counterpoint before the transfer runs, rather than relying on the fallback. Subscribers who would rather a user without an email address not transfer at all can add a collection filter to exclude them.
NCR Counterpoint stores the email address as text of up to 50 characters and permits it to be empty.
Add/Update NCR Counterpoint User Address TO iPaaS.com
Parent: Add/Update NCR Counterpoint User TO iPaaS.com.
Mapping Type | Source Field (NCR Counterpoint) | Destination Field (iPaaS.com) | Description |
Dynamic Formula |
| Name | Optional. . |
Dynamic Formula |
| Address1 | Optional. . |
Dynamic Formula |
| Address2 | Optional. . |
Dynamic Formula |
| Address3 | Optional. . |
Dynamic Formula |
| City | Optional. . |
Dynamic Formula |
| Country | Optional. . |
Dynamic Formula |
| Region | Optional. . |
Dynamic Formula |
| PostalCode | Optional. . |
Dynamic Formula |
| PhoneNumber | Optional. . |
Name — Dynamic Formula
Source: Parent.NAM · Destination: Name
This is an optional field. The name recorded against the address, which iPaaS.com uses to label the address rather than to identify the employee.
NCR Counterpoint does not keep addresses as separate records the way iPaaS.com does. The address fields live directly on the user record itself, so every mapping in this collection reads from the parent user rather than from an address record of its own. That is why each formula in this collection is prefixed with Parent — there is no separate address row in Counterpoint to read from. It also means this collection only produces an address as part of a transfer of the user that owns it; it does not run independently.
Because Counterpoint has no distinct name for the address, this mapping reuses the user's own combined name. NCR Counterpoint stores that name as text of up to 40 characters and always supplies it, so this field always arrives populated.
Address1 — Dynamic Formula
Source: Parent.ADRS_1 · Destination: Address1
This is an optional field. The first line of the user's address as recorded in NCR Counterpoint, carried across unchanged. NCR Counterpoint stores this as text of up to 40 characters and permits it to be empty. Where the user has no address line recorded, the field transfers empty and the employee address is still created.
Address2 — Dynamic Formula
Source: Parent.ADRS_2 · Destination: Address2
This is an optional field. The second line of the user's address as recorded in NCR Counterpoint, carried across unchanged. NCR Counterpoint stores this as text of up to 40 characters and permits it to be empty. Most user records leave it empty, and that is not an error.
Address3 — Dynamic Formula
Source: Parent.ADRS_3 · Destination: Address3
This is an optional field. The third line of the user's address as recorded in NCR Counterpoint, carried across unchanged. NCR Counterpoint stores this as text of up to 40 characters and permits it to be empty. Most user records leave it empty, and that is not an error.
City — Dynamic Formula
Source: Parent.CITY · Destination: City
This is an optional field. The city recorded against the user in NCR Counterpoint, carried across unchanged. NCR Counterpoint stores this as text of up to 20 characters and permits it to be empty.
Country — Dynamic Formula
Source: Parent.CNTRY · Destination: Country
This is an optional field. The country recorded against the user in NCR Counterpoint, carried across unchanged. iPaaS.com does not constrain this field to a fixed list of country names or codes on employee addresses, so whatever NCR Counterpoint holds is what arrives — the value is not normalized in transit. Subscribers whose Counterpoint users record country inconsistently, or who need a specific format such as a two-letter code, should replace this mapping with a Lookup Translation or a formula that produces the form they need. NCR Counterpoint stores this as text of up to 20 characters and permits it to be empty.
Region — Dynamic Formula
Source: Parent.STATE · Destination: Region
This is an optional field. The state or province recorded against the user in NCR Counterpoint. iPaaS.com calls this Region because it accommodates states, provinces, and other sub-national divisions; NCR Counterpoint records it as a state. The value is carried across unchanged and is not normalized in transit. NCR Counterpoint stores this as text of up to 10 characters and permits it to be empty.
PostalCode — Dynamic Formula
Source: Parent.ZIP_COD · Destination: PostalCode
This is an optional field. The postal or ZIP code recorded against the user in NCR Counterpoint, carried across unchanged. NCR Counterpoint stores this as text of up to 15 characters and permits it to be empty, and it accepts both five-digit and extended ZIP formats as well as non-US postal codes. Whatever is held is what transfers.
The formula for this mapping begins with a leading tab character before the value it reads. The tab is insignificant to how the formula evaluates — the mapping resolves to the parent user's postal code exactly as if the tab were not there — and it does not need to be removed for the mapping to work correctly.
PhoneNumber — Dynamic Formula
Source: Parent.PHONE_1 · Destination: PhoneNumber
This is an optional field. The first phone number recorded against the user in NCR Counterpoint, carried across unchanged. iPaaS.com does not impose a format on employee address phone numbers, so the value arrives in whatever form Counterpoint holds it, including any punctuation or extension text. Subscribers who need a consistent format across systems should replace this mapping with a formula that produces it.
Error Handling
Errors raised while transferring these records surface at Dashboard / Integration Monitoring / Error Logs. The specific messages, their causes and their resolutions are documented in NCR Counterpoint Error Messages. A record stopped by an error is not retried automatically; it must be resolved manually.
Testing & Validation
Replace every placeholder value called out above with one from the target Counterpoint installation, and confirm each exists in Counterpoint.
Transfer a single record through Manual Sync and confirm it appears in Counterpoint as expected.
Confirm any child records transferred with the parent.
Enable the relevant triggers and confirm a new record transfers automatically, and that a change updates the same Counterpoint record rather than creating a second one.
Attempt a transfer with a missing required field and confirm the expected error appears at Dashboard / Integration Monitoring / Error Logs.
Additional Notes
Users transfer only on demand until the trigger is installed: at the time this documentation was written, the user trigger subscriptions are not created by default. Until that Counterpoint-side installation step has been carried out and the subscriptions enabled, every transfer of a user is a Manual Sync, and the same applies to the user's address, which transfers as part of the user. Subscribers or their MiSP who rely on iPaaS.com employees being current should either carry out that step or treat keeping them current as a manual task, and should be aware that until then a user's details can be changed in Counterpoint without iPaaS.com being told.
These and other runtime behaviors are documented in NCR Counterpoint Known Limitations.
Related Documents
NCR Counterpoint Connections and Settings: the credentials and subscription settings that connect iPaaS.com to Counterpoint.
NCR Counterpoint Installation Instructions: installing CPHive and CPWebhooks on the Counterpoint server.
NCR Counterpoint Known Limitations: what the integration does not do, and the values to replace before go-live.
NCR Counterpoint Error Messages: the errors a transfer can raise, what causes them, and how to resolve them.
NCR Counterpoint API Endpoints: the CPHive endpoints the integration calls.
