entities

Entities identify the product that is being managed at the farm. Entities must be created before any field or journal transactions can be entered. Entities can be created manually or by posting from TPA movement’s schedule.  

The following items must be created prior to creating an Entity:

• Farm

• Products

• Breed

• Standards

• Feed Formulas

• Tech Advisor

• Tech Supervisor

The following procedures are outlined in the Entity document:

• Creating an Entity
• Viewing the Entity Master
• Options
• Menu Options
• Transaction Options

Create an Entity

The 'Add' Entities option is initially used to add the entity to the system. If entities are going in multiple houses, the first line with the farm level must be created. From there, house numbers can be entered to outline the multiple houses. Each following line will duplicate when creating a line from the same screen.

1. In TMTS>TIM>Master Data, select Entities.
2. In the Entities main index, click the button to create a new entity.
3. The New TIM Entities dialog box will appear to add a new entity.

4. From the Farm No drop-down menu, select the farm where the entity resides.

5. In the Entity No field, enter the code that identifies the entity. Entity no will default only if the Entity No Prefix is entered and the registry is set to one of the options discussed during the Entity No Prefix question. If the Entity No is set to manual, then the Entity No is manually entered.

6. House No is used If the granularity is defined in Houses. If so, a house number can be assigned to the entity from a predefined list of houses for the farm. The house can only be assigned after the top level entity is created.

7. Pen No is used if the granularity is defined at the pen level. If so, a pen can be assigned to the entity. The pen can only be assigned after the top level entity is created.

8. Stage represents the stage of the entity when it is being added to the system. The stage will default based on the stage of the selected farm. Available options are: Brood or Lay, or, for a multiple stage operation, Brood, Grow, or Lay.

9. Production System defines the house set-up of how the turkey will be grown. The number will be automatically generated.

10. From Product No, select the product that is assigned to the entity.

11. Formula Assignment No is used if FDSA is being utilized, and assigns the feed formulas to the entity. Formula assignment numbers must be set up previously in: General>General>Products>Feed>Feed Formulas. If applicable, select the formula number from the pre-defined list.

12. Breed No is an optional field to enter the breed code if breed tracking is utilized.

13. Standard No assigns the standard to the entity for reporting. Standard details can be viewed in the Master Data folder for the specific farm type. If applicable, select the standard.

14. From Tech Advisor No, select the technical advisor for the entity. Tech advisors must be set up previously in: Admin> Business> General> Definitions> Tech Advisors.

15. From Tech Supervisor No, select the technical supervisor for the entity. Tech supervisors must be set up previously in: Admin> Business> General> Definitions>T ech Supervisors.

16. Status indicates if the entity is active or inactive, and will default to Active. If the entity is no longer active, de-select the flag.

1. Active - entity is currently in production. Transactions can be entered.
2. Inactive - entity has been transferred or sold. Transactions can be entered but will affect the entity inventory and forcing it out of balance. The processing or transfer transactions with the final pickup flag will need to be unposted and posted to bring the entity back into balance. Costs can be entered to the entity while the entity is in this status.
3. Closed - field or journal transactions cannot be posted to the entity.

17. Select the Tpa Exclude Profile Flag if the TPA option is being used and the entity is to be excluded from projections.

18. In the Attachment field, any type of file can be attached. (Example: Word document, picture, music or video clip).

19. Attributes default from the house or farm with the option to modify when creating a new entity. Attributes can be created in: Admin>Business>General>Definitions>Attributes>Attribute Definitions. They can be assigned to the Farms and in Houses in the required tabs.   Examples of attributes include:

• Brooding Equipment/Brooding Equipment Description

• Roof/Roof Description

• Drinkers/Drinkers Description

• Farm/Farm Size

• Floor/Floor Description

• Feeders/Feeders Description

• Lighting/Lighting Description

• Cooling/Cooling Description

• Litters/Litters Description

• Ventilation/Ventilation Description

• Walls/Walls Descriptions
  

View the Entity Master

