PHPackages itrends/taecel - 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. [Utility & Helpers](/categories/utility) 4. / 5. itrends/taecel ActiveLibrary[Utility & Helpers](/categories/utility) itrends/taecel ============== Libreria de laravel para trabajar con taecel: https://taecel.com/portal/ 1.2.3(3y ago)1261MITPHPPHP ^8 Since Jul 19Pushed 3y ago2 watchersCompare [ Source](https://github.com/itrendsmx/taecel)[ Packagist](https://packagist.org/packages/itrends/taecel)[ RSS](/packages/itrends-taecel/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (2)Dependencies (5)Versions (8)Used By (0) iTrends/taecel ============== [](#itrendstaecel) [![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)![Travis](https://camo.githubusercontent.com/e601be89b0e2338b6ec7db0fc193da6ddb129d46580f400e2cfa6236afae8a8f/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f74616563656c2f74616563656c2e7376673f7374796c653d666c61742d737175617265)[![Total Downloads](https://camo.githubusercontent.com/142918c92493756318408e87008b60c5b218361e4cde4b16b276dba83eb2fa45/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f74616563656c2f74616563656c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/taecel/taecel) Instalación ----------- [](#instalación) ``` composer require itrends/taecel ``` Uso --- [](#uso) Solo necesita agregar las siguientes variables a su archivo `.env`, estas son prporcionadas por taecel cuando ellos obtienen información de su empresa. ``` TAECEL_KEY=YOUR_KEY TAECEL_NIP=YOUR_NIP ``` Una vez hecho esto, para comenzar a utilizarlo, hay dos maneras: ### A traves del facade de Laravel [](#a-traves-del-facade-de-laravel) ``` $balance = Taecel::getBalance() ``` ### A traves de una instancia de la clase Taecel [](#a-traves-de-una-instancia-de-la-clase-taecel) ``` $taecel = Taecel::create() ``` Ambos utilizarán las variables de entorno para poder obtener el KEY y NIP de taecel, y una vez instanciado, pueden hacer uso de cualquiera de las siguientes funciones: ### getBalance [](#getbalance) De acuerdo al API de taecel devuelve siempre un JSON con información similar a la siguiente: ``` { "success": true, "error": 0, "message": "Consulta Exitosa", "data": [ { "ID": "1", "Bolsa": "Tiempo Aire", "Saldo": "899,968,134" }, { "ID": "2", "Bolsa": "Pago de Servicios", "Saldo": "99,913,654" }, { "ID": "3", "Bolsa": "Timbres CFDI", "Saldo": "5,697" } ] } ``` ### getProducts [](#getproducts) Devuelve una colección de todos los productos disponibles, cada producto es una instancia del objeto `Producto`, el cual es arrable y jsonable, actualmente el objeto tiene todos los objetos mostrados en `$this`: ``` public function toArray() { return [ 'bolsa' => $this->getBolsa(), 'bolsa_id' => $this->getBolsaId(), 'categoria' => $this->getCategoria(), 'categoria_id' => $this->getCategoriaId(), 'carrier' => $this->getCarrier(), 'carrier_id' => $this->getCarrierId(), 'codigo' => $this->getCodigo(), 'monto' => $this->getMonto(), 'unidades' => $this->getUnidades(), 'vigencia' => $this->getVigencia(), 'descripcion' => $this->getDescripcion() ]; } ``` ### getProveedoresTae, get ProveedoresServicios, getProveedoresPaquetes y getProductsByCarrier [](#getproveedorestae-get-proveedoresservicios-getproveedorespaquetes-y-getproductsbycarrier) Devuelve todos los proveedores disponibles, dependiendo de la necesidad, cada proveedor es una instancia de la clase`Proveedor` en el sistema, el cual se forma con la siguiente estructura. ``` public function toArray() { return [ 'id' => $this->getId(), 'nombre' => $this->getNombre(), 'bolsa_id' => $this->getBolsaId(), 'categoria' => $this->getCategoria(), 'categoria_id' => $this->getCategoriaId(), 'tipo' => $this->getTipo() ]; } ``` ### getProductsByCarrier [](#getproductsbycarrier) Devuelve una colección de objetos `producto` filtrado por proveedor ### requestTXN [](#requesttxn) Solicita una orden de compra, requiere que se le envíen 3 campos: ``` producto referencia monto ``` Ésta función devuelve un `transaction_id` que es un `string` que sirve para realizar consultas al método `statusTxn`, en dado caso de que algo salga mal, lanza una excepción con el error devuelto por taecel. ### statusTXN [](#statustxn) Verifica el estatus de una transaccion, requiere que se envien los siguientes datos: ``` transaction_id ``` A traves de éste campo intentará verificar el estatus de la transacción, y si todo sale bien devolverá un objeto `InformacionDeTransaccion` que contiene lo siguiente: ``` public function toArray() { return [ 'transId' => $this->getTransId(), 'fecha' => $this->getFecha(), 'carrier' => $this->getCarrier(), 'folio' => $this->getFolio(), 'status' => $this->getStatus(), 'monto' => $this->getMonto(), 'nota' => $this->getNota() ]; } ``` ### pagarServicio [](#pagarservicio) Practicamente ésta función hace lo mismo que `requestTXN`, pero devuelve un objeto `InformacionDeTransaccion` dado que también manda a hablar a `statusTXN` Pruebas unitarias ----------------- [](#pruebas-unitarias) Antes de correr los test configure TAECEL\_KEY y TAECEL\_NIP como variables de entorno, y entonces ejecute. ``` composer test ``` Contribuciones -------------- [](#contribuciones) Todas las contribuciones sin bien recibidas, siempre y cuando cuenten con las pruebas unitarias correspondientes. ### Health Score 24 — LowBetter than 32% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity9 Limited adoption so far Community5 Small or concentrated contributor base Maturity52 Maturing project, gaining track record 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 ~1 days Total 6 Last Release 1393d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/f6cd9133b5177b05b7033a58bd89cedafe36d4c410e7ba3df338dc49983eb8f4?d=identicon)[atxy2k](/maintainers/atxy2k) --- Tags taecel ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/itrends-taecel/health.svg) ``` [![Health](https://phpackages.com/badges/itrends-taecel/health.svg)](https://phpackages.com/packages/itrends-taecel) ``` ### Alternatives [shlinkio/shlink A self-hosted and PHP-based URL shortener application with CLI and REST interfaces 4.8k4.3k](/packages/shlinkio-shlink)[ralphjsmit/laravel-helpers A package containing handy helpers for your Laravel-application. 13704.6k2](/packages/ralphjsmit-laravel-helpers)[dhlparcel/magento2-plugin DHL Parcel plugin for Magento 2 11180.5k2](/packages/dhlparcel-magento2-plugin)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 245.2k](/packages/aedart-athenaeum) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)