Download the PHP package rrd108/nav-m2m without Composer

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

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 rrd108/nav-m2m

Informations about the package nav-m2m

NAV-M2M PHP SDK

Ez a PHP SDK (Software Development Kit) a Nemzeti Adó- és Vámhivatal (NAV) által biztosított M2M (Machine-to-Machine) interfészhez való kapcsolódást segíti. Az SDK lehetővé teszi a gépi kommunikációt a NAV rendszereivel, például bizonylatok beküldéséhez.

Ha a csomag hasznos volt a számodra, akkor nyomj rá a star-ra!

Telepítés

  1. Composer használata: A legkényelmesebb mód az SDK telepítésére a Composer használata:

  2. Követelmények:
    • PHP 8.0 vagy újabb
    • Composer

Használat

A minta.php fájlban található példák segítségével megismerheted az SDK használatát.

Inicializálás

Először létre kell hozni egy NavM2m objektumot a megfelelő beállításokkal:

Ahol:

Felhasználó aktiválása

Minden felhasználót aktiválni kell először annak érdekében, hogy a kliensprogramunk hozzáférhessen a NAV rendszeréhez. Az aktiválást csak egyszer kell végrehajtani egy felhasználó esetén. Az aktiválás során megkapjuk a felhasználóhoz tartozó aláírókulcsot, amelyet el kell tárolni.

A felhasználó aktiválásához a következő lépéseket kell végrehajtani:

  1. Inaktív felhasználó adatai: A felhasználói regisztráció során a felhasznló számára az UPO-ról kiküldött, a felhasználó saját tárhelyére érkezet API kulcsból nyerjük ki az adatokat:

  2. Token igénylése: Az aktiváláshoz először egy tokent kell igényelni az inaktív felhasználóval:

  3. Felhasználó aktiválása: Aktiválja a felhasználót, és megkapja a felhasználóhoz tartozó titkos aláírókulcsot:

Bizonylat beadás folyamata

  1. Token igénylése a createToken() függvény segítségével. Egy token 10 percig érvényes.
  2. Fájl feltöltése az addFile() függvény segítségével. A következő lépés feltétele, hogy a result_code legyen UPLOAD_SUCCESS és a virusScanResultCode legyen PASSED. Ha nincs virusScanResultCode vagy az értékeWAITING , akkor pár másodperc várakozás után a fájl státuszát le kell kérdezni a getFileStatus() függvény segítségével.
  3. Bizonylat létrehozása a createDocument() függvény segítségével. A következő lépés feltétele, hogy a result_code legyen CREATE_DOCUMENT_SUCCESS és a documentStatus legyen VALIDATED. Ha a documentStatus értéke UNDER_PREVALIDATION vagy UNDER_VALIDATION, akkor pár másodperc várakozás után a getDocument() függvény segítségével le kell kérdezni a bizonylat státuszát.
  4. Bizonylat érkeztetése az updateDocument() függvény segítségével amely visszatérési értékében tartalmaz egy arrivalNumber értéket, amely a beküldés eredményét jelzi. Ha a documentStatus értéke UNDER_SUBMIT akkor pár másodperc várakozás után a getDocument() függvény segítségével le kell kérdezni a bizonylat státuszát.

A bizonylatokkal kapcsolatos kommunikáció DB-ban való tárolásához a következő mezőkre van szükség

Fájl feltöltése

Bizonylatfájl feltöltése:

A $result hibák kezelésére a minta.php fájlban találsz példát.

Bizonylat létrehozása/validálása

A bizonylat létrehozása és validálása:

A $result hibák kezelésére a minta.php fájlban találsz példát.

Bizonylat érkeztetése

A createDocument függvény után a bizonylat érkeztetése:

A $result hibák kezelésére a minta.php fájlban találsz példát.

Egyszerűsített foglalkoztatási adatok lekérdezése

getEgyszerusitettFoglalkoztatas

Egy adott foglalkoztatott egyszerűsített foglalkoztatási adatainak lekérdezése.

A tajNumber paraméter opcionális. Ha nincs megadva, a lekérdezés TAJ szám nélkül történik.

getEgyszerusitettFoglalkoztatasFoglalkoztatottLista

Egy adott foglalkoztató (munkáltató) egyszerűsített foglalkoztatotti listájának lekérdezése adott évre.

Loggolás

A log kiírja a standard outputra a kéréseket és a válaszokat, ami hasznos lehet a hibakeresés során. A loggolást az objektum létrehozásakor be kapcsolhatod, alapértelmezetten ki van kapcsolva.

Lehetőség van saját logger függvény használatára is. Ebben az esetben a log üzenetek nem a standard outputra íródnak ki, hanem a megadott függvény kapja meg őket:

Támogatás

Ha bármilyen kérdésed vagy problémád van, nyiss egy issue-t.

NAV M2M repo

All versions of nav-m2m with dependencies

PHP Build Version
Package Version
Requires php Version >=8.0
ramsey/uuid Version ^4.7
vlucas/phpdotenv Version ^5.5
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 rrd108/nav-m2m contains the following files

Loading the files please wait ...