如何通过API在Business Central General Journals中创建单据类型为Invoice的日记账分录

问题核心 #

在Business Central UI的「General Journals」模块中可以选择单据类型为「Invoice」来登记发票财务分录，但使用通用的日记账行API端点：

POST businesscentralPrefix/companies({id})/journals({id})/journalLines({id})

时，其模型结构中没有指定单据类型的字段，无法实现该操作；而客户付款需使用专用的customerPaymentJournals端点才能正常创建，现需找到仅登记外部系统生成发票的财务部分的API方案。

解决方案 #

使用销售日记账专用API端点 #

要创建对应发票类型的日记账分录，需使用**销售日记账（Sales Journals）**的专用API端点，而非通用的General Journals端点，对应的POST请求地址为：

POST businesscentralPrefix/companies({id})/salesJournals({id})/salesJournalLines

该端点的模型包含documentType字段，可直接设置为Invoice，完全匹配UI中选择单据类型的操作逻辑。

请求体示例 #

以下是符合要求的销售日记账行请求体，仅包含登记财务部分所需的核心字段：

{
    "journalId": "你的销售日记账GUID",
    "lineNumber": 10000,
    "accountType": "Customer",
    "accountNumber": "客户编号",
    "postingDate": "2024-05-20",
    "documentType": "Invoice",
    "documentNumber": "外部发票编号",
    "externalDocumentNumber": "外部发票编号",
    "amount": 1500.00,
    "description": "外部系统发票财务登记",
    "balancingAccountType": "G/L Account",
    "balancingAccountNumber": "对应总账科目编号"
}

说明 #

• 此方案与客户付款使用customerPaymentJournals端点的逻辑一致，都是针对特定业务场景使用专用的日记账API，而非通用端点。
• 过账该日记账分录后，会在Business Central中生成对应的客户应收财务记录，无需创建完整的销售发票，完全满足仅登记外部发票财务部分的需求。

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