Download the PHP package rebasesoftware/edm-efatura without Composer

EDM E-Fatura Library

A modern PHP library for Turkish E-Invoice (E-Fatura) integration provided by EDM, providing a clean and type-safe interface for SOAP-based e-invoice operations.

Features

• 🔐 Authentication Management - Secure login/logout with session handling and automatic session management
• 📄 Invoice Operations - Send invoices with comprehensive UBL XML generation
• 🔍 Invoice Retrieval - Get invoices by number or UUID with full metadata
• 📊 Status Tracking - Real-time invoice status monitoring with detailed status descriptions
• 🏢 Company Management - Complete issuer and recipient company information handling
• 💰 Tax Management - Advanced tax calculations with multiple tax rates and exemption handling
• 📦 Product Management - Detailed product information with brand, model, and classification support
• 💳 Payment Integration - Payment type configuration with due dates and account information
• 📋 Line Item Management - Individual invoice line items with quantities, prices, and tax calculations
• 🛡️ Exception Handling - Comprehensive SOAP exception handling with detailed error reporting
• 🎯 Type Safety - Full PHP 8.3+ type hints, return types, and nullable type support
• 🧹 Clean Code - PSR-12 compliant code with modern PHP 8.3+ features
• 📝 XML Generation - Clean, readable UBL 2.1 XML output with proper formatting and indentation
• 🔧 Helper Utilities - Built-in utilities for GUID generation and status code translation
• 📚 Documentation - Comprehensive API documentation with working examples

Requirements

• PHP 8.3 or higher
• SOAP extension enabled
• Valid E-Fatura service credentials

Installation

Quick Start

API Reference

Client Constructor

__construct(string $url, string $username, string $password, string $hostname, string $reason, string $channel, string $application)

Creates a new EDM E-Fatura client instance.

Parameters:

• $url - WSDL URL provided by EDM
• $username - Username for authentication
• $password - Password for authentication
• $hostname - Hostname of the client system
• $reason - Reason for using the service
• $channel - Channel name for the application
• $application - Application name using the service

Authentication

login(): bool

Authenticates with the E-Fatura service and establishes a session using the credentials provided in the constructor.

logout(): bool

Terminates the current session.

getSessionId(): ?string

Retrieves the current session ID.

Invoice Management

sendInvoice(Invoice $invoice): array

Sends an e-invoice to the service.

getInvoice(?string $invoiceNumber = null, ?string $invoiceUUID = null, bool $incoming = false, string $contentType = 'XML'): ?array

Retrieves a single invoice by number or UUID.

Returns an array with invoice details:

• CONTENT - Invoice XML content
• SENDER - Sender information
• RECEIVER - Receiver information
• ISSUE_DATE - Invoice issue date
• PAYABLE_AMOUNT - Total payable amount with currency
• CURRENCY - Invoice currency
• STATUS - Invoice status
• STATUS_DESCRIPTION - Status description
• DESCRIPTION - Human-readable status description
• UUID - Invoice UUID
• ID - Invoice ID
• TRXID - Transaction ID

getInvoiceStatus(string $invoiceNumber = '', ?string $invoiceUUID = null): array

Retrieves the current status of an invoice.

Error Handling

The library uses exceptions for error handling. All SOAP operations can throw EDMSoapException when communication fails.

Invoice Structure

Creating an Invoice

Code Quality

The library includes comprehensive code quality tools with modern PHP 8.3+ standards:

Code Formatting

Static Analysis

Code Quality Features

• PSR-12 Compliance - Follows PHP-FIG coding standards
• Type Safety - Full PHP 8.3+ type hints and return types
• Clean XML Generation - Readable, properly formatted XML output
• Modern PHP Patterns - Uses latest PHP features and best practices
• Excluded Documentation - Code quality tools exclude doc/ folder for faster analysis

Demo

Check out the demo application in doc/demo/index.php for practical examples of all library features.

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes following the established patterns:
   • Use proper PHP 8.3+ type hints and return types
   • Follow PSR-12 coding standards
   • Use clean XML generation with heredoc syntax
   • Remove unnecessary variable assignments
4. Run code quality tools: composer cs:fix && composer stan
5. Ensure all tests pass
6. Submit a pull request

Development Guidelines

• Type Safety: Always use proper type hints and return types
• Clean Code: Remove inline re-assignments and use direct method calls
• XML Generation: Use heredoc syntax for clean, readable XML output
• Consistency: Follow the patterns established in existing code
• Documentation: Update documentation for any new features

License

This library is licensed under the MIT License.

Support

For support and questions, please open an issue on GitHub or contact the development team.