Creating PTEs

Overview

Creating a PTE (Proyecto de Trabajo Especial) involves initializing both the header record with project information and automatically generating the appropriate workflow steps based on the client type.

PTE Creation Endpoint

The PTE creation is handled by the crear_pte view function: URL: /pte/crear/
Method: POST
Authentication: Required (@login_required)
Activity Logging: Enabled (@registrar_actividad)

Required Fields

id_cliente

integer

required

Client ID - Must reference an active client record

responsable_proyecto

integer

required

Project manager ID - Must reference an active ResponsableProyecto

id_tipo

integer

required

PTE type ID - Must have nivel_afectacion=1

plazo_dias

integer

required

Deadline in days - Must be greater than 0

id_prioridad

integer

required

Priority level for the PTE

Optional Fields

oficio_pte

string

default:"SIN FOLIO"

PTE official document number

oficio_solicitud

string

default:"PENDIENTE"

Request document number

descripcion_trabajo

string

default:"POR DEFINIR"

Detailed work description

fecha_solicitud

date

Request date in YYYY-MM-DD format

fecha_entrega

date

Delivery date in YYYY-MM-DD format

total_homologado

decimal

default:"0.00"

Standardized total amount

oficio_ot

string

Associated work order document number

comentario_general

string

General comments about the PTE

Implementation Code

Here’s the actual implementation from pte.py:496-607:

@require_http_methods(["POST"])
@login_required
@registrar_actividad
def crear_pte(request):
    """Crear PTE con header y detalles"""
    try:
        get_val = lambda k, d=None, t=str: t(v) if (v := request.POST.get(k, '').strip()) else d
        
        oficio_pte = get_val('oficio_pte', 'SIN FOLIO')
        oficio_solicitud = get_val('oficio_solicitud', 'PENDIENTE')
        descripcion_trabajo = get_val('descripcion_trabajo','POR DEFINIR')
        responsable_proyecto = get_val('responsable_proyecto')
        fecha_solicitud = get_val('fecha_solicitud')
        fecha_entrega = get_val('fecha_entrega', None)
        prioridad = get_val('id_prioridad')
        plazo_dias = get_val('plazo_dias', 0, int)
        id_tipo_id = get_val('id_tipo', None, int)
        total_homologado = get_val('total_homologado', 0.00, float)
        oficio_ot = get_val('oficio_ot', '')
        comentario_general = get_val('comentario_general', '')
        id_cliente = get_val('id_cliente')
        
        # Validation checks
        if not id_cliente:
            return JsonResponse({
                'exito': False,
                'tipo_aviso': 'error',
                'detalles': 'El cliente es obligatorio'
            })
        if not responsable_proyecto:
            return JsonResponse({
                'exito': False,
                'tipo_aviso': 'error',
                'detalles': 'El responsable del proyecto es obligatorio'
            })
        
        if not id_tipo_id:
            return JsonResponse({
                'exito': False,
                'tipo_aviso': 'error',
                'detalles': 'El tipo de PTE es obligatorio'
            })
        
        if plazo_dias <= 0:
            return JsonResponse({
                'exito': False,
                'tipo_aviso': 'error',
                'detalles': 'El plazo en días debe ser mayor a 0'
            })
        
        if not prioridad:
            return JsonResponse({
                'exito': False,
                'tipo_aviso': 'error',
                'detalles': 'La prioridad es obligatoria'
            })
        
        # Create PTE Header
        pte_header = PTEHeader.objects.create(
            oficio_pte=oficio_pte,
            oficio_solicitud=oficio_solicitud,
            descripcion_trabajo=descripcion_trabajo,
            id_responsable_proyecto_id=responsable_proyecto,
            fecha_solicitud=fecha_solicitud,
            prioridad = prioridad,
            fecha_entrega=fecha_entrega,
            plazo_dias=plazo_dias,
            total_homologado=total_homologado,
            id_tipo_id=id_tipo_id,
            id_orden_trabajo=oficio_ot,
            comentario=comentario_general,
            id_cliente_id=id_cliente,
            estatus=1  # Activo
        )
        
        # Get client type and create workflow steps
        clientes = Cliente.objects.get(id=id_cliente)
        tipo_cliente = clientes.id_tipo_id

        pasos = Paso.objects.filter(
            activo=1, 
            id_tipo_cliente_id=tipo_cliente
        ).order_by('id', 'orden')

        if not pasos:
            return JsonResponse({
                'exito': False,
                'tipo_aviso': 'error',
                'detalles': f'No se encontraron pasos para el tipo de cliente {tipo_cliente}'
            })
        
        # Create detail records for each step
        detalles_creados = []
        for paso in pasos:
            detalle = PTEDetalle.objects.create(
                id_pte_header_id=pte_header.id,
                id_paso_id=paso.id,
                estatus_paso_id=1,  # Pendiente
                comentario=''
            )
            detalles_creados.append(detalle.id)
        
        return JsonResponse({
            'exito': True,
            'tipo_aviso': 'exito',
            'detalles': f'PTE creado correctamente',
            'id': pte_header.id,
            'registro_id':pte_header.id,
        })

