Crear tarea

El servicio de creación de tarea de ajuste permite fondear a tus colaboradores.

Método: POST
URL: api/adjustments/create-task
Headers requeridos:

Authorization: Bearer {token}
host_url:https://webhook.site/6e19b388-5b2b-4655-95dd-dd9c129c96bc

Códigos de Estado

Código	Estado	Descripción
✅ 200	200 OK	La solicitud fue exitosa.
⚠️ 422	422 Unprocessable Entity	Error en los datos enviados.
❌ 500	500 Internal Server Error	Error interno del servidor.

Campos requeridos

Campo	Tipo	Requerido	Descripción
title	String	✅	Título de la tarea.
description	String	✅	Descripción de la tarea.
memberships	Array	✅	Lista de membresías a fondear.
membership	String	✅	Identificador único de la membresía.
amount	Número	✅	Monto a fondear para la membresía.

Ejemplo de request

{
  "title": "FONDEO PAGOS 987",
  "description": "PAGO 0011",
  "memberships": [
    { "membership": "690010207", "amount": 1 },
    { "membership": "700008317", "amount": 1 },
    { "membership": "760010145", "amount": 1 },
    { "membership": "780009278", "amount": 1 },
    { "membership": "330023920", "amount": 1 }
  ]
}

Respuestas detalladas

• 200 OK - Solicitud exitosa
• Descripción: La solicitud se procesó correctamente.

Detalles de la tarea (task)

Campo	Tipo	Descripción
uuid	String	Identificador único de la tarea.
title	String	Título de la tarea.
description	String	Descripción de la tarea.
tenant_id	String	ID del inquilino asociado a la tarea.
status	string	pending,authorized,processed
updated_at	String	Fecha y hora de la última actualización de la tarea.
created_at	String	Fecha y hora de creación de la tarea.

Detalles de la tarea (memberships)

Campo	Tipo	Descripción
uuid	String	Identificador único de la membresía.
adjustment_task_id	String	ID de la tarea de ajuste relacionada.
membership	String	Identificador de la membresía asociada.
amount	Number	Monto asignado a la membresía.
status	String	pending,finished,error
updated_at	String	Fecha y hora de la última actualización de la membresía.
created_at	String	Fecha y hora de creación de la membresía.

Ejemplo de respuesta

{
  "success": true,
  "message": "Tarea creada correctamente",
  "task": {
    "uuid": "e81c3dcf-b59d-493b-b9d7-83feb4ef3973",
    "title": "FONDEO PAGOS 14FEB",
    "description": "PAGOS FEB 2025",
    "tenant_id": "005f59a5-679b-44c5-869f-7c41933fad4e",
    "updated_at": "2025-02-11T17:21:56.000000Z",
    "created_at": "2025-02-11T17:21:56.000000Z"
  },
  "memberships": [
    {
      "uuid": "629ff966-7244-42a6-a6c7-fb69de0e8b44",
      "adjustment_task_id": "e81c3dcf-b59d-493b-b9d7-83feb4ef3973",
      "membership": "690010207",
      "amount": 1,
      "status": "pending",
      "updated_at": "2025-02-11T17:21:56.000000Z",
      "created_at": "2025-02-11T17:21:56.000000Z"
    }
  ]
}

422 Unprocessable Entity - Error de validación

• Descripción: Ocurre cuando los datos enviados en la solicitud no cumplen con las reglas de validación.

Campo	Tipo	Descripción
success	Boolean	Indica si la solicitud fue exitosa (false).
message	String	Mensaje general del error.
errors	Array	Lista de errores de validación encontrados.

Detalles de los errores (errors)

Campo	Tipo	Descripción
field	String	Nombre del campo que generó el error.
message	String	Mensaje descriptivo del error de validación.
value	String	Valor enviado que causó el error (si aplica).

Ejemplo de respuesta

{
  "success": false,
  "message": "Error al validar los datos.",
  "errors": [
    {
      "field": "title",
      "message": "El campo title es requerido.",
      "value": ""
    },
    {
      "field": "memberships.0.membership",
      "message": "La membresía 69001020712 no pertenece al comercio indicado.",
      "value": "69001020712"
    }
  ]
}