SAS4 Documentation

Billing

The billing section is dedicated for end-users. Here you can find invoices generated automatically for postpaid users. Also you can issue invoices manually for any user. The invoice list has quite few actions: Pay Invoice, Download and Invoice Designer. Usually postpaid subscribers get their invoices generated automatically before their next billing cycle. They can pay their invoices online from the user control panel using any available payment method, or when handing them cash , the manager has to search for their invoice and mark it as ‘Paid’, otherwise they might get disconnected from service.

1. Invoices Index

Shows invoices details.

2. Invoices Actions

  • Pay Invoice: Select unpaid invoice.click on pay invoice. The selected invoice will be ticked as paid.
  • Download invoice: Select invoice, then click on download.
  • Invoice Designer: Check Design invoice section.

3. Design invoice

Select invoice,click on invoice designer.The invoice designer is a simple HTML code editor allowing you to edit the current invoice design. You can easily replace the HTML tags and change logos and stuff, however, if you want to go further, then you must have some experience with Laravel Blade templating engine. Note that HTML has mandatory name attributes that have to be tracked to perform value variations accordingly. Details associated with invoice no, issue & due dates, Status and address information etc are filled out from the system database. After selecting the PDF paper size, save it for final issue.

Note: Each attribute code in table represents a specific value fetch from database which has to be in consistent with description column, attribute can be used in your HTML code.

Attribute Code Description
$invoice['number'] Invoice Number
$invoice['issue_date'] Issued On
$invoice['due_date'] Due date
$invoice['status'] invoice status (paid or unpaid)
$issuer['name'] Company Name
$issuer['address_line1'] Company Address
$issuer['address_line2'] Company Address 2
$issuer['phone'] Company Phone
$issuer['email'] Company Email
$receiver['name'] User First-Name
$receiver['address_line1'] User Address
$receiver['address_line2'] User Address 2
$receiver['phone'] User Phone
$receiver['email'] User Email
Iterate over items object which hace the following attribute give name $item for example
$item['name'] Service Name
$item['unit_price'] Service Price
$item['qty'] Service Quantity
$item['price'] Service Total Price
Iterate items end here
$invoice['value'] Invoice sub-total
$invoice['vat'] Invoice VAT (Value Added Tax)
$invoice['discount'] Invoice Discount
$invoice['total'] Invoice Total

Note: bellow section is an example of code show table of iterate of invoice items

<div class="row">   
         <div class="col-xs-12">    
             <table class="invoice-items-table">    
                 <thead>    
                 <tr>   
                     <th class="header-row">Item</th>   
                     <th class="header-row">Unit Price</th> 
                     <th class="header-row">Qty</th>    
                     <th class="header-row">Price</th>  
                 </tr>  
                 </thead>
                 @foreach ($items as $item) 
                     <tr>
                         <td class="item-row">{{$item['name']}}</td>
                         <td class="item-row">{{$item['unit_price']}}</td>
                         <td class="item-row">{{$item['qty']}}</td>
                         <td class="item-row">{{$item['price']}}</td>
                     </tr>
                 @endforeach
             </table>
         </div>
</div>

4. Issue Invoice

From user Invoice Form, select client, add service & custom item, fill out fields then save/ save & print.