如何在ActiveCollab中通过API发送发票？

官方公开API文档未收录发票发送相关端点，实际可通过系统内部保留的API接口实现该需求，操作步骤如下：

• 先调用账户鉴权接口获取有效的API调用令牌，所有后续请求头需要携带X-Angie-AuthApiToken: 你的API令牌以及Content-Type: application/json参数
• 先调用GET /invoices接口拉取发票列表，获取你需要发送的目标发票的ID，仅草稿状态的发票支持执行发送操作
• 调用发票发送接口，请求方式为POST，请求路径为/invoices/[替换为目标发票ID]/send，可传入的请求参数如下：
  • recipient_emails：数组格式，填写收件人邮箱，支持传入多个地址
  • subject：字符串格式，自定义发票邮件的主题，不传则使用系统默认模板生成的主题
  • message：字符串格式，自定义发票邮件的正文内容，支持HTML格式
  • send_copy_to_self：布尔值，设为true时会给当前API调用账号的绑定邮箱发送抄送副本
  • attach_pdf：布尔值，设为true时会自动生成发票PDF文件作为邮件附件发送

调用示例：

curl --location --request POST 'https://你的activecollab部署域名/api/v1/invoices/123/send' \
--header 'X-Angie-AuthApiToken: abcdefg1234567' \
--header 'Content-Type: application/json' \
--data-raw '{
    "recipient_emails": ["client@example.com"],
    "subject": "您的2024年X月服务费发票已开具",
    "message": "您好，附件为本月服务费发票，请查收核对，如有问题随时联系我们。",
    "send_copy_to_self": true,
    "attach_pdf": true
}'

注意事项：

• 只有草稿状态的发票可以调用该接口，已发送、已作废、已支付状态的发票调用会返回400错误
• 接口调用成功后，发票状态会自动变更为「已发送」，发票的金额、商品明细等核心字段将无法再修改
• 如果收件人邮箱已经在系统中关联了对应客户账号，发票记录会自动同步到该客户的账户后台

内容的提问来源于stack exchange，提问作者Xawier