Download the PHP package jafar-albadarneh/jofotara without Composer

On this page you can find all versions of the php package jafar-albadarneh/jofotara. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package jofotara

JoFotara SDK - Jordan E-Invoice Integration

Latest Version on Packagist Tests Total Downloads

A powerful, developer-friendly PHP SDK for seamless integration with Jordan's electronic tax invoicing system (JoFotara). This package provides:

๐Ÿ“ฆ Installation

๐Ÿš€ Quick Start

๐Ÿ“– Documentation

Invoice Types

The SDK supports all JoFotara invoice types:

Payment Methods

JoFotara supports two payment methods:

Tax Handling

The SDK supports various tax scenarios:

Response Handling

๐Ÿงช Testing

Important: JoFotara does not provide a sandbox environment. For testing:

  1. You need a registered entity with Jordan Tax Department
  2. Your entity must be registered for JoFotara
  3. Use past dates for test invoices
  4. Always issue credit invoices to reverse test transactions

Running Tests

๐Ÿ”’ Security

Never commit your JoFotara credentials to version control. Use environment variables:

๐Ÿ“„ License

The MIT License (MIT). Please see the License File for more information.

Basic Invoice Information

Seller Information

Buyer Information

Supplier Income Source

The supplier income source sequence (ุชุณู„ุณู„ ู…ุตุฏุฑ ุงู„ุฏุฎู„) is a required value that must be set for each invoice. This value is obtained from your JoFotara portal and represents your business's income source sequence number.

Important: The supplier income source sequence is mandatory and must be set before generating the invoice XML. You can find this value in the table where it shows your client ID and secret, under column "ุชุณู„ุณู„ ู…ุตุฏุฑ ุงู„ุฏุฎู„".

Example usage in a complete invoice:

The supplier income source sequence is used by the JoFotara system to:

Invoice Items and Tax Handling

Automatic Total Calculations

The SDK automatically calculates all invoice totals based on the items you add:

Automatic calculations are applied once you call ->invoiceTotals(). This method must be called after all items have been added.

For special cases, you can manually set totals:

Note: When manually setting totals, they must match the calculated values from the items, or an exception will be thrown to ensure data integrity.

API Communication

The send() method handles the complete flow:

  1. XML generation and validation
  2. Base64 encoding
  3. API authentication
  4. Error handling

Validation

The SDK includes comprehensive validation to ensure your invoice meets JoFotara requirements:

Validation errors throw InvalidArgumentException with descriptive messages to help you quickly identify and fix issues.

Development Testing

Contributing

Contributions are welcome! Please see CONTRIBUTING for details.

Security

If you discover any security-related issues, please email [email protected] instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.


All versions of jofotara with dependencies

PHP Build Version
Package Version
Requires php Version ^8.0 || ^8.1 || ^8.2 || ^8.3 || ^8.4
ext-curl Version *
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package jafar-albadarneh/jofotara contains the following files

Loading the files please wait ....