Once the entity has been created and saved, it can be viewed in the Entity Master. The fields in the Entity Master are read-only and cannot be modified, except when a new entity is being created. After the entities are created, the screen is read only. Entities can be created manually using the 'New' button or by posting from a BPA Movement Schedule. The data in the tabs are derived from other areas of the system. When changes are made in these areas below, it will update the Entities screen for each entity.

There are numerous tabs in the Entity Master.

• General
• Statistics
• Placement Detail
• Feed/Nutrients
• Field Service
• Condemn
• Costs
• Movement Details
• Inventory Details
• Health Status

General

The General tab contains the basic details for the entity. If a flock is manually created, the date fields in the General tab can be entered manually or modified.

1. In the Entities main index, select the entity to be viewed and double-click to open and view the entity. Alternatively, click the button, or right-click and select 'Edit'.
2. Click on the General tab.

3. Depending on the Date Placed Mode established in the PMTS registry, First Date Placed will either represent the weighted average date placed or the first date placed from the placement transaction.

4. If a flock has multiple dates placed, Avg Date Placed will calculate all of the placement dates and display the average date. The field will be populated when a flock is received via Poult Receivings or in HIM Breeder Placements or Poult Placements.

5. Date Sold indicates the sold date for the entity. The date will represent the processing transaction where the final pickup flag is selected.

6. If a flock has multiple sold dates, Date Sold Avg will calculate all of the sold dates and display the average date. The field will be populated when a flock is sold via a Processing Transaction.

7. First Date Sold indicates the first date that the entity was sold.

8. First Date Moved In indicates the first date in which the entity was moved in.

9. Last Date Moved In indicates the last date in which the entity was moved in.

10. Avg Date Moved In indicates the average date in which the entity was moved in.

11. First Date Moved Out indicates the first date the turkeys were moved out of the house. The date is established based on the date of the first transfer out.

12. Last Date Moved Out indicates the last date the turkeys were moved out of the house. The date is established based on the date of the first transfer out.

13. Avg Date Moved Out indicates the average date the turkeys were moved out of the house. The date is established based on the date of the first transfer out.

14. Hatch Date indicates the hatch date of the entity as defined on the initial placement transaction.

15. Stage indicates the stage of the flock. Chicken entities will only have a Grow stage. Turkey entities will have a Brood or Grow stage.

16. Grower Rank represents the grower's performance as compared to other growers that were processed during the same time frame.

17. Grower Percentile represents the grower's standing for this flock among all other flocks that were processed during the same time period.

18. Ranking Group Std Cost Avg represents the average total cost to produce a flock based on a group of flocks that were processed during the same time period.

19. Standard No displays the entity's standard number, which is used for reporting.  

20. Product No identifies the product within the system (alphanumeric, max 20 characters).

21. Product Name displays the name of the product.

22. Breed No displays the breed code assigned to the entity at placement, if breed tracking is utilized.
23. Days Out displays the number of days between the First Date Placed and the Last Date Sold of the previous flock.
24. Formula Assignment No is used if FDSA is being utilized, and assigns the feed formulas to the entity. Formula assignment numbers must be set up previously in: General>General>Products>Feed>Feed Formulas. If applicable, select the formula number from the pre-defined list.
25. Formula Assignment Name defaults and displays the name of the formula assignment.

26. Tech Supervisor No identifies the technical supervisor for the entity.

27. Tech Advisor No identifies the technical advisor for the entity.

28. The TPA Exclude Profile Flag will be selected if the TPA option is being used and the entity is to be excluded from projections.

29. Ranking Group Flock Count displays the number of flocks included in the group where the flock ranking is determined. For example, if the number was 100 and the flock ranking is 35, the flock is ranked 35 in the group of 100.

30. Ranking Status indicates if the entity will be included in ranking statistics. Available options are: In-Ranking (included in statics) or Out-Raking (excluded from statistics). Settlements does  the ranking and posts the information back to the Ranking fields.

31. Status indicates if the entity is Active, In-active, or Closed.

32. In the Attachment field, any type of file can be attached. (Example: Word document, picture, music or video clip).

