1. Adjuntos
  • Uso de API
    • 1. Introducción
    • 2. Ambientes Disponibles
    • 3. Seguridad
    • 4. Respuestas
    • 5. Tipos de Parámetros
    • 6. Errores
    • 7. Por dónde comenzar
    • 8. Webhooks
    • 9.-Adjuntos
  • Apis
    • 8.1. Documentos
      • Nuevo Documento
      • Listar DTEs
      • Listar DTEs V.2
      • Obtener Documento
      • Listar Documentos Adjuntos
      • Adjuntar archivo o documentos a un DTE
      • Dejar un comentario en la bitacora de un documento
      • Listar los registros de bitácora de un DTE
      • Asociar contacto a un DTE
      • Enviar DTE por correo electrónico
      • Generar una acción comercial sobre un DTE
      • Actualizar información de pago de un documento
      • Obtener información de pago de un documento
      • Cargar Borrador DTE
      • Nuevo Documento Portafolio Contrato
      • Carga Masiva Documentos Contrato
      • Listar tipos de Documentos de Escritorio Digital
      • Enviar a flujo expedientes
      • Listar opciones v2
      • Listar flujos para aprobaciones
    • 8.1.2 No Tributario
      • Portafolio
        • Listar contratos
        • Obtener contrato
        • Crear contrato
        • Actualizar contrato
        • Enviar contrato por correo
        • Imprimir contrato
      • Adjuntos
        • Presigned / Cargar archivo a repositorio
          POST
      • Nuevo Documento No Tributario
        POST
      • Listar DNTs
        GET
      • Actualizar Documento No Tributario
        PUT
      • Obtener información de un documento
        GET
      • Actualiza Estado de Documento No Tributario
        PUT
      • Buscar DTE referenciados a un DNT
        POST
    • 8.1.3 Documentos Personalizados
      • Convertir documento personalizado a expedientes para Escritorio Digital
      • Obtener listado de documentos personalizados
      • Crear un documento
    • 8.2. Folios
      • Cargar un CAF
      • Anular un CAF
      • Listar CAFs cargados
      • Listar CAFs
      • Solicitar un rango de folios para sucursal
      • Listar rangos de folios entregados a sucursales
      • Listar distribución de folios consumidos y por usar
      • Obtener Folios de un CAF
    • 8.3. Empresas
      • Articulos
        • Categorias
          • Listar categorias
          • Crear Categoria
          • Actualizar
          • Eliminar
        • Descuentos
          • Listar Descuentos
          • Crear Descuento
        • Listar artículo de venta
        • Buscar artículos
        • Crear artículo de venta
        • Eliminar artículo de venta
        • Actualizar artículo de venta
      • Listas Personalizadas
        • Crear Lista Personalizada
        • Listar Lista Personalizada
        • Eliminar lista personalizada
        • Modificar lista personalizada
        • Listar elementos de lista personalizada
      • Listar mis empresas
      • Crear una empresa
      • Buscar Sucursales de una empresa
      • Crear sucursal
      • Actualizar Sucursal
      • Eliminar Sucursal
      • Obtener sucursal
      • Crear Choferes de una empresa
      • Buscar choferes de una empresa
      • Obtener Chofer
      • Actualizar Choferes de una empresa
      • Modificar Choferes de una empresa
      • Eliminar chofer
      • Crear transportistas de una empresa
      • Buscar transportistas de una empresa
      • Obtener un transportista
      • Actualizar un transportista
      • Modificar un transportista
      • Marcar eliminado un transportista
      • Crear vehiculos de una empresa
      • Buscar vehiculos de una empresa
      • Obtener vehiculo
      • Modificar lista personalizada
      • Actualizar vehiculo
      • Modificar vehiculo
      • Eliminar Vehiculo
      • Cargar Certificado Digital para la Empresa
      • Obtener el certificado digital cargado en el sistema
      • Listar correos de la empresa enviados o recibidos por medio de Febos
      • Modificar grupo de unidad organizativa
      • Actualizar usuarios de grupo de unidad organizativa
      • Eliminar grupos de unidad organizativa
      • Invitar Proveedor
      • Buscar Proveedores
      • Listar árbol de usuarios dentro de grupos
      • Listar Unidades y oficinas de Escritorio Digital
      • Consultar información de una empresa
      • Lista Suplencias de Empresa
      • Asignar usuario a grupo
      • Eliminar relación de grupo usuario
    • 8.4. Seguridad
      • Listar roles
      • Listar permisos de rol
      • Ingreso programático
      • Crear Token permanente
      • Listar Token
    • 8.5. Utilidades
      • Pre firmar URL para upload
      • Subir archivo para proceso
      • Realizar acción masiva
      • Encolar tarea en background
      • Consulta estado de tarea en background
      • Historial de Eventos
      • Crear ticket de soporte
    • 8.6. SII
      • Generar AEC.
    • 8.7. Firma Electrónica
      • Firmar un documento
      • Recuperar Firmas Disponibles
    • 8.8. Usuarios
      • Listar eventos de firmas
      • Listar Usuarios
      • Listar Roles de Usuario
      • Obtener Usuario
      • Latido de usuario
      • Listar Grupos Usuario
    • 8.9. Impuestos
      • Listar Impuestos
    • 8.10. Aprobaciones
      • Cambiar correo de un paso
      • Previsualización documentos de aprobación
      • Listar Ejecuciones en Aprobaciones
      • Enviar archivo a flujo de firma
      • Obtener estado de ejecucion
      • Cambiar privacidad de una ejecución
    • 10. Configuraciones
      • Documentos - Numeración
        • Listar / obtener configuración de tipos de documento
        • Activar tipo de documento para la empresa
        • Actualizar configuración de tipo de documento (completa)
        • Actualizar configuración de tipo de documento (parcial)
        • Obtener grupos para configuración de folio
        • Obtener configuración de folio
        • Configurar folio de numeración
        • Crear tipo de documento de empresa
        • Actualizar tipo de documento (nombre / código doc digital)
      • opciones
        • destinos
          • Listar destinos de una opción
          • Obtener un destino de una opción
          • Agregar destino(s) a una opción
          • Modificar un destino de una opción
          • Eliminar un destino de una opción
      • Obtener objeto con configuraciones
  • Schemas
    • Schemas
      • Aprobaciones
        • AprobacionCrearResponse
        • Aprobacion-Paso
      • Articulos
        • Categoria
      • Estructura básica de un adjunto
    • BaseResponse
    • BaseListResponse
    • Dte
  1. Adjuntos

