Referencia

Endpoints

34 endpoints organizados en 6 grupos. Todas las consultas 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

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

¿Necesita acceso a estos endpoints?

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