Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/CLINTONARMANDO/apiregistropendientes/llms.txt

Use this file to discover all available pages before exploring further.

Every pendiente moves through a defined state lifecycle. This page documents the endpoints that drive those transitions: changing state, assigning a technician, postponing to a future date, and reading the current estadoTecnico field.

​
State lifecycle overview

The diagram below shows the typical progression of a work order: 
REGISTRADO → ASIGNADO → EN_PROGRESO → REVISION → POR_VALIDAR → FINALIZADO
                              ↓                        ↓
                           PAUSADO               OBSERVADO
                              ↓
                         POSTERGADO / CANCELADO
Not all transitions are valid from every state. The API enforces valid transitions server-side and returns a 400 Bad Request if an invalid transition is attempted.
Full enum list for EstadoPendiente: REGISTRADO, ASIGNADO, EN_PROGRESO, PAUSADO, REVISION, POR_VALIDAR, OBSERVADO, FINALIZADO, POSTERGADO, CANCELADO.

​
PUT /api/pendientes//estado

Change the state of a work order. The new state is passed as a query parameter.

​
Path parameters

​
id
number
required
ID of the pendiente whose state is being changed.

​
Query parameters

​
nuevoEstado
string
required
The target EstadoPendiente value. Must be a permitted transition from the current state. One of: REGISTRADO, ASIGNADO, EN_PROGRESO, PAUSADO, REVISION, POR_VALIDAR, OBSERVADO, FINALIZADO, POSTERGADO, CANCELADO.

​
Response — 200 OK

Returns the updated PendienteResponse with the new state reflected.

​
Examples

curl --request PUT \
  --url 'https://api.example.com/api/pendientes/42/estado?nuevoEstado=EN_PROGRESO' \
  --header 'Authorization: Bearer <token>'

​
PUT /api/pendientes//asignar

Assign a technician to a work order. The employee ID is passed as a query parameter.

​
Path parameters

​
id
number
required
ID of the pendiente to assign.

​
Query parameters

​
idAsignado
number
required
ID of the technician (employee) to assign to this work order.

​
Response — 200 OK

Returns the updated PendienteResponse with the assigned technician and updated state.
You can reassign a technician on an already-assigned work order. The state will not change if the order is already past ASIGNADO.

​
Example

cURL
curl --request PUT \
  --url 'https://api.example.com/api/pendientes/42/asignar?idAsignado=9' \
  --header 'Authorization: Bearer <token>'

​
PUT /api/pendientes//postergar

Postpone a work order to a future date with an explanatory reason. The state transitions to POSTERGADO.

​
Path parameters

​
id
number
required
ID of the pendiente to postpone.

​
Request body

​
nuevaFecha
string
required
New scheduled datetime in ISO 8601 format (e.g. 2026-07-10T09:00:00). Must be in the future.
​
empleadoId
number
Optional ID of the employee recording the postponement.

​
Response — 200 OK

Returns the updated PendienteResponse with estado: "POSTERGADO" and the new fechaPendiente.
Postponing a work order in FINALIZADO state is not permitted. The order must be in a state that allows postponement.

​
Example

cURL
curl --request PUT \
  --url https://api.example.com/api/pendientes/42/postergar \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "nuevaFecha": "2026-07-10T09:00:00",
    "empleadoId": 3
  }'

​
GET /api/pendientes//estado-tecnico

Update the estadoTecnico (network configuration sub-state) for a work order. Despite the HTTP method, this endpoint changes the technical state and returns the updated pendiente. The new state is passed as a query parameter.
This endpoint uses GET with a @RequestParam for the new state. It updates estadoTecnico — the PPPoE/VLAN configuration sub-state — independently of the main estado lifecycle.

​
Path parameters

​
id
number
required
ID of the pendiente.

​
Query parameters

​
nuevoEstado
string
required
The target EstadoTecnico value. One of: OK, PENDIENTE_PPPoE, PENDIENTE_VLAN, PENDIENTE_PPPoE_Y_VLAN.

​
Response — 200 OK

Returns the updated PendienteResponse with the new estadoTecnico reflected.

​
Example

cURL
curl --request GET \
  --url 'https://api.example.com/api/pendientes/42/estado-tecnico?nuevoEstado=PENDIENTE_PPPoE' \
  --header 'Authorization: Bearer <token>'

Build docs developers (and LLMs) love

Get started for freeTalk to us