The function uses a lambda helper get_val to extract and type-cast POST parameters with default values, making the code more concise.

Automatic Workflow Generation

One of the key features of PTE creation is the automatic workflow step generation based on client type:

Retrieve Client Type

The system gets the client record and extracts the id_tipo_id field

clientes = Cliente.objects.get(id=id_cliente)
tipo_cliente = clientes.id_tipo_id

Query Matching Steps

Fetch all active workflow steps configured for this client type

pasos = Paso.objects.filter(
    activo=1, 
    id_tipo_cliente_id=tipo_cliente
).order_by('id', 'orden')

Create Detail Records

For each matching step, create a PTEDetalle record with initial “Pendiente” status

for paso in pasos:
    PTEDetalle.objects.create(
        id_pte_header_id=pte_header.id,
        id_paso_id=paso.id,
        estatus_paso_id=1,
        comentario=''
    )

If no workflow steps are found for the client type, the PTE creation fails with an error message. Ensure that workflow steps are properly configured for each client type.

Validation Rules

The system enforces several validation rules:

Field	Validation	Error Message
`id_cliente`	Must not be empty	”El cliente es obligatorio”
`responsable_proyecto`	Must not be empty	”El responsable del proyecto es obligatorio”
`id_tipo`	Must not be empty	”El tipo de PTE es obligatorio”
`plazo_dias`	Must be > 0	”El plazo en días debe ser mayor a 0”
`id_prioridad`	Must not be empty	”La prioridad es obligatoria”

Response Format

Success Response

{
  "exito": true,
  "tipo_aviso": "exito",
  "detalles": "PTE creado correctamente",
  "id": 123,
  "registro_id": 123
}

Error Response

{
  "exito": false,
  "tipo_aviso": "error",
  "detalles": "El cliente es obligatorio"
}

Example Usage

const formData = new FormData();
formData.append('id_cliente', '5');
formData.append('responsable_proyecto', '2');
formData.append('id_tipo', '1');
formData.append('plazo_dias', '30');
formData.append('id_prioridad', '1');
formData.append('oficio_pte', 'PTE-2024-001');
formData.append('descripcion_trabajo', 'Instalación de equipamiento');
formData.append('fecha_solicitud', '2024-01-15');

fetch('/pte/crear/', {
  method: 'POST',
  body: formData,
  headers: {
    'X-CSRFToken': getCookie('csrftoken')
  }
})
.then(response => response.json())
.then(data => {
  if (data.exito) {
    console.log('PTE created with ID:', data.id);
  } else {
    console.error('Error:', data.detalles);
  }
});

Editing PTEs

To edit an existing PTE, use the editar_pte endpoint at /pte/editar/:

@require_http_methods(["POST"])
@login_required
@registrar_actividad
def editar_pte(request):
    pte_id = request.POST.get('id')
    pte = get_object_or_404(PTEHeader, id=pte_id)
    
    # Update fields
    pte.oficio_pte = request.POST.get('oficio_pte', pte.oficio_pte)
    pte.descripcion_trabajo = request.POST.get('descripcion_trabajo', pte.descripcion_trabajo)
    # ... more fields
    
    pte.save()

The edit function uses get_object_or_404 to ensure the PTE exists, returning a 404 error if not found.

Workflow Steps

Manage the detailed workflow steps created automatically

Status Tracking

Track and update PTE status throughout the lifecycle

PTE Management

Work Orders (OTE)

Production Tracking

Catalogs & Configuration

Query Center

Overview

PTE Creation Endpoint

Required Fields

Optional Fields

Implementation Code

Automatic Workflow Generation

Validation Rules

Response Format

Success Response

Error Response

Example Usage

Editing PTEs

Workflow Steps

Status Tracking

Build docs developers (and LLMs) love

PTE Management

Work Orders (OTE)

Production Tracking

Catalogs & Configuration

Query Center

​Overview

​PTE Creation Endpoint

​Required Fields

​Optional Fields

​Implementation Code

​Automatic Workflow Generation

​Validation Rules

​Response Format

​Success Response

​Error Response

​Example Usage

​Editing PTEs

​Related Operations

Workflow Steps

Status Tracking

Build docs developers (and LLMs) love

Overview

PTE Creation Endpoint

Required Fields

Optional Fields

Implementation Code

Automatic Workflow Generation

Validation Rules

Response Format

Success Response

Error Response

Example Usage

Editing PTEs

Related Operations