SellViaApp
Crear mi app

Documentación de proveedores

Alimenta tu aplicación y recupera pedidos a través de la API.

Conecta tu ERP, plataforma de comercio electrónico, POS o software de negocios para SellViaApp. Enviar categorías, productos y precios, luego recuperar pedidos confirmados de compra como JSON.

Base URLhttps://api.sellviaapp.com/
Formatoapplication/json; charset=utf-8
Versión actual2026.08
TransporteHTTPS

De su software a los clientes

Un flujo de datos de dos vías simple

Su sistema sigue siendo la fuente de sus datos de negocio. Alimenta la tienda SellViaApp mientras que las órdenes confirmadas por el cliente fluyen de vuelta a su software de planificación de recursos institucionales o de negocios.

1

Tu planificación

Productos, categorías, precios y contenidos.

2

API SellViaApp

Seguro JSON intercambia sobre HTTPS.

3

Aplicación móvil

Los clientes navegan y hacen pedidos.

4

Sus órdenes

Su sistema los recupera automáticamente.

No hay entrada duplicada

Los identificadores externos conservan el mapeo a sus referencias de ERP, mientras que la paginación mantiene grandes sincronizaciones confiables.

Inicio rápido

Conecta tu sistema en tres pasos

1

Consigue tus credenciales

La clave de API identifica su tienda. El administrador Token protege las operaciones del servidor.

2

Alimentar el catálogo

Cree categorías, luego envíe o actualice productos de su ERP.

3

Recuperar pedidos

Vota la ruta del proveedor paginado y almacena cada GUID procesado.

Crear un producto · cURL
curl -X POST "https://api.sellviaapp.com/product/add" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_SUPPLIER_KEY" \
  -H "X-Admin-Token: YOUR_ADMIN_TOKEN" \
  -d '{
    "external_key": "ERP-ARTICLE-1042",
    "code": "ART-1042",
    "name": "Premium product",
    "description": "Complete product description",
    "base_price": 24.90,
    "vat_rate": 21,
    "category_id": 12,
    "active": true
  }'
Recuperar pedidos · cURL
curl "https://api.sellviaapp.com/admin/order/list?page=1&per_page=25&from_date=2026-08-01" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_SUPPLIER_KEY" \
  -H "X-Admin-Token: YOUR_ADMIN_TOKEN"
Cada orden contieneGUID, número, cliente, líneas, cantidades, precios, IVA, total, moneda, modo de realización, dirección y fecha.

Seguridad

Cátedras separadas para cada uso

KEY

X-API-Key

Se requiere para identificar al proveedor. Nunca exponga la clave en el JavaScript público.

JWT

Autorización: portador

Se requiere para datos de clientes registrados. Renovarlo a través de auth/refresh.

ADM

X-Admin-Token

Reservado para integraciones aprobadas de servidores que modifiquen catálogos y categorías.

Integración lado del servidor sólo

Mantenga X-API-Key y X-Admin-Token dentro de su servidor o ERP. Nunca los coloque en un sitio web público, aplicación móvil o repositorio de origen.

Puntos finales

Autenticación

Crear, refrescar y cerrar sesiones seguras.

POST /auth/login Clave de API

Firme a un cliente en el uso de su login y contraseña.

POST /auth/refresh Clave de API

Renovar un token de acceso usando un token refrescante.

POST /auth/logout Llav + portador

Cierre el período de sesiones activo.

POST /auth/guest Clave de API

Crear una sesión de invitados cuando esté habilitada por el proveedor.

POST /auth/forgot-password Clave de API

Iniciar la recuperación de la cuenta sin revelar si existe una cuenta.

Puntos finales

Proveedores y marca

Encuentra una tienda y recupera su configuración pública.

GET /admin/supplier/list Público

Busca proveedores visibles en el directorio.

GET /admin/supplier/logo Público

Retrieve an optimised provider logo.

GET /admin/supplier/contact Clave de API

Recuperar datos de contacto público configurados.

GET /admin/supplier/legal Clave de API

Recuperar términos, privacidad, aviso legal y sobre contenido.

GET /admin/megawinappcheck/check_supplier_to_use Público

Resolver un proveedor de un sufijo o identificador.

Puntos finales

Clientes

Crear y gestionar cuentas de clientes para cada tienda.

POST /customer/add Clave de API

Cree un cliente y genere el acceso del proveedor.

GET /customer/list Llav + portador

Lista o filtro de información autorizada al cliente.

GET /customer/me Llav + portador

Recuperar el perfil de cliente firmado.

PATCH /customer/update Llav + portador

Actualizar perfil, idioma, tipo, correo electrónico o contraseña.

DELETE /customer/deleteaccount Llav + portador

