Skip to content
D
Documentation

Contacts, L/Gs, and Last Modifications on a sales job

reference
12 min readUpdated

Contacts, L/Gs, and Last Modifications on a sales job

A saved sales job has related-work surfaces beside its main record. Use Contacts to associate people with the job, LGs to review or request job-related letters of guarantee, and Last Modifications to review recorded changes to the job.

In this chapter, L/G means letter of guarantee. A contact is a person associated with the saved sales job.

If you need to…Go to
Associate a person with the saved jobAssociate a contact with the sales job
Review or request a job-related letter of guaranteeReview or request a job-related L/G
Review who changed the job and what changedReview recorded job changes
Understand why a tab or action is unavailableHandle availability and stage branches
Match a displayed message to a recovery actionWhen a related-work action goes wrong

These surfaces remain companion work beside the saved sales-job record. The record itself remains the parent surface.

Before you start

Each related-work surface depends on a saved sales job and on the access and subscription conditions in the table below. A principal user cannot use Contacts, LGs, or Last Modifications.

SurfaceWhat must be in place
ContactsA saved job, the Contacts subscription, a selected account with a PrimaryID, and the Contacts tab selected.
LGs listA saved job with Job.Id, the Letter of Guarantee subscription, the LGs tab selected, and the list access for that tab.
Last ModificationsThe Last Modifications tab selected and the Latest Modifications subscription.
All threeA non-principal user.
Work informationThe contact, guarantee request, or changed field that must remain connected to the job's client and vendor work.

Open a saved sales job

A saved sales job is the record that holds the related-work tabs for contacts, letters of guarantee, and recorded changes.

Prerequisites

  • You know the saved sales job to open.

Steps

  1. Open the saved sales-job record.
  2. Select the related-work tab that matches the work you need: Contacts, LGs, or Last Modifications.
The saved sales-job record with the related-work tabs visible

Result: The saved sales-job record is open with Comments, Tasks, Activities, Attachment, Contacts, LGs, and Last Modifications available as record tabs when their conditions are met.

With the record open, read the related-work surface before starting an action.

The related-work surface keeps people, guarantees, and change history beside the saved job without replacing the main record.

TabUse it forWhat you can see or open
ContactsAssociate people with the job.The contact grid can show Title, Name, Position, Department, Account, and Branch.
LGsReview or request job-related letters of guarantee.The list is organized by L/G status; selecting an L/G row opens the separate sales edit record.
Last ModificationsReview the job audit log.An entry shows its action date, user name, and action summary; an expanded edit shows the field, old value, and new value.

The Contacts surface appears only when the Contacts subscription, selected account, account PrimaryID, and Contacts tab state are present. The LGs list also needs Job.Id, the Letter of Guarantee subscription, and active access to the LGs tab. An L/G detail surface needs a loaded guarantee with an ID. Last Modifications needs its subscription and selected tab state.

Use the column headers and row values that appear in your own list. Select the related-work tab you need to view its entries.

When you know which surface contains the work, follow the matching procedure below, starting with Associate a contact with the sales job.

Associate a contact with the sales job

A contact is a person associated with the saved job so the job carries the people connected to its work. Use the contact grid as the job's association surface.

Prerequisites

  • The sales job is saved and the Contacts tab is available.
  • You are working in the same branch as the contact when the action requires it.
  • Your account permits the relevant new-contact or deletion action.

Steps

  1. In the contact selection area, select the existing contact to associate with the sales job.

  2. Choose the contact action that matches your situation.

    If you need to…Action
    Start the new-contact flow when the contact does not existEnter its text in the contact selection area.
    Remove the association when permittedSelect the contact's icon-only delete action.
    Continue when the contact flow opens a new recordContinue in [Create a contact] as the separate contact-creation task.

The New control starts the new-person flow when the Contacts subscription and allowedtoNew permit it. Export exports the contact list. Select the contact's delete action when you need to remove that association from this job.

Result: The contact list refreshes after each permitted association change, and the job shows the current contact association.

After the contact list refreshes, continue with Review or request a job-related L/G if you need guarantee work.

Use the L/G work area to find a request, open a row for the separate sales edit record, or start a new request when the job and your permission allow it.

Prerequisites

  • The sales job is saved with Job.Id.
  • The Letter of Guarantee subscription is available to your account.
  • You are not a principal user and the L/G action is allowed for the job's branch.

