Qué es
Estos ejemplos usan la autenticación con API key contrahttps://pos-api.terominds.com/api. Reemplazá el tenantId y la clave. Las mutaciones necesitan una clave con alcance escritura.
Listar productos
categories, products (con eans, imageUrl y availableLocationIds) y recipes. Para solo los nombres de categoría:
Importar CSV: vista previa y confirmación
El CSV usa las mismas columnas que Catálogo → Acciones → Importar CSV:nombre, precio_pesos, ean, categoria, iva_alicuota, stock, proveedor, control_prioritario.
1. Vista previa
rows, summary y unknownSuppliers. Cada fila trae status (create, conflict, error, duplicate_ean) y data ya normalizado.
2. Confirmar
Mandá las filas que quieras crear o actualizar.defaultCategoryId es obligatorio si alguna fila nueva no tiene categoría. locationId es obligatorio si hay stock.
action puede ser create, update (requiere productId) o skip.
Poner la foto de un producto
PUT /products/:productId reemplaza el producto. Primero obtené el registro (por ejemplo desde /catalog) y reenviá los campos actuales más imageUrl.
imageUrl debe ser una URL pública que el POS pueda descargar. Si también tenés el SHA-256 del archivo, podés enviarlo en imageSha256.
Actualizar medios de pago
Leé el estado actual y volvé a enviar el cuerpo completo. Los campos que no mandes se interpretan como apagados o vacíos.Relacionado
Carga masiva CSV
El mismo archivo desde la pantalla.
Productos
Campos de un producto.
Medios de pago
Efectivo, CVU y otros.
Autenticación
URL base y encabezados.