codetech/laravel-vendus

Vendus (Cegid Vendus) integration for Laravel — sync clients and products, and issue certified invoices and sales documents.

v2.0.0 2026-07-21 22:20 UTC

Requires

• php: ^8.2
• guzzlehttp/guzzle: ^7.8
• illuminate/http: ^11.0|^12.0|^13.0
• illuminate/support: ^11.0|^12.0|^13.0

Requires (Dev)

• larastan/larastan: ^3.10
• laravel/pint: ^1.29
• orchestra/testbench: ^9.0|^10.0|^11.0
• pestphp/pest: ^3.0|^4.0

MIT

• José Osório

• laravel
• vendus
• codetech
• faturação
• faturas
• recibos
• laravel-vendus

Published on Packagist.org on 2026-07-21 22:21 UTC

README

Laravel Vendus

Connect your Laravel application to Vendus, the Portuguese certified invoicing software. Keep your Eloquent models — customers and products — in sync with your Vendus account through a pair of drop-in traits, and build certified sales documents (invoices, receipts, credit notes) on top of a clean, fully testable HTTP client.

Quick start

composer require codetech/laravel-vendus

Set your Vendus API key in .env:

VENDUS_API_KEY=your-api-key

Add a vendus_id column to the table of any model you want to sync, give the model the matching trait, and sync it:

use CodeTech\Vendus\Contracts\VendusClient;
use CodeTech\Vendus\Traits\InteractsWithVendusClient;

class Customer extends Model implements VendusClient
{
    use InteractsWithVendusClient;
}

use CodeTech\Vendus\VendusResource;

$customer = Customer::find(1);

$resource = new VendusResource($customer);
$resource->sync();

sync() creates the customer on Vendus (or updates it if it already exists — clients are matched by their Vendus external_reference) and stores the resulting Vendus ID on your model. Products work the same way with the InteractsWithVendusProduct trait and VendusProduct contract, matched by their Vendus product reference.

Documentation

Configuration, customizing the attribute mappings, sales documents, translations — it's all covered in the documentation.

Upgrading from 1.x? See the upgrade guide.

Changelog

Every release is documented on the GitHub releases page.

Contributing

Contributions are welcome! Please read the contributing guidelines before opening an issue or pull request.

Security

If you discover a security vulnerability, please follow the security policy — do not report it publicly.

Support

If this package helps you, consider starring the repository — it helps other developers discover it.

License

codetech/laravel-vendus is open-sourced software licensed under the MIT license.

About CodeTech

CodeTech is a web development agency based in Matosinhos, Portugal. Oh, and we LOVE Laravel!