Developer Center

Invoice

Default Parameters

In the following parameters "/" slash character is used to determine the array data under an array data.

Name Type Description
source string Used to specify the source where the incident took place.
automation  : Occurred by automation.
api                   : Occurred through API.
admin             : Occurred by administrator.
client              : Occurred by client.
id int Invoice ID number
user_id int Client ID number
user_data array Client information saved while the invoice is created. (Not Current)
user_data / name string Client Name
user_data / surname string Client SurName
user_data / full_name string Client FullName
user_data / company_name string Client Company Name
user_data / company_tax_number string Client's Corporate Tax Number
user_data / company_tax_office string Client's Corporate Tax Office
user_data / email string Client E-Mail Address
user_data / gsm_cc int Client's GSM Country Code Ex: 01
user_data / gsm int Client's GSM Number without Country Code
user_data / landline_cc int Client's Fixed Line Country Code Ex: 01
user_data / landline_phone int Client's Fixed Line Number without Country Code
user_data / identity int Client's Citizenship Identity Country Code
user_data / kind string Client's Account Type; individual, corporate
user_data / taxation int | null Client's Tax Exemption Status;
If the value '1' comes, it means it is exempt from tax.
user_data / currency int Currency Defined in Client's Account
user_data / address array Client address information saved while the invoice is created (Not Current)
user_data / address / country_name string Client Address > Country Name
user_data / address / country_code string Client Address > Country Code (Alpha-2)
user_data / address / city string Client Address > City Name
user_data / address / counti string Client Address  >Counti Name
user_data / address / address string Client Address
user_data / address / zipcode string Client Address Postal Code
cdate string Invoice Generation Date (Format: Y-M-D H:i:s)
duedate string Invoice Due Date (Format Y-M-D H:i:s)
datepaid string Invoice Payment Date (Format: Y-M-D H:i:s)
refunddate string Invoice Refund Date (Format: Y-H:i:s)
status string Determines invoice status;
paid : Paid
unpaid : Not Paid
waiting: Awaiting Confirmation
cancelled : Canceled
refund : Refunded
currency int ID number that defines currency of to invoice.
Database: currencies.id 
data/exchange_rate float Invoice Exchange Rate
local int It is 1 if invoice belongs to the local address, 0 if not.
legal int Specifies tax exemption status of invoice;
1: tax included, 0: tax-free
taxed int Specifies the formalization status of invoice;
1: formalized, 0: not formalized
taxed_file string Used to define a pdf file for an official invoice.
File should be in "resources/uploads/invoices/" directory
taxation_type string Specifies the tax type of invoice;
inclusive: Tax Included
exclusive: Tax Excluded
taxrate float Determines the tax rate of invoice
subtotal float Specifies the subtotal of the invoice
tax float Specifies the total tax amount of invoice
total float Specifies all-inclusive total amount of invoice
discounts array The information regarding coupons and promotions used in invoice is included
discounts/items/coupon/*/id int Specifies the ID number of the coupon
Database: coupons.id
discounts/items/coupon/*/name string Specifies the coupon name
discounts/items/coupon/*/rate int Determines what percentage value of the coupon has
discounts/items/coupon/*/dvalue string If discounted by rate: % as value, if discounted by amount: value currency code are defined
discounts/items/coupon/*/amount string Discount amount applied by coupon is specified as formatted
discounts/items/coupon/*/amountd float Discount amount applied by coupon is specified
discounts/items/promotion/*/id int Specifies ID number of promotion
Database: promotions.id
discounts/items/promotion/*/name string Sets the promotion name
discounts/items/promotion/*/rate int Specifies %value rate of promotion
discounts/items/promotion/*/dvalue string If discounted by rate: % as value, if discounted by amount, formatted amount value and currency code are defined
discounts/items/promotion/*/amount string The discount amount applied to the promotion is determined in format
discounts/items/promotion/*/amountd float Discount amount applied by promotion is specified
used_coupons string The ID number of the coupons used is determined by separating them with comma.
used_promotions string The ID number of the promotions used is determined by separating them with comma.
sendbta int Specifies the address delivery status of formalized invoice
1: active, 0: passive
sendbta_amount float Specifies the address delivery amount of formalized invoice
pmethod string Specifies the payment method module
pmethod_commission float Specifies the commission amount belonging of payment method
pmethod_commission_rate float Determines the commission rate of the payment method
pmethod_status string Specifies the status of the payment;
SUCCESS: Payment Successful
ERROR: Payment Failed
PAPPROVAL: Pending Approval
pmethod_msg string Determines the message returned from the payment method
notes string Determines notes about the invoice. (Only the manager /staff can see)

Sample Usage

Hook::add("InvoiceViewDetails",1,function($params=[]){
    $id             = $params["id"];
    $status         = $params["status"];
    $currency       = $params["currency"];
    $items          = Invoices::get_items();
    /**
    # Example: update invoice data Invoices::set($id,['duedate' => '2020-03-05 00:00:00']);
    # Example: update invoice item data Invoices::set_item($item["id"],['description' => 'Example']);
    # Example: insert invoice item dat:
    $item_id = Invoices::add_item([
        'owner_id'      => $id,
        'description'   => 'Example',
        'amount'        => 1.0,
        'currency'      => $currency,
    ]);
    */
    /** Write the code here... */
});

InvoicePaid

Called when the status of an invoice is changed as paid.

Return

Not supported

InvoiceUnpaid

Called if the status of an invoice is changed to unpaid.

Return

Not supported

InvoiceFormalized

Called when the status of an invoice is changed to formalized.

Return

Not supported

InvoiceCancelled

Called when the status of an invoice is changed to canceled.

Return

Not supported

InvoiceRefunded

Called when the status of an invoice is changed to refunded.

Return

Not supported

InvoiceCreated

Called after an invoice is created.

Return

Not supported

InvoiceModified

Called after administrator modifies the invoice.

Return

Not supported

PreInvoiceDeleted

Called before an invoice is deleted from the system.

Return

Not supported

InvoiceDeleted

Called when an invoice is deleted from the system.

Return

Not supported

InvoicePaymentReminder

Called when a payment reminder is made for an invoice.

Return

Not supported

InvoiceViewDetails

Called when administrator or client enters invoice detail.

Return

Not supported

Domain Product / Service

Do you have any questions?

Feel free to contact us
Contact Us
Copyright © 2024. All Rights Reserved.
Join Our Discord Channel
Top