Difference between revisions of "MOR API invoices get"

From Kolmisoft Wiki
Jump to navigationJump to search
Line 26: Line 26:
'''Success'''
'''Success'''


  <Invoices from="2018-01-01" till="2019-01-01">
   
  <Invoice user_id="3" agreementnumber="0000000001" clientid="" number="INV1801011">
 
    <paid>0</paid>
    <Invoices from="2019-05-01" till="2019-05-31">
    <Product>
 
      <Name>United States</Name>
        <Invoice user_id="2" agreementnumber="" clientid="" number="INV1905011">
      <Quantity>5</Quantity>
 
      <Price>0.0942</Price>
            <paid>0</paid>
      <Date_added></Date_added>
            <Product>
      <Issue_date>2018-03-06</Issue_date>
 
      <Time>00:03:30</Time>
                <Name>Test_periodic_service - 1</Name>
    </Product>
                <Quantity>1</Quantity>
    <Product>
                <Price>10.0000</Price>
      <Name>Lithuania - Fixed</Name>
                <Discount>0.0000</Discount>
      <Quantity>30</Quantity>
                <Sum>10.0000</Sum>
      <Price>13.0837</Price>
                <Date_added/>
      <Date_added></Date_added>
                <Issue_date>2019-06-27</Issue_date>
      <Issue_date>2018-03-06</Issue_date>
                <Time/>
      <Time>01:14:40</Time>
 
    </Product>
            </Product>
    <Total_time>01:18:10</Total_time>
            <Product>
  </Invoice>
 
  <Invoice user_id="3" agreementnumber="0000000001" clientid="" number="INV1801012">
                <Name>Test_periodic_service - 2</Name>
    <paid>0</paid>
                <Quantity>1</Quantity>
    <Product>
                <Price>10.0000</Price>
      <Name>Lithuania - Fixed</Name>
                <Discount>2.0000</Discount>
      <Quantity>70</Quantity>
                <Sum>8.0000</Sum>
      <Price>13.7963</Price>
                <Date_added/>
      <Date_added></Date_added>
                <Issue_date>2019-06-27</Issue_date>
      <Issue_date>2018-07-10</Issue_date>
                <Time/>
      <Time>01:19:38</Time>
 
    </Product>
            </Product>
    <Product>
            <Total_time/>
      <Name>Switzerland - Fixed</Name>
 
      <Quantity>5</Quantity>
        </Invoice>
      <Price>0.1975</Price>
 
      <Date_added></Date_added>
</Invoices>
      <Issue_date>2018-07-10</Issue_date>
      <Time>00:00:40</Time>
    </Product>
    <Product>
      <Name>Singapore - Fixed</Name>
      <Quantity>4</Quantity>
      <Price>0.0987</Price>
      <Date_added></Date_added>
      <Issue_date>2018-07-10</Issue_date>
      <Time>00:00:20</Time>
    </Product>
    <Product>
      <Name>Calls to DIDs</Name>
      <Quantity>79</Quantity>
      <Price>0.0000</Price>
      <Date_added></Date_added>
      <Issue_date>2018-07-10</Issue_date>
      <Time>01:20:38</Time>
    </Product>
    <Total_time>02:41:16</Total_time>
  </Invoice>
  <Invoice user_id="15" agreementnumber="0000000013" clientid="" number="INV1801013">
    <paid>0</paid>
    <Total_time></Total_time>
  </Invoice>
</Invoices>
<br><br>
----
----


Revision as of 07:50, 2 July 2019

Description

MOR API Retrieves a list of invoices in the selected time period.

If a user has 'admin' rights, he will get ALL invoices from the selected period. If a user has 'accountant' rights and can see only assigned users, he will get only assigned users invoices from the selected period. If user has 'user' rights, he will get only HIS invoices from the selected period.

Usage

  • From MOR X4 call: /api/invoices_get
  • For Backwards-compatibility old name 'invoices' is also usable. Call: /api/invoices
  • Methods: POST, GET(if allowed, not recomended)



Parametres

  • u - username username of user which can view invoices. Required.
  • from/till - time period for invoices in Unix Epoch Time format. Invoice's period start should be >= from and period end <= till.
  • lang - choose the language in which you want to get invoice details (mainly 'Calls').



Request

HTML POST: http://<SERVER IP>/billing/api/invoices_get?u=username&from=1188604800&till=1191196799&lang=en



Returns

Success 


   <Invoices from="2019-05-01" till="2019-05-31">

       <Invoice user_id="2" agreementnumber="" clientid="" number="INV1905011">

           <paid>0</paid>
           <Product>

               <Name>Test_periodic_service - 1</Name>
               <Quantity>1</Quantity>
               <Price>10.0000</Price>
               <Discount>0.0000</Discount>
               <Sum>10.0000</Sum>
               <Date_added/>
               <Issue_date>2019-06-27</Issue_date>
               
           </Product>
           <Product>

               <Name>Test_periodic_service - 2</Name>
               <Quantity>1</Quantity>
               <Price>10.0000</Price>
               <Discount>2.0000</Discount>
               <Sum>8.0000</Sum>
               <Date_added/>
               <Issue_date>2019-06-27</Issue_date>
               
           </Product>
           <Total_time/>

       </Invoice>

</Invoices>

Errors 

<?xml version="1.0" encoding="UTF-8"?>
<status>
  <error>Incorrect hash</error>
</status>

<Error>user not found</Error>

<Error>no invoices found</Error>



See also

Retrieved from "https://wiki.kolmisoft.com/index.php?title=MOR_API_invoices_get&oldid=24865"