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:
    • 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.
  5. REPRODUCTOR_ID tiene prioridad sobre REPRODUCTOR_NOMBRE.
  6. Si no viene el ID, el reproductor se busca por nombre dentro de la cuenta:
    • 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.
  7. El propietario se busca primero por PROP_CEDULA y luego por PROPIETARIO_NOMBRE. Si no existe, se crea como contacto y cliente.
  8. Una venta se considera duplicada:
    • Por CONTRATO, cuando tiene número de contrato.
    • Por propietario, reproductor y fecha cuando no tiene número de contrato.
  9. Una venta existente no se crea nuevamente, pero puede utilizarse para asociar los envíos indicados en Shipments.
  10. Todos los envíos importados:
    • 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.
  11. Cuando se importa un envío, la venta cambia a estado "Enviado" si se encontraba en estado inicial.
  12. Los envíos duplicados se detectan por:
    • Venta, fecha y número de guía; o
    • Venta, fecha, destinatario y dirección cuando no existe número de guía.
  13. Los formatos de fecha admitidos incluyen fechas reales de Excel y formatos como YYYY-MM-DD, DD/MM/YYYY y MM/DD/YYYY.
  14. Las filas válidas se importan y las filas con errores se reportan individualmente al finalizar el proceso.