33. Enter any additional Notes relating to the Entity.

Statistics

The Statistics tab represents the data from the Processing Transactions.

1. Age indicates the age of the entity.
2. Average Age Transfer Out indicates the average age at the time of transfer.
3. Avg Weight indicates the average weight of a single turkey at the farm.
4. Average Weight Transfer Out indicates the average weight of a single turkey at the time of transfer.
5. Caloric Conversion After is a calculated field representing: Nutrient Energy/Weight After Condemn.
6. Caloric Conversion Before is a calculated field representing: Nutrient Energy/Weight Before Condemn.
7. Condemn is a calculated field using condemnation weight or head, and is based on the registry switch 'Percent Condemn Mode'.
8. Farm Head displays the number of turkeys being transferred from the farm.
9. Farm Weight displays the total weight of turkeys being transferred from the farm.
10. Feed Conversion Before  is a calculated field representing: Feed Consumed/Weight Before Condemn.
11. Feed Conversion After is a calculated field representing: Feed Consumed/Weight After Condemn.
12. Feed Conversion Transfer Out is a calculated field representing: Feed Consumed/Average Weight Transfer Out.
13. Percent Mortality is a calculated field representing: (Mortality/Head Placed) *100
14. Plant Head displays the number of turkeys that arrived at the plant.
15. Inventory displays the number of turkeys in inventory.
16. Plant Weight displays the total weight of turkeys being that arrived at the farm.
17. Weight Gain/Day is a calculated field representing: Avg Weight/Avg Age.
18. Average Weight Gain/Day Transfer Out is a calculated field representing: Avg Weight/Average Age Transfer Out.
19. Percent Mortality Diff is a calculated field representing: ((Head Placed - Head Sold) / Head Placed) *100
20. Placement Density is a calculated field representing: Head Placed / Area.
21. Processing Density is a calculated field representing: Weight Sold / Area.
22. Percent Livability is a calculated field representing: Basis Head Count / Head Placed.
23. EPEF is a calculated field representing: ((Avg Weight * % Livability) / FCR Before * Avg Age)) * 100.
24. Head Placed indicates the number of head placed for the entity.
25. Head Transferred In indicates the number of turkeys transferred in from another farm or entity.
26. Head Transferred Out indicates the number of turkeys transferred out to another farm or entity.
27. Head Culled displays the number of turkeys killed.
28. Percent Head Culled displays the percentage of total turkeys killed.
29. Feed Delivered Internal displays the total amount of internal feed delivered.
30. Feed Transferred In displays the total amount of feed transferred in.
31. Feed Transferred Out displays the total amount of feed transferred out.
32. Feed Purchased displays the total amount of feed purchased.
33. Feed Consumed displays the total amount of feed consumed.

34. Farm Condemnation Head indicates the number of turkeys that were condemned at the farm.
35. Farm Condemnation Weight indicates the weight of the turkeys that were condemned at the farm.
36. Plant Condemnation Head indicates the number of turkeys that were condemned at the plant.
37. Plant Condemnation Weight indicates the weight of the turkeys that were condemned at the plant.
38. DOA Head displays the total number of turkeys dead on arrival (DOA).
39. DOA Weight displays the total weight of the turkeys that were dead on arrival.
40. DOA Percent displays the total percentage of turkeys that were dead on arrival.

Placement Detail

The Placement Detail tab contains the details of the number of poults placed from each donor source or parent, and is derived from the purchase order (if defined) or internal placements (HIM Breeder/Poult Placements).

1. Date Placed indicates the date that poults were placed at the house.
2. Hatchery No indicates the hatchery where the poults were placed.
3. Hatchery Name displays the name of the hatchery.
4. Hatcher No is an optional field and defines the hatcher number.
5. Setter No is an optional field and defines the setter number.
6. House No displays the number of the house assigned to the entity, if applicable.
7. Pen No displays the pen code, if applicable.
8. Breed No displays the breed code, if applicable.
9. Breed Name displays the name of the breed.
10. Parent Flock No displays the number of the parent flock.
11. Head Placed indicates the number of poults placed at the house.
12. Product No displays the number of the product to which the turkeys are assigned, and is used for identification purposes. Products are defined in: General>General>Products>Animals>Poultry.
13. Product Name displays the name of the product...
14. Sex indicates the sex of the product.

