Base URL y ambientes
Para pedir tus credenciales de la API Inventario, escribe a inventarios@cashea.app.
Sandbox
Sandbox es el ambiente de pruebas donde integras y validas antes de pasar a producción. Su catálogo es independiente: los productos que cargues ahí no aparecen en el marketplace real. Cada ambiente tiene su propia API Key — la de Sandbox no sirve en producción, ni viceversa. Ver Autenticación.Cómo operar la API
Las operaciones tienen un orden: un producto necesita una categoría válida, los atributos de esa categoría y una marca comercial antes de poder crearse.1
Elige la categoría
Listar categorías para navegar el árbol o buscar por nombre. Elige una categoría hoja (
hasChildren: false) y guarda su uuid.2
Trae sus atributos (opcional)
No todas las categorías tienen atributos. Obtener categoría por ID te dice cuáles tiene, cuáles son obligatorios y qué valores aceptan. De ahí salen los pares
attributeId / valueId.3
Elige la marca comercial
Listar marcas comerciales devuelve las habilitadas de tu tienda. Sus
uuid van en commercialBrands.4
Carga los productos
Crear productos encola un job y responde
202 con un jobId. No devuelve los productos creados.5
Consulta el job
Obtener job por ID hasta que el estado sea
COMPLETED o FAILED. Revisa siempre el array errors: un job COMPLETED puede traer ítems fallidos.6
Verifica el resultado
Obtener producto por SKU o Buscar productos para confirmar qué quedó cargado.
sku y también devuelve un jobId.
Manejo de errores
Los errores se devuelven en el siguiente formato:Common status codes
Cada endpoint puede tener errores propios además de estos; están en su sección Errors.
Planes de cuotas
bestInstallmentPlan es un techo, no una asignación. Al crear o actualizar un producto declaras el máximo de cuotas que quieres ofrecer (3, 6, 9 o 12) y Cashea le otorga todos los planes elegibles hasta ese valor, nunca por encima.
La elegibilidad la define el precio: cada plan tiene un monto mínimo, y un producto recibe solamente los planes cuyo mínimo alcanza. Por eso el valor que devuelve la API puede ser menor al que enviaste.
Cashea Envíos
freeShipping lo calcula Cashea en base al peso del producto y a las opciones de envío configuradas para tu comercio. No es un campo que puedas enviar al crear ni al actualizar productos: aparece solo en las respuestas de Obtener producto por SKU y Buscar productos, y como filtro en el body de búsqueda.