📘 Pantalla: Acuerdo de compraventa
El contrato de compraventa es el registro del negocio cerrado con la trading, la cooperativa o la industria: tanto de producto, a tanto por bolsa, para embarcar entre tal y tal fecha. En upCampo, es el que le da destino a la producción: cada romaneo de salida descuenta del contrato, y la pantalla muestra, en cualquier momento, cuánto ya se embarcó y cuánto falta todavía.
El contrato por sí solo no saca nada del stock. Es lo acordado: registra lo que se pactó y sirve de referencia. Quien da de baja el saldo es el romaneo de salida, camión por camión. Un contrato de 2.000 toneladas puede cerrarse con el depósito todavía vacío: es el caso de la venta futura, acordada antes de que entre la producción.
El contrato es también el lugar donde se guardan los parámetros fiscales de la venta, cuando hay emisión de factura: naturaleza de la operación, serie, CFOP, CST, transportista e información complementaria.
📍 Ubicación en el sistema
Menú: Almacenamiento de granos > Acuerdo de compraventa
🧩 Función principal
Controlar el saldo de cada contrato —cantidad contratada, embarcada y restante— y reunir en un solo lugar el precio acordado, los descuentos por clasificación aceptados por el comprador y los datos fiscales de la factura.
🔀 Venta o Compra
El Tipo se elige al crear el contrato y no cambia después de guardado. Invierte los papeles de los campos de entidad:
- Venta — el campo principal es Comprador (Entidad), quien se lleva el producto; el campo de tercero es Vendedor (tercero).
- Compra — el campo principal pasa a ser Vendedor (Entidad) y el de tercero, Comprador (tercero).
📝 Campos del encabezado
| Campo | Descripción |
|---|---|
| Situación | Abierto, Iniciado, Finalizado, Cancelado y Venta futura. Un contrato finalizado o cancelado ya no aparece para elegir en los romaneos. |
| Configuración de impuestos | Qué CNPJ de la sucursal emite la factura de este contrato. |
| Campaña Origen / Año | La campaña del producto negociado. |
| Moneda | Moneda del contrato. Es la que decide qué bloque de valores queda activo. |
| Fecha | Fecha de cierre del negocio. |
| Número (nuestro) | Obligatorio. La numeración del establecimiento. |
| Número (proveedor) | El número que usa el comprador para el mismo contrato: es con él que la trading se va a referir al negocio. |
| Comprador (Entidad) | Obligatorio. Con quién se cerró el contrato. Completa la Dirección, que queda solo de lectura. |
| Ubicación de stock | Obligatoria. De dónde sale el producto (o adónde entra, en la compra). |
| Cultivo | Obligatorio. Además de clasificar el contrato, es su campo Unidad el que define si la cantidad se convierte en bolsas o en arrobas. |
| Producto | Obligatorio. Lo que se está negociando: algodón en fibra, semilla de algodón, maíz en grano. |
| Fecha de inicio del envío / Fecha de envío final | La ventana de embarque acordada. |
| KG cantidad | Obligatoria y mayor que cero. El total contratado, en kilos. Siempre es en KG que el contrato controla el saldo: las demás unidades son solo una lectura del mismo número. |
| Cantidad SC o Cantidad @ | El mismo total, en la unidad en que se negocia ese producto, y el rótulo del campo cambia junto: Cantidad SC para granos (bolsa de 60 kg) y Cantidad @ para algodón (arroba de 15 kg). Quien manda es el campo Unidad del Cultivo. Digitar de un lado completa el otro. |
| Cantidad enviada KG | Sumada por los romaneos. No se digita. |
| Cantidad restante KG | Lo que falta embarcar. Baja con cada romaneo y es lo que decide si el contrato todavía aparece al registrar uno nuevo. No es un bloqueo: el sistema no impide que el embarque supere lo contratado. |
| Campo cantidad | Qué valor del romaneo se lleva a la factura: Neto final (el estándar), Neto inicial o Cantidad. Si elige Cantidad, el romaneo de salida pasa a mostrar un campo Cantidad para digitar. |
| Responsable de impuestos | Nosotros o Ellos: de quién es el impuesto de la operación. Define en qué totalizador del contrato se acumula el impuesto de los romaneos. |
| Quién vendió / Quién compró (negociante) | El corredor o negociante que intermedió: campo libre. |
| Nota | Campo libre. |
Cómo controla upCampo el saldo del contrato
El contrato guarda la cantidad en tres unidades al mismo tiempo, pero solo una manda: el saldo se controla en kilos. Las otras son una lectura del mismo número, convertido.
Quien decide el divisor es el campo Unidad del cultivo: en SC - Sacas la cuenta es por 60; en cualquier otra, por 15. Ni 60 ni 15 son configurables: es lo que pesan la bolsa y la arroba.
| Momento | Kilos | En bolsas |
|---|---|---|
| Contratado | 1.200.000 kg | 20.000 sc |
| Ya embarcado (romaneos de salida) | 780.000 kg | 13.000 sc |
| Cantidad restante KG | 420.000 kg | 7.000 sc |
💵 Los valores
El bloque de valores trae Valor unitario (KG), el valor unitario en la unidad del producto (SC o @, con el rótulo cambiando junto), Valor total, V. Envío total, V. Líquido y V. Impuestos Totales. Completar el unitario por kilo actualiza el valor por bolsa y el total, y viceversa. El V. Líquido es obligatorio para guardar.
Hay tres bloques de valores, uno por moneda, y los bloques de moneda extranjera traen también la Cotización. Cambiar la cotización reprocesa los valores convertidos.
🧪 % Clasificación/Descuento
Es el bloque que dice cómo acepta el comprador descontar la carga. Para cada tipo —humedad, impureza, quebrado, ardido, dañado y almacenamiento— se elige la tabla de descuento estándar que vale en este contrato. Las marcas manual al lado (humedad, impureza, ardido, dañado y almacenamiento) abren el campo de descuento para digitar en lugar de buscarlo en la tabla.
Un tipo sin tabla elegida simplemente no aparece en el romaneo vinculado a este contrato: así se achica la pantalla de quien solo descuenta humedad e impureza, por ejemplo.
🗂 Pestañas
Aditivos
Registra los cambios de cantidad acordados después del cierre. Cada aditivo tiene Tipo (Agregando o Extracción), Fecha, Número, KG cantidad, la cantidad en la unidad del producto, valores unitarios y V. Líquido. El aditivo modifica la cantidad restante del contrato: agregando aumenta el saldo a embarcar, extracción lo disminuye.
NF-E - Parámetros para la emisión de la factura electrónica
No todo contrato emite factura. La venta interna —el maíz que va al engorde a corral del propio establecimiento, por ejemplo— se registra en un contrato solo para controlar la cantidad. En ese caso, basta con dejar esta pestaña y la de detalles en blanco: el contrato funciona normalmente y el romaneo de salida sigue dando de baja el stock; lo que no va a existir es el Generar Factura.
Cuando hay emisión, es aquí donde quedan los datos que usará la factura: Medio pago, Método de envío, Transportador (si está fijo), Centro de coste, Serie, Naturaleza de la operación, Especie y la Información complementaria: el texto legal que sale al pie de la factura, donde caben campos automáticos (el botón encima del campo lista cuáles están disponibles, como el conductor y el CPF del vehículo). El botón Copiar parámetros de otro contrato trae todo eso de un contrato ya configurado.
NF-E - Detalles (productos)
Los ítems que entran en la factura, con Producto, NCM, Unidad, Cantidad, Valor unitario y el bloque de Impuestos: CFOP, CST de ICMS, PIS, COFINS e IPI, con las alícuotas y la reducción de base. Al elegir el CST, viene junto la alícuota estándar registrada. Es esta pestaña la que consulta el romaneo al generar la factura: sin ítems aquí, la factura no sale.
Archivo
Adjuntos del contrato: el PDF firmado, el aditivo escaneado. Cada adjunto tiene Título, Descripción, nombre del archivo y Nota, y la lista trae un botón visualizar que abre el documento.
💰 Finalizar y Generar financiero
- Finalizar cierra el contrato; en un contrato ya finalizado, el mismo botón pregunta si quiere reabrirlo.
- Generar financiero abre la ventana que transforma el valor neto del contrato en cuotas por cobrar en el módulo financiero. El campo al lado del botón muestra el título ya generado.
📋 La lista
La lista filtra por Campaña y por Tipo (Venta, Compra o Todos), y muestra la Situación como etiqueta de color, además de cantidad, valor neto, cantidad embarcada y restante: se puede leer el avance de todos los contratos de la campaña en una sola pantalla. El botón Ver existencias abre el saldo actual sin salir de aquí, e Informes ▼ lista los informes habilitados para esta pantalla.
- Se sabe, en cualquier momento, cuánto falta embarcar de cada contrato
- Al momento del embarque, quien registra el romaneo ya encuentra el contrato correcto, con el saldo a la vista
- Si hay emisión de factura, sale del romaneo con los parámetros fiscales acordados
❓ Preguntas frecuentes
El contrato no aparece para elegir en el romaneo. ¿Por qué?
Tres motivos cubren casi todos los casos: el contrato está finalizado o cancelado, la cantidad restante llegó a cero, o es de otra campaña/sucursal distinta de la seleccionada en el filtro de la lista de romaneos. Revise la situación y la cantidad restante en la lista de contratos.
Acordé más cantidad con el comprador. ¿Creo otro contrato?
No hace falta: use la pestaña Aditivos, con el tipo Agregando. La cantidad restante del contrato aumenta y queda registrado el historial de lo que se acordó después. Para reducir, el tipo es Extracción.
El romaneo no genera la factura. ¿Qué falta en el contrato?
Casi siempre es la parte fiscal incompleta: naturaleza de la operación y serie en la pestaña de parámetros, o un ítem sin CST de ICMS, PIS, COFINS e IPI, o un producto sin NCM y sin unidad en la pestaña de detalles. También se exige el código IBGE del municipio en la entidad del contrato y en la transportista. El aviso en pantalla indica cuál de los ítems falta.
Vendo dentro del propio establecimiento, sin factura. ¿Puedo usar un contrato?
Sí, y es un uso común: el maíz que va al engorde a corral, por ejemplo. Registre el contrato normalmente y deje las pestañas de NF-E en blanco: sigue controlando la cantidad contratada, embarcada y restante, y el romaneo de salida sigue dando de baja el stock. Solo no habrá factura que emitir.
Cerré un contrato antes de cosechar. ¿El sistema lo permite?
Sí. El contrato registra lo acordado, no el stock: quien da de baja el saldo es el romaneo de salida. La venta futura, cerrada antes de que entre la producción, se registra normalmente, y la situación Venta futura existe justamente para dejarlo claro en la lista.
¿Para qué sirve el campo "Campo cantidad"?
Para indicar qué peso del romaneo vale como cantidad de la factura. Lo normal es Neto final: el peso ya descontado. Si elige Cantidad, el romaneo de salida gana un campo propio de cantidad, usado cuando lo que se cobra no es el peso de la báscula.
La cantidad se convirtió en arrobas y yo esperaba bolsas. ¿Por qué?
La bolsa es siempre de 60 kg y la arroba, de 15 kg: eso no se configura en ningún lugar. Lo que el sistema necesita saber es en cuál de las dos se negocia ese producto, y eso viene del campo Unidad del Cultivo: en SC - Sacas el campo se llama Cantidad SC y divide los kilos por 60; en @ - Arroba, pasa a ser Cantidad @ y divide por 15. Si se convirtió en la unidad equivocada, el ajuste está en el registro del cultivo. El saldo del contrato, en todo caso, sigue controlándose en kilos.
Finalicé un contrato por error. ¿Se puede deshacer?
Sí. Seleccione el contrato y haga clic de nuevo en Finalizar: en un contrato ya finalizado, el botón pregunta si quiere reabrirlo, y vuelve a la situación Abierto.