> ## Documentation Index
> Fetch the complete documentation index at: https://docs.somosboop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Registrar una transacción

> Aprende a registrar una nueva transacción de venta dentro de boop.

# Registrar una transacción

Una transacción registra la venta de materiales realizada por un **Gestor** hacia un **Transformador**.

Durante este proceso se registra toda la información necesaria para mantener la trazabilidad de la operación, incluyendo el documento soporte, los materiales vendidos, la bodega de origen y el transformador que recibirá los materiales.

<Warning>
  ### Importante

  En la versión actual de **boop**, únicamente los **Gestores** pueden registrar nuevas transacciones.

  Todas las transacciones se crean con estado **Pendiente de aprobación** y deberán ser revisadas posteriormente por el Transformador.
</Warning>

***

## Antes de comenzar

Antes de registrar una transacción verifica que cumples los siguientes requisitos.

<CardGroup cols={2}>
  <Card title="Alianza activa" icon="handshake">
    Debe existir una alianza activa con el Transformador que recibirá los materiales.
  </Card>

  <Card title="Materiales configurados" icon="boxes-stacked">
    Los materiales que venderás deben encontrarse previamente configurados dentro de tu organización.
  </Card>

  <Card title="Documento soporte" icon="file-pdf">
    Debes contar con un documento en formato PDF que respalde la transacción, por ejemplo una factura.
  </Card>

  <Card title="Bodega disponible" icon="warehouse">
    La bodega desde donde salen los materiales debe encontrarse registrada.
  </Card>
</CardGroup>

***

## Ingresar al módulo

Desde el menú principal selecciona **Ventas**.

Al ingresar encontrarás el historial de todas las transacciones registradas por tu organización.

La pantalla muestra información como:

| Campo             | Descripción                                     |
| ----------------- | ----------------------------------------------- |
| Consecutivo       | Identificador único de la transacción.          |
| Gestor            | Organización que registra la venta.             |
| Bodega            | Lugar desde donde salen los materiales.         |
| Transformador     | Organización que recibe los materiales.         |
| Planta            | Planta de transformación de destino.            |
| Documento soporte | Archivo PDF asociado a la operación.            |
| Estado            | Estado actual de la transacción.                |
| Fecha de creación | Momento en que fue registrada.                  |
| Acciones          | Permite consultar el detalle de la transacción. |

***

## Crear una nueva transacción

En la parte superior del listado encontrarás el botón **Agregar nueva venta**.

Al seleccionarlo se abrirá el formulario para registrar la información de la operación.

<Steps>
  <Step title="Selecciona la bodega">
    Indica la bodega desde la cual salieron los materiales.
  </Step>

  <Step title="Selecciona el Transformador">
    Escoge el Transformador que recibirá los materiales.

    Solo aparecerán los Transformadores con los que exista una alianza activa.
  </Step>

  <Step title="Adjunta el documento soporte">
    Carga un archivo PDF que respalde la transacción.

    Por ejemplo, una factura.
  </Step>

  <Step title="Registra los materiales">
    Agrega todos los materiales vendidos durante la operación.
  </Step>

  <Step title="Guarda la transacción">
    Selecciona una de las opciones disponibles para finalizar el proceso.
  </Step>
</Steps>

***

# Materiales de la transacción

La sección **Lista de materiales** permite registrar todos los materiales incluidos dentro de la venta.

Para agregar un material selecciona **Agregar material vendido**.

***

## Materiales estandarizados

<Info>
  Uno de los objetivos principales de **boop** es estandarizar la clasificación de los materiales aprovechables.

  Por esta razón, los materiales no se escriben manualmente durante una transacción.

  Todos los materiales deben haber sido configurados previamente por la organización dentro de su configuración general.
</Info>

Cuando seleccionas **Agregar material vendido**, la plataforma mostrará únicamente los materiales previamente registrados por tu organización.

Esto garantiza que:

* Todos los usuarios utilicen la misma clasificación.
* Se reduzcan errores de digitación.
* Se mantenga una interpretación uniforme de los materiales.
* La información sea consistente con los requerimientos definidos por la normativa ambiental.

```mermaid theme={null}
flowchart LR

A[Configuración de materiales]

A --> B[Catálogo del Gestor]

B --> C[Nueva transacción]

C --> D[Agregar material]

style A fill:#58388D,color:#fff
style D fill:#14F4A9,color:#000
```

***

## Información de cada material

Por cada material registrado deberás indicar:

| Campo    | Descripción                                           |
| -------- | ----------------------------------------------------- |
| Material | Material previamente configurado por la organización. |
| Cantidad | Cantidad vendida expresada en toneladas.              |

Podrás agregar tantos materiales como hagan parte de la misma transacción.

***

## Documento soporte

La transacción debe contar con un documento que respalde la operación.

Actualmente la plataforma acepta:

| Requisito     | Valor |
| ------------- | ----- |
| Formato       | PDF   |
| Tamaño máximo | 5 MB  |

El documento soporte normalmente corresponde a una factura, aunque podrá utilizarse cualquier documento válido que respalde la operación.

***

## Guardar la transacción

Al finalizar encontrarás dos opciones.

<CardGroup cols={2}>
  <Card title="Guardar y continuar registrando" icon="floppy-disk">
    Guarda la transacción actual y permite registrar una nueva inmediatamente.
  </Card>

  <Card title="Guardar y volver a la lista" icon="list">
    Guarda la información y regresa al listado general de transacciones.
  </Card>
</CardGroup>

***

## ¿Qué ocurre después de guardar?

Cuando la información es válida:

* Se genera un consecutivo único para la transacción.
* La operación aparece en el listado de ventas.
* El estado inicial será **Pendiente de aprobación**.
* El Transformador podrá revisar la información registrada.

***

## Recomendaciones

<Tip>
  Antes de guardar la transacción verifica que:

  * El documento soporte corresponda exactamente a la información registrada.
  * Los materiales coincidan con la factura.
  * Las cantidades estén expresadas correctamente en toneladas.
  * Seleccionaste el Transformador correcto.
  * Todos los materiales pertenecen a la misma operación comercial.

  Una transacción bien registrada agiliza el proceso de revisión y reduce la necesidad de correcciones posteriores.
</Tip>

***

## Continúa con el siguiente proceso

<CardGroup cols={2}>
  <Card title="Responder una transacción" icon="clipboard-check" href="/procesos/operacion/responder-una-transaccion">
    Conoce cómo el Transformador revisa, aprueba o devuelve una transacción.
  </Card>

  <Card title="Estados de una transacción" icon="arrows-rotate" href="/procesos/operacion/estados-de-una-transaccion">
    Aprende cómo evoluciona una transacción durante su ciclo de vida.
  </Card>
</CardGroup>
