Import Breeding Contracts and Shipments from an EXCEL file
Contracts Sheet
The Contracts sheet is required. Column headers must remain exactly as shown below.
| Column | Required value? | Description |
|---|---|---|
| Conditional | Workbook reference used to connect a sale with its shipments. It is required and must be unique when the |
| Conditional | Internal CRIO stallion ID. Required when |
| Conditional | Name of an existing stallion in CRIO. Required when |
| Yes | Name of the contract buyer or owner. It is used to find or create the contact. |
| No | Owner identification or document number. It is used first when searching for an existing contact. |
| No | Owner’s primary telephone number. |
| No | Owner’s email address. |
| No | Owner’s city and country. |
| No | Owner’s address. |
| Yes | Date of the breeding sale or contract. |
| No | Contract number. When provided, it is used to detect duplicate sales. |
| No | Invoice number associated with the sale. |
| Conditional | Currency configured in CRIO. When |
| No | Sale amount. When greater than zero, the corresponding accounting entry is created. It cannot be negative. |
| No | Additional comments about the sale. |
| No | Name of the mare receiving the semen. |
| No | Mare identification or registration number. |
| No | Mare microchip number. |
| No | Mare insemination date. |
Even when some values are optional, all headers listed above must remain in the
Contractssheet, exceptSALE_REFwhen no shipments are being imported.
Shipments Sheet
The Shipments sheet is optional. It may contain multiple shipments associated with the same sale.
| Column | Required value? | Description |
|---|---|---|
| Yes | Sale reference defined in the |
| Yes | Date on which the shipment was made. |
| No | Person, company, or facility sending the semen. |
| No | Person, clinic, or facility receiving the semen. |
| No | Recipient’s contact telephone number. |
| No | Delivery address. |
| No | Shipping or courier company used for the shipment. |
| No | Shipment tracking number. |
| No | Additional comments about the shipment. |
When the
Shipmentssheet contains records, all its headers must exist, even when optional values are left blank.
NOTES AND BUSINESS RULES
- Sheet names must be exactly
ContractsandShipments. - The
Contractssheet is required. TheShipmentssheet is optional and may be omitted. - If
Shipmentsdoes not exist or contains no records,SALE_REFcolumn is not required inContracts. - If
Shipmentscontains records: - Every sale/contract must have a
SALE_REF. - Each reference must be unique within
Contracts. - Every shipment must contain an existing
SALE_REF. - One sale may have multiple shipments.
- Every sale/contract must have a
STALLION_IDtakes precedence overSTALLION_NAME.- When the ID is not provided, the stallion is matched by name within your the account:
- Matching ignores capitalization, accents, and repeated spaces.
- There must be exactly one match.
- The importer does not automatically create stallions.
- If no stallion is found or multiple stallions share the same name, the row is rejected.
- The owner is matched first by
OWNER_IDand then byOWNER_NAME. If no contact exists, a new contact of type customer is created. - A sale/contract is considered a duplicate:
- By
CONTRACTwhen a contract number is provided. - By owner, stallion, and date when no contract number is provided.
- By
- An existing sale is not created again, but it may still be used to associate shipments listed in
Shipments. - Every imported shipment:
- Is connected to the sale identified by
SALE_REF. - Inherits the stallion and customer from the sale.
- Is created with
Shippedstatus. - Is recorded as non-frozen semen, thus it does not consume semen from a tank.
- Does not send email notifications.
- Is connected to the sale identified by
- When a shipment is imported, a sale in its initial state is changed to shipped status.
- Duplicate shipments are detected using:
- Sale, shipment date, and tracking number; or
- Sale, shipment date, recipient, and address when no tracking number is provided.
- Accepted date formats include native Excel dates and formats such as
YYYY-MM-DD,DD/MM/YYYY, andMM/DD/YYYY. - Valid rows are imported, while invalid rows are reported individually when the import finishes.