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:

• API Tipo de cambio SUNAT

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