The Vue Storefront Essentials Course is now available! Learn More
Customer normalizer

Customer normalizer

The normalizeCustomer function is used to map a SAP User into the unified SfCustomer data model.


NameTypeDefault valueDescription
userUserSAP User


The SfCustomer model is returned from Unified Methods such as RegisterCustomer, LoginCustomer and GetCustomer. If the SfCustomer structure doesn't contain the information you need for your Storefront, you can extend its logic using the defineNormalizers function. The following example demonstrates how to extend SfCustomer with a country field.

import { normalizers as normalizersSAP, defineNormalizers } from "@vsf-enterprise/unified-api-sapcc";

const normalizers = defineNormalizers<typeof normalizersSAP>()({
  normalizeCustomer: (user) => ({
    country: user.defaultAddress?.country,


SAP User have some fields optional on the interface, but in the reality a valid User should contain a customerId, uid, firstName, and lastName, so if any of these information is missing, normalizer returns an error.

import { User } from "@vsf-enterprise/sapcc-types";
import { SfCustomer } from "@vue-storefront/unified-data-model";

export function normalizeCustomer(user: User): SfCustomer {
  if (!user.customerId || !user.uid || !user.firstName || !user.lastName) {
    throw new Error("Missing required fields for customer");

  return {
    id: user.customerId,
    firstName: user.firstName,
    lastName: user.lastName,
    email: user.uid,