PHPackages                             nikos-ioannidis/softone - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. nikos-ioannidis/softone

ActiveLibrary[Framework](/categories/framework)

nikos-ioannidis/softone
=======================

A PHP Laravel package to interact with Softone ERP Web Services

v1.0.2(4w ago)0183↑310%MITPHPPHP ^8.2

Since Jun 3Pushed 4w agoCompare

[ Source](https://github.com/nikos-ioannidis/softone)[ Packagist](https://packagist.org/packages/nikos-ioannidis/softone)[ RSS](/packages/nikos-ioannidis-softone/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependenciesVersions (4)Used By (0)

 Softone Web Services PHP Laravel Package
==========================================

[](#----softone-web-services-php-laravel-package)

 A Laravel package that makes it easy to consume Softone ERP Web Services REST API.

 **Disclaimer:** This is not an official package. Forked and extended from [asikam/softone](https://github.com/asikam/softone).

Table of Contents
-----------------

[](#table-of-contents)

- [Introduction](#introduction)
- [Requirements](#requirements)
- [Installation](#installation)
- [Configuration](#configuration)
- [Usage](#usage)
    - [Using SoftoneBrowser](#using-softonebrowser)
    - [Building Requests Step by Step](#building-requests-step-by-step)
- [Available Methods](#available-methods)
    - [SoftoneBrowser Methods](#softonebrowser-methods)
    - [Softone Core Methods](#softone-core-methods)
- [Examples](#examples)
- [Contributing](#contributing)
- [License](#license)

Introduction
------------

[](#introduction)

This package provides a simple and elegant way to interact with the Softone Web Services REST API in your Laravel applications. It handles authentication, request building, and response parsing, allowing you to focus on your application logic.

Official Softone Web Services documentation:

Requirements
------------

[](#requirements)

- PHP 8.2 or higher
- Laravel 10.0 or higher

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require nikos-ioannidis/softone
```

After installing, publish the configuration file:

```
php artisan vendor:publish --provider="NikosIoannidis\Softone\SoftoneServiceProvider"
```

Configuration
-------------

[](#configuration)

After publishing the configuration file, you can find it at `config/softone.php`. You'll need to set the following environment variables in your `.env` file:

```
COMPANY_AFM=your_company_afm
SOFTONE_URL=your_softone_url
SOFTONE_USER=your_username
SOFTONE_PASS=your_password
SOFTONE_APPID=your_app_id
SOFTONE_COMPANY=your_company_id
SOFTONE_BRANCH=your_branch_id
SOFTONE_MODULE=your_module_id
SOFTONE_REFID=your_ref_id

```

Usage
-----

[](#usage)

### Using SoftoneBrowser

[](#using-softonebrowser)

The `SoftoneBrowser` class provides a simplified interface for common operations:

```
use NikosIoannidis\Softone\SoftoneBrowser;

// Create a new instance
$softone = new SoftoneBrowser();

// Search for customers with a specific tax ID
$softone->search("CUSTOMER", 'CUSTOMER.AFM=000000000*=;');

// Or with named parameters
$softone->search(
    object: "CUSTOMER",
    filters: 'AFM=000000000=;',
    list: 'Web',
    start: 0,
    limit: 30
);

// Access the response data
foreach ($softone->responseData as $item) {
    echo $item['CUSTOMER.AFM'] . "\n";
    echo $item['CUSTOMER.NAME'] . "\n";
}
```

### Building The Request

[](#building-the-request)

For more control, you can use the core `Softone` class to build your requests:

```
use NikosIoannidis\Softone\Softone;

// Create a new instance
$softone = new Softone();

// Get browser information
$softone->setService('getBrowserInfo');
$softone->setObject('CUSTOMER');
$softone->setFilters('CUSTOMER.AFM=000000*=;');
$softone->send();

// Get browser data using the request ID from the previous request
$softone->setService('getBrowserData');
$softone->setReqId($softone->reqID);
$softone->limit(10);
$softone->send();

// Access the response data
foreach ($softone->responseData as $item) {
    echo $item['CUSTOMER.NAME'] . "\n";
    echo $item['CUSTOMER.AFM'] . "\n";
}
```

### Selector Services

[](#selector-services)

```
use NikosIoannidis\Softone\SoftoneBrowser;

$softone = new SoftoneBrowser();

// Get selector data
$softone->getSelectorData('CUSTOMER', 'search term');

// Get specific fields from a table record
$softone->selectorFields('CUSTOMER', 'CUSTID', 27, 'NAME,AFM');
```

Available Methods
-----------------

[](#available-methods)

### SoftoneBrowser Methods

[](#softonebrowser-methods)

- `search($object, $filters, $list, $start, $limit)`: Combines getBrowserInfo and getBrowserData in one call
- `info($object, $filters, $list)`: Gets browser information for a specific object
- `getBrowserInfo($object, $filters, $list)`: Gets browser information for a specific object
- `getBrowserData($start, $limit)`: Gets browser data with pagination
- `getData($object, $key)`: Gets data for a specific object with a key
- `getSelectorData($editor, $value)`: Returns data from a Selector of the application
- `selectorFields($tableName, $keyName, $keyValue, $resultFields)`: Returns specific fields from a table record

### Softone Core Methods

[](#softone-core-methods)

The core `Softone` class provides numerous methods for building and sending requests:

- `setService($service)`: Sets the service to call (e.g., getBrowserInfo, getBrowserData)
- `setUsername($username)`: Sets the username for authentication
- `setPass($password)`: Sets the password for authentication
- `setAppId($appId)`: Sets the application ID
- `setCompany($company)`: Sets the company ID
- `setBranch($branch)`: Sets the branch ID
- `setModule($module)`: Sets the module ID
- `setRefid($refid)`: Sets the reference ID
- `setClientID($clientID)`: Sets the client ID
- `setObject($object)`: Sets the object to query (e.g., CUSTOMER, ITEM)
- `setKey($key)`: Sets the key for getData requests
- `setFilters($filters)`: Sets the filters for browser requests
- `setList($list)`: Sets the list for browser requests
- `locate($locate)`: Sets the locate info softone parameter
- `start($start)`: Sets the start parameter for pagination
- `limit($limit)`: Sets the limit parameter for pagination
- `setReqId($reqID)`: Sets the request ID for getBrowserData requests
- `setRequestData($data)`: Sets the request data
- `setEditor($editor)`: Sets the editor key for getSelectorData
- `setEditorValue($value)`: Sets the editor value for getSelectorData
- `setTableName($tableName)`: Sets the table name for selectorFields
- `setKeyName($keyName)`: Sets the key field name for selectorFields
- `setKeyValue($keyValue)`: Sets the key field value for selectorFields
- `setResultFields($resultFields)`: Sets comma-separated result fields for selectorFields
- `send()`: Sends the request to the Softone Web Services API

Examples
--------

[](#examples)

### Searching for Customers

[](#searching-for-customers)

```
use NikosIoannidis\Softone\SoftoneBrowser;

$softone = new SoftoneBrowser();
$softone->search("CUSTOMER", 'CUSTOMER.NAME=*Company*=;');

foreach ($softone->responseData as $item) {
    echo "Customer ID: " . $item['CUSTOMER.CODE'] . "\n";
    echo "Customer Name: " . $item['CUSTOMER.NAME'] . "\n";
    echo "Tax ID: " . $item['CUSTOMER.AFM'] . "\n";
    echo "-------------------\n";
}
```

### Getting a Specific Customer by ID

[](#getting-a-specific-customer-by-id)

```
use NikosIoannidis\Softone\SoftoneBrowser;

$softone = new SoftoneBrowser();
$softone->getData('CUSTOMER', '1001');

$customer = $softone->response;
echo "Customer Name: " . $customer->NAME . "\n";
echo "Tax ID: " . $customer->AFM . "\n";
```

Contributing
------------

[](#contributing)

Contributions are welcome! Please feel free to submit a Pull Request.

License
-------

[](#license)

This package is open-sourced software licensed under the [MIT license](LICENSE).

Originally forked from [asikam/softone](https://github.com/asikam/softone).

###  Health Score

44

—

FairBetter than 90% of packages

Maintenance94

Actively maintained with recent releases

Popularity15

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 86.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~11 days

Total

3

Last Release

29d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a17855d41d909a930d4bc26126569ad84add83de8e6fbedf0606d0111eab4224?d=identicon)[nikos-ioannidis](/maintainers/nikos-ioannidis)

---

Top Contributors

[![asikam](https://avatars.githubusercontent.com/u/15692972?v=4)](https://github.com/asikam "asikam (51 commits)")[![nikos-ioannidis](https://avatars.githubusercontent.com/u/2659772?v=4)](https://github.com/nikos-ioannidis "nikos-ioannidis (8 commits)")

---

Tags

httpclientframeworkrestcurlhttp clientweb serviceERPsoftone

### Embed Badge

![Health badge](/badges/nikos-ioannidis-softone/health.svg)

```
[![Health](https://phpackages.com/badges/nikos-ioannidis-softone/health.svg)](https://phpackages.com/packages/nikos-ioannidis-softone)
```

###  Alternatives

[eightpoints/guzzle-wsse-middleware

WSSE Middleware for Guzzle, a PHP HTTP client library and framework for building RESTful web service clients

312.1M5](/packages/eightpoints-guzzle-wsse-middleware)[gregurco/guzzle-bundle-oauth2-plugin

OAuth2 Plugin for Guzzle Bundle, a PHP HTTP client library and framework for building RESTful web service clients

13360.4k](/packages/gregurco-guzzle-bundle-oauth2-plugin)[gregurco/guzzle-bundle-cache-plugin

Cache Plugin for Guzzle Bundle, a PHP HTTP client library and framework for building RESTful web service clients

11400.9k1](/packages/gregurco-guzzle-bundle-cache-plugin)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)