Skip to main content

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

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>
Back to top