Referencia

Endpoints

Algunos de nuestros endpoints. Todas las solicitudes requieren el header X-Api-Key y responden en JSON con campos en PascalCase.

Auxiliares

GETPOST
/api/v1/auxiliares
GETPUTDELETE
/api/v1/auxiliares/:id
GET
/api/v1/auxiliares/:id/condiciones-venta
GET
/api/v1/auxiliares/:id/contactos
GET
/api/v1/auxiliares/:id/direcciones-despacho
GET
/api/v1/auxiliares/:id/impuestos
GET
/api/v1/auxiliares/:id/saldo
GET
/api/v1/auxiliares/:id/vendedores

Clientes

Alias retrocompatible — filtra automáticamente por tipo=cliente

GETPOST
/api/v1/clientes
GETPUTDELETE
/api/v1/clientes/:id
GETPUTDELETE
/api/v1/clientes/:id/condiciones-venta
GETPOST
/api/v1/clientes/:id/contactos
PUTDELETE
/api/v1/clientes/:id/contactos/:id
GETPOST
/api/v1/clientes/:id/direcciones-despacho
PUTDELETE
/api/v1/clientes/:id/direcciones-despacho/:id
GET
/api/v1/clientes/:id/estado-cuenta
GETPOST
/api/v1/clientes/:id/impuestos
DELETE
/api/v1/clientes/:id/impuestos/:id
GET
/api/v1/clientes/:id/saldo
GETPOST
/api/v1/clientes/:id/vendedores
DELETE
/api/v1/clientes/:id/vendedores/:id

Catálogos

CRUD completo — mismo patrón en los 18

GETPOST
/api/v1/:recurso
GETPUTDELETE
/api/v1/:recurso/:id
Áreas de negocioBodegasCanalesCargosCentros de costoCiudadesCobradoresComunasConceptos de cajaCondiciones de ventaGirosGruposProvinciasRegionesSubgruposUnidades de medidaVendedoresZonas

Solo lectura

GET
/api/v1/:recurso
AprobadoresAtributosCompromisosConceptos de pérdidaDescuentosImpuestosMonedas

Casos especiales

GETPOST
/api/v1/listas-precio
PUTDELETE
/api/v1/listas-precio/:id
PUTPATCH
/api/v1/listas-precio/:id/items

Productos

GETPOST
/api/v1/productos
GETPUTDELETE
/api/v1/productos/:id
GETPUT
/api/v1/productos/:id/complementarios
DELETE
/api/v1/productos/:id/complementarios/:id
POST
/api/v1/productos/:id/copiar
PUTDELETE
/api/v1/productos/:id/ficha-tecnica
GETPUTDELETE
/api/v1/productos/:id/imagen
GET
/api/v1/productos/:id/impuestos
GETPUT
/api/v1/productos/:id/kit/componentes
GET
/api/v1/productos/:id/margen
GET
/api/v1/productos/:id/partidas
GET
/api/v1/productos/:id/precios
GET
/api/v1/productos/:id/stock
GETPUT
/api/v1/productos/:id/sustitutos
DELETE
/api/v1/productos/:id/sustitutos/:id

Stock

GET
/api/v1/stock
GET
/api/v1/stock/bodegas

Precios

GET
/api/v1/precios

Notas de Venta

GETPOST
/api/v1/notas-venta
GETPUT
/api/v1/notas-venta/:id
PUT
/api/v1/notas-venta/:id/atributos
GET
/api/v1/notas-venta/:id/margen
POST
/api/v1/notas-venta/anular-masivo
POST
/api/v1/notas-venta/concluir-lote

Cotizaciones

GETPOST
/api/v1/cotizaciones
GET
/api/v1/cotizaciones-tipo
GET
/api/v1/cotizaciones-tipo/:id
POST
/api/v1/cotizaciones-tipo/:id/generar-cotizacion
GETPUT
/api/v1/cotizaciones/:id
POST
/api/v1/cotizaciones/:id/estado
GET
/api/v1/cotizaciones/:id/margen
POST
/api/v1/cotizaciones/:id/nota-venta
GETPOST
/api/v1/cotizaciones/:id/seguimientos
POST
/api/v1/cotizaciones/perdidas-batch

Reportes

GET
/api/v1/reports/credit-audit
GET
/api/v1/reports/credit-audit/excel

Connect

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

GET
/api/v1/connect/accounts
GET
/api/v1/connect/accounts/:id/billing
GET
/api/v1/connect/accounts/:id/credit
GET
/api/v1/connect/accounts/:id/shipping-addresses
GET
/api/v1/connect/config
POST
/api/v1/connect/orders
GET
/api/v1/connect/pricelist/:id
GET
/api/v1/connect/products

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

¿Necesita acceso a estos endpoints?

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