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.