Orders Service

​

Overview

​

Core Entities

​

Pedido

• id (Integer) - Primary key
• codigo (String) - Unique order code
• serie (String) - Unique order series
• descripcion (String) - Order description
• estado (String) - Order status (default: “PENDIENTE”)
• clienteId (Long) - Customer ID reference
• cliente (Cliente) - Customer data (transient, from Cliente service)
• detalle (List<PedidoDetalle>) - Order line items
• fechaPedido (LocalDateTime) - Order creation timestamp (auto-set)
• fechaEntrega (LocalDate) - Delivery date (auto-set to 1 week after order)
• baseImponible (Double) - Taxable base amount
• igv (Double) - Tax amount (IGV)
• total (Double) - Total amount
• formapagoId (Long) - Payment method ID reference
• formaPago (FormaPago) - Payment method data (transient)

• fechaPedido: Current timestamp
• fechaEntrega: Order date + 1 week
• estado: “PENDIENTE”

• One-to-many with PedidoDetalle via pedido_id
• References Cliente (external service)
• References FormaPago (external service)

​

PedidoDetalle

• id (Long) - Primary key
• cantidad (Integer) - Quantity ordered
• precioUnitario (Double) - Unit price
• baseImponible (Double) - Line taxable base
• igv (Double) - Line tax amount (18%)
• total (Double) - Line total
• productoId (Long) - Product ID reference
• producto (Producto) - Product data (transient)

• Many-to-one with Pedido via pedido_id
• References Producto (from Catalog service)

​

Key Components

​

Controllers

​

PedidoController

• POST /pedido - Create new order
• GET /pedido - List all orders
• GET /pedido/{id} - Get order by ID
• PUT /pedido/{id} - Update order
• DELETE /pedido/{id} - Delete order

​

Services

​

PedidoService

• createPedido() - Create order with validation
• getAllPedidos() - List all orders with customer/payment data
• getPedidoById() - Get order with full details
• updatePedido() - Update order details
• deletePedido() - Delete order

​

Repositories

​

PedidoRepository

​

Feign Clients

​

ProductoFeign

​

ClienteFeign

​

FormaPagoFeign

​

CategoriaFeign

​

Configuration

​

OpenAPIConfig

​

DTOs

​

Transient DTOs (from other services)

• Producto - Product data from Catalog service
• Cliente - Customer data from Customer service
• FormaPago - Payment method from Payment service
• Categoria - Category data from Catalog service

​

Dependencies

• spring-boot-starter-data-jpa - JPA/Hibernate
• spring-boot-starter-web - REST API
• spring-boot-starter-validation - Bean validation
• spring-cloud-starter-netflix-eureka-client:4.0.3 - Service discovery
• spring-cloud-starter-config:4.0.4 - Centralized configuration
• spring-cloud-starter-openfeign - Feign client for microservice communication
• spring-cloud-starter-circuitbreaker-resilience4j - Circuit breaker pattern
• springdoc-openapi-starter-webmvc-ui:2.0.2 - OpenAPI/Swagger UI
• mysql-connector-j - MySQL driver
• lombok - Code generation

​

Configuration

server:
  port: ${PORT:${SERVER_PORT:0}}

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/pedido-ms
    username: root
    password: ""
  jpa:
    hibernate:
      ddl-auto: update
    show-sql: true

eureka:
  client:
    serviceUrl:
      defaultZone: http://localhost:8090/eureka

​

Database Schema

• pedido - Order header
  • Primary key: id
  • Unique constraints: codigo, serie
  • Foreign keys: cliente_id, formapago_id (references external services)
• pedido_detalle - Order line items
  • Primary key: id
  • Foreign keys: pedido_id → pedido.id, producto_id (external)

​

Business Logic

​

Order Status Management

• PENDIENTE - Default state for new orders
• Can be updated to other statuses (e.g., EN_PROCESO, ENTREGADO, CANCELADO)

​

Delivery Date Calculation

• fechaPedido: Set to current timestamp
• fechaEntrega: Automatically set to 1 week after order date
• Both dates can be manually updated

​

Tax Calculation

• Base Imponible: Sum of line item bases
• IGV (Tax): 18% of base imponible
• Total: Base imponible + IGV

​

Order vs Sale Distinction

• Orders (Pedidos): Pre-sales commitments, can be modified/cancelled
• Sales (Ventas): Completed transactions with invoice numbers
• Orders may be converted to sales after fulfillment

​

Key Features

• Customer order management with CRUD operations
• Order status tracking (PENDIENTE, etc.)
• Automatic delivery date calculation (1 week default)
• Multi-line item support
• Integration with Customer, Product, and Payment services
• Tax calculation (IGV at 18%)
• Unique order codes and series
• Circuit breaker for fault tolerance
• OpenAPI/Swagger documentation
• Eureka service discovery integration

​

Integration Points

​

Consumes:

• Catalog Service (ProductoFeign, CategoriaFeign) - Product data and availability
• Customer Service (ClienteFeign) - Customer information
• Payment Service (FormaPagoFeign) - Payment method details

​

APIs Exposed:

• Order CRUD operations
• Order listing and retrieval
• Order status updates

​

Order Lifecycle

1. Order Creation - Customer places order with PENDIENTE status
2. Order Processing - Status updated as order is prepared
3. Order Fulfillment - Delivery scheduled (fechaEntrega)
4. Conversion to Sale - Order may be converted to Venta (Sale) upon completion
5. Inventory Impact - No immediate inventory changes (reserved on conversion)

​

Differences from Sales Service