The platform
How Proveely works under the hood
A complete guide to the architecture, company hierarchy, permissions and flows that power the platform.
HQ — Branch hierarchy
Proveely is built for businesses with multiple locations. HQ controls the master catalog and each Branch operates independently.
HQ (Central)
Controls the master catalog, suppliers, brands, categories and global settings. Manages users and permissions across all branches.
- Master product catalog
- Supplier connection and mapping
- Product approval/rejection
- User and permission management
- Storefront configuration
Branch
Inherits the catalog from HQ but operates with its own pricing, margins, stock and discounts. Can request new products.
- Independent pricing chain
- Own stock (own_stock)
- Product requests to HQ
- Own storefront configuration
- Field-level permissions
Granular permission system
Each user has field-level permissions. HQ defines exactly what each person can edit in each branch.
Operates within their HQ company. Can view and edit the full catalog, approve products and manage branches.
Operates within their branch. Can only edit the specific fields that HQ has enabled for them.
Permission groups
Supplier synchronization
Proveely connects supplier APIs and keeps the catalog updated automatically.
Configure
URL, authentication (REST, SOAP, JWT) and field mapping
Import
Products are fetched and created as pending
Update
Cost and stock update automatically at a customizable frequency
Review
Changes to title, description or images stay pending
Change priority
Product lifecycle
Products go through an approval flow before being visible on the online store.
Pending
Product was imported from supplier or created manually. Awaiting review.
Approved
The product was reviewed and approved. Not yet visible in the store.
Published
Product is approved AND published. Visible on the storefront to customers.
Rejected
The product was reviewed and rejected from the catalog.
Approving does NOT auto-publish. Publishing DOES auto-approve.
AI categorization
Artificial intelligence analyzes your products and assigns categories, tags and brands automatically. Save hours of manual work.
Automatic categories
AI analyzes title, description and images to assign the correct category from your catalog tree.
Smart tags
Generates relevant tags based on product attributes: material, use, season, style.
Brand detection
Automatically identifies and assigns the correct brand from the product name.
Batch processing
Run categorization on hundreds of products at once with a background job.
Pricing chain
Each product goes through a calculation chain that transforms the supplier cost into the final consumer price.
Cost
Price charged by the supplier
Supplier disc.
Negotiated discount with supplier
Margin
Company profit percentage
Tax
Tax rate (default 22%)
Discount
Promotional discount for end consumer
Cost x (1 - supplier_disc) x (1 + margin) x (1 + tax) x (1 - discount) = Final priceEach branch configures its own chain per product. Price is calculated automatically.
Storefront (online store)
Each company has its own white-label online store with custom branding, colors and catalog.
API Key authentication
Each storefront identifies itself with an X-Storefront-Key that resolves the company.
Filtered catalog
Only shows products that are both approved AND published for the company.
Calculated prices
Final prices are computed using the company's chain. Internal fields (cost, margin) are not exposed.
Own stock
If the branch has own_stock, it's used. Otherwise, supplier stock is shown.
Integrated checkout
Cart, shipping zones, MercadoPago or bank transfer.
Full customization
Logo, colors, banners, CMS pages and contact settings. Your store, your brand, no code needed.
Full customization
Everything is configured from the admin panel — no code, no developers needed.
Branding & design
- Desktop and mobile logo
- Favicon
- Primary, secondary and accent colors
- Store name
- Description and footer text
SEO & analytics
- Meta title and description
- Google Analytics
- Meta Pixel (Facebook)
- Microsoft Clarity
- Google Site Verification
Banners & popups
- Banner carousel with ordering and toggle
- Desktop and mobile images
- Promotional popup with frequency and delay
- Links to categories or products
CMS pages
- Static pages with HTML
- Custom URL slug
- FAQ, Terms, About us
- Configurable display order
Shipping & payments
- Shipping zones with flat rate
- Free shipping above X
- Coordinate via WhatsApp
- Bank accounts for transfer
- Integrated MercadoPago
Contact & social
- Address, phone, email
- Direct WhatsApp
- Social media links
- Accepted payment methods
Order flow
From when the customer buys to when they receive their product.
Pending
Order was created, waiting for payment confirmation.
Payment confirmed
MercadoPago confirmed payment or transfer was verified.
Shipped
Order was dispatched. Customer is notified by email.
Delivered
Customer received the order. Notified by email.
Shipping can only be marked after confirming payment.
Sales dashboard
Analyze your store's commercial performance with revenue metrics, top-selling products and trends.
Total revenue
Visualize income by day, week or month with trend charts.
Top products
Ranking of best-selling products by units and by invoiced amount.
Orders by status
Distribution of pending, paid, shipped and delivered orders.
Comparisons
Compare periods to detect growth or drops in sales.
Main dashboard
Real-time overview of your operation. Key metrics, recent activity and quick access to the most-used features.
Built-in CRM
Manage customers, sales opportunities and your commercial pipeline from the same platform.
Contacts & customers
Customer database with order history, associated deals and contact info. Advanced search and filters.
Visual pipeline (Kanban)
Drag-and-drop board with customizable stages. Drag deals between stages to update their status.
Deals & opportunities
Each deal has items with product, quantity, price and discount. Total value is calculated automatically.
Configurable stages
Create your own stages with name, color and order. Define which one is 'won' and which is 'lost'.
Pipeline example
Newsletter & campaigns
Send email campaigns to your subscribers directly from Proveely.
Subscriber management
Sign-ups, unsubscribes, reactivations. Import existing customers as subscribers with one click.
Email campaigns
Create campaigns with rich HTML, preview them and send to everyone or specific branches.
Send tracking
Monitor how many emails were sent, how many failed and the individual status of each recipient.
Automatic branding
Every email is automatically wrapped with your store's logo, colors and footer.
Transactional emails
Automatic notifications at every order stage, branded with your store identity.
Payment confirmed
Customer receives confirmation with order details.
Order shipped
Notification with tracking number (if available).
Order delivered
Successful delivery confirmation.
Emails are sent from your own domain (e.g. noreply@yourstore.com) via Resend.
Support tickets
Built-in support system to manage customer inquiries and issues directly from Proveely.
Internal tickets
Each company manages its own tickets: HQ within HQ, each branch within its branch.
Tickets to Proveely
Users report incidents or request improvements directly to the Proveely development team.
Priorities
Classify tickets by priority: low, medium, high, urgent.
Assignment
Assign tickets to team members for follow-up and resolution.
History
Each ticket keeps a full history of messages and status changes.
Audit logs
Detailed record of every action taken on the platform. Who did what, when and where.
Full traceability
Every change to products, prices, permissions and settings is recorded.
Advanced filters
Filter by user, action type, affected entity and date range.
Change detail
View the previous and new value for each modified field.
Export
Export logs as CSV for external analysis or compliance.
System monitoring
Monitor platform health, sync status and service performance in real time.
Service status
Real-time indicators for API, database, job queues and external services.
Supplier sync
Status of each sync: last run, products updated, errors.
Alerts
Automatic notifications when a service fails or a sync has errors.
Performance metrics
Response time, resource usage and platform throughput.