Steps

  1. On the LGs tab, select the status view that matches the request.

    If you need to review…Select
    Every listed L/GAll
    A draft requestDraft
    A request awaiting approvalAwaiting Approval
    An approved guaranteeApproved
    An active guaranteeActive
    A guarantee due for returnDue for Return
    An expired guaranteeExpired
    A cancelled guaranteeCancelled
    A liquidated guaranteeLiquidated
    A returned guaranteeReturned
    A closed guaranteeClosed
  2. Select an L/G row to open its separate sales edit record.

  3. To request a new L/G, select the add action on the LGs tab when the current tab, same branch, subscription, record context, and allowedtoNewLetterOfGuarantee permission allow it.

  4. In the L/G popup, complete the request fields shown for your configuration:

    FieldRequirement or choices
    Expiry DateRequired.
    On Behalf ofConfiguration-dependent selection.
    LG TypeBid bond, Down payment guaranty, Performance bond, or Warranty bond.
    RequestedAmountConfiguration-dependent number.
    IsExtendableDeclared as not required.
    CurrentAmountConfiguration-dependent number.
    Confirmation Of The LG RequirementRequired; choose Yes or No.
    CommentRequired.
    Confirmation Of The Financial ViabilityRequired; choose Yes or No.
  5. Select Request to submit the request.

  6. In an L/G detail record, select the action that matches the current L/G stage and your permission.

    If you need to…Select
    Save the current detail recordSave
    Save the detail record and leave itSave and Close
    Request approvalRequest approval

Result: A saved request refreshes the L/G list and closes the L/G popup.

After the L/G list refreshes, continue with Review recorded job changes if you need to inspect the job history.

Review recorded job changes

Last Modifications is the job audit log. It lets you narrow recorded changes by user or field and inspect the before-and-after values of an edit.

Prerequisites

  • The saved sales job has the Latest Modifications subscription.
  • You are not a principal user.

Steps

  1. Select Last Modifications on the saved sales-job record.
  2. In ActionUsers, select a user to narrow the entries to that user's actions.
  3. In Fields, select a field to narrow the entries to that field's changes.
  4. Expand an audit entry to read its field, old value, and new value.
  5. Select Refresh to reload the entries.

Each entry supplies an action date, user name, and action summary.

Result: The history shows the entries that match the selected user and field filters, and refreshed entries are available after Refresh.

If a tab or action is missing while you review the history, check Handle availability and stage branches.

Handle availability and stage branches

The saved-job tabs and their actions are conditional. Use the condition that matches the missing surface before treating it as a problem.

What is unavailableCondition that controls it
ContactsThe Contacts subscription, selected account, account PrimaryID, and Contacts tab state are required. Principal users cannot use it.
LGsThe Letter of Guarantee subscription, Job.Id, the LGs tab state, and active access to that tab are required. Principal users cannot use it.
Last ModificationsThe Latest Modifications subscription and Last Modifications tab state are required. Principal users cannot use it.
L/G detail tabs such as Comments, Attachment, LG Extensions, LG Deductions, LG Increase, and Last ModificationsA loaded guarantee with an ID is required.
New contact actionallowedtoNew and the Contacts subscription are required.
Contact association deletionA non-empty list, selected layout, same branch, the Contacts subscription, and allowedtoDelete are required.
New L/G requestSame-branch access and allowedtoNewLetterOfGuarantee, together with the L/G list conditions, are required.
L/G list viewsThe L/G subscription and current tab state control the views.

ActionTypes is not a reader control because its guard is permanently false. Use the column headers and row values visible in your own related-work lists.

After checking the conditions, use When a related-work action goes wrong for a displayed recovery message.

Use the message on screen to identify the input or stage condition that stopped the action. The available recovery is limited to the correction stated in the message.

MessageWhat to do
Forbidden characters detected. Please remove them and try again.Remove the forbidden characters from the contact text and submit it again.
You already have a contact with this nameUse the existing contact instead of creating a duplicate.
Please Add Extension to activate the LGAdd the required extension before activating the L/G.
LG has one or more extensions or deductions and cannot be reverted to the requested stageDo not revert the L/G to that stage while its extensions or deductions remain.
LG still needs confirmationComplete the required confirmation before continuing.
Please choose a date after the current expiry dateChoose a date after the current expiry date.
There is a pending increase you can editEdit the pending increase instead of starting another increase.

The following messages can also appear while related sales-job work is being processed. Read the message, then take the corresponding action before continuing.

