Skip to main content

NCR Counterpoint to iPaaS.com Location Group Mapping Documentation

Field-level mapping documentation for the NCR Counterpoint Location Group collections.

Summary

This mapping collection brings the location groups maintained in NCR Counterpoint into iPaaS.com. It carries the group's own identifier, its readable description, and the list of locations belonging to it.

Deleted Record Support

Deletions are carried by the Delete NCR Counterpoint Location Group TO iPaaS.com collection: when the record is removed in Counterpoint, that collection sends the removal to iPaaS.com. Whether the removal transfers automatically depends on the delete trigger event being available; where it is not, the collection runs through Manual Sync. 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.

Duplicate or Conflicting Mappings

  • Delete NCR Counterpoint Location Group TO iPaaS.com: removes a location group from iPaaS.com that this collection has already transferred.

Important: these two collections operate on the same entity and share the same trigger set. They are complementary rather than alternatives — this collection establishes and maintains the group, the other removes it — so both are normally enabled together. Subscribers or their MiSP should review both collections before enabling either, and should treat NCR Counterpoint as the source of truth for location group membership if these groups are also maintained in another connected system.

System Caveats

NCR Counterpoint Caveats

  • Descriptions arrive populated and short: Counterpoint holds the group description as text of up to 30 characters and requires it to be populated, so a description always arrives and is never longer than 30 characters. Subscribers replacing this mapping with a formula are not held to that limit by iPaaS.com, but should keep results short enough to stay readable alongside descriptions that came straight from Counterpoint.

iPaaS.com Caveats

  • Locations must transfer before groups for membership to resolve: a member location that has not been transferred is left out of the list rather than causing an error, and the group transfers with the remaining members only. No message is raised against the group, so a partially populated group looks the same as a complete one, and this mapping does not transfer missing locations on its own. Subscribers or their MiSP should therefore transfer locations first — Add/Update NCR Counterpoint Location TO iPaaS.com handles those. Where a group has already transferred with members missing, re-running the group once its locations have landed sends the membership again with those locations resolved. Subscribers should confirm in a staging environment that the resulting membership matches Counterpoint before relying on it in production.

Integration Flow

  1. No records are transferred as prerequisites for this collection. The records it references are expected to exist already.

  2. The record is sent to iPaaS.com, where subsequent transfers are routed by the external ID recorded on transfer.

Mappings

Add/Update NCR Counterpoint Location Group TO iPaaS.com

Mapping Type

Source Field (NCR Counterpoint)

Destination Field (iPaaS.com)

Description

Field

LOC_GRP_ID

Name

Required. IPaaS.com rejects the location group without it.

Field

DESCR

Description

Optional. .

Dynamic Formula

return await ConvertLocationGroupLocationsToiPaaSLocationListAsync(Locations);

Locations

Recommended. .

Name — Field

Source: LOC_GRP_ID · Destination: Name

This is a required field — iPaaS.com rejects the location group without it. The location group's own identifier in NCR Counterpoint, carried across unchanged and used as the group's name in iPaaS.com.

This is the code subscribers or their MiSP see against the group in Counterpoint, not a longer label — the readable label travels on Description. Counterpoint always supplies it, because it is the group's key.

Description — Field

Source: DESCR · Destination: Description

This is an optional field. The location group's readable description as maintained in NCR Counterpoint, carried across unchanged.

Counterpoint stores this as text of up to 30 characters and requires it to be populated, so a description always arrives and is never longer than 30 characters. Subscribers replacing this mapping with a formula are not held to that limit by iPaaS.com, but should keep results short enough to stay readable alongside descriptions that came straight from Counterpoint.

Locations — Dynamic Formula

Source: return await ConvertLocationGroupLocationsToiPaaSLocationListAsync(Locations); · Destination: Locations

This is a recommended field. iPaaS.com accepts the group without it, but a location group with no member locations conveys nothing beyond its name, so it should be mapped for any meaningful location group sync.

Populates the group's membership. The formula walks the locations NCR Counterpoint reports as belonging to this group and, for each one, looks up the matching location already transferred into iPaaS.com. It returns the list of those iPaaS.com locations, which iPaaS.com attaches to the group.

The important behavior is what happens to a member that has not been transferred: it is left out of the list rather than causing an error, and the group transfers with the remaining members only. No message is raised against the group, so a partially populated group looks the same as a complete one. This mapping does not transfer missing locations on its own.

Subscribers or their MiSP should therefore transfer locations before location groups — the Add/Update NCR Counterpoint Location TO iPaaS.com collection handles those. Where a group has already transferred with members missing, re-running the group once its locations have landed sends the membership again with those locations resolved. Subscribers should confirm in a staging environment that the resulting membership matches Counterpoint before relying on it in production.

Delete NCR Counterpoint Location Group TO iPaaS.com

This collection carries no mapped fields. iPaaS.com matches the record by the external ID recorded when it first transferred, so a removal needs no field mapping.

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

  1. Replace every placeholder value called out above with one from the target Counterpoint installation, and confirm each exists in Counterpoint.

  2. Transfer a single record through Manual Sync and confirm it appears in Counterpoint as expected.

  3. Confirm any child records transferred with the parent.

  4. 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.

  5. Attempt a transfer with a missing required field and confirm the expected error appears at Dashboard / Integration Monitoring / Error Logs.


Related Documents

Did this answer your question?