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

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
• docs/09-treasuries-and-numbering-series.md
• docs/10-sales-order-actions.md
• docs/11-payments-warehouses-and-taxes.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.