> For the complete documentation index, see [llms.txt](https://factura-electronica.aliaddo.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://factura-electronica.aliaddo.dev/primeros-pasos/manual-operativo-de-la-plataforma.md).

# Manual Operativo de la Plataforma

## Ingreso a la plataforma

Para ingresar a la plataforma debes utilizar tu correo o nombre de usuario y tu contraseña asignada, es recomendable que en el primer ingreso cambies la contraseña.

![](/files/-MkDVyB0LOW9-YC6cPC4)

Luego deberás seleccionar tu empresa:

![Puedes escribir el nombre de tu empresa o seleccionarla en la parte inferior al buscador](/files/-MkDXlhEfPnYWBvMtoKf)

A continuación encontrarás una página cómo la siguiente:

![Puede que las opciones del menú varíen](/files/-MkDX0cJOOQGONWkBGvM)

## Interacción con la plataforma

Ahora veremos las funcionalidades de la plataforma en dos partes, la parte superior (Encabezado) y la parte inferior (Menú y contenido)

### Encabezado

El encabezado se divide en las siguientes opciones:

![](/files/-MkDZYb-gHaHslPJZA2L)

1. **Selector de empresa:** Buscador que te permite seleccionar la empresa con la que vas a interactuar, es importante seleccionar una empresa antes de realizar cualquier operación o consulta en la plataforma.
2. **Botón de api key:** Permite consultar el **x-api-key** asociado a tu empresa:

&#x20;

![Puedes darle click para copiar tu x-api-key](/files/-MkDbohIJBwzMKiWsA6f)

&#x20;   3\. **Botón de crear empresa:** Te permite crear una nueva empresa, te redireccionará a este formulario en el que deberás ingresar los datos de la nueva empresa:

![](/files/-MkDcRCOIWn9SxQFcSq3)

&#x20;  4\. **Menú de usuario:** Permite interactuar con las opciones de tu usuario personal:\
&#x20;      a. **Empresas:** Consultar las empresas vinculadas a tu usuario.\
&#x20;      b. **Plan y Facturación:** Consulta el pan que tienes adquirido actualmente y el historial de comprobantes de pago.\
&#x20;      c. **Cambiar contraseña:** Permite cambiar tu contraseña.\
&#x20;      d. **Documentación Swagger:** Redirige a la documentación de swagger.\
&#x20;      e. **Documentación API:** Redirige a la documentación de la API.\
&#x20;      f. **Cerrar sesión:** Finalizar la sesión actual, redirige al inicio de sesión.

![](/files/-MkDdJWpL6_fnTKDlcWO)

### &#x20;   **Menú y contenido**

El menú cuenta con las siguientes opciones:

![](/files/-MkDld3byYSFyhWpRagy)

1. **Dashboard:** Permite ver el flujo de documentos de la plataforma por medio de gráficos:

![](/files/-MkDmPPznQG3h7-KGBTy)

2\. **Log documentos:** Historial de documentos procesados por la api, cuenta con los registros de todos los documentos: Facturas, Notas crédito, Notas débito, Nómina, Notas de reemplazo de nómina y Notas de eliminación de nómina.

![](/files/-MkE-k2QJEwaflEsf9x3)

### Facturas, notas crédito y débito

Cada uno de estos documentos puede ser consultado por uno de estos tres criterios de búsqueda: **Por fecha, Por consecutivo o por Estado**

![](/files/-MkE09Oj-jNMd2cHPKt0)

Los documentos cuentan con las siguientes acciones de interacción:

![](/files/-MkE6xYqOksxK2N1CkMv)

&#x20;    **Botón de acciones:** Permite visualizar y/o descargar el documento en los formatos listados

![](/files/-MkE5XmQYB3xglQZIlLp)

&#x20;   **ID:** Copia el ID del documento al portapapeles

&#x20;   **Cufe:** Copia el cufe al portapapeles

&#x20;   **JSON:** Muestra el documento en formato JSON

&#x20;   **Avión de papel:** Muestra el historial de acciones del envío del documento

&#x20;   **DIAN:** Muestra detalladamente el mensaje de respuesta de la DIAN

### Comprobantes de nómina

Estos documentos pueden ser filtrados en dos categorías, por el período o por un empleado específico:

![](/files/-MkEZrtcRetw0Gjf5aF4)

&#x20;Los documentos de nómina cuentan con las siguientes acciones de interacción:

&#x20;   **Botón de acciones:** Permite visualizar y/o descargar el documento en los formatos listados

![](/files/-MkEaEwcRp09RcuG_3mo)

&#x20;   **ID:** Copia el ID del documento al portapapeles

&#x20;   **Cufe:** Copia el cufe al portapapeles

&#x20;   **Número:** Muestra el número del documento

&#x20;   **Ambiente:** Indica el ambiente al que fue enviado el documento, puede ser: Pruebas, Habilitación o Producción

&#x20;   **DIAN:** Muestra detalladamente el mensaje de respuesta de la DIAN

3\. **Logo:** Permite subir el logo de la empresa y eliminarlo

![](/files/-MkE9gDus3-e2RKrDrG2)

4\. **Resoluciones:** Consultar las resoluciones agregadas en el portal de la DIAN para facturar, el botón **JSON** muestra la resolución en formato JSON.

![](/files/dDKMVWotad0lSRgmz90s)

5\. **Empresa:** Permite visualizar los datos de la empresa, editarlos y copiar o generar la api key.

![](/files/0HaNBuyyzdAtAdDVJRp6)

6\. **Firma:** Permite subir el archivo de la firma electrónica que debe ir con la contraseña asignada

![](/files/-MkEH6hdPlI6E8g7Oq4O)

7\. **Importar Facturas:** Permite importar y ver el historial de facturas

![](/files/-MkEIAw6OkNRyf8Y-ocz)

La **modalidad** indica para qué ambiente serán enviadas las facturas: Producción, habilitación, pruebas. Adicionalmente indica qué se hará con ellas en las opciones de **Acción**: Crear o actualizar los documentos.

El **log de archivos importados** indica el registro de las facturas filtrado con las opciones en la parte superior, funciona cómo el log de documentos mencionado más arriba.

8\. **Importar Notas Débito:** Permite importar notas débito, funciona igual que **Importar Facturas.**

9\. **Importar Notas Crédito**: Permite importar notas crédito, funciona igual que **Importar Facturas.**

10\. **Usuarios:** Listado de usuarios que tienen acceso a la plataforma. Permite agregar o editar a los usuarios.

![](/files/LLHZiCNyCFoakXSeOn4v)
