# CreateFolderItem

#### 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

<table border="1" id="bkmrk-amount-unit-price-to" style="border-collapse: collapse; width: 100%; height: 103px;"><tbody><tr style="height: 29px;"><td style="width: 50%; height: 29px;">amount</td><td style="width: 50%; height: 29px;">Unit price to be charged</td></tr><tr style="height: 45px;"><td style="width: 50%; height: 45px;">billingDate</td><td style="width: 50%; height: 45px;">Sample date, in which the Billing Request will be used as a date for invoicing.</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">billingStatus</td><td style="width: 50%; height: 29px;">1 .. Pending

2 .. For Approval (Sales Order may be generated here)

3 .. To Be Invoiced (Invoice may be generated here)

</td></tr><tr><td style="width: 50%;">totalQuantity</td><td style="width: 50%;">Pcs to be charged per Unit price after free Qty is reduced

</td></tr><tr><td style="width: 50%;">catalogPrice</td><td style="width: 50%;">Price before any discounts

</td></tr><tr><td style="width: 50%;">item</td><td style="width: 50%;">Product ID

</td></tr><tr><td style="width: 50%;">name</td><td style="width: 50%;">Main title of the future Billing Request

</td></tr><tr><td style="width: 50%;">note</td><td style="width: 50%;">Future description of Billing Request

</td></tr><tr><td style="width: 50%;">purchasePrice</td><td style="width: 50%;">Unit price for which the goods is purchased

</td></tr><tr><td style="width: 50%;">Quantity</td><td style="width: 50%;">Pcs to be charged per Unit Price

</td></tr><tr><td style="width: 50%;">folder</td><td style="width: 50%;">Customer folder ID

</td></tr><tr><td style="width: 50%;">totalAmount</td><td style="width: 50%;">total qty \* amount

</td></tr><tr><td style="width: 50%;">totalAmountWithVat</td><td style="width: 50%;">totalAmount + VAT

</td></tr><tr><td style="width: 50%;">vatValue</td><td style="width: 50%;">VAT rate in numbers

</td></tr><tr><td style="width: 50%;">ratio</td><td style="width: 50%;">fixed value (100) = 100%

</td></tr><tr><td style="width: 50%;">taxationDate</td><td style="width: 50%;">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)

</td></tr><tr><td style="width: 50%;">isModelItem</td><td style="width: 50%;">1

</td></tr><tr><td style="width: 50%;">validFrom</td><td style="width: 50%;">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.

</td></tr><tr><td style="width: 50%;">validTo</td><td style="width: 50%;">Expiration date

</td></tr><tr><td style="width: 50%;">destinationProject</td><td style="width: 50%;">Target Project ID, where the Billing Request will be created.

</td></tr><tr><td style="width: 50%;">billingFrequency</td><td style="width: 50%;">2 .. yearly

4 .. quarterly

6 .. monthly

8 .. weekly

10 .. daily

</td></tr></tbody></table>

#### Request Example

```XML
<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

```XML
<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>
```