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.

API Registro Pendientes follows a straightforward request cycle: authenticate once to receive a JWT token, then include that token in every subsequent request. This guide walks you through authentication, creating a work order, and checking its status — all from the command line.

​
Prerequisites

Before you begin, make sure you have the following:
  • Java 21 or later installed on your machine (required only if you are running the server locally)
  • A running API instance — either a local server on http://localhost:8080 or a remote deployment URL provided by your team
  • User credentials (DNI and password) issued by your system administrator
If you need credentials or access to a running instance, contact your ISP administrator. User accounts are managed via the /api/usuarios endpoint and require the REGISTRAR_PENDIENTE permission to create work orders.

​
Steps

1

Authenticate and obtain a token

Send your DNI and password to POST /auth. The response contains a JWT token you will use for all subsequent requests.
curl -X POST http://localhost:8080/auth \
  -H "Content-Type: application/json" \
  -d '{"dni": "12345678", "password": "yourpassword"}'
A successful response looks like this:
{
  "token": "eyJhbGciOiJIUzI1NiJ9...",
  "usuario": {
    "id": 1,
    "nombre": "Juan Perez",
    "dni": "12345678",
    "email": "juan@example.com",
    "vigente": true,
    "rol": { "id": "ADMIN", "nombre": "Administrador" }
  }
}
Copy the token value — you will pass it in the Authorization header for every subsequent request.
2

Create a work order

Send a POST /api/pendientes request with the work order details. Replace the Authorization header value with the token you received in step 1.
curl -X POST http://localhost:8080/api/pendientes \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json" \
  -d '{
    "clienteId": 1,
    "tipo": "INSTALACION_INTERNET",
    "prioridad": "MEDIA",
    "lugar": "JULIACA",
    "empresa": "SIMAX",
    "direccion": "Jr. Moquegua 123",
    "fechaPendiente": "2026-05-25",
    "registradoPorId": 2
  }'
The response returns the newly created work order with its assigned id and an initial state of REGISTRADO.
The tipo field accepts: INSTALACION_INTERNET, AVERIA, INSTALACION_CAMARAS, RECOJO_DISPOSITIVOS, and TRASLADO. The prioridad field accepts BAJA, MEDIA, URGENTE, and MUY_URGENTE. See Core Concepts for details on all field values.
3

Check the work order status

Use the id returned in the previous step to fetch the current state of the work order.
curl -X GET http://localhost:8080/api/pendientes/1 \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiJ9..."
The response includes the full work order object, including its estado (state), assigned technician, timestamps, and any attached notes.

​
What’s next

You have authenticated, created a work order, and retrieved its details. From here, you can:

Authentication reference

Understand token lifetime, validation, and how to handle auth errors.

Work order states

Learn the full state machine: REGISTRADO → ASIGNADO → EN_PROGRESO → FINALIZADO.

Permissions model

See which permissions are required for each operation and how roles are configured.

API reference

Full endpoint documentation with all request parameters and response schemas.

Build docs developers (and LLMs) love

Get started for freeTalk to us