PHPackages                             asikam/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. asikam/softone

ActiveLibrary[Framework](/categories/framework)

asikam/softone
==============

A simple PHP Laravel package to interact with Softone ERP Web Services

v1.1.2(8mo ago)030MITPHPPHP ^8.2

Since Dec 9Pushed 8mo ago1 watchersCompare

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

READMEChangelog (3)DependenciesVersions (14)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

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 7.4 or higher
- Laravel 8.0 or higher

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

[](#installation)

You can install the package via composer:

```
composer require asikam/softone
```

After installing, publish the configuration file:

```
php artisan vendor:publish --provider="Asikam\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 Asikam\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 Asikam\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->data as $item) {
    echo $item['CUSTOMER.NAME'] . "\n";
    echo $item['CUSTOMER.AFM'] . "\n";
}
```

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

### 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
- `send()`: Sends the request to the Softone Web Services API

Examples
--------

[](#examples)

### Searching for Customers

[](#searching-for-customers)

```
use Asikam\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 Asikam\Softone\Softone;

$softone = new Softone();
$softone->setService('getData');
$softone->setObject('CUSTOMER');
$softone->setKey('1001'); // Customer ID
$softone->send();

$customer = $softone->data;
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.

For more information on how to use the Softone Web Services, please refer to the [official documentation](https://www.softone.gr/ws/).

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance59

Moderate activity, may be stable

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~21 days

Recently: every ~57 days

Total

13

Last Release

264d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/035c6e0212d710de05810b7ea7fb1fddc6e3f887a72ba86b39ebaab6e9af373c?d=identicon)[asikam](/maintainers/asikam)

---

Top Contributors

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

---

Tags

httpclientframeworkrestcurlhttp clientweb service

### Embed Badge

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

```
[![Health](https://phpackages.com/badges/asikam-softone/health.svg)](https://phpackages.com/packages/asikam-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

13348.3k](/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

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

PHPackages © 2026

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