leventcz / parasut-php

v1.1.2 2024-09-07 14:26 UTC

Requires

• php: ^8.2
• guzzlehttp/guzzle: ^7.0.0

Requires (Dev)

• laravel/pint: ^1.5.0
• pestphp/pest: ^2.0.0
• pestphp/pest-plugin-mock: ^2.0.0
• phpstan/phpstan: ^1.9
• symfony/var-dumper: ^6.2

MIT

• Levent Çorapsız

• php
• sdk
• parasut

Published on Packagist.org on 2024-09-07 14:27 UTC

README

Parasut PHP API Client

Modern PHP API client that allows you to interact with the Parasut API v4

Installation

Requires PHP 8.2+

composer require leventcz/parasut-php

Usage

Initializing Client

$credentials = [
    'client_id' => 'YOUR_CLIENT_ID',
    'client_secret' => 'YOUR_CLIENT_SECRET',
    'company_id' => 'YOUR_COMPANY_ID',
    'username' => 'YOUR_USERNAME',
    'password' => 'YOUR_PASSWORD'
];

$client = Parasut::client($credentials);

Examples

// paginate through sales invoices
$salesInvoices = $client
    ->salesInvoice()
    ->index(['page' => ['size' => 10, 'number' => 4]]);

$salesInvoices['data']; // array of sales invoices   
$salesInvoices['meta']; // pagination meta

// retrieve the specified sales invoice with its payments
$salesInvoice = $client
    ->salesInvoice()
    ->show($id, ['include' => 'payments']);

$salesInvoice['data']; // sales invoice
$salesInvoice['included']; // array of payments

Methods & Parameters

The methods fully follow the naming conventions of their related endpoints and take required and optional parameters as arguments.

// POST | https://api.parasut.com/v4/{company_id}/contacts/{id}/contact_debit_transactions
$client
    ->contact()
    ->contactDebitTransactions($id, $query, $body)

// PATCH | https://api.parasut.com/v4/{company_id}/employees/{id}/archive
$client
    ->employee()
    ->archive($id, $query)

API Reference

Resource	Reference
salesInvoice()	https://apidocs.parasut.com/#tag/SalesInvoices
contact()	https://apidocs.parasut.com/#tag/Contacts
purchaseBill()	https://apidocs.parasut.com/#tag/PurchaseBills
bankFee()	https://apidocs.parasut.com/#tag/BankFees
salary()	https://apidocs.parasut.com/#tag/Salaries
tax()	https://apidocs.parasut.com/#tag/Taxes
employee()	https://apidocs.parasut.com/#tag/Employees
eInvoiceInbox()	https://apidocs.parasut.com/#tag/EInvoiceInboxes
eArchive()	https://apidocs.parasut.com/#tag/EArchives
eInvoice()	https://apidocs.parasut.com/#tag/EInvoices
eSmm()	https://apidocs.parasut.com/#tag/ESmms
account()	https://apidocs.parasut.com/#tag/Accounts
transaction()	https://apidocs.parasut.com/#tag/Transactions
product()	https://apidocs.parasut.com/#tag/Products
warehouse()	https://apidocs.parasut.com/#tag/Warehouses
shipmentDocument()	https://apidocs.parasut.com/#tag/ShipmentDocuments
stockMovement()	https://apidocs.parasut.com/#tag/StockMovements
inventoryLevel()	https://apidocs.parasut.com/#tag/InventoryLevels
itemCategory()	https://apidocs.parasut.com/#tag/ItemCategories
tag()	https://apidocs.parasut.com/#tag/Tags
tracableJob()	https://apidocs.parasut.com/#tag/TrackableJobs

License

Parasut PHP is an open-sourced software licensed under the MIT license.