> 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.

![](https://3501199730-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lq22TUGQpbcCXFGtF0q%2F-MkDSp0O2Y2dXFPDi1XI%2F-MkDVyB0LOW9-YC6cPC4%2Fimage.png?alt=media\&token=70ca221a-059a-4f95-a2b7-ec1060526027)

Luego deberás seleccionar tu empresa:

![Puedes escribir el nombre de tu empresa o seleccionarla en la parte inferior al buscador](https://3501199730-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lq22TUGQpbcCXFGtF0q%2F-MkDSp0O2Y2dXFPDi1XI%2F-MkDXlhEfPnYWBvMtoKf%2Fimage.png?alt=media\&token=cf1a8110-fecc-4c8e-abac-b764e1b152a5)

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

![Puede que las opciones del menú varíen](https://3501199730-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lq22TUGQpbcCXFGtF0q%2F-MkDSp0O2Y2dXFPDi1XI%2F-MkDX0cJOOQGONWkBGvM%2Fimage.png?alt=media\&token=4a3dceec-8667-4da0-af8b-77a90ef92b42)

## 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:

![](https://3501199730-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lq22TUGQpbcCXFGtF0q%2F-MkDSp0O2Y2dXFPDi1XI%2F-MkDZYb-gHaHslPJZA2L%2Fimage.png?alt=media\&token=1a479e46-2509-4203-b047-38805939d4aa)

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:

 

![Puedes darle click para copiar tu x-api-key](https://3501199730-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lq22TUGQpbcCXFGtF0q%2F-MkDSp0O2Y2dXFPDi1XI%2F-MkDbohIJBwzMKiWsA6f%2Fimage.png?alt=media\&token=04fd177b-000b-46ae-b4bd-7dc620189fbd)

    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:

![](https://3501199730-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lq22TUGQpbcCXFGtF0q%2F-MkDSp0O2Y2dXFPDi1XI%2F-MkDcRCOIWn9SxQFcSq3%2Fimage.png?alt=media\&token=f4b0c02f-27e1-4ed4-8fbd-fc80f0490005)

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

![](https://3501199730-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lq22TUGQpbcCXFGtF0q%2F-MkDSp0O2Y2dXFPDi1XI%2F-MkDdJWpL6_fnTKDlcWO%2Fimage.png?alt=media\&token=1fb58bcb-38ec-4bb7-9296-4af91e89e7cc)

###     **Menú y contenido**

El menú cuenta con las siguientes opciones:

![](https://3501199730-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lq22TUGQpbcCXFGtF0q%2F-MkDSp0O2Y2dXFPDi1XI%2F-MkDld3byYSFyhWpRagy%2Fimage.png?alt=media\&token=39d21fc4-f948-4d55-9f0f-012d1b0eabce)

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

![](https://3501199730-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lq22TUGQpbcCXFGtF0q%2F-MkDSp0O2Y2dXFPDi1XI%2F-MkDmPPznQG3h7-KGBTy%2Fimage.png?alt=media\&token=af380dd1-7f7c-43ae-8b0c-950d5fabf086)

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.

![](https://3501199730-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lq22TUGQpbcCXFGtF0q%2F-MkDSp0O2Y2dXFPDi1XI%2F-MkE-k2QJEwaflEsf9x3%2Fimage.png?alt=media\&token=7d94719e-ff1b-48ed-ae75-5d8700440f85)

### 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**

![](https://3501199730-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lq22TUGQpbcCXFGtF0q%2F-MkDSp0O2Y2dXFPDi1XI%2F-MkE09Oj-jNMd2cHPKt0%2Fimage.png?alt=media\&token=999a8370-2487-44f7-9b43-74fdd3d9262d)

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

![](https://3501199730-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lq22TUGQpbcCXFGtF0q%2F-MkDSp0O2Y2dXFPDi1XI%2F-MkE6xYqOksxK2N1CkMv%2Fimage.png?alt=media\&token=4f77362c-5283-4ea1-ba21-d30217132910)

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

![](https://3501199730-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lq22TUGQpbcCXFGtF0q%2F-MkDSp0O2Y2dXFPDi1XI%2F-MkE5XmQYB3xglQZIlLp%2Fimage.png?alt=media\&token=67a2a279-dfaf-4380-9c8f-cbd40a75abcf)

    **ID:** Copia el ID del documento al portapapeles

    **Cufe:** Copia el cufe al portapapeles

    **JSON:** Muestra el documento en formato JSON

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

    **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:

![](https://3501199730-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lq22TUGQpbcCXFGtF0q%2F-MkEP1p0-JWZ9SdqVx1J%2F-MkEZrtcRetw0Gjf5aF4%2Fimage.png?alt=media\&token=433f8015-69fd-4923-9211-0ed58b473f92)

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

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

![](https://3501199730-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lq22TUGQpbcCXFGtF0q%2F-MkEP1p0-JWZ9SdqVx1J%2F-MkEaEwcRp09RcuG_3mo%2Fimage.png?alt=media\&token=fd5bb906-df36-468c-944b-61aa25987221)

    **ID:** Copia el ID del documento al portapapeles

    **Cufe:** Copia el cufe al portapapeles

    **Número:** Muestra el número del documento

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

    **DIAN:** Muestra detalladamente el mensaje de respuesta de la DIAN

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

![](https://3501199730-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lq22TUGQpbcCXFGtF0q%2F-MkDSp0O2Y2dXFPDi1XI%2F-MkE9gDus3-e2RKrDrG2%2Fimage.png?alt=media\&token=0a198485-01f3-47e6-8b7c-ecea80b00f43)

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.

![](https://3501199730-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq22TUGQpbcCXFGtF0q%2Fuploads%2F01HaoY3LNKn2HCGlyg0c%2Fimagen_2023-02-02_120803643.png?alt=media\&token=e2ad3fa5-46b1-4ce5-a6dc-978b5423c635)

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

![](https://3501199730-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq22TUGQpbcCXFGtF0q%2Fuploads%2FrTxhKfeu3rWZmYybBfxZ%2Fimagen_2023-02-02_120343402.png?alt=media\&token=e82af805-01bd-4362-acd5-270268c21273)

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

![](https://3501199730-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lq22TUGQpbcCXFGtF0q%2F-MkDSp0O2Y2dXFPDi1XI%2F-MkEH6hdPlI6E8g7Oq4O%2Fimage.png?alt=media\&token=40c9fda8-4dca-4354-9ef1-813ae63f66a5)

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

![](https://3501199730-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lq22TUGQpbcCXFGtF0q%2F-MkDSp0O2Y2dXFPDi1XI%2F-MkEIAw6OkNRyf8Y-ocz%2Fimage.png?alt=media\&token=f4822c19-1156-49d9-9ecc-b1ef54cd5446)

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.

![](https://3501199730-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lq22TUGQpbcCXFGtF0q%2Fuploads%2FfTOg6vM3dGU8OTbGDaQb%2Fimagen_2023-02-02_121020863.png?alt=media\&token=dbbdc1c3-05f2-43e9-bae1-9310b616d6fb)