mpernia / holded-php-sdk
Framework-agnostic PHP SDK for Holded API
1.0.0
2026-04-26 15:02 UTC
Requires
- php: ^8.2
- ext-curl: *
- psr/http-client: ^1.0
- psr/http-factory: ^1.0
- psr/http-message: ^2.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.0
- phpunit/phpunit: ^11.0
README
Framework-agnostic PHP 8.2+ SDK for the Holded Invoice API.
Installation
composer require mpernia/holded-php-sdk
Quick Start
<?php require_once __DIR__ . '/vendor/autoload.php'; use Holded\SDK\HoldedClient; // Create a client with your API key $client = HoldedClient::builder() ->withApiKey('your-holded-api-key') ->build(); // List invoices $invoices = $client->documents() ->type(\Holded\SDK\Documents\DocumentType::INVOICE) ->list(); // Get a specific contact $contact = $client->contacts()->get('contact-id');
Available Resources
| Resource | Description |
|---|---|
documents() |
Invoices, estimates, orders, purchase invoices |
contacts() |
Customers and suppliers |
products() |
Product catalog |
treasuries() |
Treasury accounts |
expenseAccounts() |
Expense accounts |
numberingSeries() |
Numbering series |
salesChannels() |
Sales channels |
warehouses() |
Warehouses |
payments() |
Payment terms |
paymentMethods() |
Payment methods |
taxes() |
Tax configuration |
contactGroups() |
Contact groups |
remittances() |
Remittances |
services() |
Services |
Documentation
Detailed examples and guides:
- docs/README.md — Index of all examples
- docs/01-list-documents.md
- docs/02-create-invoice.md
- docs/03-contacts.md
- docs/04-products.md
- docs/05-create-sales-invoice.md
- docs/06-create-purchase-invoice.md
- docs/07-download-invoice-pdf.md
- docs/08-download-contact-attachment.md
Requirements
- PHP 8.2+
- ext-curl
Contributing
Contributions are welcome! Please read our Contributing Guide before submitting PRs.
Development
# Install dependencies composer install # Run tests composer test # Run code style check composer fix-cs
License
MIT — see LICENSE for details.