Contact person: Business Client

Phone:Show

Email:Show

Location: Slatina, Romania

Budget: Recommended by industry experts

Time to start: As soon as possible

Project description:
"Overview
This document outlines the technical architecture and API integration strategy for developing a mobile
application that allows users to search, identify, and order spare parts via the ASWO system, while
connecting with the PrestaShop backend for user accounts and custom order handling.
1. User Account & Registration
Login/Register via PrestaShop API
Use PrestaShop Webservice API or JWT Auth plugin
Data saved into standard ps_customer table
Optional: Add separate table for mobile-only users
2. Appliance & Article Search (ASWO API)
2.1 Article Search (Command: artikelsuche )
Input params: - suchbg : keyword - vgruppe : article family ID (optional) - artnr : exact article ID
(optional) - vergleich : return replacement articles (J/N) - attrib , bigPicture , morepics ,
artikeldetails : extra info flags
Pagination: - anzahl : results per page (max 50) - seite : page number
2.2 Appliance Search (Command: geraetesuche )
Steps: 1. geraetesuche : keyword, manufacturer 2. geraeteartikelgruppen : show article families for
selected device 3. geraeteartikel : show articles in a family
2.3 Popular Articles
On device selection, call geraeteartikel to preload known popular items
3. Shopping Cart
3.1 Add/Update/Delete (Command: warenkorb )
artnr , geraeteid , preis , menge
Menge 0 = remove
•
•
•
•
•
•
•
1
3.2 View Cart (Command: warenkorbanzeigen )
Flags for: sperrgutanzeigen , packstationcheck , nncheck
3.3 Clear Cart (Command: warenkorbloeschen )
3.4 Sync with ASWO Account (Command: aswokorb )
bestellreferenz : ID string
4. Placing Orders (Command: bestellung )
Supports multiple fields for shipping/billing address
Handles zahlungsart , versandkosten , language , and more
If PayPal: - zahlungsart=7 returns paypallink
Mark as Paid (optional): - Use bestellungstatus with orderid , orderstatus=1
5. Post-Order Actions
Returns: link to GeniusFix: [login to view URL]
Backorders (Command: rueckstaende )
Release Order to ASWO (Command: freigeben )
6. SEO and Support
SEO Data Feed (Command: seodaten )
End-user Requests (Command: anfrage , anfragedatei )
7. Data Fields Mapping
Use the fields from section 9 of the ASWO API documentation.
artikelnummer , artikelbezeichnung , thumbnailurl , lieferzeit , preis , etc.
Use technischedaten for rich product details (if attrib=1 )
•
•
•
•
•
•
•
•
•
•
•
2
8. Visual/UI Suggestions
Where possible: - Show appliance thumbnails - Show part diagrams or exploded views (if provided) - Include
badges for: Original , Alternative , Q - Highlight replacement availability if ersatzartikel=J
9. PDF & Visual Support
Generate order summaries or appliance guides in PDF using native iOS/Android share
Embed ASWO images (via thumbnailurl , bigPicture , morepics )
Use app native printing/sharing for downloadable forms
10. Database Strategy (PrestaShop)
Store app orders in a separate table to differentiate from web orders
Sync only essential customer data
Optionally map ASWO order ID to PrestaShop customer for history tracking
11. Next Steps
Review which optional fields to support (e.g. PayPal, pickup stations)
Finalise mockups and data mapping
Prepare developer PDF with API examples and visual diagrams
End of document.
•
•
•
•
•
•
•
•
•
3
8.1 App Workflow and User Flow Explanation
The following diagram illustrates the typical journey of a user through the mobile app, integrating
ASWO’s API and PrestaShop’s database.
Key Stages in the App Flow:
1. App Launch / Session Start
A new sessionid is created for each user using neuesitzung. This session persists during browsing
and ordering operations.
2. Login or Registration
Customers can log in using their existing PrestaShop credentials (ps_customer). Alternatively,
registration uses the same database schema for unified data management.
3. Appliance or Article Search
Two pathways are available:
- Keyword search using artikelsuche or geraetesuche.
- Guided search via geraetefinder, leading step-by-step to the appliance.
4. Article Details & Availability
Once a device is selected, article families (geraeteartikelgruppen) and articles (geraeteartikel) are
shown. Top articles or replacement parts (ersatzartikel) can be listed automatically.
5. Cart & Order Preparation
Users add articles to their basket using warenkorb. The cart is retrieved or modified via
warenkorbanzeigen and warenkorbloeschen.
6. Order Submission
Finalised orders are sent to ASWO via bestellung. Payment options include CoD, Bank Transfer, or
Netopia (PayPal is ignored).
7. Order Confirmation & Tracking
Orders can be released using freigeben. Romanian deliveries use GLS. Order tracking is done by
embedding a GLS iframe:
[login to view URL]{sendungsnummer}
8. Returns & Post-Order Actions
Returns are handled via the GeniusFix form:
[login to view URL]
Any backorders are displayed using rueckstaende.
Note: Orders placed through the app are stored in a separate database table within PrestaShop to
avoid mixing with web-based orders. However, customer data remains synced for history tracking
and UI coherence." (client-provided description)