Desactivar la cuenta de cliente en la tienda activa.

Puntos finales

Catálogo

Categorías, productos, imágenes, precios, stock, promociones y favoritos.

GET /fam1/list Llav + portador

Lista de categorías primarias.

POST /fam1/add Administrador

Crear una categoría primaria.

PATCH /fam1/update Administrador

Actualizar una categoría primaria.

DELETE /fam1/delete Administrador

Esconder una categoría primaria.

GET /fam2/list Llav + portador

Lista subcategorías.

POST /fam2/add Administrador

Cree una subcategoría.

PATCH /fam2/update Administrador

Actualice una subcategoría.

DELETE /fam2/delete Administrador

Ocultar una subcategoría.

GET /product/list Llav + portador

Listar y buscar productos con paginación.

GET /product/image URL firmada

Servir una imagen de producto firmada y cacheable.

POST /product/add Administrador

Cree un producto.

PATCH /product/update Administrador

Actualizar un producto.

DELETE /product/delete Administrador

Ocultar un producto.

POST /product/favoris Llav + portador

Añadir o quitar un producto de los favoritos.

GET /price/list Llav + portador

Precios de lista aplicables al grupo de clientes.

GET /mark/list Llav + portador

Lista de marcas disponibles.

GET /size/list Llav + portador

Lista de tamaños disponibles.

GET /libweb/list Llav + portador

Lista etiquetas de referencia web.

Puntos finales

Carrito y pedidos

Administrar el carrito y confirmar un pedido atómico.

GET /admin/order/list Administrador

Recuperar todas las órdenes confirmadas del proveedor con cliente, líneas y paginación.

GET /order/add Llav + portador

Recuperar o inicializar el carro actual.

GET /order/list Llav + portador

Lista el historial de carros y pedidos.

DELETE /order/delete Llav + portador

Limpiar y eliminar el carro actual.

GET /order/total Llav + portador

Calcular el subtotal de la cesta, IVA y total.

GET /order/count/line Llav + portador

Cuenta líneas en el carro.

POST /order/sendtomegawin Llav + portador

Confirme el orden, modo de cumplimiento y dirección.

POST /orderline/add Llav + portador

Añadir un producto y cantidad a la cesta.

GET /orderline/list Llav + portador

Recuperar las líneas de carro actuales.

PATCH /orderline/update Llav + portador

Actualizar una cantidad de línea.

DELETE /orderline/delete Llav + portador

Quita una línea del carrito.

Puntos finales

Documentos

Facturas, estimaciones, órdenes y sus líneas.

POST /document/add Llav + portador

Crear un documento relacionado con el cliente.

GET /document/list Llav + portador

Lista o filtración de documentos.

PATCH /document/update Llav + portador

Actualizar un documento identificado por GUID.

DELETE /document/delete Llav + portador

Eliminar un documento y sus líneas.

POST /documentline/add Llav + portador

Agregue una línea y recalcule el documento.

GET /documentline/list Llav + portador

Recuperar un documento con todas sus líneas.

PATCH /documentline/update Llav + portador

Actualizar una línea identificada por GUID.

DELETE /documentline/delete Llav + portador

Eliminar una línea y recalcular los totales.

Puntos finales

Apoyo, notificaciones e integraciones

Comunicación, soporte y sincronización externa del cliente.

GET /support/ticket/list Llav + portador

Lista de entradas disponibles para el cliente.

POST /support/ticket/create Llav + portador

Cree una solicitud de soporte.

GET /support/ticket/list/log_reply Llav + portador

Recuperar un ticket y sus respuestas.

GET /support/ticket/list/waiting_reply_by_support Llav + portador

Lista solicitudes de espera de apoyo.

POST /support/ticket/reply/send Llav + portador

Responder a un billete.

POST /admin/supplier/sendfeedbackfromapp Llav + portador

Enviar comentarios al proveedor.

POST /admin/supplier/sendemailtosalesupport Llav + portador

Soporte de ventas de contacto.

GET /admin/notification/sendtomobile Llav + portador

Recuperar las notificaciones móviles.

POST /admin/notification/setdelivery Llav + portador

Marcar una notificación como entregada.

POST /woocommerce/menu/synchronisation Administrador

Sincronizar las categorías WooCommerce.

POST /woocommerce/product/synchronisation Administrador

Sincronizar productos WooCommerce.

Contratos básicos

Parámetros detallados

Los parámetros se pueden enviar como JSON o, para las rutas de GET, en la cadena de consulta.

/auth/login+
NombreTipoNecesidadDescripción
logincuerdaSí.

Email, inicio de sesión o inicio de sesión incluyendo sufijo proveedor.

passwordcuerdaSí.

Contraseña de cliente.

