Cierra los huecos de la auditoría contra "SOFTWARE PARA AGENTES DE CARGA": - ops (Diag. 2/3): bitácora con puntos de decisión (kind=decision) y ciclo de corrección (parent_event_id/attempt) para ¿Cut Off? y ¿despacho autorizado? (R-E-05/13, R-I-06). Reprogramación de salida (previous_etd, R-E-06). Hitos operativos completos export/import. Cierre operativo con costos finales (close_shipment, R-E-22). - fin (Diag. 4): facturación con gate por cierre operativo y sin duplicar (R-F-01), costos de operación arrastrados (ops_cost_total, R-F-02), envío con PDF generado y guardado en MinIO (send_invoice + pdf.py sin dependencias, R-F-05) y revisión del cliente (en_revision_cliente + aprobación, R-F-06). - crm (Diag. 1): opportunity_id enlaza embudo→RFQ (R-C-02), contacto como etapa (first_contact_at, R-C-04), re-cotización (clone_quote + reopen, R-C-12). - transversal: catálogo de Incoterms y participantes/actores incl. autoridad aduanera (R-T-01/10), enforcement de permisos por carril (RBAC) con roles sembrados y dependencias dev-safe (R-T-07). - Migración d5e6f7a8b9c0 con downgrade. Seed extendido. 70 tests (12 nuevos). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
135 lines
7.3 KiB
Python
135 lines
7.3 KiB
Python
from fastapi import APIRouter, Depends, Query, status
|
|
from sqlalchemy.orm import Session
|
|
|
|
from core.database import get_core_db
|
|
from core.security import get_current_user
|
|
|
|
from . import service
|
|
from .dto import (
|
|
InvoiceClientReviewInput,
|
|
InvoiceCreate,
|
|
InvoiceItemCreate,
|
|
InvoiceItemResponse,
|
|
InvoiceItemUpdate,
|
|
InvoiceResponse,
|
|
InvoiceUpdate,
|
|
PaymentCreate,
|
|
PaymentResponse,
|
|
)
|
|
|
|
router = APIRouter()
|
|
|
|
|
|
def _uid(cu: dict) -> str | None:
|
|
return cu.get("sub") or cu.get("id")
|
|
|
|
|
|
@router.get("/invoices", response_model=list[InvoiceResponse])
|
|
def list_invoices(
|
|
company_id: int = Query(...),
|
|
search: str | None = Query(None),
|
|
inv_status: str | None = Query(None, alias="status"),
|
|
account_id: int | None = Query(None),
|
|
current_user: dict = Depends(get_current_user),
|
|
db: Session = Depends(get_core_db),
|
|
):
|
|
return service.get_invoices(db, current_user["tenant_id"], company_id, search, inv_status, account_id)
|
|
|
|
|
|
@router.get("/invoices/{invoice_id}", response_model=InvoiceResponse)
|
|
def get_invoice(invoice_id: int, company_id: int = Query(...), current_user: dict = Depends(get_current_user), db: Session = Depends(get_core_db)):
|
|
return service.get_invoice(db, invoice_id, current_user["tenant_id"], company_id)
|
|
|
|
|
|
@router.post("/invoices", response_model=InvoiceResponse, status_code=status.HTTP_201_CREATED)
|
|
def create_invoice(payload: InvoiceCreate, company_id: int = Query(...), current_user: dict = Depends(get_current_user), db: Session = Depends(get_core_db)):
|
|
return service.create_invoice(db, payload, current_user["tenant_id"], company_id, _uid(current_user))
|
|
|
|
|
|
@router.post("/invoices/from-shipment", response_model=InvoiceResponse, status_code=status.HTTP_201_CREATED)
|
|
def generate_from_shipment(shipment_id: int = Query(...), company_id: int = Query(...), current_user: dict = Depends(get_current_user), db: Session = Depends(get_core_db)):
|
|
return service.generate_from_shipment(db, shipment_id, current_user["tenant_id"], company_id, _uid(current_user))
|
|
|
|
|
|
@router.patch("/invoices/{invoice_id}", response_model=InvoiceResponse)
|
|
def update_invoice(invoice_id: int, payload: InvoiceUpdate, company_id: int = Query(...), current_user: dict = Depends(get_current_user), db: Session = Depends(get_core_db)):
|
|
return service.update_invoice(db, invoice_id, payload, current_user["tenant_id"], company_id, _uid(current_user))
|
|
|
|
|
|
@router.patch("/invoices/{invoice_id}/emit", response_model=InvoiceResponse)
|
|
def emit_invoice(invoice_id: int, company_id: int = Query(...), current_user: dict = Depends(get_current_user), db: Session = Depends(get_core_db)):
|
|
return service.emit_invoice(db, invoice_id, current_user["tenant_id"], company_id)
|
|
|
|
|
|
@router.patch("/invoices/{invoice_id}/send", response_model=InvoiceResponse)
|
|
def send_invoice(invoice_id: int, company_id: int = Query(...), current_user: dict = Depends(get_current_user), db: Session = Depends(get_core_db)):
|
|
"""Genera el PDF, lo guarda en MinIO y marca la factura como enviada (R-F-05)."""
|
|
return service.send_invoice(db, invoice_id, current_user["tenant_id"], company_id, _uid(current_user))
|
|
|
|
|
|
@router.get("/invoices/{invoice_id}/pdf-url")
|
|
def get_invoice_pdf_url(invoice_id: int, company_id: int = Query(...), current_user: dict = Depends(get_current_user), db: Session = Depends(get_core_db)):
|
|
"""URL firmada fresca del PDF de la factura (R-F-05)."""
|
|
return {"url": service.get_invoice_pdf_url(db, invoice_id, current_user["tenant_id"], company_id)}
|
|
|
|
|
|
@router.patch("/invoices/{invoice_id}/client-review", response_model=InvoiceResponse)
|
|
def mark_client_review(invoice_id: int, company_id: int = Query(...), current_user: dict = Depends(get_current_user), db: Session = Depends(get_core_db)):
|
|
"""Marca la factura en revisión del cliente (R-F-06)."""
|
|
return service.mark_client_review(db, invoice_id, current_user["tenant_id"], company_id, _uid(current_user))
|
|
|
|
|
|
@router.patch("/invoices/{invoice_id}/client-decision", response_model=InvoiceResponse)
|
|
def client_review_decision(invoice_id: int, payload: InvoiceClientReviewInput, company_id: int = Query(...), current_user: dict = Depends(get_current_user), db: Session = Depends(get_core_db)):
|
|
"""Registra la decisión del cliente sobre la factura: aprobada o con observaciones (R-F-06)."""
|
|
return service.client_review_decision(db, invoice_id, payload, current_user["tenant_id"], company_id, _uid(current_user))
|
|
|
|
|
|
@router.patch("/invoices/{invoice_id}/cancel", response_model=InvoiceResponse)
|
|
def cancel_invoice(invoice_id: int, company_id: int = Query(...), current_user: dict = Depends(get_current_user), db: Session = Depends(get_core_db)):
|
|
return service.cancel_invoice(db, invoice_id, current_user["tenant_id"], company_id)
|
|
|
|
|
|
@router.delete("/invoices/{invoice_id}", status_code=status.HTTP_204_NO_CONTENT)
|
|
def delete_invoice(invoice_id: int, company_id: int = Query(...), current_user: dict = Depends(get_current_user), db: Session = Depends(get_core_db)):
|
|
service.delete_invoice(db, invoice_id, current_user["tenant_id"], company_id)
|
|
|
|
|
|
# ----- Conceptos -----
|
|
|
|
@router.get("/invoices/{invoice_id}/items", response_model=list[InvoiceItemResponse])
|
|
def list_items(invoice_id: int, company_id: int = Query(...), current_user: dict = Depends(get_current_user), db: Session = Depends(get_core_db)):
|
|
return service.get_items(db, invoice_id, current_user["tenant_id"], company_id)
|
|
|
|
|
|
@router.post("/invoice-items", response_model=InvoiceItemResponse, status_code=status.HTTP_201_CREATED)
|
|
def create_item(payload: InvoiceItemCreate, company_id: int = Query(...), current_user: dict = Depends(get_current_user), db: Session = Depends(get_core_db)):
|
|
return service.create_item(db, payload, current_user["tenant_id"], company_id)
|
|
|
|
|
|
@router.patch("/invoice-items/{item_id}", response_model=InvoiceItemResponse)
|
|
def update_item(item_id: int, payload: InvoiceItemUpdate, company_id: int = Query(...), current_user: dict = Depends(get_current_user), db: Session = Depends(get_core_db)):
|
|
return service.update_item(db, item_id, payload, current_user["tenant_id"], company_id)
|
|
|
|
|
|
@router.delete("/invoice-items/{item_id}", status_code=status.HTTP_204_NO_CONTENT)
|
|
def delete_item(item_id: int, company_id: int = Query(...), current_user: dict = Depends(get_current_user), db: Session = Depends(get_core_db)):
|
|
service.delete_item(db, item_id, current_user["tenant_id"], company_id)
|
|
|
|
|
|
# ----- Pagos (cobranza) -----
|
|
|
|
@router.get("/invoices/{invoice_id}/payments", response_model=list[PaymentResponse])
|
|
def list_payments(invoice_id: int, company_id: int = Query(...), current_user: dict = Depends(get_current_user), db: Session = Depends(get_core_db)):
|
|
return service.get_payments(db, invoice_id, current_user["tenant_id"], company_id)
|
|
|
|
|
|
@router.post("/payments", response_model=PaymentResponse, status_code=status.HTTP_201_CREATED)
|
|
def create_payment(payload: PaymentCreate, company_id: int = Query(...), current_user: dict = Depends(get_current_user), db: Session = Depends(get_core_db)):
|
|
return service.create_payment(db, payload, current_user["tenant_id"], company_id)
|
|
|
|
|
|
@router.delete("/payments/{payment_id}", status_code=status.HTTP_204_NO_CONTENT)
|
|
def delete_payment(payment_id: int, company_id: int = Query(...), current_user: dict = Depends(get_current_user), db: Session = Depends(get_core_db)):
|
|
service.delete_payment(db, payment_id, current_user["tenant_id"], company_id)
|