PHP download

Download the PHP package valsis/ro-company-lookup without Composer

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

Table of contents
Download valsis/ro-company-lookup
More information about valsis/ro-company-lookup
Files in valsis/ro-company-lookup

Vendor valsis
Package ro-company-lookup
Short Description Lookup Romanian company data by CUI via ANAF public web services.
License MIT
Homepage https://github.com/ValsiS/ro-company-lookup

Keywords package laravel company lookup CUI Romania anaf

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 valsis/ro-company-lookup

Informations about the package ro-company-lookup

Ro Company Lookup

A production-ready Laravel package that retrieves Romanian company data by CUI from ANAF public web services. It returns clean DTOs, supports batching, caching, retries, circuit breaker, schema audit, and a very simple developer experience.

Requirements

PHP 8.3+
Laravel 12+

Compatibility

PHP	Laravel	CI
8.3	12.x
8.5	12.x

Quick start

Example response:

Installation

Publish the config file (optional):

Configuration

All configuration lives in config/ro-company-lookup.php.

Core options:

driver: active driver, default anaf
timezone: default query date timezone, default Europe/Bucharest
language: output key naming, ro or en

Date formatting:

date_output_format: fallback output format for dates (default Y-m-d)
date_output_formats: per-language formats (default ro => d.m.Y, en => Y-m-d)

HTTP + ANAF:

anaf.base_url, anaf.endpoint, anaf.timeout, anaf.connect_timeout
anaf.retries, anaf.backoff_ms, anaf.user_agent

Cache + resilience:

cache_store, cache_prefix, cache_version
cache_ttl_seconds, stale_ttl_seconds
use_locks, lock_seconds, lock_wait_seconds
throttle_seconds (optional per-CUI guard)

Observability + safety:

logging.enabled, logging.channel, logging.level
schema_audit.enabled, schema_audit.fail_on_unknown, schema_audit.snapshot_path
circuit_breaker.enabled, circuit_breaker.failure_threshold, circuit_breaker.cooldown_seconds

Raw payloads:

enable_raw (include raw ANAF payloads in meta.raw)

Usage

Standard lookup

The lookup accepts RO123, ro 123, or 123 and normalizes to an integer CUI. By default, the query date is "today" in Europe/Bucharest.

ANAF mapping is strict to the v9 payload fields (date_generale, inregistrare_scop_Tva, adresa_domiciliu_fiscal, adresa_sediu_social, etc.). Legacy/alternate key names are intentionally not mapped.

Non-throwing API

Summary helpers (simplest UX)

Batch helpers

Validation / normalization

After normalization, the CUI must be between 2 and 10 digits. Invalid input returns standardized error codes such as invalid_cui, invalid_cui_too_short, or invalid_cui_too_long.

Date formatting (global + per request)

Global (config):

Per request override:

DTO structure (high level)

The main response is CompanySimpleData:

company (CUI, names, trade register, profile)
caen (primary CAEN)
address (fiscal + registered office)
contact (phones, emails)
legal (current + history)
vat (current + history)
vat_collection (TVA la incasare)
inactive_status (inactiv/reactivat)
split_vat
meta (source, query date, cache status, raw)

Company profile (company.profile) includes:

registration_date
registration_status
fiscal_office
ownership_form
e_invoice_status
e_invoice_registration_date
iban

Output examples

Summary response

exists is true only when status is ok. valid indicates whether the CUI input passed validation.

Full response (excerpt, RO)

Caching, retries, and resilience

Results are cached by driver + CUI + date.
Default cache TTL is 24 hours.
When a request fails and a stale cache entry exists (within the configured stale TTL), the stale entry is returned with meta.is_stale = true.
Bump cache_version to invalidate cache after mapping changes.
Retries use exponential backoff and only trigger on 429 and 5xx responses.
Circuit breaker (optional) opens after repeated 5xx responses and cools down for a configurable interval.
Optional throttle_seconds guards rapid repeated queries per CUI.

Errors

The package throws typed exceptions for error scenarios:

InvalidCuiException for invalid input
LookupFailedException for upstream failures
CircuitOpenException when the circuit is open

For user-facing flows, prefer tryLookup() / trySummary() helpers.

Artisan commands

Example output (ro-company-lookup:check, fictive data):

Example output (ro-company-lookup:demo, fictive data):

Schema audit

Enable unknown-key detection and optional snapshots:

Documentation

Full docs: docs/wiki/Home.md
JSON Schemas: docs/schemas

Testing

Changelog

See CHANGELOG.md.

Contributing

See CONTRIBUTING.md. Dependabot is enabled.

Code of Conduct

See CODE_OF_CONDUCT.md.

Security

See SECURITY.md.

License

The MIT License (MIT). See LICENSE.

All versions of ro-company-lookup with dependencies

PHP Build Version

Package Version

Version v0.3.2 Release 28. Jan 2026
create-project require 0 people chose require and
0 people chose create-project.

Download

Download latest version of ro-company-lookup from vendor valsis

Requires php Version ^8.3
illuminate/cache Version ^12.0
illuminate/http Version ^12.0
illuminate/support Version ^12.0
spatie/laravel-data Version ^4.0
spatie/laravel-package-tools Version ^1.16

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 valsis/ro-company-lookup contains the following files

Loading the files please wait ...