Placements By Parent Flocks

The Placements By Parent Flock tab contains a chart with information outlining how many poults were placed from a particular parent or donor source.

Placements By Date

The Placements By Date tab contains a chart with information outlining how many turkeys were placed by date if the flock had multiple hatch or placement dates.

Feed/Nutrients

The information in the Feed/Nutrients tab is derived from General>General>Products>Feed>Feed Formulas if FMIM is not being used. Otherwise, the data is derived from FMIM>Feed Formulas

1. Name displays the name of the feed or nutrient.
2. Feed Record Type describes the type of feed record of the transaction. Each time a transaction occurs regarding feed and is posted to the journal transactions, it  is represented here.
3. The Week fields indicates the week ending date that represents the transactions that occur during this time period.
4. Total Amount is the accumulated totals for all of the weeks.

Field Service

The Field Service tab is used to view all of the BRIM transactions related to the entity. The data is derived from the Field Transaction.

1. End Date displays the week ending date.
2. Age indicates the age of the entity.
3. Culls displays the number of birds that were culled.
4. Feed Consumed indicates the amount of feed consumed.
5. Head Inventory displays the number of birds in inventory.
6. Mortality displays the total mortality rate for the birds.
7. Mortality % indicates the percentage of birds that died.
8. Weight displays the total weight of the birds.
9. Uniformity indicates the weight consistency of the birds.
10. Placement Mortality represents the chick mortality at placement.
11. Cull % displays the percentage of birds that were culled.

Condemn

The information in the Condemn tab is derived from Transactions>Condemnations. When a flock has been sent to the processing plant, it records the bird parts and weights. These condemn categories will need to be set up before entering condemnations, in: Admin>Business>Poultry>Definitions>Condemnation.

• Parts Condemns - Relates to the processing of the turkeys and refers to when the turkey is processed in parts (Example: Breast, thighs, wings, etc.).
• Whole Bird Condemnations - Relates to the processing of the turkeys and refers to when the whole turkey is processed as one.

Parts Condemns

1. Calculation Category displays the parts condemnations counts at the farm or at the plant.
2. Part Description displays a description of the part being processed (Example: Breast, thigh, wing).
3. Whole Bird displays the condemnation category. Whole bird condemn categories can be set up in: Admin>Business>Poultry>Definitions>Condemnation>Whole Bird Categories. The values entered in those fields in the condemn transactions will transfer to the entity master.
4. Weight displays the weight of each part condemnation.

Whole Birds Condemnations

1. Calculation Category displays the whole turkey condemnations counts at the farm or at the plant.
2. Condemn Description displays the type of cull (Example: Contaminated, Jaundice, Joint Lesions).
3. Head displays the number of turkeys being processed through the plant on a single load or shipment.
4. Weight displays the weight of each whole turkey condemnation.
5. Percent displays the percentage of the description of the total weight.

Costs

The Costs tab represents all of the costs associated with the flock and is broken down by the accounts set-up in the Chart of Accounts Master. Costs are derived from the journal transactions.

1. Account Name displays the name of the account holder.
2. Complex Account No displays the complex account number.
3. Location Group No displays the number of the location group.
4. Stage No displays the stage number and is derived from the entity stage of the flock.
5. Cost Object No displays the cost object number.
6. Cost Element No displays the cost element number.
7. User Account No displays the number of the user account.

8. The Week fields are derived from the journal transactions as the week ending on the date the transactions took place.
9. Total Cost is a calculated field for the total cost for the entity.
10. Total Cost Per Unit displays the total cost of each unit.

Movement Details

The information in the Movement Details tab is derived from Movements>Transfers and defines the source placement and the destination where it was moved.

