com.somosvelora/velora

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, h…

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.

[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.

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

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

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

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

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

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

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

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).

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

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

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

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

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

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

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

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

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

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

[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] Sends a pre-approved Meta WhatsApp template message. Window-independent — can be sent proactively, outside the 24-hour session window.

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.

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

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

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

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

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 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.

[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 a…

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

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

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

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

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

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

[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 WhatsApp Business using the BYOA Meta Embedded Signup model. Primary: returns a signup link. Optional: registers a phone number as a lightweight pre-step.

[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] Bulk-creates products in the business catalog from a structured list (up to 50 items).

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.

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

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

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…

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.