Laravel Billingo

laravel-billingo is a Laravel package for seamless integration with the Billingo API v3. This package provides a simple and elegant way to interact with Billingo's features directly from your Laravel application.

Installation

You can install the package via Composer:

composer require omisai/laravel-billingo

After installation, publish the configuration file:

php artisan vendor:publish --provider="Omisai\\Billingo\\BillingoServiceProvider"

This will create a config/billingo.php file where you can configure your Billingo API credentials and settings.

Configuration

Add your Billingo API key to your .env file:

BILLINGO_API_KEY=your-api-key-here

Usage

For detailed usage instructions, including examples and API documentation, please refer to the USAGE.md file.

Basic Example

use Omisai\\Billingo\\Facades\\Billingo;

// Create a partner
$partner = Billingo::partners()->create([
    'name' => 'John Doe',
    'address' => [
        'country_code' => 'HU',
        'post_code' => '1234',
        'city' => 'Budapest',
        'address' => 'Main Street 1',
    ],
]);

// Create an invoice
$invoice = Billingo::invoices()->create([
    'partner_id' => $partner['id'],
    'block_id' => 12345,
    'type' => 'invoice',
    'items' => [
        [
            'name' => 'Product Name',
            'unit_price' => 1000,
            'quantity' => 1,
            'unit' => 'piece',
            'vat' => '27%',
        ],
    ],
]);

Contributing

We welcome contributions! Please see CONTRIBUTING.md for details on how to contribute to this project.

Security

If you discover any security-related issues, please email [email protected] instead of using the issue tracker. For more information, see SECURITY.md.

Testing

composer test

License

This project is licensed under the MIT License - see the LICENSE file for details.

Sponsoring

If you find this package useful, please consider sponsoring the development:

• Sponsoring on GitHub

Your support helps us maintain and improve this open-source project!