1. Transfer Date displays the date that the transfer took place.
2. Dest Complex Entity No displays the destination complex entity number and is used to define the destination entity – the farm/house receiving the birds.
3. Dest Farm Name displays the name of the farm where the birds were received.
4. Ref No displays a unique reference number used to identify the transfer.
5. Sex displays the sex of the birds.
6. Head Count displays the number of birds that were moved in the destination entity and the number of birds moved out of the source entity.

Inventory Details

The Inventory Details tab displays the inventory and the transactions associated with the inventory. The information in the Inventory tab is derived from Field Transactions.

1. Complex Entity No displays the number of the entity.
2. Event Type indicates where the transaction originated from.
3. Sex displays the sex of the birds.
4. Head Count displays the number of birds involved in a particular transaction. For example, in a Field Transaction for Mortality, 10 birds died, so the 10 birds will be the "head count". These numbers will include mortality and culls, birds placed, birds moved, etc. Anything that will add or subtract from the beginning inventory needs to be included in the head count.
5. Inventory Date displays the date that is the week's ending date.
6. The Entity History flag will be selected if the transfer was set to include the entity history in the transfer transaction. All costs will then be passed along to the destination entity.

Health Status

The Health Status tab represents the most recent health status transactions based on the Lab Test transaction and/Entity Status transaction. The Entity Status transaction will always override the lab test transaction for the same test code.

*Note: The Health Status tab is only used in version 7.26 and up.

