ShanghaiChangyun
Talk to Sales

Installation Guide

An administrator can install and configure the App in about 10 minutes. The App's interface is in Simplified Chinese; the Chinese names you will see on screen are given in brackets.

For version 1.1

Before you start

  • Salesforce Enterprise, Unlimited, Performance or Developer Edition with Lightning Experience enabled
  • System administrator permissions for the person installing
  • The App's interface is in Simplified Chinese

Step 1: Install

  1. 1 Click Get It Now on the App's AppExchange listing and choose a production org or a sandbox. If you need a direct installation link, contact us.
  2. 2 Choose Install for Admins Only (recommended; grant access to others with permission sets afterwards).
  3. 3 When asked about third-party website access, allow access to api.qichacha.com and continue.
  4. 4 You will receive a confirmation email when installation finishes. A new installation starts a 7-day trial with 20 lookups.

Step 2: Assign permission sets

Setup → Permission Sets: assign the user permission set [工商信息查询 用户] to business users and the admin permission set [工商信息查询 管理员] to administrators (it includes all user permissions).

Step 3: Test the connection

In the App Launcher, open the app [工商信息查询] and its setup page [工商信息配置说明]. Click Test Connection [测试连接], which uses one lookup. A success message [连接正常] confirms the setup; the page also shows this month's usage and limit.

Step 4: Show the Business Registry tab on Accounts

  • Account page not customized: Setup → Object Manager → Account → Lightning Record Pages, open [工商信息客户页面] → Edit → Activation → Assign as Org Default → Save.
  • Account page already customized: open any Account → gear icon → Edit Page, add a tab named [企业工商信息] to the Tabs component, drag in the component [企业工商信息] → Save.

Step 5: Add the Smart New button to the Account list

Setup → Object Manager → Account → List View Button Layout → menu at the right of the List View row → Edit. Under Custom Buttons, move [工商信息智能新建] to Selected Buttons → Save.

Step 6: Configure field mapping (optional)

Open the field mapping page [工商信息字段映射], choose an Account field and a write mode (fill blank fields only, or always overwrite) for each registry value, and save. Custom fields created later also appear, provided the type matches: Text and Text Area fields accept any registry value, Date fields accept only the date of establishment, and Picklist fields accept only the registration status.

We recommend making the App's fields (labels ending in [(工商查询)]) read-only on Account page layouts, so registry data is only updated through the App.

Everyday use

  • Create an Account: click [工商信息智能新建] on the Account list, or search on the [工商信息搜索] page by company name, Unified Social Credit Code or registration number (at least 2 characters), select the company and create the Account. The App checks the Unified Social Credit Code to avoid duplicate Accounts.
  • Link and refresh: use the [企业工商信息] tab on an Account to link a company, or refresh its data with [刷新工商信息].
  • Usage: each search, page of results, refresh and connection test uses one lookup; failed lookups are not counted. The 7-day trial includes 20 lookups; a paid subscription includes 1,000 lookups per org per month, reset on the 1st.

Troubleshooting

SYMPTOMCAUSE AND FIX
No Business Registry tab on AccountsStep 4 not done, or the user has no permission set
No Smart New button on the Account listStep 5 not done
Search unavailable or a permission errorAssign [工商信息查询 用户] or [工商信息查询 管理员] to the user
The lookup limit is used upOn a paid subscription, lookups resume on the 1st of next month; contact us to add more. During the trial, contact us to subscribe
Cannot reach the lookup serviceTry again later; if it persists, send us the full message

Uninstall

Setup → Installed Packages → Uninstall. Uninstalling deletes the App's fields and their data, so export anything you want to keep first.

Support

admin@changyunnetwork.com · +86 180 1712 6135 · Business days 9:00–18:00 Beijing time