Skip to content

Domain: Review

The Review domain manages customer product reviews. Reviews are collected and hosted via the Kiyoh review platform and surfaced in the Zwerfkei storefront.

Responsibilities

  • Triggering review invitations after order delivery.
  • Displaying product and shop reviews sourced from Kiyoh.
  • Storing a local cache of review data for performance.

Entities

Entity Description
Review A customer review for a product or the shop, sourced from Kiyoh. Contains rating, summary text, author (anonymised) and date.

Integrations

Kiyoh

Kiyoh is the external SaaS provider for collecting and hosting customer reviews. The Zwerfkei Backend integrates with the Kiyoh API to:

  • Send review invitation requests after an order is marked as delivered.
  • Retrieve published reviews for display on the storefront.

Reviews are read-only from the Zwerfkei perspective; moderation and management happen within the Kiyoh dashboard.

Business Rules

  • A review invitation is sent to the customer a configurable number of days after the order is marked as delivered.
  • Reviews are fetched from Kiyoh and cached locally to reduce API calls and ensure storefront availability even if Kiyoh is temporarily unreachable.
  • Customer names in displayed reviews are anonymised per Kiyoh defaults (first name + last name initial).