CreateFolderItem
May 14, 2020
Description
Create recurring billing request. Recurring billing request is used to instruct the server to create individual instance of Billing Request, which is a source for Invoice creation.
Important Parameters
amount
Unit price to be charged
billingDate
Sample date, in which the Billing Request will be used as a date for invoicing.
billingStatus
1 .. Pending
2 .. For Approval (Sales Order may be generated here)
3 .. To Be Invoiced (Invoice may be generated here)
totalQuantity
Pcs to be charged per Unit price after free Qty is reduced
catalogPrice
Price before any discounts
item
Product ID
name
Main title of the future Billing Request
note
Future description of Billing Request
purchasePrice
Unit price for which the goods is purchased
Quantity
Pcs to be charged per Unit Price
folder
Customer folder ID
totalAmount
total qty * amount
totalAmountWithVat
totalAmount + VAT
vatValue
VAT rate in numbers
ratio
fixed value (100) = 100%
taxationDate
Date relative to Billing Date, in which you may decide to put the transaction into current / previous / next periods. Put any date close to Billing Date (ie any day in the same/previous month)
isModelItem
1
validFrom
Date, from which the rule becomes active. Difference of dates between validFrom and billingDate is important. Item generated in validFrom = today should have billingDate today + 1 year, in case the first next fee is paid after one year of using the service.
validTo
Expiration date
destinationProject
Target Project ID, where the Billing Request will be created.
billingFrequency
2 .. yearly
4 .. quarterly
6 .. monthly
8 .. weekly
10 .. daily
Request Example
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wsdl="http://atollon.com/enterprise/wsdl">
<soapenv:Header/>
<soapenv:Body>
<wsdl:CreateFolderItem>
<server>acme</server>
<session>7CDF678513DCBF0379DDD26A6961B604D7F1515CBD04</session>
<ITEM>
<amount>1234</amount>
<billingDate>2020-05-14T00:00:00</billingDate>
<billingStatus>2</billingStatus>
<totalQuantity>5</totalQuantity>
<catalogPrice>190</catalogPrice>
<currency>CZK</currency>
<item>133629101</item>
<name>Repeated service</name>
<note>Billing the yearly service.</note>
<purchasePrice>130</purchasePrice>
<quantity>5</quantity>
<folder>139676101</folder>
<totalAmount>6170</totalAmount>
<totalAmountWithVat>6787</totalAmountWithVat>
<vatValue>10</vatValue>
<ratio>100</ratio>
<taxationDate>2020-05-14T00:00:00</taxationDate>
<validFrom>2020-05-14T00:00:00</validFrom>
<validTo>2099-05-04T00:00:00</validTo>
<destinationProject>139704101</destinationProject>
<billingFrequency>2</billingFrequency>
</ITEM>
</wsdl:CreateFolderItem>
</soapenv:Body></soapenv:Envelope>
Response Example
<ns0:Envelope xmlns:ns0="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://atollon.com/enterprise/wsdl">
<ns0:Body>
<ns1:CreateFolderItemResponse>
<result>OK</result>
<time>0.01345706</time>
<count>0</count>
<itemId>139812101</itemId>
</ns1:CreateFolderItemResponse>
</ns0:Body></ns0:Envelope>