suppliercuerdaNo

Sufijo de proveedor o clave cuando no se incluye en el login.

/customer/add+
NombreTipoNecesidadDescripción
nomcuerdaSí.

El apellido del cliente.

prenomcuerdaSí.

Nombre de pila del cliente.

emailemailSí.

Correo electrónico único dentro del proveedor.

denominationcuerdaNo

Nombre de la compañía, opcional.

passwordcuerdaSí.

Al menos ocho personajes.

languecuerdaNo

Lenguaje preferido.

/product/list+
NombreTipoNecesidadDescripción
pageenteroNo

Número de página, empezando a 1.

per_pageenteroNo

Productos por página.

searchcuerdaNo

Buscar por código, nombre o descripción.

category_identeroNo

Filtro de categoría primaria.

subcategory_identeroNo

Filtro subcategoría.

/product/add+
NombreTipoNecesidadDescripción
codecuerdaSí.

Código de producto único dentro de la tienda.

namecuerdaSí.

Nombre mostrado en la aplicación.

descriptioncuerdaNo

Descripción detallada del producto.

base_pricedecimalSí.

Precio de venta excluyendo el impuesto según su configuración.

vat_ratedecimalNo

Tasa de IVA, por ejemplo 21.

category_identeroNo

SellViaApp identificador de categoría.

external_keycuerdaNo

Identificador estable de su ERP.

image_urlurlNo

URL HTTPS de la imagen principal.

activebooleanNo

Controla la visibilidad del producto.

/admin/order/list+
NombreTipoNecesidadDescripción
pageenteroNo

Página solicitada, comenzando por 1.

per_pageenteroNo

Pedidos por página, máximo 100.

from_dateFechaNo

Sólo órdenes de devolución de esta fecha.

guidcuerdaNo

Retire una orden de GUID.

statuscuerdaNo

Filtro disponible dependiendo del modo de almacenamiento: pendiente, preparación, lista, entregada o cancelada.

/order/sendtomegawin+
NombreTipoNecesidadDescripción
order_guiduuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuNo

GUID del carro para confirmar.

delivery_modeenumSí.

pickup | delivery

delivery_addresscuerdaNo

Se requiere para el envío.

delivery_dateFechaNo

YYYY-MM-DD

delivery_commentcuerdaNo

Instrucciones de Fulfilment.

languagecuerdaNo

Lenguaje de correo electrónico transaccional.

/document/add+
NombreTipoNecesidadDescripción
doc_typecuerdaSí.

invoice | estimate | purchase_order

customer_identeroNo

Compatibilidad con el legado; el cliente autenticado tiene precedencia.

doc_numbercuerdaSí.

Número de documento.

doc_dateFechaSí.

YYYY-MM-DD

due_dateFechaNo

YYYY-MM-DD

payment_methodcuerdaNo

Método de pago.

remarkcuerdaNo

Nota de forma libre.

/documentline/add+
NombreTipoNecesidadDescripción
document_guiduuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuuSí.

Documento GUID.

textcuerdaSí.

Descripción de la línea.

quantitydecimalSí.

Cantidad.

unit_pricedecimalSí.

Precio unitario, sin IVA.

vat_ratedecimalNo

Tasa de IVA.

discount_percentagedecimalNo

Descuento porcentual.

JSON

Sobre de respuesta

200
{
  "success": true,
  "message": "OK",
  "data": {
    "items": []
  },
  "meta": {
    "page": 1,
    "per_page": 10,
    "total": 0
  }
}

Diagnósticos

Errores estructurados

Cada error expone un código legible por máquina, categoría, mensaje legible por humanos y, cuando está disponible, un identificador de solicitud.

400Solicitud de invalidez
401Autenticación necesaria
403Acceso denegado
404Recursos o ruta no encontrada
409Conflicto comercial
422Falló la validación
429Demasiadas solicitudes
5xxIncidencia técnica
422 Contenido no procesable
{
  "success": false,
  "message": "The delivery address is required.",
  "data": null,
  "error": {
    "code": "DELIVERY_ADDRESS_REQUIRED",
    "category": "validation",
    "message": "The delivery address is required.",
    "details": {}
  }
}

Documentación de legado

Las URL de Legacy siguen siendo reconocidas

La nueva API acepta variantes publicadas en doc.sellviaapp.com para que las integraciones existentes sigan funcionando.

/api/document/*→/document/*
/user/add→/customer/add
/fam1/insert→/fam1/add
/product/insert→/product/add
/product/favorites→/product/favoris
/order/count→/order/count/line
/CUSTOMER/LIST→/customer/list
Verificación completa

Cada ruta publicada en la documentación heredada ahora tiene una ruta nativa o un alias de compatibilidad.