README

The Invoicetronic API is a RESTful service that allows you to send and receive invoices through the Italian Servizio di Interscambio (SDI), or Interchange Service. The API is designed to be simple and easy to use, abstracting away SDI complexity while providing complete control over the invoice send/receive process. It provides advanced features as encryption at rest, multi-language pre-flight invoice validation, multiple upload formats, webhooks, event logging, client SDKs, and CLI tools.

For more information, see Invoicetronic website

Before you start

For the full integration guide, tutorials, SDKs and quickstarts, see the Documentation. A few cross-cutting topics worth knowing before integrating:

• Prerequisites — what you need to start in Sandbox and what's required to move to production.
• API Keys — how ik_live_ and ik_test_ keys select the environment.
• Sandbox — free test environment that mirrors the live workflow, with no credits consumed.
• Rate Limiting — per-second, per-minute and per-day limits; how to handle 429 Too Many Requests.
• Pagination — page and page_size parameters and the Invoicetronic-Total-Count response header.
• CORS — calling the API from the browser; allowed origins are configured per key.
• Webhooks — real-time event notifications with HMAC-SHA256 signature validation.
• Localization — use the Accept-Language header to receive error messages in Italian, English or German.

For more information, please visit https://invoicetronic.com/en/contact/.

Installation & Usage

Requirements

PHP 7.4 and later. Should also work with PHP 8.0.

Composer

To install the bindings via Composer, run the following command:

$ composer require invoicetronic/php-sdk

Then run composer install

Manual Installation

There are three options:

• Download the latest release of the PHP SDK Phar Archive and simply include it in your project.

require_once('./invoicetronic-sdk.phar');

• Download our SDK using PHP-download and simply include it in your project.
• Create your own custom autoloader and download all the dependencies (transitive included) as explained here.

## Getting Started

Please follow the [installation procedure](#installation--usage) and then run the following:

```php
<?php
require_once(__DIR__ . '/vendor/autoload.php');



// Configure HTTP basic authorization: Basic
$config = Invoicetronic\Configuration::getDefaultConfiguration()
              ->setUsername('YOUR_USERNAME')
              ->setPassword('YOUR_PASSWORD');

$apiInstance = new Invoicetronic\Api\CompanyApi(
    // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
    // This is optional, `GuzzleHttp\Client` will be used as default.
    new GuzzleHttp\Client(),
    $config
);
$page = 1; // int | Page number.
$page_size = 100; // int | Items per page. Cannot be greater than 200.
$sort = 'sort_example'; // string | Sort by field. Prefix with '-' for descending order.
$q = 'q_example'; // string | Full-text search across committente, prestatore, identifier, and file name.

try {
    $result = $apiInstance->companyGet($page, $page_size, $sort, $q);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling CompanyApi->companyGet: ', $e->getMessage(), PHP_EOL;
}

API Endpoints

All URIs are relative to http://localhost

Models

• Company
• DocumentData
• Error
• Event
• ProblemDetails
• Receive
• Send
• SendReduced
• Status
• Update
• WebHook
• WebHookHistory

Authorization

Authentication schemes defined for the API:

Basic

• Type: HTTP basic authentication

Tests

To run the tests, use:

composer install
vendor/bin/phpunit

Author

info@invoicetronic.com

About this package

This PHP package is automatically generated by the OpenAPI Generator project:

• API version: 1.14.0
  • Generator version: 7.20.0
• Build package: org.openapitools.codegen.languages.PhpClientCodegen