API or Connector Module for UltimatePOS
This module provides the API for use in UltimatePOS
API Documentation:
We’ve detailed API documentation which includes all API endpoints, input request output response, and more.
It is included with the API module which you’ll be getting upon purchasing.
✅ After purchasing & API module installation, just go to yourwebsite.com/docs, and there you’ll find the documentation
API Documentation showing 404 error:
- Solution 1: Follow the steps mentioned below in “Additional update steps” 👇
OR - Solution 2: If you’ve SSH access or terminal(cmd line) access to the server or using localhost, go inside pos directory and run the below command:
php artisan scribe:generate
OR - Solution 3: Download this zip file, upload it inside pos/public directory, and unzip it there.
Try any of the above methods, method 3 is the easiest.
After doing open your website document, hopefully it should work now.
Features:
All the APIs provided are mentioned in the official API documentation https://pos.ultimatefosters.com/docs
Installation Steps:
Follow the steps as given in Module Management installation
Update Steps:
Follow the steps as given in Module Management Updating
Additional update steps:
This step needs to be followed after updating UltimatePOS:
- Login with superadmin account
- Go Modules screen in the sidebar
- Click on the “Regenerate” button as given in the screenshot below.
Generating client id & Client secret:
- After installing the API-Connector module login with superadmin username & password
- Go to Connector -> Clients
- Click on “Create Client” button and it will show a popup.
- Enter the name (any name is fine) & Save
- In the list of clients, it will show the id, & secret. Check screenshow below.
NOTE: Only the superadmin users can view the Connector -> Clients page. So if any other users need a client id or secret then the superadmin user should generate and send it to them.
Changing Logo in the API documentation:
Replace the logo present inside pos\public\docs\images\logo.png
Video Demonstration:
Version Log:
V 3.0, – Released June 7, 2024
- NEW: Updated as per new design.
NOTE: You must update UltimatePOS to V6.x before updating the module to this version.
V2.2, – Released January 30, 2024
- NEW: Option for service_staff in add/edit sales sell line
- FIX: Permission issue fixes for various APIs
V2.1, – Released June 6, 2023
- FIX: Fixed add/edit sale issue in API.
V1.8, – Released December 1, 2022
- Undefined issue in sales API fixed
- Service Staff in sales API improved
V1.7, – Released Feb 2, 2022
- Permission checks added to sell list API
- Sell permission checks added to sell list API
- Multiple payment status filters added to sell list API
- Expense subcategory API endpoint added
V1.5, Nov 26, 2021
- Currency precision and quantity precision added to business setting API response
- Sending lot details in sell list and product list API, if request parameter is set to true.
V1.4, Oct 08, 2021
- Source field added to sells
- Filter by source implemented on sell api
V1.3, Sep 08, 2021
- Added discounts on products/variations api
- Added reset password api
- Added public invoice URL in sales
V1.1, Aug 18, 2021
- User register API added
- Other API improvements
V1.0, May 02, 2021
- Fixes & improvements in API
V0.8, March 04, 2021
- Permissions list added to logged in user details API
- API created for CRM->follow up & lead list
- additional follow-up info field added in API & filter parameter name changed in the list follow up API
- pagination added in list of supplier/customer/lead API
- Search and order by added in supplier/customer/lead list API
- Permission check added to list leads API
- sorting added on list follow-up API
- status/follow up type filter added for list follow up API
- pagination & customer info added in the list follow up API
V0.7, December 21, 2020
- Various minor updates, fixes & improvements
Initial Release – V0.5, Nov 11, 2020
- Initial release.