Download the PHP package fakturoid/fakturoid-php without Composer

Fakturoid PHP lib


PHP library for Fakturoid.cz. Please see API for more documentation. New account just for testing API and using separate user (created via "Settings > User account") for production usage is highly recommended.

Content

• Versions
• Installation

• Authorization by OAuth 2.0

  • Authorization Code Flow
  • Client Credentials Flow
• Usage
  • Set credentials to the Fakturoid manager
  • Switch account
  • Basic usage
  • Downloading an invoice PDF
  • Using custom_id
  • InventoryItem resource
• Handling errors
  • Common problems
• Development
  • Docker
  • Testing
  • Code-Style Check
  • Check all requires for PR

Versions

Installation

The recommended way to install is through Composer:

Library requires PHP 8.2 (or later) and ext-json, nyholm/psr7 and psr/http-client extensions.

User agent and HTTP client

You need to create your own client that implements Psr\Http\Client\ClientInterface or you can use symfony/http-client, guzzlehttp/guzzle or other. And you also need to set a default header value for this client, where you need to specify User-Agent.

Creating a client using Guzzle

Create a client using Symfony

In Symfony app you can define in configuration

Authorization by OAuth 2.0

Authorization Code Flow

Authorization using OAuth takes place in several steps. We use data obtained from the developer portal as client ID and client secret (Settings → Connect other apps → OAuth 2 for app developers).

First, we offer the user a URL address where he enters his login information. We obtain this using the following method:

After entering the login data, the user is redirected to the specified redirect URI and with the code with which we obtain his credentials. We process the code as follows:

Credentials are now established in the object instance and we can send queries to the Fakturoid api. Credentials can be obtained in 2 ways. Obtaining credentials directly from the object:

Client Credentials Flow

Processing credentials using the credentials callback:

The way callback works is that the library calls the callback function whenever the credentials are changed. This is useful because the token is automatically refreshed after its expiration.

Usage

Set credentials to the Fakturoid manager

If you run a multi-tenant application or an application that processes documents in parallel, you need to set Credentials correctly. Each time a new access token is obtained, the previous one is invalidated. For these needs there is AuthProvider::setCredentials() and also CredentialCallback.

Switch account

Basic usage

Downloading an invoice PDF

If you call $fManager->getInvoicesProvider()->getPdf() right after creating an invoice, you'll get a status code 204 (No Content) with empty body, this means the invoice PDF hasn't yet been generated and you should try again a second or two later.

More info in API docs.

Using custom_id

You can use custom_id attribute to store your application record ID into our record. Invoices and subjects can be filtered to find a particular record:

As for subjects, Fakturoid won't let you create two records with the same custom_id so you don't have to worry about multiple results. Also note that the field always returns a string.

InventoryItem resource

To get all inventory items:

To filter inventory items by certain SKU code or article number:

To search inventory items (searches in name, article_number and sku):

To get all archived inventory items:

To get a single inventory item:

To create an inventory item:

To update an inventory item:

To archive an inventory item:

To unarchive an inventory item:

To delete an inventory item:

InventoryMove resource

To get get all inventory moves across all inventory items:

To get inventory moves for a single inventory item:

To get a single inventory move:

To create a stock-in inventory move:

To create a stock-out inventory move:

To update an inventory move:

To delete an inventory move:

Handling errors

Library raises Fakturoid\Exception\ClientErrorException for 4xx and Fakturoid\Exception\ServerErrorException for 5xx status. You can get response code and response body by calling getCode() or getResponse()->getBody().

Common problems

• In case of problem please contact our invoicing robot on [email protected].

Development

• To run tests, PHPUnit requires ext-dom extension (typically a php-xml package on Debian) and ext-mbstring extension (php-mbstring package).
• If you wish to generate code coverage (and have more intelligent stack traces), you will need Xdebug (php-xdebug package), it will hook itself into PHPUnit automatically.

Docker

Testing

Both commands do the same but the second version is a bit faster.

Code-Style Check

Both commands do the same but the second version seems to have a more intelligent output.

Check all requires for PR

Or you can fix CS and Rector issues automatically: