com.somosvelora/velora

[demo: deshabilitada] Sets the absolute stock quantity for a product (inventory sync, no audit trail).

[demo: deshabilitada] Mass price change for all products or a specified subset in this business.

[demo: deshabilitada] Opens or closes a cash register shift for the authenticated business.

Queries the current cash register balance for the authenticated business — the open session data or the last closed session. Read-only.

[demo: deshabilitada] Records a cash movement tied to the OPEN caja shift: income, expense, withdrawal, tax, or payroll.

[demo: deshabilitada] Connects MercadoPago for this business using the BYOA OAuth-redirect model. Primary: returns an authorization URL. Fallback: accepts a production access token directly.

[demo: deshabilitada] Connects PedidosYa for this business using the BYOA secure-form model. Primary: returns a secure link. Fallback: accepts an API token directly.

[demo: deshabilitada] Connects Tienda Nube (Nuvemshop) using the BYOA OAuth-redirect model. Returns an authorization URL — no token ever passes through chat. Gated behind env config in production.

[demo: deshabilitada] Connects WhatsApp Business using the BYOA Meta Embedded Signup model. Primary: returns a signup link. Optional: registers a phone number as a lightweight pre-step.

Returns the BYOA (Bring Your Own Account) integration readiness for the authenticated business — what is connected and how to connect what is missing. Read-only.

[demo: deshabilitada] Creates a new product in the business catalog. Requires name and price.

[demo: deshabilitada] Creates a procurement order (purchase request) to a supplier.

[demo: deshabilitada] Creates a physical shipment via the chosen courier and returns a tracking number and label URL.

[demo: deshabilitada] Creates a supplier for this business.

[demo: deshabilitada] Creates a tracked MercadoPago payment link for a catalog-tied cobro: atomically records the Sale + Invoice + PaymentIntent, then generates a real Checkout Pro link. MONEY: real and irreversible.

[demo: deshabilitada] Deletes a customer from this business (blocked when the customer has sales or invoices).

[demo: deshabilitada] Deletes (or soft-archives, when it has sale records) a product from the catalog.

[demo: deshabilitada] Deletes a supplier from this business (with full audit trail).

[demo: deshabilitada] Updates a single product's fields (name, price, costPrice, or stockQuantity).

[demo: deshabilitada] Updates an existing supplier's fields.

[demo: deshabilitada] Emits an ARCA (formerly AFIP)-compliant electronic invoice (factura electrónica) for the authenticated business and returns the CAE authorization code.

[demo: deshabilitada] Emits an ARCA-compliant Nota Crédito (NC) or Nota Débito (ND) against an original AFIP invoice and returns the CAE authorization code.

Searches customers in the business by name and/or phone. Returns up to 20 matching customers sorted by name.

Checks whether the business is ready to emit real ARCA electronic invoices. Returns { ready, missing, guidance } where ready=true means all fiscal fields and the ARCA certificate are configured.

Computes the shipment weight and item breakdown for a package. Accepts a saleId, a list of productIds, or an explicit weightGramsOverride.

Checks the current status of a Velora PaymentIntent. Accepts a paymentIntentId OR a customer name.

Returns all suppliers for this business (up to 50, sorted by name).

ONE widget, two display modes: inline snapshot by default, fullscreen tabs (Cliente 360, Cerrar el día, Reposición de stock, Dashboard de ventas) on demand. Aggregates caja, payments, ventas, reportes, supplier, and customer reads.

Opens a visual widget showing the current shift state and action buttons. Read-only here.

Opens the catalog selector — a graphical product picker (MCP Apps widget) that shows active products with prices (ARS) and stock. Side-effect-free (no sale, no charge).

Opens the cobro status widget — a read-only view of ONE PaymentIntent's payment state. Accepts paymentIntentId OR customerName.

Opens the comprobante + envío widget — a read-only view of the delivery receipt for a completed cobro. Accepts paymentIntentId, saleId, OR customerName.

Opens a graphical onboarding hub showing integration status and connect links. Read-only.

Opens the payment-link wizard — a graphical form pre-filled with the cobro, for the owner to review and confirm before any money moves. Side-effect-free (no charge).

Opens the pending cobros dashboard — a read-only widget listing PaymentIntents awaiting payment. Side-effect-free.

Opens a VISUAL preview of a cash sale — resolved product names, unit prices, quantities, and total — with a confirm button that fires register_sale. Read-only preview itself.

Combines catalog stock/weight data and a live shipping quote into one widget — resolves items, computes total weight, and quotes couriers. Read-only, side-effect-free.

Lists active products in the business catalog. Returns products sorted by name, each with id, name, price (ARS), costPrice, sku, stock quantity, and weightGrams.

Queries sales metrics from the database: 'ventas_periodo', 'margen', 'ranking_productos', 'por_empleado', or 'historial_cliente'.

Quotes shipment rates from every active courier configured for the authenticated business and returns options sorted by price ascending.

[demo: deshabilitada] Records a cash-register movement for the authenticated business ('purchase', 'income', 'salary', 'tax', 'adjustment').

[demo: deshabilitada] Records a sale for the authenticated business. Creates a full Sale with SaleItems, decrements inventory, creates a CashMovement and Invoice.

[demo: deshabilitada] Reverses the N most-recent sales within a time window. Restores inventory, removes CashMovement, SaleItem, Invoice, and Sale records. Destructive and irreversible.

[demo: deshabilitada] Sends a pre-approved Meta WhatsApp template message. Window-independent — can be sent proactively, outside the 24-hour session window.

[demo: deshabilitada] Sends a plain-text WhatsApp message to a customer phone number. Only valid inside the 24-hour customer-service window (Meta error 131026 outside).

[demo: deshabilitada] Records inbound stock for a product — restock or initial stock, with an audit trail.

Tracks the current status and event history of a shipment by tracking number.

[demo: deshabilitada] Bulk-creates products in the business catalog from a structured list (up to 50 items).

[demo: deshabilitada] Creates a new customer or updates an existing one for the authenticated business.

Validates an Argentine CUIT or CUIL number. Returns parsed components (prefix, body, check digit), person type, and whether the check digit is mathematically correct. Accepts any format: raw digits, hyphened (20-12345678-9), or spaced. This tool runs the REAL check-digit algorithm — not a demo fixture.