Referencia

Endpoints

42 endpoints organizados en 7 grupos. Todas las solicitudes requieren el header X-Api-Key y responden en JSON con campos en PascalCase.

Auxiliares

8 endpoints
GET/api/v1/auxiliares

Listar auxiliares con paginación

Params: tipo, rut, nombre, email, page, limit

GET/api/v1/auxiliares/{codaux}

Detalle de un auxiliar

GET/api/v1/auxiliares/{codaux}/contactos

Contactos asociados

GET/api/v1/auxiliares/{codaux}/direcciones-despacho

Direcciones de despacho

GET/api/v1/auxiliares/{codaux}/vendedores

Vendedores asignados

GET/api/v1/auxiliares/{codaux}/impuestos

Impuestos configurados

GET/api/v1/auxiliares/{codaux}/condiciones-venta

Vendedor, condición, crédito, zona, canal, cobrador, lista de precios

GET/api/v1/auxiliares/{codaux}/saldo

Saldo desglosado en 4 capas + crédito disponible

Clientes

Alias retrocompatible — filtra automáticamente por tipo=cliente

8 endpoints
GET/api/v1/clientes

Listar clientes

Params: rut, nombre, email, page, limit

GET/api/v1/clientes/{codaux}

Detalle del cliente

GET/api/v1/clientes/{codaux}/contactos

Contactos del cliente

GET/api/v1/clientes/{codaux}/direcciones-despacho

Direcciones de despacho

GET/api/v1/clientes/{codaux}/vendedores

Vendedores del cliente

GET/api/v1/clientes/{codaux}/impuestos

Impuestos del cliente

GET/api/v1/clientes/{codaux}/condiciones-venta

Condiciones de venta

GET/api/v1/clientes/{codaux}/saldo

Saldo desglosado

Catálogos

11 endpoints
GET/api/v1/giros

Actividades económicas SII

GET/api/v1/comunas

Comunas con su región

GET/api/v1/ciudades

Ciudades con región y código postal

GET/api/v1/provincias

Provincias con su región

GET/api/v1/regiones

Regiones

GET/api/v1/vendedores

Vendedores con tipo y email

GET/api/v1/zonas

Zonas de venta

GET/api/v1/canales

Canales de venta

GET/api/v1/cobradores

Cobradores

GET/api/v1/listas-precio

Listas de precios

GET/api/v1/condiciones-venta

Condiciones de venta con días de plazo

Productos

4 endpoints
GET/api/v1/productos

Listar productos con paginación

Params: grupo, subgrupo, activo, page, limit

GET/api/v1/productos/{codprod}

Detalle de un producto

GET/api/v1/productos/{codprod}/stock

Stock por bodega o componentes si es kit

Params: bodega

GET/api/v1/productos/{codprod}/precios

Precios en todas las listas de precios

Stock

2 endpoints
GET/api/v1/stock

Stock consolidado de todos los productos

Params: bodega

GET/api/v1/stock/bodegas

Stock desglosado por bodega

Params: bodega

Precios

1 endpoints
GET/api/v1/precios

Todos los productos con precios en todas las listas

Connect

Integración e-commerce — captura de pedidos, creación de clientes y sincronización de productos

8 endpoints
POST/api/v1/connect/orders

Crear Nota de Venta en Softland a partir de un pedido de e-commerce

GET/api/v1/connect/config

Configuración del plugin de integración e-commerce

GET/api/v1/connect/accounts

Buscar cliente por RUT

Params: tax_id

GET/api/v1/connect/accounts/{id}/billing

Datos de facturación del cliente

GET/api/v1/connect/accounts/{id}/shipping-addresses

Direcciones de despacho del cliente

GET/api/v1/connect/accounts/{id}/credit

Crédito autorizado y disponible

GET/api/v1/connect/products

Productos con stock y precios para sincronización

Params: page, limit

GET/api/v1/connect/pricelist/{id}

Precios de todos los productos en una lista específica

Errores

Códigos de error

Todos los errores devuelven un objeto con código estructurado, mensaje descriptivo y status HTTP.

400BAD_REQUESTParámetros inválidos
401UNAUTHORIZEDClave inválida o no proporcionada
403FORBIDDENClave sin permiso para este endpoint
404NOT_FOUNDRecurso no encontrado
409CONFLICTConflicto con el estado actual
422VALIDATION_ERRORError de validación
429RATE_LIMITEDLímite de consultas excedido
500INTERNAL_ERRORError interno del servidor
Más sobre ConexionERP:Cómo funcionaIntegracionesGuía: stock por bodega

¿Necesita acceso a estos endpoints?

Le entregamos las claves y lo dejamos funcionando en 1 hora.

Conversemos sobre su casoo llámenos al 800 914 659