Shopping Cart Manage customer shopping carts including adding products, updating quantities, and removing items.
All cart endpoints require authentication. Include the JWT token in the Authorization header.
Add Product to Cart
POST /api/ecom/carrito Add a product to the customer’s shopping cart
Add a product to the authenticated customer’s cart. If the product already exists in the cart, the quantity will be incremented.
Bearer token from login response Format: Bearer {token}
Request Body Product code to add to cart
Response Success message: “Producto añadido al carrito”
Example Request curl -X POST https://api.example.com/api/ecom/carrito \ -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \ -H "Content-Type: application/json" \ -d '{ "prd_codigo": "PRD001" }'
Example Response { "message" : "Producto añadido al carrito" }
{ "message" : "Carrito no encontrado" }
500 Internal Server Error
{ "message" : "Error al añadir el producto al carrito" }
The cart is automatically created for each customer during registration. If a product already exists in the cart, the upsert operation will increment its quantity by 1.
Get Cart Contents
GET /api/ecom/carrito Retrieve the customer’s shopping cart with all items
Get the authenticated customer’s cart with all product details, quantities, and pagination.
Bearer token from login response
Query Parameters Page number for paginated cart items (starts at 1)
Response Number of items per page (from PAGINATION_LIMIT env var)
Array of cart items with product details Show Cart item properties
Subtotal for this item (price × quantity)
Example Request curl -X GET "https://api.example.com/api/ecom/carrito?page=1" \ -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
Example Response { "page" : 1 , "limit" : 20 , "totalPages" : 1 , "carrito" : { "crr_codigo" : "CRR001" , "cli_codigo" : "CLI001" , "crr_fecha" : "2024-03-04T10:30:00.000Z" , "crr_total" : 2799.98 }, "detalles" : [ { "prd_codigo" : "PRD001" , "prd_nombre" : "Laptop Gaming MSI" , "prd_precio" : 1299.99 , "dcar_cantidad" : 1 , "dcar_subtotal" : 1299.99 , "prd_imagen" : "/images/products/laptop-msi.jpg" }, { "prd_codigo" : "PRD002" , "prd_nombre" : "Laptop Dell XPS 15" , "prd_precio" : 1499.99 , "dcar_cantidad" : 1 , "dcar_subtotal" : 1499.99 , "prd_imagen" : "/images/products/laptop-dell.jpg" } ] }
{ "message" : "Carrito no encontrado" }
Search Cart Items
GET /api/ecom/carrito/name Search products in cart by name
Filter cart items by product name with pagination.
Bearer token from login response
Query Parameters Page number for pagination
Response Example Request curl -X GET "https://api.example.com/api/ecom/carrito/name?name=laptop&page=1" \ -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
Example Response { "page" : 1 , "limit" : 20 , "totalPages" : 1 , "filtros" : { "name" : "laptop" }, "detalles" : [ { "prd_codigo" : "PRD001" , "prd_nombre" : "Laptop Gaming MSI" , "prd_precio" : 1299.99 , "dcar_cantidad" : 1 , "dcar_subtotal" : 1299.99 , "prd_imagen" : "/images/products/laptop-msi.jpg" } ] }
{ "message" : "Parámetro name requerido" }
Update Item Quantity
PUT /api/ecom/carrito/detalle Update the quantity of a product in the cart
Change the quantity of a specific product in the customer’s cart.
Bearer token from login response
Request Body New quantity (must be greater than 0)
Response Success message: “Cantidad actualizada correctamente”
Example Request curl -X PUT https://api.example.com/api/ecom/carrito/detalle \ -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \ -H "Content-Type: application/json" \ -d '{ "prd_codigo": "PRD001", "cantidad": 3 }'
Example Response { "message" : "Cantidad actualizada correctamente" }
{ "message" : "prd_codigo y cantidad son requeridos" }
{ "message" : "Carrito no encontrado" }
To remove an item from the cart entirely, use the DELETE endpoint instead of setting quantity to 0.
Remove Item from Cart
DELETE /api/ecom/carrito/detalle/:prd_codigo Remove a product from the shopping cart
Completely remove a product from the customer’s cart.
Bearer token from login response
Path Parameters Product code to remove from cart
Response Success message: “Producto eliminado del carrito”
Example Request curl -X DELETE https://api.example.com/api/ecom/carrito/detalle/PRD001 \ -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
Example Response { "message" : "Producto eliminado del carrito" }
{ "message" : "prd_codigo es requerido" }
{ "message" : "Carrito no encontrado" }
Typical cart operations flow:
Browse Products : Use /api/ecom/producto to view available productsAdd to Cart : POST to /api/ecom/carrito with product codeView Cart : GET /api/ecom/carrito to see all items and totalUpdate Quantities : PUT to /api/ecom/carrito/detalle to change item quantitiesRemove Items : DELETE /api/ecom/carrito/detalle/:prd_codigo to remove unwanted itemsProceed to Checkout : Use /api/ecom/pagos/checkout to complete purchase
Example: Complete Cart Management JavaScript - Full Cart Flow
Python - Full Cart Flow
const token = 'your_jwt_token_here' ; const baseURL = 'https://api.example.com' ; // 1. Add product to cart async function addToCart ( productCode ) { const response = await fetch ( ` ${ baseURL } /api/ecom/carrito` , { method: 'POST' , headers: { 'Authorization' : `Bearer ${ token } ` , 'Content-Type' : 'application/json' }, body: JSON . stringify ({ prd_codigo: productCode }) }); return response . json (); } // 2. Get cart contents async function getCart () { const response = await fetch ( ` ${ baseURL } /api/ecom/carrito?page=1` , { headers: { 'Authorization' : `Bearer ${ token } ` } }); return response . json (); } // 3. Update item quantity async function updateQuantity ( productCode , quantity ) { const response = await fetch ( ` ${ baseURL } /api/ecom/carrito/detalle` , { method: 'PUT' , headers: { 'Authorization' : `Bearer ${ token } ` , 'Content-Type' : 'application/json' }, body: JSON . stringify ({ prd_codigo: productCode , cantidad: quantity }) }); return response . json (); } // 4. Remove item async function removeFromCart ( productCode ) { const response = await fetch ( ` ${ baseURL } /api/ecom/carrito/detalle/ ${ productCode } ` , { method: 'DELETE' , headers: { 'Authorization' : `Bearer ${ token } ` } } ); return response . json (); } // Usage await addToCart ( 'PRD001' ); await addToCart ( 'PRD002' ); const cart = await getCart (); console . log ( 'Cart total:' , cart . carrito . crr_total ); await updateQuantity ( 'PRD001' , 3 ); await removeFromCart ( 'PRD002' );
Error Handling Common Error Codes
400 Bad Request: Missing required parameters401 Unauthorized: Invalid or missing authentication token404 Not Found: Cart or product not found500 Internal Server Error: Server-side error
Authentication Errors All cart endpoints require authentication. If the token is missing or invalid:
{ "error" : "Token inválido o expirado" }
Each customer has exactly one active cart. The cart persists across sessions until items are purchased or manually removed.
Source Code Reference Implementation details can be found in:
Routes: /src/routes/ecom.carrito.routes.js:1-37
Controller: /src/controllers/ecom.carrito.controller.js:12-196
Model: /src/models/carrito.model.js
Middleware: /src/middlewares/auth.middleware.js