Presigned / Cargar archivo a repositorio

Entorno certificación
https://api.febos.cl/certificacion/
Entorno certificación
https://api.febos.cl/certificacion/
POST
/repositorios/{repositorio_id}/archivos/presigned
InformaciónDetalle
Permiso requeridoAWS01
ID operaciónio.ed.repositorios.archivos.presigned.crear
MétodoPOST
Endpoint multipropósito para cargar/registrar un archivo (adjunto) en un repositorio de Escritorio Digital. El comportamiento se controla con el campo source del body. Si el body incluye febosId, el adjunto queda asociado a ese documento (DNT/expediente); si el documento es un expediente EXP, además se renombra automáticamente según la configuración.
Una sola ruta cubre 6 operaciones según source y otros campos:
sourceCondición adicionalOperación
filesin uploadId (default)Iniciar multipart: genera uploadId y URLs prefirmadas por parte
filecon uploadIdCompletar multipart: ensambla el archivo en S3 y registra el adjunto
fileabort: trueAbortar multipart: cancela la carga y libera las partes
copy—Copiar: duplica un archivo S3 existente (por adjunto.adjuntoId)
tmp_move—Mover temporal: mueve un objeto temporal (adjunto.tmpKey) al repo
base64—Cargar base64: sube el archivo enviado en contenido (base64) al repo

Flujo recomendado para archivos grandes (multipart)#

