Download the PHP package wdev-rs/netracuni-php without Composer
On this page you can find all versions of the php package wdev-rs/netracuni-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download wdev-rs/netracuni-php
More information about wdev-rs/netracuni-php
Files in wdev-rs/netracuni-php
Package netracuni-php
Short Description PHP library for NetRacuni API
License MIT
Homepage https://github.com/wdev-rs/netracuni-php
FAQ
Example:
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 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.
Informations about the package netracuni-php
NetRačuni PHP SDK
The NetRačuni PHP sdk makes it easy to use the NetRačuni API from any PHP based webshop. It supports all the features from the API, easy to use and compatible with PHP version >= 7.4
Installation
You can install the package via composer:
Dependencies
The NetRačuni client depends on the Guzzle library. If you use composer it will be installed automatically.
Usage
To use the API, you need to create a token in your NetRačuni account. Please consult the documentation how to do it.
When you have the token, you can start the integration by creating an instance of the NetRačuni client:
Using sandbox or production
During development and testing you can use the sandbox environment. The client automatically recognises the token and sets up the correct endpoint urls. If you want to make sure you are using the correct environment use the following methods:
Switch to sandbox:
Switch to production
Check the settings
Using the ping method you can check the connection with the NetRačuni API and
also check if the settings in your account are correct.
The method returns boolean, or throws an error when something went wrong.
Get the tax labels
You can get the actual tax labels from the API, which returns the actual tax labels from the server of the tax authority.
The method returns an array with the tax labels, or throws an exception if an error occurred.
Example response from the sandbox:
To create and invoice with the NetRačuni client use the createInvoice method.
Please note that by using the API you can only create sale invoice (promet prodaja).
The argument is an array which defines the products what you will have on the invoice.
IMPORTANT: The taxLabels needs to be an array, and the letters have to correspond to the labels received from the
getTaxLabels method. In production all the tax labels MUST use cyrillic letters, even if some letters look the same
on cyrillic and latin these are not the same (for example tax label "A").
The result is an instance of the WdevRs\NetRacuniPhp\InvoiceResponse
To get the invoice in pdf format use the getInvoicePdfUrl method. It returns the url of the pdf what you can download or open in a new browser window.
To retrieve all the invoice data received from the server of the tax authority use
the getInvoice method.
While it is not mandatory we highly encourage you to store both the invoice data and the pdf url, and connect it to the order in your webshop.
Error handling
The NetRačuni Client transform the errors received from the API to PHP exceptions. You can simply catch the exception, and the exception message will tell you what the actual problem is. For more details about the possible error messages, please check the documentation.
Testing
Changelog
Please see CHANGELOG for more information what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Credits
- Daniel Werner
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
PHP Package Boilerplate
This package was generated using the PHP Package Boilerplate by Beyond Code.
