Parámetros query

Node.js (en tu servidor)

const res = await fetch('https://appvendly.lat/api/v1/catalogo?limit=20&page=1', {
  headers: { 'X-API-Key': process.env.VENDLY_API_KEY }
});
const { productos, total } = await res.json();

cURL

curl -H "X-API-Key: $VENDLY_API_KEY" \
     "https://appvendly.lat/api/v1/catalogo?categoria=Electrónica"

Respuesta

{
  "ok": true,
  "productos": [
    {
      "id": "uuid",
      "name": "Auriculares Bluetooth",
      "description": "...",
      "price": 145000,
      "wholesale_price": 120000,
      "stock": 8,
      "unit": "Unid.",
      "category": "Electrónica",
      "image_url": "https://appvendly.lat/uploads/img.jpg",   // URL absoluta
      "images": [],
      "variants": [// tipo: "color" o "modelo" (talles, diseños...)
        { "id": "uuid-variante", "color": "Negro", "stock": 5, "tipo": "color", "image_url": null },
        { "id": "uuid-variante", "color": "Talle M", "stock": 3, "tipo": "modelo", "image_url": null }
      ]
    }
  ],
  "total": 47, "page": 1, "limit": 20
}

Node.js (en tu servidor)

const res = await fetch(`https://appvendly.lat/api/v1/catalogo/${productId}`, {
  headers: { 'X-API-Key': process.env.VENDLY_API_KEY }
});
const { producto } = await res.json();

Respuesta

{ "ok": true, "producto": { /* mismo esquema que el array de /catalogo */ } }

Parámetros query

Respuesta

{
  "ok": true,
  "stock": [
    { "id": "uuid", "name": "Producto", "code": "P001",
      "category": "Bazar", "stock": 3, "min_stock": 5, "unit": "Unid.", "active": true }
  ]
}

Respuesta

{
  "ok": true,
  "pedidos": [
    {
      "id": "uuid", "ticket_number": "WEB-123456",
      "total": 120000, "estado": "pendiente",   // pendiente | pagado | cancelado
      "status": "pending",
      "payment_method": "efectivo",
      "cliente": "Juan Pérez", "cliente_phone": "0981000000",   // "Consumidor Final" si no hay cliente
      "customer_note": "Entregar por la tarde",
      "created_at": "2026-07-05T10:30:00Z"
    }
  ]
}

Respuesta

{
  "ok": true,
  "pedido": {
    "id": "uuid", "ticket_number": "WEB-123456", "total": 90000,
    "estado": "pendiente", "payment_method": "transferencia", "cliente": "Juan Pérez",
    "items": [
      { "product_id": "uuid", "product_name": "Remera — Negro", "variant_id": "uuid-variante",
        "variante": "Negro", "quantity": 2, "price": 45000, "subtotal": 90000 }
    ]
  }
}

Body JSON

Node.js (en tu servidor)

const res = await fetch('https://appvendly.lat/api/v1/pedidos', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': process.env.VENDLY_API_KEY
  },
  body: JSON.stringify({
    items: [
      { product_id: 'uuid-producto', quantity: 2, variant_id: 'uuid-variante' },   // producto con variantes
      { product_id: 'uuid-otro', quantity: 1 }                                  // producto sin variantes
    ],
    price_type: 'minorista',
    payment_method: 'transferencia',
    customer: { name: 'Juan Pérez', phone: '0981000000' }
  })
});
const { ok, pedido } = await res.json();   // pedido.total = total calculado por Vendly

cURL

curl -X POST https://appvendly.lat/api/v1/pedidos \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $VENDLY_API_KEY" \
  -d '{"items":[{"product_id":"uuid","quantity":1}]}'

Respuesta exitosa

{
  "ok": true,
  "pedido": {
    "id": "uuid", "ticket_number": "WEB-123456", "total": 90000,
    "estado": "pendiente", "price_type": "minorista",
    "items": [
      { "product_id": "uuid", "product_name": "Remera — Negro", "variante": "Negro",
        "quantity": 2, "price": 45000, "subtotal": 90000, "precio": "minorista" }
    ]
  }
}

Errores

Body JSON

Node.js (en tu servidor)

