Download the PHP package retail-cosmos/trx-mall-upload-sales-data-api without Composer
On this page you can find all versions of the php package retail-cosmos/trx-mall-upload-sales-data-api. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download retail-cosmos/trx-mall-upload-sales-data-api
More information about retail-cosmos/trx-mall-upload-sales-data-api
Files in retail-cosmos/trx-mall-upload-sales-data-api
Package trx-mall-upload-sales-data-api
Short Description This is a Laravel package providing the functionality to upload sales data to the TRX mall via APIs
License MIT
Homepage https://github.com/retail-cosmos/trx-mall-upload-sales-data-api
Informations about the package trx-mall-upload-sales-data-api
The TRX Mall Upload Sales Data API
The TRX Mall Upload Sales Data API is a Laravel package to upload sales data to TRX Mall via API.
Installation
-
Install the package via composer:
-
Publish the config file:
- Read the config file options and set
.env
variables accordingly.
Usage
-
You need to add code in your Laravel app to share the sales data with the package. A service class needs to be added for the same. We provide an option to generate the class with a single command:
-
A new class is added at
app/Services/TrxMallUploadSalesDataApiService.php
. It contains a couple of methods to return the stores and sales data as per the requirements. You may make those methods dynamic by changing the code. You may check this stub file anytime for future reference. - Add a scheduler in your Laravel project to call the command
trx:send-sales
daily at midnight. It sends the sales for the previous day for each store as returned from the application.
Notes
- The sales command sends the sales for the previous day for each store by default. If you wish to send sales for a specific date/store, you may pass the following options to the command:
--date
- Date in the Y-m-d (2024-12-31) format to send sales for a specific date.--store_identifier
- To send a sales for a specific store only. check the stub file for the store identifier.
Example:
-
If you have set respective .env variables, this package sends notification emails after successful/failed attempt to send sales data to TRX. If you want to customize the notification email, you can publish the view by running the following command:
- The package calculates 'Batch ID' for the sales data based on the
TRX_MALL_DATE_OF_FIRST_SALES_UPLOAD
in the.env
file. It finds the difference between the date specified forTRX_MALL_DATE_OF_FIRST_SALES_UPLOAD
and the date for which you are attempting to send the sales data and adds one(1) to it. For example, if theTRX_MALL_DATE_OF_FIRST_SALES_UPLOAD
is set to2024-01-10
and you are attempting to send the sales data for2024-01-20
then the batch ID will be '11'.
Testing
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
- Punyapal Shah
- Gaurav Makhecha
- All Contributors
License
The MIT License (MIT). Please see License File for more information.
All versions of trx-mall-upload-sales-data-api with dependencies
guzzlehttp/guzzle Version ^7.8
illuminate/contracts Version ^11.0
spatie/laravel-package-tools Version ^1.14.0