Download the PHP package eproduct/money-s3 without Composer
On this page you can find all versions of the php package eproduct/money-s3. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package money-s3
MoneyS3 PHP Library
A PHP library for generating XML data compatible with MoneyS3 accounting software. This library provides a simple and intuitive API for creating invoices and receipts in the MoneyS3 XML format.
Supported Documents
| Document Type | Status | XML Element | Description |
|---|---|---|---|
| Issued Invoice | ✅ Done | FaktVyd |
Outgoing invoices sent to customers |
| Received Invoice | ✅ Done | FaktPrij |
Incoming invoices from suppliers |
| Receipt | ✅ Done | Prijemka |
Receipt documents for goods/services |
| Obligation | ✅ Done | Zavazek |
Financial obligations |
Table of Contents
- Requirements
- Installation
- Basic Usage
- API Reference
- MoneyS3 Class
- Invoice Management
- Receipt Management
- Supporting Classes
- Examples
- Development
- Testing
- License
Requirements
- PHP 8.3 or higher
- ext-xmlwriter extension
Installation
Install the package via Composer:
Basic Usage
API Reference
MoneyS3 Class
The main class for managing MoneyS3 data and generating XML output.
Constructor
$ico: Company identification number (ICO)
Methods
addInvoice(InvoiceType $type): Invoice
Creates and adds a new invoice to the data collection.
$type: Invoice type (InvoiceType::ISSUEDorInvoiceType::RECEIVED)- Returns:
Invoiceinstance for method chaining
addReceipt(): Receipt
Creates and adds a new receipt to the data collection.
- Returns:
Receiptinstance for method chaining
getXml(bool $flushMemory = true): string
Generates XML representation of all data.
$flushMemory: Whether to clear internal data after generating XML (default:true)- Returns: Complete XML document as string
Invoice Management
InvoiceType Enum
Invoice Class
Represents an invoice with comprehensive configuration options.
Key Methods
Receipt Management
Receipt Class
Represents a simple receipt document.
Currently provides basic receipt structure. Additional properties can be added as needed.
Supporting Classes
Partner Class
Represents business partner information for invoices.
Company Class
Represents your company information.
Address Class
Represents address information for companies and partners.
VatSummary Class
Represents VAT summary information.
Examples
Complete Invoice Example
Multiple Invoices Example
Batch Processing with Memory Management
Development
Prerequisites
- Docker and Docker Compose
- Make
Setup Development Environment
Available Make Commands
make up- Start Docker containersmake down- Stop Docker containersmake install- Install Composer dependenciesmake update- Update Composer dependenciesmake phpstanormake ps- Run PHPStan static analysismake test- Run PHPUnit tests
Testing
The library includes comprehensive tests covering:
- XML generation and validation
- Invoice creation and configuration
- Receipt management
- Multiple document types
- Well-formed XML output
Run tests using:
Or with Docker directly:
XML Output Structure
The generated XML follows the MoneyS3 format:
Error Handling
The library uses type-safe approach with PHP 8.3+ features:
- Enum types for invoice types
- Strict typing throughout the API
- PHPStan level 9 compliance
- Comprehensive exception handling
License
This project is licensed under the MIT License - see the LICENSE file for details.
Authors
Tomáš Kratschmer
- Email: [email protected]
Lukáš Chytil
- Email: [email protected]
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Changelog
Version 0.0.1
- Initial release
- Invoice agenda (issued/received)
- Receipt agenda
- Obligation agenda
- XML generation
- Comprehensive test suite
- Docker development environment
⚠️ Disclaimer
This library is not affiliated with, endorsed by, or associated with MoneyS3 accounting software, Seyfor a. s. company, or its developers. MoneyS3 is a trademark of Seyfor, a.s. This is an independent, open-source library created to generate XML files compatible with the MoneyS3 XML import format. Use of this library is at your own risk, and the authors are not responsible for any data loss or accounting errors that may result from its use.
All versions of money-s3 with dependencies
ext-xmlwriter Version *