# 在Bukku记录你的销售

> 把Bukku连接到BCL，用自动化把已付款订单记录为销售、创建发票、记录付款、作废销售和添加顾客。
>
> Source: https://docs.bcl.my/zh/bukku/

Bukku是一个线上会计系统。把它连接到BCL，然后在自动化里添加一个**Bukku**步骤。这个步骤可以把每个已付款订单记录为账目里的销售、创建发票、记录付款、作废销售，或添加顾客。

## 连接Bukku

按照以下步骤：

1. 在Bukku打开**Control Panel** → **Integrations**，开启API Access，然后复制**Access Token**。
2. 在BCL前往**Platform Setup** → **Integrations**。点击**Apps**，然后在**Bukku**卡片上点击**Connect**。

   *(Screenshot: Integrations页面上的Bukku卡片，Connect已标示)*

3. 开启**Enable Bukku integration**。
4. 在**Company subdomain**输入你Bukku网址的第一部分，例如kedaiali.bukku.my就输入`kedaiali`。
5. 把token粘贴到**Access Token**，然后点击**Verify Connection**。
6. 点击**Save Bukku**。

   *(Screenshot: Bukku面板，Enable Bukku integration已标示)*

让**Test company on Bukku staging**保持关闭。它只适用于Bukku在其staging网站上设置的测试公司。

## 在自动化里添加Bukku步骤

最快的方法是用**Automations** → **Templates**下的模板：**Record Sales in Bukku**、**Email the Bukku Invoice**或**Void Sale in Bukku**（请看[用模板创建自动化](/zh/automation-templates/)）。如果要自己添加步骤：

1. 在你的自动化里点击**Add Node**，在**Apps & developer**下选择**Bukku**。
2. 双击新的步骤，打开**Bukku Action Settings**，输入**Action Name**。
3. 在**Action Type**选择这个步骤要做什么：

   | Action Type | 作用 |
   | --- | --- |
   | **Record paid sale** | 把已付款订单记录为Bukku里的销售，包括产品、折扣、费用、运费和收到的款项。 |
   | **Create invoice** | 为订单创建一张未付款的发票。 |
   | **Record payment** | 把订单的Bukku发票标为已付。 |
   | **Void sale or invoice** | 作废这个订单的销售或发票，例如在退款后。输入**Reason**。 |
   | **Add customer** | 把顾客加入你的Bukku联系人，包括**Email**、**Name**和**Phone**。 |

4. 在**Customer**下选择**The buyer**，或选择**One contact for all sales**，再选择**Contact**。
5. 在**Accounts**下，为订单明细选择**Income account**。只有在你收取SST时才选择**Tax code**。如果是销售或付款，在**Money goes to**选择款项存入的地方，通常是Bayarcash结算款项存入的银行账户，再选择**Payment method**。
6. 在**Save as**选择**Ready**，或选择**Draft**，先在Bukku检查后才计入账目。
7. 点击**Save Bukku**，然后点击**Update Automation**，再开启自动化的开关。

后面的步骤可以使用这个步骤返回的Bukku发票号码和链接。在后面的步骤点击**Variables**，然后在**From earlier nodes**下查看。

## 常见问题

### 我在哪里找到Bukku的access token和子域名？

在Bukku打开Control Panel → Integrations，开启API Access，然后复制Access Token。子域名是你Bukku网址的第一部分，例如kedaiali.bukku.my的kedaiali。

### 订单会在Bukku被记录两次吗？

不会。Record paid sale每个订单只记录一次。

### Record payment失败，为什么？

Record payment会把订单的Bukku发票标为已付，所以必须先为这个订单运行Create invoice。如果发票保存为Draft，请先在Bukku批准它。

### Record paid sale说它需要付款触发器，这是什么意思？

Record paid sale和Record payment需要一个在付款后触发的触发器：Payment Successful、Payment Completed、Status Changed或Order Shipped。如果是其他触发器，请用Create invoice或Add customer。