Compra

Consultar y anular los pedidos del cliente, llenar el carrito, calcular el envío y el descuento de un cupón, y pagar.

1 min de lecturaActualizado el 30 de setiembre de 2026

Qué incluye

  • Pedidos: el historial de pedidos del cliente, el detalle de cada uno y su anulación.
  • Carrito: cómo se identifica y de quién es, añadir, ver y quitar productos, calcular el envío y el descuento de un cupón, y pagar.

Los pedidos exigen el token del cliente. El carrito se identifica con la cabecera user-ip-address. Ver autenticación.

Consulta de DNI o RUC

Usa GET /api/v1/ecommerce/service/{type}/{number}, con el token del cliente: type es dni o ruc, y number tiene 8 cifras para un DNI y 11 para un RUC. Devuelve en data lo que responde la consulta (nombre_o_razon_social o nombre_completo, direccion, ubigeo…), que es lo que se reenvía en data al pagar. Si el documento no existe responde 404 DOCUMENT_NOT_FOUND, y si el servicio externo no contesta, 503 LOOKUP_SERVICE_UNAVAILABLE.

GET /api/v1/ecommerce/services/ruc/{number} es la copia antigua: hace la misma consulta, solo para RUC, y devuelve solo name y trade_name. No la uses.