Difference between revisions of "MOR API invoices get"

From Kolmisoft Wiki
Jump to navigationJump to search
Line 1: Line 1:
[[MOR API]]
=Description=
 
[[MOR API]] Retrieves a list of invoices in the selected time period.
Retrieves a list of invoices in the selected time period.
 
==Request==


If a user has 'admin' rights, he will get '''ALL''' invoices from the selected period. If user has 'user' rights, he will get only '''HIS''' invoices from the selected period.
If a user has 'admin' rights, he will get '''ALL''' invoices from the selected period. If user has 'user' rights, he will get only '''HIS''' invoices from the selected period.
<br><br>
=Usage=


HTML POST: http://<SERVER IP>/billing/api/invoices?u=username&p=password&from=1188604800&till=1191196799&lang=en
* Call: /billing/api/invoices_get
* Methods: POST, GET(if allowed, not recomended)
<br><br>
===Parametres===


Here:
* u - username username of user which can view invoices. '''Required'''.
* '''from/till''' - time period for invoices in [http://en.wikipedia.org/wiki/Unix_time Unix Epoch Time] format. Invoice's '''period start''' should be >= '''from''' and '''period end''' <= '''till'''.
* from/till - time period for invoices in [http://en.wikipedia.org/wiki/Unix_time Unix Epoch Time] format. Invoice's '''period start''' should be >= '''from''' and '''period end''' <= '''till'''.
** http://www.epochconverter.com/ can help to convert time for testing.
** http://www.epochconverter.com/ can help to convert time for testing.
* '''lang''' - choose the language in which you want to get invoice details (mainly 'Calls').
* lang - choose the language in which you want to get invoice details (mainly 'Calls').
<br><br>
===Request===


==Example result==
HTML POST: http://<SERVER IP>/billing/api/invoices_get?u=username&from=1188604800&till=1191196799&lang=en
<br><br>
===Returns===
 
'''Success'''


  <Invoices till="2015-08-22" from="2005-04-21">
  <Invoices till="2015-08-22" from="2005-04-21">
Line 59: Line 67:
   </Invoice>
   </Invoice>
  </Invoices>
  </Invoices>
<br><br>
----


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


  <Error>user not found</Error>
  <Error>user not found</Error>


  <Error>no invoices found</Error>
  <Error>no invoices found</Error>
<br><br>
=See also=
* [[MOR API]]

Revision as of 14:19, 23 May 2013

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 user has 'user' rights, he will get only HIS invoices from the selected period.

Usage

  • Call: /billing/api/invoices_get
  • 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 till="2015-08-22" from="2005-04-21">
 <Invoice clientid="" number="INV0706221" agreementnumber="" user_id="0">
   <Product>
     <Name>Calls</Name>
     <Quantity>2</Quantity>
     <Price>5.0000</Price>
     <Date_added></Date_added>
     <Issue_date>2012-06-22</Issue_date>
   </Product>
 </Invoice>
 <Invoice clientid="" number="INV0706222" agreementnumber="" user_id="2">
   <Product>
     <Name>Calls</Name>
     <Quantity>4</Quantity>
     <Price>20.0000</Price>
     <Date_added></Date_added>
     <Issue_date>2012-06-22</Issue_date>
   </Product>
   <Product>
     <Name>Test_periodic_service - Test_preriodic_service_memo</Name>
     <Quantity>1</Quantity>
     <Price>390.5591</Price>
     <Date_added></Date_added>
     <Issue_date>2012-06-22</Issue_date>
   </Product>
 </Invoice>
 <Invoice clientid="" number="INV0706223" agreementnumber="0000000001" user_id="3">
   <Product>
     <Name>Calls</Name>
     <Quantity>2</Quantity>
     <Price>11.0000</Price>
     <Date_added></Date_added>
     <Issue_date>2012-06-22</Issue_date>
   </Product>
   <Product>
     <Name>Calls from Users</Name>
     <Quantity>7</Quantity>
     <Price>52.0000</Price>
     <Date_added></Date_added>
     <Issue_date>2012-06-22</Issue_date>
   </Product>
 </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