Download the PHP package beziworld/laravel-company-data without Composer
On this page you can find all versions of the php package beziworld/laravel-company-data. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download beziworld/laravel-company-data
More information about beziworld/laravel-company-data
Files in beziworld/laravel-company-data
Package laravel-company-data
Short Description Polish company data for Laravel: GUS REGON (BIR) lookup, VAT white list (Biała lista) with bank account checks and EU VIES validation.
License MIT
Homepage https://github.com/beziworld/laravel-company-data
Informations about the package laravel-company-data
Laravel Company Data
Polish and EU company data for Laravel from three official sources:
- GUS REGON (BIR 1.1/1.2): company name, address, type and full reports by NIP, REGON or KRS
- VAT white list (Wykaz podatników VAT): VAT status, registered bank accounts and account checks with a request id as evidence
- VIES: validation of EU VAT numbers
Polska wersja dokumentacji
Installation
The white list and VIES need no keys. Lookups are cached for 12 hours (the white list allows only 100 searches a day per IP address).
GUS
Sessions are opened on demand, cached for 55 minutes and renewed automatically when GUS expires them.
VAT white list
Paying an invoice above PLN 15,000 to an account that is not on the white list can make the payer jointly liable
for the supplier's VAT and excludes the expense from tax costs. Store requestId with the payment.
The API moved to wykazpodatnikowvat.mf.gov.pl in October 2026 (the old wl-api.mf.gov.pl stops on 1 December
2026); the package uses the new host by default.
VIES
National systems are often temporarily unavailable or rate limited (MS_UNAVAILABLE, MS_MAX_CONCURRENT_REQ).
Such errors are retried and, if they persist, thrown as ViesException with isTemporary() === true. An invalid
number is not an exception: it returns valid === false.
Usage examples
Fill in the company form from NIP
Verify a supplier before paying
Reverse charge for EU customers
Combine it with beziworld/laravel-polish-validation to validate the NIP checksum before calling the APIs.
Exceptions
GusException, WhiteListException (errorCode() such as WL-191, isLimitExceeded(), isTemporary()) and
ViesException (errorCode(), isTemporary()), all extending CompanyDataException.
Development
Author
Created and maintained by Kamil Ćwiertnia, beziworld.eu.
- E-mail: [email protected]
- Issues: GitHub issues
Need a B2B integration or a custom Laravel project? Get in touch through beziworld.eu.
Other packages by the author
laravel-polish-validation · laravel-polish-calendar · laravel-nbp · laravel-przelewy24 · laravel-tpay · laravel-smsapi · laravel-directadmin
License
MIT. See LICENSE.md. Data sources: Statistics Poland (GUS), Ministry of Finance, European Commission. This package is not affiliated with any of them.
All versions of laravel-company-data with dependencies
ext-json Version *
ext-dom Version *
ext-libxml Version *
guzzlehttp/guzzle Version ^7.8
illuminate/contracts Version ^12.0|^13.0
illuminate/http Version ^12.0|^13.0
illuminate/support Version ^12.0|^13.0