This documentation is currently under development. Certain sections are not yet complete and will be added shortly.
Ctrlk
HomeDocumentation
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Cegid Retail Y2 APIs

Overview of the Cegid Retail Y2 web services and business notifications used by The Wallet Crew connector.

This page lists the Cegid Retail Y2 services used by The Wallet Crew connector. It explains what each service does, why it matters, and which methods are called.

For connector setup, see Connect with Cegid Retail Y2. For customer field synchronization, see Cegid Retail Y2 fields mapping.

At a glance

The Wallet Crew connects to Cegid Retail Y2 in real time through APIs and business notifications. Each service supports a specific wallet use case.

  • Customer supports profile search, creation, update, and consent management. It is used to expose customer data in wallet journeys.

  • Cash Operations exposes available vouchers and gift cards. It is used to display wallet benefits and stored value.

  • Loyalty supports loyalty card creation and loyalty data retrieval, such as card details or points.

  • Sale Documents exposes receipts and sales documents. It is used for receipt display and click-and-collect related journeys.

  • Business Notifications sends events related to loyalty, purchase, or order activity. It is used to refresh wallet data and trigger push notifications in real time.

Real-world examples

  • A brand creates or updates a customer from an enrolment form. The Wallet Crew writes the profile back to Cegid Retail Y2.

  • A loyalty card is created in Cegid Retail Y2, then displayed in Apple Wallet or Google Wallet with current balances or benefits.

  • A recent purchase triggers receipt retrieval or PDF generation, so the document can be exposed in a wallet journey.

How the integration works

The Wallet Crew uses two integration patterns with Cegid Retail Y2. Web service calls retrieve or update data on demand. Business notifications signal events that should trigger a refresh or a wallet notification.

In practice, customer and loyalty services support enrolment and card lifecycle. Cash operation and sales document services expose benefits and transaction data. The sales report endpoint generates receipt PDFs when a document file is needed.

Services used by The Wallet Crew

Customer

The customer service supports profile lookup, creation, update, and consent synchronization. It is the foundation for account-linked wallet journeys.

Endpoint: CustomerWcfService.svc

Methods used

  • SearchCustomerIds searches customer records, typically by email.

  • UpdateCustomer updates an existing customer profile.

  • AddNewCustomer creates a new customer in Cegid Retail Y2.

Cash Operations

The cash operations service exposes vouchers and gift cards attached to a customer. This makes stored value or available benefits available to wallet experiences.

Endpoint: CashOperationsWcfService.svc

Methods used

  • GetCustomerAvailableBons retrieves available vouchers or gift cards for a customer.

Loyalty

The loyalty services manage loyalty cards and program data. They are used to create cards, retrieve card details, and determine which programs are available.

Endpoints: LoyaltyWcfService.svc and LoyaltyEngineLoyaltyEngineService.svc

Methods used

  • GetCustomerCards returns loyalty cards linked to a customer.

  • GetLoyaltyCard returns the details of a specific loyalty card.

  • CreateLoyaltyCard creates a new loyalty card in Cegid Retail Y2.

  • GetCardCreationActiveProgramsOnStore returns the loyalty programs available for a store.

Sale Documents

The sale document service provides access to transaction records. It is used for wallet use cases that depend on receipts or click-and-collect related documents.

Endpoint: SaleDocumentService.svc

Methods used

  • GetByKey retrieves a specific sales document by key.

  • GetHeaderList retrieves a list of recent sales documents.

Sales Report

The sales report service generates a receipt PDF. It is used when a rendered document is needed instead of raw sale document data.

Endpoint: SalesExternalReport (REST)

Receipt PDF generation flow

The receipt flow has three steps. First, generatedocument starts the PDF generation. Then poll checks whether the file is ready. Finally, download retrieves the generated PDF.

Methods used

  • generatedocument starts a new PDF generation.

  • poll checks whether the PDF is available.

  • download downloads the generated PDF.

Employee

The employee service retrieves store staff data. It is mainly used when a wallet layout needs to display an advisor or salesperson.

Endpoint: EmployeeSalespersonsService.svc

Methods used

  • GetListDetail returns the list of advisors for a store.

Business Notifications

Business notifications keep wallet data fresh without waiting for a manual refresh. They let The Wallet Crew react to events such as loyalty updates, purchases, or orders.

Endpoint: BusinessNotificationSubscriptionService.svc

Methods used

  • GetActive lists active subscriptions.

  • Update updates an existing subscription.

  • Create creates a new subscription.

  • Delete removes an existing subscription.

Why these APIs matter

Together, these services let The Wallet Crew keep customer profiles, loyalty data, benefits, and transaction records aligned with Cegid Retail Y2. That alignment is what makes wallet passes feel current, reliable, and operationally useful.

FAQ

Does the connector rely only on notifications?

No. The connector uses direct API calls to read and write data, and business notifications to react to events in near real time.

Which service is used for vouchers and gift cards?

CashOperationsWcfService.svc is used for that purpose through GetCustomerAvailableBons.

Which service generates receipt PDFs?

SalesExternalReport generates the PDF. SaleDocumentService.svc is used separately to retrieve sale document data and document lists.

Last updated