brunoinds/sunat-dolar

There is no license information available for the latest version (v1.0.0) of this package.

Calculate SUNAT Perú dollar exchange

Maintainers

Details

github.com/brunoinds/php-sunat-dolar

Source

Issues

Installs: 66

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

v1.0.0 2023-12-29 00:24 UTC

Requires (Dev)

Unknown License 492f74415107b5b52ae8f1b5c4fc2fc1387866e5

  • Bruno Freire <brunoqm99.woop@gmail.com>

This package is auto-updated.

Last update: 2024-09-29 01:59:33 UTC

README

A simple PHP library for exchanging currencies based on Peruvian SUNAT exchange rates.

Installation

Install via Composer:

composer require brunoinds/sunat-dolar

Usage

The Exchange class provides methods for exchanging between PEN and USD:

use Brunoinds\SunatDolar\Exchange;
use Brunoinds\SunatDolar\Enums\Currency;

// Get current exchange rate
$result = Exchange::now()->convert(Currency::USD, 1)->to(Currency::PEN);

// Get historical exchange rate 
$date = new DateTime('2023-12-10');
$result = Exchange::on($date)
                ->convert(Currency::USD, 1)
                ->to(Currency::PEN);
echo $result // 0.27

// Get buy/sell prices
$dollarBuy = Exchange::on($date)->getDollarBuyPrice(); //3.749;
$solesSell = Exchange::on($date)->getSolesSellPrice(); //0.266

The Currency enum provides constants for the supported currencies:

use Brunoinds\SunatDolar\Enums\Currency;

Currency::USD; // 'USD'
Currency::PEN; // 'PEN'

Testing

Unit tests are located in the tests directory. Run tests with:

composer test

Contributing

Pull requests welcome!

License

MIT License

Powered by:

Let me know if you would like any sections expanded or have any other feedback!