Subir
POST /v1/buyer/file/upload es una solicitud multipart con una sola parte llamada file, de hasta 512 MB:
FileManager) es un registro FileDetails:
fileName en la subida. Un fallo a nivel de almacenamiento devuelve 500; reintenta con backoff.
Referenciar el archivo desde una entidad
Los campos de adjuntos (por ejemplobuyerAttachments al crear una orden de trabajo, o attachments en un tipo de activo) toman arrays de objetos FileDetails, exactamente como los devuelve la subida:
Descargar
GET /v1/buyer/file/download/{id}/{name} transmite los bytes almacenados con Content-Disposition: attachment. {id} es el fileId de la subida (o de cualquier FileDetails que leas de una entidad); {name} es el nombre de archivo con el que se sirve la descarga:
supplierAttachments de una orden de trabajo, o invoicePDFs/attachments de una factura, y descarga cada fileId.
Notas prácticas
- Las subidas cuentan contra el límite de tasa (10 solicitudes por ventana de 20 segundos), así que las migraciones con muchas subidas por lote deben limitarse a aproximadamente una subida cada 2 segundos.
- Guarda el
fileIdjunto con tus propios registros; no hay endpoint de listado para redescubrir archivos después del hecho. - El mismo patrón de dos pasos aplica del lado del proveedor, y los PDFs de factura tienen un endpoint dedicado del lado del proveedor que sube y publica en una sola llamada.