PHPackages                             kiankamgar/php-moadian - 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. [API Development](/categories/api)
4. /
5. kiankamgar/php-moadian

ActiveLibrary[API Development](/categories/api)

kiankamgar/php-moadian
======================

This PHP SDK provides seamless integration with the tp.tax.gov.ir API, also known as Karpoosheh or Moadian. The tp.tax.gov.ir platform offers a range of tax-related functionalities, and this SDK simplifies the process of incorporating those features into your PHP applications.

v1.0.1(2y ago)6281MITPHPPHP ^8.0

Since Apr 15Pushed 2y ago1 watchersCompare

[ Source](https://github.com/kiankamgar/php-moadian)[ Packagist](https://packagist.org/packages/kiankamgar/php-moadian)[ RSS](/packages/kiankamgar-php-moadian/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (2)Versions (3)Used By (0)

PHP Moadian
===========

[](#php-moadian)

[![Total Downloads](https://camo.githubusercontent.com/7796c143c7e03e3f1f378bd85d4760c769cbdf090afb96dfe70b35ede9989799/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6b69616e6b616d6761722f7068702d6d6f616469616e)](https://packagist.org/packages/kiankamgar/php-moadian)[![Latest Stable Version](https://camo.githubusercontent.com/d7f3b11d2b201fbb263f56677170386e8b52c66dbc6b07553ff9034363c710eb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6b69616e6b616d6761722f7068702d6d6f616469616e)](https://packagist.org/packages/kiankamgar/php-moadian)[![License](https://camo.githubusercontent.com/acc219e384f4db30a03f2f594edd7a4a1d21aae3c8426e74b3c626cffad916b3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6b69616e6b616d6761722f7068702d6d6f616469616e)](https://packagist.org/packages/kiankamgar/php-moadian)

PHP SDK for tp.tax.gov.ir API (Karpoosheh/Moadian)

This PHP SDK provides a convenient way to interact with the tp.tax.gov.ir API, also known as Karpoosheh or Moadian. By integrating this SDK into your PHP applications, you can seamlessly access and utilize the functionalities offered by the tp.tax.gov.ir APIs.

Features
--------

[](#features)

- **Easy Integration**: Simplifies the process of integrating tp.tax.gov.ir API into your PHP projects.
- **Comprehensive Functionality**: Access a wide range of functionalities offered by the tp.tax.gov.ir platform.
- **Robust and Secure**: Built with attention to security and reliability, ensuring safe interactions with the API.

Requirements
------------

[](#requirements)

- PHP 8.0 or higher
- Composer for installation

### Composer Dependencies

[](#composer-dependencies)

```
{
   "require": {
      "php": "^8.0",
      "guzzlehttp/guzzle": "^7.5",
      "ext-json": "*",
      "ext-openssl": "*",
      "ext-ctype": "*",
      "phpseclib/phpseclib": "~3.0"
   }
}
```

Getting Started
---------------

[](#getting-started)

1. Get memory id (fiscal id), private key and certificate files from tp.tax.gov.ir.
2. Install the SDK via Composer:

    ```
    composer require kiankamgar/php-moadian
    ```
3. Start utilizing the various methods provided by the SDK to interact with the API.

Usage
-----

[](#usage)

Require composer autoload file:

```
require_once __DIR__ . '/vendor/autoload.php';
```

Create an instance from Moadian class:

```
use KianKamgar\MoadianPhp\Moadian;

$moadian = new Moadian(
        $privateKeyFilePath,
        $certificateFilePath,
        $memoryId,
        $economicalCode
    );
```

Now you can use these APIs:

### Get fiscal information

[](#get-fiscal-information)

```
$fiscalInformation = $moadian->getFiscalInformation();

$economicCode = $fiscalInformation->getEconomicCode();
$fiscalStatus = $fiscalInformation->getFiscalStatus();
$nameTrade = $fiscalInformation->getNameTrade();
$nationalId = $fiscalInformation->getNationalId();
```

### Get tax payer

[](#get-tax-payer)

```
$taxPayer = $moadian->getTaxPayer();

$nameTrade = $taxPayer->getNameTrade();
$nationalId = $taxPayer->getNationalId();
$taxpayerStatus = $taxPayer->getTaxpayerStatus();
```

### Send invoice

[](#send-invoice)

#### Create invoice

[](#create-invoice)

Each invoice contains header, body array and payment array (payment array is optional). You can create invoice with Invoice helper:

```
use KianKamgar\MoadianPhp\Invoice;

$invoice = new Invoice();
$invoice->header($moadian->getMemoryId())
        ->setInty(1)
        ->setInp(1)
        ->setIns(1)
        ->setTins("14003778990")
        ->setTob(2)
        ->setBid("10100302746")
        ->setTinb("10100302746")
        ->setTprdis(20_000)
        ->setTdis(500)
        ->setTadis(19_500)
        ->setTvam(1_755)
        ->setTodam(0)
        ->setTbill(21_255)
        ->setSetm(2);

$invoice->body()
        ->setSstid("2710000138624")
        ->setSstt("title")
        ->setMu("164")
        ->setAm(2)
        ->setFee(10_000)
        ->setPrdis(20_000)
        ->setDis(500)
        ->setAdis(19_500)
        ->setVra(9)
        ->setVam(1_755)
        ->setTsstam(21255)
        ->build();

$invoice->body()
        ->setSstid("2710000138624")
        ->setSstt("another title")
        ->setMu("164")
        ->setAm(2)
        ->setFee(10_000)
        ->setPrdis(20_000)
        ->setDis(500)
        ->setAdis(19_500)
        ->setVra(9)
        ->setVam(1_755)
        ->setTsstam(21255)
        ->build();

$invoice->payment()
        ->setPcn('pcn')
        ->setPv(10)
        ->build();
```

#### Send invoices

[](#send-invoices)

Now that you have created your invoice objects you can send your invoices with two options:

1. If you just want to send invoices and do not need inquiry, you can do this:

```
$response = $moadian->sendInvoices(
        $invoice1,
        $invoice2,
        $invoice3,
        ...
    );

$timestamp = $response->getTimestamp();
$result = $response->getResult();
```

2. If you want to send invoices and get the inquiry for each as well, you can do this:

***NOTE:*** keep in mind that you need to wait at least 10 seconds to be able to inquiry an invoice, therefor in this case your request will take at least 10 seconds

```
$response = $moadian->sendInvoicesWithResponse(
        $invoice1,
        $invoice2,
        $invoice3,
        ...
    );

$result = $response->getResult();
```

### Inquiry sent invoices

[](#inquiry-sent-invoices)

1. By reference id(s)

```
$inquiry = $moadian->getInquiryByReferenceIds(['referenceId1', 'referenceId2']);

$result = $inquiry->getResult();
```

You can pass start and end as well to filter results (both are optional):

```
$start = new DateTime();
$end = (new DateTime())->modify('+1 day');

$inquiry = $moadian->getInquiryByReferenceIds(
  ['referenceId1', 'referenceId2'],
  $start,
  $end
);

$result = $inquiry->getResult();
```

2. By uid

```
$inquiry = $moadian->getInquiryByUid(['uid1', 'uid2']);

$result = $inquiry->getResult();
```

You can pass start and end as well to filter results (both are optional):

```
$start = new DateTime();
$end = (new DateTime())->modify('+1 day');

$inquiry = $moadian->getInquiryByUid(
  ['uid1', 'uid2'],
  $start,
  $end
);

$result = $inquiry->getResult();
```

3. By Time

```
// inquiry sent invoices in the past 24 hours
$inquiry = $moadian->getInquiryByTime();

$result = $inquiry->getResult();
```

Also, you can pass optional parameters:

```
use KianKamgar\MoadianPhp\Enums\InvoiceStatus;

$start = new DateTime();
$end = (new DateTime())->modify('+1 day');
$inquiry = $moadian->getInquiryByTime(
  $pageNumber, // default = 1
  $pageSize, // default = 10
  InvoiceStatus::SUCCESS,
  $start,
  $end
);

$result = $inquiry->getResult();
```

Contributing
------------

[](#contributing)

Contributions, bug reports, and feature requests are welcome! Please feel free to open issues or submit pull requests.

License
-------

[](#license)

This SDK is open-source and licensed under the MIT License. See the [LICENSE](https://github.com/kiankamgar/php-moadian/blob/main/LICENSE) file for more details.

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity47

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 ~9 days

Total

2

Last Release

752d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/350ea224895747e75c9bebd527a6d5fabd28d1e08fb1363600863934dafc3baf?d=identicon)[kiankamgar](/maintainers/kiankamgar)

---

Top Contributors

[![kiankamgar](https://avatars.githubusercontent.com/u/43221882?v=4)](https://github.com/kiankamgar "kiankamgar (26 commits)")

---

Tags

composerfinancekarpooshehmoadianphpsdksdk-phptax

### Embed Badge

![Health badge](/badges/kiankamgar-php-moadian/health.svg)

```
[![Health](https://phpackages.com/badges/kiankamgar-php-moadian/health.svg)](https://phpackages.com/packages/kiankamgar-php-moadian)
```

###  Alternatives

[wheelpros/fitment-platform-api

Magento 2 (Open Source)

12.1k1.2k](/packages/wheelpros-fitment-platform-api)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[packbackbooks/lti-1p3-tool

A library used for building IMS-certified LTI 1.3 tool providers in PHP.

51438.3k2](/packages/packbackbooks-lti-1p3-tool)[yoti/yoti-php-sdk

Yoti SDK for quickly integrating your PHP backend with Yoti

27539.9k1](/packages/yoti-yoti-php-sdk)[hoels/app-store-server-library-php

The PHP server library for the App Store Server API and App Store Server Notifications.

44162.2k](/packages/hoels-app-store-server-library-php)[soneso/stellar-php-sdk

Stellar PHP SDK for the Stellar Network

4048.2k4](/packages/soneso-stellar-php-sdk)

PHPackages © 2026

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