Confirmación de compra - bootcamp-uchile-2026/grupo-4-backend GitHub Wiki

Confirmación de compra

Servicio encargado de proporcionar la información de confirmación que se muestra al finalizar el flujo de compra del ecommerce.

El servicio ofrece un endpoint para obtener los datos que necesita la vista de confirmación, como el número de pedido, mensaje, información de correo, entrega estimada, dirección y acciones de navegación.

Endpoints

  • POST /confirmacion-compra - Obtener confirmación de compra

Modelo

ConfirmacionCompra

Representa los datos utilizados para presentar la confirmación de una compra.

Campo Tipo Descripción
numeroPedido number Número de referencia del pedido
mensaje string Mensaje principal de confirmación
detalleEmail string Información sobre el correo de confirmación
entregaEstimada string Texto con la fecha estimada de entrega
direccion string Dirección de entrega mostrada en la confirmación
acciones string[] Acciones de navegación disponibles para el usuario

DTOs

ConfirmacionCompraResponseDto

DTO utilizado para representar la respuesta del endpoint de Confirmación de compra.

Campos

Campo Tipo Descripción
numeroPedido number Número de pedido
mensaje string Mensaje de confirmación
detalleEmail string Información sobre el correo de confirmación
entregaEstimada string Fecha estimada de entrega en formato de texto
direccion string Dirección de entrega
acciones string[] Lista de acciones de navegación para Frontend

Ejemplo de Response Body

{
  "numeroPedido": 12345,
  "mensaje": "¡Gracias por tu compra!",
  "detalleEmail": "Te enviaremos un email con los detalles de tu pedido.",
  "entregaEstimada": "Jueves 22 de agosto",
  "direccion": "Av. El Bosque 123, Santiago",
  "acciones": ["Ver mi pedido", "Volver al inicio"]
}

El endpoint no requiere un cuerpo de solicitud. Por eso, no utiliza un DTO de entrada. Las clases CreateConfirmacionCompraDto y UpdateConfirmacionCompraDto no definen campos ni intervienen en esta operación.


Endpoints detallados

POST /confirmacion-compra

Proporciona la información necesaria para mostrar la pantalla de confirmación de compra.

Request Body

No requiere body ni parámetros de entrada.

Ejemplo de solicitud

POST /confirmacion-compra

Response — 201 Created

{
  "numeroPedido": 12345,
  "mensaje": "¡Gracias por tu compra!",
  "detalleEmail": "Te enviaremos un email con los detalles de tu pedido.",
  "entregaEstimada": "Jueves 22 de agosto",
  "direccion": "Av. El Bosque 123, Santiago",
  "acciones": ["Ver mi pedido", "Volver al inicio"]
}

Validaciones

El endpoint no recibe parámetros ni un cuerpo de solicitud, por lo que no tiene validaciones de campos de entrada.

Respuestas HTTP documentadas

Código Descripción
201 Created Se devuelve la información de confirmación de compra.

Actualmente, el controller documenta únicamente la respuesta HTTP 201 en Swagger.