README

A complete business logic toolkit for SAP Business One Service Layer integration in Laravel. Built on top of laravel-sapb1.

Features

Modules: Sales, Purchase, Inventory, Finance, Business Partner, Production, HR, Admin, Service

Key Capabilities

• Eloquent-like ORM - Query SAP B1 entities with familiar Laravel syntax
• UDF Support - Read/write User Defined Fields on any entity
• Local Caching - Priority-based cache with entity-level configuration
• Change Tracking - Polling-based change detection for SAP entities
• Local Database Sync - Sync SAP data to local database with soft deletes

Requirements

• PHP 8.4+
• Laravel 11.x or 12.x
• laravel-sapb1 ^1.0

Installation

composer require ismaildasci/laravel-sapb1-toolkit

php artisan vendor:publish --tag="sapb1-toolkit-config"

Quick Start

Eloquent-like Models

use SapB1\Toolkit\Models\Sales\Order;

$orders = Order::where('DocTotal', '>', 1000)
    ->where('DocumentStatus', 'bost_Open')
    ->orderBy('DocDate', 'desc')
    ->with('partner')
    ->get();

$order = Order::create([
    'CardCode' => 'C001',
    'DocumentLines' => [
        ['ItemCode' => 'ITEM001', 'Quantity' => 10, 'Price' => 100],
    ],
]);

Actions

use SapB1\Toolkit\Actions\Sales\OrderAction;

$orderAction = app(OrderAction::class);

$order = $orderAction->create([
    'CardCode' => 'C001',
    'DocumentLines' => [
        ['ItemCode' => 'ITEM001', 'Quantity' => 10, 'Price' => 100],
    ],
]);

$orderAction->close(123);

Builders

use SapB1\Toolkit\Builders\Sales\OrderBuilder;

$data = OrderBuilder::create()
    ->cardCode('C001')
    ->docDate('2024-01-15')
    ->addLine(fn ($line) => $line
        ->itemCode('ITEM001')
        ->quantity(10)
        ->price(100)
    )
    ->build();

Services

use SapB1\Toolkit\Services\DocumentFlowService;

$flow = app(DocumentFlowService::class);
$invoice = $flow->orderToInvoice(123);
$delivery = $flow->orderToDelivery(123);

UDF Support (v2.4+)

use SapB1\Toolkit\Models\Sales\Order;

$order = Order::find(123);

// Read UDFs
$value = $order->getUdf('CustomField');
$allUdfs = $order->getUdfs();

// Write UDFs
$order->setUdf('CustomField', 'value');
$order->save();

// Builder support
$data = OrderBuilder::create()
    ->cardCode('C001')
    ->udf('CustomField', 'value')
    ->build();

Local Cache (v2.5+)

use SapB1\Toolkit\Models\Inventory\Item;

// Query-level cache control
$item = Item::cache()->find('A001');           // Enable with default TTL
$item = Item::cache(600)->find('A001');        // 10 minute TTL
$item = Item::noCache()->find('A001');         // Disable cache

// Flush cache
Item::flushCache();
Item::forgetCached('A001');

Change Tracking (v2.6+)

use SapB1\Toolkit\ChangeTracking\ChangeTracker;

$tracker = ChangeTracker::for('Orders')
    ->primaryKey('DocEntry')
    ->detectCreated(true)
    ->detectUpdated(true);

$changes = $tracker->poll();

foreach ($changes as $change) {
    if ($change->isCreated()) {
        // Handle new order
    }
}

Local Database Sync (v2.7+)

# Create migrations for entities you want to sync
php artisan sapb1:sync-setup Items BusinessPartners Orders

# Run migrations
php artisan migrate

# Sync data
php artisan sapb1:sync Items                    # Incremental sync
php artisan sapb1:sync Items --full             # Full sync with delete detection
php artisan sapb1:sync-status                   # Check sync status

use SapB1\Toolkit\Sync\LocalSyncService;

$syncService = app(LocalSyncService::class);

// Sync to local database
$result = $syncService->sync('Items');
// SyncResult { created: 10, updated: 140, deleted: 0, duration: 1.23s }

// Full sync with soft delete detection
$result = $syncService->fullSyncWithDeletes('Items');

// Scheduler integration
$schedule->command('sapb1:sync Items')->hourly();
$schedule->command('sapb1:sync Items --full')->weekly();

Artisan Commands

Documentation

Directory Structure

src/
├── Actions/          # CRUD operations (110 files)
├── Builders/         # Fluent builders (122+ files)
├── DTOs/             # Data Transfer Objects (145+ files)
├── Models/           # Eloquent-like ORM (54 files)
├── Services/         # Business logic (17 files)
├── Enums/            # SAP B1 constants (36 files)
├── Cache/            # Caching infrastructure
├── ChangeTracking/   # Change detection system
├── Sync/             # Local database sync
├── Events/           # Document lifecycle events
├── Exceptions/       # Domain-specific exceptions
├── Rules/            # Laravel validation rules
├── Casts/            # Attribute casts
└── Commands/         # Artisan commands (7 files)

Testing

composer test        # Run tests
composer analyse     # Static analysis
composer format      # Code formatting

Changelog

See CHANGELOG.md for version history.

Contributing

See CONTRIBUTING.md for guidelines.

Security

Report vulnerabilities via security policy.

License

MIT License. See LICENSE.md for details.

Author: İsmail Daşcı