logipro / idcommerce-php

v0.1.0 2026-11-11 15:32 UTC

Requires

• php: >=7.4
• logipro/turbolead-api: ^0.1

Requires (Dev)

• nyholm/psr7: ^1.8
• php-http/curl-client: ^2.2
• php-http/mock-client: ^1.6
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^9.6
• squizlabs/php_codesniffer: ^3.10

MIT

• Frédéric Royet

• API-Client
• invoicing
• turbolead
• idcommerce

Published on Packagist.org on 2026-11-11 15:33 UTC

README

Bibliothèque HTTP pour l'API REST ID-Commerce (/api/idcommerce), construite sur logipro/turbolead-api (transport PSR-18 partagé).

Installation

composer require logipro/idcommerce-php

Disponible sur Packagist. PHP 7.4+ et un client HTTP PSR-18.

Utilisation

<?php

declare(strict_types=1);

use Logipro\Turbolead\IdCommerce\Dto\Client\ClientCreateRequest;
use Logipro\Turbolead\IdCommerce\Dto\Client\ElectronicInvoicingInput;
use Logipro\Turbolead\IdCommerce\IdCommerceClient;

$client = IdCommerceClient::create(
    'tlk_prefix_secret',
    'https://exemple.turbolead.fr'
);

$health = $client->health()->show();

$list = $client->clients()->list(1, 20, '2026-01-01T00:00:00+00:00');

$created = $client->clients()->create(
    (new ClientCreateRequest())
        ->withType('N1')
        ->withCompanyName('Domaine SARL')
        ->withElectronicInvoicing(
            (new ElectronicInvoicingInput())
                ->withCountryCode('FR')
                ->withCustomerCategory('business')
        )
);

$client->products()->create(/* ProductCreateRequest */);

$client->invoices()->create(/* InvoiceCreateRequest */);

$client->invoices()->renewRecurrentOffers($invoiceId);

$client->invoiceLines()->stopRecurrent($lineId);

$client->payments()->create(/* PaymentCreateRequest */);

Chemins de création (singulier)

Ressource	Méthode	Chemin
Client	clients()->create()	POST /api/idcommerce/client
Produit	products()->create()	POST /api/idcommerce/product
Facture	invoices()->create()	POST /api/idcommerce/invoice
Paiement	payments()->create()	POST /api/idcommerce/payment

Le contrat figé est dans docs/api/openapi.yaml.

Vérification

./codecheck
bin/infection
bin/integration

Installation locale (démo nginx)

./install --profile devlocal
./start

Page d'accueil : http://172.17.0.1:35083/ (variable HOST_PORT, projet Docker idcommerce-php).

./stop

git clone [e-mail]:opensource/turbolead/idcommerce-php.git

composer.lock n'est pas versionné. Pour développer contre une copie locale du transport :

composer config repositories.turbolead-api path ../turbolead-api

Licence

MIT