WSGetArchivosMultimedia

Acceso a archivos multimedia de una tarea. Soporta tres modos: descarga de archivo específico, listado de archivos y generación de PDF de formulario.

Target route

POST /apidev/legacy/WSGetArchivosMultimedia

Status

New implementation required — Este endpoint tiene tres modos funcionales distintos. No puede ser reemplazado por WSGetTareaMultimedia (contratos diferentes).

Riesgo de implementación parcial

Si solo se migra el modo ObtenerArchivo, los clientes que usan ObtenerListaArchivos u ObtenerFormularioPDF dejarán de funcionar sin aviso. Los tres modos deben implementarse juntos.

---

Authentication

{
  "WSAutorizacion": {
    "Guid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "Usuario": "usuario@empresa.com",
    "Password": "contraseña"
  }
}

---

Modo A: ObtenerArchivo

Descarga un archivo específico de una tarea. Soporta providers Azure y FTP.

Request

Campo	Tipo	Obligatorio	Descripción
WSAutorizacion	object	Sí	Credenciales legacy
Accion	string	Sí	"ObtenerArchivo"
NroServicio	string	Condicional	Número del servicio
IdExterno	string	Condicional	ID externo del servicio
NombreArchivo	string	Sí	Nombre del archivo a descargar

{
  "WSAutorizacion": { "Guid": "...", "Usuario": "...", "Password": "..." },
  "Accion": "ObtenerArchivo",
  "NroServicio": "103878",
  "NombreArchivo": "foto_destino.jpg"
}

Response

Campo	Tipo	Descripción
Resultado	string	"OK" o error
ArchivoBase64	string	Contenido del archivo en Base64
MimeType	string	Tipo MIME
NombreArchivo	string	Nombre del archivo

---

Modo B: ObtenerListaArchivos

Lista todos los archivos multimedia asociados a una tarea.

Request

Campo	Tipo	Obligatorio	Descripción
WSAutorizacion	object	Sí	Credenciales legacy
Accion	string	Sí	"ObtenerListaArchivos"
NroServicio	string	Condicional	Número del servicio
IdExterno	string	Condicional	ID externo del servicio

{
  "WSAutorizacion": { "Guid": "...", "Usuario": "...", "Password": "..." },
  "Accion": "ObtenerListaArchivos",
  "NroServicio": "103878"
}

Response

Campo	Tipo	Descripción
Resultado	string	"OK" o error
Archivos	array	Lista de archivos
Archivos[].Nombre	string	Nombre del archivo
Archivos[].Notas	string	Observaciones
Archivos[].Fecha	string	Fecha de carga
Archivos[].Formulario	string	Nombre del formulario asociado (si aplica)
Archivos[].Tamanio	number	Tamaño en bytes
Archivos[].Tipo	string	Tipo MIME

{
  "Resultado": "OK",
  "Archivos": [
    {
      "Nombre": "foto_origen.jpg",
      "Notas": "Foto de llegada",
      "Fecha": "2026-04-03T10:32:00",
      "Formulario": null,
      "Tamanio": 204800,
      "Tipo": "image/jpeg"
    },
    {
      "Nombre": "formulario_inspeccion.pdf",
      "Notas": "",
      "Fecha": "2026-04-03T11:00:00",
      "Formulario": "Inspección de vehículo",
      "Tamanio": 89600,
      "Tipo": "application/pdf"
    }
  ]
}

---

Modo C: ObtenerFormularioPDF

Genera y devuelve en Base64 el PDF del formulario digital de una tarea.

Request

Campo	Tipo	Obligatorio	Descripción
WSAutorizacion	object	Sí	Credenciales legacy
Accion	string	Sí	"ObtenerFormularioPDF"
NroServicio	string	Condicional	Número del servicio
IdExterno	string	Condicional	ID externo del servicio
IdFormulario	string	No	ID del formulario específico (si hay varios)

Response

Campo	Tipo	Descripción
Resultado	string	"OK" o error
ArchivoBase64	string	PDF del formulario en Base64
NombreArchivo	string	Nombre del archivo generado

---

Migration note

Requiere implementación nueva. La tarea es:

1. Diseñar el adapter que reciba WSAutorizacion + Accion
2. Modo A → adaptar sobre el sistema de storage existente (StorageService)
3. Modo B → adaptar sobre la tabla tarea_multimedia
4. Modo C → integrar con el generador de PDF de formularios digitales
5. Validar permisos de visualización por tenant antes de cualquier entrega de archivo

Prioridad por uso observado: ObtenerListaArchivos > ObtenerArchivo > ObtenerFormularioPDF.

---

Related

• WSGetTareaMultimedia — descarga de archivo único por nombre (contrato distinto)