README

Production-ready PHP 8.2+ SDK for the Directo XMLCore API. Directo XMLCore Documentation

A modern, type-safe, and testable PHP SDK for integrating with the Directo ERP system via its XMLCore API. It provides a simple fluent interface for managing Customers, Items, Receipts, and more.

Installation

Requires PHP 8.2+.

⚡️ Get started by requiring the package using Composer:

composer require 5dvision/directo

Usage

<?php

use Directo\Config;
use Directo\Client;

$client = new Client(new Config(
    token: 'your-api-token',
));

// List customers
$customers = $client->customers()->list();

// List items with filters
$items = $client->items()->list([
    'class' => 'ELECTRONICS',
    'ts' => '12.01.2026',
]);

// Create or update a customer using the Directo IN schema shape
$client->customers()->put([
    '@attributes' => [
        'code' => 'CUST001',
        'name' => 'Acme OU',
        'email' => 'info@example.com',
    ],
]);

For put() and putBatch(), use Directo IN schema names and @attributes on the record node. Parsed list() responses come back as XML attributes with @ prefixes such as @code and @name.

Documentation

Configuration

use Directo\Config;

$config = new Config(
    baseUrl: 'https://login.directo.ee/...', // Optional: Base URL
    token: 'your-api-token',                 // Required: API token
    tokenParamName: 'token',                 // 'token' or 'key' (default: 'token')
    timeout: 30.0,                           // Request timeout (default: 30s)
    connectTimeout: 10.0,                    // Connection timeout (default: 10s)
    validateSchema: false,                   // XSD validation (default: false)
    treatEmptyAsNull: true,                  // Empty string handling (default: true)
);

$client = new Client($config);

License

MIT License. See LICENSE for details.