1. Uso de API
  • 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
      • Nuevo Documento No Tributario
      • Listar DNTs
      • Actualizar Documento No Tributario
      • Obtener información de un documento
      • Actualiza Estado de Documento No Tributario
      • Buscar DTE referenciados a un DNT
    • 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
      • 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
      • 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
      • Crear Lista Personalizada
      • Listar Lista Personalizada
      • Eliminar lista personalizada
      • Modificar lista personalizada
      • Modificar lista personalizada
      • Listar elementos de lista personalizada
      • 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
    • 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 Usuarios
      • Listar Roles de Usuario
      • Obtener Usuario
      • Latido de usuario
      • Listar Grupos Usuario
    • 8.9. Impuestos
      • Listar Impuestos
    • 8.10. Aprobaciones
      • Previsualización documentos de aprobación
      • Listar Ejecuciones en Aprobaciones
      • Enviar archivo a flujo de firma
      • Obtener estado de ejecucion
    • 10. Configuraciones
      • Obtener objeto con configuraciones
  • Schemas
    • Schemas
      • Aprobaciones
        • AprobacionCrearResponse
        • Aprobacion-Paso
      • Articulos
        • Categoria
      • Estructura básica de un adjunto
    • BaseResponse
    • BaseListResponse
  1. Uso de API

3. Seguridad

Porque la seguridad es algo que realmente nos importa, aunque sabemos que no somos la NSA, intentamos asegurar nuestro servicio, para eso disponemos de distintos mecanismos que se describen a continuación.

3.1. Autenticación#

Todos los enpoints de Febos requieren, como mínimo, 1 parámetro obligatorio que es enviado por HEADER (si no sabes que esto, puedes encontrar la descripción más adelante). Éste parámetro, que se llama token, consiste en una cadena de texto compuesta de letras y números que parecieran al azar, pero no lo son, es un texto que Febos puede identificar y leer información de él, de tal forma que puede identificar quien esta ejecutando la acción. Éste token es único, y es generado a nombre de un usuario desde la web de Febos (portal.febos.cl). Un usuario puede crear cuantos tokens deseé, asi como tambien puede eliminarlos. La recomendación es crear un token por cada aplicación que accederá programáticamente a Febos. Es importante saber que el token queda asociado a un usuario específico, es decir, todas las acciones realizadas con esos tokens, quedarán realizadas bajo responsabilidad del usuario dueño de los tokens.
Si eres un partner, lo usual es que tu usuario tenga permiso para todas las empresas que son tus clientes, en tal caso, la recomendación es tener 1 token por cada cliente, de tal forma que si un token se ve expuesto o vulnerado (que un token haya sido divulgado sin concentimiento, por ejemplo) no afecte al resto de tus clientes.

3.2. Registro#

En Febos registramos cada llamada que se hace a la API, registramos que parámetros fueron enviados, que respondio Febos, quién hizo la llamada, en que empresa, e incluso desde que IP. Estos registros nos permiten analizar cualquier eventualidad ya sea de negocio o seguridad que se pudiese dar. Adicionalmente nos permite pode bloquear solicitudes desde ciertas IP, o restringir el uso de la API, para ciertos tokens, en caso de que un cliente requiera de mayor seguridad.

3.3. Permisos#

Cada usuario (por ende cada token, ya que hereda todo lo del usuario al que pertenece) tiene asignado ROLES, asi como cada ROL tiene asginado PERMISOS. El resultado final es un conjunto de permisos asociados a un usuario en particular. Por otro lado, cada Endpoint de la api requiere de un permiso en particular para ser utilizado, es decir, si un endpoint requiere un permiso A000 y el usuario no tiene asignado ningún rol que posea dicho permiso, al consumir la API que requiera ese permiso, tendra como respuesta un error indicando que no tiene permisos para ejecutar dicha acción.

3.4. Infraestructura#

La tecnología que hay detras de Febos tiene como nombre "Serverless", que traducido al español es algo como "sin servidores". Si bien técnicamente hablando si hay servidores, éstos funcionan de una manera muy particular; solo estan activos durante el tiempo en que son utilizados.
Cuando realizas una llamada a la API, un "mini-servidor" es levantado en milisegundos, procesa la llamada a la API, envia la respuesta y luego es desactivado. Esto ocurre con cada llamada, incluso con llamadas en paralelo, en donde si ocurren 10 llamadas en paralelo, 10 miniservidores son levantados en paralelo para responder cada una de las solicitudes. Con esto evitarmos muchos problemas de seguridad y mantenimiento de servidores, pues, al estar cada servidor activo por un par de segundos, es prácticamente imposible vulnerarlos.
Modificado en 2025-09-16 19:42:20
Anterior
2. Ambientes Disponibles
Siguiente
4. Respuestas
Built with