Datos de facturación - bootcamp-uchile-2026/grupo-4-backend GitHub Wiki

Datos de facturación

Servicio encargado de recibir los datos necesarios para la facturación de una compra dentro del ecommerce.

El servicio permite ingresar el nombre completo, RUT y dirección de facturación mediante un endpoint REST.

Endpoints

  • POST /datos-facturacion - Ingresar datos de facturación

Modelo

DatosFacturacion

Representa la información de facturación asociada a una solicitud.

Campo Tipo Descripción
id number Identificador del registro de datos de facturación
nombreCompleto string Nombre completo para la facturación
rut string RUT de la persona que solicita la facturación
direccion string Dirección de facturación

DTOs

CreateDatosFacturacionDto

DTO utilizado para ingresar los datos de facturación.

Campos

Campo Tipo Requerido Descripción Validaciones
nombreCompleto string Sí Nombre completo para la facturación Debe ser texto, no estar vacío y contener al menos un carácter distinto de espacio
rut string Sí RUT de la persona que solicita la facturación Debe ser texto, no estar vacío y contener al menos un carácter distinto de espacio
direccion string Sí Dirección de facturación Debe ser texto, no estar vacío y contener al menos un carácter distinto de espacio

Nota: Las validaciones definidas actualmente para rut comprueban que sea un texto no vacío y que no consista únicamente en espacios. No comprueban el formato ni el dígito verificador del RUT chileno.

Ejemplo de Request Body

{
  "nombreCompleto": "Juan Pérez",
  "rut": "12.345.678-5",
  "direccion": "Av. Providencia 1234, Santiago"
}

DatosFacturacionResponseDto

DTO utilizado para representar la respuesta del servicio. Incluye el identificador del registro junto con los datos enviados.

Campo Tipo Descripción
id number Identificador del registro
nombreCompleto string Nombre completo para la facturación
rut string RUT de facturación
direccion string Dirección de facturación

Ejemplo de Response Body

{
  "id": 1,
  "nombreCompleto": "Juan Pérez",
  "rut": "12.345.678-5",
  "direccion": "Av. Providencia 1234, Santiago"
}

Endpoints detallados

POST /datos-facturacion

Recibe los datos de facturación y devuelve la estructura definida en DatosFacturacionResponseDto.

Request Body

Utiliza CreateDatosFacturacionDto.

{
  "nombreCompleto": "Juan Pérez",
  "rut": "12.345.678-5",
  "direccion": "Av. Providencia 1234, Santiago"
}

Response — 201 Created

{
  "id": 1,
  "nombreCompleto": "Juan Pérez",
  "rut": "12.345.678-5",
  "direccion": "Av. Providencia 1234, Santiago"
}

Response — 400 Bad Request

Se documenta para solicitudes cuyos datos de entrada no sean válidos.

Las validaciones del DTO requieren que nombreCompleto, rut y direccion sean cadenas de texto no vacías y que no contengan solamente espacios.

El formato exacto del cuerpo de error depende de la configuración global de validación y manejo de excepciones de la API.