README

About

laravel-szamlazzhu is a Laravel package that provides an easy-to-use interface for communicating with the Számlázz.hu API. It was created by refactoring the original source code (available at here) and integrating it into the Laravel framework.

Many of the original source code files were reforged to use the built-in features of Laravel, such as HTTP client, Filesystem abstraction, Configuration and service provider. As a result, laravel-szamlazzhu provides a more streamlined and idiomatic way of interacting with the Számlázz.hu API.

Installation

To get started with package, simply install it via Composer:

composer require omisai/laravel-szamlazzhu

Configuration

Configure your API credentials in .env:

SZAMLAZZHU_API_KEY=<yourAPIToken>

or in config/szamlazzhu.php file:

'api_key' => env('SZAMLAZZHU_API_KEY', null),

Usage

For comprehensive usage examples and detailed documentation, please see USAGE.md.

This guide covers:

• Installation & Configuration
• Creating Invoices (regular, pre-payment, final, corrective, reverse)
• Creating Receipts
• Creating Proforma Invoices
• Working with Waybills (MPL, Sprinter, Transoflex, PPP)
• Advanced features (multi-currency, ledger data, attachments)
• Error handling and best practices

Note: For the most recent updates, please check the test cases or read through the source code.

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Testing

composer test

Security

If you discover any security-related issues, please email security@omisai.com instead of using the issue tracker.

License

The MIT License (MIT). Please see License File for more information.