PHP download

Download the PHP package aichadigital/lararoi without Composer

On this page you can find all versions of the php package aichadigital/lararoi. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

Table of contents
Download aichadigital/lararoi
More information about aichadigital/lararoi
Files in aichadigital/lararoi

Vendor aichadigital
Package lararoi
Short Description Agnostic package for intra-community NIF-VAT/VAT verification. Designed primarily for use with Larabill.
License MIT
Homepage https://github.com/aichadigital/lararoi

Keywords vat laravel vies verification NIF iva roi

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:

If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.

Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
To use Composer is sometimes complicated. Especially for beginners.
Composer needs much resources. Sometimes they are not available on a simple webspace.
If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.

Please rate this library. Is it a good library?

Example code of aichadigital/lararoi

Informations about the package lararoi

Lararoi

Development happens on gitlab.castris.com. The GitHub repository is a read-only distribution mirror: issues and pull requests opened there are not seen.

Lararoi is the Laravel package that owns the intra-community VAT/NIF verification domain: the verification itself, its cache, and a multi-consumer tracking/audit log — served to consuming apps through explicit, stable contracts and agnostic configuration. Consumers (billing, accounting, …) consume it; they never reimplement the domain.

The verification model is provider-agnostic (VIES SOAP/REST, isvat, viesapi, vatlayer) with automatic fallback and per-country syntax validation. See the architecture decisions (ADR-001, ADR-002) for the domain-ownership rationale.

Features

✅ VAT/NIF verification via VIES (European Commission) + multiple free/paid providers, with automatic fallback
✅ Per-country syntax validation (short-circuits obviously invalid numbers without hitting a provider)
✅ TTL cache (memory + database), one current row per NIF, enforced by a UNIQUE key
✅ Multi-consumer tracking / audit log — append-only, consumer-attributed, inert by default
✅ Per-consumer retention (declared in config, UTC) with a prune command
✅ Per-consumer output mapping — adapt the canonical result to your own shape without forking code
✅ Formal, documented contract set — swap the model, the tracking model, or the mapper via config/contracts
✅ Robust, typed error handling; development commands for testing against real APIs

Requirements

PHP 8.3+
Laravel 12+

Installation

The database schema is package-managed — just run migrations, no stub to publish:

This creates the cache table roi_vat_verifications and the tracking table roi_verification_queries. Optionally publish the config to tune providers, cache, tracking and retention:

Basic Usage

Tracking is off by default. A consumer that wants an audit trail enables lararoi.tracking.enabled, registers itself in the lararoi.consumers allow-list (with a retention policy), and passes a VerificationContext — see the Integration Guide.

Documentation

Integration Guide — install → verify → track → retain → map (the full consumer flow)
Contracts — the public contract set (interfaces, value object, exceptions)
Configuration — config keys and environment variables
Usage Guide — usage patterns and examples
Architecture Decisions — ADR-001 (domain ownership), ADR-002 (v1.0 design)
Development Guide — development commands and testing with real APIs
Contributing — guidelines for contributors

Testing & Quality

Pest PHP test suite, PHPStan level 5, Laravel Pint, GitHub Actions CI.

License

The MIT License (MIT). Please see License File for more information.

Credits

Abdelkarim Mateos
Aicha Digital
All Contributors

All versions of lararoi with dependencies

PHP Build Version

Package Version

Version v1.1.0 Release 11. Jul 2026
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of lararoi from vendor aichadigital

Requires php Version ^8.3
spatie/laravel-package-tools Version ^1.16
illuminate/contracts Version ^12.0||^13.0
illuminate/database Version ^12.0||^13.0
illuminate/http Version ^12.0||^13.0
illuminate/support Version ^12.0||^13.0
ext-soap Version *
ext-json Version *

Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package aichadigital/lararoi contains the following files

Loading the files please wait ...