API de NETSOLIN-IA
API REST en formato JSON para conectar su tienda virtual, e-commerce u otros sistemas con el ERP: catálogo de productos, existencias en tiempo real, precios, clientes y pedidos. Esta página es un resumen para evaluar la integración; al activar el servicio entregamos la guía técnica completa y acompañamos a su equipo o proveedor de desarrollo.
Cómo empezar
1. Solicite sus credenciales. Cada empresa recibe la URL de su servidor y una llave de acceso (API Key) propia. Se solicitan a Netsolin: WhatsApp +57 314 237 6479 o mercadeo@netsolin.com.
2. Autentíquese en cada petición enviando la llave en el encabezado:
| Encabezado | Ejemplo |
|---|---|
X-API-Key | X-API-Key: su-llave-secreta |
Authorization (alternativa) | Authorization: Bearer su-llave-secreta |
3. URL base: https://<servidor-de-su-empresa>/api/ecommerce/v1 — la entregamos junto con la llave.
Respuestas de autenticación: 401 sin llave · 403 llave inválida · 503 API no habilitada para la empresa.
Verifique la conexión con GET/ping — responde el nombre de la empresa, NIT y fecha del servidor.
Endpoints
Catálogo, existencias y precios
| Endpoint | Qué hace |
|---|---|
GET/productos | Catálogo paginado. Filtros: q, sku, ean, clasificación y actualizado_desde para sincronización incremental. |
GET/productos/{sku} | Ficha completa de un producto: existencias por bodega y precios de todas las listas. |
GET/existencias | Inventario vivo por referencia y bodega: físico, comprometido y disponible (físico − comprometido) — lo que evita la sobreventa. |
GET/listas-precios | Maestro de listas de precios. |
GET/precios | Precios por lista (?lista=) o resueltos por cliente (?cliente=), incluidos precios exclusivos. |
Clientes
| Endpoint | Qué hace |
|---|---|
GET/clientes | Búsqueda por NIT, correo o texto. |
GET/clientes/{codigo} | Cliente puntual. |
POST/clientes | Crea o actualiza por NIT (nunca duplica) — ideal para el registro del checkout. |
Pedidos
| Endpoint | Qué hace |
|---|---|
POST/pedidos | Crea un pedido de venta real en el ERP. Idempotente por external_id: los reintentos devuelven el mismo pedido. Acepta validar_solo para calcular totales e IVA sin grabar (útil en el checkout). |
GET/pedidos | Listado y seguimiento de estados con actualizado_desde, external_id, fechas y estado. |
GET/pedidos/{numero} | Estado del pedido, cantidades entregadas y remisión. |
POST/pedidos/{numero}/anular | Anula el pedido y libera el inventario comprometido. |
Auxiliares
| Endpoint | Qué hace |
|---|---|
GET/ping | Verifica conectividad y credenciales. |
GET/bodegas | Bodegas con nombre y estado. |
GET/ciudades | Códigos de ciudad para el alta de clientes. |
Ejemplo: crear un pedido desde su tienda
// Petición { "external_id": "WEB-1001", "nit": "900123456", "fecha": "2026-07-03", "dir_despacho": "CALLE 100 # 10-20 BODEGA 3", "fletes": 12000, "items": [ { "sku": "REF001", "cantidad": 3, "descuento_pct": 10 }, { "sku": "REF002", "cantidad": 1 } ] } // Respuesta — el ERP calcula descuentos, IVA y total { "numero": "1001", "estado": "PENDIENTE", "external_id": "WEB-1001", "idempotente": false, "subtotal": 401500.0, "iva": 45885.0, "fletes": 12000.0, "total": 459385.0 }
Si la tienda reintenta la misma orden (por un tiempo de espera o un webhook duplicado), la respuesta trae "idempotente": true y el mismo pedido: nunca se duplica una venta.
Plugin oficial para WooCommerce
Si su tienda es WordPress + WooCommerce, no necesita programar: el plugin oficial de Netsolin conecta la tienda con el ERP sobre este mismo API.
- Del ERP a la tienda: publica el inventario disponible como stock (se actualiza automáticamente), sincroniza catálogo y precios desde la lista que usted elija, y refleja los estados del pedido (despachado, entregado, anulado).
- De la tienda al ERP: cada orden de WooCommerce se crea como pedido de venta real (sin duplicados), los clientes se crean por NIT desde el checkout, el flete viaja con el pedido y cancelar en la tienda anula en el ERP.
- Instalación: Netsolin entrega el plugin, se sube en WordPress, se configura la URL del API y la llave, y se prueba la conexión con un clic. Requisito clave: el SKU de WooCommerce debe ser el código de referencia de venta en NETSOLIN-IA.
¿Otra plataforma u otro sistema?
El API es estándar (REST + JSON), así que cualquier plataforma de e-commerce, CRM u aplicación propia puede consumirla. Y si prefiere no desarrollar, nuestro equipo construye la integración a la medida — también hemos construido APIs específicas para operaciones especiales de clientes (hubs logísticos, portales de autogestión).