---
title: "customer"

doc_type: static
doc_category: static
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/sline/object/customer'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/sline/object/customer.md'
---

# customer


    商店的 <a target="__blank" href="https://help.shopline.com/hc/zh-cn/articles/13669181757849-%E7%AE%A1%E7%90%86%E5%AE%A2%E6%88%B7">客户</a>。当客户登录其账户后，可以在全局范围内直接访问 customer object。若客户未登录，该对象仅在以下模板上下文中定义：
          
- 模板 [customers/account](https://developer.shopline.com/zh-hans-cn/docs/online-store-3-0-themes/theme-structure/templates.md#kwgVv)
- 模板 [customers/addresses](https://developer.shopline.com/zh-hans-cn/docs/online-store-3-0-themes/theme-structure/templates.md#kwgVv)
- 模板 [customers/order](https://developer.shopline.com/zh-hans-cn/docs/online-store-3-0-themes/theme-structure/templates.md#kwgVv)

在上述情况之外，如果客户未登录或对应的上下文不存在，则 customer object 返回 `nil`。

#### 检查 customer object 是否存在
无法确定 customer object 是否存在的模板或对象中时，在使用前应先检查该对象是否存在。

```js
{{#if customer }}
  Hello, {{ customer.first_name }}!
{{/if}}
```

    



## 属性

    <div>
    

        
<ObjectProperty
    name="accepts_email_marketing"
    types={[<Mdx>boolean</Mdx>]}
>
<ObjectSummary>
客户是否订阅了营销电子邮件。
- `true`：已订阅
- `false`：未订阅


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="accepts_sms_marketing"
    types={[<Mdx>boolean</Mdx>]}
>
<ObjectSummary>
客户是否订阅了营销短信。
- `true`：已订阅
- `false`：未订阅


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="addresses"
    types={[<Mdx>array of [address](https://developer.shopline.com/zh-hans-cn/docs/sline/object/address.md)</Mdx>]}
>
<ObjectSummary>
客户的所有个人收货地址，最多包含 50 条。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="addresses_count"
    types={[<Mdx>integer</Mdx>]}
>
<ObjectSummary>
客户的个人收货地址数量。

取值范围：0-50


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="b2b"
    types={[<Mdx>boolean</Mdx>]}
>
<ObjectSummary>
客户是否为 B2B 客户。
- `true`：是 B2B 客户
- `false`：非 B2B 客户

要了解 B2B 功能，参考 [B2B 公司](https://help.shopline.com/hc/zh-cn/articles/21925057806745)。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="company_available_locations"
    types={[<Mdx>array of [company_location](https://developer.shopline.com/zh-hans-cn/docs/sline/object/company-location.md)</Mdx>]}
>
<ObjectSummary>
客户可访问的公司地点列表。

要了解 B2B 功能，参考 [B2B 公司](https://help.shopline.com/hc/zh-cn/articles/21925057806745)。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="current_company"
    types={[<Mdx>[company](https://developer.shopline.com/zh-hans-cn/docs/sline/object/company.md)</Mdx>]}
>
<ObjectSummary>
客户当前选定的公司信息。

要了解 B2B 功能，参考 [B2B 公司](https://help.shopline.com/hc/zh-cn/articles/21925057806745)。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="current_location"
    types={[<Mdx>[company_location](https://developer.shopline.com/zh-hans-cn/docs/sline/object/company-location.md)</Mdx>]}
>
<ObjectSummary>
客户当前选定的公司地点。

要了解 B2B 功能，参考 [B2B 公司](https://help.shopline.com/hc/zh-cn/articles/21925057806745)。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="cancelling_account"
    types={[<Mdx>boolean</Mdx>]}
>
<ObjectSummary>
客户是否申请了删除账号。
- `true`：已申请
- `false`：未申请


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="cancelling_time"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
客户账号将被删除的时间戳。可以使用 [date](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/date.md) filter 转换时间格式。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="default_address"
    types={[<Mdx>[address](https://developer.shopline.com/zh-hans-cn/docs/sline/object/address.md)</Mdx>]}
>
<ObjectSummary>
客户的默认个人收货地址。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="email"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
客户的电子邮箱。未设置时返回 `nil`。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="first_name"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
客户的名字。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="last_name"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
客户的姓氏。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="login_sources"
    types={[<Mdx>array of [login_source](https://developer.shopline.com/zh-hans-cn/docs/sline/object/login-source.md)</Mdx>]}
>
<ObjectSummary>
客户绑定的第三方账号信息。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="has_account"
    types={[<Mdx>boolean</Mdx>]}
>
<ObjectSummary>
客户在结账时使用的电子邮箱是否与 [客户帐户](https://help.shopline.com/hc/zh-cn/articles/21705361544985-%E5%AE%A2%E6%88%B7%E8%B4%A6%E6%88%B7
) 绑定。

- `true`：该邮箱关联了一个已存在的客户账户。
- `false`：该邮箱未在商店注册账号。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="id"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
客户的 ID。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="name"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
客户的姓名。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="orders"
    types={[<Mdx>array of [order](https://developer.shopline.com/zh-hans-cn/docs/sline/object/order.md)</Mdx>]}
>
<ObjectSummary>
客户的订单列表。

默认显示最新 10 条数据，可以通过 [get_pagination](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/get-pagination.md) filter 设置每页显示数量。
</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="orders_count"
    types={[<Mdx>integer</Mdx>]}
>
<ObjectSummary>
客户的订单总数。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="phone"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
客户的手机号。未设置时返回 `nil`。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="phone_dialing_code"
    types={[<Mdx>string</Mdx>]}
>
<ObjectSummary>
客户的手机区号。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="tags"
    types={[<Mdx>array of string</Mdx>]}
>
<ObjectSummary>
客户的标签列表。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="tax_exempt"
    types={[<Mdx>boolean</Mdx>]}
>
<ObjectSummary>
客户是否免税。
- `true`：免税
- `false`：不免税


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="total_spent"
    types={[<Mdx>float</Mdx>]}
>
<ObjectSummary>
客户当前所有订单的总花费金额。可以配合 [money](https://developer.shopline.com/zh-hans-cn/docs/sline/filter/money.md) filter 格式化金额。


</ObjectSummary>
</ObjectProperty>
        
<ObjectProperty
    name="accepts_marketing"
    types={[<Mdx>boolean</Mdx>]}
>
<ObjectSummary>
客户是否接受营销。
- `true`：接受
- `false`：不接受


</ObjectSummary>
</ObjectProperty>
        
    
    </div>


