--- title: "Importar ventas de saltos y sus envios desde Excel" url: "https://documentation.crioonline.com/es/article/importar-ventas-de-saltos-y-sus-envios-desde-excel" language: "es" last_updated: "2026-08-30T12:23:50.728Z" --- # Importar ventas de saltos y sus envios desde Excel Utilizando una plantilla de archivo de Excel, puede importar todos sus contratos de saltos/maquilas y registros de envío de semen.. ## Hoja `Contracts` (Ventas de saltos / Maquilas) La hoja `Contracts` es obligatoria. Los encabezados deben conservarse exactamente como aparecen a continuación. | Columna | ¿Dato obligatorio? | Descripción | | --- | --- | --- | | `VENTA_REF` | Condicional | Referencia interna del archivo para relacionar una venta con sus envíos. Es obligatoria y debe ser única si la hoja `Shipments` contiene registros. Si no hay envíos, la columna puede omitirse. Ejemplo: `V001`. | | `REPRODUCTOR_ID` | Condicional | ID interno del reproductor en CRIO. Es obligatorio si no se proporciona `REPRODUCTOR_NOMBRE`. Si vienen ambos campos, se utiliza el ID. | | `REPRODUCTOR_NOMBRE` | Condicional | Nombre del reproductor existente en CRIO. Es obligatorio si no se proporciona `REPRODUCTOR_ID`. | | `PROPIETARIO_NOMBRE` | Sí | Nombre del comprador o propietario del contrato. Se utiliza para buscar o crear el contacto. | | `PROP_CEDULA` | No | Número de identificación o documento del propietario. Se utiliza primero para buscar un contacto existente. | | `PROP_TELEFONO` | No | Teléfono principal del propietario. | | `PROP_CORREO` | No | Correo electrónico del propietario. | | `PROP_CIUDAD` | No | Ciudad y país del propietario. | | `PROP_DIRECCION` | No | Dirección del propietario. | | `FECHA` | Sí | Fecha de la venta o contrato de reproducción. | | `CONTRATO` | No | Número del contrato. Cuando existe, se utiliza para detectar ventas duplicadas. | | `FACTURA` | No | Número de factura relacionado con la venta. | | `MONEDA` | Condicional | Moneda configurada en CRIO. Si `MONTO` es mayor que cero y la moneda está vacía, se utiliza la moneda preferida de la cuenta. | | `MONTO` | No | Valor de la venta. Si es mayor que cero, se crea el asiento contable correspondiente. No puede ser negativo. | | `COMENTARIOS` | No | Observaciones adicionales sobre la venta. | | `YEGUA_NOMBRE` | No | Nombre de la yegua destinataria del semen. | | `YEGUA_ID` | No | Identificación o registro de la yegua. | | `YEGUA_MICROCHIP` | No | Número de microchip de la yegua. | | `YEGUA_INSEMINACION` | No | Fecha de inseminación de la yegua. | > Aunque algunos datos sean opcionales, todos los encabezados anteriores deben permanecer en la hoja `Contracts`, excepto `VENTA_REF` cuando no se importen envíos. ## Hoja `Shipments` (Envios o despachos de semen) La hoja `Shipments` es opcional. Puede contener varios envíos relacionados con una misma venta. | Columna | ¿Dato obligatorio? | Descripción | | --- | --- | --- | | `VENTA_REF` | Sí | Referencia de la venta definida en la hoja `Contracts`. Debe coincidir exactamente con una referencia válida de esa hoja. | | `FECHA_ENVIO` | Sí | Fecha en la que se realizó el envío. | | `REMITENTE` | No | Persona, empresa o establecimiento que envía el semen. | | `DESTINATARIO` | No | Persona, clínica o establecimiento que recibe el semen. | | `TELEFONO` | No | Teléfono de contacto del destinatario. | | `DIRECCION` | No | Dirección de entrega. | | `EMPRESA` | No | Empresa transportadora utilizada para el envío. | | `NUMERO_GUIA` | No | Número de guía o seguimiento del envío. | | `COMENTARIOS` | No | Observaciones adicionales sobre el envío. | > Si la hoja `Shipments` contiene registros, todos sus encabezados deben existir, aunque los campos opcionales se dejen vacíos. ## NOTAS Y REGLAS DE NEGOCIO 1. Los nombres de las hojas deben ser exactamente `Contracts` y `Shipments`. 2. La hoja `Contracts` es obligatoria. La hoja `Shipments` es opcional y puede omitirse. 3. Si `Shipments` no existe o no contiene registros, `VENTA_REF` no es obligatoria en `Contracts`. 4. Si `Shipments` contiene registros: 5. - Cada venta debe tener una `VENTA_REF`. - La referencia debe ser única dentro de `Contracts`. - Cada envío debe indicar una `VENTA_REF` existente. - Una venta puede tener varios envíos. 6. `REPRODUCTOR_ID` tiene prioridad sobre `REPRODUCTOR_NOMBRE`. 7. Si no viene el ID, el reproductor se busca por nombre dentro de la cuenta: 8. - Se ignoran mayúsculas, minúsculas, acentos y espacios repetidos. - Debe existir una única coincidencia. - El importador no crea reproductores automáticamente. - Si no existe o hay varios reproductores con el mismo nombre, la fila será rechazada. 9. El propietario se busca primero por `PROP_CEDULA` y luego por `PROPIETARIO_NOMBRE`. Si no existe, se crea como contacto y cliente. 10. Una venta se considera duplicada: 11. - Por `CONTRATO`, cuando tiene número de contrato. - Por propietario, reproductor y fecha cuando no tiene número de contrato. 12. Una venta existente no se crea nuevamente, pero puede utilizarse para asociar los envíos indicados en `Shipments`. 13. Todos los envíos importados: 14. - Se relacionan con la venta indicada por `VENTA_REF`. - Heredan el reproductor y el cliente de la venta. - Se crean con estado `Shipped`. - Se registran como semen no congelado y no consumen semen de un tanque. - No envían notificaciones por correo. 15. Cuando se importa un envío, la venta cambia a estado "Enviado" si se encontraba en estado inicial. 16. Los envíos duplicados se detectan por: 17. - Venta, fecha y número de guía; o - Venta, fecha, destinatario y dirección cuando no existe número de guía. 18. Los formatos de fecha admitidos incluyen fechas reales de Excel y formatos como `YYYY-MM-DD`, `DD/MM/YYYY` y `MM/DD/YYYY`. 19. Las filas válidas se importan y las filas con errores se reportan individualmente al finalizar el proceso.