dystcz / laravel-fakturoid
Fakturoid Laravel Wrapper
2.0.0
2024-05-02 00:11 UTC
Requires
- php: ^8.2
- fakturoid/fakturoid-php: ^1.0
- illuminate/support: ^11.0
- laravel/framework: ^11.0
Requires (Dev)
- orchestra/testbench: ^9.0
This package is auto-updated.
Last update: 2024-12-10 00:42:25 UTC
README
Simple wrapper for official php package https://github.com/fakturoid/fakturoid-php
Docs
Installation
Step 1: Install package
Add the package in your composer.json by executing the command.
composer require dystcz/laravel-fakturoid
This will both update composer.json and install the package into the vendor/ directory.
Step 2: Configuration
First initialise the config file by running this command:
php artisan vendor:publish
With this command, initialize the configuration and modify the created file, located under config/fakturoid.php
.
Configuration
return [ 'account_name' => env('FAKTUROID_NAME', 'XXX'), 'account_email' => env('FAKTUROID_EMAIL', 'XXX'), 'account_api_key' => env('FAKTUROID_API_KEY', 'XXX'), 'app_contact' => env('FAKTUROID_APP_CONTACT', 'Application <your@email.cz>'), ];
Examples
Create Subject, Create Invoice, Send Invoice
use Fakturoid; try { // create subject $subject = Fakturoid::createSubject(array( 'name' => 'Firma s.r.o.', 'email' => 'aloha@pokus.cz' )); if ($subject->getBody()) { $subject = $subject->getBody(); // create invoice with lines $lines = [ [ 'name' => 'Big sale', 'quantity' => 1, 'unit_price' => 1000 ], ]; $invoice = Fakturoid::createInvoice(array('subject_id' => $subject->id, 'lines' => $lines)); $invoice = $invoice->getBody(); // send created invoice Fakturoid::fireInvoice($invoice->id, 'deliver'); } } catch (\Exception $e) { dd($e->getCode() . ": " . $e->getMessage()); }
License
Copyright (c) 2019 - 2024 dyst digital s.r.o MIT Licensed.