1.
POST con source=file, parts=N → obtienes uploadId, fileId, key, bucket y urls[] (una URL prefirmada por parte).
2.
El cliente hace PUT de cada parte a su URL; guarda el ETag de cada PUT.
3.
POST nuevamente con el mismo uploadId y tags ([{PartNumber, ETag}]) para completar y registrar el adjunto.
4.
Si algo falla, POST con abort: true y el uploadId.

Carga simple desde base64 (source=base64)#

Sube el contenido codificado en base64 directamente en el request. Ideal para archivos pequeños (≤ ~5 MB de binario, por límites de payload de API Gateway/Lambda). Soporta prefijo data-URI (data:application/pdf;base64,...). Deriva Content-Type/Content-Disposition desde adjunto.adjuntoNombre (PDF → inline, XML → attachment).

Autenticación#

Headers propios de Febos: token (token de acceso) y empresa (RUT de la empresa en contexto). No usa Authorization: Bearer.

Respuesta#

Envelope estándar Febos con codigo (10 = éxito), mensaje, duracion, hora, seguimientoId. Según la operación agrega: datos de multipart (uploadId, urls, ...) o el objeto adjunto registrado.

Resolución de repositorio_id (cuando no se conoce el ID)#

El repositorio_id de la ruta identifica el repositorio de la empresa (header empresa) donde quedará el archivo. El backend lo resuelve con get_repositorio_from_id antes de cargar:
Valor en la rutaResolución
0, tmp, ., .tmpRepositorio principal de la empresa (tipo EMPRESA, propietario = empresa.empresa_id).
ExpedientesRepositorio de sistema (tipo SISTEMA) con nombre Expedientes. Si no existe, se crea con repositorioId = empresa.empresa_id.
(cualquier otro valor)Se usa tal cual como repositorioId.
Notas:
La resolución depende SIEMPRE de la empresa en contexto (header empresa): busca repositorios cuyo propietario sea la empresa autenticada.
Usa 0 (o tmp/./.tmp) cuando solo sabes que el archivo debe quedar en el repositorio por defecto de la empresa y no conoces su ID.
Usa Expedientes para dejar el archivo en el repositorio de expedientes de la empresa sin tener que crearlo/consultarlo previamente.

Solicitud

Parámetros de ruta

Parámetros de consulta

Parámetros de Header

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200OK - Iniciar multipart
application/json
Bodyapplication/json

🟢201OK - Adjunto registrado (complete/copy/tmp_move/base64)
🟢200Error / Acceso denegado / Sin permiso
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location 'https://api.febos.cl/certificacion//repositorios/0/archivos/presigned?aplicacion=FEB' \
--header 'token: xx' \
--header 'token: xx' \
--header 'empresa: 1111111-1' \
--header 'empresa: 1111111-1' \
--header 'Content-Type: application/json' \
--data '{
    "source": "file",
    "bucket": "string",
    "file": "escritorio-digital/chile/desarrollo/repositorios/61808000-5/archivo.pdf",
    "parts": 3,
    "uploadId": "string",
    "abort": false,
    "tags": [
        {
            "PartNumber": 1,
            "ETag": "\"e1a2b3c4...\""
        }
    ],
    "overrideFileId": "string",
    "febosId": "f1cab81e19d521433a18aa2161425d72278c",
    "codType": "string",
    "contenido": "data:application/pdf;base64,JVBERi0xLjQK...",
    "adjunto": {
        "adjuntoId": "string",
        "adjuntoNombre": "comprobante.pdf",
        "alias": "string",
        "tipo": "string",
        "codType": "string",
        "propietario": "string",
        "tmpKey": "string",
        "contenido": "string"
    }
}'
Respuesta Ejemplo de Respuesta
200 - Ejemplo 1
{
    "codigo": 10,
    "mensaje": "string",
    "duracion": 0,
    "hora": "string",
    "seguimientoId": "string",
    "fileId": "string",
    "uploadId": "string",
    "key": "string",
    "bucket": "string",
    "urls": [
        {
            "partNumber": 0,
            "url": "string"
        }
    ]
}
Modificado en 2026-09-24 16:17:42
Anterior
Imprimir contrato
Siguiente
Nuevo Documento No Tributario
Built with