特征
会计师
价钱
支持
登录
 

Soap API 文档

方法: createInvoice

创建一个新发票。

请注意,自动付款功能不适用于通过API创建的发票。

增值税处理
增值税处理字段的可能值:

发票的增值税处理,默认为‘UK’.
‘OUT’ meaning ‘Out of Scope – Not on VAT Return’,
‘UK’ meaning ‘英国实体的商品或服务’,
‘GEU’ meaning ‘Goods to EU Entity’,
‘SEU’ meaning ‘对欧盟实体的服务’,
‘GOEU’ meaning ‘欧盟以外的实体货物’,
‘SOEU’ meaning ‘欧盟以外实体服务’,
‘DSEU’ meaning ‘欧盟实体的数字服务’.

请注意,为了向后兼容,结果vatTreatment字段的前缀可能为“S” for 销售量 and “P” for 购买 .

请求

领域 类型 描述  
invoice dateCreated string 发票的税点 required
invoice dateDue string 发票到期日期(YYYY-MM-DD)。 使用此字段或creditTerms required
invoice dateAccrual string 发票应计日期 optional
invoice creditTerms string 发票应在税点后的天数 required
invoice description string optional
invoice 恩 tityId string 客户或供应商编号 required
invoice reference string 发票的参考字符串 optional
invoice project string 要将发票分配给的项目的ID optional
invoice type string 标识发票类型的字符串 Value one of: 购买 销售量 cn-sales cn购买 required
发票bankPaymentId integer 银行帐号 optional
Invoice vatTreatment string 发票的增值税处理。 optional
发票多币种 integer 指定发票的币种。可以找到有效货币ID的列表 在这里下载此CSV。默认为公司的本国货币。发票上的值始终被视为使用提供的货币。 optional
invoice fxrate float 公司本国货币与发票货币之间的汇率。如果未指定,则汇率将根据dateCreated中指定日期的最新数据自动确定。 optional
发票发票编号 integer 发票编号。必须唯一,如果未指定,则序列中的下一个数字将自动使用。 optional
items array 标识订单项的项目元素列表 required
item description string required
item unitPrice string 物品的单位价格(以磅为单位) required
item quantity integer required
item type string 标识收入流的帐户代码 required
item vat string 增值税总额,以英镑为单位。 使用此字段或vatRate。 required
item vatRate string 增值税百分比(以十进制数字表示)。 使用此字段或增值税。 optional
item project integer 订单项的项目ID optional

响应

领域 类型 描述  
due float 应付总金额(以磅为单位) optional
invoice_id integer 发票的内部编号 optional
invoice_prefix string 发票的前缀 optional
invoice_number string 发票号码 optional

例子

请求

<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
    <Header>
        <authenticate xmlns="//secure.clearbooks.local/api/accounting/soap/">
            <apiKey>yourApiKey</apiKey>
        </authenticate>
    </Header>
    <Body>
        <createInvoice xmlns="//secure.clearbooks.local/api/accounting/soap/">
            <invoice project="3" dateDue="2008-10-17" reference="abcd">
                <type> 购买 </type>
                <entityId>20</entityId>
                <dateCreated>2008-09-17</dateCreated>
                <description>My invoice</description>
                <items>
                    <item quantity="2" vatRate="0.175" project="2">
                        <unitPrice>1.44</unitPrice>
                        <type>1001001</type>
                        <description>Entry ticket</description>
                    </item>
                </items>
            </invoice>
        </createInvoice>
    </Body>
</Envelope>

响应

<?xml version="1.0"  恩 coding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="//secure.clearbooks.local/api/accounting/soap/">
    <SOAP-ENV:Body>
        <ns1:createInvoiceResponse>
            <return>
                <due>3.38</due>
                <invoice_id>30</invoice_id>
                <invoice_prefix>PUR</invoice_prefix>
                <invoice_number>20</invoice_number>
            </return>
        </ns1:createInvoiceResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

清除书籍 自豪地向金融行为监管局注册为帐户信息服务提供商(注册号843585)。