{"id":42069801,"url":"https://github.com/theposeidonas/laravel-parasut-api","last_synced_at":"2026-01-26T08:38:41.903Z","repository":{"id":218185883,"uuid":"745532975","full_name":"theposeidonas/laravel-parasut-api","owner":"theposeidonas","description":"Laravel için yazılmış Paraşüt V4 paketi","archived":false,"fork":false,"pushed_at":"2025-03-07T19:18:42.000Z","size":126,"stargazers_count":11,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-23T17:56:19.194Z","etag":null,"topics":["laravel","parasut","php"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/theposeidonas.png","metadata":{"files":{"readme":"README.en.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["theposeidonas"]}},"created_at":"2024-01-19T14:43:33.000Z","updated_at":"2025-07-22T08:33:07.000Z","dependencies_parsed_at":"2025-03-07T20:22:23.617Z","dependency_job_id":"5f01da87-c139-4028-bfb4-5ec610a3c504","html_url":"https://github.com/theposeidonas/laravel-parasut-api","commit_stats":null,"previous_names":["theposeidonas/laravel-parasut-api"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/theposeidonas/laravel-parasut-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theposeidonas%2Flaravel-parasut-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theposeidonas%2Flaravel-parasut-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theposeidonas%2Flaravel-parasut-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theposeidonas%2Flaravel-parasut-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theposeidonas","download_url":"https://codeload.github.com/theposeidonas/laravel-parasut-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theposeidonas%2Flaravel-parasut-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28771107,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-26T08:38:24.014Z","status":"ssl_error","status_checked_at":"2026-01-26T08:38:22.080Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["laravel","parasut","php"],"created_at":"2026-01-26T08:38:40.477Z","updated_at":"2026-01-26T08:38:41.893Z","avatar_url":"https://github.com/theposeidonas.png","language":"PHP","funding_links":["https://github.com/sponsors/theposeidonas"],"categories":[],"sub_categories":[],"readme":"\u003ca name=\"readme-top\"\u003e\u003c/a\u003e\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![MIT License][license-shield]][license-url]\n[![LinkedIn][linkedin-shield]][linkedin-url]\n\n\n\n\n\u003c!-- PROJECT LOGO --\u003e\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://istanbulwebtasarim.pro\"\u003e\n    \u003cimg src=\"https://istanbulwebtasarim.pro/images/istanbul-web-tasarim-logo.webp\" alt=\"İstanbul Web Tasarım\" style=\"width: 40%\"\u003e\n  \u003c/a\u003e\n\n\u003ch3 align=\"center\"\u003eParaşüt API Laravel Package\u003c/h3\u003e\n\n[![Laravel][Laravel.com]][Laravel-url]\n![Packagist Downloads (custom server)][downloads-url]\n![Tests](https://img.shields.io/github/actions/workflow/status/theposeidonas/laravel-parasut-api/phpunit.yml?style=for-the-badge\u0026logo=github)\n\n\n\n  \u003cp align=\"center\"\u003e\n   Paraşüt V4 API package for Laravel.\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/theposeidonas/laravel-parasut-api\"\u003e\u003cstrong\u003eDocumentation »\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/theposeidonas/laravel-parasut-api\"\u003eDemo\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/theposeidonas/laravel-parasut-api/issues\"\u003eBugs\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/theposeidonas/laravel-parasut-api/issues\"\u003eIssues\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n# Laravel Paraşüt API\n\nThis project is a package created for Laravel that allows you to easily connect with the Paraşüt V4 API. Once you enter your Paraşüt API details into the .env file, you can easily run any function you want anywhere without repeatedly dealing with Auth processes.\n\nTürkçe dökümanı okuman için lütfen README.md dosyasına gidin.\n\n### Why is it needed?\n\nThere are almost no fast and simple Paraşüt API packages written for Laravel. We needed a clean package that automatically handles OAuth2 processes, retrieves a new token if the previous one has expired, and allows you to simply write the operation you need in the Controller.\n\nPlease report any bugs and issues through the Issues section.\n\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eBack to top\u003c/a\u003e)\u003c/p\u003e\n\n\n## Starting\n\nBe sure to contact Paraşüt and obtain the necessary information. This applies to both trial and regular accounts.\n\n\n### Adding to your project\n\nOpen the terminal in your Laravel project and run the following command;\n\n```shell\ncomposer require theposeidonas/laravel-parasut-api\n```\n\nIf needed, run the following command to share the config file;\n\n```shell\nphp artisan vendor:publish --tag=parasut-config --force\n```\n\nIf you are using an older version of Laravel or have Auto-Discovery disabled, add the following code to the 'aliases' section of the config/app.php file to use it everywhere;\n\n```php\n'Parasut' =\u003e Theposeidonas\\LaravelParasutApi\\Facades\\Parasut::class,\n```\n\n### Configuration\n\nAfter adding it to your project, you need to add and adjust the following lines in the .env file:\n```dotenv\nPARASUT_USERNAME=\"demo@parasut.com\"  // Username\nPARASUT_PASSWORD=\"XXXXXXXXX\"  // Password\nPARASUT_COMPANY_ID=\"123123\" // Company ID\nPARASUT_CLIENT_ID=\"XXXXXXXXXXXXXXXXX\" // Paraşüt Client ID\nPARASUT_CLIENT_SECRET=\"XXXXXXXXXXXXXXXXX\" // Paraşüt Client Secret\nPARASUT_REDIRECT_URI=\"urn:ietf:wg:oauth:2.0:oob\" // Paraşüt Redirect URI, değiştirmenize gerek yok \n```\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eBack to top\u003c/a\u003e)\u003c/p\u003e\n\n\n## Usage\n\nYou need to include the package in the Controller you will use:\n\n```php   \nuse Theposeidonas\\LaravelParasutApi\\Facades\\Parasut;\n```\n\n#### Models\nAfter completing all the settings and configurations, you can call certain classes in the Controller you will use. These classes are as follows:\n\n```php\n/* Sales */\nParasut::Bill();            // Sales Invoice            https://apidocs.parasut.com/#tag/SalesInvoices\nParasut::Customer();        // Customer                 https://apidocs.parasut.com/#tag/Contacts\n        \n/* Expenses */      \nParasut::Receipt();         // Receipt - Invoice        https://apidocs.parasut.com/#tag/PurchaseBills\nParasut::Bank();            // Bank Expenses            https://apidocs.parasut.com/#tag/BankFees\nParasut::Salary();          // Salary Expenses          https://apidocs.parasut.com/#tag/Salaries\nParasut::Tax();             // Tax Expenses             https://apidocs.parasut.com/#tag/Taxes\nParasut::Supplier();        // Supplier                 https://apidocs.parasut.com/#tag/Contacts\nParasut::Employee();        // Employee                 https://apidocs.parasut.com/#tag/Employees\n    \n/* Invoicing */ \nParasut::Inbox();           // E-Invoice Inbox          https://apidocs.parasut.com/#tag/EInvoiceInboxes\nParasut::EArchive();        // E-Archive                https://apidocs.parasut.com/#tag/EArchives\nParasut::EBill();           // E-Invoice                https://apidocs.parasut.com/#tag/EInvoices\nParasut::ESmm();            // E-SMM                    https://apidocs.parasut.com/#tag/ESmms\n    \n/* Cash */ \nParasut::Account();         // Cash and Bank            https://apidocs.parasut.com/#tag/Accounts\nParasut::Transaction();     // Transaction              https://apidocs.parasut.com/#tag/Transactions\n    \n/* Stock */  \nParasut::Product();         // Product                  https://apidocs.parasut.com/#tag/Products\nParasut::Warehouse();       // Warehouse                https://apidocs.parasut.com/#tag/Warehouses\nParasut::Waybill();         // Waybill                  https://apidocs.parasut.com/#tag/ShipmentDocuments\nParasut::StockMovement();   // Stock Movement           https://apidocs.parasut.com/#tag/StockMovements\n\n/* Settings */\nParasut::Category();        // Category                 https://apidocs.parasut.com/#tag/ItemCategories\nParasut::Tag();             // Tag                      https://apidocs.parasut.com/#tag/Tags\n\n/* Other */\nParasut::ApiHome();         // Api Home                 https://apidocs.parasut.com/#tag/ApiHome\nParasut::TrackableJob();    // Trackable Job            https://apidocs.parasut.com/#tag/TrackableJobs\nParasut::Webhook();         // Webhooks                 https://apidocs.parasut.com/#tag/Webhooks\n```\n\n_Apart from these, to check the stock level of products, you need to use ```Parasut::Product()-\u003einventory($id); ```_\n\n#### Methods\n\nWhen using the classes within Paraşüt, you can utilize the functions listed on the https://apidocs.parasut.com page.\n\nFor example:\u003cbr\u003e\nTo use the customer index function: ```Parasut::Customer()-\u003eindex();```\u003cbr\u003e\nTo use the customer create function: ```Parasut::Customer()-\u003ecreate($data);```\u003cbr\u003e\nTo use the customer show function: ```Parasut::Customer()-\u003eshow($id);```\u003cbr\u003e\nTo use the customer edit function: ```Parasut::Customer()-\u003eedit($id, $data);```\u003cbr\u003e\n\nAll functions shown in the documentation are available.\n\n##### Data Structure\n\nWhen sending data for a create function within a class, you must send the data as described on https://apidocs.parasut.com. If you don't provide the necessary parameters, you will receive an error.\n\nAdditionally, you must send the data as an Array, not as JSON. The package will convert the data to JSON and send it automatically.\n\nExample of creating a Customer:\n```php\n$customer = [\n            'data'=\u003e[\n                'type'=\u003e'contacts',\n                'attributes'=\u003e[\n                    'email'=\u003e'demo@parasut.com',\n                    'name'=\u003e'İsim Soyisim',\n                    'contact_type'=\u003e'person',\n                    'tax_number'=\u003e'11111111111',\n                    'account_type'=\u003e'customer'\n                ]\n            ]\n        ];\n$response = Parasut::Customer()-\u003ecreate($customer);\n```\n\nIf your operations are successful, you will receive an Array like this:\n\n```php\nArray\n(\n    [success] =\u003e true // If the operation is successful, true\n    [error] =\u003e false // If the operation fails, true\n    [body] =\u003e stdClass Object // Response as described in the Paraşüt documentation -\u003e as stdClass Object\n    [status] =\u003e 200 // Response Status\n)\n```\n\n##### Query Parameters ()\n\nFiltering and sending query parameters were included in version v1.2.0-beta. You can now send the **Query Parameters** mentioned in the documentation, which are appended to the end of the URL. The parameters are optional but may vary depending on the endpoint you are using and will be validated. You cannot send parameters that are not required.\n\nWARNING: Before version v1.2.0, the parameter code with vkn in the Inbox was changed. So if you are using it in your project like ```Parasut::Inbox-\u003eindex($vkn)```, you need to send it as an array as shown below.\n\n```php\n$parameters = [\n    'filter' =\u003e [\n        'vkn' =\u003e 1234567890 // Only integer accepted.\n    ],\n    // Not required\n    'page' =\u003e [ \n        'number' =\u003e 1,\n        'size'=\u003e 15\n    ]\n];\n\nParasut::Inbox-\u003eindex($parameters);\n```\n\nExample of Parameter Submission:\n```php\n$parameters = [\n            'filter' =\u003e [\n                'name' =\u003e 'isim',\n                'currency' =\u003e 'TRY',\n                'bank_name' =\u003e 'Banka ismi',\n                'bank_branch' =\u003e 'Banka Şubesi',\n                'account_type' =\u003e 'Hesap Tipi',\n                'iban' =\u003e 'TR00 0000 0000 0000 0000 0000 00'\n            ],\n            'sort' =\u003e 'balance',\n            'page' =\u003e [\n                'number' =\u003e 1,\n                'size' =\u003e 15\n            ]\n        ];\n$response = Parasut::Account()-\u003eindex($id, $parameters);\n```\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eBack to top\u003c/a\u003e)\u003c/p\u003e\n\n### TODO\n\nYou can report missing parts and errors in the Issues section.\n- [x] Functions have been included\n- [x] Other missing parts have been added (Others)\n- [x] Staging functions have been removed\n- [x] Extra filters for functions will be added (Query Parameters)\n\n\u003c!-- LICENSE --\u003e\n## Licensing\n\nThis project is distributed under the MIT License. For more information, please refer to the 'LICENSE' file.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eBack to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\n\u003c!-- CONTACT --\u003e\n## Contact\n\nBaran Arda - [@theposeidonas](https://twitter.com/theposeidonas) - baran@webremium.com\n\nProje Linki: [https://github.com/theposeidonas/laravel-parasut-api](https://github.com/theposeidonas/laravel-parasut-api)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#readme-top\"\u003eBack to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n\u003c!-- https://www.markdownguide.org/basic-syntax/#reference-style-links --\u003e\n[contributors-shield]: https://img.shields.io/github/contributors/theposeidonas/laravel-parasut-api.svg?style=for-the-badge\n[contributors-url]: https://github.com/theposeidonas/laravel-parasut-api/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/theposeidonas/laravel-parasut-api.svg?style=for-the-badge\n[forks-url]: https://github.com/theposeidonas/laravel-parasut-api/network/members\n[stars-shield]: https://img.shields.io/github/stars/theposeidonas/laravel-parasut-api.svg?style=for-the-badge\n[stars-url]: https://github.com/theposeidonas/laravel-parasut-api/stargazers\n[issues-shield]: https://img.shields.io/github/issues/theposeidonas/laravel-parasut-api.svg?style=for-the-badge\n[issues-url]: https://github.com/theposeidonas/laravel-parasut-api/issues\n[license-shield]: https://img.shields.io/github/license/theposeidonas/laravel-parasut-api.svg?style=for-the-badge\n[license-url]: https://github.com/theposeidonas/laravel-parasut-api/blob/master/LICENSE.txt\n[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge\u0026logo=linkedin\u0026colorB=555\n[linkedin-url]: https://www.linkedin.com/in/theposeidonas/\n[Laravel.com]: https://img.shields.io/badge/Laravel-FF2D20?style=for-the-badge\u0026logo=laravel\u0026logoColor=white\n[Laravel-url]: https://laravel.com\n[downloads-url]: https://img.shields.io/packagist/dt/theposeidonas/laravel-parasut-api?style=for-the-badge\u0026color=007ec6\u0026cacheSeconds=3600","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheposeidonas%2Flaravel-parasut-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheposeidonas%2Flaravel-parasut-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheposeidonas%2Flaravel-parasut-api/lists"}