1. Complex Entity No identifies the entity for the health status transaction.
2. Record Type identifies the type of record.
3. Health Status displays a description of the animals` health and will be either Positive or Negative.
4. Trans Date displays the date of the health status transaction.
5. Ref No is a unique reference number used to identify the health status transaction.
6. Analysis No identifies the analysis code for the lab test.
7. Analysis Name displays a description of the analysis.
8. Placement Control Status is a read-only field that represents the placement status of the swine.
9. Transfer Control Status is a read-only field that represents the transfer status of the swine. This will default to `Not Tracked`.  Available options are:
1. Tracked - will have no impact on the transfer, but will be displayed in Health Status views.
2. Transfer to Same Status - source entities can be transferred to a destination entity with the same status for the lab test code.
3. No Transfer - entities cannot be transferred.
4. Not Tracked - health status is not tracked in the Health Status view. All entities can be transferred.
10. Processing Control Status is a read-only field that represents the processing status of the swine. This will default to `Not Tracked`. Available options are:
1. Tracked - will have no impact on process planning, but will be displayed in Health Status views.
2. End of Day - BRPA/TPA/SPA/GPA will schedule the entities to be killed at the end of the day. LHS will schedule picks ups at the end of the scheduled processing day.  
3. End of Week - BRPA/TPA/SPA/GPA will schedule the entities to be killed at the end of the week. LHS will schedule picks ups at the end of the scheduled processing day.
4. Not Tracked - will not be displayed in Health Status views and will have no impact on processing planning.
11. The Comments field contains any additional information related to the transaction.

Options

There are several options available from the menu bar as well as the transaction screen.

Menu Options

• Add/Change Entities
• Complex Entity Number Change
• Transfer Cost Mode
• Data Mode
• Date Granularity
• Week Ending Date Alignment
• Entity Inventory Builder
• Print Barcodes
• Entity Rebuild Inventory
• Change House No
• Change Status

Add/Change Entities

This option is used to add a new house/pen or modify an existing entity.

1. Select any record for the entity that is to be added or modified
2. Right-click and select Add/Change Entities or select Options>Add/Change Entities
3. Click to add a new house record or select the line that is to be edited.
4. The details will default from the previous record for new houses.
5. The Farm No cannot be modified in this screen. Use the Complex Entity Number Change option to modify the Farm No.
6. The Entity No cannot be modified in this screen. Use the Complex Entity Number Change option to modify the Entity No.
7. If the granularity if defined as FFH or FFHP, enter the House No and/or Pen No for new records. Existing records cannot be modified. Use the Complex Entity Number Change option to modify the Entity No.
8. Modify all other fields as required. Details are outlined in Create New Entity

Complex Entity Number Change

1. Select the FF record for the entity to be modified.
2. Select Options>Complex Entity Number Change.
3. Select the Farm No.
4. Enter the Entity No. Note that all houses and pens must exist in the source and destination farm for the option to be used.
5. Click OK to modify the complex entity number.

Transfer Cost Mode

This option determines what costs are included where displaying the data in Entities>Costs. The options available are indicated below. The selection will save to the user profile until the option is modified again.

Data Mode

The Data Mode determines the data that is displayed for the entity. The options available are indicated below. The selection will save to the user profile until the option is modified again.

Date Granularity

This option indicates the date parameters on how the data is displayed in the tabs. The options available are indicated below. The selection will save to the user profile until the option is modified again. Options are:

Week Ending Date Alignment

If the option in Date Granularity is set to Weekly, the data will be displayed with the week ending date as one of the following options. The options available are indicated below. The selection will save to the user profile until the option is modified again.

Entity Inventory Builder

This option is only used when initially creating the entity in a new implementation. The process defines the base data for the entity for the required stages. Brood entities will only require brood data. Grow entities are only used in multi-stage operations and must have brood and grow data defined. The entities must be created prior to being selected in the Entity Inventory Builder.

Brood (multi-stage only)

1. Select Options>Entity Inventory Builder.
2. Select the Hatchery No for the hatchery that the entity was hatched.
3. Select the Brood Entity No.
4. Select the Sex. Options available are Female, Male or Straight Run.
5. Enter the Date Placed.
6. Enter the Head Placed.

Grow

1. Select Options>Entity Inventory Builder.
2. Select the Hatchery No for the hatchery that the entity was hatched.
3. Select the Brood Entity No.
4. Select the Sex. Options available are Female, Male or Straight Run.
5. Enter the Date Placed.
6. Enter the Head Placed.
7. In the Grow Date Moved, enter the date that the entity was moved from Brood to Grow.
8. Select the Grow Entity No.
9. Enter the number of birds moved from brood to grow in Grow Head Moved.

Print Barcodes

This option will print the barcodes for the entities filtered in the selection dialog. The custom barcode report must be created prior to using this option.

1. Select Options>Print Barcodes
2. Select the Custom Report Layout.
3. If printing the codes for specific entities, click the drop-down in Complex Entity No and select the required entities.
4. If printing barcodes for all entities, select the Farm Type of the barcodes to be printed.
5. Select the Granularity for the barcodes. Options will be Entity, House or Pen.
6. Click OK to print the barcodes based on the specified filters.

Entity Rebuild Inventory

This option should be used when the bird inventory does not appear to be correct. This generally happens with converted data but can also be from data issues where the transactions are entered out of order.

1. Filter the data for the entities that need to be rebuilt.
2. Select all of the entities.
3. Select Options>Entity Rebuild Inventory.
4. Click OK to continue the rebuild or Cancel to stop the process.
5. When the rebuild is complete, verify that the entity data is correct.

Change House No

The Change House No option is used to move the birds from one house to another house within the same entity.

1. Select the FFH record to have the house number changed.
2. The user will be prompted to confirm that the change will modify all FFH and FFHP records for the selected house. Click Yes to continue or No to cancel.
3. In the dialog, select the New House No.
4. Click OK to change the house number for the selected entity.

Change Status

The Change Status option allows the user to change the status of the entity without having to used the Add/Change Entities option. Note that all granularity levels must be changed. Changing the FF to a different status does not modify FFH or FFHP to the same status.

1. Select the entities that are to have the status changed.
2. Right-click and select Change Status.
3. Select the required option:

Transaction Options

1. Placements - loads HIM Breeder Placements
2. Feed - loads TIM Feed Deliveries related to the Entity
3. Field Services - loads Field transactions related to the Entity
4. Condemns - loads Entity Condemnations
5. Journals - loads all journals related to the Entity
6. Processing - loads the Processing transaction