MessageWhat to do
Custom fields saved successfullyContinue after confirming that the custom fields are saved.
Job updated successfullyContinue after confirming that the job is updated.
Job deleted successfullyReturn to the appropriate list after confirming that the job is deleted.
Job regretted successfullyContinue from the regretted-job result.
Job cancelled successfullyContinue from the cancelled-job result.
Job missed successfullyContinue from the missed-job result.
Job reactivated successfullyContinue working with the reactivated job.
Converted to offer successfullyContinue with the offer work for the job.
Converted to inquiry successfullyContinue with the inquiry work for the job.
Converted To RegrettedContinue from the regretted result.
Converted to cancelledContinue from the cancelled result.
Converted to lostContinue from the lost result.
An error occurred while processing your requestReview the current action and its fields, then repeat it.
Error saving custom fieldsReview the custom fields, correct them, and save again.
Cannot be un-delivered — a due invoice already existsReview the due invoice before changing the delivery state.
All offers must be in draft status to revert to inquiryReturn every offer to Draft, then repeat the reversion.
Error {{errorMsg}}Read the displayed error detail and correct the named problem.
An account with this name already existsUse the existing account instead of creating another one.
A project with this name already existsUse the existing project instead of creating another one.
Check mandatory field(s)Complete the mandatory fields.
Please save opened inquiry firstSave the opened inquiry before continuing.
All inquiries must be in draft stage to revert to potentialReturn every inquiry to Draft, then repeat the reversion.
One or more items has ZERO quantityEnter a quantity greater than zero for each item.
One or more items has no unitSelect a unit for each item.
Please enter action for each milstone Enter an action for each milestone.
Please save opened cost sheet firstSave the opened cost sheet before continuing.
There is a maximum discount that exceeds the negotiation margin.Reduce the discount so it does not exceed the negotiation margin.
The gross profit margin is unacceptable, and the release prices have been stopped.Review the gross profit margin and release prices before continuing.
Your request was completed successfullyContinue after confirming that the request is complete.
Error: Vendor not saved yetSave the vendor before continuing.
Error: Client not saved yetSave the client before continuing.
This Field Is RequiredComplete the field.
Just '_'‘-''.' And '&' Characters AcceptedRemove characters outside the accepted set.
Sales order is archivedOpen the active sales order before continuing.
Booked quantity for this job is greater than the required BOM quantityReduce the booked quantity to the required quantity or less.
You cannot edit or delete the product after the purchase package is createdUse the existing product without editing or deleting it.
Cannot be deleted. Product is in purchasingLeave the product in place while it is in purchasing.
You cannot edit the product after the PO is createdLeave the product in place after the purchase order is created.
This product is already included in BOMUse the existing BOM item instead of adding it again.
The first variant cannot be deletedKeep the first variant and choose another permitted action.
An error occurred while connecting to your CRM system.Check the CRM connection before repeating the action.
Please select one productSelect one product, then continue.
Package must have at least one itemAdd at least one item to the package.
You cannot save without adding at least one productAdd at least one product before saving.
One of products has no quantityEnter a quantity for every product.
This record is related to saved data and cannot be deletedKeep the record and continue without deleting it.
Action not allowedChoose an action available for the current record.
Check validationCorrect the validation errors.
No remaining items. All items have been selectedContinue with the selected items.
This action is only allowed if you belong to that branchUse an account that belongs to the record's branch.
Please enter at least one emailEnter at least one email address.
Inquiry must have at least one itemAdd at least one item to the inquiry.
Offer must have at least one itemAdd at least one item to the offer.
Order must have at least one itemAdd at least one item to the order.
Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deletedKeep items in either of those states.
Please select one or more items to create a RFQ.Select one or more items before creating the RFQ.
You don’t have permissionAsk an administrator for the required permission.
Error loading accountsRefresh the account list and select an available account.
Serial you have entered already exist and belong to same manufacturerEnter a different serial or review the existing manufacturer.
There is error in serial you have enteredCorrect the serial and submit it again.
Minimum: At least one serialEnter at least one serial.
One topic and at least one note is requiredEnter a topic and at least one note.
There is no topic to printAdd a topic before printing.
Required Receiving DateEnter the receiving date.
Invalid input. The value must be greater than 0 and cannot exceed 999,999.00Enter a value between the stated limits.
Invalid input. Please enter a non-negative valueEnter zero or a positive value.
Required Receiving AfterEnter the receiving-after value.
Required Offer TypeSelect an offer type.
Required Bid Due DateEnter the bid due date.

Backend validation and persistence are outside this page's supported recovery boundaries.

After applying a listed correction, return to the saved sales job to continue its main work.

Continue with the saved sales job

The saved sales-job record remains the parent surface after related work. Contacts, LGs, and Last Modifications are tabs on that record for related work, while an L/G row opens the separate sales edit record.

Return to the saved job to continue its main work after reviewing contacts, L/Gs, or recorded changes. The broader contact record is covered by the Contacts overview page. New-contact work is covered by the Create a contact page. The complete guarantee progression is covered by the L/G lifecycle and Create an L/G pages.

Was this page helpful?

Need help using the product?

Contacts, L/Gs, and Last Modifications on a sales job — PAMS Fresh Generation