const res = await fetch(`https://appvendly.lat/api/v1/pedidos/${pedidoId}`, {
  method: 'PATCH',
  headers: { 'Content-Type': 'application/json', 'X-API-Key': process.env.VENDLY_API_KEY },
  body: JSON.stringify({ estado: 'cancelado' })
});

Respuesta

{ "ok": true, "pedido": { "id": "uuid", "ticket_number": "WEB-123456", "estado": "cancelado", "stock_devuelto": true } }

Errores

También se puede hacer desde el panel de Vendly: en los pedidos web pendientes, Rechazar; o en cualquier venta, Anular. En ambos casos el stock vuelve solo.

Parámetros query

Respuesta

{
  "ok": true,
  "clientes": [
    { "id": "uuid", "name": "Cliente Ejemplo",
      "phone": "0981000000", "email": "c@mail.com", "ruc_ci": "1234567",
      "address": "Av. Siempre Viva 123", "created_at": "2026-07-05T10:30:00Z" }
  ],
  "total": 152, "page": 1, "limit": 50
}

Node.js (en tu servidor)

const res = await fetch(`https://appvendly.lat/api/v1/clientes/${clienteId}`, {
  headers: { 'X-API-Key': process.env.VENDLY_API_KEY }
});

Respuesta

{ "ok": true, "cliente": { "id": "uuid", "name": "...", "address": "...", /* ... */ } }

Parámetros

Respuesta

{
  "ok": true,
  "ventas": [
    { "id": "uuid", "ticket_number": "T-0001", "total": 85000,
      "payment_method": "efectivo", "status": "completed",
      "channel": "pos", "cliente": "Juan Pérez",
      "created_at": "2026-07-05T10:00:00Z" }
  ]
}

Respuesta

{
  "ok": true,
  "total_hoy": 350000,
  "ventas_hoy": 4,
  "total_mes": 8500000,
  "ventas_mes": 87,
  "ticket_promedio": 97701.15   // promedio histórico de todas las ventas
}

Respuesta

{
  "ok": true,
  "productos_activos": 48,
  "clientes_total": 152,
  "ventas_mes": 8500000,
  "ventas_mes_count": 87,
  "stock_bajo": 3
}

Respuesta

{
  "ok": true,
  "config": { "currency": "PYG", "country": "PY", "usd_rate": 7800, "ars_rate": 9.5 }
}

currency es PYG para negocios de Paraguay y ARS para negocios de Argentina. Todos los montos de la API están en esa moneda.

Parámetros query

JavaScript (en tu página web)

const TIENDA = 'tu-tenant-id';   // público, no es la API Key
const res = await fetch(`https://appvendly.lat/api/public/${TIENDA}/productos?limit=50`);
const { productos, total } = await res.json();

Respuesta

{
  "ok": true,
  "productos": [{
    "id": "uuid", "name": "Remera", "description": "...", "category": "Indumentaria",
    "price": 50000, "precio_minorista": 50000, "precio_mayorista": 40000, "stock": 8,
    "image_url": "https://appvendly.lat/uploads/remera.jpg", "images": ["https://…"],
    "variants": [{ "color": "Negro", "stock": 5 }]
  }],
  "total": 47, "page": 1, "limit": 50
}

También: GET /api/public/{tenant_id}/productos/{id} (un producto) y GET /api/public/{tenant_id}/categorias. Este listado incluye productos sin stock: mostralos como "Agotado" usando el campo stock.

Respuesta

{ "ok": true, "currency": "PYG", "country": "PY", "usd_rate": 7800, "ars_rate": 9.5 }

currency: PYG (Paraguay, sin decimales) o ARS (Argentina, hasta 2 decimales).

Body JSON

JavaScript (en tu página web)

const res = await fetch(`https://appvendly.lat/api/public/${TIENDA}/orders`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },   // sin X-API-Key
  body: JSON.stringify({
    items: [{ product_id: 'uuid-producto', quantity: 2 }],
    payment_method: 'transferencia',
    customer_note: 'Juan Pérez · 0981 000 000 · Av. España 123, Asunción'
  })
});
const { success, order_id, error } = await res.json();

Respuesta

{ "success": true, "order_id": "uuid" }      // error: { "success": false, "error": "Producto no disponible" }