Ir al contenido

Crear un documento de autorización

POST/api/authorization-document

Crea un documento de autorización. El servidor lo guarda con estado activo y asigna al usuario autenticado como creador. Si file incluye base_64 y extension_file, el archivo se guarda en el disco public.

authorization_document_type_idintegerobligatorio

Tipo de documento de autorización. Debe existir en authorization_document_types.

titlestringobligatorio

Título del documento. Máximo 255 caracteres.

descriptionstring

Descripción. Opcional, máximo 500 caracteres.

datedatetime

Fecha del documento. Opcional. El servidor no valida su formato; se guarda como fecha y hora.

fileobject

Archivo del documento. Opcional. Para subir uno se envía un objeto con base_64 (contenido en base64) y extension_file (extensión, por ejemplo pdf); el servidor lo guarda en el disco public y registra la ruta en file. Si se envía una cadena, se guarda tal cual como ruta.

include_participantsboolean

Indica si el documento incluye participantes.

participantsarray

Lista de participantes. Se guarda como arreglo; el servidor no valida la estructura de sus elementos.

cost_center_type_idinteger

Tipo de centro de costo. Opcional. Debe existir en cost_center_types.

company_area_idinteger

Área de la empresa. Opcional. Debe existir en company_areas.

cashbox.configuration.create, que se valida en AuthorizationDocumentPolicy::create. Ver Permisos de Caja.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/authorization-document" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"authorization_document_type_id": 1,
"title": "Acta de aprobación de compras 2026",
"description": "Aprobación del plan anual de compras",
"date": "2026-11-19 09:00:00",
"file": {
"base_64": "JVBERi0xLjQK...",
"extension_file": "pdf"
},
"include_participants": true,
"participants": [
"Ana Torres",
"Luis Pérez"
],
"cost_center_type_id": 2,
"company_area_id": 3
}'
Documento de autorización creado201
{
"id": 7,
"authorization_document_type_id": 1,
"title": "Acta de aprobación de compras 2026",
"description": "Aprobación del plan anual de compras",
"date": "2026-11-19T09:00:00.000000Z",
"file": "authorization_documents/Xk3v9QmZ2bL7pR1sT4uW6yA8cD0eF5gH2jK.pdf",
"include_participants": true,
"participants": [
"Ana Torres",
"Luis Pérez"
],
"cost_center_type_id": 2,
"company_area_id": 3,
"status_update_comment": null,
"status_update_date": null,
"status_update_user_id": null,
"status": "activo",
"previous_status": null,
"create_user_id": 1,
"update_user_id": null,
"delete_user_id": null,
"restore_user_id": null,
"restored_at": null,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null
}
Sin permiso403
{
"message": "This action is unauthorized."
}
Datos no válidos422
{
"message": "El título es requerido.",
"errors": {
"title": [
"El título es requerido."
]
}
}