ahmadi/laravel-sepidar

Laravel package for integrating with Sepidar (سپیدار) accounting software API

dev-main 2026-07-11 08:49 UTC

Requires

• php: ^8.1
• ext-openssl: *
• illuminate/console: ^10.0|^11.0|^12.0
• illuminate/contracts: ^10.0|^11.0|^12.0
• illuminate/http: ^10.0|^11.0|^12.0
• illuminate/support: ^10.0|^11.0|^12.0

Requires (Dev)

• orchestra/testbench: ^8.0|^9.0|^10.0
• phpunit/phpunit: ^10.0|^11.0

MIT

• Ahmadi

• api
• laravel
• Accounting
• sepidar
• سپیدار

Published on Packagist.org on 2026-07-11 08:49 UTC

README

پکیج لاراول برای اتصال ساده به API نرم‌افزار سپیدار.

نصب

composer require ahmadi/laravel-sepidar
php artisan vendor:publish --tag=sepidar-config

تنظیمات .env

SEPIDAR_BASE_URL=http://192.168.20.15:7373
SEPIDAR_USERNAME=admin
SEPIDAR_PASSWORD=your_password
SEPIDAR_GENERATION_VERSION=111
SEPIDAR_DEVICE_SERIAL=100079d4

سریال ۸ کاراکتری را از نرم‌افزار سپیدار → بخش «سفارش‌گیری» → تعریف دستگاه بگیرید.

راه‌اندازی

php artisan sepidar:setup

دستور به‌صورت تعاملی هر ۵ مورد را می‌پرسد (یا از .env پیش‌فرض می‌گیرد):

php artisan sepidar:setup \
  --url=http://192.168.20.15:7373 \
  --username=admin \
  --password=secret \
  --version=111 \
  --serial=100079d4

پکیج خودکار Register، ذخیره credentials و Login را انجام می‌دهد.

مهاجرت از spidar.json قدیمی

SEPIDAR_LEGACY_JSON_PATH=D:/path/to/spidar.json

استفاده

use Ahmadi\LaravelSepidar\Facades\Sepidar;

$customers = Sepidar::customers()->all();
$items = Sepidar::items()->all();

APIها

customers() · items() · quotations() · invoices() · receipts() · currencies() · stocks() · saleTypes() · priceNoteItems() · administrativeDivisions() · customerGroupings() · units() · properties() · banks() · bankAccounts()

MIT