forked from erp-dev/erp
feat: sales return order and purchase return order
This commit is contained in:
2
api_v1/views/business/purchase_return/__init__.py
Normal file
2
api_v1/views/business/purchase_return/__init__.py
Normal file
@@ -0,0 +1,2 @@
|
||||
|
||||
|
||||
181
api_v1/views/business/purchase_return/views.py
Normal file
181
api_v1/views/business/purchase_return/views.py
Normal file
@@ -0,0 +1,181 @@
|
||||
from rest_framework import status, views, serializers, pagination
|
||||
from rest_framework.permissions import IsAuthenticated
|
||||
from rest_framework.response import Response
|
||||
|
||||
from basic_info import models as basic_models
|
||||
from business import services as business_services
|
||||
from business import models as business_models
|
||||
from api_v1.views.stock_change_views.mixins import StockChangeViewMixin
|
||||
|
||||
|
||||
class PurchaseReturnOrderItemSerializer(serializers.ModelSerializer):
|
||||
class Meta:
|
||||
model = business_models.PurchaseReturnOrderItem
|
||||
fields = [
|
||||
'id', 'product', 'price', 'color', 'quantity', 'unit',
|
||||
'empty_diff_percent', 'quantity_of_rolls', 'num_of_rolls',
|
||||
'consume_detail_ids', 'batch_number', 'remarks',
|
||||
'created_at', 'updated_at', 'spec',
|
||||
]
|
||||
read_only_fields = [
|
||||
'id', 'created_at', 'updated_at',
|
||||
'total_amount', 'diff_quantity', 'real_quantity',
|
||||
]
|
||||
|
||||
|
||||
class PurchaseReturnOrderSerializer(serializers.ModelSerializer):
|
||||
total_amount = serializers.SerializerMethodField(read_only=True)
|
||||
diff_quantity = serializers.SerializerMethodField(read_only=True)
|
||||
total_quantity = serializers.SerializerMethodField(read_only=True)
|
||||
supplier_name = serializers.CharField(source='supplier.name', read_only=True)
|
||||
operator_name = serializers.CharField(source='operator.name', read_only=True)
|
||||
warehouse_name = serializers.CharField(source='warehouse.name', read_only=True)
|
||||
items = PurchaseReturnOrderItemSerializer(many=True, read_only=True)
|
||||
|
||||
def get_total_amount(self, obj: business_models.PurchaseReturnOrder):
|
||||
return obj.get_total_amount()
|
||||
|
||||
def get_diff_quantity(self, obj: business_models.PurchaseReturnOrder):
|
||||
return obj.get_total_diff_quantity()
|
||||
|
||||
def get_total_quantity(self, obj: business_models.PurchaseReturnOrder):
|
||||
return obj.get_total_quantity()
|
||||
|
||||
class Meta:
|
||||
model = business_models.PurchaseReturnOrder
|
||||
fields = [
|
||||
'id', 'supplier', 'supplier_name', 'purchase_order', 'return_date',
|
||||
'total_amount', 'diff_quantity', 'total_quantity',
|
||||
'operator', 'operator_name', 'warehouse', 'warehouse_name',
|
||||
'status', 'remarks', 'created_at', 'updated_at', 'items',
|
||||
]
|
||||
read_only_fields = [
|
||||
'id', 'created_at', 'updated_at', 'items',
|
||||
'supplier_name', 'operator_name', 'warehouse_name',
|
||||
]
|
||||
|
||||
|
||||
class PurchaseReturnOrderPagination(pagination.LimitOffsetPagination):
|
||||
default_limit = 20
|
||||
max_limit = 100
|
||||
|
||||
|
||||
class PurchaseReturnOrderView(StockChangeViewMixin, views.APIView):
|
||||
permission_classes = [IsAuthenticated]
|
||||
pagination_class = PurchaseReturnOrderPagination
|
||||
|
||||
def get(self, request):
|
||||
if not self.check_employee_permission(request):
|
||||
return self.permission_error_response('无权限访问')
|
||||
|
||||
merchant = request.user.employee.merchant
|
||||
queryset = business_models.PurchaseReturnOrder.objects.filter(merchant=merchant).prefetch_related(
|
||||
'items', 'supplier', 'operator', 'warehouse'
|
||||
)
|
||||
paginator = self.pagination_class()
|
||||
page = paginator.paginate_queryset(queryset.order_by('-created_at'), request, view=self)
|
||||
serializer = PurchaseReturnOrderSerializer(page, many=True)
|
||||
return paginator.get_paginated_response(serializer.data)
|
||||
|
||||
def post(self, request):
|
||||
if not self.check_employee_permission(request):
|
||||
return self.permission_error_response('无权限访问')
|
||||
|
||||
merchant = request.user.employee.merchant
|
||||
data = request.data or {}
|
||||
|
||||
supplier_id = data.get('supplier')
|
||||
warehouse_id = data.get('warehouse_id') or data.get('warehouse')
|
||||
return_date = data.get('return_date')
|
||||
items = data.get('items', [])
|
||||
remarks = data.get('remarks', '')
|
||||
purchase_order_id = data.get('purchase_order')
|
||||
|
||||
if not supplier_id:
|
||||
return Response({'error': '缺少供应商 ID'}, status=status.HTTP_400_BAD_REQUEST)
|
||||
if not warehouse_id:
|
||||
return Response({'error': '缺少仓库 ID'}, status=status.HTTP_400_BAD_REQUEST)
|
||||
if not return_date:
|
||||
return Response({'error': '缺少 return_date'}, status=status.HTTP_400_BAD_REQUEST)
|
||||
if not isinstance(items, list) or not items:
|
||||
return Response({'error': 'items 需要为非空数组'}, status=status.HTTP_400_BAD_REQUEST)
|
||||
|
||||
try:
|
||||
supplier = basic_models.Supplier.objects.get(id=supplier_id, merchant=merchant)
|
||||
except basic_models.Supplier.DoesNotExist:
|
||||
return Response({'error': f'供应商 {supplier_id} 不存在'}, status=status.HTTP_400_BAD_REQUEST)
|
||||
|
||||
try:
|
||||
warehouse = basic_models.WareHouse.objects.get(id=warehouse_id, merchant=merchant)
|
||||
except basic_models.WareHouse.DoesNotExist:
|
||||
return Response({'error': f'仓库 {warehouse_id} 不存在'}, status=status.HTTP_400_BAD_REQUEST)
|
||||
|
||||
operator = request.user.employee
|
||||
|
||||
try:
|
||||
purchase_return = business_services.create_purchase_return_order(
|
||||
merchant=merchant,
|
||||
supplier=supplier,
|
||||
return_date=return_date,
|
||||
warehouse=warehouse,
|
||||
operator=operator,
|
||||
items=items,
|
||||
remarks=remarks,
|
||||
purchase_order_id=purchase_order_id,
|
||||
created_by=request.user,
|
||||
)
|
||||
except ValueError as exc:
|
||||
return Response({'error': str(exc)}, status=status.HTTP_400_BAD_REQUEST)
|
||||
|
||||
return Response(
|
||||
{
|
||||
'id': purchase_return.id,
|
||||
'status': purchase_return.status,
|
||||
'message': '采购退货单创建成功，等待审批',
|
||||
},
|
||||
status=status.HTTP_201_CREATED,
|
||||
)
|
||||
|
||||
|
||||
class PurchaseReturnOrderReviewSerializer(serializers.Serializer):
|
||||
action = serializers.ChoiceField(choices=[('approve', '审批通过'), ('cancel', '作废')])
|
||||
|
||||
|
||||
class PurchaseReturnOrderReviewView(StockChangeViewMixin, views.APIView):
|
||||
permission_classes = [IsAuthenticated]
|
||||
ACTION_STATUS_MAP = {
|
||||
'approve': business_models.PurchaseReturnStatusEnum.APPROVED,
|
||||
'cancel': business_models.PurchaseReturnStatusEnum.CANCELLED,
|
||||
}
|
||||
|
||||
def post(self, request, pk: int):
|
||||
if not self.check_employee_permission(request):
|
||||
return self.permission_error_response('无权限访问')
|
||||
|
||||
merchant = request.user.employee.merchant
|
||||
try:
|
||||
purchase_return_order = business_models.PurchaseReturnOrder.objects.select_related(
|
||||
'supplier', 'operator', 'warehouse'
|
||||
).prefetch_related('items').get(id=pk, merchant=merchant)
|
||||
except business_models.PurchaseReturnOrder.DoesNotExist:
|
||||
return self.not_found_response('采购退货单不存在')
|
||||
|
||||
serializer = PurchaseReturnOrderReviewSerializer(data=request.data or {})
|
||||
serializer.is_valid(raise_exception=True)
|
||||
action = serializer.validated_data['action']
|
||||
target_status = self.ACTION_STATUS_MAP[action]
|
||||
|
||||
try:
|
||||
business_services.review_purchase_return_order(
|
||||
purchase_return_order=purchase_return_order,
|
||||
target_status=target_status,
|
||||
reviewed_by=request.user,
|
||||
)
|
||||
except ValueError as exc:
|
||||
return Response({'error': str(exc)}, status=status.HTTP_400_BAD_REQUEST)
|
||||
|
||||
refreshed_order = business_models.PurchaseReturnOrder.objects.select_related(
|
||||
'supplier', 'operator', 'warehouse'
|
||||
).prefetch_related('items').get(id=purchase_return_order.id)
|
||||
return Response(PurchaseReturnOrderSerializer(refreshed_order).data, status=status.HTTP_200_OK)
|
||||
|
||||
2
api_v1/views/business/sales_return/__init__.py
Normal file
2
api_v1/views/business/sales_return/__init__.py
Normal file
@@ -0,0 +1,2 @@
|
||||
|
||||
|
||||
180
api_v1/views/business/sales_return/views.py
Normal file
180
api_v1/views/business/sales_return/views.py
Normal file
@@ -0,0 +1,180 @@
|
||||
from rest_framework import status, views, serializers, pagination
|
||||
from rest_framework.permissions import IsAuthenticated
|
||||
from rest_framework.response import Response
|
||||
|
||||
from basic_info import models as basic_models
|
||||
from business import services as business_services
|
||||
from business import models as business_models
|
||||
from api_v1.views.stock_change_views.mixins import StockChangeViewMixin
|
||||
|
||||
|
||||
class SalesReturnOrderItemSerializer(serializers.ModelSerializer):
|
||||
class Meta:
|
||||
model = business_models.SalesReturnOrderItem
|
||||
fields = [
|
||||
'id', 'product', 'price', 'color', 'quantity', 'unit',
|
||||
'empty_diff_percent', 'quantity_of_rolls', 'num_of_rolls',
|
||||
'batch_number', 'remarks', 'created_at', 'updated_at', 'spec',
|
||||
]
|
||||
read_only_fields = [
|
||||
'id', 'created_at', 'updated_at',
|
||||
'total_amount', 'diff_quantity', 'real_quantity',
|
||||
]
|
||||
|
||||
|
||||
class SalesReturnOrderSerializer(serializers.ModelSerializer):
|
||||
total_amount = serializers.SerializerMethodField(read_only=True)
|
||||
diff_quantity = serializers.SerializerMethodField(read_only=True)
|
||||
total_quantity = serializers.SerializerMethodField(read_only=True)
|
||||
customer_name = serializers.CharField(source='customer.name', read_only=True)
|
||||
operator_name = serializers.CharField(source='operator.name', read_only=True)
|
||||
warehouse_name = serializers.CharField(source='warehouse.name', read_only=True)
|
||||
items = SalesReturnOrderItemSerializer(many=True, read_only=True)
|
||||
|
||||
def get_total_amount(self, obj: business_models.SalesReturnOrder):
|
||||
return obj.get_total_amount()
|
||||
|
||||
def get_diff_quantity(self, obj: business_models.SalesReturnOrder):
|
||||
return obj.get_total_diff_quantity()
|
||||
|
||||
def get_total_quantity(self, obj: business_models.SalesReturnOrder):
|
||||
return obj.get_total_quantity()
|
||||
|
||||
class Meta:
|
||||
model = business_models.SalesReturnOrder
|
||||
fields = [
|
||||
'id', 'customer', 'customer_name', 'sales_order', 'return_date',
|
||||
'total_amount', 'diff_quantity', 'total_quantity',
|
||||
'operator', 'operator_name', 'warehouse', 'warehouse_name',
|
||||
'status', 'remarks', 'created_at', 'updated_at', 'items',
|
||||
]
|
||||
read_only_fields = [
|
||||
'id', 'created_at', 'updated_at', 'items',
|
||||
'customer_name', 'operator_name', 'warehouse_name',
|
||||
]
|
||||
|
||||
|
||||
class SalesReturnOrderPagination(pagination.LimitOffsetPagination):
|
||||
default_limit = 20
|
||||
max_limit = 100
|
||||
|
||||
|
||||
class SalesReturnOrderView(StockChangeViewMixin, views.APIView):
|
||||
permission_classes = [IsAuthenticated]
|
||||
pagination_class = SalesReturnOrderPagination
|
||||
|
||||
def get(self, request):
|
||||
if not self.check_employee_permission(request):
|
||||
return self.permission_error_response('无权限访问')
|
||||
|
||||
merchant = request.user.employee.merchant
|
||||
queryset = business_models.SalesReturnOrder.objects.filter(merchant=merchant).prefetch_related(
|
||||
'items', 'customer', 'operator', 'warehouse'
|
||||
)
|
||||
paginator = self.pagination_class()
|
||||
page = paginator.paginate_queryset(queryset.order_by('-created_at'), request, view=self)
|
||||
serializer = SalesReturnOrderSerializer(page, many=True)
|
||||
return paginator.get_paginated_response(serializer.data)
|
||||
|
||||
def post(self, request):
|
||||
if not self.check_employee_permission(request):
|
||||
return self.permission_error_response('无权限访问')
|
||||
|
||||
merchant = request.user.employee.merchant
|
||||
data = request.data or {}
|
||||
|
||||
customer_id = data.get('customer')
|
||||
warehouse_id = data.get('warehouse_id') or data.get('warehouse')
|
||||
return_date = data.get('return_date')
|
||||
items = data.get('items', [])
|
||||
remarks = data.get('remarks', '')
|
||||
sales_order_id = data.get('sales_order')
|
||||
|
||||
if not customer_id:
|
||||
return Response({'error': '缺少客户 ID'}, status=status.HTTP_400_BAD_REQUEST)
|
||||
if not warehouse_id:
|
||||
return Response({'error': '缺少仓库 ID'}, status=status.HTTP_400_BAD_REQUEST)
|
||||
if not return_date:
|
||||
return Response({'error': '缺少 return_date'}, status=status.HTTP_400_BAD_REQUEST)
|
||||
if not isinstance(items, list) or not items:
|
||||
return Response({'error': 'items 需要为非空数组'}, status=status.HTTP_400_BAD_REQUEST)
|
||||
|
||||
try:
|
||||
customer = basic_models.Customer.objects.get(id=customer_id, merchant=merchant)
|
||||
except basic_models.Customer.DoesNotExist:
|
||||
return Response({'error': f'客户 {customer_id} 不存在'}, status=status.HTTP_400_BAD_REQUEST)
|
||||
|
||||
try:
|
||||
warehouse = basic_models.WareHouse.objects.get(id=warehouse_id, merchant=merchant)
|
||||
except basic_models.WareHouse.DoesNotExist:
|
||||
return Response({'error': f'仓库 {warehouse_id} 不存在'}, status=status.HTTP_400_BAD_REQUEST)
|
||||
|
||||
operator = request.user.employee
|
||||
|
||||
try:
|
||||
sales_return = business_services.create_sales_return_order(
|
||||
merchant=merchant,
|
||||
customer=customer,
|
||||
return_date=return_date,
|
||||
warehouse=warehouse,
|
||||
operator=operator,
|
||||
items=items,
|
||||
remarks=remarks,
|
||||
sales_order_id=sales_order_id,
|
||||
created_by=request.user,
|
||||
)
|
||||
except ValueError as exc:
|
||||
return Response({'error': str(exc)}, status=status.HTTP_400_BAD_REQUEST)
|
||||
|
||||
return Response(
|
||||
{
|
||||
'id': sales_return.id,
|
||||
'status': sales_return.status,
|
||||
'message': '销售退货单创建成功，等待审批',
|
||||
},
|
||||
status=status.HTTP_201_CREATED,
|
||||
)
|
||||
|
||||
|
||||
class SalesReturnOrderReviewSerializer(serializers.Serializer):
|
||||
action = serializers.ChoiceField(choices=[('approve', '审批通过'), ('cancel', '作废')])
|
||||
|
||||
|
||||
class SalesReturnOrderReviewView(StockChangeViewMixin, views.APIView):
|
||||
permission_classes = [IsAuthenticated]
|
||||
ACTION_STATUS_MAP = {
|
||||
'approve': business_models.SalesReturnStatusEnum.APPROVED,
|
||||
'cancel': business_models.SalesReturnStatusEnum.CANCELLED,
|
||||
}
|
||||
|
||||
def post(self, request, pk: int):
|
||||
if not self.check_employee_permission(request):
|
||||
return self.permission_error_response('无权限访问')
|
||||
|
||||
merchant = request.user.employee.merchant
|
||||
try:
|
||||
sales_return_order = business_models.SalesReturnOrder.objects.select_related(
|
||||
'customer', 'operator', 'warehouse'
|
||||
).prefetch_related('items').get(id=pk, merchant=merchant)
|
||||
except business_models.SalesReturnOrder.DoesNotExist:
|
||||
return self.not_found_response('销售退货单不存在')
|
||||
|
||||
serializer = SalesReturnOrderReviewSerializer(data=request.data or {})
|
||||
serializer.is_valid(raise_exception=True)
|
||||
action = serializer.validated_data['action']
|
||||
target_status = self.ACTION_STATUS_MAP[action]
|
||||
|
||||
try:
|
||||
business_services.review_sales_return_order(
|
||||
sales_return_order=sales_return_order,
|
||||
target_status=target_status,
|
||||
reviewed_by=request.user,
|
||||
)
|
||||
except ValueError as exc:
|
||||
return Response({'error': str(exc)}, status=status.HTTP_400_BAD_REQUEST)
|
||||
|
||||
refreshed_order = business_models.SalesReturnOrder.objects.select_related(
|
||||
'customer', 'operator', 'warehouse'
|
||||
).prefetch_related('items').get(id=sales_return_order.id)
|
||||
return Response(SalesReturnOrderSerializer(refreshed_order).data, status=status.HTTP_200_OK)
|
||||
|
||||
Reference in New Issue
Block a user