# PAMS Fresh Generation # What is PAMS PAMS gives you one starting point for following B2B work from an initial inquiry through sales, purchasing, fulfilment, finance, and delivery. The Home screen shows where to continue for the task you need to complete. ## What PAMS is PAMS is an agent-centric customer relationship management (CRM) system for B2B sales operations. It connects the work around a customer opportunity instead of treating sales, suppliers, purchasing, warehousing, finance, and delivery as separate activities. The business flow starts with a first inquiry and can continue through offers, orders, and final delivery. Around that flow, PAMS supports follow-ups, documents, reports, bidding, tenders, procurement, delivery coordination, and commission logic. It also supports work with principals, suppliers, warehouses, invoices, and internal workflows. In this way, PAMS is presented as an end-to-end command center for the work that turns a business opportunity into a delivered result. ```mermaid flowchart LR Inquiry[First inquiry] --> Sales[Sales work] Sales --> Purchase[Purchasing and suppliers] Purchase --> Warehouse[Warehousing] Warehouse --> Finance[Finance and invoicing] Finance --> Delivery[Delivery] ``` Use this orientation table to choose your next page. | If you need to… | Go to | |---|---| | Understand the people and business roles around PAMS | Who uses PAMS | | Review the complete capability catalogue | What can you do with PAMS | | Check deployment and browser information | System requirements | | Learn the common product vocabulary | Basic terminology | | Reach Home for the first time | Open the Home screen below, then Your first day | | Understand the shared controls and layout | Understanding the interface | | Move through menus and routes | Navigation basics | | Adjust your personal workspace | Personalizing your workspace | | Follow sales work from inquiry to delivery | Sales job lifecycle | | Follow procurement work | Purchase job workflow | | Follow warehouse fulfilment | Warehouse fulfilment flow | ## Before you open PAMS PAMS is cloud-based and provides access to shared live data. Use a recent Safari, Chrome, Opera, or Edge browser on a computer, or iOS and Chrome on mobile. | Before opening PAMS | What you need | |---|---| | Deployment model | Cloud-based access to shared live data | | Desktop browser families | Recent Safari, Chrome, Opera, and Edge | | Mobile browser families | iOS and Chrome on mobile | | Sign-in state | Home requires authentication | For the complete requirements boundary, go to [System requirements](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/system-requirements). Home is protected by authentication, so you need an account that can sign in before you open it. ## Open the Home screen Home is the signed-in starting surface. Its dashboard is the overview of the work and activity available to your role, and its **Today** area shows today's work. **Prerequisites** - You have an account for the PAMS deployment. - You know the sign-in details for that account. **Steps** 1. Open the PAMS sign-in page. 2. Sign in when PAMS asks for authentication. 3. Open Home from the sign-in page. 4. Confirm that **Dashboard** is visible. 5. Confirm that **Today** is visible. ![Home with Dashboard and Today visible](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0204f63edda4fb604281c56ffed4df6d.png) **Result:** The signed-in Home screen is open, with **Dashboard** and **Today** visible. Continue to [Your first day](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/your-first-day) for first-day sign-in and profile orientation. ## Read the Home dashboard The Home dashboard covers sales movement, account activity, booking, team results, offers, and tendencies. It contains the following areas. | Dashboard area | Information it presents | |---|---| | Principals Report | Principal-facing report information | | Next 10 days and Last 10 days | Work and activity in the upcoming and recent periods | | Business development and Sales Pipeline | Business-development activity and pipeline movement | | Potentials, Inquiries, Budget offers, Firm offers, and Orders | Counts or views of sales work at these points in the flow | | Booking This Year | Current-year booking information | | Accounts in Sales Pipeline | Accounts connected to pipeline work | | Teams Booking vs. Target and Branch Booking vs. Target This Year | Team and branch booking compared with targets | | Teams Running Offer, Branch Running Offers, and Principals Running Offers | Offers that are still running, grouped by team, branch, or principal | | Branch Tendency to Target and Principals Tendency to Target | Tendency information compared with targets | The dashboard exposes **Sort by Booking**, **Sort by Target**, and **Sort by Achievement** for the visible dashboard information. Work from the headings and controls that appear in your Home view. Dashboard content can differ by role and organization settings. ![Home dashboard areas and sorting controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/92c84c4d1016e6185b3a63a6d8c80ec6.png) Continue to [Understanding the interface](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/understanding-the-interface) for shared interface conventions. ## Choose the dashboard view available to your role The Home view depends on the dashboard prepared for your role and on the subscription available to your organization. When an administrator-prepared dashboard is available, the role-dashboard choices appear outside edit mode. An active tab then determines which view you see. | Home condition | What appears | |---|---| | An administrator-prepared dashboard is available outside edit mode | Role-dashboard choices | | The active tab is a user dashboard or MRM report | The dashboard-tab view | | The active tab is a sales report | **Principals Report** | | The active tab is an Eagle View | **Eagle View** | | The role has no dashboard | `Your role has no dashboard` and `Kindly, Contact your administrator to define a dashboard` | | The subscription does not include the dashboard | The subscription-upgrade component instead of the dashboard library | | The custom dashboard has no dashboard tabs | No dashboard library | | The Home page uses business analysis | The business-analysis view instead of the custom dashboard | Choose the view that matches the work you need to review. The **Eagle View** branch is available as a dashboard tab type. Continue to [Dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) for dashboard behavior or [Reports](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/reports-hub) for report work. ## Personalize the Home dashboard Edit mode is the Home dashboard's maintenance view. It provides controls for restoring standard tabs, adding widgets, renaming or deleting tabs, and saving dashboard changes. **Prerequisites** - You can see the dashboard controls allowed for your role. - You are prepared to review the effect of a tab or widget change before saving it. **Steps** 1. Enter Home edit mode. 2. To restore the standard tabs, select **Restore the Standard Tabs** and choose one response: | If you need to… | Select | |---|---| | Leave the tabs unchanged | **Cancel** | | Restore the standard tabs | **Restore** | 3. To add a widget, select **Widget**. 4. Open the dashboard tab menu for the tab you want to change. 5. Select **Rename tab**. 6. Enter a name in **New Tab**. 7. Open the dashboard tab menu for the tab you want to delete. 8. Select **Delete tab**. 9. If more than one dashboard tab exists, select **Ultimate delete** and choose one response: | If you need to… | Select | |---|---| | Keep the tab | **Cancel** | | Permanently delete the tab and its content | **Delete** | 10. Select **Save** to save the dashboard changes. **Result:** The edit-mode controls let you restore tabs, add a widget, rename or delete a tab, and save dashboard changes. A tab name is required when you add or rename a tab. If the name is empty, PAMS displays `This Field Is Required`. Deleting a tab through **Ultimate delete** opens the confirmation message `Are you sure you want to ultimately delete this tab and all it's content ?`. After a dashboard action completes, PAMS can display `Your request was completed successfully`. When a dashboard action fails, PAMS can display `An error occurred while processing your request`. Continue to [Dashboard settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings) for administrative dashboard preparation. ## When Home does not look as expected Different Home compositions can be expected results of role, subscription, dashboard-tab, or organization configuration. Use the visible condition to choose the right interpretation. | What you see | What it means | What to do | |---|---|---| | `Your role has no dashboard` | No dashboard is available for the current role | Follow the instruction `Kindly, Contact your administrator to define a dashboard` | | No dashboard library | The custom dashboard has no dashboard tabs, or the subscription branch replaces it | Check the dashboard view available to your role and organization | | Business analysis instead of the custom dashboard | Home is using the business-analysis composition | Read the controls and areas shown in that view | | A different set of widgets or areas | Home reflects a different role or organization configuration | Use the labels and controls visible in your Home view | For problem triage, use [Getting help](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/getting-help). ## Continue from Home Home is an orientation surface. It points you toward the work, but field-level sales, procurement, warehouse, invoice, and dashboard-reference procedures belong to the pages that own those tasks. | If your next task is… | Continue with… | |---|---| | Sales work from inquiry through delivery | [Sales job lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle) | | Procurement and purchase orders | [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) | | Warehouse fulfilment | [Warehouse fulfilment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | | Dashboard views and widgets | [Dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) | | Dashboard configuration | [Dashboard settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings) | | Personal work organisation | My Desk workspace | | Review report information | Reports hub | Start with the page that owns the next hand-off rather than trying to complete that hand-off from Home. # Who uses PAMS ## Who PAMS is for PAMS is a business-to-business (B2B) operations platform for organisations that represent principals, sell directly, manage products or projects, or need one view across complex sales and supply work. | If your organisation or work involves… | PAMS is positioned to support… | |---|---| | Representing multiple principals | Commission structures and product portfolios. | | Direct sales and trading | Complex cycles with clients and suppliers, including bidding, booking, procurement, and warehousing. | | Representing principals and selling your own products or projects | A hybrid operating model. | | Managing sales performance | Visibility into sales-team performance, revenue, booking forecast, and target achievement. | | Moving beyond spreadsheets or disconnected systems | A B2B operation that has outgrown spreadsheets, struggles with generic CRMs, or juggles multiple systems. | The PAMS audience includes sales agencies, direct sales and trading teams, hybrid companies, sales managers, executives, and B2B operations whose current tools no longer keep their work together. The work described for this audience can span principals, clients, suppliers, procurement, warehousing, and invoicing. For the overall product definition, continue to [What PAMS is](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/what-is-pams). ## Before you choose a starting point The Home surface is a signed-in dashboard starting point. It does not identify your business role, persona, or permission level, so use the business descriptions above—not dashboard controls alone—to choose your first area. When no dashboard is available for the current role, PAMS displays `Your role has no dashboard` and `Kindly, Contact your administrator to define a dashboard`. > **Note:** Dashboard content depends on the current session and dashboard configuration. > Treat the areas visible on Home as an orientation surface, not as a permission list. ![Identify the Home dashboard areas before choosing a starting point](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d15bcedc0e5593f6b3ab04925f879aad.png) If you see the dashboard, the visible surface can include the Business development area, the Sales Pipeline chart, the Booking This Year readout, account and principal sections, team booking and offer charts, branch and principal tendency charts, running-offer charts, and the principal list. The visible controls **Sort by Booking**, **Sort by Target**, and **Sort by Achievement** are dashboard controls; their presence does not establish your audience role. If no dashboard is available, contact your administrator to define one. PAMS can also display `Your request was completed successfully` after a dashboard or report request, or `An error occurred while processing your request` when that request does not complete. ## Choose your starting point Choose a starting point by the business question you need to answer first. The Pams Workflow places customer and principal work alongside sales, procurement, invoicing, and warehousing. | If you need to… | Go to | |---|---| | Understand the overall flow | The Pams Workflow in the product overview. | | Follow customer-facing sales work | [Sales job lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle). | | Follow procurement work with suppliers | [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain). | | Understand warehouse receiving, inspection, or stock work | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow). | | Review dashboard visibility, forecasts, or targets | Dashboard overview. | | Organise personal cross-functional work | My Desk workspace. | | Review principal reporting | Principals Report. | | Start with access and first-use orientation | [Your first day](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/your-first-day). | Use the visible areas to recognise the kind of work you need, then continue to the focused page rather than treating the dashboard as the task itself. ![Match the dashboard area to the work you need to understand](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d15bcedc0e5593f6b3ab04925f879aad.png) ### Open Principals Report from Home Use Principals Report when your first question concerns principal reporting. The report opens from the Home dashboard. ### Prerequisites - You are signed in and the Home dashboard is visible. - **Principals Report** is visible on Home. ### Steps 1. On Home, select **Principals Report**. ![Read the required Report field and principal-report actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6aab1b7893ea8353e39ce827abb05519.png) 2. Check the visible report surface. | If you need to… | Look for… | |---|---| | Choose the report | The required **Report** field. | | Generate the report | **Generate Report**. | | Save the report as a PDF | **Download as PDF**. | | Read the report context | **Accounts** and **Time Frame**. | 3. Select the focused page that matches your work. | If you need to… | Continue with… | |---|---| | Follow sales operations | [Sales job lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle). | | Continue procurement work | [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain). | | Continue warehouse work | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow). | | Begin first-use orientation | [Your first day](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/your-first-day). | **Result:** The selected starting surface is on screen: Home for dashboard orientation, or Principals Report for its visible controls and readouts. # What can you do with PAMS PAMS gives you one connected view of customer work, supplier work, finance, warehouse fulfilment, and projects. Use the flow that matches your work, then continue to the detailed guide for that stage. ## What you can do with PAMS A Potential is an early customer opportunity. An Inquiry records the customer's request. Offer preparation turns the request into priced work, an Offer presents that work, and an Order starts fulfilment. The order hands work to the enterprise-resource-planning (ERP) flow through a bill of materials (BOM). The material path then runs through a material request (MRQ), request for quotation (RFQ), purchase order (PO), inventory, and delivery. After delivery, the financial path continues through a sales invoice and an incoming client payment. ```mermaid flowchart LR Potential --> Inquiry Inquiry --> "Offer preparation" "Offer preparation" --> Offer Offer --> Order Order --> BOM BOM --> MRQ MRQ --> RFQ RFQ --> PO PO --> Inventory Inventory --> Delivery Delivery --> "Sales Invoice" "Sales Invoice" --> "Incoming Client Payment" ``` | If you need to… | Go to | |---|---| | Understand what PAMS is | [What is PAMS](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/what-is-pams), when available in the Welcome section | | Qualify an early customer opportunity | [Potentials](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/potentials) | | Work on a customer request | [Inquiries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/inquiries) | | Prepare or send a commercial offer | [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers) | | Work with an accepted customer order | [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) | | Move from orders toward fulfilment | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) | | Plan purchasing and supplier work | [Purchase jobs: procurement chain](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) | | Complete warehouse fulfilment | [Warehouse fulfilment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | | Maintain customer accounts | [Accounts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/accounts) | | Maintain activities and files on sales work | [Sales job activities and files](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-activities-and-files) | | Work with libraries and files | [Libraries and files](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) | | Configure the Home surface | [Configuration Home](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) | ## Before you start Home is the dashboard entry point for this flow. You need to be signed in, have an available dashboard, and have at least one dashboard tab before you begin. | Starting condition | What you need | |---|---| | Access | You are signed in. | | Home view | The dashboard view is available. | | Dashboard content | At least one dashboard tab is available. | | Entry-point check | **Dashboard** is visible on `/home`; **Log in to Pams** is absent. | When you are signed in, Home displays the dashboard. When you are not signed in, the sign-in surface appears instead. Confirm the entry point before opening Home. ## Open Home Home is the signed-in surface where you reach dashboard readouts and choose the next area of work. **Prerequisites** - You are signed in. **Steps** 1. Open `/home`. 2. Confirm that **Dashboard** is visible. ![Confirm that the signed-in Home surface shows the Dashboard entry point.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0204f63edda4fb604281c56ffed4df6d.png) **Result:** The signed-in Home surface is open, **Dashboard** is visible, and **Log in to Pams** is absent. Continue by reading the dashboard areas. ## Read Home Home is a dashboard hub: it groups pipeline, booking, backlog, invoice, payment, and other operational readouts so you can choose what to investigate next. | Home area or readout | Use it to… | |---|---| | Business development | Review business-development activity and pipeline movement. | | Sales Pipeline | Review active sales-pipeline information. | | Potentials | Review early customer opportunities. | | Inquiries | Review customer requests. | | Budget offers | Review budget offers. | | Firm offers | Review firm offers. | | Orders | Review customer orders. | | Backlog | Review work that remains to be fulfilled. | | Commission Invoices | Review commission invoices. | | Sales Invoices | Review sales invoices. | | Principals Report | Compare principal-related sales information. | | Eagle View | Review vendor-analysis report choices. | Home includes **Dashboard**, **Principals Report**, **Today**, **Next 10 days**, **Last 10 days**, and **Business development**. Its operational areas include **Sales Pipeline**, **Booking This Year**, **Accounts in Sales Pipeline**, **Teams Booking vs. Target**, **Branch Booking vs. Target This Year**, **Principals Booking vs. Target This Year**, **Branch Running Offers**, and **Principals Running Offers**. The live Home surface also includes **Teams Running Offer**, **Branch Tendency to Target**, and **Principals Tendency to Target**. **Booking This Year** shows target, achieved booking, achieved percentage of target, forecast, and blind forecast. **Accounts in Sales Pipeline** shows client and principal counts. **Backlog** shows sales backlog, commission backlog, and the average commission percentage. ![Use the Home dashboard areas to choose the readout that answers your current business question.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d15bcedc0e5593f6b3ab04925f879aad.png) The principal comparison leads to the Home sort controls. ## Choose a Home sort The principal comparison lets you change the order of the visible comparison according to booking, target, or achievement. **Prerequisites** - You are on Home and can see the principal comparison. **Steps** 1. In the principal comparison, select the sort that matches your comparison. | If you want to compare by… | Select | |---|---| | Booking | **Sort by Booking** | | Target | **Sort by Target** | | Achievement | **Sort by Achievement** | 2. Read the reordered principal comparison. **Result:** The principal comparison is ordered by the selected Home sort. From there, continue with the sales and operations flow. ## Run the sales and operations flow The sales and operations flow carries work from a customer opportunity through procurement and warehouse fulfilment to billing and collection. Use the stage that matches the record you need to work on; the detailed pages linked below own the record-level steps. ```mermaid flowchart LR Potential --> Inquiry Inquiry --> "Offer preparation" "Offer preparation" --> Offer Offer --> Order Order --> BOM BOM --> MRQ MRQ --> RFQ RFQ --> PO PO --> Inventory Inventory --> Delivery Delivery -.-> "Sales Invoice" "Sales Invoice" --> "Incoming Client Payment" Order --> "Drop Shipping" ``` | Work you need to do | Continue with | |---|---| | Qualify a potential | [Potentials](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/potentials) | | Handle an inquiry | [Inquiries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/inquiries) | | Prepare or manage an offer | [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers) | | Work with an order | [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) | | Follow the order-to-delivery hand-off | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) | | Manage the procurement chain | [Purchase jobs: procurement chain](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) | | Fulfil warehouse work | [Warehouse fulfilment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | | Work on delivery notes | [Delivery notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/delivery-notes) | | Record a payment | [Record payment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/record-payment) | Drop shipping is an alternative delivery path in the operations flow. It belongs at the order and delivery decision rather than being a separate customer opportunity stage. Supporting records keep the people, work items, documents, and projects around this flow together. ## Manage relationships, activities, and projects An account is the organisation you work with; a contact is a person associated with that organisation; a task or activity records follow-up work; a project groups related work; and a library holds files. | Supporting work | Continue with | |---|---| | Maintain accounts | [Accounts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/accounts) | | Maintain contacts | [Contacts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-contacts-guarantees-and-history) | | Track tasks and activities | [Tasks and activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/tasks-and-activities) | | Maintain project work | [Projects](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/projects) | | Organise libraries and files | [Libraries and files](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) | | Review sales-job contacts, guarantees, and history | [Sales job information and assessment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-information-and-assessment) | These supporting records lead to the performance readouts used for follow-up decisions. ## Monitor performance and decide what to do next Use Home and the related reports to compare performance before choosing follow-up work. The available readouts cover booking, targets, running offers, backlog, receivables, invoices, payments, and job profitability. | Question you need to answer | Readout or guide | |---|---| | How is booking progressing this year? | **Booking This Year** | | How are teams performing against target? | **Teams Booking vs. Target** | | Which teams are running offers? | **Teams Running Offer** | | How is a branch trending toward target? | **Branch Tendency to Target** | | How are principals trending toward target? | **Principals Tendency to Target** | | What remains to collect? | **Receivables** | | What has been invoiced or paid? | Invoices and payments | | What is the profitability of a job? | [Job profitability overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/job-profitability-overview) | Compare the readout with the business flow before choosing the next record-level action. A running-offer readout points toward offer work, while a receivables readout points toward finance and payment work. ### When a dashboard action stops Identify the visible condition first, then take the corresponding route. | What you see | What it means | What to do | |---|---|---| | A subscription or upgrade surface appears instead of dashboard content | Your available subscription does not include the requested dashboard surface. | Use the subscription or administrator route for access. | | **Back** is available after the dashboard stops | The current dashboard action has a return path. | Select **Back** to return to the preceding surface. | | `Your request was completed successfully` | The requested dashboard action completed successfully. | Continue from the updated dashboard surface. | | `An error occurred while processing your request` | The dashboard action did not complete normally. | Retry from the dashboard; if it continues, use Getting help. | | `Incorrect username or password` | Sign-in failed. | Return to the sign-in page and use the sign-in guidance. | ### Messages you may see on Home Home displays these messages when the related dashboard condition occurs: | Message | When it may appear | What to do | |---|---|---| | `Your role has no dashboard` | No dashboard is available for your role. | Contact your administrator. | | `Kindly, Contact your administrator to define a dashboard` | No dashboard is available for your role. | Contact your administrator to define a dashboard. | | `Are you sure you want to ultimately delete this tab and all it's content ?` | You select **Ultimate delete** for a dashboard tab. | Read the confirmation before selecting **Delete**. | | `This Field Is Required` | The name for a new or renamed tab is empty. | Enter a tab name. | ### Out of scope This page is an orientation map, not a record-entry or configuration guide. Use the owning page for the detail you need. | For this work… | Continue with | |---|---| | Enter or validate an individual record | Open the guide for that record, such as [Create a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-sales-job) or [Create MRQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-mrq). | | Follow record-level approvals and hand-offs | Use the relevant lifecycle or hand-off guide, such as [Sales jobs lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle) or [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered). | | Configure the company or Home | Use [Configuration Home](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home). | | Check environment requirements | [System requirements](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/system-requirements) | | Resolve a support issue | Use Getting help. | This overview does not provide individual record fields, validation rules, approval ownership, the full dashboard widget catalogue, user or company administration, system deployment requirements, or support-channel details. # System requirements Choose the frontend and API deployment requirements before deployment. ## Before you start The authenticated **Home** route is not a deployment-settings screen. Use the deployment configuration below when preparing an environment. ![The authenticated Home route, separate from deployment settings](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/92c84c4d1016e6185b3a63a6d8c80ec6.png) > **Note:** Do not use **Home** to configure deployment requirements. | If you need to… | Go to | | --- | --- | | Identify the deployment definitions to use | [Find the deployment definitions](#find-the-deployment-definitions) | | Choose frontend and API configuration | [Understand the deployment baseline](#understand-the-deployment-baseline) | | Prepare the frontend image | [Prepare the frontend deployment](#prepare-the-frontend-deployment) | | Prepare the API image and writable paths | [Prepare the API deployment](#prepare-the-api-deployment) | | Apply configuration to development or production | [Handle development and production deployments](#handle-development-and-production-deployments) | | Resolve an unsupported operating-system, database, sizing, or browser-version question | [When a requirement is missing](#when-a-requirement-is-missing) | | Check the authenticated application entry point | [Check the application entry point](#check-the-application-entry-point) | | Continue with sign-in orientation | [Your first day](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/your-first-day) | | Find approved support guidance | [Getting help](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/getting-help) | ## Find the deployment definitions Select the runtime, build, container, and browser settings from the deployment components below. | Deployment area | Definition to locate | Deployment decision | | --- | --- | --- | | Frontend package | Package declaration | Select the Angular package line and TypeScript version. | | Frontend container | Container definition | Select the build image, web server image, exposed port, and process mode. | | API project | Project declaration | Select the API target framework. | | API container | Image definition | Select the Windows container image. | | API writable paths | API container access setup | Prepare the API's writable locations. | | Browser support | Frontend browser-support configuration | Use the supported browser families. | Use the definitions you locate to apply the baseline below. ## Understand the deployment baseline Configure the frontend package and container, API target and container, API writable paths, and browser family with the following baseline. | Area | Required configuration | | --- | --- | | Frontend build | Angular packages are declared at `16.2.x`; TypeScript is `4.9.3`. | | Frontend container | The image builds with `node:16`, serves through `fholzer/nginx-brotli:latest`, exposes port `80`, and starts nginx in the foreground. | | API target | The API project targets .NET Framework `v4.6`. | | API container | The image uses `mcr.microsoft.com/dotnet/framework/aspnet:4.8-windowsservercore-ltsc2022`. | | API writable paths | The image creates `C:\Data`, grants IIS identities full access, and grants access to `Content` when that folder exists. | | Browser family | The frontend polyfills describe recent Safari, Chrome, Opera, Edge, and iOS and Chrome on mobile. | Request owner approval before choosing a production operating-system edition outside the API base image, database-server version, database sizing, CPU, memory, storage, network sizing, or browser version number. Do not derive those settings from the browser families or container base image. Use the procedures below to prepare the frontend and API deployments. ## Prepare the frontend deployment Use this procedure to select the frontend build and serving requirements. Prerequisites - The frontend repository and its container definition are available. - The deployment process can build the declared frontend package. - Port `80` is available for the frontend container. Steps 1. Set the frontend Angular package line to `16.2.x`. 2. Set the frontend TypeScript version to `4.9.3`. 3. Configure the frontend build stage to use `node:16`. 4. Configure the frontend server stage to use `fholzer/nginx-brotli:latest`. 5. Set the frontend container port to `80`. 6. Set nginx to run in the foreground. **Result:** The frontend uses the defined Angular, TypeScript, Node, nginx, port, and foreground-process settings. Next, prepare the API deployment. ## Prepare the API deployment Use this procedure to select the API target, image, and writable paths. Prerequisites - The API project and its container definition are available. - A Windows container environment can use the declared API image. - The deployment process can create and grant access to the declared writable paths. Steps 1. Set the API target to .NET Framework `v4.6`. 2. Configure the API image to use `mcr.microsoft.com/dotnet/framework/aspnet:4.8-windowsservercore-ltsc2022`. 3. Configure the API image to create `C:\Data`. 4. Set IIS identity permissions on `C:\Data` to full access. 5. Set API access to `Content` when that folder exists. **Result:** The API uses the defined .NET Framework target, Windows container image, and writable-path settings. Next, apply both preparations to the selected deployment mode. ## Handle development and production deployments Use the same packaging and runtime choices when preparing development or production deployment. Request owner approval for any mode-specific configuration. | Deployment area | Use this defined choice | Owner decision still required | | --- | --- | --- | | Frontend runtime and packaging | Angular `16.2.x`, TypeScript `4.9.3`, `node:16`, nginx Brotli, port `80`, and foreground nginx | Any separate development or production configuration | | API runtime and packaging | .NET Framework `v4.6`, the Windows Server Core API image, and writable-path setup | Any separate development or production configuration | | Browser support | Recent Safari, Chrome, Opera, Edge, and iOS and Chrome on mobile | A supported browser version number | | Infrastructure sizing | No sizing value is defined | CPU, memory, storage, or network requirements | Prerequisites - The development or production deployment target is selected. - The frontend and API deployment definitions are available. Steps 1. Set the frontend build image to `node:16`; see [Prepare the frontend deployment](#prepare-the-frontend-deployment). 2. Set the frontend server image to `fholzer/nginx-brotli:latest`; see [Prepare the frontend deployment](#prepare-the-frontend-deployment). 3. Set the frontend container port to `80`. 4. Set nginx to run in the foreground. 5. Set the API runtime target to .NET Framework `v4.6`; see [Prepare the API deployment](#prepare-the-api-deployment). 6. Set the API image to `mcr.microsoft.com/dotnet/framework/aspnet:4.8-windowsservercore-ltsc2022`; see [Prepare the API deployment](#prepare-the-api-deployment). 7. Set the API writable paths as described in [Prepare the API deployment](#prepare-the-api-deployment). 8. Apply the same runtime, image, port, and writable-path settings to the selected deployment mode. 9. Ask the deployment owner to approve each mode-specific operating-system, database, sizing, or browser setting. **Result:** The deployment uses the defined frontend and API baseline, while mode-specific settings are separated for owner approval. ## When a requirement is missing Use the table below when a deployment decision has no defined value. | Deployment decision | Required action | | --- | --- | | Production operating-system edition outside the API base image | Obtain an owner-approved edition before deployment. | | Database-server version | Obtain an owner-approved version before deployment. | | CPU, memory, storage, or network capacity | Obtain owner-approved sizing before deployment. | | Supported browser version | Obtain an owner-approved version; the listed browser families are not a version requirement. | | Runtime data for dashboard column sets | Treat the runtime data requirement as a deployment dependency, not as a dashboard setting. | Continue with [Getting help](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/getting-help) when a deployment owner must approve a decision. After the deployment decisions are approved, check the authenticated application entry point. ## Check the application entry point The authenticated application entry point is the **Home** route at `/home`. The **Home** route requires authentication. After deployment, use the authenticated entry point to continue with [Your first day](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/your-first-day) for first sign-in orientation. **Result:** The application entry point is the authenticated `/home` route. # Getting help Use **Home** to check visible problem indicators, then choose the registered help destination that matches the problem. ## Before you start Use the route that matches what you need: | If you need to… | Go to | |---|---| | Check the dashboard for visible problem indicators | [Open Home](#open-home) | | Understand the inputs and limits of the dashboard view | [Recognize the Home state](#recognize-the-home-state) | | Find a destination for a question that Home does not resolve | [FAQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/faq) | | Triage an error message | [General error messages](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/general-error-messages) | | Find a known problem and its remedy | [Common issues and solutions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/common-issues-and-solutions) | | Continue to the registered help route | [Continue to the registered help page](#continue-to-the-registered-help-page) | ## Open Home Home is the signed-in starting screen at `/home`. The Home route requires authentication, so sign in before you inspect its problem indicators. **Prerequisites** - Have access to the PAMS sign-in flow. - Be ready to sign in before opening Home. **Steps** 1. Sign in to PAMS. 2. Open `/home`. ![Home at the signed-in /home route](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/92c84c4d1016e6185b3a63a6d8c80ec6.png) **Result:** Home is on screen at `/home`. ## Recognize the Home state Home is a dashboard view with sorting inputs rather than a labelled support action. Use the visible inputs as indicators only; dashboard selections depend on the dashboard configuration available to your account. | What you can see | What it tells you | |---|---| | **Sort by Booking** | A visible dashboard input with no required marker. | | **Sort by Target** | A visible dashboard input with no required marker. | | **Sort by Achievement** | A visible dashboard input with no required marker. | Home has no visible buttons or table columns, and no additional messages or dialogs appear. **Prerequisites** - Be signed in and have Home open at `/home`. **Steps** 1. Read the visible sorting inputs. 2. Check whether the problem is represented by the Home state you can see. **Result:** You know whether the problem appears on Home without treating an unlabeled control as a support control. ## When Home cannot resolve the problem Treat Home as the place to inspect the dashboard state, not as a place to submit a support request. It has no labelled Help, Help & Troubleshooting, FAQ, or support-channel control; no field for collecting a problem description; and no declared support URL, email address, telephone number, or support hand-off. If a dashboard action displays a message, use the exact text to identify the message before moving to the registered error-message destination: | Message | Use it to… | |---|---| | `An error occurred while processing your request` | identify a general processing error | | `Please choose one or more principals` | identify a missing principal choice | | `Your request was completed successfully` | identify a completed request | **Prerequisites** - Have checked the visible Home state. - Know whether the problem is a question, an error message, or a known issue. **Steps** 1. Select and open the registered destination that matches the problem. | Problem | Open | |---|---| | A question not resolved on Home | [FAQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/faq) | | An error message | [General error messages](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/general-error-messages) | | A known problem | [Common issues and solutions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/common-issues-and-solutions) | **Result:** You have a problem-specific help destination, and you know that Home does not provide the onward support hand-off. ## Continue to the registered help page The registered help page owns the next problem-resolution step. **Prerequisites** - Have selected FAQ, General error messages, or Common issues and solutions. **Steps** 1. Open the selected registered help page. **Result:** The registered help page is open for the next problem-resolution step. # Your first day A sign-in gives you access to PAMS. A profile is the set of personal details held for a PAMS account. Start with access, then review the profile details you are responsible for. ## Your first day in PAMS Enter PAMS, complete any additional sign-in check, open a profile, and save profile changes. | If you need to… | Go to | |---|---| | Open the initial sign-in form | [Sign in](#sign-in) | | Complete a code or device-trust check | [Complete an additional sign-in check](#complete-an-additional-sign-in-check) | | Find the named profile details | [Orient yourself on the profile surface](#orient-yourself-on-the-profile-surface) | | Save profile changes | [Review and save profile details](#review-and-save-profile-details) | | Continue learning the interface | `understanding-the-interface` | | Learn how to move around PAMS | `navigation-basics` | ## Before you start Have a PAMS account, its email and password, and the identifier for the profile you need to open. | Before you begin | Why it matters | |---|---| | An account for PAMS | The sign-in form requires an email and password. | | The profile user's identifier | It opens the specific profile you need to review. | | The sign-in entry | It takes you to the sign-in form. | ## Reach the sign-in and profile surfaces After signing in, continue with [Orient yourself on the profile surface](#orient-yourself-on-the-profile-surface). | If you need to… | Do this | |---|---| | Sign in to PAMS | Open the sign-in entry. | | Review a profile | Open the profile page for the person you need. | | Open the correct profile | Enter that person's profile identifier. | If the sign-in entry opens the dashboard, continue from the dashboard. Otherwise, complete [Sign in](#sign-in) and then open the profile. ![The landing route after opening the sign-in entry](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c0412e66205334ca9d219c53758132ce.png) ## Sign in Use the initial sign-in form when PAMS asks for your account credentials. The form contains **Email**, **Password**, the optional **Remember Me** choice, and **Login**. **Prerequisites** - You have the email and password for your PAMS account. - The initial sign-in state is showing. **Steps** 1. Enter your account email in **Email**. 2. Enter your account password in **Password**. 3. Optional: select **Remember Me** if you want to use the remembered-login choice. 4. Select **Login**. The initial sign-in form appears when no device-trust or verification step is required. **Email** and **Password** are required. If either value is empty, the form can show `User Name is Required` or `Password is required`. **Result:** PAMS submits the initial sign-in information. If an additional check appears, continue with [Complete an additional sign-in check](#complete-an-additional-sign-in-check). Otherwise, continue with [Orient yourself on the profile surface](#orient-yourself-on-the-profile-surface). ## Complete an additional sign-in check An additional sign-in check asks for a verification code or presents a device-trust choice after the initial credentials are submitted. | State | What appears | |---|---| | Identity verification | PAMS asks for a required code in **Enter code**. | | Device trust choice | PAMS offers the optional **Trust this device for further login** choice. | **Prerequisites** - PAMS has moved from the initial sign-in state to an additional check. - For identity verification, you have the verification code. **Steps** 1. In the identity-verification state, enter the code in **Enter code**. 2. Select **Verify** when the code contains at least six characters. 3. If a resend control appears below **Enter code**, select it after its waiting period ends. 4. In the recognized-device choice state, select **Trust this device for further login** when you want that optional choice. **Result:** PAMS submits the verification code when **Verify** is enabled, or records the available device-trust choice. An empty code or a code shorter than six characters leaves **Verify** disabled. An empty code can show `code is required`; an invalid or expired code shows `Verification code not correct or expired`. After the check, continue with [Orient yourself on the profile surface](#orient-yourself-on-the-profile-surface). ## Orient yourself on the profile surface The profile surface is where you review personal account details. Its named fields appear after the selected profile has loaded. | Profile detail | Field state | |---|---| | **User Name** | Text field; required. | | **Position** | Read-only text. | | **Title** | Text field. | | **First Name** | Text field. | | **Middle Name** | Text field. | | **Last Name** | Text field. | | **Display Name** | Text field; required. | | **Login Email** | Text field; required. | | **Cloud Account** | Read-only text. | | **Mobile** | Text field; required, with a maximum length of 20. | The profile surface also includes role, approval-limit, branch, and file areas. Use the labels displayed on your profile surface to identify those areas. Continue with [Review and save profile details](#review-and-save-profile-details). ### Review and save profile details Review the named profile details before saving them. **Save** stores profile changes; **Save and Close** stores the changes and requests that the profile close. **Prerequisites** - The profile content is showing for the person whose details you need to review. - You have permission to change the profile details. - You know the correct values for the required fields. **Steps** 1. Review **User Name**, **Display Name**, **Login Email**, and **Mobile**. 2. Correct **User Name** if it is empty or contains spaces. 3. Enter a value in **Display Name**. 4. Enter a valid value in **Login Email**. 5. Enter a value in **Mobile**. 6. Choose the save action that matches what you want to do. | If you want to… | Select | |---|---| | Save the changes and remain on the profile surface | **Save** | | Save the changes and request that the profile close | **Save and Close** | 7. If the profile-photo prompt is open, choose the action that matches what you want to do. | If you want to… | Select | |---|---| | Keep the photo | **Cancel** | | Remove the photo | **Delete** | The profile save actions are disabled when there are no changes to save. The required-field messages are `User Name is required`, `No spaces are allowed`, `Display name is required`, `Email is required`, `Email is invalid`, and `Mobile is required`. **Result:** PAMS confirms a successful save with `Data saved Successfully`. A password-change save can show `Data saved Successfully .. This User Password has been Changed .. Please check E-Mail`. ### Review trusted login devices Review the device-trust choice while completing an additional sign-in check. **Prerequisites** - PAMS is showing the additional sign-in check. - You know whether this device should be remembered for later logins. **Steps** 1. Review the optional **Trust this device for further login** choice. 2. Select **Trust this device for further login** when you want PAMS to remember this device. **Result:** The device-trust choice is recorded as part of the additional sign-in check. ## When sign-in or profile access goes wrong Use the message that appears to choose the correction rather than repeating the same entry. | What you see or encounter | What to do | |---|---| | `User Name is Required` | Enter a value in **Email** and submit **Login** again. | | `Password is required` | Enter a value in **Password** and submit **Login** again. | | `Incorrect username or password` | Recheck the account credentials before selecting **Login** again. | | `code is required` | Enter a verification code in **Enter code**. | | `Verification code not correct or expired` | Enter a current six-character-or-longer code before selecting **Verify**. | | `Error: This Email or User Name Already Exists` | Correct the duplicate email or user name before saving the profile. | | `Error: Server Error` | Retry the profile save after checking that the values are correct. | | The sign-in entry opens the dashboard | Continue from the dashboard. | ## Continue after your first-day orientation From the dashboard, continue with `understanding-the-interface` for interface orientation and `navigation-basics` for navigation orientation. # Understanding the interface The signed-in Home and Dashboard surfaces help you recognize the page, choose a dashboard view, and review the visible report and widget areas. ## What the Dashboard is for The Dashboard is the signed-in Home surface for viewing dashboard tabs, report controls, and available widget content. | If you need to… | Go to | |---|---| | Recognize the Dashboard and its surrounding navigation | Open the Dashboard and orient yourself | | Understand what must be in place before the surface appears | Before you open the Dashboard | | Choose a time-range or dashboard view | Select a dashboard view | | Understand the visible report and widget areas | Review the visible measures | | Resolve a message or an unexpected surface | Troubleshooting | | Learn the wider application navigation | Navigation basics | | Change workspace and dashboard settings | Personalizing your workspace | | Read the broader Dashboard overview and role variants | Dashboard | | Find the complete widget catalog | Dashboard widget catalog | | Route a problem to support | [Getting help](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/getting-help) | A dashboard tab is a selectable view whose active content occupies the Dashboard area. In the widget view, the grid contains the widgets selected for the active tab. Prepared role dashboards provide radio choices for the available role dashboards. ## Before you open the Dashboard The Home surface is available only in the signed-in state. Dashboard content also depends on the dashboard setup and the subscription available to your company. | Setup condition | What appears | |---|---| | You are signed in | The Home surface appears. | | A custom dashboard is selected | The custom dashboard area appears. | | Dashboard tabs are available | The Dashboard library appears. | | Your subscription includes the Dashboard | Dashboard tabs and their content appear. | | A prepared role dashboard is available | A role dashboard choice appears. | When prepared role dashboards are available, choose from the displayed radio choices to review a role dashboard. The Dashboard library appears only when dashboard tabs are available, and dashboard content appears when your subscription includes the Dashboard. The report columns are selected for the active setup. The columns for inquiries, offers, orders, delivered items, lost items, and cancelled items therefore depend on that setup. Widget-menu labels and numeric widget values also depend on the setup available to your company. > **Note:** The tabs, widget labels, values, and report columns can vary with > your company setup. ## Open the Dashboard and orient yourself The Dashboard is the Home surface where you move between application areas, review the report area, and open dashboard content. **Prerequisites** - You are signed in to Pams. **Steps** 1. Open the Dashboard surface. 2. Identify the navigation entries **Dashboard**, **Reports**, **My Desk**, **Sales**, **PM**, **Purchasing**, **Inventory**, **Financial**, **Job Profitability**, and **Data**. 3. Identify the **Principals Report** area, the time-range tabs **Today**, **Next 10 days**, and **Last 10 days**, the required field **Report**, **Generate Report**, and **Download as PDF**. 4. Open the dashboard content area. ![Dashboard navigation, report controls, and time-range tabs](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/03ad57abeb62b68412c577fb891041b8.png) **Result:** The Dashboard page is open with its navigation, report area, visible tabs, **Report** field, **Generate Report**, **Download as PDF**, and dashboard content area available for orientation. Use these surfaces to choose the view you need. ## Select a dashboard view A dashboard view determines which content occupies the Dashboard area. Use this procedure to move between the available time-range, report, and custom views. **Prerequisites** - You are signed in to Pams. - The Dashboard is open and its available tabs are visible. **Steps** 1. Select the dashboard tab that matches your task. | If you need to… | Select… | |---|---| | Review today’s dashboard content | **Today** | | Review the next ten days | **Next 10 days** | | Review the previous ten days | **Last 10 days** | | Review the principal report | **Sales Report** | | Review the custom dashboard | **Eagle View** | 2. Review the content shown for the selected tab. 3. When the widget-selection area is available, choose one option: | If you need to… | Select… | |---|---| | Find a widget | **Search for widget** | | Select every widget | **Select all** | 4. When edit mode is active, select one of these controls to manage the selected dashboard view: | If you need to… | Select… | |---|---| | Restore the standard tabs | **Restore** | | Add a widget | **Add New Widget** | | Save dashboard changes | **Save** | | Close the restore-standard-tabs sub-menu | **Cancel** | | Open tab renaming | **Rename tab** | | Open tab deletion | **Delete tab** | | Remove the selected widget from the active tab | **Remove widget from tab** | **Result:** The selected dashboard view is open, showing its time-range, principal report, custom dashboard, or widget content. Continue by reviewing the measures on that view. ## Review the visible measures A selected widget is an item chosen for the active dashboard tab. The Dashboard uses the selected-widget list to generate the widget grid, so the grid reflects the list selected for that tab. **Prerequisites** - The Dashboard is open. - You have selected a dashboard view. **Steps** 1. Complete the required **Report** field in the report area. 2. Select **Generate Report**. 3. Confirm that **Content:** appears in the dashboard content area. 4. Review the visible measures on the active surface. | Review… | Locate… | |---|---| | The principal report | **Principals Report** | | Business development | **Business development** | | Forecast content | **Including Forecast Including Forecast** | | Booking, target, and achievement sorting | **Sort by Booking**, **Sort by Target**, and **Sort by Achievement** | | Tickets | **Tickets** | 5. Select **Download as PDF** when you need a PDF copy of the report. The report columns and widget values follow the active dashboard setup. Review the values and columns shown after selecting the relevant view. **Result:** The selected dashboard measures and report content are visible, with the available report controls ready for further use. If a surface or action is missing, use the troubleshooting table. ## Troubleshooting | What you see | What it means | What to do | |---|---|---| | `Your request was completed successfully` | The dashboard request completed successfully. | Continue with the page or view that opened. | | `An error occurred while processing your request` | The dashboard request encountered an error. | Review the current dashboard setup and repeat the request when the relevant controls are available. | | `Please choose one or more principals` | The report needs at least one principal selected. | Select one or more principals, then generate the report again. | | The Dashboard surface is absent | The signed-in state, custom-dashboard choice, available tabs, or subscription affects whether the surface appears. | Confirm that you are signed in and check the dashboard setup available to your company. | | **Search for widget**, **Rename tab**, or **Delete tab** is unavailable | These controls depend on the current dashboard setup or edit mode. | Use the control when it is available on the Dashboard. | ### Out of scope | Message | Owning page | |---|---| | `Incorrect username or password` | Sign-in page | Use [Getting help](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/getting-help) for support routing when the Dashboard still does not match the setup available to your company. # Navigation basics ## Overview **Home** is the dashboard landing area. **My Desk** is the work area for lists, graphs, tasks, activities, and calendar views. | If you need to… | Go to | |---|---| | Recognize the dashboard landing area | [Understand the visible work area](#understand-the-visible-work-area) | | Open or adjust dashboard areas | [Dashboard controls and areas](#dashboard-controls-and-areas) | | Choose a list, graph, task, activity, or calendar area | [My Desk controls and areas](#my-desk-controls-and-areas) | | Select current, archived, or graph work | [Select a view and navigate](#select-a-view-and-navigate) | | Understand workspace changes | [Personalizing your workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/personalizing-your-workspace) | | Get broader screen-recognition guidance | [Understanding the interface](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/understanding-the-interface) | | Work in the complete My Desk workspace | [My Desk workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-workspace) | | Work with My Desk activities | [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities) | Open `/home` for **Home** or `/my-desk` for **My Desk**. ![The Home dashboard tabs and readouts after sign-in](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0204f63edda4fb604281c56ffed4df6d.png) ## Before you start You need a signed-in PAMS session. **Home** is protected by signed-in access. **My Desk** can look different depending on whether you are a principal user and whether your subscription includes the relevant features. | Surface | What determines whether it appears | |---|---| | Home dashboard | A dashboard is available to your role. | | Home dashboard library | At least one dashboard tab exists. | | Home fallback | Your role has no dashboard. | | My Desk standard view | You are not a principal user. | | My Desk principal-user view | You are a principal user. | | My Desk content | Your subscription includes the My Desk feature. | | **Tasks** | The Tasks module is included and you are not a principal user. | | **Activities** | The Activities module is included and you are not a principal user. | | **Calendar** | The My Desk Calendar feature is included and you are not a principal user. | The visible list content belongs to the signed-in account. Use the labels and entries on your screen when choosing a work view. ## Choose and open a work area Use **Home** for dashboard readouts. Use **My Desk** for list, graph, task, activity, or calendar work. ### Prerequisites - You are signed in to PAMS. ### Steps 1. Open the work area you need. | If you need to… | Open | |---|---| | View dashboard readouts | `/home` for **Home** | | Review list, graph, task, activity, or calendar work | `/my-desk` for **My Desk** | 2. Identify the active work area from the page content before selecting a tab. **Result:** You are on **Home** at `/home` or on **My Desk** at `/my-desk`, ready to choose a work view. The next choice depends on the area you opened: read [Dashboard controls and areas](#dashboard-controls-and-areas) for **Home**, or [My Desk controls and areas](#my-desk-controls-and-areas) for **My Desk**. ## Understand the visible work area **Home** can show dashboard tabs and readouts such as pipeline, booking, accounts, teams, branches, and principals. **My Desk** starts with **Lists** and **Graphs** and can also show **Tasks**, **Activities**, and **Calendar**. Home can show these dashboard tabs or areas: | Area | What to look for | |---|---| | **Dashboard** | The main dashboard landing area | | **Principals Report** | A principals report dashboard tab | | **Today** | A time-based dashboard area | | **Next 10 days** | A forward-looking dashboard area | | **Last 10 days** | A recent-period dashboard area | | **Business development** | A business-development dashboard area | Home readouts include **Sales Pipeline**, **Booking This Year**, **Accounts in Sales Pipeline**, **Teams Booking vs. Target**, **Teams Running Offer**, **Branch Tendency to Target**, **Principals Tendency to Target**, **Branch Booking vs. Target This Year**, **Principals Booking vs. Target This Year**, **Branch Running Offers**, and **Principals Running Offers**. ![Home dashboard readouts and the main navigation areas](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/92c84c4d1016e6185b3a63a6d8c80ec6.png) The next step is to select a dashboard tab or review the My Desk controls for the work area you opened. ## Dashboard controls and areas On **Home**, select dashboard tabs and inspect dashboard content. Dashboard editing is a separate mode; its edit controls appear when edit mode is active. | Control or area | Use | |---|---| | **Principals Report** | Select a dashboard tab of that type. | | **Eagle View** | Select a dashboard tab of that type. | | **Rename tab** | Open tab renaming while edit mode is active. | | **Delete tab** | Open tab deletion while edit mode is active. | | **Restore the Standard Tabs** | Open the restore confirmation menu while edit mode is active. | | **Cancel** | Close the restore confirmation menu. | | **Restore** | Restore the standard tabs. | | **Widget** | Open the add-widget flow while edit mode is active. | | **Save** | Save dashboard changes while edit mode is active. | | **Select all** | Select all widgets in the widget chooser. | The add-tab and rename-tab dialogs each require **New Tab**. On **Home**, these are visible, non-required inputs: - **Sort by Booking**. - **Sort by Target**. - **Sort by Achievement**. ### Add widgets to a dashboard tab Use the widget chooser when you need to add a card or chart to the active dashboard tab. **Prerequisites** - You are in Home edit mode. **Steps** 1. Select **Widget**. 2. Select the widgets to add. 3. Select **Select all** when you want every widget in the chooser. 4. Select **OK**. 5. Select **Save**. **Result:** The selected widgets are added to the active dashboard tab and the dashboard changes are saved. ![The widget chooser opened from the Home dashboard](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/92c84c4d1016e6185b3a63a6d8c80ec6.png) When standard tabs are being restored, the confirmation text is: `Are you sure you want to replace your tabs with standard tabs?` Continue with [Personalizing your workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/personalizing-your-workspace) for dashboard-tab and widget changes. If you opened **My Desk**, continue with [My Desk controls and areas](#my-desk-controls-and-areas). ## My Desk controls and areas **My Desk** keeps list, graph, task, activity, and calendar areas within the `/my-desk` route. | Control | Destination or use | |---|---| | **Filter** | Open the filter-column menu. | | **Lists** | Open list work. | | **Graphs** | Open graph work. | | **Tasks** | Open tasks when Tasks is available to your role. | | **Activities** | Open activities when Activities is available to your role. | | **Calendar** | Open the calendar when Calendar is available to your role. | | **Visit** | Open the visit activity entry. | | **Meeting** | Open the meeting activity entry. | | **Call** | Open the call activity entry. | Select **Current**, **Archived**, or **Graphs** to change the My Desk view while remaining at `/my-desk`. These choices do not change a record or move a stage. ![My Desk with the Current work view selected](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2c8ce586a7a179ff95e876d7282cd950.png) Continue with [My Desk filter choices](#my-desk-filter-choices) to filter the selected area, or with [Select a view and navigate](#select-a-view-and-navigate) to choose **Current**, **Archived**, or **Graphs**. ## My Desk filter choices Filtering starts from **Filter**, which opens the filter-column menu for the current My Desk area. ### Prerequisites - You are on `/my-desk`. - You have selected the My Desk area whose columns you want to filter. ### Steps 1. Select **Filter** in the My Desk toolbar. 2. Choose from the filter-column menu. **Result:** The filter-column menu is open for the selected My Desk area. The My Desk toolbar provides **Filter** as the available filter entry point. Layout, row-filter, group-filter, import, and export settings are unavailable in this view. Continue with [Select a view and navigate](#select-a-view-and-navigate) to choose the entries or graphs you want to review. ## Select a view and navigate **Current** is the My Desk list of current entries. **Archived** is the list of archived entries. **Graphs** is the graph view. ### Prerequisites - You are signed in. - You are on `/my-desk`. ### Steps 1. Select a My Desk view. | View | Destination | |---|---| | **Current** | List entries | | **Archived** | Archived entries | | **Graphs** | Graph view | 2. Review the selected view. ![Current list entries in My Desk](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2c8ce586a7a179ff95e876d7282cd950.png) Review archived entries next. ![Archived list entries in My Desk](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d6db9951f7d04455483763db7d3b5716.png) Review graph work next. ![Graph work in My Desk](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f2f5de4fabcfaf01d98bfc29a5ae29c1.png) **Result:** You have selected **Current**, **Archived**, or **Graphs**, and remain on My Desk at `/my-desk`. The visible controls can vary with your role, subscription, and layout. Read [Handle role, subscription, and layout differences](#handle-role-subscription-and-layout-differences) before troubleshooting a different view. ## Handle role, subscription, and layout differences Navigation surfaces depend on role and subscription. A different set of tabs can mean that you are a principal user, your role has no dashboard, or your subscription does not include a My Desk feature. | Difference | What you can expect | |---|---| | No Home dashboard | Home shows the no-dashboard message instead of the dashboard library. | | Principal user | My Desk uses its principal-user view. | | Standard user | My Desk uses the standard view when you are not a principal user. | | No My Desk subscription feature | My Desk content that depends on that feature does not appear. | | No Tasks module | **Tasks** does not appear. | | No Activities module | **Activities** does not appear. | | No My Desk Calendar feature | **Calendar** does not appear. | | No Home dashboard tab | The dashboard library does not appear because it requires at least one dashboard tab. | When Home has no dashboard, it displays `Your role has no dashboard` and `Kindly, Contact your administrator to define a dashboard`. Use these conditions to distinguish an expected role or subscription difference from a navigation problem. Do not infer which account-specific records belong in a list from this page. The next step is to compare the visible surface with these conditions. ## When navigation does not match Start with the work area and feature conditions above. Some principal-report columns and My Desk list areas depend on the layout available to your account. If My Desk shows page text but no selectable controls, wait for the available work-area tabs to appear. | What you see | What to do | |---|---| | Home has no dashboard | Treat it as the role's dashboard fallback. Home displays the no-dashboard message when the role has no dashboard. | | A dashboard area or My Desk block differs | Check the role, principal-user status, subscription features, and selected work view. | | A dashboard column or My Desk layout is incomplete | Wait for the account's available layout to finish loading. | | A control is absent from My Desk | Check the available **Current**, **Archived**, and **Graphs** tabs, then confirm the role and feature availability. | | A save or restore action reports success | The product message is `Your request was completed successfully`. | | An action reports an error | The product message is `An error occurred while processing your request`. | | Standard-tab restoration asks for confirmation | The product asks `Are you sure you want to replace your tabs with standard tabs?` before restoration. | If the visible surface still does not match these conditions, use the focused page for that work area or ask your PAMS administrator to confirm the role and subscription. ## Continue from the work area After you choose a work area, continue with the page that owns the next task: | Starting point | Continue with | |---|---| | Home dashboard orientation | [Personalizing your workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/personalizing-your-workspace) for dashboard and workspace changes. | | My Desk workspace orientation | [My Desk workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-workspace) for the complete workspace map. | | My Desk activities | [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities) for activity work. | | Reports | The Reports area for report-tab and widget navigation when Reports is available to your role. | ### Out of scope These parsed messages belong to embedded panels owned by the named page, not to navigation orientation. | Class | Message | Owning page | |---|---|---| | Error | Please choose one or more principals | Home dashboard | | Parsed message | Required Receiving Date | MRQ | | Validation | Invalid input. The value must be greater than 0 and cannot exceed 999,999.00 | Invoices | | Validation | Invalid input. Please enter a non-negative value | Invoices | | Error | This record is related to saved data and cannot be deleted | My Desk tasks | | Error | Forbidden characters detected. Please remove them and try again. | My Desk activities | | Error | Action not allowed | My Desk activities | | Error | An account with this name already exists | Accounts | | Error | Error: Vendor not saved yet | Accounts | | Error | Error: Client not saved yet | Accounts | | Error | This Field Is Required | Accounts | | Parsed message | This field is required | Accounts | | Parsed message | You already have a contact with this name | Accounts | | Error | One topic and at least one note is required | My Desk activities | | Success | Custom fields saved successfully | Sales job | | Success | Job updated successfully | Sales job | | Success | Job deleted successfully | Sales job | | Success | Job regretted successfully | Sales job | | Success | Job cancelled successfully | Sales job | | Success | Job missed successfully | Sales job | | Success | Job reactivated successfully | Sales job | | Success | Converted to offer successfully | Sales job | | Success | Converted to inquiry successfully | Sales job | | Error | Error saving custom fields | Sales job | | Error | Cannot be un-delivered — a due invoice already exists | Sales job | | Error | All offers must be in draft status to revert to inquiry | Sales job | | Error | A project with this name already exists | Sales job | | Error | Please save opened inquiry first | Sales job | | Error | All inquiries must be in draft stage to revert to potential | Sales job | | Parsed message | Please enter action for each milstone | Sales job | | Error | Please save opened cost sheet first | Offer details | | Error | Booked quantity for this job is greater than the required BOM quantity | Bill of materials | | Error | You cannot edit or delete the product after the purchase package is created | Bill of materials | | Error | Cannot be deleted. Product is in purchasing | Bill of materials | | Error | You cannot edit the product after the PO is created | Bill of materials | | Error | This product is already included in BOM | Products | | Error | The first variant cannot be deleted | Products | | Error | An error occurred while connecting to your CRM system. | Products | | Error | Please select one product | Products | | Parsed message | Required Receiving After | Products | | Parsed message | Package must have at least one item | Products | | Error | You cannot save without adding at least one product | MRQ | | Error | Please enter at least one email | Purchasing work | | Error | Inquiry must have at least one item | Purchasing work | | Error | Offer must have at least one item | Purchasing work | | Error | Order must have at least one item | Purchasing work | | Error | Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted | Purchasing work | | Error | Please select one or more items to create a RFQ. | Purchasing work | | Parsed message | Required Offer Type | Purchasing inquiry | | Parsed message | Required Bid Due Date | Purchasing inquiry | | Error | Error loading accounts | Delivery orders | | Error | Serial you have entered already exist and belong to same manufacturer | Reference details | | Error | There is error in serial you have entered | Reference details | | Error | Minimum: At least one serial | Reference details | | Error | Please Add Extension to activate the LG | Letters of guarantee | | Error | LG has one or more extensions or deductions and cannot be reverted to the requested stage | Letters of guarantee | | Error | Please choose a date after the current expiry date | Letters of guarantee | # Personalizing your workspace Use this page to choose the My Desk view that matches your work and, when your account provides Dashboard editing, arrange the Dashboard content you need. ## Before you start Workspace personalization means choosing a working view in **My Desk** and, where it is available, arranging content on **Dashboard**. **My Desk** is at `/my-desk`; **Dashboard** is at `/dashboard`. | Workspace surface | Includes | | --- | --- | | **My Desk** | **Lists**, **Current**, **Archived**, **Graphs**, **Tasks**, **Activities**, and **Calendar**. | | **Dashboard** | The dashboard library. | | If you need to… | Go to | | --- | --- | | Choose the list or work view for the current task | [Set your work view](#set-your-work-view) | | Understand the tabs and columns before choosing a view | [Recognize the workspace surfaces](#recognize-the-workspace-surfaces) | | Add, remove, restore, or save Dashboard widgets | [Manage widgets](#manage-widgets) | | Rename the active Dashboard tab | [Edit tabs](#edit-tabs) | | Understand why a tab or control is unavailable | [Handle workspace availability branches](#handle-workspace-availability-branches) | | Continue with task or activity work | [My Desk tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-tasks) or [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities) | | Continue with Dashboard content | [Dashboard overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) or [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog) | ## Prerequisites You must be signed in to reach My Desk or Dashboard. The controls you see also depend on your role, subscription, active Dashboard tab, and whether Dashboard is in edit mode. | Condition | What it affects | | --- | --- | | You are a non-principal user | **Filter**, **Tasks**, **Activities**, and **Calendar** can be available on My Desk. | | Your subscription includes the relevant feature | **Lists** and **Graphs** can appear; **Tasks**, **Activities**, and **Calendar** each also depend on their named feature. | | A Dashboard tab is active and editable | Tab-menu actions apply to that active tab. | | Dashboard is in edit mode | **Restore Standard Tabs**, **Add New Widget**, and **Save** can appear. | | The active tab is an Eagle View tab | The Eagle View dashboard child can appear. | > **Note:** Dashboard edit controls appear only when Dashboard is in edit mode. ## Open the workspace Open the workspace surface that contains the view or Dashboard content you need. ### Prerequisites - You are signed in. - You know whether you need a My Desk work view or Dashboard content. **Steps** 1. Select the workspace surface you need. | If you need to… | Select | | --- | --- | | Choose a My Desk work view | **My Desk** | | Work with Dashboard content | **Dashboard** | **Result:** My Desk or Dashboard is open, and you can identify the active workspace surface before changing its view. ## Recognize the workspace surfaces My Desk is where you choose a work view. Dashboard is where you work with the content on the active dashboard tab. The exact content in each area depends on your account and the active tab. | Surface | What to look for | | --- | --- | | My Desk | **Current**, **Archived**, **Graphs**, **Tasks**, **Activities**, and **Calendar**. | | Tasks | **Title**, **Owner**, **Start date**, **Due date**, **Status**, and **Importance** columns. | | Activities | **Title**, **Visitors**, **Activity purpose**, **Company**, **Start date**, **Status**, and **Importance** columns. | | Calendar | **Sun**, **Mon**, **Tue**, **Wed**, **Thu**, **Fri**, and **Sat** weekday columns. | | Dashboard | The active tab's dashboard grid and its account-dependent content. | | Eagle View | A custom Dashboard child when the active tab is Eagle View. | When Eagle View is active, its analysis choices include **Analyze**, **Clients**, **Vendors**, **Projects**, and **Market Segments**. Other choices depend on the loaded data. My Desk can show Tasks, Activities, and Contacts layouts selected at run time. Dashboard can show a run-time-selected widget list and principal-report columns. Those contents are account-specific. Continue to [Set your work view](#set-your-work-view) for My Desk, or to [Manage widgets](#manage-widgets) for Dashboard. ![My Desk Tasks with its visible columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/143dd75b9e004888d114161bd83a2f89.png) ![My Desk Activities with its visible columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/b4d94f329ff1bacc7f59e829b1b70855.png) ![My Desk Calendar with weekday columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2403e2e69c7fc758f97d2fa7701dddea.png) ## Set your work view Choose the My Desk view that matches the work you are about to do. Each choice keeps you on `/my-desk`. ### Prerequisites - My Desk is open. - The required tab is available for your role and subscription. **Steps** 1. Select one My Desk view. | If you need to… | Select | | --- | --- | | Work with the current view | **Current** | | Work with archived items | **Archived** | | Work with graph-based information | **Graphs** | | Work with tasks | **Tasks** | | Work with activities | **Activities** | | Work with calendar information | **Calendar** | 2. Confirm that the selected tab is active and that the address remains `/my-desk`. **Result:** The selected My Desk view is on screen, and the address remains `/my-desk`. ![My Desk Current selected](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/4d569dab76496e847e886d7a49b5ba0a.png) ![My Desk Archived selected](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c5fd115bdc3310d5bd18042cdffd13cf.png) ![My Desk Graphs selected](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/aa5993093fe8b93e4eccf25f2c4d6a8c.png) ## Manage widgets Use Dashboard widget management when Dashboard is in edit mode and the active tab is editable. A widget is a piece of content placed on that tab. ### Prerequisites - Dashboard is open. - **Add New Widget**, **Save**, and **Restore Standard Tabs** are visible. - The tab you want to change is active and editable. **Steps** 1. Select **Add New Widget**. 2. In the `Select widget` dialog, select the widgets to add. 3. If you want every available widget, select **Select all**. 4. Select **OK**. 5. Open the active tab's widget menu. 6. If you want to remove a widget, select **Remove widget from tab**. 7. If you want to restore the standard tabs, select **Restore Standard Tabs**. 8. Select **Save**. **Result:** The active Dashboard tab contains the selected widget arrangement after you select **Save**. Widget changes are saved through Dashboard **Save**. ### Edit tabs Use tab editing to change the name of the active editable Dashboard tab. Tab-menu actions remain scoped to the active tab. ### Prerequisites - Dashboard is open. - The target tab is active and editable. - The tab edit menu is available. **Steps** 1. Open the menu for the active Dashboard tab. 2. Select **Rename tab** to open the tab-name editor. 3. Enter a name in the **New Tab** field. **Result:** The active tab menu remains scoped to the active tab. The **New Tab** field is required in both the add-tab and edit-tab dialogs. If you leave it empty, the validation text is `This Field Is Required`. The tab edit controls are conditional, so follow [When a workspace change does not appear](#when-a-workspace-change-does-not-appear) if the menu is unavailable. ## Handle workspace availability branches Workspace choices change when your role, subscription, feature access, or active Dashboard tab changes. Use the following conditions to interpret the choices on screen. | Workspace choice or control | Available when | | --- | --- | | **Filter** | You are not a principal user. | | **Lists** and **Graphs** | Your subscription is included for those views. | | **Tasks** | `TasksModule` is available and you are not a principal user. | | **Activities** | `ActivitiesModule` is available and you are not a principal user. | | **Calendar** | `MyDeskCalendar` is available and you are not a principal user. | | Eagle View | The active tab is an Eagle View tab. | The global and single-branch view choices are not available choices. The My Desk refresh control is also not an available control. Dashboard's edit-menu entry that would enable editing is not an available menu entry. If a needed choice is absent, check the role, subscription, feature access, and active tab before asking for help. ## When a workspace change does not appear Use this table when the surface on screen differs from the choice you expected. | What you see | What to do | | --- | --- | | Dashboard edit controls are absent | Check whether Dashboard is in edit mode and whether the active tab is editable. If **Add New Widget**, **Save**, and **Restore Standard Tabs** are absent, continue with Dashboard configuration or [Getting help](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/getting-help). | | The Dashboard widget list differs | Treat the visible list as account-dependent and continue with [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog). | | Principal-report columns differ | Treat the visible columns as account-dependent and continue with [Dashboard overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview). | | My Desk filter rows or Lists/Contacts columns differ | Work from the rows and headers visible in your account, then continue with [My Desk workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-workspace). | | You cannot identify the client selection list, task text filter, or widget search field | Use the surrounding surface and its visible controls; these controls use their position and contents rather than a visible field label. Continue with [Getting help](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/getting-help) if you cannot proceed. | | A dialog or message appears while editing | Continue with the owning page or [Getting help](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/getting-help) rather than treating the message as a workspace-view change. | | A tab-name field rejects an empty value | Enter a tab name in **New Tab**. The validation text is `This Field Is Required`. | ## Out of scope This page covers choosing a workspace view and the conditional Dashboard personalization controls. Use the owning pages for the detailed procedures below. ### Messages This page includes only the Dashboard tab validation message. Messages owned by My Desk task and activity work, or by other application areas, belong to their owning pages and are outside this workspace-personalization scope. | Need | Owning page | | --- | --- | | Work with My Desk tasks | [My Desk tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-tasks) | | Work with My Desk activities | [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities) | | Understand detailed Dashboard widget content | [Dashboard overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) and [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog) | | Configure default layouts or Dashboard settings | [Configuration default layouts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-default-layouts) and [Configuration Dashboard settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings) | | Handle messages outside My Desk or Dashboard workspace scope | The page that owns that feature | ## Continue from your workspace After you choose a view, continue with the page that owns the work on that surface. This keeps workspace selection separate from the detailed task. ### Prerequisites - You have selected a My Desk view or opened Dashboard. - You know the next task you need to complete. **Steps** 1. Select the destination that matches your next task. | If you are continuing with… | Open | | --- | --- | | The My Desk workspace map | [My Desk workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-workspace) | | A My Desk task | [My Desk tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-tasks) | | A My Desk activity | [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities) | | Dashboard purpose and overview | [Dashboard overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) | | The widget catalog | [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog) | | Dashboard configuration | [Configuration Dashboard settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings) | | Help with a workspace problem | [Getting help](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/getting-help) | **Result:** You are on the page that owns the next workspace, task, widget, configuration, or help action. ## Related Choose the related page by the surface and task you need. The available workspace choices can differ by role or subscription. - [Understanding the interface](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/understanding-the-interface) explains broader screen recognition. - [Navigation basics](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/navigation-basics) explains wider route and work-area navigation. - [My Desk workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-workspace) owns the complete My Desk workspace map. - [My Desk tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-tasks) owns task work. - [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities) owns activity work. - [Dashboard overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) owns Dashboard purpose and overview. - [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog) owns detailed widget coverage. - [Configuration default layouts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-default-layouts) owns administration of default layouts. - [Configuration Dashboard settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings) owns Dashboard configuration. - [Getting help](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/getting-help) owns support routing. # Basic terminology Use this page to recognize the terms, headings, time ranges, and sorting labels on the signed-in PAMS Home dashboard. ## What these terms mean **Dashboard** is the Home surface that groups business-development and sales-pipeline information. **Principals Report** is its other visible top-level heading. The remaining terms name sections, measures, or work categories on that surface. | If you need to… | Go to | |---|---| | Understand the Home route and the conditions that affect what you see | [Before you start](#before-you-start) | | Match a heading, time range, or sorting label to its PAMS wording | [Read the dashboard terms](#read-the-dashboard-terms) | | Compare your screen with the dashboard surface | [Read the current dashboard](#read-the-current-dashboard) | | Understand no-dashboard messages and dashboard choices that were not part of the current view | [Messages and unavailable choices](#messages-and-unavailable-choices) | | Understand the broader Home and Dashboard orientation | Understanding the interface | | Learn how to reach Home and Dashboard | Navigation basics | | Learn dashboard capabilities and widget orientation | Dashboard overview | | Learn how to change your workspace | Personalizing your workspace | | Learn sales-stage terminology | [Sales jobs lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle) | ## Before you start Home is the signed-in PAMS dashboard at `/home`. Its content depends on the dashboard state available to your account. **Prerequisites** - Have access to the PAMS sign-in flow. - Be signed in before opening Home. **Steps** 1. Open `/home`. 2. Confirm that **Dashboard** is visible. 3. Check the dashboard state. | If you see | The state is | |---|---| | Dashboard tabs | A custom dashboard with at least one tab | | A no-dashboard message | Your role has no dashboard | ![Signed-in Home at the /home route with the dashboard headings](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c0412e66205334ca9d219c53758132ce.png) **Result:** Home is on screen at `/home` with the dashboard state available to your account. ## Read the dashboard terms Read each dashboard term as the exact heading or label PAMS places on Home. The table groups the terms by dashboard area. | Dashboard area | Terms to recognize | |---|---| | Top-level headings | **Dashboard**; **Principals Report** | | Time ranges | **Today**; **Next 10 days**; **Last 10 days** | | Business and sales sections | **Business development**; **Sales Pipeline** | | Booking and pipeline sections | **Booking This Year**; **Accounts in Sales Pipeline** | | Team sections | **Teams Booking vs. Target**; **Teams Running Offer** | | Tendency sections | **Branch Tendency to Target**; **Principals Tendency to Target** | | Booking comparison sections | **Branch Booking vs. Target This Year**; **Principals Booking vs. Target This Year** | | Running-offer sections | **Branch Running Offers**; **Principals Running Offers** | Within the visible dashboard, **Booking This Year** includes **Equivalent**, **Target**, **Achieved**, and **Forecast**. **Accounts in Sales Pipeline** includes **Clients** and **Principals**. These labels identify the measures or groups in those sections; their values come from current dashboard data. The **Sales Pipeline** section also shows **Potentials**, **Inquiries**, **Budget offers**, **Firm offers**, and **Orders**. Use the exact capitalization and wording shown in PAMS for these work categories. The visible sorting labels are **Sort by Booking**, **Sort by Target**, and **Sort by Achievement**. None has a required marker on Home. ![Dashboard headings, time ranges, sections, and sorting labels](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/92c84c4d1016e6185b3a63a6d8c80ec6.png) For dashboard areas and widgets, see Dashboard overview. For sales-stage terms, see [Sales jobs lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle). ### Read the current dashboard The current dashboard displays the headings, sections, measures, work categories, and time ranges listed above. It also displays **Sort by Booking**, **Sort by Target**, and **Sort by Achievement**. None carries a required marker. **Prerequisites** - Be signed in and have Home open at `/home`. **Steps** 1. Compare the visible dashboard with the dashboard-terms table. **Result:** You can identify the terms on the current Home dashboard. ## Messages and unavailable choices PAMS can show a no-dashboard message instead of the dashboard surface. The message identifies the role condition, and its guidance tells you who to contact. | What appears | What it means | |---|---| | `Your role has no dashboard` | PAMS reports that the signed-in role has no dashboard. | | `Kindly, Contact your administrator to define a dashboard` | The page directs you to your administrator to define a dashboard. | When dashboard editing is available, use these controls: | Purpose | Control | |---|---| | Restore standard tabs | **Restore the Standard Tabs**; **Restore** | | Leave or save editing | **Cancel**; **Save** | | Work with widgets and tabs | **Widget**; **Rename tab**; **Delete tab**; **Search for widget** | | Remove a tab permanently | **Ultimate delete**; **Delete** | These controls belong to dashboard editing, not to the read-only Home dashboard. The following choices are not part of the Home dashboard surface: - The separate branches view does not render. - **Sales Report** and **Eagle View** are not present in the Home toolbar. - The MRM tab list and its add-tab link are not present in the dashboard library. Do not treat those unavailable choices as dashboard terms. For dashboard and workspace changes, see Personalizing your workspace. Widget labels and report columns can vary, so use the headings and labels visible on your own Home surface. These messages appear on dashboard actions or related surfaces: | Message | Where to use it | |---|---| | `Are you sure you want to replace your tabs with standard tabs?` | Restore confirmation | | `Are you sure you want to ultimately delete this tab and all it's content ?` | Delete-tab confirmation | | `Your request was completed successfully` | Common success result | | `An error occurred while processing your request` | Common processing error | | `Please choose one or more principals` | Principal-selection message | | `Incorrect username or password` | Sign-in page message, not a Home-dashboard term | | `This Field Is Required` | Required-field validation message | # Principals Report Use the Principals Report to prepare a report for selected accounts, choose its reporting period and content, generate it, and download it as a PDF. ## Principals Report overview The Principals Report is a Dashboard report tab for reviewing account-related sales information in one report. Select one or more accounts, choose the period and report sections, and prepare charts or detail lists for those accounts. The report settings group the available output into report sections and list variants. Report sections include narrative content, charts, an overall analysis, and lists. List variants are the inquiry, offer, order, delivered, lost, and cancelled job lists. | If you need to… | Go to | |---|---| | Understand the Dashboard area that contains the report | [Dashboard overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) | | Prepare the account selection and report name | [Before you start](#before-you-start) | | Recognize the controls on the report page | [Open the report and identify its controls](#open-the-report-and-identify-its-controls) | | Choose a period and report content | [Set the reporting period and report options](#set-the-reporting-period-and-report-options) | | Add narrative content | [Add introduction and outline content](#add-introduction-and-outline-content) | | Generate and review the report | [Generate and read the report](#generate-and-read-the-report) | | Narrow a detail list | [Filter an available detail list](#filter-an-available-detail-list) | | Diagnose a stopped generation attempt | [When report generation fails](#when-report-generation-fails) | | Download the report or continue to broader report navigation | [Continue from the report](#continue-from-the-report) | ## Before you start The report is prepared from selected accounts and a report name, rather than from a business record that you save. Have the account records you want to include available for selection. | Have or know | Why it matters | |---|---| | One or more account records | **Accounts** is required and accepts multiple selections. | | A report name | **Report** is required. | | Access to the qualifying Dashboard tab and subscription condition | The report page appears only when the Dashboard tab and subscription condition allow it. | Open it from the Dashboard reporting flow. The Principals Report appears when the Dashboard is on the qualifying report tab and the subscription condition allows it. ## Open the report and identify its controls The Principals Report page is the report setup surface. Its main controls identify the accounts, report name, period, settings, narrative content, generation action, and PDF action. **Prerequisites** - Have access to the Dashboard report tab. - Have the accounts and report name ready. **Steps** 1. Open the Principals Report from the Dashboard reporting flow. 2. Locate **Accounts** for the account selection. 3. Locate **Report** for the report name. 4. Locate **Time Frame** for the reporting period. 5. Select one of the report actions in this table. | Action | Purpose | |---|---| | **Settings** | Configure report sections, charts, and lists. | | **Introduction & Outline** | Prepare the narrative sections. | | **Generate Report** | Start report generation. | | **Download as PDF** | Download the report as a PDF when it is ready. | ![The Principals Report controls for accounts, report name, time frame, settings, narrative content, generation, and PDF output](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3ec7419c5ea2bb5a616cf926fdbf193f.png) **Result:** The Principals Report setup controls are on screen, including **Accounts**, **Report**, **Time Frame**, **Settings**, **Introduction & Outline**, **Generate Report**, and **Download as PDF**. ## Set the reporting period and report options The reporting period limits the dates used by the report. The settings determine which report sections, charts, and lists are included before generation. **Prerequisites** - Open the Principals Report. - Select the accounts and enter the report name. **Steps** 1. In **Time Frame**, follow the applicable row. | If you need to report on… | Select or enter | |---|---| | The current year | **This Year** | | A named calendar year | **Definite Year**, then a year from `1990` through the current year | | The previous twelve-month period | **last 12 months** | | A custom date range | **From / To**, then the first date in **From** and the last date in **To**; check that **From** is not later than **To** | 2. Select **OK** in the time-frame popup. 3. Select **Settings**. 4. Select the report content options from the table. | If you need to include… | Select | |---|---| | All available report settings | **All** | | Running-job content | **Running jobs** | | Running firm-offer status | **Status of running firm offers** | | Running-order status | **Status of running orders** | | Lost-job reasons | **Reasons for lost jobs** | | Booking trends | **Bookings over time** | | Detail lists | **Show Lists** | | Account-based filtering | **Client** | | Product-based filtering | **Product Type** | 5. When a chart is enabled, choose its chart type from **Bar** or **Pie**. 6. When **Bookings over time** is enabled, choose **Monthly** where that period is required. 7. Select **OK** in the settings popup. The chart choices appear only when the related chart is enabled. **Running jobs** is a settings option that is disabled in **Settings**. Valid changes to saved settings can require the report to be generated again. ![The Principals Report page with its report setup controls and available actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/be7d28e636dbe3611625fb89c37a4044.png) > **Note:** The choices in **Accounts** depend on the accounts available to you. **Result:** The report has a selected time frame and saved report options for its sections, charts, lists, account filter, and product filter. ### Add introduction and outline content The Introduction & Outline popup holds the narrative sections that accompany the report's figures and lists. **Prerequisites** - Open the Principals Report. - Set the reporting period and report options. **Steps** 1. Select **Introduction & Outline**. 2. Enter the report introduction under **Introduction :**. 3. Enter the sales discussion under **Sales Analysis :**. 4. Enter the lost-opportunity discussion under **Lost Opportunities and Competition :**. 5. Enter the complaints and difficulties under **Client Complaints and Difficulties :**. 6. Enter the improvement proposals under **Suggestions for Business Improvement :**. 7. Enter the booking expectations under **Booking Forecast :**. 8. Enter the closing text under **Conclusion :**. 9. Confirm the entries in the report introduction and outline popup. **Result:** The report introduction and outline content is prepared for the report. ## Generate and read the report The generated report brings together the enabled charts, summaries, section navigation, and available detail lists. The report sections are conditional: a section appears when its report setting and report data allow it. **Prerequisites** - Select the accounts and enter **Report**. - Set **Time Frame** and **Settings**. - Complete **Introduction & Outline** when narrative content is required. **Steps** 1. Select **Generate Report**. 2. Use the report navigation entries to move to **Running Jobs**, **Status of running firm offers**, **Status of running orders**, **Sales Overview**, **Reasons for lost jobs**, **Status of submitted offers**, **Bookings over time**, **Deliveries over time**, or **Overall Analysis**. 3. In the job summaries, read **Jobs (Count)** and **Jobs (Value)**. 4. In the submitted-offer summary, read `Hit Rate (count)` and `Hit Rate (value)` when submitted-offer data is available. 5. In **Overall Analysis**, use the time view and client view to compare submitted offers and received orders by count and value. 6. Select a report section to read its charts and summaries. **Result:** The report view contains the enabled report sections and their available charts, summaries, and analysis views. **Generate Report** is disabled while the report is ready or while generation is in progress. The chart and setup controls are shown before a report is generated. ### Filter an available detail list Detail lists show job information grouped by the report list selected in settings. Each available list provides a filter row and a filter at the column heading. **Prerequisites** - Generate a report with **Show Lists** selected. - Open a list that is available in the generated report. **Steps** 1. Select the detail list that matches the work you need to review. | If you need to review… | Select | |---|---| | Current inquiries | `Current inquiries` | | Current offers | `Current offers` | | Current orders | `Current orders` | | Completed deliveries | `Delivered jobs` | | Lost work | `Lost jobs` | | Cancelled work | `Cancelled jobs` | 2. Enter a value in the filter row to narrow the list. 3. Use the filter at the column heading for a column-specific filter. 4. Read the columns available in the selected list, such as **Job no.**, **Client**, **Offer price**, **Order price**, **Backlog**, **Expected delivery date**, **Lost reason**, and **Cancellation reason**. **Result:** The selected detail list is narrowed by its filters, and its visible headers identify the job information available in that list. ## When report generation fails Report generation checks the required inputs before it processes the report. A missing account selection has a report-specific validation message; a processing failure uses a general error message. | What appears | What to do | |---|---| | `Required` | Complete the required field marked on the report setup form. | | `Please choose one or more principals` | Select one or more records in **Accounts**, then generate the report again. | | `An error occurred while processing your request` | Review the report inputs and submit the report again. | The report-specific account-selection check applies when no principal or client is selected. The general processing message identifies a processing failure rather than a particular field. ## Continue from the report After the report settings are valid, the report provides a PDF action for continuing from the report view. The PDF action follows the report's generated state and calls the download path. **Prerequisites** - Have valid report settings. - Have generated report content available for download. **Steps** | If | Consequence | |---|---| | The generated report is available | The PDF is available for download. | | Valid saved settings require another generation | The PDF is unavailable until the report is generated again. | 1. If valid saved settings require another generation, select **Generate Report**. 2. After the generated report is available, select **Download as PDF**. 3. Open the broader **Reports** area when you need the application's other report navigation. **Result:** The report's PDF download action is available from the generated-report state, and the broader **Reports** area remains available for other report navigation. # Reports ## Reports overview A report widget is a report panel that displays report content. A report tab is a saved grouping of report widgets, and the active report tab is the grouping you are currently reviewing. A widget chooser is the area for choosing widgets for a tab. Reports is the hub where you review these widgets, change their reporting period, and organize the widgets shown on a tab. It also provides search and time-frame controls. | If you need to… | Go to | |---|---| | Reach the reporting workspace | [Open Reports](#open-reports) | | Recognize the active tab and its widgets | [Understand the Reports screen](#understand-the-reports-screen) | | Change the period used by report widgets | [Choose a report time frame](#choose-a-report-time-frame) | | Open or close several widgets | [Review and organize report widgets](#review-and-organize-report-widgets) | | Diagnose an unavailable report surface or validation message | [Handle report branches and errors](#handle-report-branches-and-errors) | | Check a missing control or unexpected result | [When Reports does not show what you need](#when-reports-does-not-show-what-you-need) | | Read the wider dashboard workspace | [Dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) | | Identify available dashboard widget groups | [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog) | | Review management-report widget details | [Management report widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/management-report-widgets) | | Configure report settings | [Reports settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reports-settings) | The tabs and widgets depend on the reports prepared for the current dashboard, the active tab, and the selected widget state. Use the related pages for the broader dashboard, widget catalogue, management-report detail, or report configuration. > **Note:** A report widget is available only when its report-tab and widget conditions are > satisfied. A page that has loaded can therefore contain a different set of report content > from another user's page. ![Report tabs, the active report area, and the Time Frame control](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e18500c16bd669c9bde120c6f7d0fc4f.png) ## Before you start The Reports screen is assembled from available dashboard tabs and the tab that is active. These conditions determine which area you can use: | What determines availability | What you see when it applies | |---|---| | Dashboard tabs are available | The Reports library is shown when dashboard tabs exist. | | No dashboard is available | A no-report message branch is used instead of the library. | | The subscription includes the report area | Report tabs and their active report tab can be shown. | | The subscription does not include the report area | A subscription alternative is shown instead of the report library. | | A visible tab is active | The active tab's report content can be shown. | | The active tab has selected widgets | The widget body can be shown. | | A widget is opened | That widget's content can be shown. | | A time-frame dialog uses **Definite year** | The year field is required, with a minimum of `2024` and a maximum of the current year. | Before you start, sign in and know which period you want to review. The available report content depends on the tabs and widgets prepared for your dashboard, so the page may show a different library or widget set for another account. ## Open Reports Reports is the signed-in reporting workspace at `/reports`. When it loads, look for the page title **Reports**, report tabs, and report content such as a report widget. **Prerequisites** - You are signed in. **Steps** 1. Open `/reports`. 2. Confirm that the page title is **Reports**. 3. Confirm that report tabs and report content are visible. **Result:** The Reports hub is open with the available report tabs and report content. The **Time Frame** control is available on the loaded page. ## Understand the Reports screen The widget area contains the selected widgets in the active report tab. | Screen area or control | What it is for | When it appears | |---|---|---| | Report library | Holds the available report tabs and report-tab content | When dashboard tabs exist | | Report tabs | Switches between available tab groupings | When the subscription and library conditions allow them | | Active report tab | Identifies the tab whose widgets are being reviewed | When a tab is active | | Widget area | Shows the selected report widgets | When selected widgets exist | | Widget body | Shows an opened widget's content | When the widget is opened | | Widget chooser | Lets you choose widgets for a tab | In the popup for choosing dashboard widgets or changing a widget | | Search field | Narrows the widgets in the active visible tab | When the subscription, active-tab, and widget conditions allow search | | **Time Frame** | Opens the report-period choices | When the page is not in edit mode | The search field is available only when the subscription permits the area, a visible tab is active, and that tab has widgets. The tab title field is required in both the add-tab and edit-tab popups. The active tab can expose the tab actions **Extend all** and **Collapse all**. The report screen also groups popup states for adding a tab, choosing dashboard widgets, editing a tab, choosing a time frame, changing a widget, and editing a month-based report. ## Choose a report time frame The report time frame tells the report area which period to use while you review its widgets. Use the **Time Frame** control when you need to inspect another supported period. **Prerequisites** - Reports is open. - The **Time Frame** control is available. **Steps** 1. Select **Time Frame**. 2. In the dialog, choose a period from this table. | If you need to review… | Select | |---|---| | The current year | **This year** | | A specific year | **Definite year** | | The preceding twelve-month period | **last 12 months** | 3. If you selected **Definite year**, enter a year from `2024` through the current year in the year field. 4. Select **OK**. 5. Check the value shown by **Time Frame**. **Result:** The dialog closes after confirmation, and the **Time Frame** area shows the selected period when the change is applied. ![The Time Frame dialog with its period choices](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/99253ca35296af90587b0dcb0eebf873.png) ![The Reports page after the time-frame interaction](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/99253ca35296af90587b0dcb0eebf873.png) ## Review and organize report widgets Review the report panels in the active tab in the normal tab view. Organize them only when the applicable tab, widget, or edit mode exposes the action. **Prerequisites** - Reports is open with an active visible tab. - The active tab contains selected widgets for widget review. **Steps** 1. Use the applicable action in this table. | If you need to… | Do this | |---|---| | Open all selected report widgets | Select **Extend all**. | | Close the opened report widgets | Select **Collapse all**. | | Narrow the widgets in the active tab | Enter text in the search field. | | Choose widgets for the tab | Open the widget chooser. | | Select every widget shown in the chooser | Select **Select all**. | | Prepare to remove a widget in edit mode | Open the widget menu. | | Remove a widget in edit mode | Select **Remove widget from tab**. | | Change the active tab's title in edit mode | Select **Rename tab**. | | Complete the active tab's title change | Complete the required tab-title field in the edit-tab popup. | | Remove the active tab in edit mode | Select **Delete tab**. | **Result:** The active tab shows the widget expansion, collapse, search, selection, rename, or deletion result associated with the action that was available. **New Tab** uses the required tab-title field when a new tab is added. ## Handle report branches and errors Reports can show a different branch when dashboard, subscription, widget, tab, or popup conditions differ from the normal loaded screen. Use the visible branch to choose the next reader action. | What the branch means | What is available | |---|---| | No dashboard is available | The no-dashboard message branch appears. | | The subscription does not include the report area | The subscription alternative appears, with **Back** available in that branch. | | A tab is not active | Its report-tab content is not selected for display. | | No widgets are selected | The widget body is not shown. | | A widget is closed | Its widget body is not shown until the widget is opened. | | A widget chooser popup is active | The chooser is shown for choosing dashboard widgets or changing a widget. | | A shared popup is active | The popup may offer **Save**, **Cancel**, **Don't Save**, **Upload**, **No**, **Yes**, or **Ok**, according to its popup type. | The report-tab template does not mount cash-position or cash-flow widget components in the listed report-tab area. **Global view** and **Single view** are not available as mounted choices in this screen. The report screen therefore follows the active tab, widget, and popup branches rather than presenting those choices as general Reports controls. ## When Reports does not show what you need Start with the condition that matches the missing surface, then check the message if the screen asks for a value. | What you see | What to check | Message or next action | |---|---|---| | The report library is absent | Dashboard tabs and subscription availability | The library requires dashboard tabs; the subscription alternative uses its own branch. | | A widget body is absent | An active tab, selected widgets, and whether the widget is opened | Open the applicable widget or use the widget chooser when that surface is available. | | The tab-title field is empty | The add-tab or edit-tab popup | The required-field message is `This Field Is Required`. | | **Definite year** has no year | The year field in the time-frame dialog | The validation message is `Required`. Enter a year from `2024` through the current year. | | A request succeeds | The action's completion message | `Your request was completed successfully` | | A request fails | The request error message | `An error occurred while processing your request` | Reports can show report content without the subscription alternative. When a report widget is selected and opened, use its widget-specific controls in that widget's report area. ## Continue from Reports Continue to the related page that matches your next task: | If you need to… | Continue to | |---|---| | Work in the broader dashboard workspace | [Dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) | | Identify available widget groups | [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog) | | Review management-report widget detail | [Management report widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/management-report-widgets) | | Configure report settings | [Reports settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reports-settings) | # Sales job lifecycle Use this page to identify a sales job's current position, choose the work list for the next action, and follow the job to its next stage or outcome. ## Sales job lifecycle at a glance A sales job is work that progresses from **Potentials** through **Inquiries**, **Offers**, **Orders**, and **Delivered**. **Potentials** is the opening stage in the sales-job route. ```mermaid stateDiagram-v2 [*] --> Potentials Potentials --> Inquiries: convert potential Inquiries --> Offers: convert inquiry Offers --> Orders: convert offer Orders --> Delivered: deliver all active orders Inquiries --> CancelledInquiries: cancel inquiry Offers --> RegrettedToOffer: regret to offer Offers --> CancelledOffers: cancel offer Orders --> CancelledOrders: cancel order Orders --> RejectedOrders: reject order Potentials --> Missed: mark missed Inquiries --> Lost: mark lost Inquiries --> DeletedInquiries: delete inquiry ``` The active route is **Potentials** → **Inquiries** → **Offers** → **Orders** → **Delivered**. The outcome branches are separate destinations: **Missed**, **Regretted to Offer**, **Cancelled Inquiries**, **Cancelled Orders**, **Rejected Orders**, **Lost**, and **Deleted Inquiries**. | If you need to… | Go to | |---|---| | Find a job in an active or archived work list | [Find the job and its current work list](#find-the-job-and-its-current-work-list) | | Choose a list for the work you need to do | [Choose the list for the work you need to do](#choose-the-list-for-the-work-you-need-to-do) | | Read the stage tabs on a saved record | [Read the job's lifecycle position](#read-the-jobs-lifecycle-position) | | Understand the normal conversion route | [Follow the happy path](#follow-the-happy-path) | | Review an alternate outcome | [Handle exits and alternate branches](#handle-exits-and-alternate-branches) | | Fix a blocked conversion or delivery route | [When the route goes wrong](#when-the-route-goes-wrong) | | Continue with related work | [Continue the work](#continue-the-work) | ## Before you follow a sales job A saved sales job is a record that already has a place in the sales route. Before you interpret its tabs, confirm that you can reach the Sales Jobs area and that the record you need is available to you. **Prerequisites** - Your account has access to the Sales Job subscription. - A saved sales-job record is available in one of the Sales Jobs lists. - The record follows the standard sales-job route rather than a Direct Order or Instant Job route. The application shows the sales-job surface only when the Sales Job subscription is included and the page is available. The visible lists, panels, **Tasks**, **Activities**, **Attachment**, and actions vary with your access, job type, selected parties, company configuration, and the job's saved state. On the standard route, the **Potentials**, **Inquiry**, and **Offer** tabs are available as the job progresses. Direct Order and Instant Job records use a different set of tabs. If the Sales Job subscription is not included or the page is unavailable, the sales-job workspace is not the place to continue. **Note:** Opening a saved record, a stage tab, or a three-dots menu is read-only. ## Find the job and its current work list Sales Jobs separates active work from archived outcomes. Use the primary tabs to reach the part of the route you need, then open the record from its data row. **Prerequisites** - You have access to the Sales Jobs subscription. - You know whether you are looking for active work or an archived outcome. **Steps** 1. Open the Sales Jobs area. 2. Select the primary tab that matches the job's current work. | If you need to… | Select | |---|---| | Review every available sales job | **All** | | Work with early opportunities | **Potentials** | | Work with inquiries | **Inquiries** | | Work with offers | **Offers** | | Work with orders | **Orders** | | Review completed or outcome records | **Archived** | 3. If you selected **Archived**, select the outcome filter that matches the record. | Outcome | Archived filter | |---|---| | Delivered work | **Delivered** | | A lost opportunity | **Lost** | | A job returned to offer work | **Regretted to Offer** | | Cancelled inquiries | **Cancelled Inquiries** | | Cancelled orders | **Cancelled Orders** | | Rejected orders | **Rejected Orders** | | Missed opportunities | **Missed** | | Deleted inquiries | **Deleted Inquiries** | 4. Select the required data row. ![Select a sales-job row from the work list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/586c0cbaacccef78397dd14dfe66fe2f.png) The selected job opens. **Result:** The selected sales job is open, or the list shows the active or archived work list that owns your next action. ### Choose the list for the work you need to do A work list is the stage-focused list for sales jobs that need the same kind of attention. Choose it by the work you want to perform, not by a field name in the row. | If you need to… | Use this list | |---|---| | Qualify early opportunity work | **Potentials** | | Work on an inquiry before an offer exists | **Inquiries** | | Prepare or review an offer | **Offers** | | Work on confirmed order activity | **Orders** | | Review completed work or an outcome | **Archived** | The Inquiry list uses **Job No.**, **Inquiry date**, **Inquiry type**, and **Inquiry stage**. Each list can carry its own column set, so read the headers visible in the list you opened. Use the list's header filters for quick filtering and **Filter Row** for filtering from the row beneath the headers. ## Read the job's lifecycle position The saved sales-job record is the focused workspace for one job. Its stage tabs show which parts of the lifecycle are available, while **Status** and the stage-specific presentation show the position within the route. Open the record from a work-list row, then read the visible tabs and fields: | What you see | What it tells you | |---|---| | **Potentials** | The job is at the opening opportunity stage. | | **Inquiry** | The job is being handled as an inquiry. | | **Offer** | The job is being handled as an offer. | | **Order** | The job is being handled as an order. | | **Project management** | Project-management work is available for the record. | | **Delivered** | The record has reached the delivered stage. | | **Order chance** | The offer-stage record carries the order-chance value before Order. | | **Status** | The saved record's current status is shown on the record. | The record presents the tabs that its job type and saved state allow. Direct Order and Instant Job records do not present the **Potentials**, **Inquiry**, or **Offer** stage tabs. A delivered record presents **Delivered**; a record still before delivery does not use that tab as its current stage. ![Read the Potentials stage tab and its stage-specific choices](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9175badc065d26217c2b9f283c0357fb.png) ![Read the Inquiry tab, Status, and saved-record fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9b733ca4a9449ef6be4ae2754501e00c.png) ## Follow the happy path The happy path is the normal route for a sales job that continues from an early opportunity to delivery. Each conversion carries the work forward to the next focused stage page. **Prerequisites** - A saved sales job is open. - The record is at the stage whose conversion you want to follow. - The active items and stage information are ready for the next conversion. **Steps** 1. Follow the conversion that matches the current stage. | Current stage | Action | Next stage or result | |---|---|---| | **Potentials** | Convert the active Potential items. | The items are copied into the Inquiry. | | **Inquiries** | Convert the active Inquiry items. | The items move into the Offer and an **On delivery** milestone is created. | | **Offers** | Convert the Offer items and payment milestones. | The items and milestones move into the Order. | | **Orders** | Complete the delivery work on the detailed delivery page. | The job moves to **Delivered** when delivered orders equal active orders. | ![Follow the offer stage before conversion to Order](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9b733ca4a9449ef6be4ae2754501e00c.png) 2. If the conversion succeeds, confirm the message `Converted to offer successfully`. ![Follow the order stage and its delivery hand-off](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9b733ca4a9449ef6be4ae2754501e00c.png) **Result:** The sales job follows **Potentials** → **Inquiries** → **Offers** → **Orders** → **Delivered**, with each stage's detailed work continuing on its focused page. ## Handle exits and alternate branches An exit records that the job did not continue through the active route. Read the outcome list to find the record, then open the stage page that owns any recovery action. | Outcome | Stage or route context | Where to continue | |---|---|---| | **Missed** | The opportunity leaves the active route as missed work. | Missed, regretted, and cancelled jobs | | **Regretted to Offer** | Offer work returns to the regretted-to-offer outcome. | Missed, regretted, and cancelled jobs | | **Cancelled Inquiries** | An inquiry leaves the route as cancelled work. | Missed, regretted, and cancelled jobs | | **Cancelled Orders** | An order leaves the route as cancelled work. | Missed, regretted, and cancelled jobs | | **Rejected Orders** | An order leaves the route as rejected work. | Missed, regretted, and cancelled jobs | | **Lost** | The job leaves the active route as lost work. | Missed, regretted, and cancelled jobs | | **Deleted Inquiries** | An inquiry leaves the route as deleted work. | Missed, regretted, and cancelled jobs | The corresponding stage names are `CancelledInquiry` at **Inquiries**, `CancelledOffer` at **Offers**, and `CancelledOrder` at **Orders**. Use the outcome page for the archived destination and the stage page for any action that belongs to the stage itself. ## When the route goes wrong The route stops when a stage's required condition is not met. Use the exact message on screen to distinguish a draft-status restriction from a missing field, invalid item, or delivery restriction. | What you see | What it means | What to do | |---|---|---| | `All inquiries must be in draft stage to revert to potential` | An inquiry cannot revert until all inquiries are in draft stage. | Review the inquiries and use the inquiry page. | | `All offers must be in draft status to revert to inquiry` | An offer cannot revert until all offers are in draft status. | Return the offers to draft status, then retry from the offer page. | | `All orders must be in draft status to revert to offer` | An order cannot revert until all orders are in draft status. | Return the orders to draft status, then retry from the order page. | | `Cannot be un-delivered — a due invoice already exists` | A due invoice prevents reversing delivery. | Continue with the invoice page before attempting a delivery change. | | `Check mandatory field(s)` | A required field is empty. | Review the visible required fields on the current stage page. | | `One or more items has ZERO quantity` | An item quantity is zero. | Correct the item quantity on the current stage page. | | `One or more items has no unit` | An item has no unit. | Select a unit for every affected item. | | `An error occurred while processing your request` | The requested operation did not complete. | Remain on the current page and review the stage-specific values. | | `Error saving custom fields` | Custom-field saving did not complete. | Review the custom fields and save again from the record page. | The stage-menu blocks that do not appear on the page are not available choices. Use the controls shown on the current record and continue on the focused stage or outcome page instead of looking for an inline stage menu. ### Messages you may encounter The following messages belong to the sales-job record, its stage transitions, or shared work areas reached from the record. Use the context column to decide where to continue. | Context | Message | |---|---| | Custom fields | `Custom fields saved successfully` | | Save | `Job updated successfully` | | Delete | `Job deleted successfully` | | Regret | `Job regretted successfully` | | Cancellation | `Job cancelled successfully` | | Missed outcome | `Job missed successfully` | | Reactivation | `Job reactivated successfully` | | Inquiry conversion | `Converted to offer successfully` | | Inquiry conversion | `Converted to inquiry successfully` | | Regret conversion | `Converted To Regretted` | | Cancellation conversion | `Converted to cancelled` | | Lost conversion | `Converted to lost` | | Request processing | `An error occurred while processing your request` | | Custom fields | `Error saving custom fields` | | Delivery reversal | `Cannot be un-delivered — a due invoice already exists` | | Offer reversal | `All offers must be in draft status to revert to inquiry` | | Variable error | `Error {{errorMsg}}` | | Account entry | `An account with this name already exists` | | Project entry | `A project with this name already exists` | | Required field | `Check mandatory field(s)` | | Open inquiry | `Please save opened inquiry first` | | Potential reversal | `All inquiries must be in draft stage to revert to potential` | | Item quantity | `One or more items has ZERO quantity` | | Item unit | `One or more items has no unit` | | Required field | `This field is required ` | | Numeric value | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | | Numeric value | `Invalid input. Please enter a non-negative value` | | Receiving date | `Required Receiving Date` | | Receiving interval | `Required Receiving After` | | Offer type | `Required Offer Type` | | Bid due date | `Required Bid Due Date` | | Request processing | `Your request was completed successfully` | | Account or contact text | `Forbidden characters detected. Please remove them and try again.` | | Account loading | `Error loading accounts` | | Milestones | `Please enter action for each milstone ` | | Cost sheet | `Please save opened cost sheet first` | | Discount | `There is a maximum discount that exceeds the negotiation margin.` | | Gross profit | `The gross profit margin is unacceptable, and the release prices have been stopped.` | | Vendor | `Error: Vendor not saved yet` | | Client | `Error: Client not saved yet` | | Required field | `This Field Is Required` | | Contact | ` You already have a contact with this name` | | Contact text | `Just '_'‘-''.' And '&' Characters Accepted` | | Sales order | `Sales order is archived` | | Bill of materials | `Booked quantity for this job is greater than the required BOM quantity` | | Product edit | `You cannot edit or delete the product after the purchase package is created` | | Product delete | `Cannot be deleted. Product is in purchasing` | | Purchase order | `You cannot edit the product after the PO is created` | | Bill of materials | `This product is already included in BOM` | | Product variant | `The first variant cannot be deleted` | | CRM connection | `An error occurred while connecting to your CRM system.` | | Product selection | `Please select one product` | | Package | ` Package must have at least one item` | | Product list | `You cannot save without adding at least one product` | | Product quantity | `One of products has no quantity` | | Related record | `This record is related to saved data and cannot be deleted` | | Permission | `Action not allowed` | | Validation | `Check validation` | | Item selection | `No remaining items. All items have been selected` | | Branch access | `This action is only allowed if you belong to that branch` | | Email | `Please enter at least one email` | | Inquiry items | `Inquiry must have at least one item` | | Offer items | `Offer must have at least one item` | | Order items | `Order must have at least one item` | | Product deletion | `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | | Request for quotation | `Please select one or more items to create a RFQ.` | | Permission | `You don’t have permission` | | Serial | `Serial you have entered already exist and belong to same manufacturer` | | Serial | `There is error in serial you have entered` | | Serial | `Minimum: At least one serial` | | Letter of guarantee | `Please Add Extension to activate the LG` | | Letter of guarantee | `LG has one or more extensions or deductions and cannot be reverted to the requested stage` | | Letter of guarantee | `LG still needs confirmation` | | Expiry date | `Please choose a date after the current expiry date` | | Pending increase | ` There is a pending increase you can edit` | | Activity topic | `One topic and at least one note is required` | | Activity topic | `There is no topic to print` | ## Continue the work The saved job workspace keeps the shared record information together with workflow panels, items and product, and related work. After you identify the lifecycle position, move to the page that owns the next detailed action. | If you need to… | Continue with | |---|---| | Filter a list, inspect its columns, or open another record | [Find the job and its current work list](#find-the-job-and-its-current-work-list) | | Create the starting record | Create sales job | | Work with Potential items | Potentials | | Work with Inquiry items | Inquiries | | Prepare an Offer | Offers | | Confirm an Order | Orders | | Move from Order into delivery | From Orders to Delivered | | Review a missed, regretted, cancelled, lost, rejected, or deleted outcome | Missed, regretted and cancelled jobs | | Review the saved record and its common areas | Sales job record | | Follow up with **Tasks** | Sales job comments and tasks | | Review **Activities** | Sales job activities and files | | Add or review an **Attachment** | Sales job activities and files | | Continue with warehouse shipping orders | Shipping orders | | Continue with invoices associated with delivery | Invoice lifecycle | The **Tasks**, **Activities**, and **Attachment** tabs are feature-gated and appear when the corresponding subscriptions and record access allow them. Select the tab that is visible on your record; if it is not present, continue with the work area available to your account. **Prerequisites** - You have opened the saved sales job. - You know the stage, outcome, or related work you need next. **Steps** 1. Read the visible stage tab and **Status** on the saved record. 2. Select the visible tab that matches the follow-up work you need. | If you need to… | Select | |---|---| | Follow up on tasks | **Tasks** | | Review activities | **Activities** | | Add or review files | **Attachment** | **Result:** The saved record remains available while the selected stage, related work, delivery, invoice, or warehouse page holds the next task. # Find sales job work Use the Sales jobs lists to locate active work or an archived outcome, narrow the list, and open an existing sales-job record. ## Before you start A sales job is work you locate through its current list. Active lists cover **Potentials**, **Inquiries**, **Offers**, and **Orders**. The archived area groups completed or stopped outcomes. The rows are the records available in your environment, so use the rows currently shown. | If you need to… | Go to | |---|---| | Find work at an active stage | [Choose the list that contains the work](#choose-the-list-that-contains-the-work) | | Find delivered or stopped work | [Choose the list that contains the work](#choose-the-list-that-contains-the-work) | | Arrange columns or enable list filters | [Filter and narrow the list](#filter-and-narrow-the-list) | | Understand why a list or option is absent | [When a list option is unavailable](#when-a-list-option-is-unavailable) | | Work with an opened potential, inquiry, offer, or order | The focused Potentials, Inquiries, Offers, or Orders page | | Review missed, regretted, or cancelled work | [Missed, regretted and cancelled jobs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/missed-regretted-and-cancelled-jobs) | | Understand movement between sales-job stages | [Sales job lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle) | The Sales jobs entry route is the Inquiries list. It contains these tabs and the following Inquiries columns: | Area | What appears | |---|---| | List tabs | **All**, **Potentials**, **Inquiries**, **Offers**, **Orders**, and **Archived** | | Inquiries grid | **Inquiry date**, **Inquiry type**, and **Inquiry stage** | After you choose a list, use its layout and settings to narrow the rows. Selecting a row opens the sales-job record, where follow-up areas are available. ![The Inquiries list with its tabs and available rows](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c911c0b416f33bfeeb51165247425d02.png) ## Choose the list that contains the work Choose an active tab for current sales work or choose **Archived** for outcome work. | Work to review | Select | |---|---| | Review all active work | **All** | | Early opportunities | **Potentials** | | Review inquiries | **Inquiries** | | Review offers | **Offers** | | Review orders | **Orders** | | Open outcome lists | **Archived** | | Delivered work | **Delivered** | | Lost work | **Lost** | | Work regretted back to an offer | **Regretted to Offer** | | Cancelled inquiries | **Cancelled Inquiries** | | Cancelled orders | **Cancelled Orders** | | Rejected orders | **Rejected Orders** | | Missed work | **Missed** | | Deleted inquiries | **Deleted Inquiries** | ### Prerequisites - Know whether the work is active or belongs to an archived outcome. - Know the stage or outcome to review. ### Steps 1. Open the Sales jobs list. 2. Choose the list that matches your work. | If the work is… | Select | |---|---| | Active | **All**, **Potentials**, **Inquiries**, **Offers**, or **Orders** | | An archived outcome | **Archived**, then **Delivered**, **Lost**, **Regretted to Offer**, **Cancelled Inquiries**, **Cancelled Orders**, **Rejected Orders**, **Missed**, or **Deleted Inquiries** | 3. Review the rows on the selected list. ![The All list before selecting a sales-job row](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6ff7735b60138321c46b064782e51eec.png) **Result:** The list containing the required work or outcome is on screen. Continue with [Filter and narrow the list](#filter-and-narrow-the-list), or select a row to open the record. ## Filter and narrow the list The list always includes a JobStage column and gets its business columns from the saved layout for the current list. Because each list can use a different layout, use the headers currently shown on screen. ### Prerequisites - Open the list that contains the work. - Know which visible column or row characteristic identifies the record. ### Steps 1. Select **Table Layout** to open the list-layout choices. 2. Select **Columns Chooser** to change the visible columns. 3. If a column needs more room, select **Expand column width**. ![The Table Layout choices with column controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/b0aa2001ca74162c425ae33fb8f67655.png) 4. Select **Settings** to open the list options. 5. Choose a list option for your purpose. | Purpose | Select | |---|---| | Show the row-filter option | **Filter Row** | | Show the grouping option | **Group Panel** | | Prepare an export | **Export** | 6. On **All**, include archived jobs when needed. 7. Select the data row for the record you need. ![The sales-job record after opening a row](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d782b9919ca045afb1fcae36c8507772.png) The opened record provides **Comments**, **Tasks**, **Activities**, **Attachment**, **Contacts**, **LGs**, and **Last Modifications** for follow-up work. **Result:** The list is arranged or narrowed for record identification, and the selected row opens the sales-job record. Continue with the focused page for the record's stage or with the related work area you need. ## When a list option is unavailable The available lists and controls depend on the selected list, your subscription and permissions, the selected layout, and list-specific conditions. | What you see | What it means | |---|---| | Sales-job lists are available | The sales-job module is included for your subscription. | | An upgrade surface appears instead of the lists | The sales-job module is not included for the subscription. | | The main list grid appears | A selected layout is available and the current tab is supported. | | An archived outcome grid appears | The current tab is outside the active-list set. | | Archived jobs can be included | You are on **All**, outside the subscription-upgrade branch. | | Archived jobs cannot be included on **Inquiries** | The archived setting is limited to **All**. | | **Direct order** appears under **Add new** | The add-new menu is allowed for your access. Creation is outside this page. | | **Standing job** appears under **Add new** | The standing-job option is enabled for the applicable configuration. Creation is outside this page. | | Different business columns appear on different lists | The selected layout supplies the business columns for that list. | | No visible text-search panel appears | Use the available layout and settings controls. | | Business-column captions differ between lists | Business-column captions come from the selected layout and vary at run time. | The **Add new** menu and its creation options belong to creating a sales job, not finding existing work. If a list action displays a product message, it can show one of these exact messages: - `Your request was completed successfully`. - `Forbidden characters detected. Please remove them and try again.` - `Error loading accounts`. - `An error occurred while processing your request`. **Result:** Use the current tab, subscription, access condition, and selected list layout to identify why an option is unavailable and continue with the controls that are present. # Potentials A Potential is an early sales opportunity recorded before it becomes an Inquiry. You either receive the Inquiry when the opportunity continues or record the opportunity as Missed when it does not. ## Potentials Potentials is the opening stage in the Sales jobs flow. Inquiries follow Potentials, and Offers, Orders, and Delivered follow Inquiries. ```mermaid stateDiagram-v2 Potentials --> Inquiries: Receive inquiry Potentials --> Missed: Missed opportunity ``` The Potential panel is available while the sales-job surface is at the opening stage or at the Missed outcome. Select **Receive inquiry** when the opportunity continues as an Inquiry. Select **Missed opportunity** when it does not continue. | If you need to… | Go to | | --- | --- | | Start a new Potential or open an existing one | [Find and open a Potential](#find-and-open-a-potential) | | Complete the Potential fields and save it | [Create and qualify a Potential](#create-and-qualify-a-potential) | | Add or correct the item row | [Add an item to a Potential](#add-an-item-to-a-potential) | | Record that the opportunity did not continue | [Mark a Potential missed](#mark-a-potential-missed) | | Convert a saved Potential to an Inquiry | [Maintain the Potential panel and receive an inquiry](#maintain-the-potential-panel-and-receive-an-inquiry) | | Understand the complete sales-job flow | [Sales jobs lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle) | | Configure company-specific fields | [Configuration custom fields](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-custom-fields) | ![Potentials list and the Potential entry surface](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2ff8afbddbb899a2b83a5e81a95d15c2.png) ## Before you start Collect the client, vendor, and at least one item before you enter the Potential details. You need permission to edit the sales job before you save it or use its action menu. The Potential must be a saved record before **Receive inquiry** or **Missed opportunity** can appear. | Have this ready | Why it matters | | --- | --- | | The client | The Potential requires a client before it can be saved. | | The vendor | The Potential requires a vendor before it can be saved. | | At least one item | The save validation checks that `SalesItems` exists and is not empty. | | Edit permission | The action menu and its changes are available only when editing is allowed. | | A saved Potential with no unsaved changes | **Receive inquiry** and **Missed opportunity** are actions on an existing, saved Potential. | For an existing Potential, finish or discard changes before using the action menu. Unsaved changes hide the guarded actions until the record is ready. Then use [Find and open a Potential](#find-and-open-a-potential) to enter the workspace. ## Find and open a Potential Use the Sales jobs list to start a new Potential or to return to a saved Potential. **Prerequisites** - You are signed in and can edit sales jobs when you plan to create or change a record. **Steps** 1. Open the Sales jobs list. 2. Choose one entry path. | If you need to… | Select | | --- | --- | | Start a new Potential | **Add new**, then **Potentials** | | Open an existing Potential | **Potentials**, then the record in the list | 3. If you opened an existing record, open it in the edit view. **Result:** The Potential workspace is open with either a new Potential or the selected saved record. ## Understand the Potential screen The Potential screen is the sales-job workspace for the opening stage. It combines a collapsible Potential panel, its summary, identity and configured fields, the item grid, and actions for the next outcome. On a new record, the summary identifies the job as `Job No. : New`. On a saved record, the summary shows the saved job instead, and the Potential panel can offer **Receive inquiry**, **Missed opportunity**, or **Reactivate opportunity** according to the record state and edit conditions. The **Potentials** panel opens when the Potential data is available. On a saved record, select **Potentials** to collapse or reopen it. The panel body is open when its expansion state is open. The panel contains **Client** and **Vendor**, configured Potential fields, and an item grid with **Item Description**, **Unit**, and **Qty**. The saved record also provides these follow-up areas: | Tab | Use | | --- | --- | | **Comments** | Shared saved-record follow-up | | **Tasks** | Shared saved-record follow-up | | **Activities** | Shared saved-record follow-up | | **Attachment** | Saved-record files | | **Contacts** | Saved-record contacts | | **LGs** | Saved-record guarantees | | **Last Modifications** | Saved-record history | At the Potential stage, the item grid shows **Item Description**, **Unit**, and **Qty**. **Category** does not appear in this grid. The stage labels **Potentials**, **Inquiry**, **Offer**, **Order**, and **Delivered** may appear on the entry surface, but Potential work remains in the Potential panel. ![The expanded Potential panel with its summary, fields, and item grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2ff8afbddbb899a2b83a5e81a95d15c2.png) ## Create and qualify a Potential Create a Potential when you have an early sales opportunity to qualify before handing it to Inquiry. **Prerequisites** - The Potential workspace is open. - You know the client, vendor, and item information. - You can edit the sales job. **Steps** 1. In **Client**, select the client for the opportunity. 2. In **Vendor**, select the vendor involved in the opportunity. 3. Complete the available configured Potential fields. | Field group | What to complete | | --- | --- | | Identity | **Client** and **Vendor** | | Sales-job context | **Salesperson Responsible**, **Product Type**, **Job Title**, and **File Number** when shown as required | | Qualification | Select **Contact to Decision Makers** (`High`, `Medium`, `Low`); **Budget Availability** (`Available`, `In Progress`, `Not Available Yet`); **Chance in Competition** (`High`, `Medium`, `Low`); and **Order chance** (`90 %`, `70 %`, `50 %`, `30 %`, `10 %`) when those fields are available. | | Other configured fields | Any company-configured fields shown on your Potential form | 4. Add or complete an item row as described in [Add an item to a Potential](#add-an-item-to-a-potential). 5. Select **Save**. 6. Confirm that the new-record summary is no longer `Job No. : New`. The form validates the client and vendor relationship before saving. A client selection that is the same as the principal is rejected with the client-principal validation message. **Result:** The Potential is saved, and its summary shows the selected client and vendor on the saved record. > **Note:** Required markers for configured fields depend on your company settings. Complete every > field that your Potential form marks as required. ### Add an item to a Potential An item row records what the early opportunity concerns. A new Potential starts with an item row; use the row-add control when you need another row. **Prerequisites** - The Potential panel is open. - You have the item description, unit, and quantity. **Steps** 1. In the item grid, select the row-add control to create another item row when the existing row is not enough. 2. In **Item Description**, select or enter the product for the row. 3. In **Unit**, select the unit when the field is available. 4. In **Qty**, enter a quantity greater than `0` and no greater than `999,999.00`. 5. Select **Save**. The item list contains these Potential columns: | Column | Rule | | --- | --- | | **Item Description** | Required. | | **Unit** | Disabled for package items or when a product is selected. | | **Qty** | Greater than `0` and no greater than `999,999.00`; disabled for package items. | The item checks also reject a negative unit price and a negative item total price. Those price checks belong to the item validation even when the Potential grid does not display price columns. **Result:** The Potential contains an item row with a description, a usable unit where required, and a valid quantity. ### Mark a Potential missed Mark a saved Potential as Missed when the opportunity is not continuing as an Inquiry. **Prerequisites** - The Potential is saved and in the new Potential stage. - You can edit the record. - The job is not already a missed Potential and has no unsaved Potential changes. **Steps** 1. Open the Potential action menu. 2. Select **Missed opportunity**. 3. Review the missed-opportunity confirmation dialog. 4. Confirm that the saved result reports `Job missed successfully`. **Result:** The sales job leaves Potentials and is recorded as Missed. ## Reactivate a missed Potential A missed Potential can show **Reactivate opportunity**. For reactivation guidance, use [Missed, regretted, and cancelled jobs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/missed-regretted-and-cancelled-jobs). ## Maintain the Potential panel and receive an inquiry Maintain a saved Potential in its panel until the opportunity is ready to become an Inquiry. The conversion copies active Potential items into the Inquiry and hands the work to the Inquiries page. **Prerequisites** - The Potential is saved with an ID. - The Potential is in the new stage. - The job is not deleted or missed. - You can edit the record. - The Potential has no unsaved changes. **Steps** 1. Open the saved Potential record. 2. Select **Potentials** to open the panel if it is collapsed. 3. Update the Potential fields or item rows as needed. 4. If the Potential has unsaved changes, select **Save**. 5. Confirm that no unsaved Potential changes remain. 6. Open the Potential action menu. 7. Select **Receive inquiry**. 8. Confirm that the result reports `Converted to inquiry successfully`. 9. Continue the converted record on the Inquiries page. Receiving an inquiry changes the sales job to Inquiry and copies its active Potential items. The Potential panel remains available after the saved-record conversion; the next stage's work belongs to the Inquiry surface. **Result:** The sales job is an Inquiry with its active Potential items copied, ready for Inquiry work. ## Go to offer **Go to offer** belongs to Inquiry work after the Potential becomes an Inquiry. It is not a Potential action. Continue on the Inquiries page before working toward an Offer. ## When a Potential does not behave as expected Use the message you see to correct the condition before saving or repeating an action. | What you see | What to do | | --- | --- | | `Check mandatory field(s)` | Complete the required sales-job fields, including **Client**, **Vendor**, and any required configured fields, then select **Save** again. | | `Product type is required` | Select **Product Type** before saving. | | `Job title must not contain special characters` | Correct **Job Title** so it passes the title rule, then save again. | | `Client is required` | Select a value in **Client**. | | `Vendor is required` | Select a value in **Vendor**. | | `Item Description is required` | Complete **Item Description** for the affected row. | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a **Qty** greater than `0` and no greater than `999,999.00`. | | `One or more items has ZERO quantity` | Replace every zero quantity in **Qty** with a value greater than `0`. | | `One or more items has no unit` | Select a unit in **Unit** where the item requires one. | | `Invalid input. Please enter a non-negative value` | Correct the affected price so it is not negative. | | `An error occurred while processing your request` | Review the Potential values and action conditions, then retry the action on the saved record. | | `Error saving custom fields` | Review the configured fields and save them again. | | `Job updated successfully` | The saved Potential update completed. | | `Custom fields saved successfully` | The configured-field update completed. | | `Please save opened inquiry first` | Save the opened Inquiry before using the related Inquiry action. | | `All inquiries must be in draft stage to revert to potential` | Use the Inquiry page to return only an Inquiry that is still in draft stage. | | `Job missed successfully` does not appear after **Missed opportunity** | Check that the record is saved, in the new Potential stage, editable, and not already missed. | | `Job reactivated successfully` does not appear after **Reactivate opportunity** | Use [Missed, regretted, and cancelled jobs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/missed-regretted-and-cancelled-jobs) for reactivation guidance. | | The **Potentials** panel does not collapse | A saved Potential with unsaved changes raises the collapse warning. Save the changes or choose the dialog's save/discard path before leaving the panel. | | The client equals the principal | Select a client different from the principal; the Potential cannot use the same selection for both roles. | ## Messages from later sales-job and related workflows The messages below are not Potential-entry instructions. They help you recognize results and validation messages that belong to later sales-job stages, delivery, or related record maintenance. | Workflow context | Message | | --- | --- | | Later sales-job exit: deletion | `Job deleted successfully` | | Later sales-job exit: regret | `Job regretted successfully` | | Later sales-job exit: cancellation | `Job cancelled successfully` | | Inquiry progression to Offer | `Converted to offer successfully` | | Later sales-job conversion to Regretted | `Converted To Regretted` | | Later sales-job conversion to Cancelled | `Converted to cancelled` | | Later sales-job conversion to Lost | `Converted to lost` | | Delivery reversal blocked by an invoice | `Cannot be un-delivered — a due invoice already exists` | | Reverting an Inquiry when its Offers are not all draft | `All offers must be in draft status to revert to inquiry` | | Related account maintenance: duplicate name | `An account with this name already exists` | | Related project maintenance: duplicate name | `A project with this name already exists` | ## Out of scope This page covers Potential-specific work. Use the owning pages for shared sales-job header fields and the top **Save**, saved-record follow-up areas, Inquiry fields and vendor routing, later stages, wider item and pricing administration, comments and tasks, offers, orders, delivery, purchasing, invoices, payments, costing, and configuration. The Potential panel does not provide **Technical Notes**, **Commercial Notes**, or **Bid Bond** as active Potential work. **Enable Editing** is not an active Potential-menu action. Potential stage chips are not part of the active panel work. ## What happens next After **Receive inquiry**, the saved job is an Inquiry and its active Potential items are copied into that Inquiry. Continue on the Inquiries page for the next sales-job work. After **Missed opportunity**, the job leaves Potentials and is found with the missed or archived sales-job outcomes. For saved-record comments, tasks, and related follow-up, use [Sales job contacts, guarantees, and history](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-contacts-guarantees-and-history). For the complete stage sequence, use [Sales jobs lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle). For broader missed, regretted, and cancelled outcomes, use [Missed, regretted, and cancelled jobs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/missed-regretted-and-cancelled-jobs). # Inquiries ## What an inquiry is An Inquiry is the formal sales request between an early Potential and an Offer: the client's request is recorded, checked, and prepared for a principal before you decide whether it is ready to become an Offer. A Potential becomes an Inquiry when the request is formal enough to carry a client, vendor, and bid due date. An eligible Inquiry becomes an Offer through **Go to offer**. ```mermaid flowchart LR P[Potential] -->|Receive inquiry| I[Inquiry] I -->|Send inquiry to principal or Consider As Sent To Principal| S[Sent to Principal] S -->|Go to offer| O[Offer] I -->|Regret To Offer| R[Regret requested] I -->|Inquiry Cancelled By Client| C[Cancellation requested] R -->|Approve Regretted| RA[Regretted] C -->|Approve Cancelled| CA[Cancelled] R -->|Disapprove Regretted| I C -->|Disapprove Cancelled| I ``` | If you need to… | Go to | | --- | --- | | Qualify an early opportunity before a formal request exists | [Potentials](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/potentials) | | Find, complete, save, and send a formal client request | [Before you start](#before-you-start), then [Complete and save an inquiry](#complete-and-save-an-inquiry) | | Correct a saved Inquiry or handle a regret or cancellation | [Saved-record tools and conditional areas](#saved-record-tools-and-conditional-areas) | | Convert an eligible Inquiry into the next sales stage | [Convert an eligible inquiry to an offer](#convert-an-eligible-inquiry-to-an-offer) | | Continue work after conversion | [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers) | | Review missed, regretted, or cancelled work | [Missed, regretted and cancelled jobs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/missed-regretted-and-cancelled-jobs) | | Work with comments, tasks, files, contacts, or history on the saved job | [Sales job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-record) | An Inquiry can remain in its working stage while you correct it, can be considered sent when mail sending is unavailable, or can be sent through the principal route when mail sending is allowed. Regret and cancellation are exception paths. When advanced approval is required, **Approve Regretted** or **Approve Cancelled** completes that exception; the corresponding disapproval returns it from the pending request. The correction menu also provides a way to remove a regret or cancellation state. ## Before you start An Inquiry is ready to work when you have the formal request, the client and vendor to associate with it, the bid due date, and the item information that the client requested. The Inquiry area is part of an existing sales job or a new sales-job entry, and its available commands depend on the saved state, stage, mail setting, subscription, and your permission. **Prerequisites** - Have the client request and its item descriptions, units, and quantities. - Know the client, vendor, inquiry date if required by your company, and bid due date. - Use an existing sales job or start a new one; **Save** is available when the job is existing or the Inquiry is new, and the Inquiry is new or has unsaved changes. - Use the principal route when mail sending is allowed. When it is unavailable, use **Consider As Sent To Principal** instead. - For a regret or cancellation awaiting approval, use an account that can perform advanced approval before selecting an approval command. The editor keeps the Inquiry fields read-only until editing is permitted. A saved Inquiry at or beyond Sent to Principal can show **Enable Editing**, except when the Inquiry is cancelled or regretted. Save and send commands are therefore not available in every stage. ## Find or open an inquiry The **Inquiries** list is the working entry point for existing Inquiry records. A new sales-job entry is the other entry point: it opens the sales-job workspace where the Inquiry panel can be completed. **Prerequisites** - Have access to the sales-job workspace. - For an existing record, know which row belongs to the client request you need. **Steps** 1. Open the **Inquiries** list. ![The Inquiries list with its tabs and first record row](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c911c0b416f33bfeeb51165247425d02.png) 2. For an existing record, select the row you need. 3. For a new record, select **Add new**. 4. Choose the route that matches the work you are starting. | If you need to… | Select | | --- | --- | | Start the Inquiry sales-job route | **Add new**, then the new sales-job entry | | Start a direct order instead | **Direct order** | 5. If you selected **Direct order**, complete the direct-order workspace. 6. If you opened an existing row or the new sales-job route, locate the **Inquiry** panel. **Result:** An Inquiry panel is open on either a new or saved sales job. ## Understand the Inquiry workspace The Inquiry workspace is the part of the sales-job record where you identify the request, list its requested items, and use saved-record commands. The header identifies the job; the Inquiry panel contains the header fields and item area; the three-dots menu contains stage-dependent commands. After you open the panel, complete its header fields before entering item rows. On a new Inquiry, start in the field area and item grid. On a saved Inquiry, the panel arrives collapsed in the saved-record view. Expand it before editing or reviewing its fields. The saved view also provides **Comments**, **Tasks**, **Activities**, **Attachment**, **Contacts**, **LGs**, and **Last Modifications** for follow-up work on the sales job. ![The new Inquiry panel with header fields and item grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9b733ca4a9449ef6be4ae2754501e00c.png) The item grid uses the reader-facing columns **Item Description**, **Unit**, and **Qty**. The configured-field area can add company-configured fields to the Inquiry. Their presence and required state depend on company configuration, so use the labels shown in your panel rather than assuming every Inquiry has the same additions. After saving configured Inquiry fields, the confirmation can read `Custom fields saved successfully`. ![A saved Inquiry with the panel collapsed and saved-record areas visible](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ff655085e6400a64e1f80dd41f4d1ea5.png) **Note:** **Technical Notes**, **Commercial Notes**, and **Bid Bond** are saved-record follow-up tools. They are available from the saved Inquiry area, not as extra header fields in the new Inquiry editor. The notes and bid-bond work belongs to the sales-job record follow-up rather than to the field-entry procedure on this page. ### Inquiry fields The Inquiry header records who requested the work, which vendor or principal is involved, and when the request and response are due. | Field | What to enter or select | Required state and rule | | --- | --- | --- | | **Client** | The company that sent the request | Required | | **Vendor** | The vendor or principal to ask for the response | Required | | **Client Inquiry Number** | The reference number from the client's request | Required only when company configuration makes it mandatory | | **Inquiry Date** | The date of the client's request | Required only when company configuration makes it mandatory; no later than today | | **Bid Due Date** | The date by which the response is needed | Required; on or after **Inquiry Date** | | **Requested Offer Type** | The type of response requested | Required only when company configuration makes it mandatory | Required markers on a new record appear on **Client**, **Vendor**, and **Bid Due Date**; the markers for the three configurable fields depend on company settings. **Steps** 1. In **Client**, select the company that sent the request. 2. In **Vendor**, select the vendor or principal that will answer it. 3. In **Client Inquiry Number**, enter the client's reference when one is available or when your company configuration requires it. 4. In **Inquiry Date**, enter the request date when the field is required. 5. In **Bid Due Date**, enter a date on or after **Inquiry Date**. 6. In **Requested Offer Type**, select the configured offer type when the field is required. If a required field is empty, the editor displays `This field is required`. **Result:** The Inquiry header contains the client, vendor, and date information needed for item entry and saving. ### Item rows and choices An Inquiry item row describes one requested line from the client's request. Complete the row with the item's description, unit, and quantity. **Prerequisites** - Have at least one requested item and its unit and quantity. - Have completed the required Inquiry header fields. **Steps** 1. In the item grid, select the available new row. 2. In **Item Description**, enter the requested item description. 3. In **Unit**, select the unit that applies to the item. 4. In **Qty**, enter a number from `0.1` through the configured maximum quantity. 5. Review the row before saving. The Inquiry grid has the columns **Item Description**, **Unit**, and **Qty**. The **Unit** choice is disabled when its supported conditions are not met. Quantity is accepted from `0.1` to `maximumQuantityAllowed`; zero, non-numeric, and excessive values are rejected by the Inquiry validation. **Result:** At least one Inquiry item row contains its description, unit, and supported quantity. ### Saved-record tools and conditional areas Saved-record tools change with the Inquiry stage and the permissions and subscriptions available to the account. Open the three-dots menu on the saved Inquiry to see the commands available for that record; do not use a command merely because it appears on a different stage. | When the Inquiry is… | Available command or correction path | | --- | --- | | At or beyond Sent to Principal and editing is permitted, but not cancelled or regretted | **Enable Editing** | | Eligible and mail sending is unavailable | **Consider As Sent To Principal** | | Sent to Principal and you need to reverse that consideration | **Consider as not sent to principal** | | A new target Inquiry at Potential | **Back to potential** | | Received and below Offered | **Regret To Offer** or **Inquiry Cancelled By Client** | | Regretted or awaiting regret approval without advanced approval | **Consider as not regretted** | | Cancelled or awaiting cancellation approval without advanced approval | **Consider As Not Cancelled** | Changing the vendor on the relevant saved Inquiry returns it to draft. A regret or cancellation request does not become the approved exception until the appropriate approval action is completed. See [Missed, regretted and cancelled jobs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/missed-regretted-and-cancelled-jobs) for the outcome lists. **Prerequisites** - Have a saved Inquiry with the **Bid Bond** tool available. **Steps** 1. Select **Bid Bond** in the saved Inquiry area. 2. Select `Fixed Amount`, `Percentage`, or `Not Required` in the Bid Bond dialog. 3. Select **Save** when the dialog enables it. **Result:** The Bid Bond dialog shows the selected option and its available save state. ## Complete and save an inquiry Saving commits the Inquiry header and its item rows as a new record or as changes to an existing record. The form validates the request before it saves and prevents a duplicate Inquiry for the same client and vendor. **Prerequisites** - Have completed the required fields in [Inquiry fields](#inquiry-fields). - Have at least one item row as described in [Item rows and choices](#item-rows-and-choices). - If you are changing an existing Inquiry, use **Enable Editing** when the saved stage requires it. **Steps** 1. Review **Client**, **Vendor**, **Bid Due Date**, and every item row. 2. Select **Save**. 3. Read the validation message when one appears. 4. Select the field or item named in the message, then enter a permitted value. 5. Select **Save** again. 6. Confirm that the Inquiry remains open as the saved record when the save succeeds and that the new-record indicator is no longer shown. **Result:** The Inquiry is saved and remains available for the send, correction, or conversion commands that its stage permits. ### Inquiry save messages | Class | Message | Correction | | --- | --- | --- | | Validation | `This Field Is Required` | Complete the field that shows the message. | | Validation | `Item No. <n> description is required` | Enter a description in the named item row. | | Validation | `Client is required` | Select a client. | | Validation | `Vendor is required` | Select a vendor. | | Validation | `Inquiry must have atleast one item` | Add an item row. | | Validation | `Bid Due Date is required` | Enter a bid due date. | | Validation | `One or more items have an excessive quantity` | Reduce the quantity to the allowed maximum. | | Validation | `One or more items have an invalid quantity number` | Enter a valid positive quantity. | | Validation | `Vendor and client is the same.. It is not possible.` | Select different client and vendor records. | | Validation | ` You have already received an inquiry from the same client to the same vendor.` | Review the existing Inquiry instead of creating a duplicate. | | Information | `You just changed the vendor after sending this inquiry to another vendor. The inquiry will return to draft` | Review the vendor and save the Inquiry again. | | Save | `Inquiry created successfully` | Continue with the saved Inquiry. | | Save | `Inquiry updated successfully` | Continue with the updated Inquiry. | | Save | `Job updated successfully` | Continue with the saved record. | | Save | `Your request was completed successfully` | Continue with the saved record. | | Validation | `Check mandatory field(s)` | Complete the required header or configured fields. | | Validation | `Inquiry must have at least one item` | Add an item row and complete it. | | Validation | `One or more items has ZERO quantity` | Enter a supported positive quantity. | | Validation | `One or more items has no unit` | Select a unit for each item. | | Validation | `This field is required` | Complete the field that shows the message. | | Validation | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a quantity within the displayed numeric limit. | | Validation | `Invalid input. Please enter a non-negative value` | Replace the negative value with a permitted value. | | Error | `An error occurred while processing your request` | Correct the reported data and retry the save. | | Send | `Inquiry successfully considered as sent to principal` | Confirm the Inquiry stage before continuing. | | Conversion | `Converted to offer successfully` | Continue in the Offer workspace. | The saved record reports the save result through the application confirmation; the confirmation strings are `Job updated successfully` and `Your request was completed successfully`. ## Send an inquiry and handle its branches Sending an Inquiry passes the request to the principal route when mail sending is allowed. If mail sending is unavailable, you can record that the request was sent without activating the mail action. A sent Inquiry can later be considered not sent when the correction command is available. **Prerequisites** - Have a saved Inquiry with no unsaved changes. - Identify whether mail sending is allowed for the Inquiry. - For regret or cancellation approval, use an account with advanced-approval permission. **Steps** 1. Open the three-dots menu on the saved Inquiry. 2. Choose one submission route. | If… | Select | | --- | --- | | Mail sending is allowed and the Inquiry is ready to send | **Send inquiry to principal** | | The Inquiry is already at Sent to Principal and another send is permitted | **Re-send inquiry to principal** | | Mail sending is unavailable | **Consider As Sent To Principal** | 3. If you selected **Consider As Sent To Principal**, confirm the message `Inquiry successfully considered as sent to principal`. 4. If the Inquiry is sent or considered sent, confirm its stage reads `Inquiry/Sent To Principal` before using the next stage command. 5. For a received Inquiry below Offered, open the three-dots menu. 6. Select **Regret To Offer** or **Inquiry Cancelled By Client** to start the applicable exception path. 7. If advanced approval is required, have the approver select **Approve Regretted** or **Approve Cancelled**. 8. If the approver rejects the exception, select **Disapprove Regretted** or **Disapprove Cancelled** instead. After the considered-sent route, **Send inquiry to principal** and the item action are absent while the sent-state correction and conversion commands are available. Use **Consider as not sent to principal** to reverse the considered-sent state when that command is shown. ![The saved Inquiry menu with the send and considered-sent choices](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/726f51182b917d63bfd2843fb2ddb5e9.png) **Result:** The Inquiry is recorded as sent, remains in its exception request until the required approval decision, or returns through the available correction command. ## Resolve validation and save problems Use the exact text on screen to choose the correction. Messages from embedded pages are not Inquiry corrections; use the Inquiry messages below while you are in the Inquiry editor or its saved-record commands. | What you see | What to do | | --- | --- | | `This field is required` | Complete the field that shows the message. | | `Check mandatory field(s)` | Review required header and configured fields. | | `Inquiry must have at least one item` | Add an item row. | | `One or more items has ZERO quantity` | Enter a quantity greater than zero. | | `One or more items has no unit` | Select a unit. | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a supported quantity. | | `Invalid input. Please enter a non-negative value` | Remove the negative value. | | `An error occurred while processing your request` | Correct the data you last changed and retry once. If it persists, ask an administrator to review the request. | | `Error saving custom fields` | Correct the configured field values and save them again. | | `Please enter at least one email` | Enter at least one email address for the principal before sending the Inquiry. | | `Please save opened inquiry first` | Save the open Inquiry before using the dependent command. | | `All inquiries must be in draft stage to revert to potential` | Return the Inquiry to draft before selecting **Back to potential**. | | `This action is only allowed if you belong to that branch` | Use the branch allowed for your account. | | `You don’t have permission` | Ask an administrator for the required permission. | Date and quantity boundaries are enforced by the editor and item validation. The required markers for **Client Inquiry Number**, **Inquiry Date**, and **Requested Offer Type** depend on company configuration. The presence of configured custom fields and the selected list layout also depend on the company configuration. ### Out of scope messages > **Note:** Use the Inquiry surface that is actually available: conversion is a three-dots menu > command, and the Inquiry item grid is built around **Item Description**, **Unit**, and > **Qty**. The new Inquiry editor does not provide **Category**, and its alternate footer > does not provide **Technical Notes**, **Commercial Notes**, or **Bid Bond** as header > fields. The saved-record area provides those follow-up tools separately. Use the commands shown for the current Inquiry and its current stage. The following messages belong to other pages or sales-job stages: | Message | Owning page | | --- | --- | | `Job deleted successfully` | Sales job record | | `Converted to inquiry successfully` | Potentials | | `Converted To Regretted` | Missed, regretted and cancelled jobs | | `Converted to cancelled` | Missed, regretted and cancelled jobs | | `Converted to lost` | Missed, regretted and cancelled jobs | | `Job regretted successfully` | Missed, regretted and cancelled jobs | | `Job cancelled successfully` | Missed, regretted and cancelled jobs | | `Job missed successfully` | Missed, regretted and cancelled jobs | | `Job reactivated successfully` | Missed, regretted and cancelled jobs | | `All offers must be in draft status to revert to inquiry` | Offers | | `Cannot be un-delivered — a due invoice already exists` | Delivery notes | | `Error {{errorMsg}}` | Sales job record | | `An account with this name already exists` | Accounts | | `A project with this name already exists` | Projects | | `Please save opened cost sheet first` | Sales job costing — save the open cost sheet before continuing. | | `There is a maximum discount that exceeds the negotiation margin.` | Offers — reduce the discount to the permitted margin before saving. | | `The gross profit margin is unacceptable, and the release prices have been stopped.` | Offers — correct the prices or margin before saving. | ## Convert an eligible inquiry to an offer Conversion moves an eligible saved Inquiry into the Offer workspace. The conversion command is available only when the Inquiry is not deleted, editing is allowed, there are no unsaved changes, it is not already offered, and its stage is eligible for conversion. **Prerequisites** - Have a saved Inquiry. - Confirm that **Go to offer** appears in the three-dots menu. - Resolve any unsaved changes before converting. **Steps** 1. Open the three-dots menu on the saved Inquiry. 2. Select **Go to offer**. 3. If the conversion succeeds, confirm `Converted to offer successfully`. 4. Continue in the Offer workspace. 5. Read `An error occurred while processing your request` when it appears. 6. Correct the Inquiry data or stage condition shown by the record. 7. Select **Go to offer** again after the Inquiry is eligible. Continue with [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers). **Result:** The eligible Inquiry is handed to the Offer workspace, where Offer work continues. # Offers ## Offers An Offer is the priced proposal for one Client and one Vendor. It follows an Inquiry after conversion and sits before an Order in the sales flow. The Offer holds the commercial details, item prices, approval work, sending choices, and document surfaces for that proposal. ```mermaid flowchart LR Inquiry -->|convert| Offer Offer -->|Convert To Order| Order ``` | If you need to… | Go to | |---|---| | prepare the records and commercial information | [Before you start](#before-you-start) | | locate a saved proposal | [Find and open an Offer](#find-and-open-an-offer) | | enter parties, dates, and terms | [Enter the Offer details](#enter-the-offer-details) | | price items and related commercial work | [Add item values and related commercial work](#add-item-values-and-related-commercial-work) | | approve or send the proposal | [Approve and send an Offer](#approve-and-send-an-offer) | | handle a loss, regret, cancellation, or return | [Revise, close, or return an Offer](#revise-close-or-return-an-offer) | | continue after an eligible Offer | [What happens next](#what-happens-next) | | work with the Inquiry that created the Offer | [Inquiries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/inquiries) | | work with the Order created from an Offer | [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) | ## Before you start An Offer starts with a saved Inquiry that can still be edited and has the parties, items, and commercial expectations needed to price a proposal. Confirm the route before entering values: a Vendor can be an external principal or your own-company legal entity, and the available pricing work depends on that route. **Prerequisites** | Have or confirm | Why it matters | |---|---| | A saved, editable Inquiry | Offer work starts after Inquiry conversion; an unsaved source record cannot provide a reliable starting point. | | The correct **Client** and **Vendor** | The Offer is priced for these two parties, so a wrong party changes who receives or supplies the proposal. | | Currency, delivery terms, and payment terms | These values determine how the commercial proposal is expressed and reviewed. | | Items, quantities, prices, dates, and commercial expectations | The Offer panel and item grid use these values to form the proposal and its total. | | Permission to edit the sales job | Offer editing and most commands require edit permission. | | Access to the configured approval process and a person with approval permission | A requester sees **Request approval**; a person with approval permission approves the Offer. | | The Vendor route | For an external principal, use the Commissions route; for your own-company legal entity, use the own-company pricing route. | ## Find and open an Offer The Offers list is the sales-job list filtered to Offer work. Its tabs are: | Tab | Use it to | |---|---| | **All** | View all sales-job work. | | **Potentials** | View early opportunities. | | **Inquiries** | View inquiry work. | | **Offers** | View priced proposals. | | **Orders** | View converted orders. | | **Archived** | View archived sales jobs. | Its columns are **Job No.**, **File No.**, **Sales responsible**, **Vendor**, **Client**, **Job title**, **Offer price (€)**, **Offer type**, Job status, and **Offer stage**. The list also has **Refresh**, `Table Layout`, and **Settings**. ![The Offers list with its tabs and the first record row](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5d2c834bed841b22a36c36c73466eacd.png) **Prerequisites** - Have access to the sales-job lists. - Know which saved Offer you need to open. **Steps** 1. Open the sales-job list from the application navigation. 2. Select **Offers** in the sales-job tabs. 3. Use the headers visible in the grid to identify the record. 4. Select the first record row when it is the Offer you need. 5. Expand the **Offer** panel. The Offers list does not show `Show archived`. Use the headers visible in your list because saved layouts can change which columns appear. **Result:** The Offer record opens and its **Offer** panel is available to expand. With the panel open, review the workspace before pricing the proposal. ## Open the Direct order entry from the Offers list **Direct order** is a separate entry surface for creating an order directly; it is not an existing Offer record. **Prerequisites** - Be on the Offers list. - Have access to create records and an available Sales subscription. **Steps** 1. Select **Add new** on the Offers list. 2. Select **Direct order**. The Direct order entry contains **Save** and **Save and Close**, plus fields including **Status**, **Branch**, **Salesperson Responsible**, **Product Type**, **Job Title**, **End User**, **File Number**, **Client**, **Vendor**, **Client Order No.**, **Vendor Order No.**, **Order Date**, **Order Activation Date**, **Delivery Time**, **Forecasted Delivery Date**, **Shipping Address**, **Delivery Term**, **Payment Method**, **Payment Period**, **Partial Delivery**, **L/C Number**, and **External order no.** The item grid has **Item Description**, **Unit**, **Qty**, and **Unit Price**, **Discount (%)**, **Item Price**, and **Currency**. **Result:** The Direct order entry surface is open; no record has been saved by these steps. Return to the Offers list when you need an existing Offer rather than a direct order. ## Understand the Offer workspace The Offer workspace is a shared sales-job record with an Offer panel. The panel contains the Offer fields and item grid, while related sections hold the commercial and follow-up work around the proposal. ![The expanded Offer panel with fields, item grid, and header actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/65d2d089d3de3d3bbade113e960d84b0.png) The Offer panel includes **Order chance**, **Status**, **Branch**, **Product Type**, **Job Title**, **End User Account**, **File Number**, **Expected Order Date**, **Client**, **Vendor**, **Offer No.**, **Offer Type**, **Bid Due Date**, **Offer Date**, **Validity Period**, **Delivery Time**, **Delivery Term**, **Payment Method**, **Payment Period**, and **Partial Delivery**. The item grid includes **Item Description**, **Unit**, **Qty**, **Unit Price**, **Discount limit (%)**, **Discount (%)**, **Item Price**, **Currency**, and **Tax (%)**. The header contains **Save**, **Save and Close**, `Undo`, and `Redo`. The record also provides `Bold`, `Italic`, `Strikethrough`, `Underline`, `Ordered List`, `Bullet List`, `Font Color`, `Clear Formatting`, and `Post` for the related text surface. | Surface | Use it for | |---|---| | **Margin** | Review or enter margin values. | | **Payment Milestone** | Record staged payment information. | | **Technical Notes** | Keep technical proposal notes. | | **Commercial Notes** | Keep commercial proposal notes. | | **Comments** | Add record discussion. | | **Tasks** | Follow up with assigned work. | | **Activities** | Track related activities. | | **Attachment** | Keep related files. | | **Contacts** | Keep people related to the sales job. | | **LGs** | Open letters-of-guarantee work. | | **Pricing Quotations** | Open pricing quotation work. | | **Last Modifications** | Review record changes. | | **Tickets** | Open related tickets. | The three-dot command menu is state-dependent. It can include **Alternative Offer**, **Print**, **Cover letter template**, **Commercial offer template**, **Technical offer template**, **Regret To Offer**, **Inquiry Cancelled By Client**, **Back to Inquiry**, and **Delete**. Other commands appear only when their stage, approval, permission, supplier, mail, alternative-offer, print, or extension conditions allow them. ![The three-dot Offer command menu with state-dependent commands](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/df97be0447a90c24830f5a3ce232a88c.png) Selecting **Margin** opens a dialog with **Default**, **Margin**, and **Ok**. ![The Margin dialog with Default, Margin, and Ok](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/99558f59301faa97ca58594524972f77.png) ## Price and save an Offer Pricing is the work of turning the Inquiry's item and commercial information into an Offer that can be reviewed, approved, and sent. Choose the route that matches the Vendor before entering or reviewing prices. | Vendor route | Pricing surface | |---|---| | External principal | **Commissions** and the external-vendor pricing route. | | Own-company legal entity | The own-company pricing route, including the available calculation and margin work. | **Prerequisites** - Have an editable Offer with the correct Vendor. - Have the commercial terms and item information ready. - Have pricing and approval access where the configured process requires it. **Steps** 1. In the Offer panel, confirm the **Vendor**. 2. If the Vendor is an external principal, open **Commissions**. 3. If the Vendor is your own-company legal entity, open **Calculation Sheet**. 4. Review **Margin** for the applicable route. 5. Record staged terms in **Payment Milestone** when they apply. 6. Add supporting information in **Technical Notes**. 7. Add commercial information in **Commercial Notes**. 8. Select **Save** after the Offer values and item rows are ready. Editing and pricing commands are controlled by the Offer stage, edit permission, approval process, approval permission, Vendor identity, and whether the record has unsaved changes. An approved Offer can require a new approval request before it can be edited again. **Result:** The applicable pricing route is open or the Offer values are ready for the Offer-header save. For an own-company Vendor, the available pricing commands can also include **Request Pricing** or **Release Prices**. **Request Pricing** is used when pricing must be requested from another person; **Release Prices** releases the prices when the item rows have default unit prices. ### Enter the Offer details The Offer details describe the proposal number, type, dates, validity, delivery, and payment terms. Required markers are configurable, so a field is mandatory only where your company configuration requires it. **Prerequisites** - Have the saved Inquiry and correct parties selected. - Know the agreed proposal dates, validity, delivery, and payment terms. **Steps** 1. In the Offer panel, enter the proposal identifier in **Offer No.** when your configuration requires it. 2. Select `Firm` or `Budget` in **Offer Type**. 3. Enter **Bid Due Date** on or after the Inquiry date. 4. Enter **Offer Date** on or after the Inquiry date. 5. Enter **Validity Period** from `0` through the configured maximum period. 6. Enter **Delivery Time** from `1` through the configured maximum period. 7. Select the applicable company value in **Delivery Term**. 8. Select the applicable company value in **Payment Method**. 9. Enter **Payment Period** from `1` through the configured maximum period. 10. Set **Partial Delivery** when the commercial agreement permits partial delivery. **Result:** The Offer panel contains the available party, date, validity, delivery, payment, and partial-delivery values. ### Add item values and related commercial work The item grid turns the commercial request into priced Offer lines. Add at least one complete item row; a missing quantity or unit prevents a valid save. **Prerequisites** - Have the item description, unit, quantity, unit price, currency, discount, and tax information. - Have the Offer panel open. **Steps** 1. In an `Item row`, enter the item in **Item Description**. 2. Select the item **Unit**. 3. Enter a positive **Qty**. 4. Enter the **Unit Price**. 5. Review **Discount limit (%)** before entering a **Discount (%)**. 6. Review the calculated **Item Price**. 7. Confirm the line **Currency**. 8. Enter **Tax (%)** when the line requires it. 9. If the grid is locked, select **Enable Editing** before changing a row. 10. Complete **Payment Milestone** and the applicable commercial notes. The quantity and price controls enforce non-negative or positive bounds. A percentage field can be limited to `0` through `100`, and price fields can be limited to `0` through the Offer total price. **Result:** The Offer has at least one item with a description, unit, quantity, and price, plus the applicable commercial values. ### Save the Offer Saving commits the Offer details and item rows after the form checks the fields, items, and totals. **Prerequisites** - Complete the Offer details and at least one item row. - Have permission to edit the Offer. - If an approval process applies, know who must approve the saved Offer before it can progress. **Steps** 1. Review the Offer-currency total in the Offer header. 2. Review **In Branch Currency** and the exchange rate when they are shown. 3. Select **Save** in the Offer header. 4. If a required-field message appears, enter a value in the field with the required marker; if an item message appears, enter a positive value in **Qty** or select a **Unit** as the message requires; otherwise, correct the named value. 5. Select **Save** again. **Result:** The Offer-header save has been submitted with the validated Offer details and item rows. A successful save displays `Offer updated successfully`. After the Offer is saved, use its approval and sending commands. ## Approve and send an Offer Approval moves a saved Offer through the configured approval route. Sending is a separate action: it can send the Offer to the client by mail or record that it was sent without sending mail. **Prerequisites** - Have a saved Offer. - Have the configured approval permission, or know the approval role that must act next. - Confirm the Offer values and item prices before approval or sending. | Current work | Control or outcome | |---|---| | Submit for approval | **Request approval**; the Offer moves to **Awaiting Approval**. | | Approve a submitted Offer | **Approve**; the Offer moves to **Approved** or **Valid**, as configured. | | Withdraw an approval request | **Cancel approval request**. | | Reject an approval request | **Reject approval request**, then use **Consider as not approved** where that command is available. | | Send by email | Select **Send offer to client**. Select **Mail** or **Send to Client**. | | Record a send without email | Select **Consider Offer As Sent To Client**. | **Steps** 1. Select the command that matches the Offer's current work: | If you need to… | Select… | |---|---| | submit the Offer for approval | **Request approval** | | approve a submitted Offer | **Approve** | | withdraw an approval request | **Cancel approval request** | | reject an approval request | **Reject approval request**, then **Consider as not approved** when it is available | | send the Offer by email | **Send offer to client**, then **Mail** or **Send to Client** | | record a send without email | **Consider Offer As Sent To Client** | 2. Confirm the resulting approval state or sent state in the Offer record. If a zero-price Offer triggers a confirmation, review the item prices before confirming. The dialog displays `Your Offer Price Is Zero!` and `Are you sure you want to deliver free of charge?`; select **Yes** only when the Offer is intended to be free of charge. The available approval and sending commands depend on the Offer stage, approval process, approval permission, mail permission, and edit state. **Result:** The Offer is submitted for approval, approved, rejected, withdrawn, or recorded as sent through the route available to your role. ## Revise, close, or return an Offer These commands change how an Offer continues or ends. Their availability depends on the current Offer stage and permissions; use the command that matches the record's current state rather than treating the three-dot menu as a fixed list. | Need | Available command | |---|---| | Create a revised proposal | **Revision** | | Create an alternative proposal | **Alternative Offer** | | Reopen editing | **Enable Editing** | | Extend validity | **Extend Offer Validity** or **Request Extension Validity** | | Return to the Inquiry | **Back to Inquiry** | | Record regret | **Regret To Offer** | | Record client cancellation | **Inquiry Cancelled By Client** | | Record a lost proposal | **Lost** | | Approve or disapprove an outcome | **Approve Regretted**, **Disapprove Regretted**, **Approve Cancelled**, **Disapprove Cancelled**, **Aprove Lost**, or **Disapprove Lost** | | Cancel or remove the record | **Cancel** or **Delete** | | Remove prices from the consideration | **Consider Offer without prices again** | | Remove the sent-to-client consideration | **Consider Offer As Not Sent To Client** | | Return an approved Offer to an unapproved state | **Consider as not approved** | | Return a lost Offer to Offer work | **Consider as not lost** | **Prerequisites** - Have a saved Offer. - Confirm the current stage and the command's permission in the Offer header or three-dot menu. - Before deleting, confirm that deletion is the intended action; deletion is not a correction for a current proposal. **Steps** 1. Open the three-dot command menu on the Offer. 2. Select the command that matches the required revision, extension, return, or outcome. 3. Complete any dialog or reason fields shown by that command. 4. Select **Enable Editing** before changing a locked Offer. 5. Select **Delete** only when the Offer itself must be removed. 6. Confirm the resulting stage or command state in the Offer record. **Result:** The permitted revision, extension, return, outcome, cancellation, deletion, or consideration change is applied to the Offer. **Consider Offer without prices again** has no dialog. It returns the Offer to Draft and clears the default item unit prices. **Consider Offer As Not Sent To Client** returns a sent Offer to **Approved** when approval applies, or to Draft when it does not. Before selecting **Delete**, confirm that the Offer itself must be removed; deletion is not a correction for a current proposal. ## When Offer work goes wrong Correct the value named by the message, then save again. Commands also disappear when the current Offer stage, approval state, permission, Vendor route, or edit state does not allow them. Required markers and prefilled values can vary by company configuration and the current Offer. **Steps** 1. When `This field is required` appears, enter a value in the field with the required marker. If no field is identified, review all required markers. | Message | Correction | |---|---| | `This field is required` | Enter a value in the field with the required marker; if no field is identified, review all required markers. | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a value above zero and no greater than `999,999.00`. | | `Invalid input. Please enter a non-negative value` | Enter zero or a positive value. | | `Please enter action for each milstone` | Complete the action for every payment milestone. | | `Please save opened cost sheet first` | Save the open cost sheet before continuing with the Offer action. | | `All offers must be in draft status to revert to inquiry` | Return only Offers in draft status with **Back to Inquiry**. | | `Check mandatory field(s)` | Review every field carrying a required marker, then save again. | | `One or more items has ZERO quantity` | Enter a positive value in **Qty** for each item. | | `One or more items has no unit` | Select a **Unit** for each item. | | `An error occurred while processing your request` | Review the current Offer state and permissions, then retry the permitted command. | ## Offer and Offer-related messages These are the ten messages owned by Offer entry, pricing, saving, or Offer progression. Use the exact text when matching a message on screen. | Area | Message | |---|---| | Validation | `This field is required` | | Validation | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | | Validation | `Invalid input. Please enter a non-negative value` | | Pricing | `Please enter action for each milstone` | | Pricing | `Please save opened cost sheet first` | | Reversion | `All offers must be in draft status to revert to inquiry` | | Save validation | `Check mandatory field(s)` | | Item validation | `One or more items has ZERO quantity` | | Item validation | `One or more items has no unit` | | Processing | `An error occurred while processing your request` | After saving, look for `Offer updated successfully`. After sending or recording the Offer as sent, look for `Offer Submitted To Client`. ### Messages owned by the Inquiries page Inquiry conversion and Inquiry reversion messages belong with [Inquiries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/inquiries), because they describe the source record entering or leaving Offer work. | Message | Owning work | |---|---| | `Converted to offer successfully` | Inquiry conversion | | `Converted to inquiry successfully` | Inquiry reversion | | `Converted To Regretted` | Inquiry outcome | | `Converted to cancelled` | Inquiry outcome | | `Converted to lost` | Inquiry outcome | | `Please save opened inquiry first` | Inquiry save before conversion | | `All inquiries must be in draft stage to revert to potential` | Inquiry reversion | ### Messages owned by Orders and purchasing pages After the Offer hand-off, order, invoice, procurement, and purchasing messages belong to [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) or the relevant purchasing page. | Message or message group | Owning work | |---|---| | `Cannot be un-delivered — a due invoice already exists` | Orders and invoice delivery reversal | | Purchasing item and package messages | Purchasing work | | Order and purchasing exception messages | Orders and purchasing work | ### Messages owned by other pages Shared sales-job, account, project, product, reference, finance, warehouse, letters-of-guarantee, activity, and contact messages stay with the page that owns that surface. | Message | Owning work | |---|---| | `Custom fields saved successfully` and `Job updated successfully` | Sales job record | | `Error saving custom fields` and `Job deleted successfully` | Sales job record | | `An account with this name already exists` | Account work | | `A project with this name already exists` | Project work | | Product, reference, finance, warehouse, L/G, activity, and contact errors | Their related pages | ### Messages owned by Material requisition and Purchasing inquiry pages Material requisition (MRQ) and Purchasing inquiry validation messages belong to those related pages when that work is open. | Message | Owning work | |---|---| | `Required Receiving Date` | Material requisition | | `Required Receiving After` | Material requisition | | `Required Offer Type` | Purchasing inquiry | | `Required Bid Due Date` | Purchasing inquiry | ## What happens next An eligible Offer becomes an Order. The conversion is available for an Offer in **Valid**, `Considered-valid`, or **Expired** status, subject to the command's state and permission conditions. ```mermaid flowchart LR Valid -->|Convert To Order| Order ConsideredValid[Considered-valid] -->|Convert To Order| Order Expired -->|Convert To Order| Order ``` **Prerequisites** - Have an eligible Offer in **Valid**, `Considered-valid`, or **Expired** status. - Have permission to convert the Offer. - Review the client, Vendor, prices, payment, delivery, currency, items, and payment milestones before conversion. **Steps** 1. Open the eligible Offer record. 2. Select **Order** or **Convert To Order** in the Offer header. 3. Review the **Convert to order** dialog. 4. Confirm the conversion in the dialog. 5. Open the resulting Order panel. The Order receives the Offer's Client, Vendor, payment terms, delivery terms, currency, items, and payment milestones. Continue order confirmation, delivery, and later exception work in [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) and [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered). **Result:** The Order panel is available after the Offer-to-Order hand-off. # Orders ## Orders An Order records the accepted commercial commitment that follows an eligible Offer and carries the work through delivery. Use this page to find an Order, check its commercial details, and choose the state-dependent action that matches the work still to do. ```mermaid stateDiagram-v2 Offer --> Order: convert eligible Offer Order --> Delivered: deliver all active order work Order --> Offer: Back to Offer Order --> Rejected: Reject Order Acceptance Order --> Cancelled: Cancelled order ``` | If you need to… | Go to | |---|---| | Find the Orders work list and open a record | [Find and open an order](#find-and-open-an-order) | | Check the panel fields and item rules | [Order fields](#order-fields) | | Send a pricing request, print, amend, or request approval | [Supporting order tools](#supporting-order-tools) | | Confirm, activate, ship, or deliver the Order | [Confirm, activate, and progress an order](#confirm-activate-and-progress-an-order) | | Correct, reject, cancel, or return the Order | [Amend, reject, cancel, and return an order](#amend-reject-cancel-and-return-an-order) | | Continue with warehouse work | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | | Continue with terminal or archived exits | [Missed, regretted, and cancelled jobs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/missed-regretted-and-cancelled-jobs) | | Follow a draft invoice | Invoice lifecycle | | Follow the Order-to-Delivered hand-off | From orders to delivered | ![Orders list with the Orders tab selected and its work-list columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/a7e0b2610eb91658aa53c379c198b91a.png) Start with an existing Order. Create an Order through the Offer workflow. Continue detailed warehouse receipt, inspection, stock, issue, and delivery-note work in [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow). ## Before you start Before you use an order action, have the following ready: | Have or check | Why it matters | |---|---| | A saved, editable sales job with no unsaved Order changes | Order actions are available from this saved record state. | | **Client**, **Vendor**, and at least one item | Confirmation validates the parties and requires an item. | | Item descriptions, quantities, prices, discounts, and tax | These values are checked before confirmation. | | Any fields required by your configured form rules | Company configuration can add mandatory fields. | | Membership of the job's branch | Delivery is refused when you do not belong to that branch. | | A delivery check that permits the action | A delivery check is the rule that can stop conversion while the PM process is ongoing. | | Approval capability, where an approval process controls confirmation | The available approval controls depend on the process and your capability. | The Order must be editable for changes. Do not begin a confirmation or delivery action until the values you intend to commit are saved. ## Find and open an order The Orders work list is the sales-job list filtered to records at the Order stage; opening a row takes you to that sales-job record. **Prerequisites** - You can open the Sales jobs work lists. - You know which saved Order record to open. **Steps** 1. Open **Sales**. 2. Open **Sales jobs**. 3. Select **Orders**. The list shows the Orders tab and its configured columns, such as `Job No.`, `File No.`, `Sales responsible`, `Vendor`, `Client`, `Job title`, `Order price (€)`, `Order price (incl. tax)`, **Order Backlog**, `Order backlog (€)`, `Order stage`, `Job status`, `Order date`, `Forecast delivery date`, and `PM status`. 4. Select the row for the Order. The sales-job record opens. 5. Check the stage bar for **Order** or a later stage before working with order controls. **Result:** The Order record is open and its Order panel is available when the record is at Order or a later stage. An inquiry-stage record is earlier than Order and does not expose order actions. **Activate Order** is available only from the applicable later Order state. ![Inquiry-stage record without order actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/331c886eb9ce1ca0969421a8277af63f.png) ## Understand the order panel The Order panel is the part of the sales-job record that holds the accepted commercial arrangement and its delivery and payment details. It is initially collapsed, so expand it before inspecting fields or opening its menu. **Prerequisites** - You have opened an Order record. **Steps** 1. Locate the collapsed Order panel title bar showing the client, vendor, or stage information. 2. Select the panel title bar or its expander. 3. Check **Client**, **Vendor**, **Order Date**, **Delivery Term**, and **Payment Method**. 4. Open the Order panel menu. 5. Choose an action that matches the Order state and the work you need to perform. **Result:** The Order panel is expanded, its principal fields are visible, and its menu shows the controls available for the current state and permissions, including **Order amendment** and **Enable Editing** when their conditions apply. ![Expanded Order panel with fields and state-dependent actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6ee5b7eaacd1f6d387beafa30393945a.png) ### Order fields Order fields describe the parties, commercial document, delivery arrangement, payment terms, and items that make up the accepted commitment. | Area | Fields and rules | |---|---| | Parties and numbers | **Client** and **Vendor** identify the parties. **Client Order No.** and **Vendor Order No.** are required only when company rules make them mandatory. | | Dates | **Order Date** is required in Draft and cannot be earlier than the Offer date. **Order Activation Date** is required only when configured, must be from the Order Date through today, and cannot be earlier than the Order Date. | | Delivery | **Delivery Time** is required only when configured, has a minimum of 1, and is bounded by the configured maximum. **Shipping Address** and **Delivery Term** are required only when configured. | | Payment | **Payment Method** and **Payment Period** are required only when configured. **Payment Period** has a minimum of 1 and a configured maximum. **L/C Number** is required only when configured. | | External order reference | **External order no.** is required only when configured and appears when the record is not handled by the supplier. | | Item grid | Each item needs **Item Description**. **Qty** must be greater than 0 and no more than 999,999.00. **Unit Price** and **Item Price** cannot be negative. **Discount (%)** and **Tax (%)** range from 0 through 100. | | Item-dependent fields | **Unit** and the quantity and price controls are unavailable for package items or selected products according to the item type. **Item Price** is unavailable for unitized items. **Currency** and **Discount limit (%)** are read-only. | | Order totals and follow-up | The panel carries item totals, payment milestones when that feature is enabled, backlog, custom fields, **Order Activation Conditions**, **Technical Notes**, and **Commercial Notes** when their saved/configured conditions apply. | The maintained **Unit** list contains `Pieces`, `Litr`, `Meter`, `KG`, `SET`, `Number`, `LSM`, `InCH`, `EA`, `ST`, `Ton`, and `ZZ-doc-Enter-Unit-Name`. The list is maintained in the Units configuration area and appears in the order row when the row is not a package item and no product selection removes the control. When the record configuration supplies them, the opened panel includes **Forecasted Delivery Date**, **Partial Delivery**, and `Shahawy Extra`. Required markers appear where the configured rule and record state make a field mandatory. When the Order has binding invoices, **Vendor** is disabled and commercial item edits are locked. The product and item values therefore need to be correct before invoice-bound work begins. ### Supporting order tools Supporting tools prepare, document, or govern order work; they do not by themselves represent the normal progression from Order to Delivered. | If the Order is… | Use | What the control supports | |---|---|---| | Draft, in supplier context, and saved without unsaved changes | **Request Pricing Confirmation** | Request pricing confirmation; the request can open `Request Order Prices Confirmation From`. | | Saved with commission viewing enabled, in supplier context | **Calculation Sheet** | Review the calculation sheet when the feature conditions apply. | | Valid or Ready For Shipment and amendment is available | **Order amendment** | Start an amendment where the Order Amendment subscription permits it. | | Editable and not rejected or cancelled | **Enable Editing** | Re-enable editing for an editable Order state. | | Printing is allowed | **Print** or **Order template** | Print the Order or use the configured Order template. | | An approval process makes the Order requestable | **Request approval** | Send the Order into the approval path. | | You can approve an approval-stage Order | **Approve** | Approve the request. | | Rejection awaits an approval decision | **Approve Rejected** or **Disapprove Rejected** | Approve or disapprove the rejection request when advanced approval applies. | | Cancellation awaits an approval decision | **Approve Cancelled** or **Disapprove Cancelled** | Approve or disapprove the cancellation request when advanced approval applies. | | Mail is allowed and the Order is eligible | **Send order confirmation to client** | Prepare the client confirmation mail with the Order attachment. | | The Order awaits activation and mail is allowed | **Re-send order confirmation to client** | Prepare the confirmation mail again. | Treat **Send order confirmation to client** and **Re-send order confirmation to client** as client communication actions. These controls prepare the client confirmation mail in **Mail**, using **Send To Client** as the dialog action. ## Confirm, activate, and progress an order When an accepted commercial commitment is ready for confirmation, review the conditions below before selecting a control. The available route differs for an own-company order and an external-supplier order. | Order condition | Select | |---|---| | Ready to record submission to the client when mail sending is unavailable | **Consider Order As Confirmed To Client** | | Valid and own-company supplier | **Ready for shipment** | | Ready For Shipment and own-company supplier | **Deliver Order** | | Valid and external supplier | **Deliver Order** | | Awaiting Activation or the alternate awaiting-activation state | **Activate Order** | **Prerequisites** - The Order is saved and editable with no unsaved Order changes. - **Client**, **Vendor**, and at least one item are present. - The item and configured form validations pass. - You belong to the job branch and the delivery check permits delivery. **Steps** 1. Open the Order panel menu. 2. Select the control that matches the Order condition. | Order condition | Select | What happens next | |---|---|---| | Ready to record client submission when mail sending is unavailable | **Consider Order As Confirmed To Client** | The result is `Order Submitted to Client`. A zero-priced Order opens the **Order price zero** confirmation route. | | Awaiting Activation or the alternate awaiting-activation state | **Activate Order** | The **Confirm activation date** dialog opens. | | Valid and own-company supplier | **Ready for shipment** | No date dialog opens. | | Ready For Shipment and own-company supplier | **Deliver Order** | The delivery date dialog opens. | | Valid and external supplier | **Deliver Order** | The delivery date dialog opens. | 3. If **Confirm activation date** opens, enter **Order Activation Date** when required. 4. Submit the activation confirmation with a date from **Order Date** through today. 5. If the delivery date dialog opens, enter **Delivery Date**. 6. Keep **Delivery Date** on today or an earlier date. 7. Use the dialog's confirmation control. For external-supplier delivery, the result is `Order updated successfully. A draft invoice was created. Check the Invoices tab for details.` Check the stage bar for **Delivered** after all active Order work is delivered. > **Note:** Partial delivery leaves the job short of **Delivered** until all active Order work is > delivered. **Result:** The Order is confirmed, activated where required, ready for shipment, or delivered. A partial delivery leaves the job short of Delivered; the job reaches Delivered only when delivered orders equal the active orders. ## Amend, reject, cancel, and return an order These controls are alternate routes for an Order that needs correction, rejection, cancellation, or return to the Offer stage. Each appears only for the state and branch conditions listed below. | Current situation | Control and result | |---|---| | Awaiting activation | **Consider Order As Not Confirmed To Client** returns the Order to the applicable approved or draft state. | | Valid | **Not activated yet** returns the Order to the applicable approved or draft state; on-delivery invoices can block the reversal. | | Ready For Shipment in the permitted own-company branch | **Not ready for shipment yet** returns the Order to Valid and reverses invoice creation; on-delivery invoices can block it. | | Delivered in the permitted branch | **Not delivered yet** returns an own-company Order to Ready For Shipment or an external-supplier Order to Valid; on-delivery invoices can block it. | | Draft, awaiting approval, or rejected approval | Select **Reject Order Acceptance**; the available rejection dialog and approval controls depend on the current approval state. | | Rejected or awaiting a decision you cannot make | **Consider as not rejected** returns the job to Order. | | An Order that is not already delivered, rejected, or cancelled and has no pending approval decision | **Cancelled order** starts the cancellation route. | | Cancelled or awaiting a decision you cannot make | **Consider As Not Cancelled** is the cancellation return control. | | Draft non-direct/non-instant job, or awaiting/rejected approval | **Back to Offer** returns the job to Offer; when every Order is Draft, the confirmation uses **Back to inquiry** and **OK**. | | Valid or Ready For Shipment with the Order Amendment subscription | **Order amendment** starts the amendment route. | **Prerequisites** - The Order state matches one of the rows above. - The required branch, approval, subscription, and invoice conditions are satisfied. - You have checked whether active delivery or binding invoices prevent a reversal. **Steps** 1. Open the Order panel menu. 2. Select the control that matches the current Order state. 3. If a rejection dialog opens, complete the rejection fields shown in that dialog. 4. If the return-to-Offer confirmation opens, select **Back to inquiry**. 5. If the confirmation asks for acceptance, select **OK**. 6. Check the stage bar and the Order panel menu for the resulting state. **Result:** The permitted correction, rejection, cancellation, return, or amendment route is completed, and the record shows the resulting state or the reason the action remains unavailable. After selecting **Cancelled order**, use **Approve Cancelled**, **Disapprove Cancelled**, or **Consider As Not Cancelled** when those controls appear for the current approval state. ## When an order action does not work Use the message on screen and the current record state to locate the blocker. | What you see | What it means | What to check | |---|---|---| | `Order must have at least one item` | The Order has no item. | Add at least one item before confirmation. | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | A quantity is outside its permitted range. | Check **Qty**. | | `Invalid input. Please enter a non-negative value` | A price is negative. | Check **Unit Price** or **Item Price**. | | `Please enter action for each milstone ` | A payment milestone has no action. | Complete the action for every payment milestone. | | `This field is required` | A configured required field is empty. | Complete the field marked as required. | | `This action is only allowed if you belong to that branch.` | The job belongs to a branch you do not belong to. | Use the job's branch context or contact the branch owner. | | `Cannot be converted to delivered because the PM process is ongoing.` | The delivery check does not permit delivery while the PM process is ongoing. | Complete or resolve the PM process before delivery. | | `This order has binding invoices. It cannot be reverted.` | An attempted reversal is blocked by binding invoices. | Continue with the invoice-bound state rather than reverting it. | | **Activate Order** is absent | The record is not in an activation state, or it is an earlier stage such as Inquiry. | Check the stage bar and open the Order panel on an Order-stage record. | | **Order amendment** is absent | The Order is not Valid or Ready For Shipment, or the Order Amendment subscription is unavailable. | Check the Order state and subscription. | | Approval controls are absent | No approval process applies, or your approval capability does not permit the action. | Check the configured approval process and your capability. | | `An error occurred while processing your request` | Processing stopped without a more specific message. | Check the record state, permissions, branch, and required values before retrying. | The validation also checks item descriptions, discounts, tax, **Client**, **Vendor**, and configured form validators. Price and quantity errors can therefore appear alongside the messages above. ### Messages Use the context column to decide whether a message belongs to Order work before acting. | Context | Message | |---|---| | Order quantity validation | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | | Order price validation | `Invalid input. Please enter a non-negative value` | | Payment-milestone validation | `Please enter action for each milstone ` | | Order item validation | `Order must have at least one item` | | Order delivery reversal | `Cannot be un-delivered — a due invoice already exists` | | Shared Order action | `An error occurred while processing your request` | | Shared confirmation | `Your request was completed successfully` | | Shared validation | `This field is required` | | Custom-field confirmation | `Custom fields saved successfully` | | Sales-job confirmation | `Job updated successfully` | | Archived-job confirmation | `Job deleted successfully` | | Archived-job confirmation | `Job regretted successfully` | | Archived-job confirmation | `Job cancelled successfully` | | Archived-job confirmation | `Job missed successfully` | | Archived-job confirmation | `Job reactivated successfully` | | Sales-job conversion | `Converted to offer successfully` | | Sales-job conversion | `Converted to inquiry successfully` | | Custom-field error | `Error saving custom fields` | | Offer reversal validation | `All offers must be in draft status to revert to inquiry` | | Account validation | `An account with this name already exists` | | Project validation | `A project with this name already exists` | | Inquiry validation | `Please save opened inquiry first` | | Inquiry reversal validation | `All inquiries must be in draft stage to revert to potential` | | Account validation | `Error: Vendor not saved yet` | | Account validation | `Error: Client not saved yet` | | Account validation | `This Field Is Required` | | Contact validation | `You already have a contact with this name` | | Bill-of-materials validation | `Booked quantity for this job is greater than the required BOM quantity` | | Purchasing restriction | `You cannot edit or delete the product after the purchase package is created` | | Purchasing restriction | `Cannot be deleted. Product is in purchasing` | | Purchase-order restriction | `You cannot edit the product after the PO is created` | | Bill-of-materials restriction | `This product is already included in BOM` | | Product restriction | `The first variant cannot be deleted` | | CRM error | `An error occurred while connecting to your CRM system.` | | Product selection validation | `Please select one product` | | Procurement validation | `Required Receiving After` | | Material-requisition validation | `You cannot save without adding at least one product` | | Task restriction | `This record is related to saved data and cannot be deleted` | | Activity restriction | `Action not allowed` | | Purchasing validation | `Please select one or more items to create a RFQ.` | | Procurement-inquiry validation | `Required Offer Type` | | Procurement-inquiry validation | `Required Bid Due Date` | | Reference validation | `Serial you have entered already exist and belong to same manufacturer` | | Reference validation | `There is error in serial you have entered` | | Reference validation | `Minimum: At least one serial` | | Letter-of-guarantee validation | `Please Add Extension to activate the LG` | | Letter-of-guarantee restriction | `LG has one or more extensions or deductions and cannot be reverted to the requested stage` | | Letter-of-guarantee validation | `Please choose a date after the current expiry date` | | Activity validation | `One topic and at least one note is required` | ### Out-of-scope messages #### Contacts and account messages When you work with contacts or account details, these messages relate to those areas rather than to the Order panel. | Owning context | Message | |---|---| | Contacts | `Forbidden characters detected. Please remove them and try again.` | | Deliveries | `Error loading accounts` | | Procurement order | `Required Receiving Date` | | Accounts | `Error: Vendor not saved yet` | | Accounts | `Error: Client not saved yet` | | Accounts | `This Field Is Required` | | Contacts | `You already have a contact with this name` | | Bill of materials | `Booked quantity for this job is greater than the required BOM quantity` | | Bill of materials | `You cannot edit or delete the product after the purchase package is created` | | Bill of materials | `Cannot be deleted. Product is in purchasing` | | Bill of materials | `You cannot edit the product after the PO is created` | | Products | `This product is already included in BOM` | | Products | `The first variant cannot be deleted` | | Products | `An error occurred while connecting to your CRM system.` | | Products | `Please select one product` | | Material requisition | `You cannot save without adding at least one product` | | Tasks | `This record is related to saved data and cannot be deleted` | | Activities | `Action not allowed` | | Purchasing | `Please select one or more items to create a RFQ.` | | Procurement inquiry | `Required Offer Type` | | Procurement inquiry | `Required Bid Due Date` | | Procurement order | `Required Receiving After` | | Offers | `Please save opened cost sheet first` | | Item selection or package page | `No remaining items. All items have been selected` | | Package page | `Package must have at least one item` | | Inquiry page | `Inquiry must have at least one item` | | Offer page | `Offer must have at least one item` | | Email dialog | `Please enter at least one email` | | Item maintenance page | `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | | Item maintenance page | `One or more items has ZERO quantity` | | Item maintenance page | `One or more items has no unit` | ## Continue after the order Delivered is the normal destination after all active Order work is delivered. For an external supplier, delivery creates a draft invoice and the message directs you to the **Invoices** tab. Completed work is available under **Archived** > **Delivered**. Detailed delivery work after the Order page belongs to the warehouse process. | After this Order outcome | Continue in | |---|---| | All active order work is delivered | **Sales** > **Sales jobs** > **Archived** > **Delivered** | | External-supplier delivery created a draft invoice | **Invoices** tab | | Warehouse receipt, inspection, stock, issue, or delivery-note work remains | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | | A terminal or archived exception needs review | [Missed, regretted, and cancelled jobs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/missed-regretted-and-cancelled-jobs) | # From orders to delivered Use this page to open a saved Order, check its order details, move it through the available confirmation and delivery actions, and continue detailed fulfillment in Warehouse. ## Sales handoff An Order is the saved sales commitment that the Orders work area manages from confirmation through delivery. Orders ends when the Order reaches **Delivered**; detailed receiving, inspection, stock, issue, and delivery-note work belongs in Warehouse. ```mermaid flowchart LR O[Order] --> C[Orders confirmation and activation] C --> D[Delivered] D --> W[Warehouse detailed delivery work] ``` The Order panel offers confirmation, activation, shipment, delivery, and correction choices; the Orders list includes **Delivered**, while detailed delivery work continues in Warehouse after the handoff. | If you need to… | Go to | |---|---| | Find and open a saved Order | [Find and open the Order](#find-and-open-the-order) | | Read the Order fields and item grid | [Understand the Order panel](#understand-the-order-panel) | | Confirm or activate the Order | [Confirm and activate the Order](#confirm-and-activate-the-order) | | Prepare shipment or record delivery | [Prepare shipment and deliver the Order](#prepare-shipment-and-deliver-the-order) | | Correct a blocked or changed Order | [Correct the Order and handle problems](#correct-the-order-and-handle-problems) | | Continue detailed delivery work | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | | Follow the draft invoice created by delivery | Invoice lifecycle | ![Orders work list with the Orders and Delivered work tabs](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/a7e0b2610eb91658aa53c379c198b91a.png) ## Before you start An Order change starts from a saved record in the right branch and supplier context. Check these conditions before opening an action that changes the record. | Have or check | Why it matters | |---|---| | A saved Order | The Order action area works on an existing saved record. | | An editable record with no unsaved Order changes | Confirmation and other committing actions use the saved values. | | The correct branch | Delivery actions are restricted to members of the Order's branch. | | The applicable supplier type | Own-company and external-supplier Orders follow different shipment and delivery routes. | | **Client**, **Vendor**, and at least one item | Confirmation requires the parties and an item. | | Item descriptions, quantities, and prices | The Order validates item content before it progresses. | | A passing delivery check | An ongoing PM process can block delivery. | | The approval route, where configured | Approval actions appear only when the approval process and your capability allow them. | Do not rely on a field being required in every company. The form can make **Client Order No.**, **Vendor Order No.**, **Order Date**, **Order Activation Date**, **Delivery Time**, **Delivery Term**, **Payment Method**, **Payment Period**, **L/C Number**, and **External order no.** mandatory according to the configured rules. ## Find and open the Order The Orders work list is the list view for saved sales jobs at the Order stage. Opening a row takes you to that record without changing it. **Prerequisites** - You know which saved Order to open. - You can open the Orders work list. **Steps** 1. Open the Orders work list at `/sales/list/orders/view`. 2. Check that the **Orders** tab is visible. 3. Select the row for the saved Order. 4. Check the address after the row opens. The record opens at `/sales/edit/`. 5. Leave the record unchanged while you review it. After you select an Order row, the record route resolves, the panel can be expanded, and the menu can be opened without changing the record. **Result:** The saved Order record is open at its resolved record route. ## Understand the Order panel The Order panel is the part of the record that holds the parties, commercial order details, delivery and payment information, and item lines. The Order panel is available for an Order-stage record or a later stage, and the item area is shown while the order record is open. **Prerequisites** - You have opened the saved Order record. **Steps** 1. Locate the Order panel in the opened record. 2. Check **Client** and **Vendor** to confirm the parties. 3. Review the order fields that your form displays. 4. Review the item grid before changing an item. 5. Open the Order action menu. 6. Use only the action that matches the current Order state and your task. **Result:** The Order panel, item grid, and state-dependent action area are available for review. After you expand the record, **Client** and **Vendor** are visible, and the menu contains **Order amendment** and **Enable Editing**. | Area | Fields and rules | |---|---| | Order references | **Client Order No.** and **Vendor Order No.** are configurable text fields. | | Dates | **Order Date**, **Order Activation Date**, and **Forecasted Delivery Date** are date fields; the first two can be configurable requirements. | | Delivery | **Delivery Time** is a configurable number field, and **Delivery Term** is a configurable choice. | | Payment | **Payment Method** and **Payment Period** are configurable choices; **L/C Number** is a configurable text field. | | External reference | **External order no.** is a configurable text field. | | Delivery choice | **Partial delivery** is a configurable boolean field. | The item grid contains **Item Description**, **Unit**, **Qty**, **Unit Price**, **Item Price**, and read-only **Currency**. Package items disable **Unit**, **Qty**, and **Unit Price**. Unitized items disable **Item Price**. The available choices for **Delivery Term**, **Payment Method**, **Payment Period**, and **Unit** come from the records returned to the corresponding lists, so use the choices displayed in your Order rather than expecting a fixed list. The action area can include the following controls, depending on state, approval, branch, subscription, and record conditions: | Purpose | Available control | |---|---| | Start or review the Order route | **Order**, **Received job**, **Received** | | Reject or cancel acceptance | **Reject order acceptance**, **Cancelled by client**, **Cancel order** | | Return or correct the Order | **Back to Offer**, **Order amendment**, **Enable Editing**, **Delete amendment order** | | Save or request approval | **Save**, **Request Approval**, **Approved**, **Request approval**, **Approve**, **Reject Approval** | | Continue supplier work | **Cancel ready for purchasing**, **Send order award to Sub-supplier** | Use the choices displayed in the Order for the four select fields. Continue detailed delivery work from the Warehouse handoff after the Order reaches **Delivered**. ## Confirm and activate the Order Confirmation records that the accepted Order is ready for the next part of its route. Activation records the activation date when the Order is waiting for activation. | Order condition | Action to look for | |---|---| | The Order is waiting for activation | **Activate Order** | | The Order has no activation conditions | **Insert activation conditions** | | Approval is required before the Order can proceed | **Request Approval**, **Approved**, or the applicable approval action | | The Order is ready for the next route | **Received** or the applicable action shown in the Order menu | **Prerequisites** - The Order is saved and editable. - **Client**, **Vendor**, and at least one item are present. - The configured mandatory fields and item validations pass. - The approval process, where configured, identifies the applicable approval action. **Steps** 1. Open the Order action menu. 2. Select the action that matches the Order condition. | Order condition | Select | |---|---| | The Order must enter the approval route | **Request Approval** | | The Order is ready for approval | **Approved** or the applicable approval action | | The Order is waiting for activation | **Activate Order** | | The Order is ready for the next route | **Received** or the applicable action shown in the Order menu | 3. Enter **Order Activation Date** when the activation form requires it. 4. Check the date before submitting the activation confirmation. 5. Select **Save** after completing the Order values. 6. Check the Order state and action menu after saving. A missing configured field produces `Check mandatory field(s)` or `This field is required`. **Result:** The saved Order remains in the state permitted by its activation and approval conditions, ready for the shipment or delivery route described next. ## Prepare shipment and deliver the Order Shipment and delivery depend on the supplier context and on the Order being ready for that route. The resulting business state is **Delivered** when the active Order work has been delivered. | Supplier or Order condition | Delivery path | |---|---| | Own-company supplier | The Order can pass through its readiness state before delivery. | | External supplier | The Order can use its delivery route directly when its delivery conditions pass. | | Delivery check fails | Delivery stops until the delivery check permits it. | | Branch membership fails | Delivery is refused for the current branch context. | **Prerequisites** - The Order is confirmed or activated as required by its current state. - The supplier context is known. - You belong to the Order's branch. - The delivery check permits the action. **Steps** 1. Open the Order action menu. 2. Check the supplier context before choosing a shipment action. 3. Select **Received** when it is the available action for the ready Order. 4. Check the Order state after the action completes. 5. Open the **Delivered** work list when the Order reaches Delivered. **Result:** The Order is in the state returned by the selected delivery action; when the active Order work is complete, the work appears under **Delivered**, where you can follow the post-delivery handoff. ## Correct the Order and handle problems Use a correction action that matches the Order's current state. An amendment is the correction route for an eligible Order; cancellation, rejection, and return actions are separate state-dependent routes. | Current condition | Action or response | |---|---| | The Order needs a permitted amendment | Select **Order amendment**. | | The Order must become editable | Select **Enable Editing**. | | The Order is ready for purchasing and the branch state permits it | Select **Cancel ready for purchasing**. | | The Order must be rejected or cancelled | Use **Reject order acceptance**, **Cancelled by client**, or **Cancel order** as shown. | | A return to the offer route is permitted | Select **Back to Offer**. | | A delivered or ready item must be removed | Do not delete it; items labelled **Ready For Shipment** or **Delivered** cannot be deleted. | **Prerequisites** - The current Order state matches the correction action. - You have the required branch, approval, and editing capability. - You have checked the item and payment-milestone values before saving. **Steps** 1. Open the Order action menu. 2. Select **Enable Editing** when the record is locked for editing. 3. Select **Order amendment** when the Order is eligible for an amendment. 4. Edit the field that contains the incorrect value, such as **Client Order No.**, **Vendor Order No.**, **Order Date**, **Delivery Term**, **Payment Method**, **Item Description**, **Qty**, **Unit Price**, or **Item Price**. 5. Complete every payment-milestone action when payment milestones are displayed. 6. Select **Save**. 7. Check the resulting Order state and any message on screen. If delivery is blocked, use the message to choose the next route. | Message | What to check | |---|---| | `An error occurred while processing your request` | Check the Order state, permissions, branch, and required values. | | `No remaining items. All items have been selected` | Review the item selection before continuing. | | `Package must have at least one item` | Add an item to the package. | | `This action is only allowed if you belong to that branch` | Open the Order in the correct branch context. | | `Inquiry must have at least one item` | Add an inquiry item before returning to that route. | | `Offer must have at least one item` | Add an offer item before returning to that route. | | `Order must have at least one item` | Add at least one Order item. | | `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Keep the protected item and use an amendment route instead. | | `Check mandatory field(s)` | Complete the configured required fields. | | `Please select one or more items to create a RFQ.` | Select the items required for the RFQ action. | | `Please enter action for each milstone` | Complete the action for every payment milestone. | | `Cannot be un-delivered — a due invoice already exists` | Continue with the invoice-bound state rather than reversing delivery. | | `All offers must be in draft status to revert to inquiry` | Return the offers to Draft before reverting. | | `All inquiries must be in draft stage to revert to potential` | Return the inquiries to Draft before reverting. | | `This field is required` | Complete the field marked as required. | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Correct the affected quantity. | | `Invalid input. Please enter a non-negative value` | Correct the affected price. | | `Custom fields saved successfully` | The custom-field save completed. | | `Job updated successfully` | The Order update completed. | | `Job deleted successfully` | The job deletion completed; do not use deletion as a correction route for an active Order. | | `Job regretted successfully` | The regret action completed. | | `Job cancelled successfully` | The cancellation action completed. | | `Job missed successfully` | The missed-job action completed. | | `Job reactivated successfully` | The reactivation action completed. | | `Converted to offer successfully` | The conversion to Offer completed. | | `Converted to inquiry successfully` | The conversion to Inquiry completed. | | `Converted To Regretted` | The conversion to Regretted completed. | | `Converted to cancelled` | The conversion to Cancelled completed. | | `Converted to lost` | The conversion to Lost completed. | | `Error saving custom fields` | Review the custom-field values and save again when the route permits. | | `Please save opened inquiry first` | Save the opened Inquiry before continuing. | | `One or more items has ZERO quantity` | Enter a quantity greater than zero. | | `One or more items has no unit` | Choose a unit for each affected item. | **Result:** The Order is corrected through the available amendment, editing, approval, rejection, cancellation, or return route, or the displayed message identifies the condition that still blocks the action. When it reaches **Delivered**, continue with the post-delivery steps. ## Continue after delivery **Delivered** is the completed Order outcome for the active Order work. The Delivered work list contains that completed work; detailed delivery work continues in Warehouse. **Prerequisites** - The Order has reached **Delivered**, or the delivery attempt has ended. - You know whether delivery created a draft invoice. **Steps** 1. Open the Delivered work list at `/sales/list/delivered/view`. 2. Check that the **Delivered** label is visible. 3. Open the delivered Order when you need to review its sales record. 4. Open the **Invoices** tab when delivery creates a draft invoice. 5. Open [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) for receiving, inspection, stock, issue, or delivery-note work. The delivery response can create a draft invoice and directs you to the **Invoices** tab. Open [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) for the detailed delivery work. **Result:** You can locate the completed Order, follow its draft-invoice handoff, and continue detailed delivery work in Warehouse. # Missed, regretted and cancelled jobs Exit work is a sales job that has left the active Potentials, Inquiries, Offers, or Orders path. Use this page to find the archived outcome, understand which active-stage work it leaves, and recover eligible Potential, Offer, or Order work. ## Missed, regretted and cancelled jobs The active sales-job path runs through Potentials, Inquiries, Offers, and Orders. Archived outcome lists sit after that path and collect completed or exited work. Use them to classify an exit and return eligible work to the active stage that owns its next action. | If you need to… | Go to | |---|---| | Find an archived outcome list | [Find an exit list](#find-an-exit-list) | | Decide whether the job left Potential or Inquiry work | [Assess Potential exits](#assess-potential-exits) | | Decide whether the job left Offer work | [Assess Offer exits](#assess-offer-exits) | | Separate cancelled or rejected Orders from deleted work | [Assess Order and deleted exits](#assess-order-and-deleted-exits) | | Return an eligible archived job to active work | [Recover an archived job](#recover-an-archived-job) | | Restore a deleted job | [Restore deleted work](#restore-deleted-work) | | Understand why an exit was recorded | [When an exit is recorded](#when-an-exit-is-recorded) | | Continue with the active stage | [What to do next](#what-to-do-next) | The **Archived** list contains **Delivered**, **Lost**, **Regretted to Offer**, **Cancelled Inquiries**, **Cancelled Orders**, **Rejected Orders**, **Missed**, and **Deleted Inquiries**. The exit labels do not all identify the same point in the lifecycle: **Missed** leaves Potential work, while **Regretted to Offer** can leave Inquiry or Offer work. ```mermaid flowchart LR P[Potential] --> I[Inquiry] I --> O[Offer] O --> R[Order] P --> M[Missed] I --> CI[Cancelled Inquiries] I --> RO[Regretted to Offer] O --> RO O --> L[Lost] O --> CO[Cancelled Offer] R --> CA[Cancelled Orders] R --> RE[Rejected Orders] ``` ## Before you start An exit label tells you which archived list to open; edit access determines whether recovery actions are available. **Prerequisites** - Know the outcome label shown for the job: **Missed**, **Regretted to Offer**, **Cancelled Inquiries**, **Cancelled Orders**, **Rejected Orders**, **Lost**, or **Deleted Inquiries**. - Have edit access. - Recovery actions are unavailable when you open the job from another record. - Decide which active stage should own the next action. Recovery returns Potential work to Potential, Offer work to Offer, or Order work to Order. ## Find an exit list The Sales jobs list is the read-only starting point for reviewing archived outcomes. Use **Archived** to expose the outcome filters, then select the filter that matches the label on the job. **Prerequisites** - You can open **Sales** and **Sales jobs**. - You are reviewing the list without changing a record. **Steps** 1. Open **Sales jobs** from **Sales**. 2. Select **Archived**. 3. Select one of the outcome filters in the table. | If the outcome is… | Select… | |---|---| | Regret from Inquiry or Offer work | **Regretted to Offer** | | Cancelled Inquiry work | **Cancelled Inquiries** | | Cancelled Order work | **Cancelled Orders** | | Missed Potential work | **Missed** | 4. Read the visible headers to identify the columns in the selected list. ![Use the Archived filters and the visible list headers to choose an exit list.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c0fb3ed709236a4e6491f508d45ac803.png) The list columns come from the selected list layout. The four list layouts contain the following headers: | List | Visible columns | |---|---| | **Regretted to Offer** | `Job No.`, `File No.`, `Sales responsible`, `Vendor`, `Client`, `Job title`, `Offer price (€)`, `Regret reason`, `Regret date` | | **Cancelled Inquiries** | `Job No.`, `File No.`, `Sales responsible`, `Vendor`, `Client`, `Job title`, `Offer price (€)`, `Cancel reason`, `Cancelled date` | | **Cancelled Orders** | `Job No.`, `File No.`, `Sales responsible`, `Vendor`, `Client`, `Job title`, `Order price (€)`, `Order price (incl. tax)`, `Order backlog (€)`, `Order date`, `Forecast delivery date`, `Cancel reason`, `Cancelled date` | | **Missed** | `Job No.`, `File No.`, `Sales responsible`, `Vendor`, `Client`, `Job title`, `Estimated value`, `Inquiry date`, `Bid due date`, `Inquiry type`, `Inquiry stage` | On these non-**All** lists, the list opens without **Incl. archived Jobs**. Selecting another outcome filter opens the corresponding list without changing job data. **Result:** The matching archived outcome list is open, its visible headers identify the available job details, and no record data has changed. Continue with the section for the exit type you found. ## Assess Potential exits Potential work is an early sales opportunity recorded before a formal customer inquiry exists. Inquiry work is the customer request used to prepare an offer. Use the exit label and list headers to decide which of these work areas needs attention next. **Prerequisites** - You are on an archived outcome list. - You can read the outcome filter and the visible row headers. **Steps** 1. Select the list that matches the archived label. | Situation | Select… | Treat the row as… | |---|---|---| | A Potential exit marked missed | **Missed** | Returned Potential work | | An inquiry-related cancellation | **Cancelled Inquiries** | Inquiry-related exit work | 2. Use the headers in the table to identify the row before opening it. | List | Headers that help identify the work | |---|---| | **Missed** | `Job No.`, `Client`, `Job title`, `Estimated value`, `Inquiry date`, `Bid due date`, `Inquiry type`, `Inquiry stage` | | **Cancelled Inquiries** | `Job No.`, `Client`, `Job title`, `Offer price (€)`, `Cancel reason`, `Cancelled date` | Cancellation changes inquiry work to **Cancelled Inquiries** only when no active Potential remains. Regret from inquiry work requires no active Potential or active Inquiry. These conditions explain why an exit can appear after the active work has been cleared. **Result:** You know whether the archived row is Missed Potential work or Cancelled Inquiry work and which active-stage page owns the next action. For an Offer-related row, continue with Assess Offer exits; for an Order or deleted row, continue with Assess Order and deleted exits. ## Assess Offer exits An Offer is the priced commercial proposal between Inquiry and Order. Offer-related exits include **Regretted to Offer**, **Lost**, and cancelled Offer work; the archived list is the place to classify the outcome before deciding whether to recover it. **Prerequisites** - You know the archived outcome label. - You can read the row's reason, date, parties, and price where those headers are available. **Steps** 1. Select the list that matches the Offer-related outcome. | If the outcome is… | Select… | |---|---| | Regret recorded from Inquiry or Offer work | **Regretted to Offer** | | Loss from Offer work | **Lost** | 2. Use the Offer-related row details to distinguish regret, loss, and cancellation before recovery. 3. Check that no active Offer remains before treating cancelling or regretting an Offer as a final job-level exit. 4. Check that losing an Offer also affects linked purchasing jobs and inquiries. The **Regretted to Offer** list includes `Job No.`, `File No.`, `Sales responsible`, `Vendor`, `Client`, `Job title`, `Offer price (€)`, `Regret reason`, and `Regret date`. **Result:** You have classified the Offer-related exit and know whether the next move is Offer recovery or work in the owning stage. For an Order or deleted row, continue with Assess Order and deleted exits; for an eligible row, continue with Recover an archived job. ## Assess Order and deleted exits Order work records the accepted commercial commitment that follows an eligible Offer. Cancelled and rejected Orders are separate archived outcomes; **Deleted Inquiries** is a separate deleted-work list. **Prerequisites** - You know whether the row is an Order outcome or deleted work. - You have opened the matching archived filter. **Steps** 1. Select the list that matches the archived row. | If the row is… | Select… | |---|---| | Cancelled Order work | **Cancelled Orders** | | Rejected Order work | **Rejected Orders** | | Deleted work | **Deleted Inquiries** | 2. Check that no active Order remains before treating cancellation or rejection as a job-level exit. 3. Use the **Cancelled Orders** headers to identify the Order row. | List | Visible columns | |---|---| | **Cancelled Orders** | `Job No.`, `File No.`, `Sales responsible`, `Vendor`, `Client`, `Job title`, `Order price (€)`, `Order price (incl. tax)`, `Order backlog (€)`, `Order date`, `Forecast delivery date`, `Cancel reason`, `Cancelled date` | | **Deleted Inquiries** | Use the columns visible in the selected list layout. | **Ultimate Delete** is available for a deleted job when you have edit access outside an embedded context. **Result:** You have separated Cancelled Orders, Rejected Orders, and Deleted Inquiries and can choose the matching recovery route. Continue with Recover an archived job for non-deleted work or Restore deleted work for a deleted job. ## Recover an archived job Reactivation returns eligible archived Potential, Offer, or Order work to the active stage that feeds the focused page. It is different from restoring deleted work. **Prerequisites** - The job is not in **Deleted Inquiries**. - You can edit the job. - You opened the job outside an embedded record context. **Steps** 1. Open the archived job from its outcome list. 2. Select **Reactivate Job**. ![Open an archived row from the outcome list before choosing its recovery action.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c0fb3ed709236a4e6491f508d45ac803.png) 3. Read the confirmation dialog titled `You are about To reactivate this job`. 4. Select **Yes** in the confirmation dialog. 5. Confirm that the message reads `Job reactivated successfully`. 6. Open the returned job. 7. Read its stage label. | Archived work | Returned stage | |---|---| | Cancelled or regretted Potential work | `Potential` | | Regretted, cancelled, or lost Offer work | **Offer** | | Rejected or cancelled Order work | **Order** | **Result:** The job is active again in `Potential`, `Offer`, or `Order`, and the success message confirms the reactivation. Continue with the page for the returned active stage. ## When an exit is recorded An exit is recorded when the stage-specific condition is met; the archived labels are not interchangeable. The active-work condition determines whether the job changes to the corresponding exit stage. | Exit | Stage-specific condition | |---|---| | **Missed** | The job leaves Potential work as Missed. | | **Cancelled Inquiries** | Inquiry cancellation changes the job only when no active Potential remains. | | **Regretted to Offer** | Regret can leave Inquiry or Offer work; Offer regret changes the job only when no active Offer remains. | | **Lost** | Loss leaves Offer work and changes the job only when no active Offer remains. | | Cancelled Offer | Offer cancellation changes the job only when no active Offer remains. | | **Cancelled Orders** | Order cancellation changes the job only when no active Order remains. | | **Rejected Orders** | Order rejection changes the job only when no active Order remains. | Losing an Offer also cancels linked purchasing jobs and inquiries. This is why loss affects related work rather than only the archived sales-job label. ### Restore deleted work Deleted work is a job removed from the active path but still available in **Deleted Inquiries** for an editor to restore outside an embedded context. **Prerequisites** - You opened the deleted job outside an embedded record context. - You have edit access. **Steps** 1. Open the job from **Deleted Inquiries**. 2. Select **Restore**. ![Identify Restore on a deleted job before choosing a recovery action.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c0fb3ed709236a4e6491f508d45ac803.png) 3. Confirm that the job returns to `Potential`. 4. Confirm that the message reads `Your request was completed successfully`. **Result:** The deleted job is restored to `Potential`. ## When exit information is missing If the list does not show the detail you need, open the owning active-stage page after recovery or ask your administrator to confirm the saved list layout. Navigation between the four outcome lists is read-only and does not display a message or dialog. These messages can also appear for shared-list actions: | If you… | The screen can show… | |---|---| | Open the export dialog | `Exporting List:` | | Start a delete action | `Are you sure you want to Delete this Job ?` | | Enter forbidden characters | `Forbidden characters detected. Please remove them and try again.` | | Encounter an account-loading failure | `Error loading accounts` | | Encounter a shared request failure | `An error occurred while processing your request` | Do not assume that every archived state is recoverable. Use **Reactivate Job** for eligible non-deleted work and **Restore** for deleted work when those controls are available to you. The conditions and returned stages in this page are the supported recovery routes. ## What to do next After you classify an exit, continue in the page that owns the active stage or lifecycle explanation. Use the Sales jobs lifecycle page for the complete active path and exit map. Continue recovered Potential work on the Potentials page, Inquiry-related work on the Inquiries page, recovered Offer work on the Offers page, and recovered Order work on the Orders page. | Your result | Continue with | |---|---| | You need the complete active and exit map | Sales jobs lifecycle | | A job returned to `Potential` | Potentials | | Inquiry-related work needs attention | Inquiries | | A job returned to **Offer** | Offers | | A job returned to **Order** | Orders | # Create a sales job Use this page to start a sales job, complete its shared information, save it, and continue in the saved sales-job workspace. ## Overview A sales job is the shared record for sales work that continues through the sales stages. A Potential is an early sales opportunity recorded before a formal customer request exists. An Inquiry is the formal customer request that carries the client, vendor, requested items, and bid due date needed to prepare an offer. A normal Inquiry starts at the Potential stage; after you create it, the saved record opens in the edit workspace where you continue the job. Creation begins from the sales-job lists. The normal Inquiry route opens the new-job form, and a saved job continues in the Sales edit workspace. Start with the shared header and route-specific entry point, then save the record. Detailed Potential and Inquiry panels, their item grids, and later lifecycle work continue on their focused pages. | If you need to… | Go to | |---|---| | Check which creation route to use | [Find or open a sales job](#find-or-open-a-sales-job) | | Recognize the shared form and its stage-dependent areas | [Understand the sales-job form](#understand-the-sales-job-form) | | Fill the common fields | [Enter the main job information](#enter-the-main-job-information) | | Complete Potential or Inquiry details and items | [Complete the applicable stage details and items](#complete-the-applicable-stage-details-and-items) | | Correct a blocked save | [Save the sales job and handle validation](#save-the-sales-job-and-handle-validation) | | Follow the saved job through its stages | [Sales job lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle) | | Locate an existing job in a list | [Find sales job work](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/find-sales-job-work) | | Work with Potential-specific details | Potentials | | Work with Inquiry-specific details | Inquiries | | Work with item rows | Sales job items | | Review the saved record | Sales job record | | Follow up with tasks or activities | Sales job comments and tasks; Sales job activities and files | For a normal Inquiry, complete the client and vendor, the responsible salesperson, product type, job title, bid due date, and an item before selecting **Save**. For a Potential, complete the same shared information and item-entry pattern. ![The blank new sales-job form with the creation route visible](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9b733ca4a9449ef6be4ae2754501e00c.png) When a normal Inquiry is created, its **Estimated Value** is copied to each created sales potential. ## Prerequisites — what must be in place for this to go smoothly Before creating a sales job, the Sales Jobs subscription and permission to create a new job must be available. Have the responsible salesperson, product type, job title, parties, and any route-specific details ready. The form checks the information before saving, so a changed record is required before the save controls become available. | What must be in place | Why it matters | |---|---| | Sales Jobs subscription | The sales-job creation surface is available only when the subscription includes it. | | Permission to create new jobs | Without it, creation is refused. | | Salesperson, product type, and job title | These shared fields are required before creation. | | Client, Vendor, due date, and item information for an inquiry | The Inquiry route requires its party and due-date information and uses item rows. | | A changed form | **Save** and **Save and Close** become available after a change. | If the subscription or permission is unavailable, creation does not proceed. The access message is shown as `You don’t have permission to create new jobs`. **Note:** The required marker for configurable fields follows company configuration. Review the markers shown beside **Salesperson Responsible**, **Product Type**, **Job Title**, **File Number**, **Client**, **Vendor**, **Bid Due Date**, and any other visible configurable field. ## Find or open a sales job The sales-job lists separate work by stage, while **Add new** opens the available starting points for a new job. Use the stage list when you need an existing record; use a creation choice when you are starting a new one. | If you need to… | Select | |---|---| | Open all sales jobs | **All** | | Open early opportunity work | **Potentials** | | Open inquiry work | **Inquiries** | | Open offer work | **Offers** | | Open order work | **Orders** | | Start a new inquiry | **Inquiry** under **Add new** | | Start a direct order | **Direct order** under **Add new** | | Start a standing job when it is available | **Standing job** under **Add new** | **Prerequisites** - You can access the Sales Jobs area. - You know whether you need a new job or an existing record. **Steps** 1. Open the Sales Jobs list. 2. Select **Add new**. 3. Select the starting point that matches the work. | If you need to… | Select | |---|---| | Begin the normal inquiry route | **Inquiry** | | Begin early opportunity work | **Potentials** | | Begin an order directly | **Direct order** | | Begin a standing job when the option is shown | **Standing job** | 4. For an existing job, select the stage list that contains it. 5. Select the job's data row. The available stage lists are **All**, **Potentials**, **Inquiries**, **Offers**, and **Orders**. Selecting **Direct order** under **Add new** opens **Order**. **Result:** A new-job form or the selected sales-job record is on screen. If you are creating a job, continue by reviewing the shared form. ![The Add new menu with the available creation choices](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3d63d3fc3821f3c60f4bb3cd38d51f13.png) ## Understand the sales-job form The new-job form is the shared workspace for the job header and the stage area selected by the route. Its fixed header includes the job status and common information; company configuration can add custom fields and change which fields are required. | Area | What to look for | |---|---| | Header | **Save**, **Save and Close**, and **Reset**. | | Fixed information | **Status**, **Branch**, **Salesperson Responsible**, **Product Type**, and **Job Title**. | | Additional shared information | **End User**, **Estimated Value**, **File Number**, and **Expected Order Date**. | | Company-configured information | Additional fields your company has configured. | | Stage area | The selected route's panel and item work. | | Assessment information | **Order chance**, with related assessment fields where shown. | The visible stage labels include **Inquiry**, **Offer**, **Order**, and **Delivered**. The form also displays In Branch Currency (Rate:1) and **Calculated Rating** as readouts. Picker and date controls open without changing the record. **Prerequisites** - Open a new sales-job route. - Do not need to save while inspecting the form. **Steps** 1. Read the fixed header fields before opening a stage panel. 2. Select **Reset** only when you need to discard the current form changes. 3. Select **New inquiry** to open the inquiry-specific area. 4. Open each picker or date control only when you need to inspect its choices. **Result:** The shared header and the selected stage area are visible, with company-configured fields and stage-dependent controls appearing where they apply. ![The shared sales-job header, fixed fields, and stage area](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/fce4ed65caf1178b3b786ffd780ba17f.png) ## Enter the main job information The main information identifies who owns the work, what is being sold, and how the job can be found later. Complete these fields before saving; the form checks the information before saving. | Field | What to enter | |---|---| | **Salesperson Responsible** | Select the person responsible for the sales job. | | **Product Type** | Select the product type for the job. | | **Job Title** | Enter the job title. The title accepts letters, spaces, `_`, `-`, and `.`; special characters are rejected. | | **End User** | Select the end user when the field is required by your configuration. | | **Estimated Value** | Enter the estimated value when the field is required by your configuration. | | **File Number** | Enter the file number when the field is required by your configuration. | | **Expected Order Date** | Select the expected date when the field is shown for the selected stage. | **Estimated Value** cannot be less than `0`. For a new job, **Expected Order Date** cannot be earlier than today. **Prerequisites** - You have opened the new-job form. - You have the responsible salesperson, product type, and job title. - You have the estimated value, file number, end user, and expected date when your route or company configuration requires them. **Steps** 1. In **Salesperson Responsible**, select the responsible salesperson. 2. In **Product Type**, select the product type. 3. In **Job Title**, enter the job title. 4. In **End User**, select the end user when the field is required for your job. 5. In **Estimated Value**, enter the estimated value when the field is required for your job. 6. In **File Number**, enter the file number when the field is required for your job. 7. In **Expected Order Date**, select the expected order date when the field is shown for your stage. 8. Review the visible required markers before saving. If a required value is empty, the form uses `This field is required`. If the job title contains an unsupported character, it uses `Just '_' '-' And '.' Characters Accepted`. After you complete the shared fields, continue to the applicable stage details. ![The shared fields before stage-specific details are entered](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5096259ff88c0ac3558eeaa78617055b.png) **Result:** The visible shared requirements are complete and the form is ready for the applicable stage details. ![The required markers on the shared and stage-specific fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3d63d3fc3821f3c60f4bb3cd38d51f13.png) ## Complete the applicable stage details and items Stage details belong to the route you selected. An Inquiry uses its inquiry panel and item rows; a Potential uses its Potential-specific panel and item rows. The shared header does not contain the party, inquiry, or item-row fields owned by those panels. | Route | Continue with | |---|---| | Inquiry | **New inquiry**, then **Client**, **Vendor**, **Client Inquiry Number**, **Inquiry Date**, **Bid Due Date**, and **Requested Offer Type**, followed by the inquiry item row. | | Potential | The Potential-specific panel and its item row. | | Direct order | The **Order** route and its order-specific details. | | Standing job | The standing-job route when it is available. | For an Inquiry, the stage-specific controls include **Client**, **Vendor**, **Client Inquiry Number**, **Inquiry Date**, **Bid Due Date**, and **Requested Offer Type**. **Inquiry Date** cannot be later than today, and **Bid Due Date** cannot be earlier than the inquiry date. The inquiry item grid provides **Item Description**, **Unit**, and **Qty**. These stage-specific fields and item procedures belong to the focused Potential, Inquiries, and Sales job items pages. The shared header does not provide **Client**, **Vendor**, **Bid Due Date**, **Client Inquiry Number**, **Inquiry Date**, **Requested Offer Type**, **Item Description**, **Unit**, or **Qty**. **Expected Order Date** also depends on the stage: it is not shown for a Potential, project-management stage, or Order-or-later stage. **Prerequisites** - Complete the shared fields. - Know whether you are creating an Inquiry, Potential, Direct order, or Standing job. **Steps** 1. Select the stage panel for the route you opened. 2. For an Inquiry, select **New inquiry**. 3. In **Client**, select the client. 4. In **Vendor**, select the vendor. 5. Complete the other visible inquiry fields that apply to your configuration. 6. In the item grid, complete the visible item row before saving. For the normal Inquiry route, the focused Inquiry page owns the detailed panel and item procedure. For Potential work, continue with the focused Potential page. ![The opened Inquiry panel and its stage-specific controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/8d99193ef665592589d43250b5bd16a2.png) **Result:** The route-specific information and applicable item row are complete, and the sales job is ready to save. Continue with the save procedure. ![The Inquiry fields and item area](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/fa927336bfbe14055dcc18b2c6987bd5.png) ## Save the sales job and handle validation The form checks the information before saving. A successful save navigates to the saved edit workspace; it does not rely on a creation-success confirmation dialog or create-success toast. **Save and Close** follows the save-and-close path instead of leaving the new-record form open. | What you see | What it means | What to do | |---|---|---| | `Please Solve the Following Issues :` | Validation found one or more problems. | Read the listed field messages and correct each one. | | `Sales Responsible is required` | The responsible salesperson is empty. | Complete **Salesperson Responsible**. | | `Product type is required` | The product type is empty. | Complete **Product Type**. | | `Job title is required` | The job title is empty. | Complete **Job Title**. | | `Job title must not contain special characters` | The title contains an unsupported character. | Remove the unsupported character and keep only the accepted title characters. | | `You don’t have permission to create new jobs` | Your access does not permit creation. | Ask an administrator to grant the required create permission. | | `An error occurred while processing your request` | The creation request did not complete. | Remain on the form, review the values, and retry when the issue is resolved. | | `Custom fields saved successfully` | Custom-field changes were saved. | Continue with the next visible form area. | | `Job updated successfully` | The existing job was updated. | Continue in the saved job. | | `Converted to inquiry successfully` | The job was converted to an inquiry. | Continue with the Inquiry details. | | `Check mandatory field(s)` | A required field is empty. | Review the visible required markers and complete those fields. | | `Please save opened inquiry first` | An opened inquiry needs to be saved before the next action. | Select **Save**, then repeat the action. | | `One or more items has ZERO quantity` | An item quantity is zero. | Enter a quantity greater than zero in the affected row. | | `One or more items has no unit` | An item has no unit. | Select a unit in the affected row. | | `Error saving custom fields` | Custom-field saving did not complete. | Review the custom fields and select **Save** again. | | `An account with this name already exists` | An account with the entered name already exists. | Use the existing account or enter a different name. | | `An project with this name already exists` | A project with the entered name already exists. | Use the existing project or enter a different name. | | `Required Receiving Date` | A receiving date is required. | Enter the receiving date. | | `This field is required` | A required field is empty. | Complete the field named beside the message. | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | The number is outside the allowed range. | Enter a value greater than `0` and no greater than `999,999.00`. | | `Invalid input. Please enter a non-negative value` | The number is negative. | Enter `0` or a positive value. | | `Your request was completed successfully` | The requested operation completed. | Continue with the next visible action. | | `Forbidden characters detected. Please remove them and try again.` | The value contains forbidden characters. | Remove the forbidden characters and retry. | | `Required Receiving After` | A receiving-after value is required. | Enter the receiving-after value. | | `Package must have at least one item` | The package has no item. | Add at least one item before saving. | | `Required Offer Type` | An offer type is required. | Select **Requested Offer Type**. | | `Required Bid Due Date` | A bid due date is required. | Select **Bid Due Date**. | **Prerequisites** - Complete the shared and applicable stage information. - Change at least one value so **Save** or **Save and Close** is available. - Have permission to create new jobs. **Steps** 1. Select **Save**. 2. If `Please Solve the Following Issues :` appears, read each validation message. 3. Select the field named by each message. | If the message is… | Correct… | |---|---| | `Sales Responsible is required` | Select **Salesperson Responsible**, then enter a value. | | `Product type is required` | Complete **Product Type**. | | `Job title is required` | Complete **Job Title**. | | `Job title must not contain special characters` | Select **Job Title** and replace its value with letters, spaces, `_`, `-`, and `.`. | 4. Enter a value in each named field. 5. Select **Save** or **Save and Close**. After you correct the fields, select **Save** or **Save and Close** again. ![The validation state beside the required fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3d63d3fc3821f3c60f4bb3cd38d51f13.png) **Result:** A successful **Save** opens the saved sales-job edit workspace. A successful **Save and Close** follows its save-and-close path. A refused save leaves the form available for correction; no creation-success dialog or create-success toast is shown. Continue with the saved sales-job lifecycle. ### Out of scope messages The following message belongs to delivery-state work, not to creating a sales job: | Message | Where to continue | |---|---| | `Cannot be un-delivered — a due invoice already exists` | Continue with the invoice work before changing delivery. | ## Continue with the sales-job lifecycle A saved sales job is the record you continue through the sales flow. The saved edit workspace keeps the shared record with its stage work and related follow-up areas; the visible stage and related-work areas depend on the job and available subscriptions. The estimated value is part of the shared information carried into the saved job. After the save, open the visible stage or related-work area that matches your next task. A saved record can expose **Tasks**, **Activities**, and **Attachment**. **Prerequisites** - The sales job is saved. - You know whether your next action concerns its stage, a task, an activity, or an attachment. **Steps** 1. Read the visible stage and **Status** on the saved record. 2. Select the visible stage tab for the next lifecycle action. 3. Select the related-work area that matches your next task. | If you need to… | Select | |---|---| | Follow up on assigned work | **Tasks** | | Review recorded work | **Activities** | | Review files attached to the job | **Attachment** | **Result:** The saved sales job is open in its edit workspace, with the visible lifecycle and follow-up areas ready for the next task. ![The saved sales-job workspace and its shared information](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/fce4ed65caf1178b3b786ffd780ba17f.png) # Sales job record Use the sales job record to orient yourself in a saved job, read its current work area, and choose the focused page for stage, item, assessment, related-tab, or downstream work. ## Sales job record overview A sales job record is the workspace for one opportunity. It places active Potential, Inquiry, Offer, or Order work beside the shared job information, items, assessment, and related work that colleagues need to follow the opportunity. The record keeps the opportunity's conversation, follow-up, files, contacts, letters of guarantee (LGs), financial hand-offs, and history in the same job context. The stage panels remain separate jobs: use the record to locate the panel, then open the focused page when you need to perform stage-specific work. | If you need to… | Go to | |---|---| | Understand the record areas and related tabs | [Map the sales job workspace](#map-the-sales-job-workspace) | | Prepare access and record conditions | [Before you open the record](#before-you-open-the-record) | | Open an existing job or start a new one | [Find and open a sales job record](#find-and-open-a-sales-job-record) | | Read the current stage area | [Read the lifecycle work area](#read-the-lifecycle-work-area) | | Maintain shared fields or assessment values | [Review shared information and assessment](#review-shared-information-and-assessment) and [Prepare sales-job information and assessment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-information-and-assessment) | | Work with products, quantities, or pricing context | [Read the item area](#read-the-item-area) and [Sales job items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-items) | | Continue with conversation, files, contacts, guarantees, or history | [Hand off related work](#hand-off-related-work) | ## Map the sales job workspace The sales job workspace brings the current stage, shared record information, items, commercial assessment, and related work into one saved record. Choose **Potentials**, **Inquiry**, **Offer**, or **Order** to inspect that stage area. Choose **Delivered** when it is available for the record type. | Field | Options or rule | |---|---| | **Status** | Configured for the record stage. | | **Product Type** | `Complete Product`, `Spare Parts`, `Service`, `Scrap`, `Others`, and `ZZ-doc-Enter-Product-Type-Name` | | Area | What to look for | Continue with | |---|---|---| | Stage area | **Potentials**, **Inquiry**, **Offer**, **Order**, and, where applicable, **Delivered** | [Sales jobs lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle) or the focused [Potentials](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/potentials), [Inquiries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/inquiries), [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers), and [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) pages | | Job details and shared information | **Status**, **Branch**, **Salesperson Responsible**, **Product Type**, **Job Title**, **End User**, **Estimated Value**, **File Number**, and **Expected Order Date** | [Prepare sales-job information and assessment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-information-and-assessment) | | Item area | The item grid and the product, quantity, unit, pricing, and delivery context attached to the job | [Sales job items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-items) | | Commercial assessment area | **Contact to Decision Makers**, **Budget Availability**, **Chance in Competition**, **Calculated Rating**, and **Order chance** | [Prepare sales-job information and assessment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-information-and-assessment) | | Related tabs | Job-filtered conversation, follow-up, files, contacts, guarantees, financial work, delivery, references, and history | [Hand off related work](#hand-off-related-work) | The related-work container can provide these 14 named hand-offs: | Related tab or hand-off | What it places in the job context | |---|---| | **Comments** | Conversation on the job | | **Tasks** | Job-filtered follow-up tasks | | **Activities** | Job-filtered visits, meetings, calls, and related activity | | **Attachment** | Files associated with the job | | **Contacts** | Contacts associated with the job | | **LGs** | Letters of guarantee associated with the job | | **Last Modifications** | Recorded changes to the job | | **Tracking Principal Invoices** | Principal-invoice work filtered to the job | | **Sales Invoices** / **Commission Invoices** | Invoice work filtered to the job type | | **Payments** / **Commission Payments** | Payment or installment work filtered to the job type | | **Pricing Quotations** | Pricing-quotation work filtered to the job | | **Job Costing** | Costing work in the job context | | **Delivered** | Delivery work for an Instant Job | | **Reference List** | Reference work in the job context | Record-wide dialogs and feature embeds are invoking surfaces. For example, the record can invoke a flags popup, an inquiry dialog, custom fields, customer survey, or a Project Management/BOM surface. Use the focused feature page for its controls and procedures. ![The saved sales job record with its lifecycle, shared-information, assessment, and related-work areas](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c0fb3ed709236a4e6491f508d45ac803.png) ## Before you open the record A saved job has an ID before its related-work tabs are created. An editable saved job is also required for the three-dot command menu and its editing commands. > **Note:** Save the job before looking for related-work tabs; the tabs use the saved job context. | Condition | What it controls | |---|---| | The job has been saved and has an ID | Related-work tabs can be created and receive the job context | | The job is editable | The three-dot menu and editing commands are available | | The relevant subscription is included | Related tabs and commands can be available | | Your permission and branch match the feature rule | The corresponding tab, plus control, or command can be available | | The job stage and record type meet the related-work condition | Stage areas and downstream hand-offs can be available | Some tabs may be unavailable. **Tasks**, **Activities**, **Attachment**, **Contacts**, **LGs**, **Last Modifications**, **Sales Invoices**, **Commission Invoices**, **Payments**, **Commission Payments**, **Pricing Quotations**, **Job Costing**, **Delivered**, and **Reference List** may not appear. **Tracking Principal Invoices** appears for an Order or Delivered job when it is not the current principal and the Principal Invoices feature is included. **Pricing Quotations** and **Job Costing** appear from Offer through before Deleted when purchasing access and the Buyout Job feature are included; **Job Costing** also needs a valid order. **Delivered** appears for an Instant Job. **Reference List** appears from Order through before Deleted when reference-list access is available. The record commands also have their own conditions. The flag command needs an editable saved job; **Related Inquiry** excludes archived, deleted, delivered, direct-order, and instant-job cases; **Print** needs print permission; and **Consider as Reviewed** is shown to a team leader when the job requires review. Workflow panels can start collapsed. Select a panel title to read its fields and stage actions. The panel's **Save** applies to that panel; the record header **Save** applies to shared job information. ![The saved record with a collapsed workflow panel and the related-work row visible](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/331c886eb9ce1ca0969421a8277af63f.png) ## Find and open a sales job record Use the Inquiries list when you need to open an existing saved sales job. Use **Add new** when you need an unsaved record. ### Prerequisites - You can open the **Inquiries** list. - For an existing job, at least one inquiry row is available. ### Open an existing sales job ### Steps 1. Open **Sales** > **Sales jobs**. 2. Select **Inquiries**. 3. Select the first data row. ![The first data row in the Inquiries list selected for opening](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0de72f75ddd7c244e8cc8ab97c5970f9.png) 4. Confirm **Inquiry**. 5. Confirm the saved job identity, including **Job No. :**. ![The saved sales-job record after opening from Inquiries](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d782b9919ca045afb1fcae36c8507772.png) **Result:** The saved sales job opens. ### Start a new sales job ### Steps 1. Open **Sales** > **Sales jobs**. 2. Select **Inquiries**. 3. Select **Add new**. 4. Select **Inquiry**. **Result:** A new unsaved Inquiry record is displayed. ## Read the lifecycle work area | Stage area | What it represents | Focused page | |---|---|---| | **Potentials** | Early opportunity work before a formal customer inquiry exists | [Potentials](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/potentials) | | **Inquiry** | The customer-request stage between Potential and Offer | [Inquiries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/inquiries) | | **Offer** | Priced commitment work for the client and vendor | [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers) | | **Order** | Order work after an eligible offer | [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) | | **Delivered** | The delivery area available for the applicable record type | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) | The available stage areas depend on the current stage, record type, and feature conditions. A saved Inquiry can display **Inquiry**, **Offer**, and **Order**, with **Delivered** also visible for the applicable record type. The full stage sequence and exits are in [Sales jobs lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle). Use the focused stage page for actions such as receiving an inquiry, going to an offer, pricing an offer, converting an offer to an order, confirming an order, activating it, or delivering it. ![The Inquiry stage area on the saved record](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d782b9919ca045afb1fcae36c8507772.png) ![The Offer stage area on the saved record](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d782b9919ca045afb1fcae36c8507772.png) ![The Order stage area on the saved record](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d782b9919ca045afb1fcae36c8507772.png) ### When a lifecycle action stops Record-level validation and stage-stop messages tell you why the record action stopped. Quote the message you see, then use the owning stage or item page for the correction. | Message | What to check next | |---|---| | `Please save opened inquiry first` | Save the open Inquiry panel before continuing. | | `All inquiries must be in draft stage to revert to potential` | Review the Inquiry stage on the owning [Inquiries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/inquiries) page. | | `All offers must be in draft status to revert to inquiry` | Review every Offer status on the owning [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers) page. | | `One or more items has ZERO quantity` | Correct the item quantity on [Sales job items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-items). | | `One or more items has no unit` | Correct the item unit on [Sales job items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-items). | | `An error occurred while processing your request` | Recheck the record and continue in the owning lifecycle page. | These messages stop a lifecycle action at the record boundary. Use the owning stage or item page for the correction. ### Out of scope messages The following messages belong to focused pages rather than to the record-level lifecycle area. Use the named page when the message appears. #### Record actions and validation | Area | Message | Owning page | |---|---|---| | Custom fields | `Custom fields saved successfully` | [Sales job information and assessment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-information-and-assessment) | | Job save | `Job updated successfully` | Sales job record | | Job deletion | `Job deleted successfully` | Sales job record | | Regret | `Job regretted successfully` | [Missed, regretted and cancelled jobs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/missed-regretted-and-cancelled-jobs) | | Cancellation | `Job cancelled successfully` | [Missed, regretted and cancelled jobs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/missed-regretted-and-cancelled-jobs) | | Missed job | `Job missed successfully` | [Missed, regretted and cancelled jobs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/missed-regretted-and-cancelled-jobs) | | Reactivation | `Job reactivated successfully` | [Missed, regretted and cancelled jobs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/missed-regretted-and-cancelled-jobs) | | Offer conversion | `Converted to offer successfully` | [Inquiries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/inquiries) | | Inquiry conversion | `Converted to inquiry successfully` | [Potentials](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/potentials) | | Regret conversion | `Converted To Regretted` | [Missed, regretted and cancelled jobs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/missed-regretted-and-cancelled-jobs) | | Cancellation conversion | `Converted to cancelled` | [Missed, regretted and cancelled jobs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/missed-regretted-and-cancelled-jobs) | | Loss conversion | `Converted to lost` | [Missed, regretted and cancelled jobs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/missed-regretted-and-cancelled-jobs) | | Request processing | `An error occurred while processing your request` | Sales job record | | Custom fields | `Error saving custom fields` | [Sales job information and assessment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-information-and-assessment) | | Undeliver | `Cannot be un-delivered — a due invoice already exists` | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) | | Account or project name | `Error {{errorMsg}}` | [Accounts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/accounts) | | Account name | `An account with this name already exists` | [Accounts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/accounts) | | Project name | `A project with this name already exists` | [Accounts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/accounts) | | Required fields | `Check mandatory field(s)` | [Sales job information and assessment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-information-and-assessment) | | Numeric input | `This field is required ` | [Sales job information and assessment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-information-and-assessment) | | Numeric range | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | [Sales job information and assessment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-information-and-assessment) | | Non-negative input | `Invalid input. Please enter a non-negative value` | [Sales job information and assessment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-information-and-assessment) | | Offer type | `Required Offer Type` | [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers) | | Bid due date | `Required Bid Due Date` | [Inquiries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/inquiries) | | Purchasing milestone | `Please enter action for each milstone ` | [Pricing quotation overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-overview) | | Cost sheet | `Please save opened cost sheet first` | [Job profitability record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/job-profitability-record) | | Discount | `There is a maximum discount that exceeds the negotiation margin.` | [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers) | | Gross profit | `The gross profit margin is unacceptable, and the release prices have been stopped.` | [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers) | #### Account details | Area | Message | Owning page | |---|---|---| | Account request | `Your request was completed successfully` | [Accounts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/accounts) | | Vendor save | `Error: Vendor not saved yet` | [Accounts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/accounts) | | Client save | `Error: Client not saved yet` | [Accounts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/accounts) | | Required account field | `This Field Is Required` | [Accounts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/accounts) | #### Payments, contacts, and files | Area | Message | Owning page | |---|---|---| | Payment characters | `Forbidden characters detected. Please remove them and try again.` | [Record payment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/record-payment) | | Contact name | ` You already have a contact with this name` | [Sales job contacts, guarantees, and history](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-contacts-guarantees-and-history) | | File name | `Just '_'‘-''.' And '&' Characters Accepted` | [Sales job activities and files](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-activities-and-files) | #### Bill of materials, products, and material requisitions | Area | Message | Owning page | |---|---|---| | Archived sales order | `Sales order is archived` | [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) | | BOM quantity | `Booked quantity for this job is greater than the required BOM quantity` | [Sales job items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-items) | | BOM product after package | `You cannot edit or delete the product after the purchase package is created` | [Sales job items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-items) | | Product in purchasing | `Cannot be deleted. Product is in purchasing` | [Sales job items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-items) | | BOM product after purchase order | `You cannot edit the product after the PO is created` | [Sales job items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-items) | | Product already in BOM | `This product is already included in BOM` | [Sales job items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-items) | | First product variant | `The first variant cannot be deleted` | [Sales job items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-items) | | CRM connection | `An error occurred while connecting to your CRM system.` | [Sales job items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-items) | | Product selection | `Please select one product` | [Sales job items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-items) | | Empty package | ` Package must have at least one item` | [Sales job items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-items) | | Product required for save | `You cannot save without adding at least one product` | [Sales job items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-items) | | Product quantity | `One of products has no quantity` | [Sales job items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-items) | #### Tasks and activities | Area | Message | Owning page | |---|---|---| | Task deletion | `This record is related to saved data and cannot be deleted` | [Sales job comments and tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-comments-and-tasks) | | Activity action | `Action not allowed` | [Sales job activities and files](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-activities-and-files) | | Activity branch | `This action is only allowed if you belong to that branch` | [Sales job activities and files](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-activities-and-files) | | Activity topic and note | `One topic and at least one note is required` | [Sales job activities and files](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-activities-and-files) | | Activity print | `There is no topic to print` | [Sales job activities and files](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-activities-and-files) | #### Invoices, purchasing, costing, and delivery | Area | Message | Owning page | |---|---|---| | Principal invoice | `Check validation` | [Principal invoices](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/principal-invoices) | | Purchasing selection | `No remaining items. All items have been selected` | [Pricing quotation overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-overview) | | Purchasing email | `Please enter at least one email` | [Pricing quotation overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-overview) | | Purchasing Inquiry | `Inquiry must have at least one item` | [Pricing quotation overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-overview) | | Purchasing Offer | `Offer must have at least one item` | [Pricing quotation overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-overview) | | Purchasing Order | `Order must have at least one item` | [Pricing quotation overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-overview) | | Protected shipment item | `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) | | RFQ selection | `Please select one or more items to create a RFQ.` | [Pricing quotation overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-overview) | | Job costing permission | `You don’t have permission` | [Job profitability record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/job-profitability-record) | | Delivery accounts | `Error loading accounts` | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) | #### Reference lists and letters of guarantee | Area | Message | Owning page | |---|---|---| | Duplicate serial | `Serial you have entered already exist and belong to same manufacturer` | [Reference list data](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/reference-list-data) | | Serial validation | `There is error in serial you have entered` | [Reference list data](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/reference-list-data) | | Serial minimum | `Minimum: At least one serial` | [Reference list data](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/reference-list-data) | | LG activation | `Please Add Extension to activate the LG` | [Sales job contacts, guarantees, and history](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-contacts-guarantees-and-history) | | LG reversal | `LG has one or more extensions or deductions and cannot be reverted to the requested stage` | [Sales job contacts, guarantees, and history](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-contacts-guarantees-and-history) | | LG confirmation | `LG still needs confirmation` | [Sales job contacts, guarantees, and history](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-contacts-guarantees-and-history) | | Receiving date | `Required Receiving Date` | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) | | Receiving-after date | `Required Receiving After` | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) | | LG extension date | `Please choose a date after the current expiry date` | [Sales job contacts, guarantees, and history](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-contacts-guarantees-and-history) | | Pending LG increase | ` There is a pending increase you can edit` | [Sales job contacts, guarantees, and history](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-contacts-guarantees-and-history) | ## Review shared information and assessment Shared information describes the job across its lifecycle. The assessment area records the commercial indicators used before Order and displays a calculated rating. | Field or indicator | Reader-facing rule | |---|---| | **Status** | For Potential work: `Draft`, `Sent To Principal`, or `Awaiting Offer`. For Offer work: `Draft`, `Valid Offer`, `Awaiting Approval`, `Approved`, or `Valid`. For Order work: `Draft`, `Awaiting Approval`, `Approved`, `Valid`, `Due`, `Due/Overdue`, `Awaiting Activation`, or `Released for Invoicing` | | **Branch** | Read-only and always disabled | | **Salesperson Responsible** | Fixed required field; archived, unknown-stage, input-driven, and no-edit contexts lock it | | **Product Type** | Fixed required field; archived and no-edit contexts can lock it | | **Job Title** | Fixed required field with pattern validation; archived and no-edit contexts can lock it | | **Time Frame** | Read-only display shown before Order | | **End User** | Required only when company setup requires it | | **Estimated Value** | Required only when company setup requires it; shown through Potential | | **File Number** | Required only when company setup requires it | | **Expected Order Date** | No active required rule; shown before Order | | Configured custom fields | Requiredness and control type depend on each configured field | The **Product Type** choices are `Complete Product`, `Spare Parts`, `Service`, `Scrap`, `Others`, and `ZZ-doc-Enter-Product-Type-Name`. The saved record also displays `In Branch Currency (Rate:1)` as a readout and can display **Calculated Rating** as a read-only percentage. These displays do not establish a product-wide default value. | Assessment control | Choices or calculation | |---|---| | **Contact to Decision Makers** | `High`, `Medium`, or `Low`; required only when company setup makes it mandatory | | **Budget Availability** | `Not Available Yet`, `In Progress`, or `Available`; required only when company setup makes it mandatory | | **Chance in Competition** | `High`, `Medium`, or `Low`; required only when company setup makes it mandatory | | **Calculated Rating** | Read-only percentage recalculated from the three assessment controls | | **Order chance** | `90 %`, `70 %`, `50 %`, `30 %`, or `10 %`; shown at or before Potential and required only when company setup makes it mandatory | Archived records and stage-dependent edit locks can make fields read-only. Company-selected mandatory fields are managed in **Configuration** > `Dynamic validation`; the record displays the resulting field rules. ## Read the item area The item area is where the sales job's requested or offered products are listed with their product, quantity, unit, pricing, and delivery context. The item grid uses **Item** to add an item row. The supported item context includes **Unitized** and **Packages** item types. Item-entry, pricing, and delivery procedures belong to [Sales job items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-items). Item data can stop a record-level lifecycle action when the quantity is zero or the unit is missing. Correct those values in the item grid before repeating the lifecycle action. ## Hand off related work Choose a focused page according to the work you need to perform. The record remains the place for these record-wide commands: | Record-wide command | Keep the action on | |---|---| | Flag command | The saved sales job record | | **Related Inquiry** | The saved sales job record | | **Print** | The saved sales job record | | **Save** | The saved sales job record | | **Save and Close** | The saved sales job record | | **Consider as Reviewed** | The saved sales job record | ### Use record commands Use these commands when their availability conditions are met. Record-level **Save** and **Delete** display no approval controls. For approval controls, use the Offer or Order panel. #### Set a flag **Prerequisites** - The job is saved and editable. - The Sales Job User Flags subscription is available. **Steps** 1. Open the three-dot menu. 2. Select **Set flag**. 3. In the **Flags** popup, select **No flag** or a configured flag. 4. Submit the popup. **Result** The record reloads and displays `Your request was completed successfully`. If the subscription is not available, **Set flag** opens **Upgrade needed** instead of **Flags**. #### Create a related inquiry **Prerequisites** - The job is eligible for **Related Inquiry**. - The job is saved and editable. **Steps** 1. Open the three-dot menu. 2. Select **Related Inquiry**. 3. In **Add New Inquiry**, complete **Client**, **Vendor**, and **Bid Due Date**. 4. Select **Save**. **Result** The related inquiry is added to the job, the popup closes, and the record displays `Inquiry created successfully`. #### Print the record **Prerequisites** - You have print permission. - The PDF Print subscription is available. **Steps** 1. Open the three-dot menu. 2. Select **Print**. 3. In **Print options**, select **Print**. **Result** The print action prepares the job PDF and closes the popup. #### Mark the job as reviewed **Prerequisites** - You are a team leader. - The job requires review and is not archived or already reviewed. **Steps** 1. Select **Consider as Reviewed**. **Result** The review notice is hidden and the record is saved as reviewed. When values exist, the record displays **Reviewed by**, **Reviewed on**, and **Sales Responsible was**. **Result:** The selected command completes, or its popup or focused page opens for the next step. The child page owns its own controls and procedures. | If you need to… | Select or continue with | |---|---| | Read or add job conversation and follow-up | **Comments** or **Tasks**; use [Sales job comments and tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-comments-and-tasks) | | Review or add visits, meetings, calls, or files | **Activities** or **Attachment**; use [Sales job activities and files](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-activities-and-files) | | Associate people, guarantees, or review changes | **Contacts**, **LGs**, or **Last Modifications**; use [Sales job contacts, guarantees, and history](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-contacts-guarantees-and-history) | | Track principal invoices | **Tracking Principal Invoices**; use [Principal invoices](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/principal-invoices) | | Review sales or commission invoices | **Sales Invoices** or **Commission Invoices**; use [Invoice lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/invoice-lifecycle) | | Review payments or commission payments | **Payments** or **Commission Payments**; use [Record payment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/record-payment) | | Continue with quotation work | **Pricing Quotations**; use [Pricing quotation overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-overview) | | Review job costing | **Job Costing**; use [Job profitability record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/job-profitability-record) | | Review delivery work | **Delivered**; use [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | | Review references | **Reference List**; use [Reference list data](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/reference-list-data) | The related tabs show work for the saved job. When a hand-off opens a downstream feature, stop at the named child page for its detailed fields, dialogs, confirmations, errors, and landing state. The child page owns those procedures. # Sales job information and assessment ## Overview A sales job is the shared record that carries the commercial information for work that can move from inquiry through offer, order, and delivery. The stage bar shows the sales-job flow from **Inquiry** to **Offer**, **Order**, and **Delivered**. The shared information stays with the record while the focused work changes by stage. ![The stage bar and shared information area on a new Inquiry](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/586c0cbaacccef78397dd14dfe66fe2f.png) | If you need to… | Go to | | --- | --- | | Create the first sales job and complete its inquiry data | Create a sales job | | Maintain the shared fields and assessment on this record | The procedures below | | Understand the complete sales-job workspace and its related parts | Sales job record | | Maintain item rows, pricing, and item-specific locks | Sales job items | | Move the job between lifecycle stages or handle a lifecycle exit | Sales jobs lifecycle | | Maintain comments and follow-up tasks | Sales job comments and tasks | | Maintain related activities and files | Sales job activities and files | | Maintain contacts, guarantees, and history | Sales job contacts, guarantees, and history | ## Before you start The information area appears when the relevant subscription is included and the page is not missing. Editing also depends on whether the record is new or saved, whether you have edit permission, and which stage the record is in. A new record and a saved record therefore do not offer exactly the same controls. | Check before you begin | What it affects | | --- | --- | | The sales information subscription is included | The main information area is available. | | You have a new record or a saved record with edit permission | You can maintain the values that the current record allows. | | You know the current stage | **Estimated Value**, **Expected Order Date**, potential assessment, and **Order chance** are stage-dependent. | | You have the values for the fixed mandatory fields | **Salesperson Responsible**, **Product Type**, and **Job Title** are fixed mandatory fields. | | You know your company’s configured mandatory rules | **End User**, **Team**, **Estimated Value**, and **File Number** can be mandatory only when configuration says so. | | You have the customer, vendor, and inquiry information when creating an inquiry | Inquiry data has its own fixed and configuration-conditional mandatory rules. | Use the values shown on your screen and follow the mandatory markers beside the current fields. ## Find and open a sales job An **Inquiry** is the entry view for a new sales-job record. You can open it for inspection without saving it, or open an existing sales job from the inquiry list before maintaining its shared information. **Prerequisites** - You are signed in and can access the sales-job workspace. - You know whether you are inspecting a new inquiry or opening an existing sales job. **Steps** 1. From the application dashboard, select **Add new**. 2. Follow **Add new** > **Sales Jobs** > **Inquiry** to open a new inquiry screen without saving the record. 3. Open the **Inquiry** list from the **Sales Jobs** navigation. 4. Select the sales job you need to maintain from the inquiry list. **Result:** The new or existing sales-job information screen is open. The inquiry list shows **Inquiry date**, **Inquiry type**, and **Inquiry stage**, with **Refresh**, **Table Layout**, and **Settings** available. ## Understand the information and assessment screen The information and assessment screen combines the record’s workflow position, shared identity information, commercial readouts, assessment choices, and save controls. Use the stage bar to orient yourself; use the field labels to find the values you need to review or change. | Screen area | What to find there | | --- | --- | | Stage bar | **Inquiry**, **Offer**, **Order**, and **Delivered**. | | Shared information | **Branch**, **Salesperson Responsible**, **Product Type**, **Job Title**, **End User**, **Team**, **Estimated Value**, **File Number**, and **Expected Order Date**. | | Calculated readouts | **Time Frame**, `In Branch Currency (Rate:1)`, and **Calculated Rating**. | | Assessment | **Status**, **Contact to Decision Makers**, **Budget Availability**, **Chance in Competition**, and **Order chance**, subject to the current stage. | | Save controls | **Save** and **Save and Close**. | The stage bar orients you within the record’s lifecycle. Use Sales jobs lifecycle to move the job between stages. ![The field groups, calculated readouts, assessment controls, and save controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/586c0cbaacccef78397dd14dfe66fe2f.png) Read **Time Frame**, `In Branch Currency (Rate:1)`, and **Calculated Rating** as readouts after you make selections; they are not entry fields. ## Maintain shared sales-job information Shared sales-job information identifies the branch, responsible person, commercial subject, end user, team, value, file, and expected order timing. Enter these values before reviewing the commercial assessment. | Field | What you maintain | Mandatory rule or stage condition | | --- | --- | --- | | **Branch** | The branch associated with the sales job. | Not mandatory in the template. | | **Salesperson Responsible** | The salesperson responsible for the record. | Fixed mandatory; shown for a new record or when the saved record has no salesperson name. | | **Product Type** | The product type for the job. | Fixed mandatory. | | **Job Title** | The title used to identify the job. | Fixed mandatory. | | **End User** | The end user associated with the job. | Mandatory only when your configuration says so. | | **Team** | The team associated with the job when the control is available. | Mandatory only when your configuration says so. | | **Estimated Value** | The estimated commercial value. | Mandatory only when your configuration says so; available at or before `Potential`. | | **File Number** | The file number for the sales job. | Mandatory only when your configuration says so. | | **Expected Order Date** | The expected date for the order. | Not mandatory in the template; available before **Order**, except when the stage is `Unknown` or `-1`. | **Prerequisites** - You have the shared information for the record. - You know the current stage and the values your configuration makes mandatory. **Steps** 1. In the shared information area, select the appropriate value in **Branch** when a branch applies. 2. Select the responsible person in **Salesperson Responsible**. 3. Select the product category in **Product Type**. 4. Enter the identifying title in **Job Title**. 5. Select the end user in **End User** when the field is available. 6. Select the team in **Team** when the field is available. 7. Enter the commercial estimate in **Estimated Value** when the field is available. 8. Enter the file identifier in **File Number** when the field is available. 9. Enter the expected date in **Expected Order Date** when the field is available. **Result:** The shared information fields show the values you entered or selected, and the mandatory markers identify the values the current screen requires. ## Review the commercial assessment Commercial assessment records how well the inquiry is positioned and, at later stages, the chance that it becomes an order. The current stage controls which assessment choices you see. | Assessment control | Choices or display | When it applies | | --- | --- | --- | | **Status** | Select the status shown for the current stage. | The screen requests status values for Potential, Offer, or Order. | | **Contact to Decision Makers** | `High`, `Medium`, or `Low`. | Potential assessment, before **Order** and at or before `Potential`. | | **Budget Availability** | `Available`, `In Progress`, or `Not Available Yet`. | Potential assessment, before **Order** and at or before `Potential`. | | **Chance in Competition** | `High`, `Medium`, or `Low`. | Potential assessment, before **Order** and at or before `Potential`. | | **Order chance** | `90 %`, `70 %`, `50 %`, `30 %`, or `10 %`. | Offer assessment, from **Offer** until before **Order**. | | **Calculated Rating** | A calculated percentage readout. | The screen displays it as a readout rather than as an assessment choice. | **Prerequisites** - You have reviewed the shared information for the current record. - You know the stage shown on the stage bar. **Steps** 1. Confirm the current stage on the stage bar. 2. Use the table to select the assessment values available at that stage. | Current stage | Action | | --- | --- | | Potential | Select a value in **Contact to Decision Makers**, **Budget Availability**, and **Chance in Competition**. | | Offer until before **Order** | Select a value in **Order chance**. | | Any stage with a calculated result | Read **Calculated Rating** after making the available selections. | **Result:** The assessment controls that apply to the current stage show your selections, and **Calculated Rating** shows the calculated readout provided by the screen. ## Edit or restore archived information **Reset** restores the saved salesperson selection on an existing record when the record has an identifier and a salesperson name. It is not a new-record control. Archived status, edit permission, and stage-based conditions can also hide or disable editing controls. | Condition | What you see | | --- | --- | | New record | **Reset** is absent. | | Existing record with a salesperson name | **Reset** can be available. | | Archived record or no edit permission | Editing controls can be hidden or disabled. | | A stage that does not allow a field | The stage-dependent field is not available for editing. | **Prerequisites** - You have an existing saved record if you need **Reset**. - You have permission to edit the record. **Steps** 1. Open the saved sales job you need to restore or edit. 2. Check whether **Reset** is visible beside the salesperson information. 3. Select **Reset** to remove the saved salesperson selection when the control is available. 4. If an editing control is disabled or absent, continue with the fields that the current stage and permission allow. **Result:** The salesperson selection is cleared when **Reset** is available and selected; on a new record, no **Reset** control is shown. ## Save the information **Save** commits the information and assessment values on the screen. **Save and Close** commits the values and leaves the screen. **Prerequisites** - You have entered the intended shared information and assessment values. - All mandatory markers visible on the current screen are satisfied. **Steps** 1. Use the table to choose **Save** or **Save and Close**. | If you want to… | Select | | --- | --- | | Submit the values and remain on the screen | **Save** | | Submit the values and leave the screen | **Save and Close** | 2. Check the message shown after the save action. **Result:** The screen reports `Job updated successfully` when the successful update message is shown. Custom-field processing reports `Custom fields saved successfully` when that message is shown. ## Fix validation and save errors Use the message on screen to identify whether a value is missing, outside the allowed numeric range, blocked by a mandatory-field check, or rejected while saving. | Message | Corrective action | | --- | --- | | `Job updated successfully` | Treat the save action as successful on the screen. | | Other message | Reader action | | --- | --- | | `Job deleted successfully` | Continue from the sales-job list. | | `Job regretted successfully` | Continue from the sales-job list. | | `Job cancelled successfully` | Continue from the sales-job list. | | `Job missed successfully` | Continue from the sales-job list. | | `Job reactivated successfully` | Continue working with the reactivated job. | | `Converted to offer successfully` | Continue with the offer work for the job. | | `Converted to inquiry successfully` | Continue with the inquiry work for the job. | | `Converted To Regretted` | Continue from the regretted-job work. | | `Converted to cancelled` | Continue from the cancelled-job work. | | `Converted to lost` | Continue from the lost-job work. | | `Cannot be un-delivered — a due invoice already exists` | Resolve the due invoice before reversing delivery. | **Prerequisites** - A save attempt has displayed a validation or save message. **Steps** 1. Read the exact message displayed after the save attempt and follow its corrective action. | Message | Corrective action | | --- | --- | | `This field is required ` | Complete the field that shows the required marker. | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a number greater than `0` and no more than `999,999.00`. | | `Check mandatory field(s)` | Review every visible mandatory marker. | | `An error occurred while processing your request` | Review the entered values and select **Save** again. | | `Error saving custom fields` | Review the custom-field values and select **Save** again. | 2. Check for `Job updated successfully` after the corrective save. **Result:** The validation message identifies the correction to make, or the screen shows `Job updated successfully` after the corrected save. ## Know what happens next The stage bar shows the lifecycle orientation. After saving the shared information and assessment, continue with the focused task for the record. | After maintaining this page… | Continue with | | --- | --- | | You need to understand or move through lifecycle stages | Sales jobs lifecycle | | You need to maintain item rows or pricing | Sales job items | | You need to manage comments or tasks | Sales job comments and tasks | | You need to manage activities or files | Sales job activities and files | | You need to manage contacts, guarantees, or history | Sales job contacts, guarantees, and history | | You need the overall record workspace | [Sales job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-record) | Save the shared values before continuing with work that depends on the saved record. Use the stage bar for orientation, then open the page that owns the next task. # Sales job items An item row records one product or service in a sales job. Use the row to carry the description, quantity, unit, and—at offer and order stages—commercial values through the sales flow. ## Sales job items The same sales-job workspace carries item grids for the inquiry, offer, and order panels, so item work stays with the record as the opportunity develops. The main path is `Potential` → `Inquiry` → `Offer Preparation` → `Offer` → `Order`. After the order is ready, delivery moves the work toward `Delivered`, then the delivered values continue to Sales Invoice and Incoming Client Payment. An order can also hand item work to BOM when the companion manufacturing work is needed. ```mermaid flowchart LR Potential --> Inquiry Inquiry --> OfferPreparation[Offer preparation] OfferPreparation --> Offer Offer --> Order Order --> Delivery Delivery --> Delivered Delivered --> SalesInvoice[Sales Invoice] SalesInvoice --> IncomingClientPayment[Incoming Client Payment] Order --> BOM ``` Use this page according to the work you need to complete: | If you need to… | Go to | |---|---| | Check access, stage, required data, or company-configured limits | [Before you start](#before-you-start) | | Open the saved job and its item panel | [Find and open the sales job](#find-and-open-the-sales-job) | | Identify the fields in the current panel | [Understand the item surface](#understand-the-item-surface) | | Add descriptions, units, and quantities | [Add item rows](#add-item-rows) | | Enter prices, discounts, tax, and delivery values | [Price the item and review delivery details](#price-the-item-and-review-delivery-details) | | Apply **Unitized** or **Package** treatment | [Use Unitized and Packages lines](#use-unitized-and-packages-lines) | | Check why a stage action or row operation is unavailable | [Handle item branches and locks](#handle-item-branches-and-locks) | | Follow delivery into invoicing and payment | [Follow item values into delivery and invoices](#follow-item-values-into-delivery-and-invoices) | | Save changes or correct a validation message | [Save the item changes and resolve validation errors](#save-the-item-changes-and-resolve-validation-errors) | | Continue with the wider sales-job process | [Continue the sales job](#continue-the-sales-job) | | Understand the complete sales-job record | [Sales job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-record) | | Prepare shared sales-job information | [Sales job information and assessment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-information-and-assessment) | | Follow stage changes and hand-offs | [Sales job lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle) | | Move an order through delivery | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) | | Create or review invoices and payments | [Invoice lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/invoice-lifecycle) | | Work with BOM or warehouse fulfilment | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | ## Before you start An item grid is the working area for changing rows, but the available changes depend on the record, your access, the current stage, and company configuration. **Prerequisites** - Open a saved sales job when you need to change an existing record. - Have edit access to the sales job. - Confirm that the current stage permits the intended item change. - Have the product description, unit, quantity, and commercial values needed for the row. - Know that **Item Description** is required. - Check the configured quantity and item-price limits used by your company. The grid is read-only when the screen is opened with a passed-in record ID or when your user cannot edit. Inquiry item editing is also blocked after the inquiry leaves its initial stage. The inquiry panel hides the package/unitized switch, so those row treatments are not available there. | Before changing rows, check… | Why it matters | |---|---| | The record is saved | Existing-record item work is performed on the saved sales job. | | Your edit access | Without edit access, the item grid is read-only. | | The current stage | Inquiry rows can no longer be edited after the inquiry leaves its initial stage. | | Product description | **Item Description** is required for an item row. | | Company limits | Quantity and item-price limits come from configuration. | **Result:** You know whether the current item grid can be changed and have the product, unit, quantity, and commercial details ready for the row. ## Find and open the sales job The **Sales jobs** work list groups sales jobs by their current work stage. Open a saved row from the list, then select the stage summary that contains the item panel you need. **Prerequisites** - Know which saved sales job you need. **Steps** 1. Open the **Sales jobs** work list. 2. Select the list that matches the job's current stage. | If the job is… | Select | |---|---| | In any list or stage | **All** | | A potential | **Potentials** | | An inquiry | **Inquiries** | | An offer | **Offers** | | An order | **Orders** | | Archived | **Archived** | 3. Select the appropriate action for the row you need to work with. | If you need to… | Select | |---|---| | Start a new sales job | **Add new** | | Open a saved sales job | The sales-job data row | | Receive an inquiry from a potential | **Receive inquiry** | 4. Select the stage summary for the item work you need. 5. In the opened panel, locate its item grid and its panel-level **Save** control. ![Sales jobs work list with the stage tabs and item-work entry point](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/586c0cbaacccef78397dd14dfe66fe2f.png) **Result:** The saved sales job is open at its selected stage panel, with the panel's item grid and **Save** control visible when editing is permitted. ## Understand the item surface An item grid shows the row values relevant to the current sales stage. Inquiry work starts with product identity and quantity; offer and order work adds commercial values. | Panel | Item columns | |---|---| | Inquiry | **Item Description**, **Unit**, **Qty** | | Offer | **Item Description**, **Unit**, **Qty**, **Unit Price**, **Item Price**, **Discount limit (%)**, **Discount (%)**, **Tax (%)** | | Order | **Item Description**, **Unit**, **Qty**, **Unit Price**, **Item Price**, **Discount limit (%)**, **Discount (%)**, **Tax (%)** | | Delivery dialog | **Delivery Date** | The inquiry surface also shows the sales-job information fields enabled in the saved settings. Use the headers visible in the current grid when you work. The **Category** column is not part of the item grid shown on this screen. ![Inquiry item grid with Item Description, Unit, and Qty](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f39b6955bf40334699f5364efab18afd.png) **Result:** You can distinguish the identity and quantity fields used at Inquiry from the pricing fields added at Offer and Order, and you know to work from the headers currently shown. ## Add item rows An item row identifies the product or service that the sales job concerns and records the amount requested or sold. Add the row only when the current grid exposes the **+ Item** action. **Prerequisites** - Have an editable item grid open. - Have the product or service to select in **Item Description**. **Steps** 1. In the item grid, select **+ Item**. 2. In the new row, select the product or service in **Item Description**. 3. In **Unit**, select the unit when the field is enabled. 4. In **Qty**, enter a quantity of at least `0.1` when the field is enabled. 5. Repeat the row-entry steps for each additional item row. **Item Description** is a required product autocomplete. **Unit** is disabled for package rows and when the selected product already has a unit value. **Qty** is disabled for package rows, has a minimum of `0.1`, and uses the configured quantity limit as its maximum. At Inquiry, the item grid shows **Item Description**, **Unit**, and **Qty**; the offer and order price columns are not shown there. ![Item row with the required Item Description field](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ffbb0b16f68accde19ec2202cb284d78.png) **Result:** The grid contains item rows with a selected description and permitted unit and quantity values. ## Price the item and review delivery details Offer and order rows carry the commercial values used to review and deliver the sale. Enter only values allowed by the row treatment and by the configured limits. **Prerequisites** - Open an editable Offer or Order panel when entering price values. - Have the agreed prices, discounts, tax, delivery information, and payment information. **Steps** 1. In an Offer or Order item row, enter a non-negative **Unit Price** when the field is enabled. 2. Enter a non-negative **Item Price** when the field is enabled. 3. Review the read-only **Discount limit (%)**. 4. Enter **Discount (%)** from `0` through `100` when the field is enabled. 5. Enter **Tax (%)** from `0` through `100`. 6. Enter **Delivery Time** and select **Delivery Term** when the saved settings require them. 7. In the Offer or Order panel, review **Payment Method** and **Payment Period**. 8. When delivery is opened, enter the required **Delivery Date** no later than today. **Unit Price** is disabled for packages, has a minimum of `0`, and uses the configured item-price limit as its maximum. **Item Price** is disabled for unitized items, has a minimum of `0`, and uses the configured item-price limit as its maximum. **Discount limit (%)** is read-only and disabled for packages. **Discount (%)** is disabled for packages and accepts `0` through `100`. **Tax (%)** accepts `0` through `100`. **Delivery Time** and **Delivery Term** become required when the saved settings require them. **Delivery Date** is required and cannot be later than today. A later date is rejected because delivery is being recorded against the current date. **Result:** The current offer or order row contains the permitted commercial values, and the delivery information is ready for the delivery action. ### Use Unitized and Packages lines **Package** applies package treatment to selected rows. **Unitized** applies unitized treatment to selected rows. These treatments change which row fields remain editable. **Prerequisites** - Select the rows that need the same treatment. - Work in a panel where the package/unitized switch is visible. - Confirm that the selected rows allow the action. **Steps** 1. Select the rows to treat. 2. Select the treatment that applies to the selected rows. | If the rows must use… | Select | |---|---| | Package treatment | **Package** | | Unitized treatment | **Unitized** | 3. Review the row fields that become disabled after the treatment is applied. | Treatment | Fields that become unavailable | |---|---| | **Package** | **Unit** and **Qty** | | **Unitized** | **Item Price** | The **Package** and **Unitized** actions appear only when the switch is not hidden and the selected rows allow that action. The inquiry item panel hides the switch, so use these actions only in a panel where the controls are present. **Result:** The selected rows use the available treatment, and the locked fields match the treatment shown in the grid. ## Handle item branches and locks Stage actions are guarded by the sales-job state, branch relationship, supplier context, permissions, and whether the current record still has unsaved changes. A missing action means the current record does not meet that action's conditions. | Action | Available when… | |---|---| | **Calculation Sheet** in Offer | An offer exists, supplier context is present, the applicable margin mode is active, and the offer has no unsaved changes. | | **Calculation Sheet** in Order | An order exists, supplier context is present, the applicable margin mode is active, and the order has no unsaved changes. | | **Request Pricing** | The offer is a draft in the applicable offer stage and prices have not already been released or requested. | | **Request Pricing Confirmation** | The order is a draft and prices have not already been released or requested. | | **Deliver Order** | The order is in the relevant valid or ready-for-shipment stage and the branch relationship is valid. | | **Split** | One edited row is selected. | | **Delete** | Row deletion is allowed. | The item grid is read-only when the record or your user is not editable. Do not use **Save** as a workaround for a stage or permission lock: the row remains unchanged until the condition that controls the lock is satisfied. **Result:** You can choose the action that belongs to the current stage without attempting an action blocked by state, branch, permission, selection, or unsaved changes. ## Follow item values into delivery and invoices Delivery completes the order side of item work. When delivery covers all active orders, the sales job reaches **Delivered**; external-supplier delivery can also create a draft invoice for the delivered item work. **Prerequisites** - Have an eligible order with item values saved. - Confirm that the order meets the conditions for **Deliver Order**. - Have the delivery date ready. **Steps** 1. Open the eligible order panel. 2. Select **Deliver Order**. 3. Enter the required **Delivery Date** in the delivery dialog. 4. Complete the delivery action exposed by the dialog. 5. Open the **Invoices** tab when the delivery result directs you there. 6. Review the draft invoice created from active, offered, ordered, or ready-for-shipment items when the delivery uses an external supplier. Delivery changes the job stage to **Delivered** only when delivered orders equal active orders. The delivery success message directs you to the **Invoices** tab for a draft invoice. The **Invoices** tab is available only when the invoice feature is enabled, and its contents are provided by the invoice list. The tab's plus action is available only when the invoice feature is enabled, the **Invoices** tab is active, you have same-branch access, and you have permission to create an additional invoice. Delivery is the hand-off to `Sales Invoice`, which in turn leads to `Incoming Client Payment`. Detailed order-to-delivery work belongs in [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered); invoice creation and payment work belongs in [Invoice lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/invoice-lifecycle). **Result:** The order is delivered when all active orders are delivered, and any draft invoice created by external-supplier delivery is available from **Invoices**. ## Save the item changes and resolve validation errors **Save** commits the changed item values for the current panel. Correct the row or the related panel data when a validation message stops the save. **Prerequisites** - Complete the permitted item fields for the current stage. - Leave at least one item row when deleting. - Save an opened cost sheet before saving the related sales-job change. - If approval is enabled, follow the configured approval process before relying on the changed offer or order. > **Note:** Approval responsibility follows your configured approval process. **Steps** 1. Select **Save** in the panel after entering valid item values. | Panel | Select | |---|---| | Offer | **Save** | | Order | **Save** | 2. If **Item Description** is required, select a product or service in **Item Description**. 3. If **Qty** or **Unit** is invalid, enter a permitted quantity or select an available unit. 4. Read the validation message. 5. Select the invalid price, discount, tax, or delivery value. Replace it with a permitted value. 6. If deleting a row, read the confirmation before confirming the deletion. 7. Select **Save** again after all required corrections are complete. The item and sales-job messages are: | When it appears | Message | Correction | |---|---|---| | A required item or delivery date is empty | `This field is required` | Complete the required field. | | A quantity is outside its permitted range | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a value greater than `0` within the configured limit. | | A price or tax is negative | `Invalid input. Please enter a non-negative value` | Enter `0` or a positive value. | | You select item deletion | `Are you sure you want to delete this item?` | Confirm only when the row should be removed. | | Deletion would remove every row | `You can not delete all items, leave one item at least` | Keep at least one item row. | | An item has zero quantity | `One or more items has ZERO quantity` | Enter a permitted quantity. | | An item has no unit | `One or more items has no unit` | Select a unit where the field is enabled. | | An opened cost sheet is not saved | `Please save opened cost sheet first` | Save the cost sheet, then save the sales job. | | The margin blocks released prices | `The gross profit margin is unacceptable, and the release prices have been stopped.` | Review the permitted prices and margin configuration. | Other messages recorded for sales-job actions are shown exactly below: - Conversion to an offer: `Converted to offer successfully`. - Conversion to an inquiry: `Converted to inquiry successfully`. - Regret conversion: `Converted To Regretted`. - Cancellation conversion: `Converted to cancelled`. - Lost conversion: `Converted to lost`. - Save or action failure: `An error occurred while processing your request`. - Custom-field save failure: `Error saving custom fields`. - Delivery reversal blocked by an invoice: `Cannot be un-delivered — a due invoice already exists`. - Return to inquiry blocked: `All offers must be in draft status to revert to inquiry`. - Dynamic action failure: `Error {{errorMsg}}`. - Duplicate account name: `An account with this name already exists`. - Duplicate project name: `A project with this name already exists`. - Mandatory sales-job data missing: `Check mandatory field(s)`. - Open inquiry not saved: `Please save opened inquiry first`. - Return to potential blocked: `All inquiries must be in draft stage to revert to potential`. - Payment milestone action missing: `Please enter action for each milstone`. - Cost calculation save failure: `An error occurred while processing your request`. - Cost calculation validation failure: `Check mandatory field(s)`. - Discount exceeds negotiation margin: `There is a maximum discount that exceeds the negotiation margin.` - Custom fields saved: `Custom fields saved successfully`. - Sales job updated: `Job updated successfully`. - Sales job deleted: `Job deleted successfully`. - Sales job regretted: `Job regretted successfully`. - Sales job cancelled: `Job cancelled successfully`. - Sales job missed: `Job missed successfully`. - Sales job reactivated: `Job reactivated successfully`. **Result:** The changed offer or order is saved when every required value is valid; when the save stops, the displayed message identifies the correction to make before retrying. ## Continue the sales job Item work belongs to the wider lifecycle of **Potentials**, **Inquiries**, **Offers**, **Orders**, and **Delivered**. The sales-job record connects item work with related record areas, so continue from the focused page that owns the next task instead of repeating its procedure here. | Next task | Open | |---|---| | Create a standard new job, a potential, a direct order, or an instant job | [Create a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-sales-job) | | Follow lifecycle stages and transitions | [Sales job lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle) | | Work on the record and its related record areas | [Sales job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-record) | | Complete shared sales-job information and assessment | [Sales job information and assessment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-information-and-assessment) | | Add comments and tasks | [Comments and tasks on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-comments-and-tasks) | | Manage activities and attachments | [Activities and attachments on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-activities-and-files) | | Review contacts, L/Gs, and history | [Contacts, L/Gs, and Last Modifications on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-contacts-guarantees-and-history) | | Complete delivery and warehouse work | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | **Result:** The saved item values remain with the sales job, and you know which focused sales-job page owns the next stage, delivery, invoice, or companion task. # Comments and tasks on a sales job ## Comments and tasks on a sales job A comment is written discussion saved with a sales job. A task is follow-up work saved on the same record. Use **Comments** for the discussion and **Tasks** for assigned follow-up. | If you need to… | Go to | |---|---| | Open the saved job and its follow-up tabs | [Find sales job work](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/find-sales-job-work), then [Open a saved sales job](#open-a-saved-sales-job) | | Read the available fields and actions | [Understand the comments and tasks surface](#understand-the-comments-and-tasks-surface) | | Add or find written discussion | [Keep the job discussion](#keep-the-job-discussion) | | Reply to, change, or remove discussion | [Reply to a comment](#reply-to-a-comment), [Edit your own comment](#edit-your-own-comment), or [Delete your own comment](#delete-your-own-comment) | | Create or update follow-up work | [Maintain an open follow-up task](#maintain-an-open-follow-up-task) | | Review files and activities on the job | [Activities and attachments on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-activities-and-files) | ## Before you start The Comments and Tasks surfaces belong to a saved sales job. Prepare the record and the information needed for the follow-up before opening them. | Confirm | Why it matters | |---|---| | The sales job is saved and has a `Job.Id`. | **Comments**, **Tasks**, and **Activities** depend on the job having an ID. | | The Comments feature is available. | **Comments** and its comment list appear only when the feature is available. | | The Tasks feature is available. | **Tasks** and its task list appear only when the feature is available. | | You know the current task owner. | Owner-only task actions depend on the current person being the task owner. | | You know whether the task belongs to the same branch. | New task activities and sub-tasks require the matching branch. | | You know the task's state. | **Accept**, **Decline**, **Consider As Complete**, and **Consider As Not Completed** depend on the task's owner and state. | | You have the task title, priority, start date, due date, and any description. | **Priority**, the task title, **Start date**, and **Due date** are required when a task is loaded; **Description** is optional. | > **Note:** The task owner must be the current person for owner-only task actions. ## Open a saved sales job An existing sales job is the saved record that carries its own discussion and follow-up work. Open it from the **Inquiries** work list before selecting a tab. **Prerequisites** - You know the saved sales job to open. - The **Inquiries** work list is available. **Steps** 1. Open the **Inquiries** work list. 2. Select the existing sales-job row. 3. Select the available **Comments** tab. 4. Select the available **Tasks** tab when you need task follow-up. ![The Inquiries work list with its visible work tabs and list columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c0fb3ed709236a4e6491f508d45ac803.png) The visible work list can show **All**, **Potentials**, **Inquiries**, **Offers**, **Orders**, and **Archived**. Its visible columns are **Inquiry date**, **Inquiry type**, and **Inquiry stage**. **Result:** The saved sales-job record is open with **Comments** or **Tasks** selected when that feature is available. Continue with the surface you selected. ## Understand the comments and tasks surface The comments and tasks surface is the saved job's place for written discussion and assigned follow-up. Feature availability, task ownership, branch, and task state determine what you can select. | Surface or field | What it is for | When it is available | |---|---|---| | **Comments** | Open the job discussion. | The job has an ID and the comments feature is available. | | **Tasks** | Open follow-up tasks. | The job has an ID and the tasks feature is available. | | **Activities** | Open activities related to the job. | The job has an ID and the activities feature is available. | | Comment content | Write or edit discussion text. | **Comments** is selected and commenting is allowed. | | Search comments | Find existing discussion. | Comment search is enabled. | | **Priority** | Set task priority. | A task is loaded and its priority list is available. | | Task title | Name the follow-up task. | A task is loaded. | | **Description** | Add optional task detail. | A task is loaded. | | **Start date** | Set when the task starts. | A task is loaded. | | **Due date** | Set when the task is due. | A task is loaded; its minimum is the start date. | | **Task progress** | Set task progress with a number slider. | A task is loaded. | For a saved task, the task area can also provide **Sub-tasks**, **Activities**, **Attachment**, and **Last Modifications**. **Sub-tasks** is available for a saved top-level task with no parent. These tabs require a saved task opened as a full page, not through input-ID mode. Use the fields here to complete the discussion or task procedure that follows. ## Keep the job discussion Use a comment to leave job context where the people following the record can find it. **Prerequisites** - The saved sales job is open on the **Comments** surface. - Commenting is allowed. **Steps** 1. Enter the discussion in the comment editor. 2. Select **Post**. 3. If **Search comments** is available, enter search text to locate matching discussion. **Result:** The comment is submitted, or the existing discussion is narrowed by the search text. Continue with a reply, edit, or deletion when that action is available. ### Reply to a comment A reply adds a response below an existing comment when the reply action is available. **Prerequisites** - A comment is open on the **Comments** surface. - **Reply** is available for the comment. **Steps** 1. Select **Reply** on the comment. 2. Enter the response in the comment entry area. 3. Select **Post**. Use the following table to manage the reply area: | If you need to… | Select | |---|---| | Expand existing replies | **Show (n) replys** | | Collapse displayed replies | **Hide replys** | **Result:** The response is submitted, and the reply area remains open or collapsed according to the control you select. Continue with [Edit your own comment](#edit-your-own-comment). ### Edit your own comment An owned comment belongs to the current person. Only an owned, currently non-editable comment exposes the edit path. **Prerequisites** - The comment belongs to the current person. - **Edit** is available. **Steps** 1. Select **Edit** on the owned comment. 2. Select the comment text and replace it with the revised wording. 3. Select **Save** to keep the change. 4. Select **cancel** instead of **Save** to leave the comment unchanged. **Result:** The revised comment is submitted with **Save**, or the edit closes without the revision when you select **cancel**. ### Delete your own comment Deleting an owned comment removes that discussion topic and its content after you confirm the prompt. **Prerequisites** - The comment belongs to the current person. - **Delete** is available for the comment. **Steps** 1. Select **Delete** on the owned comment. 2. Read the confirmation prompt: `Are you sure you want to delete this topic and all its content?` 3. Confirm the deletion in the prompt. **Result:** The deletion request is confirmed for the owned comment and its content. ## Maintain an open follow-up task An open follow-up task records work that still needs attention on the saved sales job. Complete its required information, assign its owner, and use the action that matches its current state. **Prerequisites** - The saved sales job is open on **Tasks**, or a task dialog is available. - The task owner and matching branch are known. - You have a priority, title, start date, and due date. **Steps** 1. Select a value in **Priority**. 2. Enter the task name in the task title field. 3. Enter supporting detail in **Description**, if needed. 4. Set **Start date**. 5. Set **Due date** on or after the **Start date**. 6. Set the task owner to the person who must accept or work the task. 7. Select **Save and Close**. Use the following table for the applicable task-state action: | If | Select | |---|---| | The current person owns a new task that is not accepted | **Accept** or **Decline** | | The saved task is overdue or due to start | **Consider As Complete** | | The saved task is completed | **Consider As Not Completed** | **Result:** The task information is submitted with **Save and Close**, or its state changes through the applicable owner- and state-based action. Continue with the availability checks if a field or action is absent. ## Handle availability branches Availability branches explain why a tab or action can differ between records. Check the matching condition before treating an absent control as a missing value. | What changes | What to check | |---|---| | **Comments** is absent | The sales job has an ID and the comments feature is available. | | **Tasks** is absent | The sales job has an ID and the tasks feature is available. | | **Activities** is absent | The sales job has an ID and the activities feature is available. | | New task actions are absent | The task is new, or the current owner has accepted it; the current person is the owner. | | A new sub-task action is absent | The task is in **Sub-tasks**, belongs to the same branch, and is not completed. | | A new task activity action is absent | The task is in **Activities**, belongs to the same branch, and is not completed. | | Task-related tabs are absent | The task is saved and opened as a full page rather than through input-ID mode. | | **Sub-tasks** is absent | The saved task has a parent task. | | The **Follow** field is not available | There is no **Follow** field to complete. | | The task list has no filter field | There is no filter field to enter. | The task activity choices **Meeting**, **Visit**, and **Call** are available when the task is saved, **Activities** is active, the branch matches, and the task is not completed. ## When a comment or task action goes wrong Use the message on the screen to correct the named field or confirm the action. | What you see | What to do | |---|---| | `Priority is required` | Select a value in **Priority**. | | `Title is required` | Enter a value in the task title field. | | `Start Date is required` | Set **Start date**. | | `Due Date is required` | Set **Due date**. | | `Check mandatory field(s)` | Complete any missing required task value before selecting **Save and Close** again. | | `An error occurred while processing your request` | Review the record, owner, branch, and task-state conditions before repeating the action. | | `Are you sure you want to delete this topic and all its content?` | Stop if you do not want to remove the owned comment and its content; otherwise confirm the prompt. | The saved sales-job surface can also return the following messages from related panels and lifecycle actions. Use the owning context to decide where to continue. | Message | Reader-facing context | |---|---| | `Custom fields saved successfully` | Custom fields | | `Job updated successfully` | Sales-job lifecycle | | `Job deleted successfully` | Sales-job lifecycle | | `Job regretted successfully` | Sales-job lifecycle | | `Job cancelled successfully` | Sales-job lifecycle | | `Job missed successfully` | Sales-job lifecycle | | `Job reactivated successfully` | Sales-job lifecycle | | `Converted to offer successfully` | Sales-job lifecycle | | `Converted to inquiry successfully` | Sales-job lifecycle | | `Converted To Regretted` | Sales-job lifecycle | | `Converted to cancelled` | Sales-job lifecycle | | `Converted to lost` | Sales-job lifecycle | | `Error saving custom fields` | Custom fields | | `Cannot be un-delivered — a due invoice already exists` | Delivery and invoice workflow | | `All offers must be in draft status to revert to inquiry` | Offer and inquiry workflow | | `Error {{errorMsg}}` | Returned request error | | `An account with this name already exists` | Account record | | `A project with this name already exists` | Project record | | `Please save opened inquiry first` | Inquiry workflow | | `All inquiries must be in draft stage to revert to potential` | Inquiry workflow | | `One or more items has ZERO quantity` | Item validation | | `One or more items has no unit` | Item validation | | `This record is related to saved data and cannot be deleted` | Related-record deletion | | `This field is required ` | General field validation | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Numeric validation | | `Invalid input. Please enter a non-negative value` | Numeric validation | | `Required Receiving Date` | Field label for a required receiving date. | The **Due date** minimum is the **Start date**. Set the start date before choosing a due date. ## Continue after saving After discussion or task work, stay with the saved sales job when the next job decision is part of its lifecycle. For files and job activities, continue with [Activities and attachments on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-activities-and-files). For task and activity work beyond this record, continue with Tasks and activities. # Activities and attachments on a sales job ## Activities and attachments on a sales job A saved sales job is the job record that keeps its follow-up work and supporting documents. Use **Activities** to record visits, meetings, and calls. Use **Attachment** to associate supporting files with the same record. | If you need to… | Go to | |---|---| | Check the job's visits, meetings, or calls | [Understand the activities and files surfaces](#understand-the-activities-and-files-surfaces) | | Record a visit, meeting, or call | [Record a visit, meeting, or call](#record-a-visit-meeting-or-call) | | Associate a supporting file | [Attach and manage supporting files](#attach-and-manage-supporting-files) | | Find the saved job first | [Find sales job work](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/find-sales-job-work) | | Review broader activity work | The `tasks-and-activities` and `my-desk-activities` pages | | Work with the file library | The `libraries-files` page | ## Before you start The Activities and Attachment surfaces belong to an existing saved sales job. Before you open them, have the following in place: | Requirement | Why it matters | |---|---| | An existing saved sales job | The **Activities** and **Attachment** tabs require a saved job. | | The Activities feature enabled | This feature controls whether **Activities** is available. | | The Attachments feature enabled | This feature controls whether **Attachment** is available. | | A non-principal user account | Both tabs are guarded against principal users. | | New-activity permission | The creation action and its **Visit**, **Meeting**, and **Call** choices require this permission. | | An editable record context | The new-activity plus action requires an editable record context. | | A related record and a writable attachment panel | **Attach File** requires a related record and a panel that is not read-only. | The page itself must also be available. When the page is unavailable, the Activities and Attachment tab conditions do not open their surfaces. > **Note:** Activities and attachments are separate features. If one tab is available and > the other is not, continue with the available surface and contact your administrator about > the missing feature. ## Find the sales job and open related work Related work is the activity list or attachment panel belonging to the saved sales job. Open it from the My Desk screen, where the saved job is the record context. Prerequisites - You have an existing saved sales job. - You meet the conditions in [Before you start](#before-you-start). Steps 1. Open the My Desk screen. 2. Open the saved sales job from the sales-job work area. 3. Select **Activities** to open the job's activity list. 4. Select **Attachment** to open the files attached to the job. Selecting **Activities** opens the activity list. Selecting **Attachment** opens the file panel. Keep the saved job open when you choose either related-work tab. **Result:** The saved sales job is open with either its activity list or its attachment panel on screen. ## Understand the activities and files surfaces The **Activities** surface is the job's activity list. The **Attachment** surface is the job's attachment panel. Activity actions belong to the activity list; file actions belong to the attachment panel and its file-library hand-off. On **Activities**, use **Show archived activities** when archived activities need to be included in the list. Use **Export** to start an activity-list export. The activity-list columns come from your saved list layout, so work from the headers visible in your list rather than expecting a fixed set of columns. On **Attachment**, use **Attach File** to open the file library from the job's attachment surface. Existing-file actions are icon-only in this region. They are available only when attached files exist, loading has finished, no error is present, and the panel is not read-only. The file library owns the file-selection and broader file-management flow. The activity creation action is available only on the Activities branch when the same feature and permission conditions are true and the record is editable. Its menu contains **Visit**, **Meeting**, and **Call**. ### Activity fields An activity records what happened or is planned, when it happens, and the topic and subject that identify it. The required and optional fields depend on whether you choose a visit, meeting, or call. | Activity type | Required fields | Optional fields | |---|---|---| | Visit | **Priority**, unlabeled topic control, unlabeled subject control, **Start Date**, **End Date** | **Visit type** | | Meeting | **Priority**, unlabeled topic control, unlabeled subject control, **Start Date**, **End Date** | — | | Call | **Priority**, unlabeled topic control, unlabeled subject control, **Start Date** | **Call Use**, **Description** | The choices for **Priority**, the topic control, **Visit type**, and **Call Use** load at runtime. Select from the choices shown in your activity form. ### File fields and columns An attachment classifies a supporting file against the saved sales job. The required field on this surface is **Category**. | Field or control | What to use | |---|---| | **Category** | Select the attachment category. This select is required. | | File name | The attachment surface does not expose a labelled file-name control. | | Download | Existing-file download is an icon-only action in this region. | | Unlink | Existing-file unlink is an icon-only action in this region. | | File columns and contents | They depend on the attachments available at runtime. | The file library supplies the file-selection flow. When the conditions are met, select the icon-only action beside the attached file. ## Record a visit, meeting, or call Record a visit, meeting, or call against the saved sales job by choosing an activity type, entering its fields, and completing it with **Done**. Prerequisites - The saved sales job is open on **Activities**. - The new-activity action is available because the record is editable and you have new-activity permission. - You have the activity topic, subject, timing, and any applicable visit or call details. Steps 1. Select the plus action in the activity-list toolbar on the **Activities** surface. 2. Choose the activity type that matches the work you are recording. | If you are recording… | Select | |---|---| | A visit | **Visit** | | A meeting | **Meeting** | | A call | **Call** | 3. Select a value in **Priority**. 4. Select the activity topic in the required topic field. 5. Enter the activity subject in the required subject field. 6. Enter the applicable date fields. | Activity type | Enter | |---|---| | Visit | **Start Date** and **End Date** | | Meeting | **Start Date** and **End Date** | | Call | **Start Date** | 7. Enter the optional details for the selected activity type. | Activity type | Optional details | |---|---| | Visit | Select **Visit type**. | | Meeting | — | | Call | Select **Call Use** and enter **Description**. | 8. Complete the activity with **Done**. The activity must contain one topic and at least one note. If that requirement is not met, the activity does not complete and the screen displays `One topic and at least one note is required`. **Result:** The selected visit, meeting, or call is completed on the saved sales job, or the validation message identifies the information to add. ## Attach and manage supporting files Use the attachment surface to associate a supporting file with the saved sales job. File selection and broader file management remain in the file library. Prerequisites - The saved sales job is open on **Attachment**. - A related record exists. - The attachment panel is not read-only. - The attachment dropdown is open when you use the compact panel. Steps 1. Select **Attach File** on the attachment panel. 2. In the file-library flow, select the required **Category**. 3. Continue the file-library operation using its controls. 4. When an existing attachment is available, select the applicable icon-only action beside the attached file after loading has finished and when no error is present. | If you need to… | Select… | |---|---| | Download the attached file | the download action | | Unlink the attachment | the unlink action | If **Category** is empty, the required-field message is `This Field Is Required`. **Result:** The supporting file is associated with the saved sales job, or the file library is open for the remaining file operation. ## Handle activity status and activity choices An activity's status determines which action is available after the activity exists. The activity detail surface uses the activity ID, its current status, and your edit permission to decide which status action appears. | Activity state | Available action | |---|---| | Existing due or overdue activity | **Done** changes it to done. | | Existing editable planned, overdue, or due activity | **Cancel This Activity** cancels it. | | Existing editable cancelled activity | **Undo Cancellation** reopens it. | These choices require an existing activity ID. **Cancel This Activity** and **Undo Cancellation** also require edit permission. The status-specific state guard can hide an action when the activity is in another state. ## When an activity or file action fails Use the message on screen to choose the corrective action. The messages below belong to the activity and attachment surfaces covered by this page. | Message | Corrective action | |---|---| | `One topic and at least one note is required` | Add a topic and at least one note before completing the activity. | | `This action is only allowed if you belong to that branch` | Use an account that belongs to the required branch. | | `There is no topic to print` | Add a topic before using the activity print action. | | `Your request was completed successfully` | Treat the activity-list request as completed and review the refreshed list. | | `Action not allowed` | Stop the action and use an activity-list operation permitted for your account. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the activity-list input and submit it again. | | `This Field Is Required` | Select **Category** before continuing with the attachment. | | `An error occurred while processing your request` | Review the activity details and repeat the action; if it continues, use the owning activity support route. | The activity actions can also be unavailable when the activity ID, current status, edit permission, feature, branch, or record context does not meet the action's condition. ### Out of scope The following messages belong to purchasing, item-grid, lifecycle, or other sales-job surfaces. Use the relevant area when one of these messages appears. | Message | Owning area | |---|---| | `Required Receiving Date` | Sales-job purchasing panels | | `This record is related to saved data and cannot be deleted` | Tasks page | | `This field is required` | Sales-job item grids | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Sales-job item grids | | `Invalid input. Please enter a non-negative value` | Sales-job item grids | | `Custom fields saved successfully` and `Error saving custom fields` | Sales-job custom-fields page | | `Job updated successfully`, `Job deleted successfully`, `Job regretted successfully`, `Job cancelled successfully`, `Job missed successfully`, and `Job reactivated successfully` | Sales-job lifecycle and header page | | `Converted to offer successfully` and `Converted to inquiry successfully` | Sales-job lifecycle and header page | | Offer, inquiry, cost-sheet, purchasing, product, account, project, contact, bill-of-materials, serial, guarantee, and delivery validations | Their owning sales-job or related page | ### Out of scope The activity-list headers depend on the saved list layout. Attachment contents, existing file names, icon-only control positions, and the initial collapsed or expanded state of the attachment panel depend on what is available at runtime. The file library owns upload, linking, and category-edit work; continue there for those operations. The two required activity controls have no labels on this surface, and the select options load at runtime. ## After you record the activity or attach the file After completion, review the activity in the saved job's **Activities** surface. Use **Show archived activities** to include archived entries and **Export** to start an activity-list export. After attaching a file, review it on the **Attachment** surface and select the icon-only action beside the attached file when its conditions are met. For the broader activity workspace, continue to `tasks-and-activities` or `my-desk-activities`. For comments and tasks associated with the saved job, continue to `sales-job-comments-and-tasks`. For file-library upload, linking, and management, continue to `libraries-files`. The saved sales-job record and common record work belong to `sales-job-record`. # Contacts, L/Gs, and Last Modifications on a sales job ## 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 job | [Associate a contact with the sales job](#associate-a-contact-with-the-sales-job) | | Review or request a job-related letter of guarantee | [Review or request a job-related L/G](#review-or-request-a-job-related-lg) | | Review who changed the job and what changed | [Review recorded job changes](#review-recorded-job-changes) | | Understand why a tab or action is unavailable | [Handle availability and stage branches](#handle-availability-and-stage-branches) | | Match a displayed message to a recovery action | [When a related-work action goes wrong](#when-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**. | Surface | What must be in place | |---|---| | **Contacts** | A saved job, the Contacts subscription, a selected account with a `PrimaryID`, and the **Contacts** tab selected. | | **LGs** list | A saved job with `Job.Id`, the Letter of Guarantee subscription, the **LGs** tab selected, and the list access for that tab. | | **Last Modifications** | The **Last Modifications** tab selected and the Latest Modifications subscription. | | All three | A non-principal user. | | Work information | The 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](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6d9f516218dd152ca887379cd3d98859.png) **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. ## Understand the related-work surface The related-work surface keeps people, guarantees, and change history beside the saved job without replacing the main record. | Tab | Use it for | What you can see or open | |---|---|---| | **Contacts** | Associate people with the job. | The contact grid can show **Title**, **Name**, **Position**, **Department**, **Account**, and **Branch**. | | **LGs** | Review 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 Modifications** | Review 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). ## 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 exist | Enter its text in the contact selection area. | | Remove the association when permitted | Select the contact's icon-only delete action. | | Continue when the contact flow opens a new record | Continue 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](#review-or-request-a-job-related-lg) if you need guarantee work. ## Review or request a job-related L/G 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/G | **All** | | A draft request | **Draft** | | A request awaiting approval | **Awaiting Approval** | | An approved guarantee | **Approved** | | An active guarantee | **Active** | | A guarantee due for return | **Due for Return** | | An expired guarantee | **Expired** | | A cancelled guarantee | **Cancelled** | | A liquidated guarantee | **Liquidated** | | A returned guarantee | **Returned** | | A closed guarantee | **Closed** | 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: | Field | Requirement or choices | |---|---| | **Expiry Date** | Required. | | **On Behalf of** | Configuration-dependent selection. | | **LG Type** | **Bid bond**, **Down payment guaranty**, **Performance bond**, or **Warranty bond**. | | `RequestedAmount` | Configuration-dependent number. | | `IsExtendable` | Declared as not required. | | `CurrentAmount` | Configuration-dependent number. | | `Confirmation Of The LG Requirement` | Required; choose **Yes** or **No**. | | `Comment` | Required. | | `Confirmation Of The Financial Viability` | Required; 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 record | **Save** | | Save the detail record and leave it | **Save and Close** | | Request approval | **Request 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](#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). ## 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 unavailable | Condition that controls it | |---|---| | **Contacts** | The Contacts subscription, selected account, account `PrimaryID`, and **Contacts** tab state are required. Principal users cannot use it. | | **LGs** | The Letter of Guarantee subscription, `Job.Id`, the **LGs** tab state, and active access to that tab are required. Principal users cannot use it. | | **Last Modifications** | The 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 Modifications** | A loaded guarantee with an ID is required. | | **New** contact action | `allowedtoNew` and the Contacts subscription are required. | | Contact association deletion | A non-empty list, selected layout, same branch, the Contacts subscription, and `allowedtoDelete` are required. | | New L/G request | Same-branch access and `allowedtoNewLetterOfGuarantee`, together with the L/G list conditions, are required. | | L/G list views | The 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](#when-a-related-work-action-goes-wrong) for a displayed recovery message. ## When a related-work action goes wrong 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. | Message | What 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 name` | Use the existing contact instead of creating a duplicate. | | `Please Add Extension to activate the LG` | Add the required extension before activating the L/G. | | `LG has one or more extensions or deductions and cannot be reverted to the requested stage` | Do not revert the L/G to that stage while its extensions or deductions remain. | | `LG still needs confirmation` | Complete the required confirmation before continuing. | | `Please choose a date after the current expiry date` | Choose a date after the current expiry date. | | ` There is a pending increase you can edit` | Edit 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. | Message | What to do | |---|---| | `Custom fields saved successfully` | Continue after confirming that the custom fields are saved. | | `Job updated successfully` | Continue after confirming that the job is updated. | | `Job deleted successfully` | Return to the appropriate list after confirming that the job is deleted. | | `Job regretted successfully` | Continue from the regretted-job result. | | `Job cancelled successfully` | Continue from the cancelled-job result. | | `Job missed successfully` | Continue from the missed-job result. | | `Job reactivated successfully` | Continue working with the reactivated job. | | `Converted to offer successfully` | Continue with the offer work for the job. | | `Converted to inquiry successfully` | Continue with the inquiry work for the job. | | `Converted To Regretted` | Continue from the regretted result. | | `Converted to cancelled` | Continue from the cancelled result. | | `Converted to lost` | Continue from the lost result. | | `An error occurred while processing your request` | Review the current action and its fields, then repeat it. | | `Error saving custom fields` | Review the custom fields, correct them, and save again. | | `Cannot be un-delivered — a due invoice already exists` | Review the due invoice before changing the delivery state. | | `All offers must be in draft status to revert to inquiry` | Return 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 exists` | Use the existing account instead of creating another one. | | `A project with this name already exists` | Use the existing project instead of creating another one. | | `Check mandatory field(s)` | Complete the mandatory fields. | | `Please save opened inquiry first` | Save the opened inquiry before continuing. | | `All inquiries must be in draft stage to revert to potential` | Return every inquiry to **Draft**, then repeat the reversion. | | `One or more items has ZERO quantity` | Enter a quantity greater than zero for each item. | | `One or more items has no unit` | Select a unit for each item. | | `Please enter action for each milstone ` | Enter an action for each milestone. | | `Please save opened cost sheet first` | Save 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 successfully` | Continue after confirming that the request is complete. | | `Error: Vendor not saved yet` | Save the vendor before continuing. | | `Error: Client not saved yet` | Save the client before continuing. | | `This Field Is Required` | Complete the field. | | `Just '_'‘-''.' And '&' Characters Accepted` | Remove characters outside the accepted set. | | `Sales order is archived` | Open the active sales order before continuing. | | `Booked quantity for this job is greater than the required BOM quantity` | Reduce the booked quantity to the required quantity or less. | | `You cannot edit or delete the product after the purchase package is created` | Use the existing product without editing or deleting it. | | `Cannot be deleted. Product is in purchasing` | Leave the product in place while it is in purchasing. | | `You cannot edit the product after the PO is created` | Leave the product in place after the purchase order is created. | | `This product is already included in BOM` | Use the existing BOM item instead of adding it again. | | `The first variant cannot be deleted` | Keep 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 product` | Select one product, then continue. | | ` Package must have at least one item` | Add at least one item to the package. | | `You cannot save without adding at least one product` | Add at least one product before saving. | | `One of products has no quantity` | Enter a quantity for every product. | | `This record is related to saved data and cannot be deleted` | Keep the record and continue without deleting it. | | `Action not allowed` | Choose an action available for the current record. | | `Check validation` | Correct the validation errors. | | `No remaining items. All items have been selected` | Continue with the selected items. | | `This action is only allowed if you belong to that branch` | Use an account that belongs to the record's branch. | | `Please enter at least one email` | Enter at least one email address. | | `Inquiry must have at least one item` | Add at least one item to the inquiry. | | `Offer must have at least one item` | Add at least one item to the offer. | | `Order must have at least one item` | Add at least one item to the order. | | `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Keep 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 permission` | Ask an administrator for the required permission. | | `Error loading accounts` | Refresh the account list and select an available account. | | `Serial you have entered already exist and belong to same manufacturer` | Enter a different serial or review the existing manufacturer. | | `There is error in serial you have entered` | Correct the serial and submit it again. | | `Minimum: At least one serial` | Enter at least one serial. | | `One topic and at least one note is required` | Enter a topic and at least one note. | | `There is no topic to print` | Add a topic before printing. | | `Required Receiving Date` | Enter the receiving date. | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a value between the stated limits. | | `Invalid input. Please enter a non-negative value` | Enter zero or a positive value. | | `Required Receiving After` | Enter the receiving-after value. | | `Required Offer Type` | Select an offer type. | | `Required Bid Due Date` | Enter 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. # Sales job variants Choose the route that matches the work you are starting, then continue on the page for that route's stage. ## Overview A sales job records commercial work as it moves from an early opportunity to delivery. A Potential is an early opportunity; an **Inquiry** records a request for an offer; an **Offer** records the commercial proposal; and an **Order** records confirmed order work. The available starting routes are **Potentials**, **Direct order**, and **Instant Job**. An Instant Job is an order-starting route. ```mermaid flowchart LR P[Potentials] --> I[Inquiry] I --> O[Offer] O --> R[Order] R --> D[Delivered] DO[Direct order] --> R IJ[Instant Job] --> R ``` | If you need to… | Go to | | --- | --- | | compare the available starting routes | [Find and choose a starting route](#find-and-choose-a-starting-route) | | identify the Potential fields before entering data | [Recognize the Potential workspace](#recognize-the-potential-workspace) | | switch to a different route | [Choose another starting route](#choose-another-starting-route) | | understand the complete stage map | [Sales job lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle) | | create a sales job from the general entry point | [Create a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-sales-job) | | start early opportunity work | [Potentials](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/potentials) | | record a customer request | [Inquiries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/inquiries) | | work on a proposal | [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers) | | work on an order | [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) | | move an order through delivery | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) | The normal route starts at Potential with an inquiry, then follows **Potentials**, **Inquiry**, **Offer**, **Order**, and **Delivered**. The two order-starting routes, **Direct order** and the Instant Job route start at **Order**. ## Before you start > **Note:** The route determines the stage at which the record begins, so choosing an > order-starting route bypasses the inquiry and offer stages. The Sales job module provides the route choices and the new-record workspace. You need signed-in access and permission to create a sales job. Before choosing a route, collect the information that belongs to that route. | Collect | Why it matters | | --- | --- | | Client and Vendor | The Potential route requires both parties, and the route-specific work uses the selected parties. | | Items, Item Description, Unit, and Qty | The item grid carries the work into the inquiry, offer, or order. | | Dates such as Bid Due Date, Order Date, and delivery dates | Each route presents the dates appropriate to its starting stage. | | Commercial terms such as Delivery Term, Payment Method, and Payment Period | Direct-order and Instant Job order work uses these terms. | | Salesperson Responsible, Product Type, and Job Title | These fields are required across the new-record variants. | The Sales job module must be included in your subscription. If it is not included, the new-record page shows the subscription-upgrade surface instead of the form. With the route information ready, open the starting route from **Add new**. ## Find and choose a starting route The route choices open the new sales-job workspace. **Add new** contains **Potentials**, **Inquiry**, and **Direct order**. The Instant Job route is available where its route conditions are met. Prerequisites - You are signed in. - The Sales job module is included in your subscription. - You have permission to create a sales job. Steps 1. Open **Add new** or the unlabelled plus icon. 2. Select the route that matches the work. | If you need to start… | Select | | --- | --- | | an early opportunity | **Potentials** | | a customer request | **Inquiry** | | an order without the inquiry and offer stages | **Direct order** | | an Instant Job route | the Instant Job route when it is available | 3. If you select **Potentials**, confirm that the new sales-job workspace opens with **Job Title** visible. ![The Potentials workspace with its stage sequence and item grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/dc006cfee717f5bac53000e47df7c2b3.png) **Result:** The selected new-record route opens with its route-specific workspace and controls visible. Use the Potential fields and item grid described next when you choose **Potentials**. ## Recognize the Potential workspace The Potential workspace is where you record an early opportunity before the work moves through the inquiry and offer stages. On the Potential route, **Client**, **Vendor**, **Salesperson Responsible**, **Product Type**, and **Job Title** are required. | Area | Fields or columns | | --- | --- | | Required party and date fields | **Client**, **Vendor**, **Bid Due Date** | | Inquiry information | **Client Inquiry Number**, **Inquiry Date**, **Requested Offer Type** | | Shared required fields | **Salesperson Responsible**, **Product Type**, **Job Title** | | Item grid | **Item Description**, **Unit**, **Qty** | The Potential screen showed **File Number** as required as well. The item grid showed **Item Description**, **Unit**, and **Qty**. **Qty** accepts a value from `0.1` to `999,999.00`; it is disabled for package items. **Unit** is disabled for package items or selected products. ![The Potential fields and three visible item columns.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c54a55b6021d9db28a94484fd157341e.png) Use the route-availability table next to interpret a missing route or a later starting stage. ## Handle route-availability branches Route availability depends on the module and on the route conditions. The absence of a route in one starting variant does not mean that its work is deleted; it means that the variant starts later in the stage sequence. | What you see | What it means | | --- | --- | | The subscription-upgrade surface instead of the form | The Sales job module is not included. | | **Order** and **Delivered**, with no **Inquiry** or **Offers**, on a Direct order screen | Direct order starts at Order. | | **Order** and **Delivered**, with no **Inquiry** or **Offers**, on an Instant Job screen | Instant Job starts at Order. | | No related-inquiry action on a Direct order or Instant Job | The action is excluded for both order-starting variants. | When the required route is available, choose it from the route menu described below. ## Choose another starting route Choose another starting route when you need a different route for the work. The route-specific form determines which fields and choices you see after the route opens. Prerequisites - You are signed in and have creation permission. - The required route is available in the route menu. - You have the client, vendor, item, date, and commercial information for the selected route. Steps 1. Open **Add new** or the unlabelled plus icon. 2. Select one route. | Starting work | Select | | --- | --- | | Potential work | **Potentials** | | Inquiry work | **Inquiry** | | Order work | **Direct order** | | Instant Job order work | the Instant Job route, only where it is available | 3. Use the route-specific controls after the workspace opens. | Route | Order fields | Item columns | | --- | --- | --- | | Direct order | **Client Order No.**, **Vendor Order No.**, **Order Date**, **Order Activation Date**, **Delivery Time**, **Forecasted Delivery Date**, **Delivery Term**, **Payment Method**, **Payment Period**, **External order no.**, **Rate to** | **Item Description**, **Unit**, **Qty**, **Unit Price**, **Discount (%)**, **Item Price**, **Currency** | | Instant Job | **Client Order No.**, **Vendor Order No.**, **Order Date**, **Order Activation Date**, **Delivery Time**, **Forecasted Delivery Date**, **Delivery Term**, **Payment Method**, **Payment Period**, **External order no.**, **Rate to** | **Item Description**, **Unit**, **Qty**, **Unit Price**, **Discount (%)**, **Item Price**, **Currency** | 4. Choose the route-specific values from **Product Type**, **Requested Offer Type**, **Unit**, **Delivery Term**, and **Payment Method** where those controls appear. ![The Direct order fields and order item grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/388ad35e9ee6bb78f64c7e79e62e20ec.png) ![The Instant Job fields and order item grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/388ad35e9ee6bb78f64c7e79e62e20ec.png) **Result:** The alternative new-record workspace opens with the fields and item columns for that route. Continue with the owning page after choosing the route. ## Continue with the owning page Each route has an owning page for its route-specific work. After choosing a route, open its stage page for the route-specific work. | Selected route | Continue with | | --- | --- | | Potential | [Potentials](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/potentials) | | Inquiry | [Inquiries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/inquiries) | | Offer | [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers) | | Order | [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) | | Order through delivery | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) | Standard creation returns an inquiry record. For the inquiry path, the selected account becomes a client for that inquiry. Open the linked stage page for the work at that stage. ## Out of scope This page chooses a starting route. It does not explain saved-record tabs or post-creation tools; offer, order, delivery, archive, or project-management surfaces; or milestone, cost-sheet, product/BOM, CRM, account/contact, reference-serial, L/G, and activity messages. Initial values and runtime-configured fields remain outside this route-choice page. ### Offer and cost panels The offer panel is downstream work. `offer-panel-details` is stage-gated from **Offer** through `LostOffer`. Cost calculation and margin surfaces are inherited embedded surfaces. Offer and cost validation are outside choosing a starting route. ### Account details and contacts Use **Client** and **Vendor** to open the corresponding party pickers while choosing a route. Account-details and contact surfaces are owned by embedded or popup surfaces. Their maintenance messages are outside this route-choice page. ### Bill of materials and purchasing The bill-of-materials surface is available only under its stage and permission guard. The purchasing surface requires a saved job, permission, and subscription. Product/BOM and purchasing messages belong to those downstream surfaces. ### Other owning pages Use this hand-off map after route selection: | Work | Owning page | | --- | --- | | Potential work | [Potentials](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/potentials) | | Inquiry work | [Inquiries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/inquiries) | | Offer work | [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers) | | Order work | [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) | | Order-to-Delivered hand-off | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) | | Saved-record orientation | [Sales job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-record) | | Saved job information and assessment | [Sales job information and assessment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-information-and-assessment) | | Saved job items | [Sales job items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-items) | | Comments and tasks | [Comments and tasks on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-comments-and-tasks) | | Activities and files | [Activities and attachments on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-activities-and-files) | | Contacts, guarantees, and history | [Contacts, L/Gs, and Last Modifications on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-contacts-guarantees-and-history) | ### Route and validation messages If a route or field stops you, use the exact message to identify the correction or the owning page. The messages declared for this area are listed below; inherited messages belong to the downstream surface named in the adjacent guidance. | Message | Guidance | | --- | --- | | `Custom fields saved successfully` | Custom-field result; continue on the owning saved-record page. | | `Job updated successfully` | Saved-record result; continue on the owning saved-record page. | | `Job deleted successfully` | Saved-record result; deletion is outside route selection. | | `Job regretted successfully` | Outcome action is outside route selection. | | `Job cancelled successfully` | Outcome action is outside route selection. | | `Job missed successfully` | Outcome action is outside route selection. | | `Job reactivated successfully` | Outcome action is outside route selection. | | `Converted to offer successfully` | Continue with [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers). | | `Converted to inquiry successfully` | Continue with [Inquiries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/inquiries). | | `Converted To Regretted` | Outcome action is outside route selection. | | `Converted to cancelled` | Outcome action is outside route selection. | | `Converted to lost` | Outcome action is outside route selection. | | `An error occurred while processing your request` | Review the route and required information, then use the owning page. | | `Error saving custom fields` | Custom-field validation is outside route selection. | | `Cannot be un-delivered — a due invoice already exists` | Delivery correction is outside route selection. | | `All offers must be in draft status to revert to inquiry` | Offer correction is outside route selection. | | `Error {{errorMsg}}` | Use the owning page for the affected record. | | `An account with this name already exists` | Account maintenance is outside route selection. | | `A project with this name already exists` | Project management is outside route selection. | | `Check mandatory field(s)` | Complete the required fields on the selected route. | | `Please save opened inquiry first` | Save the inquiry on its owning page before continuing. | | `All inquiries must be in draft stage to revert to potential` | Use the inquiry owning page for this correction. | | `One or more items has ZERO quantity` | Enter a positive **Qty** for each item. | | `One or more items has no unit` | Choose a **Unit** for each item that requires one. | | `Required Receiving Date` | Complete the receiving-date field on the owning downstream page. | | `This field is required` | Complete the field marked as required. | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a **Qty** within the allowed range. | | `Invalid input. Please enter a non-negative value` | Replace the value with a non-negative value. | | `Please enter action for each milstone` | Complete the milestone action on the owning page. | | `Please save opened cost sheet first` | Save the cost sheet on its owning page. | | `Your request was completed successfully` | Continue on the owning page. | | `Error: Vendor not saved yet` | Save the Vendor on the owning account surface. | | `Error: Client not saved yet` | Save the Client on the owning account surface. | | `This Field Is Required` | Complete the field marked as required. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters on the owning form. | | `You already have a contact with this name` | Use the contact surface to correct the duplicate. | | `Booked quantity for this job is greater than the required BOM quantity` | Correct the BOM quantity on the owning surface. | | `You cannot edit or delete the product after the purchase package is created` | Use the purchasing-owned correction path. | | `Cannot be deleted. Product is in purchasing` | Use the purchasing-owned correction path. | | `You cannot edit the product after the PO is created` | Use the purchasing-owned correction path. | | `This product is already included in BOM` | Correct the BOM on its owning surface. | | `The first variant cannot be deleted` | Use the owning variant surface. | | `An error occurred while connecting to your CRM system.` | CRM correction is outside route selection. | | `Please select one product` | Select a product on the owning product surface. | | `Required Receiving After` | Complete the receiving condition on the owning page. | | `Package must have at least one item` | Add an item to the package on the owning item surface. | | `You cannot save without adding at least one product` | Add a product on the owning item surface. | | `This record is related to saved data and cannot be deleted` | Deletion is outside route selection. | | `Action not allowed` | Use the owning page for the affected stage. | | `Please enter at least one email` | Add an email on the owning contact surface. | | `Inquiry must have at least one item` | Add an item on the inquiry owning page. | | `Offer must have at least one item` | Add an item on the offer owning page. | | `Order must have at least one item` | Add an item on the order owning page. | | `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Use the order or delivery owning page. | | `Please select one or more items to create a RFQ.` | Select items on the purchasing owning page. | | `Required Offer Type` | Complete **Requested Offer Type** when that validation appears. | | `Required Bid Due Date` | Complete **Bid Due Date** on the Potential route. | | `Error loading accounts` | Account loading is outside route selection. | | `Serial you have entered already exist and belong to same manufacturer` | Serial maintenance is outside route selection. | | `There is error in serial you have entered` | Serial maintenance is outside route selection. | | `Minimum: At least one serial` | Serial maintenance is outside route selection. | | `Please Add Extension to activate the LG` | L/G maintenance is outside route selection. | | `LG has one or more extensions or deductions and cannot be reverted to the requested stage` | L/G maintenance is outside route selection. | | `Please choose a date after the current expiry date` | L/G maintenance is outside route selection. | | `One topic and at least one note is required` | Activity maintenance is outside route selection. | # Dashboard Use the Dashboard to review the measures selected for your role, read cards and charts on each tab, and customize widgets when edit mode is available. ## What the Dashboard is The Dashboard is a set of role-based tabs containing the cards and charts selected for your work. Each tab is a separate view, so start with the one that matches the question you are reviewing. The Dashboard includes the Dashboard and Principals Report views. The standard Dashboard can include measures such as business development, sales pipeline, bookings, accounts, teams, branches, and principals. Widget headings include Business development, Sales Pipeline, Booking This Year, Accounts in Sales Pipeline, Teams Booking vs. Target, Teams Running Offer, Branch Tendency to Target, Principals Tendency to Target, Branch Booking vs. Target This Year, Principals Booking vs. Target This Year, Branch Running Offers, and Principals Running Offers. The widget gallery covers 109 components. The Dashboard also has role-specific surfaces for Custom Dashboard and Business Analysis, plus a principal-dashboard role variant. Use the overview below to choose where to continue. | If you need to… | Go to | |---|---| | Check what must be true before review or editing | [Before you start](#before-you-start) | | Open the role's Dashboard | [Open the Dashboard](#open-the-dashboard) | | Understand tabs, dates, widgets, and report sections | [Read dashboard content](#read-dashboard-content) | | Find a widget and save a tab arrangement | [Find widgets and continue to customization](#find-widgets-and-continue-to-customization) | | Choose between Custom Dashboard, Business Analysis, and Principals Report | [Use the dashboard variants](#use-the-dashboard-variants) | | Resolve a missing Dashboard or unavailable subscription surface | [When the Dashboard is unavailable](#when-the-dashboard-is-unavailable) | | Create or administer dashboards | [Dashboard settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings) | | Identify cards and charts by title | [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog) | | Review pipeline and status widget families | [Pipeline and status widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pipeline-and-status-widgets) | | Review management report widget families | [Management report widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/management-report-widgets) | ![Dashboard tabs and the business widgets available for the current role](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c0412e66205334ca9d219c53758132ce.png) ## Before you start The Dashboard is a signed-in, role-based review surface. Your account must be signed in, your role must have dashboard tabs, and the subscription must include the Dashboard content and its embedded widgets. The Dashboard does not require information changes before review. **Prerequisites** - Sign in with the account whose role you want to review. - Confirm that the role has at least one Dashboard tab. - Use a subscription that includes the Dashboard content and embedded widgets. The Dashboard library appears when dashboard tabs exist. Only the active tab displays its content; the other tabs remain available for selection. The subscription condition controls the Dashboard content and embedded widgets. When edit mode is active, the header exposes **Widget** and **Save**, and tab maintenance controls can include **Rename tab**, **Delete tab**, and **Remove widget from tab**. Without a Dashboard, the page displays `Your role has no dashboard` and `Kindly, Contact your administrator to define a dashboard`. ## Open the Dashboard Open the Dashboard from the application's **Dashboard** menu entry. **Prerequisites** - You are signed in. - Your role has a Dashboard. **Steps** 1. Open the application's **Dashboard** menu entry. 2. Select the Dashboard tab you want to review. 3. Select the route that matches the role-specific surface when more than one destination is available. | If you need to… | Route | |---|---| | Open the standard Dashboard landing | `/dashboard` | | Open the principal-dashboard landing | `/principal-dashboard` | | Open the Business Analysis surface | `/dashboard/businessAnalysis` | | Open the Custom Dashboard surface | `/dashboard/customDashboard` | 4. Confirm that the Dashboard content or the role's unavailable-dashboard message is on screen. ![Dashboard landing with its visible tabs, date ranges, widgets, and sorting controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/92c84c4d1016e6185b3a63a6d8c80ec6.png) **Result:** The selected Dashboard surface is open. Its active tab shows its available content, or the page shows why the role has no Dashboard. ## Read dashboard content The active tab is the view currently shown in the Dashboard grid. Select another visible tab for a different role-selected view. On the Dashboard, the date-range labels are Today, Next 10 days, and Last 10 days. The visible sorting controls are **Sort by Booking**, **Sort by Target**, and **Sort by Achievement**. Use the widget heading to identify the measure before interpreting its card or chart. | What you are looking for | What to read | |---|---| | A current or upcoming time view | Today, Next 10 days, or Last 10 days | | A booking ranking | **Sort by Booking** | | A target comparison | **Sort by Target** | | An achievement comparison | **Sort by Achievement** | | A sales or account view | **Sales Pipeline** or **Accounts in Sales Pipeline** | | A team, branch, or principal comparison | The matching Teams, Branch, or Principals heading | The **Principals Report** tab is a role-specific report view. Its report form has the required **Report** field. When a report is ready and not generated, its navigation can include **Running Jobs**, **Status of running firm offers**, **Status of running orders**, **Sales Overview**, **Reasons for lost jobs**, **Status of submitted offers**, **Bookings over time**, **Deliveries over time**, and **Overall Analysis**. The report's outline fields are **Introduction :**, **Sales Analysis :**, **Lost Opportunities and Competition :**, **Client Complaints and Difficulties :**, **Suggestions for Business Improvement :**, **Booking Forecast :**, and **Conclusion :**. The columns shown in a principal report depend on your role and report data, so read the column names currently displayed in that report. ![Principals Report tab with its report field and role-specific report content](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/a124454c600e2bdcb74df6cf64e6f891.png) ## Find widgets and continue to customization Use this section to locate a card or chart already available to the Dashboard or add a selected widget to the active tab. The widget picker is available from edit mode. **Prerequisites** - The Dashboard is open. - Edit mode is available for the role. - You know the widget title or a keyword to search for. **Steps** 1. Choose the widget action that matches your task. | If you need to… | Select | |---|---| | Locate a widget already on the active tab | **Search for widget** | | Add a widget to the active tab | **Widget** | 2. For an existing widget, enter its title or keyword in the search field. 3. For a new widget, select **Widget** in the edit-mode header, then enter a title or keyword in **Keyword to search...** in the **Select widget** dialog. 4. Select **Search for widget** to filter the widget rows. 5. Select the action that matches the number of widgets you want. | If you need to… | Select | |---|---| | Add selected cards or charts | The row for each card or chart | | Add every available card or chart | **Select all** | 6. Select **OK** to confirm the widget selection. 7. Select **Save** to save the Dashboard tabs and exit edit mode. 8. Confirm that the selected widgets appear on the active tab. Selected widgets are added to the active tab. A successful save displays `Your request was completed successfully`. **New Tab** is required when the add-widget flow asks for a new tab title. Tab maintenance can also provide **Rename tab**, **Delete tab**, and **Remove widget from tab**. The Dashboard gallery contains 109 components. **Result:** The selected widgets appear on the active tab after a successful save, and edit mode ends. ## Use the dashboard variants The dashboard variants answer different review questions: Custom Dashboard groups selected measures, Business Analysis provides a refreshable analysis surface, and Principals Report provides the principal-focused report and its sections. | Variant | Controls and choices | |---|---| | Custom Dashboard | **Over**, **Highlight**, **Interval**, **All**, and **Top 50** | | Business Analysis | **Refresh** | | Principals Report | **Report**, **Settings**, and **Introduction & Outline** | For **Over**, the choices are **Clients**, **Projects**, and **Market Segments**. **Interval** has **last 12 months**. **Highlight** initially offers **All Clients** and **All Vendors**. Changing **Over** to another value clears the **Highlight** list; returned client and vendor names depend on the records available to the current role. When the result-range actions are available, select **All** or **Top 50** according to the result range you need. The Principals Report provides **Settings** and **Introduction & Outline**, together with the report section links listed in [Read dashboard content](#read-dashboard-content). The selected principal-report columns depend on the current role and report data. Use the choices and controls shown on the current surface when the available defaults or Highlight values differ. ## When the Dashboard is unavailable An unavailable Dashboard has a specific meaning when the page shows the role message. If the page shows `Your role has no dashboard`, the role has no dashboard defined. The accompanying message is `Kindly, Contact your administrator to define a dashboard`; contact the administrator who defines role dashboards. The subscription branch replaces Dashboard content and embedded widgets when the Dashboard subscription is not included. Follow the subscription-upgrade surface provided by your deployment. If **Widget** or **Refresh** is absent, use the controls available on the current role's page or contact the administrator. | What you see | What it means | What to do | |---|---|---| | `Your role has no dashboard` | No Dashboard is defined for the role. | Contact the administrator who defines dashboards. | | `Kindly, Contact your administrator to define a dashboard` | The page is directing the role to dashboard administration. | Ask the administrator to define a Dashboard for the role. | | The subscription-upgrade surface | The Dashboard subscription is not included. | Follow the subscription-upgrade route provided on screen. | | A variant surface without **Refresh** or **Widget** | The control is not available on the current visible surface. | Continue with the controls that are visible or contact the administrator. | | `An error occurred while processing your request` | The Dashboard request returned the common processing error. | Review the current action and request conditions, then retry. | | `Please choose one or more principals` | The principal report requires one or more principals. | Choose one or more principals before continuing the report action. | ## Continue to Dashboard settings Dashboard customization is an administrative settings task. Use [Dashboard settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings) for the registered administrative page. Continue to [New dashboard setting](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings-new) to create a record or [Edit dashboard setting](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings-edit-record) to maintain one. For detailed widget inventories, use the three focused widget catalog pages: [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog), [Pipeline and status widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pipeline-and-status-widgets), and [Management report widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/management-report-widgets). Individual widgets are grouped by component family rather than given separate pages. Detailed principal-report settings, lists, charts, and PDF generation belong to the separate principal-report task. # Dashboard widget catalog Use this page to identify a Dashboard card or chart by its displayed title, find its grouped catalog and component family, and add it to the active tab when editing is available. ## Dashboard widget catalogs A Dashboard widget catalog is a grouped way to identify the cards and charts that can appear on your Dashboard. The Dashboard is a set of role-based tabs, and the gallery contains 109 dashboard components grouped by component family. The three catalogs map sibling widgets to a family rather than giving each widget its own page. | If you need to… | Go to | |---|---| | Understand the role-based Dashboard tabs | [Dashboard overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) | | Find a card or chart by its displayed title | [Find and inspect a widget](#find-and-inspect-a-widget) | | Choose between the three grouped catalogs | [Choose a widget catalog](#choose-a-widget-catalog) | | Add a selected widget to the active tab | [Add a widget and save the tab](#add-a-widget-and-save-the-tab) | | Review sales and backlog widget details | [Sales and backlog widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-and-backlog-widgets) | | Review pipeline and status widget details | [Pipeline and status widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pipeline-and-status-widgets) | | Review management report widget details | [Management report widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/management-report-widgets) | | Change administrative dashboard availability | [Dashboard settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings) | The catalog helps you identify a card or chart by the title displayed for that widget. After you choose the family, use the widget picker to search the title and inspect its description where one is available. ## Before you start The Dashboard library is the widget-selection surface inside the Dashboard. It appears only when the Dashboard is on the custom-dashboard page and has at least one Dashboard tab. The picker is inside the dashboard surface used when the subscription-upgrade surface is not shown. **Prerequisites** - Your role has a Dashboard. - The Dashboard has at least one tab. - You are in edit mode when you need to add, remove, or save widgets. The edit header controls **Widget** and **Save** appear when edit mode is true. If the role has no Dashboard, the page displays `Your role has no dashboard`. ## Open the Dashboard Open the Dashboard to inspect its current cards and charts and, when editing is available, open the widget picker. **Prerequisites** - You are signed in. - Your role has a Dashboard. **Steps** 1. Open the Dashboard by using one of these entry methods: | Entry method | Action | |---|---| | Application menu | Open **Dashboard**. | | Direct address | Open `/dashboard`. | 2. Look for the Dashboard tabs and the edit header. The library surface appears when the Dashboard is on the custom-dashboard page and has at least one tab. If the page does not provide those tabs, use the Dashboard surface that is available to your role. ![The Dashboard surface and its available controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/92c84c4d1016e6185b3a63a6d8c80ec6.png) **Result:** A Dashboard route is open, and you can see whether the role exposes tabs and the edit controls needed for widget work. Choose a catalog next. ## Choose a widget catalog The three catalogs answer different questions about the card or chart you want to find. Choose the catalog whose component-family group matches the business result you need. | If you need to find… | Choose | Component families | |---|---|---| | Sales, bookings, backlog, teams, branches, or due dates | Sales and backlog widgets | Backlog (10), Booking (8), Sales (5), Teams (4), Branch (3), Due-date (3) | | Pipeline stages, accounts, bids, forecasts, orders, or visits | Pipeline and status widgets | Status (3), Account (2), Bid (2), Forecast (2), Order (2), Visit (2) | | Top results, MRM, aging, bonus, or other management views | Management report widgets | Top-N (26), Cash and MRM (23), Aging (1), Bonus (1), Other dashboard widgets (12) | Catalogs group siblings by component family. They do not create a page for each widget. Use the focused catalog page when you need the detailed inventory for a family. ## Find and inspect a widget The widget picker is the list used to identify a card or chart before you select it. Search by title, then use the image, title, and available description to distinguish similar rows. **Prerequisites** - The Dashboard is open in edit mode. - The widget picker is available. **Steps** 1. Open the widget picker from the Dashboard's **Widget** control. 2. Enter a title or keyword in **Keyword to search...**. 3. Select **Search for widget** to filter the widget list by title. 4. Review the matching row's Thumbnail image, title, and description. | What you can inspect | How it helps identify the widget | |---|---| | Thumbnail | Shows the visible image column for the row. | | title | Is searchable and filterable. | | description | Is filterable and appears with the title when present. | | Internal chart identifier | Remains hidden unless export is requested. | 5. Use the picker selection controls as needed: | If you need to… | Select or clear… | |---|---| | Select every widget-picker row | **Select all** | | Return to the unfiltered list | The search field | Use the displayed title as the reader-facing identifier when the full widget list or change-widget flow shows similar rows. **Result:** The widget list is filtered to the title match, and you can inspect the thumbnail, title, and available description before selecting a row. When you have identified the widget, add it to the active tab. ## Add a widget and save the tab Adding a widget changes the selected cards and charts for the active Dashboard tab. Saving commits that arrangement to the Dashboard. **Prerequisites** - The Dashboard is open in edit mode. - You know which catalog and widget title to select. - You know the tab name to use when a new tab is required. **Steps** 1. Select **Widget** to open the add-widget flow. 2. Choose the catalog and component-family group that contains the widget. 3. Search for the widget title in **Keyword to search...**. 4. Select the matching widget row. 5. Enter the tab title in **New Tab** when the add-widget flow requires a new tab. **New Tab** is a required text field. 6. Select **Save** to save the Dashboard changes. 7. Confirm that the selected card or chart appears on the active tab. A successful request displays `Your request was completed successfully`. If the request fails, it displays `An error occurred while processing your request`. Review the selected catalog, widget, and Dashboard conditions before trying again. If **New Tab** is empty, the form displays `This Field Is Required` instead of completing the tab operation. Enter the tab title and save again. **Result:** The selected card or chart is added to the active tab, and a successful save displays `Your request was completed successfully`. If the catalog or widget surface differs, use the availability branches next. ## Handle catalog availability branches The catalog and its widget surfaces depend on the Dashboard state, subscription, available data, and edit mode. Use the visible surface to choose the next action instead of treating every missing widget as a search problem. | If you see… | What it means | What to do | |---|---|---| | An existing widget menu | Widgets exist and edit mode is on. | Use the menu for the selected widget. | | **Remove widget from tab** | The selected widget can enter the removal flow. | Select it to start removal. | | The removal confirmation | The selected widget is about to be excluded from the active tab. | Read `You are about to exclude this widget from this tab. Are you sure?` before confirming the removal. | | A different MRM widget surface | The MRM branch is selected by the widget's chart identity. | Continue only when the subscription, data, and edit conditions for that branch are available. | | Different principal-report columns | The selected columns depend on the runtime tier. | Use the columns available in the current principal report. | MRM widget branches are separately guarded by subscription, data, and edit conditions. A widget can therefore be in the catalog while its dashboard surface is unavailable in the current state. When the catalog does not provide the widget you need, use the troubleshooting table next. ## When the catalog does not show what you need Use the visible picker rows and titles to decide whether the widget is available in the current Dashboard. Search again with a shorter title or keyword when the first search does not identify the widget. | What you see | What to do | |---|---| | No picker | Check that the role has a Dashboard, the page is the custom-dashboard surface, and at least one Dashboard tab exists. | | No widget row | Search again with a shorter title or keyword. | | No description | Use the displayed title and thumbnail to identify the row. | | No visible column caption | Work from the row's displayed title, thumbnail, and available description. | | A role or plan has a different row set | Treat the available rows as role- and plan-dependent. | The message `Please choose one or more principals` belongs to the Principal report. If it appears, continue the Principal report flow and choose one or more principals there. Use the tabs, rows, titles, descriptions, and selection controls that are visible in your Dashboard. Search again with a shorter title or keyword. ## Continue from the catalog The catalog identifies a widget; it is not a page for an individual widget. Each row names its widget and pairs a description where one is available. After identifying the widget, continue to the relevant focused catalog page: [Sales and backlog widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-and-backlog-widgets), [Pipeline and status widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pipeline-and-status-widgets), or [Management report widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/management-report-widgets). Use [Dashboard overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) when you need the broader role-based tab view. Selected chart records can open sales or invoice records in a new tab. # Sales and backlog widgets ## Sales and backlog widgets Sales and backlog widgets are dashboard views that help you compare sales activity, future work, bookings, teams, branches, and due dates without opening each underlying record. A dashboard tab is one view within this workspace; use its widgets to answer a specific reporting question. | If you need to… | Go to | |---|---| | See the grouped widget catalog and the dashboard areas it covers | [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog) | | Review pipeline and status-oriented dashboard views | [Pipeline and status widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pipeline-and-status-widgets) | | Review management-report widget groups | [Management report widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/management-report-widgets) | | Find the dashboard and identify the active tab | Dashboard overview | | Change broader dashboard administration settings | [Dashboard settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings) | | Personalize the wider workspace | Personalizing your workspace | The widget families are: | Family | Use it to read | |---|---| | Backlog widgets | Work that remains grouped by account manager, client, principal, product type, team, variant, market segment, or month | | Booking widgets | Booking totals, comparisons, forecasts, and time-based booking views | | Sales widgets | Sales pipeline, sales-by-year, invoice, and grouped sales activity | | Teams widgets | Team targets, running offers, tendency, and bonus views | | Branch widgets | Branch booking-versus-target and running-offer views | | Due-date widgets | Bid, delivery, and task items for the next or previous ten-day ranges | ## Before you start The Dashboard is the signed-in workspace where your account's tabs and widgets are assembled for daily reporting. **Prerequisites** - Sign in to the application. - Have the dashboard shell available to your account. - Have at least one dashboard tab. - Open a tab that contains one or more widgets when you need to read a widget. The widget catalog appears when at least one dashboard tab exists. Graphs are also subject to the account's active subscription, so the graph surface can differ between accounts. Use the tabs and widgets that are present for your account. ## Find the dashboard widgets **Prerequisites** - Be signed in. - Have a dashboard available. **Steps** 1. Open **Dashboard** from the dashboard navigation. 2. Select the active dashboard tab. 3. Read the widget area shown for that tab. 4. Select the widget-catalog entry point when you need to choose another widget. ![Dashboard navigation, active tab, and widget area](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0204f63edda4fb604281c56ffed4df6d.png) **Result:** The active dashboard tab and its available widgets are on screen, with the widget catalog available. ## Understand the widget catalog The widget catalog is the list of dashboard views you can choose from. The widgets on your active tab are the views currently placed in your dashboard. The catalog presents translated widget names and groups them by reporting subject. The available catalog content includes the following categories: | Catalog category | Examples of the information presented | |---|---| | Order and offer status | Running-order status and firm- or budget-offer status | | Principal and branch activity | Running offers and booking versus target this year | | Sales and teams | Sales pipeline, accounts in the sales pipeline, and teams booking versus target | | Backlog and booking | Backlog and booking summary for this year | | Due-date views | **Next 10 days** and **Last 10 days** | Widget names are translated in their headers. The catalog list is grouped by widget family so that you can start with the business question rather than a technical widget type. Use the names that appear in your catalog. ![Grouped catalog categories and translated widget names](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/b89b84d07f53891bb571134bdb5d91df.png) Choose a widget from the catalog list that appears on screen. ### Add a widget to the active tab Use these steps to add a widget that is not on the active tab. **Prerequisites** - Be in dashboard edit mode. - Have the widget catalog available. **Steps** 1. Select **Widget**. 2. Select the widget you want to add. 3. Select **OK**. 4. Select **Save**. **Result:** The selected widget is added to the active tab and the tab arrangement is saved. The picker can select more than one widget. It excludes widgets that are already on the active tab and provides **Select all** and a keyword search field. ### Backlog widgets Use these widgets to read outstanding sales and commission work. **Backlog** shows sales and commission backlog totals and the average commission percentage. | Widget or view | What it displays | Controls or choices | |---|---|---| | **Backlog** | Sales and commission backlog totals and average commission percentage | Read-only summary | | **Backlog By Teams** | Backlog grouped by team | **Only Sales Jobs**, **Equivalent**, and label visibility | | **Backlog By Vendors** | Backlog grouped by vendor | **Only Sales Jobs**, **Equivalent**, and label visibility | | **Backlog By Clients** | Backlog grouped by client | **Only Sales Jobs**, **Equivalent**, and label visibility | | **Backlog By Product Types** | Backlog grouped by product type | **Only Sales Jobs**, **Equivalent**, and label visibility | | **Backlog By Market Segment** | Backlog grouped by market segment | **Only Sales Jobs**, **Equivalent**, and label visibility | | **Backlog By Account Managers** | Backlog grouped by account manager | **Only Sales Jobs**, **Equivalent**, and label visibility | | **Backlog By Months** | Backlog grouped by month | The same chart and control model as the other backlog breakdowns | | **Backlog Payment Forecast NTM** | Positive invoice amounts by payment month, including invoices marked blind | **Commission Invoices**, **Sales Invoices**, and label visibility; select a chart item to open its invoice | | **Backlog Over The Months** | Backlog by principal and month, separately for each branch | No active chart, export, drill-through, year, or period control is declared | | **PM Backlog** | A monthly table with an initial balance, month totals, object totals, and a total row | **Initial Balance** is displayed; no active filter, export, drill-through, or edit control is declared | The **Backlog** widget can group results by team, vendor, client, product type, market segment, or account manager. When no saved selection exists, it starts with the team dimension. **Only Sales Jobs** and **Equivalent** apply to the selected breakdown. For the breakdown charts, the toolbox provides **Export as excel** and **Download as image**. When a breakdown has more than 10 categories, a vertical chart slider is available, except for **Backlog By Months**. **Backlog By Months** is hosted inside the composite **Backlog** view rather than as a separate dashboard-tab widget. ### Booking widgets Use booking widgets to compare achieved booking with targets and forecasts, or to review booking over time. | Widget or view | What it displays | Controls or choices | |---|---|---| | **Booking This Year** | Achieved booking, forecast, and blind forecast | Read the current-year comparison | | **Booking Summary Today** | Target, achieved booking, achieved percentage of target, forecast, and blind forecast | Read the summary | | **Booking Summary This Month** | Target, achieved booking, achieved percentage of target, forecast, and blind forecast | Read the summary | | Booking versus target | Target and achieved booking, or achievement percentage, by supplier category | **Sort by Booking**, **Sort by Target**, **Sort by Achievement** | | **Booking vs Target by Months** | Monthly booking performance by branch, including target and achieved or forecast values | **Sales Teams** choice and an enabled currency picker | The booking views also include a booking-by-supplier comparison. Use **Sort by Booking**, **Sort by Target**, or **Sort by Achievement** to change its order. The booking-by-months view provides a searchable **Sales Teams** choice and an enabled currency picker. ### Sales widgets Use sales widgets to read pipeline stages, account counts, invoices, annual totals, and sales breakdowns. | Widget or view | What it displays | Controls or choices | |---|---|---| | **Sales Pipeline** | Sales records grouped by pipeline stage | Select a chart record to open its sales record; **Show / hide label** | | **Accounts in Sales Pipeline** | **Clients** and **Vendors** counts | Read the two counts | | **Sales Pipeline in Last 10 Days** | Recent sales-pipeline records grouped by stage | Select a chart record to open its sales record; **Show / hide label** | | **Sales Invoices** | Invoice records grouped by active stage | Select a chart record to open its invoice; **Show / hide label** | | **Sales (Over Last Years)** | Annual sales totals | **Show / hide label** | | **Sales** | Sales grouped by the selected dimension | Group by team, vendor, client, product type, market segment, account manager, or month; **Last 5 years**, **Last 3 years**, **Last year**, **Previous 12 months**, or **Current year**; **Only Sales Jobs** and **Equivalent** | The **Sales** widget provides breakdowns by clients, vendors, teams, account managers, market segments, product types, and months. Each breakdown uses a horizontal stacked bar chart with a category for each returned heading and a series for each returned year. Each standalone sales breakdown provides **Last 5 years**, **Last 3 years**, **Last year**, **Previous 12 months**, and **Current year** period choices, together with **Equivalent** and **Show / hide label**. It also provides **Only Sales Jobs**, except for the vendors breakdown, where that control is not rendered. ## Use widget controls Dashboard controls change the tab layout or the way a booking result is ordered. Edit controls affect the selected tab, so use them only when you intend to change that tab's composition. **Prerequisites** - Have the dashboard tab and its widgets on screen. - Enter dashboard edit mode for tab or widget changes. **Steps** 1. Select the control that matches the change you want to make. | If you want to… | Select | |---|---| | Order a booking result by booking | **Sort by Booking** | | Order a booking result by target | **Sort by Target** | | Order a booking result by achievement | **Sort by Achievement** | | Keep dashboard changes | **Save** | | Open the standard-tab restore action | **Restore Standard Tabs** | | Leave the restore action without restoring tabs | **Cancel** | | Restore the standard tabs | **Restore** | | Open tab management for a new tab | **New Tab** | | Change the selected tab's name | **Rename tab** | | Remove the selected tab | **Delete tab** | The edit surface also provides **Remove widget from tab** from a widget toolbox. Widget controls are available only in edit mode. **Result:** The selected sort or tab-management action is in the dashboard surface, and the active tab remains the place where its widgets are organized. ### Change the backlog grouping Backlog widgets show remaining sales work grouped around the business dimension you are investigating. **Prerequisites** - Have a backlog widget available in the catalog or active tab. - Know whether you are investigating ownership, customer, product, team, market, or time. **Steps** 1. Open the backlog widget family. 2. Choose the backlog grouping that matches your question. | If you need to investigate… | Use this available backlog grouping | |---|---| | Account ownership | Account-manager grouping | | A client | Client grouping | | A principal | Principal grouping | | Product type | Product-type grouping | | A team | Team grouping | | A product variant | Variant grouping | | A market segment | Market-segment grouping | | Monthly backlog | Month grouping | | Expected payment from backlog | Payment forecast for backlog work | | Backlog across the months | Monthly trend grouping | 3. Read the grouping that appears for the selected backlog view. **Result:** The backlog information is organized by the selected account, client, principal, product, team, variant, market-segment, payment-forecast, or month view. ### Change a chart comparison or offer view Booking and sales comparison widgets put totals beside a target, forecast, or earlier period, while offer widgets organize offer work by submission or status. **Prerequisites** - Have the booking, sales, or offer widget family available. - Know whether you need a comparison, a time-series view, submitted offers, or offer status. **Steps** 1. Open the widget family that matches your question. | If you need to compare or review… | Use this available widget family | |---|---| | Booking against target | Booking comparison with target | | Booking against forecast | Booking comparison with forecast | | Booking across earlier years | Booking comparison across earlier years | | Sales across earlier years | Sales comparison across earlier years | | Orders against lost work | Order and lost-work comparison | | Submitted offers | Submitted-offer widget family | | Offer progress by status | Offer-status widget family | 2. Read the comparison or offer information shown by the selected widget. **Result:** The dashboard shows the selected booking comparison, sales comparison, offer view, or target or forecast variant where that widget is available. ### Sort booking results The booking result exposes three labelled sort controls for changing the order used in that result. **Prerequisites** - Have a booking result in view. **Steps** 1. Choose the booking sort you need. | If you want to order by… | Select | |---|---| | Booking | **Sort by Booking** | | Target | **Sort by Target** | | Achievement | **Sort by Achievement** | These sort controls have no required marker. Use the three labelled choices shown in the table when you change the booking order. **Result:** The booking result is ordered by the selected sort label. ### Read chart information Chart information is the value, label, and legend text that lets you interpret the selected widget without opening each underlying record. **Prerequisites** - Have a sales, backlog, booking, team, branch, or due-date widget in view. **Steps** 1. Read the values and labels shown in the widget. | Read | Use it to interpret | |---|---| | Currency amounts | The monetary value | | Percentages | The percentage result | | Counts | The number of records or items | | Chart legends | The value described by each legend | | Offer-status labels | The offer status shown by the widget | ![Chart values with their legends, percentages, counts, and offer-status labels](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/92c84c4d1016e6185b3a63a6d8c80ec6.png) The displayed values and record names belong to the dashboard data available to your account. Use the labels and formats on the current widget rather than treating one account's values as universal. **Result:** The chart's currency amounts, percentages, counts, legends, and offer-status labels are available for interpretation. ## Handle widget availability and branches Widget availability is the set of account, tab, subscription, and edit conditions that determines which dashboard surface you can use. Check these conditions when a widget family or control does not appear. | Condition | What you see | |---|---| | Active subscription permits graphs | The widget catalog can show graph widgets. | | No permitted graph subscription | The graph surface is not available through that subscription guard. | | At least one dashboard tab exists | The widget catalog can mount the tab surface. | | The active tab has one or more widgets | The widget grid appears. | | The dashboard is in edit mode | Edit styling and the widget toolbox action **Remove widget from tab** are available. | | The dashboard is not in edit mode | Widget controls are unavailable. | | A widget type is selected | Its matching widget surface is used. | | An invoice filter is available or unavailable | Commission-invoice and sales-invoice views use the corresponding invoice surface. | | Management-report editing is available | Management-report widgets receive the edit controls for that surface. | Principal-report column choices depend on the account's available report configuration, so use the columns shown in the current report. ![Runtime catalog surface with account-dependent widget availability](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/db53916433e4417a811f1f69b728bb5b.png) ## When a widget or action does not work Use the message on screen to identify whether the issue concerns a duplicate widget, request processing, tab limits, or a duplicate tab name. | What you see | What it means | What to do | |---|---|---| | `You already have this widget in this tab` | The selected widget is already in the tab. | Choose another widget or work with the widget already on the tab. | | `An error occurred while processing your request` | The request did not complete normally. | Review the dashboard state and repeat the action from the relevant dashboard surface. | | `You’ve exceeded the number of tabs` | The dashboard tab limit was reached. | Keep the existing tabs or remove a tab before creating another. | | `You already have a tab with the same name` | Another tab already uses that name. | Rename the new or edited tab with a different name. | Use the widget toolbox for **Remove widget from tab** only when the edit surface is available. Choose widgets from the catalog list that appears on screen. ![Runtime dashboard surface when a widget or tab action needs checking](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c0412e66205334ca9d219c53758132ce.png) ## Out of scope The dashboard request message `Your request was completed successfully` confirms that a request completed. For tab administration, use **Dashboard settings**. ## Continue from the dashboard widgets Continue according to the work you need to do: | Next need | Continue with | |---|---| | Understand the whole dashboard surface | Dashboard overview | | See the complete grouped widget map | [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog) | | Read pipeline and status groups | [Pipeline and status widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pipeline-and-status-widgets) | | Read management-report groups | [Management report widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/management-report-widgets) | | Personalize the workspace beyond dashboard widgets | Personalizing your workspace | | Administer dashboard availability | [Dashboard settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings) | # Pipeline and status widgets ## Pipeline and status widgets A dashboard widget is a grouped chart or readout that lets you review sales and operational results without opening each record. The dashboard brings together pipeline stages, offer and order statuses, account counts, bids due around the current period, forecast comparisons, backlog payment views, and visits. | If you need to… | Go to | |---|---| | Reach the dashboard and orient yourself | [Dashboard overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) | | Find or select a dashboard widget | Dashboard widget catalog | | Review sales and backlog results | Sales and backlog widgets | | Compare bookings, targets, forecasts, or visits | Management-report widgets | | Read Principal report columns | Principal report | | Continue with offer status work | [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers) | | Continue with order status work | [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) | ## Before you start The dashboard shows the widget set selected for the current dashboard page. A widget appears when the dashboard has selected widgets and a usable layout is available. Widget actions also depend on the subscription feature check, so the choices shown to one company can differ from those shown to another. **Prerequisites** - You can open the Home dashboard. - Your dashboard page has at least one selected widget. - Your company subscription includes the widget action you want to use. - The dashboard has its display layout available. The team and forecast choices depend on values the dashboard sets. The fixed team choice is **All teams**; other team names come from the teams available to the current dashboard. One forecast choice is **Value Of All Firm Inquiries And Offers Multiplied By Its Order Chance**. Another choice applies a minimum order-chance threshold. The dashboard sets the threshold rather than you entering it. The report determines which columns are available when it runs. > **Note:** A dashboard widget can be available as a chart or readout without presenting a > labelled entry field. Use the heading and visible choices to identify the result you are > reading. ## Find a widget on the dashboard Home is the dashboard surface for the grouped widgets. **Prerequisites** - You are signed in. - You know which dashboard page you want to review. **Steps** 1. Open Home. 2. Open the dashboard page that contains the widget group. 3. Review the headings currently shown on the dashboard. 4. Select the widget whose heading or readout matches the result you need. ![Dashboard headings and grouped pipeline, account, forecast, and status readouts](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d15bcedc0e5593f6b3ab04925f879aad.png) The currently displayed group includes `Sales Pipeline`, `Accounts in Sales Pipeline`, `Teams Booking vs. Target`, `Teams Running Offer`, `Branch Tendency to Target`, `Principals Tendency to Target`, `Branch Booking vs. Target This Year`, `Principals Booking vs. Target This Year`, `Branch Running Offers`, and `Principals Running Offers`. **Result:** The selected dashboard page is open, and you can identify the grouped widget by its visible heading or readout. Continue by reading the grouped result. ## Understand the grouped results A pipeline widget groups sales work by where it sits in the sales flow. A status widget groups offers or orders by their current status. Account, bid, forecast, and visit widgets add the customer, deadline, comparison, and activity views around that work. | Group | What to look for | |---|---| | Sales pipeline | `Potentials`, `Inquiries`, `Budget offers`, `Firm offers`, and `Orders` | | Accounts | `Clients` and account results connected to the sales pipeline or running offers | | Offer status | `Firm Offers` and `Budget Offers`, grouped by their status views | | Order status | Running-order results grouped by status | | Bids | Bids due in the next period or due in the previous period | | Forecast and target | Team, branch, principal, yearly target, and backlog-payment comparisons | | Visits | Visits in the previous period or in the next period | The scoped dashboard surfaces are `Sales pipeline`, `Accounts in sales pipeline`, `Accounts running offers`, `Statuses of firm offers`, `Statuses of budget offers`, `Statuses of running orders`, `Bids due in the next period`, `Bids due in the previous period`, `Sales pipeline in the previous period`, `Visits in the previous period`, and `Visits in the next period`. Each surface is selected by its chart type. The dashboard also uses separate conditions for booking versus target versus forecast by month, booking versus target versus forecast by variant, forecast versus target for the year, and forecast backlog payment. The visible comparison headings explain the level of the result: teams, branches, or principals. The readout `Backlog` belongs to the forecast backlog payment view. `Including Forecast` and `Equivalent` are visible choices in forecast and comparison widgets, not pipeline stages. When you need to change the view, open the relevant choice in the widget. ### Status widgets Status widgets are subscription-gated. When the required subscription is unavailable, the widget shows the subscription-upgrade surface instead of its chart. | Widget | What it provides | Available controls or interaction | |---|---|---| | **Statuses of Jobs in Offer Stage (Firm Offers)** | **Jobs (Count)** and **Jobs (Value)** bar charts grouped by status. | **Show / hide label**, Excel export, and PNG download. | | **Statuses of Jobs in Offer Stage (Budget Offers)** | Count and value bar charts grouped by status. | **Show / hide label**, Excel export, and PNG download. | | **Statuses of Running Orders** | Count and value bar charts grouped by status. | **Show / hide label**, Excel export, and PNG download. | | **Bank Guarantees** | A chart for each returned bank, showing facility work by category. | Select a non-remaining chart category to open its L/G record. Each chart also has **Show / hide label**, Excel export, and PNG download. | | **Cash Cover Status** | One pie chart per returned bank and its total cash cover. | **Show / hide label**, Excel export, and PNG download. | | **PM Current Status** | Project-management status amounts and counts. | Choose **By agreed margin**, **By budget**, or **By order price**. | ### Pipeline, account, bid, forecast, order, and visit widgets | Group | What to read | |---|---| | Sales pipeline | **Sales Pipeline** is a stage chart with **Show / hide label**. **Accounts in Sales Pipeline** shows **Clients** and **Vendors** counts. **Sales Pipeline in Last 10 Days** provides recent stage work. | | Sales invoices | **Sales Invoices** groups returned invoices by stage and provides **Show / hide label**. | | Backlog | **Backlog** shows sales backlog, commission backlog, and average commission backlog percentage. It is read-only. | | Backlog payment forecast | **Backlog Payment Forecast NTM** provides **Commission Invoices** and **Sales Invoices** choices, chart labels, Excel export, and PNG download. Selecting a chart item opens its invoice in a new browser tab. | | Sales breakdown | **Sales** groups results by teams, vendors, clients, product types, market segments, account managers, or months. | The subscription-upgrade surface can replace the Sales Pipeline, Accounts in Sales Pipeline, Sales Pipeline in Last 10 Days, Sales Invoices, and Sales widgets when their features are unavailable. **Prerequisites** - A dashboard page with the status widget or grouped result you need is open. - The relevant widget is available in your company's subscription. **Steps** 1. Identify the widget by its visible title. 2. Read the chart, count, value, or status grouping that answers your question. 3. Use the widget's available control when you need a different view or an export. **Result:** You have reviewed the selected dashboard result without changing dashboard configuration. ## Choose a bid, forecast, or visit view Use these steps when the widget offers a team, forecast, comparison, invoice, or sorting choice. These choices change the view you are reading; they do not save a dashboard configuration. **Prerequisites** - A dashboard page with the relevant widget is open. - The widget displays the choice you want to review. **Steps** 1. Open the team, forecast rule, comparison, invoice, or sorting choice in the relevant widget. 2. Select the option that matches the view you need. | If you need to… | Select | |---|---| | Review every team together | **All teams** | | Review one available team | An available team name | | Multiply all firm inquiries and offers by their order chance | **Value Of All Firm Inquiries And Offers Multiplied By Its Order Chance** | | Use the minimum order-chance threshold | The minimum order-chance threshold option | | Limit the booking view to your company | **Only My Company** | | Use the equivalent comparison | **Equivalent** | | Include forecast values | **Including Forecast** | | Review commission invoices in the backlog-payment view | **Commission Invoices** | | Review sales invoices in the backlog-payment view | **Sales Invoices** | | Sort a booking-versus-target result by booking | **Sort by Booking** | | Sort a booking-versus-target result by target | **Sort by Target** | | Sort a booking-versus-target result by achievement | **Sort by Achievement** | ![Forecast, comparison, and sorting choices on the dashboard](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d15bcedc0e5593f6b3ab04925f879aad.png) **Result:** The widget shows the selected team, forecast, comparison, invoice, or sorting view. If the widget or result is missing, use the availability table. ## When a widget or result is not available Availability has several causes. Check the visible dashboard conditions before treating a different widget set as a data problem. | What you see | What it means | What to do | |---|---|---| | A widget is not present | The dashboard has no selected widget for that chart type, or its display layout is unavailable. | Review the current dashboard page and its available widget choices. | | A widget action is absent | The subscription feature check does not make that action available. | Ask the person responsible for your company subscription to review the feature. | | A team choice contains only **All teams** | No additional team record is available in the current dashboard view. | Read the all-team result or ask for the relevant team setup. | | A forecast rule shows a percentage you did not enter | The dashboard sets the percentage. | Use the displayed rule that matches the intended order-chance threshold. | | You need to sort a result | The named sorting controls are available for the booking-versus-target view. | Select **Sort by Booking**, **Sort by Target**, or **Sort by Achievement**. | | Five visible controls have no text label | The current dashboard includes unlabeled controls. | Use the three named sorting controls when sorting is the task. | | **Principal report** columns differ | **Principal report** column choices are set when the report runs. | Review the columns available in the **Principal report**. | ## Out of scope The parent dashboard page is **Dashboard** (Home). These messages are not status-widget results; use the dashboard availability guidance when the dashboard itself does not load or refresh. | Owning page | Message | |---|---| | **Dashboard** (Home) | `Your request was completed successfully` | | **Dashboard** (Home) | `An error occurred while processing your request` | ## What to read next Use [Dashboard overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) for the broader dashboard orientation. Use Dashboard widget catalog for widget discovery and selection when that page is available. Use Sales and backlog widgets for detailed sales and backlog results, Management-report widgets for bid, forecast, and visit reporting, and Principal report for its column choices. For record-level follow-up, continue with [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers) for offer status work or [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) for order status work. # Management report widgets Use this page to review grouped dashboard widgets for ranking, cash, management reporting, aging, bonus, and related results, and to manage the widgets shown on a dashboard tab. ## Management report widgets Management report widgets are dashboard views that collect management results into grouped catalog rows. Use them for a ranking, cash or finance measure, management-report measure, aging result, bonus result, or another dashboard result. | If you need to… | Go to | | --- | --- | | Understand the dashboard and its tabs | [Dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) | | Find the available widget families | [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog) | | Review sales or backlog results | [Sales and backlog widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-and-backlog-widgets) | | Review ranking, cash, MRM, aging, bonus, or other management results | This page | | Review principal-report columns | [Principal report](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/principal-report) | | Configure dashboard availability | [Dashboard settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings) | The catalog groups rows into Top-N widgets, Cash and MRM widgets, Aging widgets, Bonus widgets, and Other dashboard widgets. Each widget has a title and, where available, a description. ## Prerequisites Before reviewing or changing widgets, sign in and open the dashboard. The dashboard route is `/dashboard`. Your saved role dashboard supplies the tabs and selected widgets; the active tab then displays its selected widget grid. The active tab and selected widget ID determine which widget appears. | Condition | What it controls | | --- | --- | | Signed-in account on `/dashboard` | Access to the dashboard surface | | Saved role dashboard | Tabs and selected widgets shown | | Active tab and selected widget ID | The widget shown for that tab | | MRM subscription | Whether MRM content or the subscription-upgrade surface appears | | `allowedtoEdit` and `allowedtoEnableEdting` | Edit permissions passed to widget components | | Current or immediately preceding month plus edit permission | Which financial periods can be edited | | Saved principal-report selections | The report columns built for the principal-report surface | These conditions are account-specific. Tab names, selected widgets, subscription access, and the active role dashboard do not form one universal layout for every account. ## Find and open the widget catalog The dashboard is the starting surface for the widget catalog. Use the dashboard header when the dashboard is in edit mode; the header exposes **Widget** and **Save** there. **Prerequisites** - You are signed in. - You have opened the dashboard. **Steps** 1. Open `/dashboard`. 2. Identify the dashboard surface by its visible **Dashboard** heading or tab label. 3. Select the active dashboard tab. 4. Enter dashboard edit mode until the header exposes **Widget**. 5. Select **Widget** to open the catalog when that control is available. ![Dashboard headings, tabs, and the management widget entry point](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/92c84c4d1016e6185b3a63a6d8c80ec6.png) **Result:** The dashboard is open on the selected tab. When the header exposes **Widget**, selecting it opens the widget catalog. Read the catalog groups next. ## Understand the catalog and report surface The catalog is a grouped view of dashboard choices. The report surface is a widget's own set of measures and controls. Read the group first, then use the controls visible in the chosen widget. | Surface | Reader-facing choices or readouts | | --- | --- | | Catalog groups | Ranking; cash and finance; MRM; aging; bonus; remaining dashboard widgets | | Report | Required text control | | **Over** | **Clients**; **Projects**; **Market Segments** | | Sorting | **Sort by Booking**; **Sort by Target**; **Sort by Achievement** | | MRM labels and readouts | **Taxation**; **Bank**; **Total**; **Achieved**; **Budget**; **Cash**; **Receivables**; **Payables**; **L/Gs**; **Warehouse**; **Last Modified** | The principal-report columns come from saved selections for the account, so work from the headers that appear on that report rather than assuming one fixed column list. **Add currency** is not an active control in the account widgets. Cash position, project-management backlog, project-management shipment, and cash-flow components are not active selectable registry rows in the catalog. ## Review Top-N widgets Top-N widgets rank management results by a chosen business dimension. Choose the row that matches the result you need, then use the available sort or variant choices to read the ranking. | Ranking question | Catalog rows | | --- | --- | | Booking by party or product | **Booking By Vendors**; **Booking By Clients**; **Booking By Teams**; **Booking By Market Segments**; **Booking By Account Managers**; **Booking By Product Types** | | Sales by party or product | **Sales By Clients**; **Sales By Vendors**; **Sales By Teams**; **Sales By Account Managers**; **Sales By Market Segments**; **Sales By Product Types** | | Offers by party or group | **Offers By Clients**; **Offers By Market Segments**; **Offers By Teams**; **Offers By Vendors**; **Offers** | | Variant | **Booking**; **Backlog**; **Sales** | | Account hit rate | **Top Accounts By Hit Rate** | **Prerequisites** - You have opened the dashboard and identified the active tab. - The ranking widget you need is available on that tab or in the widget catalog. **Steps** 1. Select the ranking row that matches the result you need. 2. Select **Booking**, **Backlog**, or **Sales** when the widget offers a variant choice. 3. Select **Sort by Booking**, **Sort by Target**, or **Sort by Achievement** when the widget offers a sorting choice. 4. Read the visible result headings, such as **Clients**, **Principals**, **Teams Booking vs. Target**, **Teams Running Offer**, **Branch Booking vs. Target This Year**, **Principals Booking vs. Target This Year**, **Branch Running Offers**, and **Principals Running Offers**. **Result:** The selected Top-N widget presents its ranking using the chosen variant, sorting view, and visible result headings. For cash, finance, aging, or bonus measures, continue with the MRM widgets. ## Review MRM widgets Management reporting (MRM) widgets bring cash, finance, booking, inventory, profitability, project-management, aging, and bonus measures into the dashboard. | Family | Widget rows | | --- | --- | | Cash and finance | **Cash Cover Status**; **Receivables**; **Account Receivable**; **Account Payable**; **Cash Position**; **Cash Position (LTM)**; **Cash Position For Finance (LTM)**; **Cash Position For Sales (LTM)**; **Cash Position For Inventory (LTM)**; **Cash Flow**; **Cash Flow For Finance**; **Cash Flow For Sales**; **Outstanding Commission Payment**; **Sales Invoices**; **Commission Invoices**; **Principals Outstanding** | | MRM | **Booking By Product Types**; **Booking By Teams**; **Booking By Principal**; **Booking By Account Manager**; **Backlog By Product Types**; **LGs By Bank**; **Inventory Stock By Supplier**; **Inventory Scrap**; **Sales**; **COGS**; **Depreciation**; **SG & A**; **EBIT**; **Currency Rate To Local Currency**; **Net Profit**; **Gross Margin**; **PM Backlog**; **PM Shipment** | | Aging | **Aging (Receivables)** | | Bonus | **Bonus Distribution**; **Teams Booking vs. Target** | | MRM controls | **Bank**; **Search for supplier**; **Days**; **Weeks**; **Months**; **Apply** | | MRM readouts | **Cash**; **Receivables**; **Payables**; **L/Gs**; **Warehouse**; **Working capital**; **Last Modified** | Financial editing is limited to the current or immediately preceding month when the account also has edit permission. **Prerequisites** - The required MRM subscription is available to the account. - The selected tab contains the MRM widget you need. - You have edit permission when the task requires financial editing. **Steps** 1. Select the MRM family that matches the result you need. 2. Select the widget row for the cash, finance, MRM, aging, or bonus result. 3. Select the visible period, supplier, bank, or delay choice required by that widget. 4. Select **Apply** when the widget provides that control. 5. Read the visible measure, grid, or chart using its labels, such as **Cash**, **Receivables**, **Payables**, **L/Gs**, **Warehouse**, or **Working capital**. **Result:** The selected MRM widget displays the available result for the selected account data, period, and visible filters. To change the dashboard arrangement, continue with widget management. ### Read detailed management measures The **Total Sales** widget breaks sales information into taxable, manual, group, target, achieved, commission, cumulative, and percentage measures. The forecast cash-flow widget shows expenses, overdue receivables, cash flow, cash, receivables, payables, L/Gs, warehouse, working capital, and last-modified information. **Steps** 1. Open the **Total Sales** widget when you need sales measures. 2. Read the visible sales measures, such as **Target**, **Achieved**, **Total Sales**, **Cumulative Sales**, and **Percentage of achieved Total Sales**. 3. Open the forecast cash-flow widget when you need forecast measures. 4. Enter a number for the delay period. 5. Select **Days**, **Weeks**, or **Months** for the delay period. 6. Select **Apply**. **Result:** The selected widget shows its available sales or forecast cash-flow measures using the period and delay choices that it exposes. ## Choose and manage widgets Dashboard edit mode lets you add widgets to the active tab and save the tab arrangement. It also declares tab actions for creating, renaming, and deleting tabs. | Action | Control or condition | | --- | --- | | Open the picker | **Widget** in dashboard edit mode | | Search | **Search for widget** or **Keyword to search...** | | Select all listed widgets | **Select all** | | Confirm selection | **OK** | | Persist the arrangement | **Save** | | Remove a widget | **Remove widget from tab**, subject to active-tab, subscription, and tab-type conditions | | Manage tabs | **New Tab**, **Rename tab**, and **Delete tab** | **Prerequisites** - You are on the dashboard's active tab. - You have dashboard edit permission. **Steps** 1. Select **Widget** in dashboard edit mode. 2. Enter a search term in **Search for widget** or **Keyword to search...**. 3. Choose how to add and save the widgets: | If you need to… | Select | | --- | --- | | Add specific widgets | The widgets, then **OK**, then **Save** | | Add every widget currently listed | **Select all**, then **OK**, then **Save** | 4. In edit mode, drag a widget to reposition it or resize it when the dashboard exposes those editing actions. 5. Select **Save** after arranging the widgets. **Result:** The selected widgets are added to the active tab, and **Save** persists the tab arrangement. The picker excludes widgets already selected on the active tab. If a widget or report surface is unavailable, use the matching branch below. ## Handle widget availability and report branches Widget availability follows the saved dashboard, active tab, subscription, permissions, and account data. Use the branch that matches what you see. | What changes | What you see | | --- | --- | | MRM subscription is unavailable | A subscription-upgrade surface replaces MRM content | | No role dashboard is configured | **Your role has no dashboard** and **Kindly, Contact your administrator to define a dashboard** | | Active tab or selected widget ID changes | Only the matching widget case appears | | Saved role dashboard changes | The tabs and selected widgets change | | `allowedtoEdit` or `allowedtoEnableEdting` changes | Edit permissions passed to widgets change | | Principal-report selections change | The visible report columns change | | Account widgets reach the currency branch | **Add currency** remains inactive because the branch is guarded by `false&&editMode` | The catalog contains the MRM component family, but **Cash Position**, **PM Backlog**, **PM Shipment**, and cash-flow components are not active selectable registry rows. The catalog also does not promise one widget order or one complete widget presence for every saved dashboard. ## When widget selection fails Use the message text to distinguish a completed request, a general processing error, a validation choice, or an already-selected widget. | Message | Meaning or next action | | --- | --- | | `Your request was completed successfully` | The request completed successfully. | | `An error occurred while processing your request` | The request encountered a processing error. | | `Please choose one or more principals` | Select one or more principals before continuing. | | `You already have this widget in this tab` | The widget is already selected on the active tab. | | `Widget Added` | The widget was added. | If the dashboard does not expose **Widget**, continue with the active-tab view that is visible. Principal-report columns, subscription access, and saved widget configuration vary with account data and setup. Icon-only controls may require the visible screen rather than a label. ## Related dashboard work Use the owning page for details that belong to another dashboard surface. | Topic | Owning page or boundary | | --- | --- | | Principal-report column details | Principal report | | Overall dashboard orientation | Dashboard | | Complete widget-family catalog mapping | Dashboard widget catalog | | Sales and backlog widget details | Sales and backlog widgets | ## Out of scope Use the owning page for details that belong to another dashboard surface. | Topic | Owning page or boundary | | --- | --- | | Principal-report column details | Principal report | | Overall dashboard orientation | Dashboard | | Complete widget-family catalog mapping | Dashboard widget catalog | | Sales and backlog widget details | Sales and backlog widgets | | Dashboard lifecycle or state transition | No dashboard lifecycle is defined for this page | | Universal account-specific widget inventory | Not a single account-independent list | | Widget deletion | The page does not include a widget-deletion procedure | | `Widget Deleted` message | The page does not cover the deletion action | | Passing live test case | No page-specific passing live test case is included here | ## What to do next Choose the next page by the question you need to answer. | If you need to… | Open | | --- | --- | | Orient yourself on the dashboard | [Dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) | | Discover the complete widget families | [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog) | | Review sales or backlog widgets | [Sales and backlog widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-and-backlog-widgets) | | Review pipeline, status, account, bid, forecast, order, or visit widgets | [Pipeline and status widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pipeline-and-status-widgets) | | Review principal-report columns | [Principal report](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/principal-report) | | Change administrative dashboard availability | [Dashboard settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings) | # My Desk workspace Use My Desk to narrow your daily work, choose a list or work view, and hand a linked record to the page that owns it. ## Before you start My Desk is a personal, filterable daily workspace. It brings together lists, graphs, tasks, activities, and calendar appointments; it is not a sales-job record. Its scope can include a client, vendor, project, sales-responsible person, contact, and team. A scope is the client, vendor, project, sales-responsible person, contact, or team that limits the work shown in the workspace. When you open a linked record, My Desk shows that record for inspection and hands edits to the record's owning page. The standard workspace is titled **My Desk**. Principal users see **Principal Desk** and choose a client for the workspace. A principal user is a user who works from **Principal Desk** and chooses a client scope. | If you need to… | Go to | | --- | --- | | Narrow the records in your workspace | [Focus work and choose a list group](#focus-work-and-choose-a-list-group) | | Choose a list, graph, task, activity, or calendar view | [Choose a work mode](#choose-a-work-mode) | | Add a task or activity | [Add a task or activity from My Desk](#add-a-task-or-activity-from-my-desk) | | Complete or delete a task | [Act on a task row](#act-on-a-task-row) | | Continue work on a linked record | [Open and hand off a linked record](#open-and-hand-off-a-linked-record) | | Understand principal-user or subscription differences | [Handle principal-user and subscription variations](#handle-principal-user-and-subscription-variations) | | Find the meaning of an opened-panel message | [Messages from linked panels](#messages-from-linked-panels) | | Work with standalone tasks | My Desk tasks | | Record standalone activities | My Desk activities | | Work with dashboard graphs | [Dashboard overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) | | Create a task | [Create a task](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-task) | | Create an activity | [Create an activity](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-activity) | | Continue a sales job, invoice, principal invoice, L/G, account, project, contact, user, or team | Its owning record page | ## Prerequisites My Desk requires the My Desk module subscription. If the module is not included in your plan, the workspace content is replaced by a subscription page with **Upgrade needed**, the message `The feature you are trying to use is not included in your current plan. Please upgrade your plan.`, and **Upgrade now** and **Back** actions. Principal users use **Principal Desk** with a searchable client field. Their personal **Tasks**, **Activities**, and **Calendar** tabs are disabled. **Calendar** also requires the Calendar subscription. > **Note:** My Desk is a hand-off workspace. Use the owning page when you need the full > record form or the form's messages. ## Focus work and choose a list group Use the lists area to review current or archived work within the scope you select. **Prerequisites** - You have access to the My Desk workspace. - You know which client, vendor, project, sales-responsible person, contact, or team should define your work scope. **Steps** 1. Select **Filter** to reveal the filter block. 2. Select the scope chips that match the work you want to review: **Client**, **Vendor**, **Project**, **Sales Responsible**, **Contact**, or **Team**. 3. On a selected scope chip, select its remove control to remove that scope from the workspace. 4. Beside the scope chips, select the remove-all control to clear every selected scope and return to an unscoped workspace. 5. Select the **Lists** tab. 6. Select **Current** to review current work. 7. Select **Archived** to review archived work. ![Current work groups and their list contents](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/4d569dab76496e847e886d7a49b5ba0a.png) The selected scope filters the list data, and the selected list group is saved for the workspace. Loading placeholders appear while the list data is loading. **Result:** The Lists view shows the selected **Current** or **Archived** group for your chosen scope, or its loading placeholders while that data is being retrieved. With the list group selected, continue to [Choose a work mode](#choose-a-work-mode). ## Prerequisites The same filter context is passed to the list, graph, task, activity, and calendar work components. Principal-user status and feature subscriptions determine which tabs can be selected. The selected main tab is saved when a saved choice is available. Do not treat a disabled tab as missing data. It indicates a user-context or subscription condition. ## Choose a work mode Each work mode answers a different daily question: **Graphs** gives a non-editable dashboard view, **Tasks** gives the task list, **Activities** gives the activity list, and **Calendar** gives appointment work in a calendar. A graph data point or calendar appointment can take you to related work. **Prerequisites** - My Desk is available. - The required feature subscription is included for the work mode you need. - You are not a principal user when selecting **Tasks**, **Activities**, or **Calendar**. **Steps** 1. Select the mode that matches your work: | If you need to… | Select | What opens | | --- | --- | --- | | Review dashboard measures | **Graphs** | A non-editable dashboard container | | Review or add tasks | **Tasks** | The task list | | Review or add activities | **Activities** | The activity list | | Review appointments by date | **Calendar** | The calendar | Selecting **Tasks**, **Activities**, or **Calendar** is unavailable for principal users. 2. If you select **Graphs**, review the dashboard surface. ![Graphs with dashboard measures and linked work areas](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/aa5993093fe8b93e4eccf25f2c4d6a8c.png) Select a graph data point when you need to continue into the related work. 3. If you select **Tasks**, review the task list. ![Task work mode with its list columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/143dd75b9e004888d114161bd83a2f89.png) 4. If you select **Activities**, review the activity list. ![Activity work mode and its activity list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2f2c14676b9d02c9355c17aae1e46e69.png) 5. If you select **Calendar**, review the calendar. 6. In Calendar, use the control in the table that matches your next action: | If you need to… | Use | | --- | --- | | Choose calendar data | `Filter data` | | Apply the calendar filter | **Submit** | | Return to today's date | **Today** | | Change to a timeline view | **Timeline** | **Timeline** is unavailable in Month view. 7. Select a calendar appointment to open its related work. The calendar can show **Day** and **Month** views, with `Sun`, `Mon`, `Tue`, `Wed`, `Thu`, `Fri`, and `Sat` columns. In Month view, **Timeline** is unavailable. **Result:** The selected work mode is displayed. The standard-user workspace shows **Graphs**, **Tasks**, **Activities**, and **Calendar** when those features are available; principal users see the three personal tabs disabled. When you need to create a task or activity, continue to [Add a task or activity from My Desk](#add-a-task-or-activity-from-my-desk). ## Prerequisites The **Tasks** and **Activities** tabs are subscription-gated. Principal users cannot use those tabs. When either tab is active for an eligible user, the add icon in its tab header opens the corresponding creation entry point. In the **Activities** tab, find the add icon in the tab header; it opens the activity type menu. The detailed forms belong to [Create a task](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-task) and [Create an activity](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-activity), not to the My Desk workspace. ## Add a task or activity from My Desk My Desk provides the shared entry point; the owning form supplies the fields and save rules. **Prerequisites** - The **Tasks** or **Activities** tab is available and active. - You know whether you are creating a task, a Visit, a Meeting, or a Call. **Steps** Use this table to choose the activity entry point before following the numbered steps: | If you need to create | When this applies | Action | | --- | --- | --- | | A standalone task | If **Tasks** is active | In the **Tasks** tab header, select the add icon to open the Task popup. | | Open the activity menu | If **Activities** is active | In the **Activities** tab header, select the add icon. | | Choose an activity type | If the activity menu is open | Select **Visit**, **Meeting**, or **Call**. | 1. If **Tasks** is active, select the add icon in the **Tasks** tab header to open the Task popup. 2. If **Activities** is active, select the add icon in the **Activities** tab header to open the activity type menu. 3. If **Activities** is active, select **Visit**, **Meeting**, or **Call** from the activity type menu. ![Activity type menu with Visit, Meeting, and Call](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2f2c14676b9d02c9355c17aae1e46e69.png) 4. Complete the form on its owning page. 5. Select **Save** in the form. 6. If you do not want to save, select the control at the right side of the popup header to close the popup without saving. **Save** validates the form and refreshes the relevant My Desk list after a successful save. Use [Create a task](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-task) for task fields and [Create an activity](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-activity) for activity fields. **Result:** The selected task or activity form is open, or the relevant list is refreshed after a successful save. After the form opens, continue with [Add a task](#add-a-task) or [Add an activity](#add-an-activity). ### Add a task The task popup embeds the new-task form. Use it when you need a standalone task visible in the My Desk task list. **Prerequisites** - The Task popup is open from the active **Tasks** tab. - You have the task priority, purpose, start date, and due date. **Steps** 1. In the task form, complete the required **Priority** field. 2. Complete the required **Task Purpose** field. 3. Complete the required **Start Date** field. 4. Complete the required **Due Date** field. 5. Keep **Due Date** on or after **Start Date**. 6. Review the dates: a new task starts with today's date and tomorrow's date as the date defaults. 7. Select **Save**. The task form validates the required fields and date order. A successful save refreshes the task list. **Result:** The saved task is available in the My Desk task list. Continue with [Act on a task row](#act-on-a-task-row) when you need to open, complete, un-complete, or delete a task. ### Prerequisites Open the menu at the right end of a task row to see its available actions. Only the task owner can change task completion. Completing or deleting a task requires confirmation. Use the action that matches the required result: | If you need to | Use the row menu action | | --- | --- | | Open the task page | **Open** | | Change the completion state | **Complete** or **Consider As Not Completed** | | Remove the task | **Delete** | ### Act on a task row Use the menu at the right end of a task row to open the task, change its completion state, or delete it. **Prerequisites** - A task row is visible in the task list. - You own the task when you need to change its completion state. **Steps** 1. Open the menu at the right end of the task row. 2. If you need the task page, select **Open** to hand the task to its owning task page. 3. If you need to mark the task complete, select **Complete**. 4. If the completion confirmation appears, select **Yes** to confirm or **No** to cancel. 5. If you need to remove the completion state, select **Consider As Not Completed**. 6. If the un-completion confirmation appears, select **Yes** to confirm or **No** to cancel. 7. If you need to remove the task, select **Delete**. 8. If the deletion confirmation appears, select **Yes** to delete the task, or **No** to cancel. Completion refreshes the grid. If deletion is refused because the task is related to saved data, the message is `This record is related to saved data and cannot be deleted`. **Result:** The task opens, changes completion and refreshes the grid, is deleted with its success result, or remains unchanged after **No** or a refusal. ### My Desk task messages The task row owns these messages: | When you select | Message | | --- | --- | | **Complete** | `Are you sure that you want to mark this task as completed?` | | **Consider As Not Completed** | `Are you sure that you want to un-complete this task?` | | **Delete** | `Are you sure you want to delete this task?` | | After a successful deletion | `Task deleted successfully` | **Result:** The task opens, changes completion and refreshes the grid, is deleted with its success result, or remains unchanged after **No** or a refusal. Continue with [Add an activity](#add-an-activity) when the next item is an activity rather than a task. ### Add an activity An activity records a Visit, Meeting, or Call and then hands its details to the activity page that owns the form. **Prerequisites** - The **Activities** tab is available and active. - You know whether the activity is a Visit, Meeting, or Call. **Steps** 1. If **Activities** is active, select the add icon in the **Activities** tab header to open the activity type menu. 2. Select **Visit**, **Meeting**, or **Call** from the activity type menu. 3. Complete the type-specific activity fields. 4. For a Visit, complete the required date or title fields shown by the Visit form. 5. For a Meeting, complete **Meeting Purpose**, **Priority**, **Location**, **Tags**, **Participant**, **Start Date**, **End Date**, **Prepared By**, and **Signature** as applicable; **Start Date** and **End Date** carry required markers. 6. For a Call, complete the fields shown by the Call form. 7. Select **Save** or **Save and Close** in the activity form. The activity save finalizes the activity and displays its success or error result. An activity request can show `Your request was completed successfully`, `Forbidden characters detected. Please remove them and try again.`, or `Action not allowed`. A creation form can also show `This action is only allowed if you belong to that branch`, `One topic and at least one note is required`, or `There is no topic to print`. **Result:** The selected activity form is saved and its result is displayed, or the form remains open with its message. Continue with [Open and hand off a linked record](#open-and-hand-off-a-linked-record) when you need to inspect related work from a list or graph. ## Prerequisites A linked record must come from a My Desk list or a supported graph widget. My Desk opens the record in a dynamically titled tab and keeps it in view mode. A standard user can open the record's normal page when the record supplies a normal link. ## Open and hand off a linked record Use the opened-record view to inspect supported sales jobs, invoices, principal invoices, L/Gs, clients or principals, projects, contacts, users, and teams. Continue to the owning page when you need the record's normal form. **Prerequisites** - A supported linked record is visible in a list or graph. - The record supplies a normal link when you need to edit it. **Steps** 1. Select the linked record in the list or graph. 2. Select the dynamically titled opened-record tab to inspect the record in My Desk view mode. 3. For a standard user, select the control at the right end of the opened-record tab in the tab bar to open the record's normal page. 4. For a principal user, read the opened record in view mode; no editing control is available. 5. At the right end of the opened-record tab in the tab bar, select the control that closes the tab and returns you to **Lists**. The standard-user notice says `To make changes, click the pen icon on the tab bar.` The principal-user notice says `View Mode Only`. **Result:** The record is either open in My Desk view mode, open on its owning page, or closed with **Lists** restored and the opened-record tab reset. Continue with [Handle principal-user and subscription variations](#handle-principal-user-and-subscription-variations) when the workspace title, tab state, or subscription message differs from the standard view. ## Prerequisites Your user type and subscriptions determine which My Desk surfaces are present or actionable. Standard users see the personal workspace branches. Principal users see the Principal Desk branch, disabled personal tabs, and a different opened-record view-mode path. My Desk and Calendar are subscription-gated. ## Handle principal-user and subscription variations Use the workspace title, tab state, and subscription message to identify the branch you are in before selecting a work mode. | What you see | What it means | What you can use | | --- | --- | --- | | **My Desk** | Standard-user workspace | Personal lists, filters, and eligible work tabs | | **Principal Desk** and a searchable client field | Principal-user workspace | Client-scoped principal work | | Disabled **Tasks**, **Activities**, or **Calendar** | Principal-user restriction | **Graphs** remains available | | **Upgrade needed** | My Desk or a selected feature is not in the plan | **Upgrade now** or **Back** | **Steps** 1. Read the workspace title to distinguish **My Desk** from **Principal Desk**. 2. If you are on **Principal Desk**, select a client in the searchable client field to set the principal workspace scope. 3. Select **Graphs** when the personal work tabs are disabled. 4. If **Calendar** is unavailable because its subscription is absent, select **Upgrade now** or **Back** on the subscription surface. The standard workspace shows **Graphs** when it is available. On Principal Desk, **Tasks**, **Activities**, and **Calendar** are disabled. The My Desk subscription-unavailable surface replaces normal workspace content when the module is not included. **Result:** The workspace shows the work modes permitted by your user context and subscriptions. Continue with [When workspace behaviour does not match](#when-workspace-behaviour-does-not-match) if a tab, filter, loading state, or calendar view does not match the expected workspace. ### Prerequisites The same visible differences can result from four states: a disabled tab, a subscription surface, list-loading placeholders, or a work mode that does not support the requested view. ## When workspace behaviour does not match Use the symptom and next action below to distinguish a workspace condition from a missing record. | What you see | What it means | What to do | | --- | --- | --- | | **Tasks**, **Activities**, or **Calendar** is visible but disabled | Principal-user restriction | Use **Graphs** or the principal workspace route | | **Upgrade needed** and its subscription message | The required subscription is unavailable | Select **Upgrade now** or **Back** | | Loading skeleton groups | List data is still loading | — | | The standard **Filter** area is absent on Principal Desk | Principal Desk uses the client field instead | Select a client in that field | | **Timeline** is unavailable in **Month** view | The calendar does not offer Timeline in Month view | Select **Day** or a non-Month view | | Goods receipt dates do not appear in the visible Calendar filter | The visible filter does not expose Goods receipt dates | Use the calendar data choices that are visible | The permitted column-request error path has no reader-visible error or fallback message. ### Messages from linked panels Opened record panels are owned by their respective record pages. My Desk keeps them in view mode and directs changes to the owning page. Task and activity form messages belong to [Create a task](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-task) and [Create an activity](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-activity). When an opened record shows the standard-user notice, read `To make changes, click the pen icon on the tab bar.` At the right end of the opened-record tab in the tab bar, select the control that opens the record's normal page. When it shows `View Mode Only`, use the principal-user view without editing it in My Desk. The subscription surface uses these exact messages and actions: - **Upgrade needed** - `The feature you are trying to use is not included in your current plan. Please upgrade your plan.` - **Upgrade now** - **Back** ### Messages owned by other pages The following messages can appear after My Desk hands work to an owning page. Use the named page for the fields, validation, save, and error response associated with that message. | Owning page | When to use it | Message | | --- | --- | --- | | Create a task or Create an activity | A required embedded field is empty | `This field is required ` | | Create a task or Create an activity | A numeric value is outside the allowed range | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | | Create a task or Create an activity | A numeric value is negative | `Invalid input. Please enter a non-negative value` | | My Desk tasks | A related task cannot be deleted | `This record is related to saved data and cannot be deleted` | | My Desk activities | An activity request succeeds | `Your request was completed successfully` | | My Desk activities | An activity contains forbidden characters | `Forbidden characters detected. Please remove them and try again.` | | My Desk activities | An activity action is refused | `Action not allowed` | | Purchasing inquiry | A receiving date is required | `Required Receiving Date` | | Products | A receiving-after value is required | `Required Receiving After` | | Purchasing inquiry | An offer type is required | `Required Offer Type` | | Purchasing inquiry | A bid due date is required | `Required Bid Due Date` | | Accounts | An account name already exists | `An account with this name already exists` | | Accounts | A request cannot be processed | `An error occurred while processing your request` | | Accounts | A vendor has not been saved | `Error: Vendor not saved yet` | | Accounts | A client has not been saved | `Error: Client not saved yet` | | Accounts | A required account field is empty | `This Field Is Required` | | Contacts | A contact with the same name already exists | ` You already have a contact with this name` | | Libraries | A library name contains an unsupported character | `Just '_'‘-''.' And '&' Characters Accepted` | | Teams | Storage has reached its limit | `You’ve reached the maximum storage limit` | | Principal invoices | Invoice validation fails | `Check validation` | | Create an activity | The activity branch rule is not met | `This action is only allowed if you belong to that branch` | | Create an activity | A topic or note is missing | `One topic and at least one note is required` | | Create an activity | There is no topic to print | `There is no topic to print` | | Sales job record | Custom fields save successfully | `Custom fields saved successfully` | | Sales job record | A job is updated | `Job updated successfully` | | Sales job record | A job is deleted | `Job deleted successfully` | | Sales job record | A job is regretted | `Job regretted successfully` | | Sales job record | A job is cancelled | `Job cancelled successfully` | | Sales job record | A job is missed | `Job missed successfully` | | Sales job record | A job is reactivated | `Job reactivated successfully` | | Sales job record | A job becomes an offer | `Converted to offer successfully` | | Sales job record | A job becomes an inquiry | `Converted to inquiry successfully` | | Sales job record | A job becomes regretted | `Converted To Regretted` | | Sales job record | A job becomes cancelled | `Converted to cancelled` | | Sales job record | A job becomes lost | `Converted to lost` | | Sales job record | Custom-field saving fails | `Error saving custom fields` | | Sales job record | A due invoice prevents undelivery | `Cannot be un-delivered — a due invoice already exists` | | Sales job record | An offer is not in draft status | `All offers must be in draft status to revert to inquiry` | | Sales job record | The server returns a variable error | `Error {{errorMsg}}` | | Sales job record | A project name already exists | `A project with this name already exists` | | Sales job record | A mandatory field is missing | `Check mandatory field(s)` | | Sales job record | An opened inquiry is not saved | `Please save opened inquiry first` | | Sales job record | An inquiry is not in draft stage | `All inquiries must be in draft stage to revert to potential` | | Sales job record | An item has zero quantity | `One or more items has ZERO quantity` | | Sales job record | An item has no unit | `One or more items has no unit` | | Offers | An action is missing for a milestone | `Please enter action for each milstone ` | | Offers | An opened cost sheet is not saved | `Please save opened cost sheet first` | | Offers | A discount exceeds the negotiation margin | `There is a maximum discount that exceeds the negotiation margin.` | | Offers | The gross-profit margin is unacceptable | `The gross profit margin is unacceptable, and the release prices have been stopped.` | | Orders | A sales order is archived | `Sales order is archived` | | Orders | Booked quantity exceeds the required BOM quantity | `Booked quantity for this job is greater than the required BOM quantity` | | Orders | A product is locked after package creation | `You cannot edit or delete the product after the purchase package is created` | | Orders | A product in purchasing cannot be deleted | `Cannot be deleted. Product is in purchasing` | | Orders | A product is locked after purchase-order creation | `You cannot edit the product after the PO is created` | | Products | A product is already in a BOM | `This product is already included in BOM` | | Products | The first variant cannot be deleted | `The first variant cannot be deleted` | | Products | The CRM connection fails | `An error occurred while connecting to your CRM system.` | | Products | No product is selected | `Please select one product` | | MRQ | A package has no item | ` Package must have at least one item` | | MRQ | A product is missing from the package | `You cannot save without adding at least one product` | | MRQ | A product has no quantity | `One of products has no quantity` | | Purchasing | All remaining items are selected | `No remaining items. All items have been selected` | | Purchasing | No email is entered | `Please enter at least one email` | | Purchasing | An inquiry has no item | `Inquiry must have at least one item` | | Purchasing | An offer has no item | `Offer must have at least one item` | | Purchasing | An order has no item | `Order must have at least one item` | | Purchasing | A ready or delivered item is selected for deletion | `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | | Purchasing | No item is selected for an RFQ | `Please select one or more items to create a RFQ.` | | Job profitability | Permission is missing | `You don’t have permission` | | Orders | Accounts cannot be loaded | `Error loading accounts` | | Reference lists | A serial already exists for the manufacturer | `Serial you have entered already exist and belong to same manufacturer` | | Reference lists | A serial is invalid | `There is error in serial you have entered` | | Reference lists | No serial is entered | `Minimum: At least one serial` | | L/G lifecycle | An extension is needed | `Please Add Extension to activate the LG` | | L/G lifecycle | An L/G has extensions or deductions | `LG has one or more extensions or deductions and cannot be reverted to the requested stage` | | L/G lifecycle | An L/G still needs confirmation | `LG still needs confirmation` | | L/G lifecycle | The selected date is not after expiry | `Please choose a date after the current expiry date` | | L/G lifecycle | A pending increase exists | ` There is a pending increase you can edit` | # Manage tasks from My Desk Use My Desk task work to review personal or all-user tasks, create new follow-up work, complete tasks you own, and remove task rows when deletion is available. ## Manage tasks from My Desk A standalone My Desk task is follow-up work managed from the **Tasks** tab rather than from one sales job. Use the list to see your own work or the wider task list, add a task, or act on a task row. Task work tied to one sales job continues on the sales job page. | If you need to… | Go to | |---|---| | Open the task list from My Desk | [Open My Desk task work](#open-my-desk-task-work) | | Recognize the task filters, columns, and form fields | [Understand the task screen](#understand-the-task-screen) | | Switch between all tasks, your tasks, and completed work | [Filter and act on tasks](#filter-and-act-on-tasks) | | Create, save, and complete a standalone task | [Create and complete a task](#create-and-complete-a-task) | | Understand role, ownership, and feature variations | [Handle task branches](#handle-task-branches) | | Correct a validation, save, or delete problem | [Resolve errors and continue](#resolve-errors-and-continue) | | Work with tasks filtered to one sales job | [Sales-job comments and tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-comments-and-tasks) | | Understand the shared My Desk subscription and role context | [My Desk workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-workspace) | ![The My Desk workspace with the Tasks surface available](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/aad0fe4d775a0a57df351d241efaad18.png) ## Before you start My Desk task work is the standalone task list and form used for daily follow-up work. Its availability and actions depend on the Tasks subscription, your user role, and the task's owner and completion state. | Before you start | What it determines | |---|---| | Your plan includes Tasks | The **Tasks** tab is available. | | Your plan does not include Tasks | A subscription-unavailable surface replaces the workspace. | | You are a principal user | **Tasks** is disabled. | | You are not a principal user | You can select **Tasks** when the subscription is available. | | You own the task | Completion, saving, and assignment controls can be available. | | The task is completed | Its form controls are read-only or disabled. | For the shared My Desk subscription and principal-user context, see [My Desk workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-workspace). ## Open My Desk task work Open this section for the standalone task list or the My Desk entry point for a new task. ### Prerequisites - Your plan includes Tasks. - You are not a principal user. ### Steps 1. Open My Desk. 2. Select **Tasks**. 3. In the **Tasks** tab header, select the plus icon. The plus icon opens the task popup titled **Task**. A task with no ID is initialized as a new task. Continue with [Understand the task screen](#understand-the-task-screen) to identify its controls. ![The new Task form opened from My Desk](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d7c1a2e9aa369072b0b07546c62cd792.png) **Result:** The standalone task list is open, or the new **Task** form is open for a task that has no ID. ## Understand the task screen The task screen gives you two list scopes, a completed-work switch, a task grid, and a form for task details. Continue with [Filter and act on tasks](#filter-and-act-on-tasks) when you are ready to change the scope or select a row. ### Task-list controls and statuses | Control or status | Use or meaning | |---|---| | **All** | Shows the full task list. | | **My Tasks** | The personal task-list view. | | **View completed tasks** | Reloads archived or completed work. | | **Upcoming** | An All-task status for upcoming work. | | **Due** | An All-task status for work due now. | | **Overdue** | An All-task status for late work. | | **Completed** | The status shown for completed work. | The task grid shows **Title**, **Owner**, **Start date**, **Due date**, **Status**, and **Importance** in your task list. > **Note:** The task grid uses the selected list layout. Work from the headers visible in > your task list when the layout differs. ![The All task-list view with its task columns and statuses](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3fa1c70a0e738e22d00e5c7779f831c9.png) ### Task form fields and defaults | Form surface | What to know | |---|---| | **Task** | The task form title. | | **Task Purpose** | Required task-purpose field. | | **Priority** | Required choice with `High`, `Medium`, and `Low` options. | | **Owner** | Task ownership information. | | **Tags** | Task tags surface. | | **Description** | Supporting task details. | | **Start Date** | Required date; a new task defaults to today. | | **Due Date** | Required date; it cannot be earlier than **Start Date** and defaults to one day later for a new task. | | **Task Progress** | Progress slider; a new task starts at `0`. | | **Assign To** | Choose an available assignee. | | **Reminder** | Appears after the task has an ID. | | **Save** | Validates and saves without leaving the form. | | **Save and Close** | Saves the task and leaves the form. | The form controls become read-only or disabled when the task is completed. Assignment and saving can be available for a task you own. Continue with [Create and complete a task](#create-and-complete-a-task) to enter a new task. ## Filter and act on tasks Change the task scope or act on a row in the standalone list when you need to review or update task work. ### Switch the task view ### Prerequisites - The standalone task list is open. - You know whether you need all tasks, your tasks, or completed work. ### Steps 1. Select the view that matches the work you need. | If you need to see… | Select | |---|---| | All task-list work | **All** | | Your personal task-list work | **My Tasks** | | Archived or completed work | **View completed tasks** | **Result:** The selected task view is displayed. ### Act on a task row ### Prerequisites - The required task view is displayed. - You know whether you own the task before selecting a completion action. ### Steps 1. Match the task row using **Title**, **Owner**, **Start date**, **Due date**, **Status**, or **Importance**. 2. On the task row, select its action button. 3. Select the action that matches your task: | If you need to… | Select | Then | |---|---|---| | Open the task | **Open** | Review the task form. | | Mark your task complete | **Complete** | Confirm `Are you sure that you want to mark this task as completed?`. | | Return your completed task to incomplete work | **Un complete** | Confirm `Are you sure that you want to un-complete this task?`. | | Remove the row when deletion is available | **Delete** | Select **Delete** or **Cancel** in the deletion confirmation. | The deletion confirmation is `Are you sure you want to delete this task?`. Completing or un-completing a task refreshes the grid. Deletion reports either `Task deleted successfully` or `Error while deleting task`. **Result:** The selected task opens, completion is confirmed, the task returns to incomplete work, or the deletion dialog remains open after **Cancel**. Continue with [Create and complete a task](#create-and-complete-a-task) to add or save task work. ## Create and complete a task Create a standalone task when you have follow-up work that belongs in your daily task workflow rather than under one sales job. The form requires **Task Purpose**, **Priority**, **Start Date**, and **Due Date**. ### Enter and save a task ### Prerequisites - The new **Task** form is open. - You know the task purpose, priority, start date, and due date. - You own the task when you need to save it or change its completion state. ### Steps 1. In **Task Purpose**, enter the task purpose. 2. In **Priority**, select `High`, `Medium`, or `Low`. 3. In **Start Date**, enter the task start date. 4. In **Due Date**, enter a date on or after the selected **Start Date**. 5. Review the **Owner** and **Tags** information shown by the form. 6. In **Description**, enter supporting task details when needed. 7. In **Task Progress**, review the progress value; a new task starts at `0`. 8. In **Assign To**, select an available assignee when assignment is needed. 9. Select the save action that matches what you need: | If you need to… | Select | |---|---| | Continue working in the saved task form | **Save** | | Leave the task form after saving | **Save and Close** | The save message is `Data saved Successfully`. The form's completion controls are available according to ownership and task status. ![The task form with the Save action](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/03be20999a4915a1933f937dba047ffb.png) **Result:** The task is saved in the task workflow, and the form closes after **Save and Close**. Continue with [Complete or return a saved task](#complete-or-return-a-saved-task) when you need to change its completion state. ### Complete or return a saved task Complete or return a saved task when its status and ownership allow a completion action. ### Prerequisites - The task is saved. - You own the task to complete it. ### Steps 1. Select the action that matches the saved task: | If | Select | Then | |---|---|---| | The task is yours and its status is Due or Overdue | **Consider As Complete** | Confirm `Are you sure that you want to mark this task as completed?`. | | The task is Completed and you need to return it to incomplete work | **Consider As Not Completed** | Confirm `Are you sure that you want to un-complete this task?`. | **Result:** The saved task is marked complete or returned to incomplete work after the matching confirmation. ## Handle task branches The task surface changes with subscription, role, ownership, task status, and the task's ID. Use the branch that matches what you see. | What you see or condition | What to do | |---|---| | Tasks is unavailable under your subscription | Use the subscription surface that replaces the workspace. | | You are a principal user | Treat **Tasks** as disabled; use the available principal-user workspace. | | You are not a principal user and Tasks is subscribed | Select **Tasks**. | | The task is completed | Review it with the form controls in their read-only or disabled state. | | You own the task | Use the available saving, assignment, and completion actions. | | The task has an ID | Look for **Reminder** on the saved task form. | The task list does not show a **Following** filter, a search box, or a standalone toolbar task menu. The **Following** condition is not active, the search container is not active, and the toolbar task/activity menu is not active, so these controls do not appear in this standalone task work. ## Resolve errors and continue Use the exact message to correct a missing value or stop when the requested action is blocked. After correcting the task, return to [Create and complete a task](#create-and-complete-a-task). | Message | What to do | |---|---| | `Priority is required` | Select a value in **Priority**, then save again. | | `Title is required` | Enter the task purpose in **Task Purpose**, then save again. | | `Start Date is required` | Enter **Start Date**, then save again. | | `Due Date is required` | Enter **Due Date**, then save again. | | `Error Saving Registration` | Review the task values and select **Save** or **Save and Close** again. | | `Error while deleting task` | Do not rely on deletion; review the row's available actions. | | `This record is related to saved data and cannot be deleted` | Keep the related record and continue in its owning workflow. | | `Task deleted successfully` | Return to the task list and locate the remaining work. | ### Out-of-scope messages from embedded components These messages belong to embedded components whose owning pages handle the corresponding work. Use the owning page or stage shown in the table rather than treating these as My Desk task-list messages. | Message | Owning page or stage | |---|---| | `Required Receiving Date` | Purchasing inquiry | | `This field is required` | Purchasing details | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Purchasing details | | `Invalid input. Please enter a non-negative value` | Purchasing details | | `Your request was completed successfully` | My Desk activities | | `Forbidden characters detected. Please remove them and try again.` | My Desk activities | | `Action not allowed` | My Desk activities | | `An account with this name already exists` | Account details | | `An error occurred while processing your request` | Account details | | `Error: Vendor not saved yet` | Account details | | `Error: Client not saved yet` | Account details | | `This Field Is Required` | Account details | | `You already have a contact with this name` | Contact details | | `One topic and at least one note is required` | Activities | | `Custom fields saved successfully` | Sales job | | `Job updated successfully` | Sales job | | `Job deleted successfully` | Sales job | | `Job regretted successfully` | Sales job | | `Job cancelled successfully` | Sales job | | `Job missed successfully` | Sales job | | `Job reactivated successfully` | Sales job | | `Converted to offer successfully` | Sales job | | `Converted to inquiry successfully` | Sales job | | `Error saving custom fields` | Sales job | | `Cannot be un-delivered — a due invoice already exists` | Sales job | | `All offers must be in draft status to revert to inquiry` | Sales job | | `Error {{errorMsg}}` | Sales job | | `A project with this name already exists` | Sales job | | `Please save opened inquiry first` | Sales job | | `All inquiries must be in draft stage to revert to potential` | Sales job | | `Please enter action for each milstone` | Sales job offer stage | | `Please save opened cost sheet first` | Sales job offer stage | | `Booked quantity for this job is greater than the required BOM quantity` | Bill of materials | | `You cannot edit or delete the product after the purchase package is created` | Bill of materials | | `Cannot be deleted. Product is in purchasing` | Bill of materials | | `You cannot edit the product after the PO is created` | Bill of materials | | `This product is already included in BOM` | Products | | `The first variant cannot be deleted` | Product details | | `An error occurred while connecting to your CRM system.` | Product details | | `Please select one product` | Product details | | `Required Receiving After` | Products | | `Package must have at least one item` | MRQ | | `You cannot save without adding at least one product` | MRQ | | `Please enter at least one email` | Purchasing | | `Inquiry must have at least one item` | Purchasing inquiry | | `Offer must have at least one item` | Purchasing offer | | `Order must have at least one item` | Purchasing order | | `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Purchasing | | `Please select one or more items to create a RFQ.` | Purchasing | | `Required Offer Type` | Purchasing inquiry | | `Required Bid Due Date` | Purchasing inquiry | | `Error loading accounts` | Delivery orders | | `Serial you have entered already exist and belong to same manufacturer` | Reference details | | `There is error in serial you have entered` | Reference details | | `Minimum: At least one serial` | Reference details | | `Please Add Extension to activate the LG` | L/G details | | `LG has one or more extensions or deductions and cannot be reverted to the requested stage` | L/G details | | `Please choose a date after the current expiry date` | L/G details | ## What happens next After **Save**, the task remains in the task workflow without leaving the form. **Save and Close** leaves the task form. Completion refreshes task work, and deletion reports success or error. Use [Sales-job comments and tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-comments-and-tasks) when the task work is filtered to a sales job; that work belongs to the sales job page, not the standalone My Desk task workflow. # Record activities from My Desk Use the standalone **Activities** tab in **My Desk** to review and filter activities across jobs, or add a Visit, Meeting, or Call. For work belonging to one sales job, continue on the sales job record. ## Record activities from My Desk Use the standalone **Activities** tab when you need to review or add activities without first narrowing the work to one sales job. The tab is available when the Activities subscription is available and you are not a principal user. | If you need to… | Go to | |---|---| | Check the subscription, role, and information needed first | [Before you start](#before-you-start) | | Open and recognise the all-job activity list | [Find and review activities](#find-and-review-activities) | | Switch activity types or include archived rows | [Filter the activity list](#filter-the-activity-list) | | Add a Visit, Meeting, or Call | [Add a Visit, Meeting, or Call](#add-a-visit-meeting-or-call) | | Complete the fields for the selected type | [Choose the activity type and handle its differences](#choose-the-activity-type-and-handle-its-differences) | | Resolve an unavailable surface or refused action | [When activity work goes wrong](#when-activity-work-goes-wrong) | | Continue activity work for one sales job | [Continue with job-filtered activity work](#continue-with-job-filtered-activity-work) | | Work with the wider workspace | [My Desk workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-workspace) | | Create an activity from its companion page | [Create an activity](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-activity) | | Record activities on a sales job | [Activities and attachments on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-activities-and-files) | The My Desk **Activities** tab is disabled for principal users. For one sales job, use [Activities and attachments on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-activities-and-files). The **Email** option belongs to list filtering; the My Desk add menu supports only **Visit**, **Meeting**, and **Call**. ## Before you start The activity list and its add forms depend on the subscription, your user role, the selected activity type, and the information you enter before saving. | Before you start | What must be true | |---|---| | Subscription | The Activities subscription is available. | | User role | You are not a principal user. | | Activity form | You select **Visit**, **Meeting**, or **Call** before that form appears. | | Activity information | The required activity information is ready before you select **Save** or **Save and Close**. | The selected type determines which form appears. Enter the information that applies to that type before saving. ## Find and review activities The activity list shows activities available from **My Desk**. Its visible columns are: - **Title** - **Visitors** - **Activity purpose** - **Company** - **Start Date** - **Status** - **Importance** **Prerequisites** - The Activities subscription is available. - You are not a principal user. **Steps** 1. Open **My Desk**. 2. Select **Activities**. ![Select Activities in My Desk to open the all-job activity workspace](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/609dec0cc70ac4e6e13f5bd2dbdd9b79.png) 3. Read the activity rows under the visible column headers. 4. Read **Status** to identify whether a row is `Planned`, `Overdue`, or `Done`. 5. Read **Importance** to identify whether a row is `High`, `Medium`, or `Low`. ![Activity rows with the visible list columns and values](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6a9dfc73cc470c0cf7f65695a01f24da.png) **Result:** The all-job activity list is open. You can now filter its rows by activity type or include archived rows. ## Filter the activity list Use the activity-type filters to change which rows the list displays. Include archived rows when they are outside the current list. **Prerequisites** - The activity list is open from **My Desk**. **Steps** 1. Select the filter that matches the activity set you need. | If you need to see… | Select | |---|---| | All activity types | **All** | | Visits | **Visits** | | Email activities | **Email** | | Meetings | **Meetings** | | Calls | **Call** | 2. Read the visible rows for the selected activity set. ![All activity types selected in the Activities list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/342f6aa052c3dc3606f14b05ce6da58b.png) 3. Select **Show archived activities** when you need archived activities included. ![Archived activities included in the Activities list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/cccdc0dfb049027718e0e42f30e7ae06.png) 4. Read the updated rows after the filter changes. When the list request completes successfully, it reports `Your request was completed successfully`. **Result:** The list shows the selected activity set, with archived activities included when **Show archived activities** is selected. You can now open the add menu to record a Visit, Meeting, or Call. ## Add a Visit, Meeting, or Call Use the My Desk add menu to create an activity from the all-job workspace. The activity opens in a popup with **Save** and **Save and Close** for non-email activities. **Prerequisites** - The Activities subscription is available. - You are not a principal user. - You have the required information for the activity type you plan to select. **Steps** 1. Open the add menu in **My Desk**. 2. Select the activity type you want to record. | If you are recording… | Select | |---|---| | A visit | **Visit** | | A meeting | **Meeting** | | A call | **Call** | ![My Desk add menu with Visit, Meeting, and Call](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2f2c14676b9d02c9355c17aae1e46e69.png) 3. Complete the form for the selected activity type. 4. Choose one save action. | Save action | Result | |---|---| | **Save** | Keep the activity form open | | **Save and Close** | Leave the activity form | The form checks the information before saving. A successful save reports `Data saved Successfully` and leaves the page. **Result:** The selected Visit, Meeting, or Call is submitted from the activity popup, and a successful save reports `Data saved Successfully`. Use the field differences in the next section when completing another activity. ## Choose the activity type and handle its differences Visit, Meeting, and Call are separate activity forms. Each type has its own required fields and optional details. | Activity type | Required fields | Optional or type-specific areas | |---|---|---| | Visit | **Priority**, **Visit Purpose**, **Start Date**, **End Date** | **To**, **Tags**, **Visitors**, **Discussion partner**, **Visit type** | | Meeting | **Priority**, **Meeting Purpose**, **Start Date**, **End Date** | **Location**, **Tags**, **Participant** | | Call | **Priority**, **Start Date** | **Call To**, **Tags**, **Call Number**, **Call Use**, **Description** | **Prerequisites** - The activity popup is open. - You have selected **Visit**, **Meeting**, or **Call**. - The required information for that type is ready. **Steps** 1. Complete the required fields for the selected type. | Selected type | Complete | |---|---| | Visit | **Priority**, **Visit Purpose**, **Start Date**, and **End Date** | | Meeting | **Priority**, **Meeting Purpose**, **Start Date**, and **End Date** | | Call | **Priority** and **Start Date** | 2. Complete the optional or type-specific areas that apply. | Selected type | Areas | |---|---| | Visit | **To**, **Tags**, **Visitors**, **Discussion partner**, and **Visit type** | | Meeting | **Location**, **Tags**, and **Participant** | | Call | **Call To**, **Tags**, **Call Number**, **Call Use**, and **Description** | 3. Keep **End Date** on or after **Start Date** for a Visit or Meeting. ![Visit form with required fields and Visit-specific areas](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/48c7dad9176df55d23c5a6a22a17b200.png) The Call form has no active **End Date** field. Use the values presented in the form for type-specific selectors. After an activity is saved, the record can expose **Attachment** and **Last Modifications** tabs. **Last Modifications** applies to saved non-email activities. Existing activity records also expose status actions according to their current status and editing access: | Current condition | Action available | |---|---| | Activity is due or overdue | **Done** | | Activity is done | **Consider As Not Done** | | Activity is planned, due, or overdue and editable | **Cancel This Activity** | | Activity is cancelled and editable | **Undo Cancellation** | **Result:** The selected form contains the required values and the optional areas that apply to its activity type. If saving succeeds, use the saved activity's tabs and status actions as needed; otherwise, use the messages in the next section. ## When activity work goes wrong Use the surface and message on screen to identify whether the subscription, a required value, the list request, or the current row condition stopped the action. | What you see | What it means | What to do | |---|---|---| | The subscription-upgrade surface replaces the activity list or form. | The Activities subscription is unavailable. | Make the Activities subscription available before returning to the list or form. | | `Priority is required` | A Visit or Meeting does not have the required Priority value. | Complete **Priority** before selecting **Save** or **Save and Close**. | | `Title is required` | A Visit or Meeting does not have the required purpose/title value. | Complete the activity purpose before saving. | | `Start Date is required` | A Visit or Meeting does not have a Start Date. | Complete **Start Date** before saving. | | `Date is required` | A Call does not have the required date. | Complete **Start Date** before saving. | | `Action not allowed` | The current activity-list action is not allowed. | Return to the list and choose an available action. | | `Forbidden characters detected. Please remove them and try again.` | The list request contains forbidden characters. | Remove the forbidden characters and submit the request again. | | Delete is unavailable for the row. | Delete is available only when the row is not Mail, belongs to the same branch, and meets the owner condition. | Use Delete only for an eligible row. | | A server save error is returned. | The save handler uses the returned error message rather than a fixed message. | Read the returned message and correct the activity information or access condition it identifies. | ### Out of scope messages The following messages belong to contacts, tasks, files, topics, or other activity stages. Use the owning page when one of these appears. | Message | Owning area | |---|---| | `You already have a contact with this name` | Contacts | | `This record is related to saved data and cannot be deleted` | My Desk Tasks | | `This action is only allowed if you belong to that branch` | Activity status and record actions | | `One topic and at least one note is required` | Activity topics | | `There is no topic to print` | Print minutes of activity | | `An error occurred while processing your request` | Shared activity actions | | `Just '_'‘-''.' And '&' Characters Accepted` | Files | These messages do not describe the My Desk activity-list filters or the new Visit, Meeting, and Call entry fields. ## Continue with job-filtered activity work When the activity belongs to one sales job, continue on that job's record so the activity remains associated with that job. **Prerequisites** - You know which sales job owns the activity. - You have access to the sales job record. **Steps** 1. Open the sales job record that owns the activity. 2. Open its **Activities** area. 3. Record or review the job-filtered activity there. **Result:** You are working with activities filtered to the selected sales job. For that procedure, continue with [Activities and attachments on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-activities-and-files). # Pricing Quotation ## What Pricing Quotation is Pricing Quotation is own-company costing work used to prepare a sales offer. It sits after sales job work and before the later work owned by procurement, project management, and the warehouse. The same saved record provides the context for its RFQ and quotation work, so you can follow the package from the selected Job items into the purchasing stages. ```mermaid flowchart LR SalesJob[Sales job work] --> PQ[Pricing Quotation] PQ --> RFQ[RFQ] RFQ --> Quotation[Quotation] Quotation --> Procurement[Procurement] Quotation --> ProjectManagement[Project management] Quotation --> Warehouse[Warehouse] ``` | If you need to… | Go to | | --- | --- | | choose the active work list and open a record | [Pricing Quotation active lists](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-active-lists) | | find archived, cancelled, rejected, or deleted work | [Pricing Quotation exception lists](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-exception-lists) | | prepare and send an RFQ | [Pricing Quotation RFQs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-rfqs) | | edit a quotation or return it to RFQ work | [Pricing Quotation quotations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-quotations) | | open the sales-job context that links into Pricing Quotation | Sales job record | | continue into procurement | Purchase jobs procurement chain | | continue into project management | Project management workspace | | continue into warehouse work | Warehouse fulfillment flow | ![Pricing Quotation work hub with its list tabs and toolbar](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ec955c6b33e9e33145da17096327086d.png) ## Before you start Pricing Quotation surfaces are available only when the relevant feature, subscription, access, and record conditions are in place. Use the following checklist before you choose a list or open a record. | Before you start with… | Have this in place | Why it matters | | --- | --- | --- | | the Pricing Quotation record surface | access to view purchasing and the Buyout Job Module | the record surface is available only when the sales job exists, the Purchasing tab is active, the user can view purchasing, and the buyout feature is available | | an existing record | a saved Pricing Quotation record | selecting it opens the existing record context rather than an unsaved entry | | RFQ entry | selected Job items on the saved record | the RFQ entry surface uses the selected items from the job | | downstream work | the information needed by the owning team | collect it before continuing into the next ownership area | The record header marks **Purchaser** and **Product Type** as required. **Branch**, **Shipment Time Frame**, and Job items do not carry a required marker. **Status** and **Shipment Time Frame** are configurable requirements. ## Find Pricing Quotation work Pricing Quotation has two entry points: the work hub for finding records and the direct buyout-to-procurement hub for moving between buyout and procurement areas. Prerequisites - You have access to the Buyout Job Module. - You know whether you need a list or the direct work hub. Steps 1. Choose the entry point that matches your task. | If you need to… | Open | | --- | --- | | find a saved record | Pricing Quotation work hub | | move between buyout and procurement areas | direct buyout-to-procurement hub | **Result:** The Pricing Quotation work hub or the direct buyout-to-procurement hub is on screen. ![Active RFQ list with its visible columns and toolbar controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/8d2ba7e34422bef026f3d781961f4570.png) ### Open a list or an existing record A list row is the hand-off from work-finding to the shared Pricing Quotation record. Open the record from its data-row cell. You can also open the row in another browser tab when you need to keep the list available. Prerequisites - You are on a Pricing Quotation list or an Archived exception list. - You know which saved row you need. Steps 1. Select the data-row cell for the saved Pricing Quotation record. 2. Open the row in another browser tab when you need to keep the list open. **Result:** The shared Pricing Quotation record opens, either in the current tab or in another browser tab. ![Shared record with the record header, stage entries, and Job items](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/713d9add8c10f7f224f5d2c72393d021.png) ## Understand the list and record surfaces The list is the work-finding surface. The shared record holds the package and its stages. Its tabs are: | List tab | Use | | --- | --- | | **Pricing Quotations** | Pricing Quotation list entry | | **RFQs** | RFQ work list | | **All** | All listed work | | **Quotations** | Quotation work list | | **Archived** | Archived outcome lists | The active RFQ list uses **RFQs**. Its columns are listed in the table below. The shared record has the stage entries **New**, **MRQ**, **Pricing Quotations**, **RFQ**, **Offer**, and **Order**, plus the companion areas **Attachment** and **Last Modifications**. The record header gives you the package context through **Branch**, **Purchaser**, **Product Type**, **Package Title**, and **Shipment Time Frame**. The selected Job items use the columns **Item Description**, **Unit**, and **Qty**. > **Note:** The required marker is part of the record surface. Check the marker beside the field > before you leave the record, because the required set can include company-configured fields. ### List columns and actions The list behavior depends on the list you select and the layout and permissions active for your company. Work from the headers you can see in the list rather than assuming that every list has the same columns. | Surface or condition | What you can identify | | --- | --- | | Active RFQ list | **Package no.**, **Sales job No.**, **Purchaser**, **Offer type**, **Bid due date**, **Sub-supplier**, **Client**, and **Package title** | | Archived or unquoted list | **Unquoted RFQs**, with **Package no.**, **Sales job No.**, **Purchaser**, **Sub-supplier**, **Client**, **Package title**, **Offer price**, **Regret Reason**, and **Regret Date** | | Toolbar | Icon buttons titled **Refresh** and Table Layout | | Selected layout | The columns shown for this list | | Permission or availability branch | The list actions and controls that your account is allowed to see | The list has separate outcome lists for **Unquoted RFQs**, **Cancelled RFQs**, **Rejected Quotations**, and **Deleted**. Use [Pricing Quotation exception lists](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-exception-lists) for the filters and restoration boundary. ### RFQ and quotation panels An RFQ panel holds the request-for-quotation work for the selected package items. A quotation panel holds the supplier offer work that follows RFQ work. Both panels belong to the shared Pricing Quotation record; the detailed procedures live on [Pricing Quotation RFQs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-rfqs) and [Pricing Quotation quotations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-quotations). The RFQ surface includes **Account** when the vendor popup is open. Its item columns are **Item Description**, **Unit**, and **Qty**. Its actions include **Save**, **Send RFQ To Sub-supplier**, **Consider RFQ As Submitted To Sub-supplier**, and **Receive Offer**. The quotation surface includes **Offer No.**, **Offer Type**, **Offer Date**, **Validity Period**, **Delivery Time**, **Delivery Term**, **Payment Method**, **Payment Period**, and **PO No.** Its item columns are **Item Description**, **Unit**, **Qty**, **Unit Price**, **Item Price**, and **Currency**. | Control | Available choices | | --- | --- | | **Offer Type** | `firm` and **Budget** | | **Status** | Options for **Status**: the displayed status names | | **Product Type** | Options for **Product Type**: the displayed product-type names | | **Delivery Term** | Options for **Delivery Term**: the available time-period choices | | **Payment Method** | Options for **Payment Method**: the available payment-method choices | Use [Pricing Quotation RFQs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-rfqs) for RFQ editing and [Pricing Quotation quotations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-quotations) for quotation editing. ![Record tabs and RFQ/quotation panel entry points](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/8d2ba7e34422bef026f3d781961f4570.png) ### Order area The **Order** area is a separate stage surface available only when the record's stage conditions allow it. The quotation surface also contains **Convert To Order**. The Order area, when its stage conditions allow it, has its own item columns **Item Description**, **Unit**, **Qty**, **Unit Price**, **Item Price**, and **Currency**, plus order actions such as **Request Approval**, **Approved**, and **Received**. Purchasing-order fields and actions are outside this overview. ### Quotation actions and recovery Quotation action ownership begins on [Pricing Quotation quotations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-quotations). Quotation actions include **Save**, **Valid Offer**, **Convert To Order**, the reject and regret actions, and **Back to RFQ** where it is available. For archived outcomes, use [Pricing Quotation exception lists](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-exception-lists) to find restoration controls. ## Follow RFQ and quotation hand-offs RFQ work is the request stage for a package, and quotation work is the offer stage that follows it. The direct buyout-to-procurement hub presents procurement, project management, and warehouse work areas. ### Move from selected items to the next record surface The selected Job items are the package lines from the sales-job context that you carry into the RFQ entry surface. Start this hand-off from a saved Pricing Quotation record at the Pricing Quotation stage. Prerequisites - You have opened a saved Pricing Quotation record. - The record is at the Pricing Quotation stage. - At least one Job item is available to select. Steps 1. Select one or more rows in Job items. 2. Select **+ RFQ**. 3. Continue in the RFQ entry surface with [Pricing Quotation RFQs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-rfqs). **Result:** The RFQ entry surface is open for the selected Job items. ### Continue the work after the quotation After quotation work, the onward ownership areas are procurement, project management, and warehouse. Use the corresponding sibling pages for the next area: | Next ownership area | Page | | --- | --- | | Procurement | Purchase jobs procurement chain | | Project management | Project management workspace | | Warehouse | Warehouse fulfillment flow | ## Handle stage and availability branches What you see can change with the record stage, subscription, permission, embedding context, and selected layout. A record can expose different **Status** controls before **Offer**, at **Offer**, and at **Order**. RFQ content mounts before **Offer**; quotation content mounts from **Offer** up to **Order**; and Order content mounts from **Order** through **Delivered**. The record surface also depends on the sales job, the active **Purchasing** tab, purchasing-view access, and the buyout feature. | What changes | What to check on screen | | --- | --- | | Stage | Read the stage entries and the currently displayed panel before selecting an action | | Subscription or feature availability | Confirm that the Pricing Quotation surface is present in the work area | | Permission | Confirm that the list or record controls available to your account are present | | Embedded context | Confirm that you are in the sales-job **Purchasing** tab when the record is embedded there | | Selected layout | Work from the columns currently shown in the list | **Note:** A missing tab, panel, action, or whole list can be an availability branch rather than a missing record. Use the surface that is present and the owning page for the procedure it exposes. ## When list or record work goes wrong Use this boundary to decide whether to change lists, check the record context, or hand the issue to the owning page. | What you see | What it means | What to do | | --- | --- | --- | | The list columns differ from this page | The selected layout supplies the list columns | Work from the headers visible in your list; check Table Layout if it is available | | An action or toolbar control is absent | Stage, permission, subscription, embedding context, or layout can change availability | Check the current stage and context before looking for the action on another surface | | **Pricing Quotations** or **Order** is absent from the record | Stage conditions control their availability | Check the current stage before looking for the panel on another surface | | A selected-item RFQ action is blocked | No item is selected for RFQ entry | Select one or more rows in Job items before selecting **+ RFQ** | | The package has no item rows | The relevant entry surface requires at least one item | The screen can show `Inquiry must have at least one item`, `Offer must have at least one item`, or `Order must have at least one item` according to the surface | | A package row is missing an item | The package cannot be empty | The screen can show ` Package must have at least one item` | | Every available item is already selected | There are no remaining items to add | The screen can show `No remaining items. All items have been selected` | | A required value is missing | A required field or configured required field is empty | Complete the field identified by the message, then retry the action. The screen can show `Check mandatory field(s)`, `This Field Is Required`, `This field is required`, `Required Offer Type`, or `Required Bid Due Date` | | No item is selected for RFQ | RFQ entry has no source item | The screen can show `Please select one or more items to create a RFQ.` | | A value is outside the permitted range | The quotation value fails numeric validation | The screen can show `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` or `Invalid input. Please enter a non-negative value` | | An item is already ready for shipment or delivered | That item cannot be deleted from the current work | The screen can show `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | | The branch rule rejects the action | The current account does not belong to the required branch | The screen can show `This action is only allowed if you belong to that branch` | | RFQ communication has no recipient address | The action needs at least one email address | The screen can show `Please enter at least one email` | | A request fails while processing | The request did not complete | The screen can show `An error occurred while processing your request` | | A file or contact operation shows a message from another area | The message belongs to file-library or contact maintenance, not Pricing Quotation | Use the owning area for that operation; its messages are `Your request was completed successfully` and ` You already have a contact with this name` | ### Out of scope messages The following message belongs to order payment-milestone work rather than Pricing Quotation: | Message | Owning area | | --- | --- | | `Please enter action for each milstone ` | Order payment milestones | Use [Pricing Quotation RFQs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-rfqs) for the RFQ send dialog and outbound communication. Use the purchase-job orders page for purchasing-order fields and actions. # Pricing Quotation RFQs ## Before you start An RFQ (request for quotation) is an inquiry in a Pricing Quotation record that collects the items and requirements to send to a sub-supplier for pricing. Use it when you need a sub-supplier response before the Pricing Quotation can become quotation work. The RFQ moves through these stages: | Stage | What it means for your work | |---|---| | Draft | The inquiry is being prepared or remains unsent. | | SentToPrincipal | The inquiry has been sent through the permitted mail route. | | ConsederAsSentToPrincipal | The inquiry has been marked as submitted without that mail route. | | ConsederAsNotSentToPrincipal | The inquiry is treated as not submitted. | | Offered | The inquiry has become quotation work. | The path covered here is from RFQ creation through submission and conversion: ```mermaid stateDiagram-v2 Draft --> SentToPrincipal: Send RFQ To Sub-supplier Draft --> ConsederAsSentToPrincipal: Consider RFQ As Submitted To Sub-supplier SentToPrincipal --> Offered: Receive Offer ConsederAsSentToPrincipal --> Offered: Receive Offer ``` | If you need to… | Go to | |---|---| | Find the Pricing Quotation area and choose a record | [Pricing Quotation overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-overview) | | Create or edit the RFQ information and items | [Find or start an RFQ](#find-or-start-an-rfq) | | Save the RFQ | [Complete and save the RFQ](#complete-and-save-the-rfq) | | Send it or mark it submitted | [Send the RFQ or mark it submitted](#send-the-rfq-or-mark-it-submitted) | | Continue with quotation work | [Pricing Quotation quotations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-quotations) | | Resolve an unavailable or archived record | [Pricing Quotation exception lists](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-exception-lists) | ## Find or start an RFQ The RFQs tab is where you open a saved Pricing Quotation record and create an inquiry from selected Job items. A saved record matters because the RFQ belongs to that Pricing Quotation and its purchasing job. **Prerequisites** - Your subscription includes `BuyoutJobModule`. - You have access to the Pricing Quotation area and the saved Pricing Quotation record. - The Pricing Quotation contains the Job items you want to include. - You know the purchaser, product type, package title, and item details to enter. If `BuyoutJobModule` is not included, the application shows `Upgrade needed`. When no Job items are selected for a new RFQ, the application shows: `Please select one or more items to create a RFQ.` **Steps** 1. Open the **Pricing Quotation** area. 2. Open the **RFQ** tab on the saved Pricing Quotation record. 3. Choose how to open the inquiry: | Inquiry | Action | |---|---| | New inquiry | Select **+ RFQ**. | | Existing inquiry | Open its record. | ![The Pricing Quotations list and its purchasing tabs](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/34c32f33f21c9c08b82e025f39bdb8b4.png) **Result:** The RFQ editor is open for a new inquiry, or an existing RFQ record is open for editing. ## Enter record information and items The RFQ panel combines record information with the Job items that the sub-supplier must price. On the RFQ screen, you see **Pricing Quotations**, **RFQ**, **Offer**, **Branch**, **Purchaser**, **Product Type**, **Package Title**, **Shipment Time Frame**, **Client**, and **Job items**. | Information | What to enter or expect | |---|---| | **Branch** | Optional. | | **Purchaser** | Required. | | **Product Type** | Required. Its choices come from the product types available to your company. | | **Offer Type** | Select `firm` or **Budget**. | | **Package Title** | Required. | | **Shipment Time Frame** | Mandatory only when your company configuration requires it before Order. | | **Item Description** | Identifies the item in the Job items grid. | | **Unit** | Identifies the unit used for the item quantity. | | **Qty** | Enter a value from 1 through 999999. | | **RFQ Date** | Required. It cannot be later than today. | | **Required Offer Type** | Mandatory only when your company configuration requires it. | | **Required Bid Due Date** | Mandatory only when your company configuration requires it. It cannot be earlier than **RFQ Date**. | The RFQ panel is shown for the applicable purchasing record and is read-only when the record is not editable. Its actions also depend on the record existing, its current stage, edit permission, and the unsaved-change check. The item columns are not a fixed quotation-price grid: the RFQ item grid shows **Item Description**, **Unit**, and **Qty**. Work from the headers visible in your list and record. > **Note:** The item grid does not provide a **Category**, **Unit Price**, or **Item > Price** column for this RFQ task. ![The RFQ record fields and Job items grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/df516ae89f20fe55a83cb6d3928d8007.png) **Steps** 1. In the RFQ panel, select the required **Purchaser**. 2. Select the required **Product Type**. 3. Enter the package name in **Package Title**. 4. If required by your company, enter the shipment value in **Shipment Time Frame**. 5. Enter today's date or an earlier date in **RFQ Date**. 6. If required by your company, select **Required Offer Type**. 7. If required by your company, enter a **Required Bid Due Date** that is on or after **RFQ Date**. 8. Review each retained row in **Job items**. 9. Enter the item text in **Item Description**. 10. Select the applicable **Unit**. 11. Enter the quantity in **Qty**. **Result:** The RFQ panel contains the record information and at least one item row with its description, unit, and quantity. Continue with [Complete and save the RFQ](#complete-and-save-the-rfq). ## Complete and save the RFQ Save the RFQ after the record information and at least one item are ready. Saving keeps the inquiry attached to the Pricing Quotation and leaves the saved record editable while its stage and permissions allow editing. **Prerequisites** - You have an editable new or changed inquiry. - At least one item remains in the inquiry. - Each retained item has an **Item Description** and a valid **Qty**. **Steps** 1. Retain at least one item in **Job items**. 2. Check each retained **Item Description**. 3. Check each retained **Qty** is from 1 through 999999. 4. Select **Save**. 5. If a required value is missing, enter it after the application shows `Check mandatory field(s)`. ![The completed RFQ panel before selecting Save](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/df516ae89f20fe55a83cb6d3928d8007.png) **Result:** A successful save keeps the RFQ in the Pricing Quotation's inquiries and leaves it in **Draft**. Continue with [Send the RFQ or mark it submitted](#send-the-rfq-or-mark-it-submitted). ## Send the RFQ or mark it submitted A saved unchanged RFQ in Draft can follow one of two submission paths. Use the mail path when you have both the `SendEmail` permission and the `Send Email` subscription; otherwise use the non-mail path to record that the inquiry was submitted. **Prerequisites** - The RFQ is saved and unchanged. - The RFQ is in Draft. - You know whether the mail permission and subscription are available. **Steps** 1. Open the saved Draft RFQ. 2. Select the action that matches your available mail route: | If | Select | |---|---| | `SendEmail` permission and `Send Email` subscription are available | **Send RFQ To Sub-supplier** | | The permitted mail route is unavailable | **Consider RFQ As Submitted To Sub-supplier** | If you select **Send RFQ To Sub-supplier**, PAMS prepares the RFQ content and PDF attachment, then opens **Mail** with **Send To Principal**. Select **Send To Principal** after you enter at least one recipient. The mail path can show `Email Successfully Sent to sup-spplier`. The non-mail path can show `Inquiry submitted to client`. ![The list headers used to locate a saved RFQ](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/b288450bbd0f90926ca84ed4aebe984e.png) **Result:** The mail path moves the inquiry to `SentToPrincipal`; the non-mail path records it as `ConsederAsSentToPrincipal`. Continue with [Convert the RFQ to a quotation](#convert-the-rfq-to-a-quotation). ## Change a submitted RFQ Use the submitted-RFQ actions when the RFQ needs correction or a different outcome. **Steps** 1. Open the action menu for a saved submitted RFQ. 2. Select the choice that matches the situation: | Situation | Select | |---|---| | Return a submitted RFQ to Draft | **Consider RFQ As Not Submitted** | | Change a submitted RFQ | **Enable Editing** | | Send the RFQ again from `SentToPrincipal` | **Re-send RFQ To Sub-supplier** | | Record a regretted submitted RFQ | **Regretted To Offer** | | Cancel a submitted RFQ | **Cancel RFQ** | **Result:** The selected action changes the RFQ outcome or opens it for editing. Use the message displayed by PAMS to confirm the result. ## Delete an RFQ You can delete a saved RFQ only while it is in Draft and the Pricing Quotation has more than one RFQ. **Prerequisites** - The RFQ is in Draft. - The Pricing Quotation has more than one RFQ. **Steps** 1. Open the Draft RFQ's action menu. 2. Select **Delete RFQ**. 3. Review `Are you sure you want to delete this request for quotation?`. 4. Select **OK** to confirm. **Result:** The RFQ is deleted. PAMS prevents deletion when it would leave the Pricing Quotation without an RFQ and shows `Purchasing job must have at least one RFQ`. ## Convert the RFQ to a quotation Quotation work starts when a submitted RFQ is converted after a response is ready to receive. Conversion is available for an RFQ at `SentToPrincipal` or `ConsederAsSentToPrincipal`. **Prerequisites** - The RFQ has been sent or marked submitted. - The RFQ stage is `SentToPrincipal` or `ConsederAsSentToPrincipal`. **Steps** 1. Open the eligible RFQ. 2. Select **Receive Offer**. The conversion uses the purchasing inquiry conversion action and can show `Purchasing job converted to offer successfully`. **Result:** The inquiry reaches `Offered`. Continue with [Pricing Quotation quotations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-quotations). ## When the RFQ cannot be completed Use the message on screen to distinguish an incomplete RFQ from a missing action or a company-dependent field. If a field is required in your company, complete it before saving. | What you see | What to do | |---|---| | `Please select one or more items to create a RFQ.` | Return to the Pricing Quotation record. Select **Job items**. Select **+ RFQ**. | | `Check mandatory field(s)` | Review **Purchaser**, **Product Type**, **Package Title**, and any field your company configuration makes mandatory. | | `Inquiry must have at least one item` | Keep at least one item in **Job items**. | | `Upgrade needed` | Ask your administrator to provide the `BuyoutJobModule` subscription. | | **Send RFQ To Sub-supplier** is unavailable | Check the saved unchanged Draft condition, `SendEmail` permission, and `Send Email` subscription. | | A field is required in one company but not another | Check your company's `CompanyMandatoryFields` configuration. | ### Related validation messages | Message | What to do | |---|---| | `An error occurred while processing your request` | Review the RFQ information and try the action again. | | `No remaining items. All items have been selected` | Review the selected Job items. | | `Package must have at least one item` | Keep at least one item in the package. | | `This action is only allowed if you belong to that branch` | Use a branch to which you belong. | | `Please enter at least one email` | Enter at least one email address. | | `Offer must have at least one item` | Keep at least one item in the offer. | | `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Keep these items in the record. | | `Required Offer Type` | Complete **Required Offer Type** when it is required. | | `Required Bid Due Date` | Complete **Required Bid Due Date** when it is required. | | `This field is required` | Complete the field marked as required. | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a value greater than 0 and no greater than 999,999.00. | | `Invalid input. Please enter a non-negative value` | Enter zero or a positive value. | | `Invalid input. The tax rate must be between 0 and 100` | Enter a tax rate from 0 through 100. | | `Please enter action for each milstone` | Enter an action for each milestone. | | `Your request was completed successfully` | Continue after the requested operation completes. | | `You already have a contact with this name` | Review the existing contact before entering another name. | ### Out of scope The following message concerns order work rather than the RFQ task: | Message | What to do | |---|---| | `Order must have at least one item` | Continue in the order workflow. | The RFQ action set also includes **Enable Editing**, **Re-send RFQ To Sub-supplier**, **Consider RFQ As Not Submitted**, **Regretted To Offer**, and **Cancel RFQ**. If one of these actions is available, use the current RFQ stage and the message on screen to choose the next step. # Pricing Quotation quotations Use a quotation panel to complete a supplier quotation that came from an RFQ, save its commercial details, and choose an available quotation outcome. ## Quotation work from an RFQ A quotation is the supplier response recorded against an RFQ. Quotation work starts after RFQ work and remains available from the **Offer** stage up to, but not including, **Order**. ```mermaid flowchart LR RFQ[RFQ work] -->|quotation panel becomes available| Offer[Offer] Offer -->|**Valid Offer**| Valid[Valid offer] Offer -->|**Alternative Offer**| Alternative[Alternative offer] Offer -->|**Revision**| Revision[Revision] Offer -->|**Rejected Offer**| Rejected[Rejected offer] Offer -->|**Cancel RFQ**| Cancelled[Cancelled RFQ] Offer -->|**Regretted To Offer**| Regretted[Regretted offer] Offer -->|**Back to RFQ**| RFQ Valid -->|quotation work ends before| Order[Order] ``` The quotation panel carries the supplier response and item values while the work is in the quotation range: **Offer** is the quotation stage and **Order** is the downstream boundary for this page. | If you need to… | Go to | |---|---| | Check whether quotation editing is available | [Before you start](#before-you-start) | | Find the quotation list and open a row | [Find and open a quotation](#find-and-open-a-quotation) | | Read the quotation fields and item columns | [Understand the quotation editor](#understand-the-quotation-editor) | | Enter details and save the quotation | [Save a quotation](#save-a-quotation) | | Mark a draft valid or start another offer | [Choose a quotation outcome](#choose-a-quotation-outcome) | | Recover rejected, cancelled, or regretted work | [When quotation work does not proceed](#when-quotation-work-does-not-proceed) | | Find active quotation rows | [Pricing Quotation active lists](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-active-lists) | | Review archived quotation exceptions | [Pricing Quotation exception lists](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-exception-lists) | | Maintain attached files | [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) | ## Before you start Quotation editing applies to a saved RFQ-created quotation in the quotation stage range. The subscription and your edit permission must expose the editor; outcome actions require a saved, unchanged quotation, while a new or changed quotation uses **Save** first. **Prerequisites** - The current record is an RFQ-created quotation at **Offer** or later and before **Order**. - The Buyout Job Module subscription is available. - Your account has quotation edit permission when you need to change fields or save. - The quotation is saved and unchanged when you need **Valid Offer**, **Alternative Offer**, **Revision**, an exception action, a restore control, or **Back to RFQ**. - You have the supplier, offer details, delivery and payment choices, and item values needed for the quotation. The required fields and allowed periods depend on company configuration. A configured field can be required even when another company's quotation editor does not require it. The configured maximum for offer-number length and the maximum period are also applied by the editor. ## Find and open a quotation The **Quotations** list is the active list for supplier quotations. Use it when you need to identify a saved quotation row before opening its quotation panel. **Prerequisites** - The **Sales** menu contains **Pricing Quotations**. - The Pricing Quotation list shell and its table are available. - A saved quotation row exists. **Steps** 1. Open **Sales**. 2. Select **Pricing Quotations**. 3. Select **Quotations**. 4. Identify the row using the visible quotation-list columns. | Column | Use it to identify the quotation | |---|---| | **Package no.** | Package number | | **Sales job No.** | Related sales job number | | **Purchaser** | Purchaser responsible for the work | | **Offer type** | Offer classification | | **Bid due date** | Deadline for the bid | | **Sub-supplier** | Supplier associated with the row | | **Client** | Client associated with the row | | RFQ stage | Stage of the related RFQ | | **Package title** | Package description | 5. Select the quotation row. ![The Pricing Quotations list with Quotations selected and its visible row headers](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ec955c6b33e9e33145da17096327086d.png) The list provides **Refresh**, **Table Layout**, and **Settings**. **Result:** The selected quotation record opens for inspection. Use the visible list and row to open the quotation rather than relying on a saved-record address. ## Understand the quotation editor The quotation editor records the supplier response, its commercial terms, and the values of each quotation item. The editor can be read-only when the subscription or edit-permission check does not allow editing. The quotation header includes **Sub-supplier**, **Offer No.**, **Offer Type**, **Offer Date**, **Validity Period**, **Delivery Time**, **Delivery Term**, **Payment Method**, **Payment Period**, **Partial delivery**, and **PO No.** The offer fields describe the response and the terms under which it is valid. | Area | Field | Rule | |---|---|---| | Quotation | **Sub-supplier** | Required | | Quotation | **Offer No.** | Required only when configured; configured maximum length | | Quotation | **Offer Type** | Required only when configured | | Quotation | **Offer Date** | Required only when configured; no later than today | | Terms | **Validity Period** | Required only when configured; number from 1 through the configured maximum | | Terms | **Delivery Time** | Required only when configured; number from 1 through the configured maximum | | Terms | **Delivery Term** | Required only when configured | | Terms | **Payment Method** | Required only when configured | | Terms | **Payment Period** | Required only when configured; number from 1 through the configured maximum | | Terms | **Partial delivery** | Optional checkbox | | Purchasing | **PO No.** | Required only when configured | The item grid uses **Item Description**, **Unit**, **Qty**, **Unit Price**, **Item Price**, and **Currency**. **Item Description** is required. **Unit** is optional and can be disabled for package and product rows. **Qty** must be greater than 0 and no more than 999999. **Unit Price** and **Item Price** must be non-negative; **Item Price** can be disabled for package rows. **Currency** is read-only. **Offer Type** has the options `Firm` and `Budget`. **Validity Period** and **Payment Period** each use a number from 1 through `maximumPeriodAllowed` and a period from `AllTimePeriods`. **Payment Method** uses the entries in `paymentMethodList`. The available supplier, delivery-term, purchase-order, item, and unit choices depend on your company's configured values. The item grid can also expose split-row columns and icon-only actions according to the current configuration. Work from the columns and controls visible in your editor. When shown, use **Item Description**, **Unit**, **Qty**, **Save**, and **Save and Close** as displayed. ![The quotation work area and the visible quotation-list context before opening a row](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ec955c6b33e9e33145da17096327086d.png) ![The quotation editor with its fields and save controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/df516ae89f20fe55a83cb6d3928d8007.png) The quotation editor includes **Branch**, **Purchaser**, **Product Type**, **Package Title**, **Shipment Time Frame**, **Client**, and **Job items**. **Purchaser**, **Product Type**, and **Package Title** carried required markers. The visible item columns were **Item Description**, **Unit**, and **Qty**, and the visible controls were **Save** and **Save and Close**. ![The quotation item grid with its available columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/947020b6a13ec3059ed7405f0b75b9bd.png) ## Save a quotation Save a quotation after entering its supplier response, applicable terms, and at least one complete item row. Saving creates or updates the quotation. **Prerequisites** - An editable quotation panel is open. - You have the supplier, configured offer fields, and quotation item information. - You know the quantity, unit, unit price, and currency for each item. **Steps** 1. Complete the quotation fields and item row as follows. | Area | Action | |---|---| | **Sub-supplier** | Choose the supplier. | | **Offer No.** | Enter the quotation number when required by your configuration. | | **Offer Type** | Choose `Firm` or `Budget` when required by your configuration. | | **Offer Date** | Enter the offer date when required by your configuration. | | **Validity Period** | Enter the configured validity number and period when required. | | **Delivery Time** | Enter the configured delivery number and period when required. | | **Delivery Term** | Choose a value when required. | | **Payment Method** | Choose a value when required. | | **Payment Period** | Enter the configured payment number and period when required. | | **Partial delivery** | Select it when the quotation permits partial delivery. | | **PO No.** | Choose a value when required. | | **Item Description** | Choose an item in the item grid. | | **Unit** | Choose a unit when the row permits one. | | **Qty** | Enter a quantity greater than 0 and no more than 999999. | | **Unit Price** | Enter a non-negative value. | | **Item Price** | Enter a non-negative value when the row permits it. | | **Currency** | Check the read-only value. | 2. Select **Save**. 3. If **Save** displays a validation message, correct the value named in the message table. 4. Select **Save** again after correcting a validation error. The editor uses these messages at the point of correction: | Message | Correction | |---|---| | `This field is required` | Complete the field named by the validation marker. When the RFQ validation identifies them, complete **Required Offer Type** and **Required Bid Due Date**. | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Correct **Qty**. | | `Invalid input. Please enter a non-negative value` | Correct **Unit Price** or **Item Price**. | | `Offer must have at least one item` | Add at least one quotation item. | | `No remaining items. All items have been selected` | Use the available item choices; all remaining items are already selected. | | `Package must have at least one item` | Add at least one item to the package. | | `Please enter at least one email` | Enter at least one email address where the quotation action requires one. | | `Inquiry must have at least one item` | Add an item to the inquiry before continuing with quotation work. | | `Order must have at least one item` | Add an item before handing work to the order stage. | | `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Keep those items in the quotation. | | `Please select one or more items to create a RFQ.` | Select one or more items before creating the RFQ. | **Result:** The quotation is saved and the screen displays `Saved Successfully`. If the save request fails, the screen displays `Saving Error`; correct the quotation values and select **Save** again. ## Choose a quotation outcome An outcome moves saved quotation work to its next available quotation state. The available control depends on whether the quotation is a saved unchanged draft, a saved valid offer, a saved `ConsederAsValid` offer, or an expired offer. | Quotation condition | Available outcome | |---|---| | Saved unchanged **Draft** offer | **Valid Offer** | | Saved unchanged **Valid**, `ConsederAsValid`, or **Expired** offer | **Alternative Offer** or **Revision** | | Saved unchanged **Valid**, `ConsederAsValid`, or **Expired** offer | **Rejected Offer**, **Cancel RFQ**, or **Regretted To Offer** | | Saved unchanged quotation that is not **Ordered** | **Back to RFQ** | **Prerequisites** - The quotation is saved with no unsaved changes. - The quotation is at a state listed in the outcome table. **Steps** 1. Read the quotation's current state in the open quotation panel. 2. Select the outcome that matches the work you need. | If you need to… | Select | |---|---| | Mark a saved draft as valid | **Valid Offer** | | Start another offer from an eligible quotation | **Alternative Offer** | | Start a revision from an eligible quotation | **Revision** | | Reject the offer | **Rejected Offer** | | Cancel the RFQ for the selected offer | **Cancel RFQ** | | Record regret for the offer | **Regretted To Offer** | 3. Complete the details requested by the selected outcome. | Selected outcome | Complete these fields when shown | |---|---| | **Rejected Offer** | **Reject Date** and **Comment** | | **Cancel RFQ** | **Cancellation Reason**, **Cancellation Date**, and **Comment** | | **Regretted To Offer** | **Regret Reason**, **Regret Date**, and **Comment** | 4. Read the confirmation message for the selected outcome. | Selected outcome | Message | |---|---| | **Rejected Offer** | `Offer rejected` | | **Cancel RFQ** | `Purchasing offer cancelled` | | **Regretted To Offer** | `Purchasing offer regretted` | **Result:** The selected quotation-outcome action starts from the saved quotation state that permits it. A control is unavailable when its state guard is not met. ## When quotation work does not proceed A quotation exception state records why the normal quotation path stopped. Restore controls return the corresponding saved exception to quotation work when that state permits restoration. | Work stopped as… | Restore control | |---|---| | Rejected offer | **Consider Offer as Not Rejected** | | Cancelled RFQ | **Consider RFQ As Not Cancelled** | | Regretted offer | **Consider As Not Regretted** | Use the following procedure when an action is unavailable or a save is blocked. **Prerequisites** - The quotation panel is open. - The quotation is saved and unchanged when you need an exception or restore action. **Steps** 1. Read the quotation state shown in the panel. 2. Select the restore control that matches the exception shown in the panel. | If the panel shows… | Select | |---|---| | A rejected offer | **Consider Offer as Not Rejected** | | A cancelled RFQ | **Consider RFQ As Not Cancelled** | | A regretted offer | **Consider As Not Regretted** | 3. Sign in with an account that belongs to the quotation's branch, then retry the action. 4. If a mandatory field blocks saving, complete the required field. 5. If an item error appears, add the required quotation item or correct the item row. | What you see | What to do | |---|---| | `This action is only allowed if you belong to that branch` | Use an account that belongs to the quotation's branch. | | `Check mandatory field(s)` | Complete the mandatory fields, then select **Save**. | | `Inquiry must have at least one item` | Add an item to the inquiry before continuing with quotation work. | | `Offer must have at least one item` | Add an item to the offer before continuing. | | `Order must have at least one item` | Add an item before handing work to the order stage. | | `Please select one or more items to create a RFQ.` | Select one or more items before creating the RFQ. | | `Please enter at least one email` | Enter at least one email address where the quotation action requires one. | | `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Keep those items in the quotation. | | `An error occurred while processing your request` | Review the quotation state and values, then retry the supported action. | The quotation panel includes **Payment Milestone**. **Commissions**, **Technical Notes**, and **Commercial Notes** are not available as quotation controls. **Result:** The blocking condition is corrected, the matching restore control is used, or the work remains with the page that owns the blocked RFQ, item, branch, or downstream order condition. ### Out of scope messages The following message belongs to order payment-milestone work rather than quotation work: | Message | Owning area | |---|---| | `Please enter action for each milstone ` | Order payment milestones | ## Continue after quotation work After quotation work, **Back to RFQ** returns a saved unchanged quotation that is not **Ordered** to RFQ work. **Attachment** and **Last Modifications** are shared saved-record surfaces; use their own pages for file maintenance and audit-history details. **Prerequisites** - The quotation panel is open. - The quotation is saved and unchanged for **Back to RFQ**. **Steps** 1. Select the control that matches your next task. | When you need to… | Select | |---|---| | Return the quotation work to RFQ work | **Back to RFQ** | | Open the saved record's attached documents | **Attachment** | | Open the saved record's audit history | **Last Modifications** | 2. Open the downstream order page after quotation work reaches the order boundary. **Result:** RFQ work, shared file work, audit-history work, or downstream order work is on screen at the page that owns that next task. # Pricing Quotation active lists Use the Pricing Quotation lists to find current costing work, narrow the rows to a useful set, and open the record that owns the next action. ## Pricing Quotation lists at a glance Pricing Quotation is the list area for own-company costing work that supports a sales offer. Its active lists keep current work together while separating requests for quotation (RFQ) work from quotations that have already been received. | If you need to… | Go to | |---|---| | See the complete active work list | **All** | | Work with requests sent to suppliers | **RFQs** | | Work with supplier quotations | **Quotations** | | Find work that has moved into an exception list | [Open the Archived list choices](#open-the-archived-list-choices) | | Narrow the rows by a header or row condition | [Filter the list](#filter-the-list) | | Change the columns or their order | [Understand the active list](#understand-the-active-list) | | Open the record and continue the task | Know what is next | | Continue with the wider Pricing Quotation map | [Pricing Quotation overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-overview) | | Continue with an opened RFQ | [Pricing Quotation RFQs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-rfqs) | | Continue with an opened quotation | [Pricing Quotation quotations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-quotations) | | Find an archived exception record | [Pricing Quotation exception lists](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-exception-lists) | The **All** list is the complete active list when the tab is available. **RFQs** contains active request-for-quotation work, and **Quotations** contains active quotations. The tabs divide current work by the kind of work you need to perform, rather than by a fixed set of table columns. ![The active list with the All, RFQs, Quotations, and Archived choices visible](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ec955c6b33e9e33145da17096327086d.png) ## Before you start The active lists are available only when the Pricing Quotation context and its subscription conditions are met. The list page can show the navigation choices without showing the table, so check what is on screen before you search for a row. | Check | What you need to see or have | |---|---| | Access | The **Sales** menu contains **Pricing Quotation**. | | Subscription | The Buyout Job Module subscription is available. | | Saved work | A saved Pricing Quotation record exists before it can appear as a list row. | | List rendering | The list table is available when the subscription condition permits it and a selected layout exists. | | Tabs | When breadcrumbs are enabled, the active choices are **All**, **RFQs**, **Quotations**, and **Archived**. | If the Buyout Job Module subscription is unavailable, the page shows the subscription-upgrade surface instead of the list table. If the selected layout is unavailable, the table also has no columns to display. These conditions affect whether there is a list to search; they do not change which active tab you choose for a saved record. When the table is available, continue with [Find and open a list](#find-and-open-a-list). ## Find and open a list The Pricing Quotation list is the starting point for locating saved active work. Choose the tab that matches whether you are looking for all active work, an RFQ, or a quotation. **Prerequisites** - The **Sales** menu contains **Pricing Quotation**. - The list table is visible. **Steps** 1. Open **Sales**. 2. Select **Pricing Quotation**. 3. Select one active list. | If you are looking for… | Select | |---|---| | Any active Pricing Quotation work | **All** | | A request for quotation | **RFQs** | | A supplier quotation | **Quotations** | ![The All list after selecting the active-list tab](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/db697fc03990edc1d3d42af699ce06f3.png) **Result:** The selected active list appears with its available rows, toolbar, and current layout. Continue with [Understand the active list](#understand-the-active-list) to read the table or [Filter the list](#filter-the-list) to narrow its rows. ## Understand the active list The active list is a table whose columns come from the selected table layout. The headers, their order, their visibility, their data types, their widths, and their captions can therefore differ between lists. Work from the headers that are visible in your list instead of relying on a fixed column catalogue. The table can show 30 records per page and provides navigation buttons for additional pages. A row contains the information selected by the current layout; the visible row fields can differ between tabs. The standard grid also displays the record count, offer total, order total, and order-backlog total in the main currency. The selected layout still determines which columns are visible, so these summary values do not define a fixed column set. | You want to… | Use | |---|---| | Reload the current list | **Refresh** | | Choose a saved table layout | **Table Layout** | | Save the current arrangement as another layout | **Save New Layout**, then **Layout name** | | Save changes to the selected layout | **Update Current** | | Remove the selected layout | **Delete Current** | | Choose which columns are visible | **Columns Chooser** | | Make columns use the available width | **Expand column width** | | Move a column | Reorder the visible column headers. | | Change a column's width | Resize the visible column header. | Use **Table Layout** when the visible headers or their order do not suit the work you are doing. The layout actions let you save a new arrangement, update the current arrangement, or delete the current arrangement. **Columns Chooser** and **Expand column width** change how the table fits your work area; the available columns still come from the selected layout. ![The RFQs list with its visible headers and list toolbar](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2bc63b9f82b8fc59e7bb349a7f7fba87.png) Use [Filter the list](#filter-the-list) when you need to narrow the rows without changing the active list. ### Filter the list Filtering narrows the rows without changing the active list. Use a filter in a column header for a column-level choice, **Filter Row** for row criteria, and **Group Panel** when you need the rows grouped by a field. **Prerequisites** - An active list is open. - The list toolbar is visible. **Steps** 1. Choose the filtering method that matches your task. | If you need to… | Do this | |---|---| | Narrow one column | Select the filter in the column header. | | After the filter opens | Enter or choose the condition. | | Filter by row criteria | Select **Settings** when the row-filter controls are hidden. | | When the row-filter controls are visible | Select **Filter Row**. | | When **Filter Row** is open | Enter the row criteria. | | After entering the row criteria | Select **Apply filter**, or press Enter. | | Group the results | Select **Group Panel**. | | Reload the filtered list | Select **Refresh**. | | Remove the current filter | Select **Clear applied filter**. | Filtering supports a filter in a column header and a row filter. Grouping begins collapsed and is controlled by **Group Panel**. If a filter contains a forbidden character, the list displays `Forbidden characters detected. Please remove them and try again.` Remove the forbidden character and apply the filter again. If the request itself cannot load the rows, the list displays `Load data failed: ` followed by the returned error text. **Result:** The list shows the rows that match the applied criteria, or the active filter is removed and the list returns to its unfiltered state after **Clear applied filter**. Next, use [Open the Archived list choices](#open-the-archived-list-choices) when the work is no longer in an active list. ## Open the Archived list choices **Archived** is the branch for Pricing Quotation work that is no longer in the active **All**, **RFQs**, or **Quotations** lists. Its choices identify the exception that moved the record out of the active work lists. **Prerequisites** - The Pricing Quotation list is open. - The **Archived** choice is visible. **Steps** 1. Select **Archived**. 2. Select the archived choice that matches the exception. | If you need to find… | Select | |---|---| | RFQs without a quotation | **Unquoted RFQs** | | Cancelled RFQs | **Cancelled RFQs** | | Quotations that were rejected | **Rejected Quotations** | | Deleted Pricing Quotation work | **Deleted** | ![The Archived list choices and the exception rows](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/b288450bbd0f90926ca84ed4aebe984e.png) **Result:** The selected archived exception list is on screen. For record-specific recovery or exception work, continue with [Pricing Quotation exception lists](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-exception-lists). If the list, row, control, or filter behaves differently, continue with [When the list does not match](#when-the-list-does-not-match). ## When the list does not match Use this table when the list, row, control, or filter behaves differently from the expected active list. A different set or order of columns is not by itself a problem. | What you see | What it means | What to do | |---|---|---| | The table is replaced by a subscription-upgrade surface. | The Buyout Job Module subscription condition is not met. | Follow the subscription-upgrade path shown on screen. | | The active tabs are absent. | The list is not showing its tab choices. | Check that you opened the standalone Pricing Quotation list. | | The expected columns are different. | The selected layout determines the captions, visibility, widths, and order. | Read the headers currently visible, or use **Table Layout** and **Columns Chooser**. | | A filter is rejected with `Forbidden characters detected. Please remove them and try again.` | The filter contains a forbidden character. | Remove the character and select **Apply filter** again. | | The list displays `Load data failed: ` followed by returned error text. | The list request returned an error. | Note the returned text, then retry with **Refresh**. | | **Export** is unavailable. | **Settings** or the export subscription check is unavailable. | Check **Settings** and the subscription or permission that controls export access. | | **Orders**, **Received**, `cancelled-orders`, or `rejected` is absent. | Those choices are not available on this list. | Use the active **All**, **RFQs**, **Quotations**, or **Archived** choices, then select an archived filter where appropriate. | When you need a file from the current list, continue with [Export the current list](#export-the-current-list). ## Out of scope **Import** is not an active control on the Pricing Quotation list. Use the active list controls or the opened record for the task instead. ### Export the current list **Export** is a list-level action. The export modal has a **Cancel** control. **Prerequisites** - An active list is open. - **Settings** is visible. - Export access is permitted for the subscription and your permissions. **Steps** 1. Select **Settings**. 2. Select **Export**. 3. Review the export modal. 4. Select **Cancel** to close the modal without exporting. **Result:** The export modal is closed without an export when you select **Cancel**. Return to [Understand the active list](#understand-the-active-list) to continue working with the list, or go to Know what is next to open a record. ## Know what is next An active-list row is the hand-off from list discovery to the Pricing Quotation record. After you open a row, continue on its record page for the next action. **Prerequisites** - The correct active or archived list is open. - The row for the saved work is visible. **Steps** 1. Select the needed data row. 2. Select **Open in new tab** when you want to keep the list open while inspecting the record. **Result:** The Pricing Quotation record opens for inspection. Continue in [Pricing Quotation RFQs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-rfqs), [Pricing Quotation quotations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-quotations), [Pricing Quotation exception lists](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-exception-lists), or [Sales job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-record), according to the record and the next action. # Pricing Quotation exception lists ## Pricing Quotation exception lists An exception list is a read-only Pricing Quotation list for work that is no longer in the active quotation flow. Use **Archived** to find unquoted RFQs, cancelled RFQs, rejected quotations, and deleted work, then read the visible row details before continuing with quotation work. | If you need to… | Go to | | --- | --- | | Check the access and screen conditions first | [Before you start](#before-you-start) | | Open one of the four exception lists | [Open an exception list](#open-an-exception-list) | | Identify a row and read its available details | [Read the exception-list results](#read-the-exception-list-results) | | Resolve a missing list or a list variation | [Handle list variations and problems](#handle-list-variations-and-problems) | | Return to current Pricing Quotation work | [Continue from an exception list](#continue-from-an-exception-list) | | Find non-exception Pricing Quotation lists | [Pricing Quotation active lists](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-active-lists) | | Continue with quotation records | [Pricing Quotation quotations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-quotations) | ## Before you start The lists are available to signed-in accounts that can access the Buyout Job Module. The main list shell appears when the subscription condition allows it, and the exception grid appears after a list layout is available. **Prerequisites** - Sign in with access to the Buyout Job Module. - Use an account for which the main Pricing Quotations list is available. - Wait for the selected list layout to load before relying on its headers or rows. The list shell is available when the subscription exclusion is false. The exception-list grid is available when a list layout has been selected. These conditions affect whether there is a grid to read; they do not change the four exception-list names. You are ready to open **Archived** and choose an exception list. ## Open an exception list The **Archived** area groups the four exception lists. Choose the list that matches the work you are investigating: **Unquoted RFQs** for unquoted requests, **Cancelled RFQs** for cancelled requests, **Rejected Quotations** for rejected quotations, or **Deleted** for deleted work. **Prerequisites** - You have access to the Buyout Job Module. - The Pricing Quotations list shell is available. **Steps** 1. Open **Pricing Quotations**. 2. Select **Archived**. 3. Select the exception filter that matches the work you need. | If you need to find… | Select | | --- | --- | | An RFQ with no quotation | **Unquoted RFQs** | | A cancelled RFQ | **Cancelled RFQs** | | A rejected quotation | **Rejected Quotations** | | Deleted work | **Deleted** | 4. Confirm that the selected filter is visible above the grid. ![The Pricing Quotations shell with Archived and its four exception filters visible](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/160739c0c04fa6a0d348d783befaefb9.png) **Result:** The selected exception list is open, and its filter label is visible above the results grid. Read the grid to identify the work. ## Read the exception-list results An exception-list row summarizes Pricing Quotation work that belongs to the selected view. Read the headers currently shown on screen. This view shows these columns: | Column | Use it to identify | | --- | --- | | **Package no.** | Identify the package | | **Sales job No.** | Identify the related sales job | | **Purchaser** | Identify the purchaser responsible for the work | | **Sub-supplier** | Identify the associated sub-supplier | | **Client** | Identify the associated client | | **Package title** | Identify the package description | | **Offer price** | Identify the amount offered | | **Offer price in €** | Identify the euro amount | | **Regret Reason** | Read the recorded reason for the unquoted work | | **Regret Date** | Read the date associated with the regret | The grid contains seven rows in this view. Use the headers visible in your list when identifying work. The visible columns can differ between list layouts. ![The exception-list grid with its ten visible columns, seven rows, and list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/160739c0c04fa6a0d348d783befaefb9.png) The list also provides three icon buttons. Their titles are **Refresh**, **Table Layout**, and **Settings**. Use the visible row values and headers together when checking that you have found the intended work. > **Note:** The selected list layout controls which headers you can use to identify a row. **Result:** You can identify work from the visible headers and rows. If the columns or an action differ, handle the variation before continuing. ## Handle list variations and problems When the list shows different columns or an action stops with a message, follow these steps. **Prerequisites** - An exception list is open. - The list has finished loading. **Steps** 1. Read the headers currently visible in the list. 2. If an action displays a character error, remove the forbidden characters and retry the action. The message is `Forbidden characters detected. Please remove them and try again.` 3. Select the exception filter under **Archived**. | If you need to find… | Select | | --- | --- | | An RFQ with no quotation | **Unquoted RFQs** | | A cancelled RFQ | **Cancelled RFQs** | | A rejected quotation | **Rejected Quotations** | | Deleted work | **Deleted** | 4. Check whether **Export** is present and enabled before using it. Read the row values before continuing with quotation work. **Result:** You have identified the visible columns, handled the available list variation, and know which exception filter to select. Continue with the work area that matches your next task. ## Continue from an exception list After reviewing an exception list, use the active-list page for current, non-exception work or the quotations page for quotation record work. **Prerequisites** - You have reviewed the selected exception-list results. **Steps** 1. Choose the next work area. | If you need to… | Open | | --- | --- | | Find current, non-exception Pricing Quotation work | [Pricing Quotation active lists](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-active-lists) | | Continue with quotation record work | [Pricing Quotation quotations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pricing-quotation-quotations) | 2. Continue the task in the selected Pricing Quotation page. **Result:** You have moved from exception-list review to the active-list or quotation work area that matches your next task. # Purchase job workflow A purchase job takes requested products from a material requisition (MRQ) through requests for quotation (RFQs), quotations, a purchase order, and received work. Use this page to orient yourself in that route, then open the focused page for the record-level task. ## Understand the purchase job workflow The main procurement stages are `Potential`, `Offer`, `Order`, and `Delivered`. At product level, the route is `Active`, `Offered`, `Ordered`, `ReadyForShipment`, and `Received`. ```mermaid flowchart LR MRQ[MRQ] --> Potential[Potential] Potential --> Offer[Offer] Offer --> Order[Order] Order --> Delivered[Delivered] Active[Active product] --> Offered[Offered product] Offered --> Ordered[Ordered product] Ordered --> ReadyForShipment[ReadyForShipment] ReadyForShipment --> Received[Received] ``` The route starts with the MRQ, follows RFQ and quotation work, and reaches the `Order` stage before purchase-order work continues on its focused page. After that hand-off, the job progresses to `Delivered`, while the product moves through `ReadyForShipment` to `Received`. | If you need to… | Go to | | --- | --- | | Reach the active purchasing lists | [Find the MRQ and purchase work](#find-the-mrq-and-purchase-work) | | Understand tabs, columns, and list tools | [Read the purchase work list](#read-the-purchase-work-list) | | Create or complete an MRQ | Create an MRQ | | Work on an RFQ | Manage purchase job RFQs | | Work on a quotation | Manage purchase job quotations | | Approve or activate a purchase order | Manage purchase orders | | Find exception or archived work | Find archived and exception purchase job work | | Continue with warehouse work | Warehouse fulfillment flow | Work can also leave the route. From `Potential`, it can become missed, regretted, or cancelled. From `Offer`, it can become regretted, cancelled, or rejected. From `Order`, it can become rejected or cancelled. Find those records on the exception routes. ## Before you start The MRQ and purchasing lists appear only when the purchasing feature, access, route state, and saved list layout allow them to appear. | What must be in place | What it changes | | --- | --- | | The purchasing feature is included | The list surface is available instead of the subscription-upgrade surface. | | You can create new purchasing work | **RFQ** and **Direct P.O.** are available on the MRQ list. | | A list layout is available | The list grid can display its columns. | | You are on the purchasing list | The list opens in a current state, such as **RFQs**, **Quotations**, or **POs**. | | Selection mode is enabled for the MRQ list | Row-selection checkboxes are available. | The purchasing list uses the route's current tab state. The documented states include `all`, `RFQs`, `offers`, `orders`, `received`, and `archived`, together with the declared exception states. The route selects the state in which the list opens. > **Note:** The list grid appears after a list layout is available. Its columns follow the > layout selected for the current list. ## Find the MRQ and purchase work Use the purchase-work list to orient purchasing activity and the MRQ list to start from the requested product. **Prerequisites** - The purchasing feature is included. - You have access to the purchasing list and a saved list layout is available. - You know whether you need an RFQ, a direct purchase order, or an existing MRQ or purchasing record. **Steps** 1. Choose the entry route for the work you need. | If you need to… | Select | | --- | --- | | Start a new RFQ | **RFQ** | | Start a direct purchase order | **Direct P.O.** | | Open the purchasing work list | The purchase-work list entry available in your application | | Switch to material-requisition work | **MRQs** | 2. On the purchasing list, select **MRQs** to open the MRQ list. 3. In either list, select the row link for the MRQ or purchasing record you need. The MRQ row link opens the linked MRQ record. A purchasing-list row opens the linked purchasing record. **Result:** The selected MRQ or purchasing record is open for the next focused task. ![Select the purchasing tab or MRQs hand-off before opening a row](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/719541cae6ab2ea8162077f0e7c070d8.png) ## Read the purchase work list The purchase-work list groups purchasing records by work state, while the MRQ list shows the requests that supply that work. The saved list layout determines which columns appear, so use the visible headers when locating a row. The purchase-work list provides these tabs: | Tab | Use it to locate | | --- | --- | | **All** | All purchasing work. | | **RFQs** | RFQ-stage work. | | **Quotations** | Quotation-stage work. | | **POs** | Purchase-order work. | | **Archived** | Archived or received work available in this list. | The purchase-work list includes these columns: | Column | Use it to orient the row | | --- | --- | | **Purchasing no.** | Identify the purchasing record. | | **MRQ no.** | Match the purchasing work to its MRQ. | | **Purchaser** | Identify the purchaser. | | **Job stage** | Locate the job in the procurement route. | | **Package title** | Recognize the package. | | **Required receiving date** | Check the required receiving date. | | **Supplier** | Identify the supplier. | The MRQ list includes these columns: | Column | Use it to orient the row | | --- | --- | | **MRQ no.** | Identify the request. | | **MRQ type** | Distinguish the request type. | | **Title** | Recognize the request. | | **Required receiving date** | Check the requested receiving date. | | **Sales** | Relate the request to sales work. | | **Short vendor list** | Review the short vendor list. | Both lists provide **Refresh**, **Table Layout**, and **Settings**. Use the visible headers as your reference because the current list layout selects the columns. ![Read the purchase-work tabs, columns, and list tools](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/719541cae6ab2ea8162077f0e7c070d8.png) ## Move an MRQ through RFQ and quotation An MRQ begins the purchasing route. RFQ work develops the request into an offer, and quotation work develops the offer into an order. At product level, the same part of the route is `Active` to `Offered` to `Ordered`. **Prerequisites** - You have reached the MRQ or purchase-work list. - You know whether the next work is MRQ, RFQ, or quotation work. **Steps** 1. Select the focused page for the work that follows the current stage. | If you need to… | Continue to | | --- | --- | | Create an MRQ | MRQ creation | | Work on an RFQ | Manage purchase job RFQs | | Work on a quotation | Manage purchase job quotations | **Result:** You are directed to the focused page for the MRQ, RFQ, or quotation action that follows the current stage. ## Hand the quotation to purchase-order approval and activation The quotation-to-purchase-order hand-off is where quotation work becomes purchase-order work. The process map places that work at `Order` after the quotation. **Prerequisites** - You have reached quotation work. - You can open the focused purchase-order page. **Steps** 1. Continue to Manage purchase orders. **Result:** The quotation-to-purchase-order hand-off is complete for the next focused purchase-order task. ## Recover from a blocked list action List filtering and loading can stop an action before the list is usable. Match the message you see to the response below. **Prerequisites** - You are on the MRQ or purchasing list. - You have a list action to perform. **Steps** 1. In the toolbar above the list, select the control for the action you need. | If you need to… | Select | | --- | --- | | Refresh the list | **Refresh** | | Change the visible list layout | **Table Layout** | | Open list settings | **Settings** | | Export list data | **Export** | | Delete an MRQ | **Delete** | 2. If the action opens a dialog, select **Cancel** to close it without continuing. 3. If an error or alert appears, use the matching response below. | What you see | What to do | | --- | --- | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the filter, then retry the list action. | | `Load data failed: ` + runtime error text | Treat the list load as failed and continue to the exception or troubleshooting page. | | `Are you sure you want to delete this MRQ?` | Confirm the deletion only when the MRQ is the one you intend to remove. | | `Data Importing completed` | The import has completed. | | `NO Data to Export` | Return to the list. | | `Data Deleted Successfully` | The deletion completion alert appears after the MRQ is deleted. | | ``Translated response from `checkErrorResponse``` | Use the translated response shown by the application to correct the failed action. | | A subscription-upgrade surface | Ask for the purchasing feature to be included before using the list. | 4. If `NO Data to Export` appears, return to the list. 5. On the list, select **Export** after data is available. 6. Continue to Find archived and exception purchase job work for exception recovery. **Result:** The list action is closed, retried with corrected input, or handed to the exception page for recovery. ## Continue after the purchase order hand-off After purchase-order work, the procurement stage moves from `Order` to `Delivered`. The product-level route continues from `Ordered` to `ReadyForShipment` and then `Received`. | Next state | Where to continue | | --- | --- | | `Delivered` | Purchase-order work after the order stage. | | `ReadyForShipment` | Warehouse fulfillment work after the purchase order. | | `Received` | Warehouse receiving work. | Continue with Manage purchase orders for the purchase-order record and Warehouse fulfillment flow for the warehouse work that follows the hand-off. # Find active purchase job work Use the Purchase Jobs work lists to locate procurement work, distinguish active work from archived outcomes, and open the page that owns the next task. ## Find purchase job work Purchase Jobs is the work-list surface for procurement records. Procurement work moves from a material requisition (MRQ), through a request for quotation (RFQ) and supplier quotation, to a purchase order (PO). Active work is still being handled; archived work has a received, cancelled, rejected, unquoted, or extension-rejected outcome. Use the list to find a row, then open the page for its detailed work. An archived family groups work by one of those outcomes. ```mermaid flowchart LR MRQ[MRQ] --> RFQ[RFQ] RFQ --> Q[Quotation] Q --> PO[Purchase order] PO --> A[Archived outcomes] ``` Use these links to move from finding work to handling it: | If you need to… | Go to | |---|---| | See all active purchase-job work | [Find active work by list](#find-active-work-by-list) | | Find RFQ work | [Find active work by list](#find-active-work-by-list) | | Find quotation work | [Find active work by list](#find-active-work-by-list) | | Find purchase-order work | [Find active work by list](#find-active-work-by-list) | | Find received, cancelled, rejected, unquoted, or extension-rejected work | [Find archived work](#find-archived-work) | | Understand the columns and list tools | [Read the work list](#read-the-work-list) | | Diagnose an unavailable list action | [When list actions fail](#when-list-actions-fail) | | Continue with the selected row | [Continue from the work list](#continue-from-the-work-list) | | Start with the material requisition | [Create an MRQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-mrq) | | Work on the purchase-job record | [Purchase job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-record) | | Work on an RFQ | [Purchase-job RFQs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-rfqs) | | Work on a quotation | [Purchase-job quotations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-quotations) | | Work on a purchase order | [Purchase-job orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-orders) | | Interpret archived and exception work | [Purchase-job exception lists](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-exception-lists) | | Follow the procurement chain | [Purchase job procurement chain](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) | The separate **MRQs** link leads to the material-requisition list. It is not an active Purchase Jobs tab. ![The Purchase Jobs list with its active tabs and work grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/719541cae6ab2ea8162077f0e7c070d8.png) ## Before you start Purchase Jobs lists are available when the purchasing subscription is included. When it is excluded, the subscription-upgrade surface appears instead of the normal toolbar, tabs, and list. | Before you rely on… | Know this condition | |---|---| | The normal list surface | The subscription includes the purchasing feature. | | The **RFQ** and **Direct PO** entries in the plus menu | New purchase-job access is available. | | A particular business column | The saved list layout for the current view supplies it. | | The standard grid | A saved layout is available for the selected list. | | A new Direct PO entry | Direct P.O. is not shown. | The selected list layout controls the headers, their order, and the information available to you. Use the headers visible in the selected list rather than treating the standard field list as fixed. ## Find active work by list Choose an active tab to locate work that is still being handled in the MRQ-to-RFQ-to-quotation-to-PO chain. **Prerequisites** - You are signed in to PAMS. - The purchasing subscription is included. - You know whether you are looking for all active work, an RFQ, a quotation, or a PO. **Steps** 1. Open the Purchase Jobs list. 2. Select the tab that matches the work you need. | If you need to… | Select | The list opens at | |---|---|---| | Review all active purchase-job work | **All** | All active work | | Review requests for quotation | **RFQs** | Requests for quotation | | Review supplier quotations | **Quotations** | Supplier quotations | | Review purchase orders | **POs** | Purchase orders | 3. Confirm that the selected tab is the active list you intended to review. **Result:** The active list that matches your procurement work is on screen. The selected tab and the selected list identify which part of the chain you are reviewing. ## Read the work list The work list is a grid of procurement information chosen for the current list and saved layout. Because each list can show different business columns, read the headers visible on your screen. A saved layout controls which business columns appear, so use the visible headers when locating a row. The RFQs list showed these seven columns in this order. Use them to identify the request and its supplier before opening the focused record: | Column | |---| | **Purchasing no.** | | **MRQ no.** | | **Purchaser** | | **Job stage** | | **Package title** | | **Required receiving date** | | **Supplier** | The Quotations list showed these columns. Use them to review the offer and supplier details: | **Purchasing no.** | **MRQ no.** | **Purchaser** | **Job stage** | **Package title** | |---|---|---|---|---| | **Required receiving date** | **Offer date** | **Offer total price** | **Offer total price in main currency €** | **Offer total price (incl. tax)** | | **Supplier(s)** | | | | | The POs list showed these columns. Use them to review the order and supplier details: | **Purchasing no.** | **MRQ no.** | **P.O. no.** | **Purchaser** | **Job stage** | |---|---|---|---|---| | **Package title** | **Forecasted receiving date** | **Order total price (incl. tax)** | **Supplier** | **Sub-supplier order no.** | The Archived list showed these columns. Use them to identify the archived record and its outcome: | **Product** | **Variant** | **Package no.** | **Purchaser** | **Sub-supplier** | **Package title** | |---|---|---|---|---|---| | **Price** | **Price in €** | **P.O. no.** | **Stage** | **Delivery Date** | **Sales job no.** | When the selected layout includes them, the standard grid can also provide these fields. Their availability depends on the selected layout: | Package information | Offer information | Order information | |---|---|---| | **Package no.** | **Offer stage** | **Order stage** | | **Package stage** | **Offer type** | **Order date** | | **Package** | **Offer date** | **Order price** | | **Purchasing responsible** | **Offer price** | **Sub-supplier** | Use these list tools by their icon title while reviewing the grid: | Tool | Use | |---|---| | **Refresh** | Refresh the list view. | | **Table Layout** | Work with the available table layout choices. | | **Settings** | Open the available list settings. | ## Find archived work Use the archived families to locate procurement work with a received, cancelled, rejected, unquoted, or extension-rejected outcome. **Prerequisites** - You are on the Purchase Jobs list. - You know whether the record is a received PO, cancelled RFQ or PO, rejected quotation or PO acceptance, an unquoted RFQ, or a quotation rejected for extension. **Steps** 1. Select **Archived**. 2. Choose the archived family that matches the work. | If you need to find… | Select | |---|---| | Received purchase orders | **Received POs** | | Cancelled requests for quotation | **Cancelled RFQs** | | Rejected quotations | **Rejected Quotations** | | Cancelled purchase orders | **Cancelled POs** | | RFQs with no quotation | **Unquoted RFQs** | | Quotations rejected for extension | **Non-Extented Quotations** | | Rejected PO acceptance | **Rejected PO acceptance** | The received archived view showed **Product**, **Variant**, **Package no.**, **Purchaser**, **Sub-supplier**, **Package title**, **Price**, **Price in €**, **P.O. no.**, **Stage**, **Delivery Date**, and **Sales job no.** The archived filter list appears when you select an archived family. **Result:** The archived family that matches the completed or stopped procurement work is on screen. Continue with the exception-list page when you need to interpret or manage that outcome. ## When list actions fail Use the message or visible condition below to choose the next move. | What you see | What it means | What to do | |---|---|---| | `Forbidden characters detected. Please remove them and try again.` | The list action rejected forbidden characters. | Remove the forbidden characters from the value being filtered or processed, then try the action again. | | `NO Data to Export` | The export action has no data to export. | Load data in the list before selecting **Export**. | | `Data Importing completed` | The import completed successfully. | Import completed successfully. | | **Convert to archive** is visible | The selected list is the stuck list and the archive action is available for that row. | Select **Convert to archive** only when archiving that row is the intended action. | | The archive confirmation appears | The archive action asks for confirmation before continuing. | Read the warning before deciding whether to continue: `You are about to archive this product. This action cannot be undone. Are you sure?` | | A list action produces no visible response | No result is visible. | Confirm the outcome in the owning record or exception-list page before repeating the action. | **Prerequisites** - The list contains the data you want to export. **Steps** 1. Select **Export**. 2. Select an available export format. **Result:** The selected export format is submitted. ## Continue from the work list After you locate a row, continue on the page that owns its next record action. | From the work list | Continue with | |---|---| | **MRQs** | The separate material-requisition list, then [Create an MRQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-mrq) for MRQ work. | | A purchase-job row | [Purchase job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-record). | | An RFQ row | [Purchase-job RFQs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-rfqs). | | A quotation row | [Purchase-job quotations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-quotations). | | A PO row | [Purchase-job orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-orders). | | Archived or exception work | [Purchase-job exception lists](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-exception-lists). | Open the row or linked work item from the list when you are ready to continue. **Result:** You have a destination for the located work. MRQs remain on their separate list, and detailed record work continues on the owning page. # Find archived and exception purchase job work Use the Purchase Jobs lists to locate work that has left the main procurement flow, match it to the stage where it stopped, and open the owning purchase-job record for the next action. ## Find archived and exception purchase job work An archived purchase job is a procurement record shown outside the active list tabs after it reaches a delivered or other terminal outcome. An exception list groups records that left the normal path at a particular procurement stage, so you can find the record and inspect its recovery action. The main procurement stages are `Potential`, `Offer`, `Order`, `Delivered`, `Deleted`, and `ExtensionRejected`. Use the list that matches the exit: | Procurement stage | Exception list | | --- | --- | | Potential | **Unquoted RFQs** or **Cancelled RFQs** | | **Offer** | **Unquoted RFQs**, **Cancelled RFQs**, **Rejected Quotations**, or **Non-Extented Quotations** | | **Order** | **Rejected PO acceptance** or **Cancelled POs** | | **Order** after delivery | **Received POs** | Each exception view selects the procurement stage represented by its tab label. **Received POs** represents delivered work; **Cancelled RFQs** represents cancelled request work; **Rejected Quotations** represents rejected offer work; **Cancelled POs** represents cancelled order work; **Unquoted RFQs** represents regretted request work; **Non-Extented Quotations** represents extension-rejected offer work; and **Rejected PO acceptance** represents rejected order work. ## Before you start Before you start, confirm that you can open Purchase Jobs, that you are working in the correct branch, and that the purchase-job records you need are available to you. | Before you start | Why it matters | | --- | --- | | Purchase-job subscription is included | The Purchase Jobs list shell and its purchase-job actions are available only when the subscription is included. | | The archived or exception tab is active | The exception tabs are available from the archived work area. | | The list has finished loading | The headers and rows you can use are the ones shown on screen. | | The row belongs to your branch and has an edit control in its action column | Branch authorization controls whether the edit control is available. | | The required records are available | The rows, stages, and values come from the records available to you. | You can open the Purchase Jobs shell and see **All**, **RFQs**, **Quotations**, **POs**, and **Archived**. ## Find the matching exception list An exception list is the tab whose label groups a procurement exit. Select the matching tab to see records at that exit rather than records in the active flow. | If the work is… | Select this list | Procurement stage represented | | --- | --- | --- | | Received after the order was delivered | **Received POs** | Delivered | | A cancelled request | **Cancelled RFQs** | Potential | | A rejected quotation | **Rejected Quotations** | Offer | | A cancelled order | **Cancelled POs** | Order | | A regretted request | **Unquoted RFQs** | Potential | | A quotation whose extension was rejected | **Non-Extented Quotations** | Offer | | Rejected purchase-order acceptance | **Rejected PO acceptance** | Order | The **Archived** entry opens the archived and exception group. Its link routes to the received view, so select **Received POs** when you need the delivered purchase-order records. The active exception strip contains the seven labels in the table above. ### Find a list Prerequisites - The Purchase Jobs shell is available to your account. - You know the exit or exception you need to investigate. Steps 1. Open the Purchase Jobs list surface. 2. Select **Archived**. 3. Select the tab label that matches the exit in the table above. 4. Confirm that the selected label is visible in the active tab strip. **Result:** The matching exception list is active. Read its headers and rows before opening a purchase-job record. ## Understand the list and its rows An exception-list row is the purchase-job summary that lets you identify the owning record before opening it. Use the headers shown on screen to identify the information available in the current view. The list has no data-entry fields or validation groups. It statically declares these possible columns: | Group | Possible headers | | --- | --- | | Package | **Package no.**, Package stage, **Package**, Purchasing responsible, **Sub-supplier** | | Offer | **Offer stage**, **Offer type**, **Offer date**, **Offer price** | | Order | **Order stage**, **Order date**, **Order price** | Each exception view also exposes icon buttons titled **Refresh**, Table Layout, and Settings. The headers and rows depend on the selected list and the records available to you. > **Note:** Use the headers visible in the current list when identifying a row. Another > list can show a different set of columns. Use the columns shown in your selected list rather than expecting every list to match: | List | Columns shown in each list | | --- | --- | | **Received POs** | Product, Variant, Package no., Purchaser, Sub-supplier, Package title, Price, Price in €, P.O. no., Stage, Delivery Date, Sales job no. | | **Cancelled RFQs** | Purchasing no., MRQ no., Purchaser, Package title, Required receiving date, Offer date, Total price, Total price in main currency €, Total price (incl. tax), Supplier, Cancel reason, Cancel date, Cancel comment | | **Rejected Quotations** | Purchasing no., MRQ no., Purchaser, Package title, Required receiving date, Offer date, Total price, Total price in main currency €, Total price (incl. tax), Supplier, Reject Date, Reject comment | | **Cancelled POs** | Purchasing no., MRQ no., P.O. no., Purchaser, Package title, Order total price (incl. tax), Supplier, Sub-supplier order no., Cancel reason, Cancel date, Cancel comment | | **Unquoted RFQs** | Purchasing no., MRQ no., Purchaser, Package title, Required receiving date, Offer date, Total price, Total price in main currency €, Total price (incl. tax), Supplier, Regret Comment, Regret date | | **Non-Extented Quotations** | Purchasing no., MRQ no., Purchaser, Job stage, Package title, Required receiving date, Offer date, Total price, Total price in main currency €, Total price (incl. tax), Supplier, Reject Ext. Date, Reject Ext. reason, Reject Ext. comment | | **Rejected PO acceptance** | Purchasing no., MRQ no., P.O. no., Purchaser, Package title, Forecasted delivery date, Total price, Total price in main currency €, Total price (incl. tax), Order total price (incl. tax), Supplier, Sub-supplier order no., Reject comment, Reject Date | ![The Received POs grid with its headers and rows](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6f1e54a0b798a975552b0eed865c36f0.png) ![The Cancelled POs grid with its headers and rows](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/4068c48402a2f944a8143c3b6ad1ec08.png) ## Open the matching purchase job The purchase-job record is the owning workspace for an exception row. Open it when you need to inspect the record's stage or use the action area. Prerequisites - The matching exception list is active. - The row belongs to your branch, and its action column contains the edit control. Steps 1. Locate the row using its package number or another visible identifying value. 2. Select the **Package no.** cell to open the purchase-job record in a new tab. 3. In the row's action column at the right edge of the grid, select the edit control to open the purchase-job record with its stage, account, and product context. 4. Confirm the record's stage. | Exit | Select this control | | --- | --- | | Regretted RFQ or offer | **Consider As Not Regretted** | | Cancelled RFQ or offer | **Consider RFQ As Not Cancelled** | | Rejected quotation | **Consider Offer as Not Rejected** | | Extension-rejected quotation | **Undo Denied To Extend** | | Cancelled PO | **Consider P.O. as not Cancelled** | | Rejected PO acceptance | **Consider PO acceptance as not rejected** | | Received PO | **Consider as not received** | 5. In the purchase-job record's action area beside the stage controls, select the bold control in the row that matches the exit. **Result:** The owning purchase-job record is open for inspection or recovery. ### Open a row An exception row hands work to the purchase-job record page. The package-number cell and other row cells open that page, while the edit control in the row's action column opens the record with its stage, account, and product context when the row belongs to your branch. Prerequisites - At least one row is visible in the selected exception list. Steps 1. Select the **Package no.** cell when you want the purchase-job record in a new tab. 2. Select another row cell when you want the purchase-job record in the current page. 3. In the row's action column at the right edge of the grid, select the edit control when you need the record's stage, account, and product context. **Result:** The selected row opens on its purchase-job record page. ## Handle exit-list variations Different exception labels represent different exits and originating stages. In the purchase-job record's action area, select **Consider As Not Regretted** for a regretted RFQ or offer, **Consider RFQ As Not Cancelled** for a cancelled RFQ or offer, **Consider Offer as Not Rejected** for a rejected quotation, **Undo Denied To Extend** for an extension-rejected quotation, **Consider P.O. as not Cancelled** for a cancelled PO, **Consider PO acceptance as not rejected** for rejected PO acceptance, or **Consider as not received** for a received PO. The archive action in the row's action column is available only for a row from your branch in the stuck work list. The available lists and actions depend on your subscription, branch, and available records. Check the label shown on screen and the row's branch before relying on an action. ## When the list action goes wrong The list can display a direct message when an action cannot proceed. Match the message exactly before deciding what to do. | What you see | What to do | | --- | --- | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters and retry the action. | | `NO Data to Export` | Use the list with available data before exporting. | | `You are about to archive this product. This action cannot be undone. Are you sure?` | Treat the archive action as irreversible and stop if you do not intend to archive the product. | If an action produces no visible result, check whether the row and its list state changed before continuing. An unchanged row means the action did not give you a visible completion result. ### Messages on the purchase-job record page The following messages belong to the Purchase job record page and its embedded inquiry, quotation, order, payment-milestone, and contact areas. | Message | Owning page | | --- | --- | | `Data Importing completed` | Purchase job record | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Purchase job record | | `Invalid input. Please enter a non-negative value` | Purchase job record | | `Invalid input. The tax rate must be between 0 and 100` | Purchase job record | | `Product package deleted from all inquiries` | Purchase job record | | `Product package deleted from all offers` | Purchase job record | | `Product package deleted from all orders` | Purchase job record | | `Order updated successfully. Undelivered. A draft invoice was deleted` | Purchase job record | | `Job reactivated successfully` | Purchase job record | | `Converted to inquiry successfully` | Purchase job record | | `Converted to offer successfully` | Purchase job record | | `Please insert at least one PO` | Purchase job record | | `Please insert at least one RFQ` | Purchase job record | | `Please insert at least one product` | Purchase job record | | `Inquiry must have at least one item` | Purchase job record | | `Offer must have at least one item` | Purchase job record | | `Order must have at least one item` | Purchase job record | | `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Purchase job record | | `An error occurred while processing your request` | Purchase job record | | `Package products cannot be empty` | Purchase job record | | `Required Offer Type` | Purchase job record | | `Required Bid Due Date` | Purchase job record | | `Please enter action for each milstone` | Purchase job record | | `You already have a contact with this name` | Purchase job record | | `Your request was completed successfully` | Purchase job record | ## Continue the purchase-job work The exception list locates the record; the purchase-job record's action area contains the exit-specific action and the detailed follow-up work. Prerequisites - You have located the exception row and its owning purchase-job record. Steps 1. Open the exception row's purchase-job record as described in [Open the matching purchase job](#open-the-matching-purchase-job). 2. In the purchase-job record's action area, select the control for the exit: | Exit | Select | | --- | --- | | Regretted RFQ or offer | **Consider As Not Regretted** | | Cancelled RFQ or offer | **Consider RFQ As Not Cancelled** | | Rejected quotation | **Consider Offer as Not Rejected** | | Extension-rejected quotation | **Undo Denied To Extend** | | Cancelled PO | **Consider P.O. as not Cancelled** | | Rejected PO acceptance | **Consider PO acceptance as not rejected** | | Received PO | **Consider as not received** | 3. Continue the focused work in the applicable page: | Work | Continue with | | --- | --- | | RFQ | [Purchase job RFQs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-rfqs) | | Quotation | [Purchase job quotations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-quotations) | | Purchase order | [Purchase job orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-orders) | **Result:** You have located the exception and handed the next action to the owning purchase-job record or its focused follow-up page. # Create an MRQ Create a material requisition (MRQ), find it again, and hand the saved request to the next procurement task. ## Before you start An MRQ is the material-requisition starting point for procurement work. It records the products or requirements that procurement must source before the work continues through a request for quotation (RFQ), quotation, purchase order (PO), warehouse handling, and delivery. Use the material-requisition list and new-MRQ screen to create or find an MRQ. A bill of materials (BOM) can supply the material need; the MRQ starts the procurement record that carries that need into supplier and order work. An MRQ can remain active or become cancelled: | Status | Meaning | |---|---| | **Active** | The MRQ remains in active procurement work. | | **Cancelled** | The MRQ has been converted to the cancelled state. | Choose the type that matches the work: | Type | Meaning | |---|---| | Project | **Products** and **Additional Requirements** are available. | | Stock | **Products** and **Additional Requirements** are available. | | Needs | **Products** and **Additional Requirements** are available. | | Safety stock | A stock MRQ variant. | | If you need to… | Go to | |---|---| | Reach the material-requisition list | [Find an MRQ](#find-an-mrq) | | Open the blank form | [Open a new MRQ](#open-a-new-mrq) | | Recognize the saved record | [Find a saved MRQ](#find-a-saved-mrq) | | Learn the fields and product area | [Understand the MRQ screen](#understand-the-mrq-screen) | | Enter products and save the request | [Enter and save the MRQ](#enter-and-save-the-mrq) | | Work with conditional actions | [Handle MRQ variations](#handle-mrq-variations) | | Correct a save or loading problem | [When saving goes wrong](#when-saving-goes-wrong) | | Continue through procurement | [Continue with the saved MRQ](#continue-with-the-saved-mrq) | | Complete a saved MRQ | [Complete an MRQ record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/mrq-record-follow-up) | | Follow the full procurement chain | [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) | ## Find an MRQ The MRQ list is the starting place for locating existing material requisitions or opening a new one. Sign in before opening the material-requisition list. **Prerequisites** - Your subscription includes the MRQ feature. - Your account has the permission needed for the action you want to take. - A list layout is available when the list needs a saved layout to draw its columns. **Steps** 1. Open the material-requisition list. 2. Confirm that the purchasing tabs are visible: **All**, **RFQs**, **Quotations**, **POs**, **Archived**, and **MRQs**. 3. To start a direct purchase order from the list, select **Direct P.O.** when your subscription includes the feature and your account may create a new MRQ. Selecting **Direct P.O.** opens the direct-purchase-order screen. That screen shows **Purchaser**, **Product Type**, **Package Title**, **Products**, **+ Direct P.O.**, **Save**, and **Save and Close**. ![The direct-purchase-order screen opened from the MRQ list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e18fc404133c685d16560fa4d31cb1c7.png) Your list layout determines which columns appear; use the headers visible in your list. The list shows **MRQ no.**, **MRQ type**, **Title**, **Required receiving date**, **Sales**, and **Short vendor list**. The toolbar also exposes **Refresh**, **Table Layout**, and **Settings**. ![The MRQ list tabs and identifying columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/98b50dde6cdaffad8c7c95eb0a1d4ebc.png) > **Note:** Work from the headers visible in your list. The list layout determines which columns > you can use to identify a saved MRQ. **Result:** The MRQ list is open with its purchasing tabs and identifying columns. Continue with [Open a new MRQ](#open-a-new-mrq) to create a request, or with [Find a saved MRQ](#find-a-saved-mrq) to return to an existing one. ### Open a new MRQ Use a new MRQ when you need to create the material-requisition record that begins procurement. **Prerequisites** - The MRQ list is available. - Your account may create a new MRQ. **Steps** 1. Open the new-MRQ form from the material-requisition list. 2. Confirm that the blank form opens. 3. Confirm that the blank form shows **MRQ title**, **Required Receiving Date**, **Products**, **Additional Requirements**, **Save**, and **Save and Close**. The list's **Direct P.O.** action is a different entry point from the new-MRQ form. **Result:** The blank MRQ form is open and ready for header entry. No MRQ is saved. Continue with [Enter and save the MRQ](#enter-and-save-the-mrq) to record the request. ### Find a saved MRQ A saved MRQ is the procurement request that can continue into RFQ, direct PO, and follow-up work. Use the saved list row to return to its edit screen rather than reopening the blank form. **Prerequisites** - An MRQ has been saved. - The MRQ list is available. **Steps** 1. Open the MRQ list. 2. Choose the list tab that contains the saved record. 3. Identify the record from **MRQ no.**, **MRQ type**, **Title**, **Required receiving date**, **Sales**, or **Short vendor list**. 4. Open the saved row. 5. Confirm that the saved edit screen shows **RFQ**, **Direct PO**, **Last Modifications**, **Save**, and **Save and Close**. 6. Confirm that the attached product row remains in the product area. The saved record is distinct from the blank form because it has the saved-MRQ actions and retains the attached product row. **Result:** The saved MRQ edit screen is open with its follow-up actions and attached product row. Continue with [Understand the MRQ screen](#understand-the-mrq-screen) to review the saved record, or with [Continue with the saved MRQ](#continue-with-the-saved-mrq) to hand it to procurement. ## Understand the MRQ screen The MRQ screen identifies the request in its header, keeps selected vendors with it, and holds requested products in a separate product area. | Area | What you see | |---|---| | Header | **Branch**, **MRQ title**, **Required Receiving Date**, and **Short Vendors List** | | Product area | **Products**, a grid, and **Additional Requirements** | | Save area | **Save** and **Save and Close** | | Empty grid | `No data` before a product is attached | **MRQ title** and **Required Receiving Date** are required. **Required Receiving Date** cannot be earlier than the date when the purchasing job was created. The product grid shows **#**, **Product**, **Unit**, **Qty**, **Purchasing**, and **Forecasted Receiving Date**. Select the **Short Vendors List** picker to see the available supplier choices. **Products** and **Additional Requirements** are separate actions; they are not two names for the vendor picker. ![The available supplier choices in Short Vendors List](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/485bfc2a58e51cfb76bc4e48d6d5f8e5.png) The editable header shows the required fields and product-entry actions. ## Enter and save the MRQ Enter and save the MRQ when the material requirement is ready to record and at least one product is known. **Prerequisites** - You are on the blank MRQ form. - You know the MRQ title. - You know the required receiving date. - You can select the product to attach. **Steps** 1. Enter the request name in **MRQ title**. 2. Choose a date in **Required Receiving Date** that is not earlier than the date when the purchasing job was created. 3. Select **Products**. 4. In the product picker, use **Product**, **Description**, **Category**, **Group**, **Withdrawal**, **Valuation**, or **Internal product no.** to locate the product. 5. Select the product row. 6. Select **OK**. 7. Confirm that the product appears in the MRQ grid with its row number, description, and `Pieces`; the quantity cell can remain blank until a quantity is entered. 8. Select one save option: | If you want to… | Select | |---|---| | Keep the saved MRQ open | **Save** | | Save the MRQ and leave the form | **Save and Close** | 9. Confirm the message `Saved Successfully`. The product picker also shows **Insert product** and **New product**. **New product** belongs to the product-creation path. ![The product picker and its available-product controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/620e8d58abaea71b3013b48552be2479.png) ![The selected product attached to the MRQ grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/746c268327688a0cde809026458771d0.png) After saving, the edit screen retains **RFQ**, **Direct PO**, **Last Modifications**, **Save**, **Save and Close**, and the attached product row. ![The saved MRQ edit screen and its follow-up actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/fd67a0c133bcc633354518930a96d95a.png) **Result:** The MRQ is saved, `Saved Successfully` appears, and the saved MRQ edit screen is open. Continue with [Handle MRQ variations](#handle-mrq-variations) when the MRQ type or saved state changes, or with [Continue with the saved MRQ](#continue-with-the-saved-mrq) for the next procurement action. ## Handle MRQ variations Variations appear when the MRQ type, saved state, permissions, or action being taken changes. Use the normal creation path first; popup-only fields belong to the action that opens their popup. | Situation | Reader action or condition | Fields or result | |---|---|---| | Additional requirements | Select **Additional Requirements** for an eligible MRQ type | Quantity minimum `0.01` | | Vendor restriction | Open **Short Vendors List** | The picker supplies the available supplier choice | | Product entry | Use **Products** when the MRQ type is stock, project, or needs | The product picker opens | | Requirement entry | Use **Additional Requirements** when the MRQ type is stock, project, or needs | The requirement-entry path opens | | Regret | Open the regret action | **Regret Reason**, **Regret Date**, and **Comment** | | Cancellation | Open the cancellation action | **Cancellation Reason**, **Cancellation Date**, **Amount**, and **Comment** | | Cancellation amount | The cancellation concerns items at Order stage or an order | **Amount** is available | | Rejection | Open the reject action | **Reject Date** and **Comment** | | Delivery | Open the delivery-date action | **Delivery Date** cannot exceed Today | The RFQ and Direct PO actions require a saved MRQ, the relevant permission, no unsaved changes, and a non-child display. **Last Modifications** requires a saved MRQ. **Result:** You use the normal product and vendor actions for initial entry, and reserve popup fields and downstream actions for the state that makes them available. Continue with [When saving goes wrong](#when-saving-goes-wrong) if a message blocks the action, or with [Continue with the saved MRQ](#continue-with-the-saved-mrq) after the action succeeds. ## When saving goes wrong Match the message on screen to the correction in this table. The list export and deletion paths are outside this create-and-find procedure. | Message | What to check or do | |---|---| | `Package must have at least one item` | Add an item to the package before saving. | | `You cannot save without adding at least one product` | Select **Products**, attach a product, and save again. | | `One of products has no quantity` | Enter a quantity for every product row that requires one. | | `Check mandatory field(s)` | Review the required fields, especially **MRQ title** and **Required Receiving Date**. | | `This Field Is Required` | Complete the required field identified beside the message. | | `Required Receiving After` | Choose a receiving date that is not earlier than the date when the purchasing job was created. | | `Saving Error` | The save did not complete; review the form and try the save action again. | | `An error occurred while processing your request` | Review the form and retry after correcting the displayed issue. | | `Server Error` | The server rejected the request; retry when the service is available. | | `Updated Successfully` | The update completed. | | `Updating Error` | The update did not complete; review the form and retry. | | `Loading error` | The requested MRQ content did not load; return to the list and open the record again. | | `Server error` | The server returned an error while processing the action. | | `Converted to cancelled` | The MRQ was converted to the cancelled state. | The messages `Updated Successfully`, `Updating Error`, `Saved Successfully`, and `Saving Error` belong to update or save outcomes. The validation and error messages identify the correction for their respective branches. After correcting a save problem, return to [Enter and save the MRQ](#enter-and-save-the-mrq). ## Continue with the saved MRQ After saving, the MRQ is the record from which procurement work continues. Its saved edit screen shows **RFQ**, **Direct PO**, and **Last Modifications**, as well as **Save** and **Save and Close**. | If you need to… | Select or open | |---|---| | Ask suppliers for quotations | **RFQ** | | Create a direct purchase order | **Direct PO** | | Review the record's change history | **Last Modifications** | | Complete products or requirements | [Complete an MRQ record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/mrq-record-follow-up) | | Follow the MRQ-to-order route | [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) | An active MRQ uses the `Active` state. A cancelled MRQ uses the `Cancelled` state. Continue with the focused RFQ, quotation, purchase-order, direct purchase-order, or saved purchase-job page for that next reader job. **Result:** The saved MRQ remains available for follow-up and for the next procurement hand-off. Use [Complete an MRQ record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/mrq-record-follow-up) for completion work, or follow the [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) for the wider procurement chain. ## Out of scope This page stops at creating, finding, and handing off an MRQ. The following surfaces belong to other reader jobs: - Files panel: `Your request was completed successfully` belongs to the file panel. - File and library dialogs: `Just '_'‘-''.' And '&' Characters Accepted` belongs to shared dialogs. - Product editor: `Forbidden characters detected. Please remove them and try again.` and `The first variant cannot be deleted` belong to product maintenance. - Bill of materials: `This product is already included in BOM`, `Sales order is archived`, `Booked quantity for this job is greater than the required BOM quantity`, `You cannot edit or delete the product after the purchase package is created`, and `You cannot edit the product after the PO is created` belong to BOM work. - Product editor integration: `An error occurred while connecting to your CRM system.` and `Please select one product` belong to product maintenance. - MRQ deletion procedure: `Cannot be deleted. Product is in purchasing`. - MRQ deletion procedure: `Deleted Successfully`. - MRQ deletion procedure: `Job deleted successfully`. List **Export** and row **Delete** are not part of this create-and-find reader job. ## Related - [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) — follow the procurement chain from MRQ through RFQ, quotation, purchase order, and received work. - [Complete an MRQ record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/mrq-record-follow-up) — complete products, requirements, and Last Modifications on a saved MRQ. - Purchase-job RFQs — continue with RFQ work. - Purchase-job orders — continue with purchase-order work. - Create a direct purchase order — continue from **Direct PO**. - Purchase-job record — work with the broader saved purchase-job record. - [Find active purchase job work](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-work-lists) — use the focused work-list pages. # Complete an MRQ record An MRQ is a material requisition request. After the first request exists, complete its requested products and additional requirements, save the record, and review its Last Modifications surface before continuing with purchasing work. ## Complete a saved MRQ record The MRQ status values are `NA`, **Active**, and **Cancelled**. The procurement stages are **MRQ**, **RFQ**, **Quotations**, **POs**, and **Received**. | If you need to… | Go to | |---|---| | Confirm what must exist before you begin | [Before you start](#before-you-start) | | Open the saved record | [Find and open the saved MRQ](#find-and-open-the-saved-mrq) | | Identify fields, grids, and available controls | [Understand the MRQ detail surface](#understand-the-mrq-detail-surface) | | Review requested products or add requirements | [Complete requested products and additional requirements](#complete-requested-products-and-additional-requirements) | | Save the record and inspect its audit history | [Save the completed MRQ and review Last Modifications](#save-the-completed-mrq-and-review-last-modifications) | | Understand why a field or action is absent | [Handle unavailable fields and record conditions](#handle-unavailable-fields-and-record-conditions) | | Correct a validation or save error | [Resolve validation and save errors](#resolve-validation-and-save-errors) | | Continue to RFQ or direct purchase-order work | [Continue with purchasing work](#continue-with-purchasing-work) | | Create the first MRQ request | Create an MRQ | | Follow the full procurement chain | Purchase jobs procurement chain | | Work with the downstream purchase-job record | Purchase-job record | | Work with RFQs after the hand-off | Purchase-job RFQs | | Work with purchase orders after the hand-off | Purchase-job orders | | Work with comments, files, and related history | MRQ comments, files, and history | ## Before you start Have these conditions in place before you work on a saved MRQ: | Before you start | Why it matters | |---|---| | An existing MRQ record | The saved MRQ is ready for follow-up work. | | An editable record | **Save** and **Save and Close** are available only when the record is not shown as a child, the subscription surface is available, and editing is allowed. | | Access for the next purchasing action | **RFQ** and **Direct PO** require a saved record, an editing surface, the required permission, and no job changes. | | A supported MRQ type | **Products** and **Additional Requirements** are available for stock, project, or needs MRQs when the record is not shown as a child. | | A saved MRQ | **Last Modifications** is available on the saved record. | | Leave-screen awareness | Leaving the record is guarded, so finish or save edits before leaving it. | ## Find and open the saved MRQ Follow these steps when the first MRQ request already exists and you need to continue its product or requirement work. **Prerequisites** - You have an existing MRQ and the access conditions in [Before you start](#before-you-start). **Steps** 1. Open the Purchase jobs work area. 2. Open the saved MRQ record. 3. Check that the saved record contains the **Product** and **Qty** columns. 4. Check that the purchase-job entry surface shows **Purchaser**, **Product Type**, **Package Title**, **Sub-supplier**, **Required Offer Type**, **RFQ Date**, **Required Bid Due Date**, **MRQ product**, **+ RFQ**, **Save**, and **Save and Close**. ![Saved MRQ detail surface with the requested-product grid and follow-up controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/826adaa8429de79abeb045a40bf1958f.png) **Result:** The saved MRQ is open with its product and quantity information available for review, and the next purchasing surface is identified. ## Understand the MRQ detail surface The MRQ detail surface is the saved record's working area: it shows the request fields, the requested-product information, available follow-up actions, and the Last Modifications area. | Surface | What to look for | |---|---| | Record fields | **Branch**, **MRQ title**, **Required Receiving Date**, **Required Receiving After**, **Status**, **MRQ products**, and **Additional Requirements**. | | Required fields | **MRQ title** and **Required Receiving Date** carry required rules. | | Receiving-date rule | **Required Receiving Date** must not be earlier than the date the MRQ was created. | | Requested-product grid | **Sales Item No.**, **Product**, **Unit**, **Qty**, **Purchasing**, and **Forecasted Receiving Date**. | | Saved-record product grid | **Product** and **Qty** are read-only columns. | | Available controls | **Save**, **Save and Close**, **RFQ**, **Direct PO**, **Products**, **Additional Requirements**, and **Last Modifications**. | | Controls visible on a saved record | **Save**, **Save and Close**, **Refresh**, **RFQ**, and **Direct PO**. | | Tab values | `comments`, `logHistory`, `subSuppliers`, and `variants`. | The saved-record view showed **Branch**, **MRQ title**, **Required Receiving Date**, **Short Vendors List**, and **Additional Requirements**. In that view, **Short Vendors List** and **Additional Requirements** were readouts rather than visible controls. The Last Modifications area showed this audit text: `The audit log provides you with a chronological sequence of actions performed by the users`. The complete visible product-column set can vary with the saved layout. Work from the headers that appear in your record rather than assuming that every possible product column is present. ## Complete requested products and additional requirements Requested products are the products attached to the saved MRQ. Additional requirements are extra product or quantity rows associated with that request. Review the existing rows first, because the product grid is read-only and the insertion actions are conditional. **Prerequisites** - The saved MRQ is open. - The record is not displayed as a child. - The MRQ type is stock, project, or needs for the insertion actions. **Steps** 1. Review the requested-product rows in the **Product** and **Qty** columns. 2. Choose the applicable insertion path: | If you need to… | Select… | Then… | |---|---|---| | Insert a requested product | **Products** | Enter a quantity of at least `0.01`. | | Insert an additional requirement, when the action is available | **Additional Requirements** | Enter a quantity of at least `0.01`. | 3. Review the rows before saving. The **Products** action inserts a requested-product row. The **Additional Requirements** action inserts an additional-requirement row. Both actions depend on the saved record, the editing surface, and the MRQ type; **Additional Requirements** is not a universal action. When the product picker opens, choose from the options displayed for the record. **Result:** The saved MRQ contains the requested-product and, where available, additional-requirement rows with quantities at or above `0.01`. Continue to the save and audit step. ## Save the completed MRQ and review Last Modifications Save after reviewing the product and requirement rows. Then open Last Modifications to check the saved record's audit history. **Prerequisites** - You have completed the available requested-product and additional-requirement work. - A saved MRQ. - You have the editing and subscription conditions required for saving. **Steps** 1. Choose **Save** or **Save and Close**: | If you need to… | Select… | |---|---| | Save the completed MRQ and remain on the record | **Save** | | Save the record and close the editing surface | **Save and Close** | 2. Select **Last Modifications** on the saved record. 3. Review the audit text `The audit log provides you with a chronological sequence of actions performed by the users`. ![Saved MRQ with Save controls and the Last Modifications audit surface](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/826adaa8429de79abeb045a40bf1958f.png) **Result:** The MRQ is saved, and **Last Modifications** is selected through the record's history-tab action. The saved record remains available for follow-up work. ## Handle unavailable fields and record conditions The saved MRQ can show fewer fields or actions depending on its record context. Use the following conditions to decide whether to continue looking for a control or proceed with the controls that are visible. | What you do not see | What applies | |---|---| | **Required Receiving After** | This field is not available on this working surface. | | **Status** | This field is not available on this working surface. Its options are **Active** and **Cancelled**. | | **Additional Requirements** insertion | The action depends on the MRQ type and record context; it is available for stock, project, or needs MRQs when the record is not shown as a child. | | Initially open Last Modifications | If it is not already open, select **Last Modifications** to view it. | | A product column | Product columns can come from saved layout configuration, so the complete set is determined by what your record displays. | | **Short Vendors List** or **Additional Requirements** control | These appear as readouts on the saved record rather than as visible controls. | Start with the saved-record surface and use the controls actually shown there. The available fields and actions depend on the record context. If a save reports a problem, use [Resolve validation and save errors](#resolve-validation-and-save-errors). ## Resolve validation and save errors Use this table when the MRQ surface stops a save or reports a processing problem. | Message | What to check | Next action | |---|---|---| | `Check mandatory field(s)` | **MRQ title** or **Required Receiving Date** is incomplete. | Complete the required field and select **Save** again. | | `This Field Is Required` | A required date field is empty. | Complete **Required Receiving Date**, then select **Save** again. | | `One of products has no quantity` | A requested-product row has no quantity. | Enter a quantity of at least `0.01` and select **Save** again. | | `You cannot save without adding at least one product` | The saved request has no product row. | Add a requested product through **Products**, then select **Save** again. | | ` Package must have at least one item` | A package has no item. | Add at least one item to the package before saving. | | `Cannot be deleted. Product is in purchasing` | The product is already involved in purchasing. | Do not delete that product from this record; continue with the purchasing work that owns it. | | `An error occurred while processing your request` | The requested processing operation was not completed. | Review the record conditions and retry the appropriate action. | ## Continue with purchasing work After the MRQ is saved and reviewed, **RFQ** starts the purchase path and **Direct PO** starts the direct purchase-order path. The procurement stages that follow are **MRQ**, **RFQ**, **Quotations**, **POs**, and **Received**. **Prerequisites** - A saved MRQ. - The required permission is available. - The editing surface is not displayed as a child and the job has no changes. **Steps** 1. Choose the purchasing path: | If you need to… | Select… | |---|---| | Continue into the purchase path | **RFQ** | | Continue into the direct purchase-order path | **Direct PO** | 2. Check that the purchase-job entry opens. 3. Review **Purchaser**, **Product Type**, **Package Title**, **Sub-supplier**, **Required Offer Type**, **RFQ Date**, **Required Bid Due Date**, **MRQ product**, **+ RFQ**, **Save**, and **Save and Close**. 4. Continue with the purchase-job procedure for the path you selected. **Result:** The saved MRQ hands off to the purchase-job entry surface. The entry surface shows **Purchaser** and **MRQ product**, and remains unsaved. # Comments, files, and history on an MRQ An MRQ is a material requisition: a saved request whose supporting files, discussion, and modification history remain available for follow-up work. ## Before you start The MRQ status values are `NA`, `Active`, and `Cancelled`. Complete the request on the MRQ record, then use its related areas for supporting material, discussion, and history. | If you need to… | Go to | |---|---| | Open the saved MRQ and reach its related areas | [Find and open the saved MRQ](#find-and-open-the-saved-mrq) | | Recognize the saved-MRQ surface | [Understand the saved-MRQ surface](#understand-the-saved-mrq-surface) | | Keep a supporting file with the MRQ | [Keep supporting files with the MRQ](#keep-supporting-files-with-the-mrq) | | Create a library entry | [Enter library details](#enter-library-details) | | Create a folder entry | [Enter folder details](#enter-folder-details) | | Upload supporting material | [Enter upload details](#enter-upload-details) | | Keep written discussion with the MRQ | [Keep discussion with the MRQ](#keep-discussion-with-the-mrq) | | Read the audit history | [Review Last Modifications](#review-last-modifications) | | Complete the MRQ record itself | [Complete an MRQ record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/mrq-record-follow-up) | | Create an MRQ | [Create an MRQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-mrq) | | Manage the wider purchase-job workspace | [Purchase job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-record) | | Use file management outside an MRQ | [Libraries and files](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) | ## Find and open the saved MRQ A saved MRQ has an identifier, so its related tabs can be shown. The tab area is available when the record is saved and the purchasing subscription is included. **Prerequisites** - You are signed in to PAMS. - You have an existing saved MRQ to open. - The purchasing subscription is included for the current account. **Steps** 1. Open an existing saved MRQ. 2. Confirm that `Log in to Pams` is not shown. 3. Confirm that **Last Modifications** is visible. ![The saved MRQ surface with its stage tabs, record fields, item columns, and Last Modifications tab](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5de95b11ab03a9c24121ce4e29a1dee7.png) **Result:** The saved MRQ is open and its related-tab area is available. Continue with [Understand the saved-MRQ surface](#understand-the-saved-mrq-surface). ## Understand the saved-MRQ surface The saved-MRQ surface combines the MRQ record with related follow-up areas. The record controls are **Branch**, **MRQ title**, **Required Receiving Date**, and **Required Receiving After**. | Area | What you can see | |---|---| | Record controls | **Branch**, **MRQ title**, **Required Receiving Date**, **Required Receiving After** | | Item columns | `#`, `Product`, `Unit`, `Qty`, `Purchasing`, `Forecasted Receiving Date` | | Related areas | Discussion, Last Modifications, and files | The surface has six item columns and three buttons: **Save**, **Save and Close**, and **Refresh**. It also includes the MRQ, RFQ, and Direct PO stage tabs. Use [Complete an MRQ record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/mrq-record-follow-up) for record-level completion. The related areas are conditional. The tabs require a saved MRQ and an included subscription; the discussion area requires an available comments list and the **Comments** tab; the history area requires the **Last Modifications** tab. ![The saved MRQ surface before opening a related area](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5de95b11ab03a9c24121ce4e29a1dee7.png) Choose [Keep supporting files with the MRQ](#keep-supporting-files-with-the-mrq) for files, [Keep discussion with the MRQ](#keep-discussion-with-the-mrq) for comments, or [Review Last Modifications](#review-last-modifications) for history. ## Keep supporting files with the MRQ The files surface keeps libraries, folders, and uploaded documents alongside the MRQ. A library is the top-level file area, and a folder is a named area below the current non-default location. | File-surface area | Labels and actions | |---|---| | Search and details | **Keyword to Search...**, **Library name**, **File Name**, **Links**, **Name**, **Type**, **Tags**, **Modified** | | File actions | **Get old cloud**, **Download**, **Link**, **Open**, **Add/Remove tags**, **Rename**, **Export**, **Edit**, **Delete** | | Entry areas | Edit a document, edit document links, create a folder, create a library, or upload a file | The available entry action depends on the current location: | If you need to… | Select | |---|---| | Create a library at library level | **New Library** | | Create a folder below a non-default location | **New Folder** | | Submit a supporting file below a non-default location | **Upload** | Selecting a file can expose **Open** and **Add/Remove tags**. Selecting a folder or library can expose **Rename**. > **Note:** File creation and upload change the supporting material associated with the MRQ. > Review the current location and file name before selecting a committing action. **Prerequisites** - The saved MRQ is open. - The files surface is available. **Steps** 1. Select **New Library**, **New Folder**, or **Upload**, according to the file action you need. **Result:** The selected entry form is open. Continue with [Enter library details](#enter-library-details), [Enter folder details](#enter-folder-details), or [Enter upload details](#enter-upload-details), as applicable. ### Enter library details **Prerequisites** - The library-entry form is open. **Steps** 1. In **Library name**, enter the library name. 2. Select **Save**. **Result:** The library-entry details are submitted. Return to [Keep supporting files with the MRQ](#keep-supporting-files-with-the-mrq). ### Enter folder details **Prerequisites** - The folder-entry form is open. **Steps** 1. In **Name**, enter the folder name. 2. Select **Save**. **Result:** The folder name is submitted. Return to [Keep supporting files with the MRQ](#keep-supporting-files-with-the-mrq). ### Enter upload details An upload adds supporting material to the current file location with the metadata requested by the upload entry. **Prerequisites** - The upload form is open. - You have the supporting file and its metadata ready. **Steps** 1. In **File Name**, enter the file name. 2. In **Type**, select the file type. 3. In **Tags**, enter or select the tags for the file. 4. Submit the supporting file with **Upload**. 5. If you decide not to submit it, select **Cancel**. If the file name fails the file-name character rule, the message is `Just '_'‘-''.' And '&' Characters Accepted`. After a successful file request, the success message is `Your request was completed successfully`. **Result:** The upload form is submitted with **Upload** or closed with **Cancel**. Continue with [Keep discussion with the MRQ](#keep-discussion-with-the-mrq) when you are ready to record discussion. ## Keep discussion with the MRQ Comments are written discussion attached to a saved MRQ. The discussion area requires a saved MRQ, the **Comments** tab, and an available comments list. | If you need to… | Select | |---|---| | Add a new comment | **Post** | | Reply to a displayed comment | **Reply** | | Change your own comment | **Edit** | | Save an edited comment | **Save** | | Leave comment editing | **cancel** | | Open replies | **view sub comments** | | Start comment deletion | **Delete** | | Close the deletion confirmation | **Cancel** | Use **Edit**, **Save**, or **cancel** for your own comment. Use **Reply** when the reply area is shown and you have permission to reply. Use **view sub comments** when the comment has replies. **Prerequisites** - The saved MRQ is open. - The **Comments** tab is available on the current record. - You have permission to use the discussion action you need. **Steps** 1. Select **Comments** when it is available on the saved MRQ. 2. Select the discussion action that matches your work in the table above. **Result:** The selected action opens its editor or confirmation surface. Continue with [Review Last Modifications](#review-last-modifications) when you are ready to review the record history. ## Review Last Modifications Last Modifications is the audit-log surface for reading the chronological sequence of actions performed by users on the saved MRQ. **Prerequisites** - The saved MRQ is open. - **Last Modifications** is visible. **Steps** 1. Select **Last Modifications**. 2. Read the history rows shown for the MRQ. 3. Select a history row when it has changes to open its change details. 4. Select **Refresh** when you need to reload the history. The audit log provides a chronological sequence of actions performed by the users. ![The Last Modifications tab selected on the saved MRQ](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5de95b11ab03a9c24121ce4e29a1dee7.png) **Result:** Last Modifications is open and the saved MRQ's chronological history is available. Continue with [When a follow-up action goes wrong](#when-a-follow-up-action-goes-wrong) if an action does not complete. ## When a follow-up action goes wrong Use the exact message on screen to decide whether the record-level save needs correction or the related surface needs product or administrator follow-up. | What you see | What to do | |---|---| | `Check mandatory field(s)` | Review the required fields in the active entry before submitting again. | | `An error occurred while processing your request` | Stop and request product or administrator follow-up before repeating the action. | | **Comments** is not shown | Continue with **Last Modifications** or return to the MRQ record guidance; Comments is conditional. | If a record-level save displays one of these messages, correct the MRQ record before continuing with related work: - `Package must have at least one item`. - `Cannot be deleted. Product is in purchasing`. - `You cannot save without adding at least one product`. - `One of products has no quantity`. ## Know what to do next After reviewing the available discussion, files, and history, choose the next MRQ or procurement task. | If you need to… | Continue with | |---|---| | Complete requested products or additional requirements on the MRQ | [Complete an MRQ record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/mrq-record-follow-up) | | Create the request because no saved MRQ exists | [Create an MRQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-mrq) | | Continue with the wider procurement workspace | [Purchase job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-record) | | Find active or archived purchase-job work | [Find active purchase job work](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-work-lists) | # Purchase job record Use the Purchase job record to orient a procurement job, see its current stage, and choose the page that owns the next piece of work. ## What a Purchase job record is A Purchase job record is the shared workspace for one procurement job. It brings the common package information together with the work that may follow: material requisition (MRQ), request for quotation (RFQ), quotation, and purchase order. Use it to see the job's position and move to the focused page for the work you need to complete. | If you need to… | Go to | |---|---| | Complete shared information or package items | [Prepare purchase job information](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-information) | | Work with an RFQ | Purchase job RFQs | | Work with a quotation | Purchase job quotations | | Work with a purchase order | Purchase job orders | | Create an MRQ that starts purchasing work | [Create an MRQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-mrq) | | Create a direct purchase order | Create direct purchase order | | Review the procurement chain | [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) | | Review comments, files, or history | [Comments, files, and history on a purchase job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-comments-files-and-history) | ## Before you start The workspace changes with the record's identity, subscription, stage, and open panel. Prepare a route that matches the work you intend to do, and use a saved record before opening its companion tabs. | Check | What it affects | |---|---| | The page is not missing and the subscription includes the feature | The MRQ, RFQ, and quotation areas can be available. | | The job has an ID | The saved-record tabs can open. | | The job is at an eligible stage | The applicable stage panel can appear. | | The applicable panel is open | Its fields and actions can appear. | | Your company configuration defines mandatory fields | Some offer and order fields can be required. | On the edit record surface, **Purchaser**, **Product Type**, and **Package Title** carry required markers, while **Branch** does not. Work from the values and required markers shown on your record. If you cannot change a field or action, use the condition and message shown on screen before asking for access. ## Find and open a Purchase job Choose the route that matches the work you are starting or resuming. | Your goal | Declared route | Use it for | |---|---|---| | Start a purchase job | `new` | A new Purchase job workspace. | | Start a direct order | `newDirectPO` | A direct-order Purchase job workspace. | | Return to a saved job | `edit/:ID` | The workspace for the job identified by its ID. | **Prerequisites** - You know whether the work follows the ordinary procurement chain or starts as a direct order. - For an existing job, you know its record ID. **Steps** 1. Open the route for the work you need: `new`, `newDirectPO`, or `edit/`. 2. If you opened `edit/`, confirm that the Purchase job record surface loads for that ID. 3. If you opened a new route, confirm that the new Purchase job surface loads before entering stage-specific work. **Result:** The applicable Purchase job workspace is open for a new job, a direct order, or a saved record. ### Open the workspace The record surface is the shared area at the top of the workspace. On the edit surface, it contains **Branch**, **Purchaser**, **Product Type**, and **Package Title**. The stage bar shows **MRQ**, **RFQ**, **Offer**, **PO**, and **Received**. Record commands include **Save** and **Save and Close**. Saved records also show saved-record tabs labelled **Attachment**, **Purchase Invoices**, and **Last Modifications**. **Attach File** is visible with the record surface. Open a saved-record tab only after the record has an ID; new records do not meet the tab condition. ![Identify the shared record fields, stage bar, and record commands before opening a panel.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3bcb09d3cc5a2dbf5968aaf73c2e9815.png) ## Understand the workspace Treat the Purchase job record as one workspace with areas that hand work to one another. Shared information identifies the job, package items describe what is being procured, the stage bar shows where the job is in the chain, and the stage panels hold the focused work for that stage. Saved-record tabs keep follow-up information with a saved record. ```mermaid flowchart LR S[Shared information] --> P[Package items] P --> M[MRQ panel] M --> R[RFQ panel] R --> Q[Quotation panel] Q --> O[Purchase-order panel] S --> C[Saved-record tabs] ``` The shared record area owns the record-level commands. The focused pages own the detailed work inside the MRQ, RFQ, quotation, purchase-order, files, and payables areas. > **Note:** List columns can differ. Use the headers shown in the list you opened. ### Shared information and package items Shared information identifies the Purchase job. The package-item area lists the products carried by the job and connects the common record to the stage work. The inquiry, offer, and order grids include these columns: | Column | Where it helps | |---|---| | **Product** | Identifies the product in the row. | | **Unit** | Identifies the row's unit. | | **Qty** | Shows the row quantity. | | **Stage** | Shows the row stage. | The offer and order grids also include **Unit Price**, **Item Price**, **Currency**, **Discount (%)**, and **Tax (%)**. The product-entry action for an MRQ is owned by the focused MRQ work rather than by this workspace map. For detailed shared fields and package-item changes, continue to [Prepare purchase job information](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-information). ### Stage panels Each stage panel is a focused work area for one part of procurement. Its availability depends on the subscription, the job's current stage, the job's related work, and whether that panel is open. | Panel family | When it can appear | Focused work | |---|---|---| | MRQ / inquiry | The subscription is included, the page is present, the job has inquiries at an eligible stage, and the inquiry is open. | MRQ and inquiry work | | RFQ | The subscription is included, the current stage is Offer and before Order, and the offer is open. | RFQ work | | Quotation / offer | The subscription is included, the current stage is Offer and before Order, and the offer is open. | Quotation work | | Purchase order | The current stage is Order through Delivered, or the job is a direct order at Unknown, and the order is open. | Purchase-order work | The ordinary panel flow is MRQ, RFQ, quotation, then purchase order. ![Locate the MRQ stage and its package-item area in the workspace.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e9fb173bda2191108110fc2c6a23d10d.png) ## Save the record and choose a hand-off Record-level saving prepares the shared Purchase job surface for the focused work that follows. The workspace shows **Save** and **Save and Close** as the record commands. **Prerequisites** - You have entered the shared information required on your record. - You have added the package information required for the next stage. - You know whether the next work belongs to the MRQ, RFQ, quotation, or purchase-order page. **Steps** 1. Review the shared record fields and the package-item rows. 2. Select **Save** to keep the record open for the next workspace action. 3. Select **Save and Close** when you have finished the record-level work and want to leave the workspace. 4. Choose the focused page for the next work. | Next work | Focused page | |---|---| | MRQ creation | [Create an MRQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-mrq) | | RFQ work | Purchase job RFQs | | Quotation work | Purchase job quotations | | Purchase-order work | Purchase job orders | **Result:** The shared record-level save command has been chosen, and the next focused page is identified. ![Identify the quotation hand-off after reviewing the shared record.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/7afb0e4f61c9c4c8803ff74a8031ae5f.png) ### Open an order-only panel The order-only branch is a direct-order workspace or a later-stage workspace where the purchase-order panel is available. | Condition | Purchase-order panel availability | |---|---| | Direct order at `Unknown` | The purchase-order panel can appear when the order is open. | | Current stage from **Order** through **Delivered** | The purchase-order panel can appear when the order is open. | | Other stage or a closed order | The order-panel condition is not met. | **Prerequisites** - You are using the `newDirectPO` route or the job is already from **Order** through **Delivered**. - The purchase order is open. **Steps** 1. Open the Purchase job record from the direct-order route or the later-stage record route. 2. Read the stage bar to confirm the job is at `Unknown`, **Order**, or a later stage through **Delivered**. 3. Open the purchase-order panel when it is available. 4. Continue with the purchase-order procedure on the purchase job orders page. **Result:** The direct-order or later-stage workspace is open at the purchase-order hand-off. ![Recognise the order-only branch from the stage bar and purchase-order surface.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/675705bc3734a525afd12d6253b095eb.png) ## Choose the ordinary or direct-order path Use the ordinary path when procurement moves through an MRQ, RFQ, quotation, and purchase order. Use the direct-order path when the work starts directly with a purchase order. | If you need to… | Choose this path | Continue with | |---|---|---| | Start with a material request and obtain supplier quotations | Ordinary procurement chain | [Create an MRQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-mrq), then the MRQ, RFQ, quotation, and purchase-order focused pages. | | Start with a purchase order without the ordinary chain | Direct purchase order | Create direct purchase order, then the purchase-job orders page. | | Understand the whole stage sequence | Ordinary or direct, according to the job | [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) | The direct-order branch has its own creation procedure and uses the order-only condition above. ## When the workspace rejects an action When a panel or record action is refused, first check the current stage, the record ID, the panel's open state, and the package rows. Then match the message on screen to the table below. | What you see | Check before continuing | |---|---| | `Check PO mandatory field(s)` | Complete the mandatory purchase-order fields. | | `Please insert at least one PO` | Add a purchase order before continuing. | | `Check RFQ mandatory field(s)` | Complete the mandatory RFQ fields. | | `Please insert at least one RFQ` | Add an RFQ before continuing. | | `Please insert at least one product` | Add a product to the package or applicable panel. | | `Check mandatory field(s)` | Review the visible required markers and complete those fields. | | `Inquiry must have at least one item` | Add an inquiry item. | | `Offer must have at least one item` | Add an offer item. | | `Order must have at least one item` | Add an order item. | | `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Do not delete items at either of those stages. | | `An error occurred while processing your request` | Review the action and the current record state before retrying. | | `Package products cannot be empty` | Add package products before saving. | | `Please enter action for each milstone ` | Enter an action for each payment milestone. | | `Required Offer Type` | Complete **Offer Type**. | | `Required Bid Due Date` | Complete **Required Bid Due Date**. | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a value in the stated range. | | `Invalid input. Please enter a non-negative value` | Enter zero or a positive value. | | `Invalid input. The tax rate must be between 0 and 100` | Enter a tax rate from 0 through 100. | | `Product package deleted from all inquiries` | The package-deletion action reports completion for inquiries. | | `Product package deleted from all offers` | The package-deletion action reports completion for offers. | | `Product package deleted from all orders` | The package-deletion action reports completion for orders. | | `Item(s) Regretted` | The item action reports that the item is regretted. | | `Item(s) Cancelled` | The item action reports that the item is cancelled. | | `Item(s) Rejected` | The item action reports that the item is rejected. | | `Item(s) Reactivated` | The item action reports that the item is reactivated. | | `Order updated successfully. Undelivered. A draft invoice was deleted` | Review the updated order and its undelivered state. | | `Job reactivated successfully` | The reactivation action reports completion. | | `Email sent to client. Added to emails list activity` | The email action reports that the email was sent and added to email activity. | | `Converted to inquiry successfully` | The conversion action reports completion. | | `Converted to offer successfully` | The conversion action reports completion. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters and retry the action. | | ` You already have a contact with this name` | Review the contact name before continuing with contact work. | | `Your request was completed successfully` | The request reports completion. | | `Just '_'‘-''.' And '&' Characters Accepted` | Use only the characters named by the message. | Stage conditions also explain why a panel is absent: the inquiry panel needs an eligible inquiry and an open inquiry; the RFQ and quotation panels need the Offer stage or earlier and an open offer; the order panel needs the later-stage or direct-order condition and an open order. Tabs need a subscription, a present page, and a record ID. The workspace also carries shared file and contact components. Their messages belong to the focused file-management and contact procedures, not to this workspace map. ### Out of scope This page maps the workspace and its hand-offs. It does not repeat the detailed procedures for shared fields, package-item editing, RFQs, quotations, purchase orders, files, or payables. | Work | Owning page or boundary | |---|---| | Shared fields and package items | [Prepare purchase job information](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-information) | | RFQ actions, fields, and validations | Purchase job RFQs | | Quotation actions, fields, and validations | Purchase job quotations | | Purchase-order fields, approval, and receipt | Purchase job orders | | Comments, attachments, mail activity, and log history | [Comments, files, and history on a purchase job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-comments-files-and-history) | | Payables filters and allocation actions | Payables page | | Contact duplicate-name handling | Contact record page | | File-name character handling | File management page | ## Continue the Purchase job After saving, use the stage bar and saved-record areas to choose the next destination. | If the next task is… | Continue with… | |---|---| | Create or complete the MRQ | [Create an MRQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-mrq) | | Complete shared fields or package items | [Prepare purchase job information](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-information) | | Complete RFQ work | Purchase job RFQs | | Complete quotation work | Purchase job quotations | | Complete, approve, activate, or receive a purchase order | Purchase job orders | | Review files or record history | [Comments, files, and history on a purchase job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-comments-files-and-history) | | Follow the lifecycle from one stage to the next | [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) | The purchase-order list shows **Purchasing no.**, **MRQ no.**, **P.O. no.**, **Purchaser**, **Job stage**, **Package title**, **Forecasted receiving date**, **Order total price (incl. tax)**, **Supplier**, and **Sub-supplier order no.**. Continue from the stage and order surfaces that are available to you. # Prepare purchase job information ## Overview A purchase-job information workspace holds the shared details and package items that define what the business intends to buy. You maintain the job-level information and the products in the package before working with its RFQ, quotation, or purchase-order panels. The procurement process includes the stages **MRQ**, **RFQ**, **Offer**, **PO**, and **Received**. This page covers the shared information and package area across that workspace; the focused RFQ, quotation, and purchase-order actions belong to their own pages. | If you need to… | Go to | |---|---| | Understand the wider purchase-job record | Purchase job record | | Locate existing purchase-job work | Purchase job work lists | | Create an MRQ | Create MRQ | | Maintain shared information and package items | Maintain package items and save the record on this page | | Work with RFQs | Purchase job RFQs | | Work with quotations | Purchase job quotations | | Work with purchase orders | Purchase job orders | | Review comments, files, and history | Purchase job comments, files, and history | | Continue received work | Warehouse fulfillment flow | ## Prerequisites — what must be in place for this to go smoothly Before you edit, open a purchase-job record or a supported new-record route. You also need permission to change the record, and the screen must be available for the current company configuration. > **Note:** The package headers are part of the saved screen layout. Use the headers visible on > your record when you review or enter package information. Prerequisites - The shared information area is available only when the subscription includes it and the page is not unavailable. - You need edit permission for the record. The record-level save actions are unavailable when the record has no changes or while a save is in progress. - Have the purchaser, product type, and package title ready. **Purchaser**, **Product Type**, and **Package Title** are required; **Branch** has no required marker on the edit screen. - The columns in the product-selection and package areas can differ. Use the headers shown on your screen. - Review the values and headers shown before editing. ## Find or start a purchase job Open an existing purchase job or begin a supported purchase-job route before maintaining its shared information. Prerequisites - You are signed in to PAMS. - You know whether you are reviewing an existing purchase job or starting a new one. Steps 1. Open **Purchasing**. 2. Open the route that matches the work: | If you need to… | Use the route | |---|---| | Start a standard purchase job | The supported new purchase-job route | | Start a direct purchase-order route | The supported direct purchase-order route | | Edit an existing purchase job | **Purchase Jobs**, then the purchase job you need to maintain | 3. Confirm that the purchase-job information screen shows **Branch**, **Purchaser**, **Product Type**, and **Package Title**. The screen now shows those shared fields, the package columns, **Save**, **Save and Close**, **MRQ**, and **Received**. Continue with the shared information and package area. **Result:** The purchase-job information screen is open for an existing record or a supported new-record route. ## Understand the shared information and package area The screen combines job-level information with the package products used in purchasing work. The shared fields identify the job; the package area describes its items and their receiving requirements. ### Shared information | Field | What you enter or review | Requiredness | |---|---|---| | **Branch** | The branch associated with the purchase job | No required marker on the edit screen | | **Purchaser** | The purchaser responsible for the job | Required | | **Product Type** | The product classification for the job | Required | | **Package Title** | The title of the package | Required | ### Package and product-selection columns The package grid can show the following columns: | Package column | |---| | **Item No.** | | **Product** | | **Category** | | **Group** | | **MRQ Qty.** | | **MRQ type** | | **Qty** | | **Unit** | | **Required Receiving Date** | | **Job no.** | | **MRQ** | | **V.L.** | | **Is limited V.L.** | | **Stage** | | `Current vendor` | The product-selection area can show these columns: | Product-selection column | |---| | **Product** | | **Description** | | **Quantity** | | **Unit** | | `Required On` | **Vendor** is a required field in the vendor popup. The visible package columns come from the screen layout. They can therefore differ between companies or saved layouts. Use the column headers actually shown in the package area rather than expecting every possible column on every record. ### Stages and record controls The visible stage choices are **MRQ**, **RFQ**, **Offer**, **PO**, and **Received**. The record-level controls and follow-up surfaces include: | Control or surface | Purpose | |---|---| | **Save** | Save changes to the record | | **Save and Close** | Save changes and close the record | | **MRQ** | Open the MRQ stage area | | **Direct P.O.** | Start the direct purchase-order action when available | | **Delete** | Delete from the MRQ list when available | | **Export** | Export from the MRQ list when available | | **Received** | Open the received stage area | | **Purchase Invoices** | Open the purchase-invoice follow-up tab when available | | **Last Modifications** | Open the record-modification follow-up tab | | **Attachment** | Open the attachment area | ![Shared purchase-job fields and record controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3bcb09d3cc5a2dbf5968aaf73c2e9815.png) ![MRQ package columns on the purchase-job record](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/701762b936b9bb1630cb8559da48dafa.png) ## Maintain package items and save the record Maintain the shared job information, choose MRQ products, review package rows, and save the record. Prerequisites - The purchase-job information screen is open. - The shared information area is available and you have edit permission. - You know the purchaser, product type, package title, and products to include. Steps 1. In **Branch**, review or enter the branch for the purchase job. 2. In **Purchaser**, select the purchaser for the job. 3. In **Product Type**, select the product type. The choices are `Complete Product`, `Spare Parts`, `Service`, `Scrap`, `Others`, and `ZZ-doc-Enter-Product-Type-Name`. 4. In **Package Title**, enter the package title. 5. Open **MRQ**. 6. In the product-selection area, select the MRQ products to include. 7. Review the package rows and complete the visible item values, including **Product**, **MRQ Qty.**, **MRQ type**, **Qty**, **Unit**, and **Required Receiving Date** where those columns appear. 8. Select **Save** to keep the changes while remaining on the record. 9. Select **Save and Close** when you want to save the changes and close the record. The MRQ product action opens Planned orders and submits the selected products. The package columns and save controls are available on the record screen. If a required value is missing, the form can show `Check mandatory field(s)`. If the package contains no product, it can show `Package products cannot be empty` or `Please insert at least one product`. Correct the relevant shared field or add a product before trying the save action again. **Result:** The shared information and visible package rows are ready for the next purchase-job surface, subject to the record's current stage and edit conditions. ## Handle stage and record variations What you see can change with the current stage, company configuration, saved layout, and whether the record is editable. | Variation | What changes for you | |---|---| | New standard route | The purchase-job information work starts from a new purchase-job route. | | Direct purchase-order route | The record starts from a direct purchase-order route; direct purchase-order work may be available through **Direct P.O.** | | Existing-record route | Open an existing purchase job for editing. The record shows **MRQ**, **RFQ**, **Offer**, **PO**, and **Received**. | | Stage | Stage areas and controls depend on the current stage. | | Company configuration | Shared fields and conditional fields can depend on the company configuration. | | Saved layout | Read the headers shown in the package and split-row grids; they can differ. | | Edit condition | **Save** and **Save and Close** are disabled when there are no changes or while saving. | Approval and activation conditions for purchase-order actions are handled in the purchase-order area. Use the focused pages for RFQ, quotation, and purchase-order panel procedures. ## When saving or selecting items goes wrong Use the message on screen to choose the correction. These messages belong to shared information or product/package selection; focused pages handle RFQ, quotation, and purchase-order panel messages. | Message | Corrective action | |---|---| | `Please insert at least one product` | Add at least one product in the product-selection area. | | `Package products cannot be empty` | Add package products before saving. | | `Check mandatory field(s)` | Review **Purchaser**, **Product Type**, **Package Title**, and any other required field visible on the current surface. | | `An error occurred while processing your request` | Review the values and try the action again. | | `Your request was completed successfully` | Continue with the next task. | | `Inquiry must have at least one item` | Add an item before completing the inquiry-related action. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the value and retry. | Read the labels and headers on the open screen before entering values. ## Continue after saving the purchase job When the shared information and package items are ready, continue with the surface that matches the next procurement task. The record can expose **Purchase Invoices**, **Last Modifications**, **Attachment**, **Received**, and other record follow-up controls. | Next need | Continue with | |---|---| | Review or maintain RFQs | Purchase job RFQs | | Review or maintain quotations | Purchase job quotations | | Review or maintain purchase orders | Purchase job orders | | Review files, comments, or history | Purchase job comments, files, and history | | Continue after receiving the purchase | Warehouse fulfillment flow | | Review purchase-invoice information | **Purchase Invoices** when that follow-up tab is available | | Review record changes | **Last Modifications** | Use the focused pages for RFQ, quotation, and purchase-order panel actions. Use the warehouse fulfillment flow for work after **Received**. # Manage purchase job RFQs Use this page to create a request for quotation (RFQ) for a purchase job, send it to a sub-supplier or record its submission, and move an eligible RFQ into the offer stage. ## What a purchase-job RFQ is An RFQ is the purchase-job request you send to a sub-supplier for a quotation. It sits after the material requisition (MRQ) and before the quotation stage, so it turns the items requested in the MRQ into a supplier-facing procurement request. The purchase-job flow is: | Stage | What it represents | |---|---| | MRQ | The material request that starts the purchase-job work. | | RFQ | The request sent to a sub-supplier. | | Quotations | The stage that follows an RFQ converted to an offer. | | POs | The purchase-order stage after quotations. | | Received | The receiving stage after the purchase order. | An RFQ can be in one of these stages or exit states: `Draft`, `SentToPrincipal`, `ConsederAsSentToPrincipal`, `ConsederAsNotSentToPrincipal`, `CanceledInquiry`, `RegretToOffer`, and `Offered`. At `SentToPrincipal` or `ConsederAsSentToPrincipal`, use **Receive Offer** to convert the RFQ to an offer. | If you need to… | Go to | |---|---| | Find an RFQ in the purchase-job lists | [Find and open an RFQ](#find-and-open-an-rfq) | | Recognize the RFQ fields and item grid | [Understand the RFQ record](#understand-the-rfq-record) | | Create or correct a draft | [Create and correct an RFQ](#create-and-correct-an-rfq) | | Send or record submission | [Send or record submission and receive the offer](#send-or-record-submission-and-receive-the-offer) | | Reverse, regret, cancel, or delete an RFQ | [Correct or close an RFQ](#correct-or-close-an-rfq) | | Continue with quotations | [Purchase-job quotations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-quotations) | | Work with comments, attachments, or history | [Purchase-job comments, files, and history](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-comments-files-and-history) | ## Before you start An RFQ belongs to a saved purchase job, and the available actions depend on the job stage, whether the RFQ has unsaved changes, and your email access. | Confirm before you start | Why it matters | |---|---| | The purchase job is saved. | RFQ actions require a saved record; the read-only entry check showed **Purchaser** and **MRQ product** on the entry surface. | | The job is a non-direct purchase job before `Order`. | **+ RFQ** is available for this route while the job is at the eligible pre-order stages. | | At least one inquiry exists and the job is after `Unknown` and before `Offer`, or is `Deleted`. | These conditions expose the RFQ panel. | | You can edit the saved record and the RFQ has no unsaved changes. | Saving and submission actions depend on edit access and an unchanged saved RFQ. | | You know whether your account has `Send Email` permission and an active subscription. | These determine whether the screen offers email sending or recording submission without email. | | You have the sub-supplier and item information. | The RFQ identifies the supplier and the items requested. | Before creating an RFQ, open the purchase-job entry and confirm that **Purchaser** and **MRQ product** are present. ![The Purchasing entry surface with Purchaser and MRQ product](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/206a781855b25229ce5538cc0239ce87.png) ## Find and open an RFQ The RFQs list is the starting point for locating existing supplier requests; the purchase-job record is where you work with the RFQ panel. **Prerequisites** - You have access to the **Purchasing** area. - You know the purchase job or supplier request you need to open. **Steps** 1. Open **Purchasing**. 2. Select **RFQs**. 3. In the Purchase Jobs list, select the tab that matches the work you need. | If you need to… | Select | |---|---| | Search all purchase jobs | **All** | | Work with RFQs | **RFQs** | | Work with quotations | **Quotations** | | Work with purchase orders | **POs** | | Find archived work | **Archived** | 4. Select the purchase job. 5. Open the RFQ accordion in the purchase-job record. **Result:** The purchase-job record opens with the RFQ panel available while the job is before `Offer` or is `Deleted`. ## Understand the RFQ record The RFQ panel is the collapsible part of a saved purchase-job record where you choose the supplier, review the request, and work with its items. The **Sub-supplier** picker displays supplier names for eligible principal or sub-supplier accounts and excludes the local branch. The panel identifies the **Sub-supplier**, the **Client**, and the **Currency**. Its item grid shows these three columns: | Column | What to check | |---|---| | **Item Description** | The description of the requested item; this field is required. | | **Unit** | The item's unit; the control is disabled for package items or selected products. | | **Qty** | The requested quantity; enter a value from `1` through `999999`. | The RFQ panel is an accordion, so open it to see its body. The RFQ body is available only while the inquiry is open. The purchase-job tabs are available on a saved purchase job. Follow the required markers shown on your screen. ## Create and correct an RFQ Create a draft when the purchase job needs a supplier request, then correct its supplier or item rows before saving it. A draft keeps the request editable until it is submitted or otherwise staged. The **Sub-supplier** picker displays supplier names for eligible principal or sub-supplier accounts and excludes the local branch; **Required Offer Type** offers the exact rendered choices **firm** and **Budget**. **Prerequisites** - The purchase job is saved, non-direct, and at an eligible stage before **Order**. - You know the sub-supplier and the items to request. - You have edit permission on the record. **Steps** 1. In the purchase-job record, select **+ RFQ**. 2. In **Sub-supplier**, select the supplier for this request. 3. If **Required Offer Type** is shown as required, select the required offer-type choice. 4. In each draft item row, enter or correct **Item Description**. 5. In each draft item row, select **Unit** when the control is available. 6. In each draft item row, enter **Qty** from `1` through `999999`. 7. Select **Save** in the RFQ panel header. If the form rejects the draft, correct the field or item condition named by the message before selecting **Save** again. The RFQ panel is read-only when the record is embedded or you do not have edit permission. An RFQ with an ID can have its draft changes undone before it is staged. **Delete RFQ** is available only for an unstaged RFQ when the purchase job contains more than one RFQ. Package items and selected products can make **Unit** unavailable. Package selection also requires at least one package item, and the item-selection action can stop when all remaining items are already selected. **Result:** The purchase job contains a saved, editable RFQ draft, or the displayed validation message identifies the supplier, item, or package value that needs correction. ## Send or record submission and receive the offer Submission moves a saved unchanged draft from preparation into supplier follow-up. The screen chooses between sending an email and recording submission according to your `Send Email` permission and subscription. **Prerequisites** - The RFQ is saved, unchanged, and has an ID. - The RFQ is an unsubmitted draft. - For email sending, your account has `Send Email` permission and the required subscription. **Steps** 1. Select the action that matches the RFQ state. | Condition | Action | |---|---| | Email sending is allowed | Select **Send RFQ To Sub-supplier**. | | Email sending is not allowed | Select **Consider RFQ As Submitted To Sub-supplier**. | | The RFQ is at `SentToPrincipal` and must be sent again | Select **Re-send RFQ To Sub-supplier**. | | The RFQ is at `SentToPrincipal` or `ConsederAsSentToPrincipal` and the offer is ready | Select **Receive Offer**. | | The RFQ is at `SentToPrincipal` or `ConsederAsSentToPrincipal` and the submitted state must be reversed | Select **Consider RFQ As Not Submitted**. | **Result:** Recording submission sets the inquiry stage to `ConsederAsSentToPrincipal` and displays `Inquiry submitted to client`. Receiving the offer converts the purchase job to the offer stage and displays `Converted to offer successfully`. ## Correct or close an RFQ After submission, the RFQ exposes only the corrections and closing actions allowed for its current stage. Use the action that matches the stage instead of assuming that every RFQ action is available everywhere. **Prerequisites** - The RFQ is open in its purchase-job record. - The current stage is visible before you choose a reversal, regret, cancellation, download, or deletion action. **Steps** 1. Select the action that matches the RFQ state and the correction you need. | Condition | Action | |---|---| | The RFQ is at `SentToPrincipal` or `ConsederAsSentToPrincipal` and needs correction | Select **Enable Editing**. | | The RFQ is at `SentToPrincipal` or `ConsederAsSentToPrincipal` and must be marked as regretted | Select **Regretted To Offer**. | | The RFQ is at `SentToPrincipal` or `ConsederAsSentToPrincipal` and must be cancelled | Select **Cancel RFQ**. | | The RFQ is at `CanceledInquiry` and must be restored | Select **Consider RFQ As Not Cancelled**. | | The RFQ is at `RegretToOffer` and the regret state must be reversed | Select **Consider As Not Regretted**. | | Printing is allowed | Select **RFQ template**. | | The RFQ is unstaged and the purchase job has more than one RFQ | Select **Delete RFQ**. | **Result:** The RFQ changes only to the reversal, regret, cancellation, template, or deletion state exposed for its current stage. The available exit states include `CanceledInquiry`, `RegretToOffer`, and `ConsederAsNotSentToPrincipal`. ## When an RFQ action fails Match the message on screen to the correction below before repeating the action. | Message | Corrective action | |---|---| | `Check mandatory field(s)` | Complete the required RFQ fields shown on the form. | | `Inquiry must have at least one item` | Add an item to the inquiry before saving or submitting it. | | `Please select one or more items to create a RFQ.` | Select at least one item for the new RFQ. | | `An error occurred while processing your request` | Check the RFQ stage and record permissions before retrying. | | `No remaining items. All items have been selected` | Review the selected items; there are no unselected items left to add. | | `Package must have at least one item` | Add an item to the package. | | `This action is only allowed if you belong to that branch` | Use a branch to which your account belongs. | | `Please enter at least one email` | Enter at least one email address before sending. | | `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Leave those items in place and choose another item to remove. | | `Package products cannot be empty` | Add products to the package before saving it. | Saving validates the RFQ before committing it. If you leave with unsaved work, the screen's deactivation guard protects that work. ![The RFQ action area and validation context](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/206a781855b25229ce5538cc0239ce87.png) The RFQ messages also include the following messages. Apply the correction indicated by the message before retrying the action. | Message | When to use it | |---|---| | `This Field Is Required` | Complete the field marked as required. | | `Required Offer Type` | Complete the **Required Offer Type** field. | | `Required Bid Due Date` | Complete the **Required Bid Due Date** field. | | `Product package deleted from all inquiries` | Confirm the package deletion result. | | `Item(s) Regretted` | Confirm the regret result. | | `Item(s) Cancelled` | Confirm the cancellation result. | | `Item(s) Rejected` | Confirm the rejection result. | | `Item(s) Reactivated` | Confirm the reactivation result. | | `Email sent to client. Added to emails list activity` | Confirm the email-send result in the email activity. | | `Converted to offer successfully` | Continue with the offer stage. | | `Please insert at least one product` | Select at least one product. | | `Please insert at least one RFQ` | Create or select at least one RFQ. | | `Check RFQ mandatory field(s)` | Complete the required RFQ fields. | | `Selected sub-supplier is not among the requested vendors` | Select a requested sub-supplier. | | `This account already exists. Would you like to consider it as a sub-supplier?` | Choose the offered sub-supplier option when it matches the request. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters. | | `You already have a contact with this name` | Use a different contact name. | | `Your request was completed successfully` | Confirm that the requested action completed. | | `Just '_'‘-''.' And '&' Characters Accepted` | Use only the accepted characters. | | `Product package deleted from all offers` | Continue with the quotation-stage record. | | `Product package deleted from all orders` | Continue with the purchase-order record. | | `Order updated successfully. Undelivered. A draft invoice was deleted` | Continue with the updated order. | | `Job reactivated successfully` | Continue with the reactivated job. | | `Converted to inquiry successfully` | Continue with the inquiry record. | | `Check PO mandatory field(s)` | Complete the required purchase-order fields. | | `Please insert at least one PO` | Add at least one purchase order. | | `Offer must have at least one item` | Add at least one quotation item. | | `Order must have at least one item` | Add at least one purchase-order item. | | `Please enter action for each milstone ` | Enter an action for each payment milestone. | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a value within the displayed range. | | `Invalid input. Please enter a non-negative value` | Enter zero or a positive value. | | `Invalid input. The tax rate must be between 0 and 100` | Enter a tax rate from `0` through `100`. | ### Out of scope — Libraries and files, contact editing, and payment milestone editing Use [Purchase-job comments, files, and history](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-comments-files-and-history) or [Libraries and files](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) for the **Attachment** and **Last Modifications** tabs. Use [Contact record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contact-record) for contact editing. Payment milestone editing is outside this RFQ task. ## Continue after the RFQ An offered RFQ becomes a quotation-stage purchase job. From there, procurement work continues through **Quotations**, **POs**, and **Received**; RFQ work and quotation work remain on separate pages. Select [Purchase-job quotations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-quotations) to continue with the quotation stage and the quotation-to-purchase-order work. # Manage purchase job quotations ## Manage purchase job quotations A purchase-job quotation is the offer record created from a request for quotation (RFQ). Use it to review the offer, check its required information, validate it, convert it to a purchase order (PO), or choose a correction path when the offer needs to change. The purchase-job flow is ordered as follows: ```mermaid stateDiagram-v2 MRQ --> RFQ RFQ --> Offer Offer --> Order: Valid Offer / Convert To PO Order --> Delivered ``` The quotation belongs to the `Offer` part of this flow. The preceding RFQ work creates the quotation; quotation work decides whether the offer is valid and ready to become an order. See the purchase-job RFQ page for the request stage and the purchase-jobs procurement-chain page for the full sequence. | If you need to… | Go to | |---|---| | Find the saved quotation record | Purchase-job work lists | | Review the quotation panel and related tabs | Understand the quotation panel on this page | | Check the job and offer values | Purchase-job fields and Offer fields on this page | | Validate an eligible offer or convert it to a PO | Validate and convert a quotation on this page | | Handle a rejection, cancellation, revision, alternative, or return | Create alternatives, revisions, and returns on this page | | Work with comments, attachments, or history | Purchase-job comments, files, and history | | Continue after the quotation becomes a PO | Purchase-job orders | | Find exception or archived purchase-job work | Purchase-job exception lists | The quotation task ends when `Offer` hands off to `PO`. Approval, activation, receipt, amendments, and later purchase-order work belong in the purchase-job orders page. ## Before you start Before you work on a quotation, have the saved purchase job and its RFQ-created quotation available. The purchase-job record supplies the job identity; the offer area supplies the quotation values and item list. Its required identifying fields are **Purchaser**, **Product Type**, and **Package Title**. | Have or know | Why it matters | |---|---| | The saved purchase job | The quotation is worked from the purchase-job record. | | The RFQ-created quotation | Quotation actions belong to the offer created after RFQ work. | | Purchaser | Identifies the purchaser responsible for the job. | | Product Type | Identifies the product type used by the job. | | Package Title | Identifies the package being worked. | | The current stage | Quotation actions are stage-dependent, so the available action set changes with the record stage. | The main record fields appear when the subscription condition and page condition both allow the surface: `!subscriptionNotInclude && !PageNotFound`. The `IsAccepted` checkbox is limited to the offer stage, before the order stage, and when the offer collection contains items. Quotation actions are stage-dependent. When their stage conditions allow them, the offer section contains **Valid Offer**, **Convert To PO**, **Alternative Offer**, **Revision**, **Rejected Offer**, **Denied To Extend**, and **Back to RFQ**. The next section shows how to open the saved quotation. ## Find and open a quotation A quotation record is the saved purchase-job record that contains the RFQ-created offer, its item grid, and the stage-dependent quotation actions. **Prerequisites** - Have a saved purchase job with an RFQ-created quotation. - Start from the purchase-job work lists or another link to the saved record. **Steps** 1. Open the purchase-job work list. 2. Select the saved purchase job that contains the quotation. 3. Open the quotation record. ![Identify the saved purchase-job record and its stage bar before opening quotation work.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3bcb09d3cc5a2dbf5968aaf73c2e9815.png) **Result:** The purchase-job quotation record is open, with its stage bar and available quotation surfaces visible. ## Understand the quotation panel The quotation panel is the offer area of the purchase-job record. It brings together the stage bar, offer actions, vendor entry, item grid, and related purchase-job tabs. The stage bar contains MRQ, RFQ, Offer, PO, and Received. Work on quotation values in `Offer`; after conversion, continue in `PO`. The panel's contents are stage-dependent. The vendor value is entered through the vendors popup, where **Vendor** is required. It is not a field to look for in the shared purchase-job fields area. The item grid shows these headers: | Item-grid header | What to review | |---|---| | Product | The product on the quotation item. | | Category | The item's category. | | MRQ Qty. | The quantity from the material request. | | Qty | The quoted quantity. | | Unit | The quantity unit. | | Unit Price | The price for one unit. | | Discount (%) | The item discount percentage. | | Item Price | The resulting item price. | | Currency | The item's currency. | | Tax (%) | The item tax percentage. | | Stage | The item's current purchase-job stage. | Related surfaces can include **Purchasing PO template**, **Cancel PO**, **Back to Offer**, **Partial delivery**, **Attachment**, **Purchase Invoices**, **Last Modifications**, **Attach File**, and **Tickets**. The files view can display **No Files**. The quotation panel does not place **PO No.**, **Forecasted Receiving Date**, **Forecasted Logistics Costs**, **Logistics Costs**, **Rate to**, **Category**, **File name**, **Tags**, **Modified**, **Mail subject**, or **Priority** in its own quotation component. Use the purchase-order surfaces for order values, and use the related tabs for files and history. ![Use the stage bar, item-grid headers, and related tabs to orient yourself before changing an offer.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3bcb09d3cc5a2dbf5968aaf73c2e9815.png) ### Purchase-job fields The shared purchase-job fields identify the job that owns the quotation. They appear only when the main record surface is available under the subscription and page conditions. | Field | Required | Use | |---|---:|---| | Branch | No | Identifies the branch associated with the purchase job. | | Purchaser | Yes | Identifies the purchaser responsible for the job. | | Product Type | Yes | Identifies the product type for the job. | | Package Title | Yes | Identifies the package for the job. | **Purchaser**, **Product Type**, and **Package Title** carry required markers. **Branch** does not carry a required marker. ### Offer fields The offer fields describe the supplier's quotation before it is validated or converted. The offer field set includes **Offer No.**, **Offer Type**, **Offer Date**, **Validity Period**, **Delivery Time**, **Delivery Term**, **Payment Method**, **Payment Period**, **Status**, and **Vendor**. | Field | Requirement or choice | |---|---| | Offer No. | Configurable in the quotation surface. | | Offer Type | Configurable; the named choices are `Firm` and `Budget`. | | Offer Date | Configurable. | | Validity Period | Configurable. | | **Delivery Time** | Select a time period from the available time-period records. Each option is shown by its `Name`. | | **Delivery Term** | Select a delivery-term record from the list. Each option is shown by its `Code`. | | **Payment Method** | Select a payment-method record from the list. Each option is shown by its `Code`. | | Payment Period | Configurable. | | **Status** | Select an offer-status record from the list. Each option is shown by its `Name`. | | Vendor | Required in the vendors popup. | Review the item grid using the headers listed above. Enter the values that belong to the quotation you are working on, then continue to validation. ### Purchase-order fields Purchase-order fields describe the record after quotation work reaches the purchase-order stage. The purchase-order area includes the following values: | Group | Fields | |---|---| | Order identity | **Sub-supplier**, **PO No.**, **Sub-Supplier Order No.** | | Dates | **Order Date**, **Order Activation Date**, **Forecasted Receiving Date**, **Forecasted Shipping Date**, **Actual Shipping Date**, **Forecasted In-port Arrival Date**, **Actual In-port Arrival Date**, **Forecasted Out-port Leaving Date** | | Commercial terms | **Delivery Time**, **Delivery Term**, **Payment Method**, **L/C Number**, **Payment Period**, **Status**, **External PO no.** | | Logistics costs | **Forecasted Logistics Costs**, **Logistics Costs** | The purchase-order readout includes `PO/Draft`, `PO No.: PO26.1021`, `Order Price: 100.00 €`, and **Approved**. These are record values, not values to enter for a new quotation. ## Validate and convert a quotation Validation checks whether the offer has the information needed for the next purchase-job stage. Conversion hands an eligible offer from `Offer` to `PO`. **Prerequisites** - Open the saved purchase-job quotation. - Work from the `Offer` stage. - Complete the required purchase-job fields: **Purchaser**, **Product Type**, and **Package Title**. - Enter the required **Vendor** in the vendors popup. - Have at least one quotation item. - Choose an **Offer Type**: `Firm` or `Budget`. **Steps** 1. Review **Purchaser**, **Product Type**, and **Package Title** in the purchase-job area. 2. Review **Vendor** in the vendors popup. 3. Review the quotation item grid. 4. Choose `Firm` or `Budget` in **Offer Type**. 5. Select **Valid Offer**. | Message | Action | |---|---| | `Check RFQ mandatory field(s)` | Complete the required RFQ fields. | | `Offer must have at least one item` | Add or retain at least one quotation item. | | `Required Offer Type` or `Required Bid Due Date` | Complete the corresponding required value. | 6. Select **Convert To PO**. | Message | Action | |---|---| | `Check PO mandatory field(s)` | Complete the required purchase-order fields. | | `Please insert at least one PO` | Add at least one PO. | 7. Check the stage bar for the `PO` stage. The product can display these validation messages while the offer is being checked: `Check RFQ mandatory field(s)`, `Offer must have at least one item`, `Required Offer Type`, and `Required Bid Due Date`. During purchase-order validation it can display `Check PO mandatory field(s)` or `Please insert at least one PO`. Complete the required values before selecting **Valid Offer** or **Convert To PO**. If the record does not satisfy a required condition, follow the message shown on screen. **Result:** The quotation is either stopped with the matching validation message, or the record reaches the purchase-order hand-off shown by the `PO` stage. Continue purchase-order work in the purchase-job orders page. ## Create alternatives, revisions, and returns The offer action area provides separate branches for an alternative, a revision, rejection, cancellation, extension denial, or return to RFQ work. Choose the branch that matches the correction required for the quotation. | If you need to… | Select | |---|---| | Create an alternative offer | **Alternative Offer** | | Create a revision | **Revision** | | Mark the offer as rejected | **Rejected Offer** | | Cancel the RFQ from offer work | **Cancel RFQ** | | Deny an extension | **Denied To Extend** | | Return to RFQ work | **Back to RFQ** | The relevant popup can ask for **Comment**, **Cancellation Reason**, **Regret Date**, or **Reject Date**. **Prerequisites** - Open the quotation record at the stage where the required branch action is available. - Have the reason or date information needed by the popup. **Steps** 1. Select the branch and complete the popup fields shown for it. | Required branch | Select | Complete the popup field shown | |---|---|---| | Alternative offer | **Alternative Offer** | The available popup information. | | Revision | **Revision** | The available popup information. | | Rejection | **Rejected Offer** | **Comment** or **Reject Date**. | | Cancellation | **Cancel RFQ** | **Cancellation Reason**. | | Extension denial | **Denied To Extend** | The available popup information. | | Return to RFQ work | **Back to RFQ** | The available popup information. | 2. Complete the popup's available confirmation action. 3. Check the message shown after the action. The corresponding success messages are `Item(s) Regretted`, `Item(s) Cancelled`, `Item(s) Rejected`, `Item(s) Reactivated`, and `Job reactivated successfully`. **Result:** The selected quotation branch is submitted with its available popup information, or the record remains on the quotation surface with the message that identifies the correction. ## When a quotation action is refused A refused action means the quotation or the current account context does not meet a required validation, permission, subscription, or processing condition. Use the message on screen to choose the correction. | Message | Correction | |---|---| | `Check mandatory field(s)` | Review the visible required fields and complete them before selecting the action again. | | `Please insert at least one product` | Add at least one product to the purchase-job work. | | `Please insert at least one RFQ` | Return to the RFQ work and add at least one RFQ. | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a value greater than 0 and no greater than `999,999.00`. | | `Invalid input. Please enter a non-negative value` | Enter `0` or a positive value. | | `Invalid input. The tax rate must be between 0 and 100` | Enter a tax rate from `0` through `100`. | | `This action is only allowed if you belong to that branch` | Work in a branch to which your account belongs. | | `No remaining products. All package products have been selected` | Review the selected package products before trying to add another one. | | `Package products cannot be empty` | Add package products before retrying the action. | | `An error occurred while processing your request` | Check the record values and retry the action. | | `Product package deleted from all inquiries` | Review the inquiry records after deleting a product package. | | `Product package deleted from all offers` | Review the offer records after deleting a product package. | | `Product package deleted from all orders` | Review the order records after deleting a product package. | | `Order updated successfully. Undelivered. A draft invoice was deleted` | Review the updated order and its invoice area. | | `Email sent to client. Added to emails list activity` | Review the email activity when the message is sent. | | `Inquiry must have at least one item` | Add an item to the inquiry before continuing. | | `Order must have at least one item` | Add an item to the order before continuing. | | `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Keep items at these stages in the record. | | `Please enter action for each milstone ` | Enter an action for each milestone. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters and retry. | | ` You already have a contact with this name` | Use a different contact name. | | `Your request was completed successfully` | Continue after the completed request. | | `This Field Is Required` | Complete the field before retrying. | | `Input contains forbidden characters(< , >). Please remove them and try again.` | Remove `<` and `>` and retry. | | `Min value is 1` | Enter a value of at least `1`. | | `Cannot be un-delivered — a due invoice already exists` | Review the due invoice before changing delivery status. | | `Check validation` | Review the validation requirements before retrying. | | `Error {{errorMsg}}` | Read the error text and correct the related value. | | `Converted to inquiry successfully` | Continue with the converted inquiry. | | `Converted to offer successfully` | Continue with the converted offer. | | `Please enter at least one email` | Enter at least one email address before retrying. | Use the named quotation actions listed above when choosing a branch. After the branch is resolved, continue with the purchase-order hand-off when the quotation reaches `PO`. ## Continue with the purchase order The purchase-order hand-off begins when a quotation moves from `Offer` to `PO`. The stage bar then continues through `PO` and `Received`, and **Convert To PO** starts this hand-off. **Prerequisites** - Complete the quotation review and validation work. - Confirm that the record is ready for the purchase-order stage. **Steps** 1. Select **Convert To PO** from the eligible offer. 2. Check that the stage bar shows `PO`. 3. Open the purchase-job orders page for approval, activation, receipt, amendments, and later purchase-order work. **Result:** The quotation task ends at the purchase-order hand-off, and purchase-order procedures own the next actions. # Manage purchase orders A purchase order is the order-stage procurement panel for an existing purchase job. Use this page after a quotation has been converted to an order, before activation, receipt, and Warehouse work. Direct purchase-order creation is covered by [Create a direct purchase order](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-direct-purchase-order); locating the existing job is covered by [Find active purchase job work](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-work-lists). ## Manage purchase orders The purchase-order panel carries an order through approval, award submission, activation, and receipt-related work. The procurement lifecycle places the order stage after quotation work and before the received stage. | If you need to… | Go to | |---|---| | Find the saved purchase job that contains the order | [Find active purchase job work](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-work-lists) | | Review the quotation before its hand-off | [Manage purchase-job quotations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-quotations) | | Open and review the order panel | [Find and open the purchase job](#find-and-open-the-purchase-job) | | Read or complete order fields | [Order information](#order-information) | | Save an editable order or request approval | [Save the order and request approval](#save-the-order-and-request-approval) | | Approve the order award | [Approve and submit the order award](#approve-and-submit-the-order-award) | | Activate an order or record order-side receipt | [Activate the order and record receipt](#activate-the-order-and-record-receipt) | | Amend, correct, cancel, reject, or return an order | [Amend, correct, or close the order](#amend-correct-or-close-the-order) | | Review comments, files, and history | [Comments, files, and history on a purchase job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-comments-files-and-history) | | Continue with physical receipt and stock work | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | | Create an order without quotation conversion | [Create a direct purchase order](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-direct-purchase-order) | ```mermaid stateDiagram-v2 Quotation --> Order: quotation conversion Order --> AwaitingApproval: Request Approval AwaitingApproval --> Approved: Approved Approved --> AwardSubmitted: Send order award to Sub-supplier Approved --> AwardSubmitted: Consider PO award as submitted AwardSubmitted --> AwaitingActivation: Activate PO AwaitingActivation --> Received: receipt action ``` The order panel is the place for the order-side decisions in this flow. Physical receiving, stock handling, and Warehouse operations belong to [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow). ## Before you start A saved order is required for approval and award actions. The order area is available only when the subscription and page are available, the purchase job is in the order-through-delivered range, and the order is open. | Check before you begin | Why it matters | |---|---| | The purchase job already exists and the order is saved | Approval and award actions require an existing saved order. | | The purchase job is between Order and Delivered | The order area and its actions are stage-dependent. | | You have edit access | Saving, approval, award, activation, and corrective actions use the edit-access guard. | | The order has no unsaved changes before approval or award | Approval and award actions require a saved, unchanged order. | | Your company knows whether approval is enabled | **Request Approval** and **Approved** appear under different approval conditions. | | Your company knows whether the mail feature is available | **Send order award to Sub-supplier** is shown when mail is available; otherwise **Consider PO award as submitted** is shown. | | The purchase-order mandatory-field configuration is known | Fields marked configurable are required only when the company configuration makes them mandatory. | After approval, the order panel is read-only unless editing is allowed. You can edit an order at or after **Approved** but before **Delivered**, or when it is marked as awaiting activation. Confirm the approver through your company’s approval assignment before requesting approval. ## Find and open the purchase job Use this procedure to review an existing order without selecting a state-changing action. **Prerequisites** - You know the saved purchase job to open. - The job is available in the purchase-job work list. **Steps** 1. Open the saved purchase job record. 2. Select **PO**. 3. Expand the order panel. 4. Open the order action menu. 5. Review the fields and actions without selecting an action that changes the order. The PO tab opens with the expanded panel, **Sub-supplier**, **Order Date**, and `PO/Draft` state. You can review the panel and action menu without changing the order. **Result:** The **PO** panel is open, the order fields and current actions are visible, and the order remains unchanged. ## Understand the purchase-order workspace The purchase-order workspace combines the order summary, editable order information, item table, totals, currency area, payment milestones, related tabs, and a state-dependent action menu. The order action menu changes with the order state and company features. | Workspace area | What you use it for | |---|---| | Order summary and editor | Review the supplier, number, dates, terms, payment, status, and logistics information. | | Item grid | Review or change item quantities, prices, discounts, and tax values when editing is available. | | Totals and currency area | Review item totals, tax, total price including tax, local-currency values, and currency rate entry. | | Payment-milestone area | Review logistics costs and the payment milestone when the milestone surface applies. | | Related tabs | Open **MRQ**, **RFQ**, **Offer**, **PO**, **Received**, **Attachment**, **Purchase Invoices**, or **Last Modifications**. | | Supporting areas | Use **Attach File**, **No Files**, and **Tickets** where those surfaces are available. | | Action menu | Review state-dependent actions such as **Approved**, **Purchasing PO template**, **Cancel PO**, and **Back to Offer**. | The item grid shows the following columns. | Item-table column | Use | |---|---| | **Product** and **Unit** | Identify the product and its unit. | | **Qty** | Review or change the quantity when editing is available. | | **Unit Price** and **Item Price** | Review the unit and calculated item prices. | | **Currency** | Identify the row currency. | | **Stage** | Review the item stage. | | **Discount (%)** and **Tax (%)** | Review or change the percentage values when editing is available. | | **Category** and **MRQ Qty.** | Review the category and MRQ quantity. | The order grid uses the columns listed above. **Name** and **Item Description** do not appear in the order grid. The totals area includes `Count`, **Product**, **Tax**, `Currency`, `Total Price: incl. tax`, **In Local Currency**, **Enter rate**, and **Backlog**. The payment area can show `Logistics Costs - Payment Milestone (1 Installment(s))`. The **Payment Milestone** area appears for the applicable offer- or order-milestone popup, and **Enter rate** appears when the order currency differs from the sales currency. Dates use the product's `dd MMM yyyy` display format. **Order Date** cannot be later than today. **Order Activation Date** and **Forecasted Receiving Date** cannot be earlier than **Order Date**. ### Order information Order information records who receives the order, how it is delivered and paid, what it costs, and which dates and state details govern the next action. | Area | Fields and rules | |---|---| | Supplier and identifiers | **Sub-supplier**, **PO No.**, **Sub-Supplier Order No.**, and **External PO no.** identify the order and its supplier-side reference. **Vendor** is not a separate reader-facing order field here. | | Dates | **Order Date**, **Forecasted Receiving Date**, **Forecasted Shipping Date**, **Actual Shipping Date**, **Forecasted In-port Arrival Date**, **Actual In-port Arrival Date**, and **Forecasted Out-port Leaving Date** describe order and logistics timing. **Forecasted Receiving Date** cannot be earlier than the order date. | | Delivery and payment | **Delivery Time**, **Delivery Term**, **Payment Method**, **L/C Number**, and **Payment Period** carry delivery and payment choices. The **Payment Method** list contains company payment-method records and displays each record by **Code**. | | State and receipt | **Status**, `Is Partial Delivery Allowed`, **Order Activation Date**, and **Received On** show or control order progression. **Order Activation Date** is optional and cannot be earlier than the order date. **Received On** is required in receipt popups and cannot be later than today. | | Logistics and currency | **Forecasted Logistics Costs** and **Logistics Costs** accept non-negative values. The local-currency rate is required in its popup and cannot be negative. | | Cancellation | **Cancellation Reason** is required in cancellation popups. **Cancellation Date** and **Amount** are not required there. | | Rejection | **Reject Date** is required in rejection popups. | Company configuration controls the required state of **Delivery Time**, **Delivery Term**, **Payment Method**, **Payment Period**, **Status**, and **Cancellation Reason**. Required markers appear on **Sub-supplier**, **Purchaser**, **Product Type**, and **Package Title** when company configuration makes them required. ## Save the order and request approval Save an order after changing editable order fields. Request approval only after the saved order passes validation and the company approval route requires another approver. **Prerequisites** - The order is saved and open. - You have edit access. - The order is in the order-through-delivered job-stage range. - You know who your company has assigned to approve this order when approval is enforced. **Steps** 1. In an editable order, enter or correct the required order information. 2. Select **Save**. 3. Enter the corrected value in the affected order field. | Message | Correction | |---|---| | `Order must have at least one item` | Add at least one order item. | | `Please enter action for each milstone ` | Enter an action for each payment milestone. | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Correct the affected quantity. | | `Invalid input. Please enter a non-negative value` | Enter zero or a positive value in the affected price or cost field. | | `Invalid input. The tax rate must be between 0 and 100` | Enter a tax rate from 0 through 100. | 4. Select the action again. 5. When approval is enabled and the order is below Approved, select **Request Approval**. If the order has no item, the product grid cannot provide a complete order. If a configurable mandatory field is empty, use the field marker and the order information table above to complete that field before saving. **Result:** The order is saved when validation passes. When approval is enabled and the order is eligible, it enters the approval route and the order can show `Order Awaiting Approval from Manager`. ## Approve and submit the order award Approval changes the order's approval state; award submission then records that the approved order has been sent or treated as submitted to the **Sub-supplier**. **Prerequisites** - The order is saved with no unsaved changes. - You are the person assigned by your company's approval configuration, or approval is disabled. - For mail submission, the mail feature is available. **Steps** 1. For an order that is below Approved, select **Approved** when you are allowed to approve it. A successful approval displays `Order approved successfully`. 2. Select the award action that matches your company's approval and mail settings. | Condition | Select | |---|---| | Approval is enabled and the order is approved | **Send order award to Sub-supplier** | | Approval is disabled or mail is unavailable | **Consider PO award as submitted** | The mail branch requires an approved order when approval is enabled. The non-mail branch is shown when the mail feature is unavailable and can also apply at or before Approved when approval is disabled. The award actions produce `Order submitted to sub-supplier`; the mail branch also produces `Email Successfully Sent to sub-supplier .. Email Added to Activity Emails List`. **Result:** The order is approved by the assigned approver, then the available award-submission route records the award as submitted to the **Sub-supplier**. ## Activate the order and record receipt Activation records the move from awaiting activation into active order work. Receipt records the order-side received date; reversing receipt returns a delivered order to the not-received route. Physical receiving and stock operations remain in [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow). **Prerequisites** - The order is saved with no unsaved changes. - You have edit access. - The order is in `Awaiting Activation` or `Consider As Awaiting Activation` for activation, or in **Delivered** for reversing receipt. **Steps** 1. Select the order-side action that matches the work in the table. | Work | Action | |---|---| | Activate an order awaiting activation | **Activate PO** | | Record receipt | The order-side receipt action | | Return a delivered order to the not-received route | **Consider as not received** | 2. For activation, enter an **Order Activation Date** that is not earlier than the order date. 3. For receipt, enter **Received On** no later than today. 4. Select **Ok** when the activation-date popup is open. If the receipt action displays `Received Successfully`, the order-side receipt message has been returned. If reversing receipt displays `unreceived Successfully`, the order-side unreceipt message has been returned. An undelivered order update can display `Order updated successfully. Undelivered. A draft invoice was deleted`. **Result:** The selected order-side activation or receipt action is complete on its available surface; the physical Warehouse receiving task remains separate. ## Amend, correct, or close the order Use the order action menu that matches the order's current state. An amendment creates a new Draft order, while correction and closure actions are available only in their stated order states. | If the order is… | Select… | |---|---| | Valid or considered awaiting activation and you need a new version | **Order amendment** | | An amendment draft that you need to remove | **Order amendment** | | Approved or later but before Delivered, or considered awaiting activation, and editing is allowed | **Enable Editing** | | Awaiting approval and you need to withdraw the request | **Cancel Approval Request** | | Awaiting approval and the approver needs to reject the request | **Reject Approval Request** | | Approved and you need to reverse that approval state | **Consider as not approved** | | Valid or awaiting activation and you need to reverse award submission | **Consider PO award as not submitted** | | Before receipt or rejection and you need to cancel it | **Cancel PO** | | Valid or awaiting activation and you need to accept a rejected-order route | **Rejected PO acceptance** | | Cancelled and you need to restore the order route | **Consider P.O. as not Cancelled** | | Rejected and you need to restore acceptance | **Consider PO acceptance as not rejected** | | Delivered and you need to reverse receipt | **Consider as not received** | | Before approval on a non-direct order and you need to return it | **Back to Offer** | **Prerequisites** - The order state matches one row in the decision table. - You have edit access and the order has no unsaved changes. **Steps** 1. Open the order action menu. 2. Select the action in the row that matches the order's current state. 3. Complete any popup fields required by that action, such as **Cancellation Reason**, **Cancellation Date**, **Amount**, or **Reject Date**. **Result:** The selected amendment, correction, recovery, return, cancellation, rejection, or closure route is applied to the order state that made the action available. ## When order work goes wrong **Steps** 1. Read the validation message. 2. Enter the corrected value in the affected order field. 3. Select the action again. | Message | Corrective action | |---|---| | `Check PO mandatory field(s)` | Enter the corrected value in the affected order field. | | `Please insert at least one PO` | Add the required purchase-order entry before continuing. | | `Please insert at least one product` | Add a product item before continuing. | | `Check mandatory field(s)` | Review the fields required by the applicable configuration. | | `Order must have at least one item` | Add an item to the order grid. | | `Please enter action for each milstone ` | Complete the action for every payment milestone. | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Correct the affected quantity. | | `Invalid input. Please enter a non-negative value` | Enter zero or a positive value in the affected price or cost field. | | `Invalid input. The tax rate must be between 0 and 100` | Enter a tax rate from 0 through 100. | | `An error occurred while processing your request` | Review the order state and access, then repeat the action only when its action-menu condition is satisfied. | | `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Keep those item rows in the order. | | `Item(s) Reactivated` | Review the item state after reactivation. | | `Item(s) Regretted` | Review the selected item state after the regret action completes. | | `Item(s) Cancelled` | Review the selected item state after the cancellation action completes. | | `Item(s) Rejected` | Review the selected item state after the rejection action completes. | **Result:** The corrected action is submitted, or the relevant message remains visible. An action or field may be unavailable when the order is not saved, has unsaved changes, is outside the order-through-delivered range, lacks edit access, or is in a state that does not satisfy that action's condition. Approval and award actions also depend on approval and mail configuration. ### Out of scope messages Messages about work before or beside the purchase-order panel belong to their focused pages: | Message | Page that owns it | |---|---| | `Required Offer Type field is mandatory` | The purchase-job RFQs page | | `Required Bid Due Date field is mandatory` | The purchase-job RFQs page | | `Inquiry must have at least one item` | The purchase-job RFQs page | | `Offer must have at least one item` | The purchase-job quotations page | | `Check RFQ mandatory field(s)` | The purchase-job RFQs page | | `Please insert at least one RFQ` | The purchase-job RFQs page | | `Product package deleted from all inquiries` | The purchase-job product-packages page | | `Product package deleted from all offers` | The purchase-job product-packages page | | `Product package deleted from all orders` | The purchase-job product-packages page | | `Package products cannot be empty` | The purchase-job product-packages page | | `Converted to inquiry successfully` | The purchase-job conversions page | | `Converted to offer successfully` | The purchase-job conversions page | | `Forbidden characters detected. Please remove them and try again.` | [Comments, files, and history on a purchase job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-comments-files-and-history) | | ` You already have a contact with this name` | The purchase-job contacts page | | `Your request was completed successfully` | The purchase-job files page | | `Just '_'‘-''.' And '&' Characters Accepted` | The purchase-job files page | | `Job reactivated successfully` | [Purchase job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-record) | These messages do not describe order validation. Follow the focused page that owns the RFQ, quotation, package, conversion, contact, attachment, or file operation. ## What happens next After order-side work is complete, continue with the task that matches the next record surface. | Next need | Continue with | |---|---| | Review comments, files, or audit history | [Comments, files, and history on a purchase job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-comments-files-and-history) | | Work with the broader purchase-job record | [Purchase job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-record) | | Handle physical receipt, stock, or warehouse fulfillment | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | | Continue with purchase invoices | Select **Purchase Invoices**, then use the invoice page for that work. | | Return to the procurement chain | [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) | --- title: Comments, files, and history on a purchase job ... # Comments, files, and history on a purchase job ## Comments, files, and history on a purchase job A saved purchase job keeps its supporting files beside the procurement record and provides an audit view of changes. Use **Attachment** for file follow-up and **Last Modifications** for the audit history after RFQ, quotation, or purchase-order work. **Comments** is not available on this screen. | If you need to… | Go to | |---|---| | Understand the purchase-job record | [Purchase job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-record) | | Prepare shared information and package items | [Prepare purchase job information](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-information) | | Find a saved purchase job | [Find active purchase job work](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-work-lists) | | Keep supporting files with the job | [Keep supporting files with the purchase job](#keep-supporting-files-with-the-purchase-job) | | Open the broader file library | [Open the file library](#open-the-file-library) | | Review a file's category or unattach it | [Review or change a file](#review-or-change-a-file) | | Read the audit history | [Review Last Modifications](#review-last-modifications) | | Work on RFQs | [Manage purchase job RFQs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-rfqs) | | Work on quotations | [Manage purchase job quotations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-quotations) | | Work on purchase orders | [Manage purchase orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-orders) | ![Purchase-job stages and follow-up tabs at the bottom of the saved record](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3bcb09d3cc5a2dbf5968aaf73c2e9815.png) The saved purchase-job screen includes **MRQ**, **RFQ**, **Offer**, **PO**, and **Received**. Its bottom navigation includes **Attachment**, **Purchase Invoices**, and **Last Modifications**. Use the stage-specific pages for procurement work; use **Attachment** and **Last Modifications** for saved-record follow-up. ## Before you start The follow-up tabs belong to a saved purchase job. Their availability depends on the record having an ID, the purchasing subscription and page checks passing, and the follow-up component's read-only state. | Before you rely on… | Check this condition | |---|---| | The bottom follow-up tabs | The purchase job is saved and has an ID. | | **Attachment** | The subscription and page checks pass. | | **Last Modifications** | The subscription and page checks pass. | | **Attach File** | The Attachment component is not read-only. | | The required record fields | **Purchaser**, **Product Type**, and **Package Title** carry required markers. | | **Branch** | The field is present without a required marker on the edit screen. | The saved purchase job opens with the files tab selected. Keep the record saved before opening **Attachment** or **Last Modifications**. A read-only Attachment surface does not offer **Attach File** or the row-level unattach action. > **Note:** The follow-up tabs are separate from the **MRQ**, **RFQ**, **Offer**, **PO**, and > **Received** stage areas. Use the stage-specific pages when the task changes procurement work. ## Find and open a saved purchase job Start with an existing saved purchase job because the follow-up tabs use its saved ID. **Prerequisites** - You are signed in to PAMS. - You know which saved purchase job you need to review. **Steps** 1. Open [Find active purchase job work](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-work-lists) and locate the saved purchase job. 2. Open the saved purchase job from the work list. 3. Confirm that the saved purchase job is open. The saved purchase job shows its purchase-job stages and available bottom tabs. It remains open with the files tab selected. **Result:** The saved purchase job is open, ready for **Attachment** or **Last Modifications**. ## Keep supporting files with the purchase job The **Attachment** surface keeps supporting documents with the saved purchase job. When files are present, the grid can show **File name**, **Category**, **Tags**, the size column, and **Modified**. When no files are present, it shows `No Files`. **Prerequisites** - A saved purchase job is open. - The **Attachment** tab is available. - You have edit access if you need **Attach File** or **unattach**. **Steps** 1. Select **Attachment** at the bottom of the purchase-job screen. 2. Review the visible file-grid headers: **File name**, **Category**, **Tags**, the size column, and **Modified**. 3. Select **Attach File** when you need the broader file library. 4. For an uncategorized row, select **Category** to open category editing. 5. Review or enter the available file-manager values: **File name**, **Category**, **Comment**, and **Links**. 6. Select **unattach** on the file row when you need to remove its attachment from the purchase job. 7. Select **Cancel** when the unattach confirmation is open and you want to keep the attachment. The attachment grid appears only when files exist and the component is not empty, loading, or in an error state. The **unattach** action appears only when an attachment row exists and the component is not read-only. If the file action validates a value, the application can show `This Field Is Required` or `Just '_'‘-''.' And '&' Characters Accepted`. Correct the value in the relevant file field before repeating the action. After a completed request, the application shows `Your request was completed successfully`. The unattach confirmation says `Are you sure you want to unattach this File?`. Decide at this point whether the file should remain associated with the purchase job. **Result:** The Attachment surface is open with the available file rows, file fields, or empty state, and the available follow-up action is complete or cancelled. ![Attachment with Attach File, the empty state, or the supporting-file grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3bcb09d3cc5a2dbf5968aaf73c2e9815.png) ### Open the file library Select **Attach File** when you need the broader file library. The library opens when the Attachment component is not read-only; otherwise, the Attachment surface remains visible and can show `No Files`. | If you need to… | Then | |---|---| | Open the broader file library | Select **Attach File**. | | Create a library, folder, or file | Continue in [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files). | | Upload or edit a file | Use the file-library surface, which can provide **File name**, **Category**, **Comment**, and **Links**. | **Result:** The file library is open, or the Attachment surface remains visible with `No Files`. ### Create a library, folder, or file Library, folder, and complete file-creation work belongs to the file-library page rather than the purchase-job follow-up surface. File upload or document-edit popups can provide **File name**, **Category**, **Comment**, and **Links**. The broader file-library surface covers role-maintenance messages and complete create-library, create-folder, and file-creation procedures. ### Review or change a file An attached file row can expose its existing **Category**, or a **Category** action when no category is assigned. The available actions depend on the row and read-only state. **Prerequisites** - The **Attachment** surface is open. - A file row is available for row-level review or change. **Steps** 1. Review the **Category** value on the file row. 2. If the row has no category, select **Category** to open category editing. 3. Select **unattach** when the attachment must no longer belong to the purchase job. 4. Select **Cancel** to close the unattach confirmation without removing the attachment. The confirmation message is `Are you sure you want to unattach this File?`. No attachment download control or direct delete action is available. **Result:** The file's category action is open, the attachment remains associated, or the unattach confirmation is closed. ## Review Last Modifications **Last Modifications** is the purchase-job audit surface. It lists the recorded date, user name, action, and change details for the saved record. **Prerequisites** - A saved purchase job is open. - **Last Modifications** is available in the bottom navigation. **Steps** 1. Select **Last Modifications**. 2. Read `The audit log provides you with a chronological sequence of actions performed by the users`. 3. Review **Created On**, the user name, the action, and the change details in the history entries. 4. Select **Refresh** to reload the history. 5. Select an edit history row when changes are available to expand its change details. When history entries exist, they appear in the list. The history view shows **Refresh**, the audit-log description, and history entries. **Result:** The Last Modifications view is open with the available audit entries and any selected change details visible. ## When a follow-up surface is unavailable Use the visible state to decide whether the purchase job has no files, is still loading, or needs a retry. The purchase-job screen has no **Comments** tab or panel; continue with **Attachment** or **Last Modifications**. | What you see | What to do | |---|---| | `No Files` | Continue with the empty Attachment surface or select **Attach File**. | | `loading...` | Wait for the Attachment surface to finish loading. | | **Try Again** | Select **Try Again** to reload attached files. | | No **Comments** tab | Continue with **Attachment** or **Last Modifications**. | | No download or direct-delete control | Use **Category** or **unattach** when available. | **Prerequisites** - A saved purchase job is open. - The Attachment surface shows an error with **Try Again**. **Steps** 1. Select **Try Again**. 2. Review the Attachment surface for its file rows, `No Files`, or another visible state. **Result:** The Attachment surface has reloaded and shows the resulting file state. ## Continue after reviewing the purchase job Follow-up review is separate from the procurement work that moves a purchase job through RFQ, quotation, and purchase-order stages. Return to the owning page when the next task changes the record, stage, invoice, or file-library administration. | If you need to… | Continue with | |---|---| | Return to record-level purchase-job work | [Purchase job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-record) | | Maintain shared information and package work | [Prepare purchase job information](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-information) | | Work on RFQs | [Manage purchase job RFQs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-rfqs) | | Work on quotations | [Manage purchase job quotations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-quotations) | | Work on purchase orders | [Manage purchase orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-orders) | | Locate another active or archived job | [Find active purchase job work](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-work-lists) | | Continue broader file-library work | [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) | ### Related workflow messages Use the owning page when one of these messages appears. | Message | Owning page | |---|---| | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Purchase job RFQ, quotation, or purchase-order panel | | `Invalid input. Please enter a non-negative value` | Purchase job quotation or purchase-order panel | | `Invalid input. The tax rate must be between 0 and 100` | Purchase job quotation or purchase-order panel | | `Product package deleted from all inquiries` | Purchase job record or RFQ workflow | | `Product package deleted from all offers` | Purchase job record or quotation workflow | | `Product package deleted from all orders` | Purchase job record or purchase-order workflow | | `Order updated successfully. Undelivered. A draft invoice was deleted` | Purchase-order panel | | `Job reactivated successfully` | Purchase job record | | `Converted to inquiry successfully` | RFQ workflow | | `Converted to offer successfully` | Quotation workflow | | `Please insert at least one PO` | Purchase-order panel | | `Please insert at least one RFQ` | RFQ panel | | `Please insert at least one product` | Purchase job record | | `Inquiry must have at least one item` | RFQ panel | | `Offer must have at least one item` | Quotation panel | | `Order must have at least one item` | Purchase-order panel | | `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Purchase-order panel | | `An error occurred while processing your request` | Purchase job record | | `Package products cannot be empty` | Purchase job record | | `Required Offer Type` | RFQ panel | | `Required Bid Due Date` | RFQ panel | | `Please enter action for each milstone ` | Purchase-order panel | | `Forbidden characters detected. Please remove them and try again.` | Purchase invoice list | | `You already have a contact with this name` | Contact record | # Create a direct purchase order Use this page to open the direct-order form, complete the information and products it exposes, and save the record when the form permits the action. ## Create a direct purchase order A direct purchase order is the direct branch of the procurement flow. It places the purchase job at the `Order` stage, which is the stage the ordinary procurement path reaches after `Potential` and `Offer` work. ```mermaid flowchart LR MRQ[MRQ] --> Potential[Potential] Potential --> Offer[Offer] Offer --> Order[Order] Direct[Direct purchase order] --> Order Order --> Delivered[Delivered] ``` The direct route begins a new record at `Unknown` before the direct-order area opens. The record's direct-order mode then supplies the order-stage form. From the order stage, the purchase-job lifecycle can continue to `Delivered`, or leave the main route through the declared order exits. | If you need to… | Go to | | --- | --- | | Check what must be ready before opening the form | [Before you start](#before-you-start) | | Open the direct-order editor | [Open the direct purchase-order form](#open-the-direct-purchase-order-form) | | Identify the main areas and visible grid | [Understand the direct-order form](#understand-the-direct-order-form) | | Enter the purchaser, product type, package, and products | [Enter the main information and products](#enter-the-main-information-and-products) | | Complete purchase-order values and item amounts | [Complete the order details](#complete-the-order-details) | | Save the completed record | [Save the direct purchase order](#save-the-direct-purchase-order) | | Correct a blocked action or message | [Resolve validation and error messages](#resolve-validation-and-error-messages) | | Continue with approval, activation, or warehouse work | [Continue with the saved purchase order](#continue-with-the-saved-purchase-order) | ## Before you start The direct-order form is an editable new-record route. It needs the main information, any order fields that your company configuration makes mandatory, and at least one valid order with valid order items before saving can call the save service. **Prerequisites** - You have edit access to procurement details. **Save** and **Save and Close** require edit access, a changed record, and no save already in progress. - You know the branch, purchaser, product type, and package title for the order. - You have the product rows to enter or select. A new direct order must contain at least one product before it can pass the save checks. - You can reach the form through the **+ Direct P.O.** entry point. - You know which values your company requires in the order panel. **PO No.**, **Delivery Time**, **Delivery Term**, **Forecasted Receiving Date**, **Payment Method**, **Payment Period**, **Forecasted Logistics Costs**, and **Logistics Costs** are mandatory only when the company configuration says so. **Rate to** is required when its local-currency popup opens. - Continue with approval, award submission, activation, and receipt work in [Manage purchase orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-orders). Do not treat the absence of a required marker on an order field as a fixed optional rule. The form asks company configuration whether those fields are mandatory. ## Open the direct purchase-order form The direct purchase-order editor is the new-record form opened by **+ Direct P.O.**; it is not the ordinary quotation or purchase-order list entry. **Prerequisites** - You are signed in. - You have edit access to procurement details. **Steps** 1. Open the procurement list that provides the new-record actions. 2. Select **+ Direct P.O.**. 3. Confirm that the form shows **Branch**, **Purchaser**, **Product Type**, and **Package Title**. The authenticated purchase-work list can show **RFQs** while **Direct P.O.** is absent from that list. When that happens, use the available **+ Direct P.O.** action instead of looking for a separate list entry. ![The direct purchase-order form with its main fields, product area, and visible actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/b1572ac4f3c331b1b75be12f8438b089.png) **Result:** The direct purchase-order form is open in new-record mode. Its direct-order area is shown for the `AddNewDirectPO` action. Continue with the main information and products. ## Understand the direct-order form The form combines the purchase-job information area with a product area and an embedded purchase-order area. The form shows the main fields and a product grid; the order panel supplies its own fields and item values when that area is available. | Area | What to use it for | | --- | --- | | Main information | Choose **Branch**, **Purchaser**, and **Product Type**, then enter **Package Title**. | | Product area | Review product rows and use **MRQ product** to insert a product row. | | Order panel | Enter order identification, delivery, payment, logistics, rate, and item values. | | Product grid | Review the columns shown in the direct-order form. The grid shows **No Data** until product rows are available. | The top-level grid has these columns: | Group | Columns | | --- | --- | | Product identity | **Item No.**, **Product**, **Category**, **Group** | | Request information | **MRQ Qty.**, **MRQ type**, **Required Receiving Date**, **Job no.**, **MRQ** | | Quantity and status | **Qty**, **V.L.**, **Is limited V.L.**, **Stage** | The embedded order panel has these fields: | Area | Fields | | --- | --- | | Identification and delivery | **PO No.**, **Delivery Time**, **Delivery Term**, **Forecasted Receiving Date** | | Payment and status | **Payment Method**, **Payment Period**, **Status** | | Costs and rate | **Forecasted Logistics Costs**, **Logistics Costs**, **Rate to** | Its item grid defines **Product**, **Unit**, **Qty**, **Unit Price**, **Item Price**, **Currency**, **Stage**, **Discount (%)**, and **Tax (%)**. Work from the headers and controls visible in your form; the order panel's option lists and some item columns depend on the active configuration. **Commissions** is not an available action on this form. ## Enter the main information and products Complete the main information before adding products. The top-level fields identify the purchase job and determine which product set the direct order uses. **Prerequisites** - The direct purchase-order form is open. - You know the purchaser, product type, package title, and product rows. **Steps** 1. In **Branch**, enter the applicable branch when the form presents that field. 2. In **Purchaser**, select the purchaser. 3. In **Product Type**, select the applicable displayed choice. The available choices come from the current configuration. 4. In **Package Title**, enter the package title. 5. Review the product area for existing rows. 6. If a product row is needed, select **MRQ product**. 7. Review the product grid and confirm that the required product row is present. The product grid can show **No Data** before a row is inserted. Saving without a product is blocked with `Please insert at least one product`. **Result:** The main information is entered and the product area contains the product row or rows required for the direct order. Continue with the order details. ## Complete the order details The order details describe how the selected products are ordered, delivered, paid for, and priced. Complete the fields that your company configuration makes mandatory, then check each editable item value before saving. **Prerequisites** - The main information and product rows are complete. - You know the order number, delivery and payment choices, logistics values, and item amounts required for this order. | Control | What to select | | --- | --- | | **Product Type** | Select a product-type choice from the displayed list. | | **Delivery Time** | Select a delivery-time choice from the displayed list. | | **Delivery Term** | Select a delivery-term choice from the displayed list. | | **Payment Method** | Select a payment-method choice from the displayed list. | | **Payment Period** | Select a payment-period choice from the displayed list. | **Steps** 1. In the order panel, enter **PO No.** when it is required by your company configuration. 2. In **Product Type**, select a product-type choice from the displayed list. 3. In **Delivery Time**, select a delivery-time choice from the displayed list. 4. In **Delivery Term**, select a delivery-term choice from the displayed list. 5. In **Payment Method**, select a payment-method choice from the displayed list. 6. In **Payment Period**, select a payment-period choice from the displayed list. 7. Enter **Forecasted Receiving Date** when it is required by your company configuration. 8. In **Status**, select the applicable displayed choice. The available choices come from the current configuration. A new direct order starts at `Unknown`. 9. Enter **Forecasted Logistics Costs** and **Logistics Costs** when required. Use values of zero or greater. 10. In the order grid, enter **Qty** from `1` through `999,999`. 11. Enter **Unit Price** from `0` through `999,999,999`. 12. Enter **Discount (%)** and **Tax (%)** from `0` through `100`. 13. Select the applicable rate, logistics, or milestone action: | If you need to… | Select… | | --- | --- | | Enter a local-currency rate | **Enter rate**, then enter a non-negative **Rate to** value. | | Open the logistics-cost rate action | **Logistics Costs** | | Edit payment milestones | **Payment Milestone** | > **Note:** Choice controls use the current configuration. Select the applicable displayed choice for each named choice control. The order grid treats **Product**, **Unit**, **Item Price**, **Currency**, and **Stage** as values to review. **Qty**, **Unit Price**, **Discount (%)**, and **Tax (%)** are the editable item values. If an item value violates its rule, the form displays the corresponding validation message: - `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00`. - `Invalid input. Please enter a non-negative value`. - `Invalid input. The tax rate must be between 0 and 100`. **Result:** The order panel contains the required order values, and each editable item value falls within its allowed range. Continue with **Save** or **Save and Close**. ## Save the direct purchase order Use **Save** to keep the record on the form or **Save and Close** to save and leave the page. The save action first checks the main data, package items, order count, and order items. **Prerequisites** - The main information is valid. - The package contains valid product items. - At least one order exists. - The order contains valid items. - You have edit access and the form contains changes. **Steps** 1. Select the action that matches where you want to continue: | If you need to… | Select… | | --- | --- | | Keep the record open | **Save** | | Leave the form after saving | **Save and Close** | 2. Confirm the message `Saved Successfully` when the save completes. After a successful save, the saved procurement record opens and the message `Saved Successfully` appears. Continue with the saved purchase order. **Result:** A successful save opens the saved procurement record and displays `Saved Successfully`. ## Resolve validation and error messages Use the message on screen to correct the part of the direct order that is incomplete or outside its allowed range. | Message | Corrective action | | --- | --- | | `Check PO mandatory field(s)` | Complete the mandatory order fields, including any fields made mandatory by company configuration. | | `Please insert at least one PO` | Add at least one purchase order in the order area. | | `Please insert at least one product` | Add a product with **MRQ product**. | | `Check mandatory field(s)` | Review the required main or order fields and complete the missing value. | | `Order must have at least one item` | Add at least one item to the order. | | `Package products cannot be empty` | Add a product to the package. | | `Please enter action for each milstone ` | Complete the action for each payment milestone. | | `An error occurred while processing your request` | Review the values and retry the action. | | `Saving Error` | The save did not complete. Review the form and retry **Save** or **Save and Close**. | | `Updating Error` | The update did not complete. Review the form and retry the record action. | | `Loading error` | The form data did not load. Reopen the direct-order form. | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a quantity from `1` through `999,999`. | | `Invalid input. Please enter a non-negative value` | Enter a zero or positive unit-price or item-price value. | | `Invalid input. The tax rate must be between 0 and 100` | Enter **Tax (%)** from `0` through `100`. | For approval after the order is saved, use [Manage purchase orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-orders). ## Continue with the saved purchase order A saved direct purchase order enters the purchase-order part of the procurement lifecycle. The direct-order creation page ends when the saved record opens; approval, award submission, activation, receipt, exceptions, and warehouse work continue on their focused pages. 1. Open the page that matches your next task: | If you need to… | Open… | | --- | --- | | Request approval, submit or amend the order award, activate the order, or handle order-side receipt work | [Manage purchase orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-orders) | | Review how the order stage follows `Potential` and `Offer` work and leads toward `Delivered` | [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) | | Handle physical receipt, inspection, stock, or other warehouse work after the procurement hand-off | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | | Review the wider purchase-job workspace | [Purchase job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-record) | The procurement lifecycle can leave the main route from `Potential`, `Offer`, or `Order` through its declared missed, regretted, cancelled, or rejected exits. The direct-order page does not perform those later actions. **Result:** The saved purchase order is handed to the purchase-order page for its next action; warehouse work is handed to the warehouse page when the order reaches that downstream boundary. # Invoice lifecycle An invoice records an amount due from an account or principal. Its lifecycle runs from preparation through approval, due-date handling, and payment. ## Invoice lifecycle at a glance The invoice workspace carries header information, invoice items, totals, payment information, and approval state. The lifecycle uses these statuses: | Status | What it means in the lifecycle | | --- | --- | | **Draft** | The invoice is being prepared or returned for further work. | | Release for Approval | The invoice is ready to enter the approval path. | | **Approved** | The invoice has completed approval and moves into sending and payment handling. | | **Due** | The invoice has an outstanding amount and its payment period has not become overdue. | | **Overdue** | The invoice still has an outstanding amount after its payment period. | | **Paid** | The due amount is zero or less. | The normal shape is Draft → Release for Approval → Approved → Due. From Due, the invoice becomes Overdue when its payment period is overdue, or Paid when its due amount is zero or less. An approved invoice can also return to Draft when the approval process permits **Consider as not approved**. ```mermaid stateDiagram-v2 Draft --> Release for Approval: Request approval Release for Approval --> Approved: Approve Approved --> Due: Consider as sent to client/principal Due --> Overdue: payment period overdue Due --> Paid: due amount ≤ 0 Approved --> Draft: Consider as not approved ``` | If you need to… | Go to | | --- | --- | | Check access and approval prerequisites | [Before you start](#before-you-start) | | Locate a saved invoice | [Find and open an invoice](#find-and-open-an-invoice) | | Identify fields, totals, tabs, and actions | [Read the invoice workspace](#read-the-invoice-workspace) | | Start a new account or additional invoice | [Choose an invoice creation route](#choose-an-invoice-creation-route) | | Request, complete, or reverse approval | [Request and complete approval](#request-and-complete-approval) | | Follow payment and due-date branches | [Follow Due, Overdue, and Paid branches](#follow-due-overdue-and-paid-branches) | | Correct a blocked invoice action | [When an invoice action does not work](#when-an-invoice-action-does-not-work) | | Record an incoming payment | [Record a payment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/record-payment) | | Review principal invoices | [Principal invoices](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/principal-invoices) | | Review purchase invoices or outgoing payments | [Payables](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/payables) | ## Before you start Prepare the access and record conditions below before you begin. | Prepare | Why it matters | | --- | --- | | The invoice feature is included in your subscription. | The invoice workspace is subscription-gated. | | Access to the invoice list and editor is granted to your role. | The list and editor have permission guards. | | An approval process and applicable approval limit are configured when your work uses approval. | The **Approve** and **Request approval** actions depend on approval configuration and limits. | | A saved invoice exists for record actions. | Approval, sending, and other record actions operate on a saved invoice. | Open the finance invoice list to work with saved invoice records. Opening a saved invoice takes you to its invoice workspace. Account-invoice and additional-invoice creation are separate routes. **Note:** Approval authority matters before saving or changing an invoice. If your work uses an approval process, identify the person or role that must approve the invoice before you select an approval or record-changing action. ## Find and open an invoice The invoice list is the finance workspace for choosing an invoice type, narrowing statuses, and opening an existing record. After you open a record, continue with [Read the invoice workspace](#read-the-invoice-workspace). **Prerequisites** - Your subscription includes the invoice workspace. - Your role can open the finance invoice list. - You know whether the record is a sales invoice or a commission invoice. **Steps** 1. Open the finance invoice list. 2. Select the invoice navigation tab that matches your task. | If you need to… | Select | | --- | --- | | Review every invoice-list area | **All** | | Review sales invoices | **Sales Invoices** | | Review commission invoices | **Commission Invoices** | | Review incoming payments | **Incoming Payments** | | Review principal invoices | **Tracking Principal Invoices** | 3. Select the status filter that matches the invoice stage. | If you need to find… | Select | | --- | --- | | All available statuses | **All** | | Upcoming invoices | **Upcoming** | | Draft invoices | **Draft** | | Approved invoices | **Approved** | | Receivable invoices | **Receivable** | | Paid invoices | **Paid** | 4. Read the visible grid headers before identifying the row. The sales-invoice grid shows **Invoice No.**, **Job No.**, **Account**, **Due Date**, Invoice Amount €, Invoice Amount, Paid Amount, Paid Amount €, Due Amount, Due Amount NaN, Total Sales Price, and **Status**. 5. Select the row for the saved invoice you need to review. ![Use the navigation tabs, status filters, and visible invoice grid headers to locate a record.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/8bc189367930435638a61afdd11e661f.png) 6. Open the selected invoice record. Your list layout determines which columns are available. Work from the headers currently shown in your list rather than assuming that every account has the same columns. **Result:** The selected saved invoice is open in its invoice workspace, or the list shows that the required tab or filter is unavailable. ## Read the invoice workspace The invoice workspace brings together the invoice header, account-invoice items, totals, approval actions, and saved-record follow-up areas. The header can contain these fields: | Field | When it appears | Required status | Choices | | --- | --- | --- | --- | | **Account** | Non-account invoice | Not required | — | | **Invoice Date** | Invoice loaded | Not required | — | | **Invoicing Address** | Invoice loaded | Required | — | | **Payment Period** | Invoice loaded | Not required | Choices: the runtime `Name` values from `AllTimePeriods`; each option has an `ID` value. | | **Issued By** | Invoice loaded | Required | Choices: the runtime `Name` values from `usersList`; each option has an `ID` value. | | **Vendor Order No.** | Sales or commission invoice | Not required | — | | **External invoice no.** | Sales or commission invoice with the integration condition | Not required | — | | **Client** | Commission invoice | Not required | — | | **Client Order No.** | Sales or commission invoice | Not required | — | | **Order Date** | Sales or commission invoice | Not required | — | | **Delivery Date** | Sales or commission invoice | Not required | — | | **Delivery Term** | Sales or commission invoice | Not required | — | | **Payment Method** | Invoice loaded | Not required | — | | **Invoice Note** | Invoice loaded | Not required | — | An account invoice can show an item grid with **Item**, **Unit**, **Quantity**, **Unit Price**, Discount, **Item Price**, **Tax**, and Currency Code. The summary area shows **Invoice amount**, **Total taxes**, **Total incl. tax**, **Paid Amount**, **Deductions**, and **Due amount**. The saved-record workspace includes the tabs **Comments**, **Attachment**, **Tasks**, **Activities**, **Deductions**, **Payments**, and **Last Modifications**. Approval and sending actions depend on the invoice type, status, approval process, approval limit, email permission, and feature conditions. Available actions include **Approve**, **Request approval**, **Consider as sent to principal**, **Consider as sent to client**, **Send to principal**, and **Send to client**. The invoice-create workspace can also contain embedded areas for files, activities, tasks, an address, and contacts. Use those areas only for the supporting work they own; see [Out of scope messages](#out-of-scope-messages) for messages from those areas. ![Recognize the invoice workspace and its saved-record areas.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2add82e9f737965363aa85f157f25db1.png) ## Choose an invoice creation route An account invoice and an additional invoice are separate creation routes. Each opens the invoice creation workspace; its fields and save procedure are covered in [Create an Account Invoice](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-invoice). | Create… | Continue with | | --- | --- | | An account invoice | [Create an Account Invoice](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-invoice) | | An additional invoice | In the finance invoice area, open the entry for an additional invoice. | **Prerequisites** - You have permission to open the applicable creation route. - You know whether the invoice is an account invoice or an additional invoice. **Steps** 1. In the finance invoice area, open the entry for the invoice type you need. 2. Follow the applicable outcome. | If you see… | Do this | | --- | --- | | The invoice creation workspace | Continue with [Create an Account Invoice](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-invoice). | | `You are not allowed to View this page!` | Contact your administrator to request access to the applicable creation option. | **Result:** The applicable creation workspace is open, or the dashboard is visible after access is refused. ## Request and complete approval Approval is the controlled review of an invoice before it proceeds through sending and payment. The available action depends on its status, approval process, limit, and permission. | Invoice condition | Action available when the guard allows it | Resulting direction | | --- | --- | --- | | **Draft**, Release for Approval, or **Awaiting Approval** with approval authority | **Approve** | Completes approval and leaves the invoice **Approved**. | | **Draft** or Release for Approval when direct approval is not allowed | **Request approval** | Sends the invoice into **Awaiting Approval**. | | **Awaiting Approval** | **Cancel request for approval** | Cancels the request. | | **Awaiting Approval** with approval permission | **Reject approval request** | Rejects the request. | | **Approved** with an approval process | **Consider as not approved** | Returns the invoice to **Draft**. | **Prerequisites** - The invoice is saved. - The invoice is in a status listed in the applicable row above. - The approval process, limit, and permission required by the action are in place. - If you are saving or deleting a record, identify the person or role that must approve the change before you commit it. **Steps** 1. Open the saved invoice and read its current status. 2. Select the approval action that matches the status and authority available to you. 3. Follow the applicable approval outcome. | If… | Select or do this | | --- | --- | | The invoice enters **Awaiting Approval** | Wait for the authorised approver to select **Approve** or **Reject approval request**. | | The request is no longer required while the invoice is **Awaiting Approval** | Select **Cancel request for approval**. | | An approved invoice must return for correction | Select **Consider as not approved**. | 4. Re-read the status before starting sending or payment work. Fields including **Account**, **Invoice Date**, **Invoicing Address**, **Payment Period**, **Issued By**, and **Payment Method** are locked after approval. Do not plan an edit of these fields after approval; return the invoice to **Draft** where the approval process permits it. **Result:** The invoice shows the status produced by the selected approval path: **Approved**, **Awaiting Approval**, **Draft**, or the unchanged status when the guard does not allow the action. ## Follow Due, Overdue, and Paid branches The payment branch tells you whether an invoice still needs collection, has passed its payment period, or has no amount left to collect. | Condition | Status or branch | | --- | --- | | The due amount is greater than zero and the payment period is not overdue | **Due** | | The due amount is greater than zero and the payment period is overdue | **Overdue** | | The due amount is zero or less | **Paid** | | A due invoice must be marked as not sent | **Consider as not sent to principal** or **Consider as not sent to client** | | An eligible approved or draft invoice must be marked as sent | **Consider as sent to principal** or **Consider as sent to client** | **Prerequisites** - The invoice is approved or otherwise eligible for the sending action. - You know whether the invoice is sent to the client or to the principal. - You have the permission and feature access required by the action. **Steps** 1. Open the invoice and read **Due amount** and the payment-period information. 2. Identify the payment branch. | If… | Follow this branch | | --- | --- | | **Due amount** is zero or less | Treat the invoice as **Paid**. | | **Due amount** is greater than zero and the payment period is overdue | Follow **Overdue**. | | **Due amount** is greater than zero and the payment period is not overdue | Follow **Due**. | 3. Select **Consider as sent to principal** or **Consider as sent to client** when the approved invoice must enter the sent branch without the corresponding send action. 4. Select **Consider as not sent to principal** or **Consider as not sent to client** when a **Due** or due-equivalent invoice must return to the not-sent branch. 5. Use [Record a payment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/record-payment) to record incoming money. After approval, editing remains locked according to the invoice status and approval guards. The payment branch determines the next finance task rather than providing a general editing route. **Result:** The invoice is identified as **Due**, **Overdue**, or **Paid**, and you have the appropriate sending or payment hand-off. ## When an invoice action does not work Use the message on screen to choose the correction. | What you see | What it means | What to do | | --- | --- | --- | | `This field is required` | A required invoice field is empty. | Complete the required field, then save again. | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | A numeric value is outside the permitted positive range. | Enter a value greater than zero and no greater than `999,999.00`. | | `Invalid input. Please enter a non-negative value` | A numeric value is negative. | Enter zero or a positive value. | | `Check validation` | The form has validation findings to review. | Read the validation state, correct the named field, and save again. | | `Invoice saved successfully` | The invoice save completed. | Re-read the invoice status and totals before continuing. | | `Invoice failed to save` | The save did not complete. | Review the invoice values and permissions, then retry the save. | | `An error occurred while processing your request` | Processing failed while the action was handled. | Stop the workflow and ask an administrator to review the invoice action and access. | | `complete popup on changed invoice close` | The changed invoice close confirmation is displayed. | Resolve the confirmation before leaving the changed invoice. | | `You are not allowed to View this page!` | The requested invoice creation route is refused. | Ask for permission to open the account-invoice or additional-invoice route. | The sales-invoice screen does not provide Payment List or **Due/Overdue**. ![Recognize the invoice-list toolbar area before relying on an export action.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ed823ddc6bb19f7060db24e597a32eb0.png) ### Out of scope messages Embedded files, activities, and contacts have their own owning pages. Their messages can appear in the invoice editor, but they do not describe the invoice lifecycle. | Message | Owning page or area | | --- | --- | | `This record is related to saved data and cannot be deleted` | Libraries | | `Your request was completed successfully` | Libraries | | `Forbidden characters detected. Please remove them and try again.` | Libraries | | `Action not allowed` | Activities and attachments on a sales job | | `One topic and at least one note is required` | Activities and attachments on a sales job | | `You already have a contact with this name` | Contacts, L/Gs, and Last Modifications on a sales job | Use the owning page for the procedure that produced one of these messages. Continue with [When an invoice action does not work](#when-an-invoice-action-does-not-work) for invoice status, approval, and payment problems. ## Continue with the next finance task Choose the next task from the invoice's current status and the work still required. | If the invoice work is… | Continue with | | --- | --- | | Starting a new account or additional invoice | The invoice-creation page | | Recording money received | [Record a payment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/record-payment) | | Reviewing principal invoice status, deductions, or principal payments | [Principal invoices](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/principal-invoices) | | Reviewing purchase invoices or outgoing payments | [Payables](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/payables) | For invoice-entry fields and the save procedure, continue to [Create an Account Invoice](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-invoice). For payment, principal-invoice, or payables work, continue to [Record a payment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/record-payment), [Principal invoices](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/principal-invoices), or [Payables](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/payables). # Create an Account Invoice ## Create an account invoice An account invoice records an amount to bill against an account. An additional invoice is another invoice entry created through the separate additional-invoice route. The new invoice starts in **Draft**. Use the saved invoice's lifecycle page for the work that moves it through approval, sending, and payment follow-up. ```mermaid flowchart LR A[Create an account invoice] --> D[Draft] B[Create an additional invoice] --> D ``` | If you need to… | Go to | | --- | --- | | Check the information and controls before entering data | [Understand the invoice form](#understand-the-invoice-form) | | Add a billing destination | [Add a billing address](#add-a-billing-address) | | Enter items and save the invoice | [Complete and save the invoice](#complete-and-save-the-invoice) | | Correct a message that prevents saving | [When validation fails](#when-validation-fails) | | Check amounts and what remains due | [Review currency and totals](#review-currency-and-totals) | | Continue approval and invoice-status work | [Continue with the saved invoice](#continue-with-the-saved-invoice) | | Create or correct the account first | [Create an account](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-account) | | Review the saved invoice lifecycle | [Invoice lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/invoice-lifecycle) | | Record money received after the invoice exists | [Record a payment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/record-payment) | | Work with principal invoices | [Principal invoices](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/principal-invoices) | | Review purchase invoices and outgoing payments | [Payables](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/payables) | ## Before you start Prepare the account, the invoice header information, the invoice items, and access to the finance invoice feature before opening the form. Selecting the right account connects the invoice to the account's billing context; collecting the invoice values first avoids leaving a new record incomplete. **Prerequisites** | Prepare | Why it matters | | --- | --- | | The account for an account invoice | The **Account** picker is available for account invoices. | | The invoice date, payment period, issuer, payment method, note, and item values | These values complete the invoice header and item grid. | | The invoicing address | **Invoicing Address** is required before the invoice can be saved. | | The person or user to select in **Issued By** | **Issued By** is required before the invoice can be saved. | | Edit access and changed invoice data | **Save** and **Save and Close** require edit access, changes, a non-upcoming status, and no active save. | | An invoices-module subscription | The invoice workspace is hidden when the invoice feature is not included. | | `EditClient` permission when adding a new billing destination | Adding a destination requires the account-edit permission. | > **Note:** The destination is selected from **Billing Address Destination**; the address itself is entered through the destination form. When the account does not already provide the billing destination needed by the invoice branch, add a destination before saving. Approval controls are separate from the save controls and depend on approval configuration, invoice status, permission, and subscription features. ## Open the invoice form Choose the finance route that matches the invoice you need. Do not enter invoice data until the form is visible. **Prerequisites** - You are signed in to PAMS. - The invoice feature is included in the subscription. - You have access to the finance invoice page. **Steps** 1. Choose one route. | Invoice you need | Route or entry point | | --- | --- | | Account invoice | Open the account-invoice route, or select the **Account Invoices** add link when it is available. | | Additional invoice | Open the additional-invoice route. | ![The account-invoice entry point and the page reached after opening it](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c0412e66205334ca9d219c53758132ce.png) The route determines which new-invoice form opens. ![The additional-invoice entry point and the page reached after opening it](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0204f63edda4fb604281c56ffed4df6d.png) 2. If the access dialog appears, read `You are not allowed to View this page!` and stop entering invoice data. 3. If the site redirects you to the dashboard, return to the finance invoice entry point after the access issue is resolved. **Result:** The invoice form is open when access is available. When access is refused, the dashboard is displayed instead and no invoice fields are available. ## Understand the invoice form The invoice form combines header information, an item grid, a summary, and save controls. The fields shown can change with the invoice type and status. | Area | Field or control | What to use it for | | --- | --- | --- | | Header | **Account** | Select the account for an account invoice; other invoice types use read-only text. | | Header | **Invoice Date** | Enter or review the invoice date. | | Header | **Billing Address Destination** | Select the billing destination. | | Header | **Invoicing Address** | Enter the required invoicing address. | | Header | **Payment Period** | Set the payment count and period. Choices come from the available time-period data. | | Header | **Issued By** | Select the issuer. Choices come from the available user data. | | Header | **Payment Method** | Select the payment method for an account invoice; sales and commission invoices can show it as read-only text. | | Header | **Invoice Note** | Add a note to the invoice. | | Items | **Item**, **Unit**, **Qty**, **Unit Price**, **Discount (%)**, **Item Price**, **Tax (%)**, **Currency** | Enter and review the item row values. | | Toolbar | **Save** | Save the invoice while remaining on the form. | | Toolbar | **Save and Close** | Save the invoice and close the form. | Sales and commission invoice types can add fields for vendor order, external invoice number, client or order dates, delivery term, payment method, L/C number, and freight. These fields depend on the invoice type; use the labels visible on the form for the selected type. Approval actions such as **Approve** and **Request approval** depend on invoice status, approval configuration, permission, and subscription features. **Enable Editing** also depends on status and permission. After approval, the main header fields can become unavailable for editing. If the account needs a billing destination, continue to [Add a billing address](#add-a-billing-address). Otherwise, continue to [Complete and save the invoice](#complete-and-save-the-invoice). ## Add a billing address Use a billing address destination when the account does not already provide the destination required by the invoice. The destination picker is separate from the required **Invoicing Address** field. **Prerequisites** - The invoice form is open. - The account needs a new billing destination. - You have `EditClient` permission to add a destination. **Steps** 1. Choose the destination path. | If | Then | | --- | --- | | The correct destination is available | In **Billing Address Destination**, choose it. | | The destination is not available | Select **Add new Destination**. | 2. If you selected **Add new Destination**, enter the destination name in **Destination Title**. 3. Enter the country in **Country**. 4. Enter the state in **State**. 5. Enter the city in **City**. 6. Enter the street in **Street**. 7. Enter the postal value in **Zip-code**. 8. Select **Save**. 9. Select the saved destination in **Billing Address Destination**. If permission is denied, stop the address procedure and ask an administrator or account editor to add the destination. The invoice cannot use a destination that has not been saved and selected. **Result:** An existing or newly saved billing destination is selected on the invoice form. Continue to [Complete and save the invoice](#complete-and-save-the-invoice). ## Complete and save the invoice Enter the invoice header values and item rows, then save the new invoice. The account-invoice item grid uses the item, quantity, price, discount, tax, and currency values to calculate the invoice summary. **Prerequisites** - The invoice form is open. - **Account**, **Invoicing Address**, and **Issued By** are available. - You have the invoice date, payment period, payment method, and item values. - You have edit access. **Steps** 1. In **Account**, select the account for an account invoice. 2. Enter the date in **Invoice Date**. 3. Select the billing destination in **Billing Address Destination** when one is available. 4. Enter the required address in **Invoicing Address**. 5. Set the count and period in **Payment Period**. 6. Select the issuer in **Issued By**. 7. Select the payment method in **Payment Method**. 8. Enter any supporting text in **Invoice Note**. 9. In the `Account Invoice` item grid, enter the item description in **Item**. 10. Enter the unit in **Unit**. 11. Enter the quantity in **Qty**. 12. Enter the unit amount in **Unit Price**. 13. Enter a percentage in **Discount (%)** when a discount applies. 14. Review the calculated **Item Price**. 15. Enter the tax percentage in **Tax (%)**. 16. Select the item **Currency**. 17. Save the invoice. | If you want to… | Select | | --- | --- | | Remain on the form | **Save** | | Leave the form | **Save and Close** | The save controls are available only when edit access and changed data meet the toolbar conditions. A successful save shows `Invoice saved successfully`. A failed save shows `Invoice failed to save`; a processing problem shows `An error occurred while processing your request`. **Result:** The invoice is saved when `Invoice saved successfully` appears. Continue to [Review currency and totals](#review-currency-and-totals). If saving fails, continue to [When validation fails](#when-validation-fails). ## When validation fails Correct the value named by the validation message, then return to the save procedure. The form validates required header and item values before it processes the save request. | Message | Correction | | --- | --- | | `This Field Is Required` | Enter the required value, including **Invoicing Address** when it is empty. | | `This field is required` | Enter the required item value or other field value identified by the message. | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a quantity or other bounded number greater than zero and no higher than `999,999.00`. | | `Invalid input. Please enter a non-negative value` | Replace a negative quantity, price, tax, or discount with a non-negative value. | | `Validation errors:` | Review the validation messages beside the fields and correct each listed value. | | `An error occurred while processing your request` | Review the invoice values, correct any visible validation problem, then select **Save** to retry the save. | The form also validates **Invoicing Address**. Enter the address in that field and use only the characters it accepts. ## Review currency and totals The invoice summary shows the amounts produced from the item rows and payments. Review the summary after changing item values or currency so the amount due matches the invoice you intend to issue. | Summary value | What it represents | | --- | --- | | **Invoice amount** | Calculated from the item values. | | `Total taxes` | The tax total calculated from the item tax values. | | `Total incl. tax` | The invoice total including tax. | | **Paid Amount** | Already paid against the invoice. | | **Deductions** | Recorded against the invoice. | | **Due amount** | Remaining after paid amounts and deductions. | Changing the currency recalculates the item and summary values in the selected currency. The account due calculation uses the due amount and its currency; a branch-currency display can show the due amount converted for the branch. An invoice with a due amount less than or equal to zero is **Paid**. An invoice whose payment period is overdue is **Overdue**. Otherwise, the invoice is **Due**. ## Out of scope Creating the invoice ends after the new record is saved. The saved invoice workspace owns the related work below: | Saved-record area | Work to continue elsewhere | | --- | --- | | **Comments** | Add or review discussion on the saved record. | | **Attachment** | Manage attached files. | | **Tasks** | Manage tasks linked to the saved record. | | **Activities** | Manage activities linked to the saved record. | | **Deductions** | Review or maintain deductions after the invoice exists. | | **Payments** | Record or review payments after the invoice exists. | | Principal **Invoice** | Continue principal-invoice work on the principal-invoice page. | | **Last Modifications** | Review saved-record history. | The saved invoice can embed files, activities, tasks, address, and contact components, but those components belong to their own follow-up work rather than the new-invoice procedure. Use [Record a payment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/record-payment), [Principal invoices](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/principal-invoices), and [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) for those separate tasks. ## Continue with the saved invoice After saving, continue with the invoice lifecycle for status and approval work. | After saving, if you need to… | Continue with | | --- | --- | | Check the invoice status, including **Draft**, **Approved**, **Due**, **Overdue**, or **Paid** | [Invoice lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/invoice-lifecycle) | | Request approval or approve an eligible invoice | [Invoice lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/invoice-lifecycle) | | Record money received | [Record a payment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/record-payment) | | Continue principal-invoice work | [Principal invoices](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/principal-invoices) | Start the next action from the saved invoice rather than returning to the new-invoice form. # Record a payment An incoming payment is a payment recorded after money is received from an account. Use the finance payment routes to find a payment or enter a new one. Allocation applies the received amount against invoices while preserving the remaining balance. ```mermaid flowchart LR A[Received amount] --> B[Select account] B --> C[Load invoices] C --> D[Enter allocated amount] D --> E[Save payment] D --> F[Remaining balance] ``` ## Before you start Have the account, payment date, amount, currency, and receiving method ready before you open the form. | If you need to… | Go to | | --- | --- | | Find an existing payment or open the payment route | [Find a payment](#find-a-payment) | | Recognise the fields and allocation area | [Understand the payment screen](#understand-the-payment-screen) | | Enter the account, date, amount, and method | [Enter payment details](#enter-payment-details) | | Load invoices and adjust allocation | [Handle payment method and invoice allocation](#handle-payment-method-and-invoice-allocation) | | Correct a validation message before saving again | [Save the payment and resolve errors](#save-the-payment-and-resolve-errors) | | Continue with attached files | [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) | | Maintain the account used by **Received From** | [Accounts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/accounts) | | Maintain payment-method data | [Payment methods](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-payments-methods) | | Maintain bank accounts for bank transfers | [Bank accounts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-banks-accounts) | The new-payment form requires **Received From**, **Receiving Date**, **Received Amount**, and **Recieving Method**. If your subscription does not include the payment feature, the payment form is replaced by a subscription-upgrade surface. Save controls appear only when editing is allowed. ## Find a payment Use the payment list to review incoming payments or open a new incoming-payment form. The invoice route is a separate list, even though it also has an **Incoming Payments** tab. **Prerequisites** - You are signed in to PAMS. - You know whether you are finding an existing payment or recording a new one. **Steps** 1. Open the finance payment list. ![Payment list with its tabs and visible payment columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/bd8f887cd10539b50b8bfbafc7ab9eb2.png) 2. Select the payment-list tab that matches the payment state. | If you need to… | Select | | --- | --- | | Review every payment in the list | **All** | | Review payments that still have an unallocated amount | **Not completely Allocated** | | Review payments whose amount is completely allocated | **Completely Allocated** | 3. Read the payment rows under **Transaction no.**, **Receiving on**, **Account**, **Amount**, **Amount in €**, **Unallocated amount**, and **Unallocated Amount in €**. 4. Use **Refresh**, **Table Layout**, or **Settings** for the corresponding list-toolbar action. 5. Select **Incoming Payment** to open the new-payment route. ![Payment route entry from the finance list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0632793af05f159ff726217821f5a99b.png) The invoice list is a different destination. Return to the payment list before using payment-list tabs or toolbar actions. Treat **Export** on the invoice list as an invoice-list action. The finance destinations are **All**, **Sales Invoices**, **Commission Invoices**, **Payment List**, and **Principals Invoices**. The payment list shows 30 rows per page. Use header filtering, the optional filter row, **Open**, or **Open in new tab** to review a payment. **Delete** appears when your permission allows it. **Result:** The payment list is open with its tabs and payment columns, or the new-payment form is open. Continue with [Understand the payment screen](#understand-the-payment-screen). ### Export the payment list 1. Open the list toolbar's export action. 2. In **Exporting List:**, select **Export to Excel** or **Export to PDF**. 3. Select **Export** to start the export. 4. Select **Cancel** to close the export choices without starting an export. **Result:** The export choices are closed. If the list contains no data, it displays `NO Data to Export`. ### Delete a payment **Prerequisites** - You have permission to use **Delete**. - You have opened the payment list. **Steps** 1. Select **Delete** for the payment. 2. Confirm `Are you sure you want to Delete this payment ?`. **Result:** The payment is deleted and `Data Deleted Successfully` is displayed. ## Understand the payment screen The payment screen combines payment details at the top, invoice allocation in the middle, and tabs for saved payments below. Read these areas before entering values. ### Payment details and readouts The form contains these fields and readouts: | Area | Labels | | --- | --- | | Payment details | **Received From**, **Receiving Date**, **Payment Number**, **Received Amount**, **Currency**, **Recieving Method**, **Reference #**, **Receiving Account**, **Bank Charges** (for **Bank transfer**), **Amount** | | Allocation readouts | **No Invoices To Display**, **Recieved Amount**, **Allocated Amount**, **None Allocated Amount**, **Tickets** | | Saved-payment tabs | **Attachment**, **Last Modifications** | **Payment Number** and **Amount** are read-only when their conditions apply. The visible payment list columns come from the selected list layout. ### Allocation grid The invoice allocation grid uses **Invoice No.**, **Invoice Date**, **Job No.**, **Invoice Amount**, **Paid Amount**, **badDebt Amount**, **Due Amount**, **Due Amount** in default currency, and **Allocated Amount**. Only **Allocated Amount** is editable. Selecting an account loads its invoice allocation data. Keep **Allocated Amount** no higher than the received payment amount. ![Payment screen with details and allocation areas](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f2544bda02cd5cbf96391377f7f5df86.png) Continue with [Enter payment details](#enter-payment-details). ## Enter payment details Enter the payment in the order the form presents it: account, date, amount, currency, receiving method, and any details required by that method. **Prerequisites** - You have opened the new-payment form. - You have the account, date, amount, currency, and receiving method ready. **Steps** 1. In **Received From**, select the account that made the payment. 2. In **Receiving Date**, enter the date the payment was received. 3. In **Received Amount**, enter the amount received. 4. In **Currency**, select the currency for the payment. Each option shows a code, name, and symbol. 5. In **Recieving Method**, select the method used for the payment. 6. Complete the method-specific detail. | If you selected… | Then… | | --- | --- | | **cheque** | Enter the cheque identifier in **Reference #**. | | **Bank transfer** | Select the destination in **Receiving Account**. | | **Cash** | No method-specific field is listed for this choice. | 7. Review **Payment Number** and **Amount** without editing them. **Payment Number** is read-only for an existing payment, and **Amount** is read-only when its currency and payment data are available. **Result:** The payment form contains the base details and the applicable method-specific detail. Continue with [Handle payment method and invoice allocation](#handle-payment-method-and-invoice-allocation). When the received amount is positive, a currency is selected, and assistant currencies are available, the currency-assistant row displays **Amount** and `Rate to` for each displayed currency. ## Handle payment method and invoice allocation The receiving method determines which method-specific fields appear, while the selected account determines which invoices can be allocated. Use the method table in [Enter payment details](#enter-payment-details) when you need to check the applicable field. Allocation cannot exceed the received payment amount. Each option shows a code, name, and symbol. Select the currency that matches the payment. After you select **Bank transfer**, **Receiving Account** becomes available. **Prerequisites** - You have entered the base payment details. - You have selected **Received From** before reviewing invoice allocation. **Steps** 1. Select **Received From** to load invoice allocation data for the account. 2. Review the invoices shown in the allocation grid. 3. Select **Enable Editing** when you need to change an existing payment. 4. Select **Adjust Allocation** when allocation adjustment is available. 5. Keep the total allocated amount at or below the value in **Received Amount**. 6. Select **Exit Enable Editing Mode** when you finish changing an existing payment. 7. If the invoice subscription is unavailable, read **Payable invoices** in the allocation area. 8. If no invoice is available, read `No Invoices To Display`. **Result:** The applicable fields are complete, invoices for the selected account are available for review, and the allocation does not exceed the received payment amount. Continue with [Save the payment and resolve errors](#save-the-payment-and-resolve-errors). An allocation recalculates the invoice due and paid amounts and the payment's allocated and non-allocated amounts. If the allocated amount exceeds the invoice due, the form displays `Allocated amount is bigger than Due Amount`. If it exceeds the received amount, the form displays `Allocated amount is bigger than recieved amount`. ## Save the payment and resolve errors Use **Save** to keep the payment on the form or **Save and Close** to save and leave the page. When you select **Save** on an empty form, the page remains on the new-payment form and displays `Check mandatory field(s)`. > **Note:** An empty save keeps the new-payment form open and displays `Check mandatory field(s)`. ### Save the payment **Prerequisites** - You have completed the applicable payment fields. - You have checked that the allocated amount does not exceed the payment amount. **Steps** 1. Select the save action that matches what you need. | If you need to… | Select | | --- | --- | | Save the payment and remain on the form | **Save** | | Save the payment and leave the page | **Save and Close** | **Result:** The selected save action has been submitted while the payment form remains available or the page is left. **Save** displays `Data saved Successfully`, and a new payment opens its saved record. ### Correct validation messages **Prerequisites** - The payment form displays a validation message. **Steps** 1. Select the destination in **Receiving Account** when the form shows `Receiving account is required` or `Receiving bank account is required`. 2. Select **cheque** when the form shows `Reference # is required`. 3. Enter the cheque identifier in **Reference #**. 4. When the form shows a message, apply the matching correction. | If the message is… | Apply this correction | | --- | --- | | `Check mandatory field(s)` | Complete the field named by the validation message. | | `Client is Required` | Select the account in **Received From**. | | `Receiving Date is Required` | Enter the received date in **Receiving Date**. | | `Received Amount is Required` | Enter the payment amount in **Received Amount**. | | `Received Amount Currency is Required` | Select the payment currency in **Currency**. | | `Payment Method is Required` | Select the payment method in **Recieving Method**. | | `Receiving account is required` or `Receiving bank account is required` | Select the destination in **Receiving Account**. | | `The Allocated Amount is more than Payment Amount` | Reduce **Allocated Amount** so it does not exceed **Received Amount**. | | `Input contains forbidden characters(< , >). Please remove them and try again.` | Remove `<` and `>` from the entered value. | 5. Select **Save** again. ![Mandatory-field validation on the payment form](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/1ca40791d5fc9107398c78c74fe6aed5.png) **Result:** The payment form displays the corrected field or allocation value, ready for another save attempt. Continue with [After the payment is saved](#after-the-payment-is-saved). The allocation-specific messages are `Allocated amount is bigger than Due Amount`, `Allocated amount is bigger than recieved amount`, and `The Allocated Amount is more than Payment Amount`. ## Out of scope The **Deductions** tab is not available for payment work. If `Save error` appears, review the payment values and use the specific validation message when one is displayed. ## After the payment is saved After the payment is saved, use its supporting tabs to continue file work or review its history. The save-success message is `Data saved Successfully`; editing-mode messages are `Enable editing mode is active` and `Enable editing mode is inactive`. **Prerequisites** - The payment is saved. **Steps** 1. Select **Attachment** to continue file work from the saved payment. The attached-documents area opens. Its document action opens the upload-file popup and refreshes the files when the popup closes. 2. Select **Last Modifications** to review the payment's audit-history surface. **Result:** You can continue with attached files or review the payment's history. # Principal invoices A principal invoice is an invoice record that you review through the Principal invoices list and its status views. The list includes **All**, **Upcoming**, **Receivable**, and **Paid**. A considered-paid invoice appears under **Paid**; an invoice returned to due appears under **Due**. ## At a glance Use this page to review a principal invoice record, update it when permitted, and manage its payment or deduction information. The separate list and record areas support different tasks. | If you need to… | Go to | |---|---| | Open the principal-invoice list | [Find and open a principal invoice](#find-and-open-a-principal-invoice) | | Export the selected status view | [Export the current principal-invoice list](#export-the-current-principal-invoice-list) | | Find fields and totals | [Record fields and totals](#record-fields-and-totals) | | Edit an invoice record | [Update the principal-invoice record](#update-the-principal-invoice-record) | | Review payment or deduction information | [Manage payments, deductions, and paid status](#manage-payments-deductions-and-paid-status) | | Add a deduction or principal payment | [Add a deduction or principal payment](#add-a-deduction-or-principal-payment) | | Review the general invoice status flow | [Invoice lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/invoice-lifecycle) | | Record a separate payment | [Record a payment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/record-payment) | | Review purchase invoices or outgoing payments | [Payables](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/payables) | The list is for choosing a status view and selecting an existing invoice. The record is for reviewing invoice information and, when permitted, updating the record or managing related financial information. ## Before you start Principal invoice work depends on subscription access, the selected list layout, the record state, and your role. | What to check | What it changes | |---|---| | Subscription and layout | **All**, **Upcoming**, **Receivable**, and **Paid** appear when the subscription includes the area and the minimum layout is open. | | Invoice details | Actions require an existing invoice and an applicable status. | | Editing access | **Save** and **Save and Close** are available when the record is not opened with an input ID and your account passes the edit-permission check. | | List columns | The visible headers come from the chosen list layout, so another account can show different columns. | | Role | **Principal Payments** is unavailable to a principal user. | Deductions require at least due status. Payment and considered-paid actions have their own status conditions. Use the status shown on the record and the controls that appear there before choosing related work. > **Note:** Principal invoices is separate from the general invoice lifecycle and from Payables. > Use the page that owns the next task instead of treating a status tab as a lifecycle transition. ## Find and open a principal invoice Choose a status view and open an existing invoice when its row can be selected. **Prerequisites** - The Principal invoices area is included in your subscription. - The list layout is open and an existing invoice row is available. **Steps** 1. Open the Principal invoices page. 2. Select the status view that answers your question. | If you need to review… | Select | |---|---| | All invoice statuses | **All** | | Upcoming invoices | **Upcoming** | | Receivable invoices | **Receivable** | | Paid invoices | **Paid** | 3. Confirm that the chosen status view and its table are visible. If the status view cannot load, the page displays `Load data failed: `. ![The Principal invoices list with the All status view selected](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/78c269468e8f9cb9e304dc8b1cb7c24f.png) 4. Select the existing invoice row you need to review. 5. Confirm that the invoice details open before choosing an action. **Result:** The chosen status view is on screen, or the existing invoice record is open for review. ### Export the current principal-invoice list After the status view is open, export its current rows. **Prerequisites** - A Principal invoices status view is open. - **Export** is available on the list page. **Steps** 1. Select **Export**. 2. Review the export page. 3. If list options are presented, use **Filter Row** and **Group Panel** according to the arrangement you need. ![The export surface for the selected Principal invoices list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f1137c82b8c7d2b083f567f6a77ea392.png) **Result:** The export page for the selected list is open. ## Understand the principal-invoice screen The screen has a list page for status views and a record page for invoice details. The record also exposes related tabs and status actions when the record conditions allow them. The list page shows `Tracking Principal Invoices`, the status filters, and **Refresh**, **Table Layout**, and **Settings**. The record page contains invoice fields, amount information, related tabs, and **Consider As Paid** and **Consider As Not Paid** when their conditions are met. | Area | What it is for | Conditions that affect it | |---|---|---| | Principal invoices list | Choose **All**, **Upcoming**, **Receivable**, or **Paid**, then review rows. | Subscription and minimum-layout conditions control the status filters. | | Invoice record | Review or edit fields for an existing invoice. | The record must exist; edit actions also require edit permission. | | **Comments** | Open comments related to the record. | The record cannot be upcoming or awaiting principal payoff, and comments access must be available. | | **Deductions** | Review deduction entries and, where allowed, add one. | The record must be at least due and meet the deduction conditions. | | **Principal Payments** | Review principal-payment entries and, where allowed, add one. | The record cannot be upcoming or awaiting principal payoff, and the reader cannot be a principal user. | | **Last Modifications** | Open the record modification history. | The record cannot be upcoming or awaiting principal payoff. | The list table uses the columns from your chosen layout. The invoice details use their own fields and related tables. ### List columns The same 12 headers appear in **All**, **Upcoming**, **Receivable**, and **Paid**: | First set of headers | Second set of headers | |---|---| | `Invoice No.` | `Job No.` | | `Account` | `Due Date` | | `Invoice Amount €` | `Invoice Amount` | | `Paid Amount` | `Paid Amount €` | | `Due Amount` | `Due Amount NaN` | | `Total Sales Price` | **Status** | The list can also include **Item descrption** and **Amount**. Work from the headers visible in your current list; other saved layouts can show a different set of columns. ![The runtime columns visible for the current Principal invoices layout](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/b7610132378b2094791429fe88a05944.png) ### Record fields and totals An invoice record brings together parties, dates, identifiers, description, note, and amount information. Open an existing record before using these fields. | Field | Type | Requirement | |---|---|---| | **Client** | Text | Required only when company configuration makes it required. | | **Vendor** | Text | Required only when company configuration makes it required. | | **Shipment Date** | Date | Optional. | | **Invoice Date** | Date | Optional. | | **Order Date** | Date | Optional. | | **Delivery Date** | Date | Optional. | | **End User** | Text | Optional. | | **Salesperson Responsible** | Text | Optional. | | **Product Type** | Text | Optional. | | **Vendor Order No.** | Text | Optional. | | **Client Order No.** | Text | Optional. | | **Invoice No.** | Text | Required only when company configuration makes it required. | | **Job Title** | Text | Optional. | | **Item Description** | Text | Optional. | | **Note** | Text | Required only when company configuration makes it required. | **Client**, **Vendor**, **Invoice No.**, and **Note** are configurable required fields. Check the required marker on this record rather than treating all four as universally required. Amount information appears in the invoice amount area and in the deduction and payment grids. ### Payment, deduction, and paid-status fields The related dialogs collect different financial information. | Dialog | Required fields | Limits or choices | |---|---|---| | Principal payment | Payment amount, **Payment Date**, and **comment** | Amount must be greater than 0 and cannot exceed the due invoice amount. **Payment Date** cannot be later than today. | | Principal deduction | Deduction amount, **Deduction reason**, and **comment** | Amount must be greater than 0 and cannot exceed the due invoice amount. | | Considered paid | **For Sure Paid**, **Probably Paid**, and **Reason For Consideration As Paid** | Each field is required before the paid-status save path. | The **Deduction reason** choices are `Late Delivery`, `Technical Reason`, `Missed Parts`, `Missed Services`, and `Unreasoned`. ## Update the principal-invoice record Change editable invoice fields on an existing record. **Prerequisites** - The existing principal invoice record is open. - The record is opened without an input ID. - Your account passes the record's edit-permission check. **Steps** 1. Enter the new invoice number in **Invoice No.**. 2. Choose how to save the record. | If you want to… | Select | |---|---| | Keep the record open | **Save** | | Save the record and leave the page | **Save and Close** | 3. If validation stops the save, correct the fields marked as required and repeat your selected save option. A successful record update displays `Your request was completed successfully`. A validation failure displays `Check validation`. **Result:** The record is saved with the success message, or it remains open with `Check validation` so you can correct it. ## Manage payments, deductions, and paid status After reviewing the record fields, use the related tab that matches the financial work. **Prerequisites** - An existing principal invoice record is open. - The record status and your role permit the related work. **Steps** 1. Select the related tab that matches the work. | If you need to… | Select | |---|---| | Review comments | **Comments** | | Review or add deductions | **Deductions** | | Review or add principal payments | **Principal Payments** | | Review record changes | **Last Modifications** | 2. Review the table columns in the chosen tab. 3. If **Deductions** is available, use it only when the invoice has reached at least due status. 4. If **Principal Payments** is available, use it only when you are not a principal user. 5. Choose the permitted financial branch from the table below. | If you need to… | Continue with | |---|---| | Consider the invoice paid | [Consider an invoice paid](#consider-an-invoice-paid) | | Return an invoice to due | [Return an invoice to due](#return-an-invoice-to-due) | | Add a deduction or principal payment | [Add a deduction or principal payment](#add-a-deduction-or-principal-payment) | **Result:** The permitted related-work tab is open, or its unavailable condition explains why that branch cannot be used for the current record. ### Consider an invoice paid Use **Consider As Paid** when an existing record has a positive outstanding amount and its status is eligible for the considered-paid branch. **Prerequisites** - An existing record is open on its standalone details page. - The record is not upcoming or already paid. - The applicable status guards permit the action. - The outstanding amount is positive. **Steps** 1. Select **Consider As Paid**. 2. Enter the required information in **For Sure Paid**, **Probably Paid**, and **Reason For Consideration As Paid**. 3. Select **Save** in the dialog. 4. Confirm that the record returns to its paid-status branch. **Result:** The considered-paid information is saved and the invoice is shown in the paid-status branch. ### Return an invoice to due Use **Consider As Not Paid** for an invoice that is currently considered paid. **Prerequisites** - An existing record is open. - The record is currently considered paid. **Steps** 1. Select **Consider As Not Paid**. 2. Confirm that the record returns to the due branch. The considered-paid status appears under **Paid**. The corresponding due status appears under **Due**. **Result:** The invoice is shown under **Due**. ### Add a deduction or principal payment Choose one entry path after opening the permitted related tab. **Prerequisites** - An existing record is open on a permitted, standalone details page. - For a deduction, **Deductions** is active and the record is not paid or considered paid. - For a principal payment, **Principal Payments** is active and the record status permits payment. **Steps** 1. Follow the applicable path. | Entry path | Actions | |---|---| | Deduction | In **Deductions**, enter the deduction amount. Select a **Deduction reason**. Enter the required **comment**. Select **Save**. | | Principal payment | In **Principal Payments**, enter the payment amount. Enter **Payment Date** and the required **comment**. Select **Save**. | For either amount, enter a value greater than 0 that does not exceed the due invoice amount. A successful save displays `Your request was completed successfully`; a payment validation failure displays `Check validation`. **Result:** The new deduction or principal payment is saved and appears in its related grid, or the dialog remains open with the validation message so you can correct the entry. ## When a principal-invoice action fails Use the message on screen to correct the value or choose the appropriate page. | What you see | What to do | |---|---| | `This Field Is Required` | Enter a value in the field marked as required, then repeat the action. | | `Amount must be greater than 0 and can't exceed due invoice amount` | Enter an amount greater than 0 and no greater than the due invoice amount. | | `Check validation` | Correct the highlighted payment or record fields, then repeat the save action. | | `Load data failed: ` | Read the error message, then reload the Principal invoices page. | | `Updating error ` | Read the error text, correct the record, and repeat the update. | | `Deductions Reasons failed to load` | Reload the deduction area and retry when the choices are available. | | `Are you sure you want to delete this payment?` | Read the confirmation and continue only if you intend to remove the payment. | | `Are you sure you want to delete this deduction?` | Read the confirmation and continue only if you intend to remove the deduction. | If a related tab or action is absent, check the record status and whether your role permits the branch. ## After reviewing a principal invoice When you finish the list and record work, continue to the page that owns the next task. | If you need to… | Continue to | |---|---| | Follow the general invoice status flow | [Invoice lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/invoice-lifecycle) | | Record a separate payment | [Record a payment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/record-payment) | | Review purchase invoices or outgoing payments | [Payables](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/payables) | # Payables Payables is the finance reference point for finding purchase invoices and outgoing payments, reviewing their list information, and moving to the page for the next task. Purchase invoices are amounts owed for purchases. Outgoing payments are payments that can be reviewed by their allocation state. ## Payables Payables brings together the lists used to review purchase invoices and outgoing payments. Select the list tab that matches the records you need to review. | If you need to… | Go to | |---|---| | Open the purchase-invoice list or choose its status tab | [Find a purchase invoice or outgoing payment](#find-a-purchase-invoice-or-outgoing-payment) | | Review columns, filters, and allocation counts | [Understand the Payables lists](#understand-the-payables-lists) | | Change the table layout | [Choose a list layout](#choose-a-list-layout) | | Export the current list | [Export a Payables list](#export-a-payables-list) | | Record a payment after selecting a payment action | [Record a payment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/record-payment) | | Create an invoice from the finance flow | [Create an invoice](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-invoice) | | Review additional direct-cost transactions | [Cost transactions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/cost-transactions) | The purchase-invoice and outgoing-payment tabs are separate list families. Select **Purchase Invoices** or **Outgoing Payments** to view the corresponding list. ![Payables with the purchase-invoice tabs and table visible](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/bdeff21e499d40d9f9716d2120c0600b.png) ## Before you start Payables can show different tabs, actions, and columns for different subscriptions, permissions, and saved table layouts. Prepare for the following conditions before you choose a list: | What to check | What you see or use | |---|---| | Subscription access | The main Payables tabs appear when the subscription includes the feature. When it does not, an upgrade surface appears instead. | | Selected table layout | A grid appears when a table layout is selected for the current list and the selected tab permits that grid. | | List columns | The headers come from the selected layout, so the columns in your account can differ from another account. | | Available actions | Actions such as payment, layout management, and export depend on the permissions and feature settings available to your account. | The list uses the selected layout's columns rather than a fixed business-column list. Work from the headers visible in your list when you identify a record. **Note:** Available actions vary with your permissions. Use the controls that appear in your account rather than assuming that a payment or layout action is available. When these conditions are clear, select the list family you need. ## Find a purchase invoice or outgoing payment **Prerequisites** - You can open the Payables page and the subscription includes the Payables tabs. **Steps** 1. Select the list family that matches your task. | If you need to… | Select | |---|---| | Review purchase invoices | **Purchase Invoices** | | Review outgoing payments | **Outgoing Payments** | 2. If you selected **Outgoing Payments**, choose the allocation view. | If you need to review… | Select | |---|---| | Payments that are not fully allocated | **Not completely Allocated** | | Payments that are fully allocated | **Completely Allocated** | 3. Confirm that the selected list and its tabs are visible. The purchase-invoice list opens at `/finance/payables/list/purchase-invoices/view`. The outgoing-payment list opens at `/finance/payables/list/outgoing-payment/view`. **Not completely Allocated** opens `/finance/payables/list/outgoing-payment-not-completely-allocated/view`, and **Completely Allocated** opens `/finance/payables/list/outgoing-payment-completely-allocated/view`. The **Purchase Invoices** and **Outgoing Payments** tabs and the available list columns appear together on the Payables page. ![Outgoing Payments with its allocation tabs visible](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6d2bd53c2f4ab2f36d2ac809c4befbb6.png) **Result:** The selected Payables list is on screen. For outgoing payments, the selected allocation view is also on screen. Use the selected list's tabs and headers to identify the records you need to review. ## Understand the Payables lists The purchase-invoice list helps you separate invoices by payment status; the outgoing-payment list helps you separate payments by allocation status. The visible rows and headers belong to the account and list layout you are using. | List | Tabs | Columns visible in the displayed list | |---|---|---| | Purchase invoices | **All**, **Upcoming**, **Payable**, **Paid** | **Account**, **Created By**, **Job No.**, **Shotec S.A.E Order No.**, **Sub-supplier Order No.**, **Payment Due Date**, **Total Amount**, **Total Amount (€)**, **Due Amount**, **Due Amount (€)**, **Paid Amount**, **Paid Amount (€)**, **Status** | | Outgoing payments | **Not completely Allocated**, **Completely Allocated** | **Transaction no.**, **Receiving on**, **Account**, **Amount**, **Unallocated amount** | In the purchase-invoice list, `Due` and `Upcoming` appear as row values in **Status**. They are record values, not default values for every account. In the outgoing-payment views, the displayed rows show `Count: 6.00` for **Not completely Allocated** and `Count: 14.00` for **Completely Allocated**. These are values from the records in that account. The shared list controls can appear conditionally: **Apply filter**, **Clear applied filter**, **Refresh**, **Filter Row**, and **Group Panel**. Use them when they are shown. Use the headers in the outgoing-payment list to identify a payment. This list has no labelled form fields or text-labelled actions. ![Purchase Invoices with the status tabs and visible headers](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/298cf334abe05cc753aef81abee36713.png) ![Not completely Allocated with its allocation count and headers](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/56008af98f6459133f8d6f5fd2ef4962.png) When you know which columns and controls you need, continue to the list-layout choices or the export action. ### Choose a list layout Use a table layout when you need the list to use a saved arrangement of columns or when your account exposes the layout-management controls. **Prerequisites** - You have opened the Payables list whose columns you want to review. - Your account permits table-layout management. **Steps** 1. Select **table layout**. The available choices use the saved layout names in your account. 2. Choose the action that matches your layout task. | If you need to… | Select or enter | |---|---| | Use the displayed standard layout | **Standard Layout** | | Create a saved layout | **Save New Layout**, enter the layout name in the layout-name entry area, then select **Save** | | Change the current saved layout | **Update Current** | | Remove the current saved layout | **Delete Current** | | Review column choices | **Columns Chooser** | | Change a column width | **Expand column width** | The chooser provides **Close**. The purchase-invoice list has 13 visible columns when the chooser is opened. 3. If the layout controls are no longer visible, press `Escape` to close the chooser or return to the list before selecting **table layout** again. ![table layout choices including Standard Layout and saved-layout controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6abdac7d6495852c5a7a27c2230b9a9b.png) ![Columns Chooser with the Close control visible](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e5d7e9830ba6ed3597e69b2862b3b167.png) **Result:** The chosen layout remains selected, or the layout chooser is closed with the current list columns unchanged. After choosing a layout, export the current list if you need a file, or continue to the available payment branch. ## Export a Payables list Use **Export** when your account makes export available for the Payables list. **Prerequisites** - You have opened the Payables or purchase-invoice list to export. - Export is allowed for your account. **Steps** 1. Select **Export** when it is available. 2. Follow the export surface that opens for the selected list. **Result:** The available export flow opens for the Payables list. When export is not allowed, the **Export** control is disabled. If you are continuing with a payment rather than a file, use the payment branch below. ## Handle list and payment branches The Payables page separates list review from the payment pages that own payment recording. Choose the branch that matches the record or payment work you need to continue. **Prerequisites** - You know whether you are reviewing purchase invoices or outgoing payments. - The required action is available in your account. **Steps** 1. Select the branch that matches the work. | If you need to… | Select | |---|---| | Review purchase invoices | **Purchase Invoices** | | Review outgoing payments | **Outgoing Payments** | | Open the outgoing-payment action menu | **Outgoing Payment** | | Open the purchase-invoice payment page | **Pay Purchase Invoice** | | Open the additional-cost payment page | **Pay Additional Direct Cost** | The purchase-invoice and outgoing-payment surfaces appear under their corresponding tab conditions. Each action is available only when the account permits it. **Result:** The permitted list or payment branch opens. If an action is rejected, use the message in the next section before trying the branch again. ## When a Payables action fails Use the message on screen to correct a rejected value. Payables uses this validation message: | What you see | What to do | |---|---| | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the value you entered, then repeat the action. | Select **table layout** when it appears. If it does not appear, continue with the controls visible on the list. After correcting a rejected value, return to the relevant list and use the available branch. ## Continue from a Payables list After reviewing a Payables list, select **Pay Purchase Invoice** or **Outgoing Payment** when available, then review the page that opens before entering payment information. # L/G lifecycle Use this page to find an existing letter of guarantee (L/G), review its stage, and follow the available approval, return, closure, liquidation, cancellation, extension, deduction, or increase branch. ## L/G lifecycle at a glance An L/G is a saved letter-of-guarantee record that moves through product stages while its approval, active use, return, and closure work is handled. The L/G list uses these stage labels: | Stage label | | --- | | **Draft** | | **Awaiting Approval** | | **Approved** | | **Active** | | **Due for Return** | | **Expired** | | **Returned** | | **Closed** | | **Cancelled** | | **Liquidated** | The list presents stage tabs for early, approval, active, returned, closed, cancelled, liquidated, and expired L/G work. Early L/G work appears in the **All** and **Draft** views. Find an existing L/G by selecting its stage tab in the L/G list. On a saved record, the available actions are grouped as follows: | Work | Available actions | | --- | --- | | Approval | **Request approval**, **Approve**, **Cancel**, **Reject approval request** | | Stage movement | **Due for Return**, **Returned**, **Liquidated**, **Active** | | Record branches | **LG Extensions**, **LG Deductions**, **LG Increase** | The stage, recommendation state, approval process, and permissions determine which action appears. ```mermaid stateDiagram-v2 state "Requested" as sRequested state "Awaiting Approval" as sAwaitingApproval state "Rejected Approval" as sRejectedApproval state "Approved" as sApproved state "Active" as sActive state "Due for Return" as sDueForReturn state "Returned" as sReturned state "Liquidated" as sLiquidated state "Cancelled" as sCancelled sRequested --> sAwaitingApproval: Request approval sAwaitingApproval --> sApproved: Approve sAwaitingApproval --> sRejectedApproval: Reject approval request sAwaitingApproval --> sRequested: Cancel approval request sApproved --> sActive: Active sActive --> sDueForReturn: Due for Return sDueForReturn --> sReturned: Returned sActive --> sLiquidated: Liquidated sRequested --> sCancelled: Cancel ``` Use the later sections according to the work you need. | If you need to… | Go to | | --- | --- | | Check the record, subscription, and approval conditions | [Before you start](#before-you-start) | | Reach the list and choose a stage view | [Find an L/G](#find-an-lg) | | Recognize the saved-record surface and its supporting tabs | [Understand the L/G screen](#understand-the-lg-screen) | | Review the starting fields for a new record | [Review a new-record surface](#review-a-new-record-surface) | | Submit an L/G or follow approval | [Submit and approve an L/G](#submit-and-approve-an-lg) | | Return, close, liquidate, or cancel an L/G | [Return, close, liquidate, or cancel an L/G](#return-close-liquidate-or-cancel-an-lg) | | Extend, deduct, increase, or enable editing | [Handle extensions and editing branches](#handle-extensions-and-editing-branches) | | Correct a blocked action or validation problem | [Fix errors and continue](#fix-errors-and-continue) | | Continue to the next owned record task | [Continue after the lifecycle action](#continue-after-the-lifecycle-action) | | Create a new L/G | [Create an L/G](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-l-g) | | Use the finance L/G view | [L/G finance view](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/l-g-finance-view) | | Work from the sales-job record | [Sales job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-record) | ![Use the stage tabs and visible list rows to identify the L/G stage view.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9cd3ab70e67bca54819fa9f9540f9c7b.png) ## Before you start An existing-record lifecycle action starts from a saved L/G in the L/G list or its record surface; the list and details areas appear only in their applicable job, subscription, and page contexts. | Prepare | Why it matters | | --- | --- | | Open the L/G list from an open job record. | The list is available from the job context. | | Use a subscription that includes the Letter of Guarantee module. | The L/G list checks the Letter of Guarantee module subscription before it appears. | | Open the details surface for an existing, saved record rather than the new-record popup. | Existing-record actions require saved information and no unsaved changes. | | Use the L/G details view in the **L/G** tab. | The details surface is shown in that tab. | | Have the permission required by the action. | Approval controls depend on your account's permission and the approval settings. | | Confirm the person or role who must approve the L/G before selecting an approval action. | Approval actions require the applicable approval authority. | The saved-record action surface is available when the L/G is saved and has no unsaved changes. The approval branch also checks whether approval applies, whether your account may use it, and whether you are finance responsible. Keep the record saved before starting a stage action. **Note:** Before selecting **Save** or the available delete action, identify the person or role with approval authority when your approval process requires it. ## Find an L/G The L/G list is the place to choose a stage view, read the available rows, and open an existing record. Work from the headers currently shown in your list. **Prerequisites** - An open job record is available. - The Letter of Guarantee module is included in your subscription. - You know the stage view in which the saved L/G is listed. **Steps** 1. Open the L/G list in the job record. 2. Select the stage view that matches the record you need. | If you need to… | Select | | --- | --- | | Review the list without a stage restriction | **All** | | Review draft or requested work | **Draft** | | Review approval work | **Awaiting Approval** | | Review approved work | **Approved** | | Review active work | **Active** | | Review L/Gs due for return | **Due for Return** | | Review expired work | **Expired** | | Review returned work | **Returned** | | Review closed work | **Closed** | | Review cancelled work | **Cancelled** | | Review liquidated work | **Liquidated** | 3. Read these visible headers before selecting a record: `L/G no.`, `Beneficiary`, `L/G issuer`, `Bank`, `Requested value`, `Issued value`, `Current value`, `Issue date`, `Expiry date`, `Job No`, `Stage`, `L/G type`, and `Increase amount`. 4. Select the row for the saved L/G you need to review. 5. Use the list toolbar when the related list task is required: **Refresh**, **Table Layout**, or **Settings**. 6. Select **Export** when the list provides the export control. 7. Select **Delete** when the record is eligible for deletion. ![Recognize the L/G list headers, stage tabs, and toolbar buttons.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c4634e2be2090eec18a27b7a65bd4ab0.png) **Result:** The L/G is ready to open from its current stage list, and the headers show which record row to choose. The columns depend on the current list layout, so use the headers visible on your screen. ## Understand the L/G screen The saved L/G screen combines record information, stage actions, controlled-editing branches, and supporting tabs. A control appears only when its stage and guard conditions allow it. The saved-record surface includes approval, return, terminal, and branch actions. Recommendation controls appear at or beyond the requested stage when the corresponding sales or finance recommendation is required. The supporting tabs are **Comments**, **Attachment**, and **Last Modifications**. The screen also contains the deduction, extension, and increase tab branches. Use those branches for their own supporting work; they do not replace the stage action for the L/G record. If a saved action produces no visible response, use the recovery guidance in [Fix errors and continue](#fix-errors-and-continue). ### Review a new-record surface The new-record surface collects the starting L/G information before later lifecycle actions become relevant. Use the [Create an L/G](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-l-g) page for the complete creation procedure. The surface can contain **Expiry Date**, **On Behalf of**, **LG Type**, **Confirmation Of The LG Requirement**, **Confirmation Of The Financial Viability**, **Extension Period**, **Expiration date**, and **Reason**. **LG Type** has these choices: **Bid bond**, **Down payment guaranty**, **Performance bond**, and **Warranty bond**. The confirmation fields use these values: | Field | Values | | --- | --- | | **Confirmation Of The LG Requirement** | **Yes** or **No** | | **Confirmation Of The Financial Viability** | **Yes** or **No** | **On Behalf of** uses the vendor choices available in the record's vendor list. The new-record surface provides **Save** and **Save and Close**. Lifecycle work starts after a saved record is available. ## Submit and approve an L/G Approval is the controlled review path that moves a saved L/G from requested work through approval and into the active stage when the applicable controls and permissions allow it. | Current stage or condition | Control | Product direction | | --- | --- | --- | | Requested work ready for the approval path | **Request approval** | The action prepares the L/G for **Awaiting Approval**. | | Approval is allowed for the current user | **Approve** | The action prepares the L/G for **Approved**. | | An approval request is open | **Cancel approval request** | The request is cancelled through the unsubmission preparation branch. | | An approval request is open and rejection is allowed | **Reject approval request** | The L/G is prepared for **Rejected Approval**. | | An approved L/G can enter active use | **Active** | The action uses the submission preparation branch for the active stage. | **Prerequisites** - The L/G is saved. - The current stage and approval condition match one row in the table. - The approval process and your approval permission allow the approval action shown in the record action area. - The person or role responsible for approval has been identified before the approval action. **Steps** 1. Open the saved L/G and read its current stage. 2. Select the control that matches the L/G's current stage and approval condition. | If you need to… | Select | | --- | --- | | Submit requested work for approval | **Request approval** | | Approve an L/G awaiting approval | **Approve** | | Withdraw an approval request | **Cancel approval request** | | Reject an approval request | **Reject approval request** | | Move an approved L/G into active use | **Active** | 3. Read the stage shown on the record before starting the next lifecycle branch. **Result:** The L/G shows the stage exposed by the approval control you used: **Awaiting Approval**, **Rejected Approval**, **Approved**, or **Active** when the corresponding preparation completes. ## Return, close, liquidate, or cancel an L/G Return and terminal actions move an L/G out of active or approval-related work into the corresponding return, closed, liquidated, expired, or cancelled view. | Control | Stage condition or branch | Resulting stage | | --- | --- | --- | | **Due for Return** | The current L/G can enter the due-for-return branch. | The record enters the due-for-return stage. | | **Returned** | The L/G is in the returned preparation branch and the return information is accepted. | The record is recorded as returned. | | **Liquidated** | The L/G can enter liquidation. | The record enters liquidation. | | **Cancel** | The current L/G permits cancellation. | The record enters the cancelled stage. | | **Closed** | The close preparation branch is available. | The record is closed. | **Prerequisites** - The L/G is saved. - The current stage shows the matching action in the record action area. - You have the permission required for that control. - For a return action, the return information required by the popup is available. **Steps** 1. Open the saved L/G and read its current stage. 2. Choose the action that matches the record's required outcome. | If you need to… | Select | | --- | --- | | Mark the L/G due for return | **Due for Return** | | Record that the L/G was returned | **Returned** | | Enter the liquidation branch | **Liquidated** | | Cancel the L/G | **Cancel** | | Close the L/G | **Closed** | 3. Read the resulting stage before leaving the record. **Result:** The L/G is shown in the stage view produced by the control: due for return, returned, liquidated, cancelled, expired, or closed. The available result depends on the current-stage guard. ## Handle extensions and editing branches Extension, deduction, and increase branches change the controlled information on an existing L/G; they are separate from the main approval and return actions. | If you need to… | Select or use | Fields handled | | --- | --- | --- | | Extend the L/G as a warranty bond | **Extend As Warranty Bond** | **Extension Period**, **Expiration date**, and **Reason** | | Enter a deduction | **LG Deductions** | **LG Deduction Date**, **LG Deduction Percentage**, and **Reason** | | Enter an increase | **LG Increase** | **LG Increase Date**, **LG Increase Percentage**, and **LG Increase Reason** | | Review extension entries | **LG Extensions** | Extension records for the L/G | | Edit a controlled existing record | **Enable Editing** | Fields permitted by the active editing branch | **Prerequisites** - The L/G is saved and the applicable branch is visible. - The record is **Active** where the active-stage condition controls the branch. - You have the permission required to enable editing or save the branch. **Steps** 1. Open the saved L/G and read the visible branch controls. 2. Follow the branch that matches the work you need. | If you need to… | Select or enter | | --- | --- | | Extend the L/G as a warranty bond | Select **Extend As Warranty Bond**; enter **Extension Period**, **Expiration date**, and **Reason**. | | Enter a deduction | Select **LG Deductions**; enter **LG Deduction Date** and **LG Deduction Percentage**. | | Enter an increase | Select **LG Increase**; enter **LG Increase Date**, **LG Increase Percentage**, and **LG Increase Reason**. | | Save an increase | Use the increase branch's save action. | | Edit a controlled field | Select **Enable Editing** before changing the field. | **Result:** The extension, deduction, increase, or editing branch named in the table is open, or the record remains unchanged when its stage or permission guard does not expose that action. ## Fix errors and continue Use the exact message on screen to choose the correction. These messages belong to the L/G lifecycle surface. | What you see | What it means | What to do | | --- | --- | --- | | `Your request was completed successfully` | The requested action completed. | Read the record stage and continue from the resulting view. | | `An error occurred while processing your request` | Processing failed while the action was handled. | Review the current stage and permission, then ask an administrator to review the action if it remains unavailable. | | `You don’t have permission` | Your permission does not allow the action. | Ask for the required L/G or approval permission. | | `Please Add Extension to activate the LG` | The L/G needs an extension before activation. | Add an extension, then return to the activation branch. | | `LG has one or more extensions or deductions and cannot be reverted to the requested stage` | The L/G cannot return to the requested stage while those entries exist. | Review the extension and deduction branches before retrying. | | `LG still needs confirmation` | A required L/G confirmation is incomplete. | Complete the applicable confirmation before retrying the action. | | `Please choose a date after the current expiry date` | The extension date is not after the current expiry date. | Choose a later **Expiration date**. | | `There is a pending increase you can edit` | An increase is already pending and can be edited. | Edit the pending increase instead of starting another one. | | `Forbidden characters detected. Please remove them and try again.` | A value contains a forbidden character. | Remove the forbidden character and retry the action. | The named field rules are also part of recovery: `IncreaseAmount` accepts a minimum of `0.01`, `IncreaseDate` cannot be later than today, `ExpiryDate` cannot be earlier than today, and an extension **Expiration date** cannot be earlier than the current L/G expiry date. Several other requirements depend on company configuration. If the list headers differ from the headers you expect, work from the columns currently visible in the selected list layout. If a saved action produces no visible response, do not assume that it completed; reread the stage and ask an administrator to review the action. ### Out of scope messages Some messages and surfaces belong to subscription, navigation, comments, attachments, files, or history work rather than to an L/G stage transition. | Surface or message | Use its owning area for | | --- | --- | | `subscriptionNotInclude` | Subscription access to the Letter of Guarantee module | | `PageNotFound` | A missing or unavailable page | | **Back** | Returning from a supporting or unavailable surface | | **Go Back to Home Page** | Returning to the application home page | | `comments-component` | Comment work | | `shared-attached-docs` | Shared attachment work | | `files` | File work | | `log-history` | History and modification review | These surfaces can appear around an L/G record, but they do not define the L/G stage lifecycle. ## Continue after the lifecycle action After a lifecycle action, read the stage shown on the open L/G record to determine which record view or follow-up task owns the next work. | Current need | Continue with | | --- | --- | | Review the L/G without changing it | the letters-of-guarantees view-record page | | Edit an eligible L/G record | the letters-of-guarantees edit-record page | | Review the finance-route L/G | the finance letters-of-guarantees view-record page | | Edit the finance-route L/G | the finance letters-of-guarantees edit-record page | | Create a new L/G | the Create an L/G page | | Continue from the sales-job context | [Sales job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-record) | Use the L/G stage shown on the record to decide whether to continue with approval, active use, return, closure, liquidation, cancellation, or expiry. For a new record, use [Create an L/G](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-l-g). For finance-specific work, use [L/G finance view](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/l-g-finance-view). # Create an L/G Use this page to open the new L/G form, enter a basic letter-of-guarantee request, or locate a saved L/G before continuing with lifecycle work. ## What an L/G is An L/G is the product's record for a letter of guarantee. Create the record or locate an existing one before you work with its approval, activation, return, closure, or other lifecycle stages. The L/G lifecycle includes `NA`, `Requested`, `Awaiting Approval`, `Rejected Approval`, `Approved`, `Running`, `Due for Return`, `Returned`, `Cancelled`, `Liquidated`, `Expired`, `Closed`, and `Valid Inclusion`. | If you need to… | Go to | |---|---| | Enter a new letter-of-guarantee request | [Enter and save the basic request](#enter-and-save-the-basic-request) | | Find a saved L/G by scope or stage | [Find a new or saved L/G](#find-a-new-or-saved-lg) | | Continue approval, stage, return, closure, liquidation, cancellation, extension, deduction, or increase work | [L/G lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/l-g-lifecycle) | | Use the finance-route list and record view for reference work | [L/G finance view](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/l-g-finance-view) | | Work with the L/G surface in a sales-job record | [Sales job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-record) | | Review the sales-job L/G relationship and history | [Sales job contacts, guarantees, and history](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-contacts-guarantees-and-history) | The create route and saved-record list are separate entry points. The L/G list is a list screen, and the L/G details screen is a form screen; their available controls vary with the route and the record state. ```mermaid flowchart LR A[Need an L/G] --> B[Open the new form] A --> C[Open the saved-record list] B --> D[Enter the basic request] D --> E[Continue with saved-record work] C --> F[Choose a scope and stage view] F --> G[Open the matching row] G --> E ``` ## Before you start An L/G page appears only when the application, subscription, record, and permission conditions allow that surface. Have the following ready before you choose a route. | Check | What must be true | Why it matters | |---|---|---| | Route | Use the finance routes for a new form or the saved-record list. | The route determines whether you enter a request or locate an existing record. | | Subscription | The details form is available only when the subscription condition allows it. | A blocked subscription prevents the details form from opening. | | Record | Saved-record recommendations require a saved L/G at or after `Requested`. | The recommendation fields belong to saved-record work, not the initial entry. | | Permission | Your account must have permission to view the page and use the relevant action. | A permission restriction can stop the page or an action before you can work. | | Request information | Have the beneficiary, issuer, requested value, expiry information, and any configured request values ready. | These values are the information used by the create form. | The details form also requires its L/G details record to be present. The new-form controls are shown for the new-form route condition. In a sales-job record, the L/G list appears in the L/G tab when that tab is selected. Extension, deduction, increase, return, and edit controls appear in their corresponding popup states. Recommendation controls appear only for a saved record at or after `Requested` and when the relevant recommendation setting applies. > **Note:** The create task and the lifecycle task are different. First create or locate the L/G; > then use [L/G lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/l-g-lifecycle) for later stage work. ## Find a new or saved L/G Use the new route when you are entering a request. Use the saved-record list when you need to identify an existing L/G by its scope, stage, or row values. Prerequisites - You have access to the applicable finance or sales-job surface. - For a saved record, you know enough of its beneficiary, issuer, job, or stage to recognise its row. Steps 1. Choose the route that matches your task. | If you need to… | Open | |---|---| | Enter a new request | The new L/G form | | Locate a saved record | The Financial LGs All Jobs list | ![The L/G entry points for opening a new form or saved-record list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2e0b3b9365c1ce341b46cf73e5167c17.png) 2. If you opened the new form, continue to [Enter and save the basic request](#enter-and-save-the-basic-request). 3. If you opened the Financial LGs All Jobs list, choose the scope that answers your search. | If you need to search… | Select | |---|---| | Across the available L/G records | **All** | | Company L/G records | **Company LGs** | | Principal L/G records | **Principal LGs** | ![The Financial LGs All Jobs list with its scope controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/79fc519b737e14734a18590a6768fbab.png) 4. Select the stage view that answers your search. | If you need to find records that are… | Select | |---|---| | In any listed stage | **All** | | Draft | **Draft** | | Waiting for approval | **Awaiting Approval** | | Approved | **Approved** | | Active | **Active** | | Due for return | **Due for Return** | | Expired | **Expired** | | Returned | **Returned** | | Closed | **Closed** | | Cancelled | **Cancelled** | | Liquidated | **Liquidated** | ![The Active stage view](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d3698204457260f2efa0428d6cd88eff.png) The list stays open when you switch between **Draft** and **Active**. The **Active** view shows records whose stage is `Running`. ![The Draft stage view](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9a0337054da28ba18498f1186f684f88.png) 5. Identify the row using the visible values under `L/G no.`, `Beneficiary`, `L/G issuer`, `Bank`, `Requested value`, `Issued value`, `Current value`, `Issue date`, `Expiry date`, `Job No`, `Stage`, `L/G type`, and `Increase amount`. 6. Open the matching record. **Result:** You are on the new L/G form or on the saved-record list with a scope and stage view selected. A matching saved row is identifiable from its visible values. ## Understand the create form The new L/G form collects the parties, type, and requested value that make up the basic request. Use the required marker shown beside each field. | Visible field or option | What you see | |---|---| | **Beneficiary** | A required marker appears beside the field. | | **LG Issuer** | A required marker appears beside the field. | | **On Behalf of** | The field is visible without a required marker; its available choices appear when you open it. | | **LG Type** | The field is visible without a required marker. | | **Requested LG Value** | A required marker appears beside the field. | | **Beneficiary Permitted To Extend** | A visible option appears without a label. | | **Save** | Saves the form through the available save action. | | **Save and Close** | Saves through the available save-and-close action. | The form also includes **Expiry Date**. The available **LG Type** choices are **Bid bond**, **Down payment guaranty**, **Performance bond**, and **Warranty bond**. The choices in **On Behalf of** depend on the available records when the form is opened. ## Enter and save the basic request Use this procedure to enter the values required for the initial request. The form requires **Expiry Date** for a new or upgraded L/G, and the date cannot be earlier than today. The requested value cannot be below `0`; **On Behalf of** and **LG Type** depend on the new or editable L/G configuration. Prerequisites - You are on the new L/G form. - You have the beneficiary, issuer, requested value, expiry date, and any configured values ready. Steps 1. In **Beneficiary**, select the beneficiary for the guarantee. 2. In **LG Issuer**, select the issuer. 3. In **Expiry Date**, enter a date that is today or later. 4. In **On Behalf of**, select the available party when your configuration provides this field. 5. In **LG Type**, select the applicable type. | If the guarantee is for… | Select | |---|---| | A bid bond | **Bid bond** | | A down payment guarantee | **Down payment guaranty** | | A performance bond | **Performance bond** | | A warranty bond | **Warranty bond** | 6. In **Requested LG Value**, enter the requested value as a number that is `0` or greater. 7. If the form shows an extension option, select it when the request is extendable. 8. Choose how to save the request. | If you want to… | Select | |---|---| | Commit the request and remain on the form | **Save** | | Commit the request and leave the form | **Save and Close** | 9. If you leave the form while it has unsaved changes, choose an option in the `Do you want to save your changes?` dialog. | If you want to… | Select | |---|---| | Keep the changes | **Save** | | Leave without saving | **Don't Save** | ![The completed new L/G form and its save controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f6646e7ce82dfaf6cb5c7aea90c8f14d.png) **Result:** The request values are entered, and the available **Save** and **Save and Close** controls remain visible. ## Handle route and configuration differences The same L/G feature can look different because the route, subscription, permission, your configuration, and selected list layout determine which surfaces and rules are available. | Difference | What to expect | |---|---| | Finance route versus sales-job route | The finance route opens the L/G list directly. The list appears inside a sales-job record when the L/G tab is selected. | | Subscription or not-found condition | The details form is available only when the subscription allows it and the record is found. | | New form versus saved record | New-form controls appear on the new-form page. Recommendation fields appear for a saved record at or after `Requested` when the relevant recommendation setting applies. | | Required markers | **On Behalf of**, **LG Type**, **Extension Period**, **Expiration date**, **Reason**, **LG Deduction Date**, **LG Deduction Percentage**, and **Returned On** can show required markers according to your configuration. The requested value can also be configured as required. | | Popup state | Extension, deduction, increase, return, and edit controls appear in their named popup states. | | Selected list layout | The visible list columns follow the selected table layout, so another layout can show a different set of columns. | Use the required marker beside each field. On the new L/G form, **Beneficiary**, **LG Issuer**, and **Requested LG Value** show required markers, while **On Behalf of** and **LG Type** do not. ## When saving or locating goes wrong | What you see | What it means or what to do | |---|---| | `Your request was completed successfully` | The product's success message for a completed request. | | `An error occurred while processing your request` | The product reported a processing error. Review the form values and try the action again. | | `You don’t have permission` | Your account lacks permission for the attempted action. Ask your administrator to review access. | | `Please Add Extension to activate the LG` | Add the required extension before activating the L/G. | | `LG has one or more extensions or deductions and cannot be reverted to the requested stage` | The L/G has extension or deduction work that prevents reverting it to the requested stage. | | `LG still needs confirmation` | Complete the required confirmation before continuing. | | `Please choose a date after the current expiry date` | Choose a date after the current expiry date. | | `There is a pending increase you can edit` | Edit the pending increase before starting another increase. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the value and retry. | | `You are not allowed to View this page!` | The page refused the view request. Check your permission for the route. | The visible list controls include **Refresh**, **Table Layout**, and **Settings**. If saving does not produce the expected record, use the visible response and contact your administrator when the result does not match the expected route or permission. ## After the L/G is saved A saved L/G is the hand-off point from basic entry to record work. At or after `Requested`, saved record fields and recommendation controls become relevant when their record and configuration conditions apply. Saved-record tabs and stage actions also require the applicable record and route conditions. Continue with [L/G lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/l-g-lifecycle) for approval, stage, return, closure, liquidation, cancellation, extension, deduction, and increase work. Use [L/G finance view](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/l-g-finance-view) for the finance reference view. ### Use the saved-record tabs Saved-record tabs hold the follow-up and shared maintenance surfaces for an L/G. Select the tab that matches the work you need to do, then use the owning page for the detailed procedure. Prerequisites - You have a saved L/G record open, or you have opened an existing L/G from the saved-record list. - The applicable route and record conditions allow the tab to appear. Steps 1. Select the tab that matches the work you need to do. | If you need to… | Select | |---|---| | Open the record's comment surface | **Comments** | | Open the attached-file surface | **Attachment** | | Work with extensions | **LG Extensions** | | Work with deductions | **LG Deductions** | | Work with increases | **LG Increase** | | Review modification history | **Last Modifications** | ![The saved-record tab choices for follow-up work](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d3698204457260f2efa0428d6cd88eff.png) **Result:** The applicable saved-record tab is open, ready for the follow-up work supported by that surface. # L/G finance view An L/G (letter of guarantee) is a finance record that you can find in the Finance list and inspect in its record view. Use this page to find an existing L/G, filter the list, inspect its record, and choose an available record action. | If you need to… | Go to | | --- | --- | | Find the finance list and understand its entry conditions | [Before you start](#before-you-start) | | Choose a company or principal list and stage | [Find and filter the L/G list](#find-and-filter-the-lg-list) | | Interpret the visible columns and list tools | [Read the L/G list](#read-the-lg-list) | | Open and orient yourself in a saved record | [Open and read an L/G record](#open-and-read-an-lg-record) | | Choose a record value | [Choice fields on the record](#choice-fields-on-the-record) | | Review saving, approval, and stage actions | [Handle record actions and saving](#handle-record-actions-and-saving) | | Review saved-record tabs | [Use supporting record areas](#use-supporting-record-areas) | | Respond to a message | [Handle feedback and continue](#handle-feedback-and-continue) | | Create an L/G | [Create an L/G](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-l-g) | | Follow the L/G stage flow | [L/G lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/l-g-lifecycle) | ## Before you start The finance L/G view is the Finance list and record area for reviewing existing L/Gs. Before you start, confirm the following: | Check | What to have or know | Why it matters | | --- | --- | --- | | List availability | Your subscription includes the L/G list. | The list is available only when the subscription does not exclude it. | | Record | A saved L/G record is available. | The record view requires a loaded record before its record actions and saved-record areas apply. | | Starting view | The company list opens with the **All** list selected. | Use **All** to review every entry in the current list scope. | **Steps** 1. Open Finance. 2. Select **Bank Guaranties**. **Result:** The company L/G list opens with **All** selected. The visible headers depend on the list layout selected for the current account. Review the values shown for the saved record before changing anything. ## Find and filter the L/G list After the list opens, narrow existing L/Gs by who the list represents and by stage before opening a row. **Prerequisites** - Your subscription includes the L/G list. - You are in Finance and can open **Bank Guaranties**. **Steps** 1. Select **Bank Guaranties** in Finance. 2. Choose the list that matches the records you need. | If you need to… | Select | | --- | --- | | Review company L/Gs | **Company LGs** | | Review principal L/Gs | **Principal LGs** | | Review all entries in the current list scope | **All** | 3. Select one stage filter. | Stage filter | Use it to show | | --- | --- | | **All** | L/Gs in every available stage | | **Draft** | Draft L/Gs | | **Awaiting Approval** | L/Gs awaiting approval | | **Approved** | Approved L/Gs | | **Active** | Active L/Gs | | **Due for Return** | L/Gs due for return | | **Expired** | Expired L/Gs | | **Returned** | Returned L/Gs | | **Closed** | Closed L/Gs | | **Cancelled** | Cancelled L/Gs | | **Liquidated** | Liquidated L/Gs | Selecting a stage refreshes the grid. **Principal LGs** is the finance-only principal view. In that view, **Draft**, **Awaiting Approval**, and **Approved** are hidden; use the available stage filters in the selected list instead. ![Choose the company or principal list and the L/G stage filter](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/79fc519b737e14734a18590a6768fbab.png) **Result:** The selected L/G list and stage filter are on screen, and the refreshed grid is ready for row selection in the next section. ## Read the L/G list The L/G list is a grid of existing finance records. Read the headers first, then use the row's stage and L/G type to decide which record to open. The finance grid can show these columns: | Column | | --- | | **L/G no.** | | **Beneficiary** | | **L/G issuer** | | **Bank** | | Requested value | | Issued value | | **Current value** | | Issue date | | **Expiry date** | | **Job No** | | **Stage** | | **L/G type** | | Increase amount | Rows show stage and L/G type values, including `Draft`, `Bid bond`, `Performance bond`, and `Down payment bond`. The selected list layout determines which headers appear. The list also provides the icon buttons **Refresh**, **Table Layout**, and **Settings**, plus the list actions **Export** and **Delete**. Work from the headers and values visible in your grid. ![Read the finance grid headers, row values, and list tools](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/600147b517fe05b606080cdbab4c4bf7.png) ## Open and read an L/G record An L/G record is the finance detail surface for one selected L/G. Open it after identifying the row whose finance information you need. **Prerequisites** - The finance L/G list is open. - A saved L/G row is visible. **Steps** 1. Select a data cell in the L/G row you need. The selected cell opens the finance record for that L/G. 2. Read the labelled information available for the loaded record. | Record area | Labels that can appear | | --- | --- | | Dates and identity | **Expiry Date**, **Start Date**, **Expiration date**, **Activation Date**, **Returned On**, **LG Number** | | Party and type | **On Behalf of**, **LG Type**, **Bank** | | Confirmation and comments | **Confirmation Of The LG Requirement**, **Comment**, **Confirmation Of The Financial Viability** | | Extension | **Extension Period**, **No. Of Previous Extensions**, **Reason** | | Deduction | **LG Deduction Date**, **LG Deduction Percentage**, **Reason** | | Increase | **LG Increase Date**, **LG Increase Percentage**, **LG Increase Reason** | | Return | **Return Reason** | | Finance amounts | Requested, issued, current, cash-cover, and increase amount surfaces | 3. Check the record's current stage before choosing a stage or approval action. A configurable field is required only where the company configuration makes it mandatory. **Save**, **Save and Close**, record actions, and record tabs appear only under their applicable loaded-record, permission, stage, and saved-record conditions. **Result:** The selected row's finance record is open. Inspect the values shown for the saved record before changing anything. ### Choice fields on the record Choice fields limit the values you can use for the parties, L/G type, bank, and confirmation questions. The available **Bank** input depends on the issuer branch. | Control | Choices or input shown | | --- | --- | | **On Behalf of** | Principal vendor records allowed by the company or principal permission branch | | **LG Type** | **Bid bond**, **Down payment guaranty**, **Performance bond**, or **Warranty bond** | | **Bank** when the issuer branch is true | Bank accounts returned by the bank-account lookup, displayed with bank, account number, and total account information | | **Bank** when the issuer branch is not true | A text field | | **Confirmation Of The LG Requirement** | **Yes** or **No** | | **Confirmation Of The Financial Viability** | **Yes** or **No** | ## Handle record actions and saving After reading the record, use its visible action to move an eligible L/G through approval or stage work, or to open a maintenance area. Visibility depends on the loaded record, its stage, approval configuration, permissions, and pending extension or increase conditions. | Action group | Available controls | | --- | --- | | Saving | **Save** and **Save and Close**; both require edit permission, a non-embedded record surface, and changes | | Approval | **Request approval**, **Approve**, **Cancel approval request**, and **Reject approval request** | | Stage | **Due for Return**, **Returned**, **Closed**, **Liquidated**, **Active**, and **Draft** | | Maintenance | **Enable Editing**, **LG Extensions**, **LG Deductions**, and **LG Increase** | | List removal | **Delete** for the selected list record | > **Important:** Approval and permission conditions control which actions appear. Use > the action that is visible for the loaded record and your permission. **Prerequisites** - The L/G record is loaded. - You have edit permission when you need to save. - The record is not an embedded surface when you need **Save** or **Save and Close**. - You understand the current stage shown on the record. **Steps** 1. Select **Enable Editing** when the loaded record is read-only and the action is available. 2. Change the applicable record value or use the applicable maintenance action. 3. Select the save action that matches your goal. | If you need to… | Select | | --- | --- | | Keep the record view open | **Save** | | Save and leave the record view | **Save and Close** | 4. Read the feedback shown after the save request. The available approval and stage actions are guarded by the current stage, approval configuration, permissions, and record conditions. **Result:** The record remains open or closes according to the save action and the feedback shown. ## Use supporting record areas Supporting record areas keep discussion, files, extensions, deductions, increases, and history with a saved L/G. Open them after a saved record ID exists. **Prerequisites** - A saved L/G record is open. - The record has a saved record ID. **Steps** 1. Select the saved-record area that matches the work you need. | If you need to… | Select | | --- | --- | | Review discussion | **Comments** | | Review attachments | **Attachment** | | Review extensions | **LG Extensions** | | Review deductions | **LG Deductions** | | Review increases | **LG Increase** | | Review detailed changes | **Last Modifications** | 2. If you select **LG Extensions**, wait for its time-period data to load when the area requests it. Two record accordions appear only when the record is not being passed as an embedded input. The tabs themselves require a saved record ID. **Result:** The selected supporting area is open for the saved L/G record. ## Handle feedback and continue After an action, read the feedback to identify the correction or condition and choose the next move. **Prerequisites** - The list or loaded record is on screen. - Read the complete message before changing a value or selecting another action. **Steps** 1. Read the message shown on screen. | Message | Response | | --- | --- | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters, then repeat the list action. | | `Your request was completed successfully` | Continue from the completed action's resulting screen. | | `An error occurred while processing your request` | Stop and review the record values and action conditions before retrying. | | `You don’t have permission` | Use an action allowed by your permission, or ask for the required access. | | `Please Add Extension to activate the LG` | Add an extension before attempting activation. | | `LG has one or more extensions or deductions and cannot be reverted to the requested stage` | Keep the current stage and review its extensions or deductions. | | `LG still needs confirmation` | Complete the required confirmation before repeating the stage action. | | `Please choose a date after the current expiry date` | Choose a date after the current expiry date. | | `There is a pending increase you can edit` | Edit the pending increase before starting another increase. | 2. Verify the list or record state before taking another action. **Result:** The correction or condition is identified, and the list or record is ready for the next supported action. ## What to do next For new-versus-existing entry and the creation procedure, go to [Create an L/G](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-l-g). For stage meanings and the complete L/G stage lifecycle, go to [L/G lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/l-g-lifecycle). # Warehouse fulfillment flow ## Warehouse fulfillment flow Warehouse fulfillment work is reviewed across three list surfaces: **Goods Receipt Notes** for receiving, **Incoming Inspection Notes** for inspection, and **Stock By Shipment** for stock. These surfaces connect the work without confirming that a record moves from receiving to inspection and then to stock. | If you need to… | Go to | |---|---| | Find received shipments | [Goods receipt notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/goods-receipt-notes) | | Review incoming inspections | [Incoming inspection notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/incoming-inspection-notes) | | Review stock by shipment | [Stock by shipment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/stock-by-shipment) | | Issue goods or prepare a delivery | [Goods issue notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/goods-issue-notes) or [Delivery notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/delivery-notes) | | Understand the upstream order-to-delivered context | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) | Choose the surface that answers your warehouse question rather than assuming that opening one list advances a record to another list. ![The warehouse list workspace with its title and toolbar visible](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ee55b24ed67fc9ce74c8f636812ae384.png) ## Before you start Before opening a warehouse list, sign in with access to the warehouse workspace and use a workspace with a selected list layout. A list appears only when a layout is selected. The controls available to you depend on your subscription, permissions, enabled features, and layout configuration. The selected layout determines the headers. When the list opens, rows appear with the **Refresh**, **Table Layout**, and **Settings** controls. > **Note:** Another workspace can show different controls or headers because the > subscription, permissions, enabled features, and layout configuration can differ. ## Find the receiving, inspection, or stock list Use the list that matches the information you need. The dedicated record pages handle creation and editing separately; use the [Goods receipt notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/goods-receipt-notes) or [Incoming inspection notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/incoming-inspection-notes) procedure for those tasks. ### Open a warehouse list **Prerequisites** - You have access to the warehouse workspace. - A list layout is selected for the workspace. **Steps** 1. Open the list for the information you need. | If you need to review… | Open | |---|---| | Receiving | **Goods Receipt Notes** | | Inspection | **Incoming Inspection Notes** | | Stock by shipment | **Stock By Shipment** | 2. Identify the list by its title. 3. Confirm that the toolbar shows **Refresh**, **Table Layout**, and **Settings**. **Result:** The selected warehouse list is open with its title and available toolbar controls visible. ![The Goods Receipt Notes list with its receiving columns and toolbar](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ba1e137fd223f833c70570aaadea7de8.png) The inspection list has its own title and toolbar. ![The Incoming Inspection Notes list with its inspection columns and toolbar](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f9047bba4dd86d79823ac67a6792d9e4.png) ### Create a warehouse record The separate receiving, inspection, and stock detail or edit pages handle record work; continue to the dedicated page when you need to create or edit a record. ## Review products awaiting inspection or storage Use **Incoming Inspection Notes** for incoming inspections and **Stock By Shipment** for stock by shipment. The two lists remain separate, so neither list by itself confirms a receiving-to-inspection-to-stock transition. **Prerequisites** - You know whether you need the inspection list or the stock list. - A list layout is selected for the workspace. **Steps** 1. Open **Incoming Inspection Notes** when you need to review incoming inspections. 2. Confirm that the page title is **Incoming Inspection Notes**. 3. Open **Stock By Shipment** when you need to review stock by shipment. 4. Confirm that the page title is **Stock By Shipment**. **Result:** You can review the inspection and stock lists separately. ![The Stock By Shipment list with stock columns and toolbar](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/8c06f1c201eaa989e685415b4d8f0d31.png) ## Read the list columns The selected layout determines which headers appear. Read the headers that are visible in your layout. | List | Columns | |---|---| | Goods Receipt Notes | `GRN`, `Warehouse`, `Shipment no.`, `Supplier`, `Received on`, `Received by`, `P. O. no.` | | Incoming Inspection Notes | `Warehouse`, `Inspection No.`, `GRN`, `Purchasing job no.`, `P.O. no`, `Inspected by` | | Stock By Shipment | `Product`, `Description`, `Qty`, `Qty (available)`, `Unit`, `Area`, `Inspection no.`, `GRN`, `Location`, `Stage` | The receiving list identifies the goods receipt, warehouse, shipment, supplier, receipt date, and people involved. The inspection list identifies the warehouse, inspection, related receipt, purchasing job, purchase-order number, and inspector. The stock list identifies the product, quantities, unit, area, inspection and receipt references, location, and stage. ## Adjust the list view Use **Table Layout** and **Settings** to change the list presentation when those menus are available. **Prerequisites** - A warehouse list is open. - The relevant menu is available in your workspace. **Steps** 1. Open the menu for the adjustment you need. | If you need to… | Open | |---|---| | Widen columns | **Table Layout** | | Filter rows | **Settings** | | Group rows | **Settings** | 2. Select the option you need. | If you need to… | Select | |---|---| | Widen columns | **Expand column width** | | Filter rows | **Filter Row** | | Group rows | **Group Panel** | **Result:** The list uses the available table-layout, filtering, or grouping choice. ### Choose a list layout A list layout is the saved choice of list columns and presentation settings used for a warehouse list. **Prerequisites** - A warehouse list is open. - **Table Layout** is available. **Steps** 1. Open **Table Layout**. 2. Choose the layout action you need. | If you need to… | Select | |---|---| | Choose available columns | **Columns Chooser** | | Create a named layout | **Save New Layout** | | Save changes to the current layout | **Update Current** | | Remove the current layout | **Delete Current** | 3. If you selected **Save New Layout**, enter a name in **Layout name**. 4. If the layout-name popup is open, select **Save**. 5. If the confirmation popup appears after selecting **Delete Current**, select **No** to leave the layout in place. **Result:** The list uses the selected layout, or the layout-name popup closes after you save a new layout. ### Choose a list setting Use **Settings** for the presentation or export option available in your workspace. **Prerequisites** - A warehouse list is open. - **Settings** is available. **Steps** 1. Open **Settings**. 2. Select the setting you need. | If you need to… | Select | |---|---| | Filter rows | **Filter Row** | | Group rows | **Group Panel** | | Export the list | **Export** | **Result:** The list applies the selected filtering, grouping, or export option that your workspace makes available. ## When export or layout choices are unavailable List controls are conditional. A subscription restriction can show a subscription-upgrade surface instead of the list. Export depends on the export feature and permission. Import controls depend on importing being enabled. | What you see | What to do | |---|---| | The list is replaced by a subscription-upgrade surface | Contact the administrator responsible for the workspace subscription. | | **Export** is absent | Ask the administrator to check the export feature and your permission. | | Import controls are absent | Ask the administrator to check whether importing is enabled. | | `Data Loading Error` | Reopen the list. | | `Couldnt Load Default Layout` | Check that a list layout is selected, then reopen the list. | | `Couldnt Load Table Layouts` | Reopen **Table Layout** or contact the administrator if layouts remain unavailable. | | `Are you sure?` | Treat the prompt as a layout-deletion confirmation and choose the confirmation option that matches your intention. | | `There is an error loading template please contact the admin` | Contact the administrator. | When the corresponding operation is available, read the exact result message on screen. | Operation result | Message | |---|---| | Delete succeeds | `Data Deleted Successfully` | | Deletion is not allowed | `Action not allowed` | | Related data prevents deletion | `This record is related to saved data and cannot be deleted` | | Storage limit prevents deletion | `You’ve reached the maximum storage limit` | | Products are unavailable in stock | `Some products are not available in stock` | | Another processing error occurs | `An error occurred while processing your request` | | Import succeeds | `Data Importing completed` | ## Out of scope Receiving, inspection, and stock detail and edit work are covered on dedicated warehouse pages. This guide connects list surfaces rather than defining a receiving-to-inspection-to-stock lifecycle. Values in list rows are examples for the workspace where they appear; use the headers and records in your own list. ## Know what to do next Continue to the dedicated page that owns your next task: - [Goods receipt notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/goods-receipt-notes) for goods receipt note work. - [Incoming inspection notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/incoming-inspection-notes) for incoming inspection note work. - [Stock by shipment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/stock-by-shipment) for stock reference views. - [Goods issue notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/goods-issue-notes) for goods issue work. - [Delivery notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/delivery-notes) for warehouse delivery work. - [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) for upstream context. --- title: Goods receipt notes ... # Goods receipt notes Create receipts, locate saved receipts, and review information recorded for incoming shipments. ## Goods receipt notes A Goods Receipt Note records an incoming shipment after a Purchase Order and before the work that continues in Warehouse. In PAMS, the purchase chain is: ```mermaid flowchart LR BOM[Bill of Material] --> MRQ[Material Requisition] MRQ --> RFQ[Request for Quotation] RFQ --> PQ[Purchase Quotation] PQ --> PO[Purchase Order] PO --> GRN[Goods Receipt Note] GRN --> WH[Warehouse] WH --> DN[Delivery Note] ``` Use **Goods Receipt Note** when you create one. Saved receipts are grouped under **Goods Receipt Notes**. | If you need to… | Go to | | --- | --- | | Start a new receipt | [Before you start](#before-you-start), then [Find a goods receipt note](#find-a-goods-receipt-note) | | Identify the order, date, supplier, and receiving user on a receipt | [Header fields](#header-fields) | | Read the product quantities and available controls | [Received-products grid](#received-products-grid) | | Save a receipt or leave the saved record open | [Create and save a goods receipt note](#create-and-save-a-goods-receipt-note) | | Choose the correct receipt branch | [Handle order types and receipt branches](#handle-order-types-and-receipt-branches) | | Find a saved receipt after saving | [After the receipt is saved](#after-the-receipt-is-saved) | | Continue with the wider warehouse process | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | | Review incoming inspection work | [Incoming inspection notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/incoming-inspection-notes) | | Review stock by shipment | [Stock by shipment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/stock-by-shipment) | | Review purchase-order work | [Purchase job orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-orders) | ## Before you start Before opening a new receipt, have the related order ready to select and confirm that your account has warehouse responsibility and permission to create a new record. The receipt form requires a related order when no order is already loaded. **Prerequisites** - A related order is available for selection. - Your account has warehouse responsibility. - Your account has new-record permission. Use [Find a goods receipt note](#find-a-goods-receipt-note) to open the new receipt or the saved receipts list. ## Find a goods receipt note The **Goods Receipt Notes** list is the place to review saved receipt records. From the Warehouse menu, you can also open a new receipt directly. | If you need to… | Select or open | | --- | --- | | Start a new receipt | Follow [Create and save a goods receipt note](#create-and-save-a-goods-receipt-note). | | Review saved receipts | **Goods Receipt Notes** | **Prerequisites** - You have warehouse responsibility and new-record permission when starting a new receipt. - You know whether you are starting a new receipt or reviewing a saved one. **Steps** 1. Choose the path that matches your task. | Task | Action | | --- | --- | | Start a new receipt | Follow [Create and save a goods receipt note](#create-and-save-a-goods-receipt-note). | | Review saved receipts | Open **Goods Receipt Notes**. | ![Goods Receipt Notes list and its row headers](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ba1e137fd223f833c70570aaadea7de8.png) 2. Read the row headers **GRN**, **Warehouse**, **Shipment no.**, **Supplier**, **Received on**, **Received by**, and **P. O. no.** 3. Select a list row to open the receipt. **Result:** You have either opened a new receipt or reached the **Goods Receipt Notes** list and can identify a saved receipt from its displayed columns. ## Understand the receipt screen The receipt screen is the `Receiving shipment sheet` where you identify the incoming shipment, review its related order, and save the receipt. A saved record also exposes **Last Modifications** for its record history. The related-order panel is open when its order row is open. The screen shows **Last Modifications** for an existing receipt. The form displays **Save** and **Save and Close** when the corresponding editing conditions are met. ![Receipt screen with the related-order area and save actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ee55b24ed67fc9ce74c8f636812ae384.png) | Screen area | What to look for | | --- | --- | | Breadcrumb | `Receiving shipment sheet` | | Related-order panel | The selected order's received products when the order panel is open | | Save actions | **Save** and **Save and Close** | | Saved-record history | **Last Modifications** on an existing receipt | The receipt details appear within the Warehouse record tabs when your subscription includes the feature and your account has access to the Warehouse record. The **Warehouse** field does not appear on this receipt form. The history area is **Last Modifications** on a saved receipt. ### Header fields The header fields identify the order being received, the person and date recorded for the receipt, and supplier information that depends on the order type. | Field | What it records | Rule | | --- | --- | --- | | **Related order no.** | The order linked to the incoming shipment | Required when no related order is loaded; a loaded order number is disabled | | **Recieved by** | The user recorded as receiving the shipment | Required, disabled, and set to the signed-in user | | **Recieved on** | The receipt date | Optional, disabled, set to the current date, and limited to today or earlier | | **Sub-supplier** | The supplier associated with a purchase-order receipt | Selectable for a loaded purchase order | | **Sub-supplier shipment no.** | The supplier's shipment reference | Available for a loaded purchase order | ![Receiving user shown in the disabled Recieved by field](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9630ca9fb16d5a7041ff1661a9ec455f.png) ![Current date shown in the disabled Recieved on field](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9630ca9fb16d5a7041ff1661a9ec455f.png) Selecting **Related order no.** sets the order type and loads the received-product data. For a new note with a loaded related order, **Reset** is available if you need to clear the current entry and start again. Purchase-order and delivery-note receipts use different supplier controls. A delivery-note receipt shows a disabled **Sub-supplier** text field instead of the selectable purchase-order supplier controls. ### Received-products grid The received-products grid records what arrived against the selected order. The received-order panel displays **Product**, **Ordered Qty.**, **Received Qty.**, **Position**, and **Comment**. The grid also declares **Unit** and **Returned Qty.** as possible columns. | Product information or control | What it is for | | --- | --- | | **Product** | Identifies the product received | | **Ordered Qty.** | Shows the quantity on the related order | | **Received Qty.** | Records the quantity received | | **Position** | Identifies the product's order position | | **Comment** | Holds the row comment | | **Unit** | Shows the row's unit when that column is available | | **Returned Qty.** | Shows the returned quantity when that column is available | | **Package** | Opens package work when this control is shown for the row | | **Unitized** | Opens unitizing work when this control is shown for the row | | **Split** | Opens split work when this control is shown for the row | | **Delete** | Opens the delete action when this control is shown for the row | The received-order panel appears when your subscription includes the feature, the receipt page is available, and the selected order is open. The received-products data loads after you select **Related order no.** The columns shown can vary with the product data, so use the headers visible on your screen when recording quantities. When you are ready to record a receipt, continue with [Create and save a goods receipt note] (#create-and-save-a-goods-receipt-note). ## Create and save a goods receipt note Products received against an order are recorded in the product rows loaded by **Related order no.**. **Prerequisites** - You have warehouse responsibility and permission to create a new record. - You have a related order ready to select. - You know the quantity received for each product. **Steps** 1. Open the Warehouse list toolbar. 2. Select the plus icon at the right side of the Warehouse list toolbar. 3. Select **Goods Receipt Note** from the new-record menu. 4. In **Related order no.**, select the order for the incoming shipment. ![Select the related order on a new receipt](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9630ca9fb16d5a7041ff1661a9ec455f.png) 5. Confirm that the received-product rows appear. 6. In each product row, enter the received quantity in **Received Qty.**. 7. Review the product rows before saving. 8. Choose the save action that matches where you want to continue. | If you want to… | Select | | --- | --- | | Remain on the saved receipt edit page | **Save** | | Leave the receipt screen | **Save and Close** | If no product has a received quantity, the form displays `Shipment is empty. Please enter received quantity`. If a received quantity is greater than the order quantity, the form displays `Be careful. You are about to receive a quantity greater than the order quantity. Are you sure?` and the related quantity message is `Received quantity is greater than order quantity`. After a successful save, the screen displays `Your request was completed successfully`. A save using **Save** opens the saved receipt edit page. **Save and Close** leaves the page. **Result:** The receipt is saved. The selected save action determines whether the saved receipt edit page remains open. ## Handle order types and receipt branches The order type selected in **Related order no.** determines which supplier fields you use for the receipt. The **Related order no.** list groups available orders under the displayed options below. | Select from this group | Use the resulting receipt branch | | --- | --- | | **P.O.s** | Use selectable **Sub-supplier** and **Sub-supplier shipment no.** fields | | `Assmbly orders` | Use the received-order information loaded for the assembly order | | **Transfer orders** | Use the received-order information loaded for the transfer order | | **Delivery note** | Use the disabled **Sub-supplier** text field | **Prerequisites** - A new receipt is open. - The related order is available in one of the **Related order no.** list groups. **Steps** 1. Open **Related order no.**. 2. Select the group that matches the incoming order. 3. Select the related order from that group. 4. Use the supplier fields shown for the selected order type. **Result:** The receipt uses the supplier controls and received-order information for the selected order type. **Note:** **Consider PO As Not Received** is an existing-order follow-up action. It is separate from creating the first receipt. If a save or validation message appears, use [When saving or validating goes wrong] (#when-saving-or-validating-goes-wrong). ## When saving or validating goes wrong Use the message on screen to correct the receipt before trying the action again. | Message | What to correct | | --- | --- | | `This Field Is Required` | Complete the required field identified by the form, such as **Related order no.** when no order is loaded or **Recieved by**. | | `An error occurred while processing your request` | Review the receipt values and try the save again. | | `Shipment is empty. Please enter received quantity` | Enter a value in **Received Qty.** for the product received. | | `Received quantity is greater than order quantity` | Review **Received Qty.** against **Ordered Qty.**. | | `Check mandatory field(s)` | Complete the mandatory fields before saving. | | `Be careful. You are about to receive a quantity greater than the order quantity. Are you sure?` | Check the quantity and confirm the receipt only when the excess quantity is intended. | | `Saving Error` | Review the related-order values and try the save again. | | `Saved Successfully` | The related-order save completed. Continue with the resulting screen. | | `Your request was completed successfully` | The receipt save completed. Use the result described in [Create and save a goods receipt note](#create-and-save-a-goods-receipt-note). | ## After the receipt is saved A saved receipt remains available as a Goods Receipt Note for later review. The saved record exposes **Last Modifications**. Open **Goods Receipt Notes** to locate the saved receipt again. From the receipt, the purchase chain continues from Goods Receipt Note to Warehouse and Delivery Note. Continue with [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) for the broader hand-off, [Incoming inspection notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/incoming-inspection-notes) when inspection work is required, or [Stock by shipment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/stock-by-shipment) for later stock and storage work. ## Out of scope messages The following messages belong to embedded or related surfaces rather than the create-and-locate receipt task: | Message | Owning surface | | --- | --- | | `Just '_'‘-''.' And '&' Characters Accepted` | Files library validation | | `Amendment order deleted successfully` | Amendment-order deletion | | `Error {{errorMsg}}` | Shared dynamic error path | | `Items deleted successfully` | Received-purchase-order item maintenance | | `Items updated successfully` | Received-purchase-order item maintenance | # Incoming inspection notes An incoming inspection note records the inspection work associated with received products. Use it to create a note, review a saved note, record inspection decisions, and release inspected products to stock. ## Incoming inspection notes An incoming inspection note is the inspection record you use after receiving work and before the subsequent warehouse stock work. | If you need to… | Go to | | --- | --- | | Create or review an inspection note | [Find an inspection note](#find-an-inspection-note) | | Understand the fields and conditional areas | [Understand the inspection screen](#understand-the-inspection-screen) | | Enter decisions and save the note | [Record inspection details](#record-inspection-details) | | Understand successful and blocked saves | [Recognize completion and validation messages](#recognize-completion-and-validation-messages) | | Continue with the broader receiving, inspection, and stock relationship | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | | Review receiving work before inspection | [Goods receipt notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/goods-receipt-notes) | | Review stock by shipment | [Stock by shipment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/stock-by-shipment) | | Review inspection-base setup | [Base of inspection](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-base) | | Review inspection-checklist setup | [Inspection checklist](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-checklist) | | Review inspection-document setup | [Inspection documents](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-documents) | ## Before you start An inspection note needs an order context before its product, checklist, document, defect, and comment areas can appear. Have the order ready, and keep the receiving details available for the fields filled from the selected order. | Have or know | Why it matters | | --- | --- | | An order to inspect | **Order Number** is required on the new form. | | The selected order's GRN details | **GRN No.** is required when an order is selected. | | The selected order's sub-supplier details | **Sub-supplier** is required when an order is selected. | | Whether you are leaving a new note | The new-note route uses a leave-screen guard, so leaving with unsaved changes can interrupt navigation. | | The order source you need | The picker supports purchase, assembly, transfer, and delivery-note data sources. | The product can replace the inspection page with an upgrade surface when the Warehouse inspections subscription is unavailable. Access and subscription settings determine which surface you receive. > **Note:** A new note can use the leave-screen guard when you move away before saving. ## Find an inspection note Choose the path that matches the work you need to do. **Prerequisites** - You know whether you are starting a new note or reviewing a saved note. | Path | Step | Action | | --- | --- | --- | | Start a note | 1 | From the Warehouse new-record menu, select **Incoming Inspection Note**. | | Start a note | 2 | Confirm that the page title is **Incoming Inspection Note**. | | Review a saved note | 1 | Open the inspection list. | | Review a saved note | 2 | Confirm that the list title is **Incoming Inspection Notes**. | | Review a saved note | 3 | Select the row link for the note. | ![The new-note title and header area](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f5609bb83340bbbe898f97e515693da0.png) ![The inspection list title, columns, and toolbar](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f9047bba4dd86d79823ac67a6792d9e4.png) The list has these columns: | Column | Use it to… | | --- | --- | | **Warehouse** | Identify the warehouse shown for the row. | | **Inspection No.** | Identify the inspection note. | | **GRN** | Identify the goods receipt reference. | | **Purchasing job no.** | Identify the purchasing job reference. | | **P.O. no** | Identify the purchase-order reference. | | **Inspected by** | Identify the inspecting person shown for the row. | The list toolbar provides **Refresh**, **Table Layout**, and **Settings**. Selecting a row opens its edit screen. **Result:** The new-note form or the selected saved note is open. Continue with [Understand the inspection screen](#understand-the-inspection-screen). ## Understand the inspection screen The inspection screen starts with header information, then shows order-dependent product, checklist, document, defect, and comment areas. Saved notes also expose history, warehouse, and comment surfaces. On a new note, the header includes **Order Number**, **Inspected by**, and **Inspected on**. **Order Number** is selectable and required. **Inspected by** is a disabled selection, and **Inspected on** is a disabled date whose maximum is today. **GRN No.** and **Sub-supplier** are disabled text fields that become required when an order is selected. **Sub-supplier shipment no.** is also disabled text. **Order Number** has a required marker. **Inspected by**, **Inspected on**, **Save**, and **Save and Close** are available on the new-note form. ![The required Order Number picker](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f5609bb83340bbbe898f97e515693da0.png) The product area appears after an order is selected. Its grid contains **Products**, **Unit**, **Ordered Qty.**, **Received Qty.**, **Accepted qty**, **Rejected qty**, **Rejection Reason**, **Comments**, and **Attachment**. The product add action is not available on this surface. When a product has rejected quantity and the note is editable, **Re-inspect** is available for that product. After release, **Re-inspect** is row-specific for a product with rejected quantity. The checklist grid contains **Object to inspet**, **Base of inspection**, **Acceptance (YES/NO)**, and **Comments**. The acceptance choice is **Yes** or **No**, and it is editable only when the screen is editable. The documents grid contains **Document** and **Yes / No** choices; the choices are editable only when the screen is editable. The defects grid contains **Defect**, **Defect Category**, and **Attachament**. The main form also contains the optional **Comment** text area. A defect entry requires **Defect** and provides **Defect Category** selection. On a saved note, the available tabs include history, warehouse areas, and comments. **Last Modifications** opens the audit-log tab. **Finish and release to stock** and **Inspection template** may be available when the note is saved, unchanged, and not released. Save controls appear when the note is editable and its data has changed; they are disabled without data changes. Editable grid actions are hidden on a read-only note. When inspection defects exist, **Defect** is available for the defect work. ![The inspection surface with its main areas](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/896f620c73cc3fc71db9ffe1833f69da.png) Continue with [Record inspection details](#record-inspection-details). ## Record inspection details Record inspection details against a selected order. The order supplies the dependent areas; the quantities and decisions you enter determine which conditional fields become required. **Prerequisites** - You have an order to inspect. - You have the received quantity and inspection decisions for each product. - You know any rejection reason, defect, document decision, and comment to record. **Steps** 1. In **Order Number**, select the order to inspect. ![The header fields after opening a new note](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f5609bb83340bbbe898f97e515693da0.png) 2. Review the **Products**, **Checklist**, **Documents**, **Defects**, and **Comment** areas. 3. In the product grid, review **Ordered Qty.** and **Received Qty.**. 4. Open the product details and enter **Accepted qty**. 5. Keep **Accepted qty** at or below **Received Qty.**. 6. Enter **Rejected qty** for the quantity that is not accepted. 7. If **Rejected qty** is greater than zero, enter **Rejection Reason**. 8. Choose **Yes** or **No** in **Acceptance (YES/NO)** for each checklist item. 9. Choose **Yes** or **No** in the documents grid for each document decision. 10. In the defects area, enter **Defect** and select **Defect Category** when recording a defect. 11. Enter an optional note in **Comment**. 12. If accepted quantity is greater than zero during re-inspection, enter **Comment after re-inspection**. 13. Choose the save action that matches what you want to do next. | If you want to… | Select | | --- | --- | | Save the note and remain on its form | **Save** | | Save the note and leave its form | **Save and Close** | The product grid also provides **Comments** and **Attachment** columns. Use the available product popup fields for **Ordered Qty.**, **Received Qty.**, **Accepted qty**, **Rejected qty**, **Rejection Reason**, and **Comment**. The re-inspection popup provides **Accepted qty** and **Comment after re-inspection** under their stated conditions. **Result:** The note is saved with the inspection details. A new note saved without leaving opens its edit screen. Continue with [Recognize completion and validation messages](#recognize-completion-and-validation-messages). ## Recognize completion and validation messages The message identifies whether the save completed or which inspection condition needs correction. | Condition | Message | What to do | | --- | --- | --- | | The save completes | `Your request was completed successfully` | Continue reviewing the saved note. | | Mandatory data is missing during save | `Check mandatory field(s)` | Complete the required fields and save again. | | A required field is empty | `This Field Is Required` | Enter the missing value in the named field. | | Accepted quantity exceeds received quantity | `Accepted quantity cannot be greater than received quantity.` | Reduce **Accepted qty** to the received quantity or less. | | Package-product validation rejects an empty package | `Package products cannot be empty` | Complete the package-product information before saving. | | A product has no acceptance or rejection decision | `You have products with no decision regarding accepted or rejected quantity` | Enter the accepted or rejected quantity decision for each product. | When a product has rejected quantity and the note remains editable, **Re-inspect** is available. After a saved, unchanged note that is not released, **Finish and release to stock** and **Inspection template** may be available. Continue with [When validation or saving goes wrong](#when-validation-or-saving-goes-wrong). ## When validation or saving goes wrong Use the condition that matches what you see before changing the note. | What you see | What it means | What to do | | --- | --- | --- | | `An error occurred while processing your request` | A save or load request returned an error. | Review the note and request access or service assistance before repeating the action. | | `Check mandatory field(s)` | The save request contains invalid or incomplete mandatory data. | Complete the required header, quantity, and conditional rejection fields. | | `Accepted quantity cannot be greater than received quantity.` | **Accepted qty** is above **Received Qty.** | Reduce **Accepted qty** and save again. | | **Products**, **Checklist**, **Documents**, **Defects**, and **Comment** are absent | No order is selected. | Select an order in **Order Number**. | | Editable product or defect actions are absent | The note is read-only. | Review the note without changing it, or open an editable note. | | An upgrade surface replaces the inspection page | Warehouse inspections subscription access is unavailable. | Follow the upgrade surface available to your organization. | | The list headers differ from the expected headers | The selected list layout determines the columns shown. | Work from the headers visible in your list and use **Table Layout** if you need to adjust the layout. | No message or dialog appears during the passing read-only review path. Treat the absence of an editable action as the condition to act on, rather than waiting for a confirmation. Continue with [Release inspected products and continue](#release-inspected-products-and-continue). ## Out of scope | Message | Where it belongs | | --- | --- | | `Just '_'‘-''.' And '&' Characters Accepted` | Shared file-library validation in the file popup | ## Release inspected products and continue **Inspection completed** and **Finish and release to stock** are alternative closing actions for an existing editable note when its products have not been released. Before release, every inspected product needs an accepted or rejected quantity. **Prerequisites** - The inspection note is saved. - The note has no unsaved changes. - The note is not released. **Steps** 1. Open the saved inspection note. 2. Confirm that the note has no unsaved changes. 3. Select **Finish and release to stock**. 4. Review the **Release to stock** confirmation and the message `You are about to release these products to stock, are you sure?`. 5. Confirm the release. **Result:** The products are released to stock. Continue with [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) and [Stock by shipment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/stock-by-shipment). # Stock by shipment Stock views are warehouse reference lists for inspecting stock by shipment or by product. ## Stock views for warehouse work **Stock By Shipment** helps you inspect stock records in the shipment-oriented list, while **Stock By Products** presents stock from the product-oriented view. Both lists support virtual scrolling, show 30 records at a time, provide page navigation without changing the number shown, and let you filter from column headers. | If you need to… | Go to | |---|---| | Find the stock list organised around shipment records | [Find a stock view](#find-a-stock-view) | | Find the stock list organised around products | [Find a stock view](#find-a-stock-view) | | Read the headers and formats in each list | [Compare the two stock views](#compare-the-two-stock-views) | | Change the visible list or filter the results | [Adjust the displayed view](#adjust-the-displayed-view) | | Continue with warehouse work after reviewing stock | [Know what to do next](#know-what-to-do-next) | | Continue to the warehouse fulfillment flow | Warehouse fulfillment flow | | Open the Receiving work list | Upcoming stock | | Continue to goods receipt work | Goods receipt notes | | Continue to incoming inspection work | Incoming inspection notes | | Continue to goods issue work | Goods issue notes | | Continue to delivery-note work | Delivery notes | ## Before you start The stock page is a configured warehouse list rather than a fixed form. Your subscription, saved layout, and access settings determine which list surface, controls, and columns appear. The list appears after a layout is available. If your subscription does not include the feature, the page shows its subscription-upgrade surface; otherwise it shows the list. The layout and display controls require the list setup. Table-layout controls also require table-layout access, row filtering requires row-filter access, and grouping requires group-filter access. The headers follow the current layout, so the columns can differ between configurations. In a transfer-order context, the shipment list can also appear in a popup when that context calls for it. **Prerequisites** - You have access to the warehouse area. - Your subscription includes the stock list feature. - A saved list layout is available for the view. ## Find a stock view Use the stock tabs to move between shipment-oriented stock, product-oriented stock, and the Receiving list. **Prerequisites** - You are in the warehouse area. - Your subscription includes the stock list feature. **Steps** 1. Select the control that matches the work you need to do. | If you need to… | Select | Confirm that… | |---|---|---| | Inspect stock in the shipment-oriented list | **Stock By Shipment** | the shipment view is open | | Inspect stock in the product-oriented list | **Stock By Products** | the product view is open | | Open the Receiving work list | **Receiving** | The Receiving page title | ![Confirm the Stock By Shipment title and shipment grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/8c06f1c201eaa989e685415b4d8f0d31.png) ![Confirm the Stock By Products title and product grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f314a82bedfe83bdabdae6c15d628f2e.png) **Result:** The selected work list is open, and its visible title identifies the shipment, product, or Receiving view. ## Compare the two stock views The shipment view answers questions about stock records in a shipment context. The product view answers questions about stock totals and inbound quantities by product. The headers shown below are the columns visible when each list is fully loaded. | View | Columns shown | |---|---| | **Stock By Shipment** | Product, Description, Qty, Qty (available), Unit, Area, Inspection no., GRN, Location, Stage | | **Stock By Products** | Warehouse, Product, Latest Supplier, Stock Available, Stock Committed, Stock Total, Inbound Available, Inbound Committed, Inbound Total, Last Cost, Last Cost (€) | Both lists show **Refresh**, **Table Layout**, and **Settings** when fully loaded. The shipment view formats date cells as dates and formats numeric cells according to their data field as values, currencies, or percentages. The product view formats date cells as dates and numeric cells as values, currencies, percentages, or quantities according to the data field. Use the page title and the visible headers together to identify which stock view you are using. ## Adjust the displayed view The available display actions depend on your configuration. A fully loaded list shows **Refresh**, **Table Layout**, and **Settings**. Other display, filter, grouping, and export actions appear only when their configuration allows them. **Prerequisites** - You have opened one of the stock views. - Your configuration allows the display action you need. **Steps** 1. Apply the filter or display change that matches what you need. | If you need to… | Action | |---|---| | Filter a column | Use a filter in the column header. | | Search the grid | Enter a keyword in the field with the placeholder `Keyword to search...`. | | Filter a range | Select the `From/To` filter operation. | | Change the columns or layout | Select **Table Layout**. | | Change list settings | Select **Settings**. | | Choose an export format | Select **Export**. | | Leave the export dialog without exporting | Select **Cancel**. | Selecting **Export** opens a dialog headed `Exporting List:` with the options `Export to Excel` and `Export to PDF`. The export starts with Excel selected and uses `Warehouse List` as the file name. **Result:** The stock view remains open with the display, filter, layout, or export surface that your configuration makes available. ## When a view or control is unavailable An unavailable stock surface can reflect subscription state, layout readiness, access settings, loading time, or a conditional popup—not an empty stock result. | What you see | What it means | What to do | |---|---|---| | The subscription-upgrade surface | Your subscription does not include the feature | Select **Back** on that surface to leave it, then contact the person who manages your subscription. | | The list area is absent | A layout is not ready | Wait for the layout to load or ask the layout administrator to provide one. | | **Table Layout** or another display control is absent | Your configuration does not provide that control | Use the controls that are visible, or ask the person who manages your configuration to check the list setup. | | Row filtering is absent | Row-filter access is not enabled | Use the visible grid headers or ask the person who manages your configuration to check row-filter access. | | Grouping is absent | Group-filter access is not enabled | Continue with the visible list or ask the person who manages your configuration to check group-filter access. | | **Export** is absent | Your configuration does not provide export | Continue with the visible stock view or ask the person who manages your configuration to check the list setup. | | A loading indicator remains on screen | The list is still loading | Wait for the grid to finish loading before treating the absence of headers as a data issue. | While a list is loading, a loading indicator can remain visible. Once the lists are ready, you can see the named buttons **Refresh**, **Table Layout**, and **Settings**; the two stock views show no other named buttons, dialogs, or readouts. > **Note:** A list that is still loading does not yet tell you that stock data is > unavailable. Wait for the headers to appear before investigating the data. Your selected layout supplies the grid headers. Work from the headers visible in your list rather than expecting a fixed set of columns or form-validation messages. The configured messages for this area are shown exactly as follows: | Situation | Message | |---|---| | Export has no data | `NO Data to Export` | | Import completes | `Data Importing completed` | ## Know what to do next After you review a stock list, continue with the warehouse work list that matches the stock situation. The available follow-up pages are **Receiving**, goods receipt, incoming inspection, goods issue, delivery-note work, and the warehouse fulfillment flow. When row opening is available, selecting a product row can take you to its stock- product page. **Stock Product** can appear when your configuration permits creation. Use either action only when it is visible, and confirm the destination before continuing. This reference view does not change a stage or save a record. # Goods issue notes ## Goods issue notes A goods issue note records products issued from warehouse stock against a related record. Use it to locate and review the products that left the warehouse. | If you need to… | Go to | |---|---| | Understand where this work fits among warehouse activities | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | | Find or start a note | [Find or start a goods issue note](#find-or-start-a-goods-issue-note) | | Read the fields and product areas | [Understand the note screen](#understand-the-note-screen) | | Add products and quantities | [Create the note and add products](#create-the-note-and-add-products) | | Compare a new note with a saved note | [Handle new and existing notes](#handle-new-and-existing-notes) | | Save a note or correct a validation problem | [Save the note and recover from errors](#save-the-note-and-recover-from-errors) | | Continue with related warehouse documents | [Know what comes next](#know-what-comes-next) | | Review goods receipt work | [Goods receipt notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/goods-receipt-notes) | | Review stock by shipment | [Stock by shipment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/stock-by-shipment) | | Review incoming inspection or delivery work | Open the related warehouse page from your warehouse navigation. | The note identifies the related work and the products issued. The surrounding warehouse pages cover receiving, inspection, stock, and delivery activities. ## Before you start Have warehouse access and the related order and product details ready. You select the related record and enter the quantity for each product before saving. | Have ready | Why it matters | |---|---| | Access to the warehouse area | The goods issue notes list is in the warehouse area. | | The order or other record related to the issue | You select it in **Related to** when creating a note. | | The products to issue | You add them through **Products** when the new note has an issue order. | | The quantity required for each product | The product editor requires a value in **Qty**. | | The unit for each product | **Unit** identifies how the quantity is measured. | | Storage area and position for each product, where required | Save validation asks for these details when they are needed. | The available **Issued By** choices depend on your setup. Review the values shown for **Related to**, **Issued By**, **Issued on**, and the product fields before saving. ## Find or start a goods issue note Use the goods issue notes list to review saved notes or open a new-note form. Prerequisites - Have access to the warehouse area. - Know whether you are opening a saved note or creating a new one. Steps 1. Open the goods issue notes list. ![The goods issue notes list with its visible columns and toolbar controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/cad5413c5e3c3320bac04e781f23bb3e.png) 2. Select the route that matches your task. | If you need to… | Select | |---|---| | Open a saved note | the edit control in the selected note row | | Start a note from the new-record menu | **Goods Issue Note** | | Start a note from the goods issue notes list | **Goods Issue Note new entry** | 3. If you started a new note, confirm that the page shows **Related to**, **Issued By**, **Issued on**, **Save**, and **Save and Close**. **Result:** You are viewing the selected saved note or the new goods issue note form. From the new form, continue to [create the note and add products](#create-the-note-and-add-products). ## Understand the note screen The note screen is headed **Goods issue note sheet**. It has header information for the related record and issue, followed by a product area. The product columns depend on whether the note is new or saved. | Area | What you use it for | When it appears | |---|---|---| | **Related to** | Identify the order or record connected to the issue | A picker on a new note; read-only text on a saved note | | **Issued By** | Review the issuer value | On the note form; disabled | | **Issued on** | Review the issue date | On the note form; disabled and limited to today or earlier | | **Products** | Open product insertion | On a new note when an issue order exists | | **Qty** | Enter the quantity for the selected product | In the product editor | | **Unit** | Review the product's unit | In the product editor and product-selection area | | Product-selection information | Review the product, stage, sales item, and requested quantity | In the product-selection area when it is available | | **Product**, **Issued Qty**, **Returned Qty** | Review products on a saved note | In the saved-note product grid | The saved-note grid includes **Returned Qty**. When it is available, the new-note product-selection area includes the product, requested quantity, **Stage**, and **Sales item**. The product grid appears when the note has an issue order. The list layout shown here has these columns: | Column | Use it to review | |---|---| | **Sheet no.** | Identify the issue note. | | **Warehouse** | Identify the warehouse. | | **Product** | Identify the product. | | **Qty** | Review the quantity. | | **Unit** | Review the quantity's unit. | | **P.M responsible** | Review the responsible person. | | **Issued by** | Review the issuer. | | **Issued on** | Review the issue date. | The list toolbar shows **Refresh**, **Table Layout**, and **Settings**. The columns come from the selected list layout, so use the headers visible in your list. ![The goods issue notes list and its visible columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/1a3bf4f0e4b6e42885ded75beb11ce03.png) The **Inventory** select, **Comments** and **Last Modifications** tabs, product deletion action, and old product links are not part of the visible note surface. ## Create the note and add products Use the new-note form to connect the issue to its related record and record the products and quantities being issued. Prerequisites - Be on the new-note form. - Know the related order or record. - Know each product and the quantity to issue. Steps 1. In **Related to**, select the order or record connected to the goods issue. 2. Select **Products** when the new note has an issue order. ![The new goods issue note with the related-record and product-entry areas](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/36d97d0eb621346c7254be86d64b7f50.png) 3. Select the product to add from the product-selection area. 4. Open the selected product with the edit control in its row. 5. In the product editor, enter the required quantity in **Qty**. 6. Review **Unit** for the selected product. 7. Close the product editor with its close control. **Result:** The new note contains the selected related record and product quantity. When the product-selection area is available, it provides **Product**, requested quantity, **Unit**, **Stage**, and **Sales item** for review. Continue to [save the note](#save-the-note-and-recover-from-errors). ## Handle new and existing notes A new note is used to choose its related record and add products. A saved note is used to review issued and returned quantities. | Note state | Header behaviour | Product area | Available actions | |---|---|---|---| | New note | **Related to** is a required picker; **Issued By** and **Issued on** are visible and disabled | Product insertion is available when an issue order exists; **Qty** is required in the product editor | **Products**, **Save**, **Save and Close**, and the product-editor close control | | Saved note | **Related to** is read-only | The saved grid shows **Product**, **Issued Qty**, and **Returned Qty** | The selected product-row edit control opens a product for editing; the product-editor close control leaves the page | The product delete action, **Comments** and **Last Modifications** tabs, old **Product** and **Final product** links, and the list import action are unavailable. Use visible **Refresh** and **Table Layout** controls for list operations. ## Save the note and recover from errors Review the related record, products, quantity, and unit before saving. On an editable page, the save choices are unavailable when there are no changes or while saving is in progress. Prerequisites - Complete the note information. - Correct any product details required by the form. Steps 1. Select the save action that matches your task. | If you need to… | Select | |---|---| | Save and remain on the page | **Save** | | Save and close the page | **Save and Close** | 2. If the form asks for storage details, enter the storage area and position for each product. 3. If the form reports that package products are empty, add the required package products. 4. If the request fails, correct the note information. 5. Select the appropriate save action again. | Message | Correction | |---|---| | `Please enter the storage area and position for each product` | Enter the storage area and position for every product. | | `Package products cannot be empty` | Add the required package products. | | `An error occurred while processing your request` | Correct the note information and select the save action again. | | `Your request was completed successfully` | Continue from the saved note. | **Result:** The note is saved when the success message appears. **Save** returns to the saved issue edit record, while **Save and Close** leaves the page. If a validation or request message appears, the form remains available for correction. ## Know what comes next After saving, use the surrounding warehouse pages to continue the receiving, inspection, stock, or delivery work that belongs to your process. | Continue with… | Open | |---|---| | The overall warehouse sequence | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | | Goods received into the warehouse | [Goods receipt notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/goods-receipt-notes) | | Stock grouped by shipment | [Stock by shipment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/stock-by-shipment) | | Incoming inspection or delivery work | The related warehouse page from your warehouse navigation | Continue with the related warehouse task from your warehouse navigation. # Delivery notes ## Delivery notes A delivery note is the warehouse surface for recording delivery work after the sales-order hand-off. Use this page to create a delivery note, find delivery notes, and continue with the saved record on its edit surface. The warehouse flow follows Purchase Order and precedes the detailed delivery work. | If you need to… | Go to | |---|---| | Prepare the information and access needed for delivery-note work | [Before you start](#before-you-start) | | Open a new delivery note or locate the delivery-note list | [Find a delivery note](#find-a-delivery-note) | | Identify the information areas and conditional controls | [Understand the delivery note screen](#understand-the-delivery-note-screen) | | Enter delivery information and save the note | [Create and save a delivery note](#create-and-save-a-delivery-note) | | Review when completion or printing can appear | [Complete or print a delivery note](#complete-or-print-a-delivery-note) | | Correct a validation or request error | [When delivery-note validation goes wrong](#when-delivery-note-validation-goes-wrong) | | Continue warehouse fulfilment work | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | | Follow the upstream order-to-delivered hand-off | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) | | Work with a goods issue note | [Goods issue notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/goods-issue-notes) | ## Before you start The delivery-note details area appears when subscription access is available, the page is present, and a delivery note exists. On a new note, the shipping-order area appears after a shipping order is present on the note. **Prerequisites** - Have the shipping-order information needed to choose **Shipping order**. - Have the warehouse responsibility and permission required for the action you are about to use. - Check the controls and fields displayed by your company configuration before entering values. - Confirm the approval arrangement used by your organization before saving or completing a delivery note. The list layout determines which columns you see. Work from the headers visible in your list rather than expecting a fixed set of columns. New-list actions also depend on the corresponding warehouse responsibility and permission checks. > **Note:** The headers and configurable fields available to you depend on the > company configuration and the list layout selected for your account. ## Find a delivery note A delivery note has three reader-facing surfaces: the new surface for starting the record, the list for locating records, and the edit surface for a saved record. **Prerequisites** - Have warehouse access. - For a new note, have the related shipping order available. - For an existing note, know enough of its displayed list information to distinguish the correct record. **Steps** 1. In the main navigation, select **Warehouse**. 2. In the warehouse area, select **Delivery Notes**. Choose the surface you need: | If you need to… | Open | |---|---| | Start a delivery note | The new delivery-note surface | | Locate a saved note | The **Delivery Notes** list | The new surface displays **Shipping order**, **Save**, and **Save and Close**. **Delivery completed** and **Print** are not displayed on this surface. ![The new delivery-note surface with Shipping order and the save controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ba0e5df62aa661bb158668ce0a0d72bd.png) The list displays these headers: | Header | What it helps you locate | |---|---| | **Sheet no.** | The note number | | **Warehouse** | The warehouse connected to the note | | **Client** | The client connected to the note | | **Client order no.** | The client's order reference | | **Vendor order no.** | The vendor's order reference | | **P.M responsible** | The responsible project-management person | | **Delivered by** | The delivery person | | **Total weight** | The recorded total weight | The list also displays **Refresh**, **Table Layout**, and **Settings**. **Delivery completed** is not displayed on the list. ![The delivery-note list with its displayed headers and list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/b62bfcbcc856b3dcb4d3884a505299be.png) 3. In the **Delivery Notes** list, select the saved note you want to open. **Result:** You are on the new delivery-note surface, the **Delivery Notes** list, or the selected saved note, with the controls and list headers available for that surface. Continue to [Understand the delivery note screen](#understand-the-delivery-note-screen) to identify the areas and controls available on the surface you opened. ## Understand the delivery note screen A delivery note brings together the selected shipping order, delivery details, product quantities, issue-goods information, and a delivery destination. Some areas appear only for a saved note, a selected address, a matching product condition, or a company configuration. The shipping-order area contains these fields: | Area | Fields | |---|---| | Shipping order | **Branch**, **Sales Job Number**, **Invoice**, **Phone**, **Client**, **Client Order No.**, **Carrier**, **Delivery Date**, **Delivery Destination**, **Total Weight**, **Invoice Date**, **Delivery Terms** | | Product edit | **Returned Qty** (required), **Unit** (optional) | | Issue-goods details | **Issued By** (disabled), **Issued on** (no later than today), **Qty** (required) | | Address | **Destination Title** (required), plus **Country**, **State**, **City**, **Street**, and **Zip-code** where your configuration requires them | The shipping-order fields appear when the delivery note has a shipping order. The product area appears when the issue-goods record has an issue order and is new, or when the current user is a developer. The issue-goods details include a disabled **Issued By** control and a date-limited **Issued on** field. When an address is selected, enter the required **Destination Title**. The address may also ask for **Country**, **State**, **City**, **Street**, and **Zip-code**, depending on your configuration. Use the options displayed in the corresponding lists. The details action area can show **Delivery completed** when the note has an ID, has no unsaved data, and is not complete. It can show **Print** when the note is complete, has no unsaved data, and printing is allowed. The new surface does not show either control. The active details surface does not provide the **Comments**, **Receiving sheet**, **Inspection sheet**, **Transfer history**, or **Last Modifications** areas. ![The delivery-note list and the visible locating controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/13d0a0d2b7a0d1721453b7d7e193b143.png) Continue to [Create and save a delivery note](#create-and-save-a-delivery-note) to enter the displayed information. ## Create and save a delivery note Record and save the delivery note as follows. **Prerequisites** - Have warehouse access and the related shipping order. - Confirm the warehouse responsibility and permission checks for the new-list action. - Have the delivery information and product quantities needed for the fields displayed on your note. Use the field table while entering information: | Field | Rule on the delivery-note surface | |---|---| | **Shipping order** | Required on the new surface | | **Branch**, **Sales Job Number**, **Invoice**, **Client Order No.**, **Invoice Date**, **Delivery Terms** | Display with the shipping-order area and are not marked required by the field table | | **Phone**, **Client**, **Carrier**, **Delivery Date**, **Delivery Destination**, **Total Weight** | Required only where your company configuration says so | | **Returned Qty** | Required in the product-edit popup | | **Unit** | Optional in the product-edit popup | | **Issued By** | Disabled in issue-goods details | | **Issued on** | Cannot be later than today | | **Qty** | Required in the inspected-product edit popup | | **Destination Title** | Required after an address is selected | | **Country**, **State**, **City**, **Street**, **Zip-code** | Required only where your company configuration says so after an address is selected | **Steps** 1. On the new delivery-note surface, select the related shipping order in **Shipping order**. 2. Enter the displayed shipping-order and delivery values in their matching fields. 3. In the product-edit popup, enter the returned amount in **Returned Qty**. 4. Optional: Enter the product's unit in **Unit**. 5. In the issue-goods details, enter the inspected product amount in **Qty**. 6. If an address is selected, enter the destination in **Destination Title**. 7. If the address form displays them, complete **Country**, **State**, **City**, **Street**, and **Zip-code** according to your configuration. 8. Select a save choice from the following alternatives: | If you need to… | Select | |---|---| | Save the note and remain in the save popup mode | **Save** | | Save while leaving the form or completing the task | **Save and Close** | | Leave without keeping the changes | **Don't Save** | | Return from the save popup without saving | **Cancel** | Saving validates the form and product list before creating or updating the record. If the record is new and the service returns an identifier, the application opens the saved record as the saved note. 9. Confirm the result before leaving the page. A successful save uses `Your request was completed successfully`. Leaving with unsaved changes is protected by the page's navigation guard. **Result:** The delivery note is saved when the success message appears, and the new record is available as a saved note. Continue to [Complete or print a delivery note](#complete-or-print-a-delivery-note) to use the actions available after saving. ## Complete or print a delivery note Completion and printing apply to a saved delivery note, not to the new-record surface. **Delivery completed** requires a note ID, no unsaved data, and an incomplete note. **Print** requires a complete note, no unsaved data, and printing permission. **Prerequisites** - Have a saved delivery note open on its edit surface. - For **Delivery completed**, the note must have an ID, no unsaved data, and be incomplete. - For **Print**, the note must be complete, have no unsaved data, and allow printing. **Steps** 1. On the saved note, select **Delivery completed** when its conditions are met. 2. On the completed note, select **Print** when its conditions are met. **Result:** The applicable action has been selected on a saved delivery note. **Delivery completed** and **Print** are absent on the new surface. If a save or request is refused, continue to [When delivery-note validation goes wrong](#when-delivery-note-validation-goes-wrong). ## When delivery-note validation goes wrong Use the message on screen to choose the correction. Product checks can stop a save before the request is completed; a server refusal can instead show a general error or permission message. | Message | What to do | |---|---| | `Please review the validation error for each product` | Review each product row and correct the product validation error before selecting a save control again. | | `Please enter the storage area and position for each product` | Enter the storage area and position for every product, then save again. | | `Package products cannot be empty` | Add the required package-product information before saving. | | `An error occurred while processing your request` | Check the entered delivery-note information and retry the save. Escalate the request if the message persists. | | `Error {{errorMsg}}` | Read the displayed error detail and correct the named condition or escalate it to your support contact. | | `You don’t have permission` | Confirm the warehouse responsibility and permission for the action with your administrator. | If the page does not show a result after a save attempt, do not treat the record as saved; verify it in the **Delivery Notes** list or ask your administrator to check the request. ### Out of scope This page owns the delivery-note create, locate, and saved-record surfaces. The following items belong elsewhere: - The option names in **Issued By** belong to the issue-goods data source. - The option names in **Country** belong to the shared address data source. - Comment actions, log-history actions, and file-library actions belong to their shared surfaces. - The inventory control is inactive markup and is not an available delivery-note action. - The list action-column delete markup is commented out and is not an available list action. - Print activity and assembled-product popup actions belong to their owning surfaces. ## After the delivery note After a successful save, return to **Warehouse** and **Delivery Notes** to locate the saved record later. Select the saved note from the list to open it. | Continue with… | Use this page | |---|---| | The broader warehouse fulfilment flow | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | | The upstream order-to-delivered hand-off | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) | | Goods issue work as a separate warehouse document | [Goods issue notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/goods-issue-notes) | # QC ## QC at a glance QC, or Quality Control, is the warehouse-adjacent surface for reviewing received products and their inspection information. The page shows the **Receiving** tab and the `Quality Control` heading. When the list is empty, it shows `No data`. | If you need to… | Go to | |---|---| | Open the QC list | [Find the QC list](#find-the-qc-list) | | Understand the visible columns and toolbar | [Read and arrange the QC list](#read-and-arrange-the-qc-list) | | Review receipt, product, and inspection information | [Review receipt and inspection details](#review-receipt-and-inspection-details) | | Follow purchase-order, delivery-note, or inspection branches | [Handle receipt and inspection branches](#handle-receipt-and-inspection-branches) | | Finish an inspection when the action is available | [Finish the inspection and continue](#finish-the-inspection-and-continue) | | Continue with a receipt record | [Goods receipt notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/goods-receipt-notes) | | Continue with an inspection record | [Incoming inspection notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/incoming-inspection-notes) | | Review the next stock reference surface | [Upcoming stock](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/upcoming-stock) | ![The Quality Control heading, Receiving tab, active columns, and toolbar](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9d8558d01e16c276d7338333ccc697c3.png) ## Before you start QC information is conditional on the record and the workspace setup. The list uses the active layout's runtime column set, while warehouse, receipt, and inspection areas appear only when the corresponding record information is available and the relevant subscription and page access are present. | Have or know | Why it matters | |---|---| | Access to the QC workspace | The QC list can be replaced by a subscription or page-access condition. | | An active list layout | The selected layout supplies the columns shown in the list. | | The received order or inspection record you need | Receipt and inspection information appears when the relevant record details are available. | | The applicable subscription | Warehouse, receiving-shipment, inspection, and Files areas are conditional surfaces. | | The record's inspection branch | Purchase-order and delivery-note receipts show different supplier information. | Use the QC destination provided by your workspace. ## Find the QC list Open **QC** from the main menu. The page opens with the `Quality Control` heading and **Receiving** tab. **Prerequisites** - You are signed in to PAMS. - Your account can open the QC workspace. - A list layout is available to the workspace. **Steps** 1. Open **QC**. 2. Confirm that the page heading is `Quality Control`. 3. Select **Receiving**. 4. Confirm that **Product** is visible in the loaded list surface. ![The Receiving tab selected with Product visible in the QC list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/a95e1ed7cabf75ef2780a609def49a28.png) **Result:** The QC list is open on the **Receiving** tab. An empty list shows `No data`. ## Read and arrange the QC list The QC list is an active grid whose headers come from the selected layout. The displayed columns are: | Order | Column | Use it to… | |---:|---|---| | 1 | `Sales job no.` | identify the sales-job reference | | 2 | `Product` | identify the product | | 3 | `Description` | read the product description | | 4 | `Area` | read the storage area | | 5 | `Position` | read the storage position | | 6 | `P.O.s` | read the purchase-order reference | | 7 | `Received Qty` | read the received quantity | | 8 | `Accepted qty` | read the accepted quantity | | 9 | `Rejected qty` | read the rejected quantity | | 10 | `Unit` | read the quantity unit | | 11 | `Stage` | read the displayed warehouse stage | | 12 | `GRN` | read the goods-receipt reference | | 13 | `Inspection No.` | read the inspection reference | When the list has no rows, it shows `No data`. The visible icon-button titles are **Refresh**, **Table Layout**, and **Settings**. **Prerequisites** - The QC list is open. - The relevant toolbar control is available in your workspace. **Steps** 1. Read the headers visible in the grid rather than assuming that every possible QC column is shown. 2. Choose one toolbar action: | Control | Action | Purpose | |---|---|---| | **Refresh** | Select **Refresh**. | Reload the visible list. | | **Table Layout** | Open **Table Layout**. | Work with the current list layout or its columns. | | **Settings** | Open **Settings**. | Use the filtering, grouping, export, or other grid setting available to your workspace. | **Result:** The QC grid shows the current rows and the column and view controls available to your workspace. An empty list shows `No data`. ## Review receipt and inspection details Receipt and inspection details are the record information behind a QC item. They appear only when the relevant warehouse, received-order, inspection, or popup conditions are met. | Area | Information or control | When it appears | |---|---|---| | Warehouse details | **Product**, **Description**, **Areas**, **Position**, **Stocked By**, **Stocked On**, and **Note** | Warehouse details exist; product and stocking fields require a stocking product where stated. | | Receipt details | **Stocked By**, **Stocked On**, and the applicable **Sub-supplier** fields | Receiving-shipment details and a received order exist. | | Inspection header | **Inspected by**, **Inspected on**, **GRN No.**, **Sub-supplier shipment no.**, and **Sub-supplier** | Inspection details exist; the received-order fields require a received order where stated. | | Inspection information | **Checklist**, **Documents**, and **Comment** | A checklist, received documents, or received order exists. | | Product inspection | **Product**, **Ordered Qty.**, **Received Qty.**, **Accepted qty**, **Rejected qty**, and **Comment** | The inspected-product popup is open. | | Defect information | **Defect** and **Defect category** | The new-defect or edit-defect popup is open. | When these fields are available, choose from the following values: | Control | Choices or source of choices | |---|---| | **Areas** | Select a storage-area name from the available list. | | **Stocked By** in warehouse details | Select a responsible person from the available list. | | **Stocked By** in receiving-shipment details | Select a responsible person from the available list. | | **In Stock** | Select a storage-area name from the available list. | | **Sub-supplier** for a purchase order | Select an eligible principal or sub-supplier account from the available list. | | **Inspected by** | Select a responsible person from the available list. | | **Defect category** | Select `Minor`, `Major`, or `Critical`. | | **Category** in attached documents | Select a category from the available list. | Review the receipt references first, then compare ordered, received, accepted, and rejected quantities. Read **Checklist**, **Documents**, **Comment**, and defect information when those areas are present. The **Areas** control is required when the warehouse stocking product is present. In an inspected-product popup, **Qty**, **In Stock**, and **Position** are required; **Stock Type** is company-configurable. ## Handle receipt and inspection branches The receipt branch determines which supplier information is available, while the inspection popup determines how accepted and rejected quantities and defects are recorded. **Prerequisites** - You have a QC item with the relevant receipt or inspection record available. - You know whether the item belongs to a purchase order or delivery note. - You know the received, accepted, and rejected quantities to review. **Steps** 1. Review the supplier fields that match the receipt branch. | If the received order is… | Review | |---|---| | A purchase order | **Sub-supplier** and **Sub-supplier shipment no.** in the received-order details | | A delivery note | The text **Sub-supplier** field in the received-order details | | A received purchase-order row with received products | The received-order rows and their product information | | An inspected product | **Ordered Qty.**, **Received Qty.**, **Accepted qty**, **Rejected qty**, and **Comment** in the inspected-product popup | | A product with a defect | **Defect** and **Defect category** in the defect popup | 2. Open the received purchase-order row when it contains received products. 3. Compare **Received Qty** with **Ordered Qty.** in the inspected-product popup. 4. Review **Accepted qty** and **Rejected qty** for the product. 5. If the product has rejected quantity and the inspection remains editable, use **Re-inspect**. The available fields and actions depend on the record-level conditions. **Result:** You have reviewed the receipt branch and the inspection quantities and defect information that the available QC record surface provides. ## Finish the inspection and continue **Finish and release to stock** completes a saved inspection that is unchanged and not already released. **Prerequisites** - The inspection record is saved. - The record has no unsaved changes. - The record is not already released. **Steps** 1. Open the saved inspection record. 2. Confirm that the inspection has no unsaved changes. 3. Select **Finish and release to stock** when it is available. 4. Confirm the result shown by the application. The inspection action displays `Your request was completed successfully` when the request completes. **Result:** The inspection action has been selected for a saved, unchanged, unreleased inspection. Continue with the warehouse surface that matches the displayed next work. ## Resolve validation and errors Use the exact message on screen to identify the missing quantity, location, decision, or service response. Correct the corresponding information before repeating the action. | Message | Correction | |---|---| | `Your request was completed successfully` | Treat the request as completed and review the resulting record surface. | | `An error occurred while processing your request` | Review the record information and request service or access assistance before repeating the action. | | `Please enter the storage area and position for each product` | Enter the storage area and position information for each product. | | `Position is required` | Enter **Position**. | | `Package products cannot be empty` | Complete the package-product information. | | `Shipment is empty. Please enter received quantity` | Enter **Received Qty.** for the received product. | | `Received quantity is greater than order quantity` | Compare **Received Qty.** with **Ordered Qty.** and correct the received quantity. | | `Check mandatory field(s)` | Complete the mandatory fields before saving. | | `Error {{errorMsg}}` | Read the substituted error detail and correct the named problem. | | `You have products with no decision regarding accepted or rejected quantity` | Enter the accepted or rejected quantity decision for every product. | | `Amendment order deleted successfully` | Treat the amendment-order deletion as completed. | ## Out of scope QC includes embedded Files and attached-document areas, but their option-list meanings belong to their owning surfaces. | Surface or control | Where its meaning belongs | |---|---| | **Links** options: `Sales jobs`, `Buyout`, `Purchasing`, `Project`, `Invoice`, and `Payment` | Files | | **Category** options | The shared attached-documents editor | | `Just '_'‘-''.' And '&' Characters Accepted` | This message belongs to the embedded Files surface. | | Unavailable layout, warehouse, or inventory choices | These controls are not available on this QC surface. | Work from the headers visible in your selected layout. ## Continue warehouse work Choose the next page by the warehouse question you need to answer. QC places receipt and inspection information together. | After QC work, if you need to… | Continue with | |---|---| | Review or create the receipt record | [Goods receipt notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/goods-receipt-notes) | | Review or create an inspection note | [Incoming inspection notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/incoming-inspection-notes) | | Review products released for later storage work | [Upcoming stock](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/upcoming-stock) | | Understand the related receiving, inspection, and stock surfaces | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | Use the displayed receipt, inspection, and stage information to choose the relevant surface. --- title: Upcoming stock ... # Upcoming stock Use **Upcoming stock** to review products that have arrived, distinguish products waiting for inspection from products released for storage, and assign a storage position to an eligible product. ## Upcoming stock **Upcoming stock** is the Inventory reference list for following received products from inspection to storage. It is for reviewing incoming stock and its queues, rather than for creating a product record. The warehouse flow has two review points: ```mermaid stateDiagram-v2 [*] --> AwaitingInspection: received product AwaitingInspection --> AwaitingStorage: released by Quality Control AwaitingStorage --> Stored: Stock product ``` | If you need to… | Go to | | --- | --- | | Open the list and learn what each queue contains | [Find the Upcoming stock list](#find-the-upcoming-stock-list) | | Interpret the headers and row stages | [Read the Upcoming stock list](#read-the-upcoming-stock-list) | | Review received products that have not been inspected | [Choose the queue to review](#choose-the-queue-to-review) | | Review products released for storage | [Choose the queue to review](#choose-the-queue-to-review) | | Assign a storage position to an eligible product | [Handle the conditional Stock product action](#handle-the-conditional-stock-product-action) | | Continue with inspection work | [Incoming inspection notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/incoming-inspection-notes) | | Continue through warehouse fulfilment | [Warehouse fulfilment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | | Review stock by shipment | [Stock by shipment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/stock-by-shipment) | | Continue with goods receipt work | [Goods receipt notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/goods-receipt-notes) | ## Before you start The list appears according to your subscription, department, permissions, chosen list layout, and available stock data. The list area requires a chosen list layout, and it is hidden when the subscription does not include the relevant feature. | Page area | What determines whether it appears | | --- | --- | | Main Upcoming stock list | A list layout is chosen and the subscription includes the feature. | | **Stock By Shipment** | The subscription includes Stock By Products and the department is not Quality Control. | | **Stock By Products** | The subscription includes Stock By Products and the department is not Quality Control. | | `+` menu | A list number exists and the subscription is included. | | Stocking Product Sheet | The Stocked Product permission and the Stock By Products subscription are available. | | Headers | The headings shown depend on the list layout you use. | Treat the headers visible in your list as the authoritative column set for your work. When the list is available, open it as follows. ## Find the Upcoming stock list **Receiving** is the receiving view for products that have arrived and are moving through inspection and storage review. **Prerequisites** - You are signed in to PAMS. - Your account can open the Inventory destination. **Steps** 1. Open **Inventory**. 2. Confirm that the page heading is **Upcoming stock**. 3. Confirm that **Receiving** is the active main tab. ![Identify the Upcoming stock heading and the active Receiving tab.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/8ea774b018373b8eacfaa097d3335547.png) **Result:** The Upcoming stock list is open with **Receiving** active. Read the visible headers and row stage before choosing a queue. ## Read the Upcoming stock list The list is a reference grid: each row lets you compare receiving quantities, inspection status, and storage information without opening an entry form. The list uses these headers: | Receiving information | Quantities and status | Storage and inspection references | | --- | --- | --- | | **Sales job no.** | **Received Qty** | **Area** | | **Product** | **Accepted qty** | **Position** | | **Description** | **Rejected qty** | **GRN** | | **P.O.s** | **Unit** | **Inspection No.** | | | **Stage** | | Rows in the initial list and in **Awaiting Inspection** show the stage `Awaiting inspection`. Rows in **Awaiting Storage** show the stage `Accepted`; the displayed rows also contain GRN and Inspection No. values. The visible icon-button titles are **Refresh**, **table layout**, and **Settings**. Use the filter in a column heading to narrow the rows, and use the page controls to move through the list. ![Compare the list headers and row stage.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/4232b51689b7297148b3066d45b5f189.png) > **Note:** The columns and available choices depend on your list layout, subscription, department, > permissions, and available stock data. Select **Refresh** to reload the list when you need the latest visible rows. Use **table layout** to work with the available list layout, and use **Settings** for the available grid settings. The headers depend on the list layout you use. If your layout differs, read the headers shown in your list rather than assuming that every possible column is present. Use the row stage and these headers to choose the queue to review. ## Choose the queue to review **Awaiting Inspection** is the queue for products received but not yet inspected. **Awaiting Storage** is the queue for products released by Quality Control for storage. **Prerequisites** - The Upcoming stock list is open. - **Receiving** is the active main tab. **Steps** 1. Select the queue that matches the work you need to review. | If you need to… | Select | | --- | --- | | Review products received but not yet inspected | **Awaiting Inspection** | | Review products released by Quality Control for storage | **Awaiting Storage** | 2. Confirm that the selected queue is visible. ![Review the Awaiting Inspection queue and its row stage.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/7f3d54566b758c59982110487ff9c27d.png) ![Review the Awaiting Storage queue and its accepted rows.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/be16e862ff8e403a21c76005bba1dd20.png) **Result:** The selected queue is open, and its rows show the corresponding receiving or storage stage. For an eligible row in **Awaiting Storage**, continue with the stocking action. ## Handle the conditional Stock product action **Stock product** assigns an eligible received product to a storage position after the product has a receiving shipment, an inspection, a release to Inventory, and no rejected quantity. **Prerequisites** - You are reviewing a row that meets all four eligibility conditions. - You have a storage position for the product. **Steps** 1. Select **Stock product** for the eligible product. 2. In **Product assignment certificate**, enter the storage location in **Position**. 3. Optional: Enter an explanation in **Note**. 4. Select **OK**. 5. Confirm that the Product assignment certificate closes. 6. Confirm that Upcoming stock refreshes. **Result:** The eligible product is assigned through the Product assignment certificate, the popup closes, and the Upcoming stock list refreshes. If the list does not refresh or the action is unavailable, use the symptom table below. ## When the list or action does not work | What you see | What it means | What to do | | --- | --- | --- | | The Upcoming stock page opens without the list. | A chosen list layout and an included subscription are required for the list to appear. | Ask the person who manages your PAMS access to check the list layout and subscription. | | A column you expect is not shown. | Your list layout determines the headers. | Work from the headers visible in the list. | | You need to record a storage position. | The list is for reviewing received products. | Select **Stock product** when the row meets the stocking conditions. | | **Stock product** is not available. | The row is not eligible, or the action is unavailable in the current configuration. | Review the row's receiving, inspection, release, and rejected-quantity conditions. | | PAMS displays `Please enter the storage area and position for each product`. | The stocking entry lacks the required storage information. | Enter **Position** before selecting **OK** again. | If a conditional detail or popup flow displays a message, use the message exactly as shown: | Condition | Message | | --- | --- | | A request completes successfully | `Your request was completed successfully` | | A request cannot be processed | `An error occurred while processing your request` | | **Position** is empty in the stocking entry | `Position is required` | | A product entry has no package products | `Package products cannot be empty` | | A shipment has no received quantity | `Shipment is empty. Please enter received quantity` | | Received quantity exceeds order quantity | `Received quantity is greater than order quantity` | | A mandatory field is missing | `Check mandatory field(s)` | | A product has neither an accepted nor rejected decision | `You have products with no decision regarding accepted or rejected quantity` | | A value contains forbidden characters | `Forbidden characters detected. Please remove them and try again.` | ## What comes next Choose the next warehouse work page according to the queue you reviewed. **Stock By Shipment** and **Stock By Products** are separate warehouse views. | After you review or stock… | Continue with | | --- | --- | | Products in **Awaiting Inspection** | [Incoming inspection notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/incoming-inspection-notes) | | Released stock | [Warehouse fulfilment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | | A shipment-oriented stock question | [Stock by shipment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/stock-by-shipment) | | Goods receipt work | [Goods receipt notes](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/goods-receipt-notes) | After resolving an issue, use the selected queue and row stage to choose the next warehouse work page. # Project management workspace Use Project management to follow the bill of materials (BOM), purchasing, stock, and delivery work attached to a project. This page helps you find the right list, read its current stage, orient yourself in the related project record, and hand the work to the page that owns the next step. A bill of materials (BOM) is the list of products and quantities needed for the project. ## Project management workspace Project management is the workspace for the material and delivery work that turns a project into an orderable, receivable, and deliverable result. The workspace also includes a material requisition (MRQ), the request used to start material-requisition work for stock. The project delivery chain moves from project planning through BOM preparation, purchasing, stock and inspection, and delivery. Project management brings these views together; the focused pages own the detailed MRQ, purchasing, warehouse, and order procedures. ```mermaid flowchart LR A[Project management] --> B[BOM preparation] B --> C[Purchasing] C --> D[Stock and inspection] D --> E[Delivery] A --> F[MRQ for stock] F --> C ``` | If you need to… | Go to | |---|---| | Choose the project-work list and open related records | [Find project work](#find-project-work) | | Understand the columns and list tools | [Read the project-management list](#read-the-project-management-list) | | Check the shared project record | [Open and orient a project record](#open-and-orient-a-project-record) | | Create an MRQ | [Create an MRQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-mrq) | | Continue through procurement | [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) | | Continue through warehouse fulfillment and delivery | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | | Create a shipping order | [Shipping orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/shipping-orders) | | Create an assembly order | [Assembly orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/assembly-orders) | The project-management list is at `/projects-management/list/:List/view`. The shared project record is at `/projects-management/edit/:id`. ## Before you start Project-management surfaces depend on your subscription, permission, the saved state of a record, and company configuration. The same project can therefore expose fewer fields or actions in another setup. Company configuration is the configuration area for configurable fields and list layout. Prerequisites - Your subscription includes Project management. If it does not, the list is replaced by an upgrade surface. - Your subscription includes the stock material-requisition feature before you use **MRQ for stock**. - You have access to the relevant list or record page. - You know the project record or project work you need to open. - For record-level actions, the record is saved first. The form enforces these required fields: **Salesperson Responsible**, **Product Type**, **Job Title**, **Client**, **Vendor**, and **Bid Due Date**. **Order chance**, **End User**, **Estimated Value**, **File Number**, **Client Inquiry Number**, **Inquiry Date**, **Requested Offer Type**, **Contact to Decision Makers**, **Budget Availability**, and **Chance in Competition** are required only where your company configuration makes them required. **Status**, **Branch**, and **Expected Order Date** are not required by the listed rules. ## Find project work Project work is grouped by the list that represents its current work position. Use the list tabs to move from the broad project view to a focused work queue. | Work you need to find | Select | |---|---| | All project work | **All** — `/projects-management/list/all/view` | | BOM preparation work | **BOM Preparation** | | Current material requisitions | **Current MRQs** | | Purchasing work | **In Purchasing** | | Stock work | **In Stock** | | Delivered work | **Delivered** | | Running project jobs | **Running Jobs** | | Delivered project jobs | **Delivered Jobs** — `/projects-management/list/delivered-orders/view` | Use the visible **All**, **BOM Preparation**, **Current MRQs**, **In Purchasing**, **In Stock**, **Delivered**, and **Running Jobs** tabs for the project-work queues. Use the tab labels visible in your list for the purchasing and goods queues. Prerequisites - Project management is included in your subscription. - You know which work position you need to review. Steps 1. Open the Project management list. 2. Select the tab that matches the work position you need. 3. Follow the destination that matches the selected work. | If you selected or found… | Then… | |---|---| | Purchasing work | Choose the purchasing list and use its available filters. | | A sales-job, MRQ, receiving, or inspection link in the row | Open the related link. | | Stock work with the stock MRQ feature included in your subscription | Select **MRQ for stock**. | | BOM preparation work | Open the **BOM Preparation** list. | **Result:** The selected project-work list or related record is open. Selecting **BOM Preparation** opens the BOM preparation list. When **In Purchasing** is open, its available filters are **All**, **RFQs**, **Quotations**, **Orders**, and **Stuck**. ![The All project-work list with its tabs and columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d06c576f6b6d8d4c900f0308fe33f1ca.png) ## Read the project-management list The project-management list is a work queue: its visible columns come from the saved list layout, while the stage value in each row tells you where that project work is. On **All**, use these columns: | Column | What it identifies | |---|---| | **Product** | The product in the project work row | | **Sub-supplier** | The sub-supplier associated with the row | | **MRQ No.** | The material-requisition number | | **Purchsing No.** | The purchasing number; the spelling is shown exactly this way | | **Description** | The row description | | **Quantity** | The row quantity | | **Stage** | The current project-work stage | | **Required receiving date** | The required receiving date | On **BOM Preparation**, use **Product**, **Description**, **Quantity**, **PM responsible**, and **Odoo order no.** The list uses the selected layout rather than a fixed column set. Work from the headers you can see. Select **Refresh** to reload the list. Select **Table Layout** to work with the table layout. Select **Settings** to open the available list settings. Use **Export** when the export action is available. > **Note:** A different saved layout can change the headers you see. Use the visible > headers as your working reference. ![The BOM Preparation list and its visible columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5439623a0ace62d970608300744da82e.png) ## Open and orient a project record A project record is the shared job record behind project-management work. It holds the project information used by the sales and delivery chain. In project-management context, the record uses the Project management breadcrumb and provides an **Orders** link. The record route is `/projects-management/edit/:id`. Its core fields include: | Field | Type | Requirement | |---|---|---| | **Salesperson Responsible** | Picker | Required | | **Product Type** | Select | Required | | **Job Title** | Text | Required | | **Client** | Picker | Required | | **Vendor** | Picker | Required | | **Bid Due Date** | Date | Required | | **Order chance** | Select | Configurable | | **Status** | Select | Not required | | **Branch** | Text | Not required | | **Expected Order Date** | Date | Not required | Additional fields can be configurable or stage-dependent. **Status** and **Order chance** are part of the record's stage-related information; the other panels and fields shown depend on the record stage, subscription, page availability, and inquiry state. The record provides a shared **Save and close** surface. Save the record before using record-level actions that require a saved record. Use the fields and links that appear on the project record you opened. ## Handle stage and setup differences A stage-dependent surface is a field, tab, dialog, filter, or action that appears only for a particular project stage or record condition. Use the Company configuration described in Before you start when interpreting configurable fields and list layout. | What changes | Condition that controls it | |---|---| | The whole list or an upgrade surface | Whether the subscription includes Project management | | Main list tabs | Subscription inclusion and enabled breadcrumbs | | Purchasing and goods filters | The corresponding list-tab group | | Record fields | Subscription, page existence, job stage, and whether an inquiry is open | | Stage-action dialog fields | The matching dialog name | | List columns | The selected table layout | | Project-management breadcrumb and **Orders** link | The record is in Project management context | When a stage-action dialog opens, its fields depend on the dialog name. The possible fields include **Regret Reason**, **Regret Date**, **Comment**, **Cancellation Reason**, **Cancellation Date**, **Amount**, **Lost Reason**, **Lost Date**, **Winner Name**, Difference (%), **Delivery Time Difference**, **Reject Date**, **Offer validation type**, **Request extension as date**, **Request extension as period**, **Order Activation Date**, and **Delivery Date**. Use the surface that is visible for the current record. A missing field or action can result from subscription, page availability, permissions, inquiry state, stage, or company configuration rather than from a damaged record. ## When the work does not proceed When an action stops, match the message to the situation before changing the record. Use the following messages and restrictions when project work stops. | What you see | What to check or do | |---|---| | `This field is required` | Complete the required field named on the form. | | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a positive value no greater than `999,999.00`. | | `An error occurred while processing your request` | Review the record and request again through the owning procedure. | | `An account with this name already exists` | Use the existing account or change the account name according to your process. | | `A project with this name already exists` | Use the existing project or choose a name that is not already used. | | `Custom fields saved successfully` | The custom-field change is saved. | | `Error saving custom fields` | Review the custom-field values and save again through the owning record procedure. | | `You cannot edit or delete the product after the purchase package is created` | Do not edit or delete that product after the purchase package exists. | | `Cannot be deleted. Product is in purchasing` | Continue from the purchasing work instead of deleting the product here. | | `You cannot edit the product after the PO is created` | Do not edit the product after the purchase order exists. | | `Booked quantity for this job is greater than the required BOM quantity` | Correct the booked quantity so it does not exceed the required BOM quantity. | | `Cannot be un-delivered — a due invoice already exists` | Do not reverse delivery while the due invoice exists. | | `All offers must be in draft status to revert to inquiry` | Return every offer to draft before reverting to inquiry. | | `Please save opened inquiry first` | Save the open inquiry before continuing. | | `All inquiries must be in draft stage to revert to potential` | Return every inquiry to draft before reverting to potential. | Successful record and project-work actions use these messages: | Action | Message | |---|---| | Save the job | `Job updated successfully` | | Save custom fields | `Custom fields saved successfully` | | Delete the job | `Job deleted successfully` | | Regret the job | `Job regretted successfully` | | Cancel the job | `Job cancelled successfully` | | Mark the job missed | `Job missed successfully` | | Reactivate the job | `Job reactivated successfully` | | Convert to an offer | `Converted to offer successfully` | | Convert to an inquiry | `Converted to inquiry successfully` | If a related purchasing, warehouse, account, contact, MRQ, or activity action shows one of these messages, follow the message's instruction and continue in the owning work area. | Message | Reader guidance | |---|---| | `Invalid input. Please enter a non-negative value` | Enter zero or a positive value. | | `Please enter action for each milstone` | Enter an action for every milestone. | | `Please save opened cost sheet first` | Save the open cost sheet before continuing. | | `Error: Vendor not saved yet` | Save the vendor before continuing. | | `Error: Client not saved yet` | Save the client before continuing. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters and enter the value again. | | `You already have a contact with this name` | Use the existing contact or choose another name. | | `This product is already included in BOM` | Use the existing BOM item instead of adding it again. | | `The first variant cannot be deleted` | Keep the first product variant. | | `An error occurred while connecting to your CRM system.` | Check the CRM connection before continuing. | | `Please select one product` | Select one product before continuing. | | `Package must have at least one item` | Add an item to the package before saving. | | `You cannot save without adding at least one product` | Add at least one product before saving. | | `This record is related to saved data and cannot be deleted` | Keep the record because saved data depends on it. | | `Action not allowed` | Use an action available for the current record. | | `Please enter at least one email` | Enter at least one email address. | | `Inquiry must have at least one item` | Add an item to the inquiry before continuing. | | `Offer must have at least one item` | Add an item to the offer before continuing. | | `Order must have at least one item` | Add an item to the order before continuing. | | `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Keep items at either of these stages. | | `Please select one or more items to create a RFQ.` | Select at least one item before creating the RFQ. | | `Required Offer Type` | Select an offer type before continuing. | | `Required Bid Due Date` | Enter the bid due date before continuing. | | `This Field Is Required` | Complete the required account field. | | `Error loading accounts` | Check the account list before continuing. | | `Serial you have entered already exist and belong to same manufacturer` | Enter a different serial. | | `There is error in serial you have entered` | Correct the serial and enter it again. | | `Minimum: At least one serial` | Add at least one serial. | | `Please Add Extension to activate the LG` | Add an extension before activating the L/G. | | `LG has one or more extensions or deductions and cannot be reverted to the requested stage` | Remove the extensions or deductions before reverting the L/G. | | `Please choose a date after the current expiry date` | Choose a date after the current expiry date. | | `One topic and at least one note is required` | Add one topic and at least one note. | ## Out of scope on this workspace The project-management workspace overview ends at the hand-off to shipping-order or assembly-order work. The shipping-order and assembly-order screens have separate routes and own their detailed controls. Use the focused pages for those procedures; do not treat a project-management list row as the complete order-creation screen. ### Out of scope messages The following message belongs to the owning saved-record page rather than this workspace: | Message | Owning page | |---|---| | `Your request was completed successfully` | Account details and other saved-record pages | | `Required Receiving After` | Products page | ## Create a shipping order A shipping order is the separate order-creation surface for the shipping part of project delivery. The project-management workspace provides the hand-off; the shipping-order page owns the creation procedure and its required selection, date, item, and save controls. Open [Shipping orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/shipping-orders) to create and locate a shipping order. ## Create an assembly order An assembly order is the separate order-creation surface for the assembly part of project delivery. The project-management workspace provides the hand-off; the assembly-order page owns the creation procedure and its required fields, product selection, and save controls. Open [Assembly orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/assembly-orders) to create and locate an assembly order. ## Continue the project flow Use the related project-management links to hand work to its owning page. A related record link opens the project-management record in a new tab with the project context. | Next work | Open | |---|---| | Create and follow an MRQ | [Create an MRQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-mrq) | | Complete a saved MRQ | [Complete an MRQ record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/mrq-record-follow-up) | | Continue procurement | [Purchase job workflow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-jobs-procurement-chain) | | Fulfil and deliver warehouse work | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | | Create a shipping order | [Shipping orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/shipping-orders) | | Create an assembly order | [Assembly orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/assembly-orders) | | Continue from project records in Orders and delivered orders | Use the **Orders** or **Delivered Jobs** project-record route when it is available. | The project delivery chain therefore continues from Project management to the owning MRQ, procurement, warehouse, shipping, assembly, and delivered-order pages rather than being completed on this overview page. # Shipping orders Use a shipping order to select items from a sales job, track their shipment progress, and review the connected order. ## Shipping orders A shipping order records the items selected for shipment and their progress from a sales job toward delivery. Use it after the sales job identifies what must be shipped and before the connected shipment and delivery work is completed. The shipping-order lifecycle uses these statuses: ```mermaid stateDiagram-v2 Draft --> GoodsAwaitingIssue GoodsAwaitingIssue --> GoodsIssued GoodsIssued --> GoodsInpected GoodsInpected --> GoodsReadyForShipemnt GoodsReadyForShipemnt --> GoodsReleasedForShipment GoodsReleasedForShipment --> GoodsDelivered ``` | Status | What it represents in the shipping-order flow | |---|---| | `Draft` | The shipping order has been created as a draft. | | `GoodsAwaitingIssue` | The goods are awaiting issue. | | `GoodsIssued` | The goods have been issued. | | `GoodsInpected` | The goods have reached inspection. | | `GoodsReadyForShipemnt` | The goods are ready for shipment. | | `GoodsReleasedForShipment` | The goods have been released for shipment. | | `GoodsDelivered` | The goods have been delivered. | | If you need to… | Go to | |---|---| | Check what a shipping order is and where it fits | [Shipping orders](#shipping-orders) | | Prepare the sales job and information needed to create one | [Before you start](#before-you-start) | | Locate an order that already exists | [Find a shipping order](#find-a-shipping-order) | | Open the project-management list | [Open the shipping-order list](#open-the-shipping-order-list) | | Open a new order form | [Open a new shipping order](#open-a-new-shipping-order) | | Read the order fields and shipment-progress areas | [Understand the shipping-order screen](#understand-the-shipping-order-screen) | | Enter items and save the order | [Create a shipping order](#create-a-shipping-order) | | Continue the surrounding project flow | [Project management workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/project-management-workspace) | | Review the connected order and delivery flow | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) | | Continue detailed warehouse work | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | ## Before you start Have a sales job that contains the items you need to ship. The shipping order uses the selected sales job as its item source, so selecting the wrong job puts the wrong shipment context into the order. | Have or check | Why it matters | |---|---| | The sales job's **Sales Job Number** | A new shipping order requires this selection. | | The items to ship | The order must contain at least one item before it can be saved. | | The person and date for the order | **Shipping ordered by** and **Shipping ordered on** are required on the order screen. | | Access to Projects Management | The shipping-order list and new-record route are in this module. | | A saved order when reviewing progress | Existing-order fields and **Last Modifications** appear only after the order exists. | Leaving a new or edited shipping-order form is protected when it contains unsaved changes. Complete or cancel the form through its available controls rather than assuming that leaving the page silently discards unsaved changes. The available permission and subscription branches depend on your account and setup. If the shipping-order content or edit controls are not available, use the access route for your Projects Management administrator. When these checks are complete, find the order or open a new order from the **Shipping Orders** list. ## Find a shipping order The shipping-order list groups existing orders by shipment progress. Use a status choice when you know the work position, or select a row when you know the order or job you need to review. ### Open the shipping-order list Open **Shipping Orders** in **Projects Management**. ![Shipping Orders list with status choices, columns, and list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2cc4346af51b547073fb75c407caa739.png) The list shows these headers: | Header | Use it to… | |---|---| | **Sheet no.** | Identify the shipping-order sheet. | | **Order date** | Compare the order dates. | | **P.M responsible** | See the project-management responsibility shown for the row. | | **Client order no.** | Check the client order number when the row provides one. | | **Job no.** | Match the shipping order to its job. | The list also provides **Refresh**, **table layout**, and **Settings**. The headers come from the selected list layout, so work from the headers visible in your list when another layout presents a different set of columns. #### Prerequisites - You have access to **Projects Management**. - You know the sales job number, shipping-order sheet number, or status to look for. #### Steps 1. Open **Projects Management**. 2. Select **Shipping Orders**. 3. Select a status choice from the list. | If you need to… | Select | |---|---| | See all shipping-order statuses | **All** | | See requested or draft shipments | **Requested shipments** | | See orders ready for shipping | **Ready for shipping** | | See released shipments | **Released shipments** | | See delivered shipments | **Delivered** | 4. Select the shipping-order row you need. **Result:** The selected shipping order opens for review. From the list, open an existing row to review it, or use the new-record menu to create an order. ### Open a new shipping order Use the project-management new-record menu when you need to create a shipping order. The menu contains **Shipping Order**. ![New Shipping Order form with required order fields and save controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3456703e14011a7ed58bd41a65f16523.png) #### Prerequisites - You have access to **Projects Management**. - You know the sales job whose items you need to ship. #### Steps 1. Open the project-management new-record menu. 2. Select **Shipping Order**. 3. Confirm that **Sales Job Number**, **Shipping ordered by**, **Shipping ordered on**, **Save**, and **Save and Close** are on the form. **Result:** The new shipping-order form is open. ## Understand the shipping-order screen The shipping-order screen combines order information, shipment progress, selected items, and saved-order history. A new order starts with the order-information area; the item and progress surfaces change as the order is linked to a sales job and saved. After you identify the fields, create the order in [Create a shipping order](#create-a-shipping-order) or reopen a saved order in [Review shipment progress](#review-shipment-progress). | Screen area | What it is for | |---|---| | Details | Order information and shipment-progress fields. | | Items | The shipment items and their quantities. | | Split an item | Select **Split** when the option is available for the selected product row. | | Order lookup | Selecting **Sales Job Number** opens the available-item selection surface. | | Product lookup | **Product** opens product insertion when its condition applies. | | Warehouse detail and totals | Item-level warehouse and quantity information. | | Comments | Comments for a saved order. | | Last Modifications | The saved order's log history. | The screen provides tabs, shared popups, and file surfaces. The visible **Save** and **Save and Close** controls are part of the form. The item-selection and lookup surfaces can be collapsed or expanded according to the screen state. Work from the labels currently visible rather than expecting every panel to open in the same state. ### Order information Order information identifies the sales job, responsibility, and date for the shipping order. On a new order, select the sales job; on an existing order, the saved order number and linked client can also appear. | Screen label | Rule | |---|---| | **Sales Job Number** | Required for a new order. It selects the sales job and its available items. | | **Shipping ordered by** | Required. It is filled from the signed-in user and is read-only. | | **Shipping ordered on** | Required, filled with the current date, read-only, and no later than today. | | **Client** | Appears when the shipping order has a linked sales job. | | Existing order number | The existing order's `SalesOrderNo` is present on a saved order. | ### Shipment progress Shipment progress records who confirmed, released, and delivered the goods for an order linked to a sales job. These fields connect the order screen to the status flow from goods issue through delivery. | Progress information | Screen label | Rule | |---|---|---| | Ready date | **Confirmed on** | No later than today. | | Ready responsibility | **Confirmed by** | Disabled responsibility selection. | | Release date | **Released on** | From **Confirmed on** through today. | | Release responsibility | **Released by** | Disabled responsibility selection. | | Delivery date | **Delivery Date** | No later than today. | | Delivery responsibility | **Delivered by** | Disabled responsibility selection. | **Client**, **Confirmed on**, **Confirmed by**, **Released on**, **Released by**, **Delivery Date**, and **Delivered by** appear when the shipping order is linked to a sales job. The ready and released dates preserve their stated ordering: a release date cannot precede the ready date or extend beyond today. ## Create a shipping order Create the order when the sales job and the items selected for shipment are known. Selecting the sales job opens the item-selection surface; saving with no item is blocked. #### Prerequisites - You have opened a new shipping-order form. - You know the sales job to select. - The sales job contains at least one item available for shipment. #### Steps 1. In **Sales Job Number**, select the sales job. 2. In **Items for shipment**, select the available item rows. 3. Select **OK** in **Items for shipment**. 4. Check the **Items** area for the selected rows and quantities. 5. Check **Shipping ordered by**. 6. Check **Shipping ordered on**. 7. Select **Save and Close**. If the order has no item, the save validation displays `Please enter sales item(s)`. Add at least one item before selecting **Save and Close** again. 8. Confirm the success message `Your request was completed successfully`. **Result:** The shipping order is saved and the form closes after the successful **Save and Close** action. After saving, use [Handle conditional shipping-order details](#handle-conditional-shipping-order-details) to identify the surfaces available for the saved order. ## Handle conditional shipping-order details The form changes as the order moves from new to saved and as the linked sales job and edit access change. Use the condition that matches the form state rather than looking for every surface on a new order. | Form condition | What appears | |---|---| | Existing order | Existing-order fields and **Last Modifications**. | | New order | The order picker for **Sales Job Number**. | | Linked sales job | **Client** and shipment-progress fields. | | New order with a sales job | **Product**. | | Edit permission available | **Save**, **Save and Close**, and the editable close action. | | Edit permission absent | The non-editable close action instead of the editable save controls. | Permission and subscription branches depend on the account and setup. A missing surface can therefore reflect access or subscription configuration rather than a different order value. ### Work with item-selection options The product-selection popup provides row selection, dispatch priority, quantity, and unit choices when its conditions apply. | Control or value | Use | |---|---| | **Select all** | Select every product row in the insertion popup. | | **Unselect all** | Clear the selected product rows. | | **Dispatch priority** | Choose how the product rows are dispatched. | | `Manual selection` | Select rows manually; this is option ID 1. | | `First booked first out` | Use the first-booked-first-out option; this is option ID 2. | | **Target Qty** | Enter the target quantity; the minimum is 0. | | **Selected Qty** | Review the selected quantity; the minimum is 0 when editable. | | **Unit** | Read the item unit. | **Select all** appears in the product popup, and **Unselect all** appears when rows are selected. The responsibility and unit option names come from your current account data. ### Split an item when the option is available Use manual splitting only for an instant job with distribution type 1. In that state, the selected product row provides **Split**. #### Prerequisites - The order is an instant job. - Its distribution type is 1. - The product row is selected in the product popup. #### Steps 1. Select the product row. 2. Select **Split**. **Result:** Manual item-splitting preparation opens for the selected product. ### Review shipment progress Reopen a saved order from the shipping-order list when you need to compare its item quantities with its progress fields or inspect its change history. #### Prerequisites - The shipping order is saved. - You can identify its row in the shipping-order list. #### Steps 1. Open **Shipping Orders** in **Projects Management**. 2. Select the status choice that contains the order. 3. Select the shipping-order row. 4. Review the item quantities and shipment-progress fields. 5. Select **Last Modifications**. **Result:** The saved shipping order is open, and **Last Modifications** displays its log history. **Last Modifications** is available only for an existing order. ## Out of scope on this screen The shipping-order details screen does not provide the following fields or surface: | Item | What to expect | |---|---| | **Inventory** | Not available as an active screen area. | | **Moved to shipping on** | Not available on this screen. | | **Moved to shipping by** | Not available on this screen. | | **Client Order No.** | Not available on this screen. | | **Contractual Delivery Date** | Not available on this screen. | If a value blocks the save or another order action, use [When something goes wrong](#when-something-goes-wrong). The list headers depend on the selected layout. The individual names offered for **Shipping ordered by**, **Confirmed by**, **Released by**, **Delivered by**, and the Target Qty and Selected Qty unit choices depend on the current account data. Use **Requested shipments** for draft shipping orders. The initial expansion of panels or popups depends on the current screen state. ## When something goes wrong Use the message on screen to identify whether the order needs item information, warehouse information, a quantity decision, access, or a compatible unit choice. | Message | Corrective action | |---|---| | `Please enter the storage area and position for each product` | Enter storage-area and position information for every product, then save again. | | `Please enter sales item(s)` | Add at least one sales item in **Items for shipment**, select **OK**, and save again. | | `Some products are not available in stock` | Review the selected products against available stock before saving again. | | `You have products with no decision regarding accepted or rejected quantity` | Set the accepted or rejected quantity decision for each affected product. | | `Package products cannot be empty` | Complete the package-product contents before saving. | | `You don’t have permission` | Ask the administrator responsible for Projects Management access to grant the required permission. | | `This is only possible if all unit types are the same` | Select items with the same unit type before using the operation again. | | `An error occurred while processing your request` | Check the order values and try the operation again; if it continues, ask your administrator to investigate. | After correcting the order, return to [Create a shipping order](#create-a-shipping-order) or [Review shipment progress](#review-shipment-progress), depending on the task. ## After you create or find the order After a successful save, **Save and Close** closes the form. Reopen the saved order from the **Shipping Orders** list when you need to review its items, progress fields, or **Last Modifications**. The shipping-order lifecycle continues through goods issue, inspection, ready for shipment, release, and delivery. The order belongs to the connected project flow that covers ordering, stock, and delivery. For the surrounding workspace, see [Project management workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/project-management-workspace). For the broader order and delivery hand-off, see [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered). For detailed warehouse work, see [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow). # Assembly orders Create or locate the Project management record used to assemble products, then save the order with its sales item, products, quantities, and dates. ## Overview An assembly order is the Project management record for assembling products for a project. Project management brings together bill-of-materials (BOM), ordering, stock, and delivery work; PAMS connects BOMs, material requisitions (MRQs), requests for quotation (RFQs), purchase orders (POs), warehouses, and delivery in the project cycle. | If you need to… | Go to | |---|---| | Understand the information needed before you start | [Prerequisites](#prerequisites) | | Open the assembly-order list or a new order | [Find an assembly order](#find-an-assembly-order) | | Identify fields, product areas, and tabs | [Understand the Assembly Order screen](#understand-the-assembly-order-screen) | | Enter products and save the order | [Create and save an assembly order](#create-and-save-an-assembly-order) | | Check which actions change with the order state | [Handle new, existing, and optional order states](#handle-new-existing-and-optional-order-states) | | Correct a validation or processing problem | [Resolve validation and access problems](#resolve-validation-and-access-problems) | | Continue with related Project management work | [Know what comes next](#know-what-comes-next) | | Review the wider Project management area | Project management workspace | | Continue with warehouse work | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | ## Prerequisites Inventory identifies the warehouse record used by the order. **Sales Order No.** and **Sales Item Description** identify the sales order and sales item that the assembly order serves. The selected sales item can supply **Final product**, **Qty**, **Unit**, and **Name** when those values are empty. | Before you start | What applies | |---|---| | Inventory | **Inventory** is required. Its choices are warehouse records loaded for your company. | | Sales order | Select a value in **Sales Order No.**. This selection is required before the order can use **Product**. | | Sales item | Select a value in **Sales Item Description**. This selection is required before the order can use **Product**. | | Order date | **Ordered on** is required. The new-order date sets it. | | Completion | **Completed on** and **Completed by** are required only for a completed process. | | Edit access | **Save** and **Save and Close** appear only when you may edit. They are disabled when there are no data changes. | The **Product** action is available only for an unsaved order with both the sales order and sales item selected. The available choices for **Inventory**, **Sales Order No.**, **Sales Item Description**, **Ordered by**, and **Completed by** come from data loaded for your company rather than from a fixed list on the form. ## Find an assembly order The assembly-order list is the place to identify saved orders or start a new one. Open it from the Project management area. **Prerequisites** - You can open the Project management area. - You know whether you are locating an existing order or creating a new one. **Steps** 1. Open the assembly-order list from the Project management area. 2. Select the work view that matches the order stage. | If you need to… | Select | |---|---| | Review all visible work | **All** | | Prepare a bill of materials | **BOM Preparation** | | Review current material requisitions | **Current MRQs** | | Review purchasing work | **In Purchasing** | | Review stock work | **In Stock** | | Review delivered work | **Delivered** | | Review assembly orders | **Assembly Orders** | 3. Identify a saved row from **Sheet no.**, **Job no.**, **P.M responsible**, **Order date**, **Item description**, or **Expected complete on**. 4. Open the list entry that matches the work you need to do. | If you need to… | Open | |---|---| | Review or continue an existing order | The saved row | | Create an assembly order | A blank assembly-order form | 5. Select the toolbar action that matches your task. | If you need to… | Select | |---|---| | Reload the list | **Refresh** | | Change the list layout | **Table Layout** | | Open list settings | **Settings** | The list contains rows and can draw **Sheet no.**, **Job no.**, **P.M responsible**, **Order date**, **Item description**, and **Expected complete on**. Your list layout determines the columns visible in the list. > **Note:** Work from the headers visible in your list. A different list layout can draw a > different set of columns. ![The assembly-order list with its work views, rows, columns, and toolbar controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/40aadbb4f396bba17fa431265887e1eb.png) **Result:** The assembly-order list is open with rows and its available work views, or the blank assembly-order form is open. ## Understand the Assembly Order screen The Assembly Order screen combines order information, a product lookup, component rows, and receiving and inspection areas. Use the information area for the order header and the product area for the products that make up the assembly. | Area | What you see | |---|---| | Order information | **Inventory**, **Sales Order No.**, **Sales Item Description**, **Time Frame**, **Ordered by**, **Ordered on**, **Final product**, **Qty**, **Unit**, **Name**, **Completed on**, and **Completed by** | | Product work area | **Product**, with **Product**, **Used qty**, and **Unit** columns | | Products popup | **Product**, **Unit**, and **Sales item**, with **OK** | | Receiving area | **Warehouse**, **Recieved by**, **Recieved on**, **Sub-supplier**, and **Sub-supplier shipment no.** | | Inspection area | **Inspected by**, **Inspected on**, **GRN No.**, **Sub-supplier**, **Client**, **Checklist**, **Documents**, **Product**, **Ordered Qty.**, **Received Qty.**, **Accepted qty**, **Rejected qty**, **Defect**, and **Defect category** | The screen lists **Receiving sheet**, **Inspection sheet**, **Transfer history**, and **Last Modifications** tabs. It also lists **Comments**, but the page-level **Comments** tab is not available on this screen. The **Defect category** choices are **minor**, **major**, and **critical**. The receiving and inspection areas contain the fields needed for those surfaces. ![The new Assembly Order form with order fields, Product, and component columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/10233fbd1643c2e6c0a7caa6ffec2a59.png) ## Create and save an assembly order Create an assembly order when the sales order and sales item are known and the products to assemble are ready to record. **Prerequisites** - You are on the new assembly-order form. - You can select **Inventory**, **Sales Order No.**, and **Sales Item Description**. - You know the person and date to use for **Ordered by** and **Ordered on**, where those fields are available. - You know which products belong in the assembly. **Steps** 1. Select **Inventory**. 2. Select **Sales Order No.**. 3. Select **Sales Item Description**. 4. Select **Ordered by**, where the field is available. 5. Select **Ordered on**, where the field is available. 6. Review **Final product**, **Qty**, **Unit**, and **Name**. The selected sales item can fill these values when they are empty. 7. Select **Product**. 8. In the Products popup, select the products to add. 9. Select **OK**. The selected products appear as component rows with **Product**, **Used qty**, and **Unit**. If the form or product list needs correction, saving validates both before it sends the request. ![The Products popup and selected component rows before saving](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/83851e705ab044536376f8a189353a0f.png) **Result:** The selected products appear as component rows and the order is ready for saving. ### Save the assembly order Save after the order fields and component rows are complete. Use the option that matches whether you need to continue working on the saved record. **Prerequisites** - The order contains the required selections and at least one product row. - You may edit the order and the form has data changes. **Steps** 1. Select one save option: | If you want to… | Select | |---|---| | Keep the saved order open | **Save** | | Save the order and leave the form | **Save and Close** | 2. Confirm the message `Your request was completed successfully`. Saving can display `Check mandatory field(s)` when a required field is incomplete. If a product does not have the required storage information, correct it when the form displays `Please enter the storage area and position for each product` before saving again. **Result:** The assembly order is saved, the selected products remain in its component area, and `Your request was completed successfully` confirms the request. ## Handle new, existing, and optional order states An order's state changes which order actions and supporting surfaces you can use. Start with the new-order path, then use the saved record for later work. | Order situation | What you can use | |---|---| | New and unsaved, with both sales selections | **Product** is available for adding products. | | New and unsaved, without either sales selection | Complete the sales selections before using **Product**. | | Saved order | Continue from the saved record and use the save controls when editing is allowed. | | Saved order with products | Review the component rows before saving later changes. | | Saved inspection details, unchanged record, and unreleased items | **Finish and release to stock** is available. | ## Resolve validation and access problems When the screen stops an action, match its exact message to the correction below. | Message | What to do | |---|---| | `Please enter the storage area and position for each product` | Enter the storage area and position for each product, then save again. | | `You cannot save without adding at least one product` | Select **Product**, add at least one product, select **OK**, and save again. | | `Check mandatory field(s)` | Complete the fields marked as required, then save again. | | `Package products cannot be empty` | Add the required products to the product list before saving. | | `An error occurred while processing your request` | Review the order and product list, correct any displayed issue, and retry the action. | The screen validates before saving and protects navigation with a leave-screen check. Save only when you may edit and when the order has changes to commit. If an option or list column differs from the choices above, use the options and headers displayed in your form or list. ## Know what comes next A saved assembly order remains part of the Project management area that groups ordering, stock, and delivery work. **Shipping orders** are the companion Project management task. Continue with [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) when warehouse fulfillment is the next task in your role. The label **Finish and release to stock** identifies an available action only when the saved inspection details, unchanged record, and unreleased-item conditions are met. Do not treat that label alone as confirmation of a stage transition or stock effect. # Tasks and activities Use this page to find follow-up work, narrow the Tasks or Activities list, and choose what to do next. ## Tasks and activities at a glance A task is follow-up work with an owner, dates, a status, and an importance value. An activity is a Visit, Meeting, Call, or Mail record used to keep follow-up work visible. Together, these lists keep follow-up work visible across the sales operation. | If you need to… | Go to | |---|---| | Review all assigned and shared task work | [Tasks list](#tasks-list) | | Review only your personal task work | [Tasks list](#tasks-list), then select **My Tasks** | | Include completed tasks in the task review | [Tasks list](#tasks-list), then select **View completed tasks** | | Review every activity type together | [Activities list](#activities-list), then select **All** | | Review visits, email, meetings, or calls separately | [Activities list](#activities-list), then select the matching activity type | | Create follow-up work after reviewing the lists | [What to do next](#what-to-do-next), then open [Create a task](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-task) or [Create an activity](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-activity) | | Change an activity's record status | [Activity status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/activity-status) | | Continue in the personal work area | [My Desk tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-tasks) or [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities) | The activity list recognises five statuses: **Planned**, **Due**, **Overdue**, **Done**, and **Cancelled**. The status tells you where the follow-up stands; the list filters tell you which kind of follow-up you are reviewing. ## Before you start The lists are available only when the relevant list surface is available to your company and its saved layout can be loaded. The list filters appear only when the screen's filter area is available. For Activities, the activity-type filters require the Activities subscription. | Before you start | What you need to see | Why it matters | |---|---|---| | Tasks list | The **All** and **My Tasks** choices | These choices switch the task scope. | | Task completion view | **View completed tasks** in the **More Filters:** area | This control includes completed task work. | | Activities list | The **All**, **Visits**, **Email**, **Meetings**, and **Call** choices | These choices switch the activity type. | | Archived activities | **Show archived activities** in the **More Filters:** area | This control includes archived activity records. | | Either grid | Visible column headers and rows | These headers identify the information available for each record. | If the selected layout is unavailable, the grid does not appear. If the Activities subscription is not included, the activity-type choices do not appear. The lists do not offer task-text or activity-date filters. > **Note:** The columns in each list come from the selected layout, so use the headers > visible in your list rather than expecting a fixed set of columns. ## Find the task or activity list Use the corresponding entry from the application menu when you already have the application open. | To review… | Open from the menu | |---|---| | Tasks | **Tasks** | | Activities | **Activities** | **Prerequisites** - You are signed in to PAMS. - The list's subscription and layout conditions in [Before you start](#before-you-start) are in place. **Steps** 1. Select the list that matches the follow-up work you want to review. | If you need to review… | Select | |---|---| | Tasks | **Tasks** | | Visits, Email, Meetings, or Call follow-up work | **Activities** | ![The Tasks list with its filters and visible grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/543f8052ce650c92b92e156877477be2.png) **Result:** The selected list is open with its available filters, rows, and visible column headers. If the selected list does not appear, refresh the page. ### Tasks list Use the Tasks list to review all task work, narrow it to your own work, or include completed work. **Prerequisites** - You have opened the **Tasks** list. - The task filter area and selected list layout are available. **Steps** 1. Select the task view you need. | If you need to review… | Select | |---|---| | All task work | **All** | | Your personal task work | **My Tasks** | | Completed task work | In **More Filters:**, select **View completed tasks** | 2. Read the headers visible above the task rows. | Header | Use it to read | |---|---| | **Title** | The name of the follow-up work. | | **Owner** | The person responsible for it. | | **Start date** | When it starts. | | **Due date** | When it is due. | | **Status** | Its current status. | | **Importance** | Its importance value. | ![The six task columns visible in the selected layout](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0ad4da3a64b8aaeb331b11f1c5501e7f.png) The Tasks screen remains open after you select a task view. The completed view includes rows whose statuses include **Completed** and **Overdue**. ![The completed-task view with status values in the grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0ad4da3a64b8aaeb331b11f1c5501e7f.png) **Result:** The Tasks list shows the selected task scope, the completed-task inclusion state, and the visible task column headers. ### Activities list Use the Activities list to review all activity types, isolate one type, or include archived activities. **Prerequisites** - You have opened the **Activities** list. - The Activities subscription is included. - The activity filter area and selected list layout are available. **Steps** 1. Select the activity type that matches the work you want to review. | If you want to review… | Select | |---|---| | Every activity type | **All** | | Visits | **Visits** | | Email activities | **Email** | | Meetings | **Meetings** | | Calls | **Call** | 2. In the **More Filters:** area, select **Show archived activities** to include archived activities. 3. Read the headers visible above the activity rows. | Header | Use it to read | |---|---| | **Title** | The name of the activity. | | **Visitors** | People associated with it. | | **Activity purpose** | Its recorded purpose. | | **Company** | The associated company. | | Startdate | When it starts. | | **Status** | Its current status. | | **Importance** | Its importance value. | 4. Read **Planned**, **Due**, **Overdue**, **Done**, or **Cancelled** in the **Status** column when it appears. 5. If **Open** appears for the activity row, select **Open** to open the activity record. ![The seven activity columns visible in the selected layout](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d3e944d485bcaa998bf78ab141228016.png) The Activities screen remains open after you select an activity type or **Show archived activities**. The Call view contains **Planned** and **Done** rows. The Email and Meetings views show **No Data** and `Count: 0.00`. **Result:** The Activities list shows the selected activity type or archive inclusion, the configured columns, and the status shown for each visible activity. ## When list work goes wrong Use the condition that matches what is on screen rather than searching for a filter or control that is unavailable. | What you see | What it means | What to do | |---|---|---| | The task list has no **Following** choice. | That choice is unavailable. | Use **All** or **My Tasks**. | | Some task choices are unavailable. | The unavailable choices are not present. | Use the task choices and column headers shown. | | Some activity choices are unavailable. | The unavailable choices are not present. | Use the activity choices and column headers shown. | | The task or activity grid is absent. | The selected list layout is unavailable. | Wait for the list to load or use the list when a grid appears. | | Activity-type choices are absent. | The Activities subscription is not included, or the filter area is unavailable. | Use the activity list after the subscription is included and the filter area is available. | | A task row does not offer **Delete**. | **Delete** is restricted by branch, delete permission, and ownership conditions. | Use the controls shown for that row, or ask an authorised owner in the same branch. | | An activity row does not show **Open** or **Delete**. | These actions are unavailable for that row; **Delete** is limited to the current owner. | Use the controls shown for that row. | | Task deletion displays `This record is related to saved data and cannot be deleted`. | The record is related to saved data. | Keep the record and use its available follow-up action instead of deleting it. | | The message **Action not allowed** appears. | The requested activity action is refused. | Check the activity's branch and your access before trying the available control again. | | The message **Your request was completed successfully** appears. | The activity-list request completed successfully. | Continue with the updated list or select **Open** if it appears for the affected activity. | | A list remains on a loading indicator while changing filters. | The list is still refreshing. | Wait for the list to finish loading before interpreting its rows. | Work from the controls and rows actually present on screen. ## What to do next After you review a list, choose the page that owns the next piece of work. | Your next goal | Continue with | |---|---| | Record a new task | [Create a task](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-task) | | Record a Visit, Meeting, or Call | [Create an activity](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-activity) | | Change an activity from **Due** or **Overdue** to **Done** | [Activity status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/activity-status) | | Reverse a completed activity | [Activity status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/activity-status) | | Cancel or undo cancellation on an activity | [Activity status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/activity-status) | | Work from the broader personal workspace | [My Desk tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-tasks) or [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities) | The create pages own the task and activity fields and save actions. The activity-status page owns record-level status actions. The My Desk pages own the broader personal task and activity workspace. This page owns the standalone list review. # Create a task ## What a task is A task is a record of follow-up work that you need to track. Record a task when you have work to do later and need a dated item with an owner, an assignee, a status, or related follow-up. Create and handle these records in the Tasks flow: use the new-task form to create one, then open the saved task for its tabs and status actions. | If you need to… | Go to | |---|---| | Enter follow-up work for the first time | [Enter task details](#enter-task-details) | | Commit a new task | [Save the task](#save-the-task) | | Open a task that already exists | [Find a task](#find-a-task) | | Use tabs, status actions, or activity options on a saved task | [Handle saved-task options](#handle-saved-task-options) | | Continue in the wider task workspace | [Continue after saving](#continue-after-saving) | | Work with the task and activity lists together | [Tasks and activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/tasks-and-activities) | | Change an activity's status | [Activity status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/activity-status) | | Create a Visit, Meeting, or Call | [Create an activity](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-activity) | | Work from the personal task workspace | [My Desk tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-tasks) | | Work from the personal activity workspace | [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities) | | Work with tasks embedded in a sales job | [Sales-job comments and tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-comments-and-tasks) | The task list and new-task form are separate surfaces. Open the task list to find existing work, open the new-task form to record work, or open a saved task to continue working with it. ![The task form with its fields and save actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/a12f6a4952cfcb9e993b1a675ff1f957.png) ## Before you start You need a signed-in account and a subscription that includes the task form. The form is available only when the task data is present and the subscription condition allows it. Leaving the new-task screen is protected while you are entering a task. Collect the task purpose, description if one is needed, start date, due date, priority choice, and assignee choice before you begin. Priority choices come from the priorities available to your account. Assignee choices come from the users available for the relevant branch. The labels and initial values for **Priority** and **Assign To** depend on those returned choices. The form provides **Owner**, **Assignee**, and **Tags** as display information. **Reminder** belongs to a saved task rather than a new unsaved task. On the task form, **Start Date** and **Due Date** carry required markers. The other visible fields do not carry required markers on this form, although the form's validation rules still define **Priority** and **Task Purpose** as required when you save. ## Find a task Choose the entry point that matches the work you need to do. | If you need to… | Open | |---|---| | Record work that does not yet have a task record | The new-task form | | Reopen saved work or choose a task row for a later action | The task list | ### Open a new task **Prerequisites** - You are signed in. - The task form is available for your subscription. **Steps** 1. Open the new-task form. 2. Confirm that **Task Purpose**, **Priority**, **Description**, **Start Date**, **Due Date**, **Task Progress**, and **Assign To** are visible. ![The new-task form with its visible fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/19e9b452b3ad706562e085a46a333f39.png) **Result:** The new-task form is open and ready for task details. The form shows the **Save** and **Save and Close** actions. ### Locate an existing task **Prerequisites** - You are signed in. - You know enough about the task to recognise its row. **Steps** 1. Open the task list. 2. Select the view that matches the work you need to find. | If you need to see… | Select | |---|---| | Every available task | **All** | | Tasks assigned to you | **My Tasks** | | Completed tasks | **View completed tasks** | 3. Match the row using the visible columns **Title**, **Owner**, **Start date**, **Due date**, **Status**, and **Importance**. 4. Open the task row you need. ![The task list with its filters and visible columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/734e469dca731d0a178c8957e1da75a5.png) **Result:** The selected saved task is open. For a new task, continue with [Enter task details](#enter-task-details). For a saved task, continue with [Handle saved-task options](#handle-saved-task-options). ## Enter task details Enter the information that identifies the follow-up work and places it on the right dates. The available choices for **Priority** and **Assign To** come from your account and branch data, so use the choices that appear in your form. ### Complete the task form **Prerequisites** - The new-task form is open. - You have the task purpose and its start and due dates. **Steps** 1. In **Task Purpose**, enter the work you need to follow up. 2. In **Priority**, select an available priority. 3. In **Description**, enter supporting details when they are needed. 4. In **Start Date**, enter the date on which the task starts. 5. In **Due Date**, enter the date by which the task is due. 6. In **Task Progress**, review the progress shown for the task. 7. In **Assign To**, select the available assignee when the task must be given to another available user. 8. Review the **Owner**, **Assignee**, and **Tags** information shown on the form. **Result:** The task form contains the available task information and is ready for [saving](#save-the-task). ## Save the task Saving commits the task after the form validates it. The save controls are available for a new task when the current account is the owner; they are also available for an accepted, owned saved task. **Prerequisites** - The task form is open. - The current account is allowed to save the task. **Steps** 1. Enter all values required by the form. 2. Select **Save** when you want to save the task and remain on the task. 3. Select **Save and Close** when you want to save the task and close the form. | Choice | Use it when you need to… | |---|---| | **Save** | Continue working with the saved task | | **Save and Close** | Leave the task form after saving | 4. If validation displays a message, correct the named field and select the save control again. **Result:** A successful save displays `Data saved Successfully`. A new task saved from the new-task form opens in the saved task view. If the save cannot complete, the form displays `Error Saving Registration`. ## Handle saved-task options A saved task is the version that has a task ID and can expose task tabs and status actions. The options depend on the task's status, ownership, parent-task relationship, branch, and whether the task is complete. ### Use the saved-task controls **Prerequisites** - A saved task is open. - You know whether the task is yours and whether it is complete, overdue, or due to start. **Steps** 1. Select the status action that matches the task's current condition. | If the task… | Select | |---|---| | Is assigned to you and has not already been accepted | **Accept** | | Is assigned to you and you do not accept it | **Decline** | | Is overdue or due to start and the work is complete | **Consider As Complete** | | Is completed and needs to return to an incomplete state | **Consider As Not Completed** | 2. Select the saved-task tab that matches the work you need. | If you need to work with… | Select | |---|---| | Child tasks on a saved root task | **Sub-tasks** | | Related activities | **Activities** | | Comments | **Comments** | | Attached files | **Attachment** | | Change history | **Last Modifications** | 3. In **Activities**, select **Meeting**, **Visit**, or **Call** when the task is in the same branch and is not completed. ![The saved-task action area and task tabs](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/19e9b452b3ad706562e085a46a333f39.png) **Result:** The selected status, saved-task tab, or activity option is open when its ownership, status, parent-task, and branch conditions allow it. Accepting a task displays `You accepted the assigned task`. Declining it displays `You declined the assigned task`. ## Fix task-entry problems Use the message on screen to identify whether the form needs a value, the task owner must take the action, or the list action is blocked. | What you see | What it means | What to do | |---|---|---| | `Priority is required` | The form has no accepted priority value. | Select a value in **Priority**, then save again. | | `Title is required` | The task purpose is empty. | Enter the task purpose in **Task Purpose**, then save again. | | `Start Date is required` | The start date is empty. | Enter **Start Date**, then save again. | | `Due Date is required` | The due date is empty. | Enter **Due Date**, then save again. | | `Only task owner can take that action` | The current account cannot perform that status action. | Have the task owner perform the action. | | `An error occurred while processing your request` | Accept or decline did not complete. | Check the task assignment and select the action again when appropriate. | | `Error Saving Registration` | The save error path was reached. | Review the task values and select **Save** or **Save and Close** again. | | `This record is related to saved data and cannot be deleted` | The related task cannot be deleted from the list. | Keep the related record and use its owning workflow instead. | | `Error while deleting task` | The delete operation did not complete. | Do not rely on deletion; reopen the row and review its available actions. | | `You declined the assigned task` | The assigned task was declined. | Review the assignment before continuing. | | `Task deleted successfully` | The task was deleted. | Return to the task list and locate the remaining work. | | `Forbidden characters detected. Please remove them and try again.` | An activity contains forbidden characters. | Remove the characters and try the activity entry again. | | `Action not allowed` | The requested activity action is unavailable. | Continue from the activity page that owns the action. | | `This action is only allowed if you belong to that branch` | The activity action requires branch membership. | Use an account that belongs to the task's branch. | | `One topic and at least one note is required` | The activity needs a topic and a note. | Enter one topic and at least one note on the activity page. | | `There is no topic to print` | The activity has no topic available for printing. | Add a topic before printing the activity. | | `You already have a contact with this name` | The contact name already exists. | Use the existing contact or enter a different name on the contact page. | | `Just '_'‘-''.' And '&' Characters Accepted` | The file or library name contains unsupported characters. | Use only the accepted characters in the file or library page. | | `Your request was completed successfully` | A file or library request completed. | Continue from the file or library page. | The task list shows **All**, **My Tasks**, and **View completed tasks**. It does not show a following filter tab or a filter text field. The task form does not provide a usable **Follow** control, and its header does not provide **Attachments**, **Sub-tasks**, or **Activity** controls; use the saved-task tabs instead. The task-list grid is drawn from the selected list layout. | Visible task-list column | |---| | **Title** | | **Owner** | | **Start date** | | **Due date** | | **Status** | | **Importance** | **Export** is not shown on the task list, so use the controls that are actually shown on your list rather than relying on a hidden Export action. The available priority and assignee choices, editable defaults, and some saved-task states depend on returned account, branch, and task data. Server-side authorization and server-side validation are handled outside the task form's visible rules. ## Continue after saving After saving, continue from the saved task according to the work you need to do: use its conditional tabs for task-related work, or move to the registered page that owns the wider activity, workspace, or embedded-record operation. **Prerequisites** - You have saved a task or opened an existing task. **Steps** 1. In the saved-task tab row, select **Sub-tasks**, **Activities**, **Comments**, **Attachment**, or **Last Modifications**. | If you need to… | Select or open | |---|---| | Work with child tasks on a root task | **Sub-tasks** | | Work with related activities | **Activities** | | Review comments, attachments, or change history | **Comments**, **Attachment**, or **Last Modifications** | | Create a Visit, Meeting, or Call in the same branch before the task is complete | **Meeting**, **Visit**, or **Call** | | Follow activity status transitions | [Activity status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/activity-status) | | Create a Visit, Meeting, or Call | [Create an activity](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-activity) | | Work from the personal task workspace | [My Desk tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-tasks) | | Work from the personal activity workspace | [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities) | | Work with tasks embedded in a sales job | [Sales-job comments and tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-comments-and-tasks) | **Result:** You are on the saved-task tab or registered follow-up page that owns the next piece of work. # Activity status Use this page to find an activity, read its status, and choose a status action when the activity record offers one. ## Activity status at a glance An activity status tells you where an activity sits in its follow-up flow. The Activities list and the activity record show the status, using **Planned**, **Due**, **Overdue**, **Done**, or **Cancelled**. The date-driven part of the flow is: ```mermaid flowchart LR Planned --> Due: date is due Due --> Overdue: end date has passed Due --> Done: Done Overdue --> Done: Done Planned --> Cancelled: Cancel This Activity Due --> Cancelled: Cancel This Activity Overdue --> Cancelled: Cancel This Activity Done --> Planned: Consider As Not Done Cancelled --> Planned: Undo Cancellation ``` The date checks place an activity in **Planned** before its start date, **Due** from its start date through its end date, and **Overdue** after its end date. **Done** records completed work, while **Cancelled** records an activity that has been cancelled. | If you need to… | Go to | | --- | --- | | Find an activity by type or include archived activities | [Find an activity](#find-an-activity) | | Identify the status in the list and understand the visible columns | [Understand the activity status screen](#understand-the-activity-status-screen) | | Decide whether the date or completion branch applies | [Choose the applicable status branch](#choose-the-applicable-status-branch) | | Use a status action on an activity record | [Change an activity status](#change-an-activity-status) | | Resolve a refused action or list message | [When a status change goes wrong](#when-a-status-change-goes-wrong) | | Work with the wider activity list | [Tasks and activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/tasks-and-activities) | | Create an activity | [Create an activity](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-activity) | | Work from the wider My Desk activity workspace | [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities) | ## Before you change a status The activity type selects the activity record surface, and the current status determines which branch and actions can apply. **Prerequisites** - Open an existing activity record. - Identify the activity type shown by the record surface. The activity record uses separate surfaces for visits, meetings, and calls. - Check whether the record is editable. **Cancel This Activity** and **Undo Cancellation** require editing to be allowed. - Check the activity's start and end dates when deciding between **Planned**, **Due**, and **Overdue**. The status action is not a list-entry field. In the Activities list, the **Status** cell displays the record's current status. The action itself belongs to the activity record surface and is conditional on the record's type, status, and editing access. If the record is not open, continue with [Find an activity](#find-an-activity). ## Find an activity The Activities list is the workspace for locating an activity and reading its current status. Use the activity-type filters when the list is broad. Include archived activities when the activity is no longer in the current list. **Prerequisites** - Be signed in to the application. **Steps** 1. Open the Activities list. ![Activities list with the activity filters and Status column](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/90feabfc14a9fee5228cbbd9bc9abc01.png) 2. Select the activity filter and archive option that match the activity. | If you need to see… | Select | | --- | --- | | Every activity type | **All** | | Visits | **Visits** | | Email activities | **Email** | | Meetings | **Meetings** | | Calls | **Call** | | Archived activities | **Show archived activities** | ![Activities list with archived activities included](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e118776f3e027299ebd7b7b0b5efb4e9.png) 3. Select the matching row's **Call**, **Visit**, **Mail**, or **Meeting** control. Choose the control that matches the activity type you want to open. **Result:** The matching activity record is open. Continue with [Understand the activity status screen](#understand-the-activity-status-screen). ## Understand the activity status screen The activity status screen has two surfaces: the Activities list, where you recognise the status in a row, and the activity record, where the activity type determines the record surface and its available status actions. The displayed list columns come from the selected list layout. The grid displays these columns: | Column | What to use it for | | --- | --- | | **Title** | Match the activity. | | **Visitors** | Recognise the people associated with the row. | | **Activity purpose** | Read the purpose for the row. | | **Company** | Match the associated company. | | **Start date** | Check the displayed start date and time. | | **Status** | Read **Planned**, **Due**, **Overdue**, **Done**, or **Cancelled**. | | **Importance** | Read the row's importance value. | The **Status** cell displays the status value; it is not a status-entry field in the list. The list also exposes **Refresh**, a button titled **table layout**, and **Settings**. Visit, meeting, and call records use separate activity-type surfaces. The status actions belong to those record surfaces rather than to the list row. Continue with [Choose the applicable status branch](#choose-the-applicable-status-branch) to identify the action for the current record. ## Choose the applicable status branch Choose a date branch when you are checking the activity's time position. Choose a record-action branch when you are completing, reopening, cancelling, or restoring an activity. **Prerequisites** - Open an existing visit, call, or meeting activity record. - Identify the current status before selecting an action. **Steps** 1. Read the activity's start and end dates. 2. Choose the row that matches the activity's dates, status, and editing access. | Check the activity | Applicable status or action | | --- | --- | | Today is before the start date | **Planned** | | Today is on or after the start date and on or before the end date | **Due** | | Today is after the end date | **Overdue** | | The activity is due or overdue and you are completing it | **Done** | | The activity is done and you are reopening its work | **Consider As Not Done** | | The activity is planned, due, or overdue and editing is allowed | **Cancel This Activity** | | The activity is cancelled and editing is allowed | **Undo Cancellation** | The activity type matters for the completion branches: **Done** and **Consider As Not Done** are provided on visit, call, and meeting records. The cancellation actions apply only to **Planned**, **Due**, and **Overdue** activities, and also depend on editing access. **Result:** You have identified the status branch and the action to use on the activity record. Continue with [Change an activity status](#change-an-activity-status). ## Change an activity status Use a status action on an existing visit, call, or meeting record when the record's current status and editing access meet the action's condition. **Prerequisites** - Open an existing visit, call, or meeting activity record. - Confirm that the record is editable when using a cancellation action. - Identify the current status before selecting an action. **Steps** 1. In the activity record, select the action identified in [Choose the applicable status branch](#choose-the-applicable-status-branch). 2. Read the **Status** value on the activity record after the action completes. ![Meetings activity list with the configured status column](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0490d7c66087de4daf726b47fe767327.png) **Result:** The activity record is ready for you to read the status value and continue with the applicable step in the follow-up flow. Continue with [When a status change goes wrong](#when-a-status-change-goes-wrong) if the action does not complete. ## When a status change goes wrong Use the message on screen to distinguish an activity-record condition from a list or request problem. | What you see | What it means | What to do | | --- | --- | --- | | `This action is only allowed if you belong to that branch` | The activity action is restricted to the applicable branch. | Return to the activity record and check the current status, activity type, and editing access. | | `One topic and at least one note is required` | The completion path requires a topic and at least one note. | Add the required topic and note before completing the activity. | | `There is no topic to print` | The activity has no topic available for printing. | Return to the activity record and work from the activity details. | | `An error occurred while processing your request` | The activity request did not complete. | Check the activity record and repeat the applicable action when the record is available. | | `Your request was completed successfully` | The activity-list request completed successfully. | Continue with the list or open the relevant activity row. | | `Forbidden characters detected. Please remove them and try again.` | The activity-list request contains forbidden characters. | Remove the forbidden characters and submit the list request again. | | `Action not allowed` | The activity-list action is not allowed in the current list condition. | Return to the list and choose an allowed activity-list action. | Use a status action only when the matching control is present on the activity record. Use the **Status** column for status recognition in the list; use the activity record for the status action. After resolving the message, return to [Change an activity status](#change-an-activity-status) or continue to [After checking or changing a status](#after-checking-or-changing-a-status). ## After checking or changing a status After checking a status, return to the Activities list when you need to review more rows. The list provides the activity-type filters, the **Show archived activities** option, and the **Status** column for that review. After a status action, read the activity record's **Status** value before continuing. For activity creation, continue with [Create an activity](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-activity). For broader work in the activity workspace, continue with [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities). For shared list orientation and list-level work, continue with [Tasks and activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/tasks-and-activities). # Create an activity An activity is the record you create for a **Visit**, **Meeting**, or **Call**. Choose the type that matches the work you need to record, then complete its activity-specific form. | If you need to… | Go to | |---|---| | Record a visit with dates, a destination, and visit details | [Visit fields](#visit-fields) | | Record a meeting with dates, a location, and participants | [Meeting fields](#meeting-fields) | | Record a call with a contact, call details, and a description | [Call fields](#call-fields) | | Choose between the two save controls | [Save the activity](#save-the-activity) | | Continue with status actions and saved-record tools | [After creating the activity](#after-creating-the-activity) | The new-activity menu contains **Visit**, **Meeting**, and **Call**. Email is not available in this menu. Activities use the statuses **Planned**, **Overdue**, **Done**, **Due**, and **Cancelled**. ```mermaid flowchart LR New[New activity] --> Visit[Visit] New --> Meeting[Meeting] New --> Call[Call] Visit --> Planned[Planned] Meeting --> Planned Call --> Planned ``` ## Before you start You need a signed-in session that can open the new activity page. Decide whether to create a **Visit**, **Meeting**, or **Call**. The activity form shows its subscribed surface when the subscription includes the activity feature. If the subscription does not include it, the page shows the upgrade surface instead. The **Save** and **Save and Close** choices require an activity record, an available subscription, and a new non-mail activity form. Collect the information that belongs to the activity type before opening the form. | Activity type | Have this information ready | Why it matters | |---|---|---| | Visit | Start and end dates, destination, visit type, purpose, and participants | These values describe where the visit takes place, when it takes place, and who takes part. | | Meeting | Start and end dates, location, participants, and meeting purpose | These values identify the meeting and its participants. | | Call | Start date, contact, call use, call number, and description | These values identify the call and preserve its purpose and detail. | ## Find the activity form Prerequisites - You are signed in. - Your subscription includes the activity surface. - You know whether you are creating a Visit, Meeting, or Call. Steps 1. Select **Add new** for the activity type you want to create. | Activity type | Select | |---|---| | Visit | **Visit** | | Meeting | **Meeting** | | Call | **Call** | **Result:** The new form for the selected activity type is on screen. Continue with [Understand the activity form](#understand-the-activity-form). For list entry points and activity filters, see [Tasks and activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/tasks-and-activities). ## Understand the activity form The new activity form shares **Save** and **Save and Close** across Visit, Meeting, and Call. The selected activity branch changes the fields shown below these controls. The selected branch remains the basis for the activity-specific fields you complete. Review the fields for the selected branch before entering the activity details. | Branch | Fields shown on the new form | Required markers shown on this form | |---|---|---| | Visit | **Visit Purpose**, **To**, **Start Date**, **End Date**, **Visit type** | **Start Date** and **End Date** | | Meeting | **Meeting Purpose**, **Location**, **Start Date**, **End Date** | **Start Date** and **End Date** | | Call | **Call Purpose**, **Call To**, **Call Use**, **Call Number**, **Start Date**, **Description** | **Start Date** | The form also contains activity-specific or conditional surfaces. **Tags**, **Visitors**, **Discussion partner**, **Participant**, **Show only for Participant**, **Prevent other participants to make changes**, **Prepared By**, and **Signature** can appear as labels or in a branch rather than as labelled widgets. > **Note:** Required markers apply only to the forms where they appear. After an activity ID exists, **Attachment** and **Last Modifications** are available under their record conditions. **Last Modifications** is excluded for mail. Continue with the section for the selected activity type. ![The Meeting form with its shared and meeting-specific fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e5ec791902e284fd516a37a69bcc6d7e.png) ### Visit fields A Visit is the activity branch for visit-specific details such as a destination, visitors, or a discussion partner. Prerequisites - You opened the new Visit form. - You have the visit dates and the visit information to enter. Steps 1. In **Visit Purpose**, choose the purpose for the visit. 2. In **To**, choose or enter the destination. 3. In **Start Date**, enter the visit start date. 4. In **End Date**, enter the visit end date. 5. In **Visit type**, choose the visit type. 6. If the form shows them, complete **Tags**, **Visitors**, and **Discussion partner**. 7. If the form shows **Prevent other participants to make changes**, select its checkbox when that restriction applies. **Result:** The Visit form contains the visit purpose, destination, required dates, and any visit choices and participants you entered. Continue with [Controls on a new activity](#controls-on-a-new-activity). ![The Visit fields including the required start and end dates](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/68b0ed36b0486d2aa7d7aad6b60de746.png) ### Meeting fields A Meeting is the activity branch for meeting-specific details such as a location and participants. Prerequisites - You opened the new Meeting form. - You have the meeting dates, location, purpose, and participant information to enter. Steps 1. In **Meeting Purpose**, choose the purpose for the meeting. 2. In **Location**, choose the meeting location. 3. In **Start Date**, enter the meeting start date. 4. In **End Date**, enter the meeting end date. 5. If the form shows **Participant**, choose the people taking part. 6. If the form shows **Show only for Participant**, select its checkbox when the meeting must be limited to the selected participant. 7. If the form shows **Prevent other participants to make changes**, select its checkbox when that restriction applies. **Result:** The Meeting form contains the meeting purpose, location, required dates, and any participants and meeting options you entered. Continue with [Controls on a new activity](#controls-on-a-new-activity). ### Call fields A Call is the activity branch for call-specific details such as a contact, call use, and call details. Prerequisites - You opened the new Call form. - You have the call date, contact, call use, call number, and description to enter. Steps 1. In **Call Purpose**, choose the purpose for the call. 2. In **Call To**, choose the contact or user for the call. 3. In **Call Use**, choose the use of the call. 4. In **Call Number**, choose the call number. 5. In **Start Date**, enter the call start date. 6. In **Description**, enter the call details. 7. If the form shows **Tags**, choose the tags for the call. **Result:** The Call form contains the required start date and any call details, contact choice, and description you entered. Continue with [Controls on a new activity](#controls-on-a-new-activity). ![The Call fields including Call Use, Call Number, and Description](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/bb49658d64271aa87e0a9f698c1411fe.png) ### Controls on a new activity Before an activity ID exists, the shared controls on the new form are **Save** and **Save and Close**. After an activity ID exists, the record can expose **Attachment** and **Last Modifications**. Existing records can also show status actions. | Control or surface | When it applies | What it is for | |---|---|---| | **Save** | On the new activity form when the subscription is available | Save the activity while remaining on the activity form. | | **Save and Close** | On the new activity form when the subscription is available | Save the activity and close the activity form. | | **Attachment** | When an activity ID exists | Open the attachment area for the saved activity. | | **Last Modifications** | When an activity ID exists, except for mail | Open the activity audit-log area. | The status actions **Done**, **Consider As Not Done**, **Cancel This Activity**, and **Undo Cancellation** belong to existing Meeting, Visit, or Call records under their status conditions. Continue with [Save the activity](#save-the-activity). ## Enter the activity details Required markers appear on **Start Date** and **End Date** for Visit and Meeting, and on **Start Date** for Call. Other controls do not show a required marker. **Note:** Required markers apply only to the forms listed here. Prerequisites - You opened the new form for the correct activity type. - You have the dates, choices, participants, and free text for that activity. Steps 1. Select the activity branch you need. | If you are recording… | Complete these fields | |---|---| | A Visit | **Visit Purpose**, **To**, **Start Date**, **End Date**, and **Visit type** | | A Meeting | **Meeting Purpose**, **Location**, **Start Date**, and **End Date** | | A Call | **Call Purpose**, **Call To**, **Call Use**, **Call Number**, **Start Date**, and **Description** | 2. Enter the required dates for the selected branch. 3. Choose the activity-specific options and participants that apply. 4. Enter free text in **Description** when you are recording a Call. 5. Review the visible required markers before selecting a save control. **Result:** The selected activity form contains the activity details supported by its visible fields, without relying on an assumed default value. ## Save the activity Prerequisites - You completed the fields for the selected activity type. - The form shows **Save** and **Save and Close**. Steps 1. Select the control that matches the result you want. | Result | Control | |---|---| | Remain on the activity form | **Save** | | Close the activity form after saving | **Save and Close** | Select **Save** when you need to continue working on the activity form. **Result:** The activity is saved using the selected control. Continue with [When activity creation goes wrong](#when-activity-creation-goes-wrong) if the screen displays an error; otherwise continue with [After creating the activity](#after-creating-the-activity). ## When activity creation goes wrong Use the message on screen to identify the branch or condition that stopped the action. | What you see | What it means | What to do | |---|---|---| | `This action is only allowed if you belong to that branch` | The action is restricted to members of the relevant branch. | Use the activity route and branch available to you. | | `One topic and at least one note is required` | The topic action requires one topic and at least one note. | Add the required topic and note before using that action. | | `There is no topic to print` | There is no topic available for the print action. | Use the print action only when a topic exists. | | `An error occurred while processing your request` | The request could not be processed. | Check the action and the information on the form before trying again. | The following messages belong to related contact, file, library, and task workflows: | Message | Related workflow | |---|---| | `You already have a contact with this name` | Contact creation | | `Your request was completed successfully` | File or library maintenance | | `Just '_'‘-''.' And '&' Characters Accepted` | File or library maintenance | | `This record is related to saved data and cannot be deleted` | Task or file deletion | | `Forbidden characters detected. Please remove them and try again.` | Task maintenance | | `Action not allowed` | Task maintenance | The activity branch changes with the route value. A Visit form has **End Date**; a Meeting form has **End Date**; the Call form does not have an **End Date** control. **Attachment** and **Last Modifications** depend on an activity ID, so they are not new-form controls. Continue with [After creating the activity](#after-creating-the-activity). ## After creating the activity Use the saved record's available controls for its status actions. For record-level status actions, see [Activity status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/activity-status). For the broader personal activity workspace, see [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities). Return to [Tasks and activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/tasks-and-activities) for the activity list and its activity work. # Contacts ## What Contacts is for Contacts is the shared relationship-information list for the people your organisation works with. Open it from the **Contacts** menu entry to find a contact, start contact creation, or open a saved contact record. | If you need to… | Go to | |---|---| | Find the shared Contacts list | [Understand the Contacts list](#understand-the-contacts-list) | | Open a new-contact form or locate the new contact | [Create a contact](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-contact) | | Review a saved contact record | [Contact record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contact-record) | | Review contacts associated with a saved sales job | [Contacts, L/Gs, and Last Modifications on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-contacts-guarantees-and-history) | ## Before you start The list is available only when the Contacts module is included in your subscription and a saved list layout is available for the data grid. The controls also depend on your permissions and on the branch that owns a row. | Before list work | What it controls | |---|---| | The Contacts module is included in your subscription | The Contacts list is available instead of the subscription-upgrade surface. | | A saved list layout is available | The data grid appears with its configured columns. | | Permission to create contacts | **New** appears. | | Permission to export list data | **Export** is enabled. | | Permission to delete contacts and a row from your branch | The row's delete action is available. | | A row from your branch | Selecting a data cell can open the contact edit page. | ## Find the Contacts list Use the list when you need the shared view rather than a contact's detail page. **Prerequisites** - The subscription, list layout, and access conditions in [Before you start](#before-you-start) are in place. **Steps** 1. Open the application menu. 2. Select **Contacts**. 3. Confirm that the page heading is **Contacts** and that a list is visible. ![The Contacts heading, list, and visible list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3066016f5a358653370bcf3745063cb7.png) **Result:** The **Contacts** list is open. ## Understand the Contacts list The list gives you a shared view of contact relationships. Its headers and display settings come from your organisation's saved layout. One fixed column identifies the contact with its avatar or identifier. The remaining columns come from the saved layout, which supplies each column's caption, visibility, data type, filtering, and width. The current list shows these columns: | Current column | What you use it to read | |---|---| | **Title** | The contact's title. | | **Name** | The contact's name. | | **Position** | The contact's position. | | **Department** | The contact's department. | | **Account** | The related account. | | **Branch** | The contact's branch. | The list has a filter row and header-filter behaviour for narrowing the displayed rows. The screen does not show a search panel, and the column chooser is disabled. The visible list tools are **New**, **Refresh**, **Table Layout**, and **Settings**. The new-contact popup is a separate surface, not an additional set of list columns. ![The current Contacts columns and list tools](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3066016f5a358653370bcf3745063cb7.png) ## Choose the next Contacts action Select the action that matches your contact task. **Prerequisites** - The Contacts list is open. **Steps** 1. Select the action that matches your task. | If you need to… | Select or do this | What opens or happens | |---|---|---| | Start a contact | Select **New** | The new-contact popup opens. | | Open an existing contact | Select a data cell in a same-branch row | The contact edit page opens. | | Prepare list data for export | Select **Export** | Export choices open. | | Close export choices | Select **Cancel** in the export modal | The export modal closes. | | Remove a same-branch contact | Select the row's delete action, then **Delete** | `Are you sure you want to delete this contact?` appears; after a successful delete, the grid reloads. | | Stop a deletion | Select **Cancel** in the deletion confirmation | The deletion confirmation closes. | ![The new-contact popup opened from the Contacts list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e4c61681c88201597ed68654a24f309d.png) ![The export surface with its list export choices](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/bd8de3fea2dade1273ae8141e4339adf.png) **Caution:** Deleting a contact changes the shared Contacts list. Select **Cancel** instead when you do not intend to remove the row. **Result:** The selected contact page or modal opens. When export choices or deletion confirmation close, you return to the Contacts list. ## When a Contacts action is unavailable The list and its actions change with subscription, layout, permission, and branch conditions. | What you see | Condition that explains it | |---|---| | A subscription-upgrade surface replaces the Contacts list | The Contacts module is not included in the subscription. | | The data grid is absent | No saved list layout is available. | | **New** is absent | Your account does not have permission to create contacts. | | **Export** is unavailable | Your account does not have permission to export list data. | | A row delete action is unavailable | You do not have delete permission, or the row belongs to a different branch. | | Open the contact edit page | Select a data cell in a same-branch row. | ## When a list action goes wrong If the list shows this message, remove the forbidden characters and repeat the list action: `Forbidden characters detected. Please remove them and try again.` Continue on the contact page when the problem concerns the record itself. | If the problem concerns… | Continue on… | |---|---| | A duplicate contact name | [Contact record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contact-record) | | Saving a contact record | [Contact record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contact-record) | | Contact permission during record work | [Contact record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contact-record) | | An invalid email address | [Contact record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contact-record) | | A contact-record success message | [Contact record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contact-record) | ## What to do next From the **Contacts** menu entry, use [Create a contact](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-contact) to create or locate a contact. Use [Contact record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contact-record) to review a saved contact record. For contacts connected to a saved sales job, use [Contacts, L/Gs, and Last Modifications on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-contacts-guarantees-and-history). # Create a contact Use this page to locate an existing contact or enter a new person's information and connect that person to an account. ## Create and locate a contact A contact is a person record that your organisation can connect to an account. Use the **Contacts** workflow to locate an existing person or open the new-contact form. | If you need to… | Go to | |---|---| | Open the list and locate an existing contact | [Contacts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contacts-overview) and then [Find a contact](#find-a-contact) | | Start a new contact | [Enter contact details](#enter-contact-details) | | Understand the main contact fields | [Understand the contact information](#understand-the-contact-information) | | Review or maintain a saved contact | [Contact record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contact-record) | | Review the account connected to a contact | [Accounts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/accounts) | | Manage files attached to a saved contact | [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) | Open the Contacts list from the **Contacts** area. From that list, use **New** when you have permission to create a contact, or open an existing contact from the list. ## Before you start The Contacts subscription must be included before the contact form is available. Your permission to create a contact controls whether **New** appears. Prepare the person's identity and the account to which the person belongs before you save. | Prepare | Why it matters | |---|---| | Contacts subscription included | The Contacts workflow and its form are available. | | Permission to create a contact | **New** is available when the permission allows it. | | Contact name | **Name** is required before save. | | Related account | **Account** is required before save. | | Editable form | **Contact Details** is available only when the form is not read-only. | The account choices and initial field values depend on the account in use. Select from the account choices shown in **Account** rather than relying on a value from another account. ## Find a contact The Contacts list is the starting point for locating an existing contact or opening the new-contact flow. **Prerequisites** - The Contacts subscription is included. - You have permission to create a contact if you need **New**. **Steps** 1. Open the **Contacts** list. 2. Read the visible list headers. | Current column | Use it to read | |---|---| | **Title** | The contact's title. | | **Name** | The person's name. | | **Position** | The person's position. | | **Department** | The person's department. | | **Account** | The related account. | | **Branch** | The contact's branch. | 3. Choose one route. | If you need to… | Select or do this | |---|---| | Start a new contact | Select **New** when your permission allows it and the Contacts subscription is included. | | Locate an existing contact | Open the contact from the list. | ![The Contacts list with its current columns and list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3066016f5a358653370bcf3745063cb7.png) Additional columns can appear according to your selected list layout. Work from the headers visible in your list when those columns differ. **Result:** The Contacts list is on screen, and you have either opened the new-contact form or reached the existing contact you need. If you opened the form, continue with [Enter contact details](#enter-contact-details). ## Understand the contact information The new-contact form identifies a person and connects that person to an account. Its main fields are **Title**, **Name**, **Position**, **Department**, and **Account**. | Main field | Required marker on the new-contact form | What to enter or choose | |---|---:|---| | **Title** | No | The person's title. | | **Name** | Yes | The person's name. | | **Position** | No | The person's position. | | **Department** | No | The person's department. | | **Account** | Yes | The account connected to the person. | The editable form boundary includes **Contact Details**, which opens optional communication-detail choices. **Attachment** and **Last Modifications** belong to a saved contact: they require a saved contact ID and are absent for a new contact. ![The new-contact form with its main fields and required markers](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e4c61681c88201597ed68654a24f309d.png) Use this field reference when you complete the form in [Enter contact details](#enter-contact-details). ## Enter contact details Enter the person's identity and account first. Add only the communication details that apply to the contact. **Prerequisites** - The new-contact form is open. - The form is editable. - You know the contact's name and related account. **Steps** 1. Enter the person's title in **Title**, if applicable. 2. Enter the person's name in **Name**. 3. Enter the person's position in **Position**, if applicable. 4. Enter the person's department in **Department**, if applicable. 5. Select the related account in **Account**. 6. Select **Contact Details**. 7. Select each applicable communication choice. | Contact-detail choice | Rule | |---|---| | **Phone** | Maximum length 20. | | **Fax** | Maximum length 20. | | **Mobile** | Maximum length 20. | | **Email** | The value must pass email validation. | | **Website** | Enter the applicable website value. | | **Online Support** | Enter the applicable online-support value. | | **Comments** | Enter the applicable comments. | 8. Enter the value in each contact-detail field you selected. ![The seven choices opened from Contact Details](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/82d4f825aa6c5c4e91f4550243522e89.png) **Result:** The contact's main information is entered, and the applicable communication-detail fields are selected and available for values. ## Save the contact Save only after **Name** and **Account** are complete and the form passes its validation checks. **Prerequisites** - The form is editable. - **Name** has a value. - **Account** has a selected account. - The mandatory-field check passes. - The data validator is valid. **Steps** 1. Start the form exit flow after entering the contact information. 2. In the exit-form confirmation popup, choose the outcome that applies. | If you want to… | Select | |---|---| | Commit the contact | **Save** | | Leave without committing the changes | **Don't Save** | 3. After saving, check for `Contact saved successfully`. **Result:** A successful save reports `Contact saved successfully` and opens the saved contact record. Review the applicable surface variation, then continue with [After saving](#after-saving). ## Handle contact variations The contact surface changes according to subscription, permission, editability, and whether the contact already has an identifier. | Variation | What changes | |---|---| | New-contact access | **New** requires permission to create a contact and an included Contacts subscription. | | Read-only form | **Contact Details** is available only when the form is not read-only and the subscription is included. | | Saved contact | **Attachment** and **Last Modifications** require a saved contact ID and a non-popup form. | | Duplicate-name check | The form checks whether the contact name matches an existing contact. | | Account lookup | The choices shown depend on account data for the account in use; local-branch records are filtered. | If a variation prevents saving, use [When contact saving goes wrong](#when-contact-saving-goes-wrong). If saving succeeds, continue with [After saving](#after-saving). **Result:** You know which contact surface applies and where to go when the contact is saved or cannot be saved. ## When contact saving goes wrong Use the message on screen to choose the correction. | What you see | What to correct | |---|---| | `This Field Is Required` | Enter a value in the field marked as required. | | `Just '_'‘-''.' And '&' Characters Accepted` | Correct **Name** to use the accepted name characters. | | `Account field is mandatory` | Select an account in **Account**. | | `Please Solve the Following Issues :` | Resolve the listed validation issues before saving. | | `You already have a contact with this name` | Use a contact name that does not duplicate an existing contact. | | `Error: This Contact Name Already Exists` | Change **Name** and try the save again. | | `Error: Server Error` | Resolve the server problem before treating the contact as saved. | | `Email is invalid` | Correct the value in **Email**. | | `At least One Contact Detail is Required` | Select at least one choice from **Contact Details**. | | `At least One Contact Detail Must Have a Value` | Enter a value in at least one selected contact-detail field. | The following messages belong to related surfaces rather than this create-and-locate task: | Message | Related surface | |---|---| | `You already have account with this name` | Account popup. | | `Name is required` | New-account popup. | | `This field is required` | New-account or vendor popup. | | `Forbidden characters detected. Please remove them and try again.` | Contacts list action. | | `Error.. client not saved yet` | Account popup. | | `Error.. vendor not saved yet` | Vendor popup. | | `Your request was completed successfully` | Contact attachments or file library. | After correcting the displayed issue, return to [Save the contact](#save-the-contact). If the save succeeds, continue with [After saving](#after-saving). **Result:** The displayed issue is corrected, or the save problem is identified before you continue. ## After saving A saved contact has a contact ID that enables its saved-record surfaces. After saving, continue to the saved contact record. **Prerequisites** - The contact has been saved and has a contact ID. - The contact is open outside a popup. **Steps** 1. Open the saved contact record. 2. Select the saved-contact area that applies. | If you want to… | Select | |---|---| | Continue with the saved contact's attachments | **Attachment** | | Continue with the saved contact's change history | **Last Modifications** | Use [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) for attachment and file-library management. Use [Contact record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contact-record) for saved contact record maintenance. **Result:** A saved contact exposes **Attachment** and **Last Modifications** when its ID is present and the record is not in a popup. Related attachment work continues in [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files), and saved contact maintenance continues in [Contact record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contact-record). # Contact record A contact record stores the information your organisation uses to identify and communicate with a person. Use it to review the person's main information, add communication details, maintain the contact image, and review related record areas when they are available. ## Contact records at a glance The record belongs to the **Contacts** area, which is the starting point for finding an existing contact and opening its saved record. Its main information includes **Title**, **Name**, **Position**, **Department**, and **Account**. You can add communication fields through **Contact Details**, maintain the image, and use the saved-record tabs **Attachment** and **Last Modifications** when the record has an identifier and the form is not a popup. | If you need to… | Go to | |---|---| | Find an existing contact | [Contacts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contacts-overview) | | Open and interpret a saved contact record | [Understand the record information](#understand-the-record-information) | | Change contact information and remain on the record | [Edit and save contact information](#edit-and-save-contact-information) | | Add communication details or maintain the image | [Manage contact details and the image](#manage-contact-details-and-the-image) | | Review files linked to the record | [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) | | Create a contact instead of changing a saved record | [Create a contact](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-contact) | ## Before you open or change a record The contact identifier determines whether the form loads a saved record and whether the saved-record tabs are available. The subscription and editability state determine which parts of the surface you can use. | Condition | What you see or can do | |---|---| | The Contacts subscription is included | The contact form is available. | | The subscription does not include Contacts | A subscription-upgrade surface replaces the form. | | The saved contact identifier is absent or zero | The form initializes a new contact and loads the account lookup. | | The saved contact identifier is present | The saved contact loads and **Name** uses the saved-contact text field. | | The form is read-only | Editing controls are disabled or hidden. **Save**, **Save and Close**, and **Contact Details** are unavailable. | | The contact has no identifier, or the form is opened in a popup | **Attachment** and **Last Modifications** are unavailable. | Before changing a record, confirm that it is saved and editable, and that the contact name and account information are ready. Select an account from the choices shown by **Account**. ## Find and open a contact record The Contacts list is where you locate an existing contact before opening its saved record. After you open the record, review its fields before choosing the part of the record you need. **Prerequisites** - You are in the **Contacts** area. - The contact already exists as a saved record. **Steps** 1. In the Contacts work list, locate the saved contact you need to review. 2. Open the contact from the list. 3. Confirm that the contact-record surface shows **Title**, **Name**, **Position**, **Department**, and **Account**. **Result:** The saved contact record shows its contact fields and save controls. Continue with [Understand the record information](#understand-the-record-information) to interpret the fields. ## Understand the record information The main form identifies the contact and relates the person to an account. On a saved record, **Name** is shown as a text field. On a new contact, **Name** uses an autocomplete or text entry. | Field | Required marker on the main surface | Use | |---|---:|---| | **Title** | No | Enter the person's title. | | **Name** | Yes | Identify the contact. | | **Position** | No | Enter the person's position. | | **Department** | No | Enter the person's department. | | **Account** | Yes | Select the account related to the contact. | **Name** and **Account** show required markers on the main surface. **Title**, **Position**, and **Department** do not show required markers there. After reviewing these fields, continue with [Edit and save contact information](#edit-and-save-contact-information) when you need to change them. ![Required markers beside Name and Account on the main form](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/94c1eebee799640767cbb6035b23c1e0.png) ## Edit and save contact information After reviewing the fields, change the saved contact when needed. The next section covers communication details and the image. **Prerequisites** - The saved contact is open. - The form is editable. - **Name** and **Account** contain valid values. **Steps** 1. In the main form, change one or more of **Title**, **Name**, **Position**, **Department**, or **Account**. 2. If you changed **Name**, use a name that is not already assigned to another contact. 3. Select the save destination that matches your next task. | If you need to… | Select | |---|---| | Continue working on the record | **Save** | | Leave the record | **Save and Close** | 4. Check the result message before continuing. When the save succeeds, the page reports `Contact saved successfully`. The common completion message is `Your request was completed successfully`. If the save returns a server failure, the page reports `Error: Server Error`. If the name conflicts during save, it reports `Error: This Contact Name Already Exists`. ![Save and Save and Close actions on the contact record](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/94c1eebee799640767cbb6035b23c1e0.png) **Result:** **Save** leaves the saved contact open after the change. **Save and Close** saves the change and leaves the record. Continue with [Manage contact details and the image](#manage-contact-details-and-the-image) for communication fields or the image. ## Manage contact details and the image **Contact Details** adds communication fields to the contact form. The image actions belong to the record image area and depend on the image state. | Contact-detail choice | Result | |---|---| | **Phone** | Adds the corresponding communication field. | | **Fax** | Adds the corresponding communication field. | | **Mobile** | Adds the corresponding communication field. | | **Email** | Adds the corresponding communication field. | | **Website** | Adds the corresponding communication field. | | **Online Support** | Adds the corresponding communication field. | | **Comments** | Adds the corresponding communication field. | **Prerequisites** - The contact record is open. - The form is editable before adding a contact-detail field. **Steps** 1. Open **Contact Details**. 2. Select the communication field you need from the choices shown. 3. Enter the value in the field that appears. 4. If you enter **Phone**, **Fax**, or **Mobile**, use numeric keys; non-numeric keys are prevented. 5. If you enter **Email**, use an email value that passes the field's validation. 6. Choose the image action that matches the current image state. | If you need to… | Select | |---|---| | Add or replace the contact image | **Upload** | | Remove an existing contact image | **Delete contact image** | ![Contact Details choices and the added communication fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/35756628475b55a34bb550a56ba2ec13.png) > **Note:** **Delete contact image** is available only when the record has a non-placeholder image. **Result:** The selected communication field appears on the contact record, and the image action is available for the current image state. Continue with [Maintain the contact image](#maintain-the-contact-image) to add or remove an image, or with [Review attachments and change history](#review-attachments-and-change-history) to open a related record area. ### Maintain the contact image The contact image area provides **Upload** for an image file and **Delete contact image** when an image URL exists and the displayed image is not the placeholder image. **Prerequisites** - The contact record is open. - The form is editable. - For deletion, a non-placeholder contact image exists. **Steps** 1. To add or replace the contact image, select **Upload**. 2. Choose the image file in the file picker. 3. To remove an existing image, select **Delete contact image**. 4. Confirm the delete-image action in the confirmation modal. 5. Check for `Photo Deleted Successfully` after the deletion completes. The **Delete contact image** control is hidden when the image URL is empty or the displayed image is the placeholder image. **Result:** **Upload** uploads the selected contact image. After a completed deletion, the page reports `Photo Deleted Successfully`. ## Review attachments and change history After maintaining the contact information, use the saved-record tabs for related areas. **Attachment** is for attached files, and **Last Modifications** is for change history. **Prerequisites** - The contact is saved and has a contact identifier. - The record is open outside a popup. **Steps** 1. Select **Attachment** to open the attached-files area. 2. Select **Last Modifications** to open the change-history area. Use [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) for attached-file management. **Result:** The saved-record tabs are **Attachment** and **Last Modifications**. Continue with [When a contact record cannot be saved](#when-a-contact-record-cannot-be-saved) if a save problem needs correction. ## When a contact record cannot be saved Use the message on screen to match the problem to the correction. | What you see | Cause | Corrective action | |---|---|---| | `This field is required` | **Name** has no value. | Enter a contact name in **Name**. | | `Just '_'‘-''.' And '&' Characters Accepted` | The contact name contains a character outside the accepted name pattern. | Correct **Name** to use the accepted characters. | | `Account field is mandatory` | No account is selected. | Select an account in **Account**. | | `Email is invalid` | The value in **Email** fails email validation. | Correct the value in **Email**. | | `You already have a contact with this name` | The contact name matches an existing contact during name checking or save. | Enter a name that does not duplicate an existing contact. | | `Error: This Contact Name Already Exists` | The save returned a duplicate-contact error. | Change **Name**, then save again. | | `Error: Server Error` | The save returned a server error. | Do not treat the change as saved; resolve the server problem before saving again. | | The exit confirmation popup opens | The form has unsaved changes and you selected **Close**. | Follow the exit confirmation flow. | After correcting the value, return to [Edit and save contact information](#edit-and-save-contact-information). ### Out of scope These messages and surfaces belong to other pages or popups rather than the contact record's own contact-name and save flow. | Message | Owning page or surface | |---|---| | `You already have account with this name` | New-account popup | | `Error.. client not saved yet` | New-account popup | | `Error.. vendor not saved yet` | New-vendor popup | | `Just '_'‘-''.' And '&' Characters Accepted`; `Your request was completed successfully` | Library and file popup | ## Continue from the contact record After reviewing or changing a contact, choose the page that owns the next task. | Next need | Continue to | |---|---| | Find another existing contact | [Contacts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contacts-overview) | | Create a new contact | [Create a contact](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-contact) | | Review the account related to the contact | [Accounts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/accounts) | | Manage attached files | [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) | | Review change history | Select **Last Modifications** on a resolved saved contact record. | # Job Profitability Use **Job Profitability** to find a saved sales job, compare its profitability measures, and continue to the record page that owns related cost detail. ## Job Profitability at a glance **Job Profitability** is the place to compare one sales job's actual revenue, direct cost, gross profit, and gross margin. A profitability record is the saved job's detail view for these currency measures and the cost groups that explain them. **Purchasing Cost** groups purchase-order items. The additional-cost group contains cost transactions by cost type. | If you need to… | Go to | |---|---| | Choose a status list and find a saved job | [Review the Job Profitability list](#review-the-job-profitability-list) | | Open one saved job's profitability record | [Find a job and open its profitability view](#find-a-job-and-open-its-profitability-view) | | Compare currency-specific measures | [Review profitability and cost summaries](#review-profitability-and-cost-summaries) | | Understand why a tab or detail row appears | [Handle conditional tabs and detail rows](#handle-conditional-tabs-and-detail-rows) | | Enter or allocate a direct-cost transaction | [Cost transactions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/cost-transactions) | | Read the wider sales-job context | [Sales job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-record) | | Review the profitability record's fields and detail groups | [Job Profitability record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/job-profitability-record) | ![Identify the Job Profitability status tabs, columns, and list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c8298ff2bab32fba1e46134e12c5c2ad.png) ## Before you start Job Profitability lists are available only when the relevant subscription and access conditions are in place. The list is for saved-job work; use it to review an existing sales job rather than create the job itself. | Check | What must be true | Why it matters | |---|---|---| | Subscription | Job Profitability is included in the subscription | The Job-costing list and its tabs are shown. | | Subscription state | Job Profitability is not included | The subscription-upgrade surface is shown instead of the list. | | Saved job | The sales job has already been saved | The list locates saved job work and leads to its profitability detail. | | Page state | The Job Profitability page is available | A page-not-found state does not provide the list work area. | | Access | Your account has the required Job Profitability access | The related work can stop with `You don’t have permission`. | The default list opens with **Running Jobs**. Use the status tabs to move to another list view. ## Review the Job Profitability list The Job Profitability list groups saved jobs by work status. **Running Jobs** and **Delivered Jobs** are the two top-level tabs. When **Delivered Jobs** is selected, its secondary choices are **All**, **Awaiting Payment**, and **Paid**. Your selected list layout determines which columns appear. The nine available columns are: | First column | Second column | Third column | |---|---|---| | **Job No.** | `Gross Margin (€)` | `Gross Margin (ج.م.‏)` | | `Total Direct Cost (€)` | `Purchase Cost (€)` | `Purchase Cost (ج.م.‏)` | | `Other Direct Cost (€)` | `Sales price (€)` | **Client** | > **Note:** Read the headers visible in your list. A saved list layout controls which columns > appear, so another layout can present a different set of headers. The visible list controls are **Refresh**, **table layout**, and **Settings**. ![Identify the Running Jobs tab and the visible profitability columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6858c836ace471ed031c73815695525d.png) Choose the list that contains the saved job: | Select | List | |---|---| | **Running Jobs** | The running-job list | | **Delivered Jobs** | The delivered-job list | | **All** | The delivered-jobs group, with all delivered jobs | | **Awaiting Payment** | The delivered jobs awaiting payment | | **Paid** | The delivered jobs marked paid | ![Identify the Delivered Jobs choices All, Awaiting Payment, and Paid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6331ce50e43d450ec02cf1e6679b2faa.png) ## Find a job and open its profitability view Use the list choice that contains the saved sales job you want to inspect. **Prerequisites** - The Job Profitability subscription is included. - You can open the Job Profitability list. - You know which saved sales job you need to review. **Steps** 1. Select the list that contains the job. | Job location | Select | |---|---| | Running-job group | **Running Jobs** | | Delivered-job group, all delivered jobs | **Delivered Jobs**, then **All** | | Delivered jobs awaiting payment | **Delivered Jobs**, then **Awaiting Payment** | | Delivered jobs marked paid | **Delivered Jobs**, then **Paid** | 2. Locate the saved job from the visible row columns, including **Job No.**, **Client**, and any profitability columns in your selected layout. 3. Select the row's available edit or open action. 4. If you use the context menu, open the row only when it belongs to the same branch. **Result:** The saved job's profitability record opens. Continue with [Review profitability and cost summaries](#review-profitability-and-cost-summaries). ## Review profitability and cost summaries Choose a currency view, then compare the values shown for the same measures in that currency. | Currency view | Measures to compare | |---|---| | **Reference Currency** | **Actual Revenue**, **Actual Direct Cost**, **Gross profit**, and **Gross margin** | | **Local currency** | **Actual Revenue**, **Actual Direct Cost**, **Gross profit**, and **Gross margin** | The summary separates the two cost explanations: | Group | What it contains | |---|---| | **Purchasing Cost** | Purchase-order items | | Additional-cost group | Cost transactions grouped by cost type | Use these measures to compare what the job earned with the direct cost assigned to it. Continue cost-transaction entry or allocation on [Cost transactions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/cost-transactions), and review the detailed profitability view on [Job Profitability record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/job-profitability-record). ## Handle conditional tabs and detail rows Visible areas change according to the selected status, currency, list layout, number of cost items, and whether editing is allowed. | Surface | It appears when… | |---|---| | Secondary status tabs | **Delivered Jobs**, **Awaiting Payment**, or **Paid** is selected | | Job list grid | **Running Jobs**, **Delivered Jobs**, **Awaiting Payment**, or **Paid** is selected and a selected list layout exists | | Currency measures | The selected currency matches the relevant reference or local currency | | Purchase-order detail | The purchase-item group is expanded | | Additional-cost detail | The cost contains more than one item and its detail is not collapsed | | Direct-cost area | Editing is allowed | **Prerequisites** - You have opened the status list or profitability record you need to inspect. - For detail work, you can identify the purchase order or cost transaction. **Steps** 1. Select the status or detail surface that matches your task. | If you need to… | Select | |---|---| | Show delivered-job status choices | **Delivered Jobs** | | Change the delivered-job list | **All**, **Awaiting Payment**, or **Paid** | | Read measures in another currency | The available currency choice | | Expand or collapse purchase-order items | **POs** in **Purchasing Cost** | | Start direct-cost work | **Direct Cost**, when editing is allowed | 2. Select the order row to display its items or products. 3. Select the purchase-order rows you need to add them to allocation. 4. In the additional-cost group, select the cost group when it contains more than one item and its detail is collapsed. 5. Select the additional-cost row to recalculate the allocation. **Result:** The list shows the selected status group, and the profitability record shows the currency measures and cost detail available for its conditions. Continue detailed entry and allocation work on [Cost transactions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/cost-transactions). ## When validation or access goes wrong Use the exact message to choose the next safe action. Messages from the direct-cost editor and allocation work belong on [Cost transactions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/cost-transactions), not on the list procedure. | What you see | What to do | |---|---| | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the value and repeat the action. | | `NO Data to Export` | Open the list's settings surface, confirm that **Export** is available, and use it only when the list has data to export. | | `Are you sure you want to Delete this transaction ?` | Stop and confirm that the transaction is the one you intend to delete before selecting the confirmation control. | | `Your request was completed successfully` | Continue after confirming that the requested operation completed. | | `An error occurred while processing your request` | Recheck the record and continue on the owning detail page. | | `You don’t have permission` | Continue with an account that has the required access. | Select **Settings** to find **Export**. ## Out of scope The Job Profitability list covers status selection and saved-job list review. It does not provide the detailed editor surfaces below. | Boundary | Use instead | |---|---| | No direct-cost transactions tab | Use [Cost transactions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/cost-transactions) for direct-cost entry and allocation. | | Grid captions are selected by the saved layout | Read the headers visible in your list. | | Direct-cost editor validation and allocation messages | Continue with [Cost transactions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/cost-transactions). | | Account, contact, file, and address messages | Continue with the owning account, contact, file, or address page. | ## Continue with the detailed work Choose the page that owns the next task. | If you need to… | Continue with | |---|---| | Choose **Running Jobs**, **Delivered Jobs**, **All**, **Awaiting Payment**, or **Paid** | **Job Profitability** on this page | | Review one job's currency measures and profitability detail | [Job Profitability record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/job-profitability-record) | | Enter a direct-cost transaction or manage allocation records | [Cost transactions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/cost-transactions) | | Read the job's wider sales, stage, and related-work context | [Sales job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-record) | # Job Profitability record ## Job Profitability records A Job Profitability record is the surface for comparing one sales job's actual revenue, direct cost, gross profit, and gross margin. Use the summary first, then inspect **Purchasing Cost** for purchase-order items and Additional Cost for cost transactions grouped by cost type. | If you need to… | Go to | |---|---| | Check the job's sales price, direct cost, gross profit, or gross margin | [Read the financial summary](#read-the-financial-summary) | | Review purchase-order items | [Inspect order and direct-cost detail](#inspect-order-and-direct-cost-detail) | | Review additional cost transactions | [Inspect order and direct-cost detail](#inspect-order-and-direct-cost-detail) | | Understand why a measure or detail row is shown differently | [Handle conditional detail](#handle-conditional-detail) | | Find the list that leads to a record | [Find and open a Job Profitability record](#find-and-open-a-job-profitability-record) | | Enter a direct-cost transaction | Cost transactions | | Choose among Job Profitability list tabs | Job Profitability | | Read the wider sales-job context | [Sales job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-record) | ![Running Jobs list with the profitability columns and list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c8298ff2bab32fba1e46134e12c5c2ad.png) ## Before you start The Job Profitability surface appears only when the subscription, page state, sales job, selected work area, and access conditions allow it. Its record form requires **Client** and **Job Title**. Before opening the surface, have the following in place: | Check | What must be true | Why it matters | |---|---|---| | Subscription | Your subscription grants Job Profitability access | Job Profitability does not appear when the subscription excludes it. | | Page state | The page loads as a record page, not a not-found page | A not-found page does not render the record surface. | | Sales job | A sales job with an identifier is available | The embedded record area requires the job identifier. | | Work area | The sales job is on the Job Costing work area | The embedded record is shown for the active Job Costing tab. | | Access | Your access allows Job Profitability work | The embedded area checks the Job Profitability permission before appearing. | | Record information | The sales job has **Client** and **Job Title** values | Both fields are required by the record form. | The routed record requires signed-in access, and leaving the form is guarded when the page has changes that need protection. ## Find and open a Job Profitability record Use a Job Profitability list to choose a profitability view, or use the direct-cost transaction list when your next task is a cost transaction. The **Running Jobs** list is the running-job view for this work. **Prerequisites** - You have the access, subscription, and saved sales-job conditions in [Before you start](#before-you-start). - You know which saved sales job you need to review. **Steps** 1. Choose the list that matches your next task. | If you need to… | Choose | |---|---| | Compare profitability for a job | Job Profitability | | Work with a direct-cost transaction | Cost transactions | 2. Open the **Running Jobs** list. 3. Use the visible list controls as needed: **Refresh**, **Table Layout**, or **Settings**. 4. Identify the job from the visible columns, including **Job No.**, Gross Margin (€), Gross Margin (ج.م.‏), Total Direct Cost (€), Purchase Cost (€), Purchase Cost (ج.م.‏), Other Direct Cost (€), Sales price (€), and Client. 5. Open the row using its available open control. **Result:** The **Running Jobs** list is on screen with its listed columns and controls. ## Read the financial summary The financial summary shows four profitability measures for the currency selected on the record. Select **Reference Currency** or **Local currency** to compare the same measures in either currency view. | Currency view | Measures | |---|---| | **Reference Currency** | **Sales Price**, **Actual Direct Cost**, **Gross profit**, **Gross margin** | | **Local currency** | **Sales Price**, **Actual Direct Cost**, **Gross profit**, **Gross margin** | The metric controls are disabled and read-only. Read the values shown for the selected currency rather than entering replacement figures. **Actual Revenue** is not shown in the record summary. After opening the record, use the selected currency view to read its measures. ## Inspect order and direct-cost detail The detail area separates committed purchasing from other direct costs. The **Purchasing Cost** group contains purchase-order items. The Additional Cost group contains cost transactions grouped by cost type. **Prerequisites** - You have opened the Job Profitability surface for a sales job. - You can identify the purchase order or cost transaction you need to inspect. **Steps** 1. In the **Purchasing Cost** group, select **POs** to expand the purchase items. 2. Select the purchase-order number to open the procurement edit page in a new window. 3. In the Additional Cost group, select the cost group row to show its transaction detail when the group has more than one item. 4. Select the transaction number to open the cost-transaction edit page in a new window. 5. If editing is allowed, select **Direct Cost** to start the additional-cost action. **Result:** You can distinguish purchase-order items from additional-cost transactions, and the selected purchase order or transaction opens in its owning page. ## Handle conditional detail The record can show different currency measures and detail rows because each area is conditional. Check the applicable condition before interpreting a missing measure or row. | Area | It appears when… | |---|---| | Reference-currency measures | The selected currency matches the branch's currency. | | Local-currency measures | The selected currency matches the local currency. | | Purchase-order detail | The purchase-item group is expanded. | | Additional-cost detail | The cost has more than one item and its detail is not collapsed. | | **Direct Cost** | Editing is allowed. | Select **POs** to expand or collapse purchase items. Additional-cost visibility is controlled by the cost group's collapsed state when it contains more than one item. ## When validation or access goes wrong Use the message text to identify whether the form needs a value, rejects characters, or does not allow the requested operation. Then apply the matching fix in the table. | What you see | What to do | |---|---| | `Validation errors:` | Review the fields highlighted by the validation summary. | | `This Field Is Required` | Enter the required value before continuing. | | `Input contains forbidden characters(< , >). Please remove them and try again.` | Remove the forbidden characters and enter the value again. | | `You don’t have permission` | Continue only with an account that has the required access. | ### Direct-cost messages The **Direct Cost** hand-off can raise the following validation messages. The complete entry procedure belongs to Cost transactions; use these messages to recognise the problem before continuing there. | Message | Check | |---|---| | `Please select at least one order.` | Select an order. | | `Please select at least one item/product.` | Select an item or product. | | `Please enter the percentage value or delete unused items.` | Enter the percentage or remove unused items. | | `Please adjust cost allocation.` | Adjust the allocation. | | `Please enter valid amount.` | Enter a valid amount. | | `Please choose cost type.` | Choose a cost type. | | `Please choose provider.` | Choose a provider. | | `Please enter Transaction Title.` | Enter the transaction title. | | `Please choose payment due date.` | Choose the payment due date. | | `Just '-' '_' and '.' are the only characters that are accepted.` | Use only the accepted characters in that field. | | `Your request was completed successfully` | The direct-cost request completed successfully. | | `An error occurred while processing your request` | The direct-cost request encountered an error. | ## Continue with the detailed work Use the owning pages for work that goes beyond reading this record. **Cost transactions** owns direct-cost transaction entry and allocation records. **Job Profitability** owns the profitability list tabs and list selection. Use [Sales job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-record) when you need the broader sales-job context; it is an optional related-work hand-off from this page. # Cost transactions Use this page to find a cost transaction, enter its details, distribute its amount across order lines, and save it for the Job Profitability flow. ## Cost transactions A cost transaction is a payable cost associated with one or more order lines. A sales-order allocation assigns it to sales-order lines; a purchase-order allocation assigns it to purchase-order lines. In Job Profitability, the cost-transaction surface sits beside the Profitability view. The two allocation directions are: | Allocation direction | Use it for | | --- | --- | | Sales-order allocation | Assigning a cost to sales-order lines. | | Purchase-order allocation | Assigning a cost to purchase-order lines. | The flow is organised around the transaction and the order lines that receive its amount: ```mermaid flowchart LR C[Cost transaction] --> S[Sales-order lines] C --> P[Purchase-order lines] S --> J[Job Profitability] P --> J ``` | If you need to… | Go to | | --- | --- | | Understand the surrounding Job Profitability record | The Job Profitability record page | | Find a cost transaction or choose an allocation route | [Find or start a cost transaction](#find-or-start-a-cost-transaction) | | Enter the transaction identity and amount | [Enter the transaction details](#enter-the-transaction-details) | | Choose order lines and distribute the cost | [Allocate the order lines](#allocate-the-order-lines) | | Check, remove, or save an allocation | [Review, remove, and save the allocation](#review-remove-and-save-the-allocation) | | Understand a validation message | [When validation stops the save](#when-validation-stops-the-save) | | Continue from a saved record | [After saving](#after-saving) | | Work with sales-order records and lines | The Sales job record page | | Work with purchase-order records and lines | The Purchase job record page | | Work with payable filters after saving | The Payables page | ## Before you start Have the following ready before you enter or edit a cost transaction. | What you need | What to check | Why it matters | | --- | --- | --- | | Subscription | The cost-transaction feature is included in your subscription. | The cost-transaction body and its actions depend on the subscription. | | Page access | The cost-transaction page is available. | The transaction body is shown only when the page is available. | | Record | A cost-transaction record exists when you are editing rather than creating. | The detail fields and saved-record tabs use that record. | | Editing permission | You can edit the transaction. | **Save**, **Save and Close**, and allocation deletion depend on editing permission. | | Order | A sales order or purchase order is available for the route you choose. | The order supplies the lines that receive the cost. | | Provider | The provider exists as an account. | **Provider** selects from the available Accounts records. | | Transaction information | The cost type, title, amount, invoice date, provider, invoice number, and comment. | These values identify the cost and support later review. | The five required fields are **Cost Type**, **Transaction Title**, **Amount**, **Invoice Date**, and **Provider**. Prepare the information for all five before you begin. The sales-order route uses **Sales Order**. The purchase-order route uses **Purchase Order (PO)**. The order and provider values are loaded from your available records, so select the record that matches the invoice or supporting business document. ## Find or start a cost transaction Use the cost-transaction list to review existing records or open the allocation route that matches the order you need to charge. **Prerequisites** - You have the order and transaction information listed in [Before you start](#before-you-start). - You know whether the cost belongs to a sales order or a purchase order. **Steps** 1. Open the cost-transaction list from the Payables area. 2. Select **All**, **Payable**, or **Paid** to filter the list. 3. Compare the displayed row with your invoice. 4. Open the route that matches your task. | If you need to… | Open | | --- | --- | | Enter a cost for sales-order lines | Sales-order allocation surface | | Enter a cost for purchase-order lines | Purchase-order allocation surface | | Edit a saved cost transaction | Saved cost-transaction surface | ![Use the filters and column headers to find an existing cost transaction.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/988927b2e699a8d110394021d12d8f4c.png) **Result:** The list or the selected cost-transaction surface is on screen. Continue with [Enter the transaction details](#enter-the-transaction-details) when you are entering a new transaction. ## Enter the transaction details Enter the information that identifies the payable cost before distributing its amount across order lines. **Prerequisites** - You have opened a sales-order or purchase-order allocation surface. - You have the cost type, title, amount, invoice date, provider, and any invoice number or comment. **Steps** 1. In **Cost Type**, select the cost type that matches the invoice. Available choices include **Documentations and Certificates**, **Freight**, **Packing**, **Transportation and Logistics**, **Custom Fees**, **Customs Clearence**, **Bank fees**, **Withholding Tax**, **Currency cost**, **Others**, **warranty**, and **LG fees**. 2. In **Cost Classification**, use the classification shown for the cost. The classification values are **Inbound Cost**, **Inventory Handling Cost**, and **Delivery Cost**; the entry surface presents **Additional Landed Cost** and **Delivery Costs** as its visible choices. 3. In **Transaction Title**, enter a title that identifies the transaction. 4. In **Amount**, enter the cost in the branch currency used by the transaction. 5. In **Invoice Date**, enter the invoice date. 6. In **Invoice No.**, enter the invoice number when one is available. 7. In **Provider**, select the account that issued the cost. 8. In **Comment**, enter any context that colleagues need when reviewing the transaction. ![Review the transaction fields before selecting sales-order lines.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/741bc812a9dc02499a2f67eb5f16c48b.png) The sales-order and purchase-order routes use the same transaction fields. Keep the title, amount, date, and provider aligned with the invoice so the saved cost remains identifiable when the list is filtered later. > **Note:** The complete Provider, Sales Order, and Purchase Order values come from your > available records. Select the record that matches the transaction rather than relying on a > remembered value. **Result:** The transaction information is entered. Continue with [Allocate the order lines](#allocate-the-order-lines). ## Allocate the order lines Choose the order lines that receive the transaction and select how to distribute the amount. **Prerequisites** - The transaction details are entered. - You have opened the correct allocation route. **Steps** 1. In **Sales Order**, select the sales order when you are allocating a sales-order cost. 2. In **Purchase Order (PO)**, select the purchase order when you are allocating a purchase-order cost. 3. Select **Items** to open the relevant order-line selection. 4. Select the order lines that receive the cost. 5. Select an **Allocation Method** when more than one allocation detail is present. | Allocation Method | Use it when | | --- | --- | | **Manual** | You need to enter each allocation percentage and amount yourself. | | **Equal Split** | You want the transaction distributed equally across the selected lines. | | **Sales price** | You want the distribution based on sales price. | 6. Review the line information in the grid. Both allocation grids include **Item No.**, **Item Price (EUR)**, an allocation percentage, and **Allocation Amount**. The remaining columns depend on the allocation route: | Route | Additional columns | | --- | --- | | Sales-order allocation | **Vendor Order No.**, **Job No.**, **Job Title** | | Purchase-order allocation | **PO No.**, **Package No**, **Package Title** | 7. If **Manual** is selected, enter the manual allocation values. | For each allocation row, enter… | In | | --- | --- | | The allocation percentage | **Allocation percentage** | | The allocation amount | **Allocation amount** | An allocation row accepts a minimum value of `0` for both **Allocation percentage** and **Allocation amount**. Those two values are disabled unless **Manual** is the selected allocation method. The **Items** surface is shown after an order is selected. ![Compare the purchase-order columns and allocation values.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/bbf0872dfe84f72e17edc7ac721008fa.png) **Result:** The selected order lines appear in the allocation grid with a distribution method and allocation values ready for review. Continue with [Review, remove, and save the allocation](#review-remove-and-save-the-allocation). ## Review, remove, and save the allocation Review the allocation before saving the transaction. Remove a row only when the allocation can be deleted and you have editing permission. **Prerequisites** - At least one order line is selected. - The transaction details and allocation values are entered. - You have editing permission. **Steps** 1. Review the allocation rows and check that the selected lines and amounts match the invoice. 2. Select the **Delete icon** for an unwanted allocation row. 3. At the confirmation prompt `Are you sure deleting this item?`, choose what to do. | If you want to… | Select | | --- | --- | | Keep the row | **No** | | Delete the row | **Yes** | 4. Choose a save action. | If you want to… | Select | | --- | --- | | Save the transaction and remain on the page | **Save** | | Save the transaction and request to leave the page | **Save and Close** | 5. Confirm the message `Your request was completed successfully` after a successful save. 6. If `An error occurred while processing your request` appears, correct the transaction or allocation values, then select **Save** or **Save and Close** again. **Save** and **Save and Close** are available on a standalone page when editing mode is off, the subscription includes the feature, and editing is allowed. The **Delete icon** is available when the allocation is deletable and editing is allowed. **Result:** The transaction is saved and a success message confirms completion. If the save-error message appeared, the corrected values are resubmitted. With **Save and Close**, the page also requests leaving the transaction surface. Continue with [After saving](#after-saving). ## When validation stops the save When the form stops a save, match the exact message to the value or selection that needs correction before selecting **Save** or **Save and Close** again. | Message | Corrective action | | --- | --- | | `Please Solve the Following Issues :` | Read the messages listed with the validation result and correct each named field or allocation. | | `Please select at least one order.` | Select a sales order or purchase order. | | `Please select at least one item/product.` | Select at least one item or product in **Items**. | | `Please enter the percentage value or delete unused items.` | Enter the allocation percentage for each used row or remove the unused row. | | `Please adjust cost allocation.` | Adjust the allocation values to match the transaction amount. | | `Please enter valid amount.` | Correct **Amount** and enter a valid value. | | `Please choose cost type.` | Select **Cost Type**. | | `Please choose provider.` | Select **Provider**. | | `Please enter Transaction Title.` | Enter **Transaction Title**. | | `Please choose payment due date.` | Enter **Invoice Date**. | | `Just '-' '_' and '.' are the only characters that are accepted.` | Remove characters that are not accepted from the affected text value. | | `This Field Is Required` | Complete the field marked as required. | | `Just '_' '-' And '.' Characters Accepted` | Keep only the accepted characters in the affected value. | | `Input contains forbidden characters(< , >). Please remove them and try again.` | Remove `<` and `>` from the affected value. | | `The total must equal 100%` | Adjust the allocation percentages until the total is 100%. | | `An error occurred while processing your request` | Correct the transaction or allocation values, then select **Save** or **Save and Close** again. | The form validates before it sends the save request. Return to [Review, remove, and save the allocation](#review-remove-and-save-the-allocation) after you correct a validation issue. ### Out of scope messages The following messages belong to shared panels or other pages, not to the cost-transaction save and validation flow. | Owning page or panel | Class | Message | | --- | --- | --- | | Account details | successMessages | Your request was completed successfully | | Account details | errorMessages | An account with this name already exists | | Account details | errorMessages | An error occurred while processing your request | | Account details | errorMessages | Error: Vendor not saved yet | | Account details | errorMessages | Error: Client not saved yet | | Account details | errorMessages | This Field Is Required | | Attached documents | successMessages | Your request was completed successfully | | Attached documents | errorMessages | An account with this name already exists | | Attached documents | errorMessages | An error occurred while processing your request | | Attached documents | errorMessages | Error: Vendor not saved yet | | Attached documents | errorMessages | Error: Client not saved yet | | Attached documents | errorMessages | This Field Is Required | | Addresses | successMessages | Your request was completed successfully | | Addresses | errorMessages | An account with this name already exists | | Addresses | errorMessages | An error occurred while processing your request | | Addresses | errorMessages | Error: Vendor not saved yet | | Addresses | errorMessages | Error: Client not saved yet | | Addresses | errorMessages | This Field Is Required | | Address | successMessages | Your request was completed successfully | | Address | errorMessages | An account with this name already exists | | Address | errorMessages | An error occurred while processing your request | | Address | errorMessages | Error: Vendor not saved yet | | Address | errorMessages | Error: Client not saved yet | | Address | errorMessages | This Field Is Required | | Comments | successMessages | Your request was completed successfully | | Comments | errorMessages | An account with this name already exists | | Comments | errorMessages | An error occurred while processing your request | | Comments | errorMessages | Error: Vendor not saved yet | | Comments | errorMessages | Error: Client not saved yet | | Comments | errorMessages | This Field Is Required | | Avatar | successMessages | Your request was completed successfully | | Avatar | errorMessages | An account with this name already exists | | Avatar | errorMessages | An error occurred while processing your request | | Avatar | errorMessages | Error: Vendor not saved yet | | Avatar | errorMessages | Error: Client not saved yet | | Avatar | errorMessages | This Field Is Required | | Decreased table | successMessages | Your request was completed successfully | | Decreased table | errorMessages | An account with this name already exists | | Decreased table | errorMessages | An error occurred while processing your request | | Decreased table | errorMessages | Error: Vendor not saved yet | | Decreased table | errorMessages | Error: Client not saved yet | | Decreased table | errorMessages | This Field Is Required | | Not-found page | successMessages | Your request was completed successfully | | Not-found page | errorMessages | An account with this name already exists | | Not-found page | errorMessages | An error occurred while processing your request | | Not-found page | errorMessages | Error: Vendor not saved yet | | Not-found page | errorMessages | Error: Client not saved yet | | Not-found page | errorMessages | This Field Is Required | | Upload logo | successMessages | Your request was completed successfully | | Upload logo | errorMessages | An account with this name already exists | | Upload logo | errorMessages | An error occurred while processing your request | | Upload logo | errorMessages | Error: Vendor not saved yet | | Upload logo | errorMessages | Error: Client not saved yet | | Upload logo | errorMessages | This Field Is Required | The following messages are emitted by related pages or panels. Use the owning page or panel when one of these messages appears: | Owning page or panel | Message | | --- | --- | | Payables list | `Forbidden characters detected. Please remove them and try again.` | | Contacts | `You already have a contact with this name` | | Sales-job screen | `Required Receiving Date` | | Sales-job screen | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | | Sales-job screen | `Invalid input. Please enter a non-negative value` | | Sales-job screen | `Custom fields saved successfully` | | Sales-job screen | `Job updated successfully` | | Sales-job screen | `Job deleted successfully` | | Sales-job screen | `Job regretted successfully` | | Sales-job screen | `Job cancelled successfully` | | Sales-job screen | `Job missed successfully` | | Sales-job screen | `Job reactivated successfully` | | Sales-job screen | `Converted to offer successfully` | | Sales-job screen | `Converted to inquiry successfully` | | Sales-job screen | `Error saving custom fields` | | Sales-job screen | `Cannot be un-delivered — a due invoice already exists` | | Sales-job screen | `All offers must be in draft status to revert to inquiry` | | Sales-job screen | `A project with this name already exists` | | Sales-job screen | `Please save opened inquiry first` | | Sales-job screen | `All inquiries must be in draft stage to revert to potential` | | Offer panel | `Please save opened cost sheet first` | | Payment milestone | `Please save opened cost sheet first` | | Bill of materials | `Booked quantity for this job is greater than the required BOM quantity` | | Bill of materials | `You cannot edit or delete the product after the purchase package is created` | | Bill of materials | `Cannot be deleted. Product is in purchasing` | | Bill of materials | `You cannot edit the product after the PO is created` | | Products list | `This product is already included in BOM` | | Products details | `The first variant cannot be deleted` | | Products details | `An error occurred while connecting to your CRM system.` | | Products details | `Please select one product` | | MRQ details | `You cannot save without adding at least one product` | | Tasks | `This record is related to saved data and cannot be deleted` | | Activities | `Action not allowed` | | Purchasing details | `Please enter at least one email` | | Purchasing details | `Inquiry must have at least one item` | | Purchasing details | `Offer must have at least one item` | | Purchasing details | `Order must have at least one item` | | Purchasing details | `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | | Purchasing details | `Please select one or more items to create a RFQ.` | | Deliveries and orders | `Error loading accounts` | | Serial combinations | `Serial you have entered already exist and belong to same manufacturer` | | Serial combinations | `There is error in serial you have entered` | | Serial combinations | `Minimum: At least one serial` | | L/G details | `Please Add Extension to activate the LG` | | L/G details | `LG has one or more extensions or deductions and cannot be reverted to the requested stage` | | L/G details | `Please choose a date after the current expiry date` | | Activity panels | `One topic and at least one note is required` | | Activity panels | `Please enter action for each milstone` | | Activity panels | `Required Receiving After` | | Purchasing details | `Package must have at least one item` | | Purchasing details | `Required Offer Type` | | Purchasing details | `Required Bid Due Date` | | Payments | `Forbidden characters detected. Please remove them and try again.` | ## After saving A saved cost transaction is the record you use to review the allocation and continue into payment work. **Prerequisites** - You have selected **Save** or **Save and Close**. - The transaction is saved. **Steps** 1. Open the saved cost-transaction record. 2. Select **Payments** when the transaction is saved. 3. In the Payments surface, use **All**, **Payable**, **Paid**, **Upcoming**, **Not completely Allocated**, or **Completely Allocated** to filter payment records. 4. Select the new-payment icon when the transaction is saved, **Payments** is active, and the record is not totally paid. **Result:** The saved cost-transaction record is on screen, and its **Payments** surface and available payment filters can be used when their record conditions are met. The surrounding Job Profitability views remain available from the Job Profitability area. # Products Use this page to find a product, record its reusable item information, and review a saved product's details. ## Products at a glance A product is a reusable item record that you select when other PAMS work asks for a product. The **Products** list is where you find item records, and the product record is where you enter or review one item. | If you need to… | Go to | |---|---| | Find an existing item or open a new record | [Find a product](#find-a-product) | | Understand the columns and controls in the item list | [Read the Products list](#read-the-products-list) | | Enter or change the item information | [Create or update a product](#create-or-update-a-product) | | Review comments, suppliers, stock, variants, files, or history | [Manage product details](#manage-product-details) | | Add components to an assembled item | [Add components to an assembled product](#add-components-to-an-assembled-product) | | Resolve a product message | [When a product action fails](#when-a-product-action-fails) | | Maintain product types, files, or stock-related work | [What to do next](#what-to-do-next) | Record each product with the name, units, description, withdrawal choice, and valuation that belong to that item. ![The Products list with its product rows and visible columns.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/52ef1d61b718866aec3c5d900b9d3ca1.png) ## Before you start Before you look for or record a product, confirm the following conditions. | Have or know | Why it matters | |---|---| | Access to the Products area | The list opens only when the application grants access to the list. | | A subscription that includes product creation | **New** is available only when the subscription is included, the list is open, and its data is loaded. | | The saved product you want to review | **Comments**, **Sub-suppliers**, **Stock Details**, and **Last Modifications** belong to an existing product record. | | The item's identifying and commercial information | The record asks for a name, category, group, sales unit, purchase unit, description, withdrawal option, and valuation. | | The product type options you need | Product Type options are maintained on [Warehouse products types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-purchasing-product-types), not on this page. | The available option values for **Product Type**, **Group**, units, **Product Withdrawal**, and **Product Valuation** depend on the lists available to the form. Select from the values shown in your product record rather than assuming that another product's options are available. ## Find a product The Products list is the starting point for opening an existing item record or the form for a new one. **Prerequisites** - You have access to the Products area. - The product list can load its data. **Steps** 1. Open **Products**. ![The Products list after it opens, with product rows visible.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/1e9057ba06e362efb3df8794d04de228.png) 2. Choose the route that matches your task. | If you need to… | Select | |---|---| | Open an existing item | Select the product row you need. | | Start a product record | Select **New**. | 3. If the list requires fresh data, select **Reload data**. 4. If you opened a new record, continue with [Create or update a product](#create-or-update-a-product). **Result:** The Products list is open with product rows, an existing product record is open, or the new-product surface is open. The new-product surface shows the product fields and save controls. ## Read the Products list The Products list is a row-based view of reusable item records. Read the headers that are actually visible in your list because the list layout determines which columns it draws. The Products list shows these seven columns in this order: | Order | Column | |---:|---| | 1 | **Product** | | 2 | **Description** | | 3 | **Category** | | 4 | **Group** | | 5 | **Withdrawal** | | 6 | **Valuation** | | 7 | **Internal product no.** | The list also shows three titled icon buttons. | Visible control | Use | |---|---| | **Refresh** | Refresh the list view. | | **Table Layout** | Work with the list layout. | | **Settings** | Open the list settings surface. | **Steps** 1. Choose the list action that matches your task. | If you need to… | Select or use | |---|---| | Change the layout | **Table Layout**, then **Columns Chooser** or **Expand column width**. | | Show or hide list grouping or filters | **Filter Row** or **Group Panel**. | | Export the list | **Export**. | **Result:** The list uses the selected layout or filter settings, or the selected export option is open. ### Export the list 1. Select **Export**. 2. In the **Exporting List:** dialog, choose the format. 3. Select **Export**. **Result:** The selected list format export starts. Your list can instead use **Internal Product No.**, **Product Type**, **Group**, **Sales Unit**, **Purchase Unit Of Measure**, **Weight (kg)**, **Volume (m3)**, **Barecode**, **External product id**, **Description**, **Product Withdrawal**, and **Product Valuation**. Use the headers on your screen when identifying a row. The selected layout determines the columns shown. ## Create or update a product The product record holds the reusable item's identifying, unit, description, withdrawal, and valuation information. Use the new-product form to create a record or the same surface to change an existing item where editing is allowed. **Prerequisites** - You are on the new-product surface or an editable product record. - You have the item's name, category, group, sales unit, purchase unit, description, withdrawal choice, and valuation information. **Steps** 1. Enter the item name in **Name**. 2. Select the item's category in **Category**. 3. Select the item's group in **Group**. 4. Select the sales unit in **Sales Unit**. 5. Select the purchasing unit in **Purchase Unit Of Measure**. 6. Enter the item description in **Description**. 7. Select the withdrawal option in **Product Withdrawal**. 8. Complete **Product Valuation** when it is available on your form. 9. Enter **Internal Product No.**, **Weight (kg)**, **Volume (m3)**, **Barecode**, or **External product id** when those details apply to the item. 10. Choose the save route. | If you need to… | Select | |---|---| | Save the product and remain on the record | **Save** | | Save the product and leave the record | **Save and Close** | **Result:** The product surface contains the entered fields and the selected save controls. ![The new-product form with its required fields and save controls.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c82be608bc78cab07042e7514c0fa3aa.png) ## Manage product details A saved product record groups related information in tabs and detail surfaces. Use the surface that matches the information you need to review. | Detail you need | Select or use | |---|---| | Product comments | **Comments** | | Products from other accounts | **Sub-suppliers**; the sub-supplier selection comes from account records. See [Accounts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/accounts). | | Warehouse quantities and stock thresholds | **Stock Details**; see [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow). | | Changes made to the record | **Last Modifications** | | Product variants | **Variants** when that saved-record surface is available. | | Product files and attachments | Use the shared file surface; see [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files). | **Comments**, **Sub-suppliers**, **Stock Details**, and **Last Modifications** require an existing product record. **Stock Details** covers quantities by warehouse, including stock, committed quantities, quantities on the way, and minimum quantities. The detail form also contains fields for variant, stock-detail, and sub-supplier surfaces, including **Name**, **Description**, **Inventory**, **Branch**, **Min. Stock Qty.**, **Min. Requisition Qty.**, **Sub-supplier**, **Country**, **Identification No.**, **Weight (kg)**, **Short Description**, and **Material Description** where their respective surface is available. The shared file surface carries **Library name**, **File Name**, **Links**, and **Comment**. Use [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) for file upload, download, linking, renaming, and tag management. ## Add components to an assembled product A bill of material is the list of component products that make up an assembled product. Selecting the assembled group exposes the **Bill of Material** surface on the product record. **Prerequisites** - You are recording or editing a product. - The product group includes the assembled choice. - You know the component product and its quantity. **Steps** 1. Select the assembled option in **Group**. 2. Open **Bill of Material**. 3. Select **Product** to add a component. 4. Enter the component quantity in `BOM Qty`. **Result:** The assembled product has a bill-of-material component entry with its product and quantity. A BOM quantity cannot be less than `1`. ## When a product action fails Match the message on screen to the correction in this table. | Message | What to do | |---|---| | `An error occurred while processing your request` | Check the product information and repeat the action. Escalate the message with the product and action details if it continues. | | `An error occurred while connecting to your CRM system.` | Check the CRM connection path used by your organisation and escalate if the connection remains unavailable. | | `Please select one product` | Select one product before continuing. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the value and repeat the action. | | `This product is already included in BOM` | Do not add the same product again to that bill of material. | If a required field is incomplete, correct the fields marked required on the form before trying the action again. Use the message shown by your form as the immediate correction signal. ### Out of scope When the **Variants** surface is active, `The first variant cannot be deleted` means keep the first variant and work with the other variant records. ## What to do next Continue with the page that owns the next piece of work instead of maintaining it from the Products form. | If you need to… | Go to | |---|---| | Maintain the values offered as Product Type options | [Warehouse products types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-purchasing-product-types) | | Upload, link, or otherwise manage product files | [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) | | Maintain a sub-supplier account record | [Accounts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/accounts) | | Follow stock quantities through warehouse work | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | | Return to the reusable item records | [Products at a glance](#products-at-a-glance) | Other PAMS work selects products when it needs a reusable item. # Accounts ## Accounts at a glance An account is the shared organization identity and relationship record that keeps an organization's identity, classifications, addresses, contact information, and related work together. Use the Accounts page to find and maintain it. The Accounts page is under **Clients**. The list has these account groups: **All**, **Clients**, **Principals**, **Sub-suppliers**, **Providers**, and **Account Managers**. The record brings together the main identity fields, classification choices, contact information, address areas, related tabs, and record actions. | If you need to… | Go to | | --- | --- | | Choose an account group and open a record | [Find an account](#find-an-account) | | Check identity, classification, contact, or address areas | [Understand the account record](#understand-the-account-record) | | Review field requirements and available choices | [Account information](#account-information) | | Understand tabs that depend on the account state | [Related tabs and conditional areas](#related-tabs-and-conditional-areas) | | Work with contacts, addresses, registrations, projects, comments, or files | [Maintain related account details](#maintain-related-account-details) | | Save an account or interpret a validation message | [Save an account and handle validation](#save-an-account-and-handle-validation) | | Create or update the account | [Create an account](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-account) | | Work with contacts | [Contacts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contacts-overview) | | Work with projects | [Projects](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/projects) | | Work with registrations | [VL registrations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/vl-registrations) | | Maintain attached files | [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) | ## Before you start The account surfaces depend on the account's saved state, your access, the subscription, and the relationship selected for the record. Check the condition that matches the work you intend to do before you look for a tab or action. | Before you start | What it determines | | --- | --- | | The subscription includes the account feature and the page is available | The account form is available. | | A selected account exists | The main account fields can appear. | | The account is saved | **Contact Persons**, **Registrations**, **Comments**, **Own projects**, and **Last Modifications** can appear. | | The account is a principal and contract access is allowed | **Contract Key Data** and contract data can appear when the contract feature is included. | | The account is a client or principal | **Registrations** can appear after the record exists. | | The account is not a company | **Contact Persons** can appear after the record exists. | | A selected layout, same-branch eligibility, delete permission, and an eligible non-company-supplier record | **Delete** can appear in the Accounts list. | | An address is selected | The address fields appear, including **Destination Title**, **Country**, **State**, **City**, **Street**, and **Zip-code**. | The form is available only when the subscription includes it and the page is available. Its main fields require a selected account, and address fields require a selected address. The record state changes which related areas are available, so an unsaved account does not provide the same set of tabs as an existing one. When these conditions are met, use [Find an account](#find-an-account) to open the list or start the record. ## Find an account Use the Accounts list when you need to choose an account group or open an existing organization record. Select the account-creation entry when you are starting a record rather than opening one from the list. **Prerequisites** - You are signed in to PAMS. - You know whether you need a new account or an existing account. **Steps** 1. Open **Clients**. 2. Select **Accounts**. 3. Select the account group that matches the work. | If you need to… | Select | | --- | --- | | See every available account | **All** | | Work with client accounts | **Clients** | | Work with principal accounts | **Principals** | | Work with sub-suppliers | **Sub-suppliers** | | Work with providers | **Providers** | | Work with account-manager records | **Account Managers** | 4. Choose the action that matches your task. | If you need to… | Select | | --- | --- | | Create an account | The account-creation entry | | Edit an existing account | The account record you need to review or maintain | The list shows **Display name**, **Full name**, **Type**, **Market segment**, and **Active**. **Result:** The Accounts list or the selected account record is open. ## Understand the account record Use the record to review one organization's identity, relationship classification, contacts, addresses, related records, and record actions. Read the main information before opening a conditional tab so you know which account role and saved state it carries. The main identity area contains **Display name**, **Full Name**, **Market Segment**, **Account Type**, **VAT ID Number**, and, for a client account, **Account Manager**. Other record areas contain contract values, registration data, contact-person data, and address details. The classification area provides **Client**, **Principals**, **Active**, **Sup-supplier**, and **Other Account**. Contact information provides **Phone**, **Fax**, **Mobile**, **Email**, **Website**, **Online Support**, **Office**, and **Pager** actions. The address surfaces are **Main Address**, **Shipping Address**, and **Billing Address**. The record action areas include **Comments**, **Contact Persons**, **Registrations**, **Own projects**, **Contract Key Data**, and **Last Modifications**. Related record work can also use **Ok**, **Save**, **Attach File**, and **Try Again** where those actions are available. ![The Accounts list with its account groups and columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/4450097f65053f7fa1f0aae1526a8d34.png) ### Account information Account information identifies the organization and classifies its relationship to the business. Complete or review these fields before maintaining related account details. | Field | Type | Requirement shown by the form | | --- | --- | --- | | **Display name** | Text | Required only where the company configuration requires it. | | **Full Name** | Text | Required only where the company configuration requires it. | | **Market Segment** | Multiselect | Required only where the company configuration requires it. | | **Account Type** | Select | Required only where the company configuration requires it. | | **VAT ID Number** | Text | Not marked required on the new-account surface. | | **Account Manager** | Select | Available when the selected account is a client. | | **Expiry Date** | Date | Optional. | | **Cancellation Period** | Number | Optional. | | **Product Type** | Select | Optional in the contract-data area. | On the new-account surface, **Display name**, **Full Name**, and **Destination Title** carried required markers. The other listed identity and address fields did not carry markers there. The required status of configurable fields can differ with company configuration and existing-record conditions. The **Market Segment** choices are: | Choices | | --- | | `Oil and Gas - General`; `Chemicals`; `Petrochemicals`; `Fertilizers` | | `Water and Waste water`; `Electricity and Power`; `Food and Beverage` | | `Engineering and Contracting`; `Service & Maintenance`; `Pharmaceutical` | | `Paper & pulp`; `Iron & Steel Industry`; `Automotive`; `General Industries` | | `Military Defense`; `Military Production`; `Oil & Gas - Upstream` | | `Oil & Gas - Refineries`; `Oil & Gas - Marketing`; `Oil & Gas - Pipeline` | | `Cement Industry`; `Sugar Industry`; `Mining`; `Oil & Gas Down Stream` | | `Agriculture`; `Textile & leather products`; `Construction`; `Computer-Software` | | `Marine`; `Ceramic`; `ZZ-doc-Enter-Market-Segment-Nam`; `Hala Market Segment222`; `Hala Segment 3` | The **Account Type** choices are: | Choice | | --- | | `End User` | | `Contractor` | | `Engineering` | | `OEM` | | `Trader` | | `Oil And Services Operation Co` | The choices for **Account Manager**, **Product Type**, **Client**, **Principal**, **Status**, **Category**, and **Country** vary with the selected account, registration, attachment, or address. ![The opened Market Segment choices](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/237a0a8a70217a9c5bdc9a6b7d60db08.png) ![The opened Account Type choices](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/7e19d0529b959c0f789317333517d3a0.png) ### Related tabs and conditional areas Related areas extend the account with the people, registrations, contract information, projects, comments, files, and history associated with the saved organization record. | Area | Appears when | | --- | --- | | **Contact Persons** | The account is an existing record and is not a company. | | **Registrations** | The account is an existing record and is a principal or client. | | **Contract Key Data** | The account is an existing principal, contract access is allowed, and the contract feature is included. | | Contract data | **Contract Key Data** is selected and the account is an eligible principal with contract access. | | **Comments** | The account is an existing record. | | **Own projects** | The account is an existing record. | | **Last Modifications** | The account is an existing record. | | Attached-document actions | The action is allowed by the read-only state, related-record values, document state, or popup state. | The saved-account tabs and child-column set depend on the actual existing record. Use the account's role and saved state to decide which related area to open rather than expecting every tab on a new record. #### Available options | Area | Available actions | | --- | --- | | Account classification | **Client**, **Principals**, **Active**, **Sup-supplier**, **Other Account** | | Contact information | **Phone**, **Fax**, **Mobile**, **Email**, **Website**, **Online Support**, **Office**, **Pager** | | Addresses | **Main Address**, **Shipping Address**, **Billing Address** | | Related records | **Ok**, **Save**, **Attach File**, **Try Again**, where their conditions are met | ### List and toolbar reference The Accounts list is a selectable account workspace. In the current layout, its columns were **Display name**, **Full name**, **Type**, **Market segment**, and **Active**. The visible toolbar controls were the icon buttons titled **Refresh**, `Table Layout`, and **Settings**. Select **Export** to open the export surface. It provides **Export**, **Filter Row**, and **Group Panel**. Use **Filter Row** to work with row filtering and **Group Panel** to work with grouping when those controls are shown. The columns shown in the Accounts list come from the saved list layout. Work from the headers currently visible in your list; the complete set is not fixed by the account page. The **Delete** action appears only when a selected layout, same-branch eligibility, delete permission, and an eligible non-company-supplier record all apply. ![The Accounts export surface with Export, Filter Row, and Group Panel](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e725b7c0fc4b23cdaa75187d1e9d2566.png) ## Maintain related account details Related account details are the people, addresses, registrations, projects, comments, files, and history connected to a saved account. Select the related area that owns the detail you need to maintain. **Prerequisites** - You have an existing account record open for the related tabs. - The account meets the condition for the tab or area you need. **Steps** 1. Open the related area that matches your task. | If you need to… | Select | | --- | --- | | Add or edit a contact person on an existing non-company account | **Contact Persons** | | Maintain a selected address | **Main Address**, **Shipping Address**, or **Billing Address** | | Work with registration data for an existing client or principal | **Registrations** | | Continue project work for the existing account | **Own projects** | | Continue account comments for the existing account | **Comments** | | Review the existing account's modification history | **Last Modifications** | 2. Maintain the selected address through **Destination Title**, **Country**, **State**, **City**, **Street**, and **Zip-code**. 3. Choose the attached-file action that matches your task. | If you need to… | Select | | --- | --- | | Open file attachment | **Attach File** | | Retry attached-file loading | **Try Again** | Contact-person work belongs to [Contacts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contacts-overview), project work belongs to [Projects](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/projects), registration work belongs to [VL registrations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/vl-registrations), and attached-file maintenance belongs to [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files). **Result:** The selected related account detail is open, maintained, or handed off to its owning page. ## Save an account and handle validation Saving commits the account information currently entered on the record. The account form provides **Save** and **Save and Close**; required-field, duplicate, prerequisite, and general request messages tell you why the request stopped or completed. **Prerequisites** - You have reviewed the account fields and selected the appropriate account classification. - You know whether you want to remain on the record or leave it after saving. **Steps** 1. Enter the required account information, including any fields your company has configured as required. 2. Choose the save action that matches your task. | If you need to… | Select | | --- | --- | | Save the account and remain on the record | **Save** | | Save the account and close the form | **Save and Close** | 3. Confirm that the request completed with `Your request was completed successfully`. The page may display `This Field Is Required`, `An account with this name already exists`, `Error: Vendor not saved yet`, `Error: Client not saved yet`, or `An error occurred while processing your request` when the save does not complete. **Result:** The account remains on the form with the relevant validation message, or the request completes with `Your request was completed successfully`. ### Out of scope The Accounts page provides the relationship entry points, but the owning pages provide the detailed work for related records. | Question or surface | Continue in | | --- | --- | | `Forbidden characters detected. Please remove them and try again.` | [Contacts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contacts-overview) or [Projects](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/projects) | | ` You already have a contact with this name` | [Contacts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contacts-overview) | | `Your request was completed successfully` for attached-file work | [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) | | `Just '_'‘-''.' And '&' Characters Accepted` | [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) | | Project messages and project child fields | [Projects](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/projects) | | Registration child fields and option choices | [VL registrations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/vl-registrations) | | Fixed choices for **Account Manager**, **Product Type**, **Client**, **Principal**, **Status**, **Category**, or **Country** | Use the choices shown on the owning account, registration, attachment, or address surface. | Saved-account tabs and child columns depend on the account that is open. Detailed related record actions belong to the owning pages listed above. ## Continue from Accounts Choose the next page according to the account work you want to complete. | If you want to… | Continue with | | --- | --- | | Create or update the account record | [Create an account](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-account) | | Maintain related contacts | [Contacts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/contacts-overview) | | Maintain account projects | [Projects](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/projects) | | Maintain registrations | [VL registrations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/vl-registrations) | | Maintain attached files | [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) | # Create an account ## Create or update an account An account is the shared organization identity and relationship information that other Data work uses. Use the account form to create or update an account record. The record combines the organization's identity with relationship roles such as client or principal. Saved accounts also provide related work for contact persons, registrations, projects, and contract data. | If you need to… | Go to | | --- | --- | | Open the Accounts list or select an existing account | **Accounts** | | Start a new account | [Before you start](#before-you-start), then [Find the account form](#find-the-account-form) | | Complete account details | [Enter the account information](#enter-the-account-information) | | Work with role-dependent details | [Handle conditional account details](#handle-conditional-account-details) | | Save the record or correct a save problem | [Save the account and resolve problems](#save-the-account-and-resolve-problems) | | Create a contact person | Create contact | | Work with projects | Projects | | Maintain registrations | VL registrations | | Maintain attached files or libraries | Libraries | ## Before you start Prepare the organization's identity, classification, main address, and contact information. Choose whether to create a new account or update an existing one. **Prerequisites** | Prepare | Why it matters | | --- | --- | | Access to the signed-in PAMS site and the account page | The account form is available only when the subscription and page are available. | | The organization's display name and full name | These identify the shared organization record. | | Classification information | Market segment, account type, and relationship roles classify the account. | | Main address information | The address area records the destination title and address values. | | Contact information | These values keep the organization's contact details with the account. | | An existing selected account for an update | The main account fields use the selected account from the Accounts list. | The form changes according to whether you are creating a record or editing an existing one. Choose **New** in the Accounts area to create a record. Select an existing account from the Accounts list to update it. ## Find the account form The Accounts list is the starting point for locating organization records. The next step is to choose the new-record or existing-record path before entering details. **Prerequisites** - You are signed in to PAMS. - You know whether you are creating a new account or changing an existing account. **Steps** 1. Open **Clients**. 2. Select **Accounts**. 3. Choose the account path. | If you need to… | Choose | | --- | --- | | Create an account | **New** | | Edit an existing account | The account record in the Accounts list | 4. If you are editing, open the selected account record. **Result:** The account form is open for a new account or the selected existing account. ## Understand the account screen The account screen is the organization record workspace. Its main form holds identity, classification, address, and contact information; saved-account tabs hold related work. The upper form contains identity and classification. Address areas are **Main Address**, **Shipping Address**, and **Billing Address**. The contact area is **Contact Information**, and the form also includes **Tickets**. Classification choices are **Client**, **Principals**, **Active**, **Sup-supplier**, and **Other Account**. The saved-record tabs are: | Tab | Use it for | | --- | --- | | **Comments** | Review or add discussion associated with the saved account. | | **Contact Persons** | Continue with people related to the saved account. | | **Registrations** | Review the account's registrations. | | **Own projects** | Continue with projects related to the saved account. | | **Contract Key Data** | Review contract information when the account and access conditions allow it. | | **Last Modifications** | Review changes recorded for the account. | The conditional areas depend on the account role, saved state, access, selected type, or popup choice. **Account Manager** appears for client accounts. Contract information is available from **Contract Key Data** only when the record is saved, the account is a principal, contract access is allowed, and the contract feature is included. **Contact Persons**, **Comments**, **Own projects**, and **Last Modifications** are saved-account surfaces. **Registrations** is available for the applicable principal or client record. Address controls appear when an address is available to edit. ![The account form with identity fields, relationship toggles, address areas, and save actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/7228fbdcfae7d294cf07326622e5797e.png) Use **Save** to keep the account on the form. Use **Save and Close** to save and leave the form. With the screen understood, enter the account information next. ## Enter the account information Enter identity values first, then classification, address, and contact information. A required marker appears beside **Display name**, **Full Name**, and **Destination Title**; the other listed fields do not show a required marker. **Prerequisites** - The account form is open. - You have the organization's identity, classification, address, and contact details. **Steps** 1. Enter the organization's identifying values. | Field | What to enter | | --- | --- | | **Display name** | The name used to identify the account in lists and related work. | | **Full Name** | The organization's full name. | | **VAT ID Number** | The organization's VAT identification number, when applicable. | 2. Select the applicable classification values. | Field or choice | What to do | | --- | --- | | **Market Segment** | Select an applicable market segment. | | **Account Type** | Select the applicable account type. | | **Client** | Select the client relationship when it applies. | | **Principals** | Select the principal relationship when it applies. | | **Active** | Select the active principal choice when it applies. | | **Sup-supplier** | Select the sub-supplier relationship when it applies. | | **Other Account** | Select the other-account classification when it applies. | ![The opened Market Segment choices](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/85b0529d47e3d10eca34e1dff13d1780.png) ![Select the applicable Account Type](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/85b0529d47e3d10eca34e1dff13d1780.png) 3. Complete the account address. | Address field | Value | | --- | --- | | **Destination Title** | The destination title for the address. | | **Country** | The country. | | **State** | The state. | | **City** | The city. | | **Street** | The street. | | **Zip-code** | The postal or ZIP code. | 4. Add the account's contact values in **Contact Information**. | Contact choice | Value | | --- | --- | | **Phone** | A phone number. | | **Fax** | A fax number. | | **Mobile** | A mobile number. | | **Email** | An email address. | | **Website** | The organization's website. | | **Online Support** | The online-support contact value. | | **Office** | An office contact value. | | **Pager** | A pager contact value. | 5. Review the required markers before continuing. **Display name**, **Full Name**, and **Destination Title** are marked as required. **Result:** The form contains the identity, classification, address, and contact values. Continue with any conditional details that apply, or save the account. ## Handle conditional account details Conditional account details appear only when the account role, saved state, permission, selected type, or popup choice permits them. Use the surface that appears. **Steps** 1. Select the client relationship in **Client** when the organization is a client. **Account Manager** appears for a client account. 2. Select **Principals** when the organization is a principal. 3. Open **Contract Key Data** on a saved principal when contract access is allowed and the contract feature is included. 4. Open **Registrations** on a saved account when you need to add or edit a registration. Use the branch that applies to the account and complete **Registration Number**, **Registration date**, and **Status** when they are shown. 5. Select **Ok** to confirm a registration or contact-person popup action when the popup supplies that control. 6. Open **Contact Persons** on a saved, non-company account. 7. Complete the contact-person popup fields that apply. | Contact-person field | | --- | | **Title** | | **Name** | | **Position** | | **Department** | | **Phone** | | **Fax** | | **Mobile** | | **Email** | | **Website** | | **Online Support** | | **Comments** | 8. Select **Save** in the popup when the contact edit is complete. 9. In **Contact Information**, use the contact type that matches the value you need. | Contact types | | --- | | **Email**, **Website**, **Online Support**, **Office**, **Pager**, **Phone**, **Fax**, **Mobile** | 10. Use the applicable file action. | If you need to… | Select | | --- | --- | | Attach a file | **Attach File** | | Retry an attachment action | **Try Again** | 11. When an account-exists popup appears, use its available action instead of entering a second account record. 12. Open the related surface when one of these messages appears. 13. Select the affected field. 14. Select the field named in the message. 15. Enter the corrected value. | Message | What to do | | --- | --- | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters, then repeat the related-surface action. | | ` You already have a contact with this name` | Change the contact name before saving the contact-person form. | | `Just '_'‘-''.' And '&' Characters Accepted` | Remove characters other than the accepted characters, then repeat the file action. | **Result:** The applicable role, saved-record, contract, registration, contact, and file surfaces are completed or ready for the next action. Continue to save the account. ## Save the account and resolve problems Saving commits the account information entered on the form. Choose whether to remain on the form or leave it, then correct any named problem before saving again. **Prerequisites** - The applicable identity, relationship, address, and contact information is entered. - You know whether you need to continue on the form after saving. **Steps** 1. Choose the save action that matches what you need. | If you need to… | Select | | --- | --- | | Remain on the account form | **Save** | | Save and leave the form | **Save and Close** | 2. Read the message. 3. Correct the named field or prerequisite before repeating the applicable save action. | Message | What to do | | --- | --- | | `Your request was completed successfully` | Continue with the saved account. | | `An account with this name already exists` | Check the account name and use the existing account when it is the organization you intended to update. | | `An error occurred while processing your request` | Review the entered values and retry the save action. | | `Error: Vendor not saved yet` | Save the vendor-related record before repeating the account action. | | `Error: Client not saved yet` | Save the client-related record before repeating the account action. | | `This Field Is Required` | Return to the field marked as required and enter its value. | **Result:** The account is saved with **Save** or **Save and Close**, or the message identifies the condition to correct before trying again. ### Out of scope The account form can expose related contact, project, registration, and file surfaces, but their detailed maintenance belongs to their owning pages. Use Create contact, Projects, VL registrations, or Libraries for those tasks. The following messages belong to those embedded surfaces rather than to the account identity save itself: | Message | Owning work | | --- | --- | | `Forbidden characters detected. Please remove them and try again.` | Contact-person and project lists | | ` You already have a contact with this name` | Contact-person form | | `Just '_'‘-''.' And '&' Characters Accepted` | File maintenance | The contact-person and own-project columns depend on the saved account's list layout. Use the headers visible in the related surface when working there. The account form also contains unnamed icon-only actions; use only actions with a reader-facing label on this page. Save behavior shared by an embedded component belongs to that component's own procedure. ## After saving A saved account is the continuing organization record for related account work. Select the saved-account surface that matches your next task. **Steps** 1. Choose the related surface that matches your next task. | If you need to… | Open | | --- | --- | | Continue the account discussion | **Comments** | | Continue with people related to the account | **Contact Persons** | | Continue with the account's registrations | **Registrations** | | Continue with related projects | **Own projects** | 2. Open the related saved-account surface that matches the next task. | If you need to… | Open | | --- | --- | | Review contract information for an eligible principal | **Contract Key Data** | | Review the account's recorded changes | **Last Modifications** | **Result:** The saved account remains available for its applicable comments, contact, registration, project, contract, and modification-history work. # Projects Use this page to find project work, recognize the project record, review its information, and move to related project areas. ## Projects overview Projects is the area for project list work. Its views are **All**, **Open**, and **Archived**. | If you need to… | Go to | |---|---| | See every project in the Projects area | [Find a project](#find-a-project) | | Review the project information fields | [Project details](#project-details) | | Choose a saved-record area | [Saved-record tabs](#saved-record-tabs) | | Review the new-project fields | [Create or update project information](#create-or-update-project-information) | | Continue with project-cycle work | [Project management workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/project-management-workspace) | | Work with tasks and activities related to the record | [Tasks and activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/tasks-and-activities) | | Review registration-list work | [VL registrations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/vl-registrations) | Project status values include `NA`, `Proceeding`, `Completed`, `OnHold`, `Planned`, `Canceled`, and `Closed`. The Projects list is organized by **All**, **Open**, and **Archived**, not by each status value. ![The Projects list with its All, Open, and Archived views and list actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/883492c86d85fd0999fe7af1ea72603b.png) ## Before you start > **Note:** Begin by opening **Projects**. The project list and new-project form are the starting > points covered on this page. ## Find a project The Projects list is the starting surface for project list work. Use its top-level views before using the list actions. ### Prerequisites - You can open the **Projects** area. ### Steps 1. Open the **Projects** area. 2. Choose the view that matches your work. | If you need to… | Select | |---|---| | See every project | **All** | | See all currently opened project work | **All opened** | | See open project work | **Open** | | See archived project work | **Archived** | 3. Use the project grid and its list actions. **Result:** The Projects list remains open in the selected **All**, **Open**, or **Archived** view, with its project grid and list actions available. ![The selected Projects list view, project grid, and list-action area](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/883492c86d85fd0999fe7af1ea72603b.png) ## Understand the project record A project record is the saved project surface that holds the project's main information and links to related work areas. Its saved tabs are separate from the main project details. ### Project details Project details identify the project, its product, status, timing, value, location, and the people or roles associated with delivery work. | Information | Reader-facing label | |---|---| | Project identity | **Project Name** | | Product | **Final Product** | | Status | **Status** | | Planned start | **Expected Start Date** | | Planned commissioning | **Expected Commissioning Date** | | Value | **Project Value** | | Location | **Project Location** | | Procurement responsibility | **Procurment by** | | Licensing responsibility | **License by** | | Project-management consultancy responsibility | **PMC by** | | Construction responsibility | **Construction by** | | Vendor-list responsibility | **Vendor List by** | ### Saved-record tabs Saved-record tabs take you from the project's main information to related project information. The available tab names are: | Tab | Use it to continue with… | |---|---| | **Comments** | Project comments | | **Attachment** | Project attachments | | **Contact Persons** | Project contact persons | | **Project Jobs** | Project jobs | | **Registrations** | Project registrations | | **Last Modifications** | Project audit history | These areas are separate from the main project details. Select the tab that matches the related information you need to review; select **Registrations** for registration-related information. ### Registration dialog Open **Registrations** to reach registration-related project information. ## Create or update project information Use the new-project form to review project information before entering it. ### Prerequisites - You have reached the new-project form. ### Steps 1. Choose the project field you need to review. | If you need to review… | Select | |---|---| | The project name | **Project Name** | | The final product | **Final Product** | | The project status | **Status** | | The full name | **Full Name** | | The project description | **Description** | ![The new-project form with Project Name visible](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/23b27d5b67054f0c14a5fe74898514cc.png) **Result:** The new-project form remains open with the project fields visible. ## Handle project surface variations The related areas are **Comments**, **Attachment**, **Contact Persons**, **Project Jobs**, **Registrations**, and **Last Modifications**. Choose the area whose label appears on your project record. ## When project work goes wrong The new-project form uses required-field validation. | What you see | What to do | |---|---| | A required-field marker on the new-project form | Review the field carrying the marker before continuing. | | **Project Name** carries a required marker | Complete **Project Name** before continuing. | | **Final Product** is visible | Review the product information in **Final Product**. | | **Status** is visible | Review the project status in **Status**. | Validation messages: - `This Field Is Required`; - `Just '_' '-' And '.' Characters Accepted`; - `Status is required`; - `Vendor is required`; - `Forbidden characters detected. Please remove them and try again.`; - `You already have a contact with this name`; - `Your request was completed successfully`; - `Just '_'‘-''.' And '&' Characters Accepted`. ## Continue from the project record After reviewing the project record, choose the related area that matches the work you need to do. | Continue with… | Open | |---|---| | Project-cycle work | [Project management workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/project-management-workspace) | | Tasks and activities | [Tasks and activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/tasks-and-activities) | | Project contact persons | **Contact Persons** | | Project comments | **Comments** | | Project attachments | **Attachment** | | Project audit history | **Last Modifications** | | Project registration-list work | [VL registrations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/vl-registrations) | Continue with the linked project-cycle, task, registration, or related-area work after reviewing the project record. # VL registrations ## VL registrations VL registrations are registrations grouped by their relationship with a client or a project. Choose the relationship view that matches the record associated with the registration. Both views use the same registration surface, with a relationship-specific list and form. | If you need to… | Go to | | --- | --- | | Check registrations grouped under clients | [Find VL registrations](#find-vl-registrations), then use **At Clients** | | Open the client registration list or its entry form | [Find VL registrations](#find-vl-registrations) | | Read the columns and toolbar on a registration list | [Understand the registration list](#understand-the-registration-list) | | Check the fields before entering a registration | [Before you start](#before-you-start) | | Continue with account or project records | Accounts or Projects | | Continue with products, reference data, or libraries | [Products](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/products), Reference list, or Libraries | The page exposes the **At Clients** and **At Projects** views. The selected view determines whether the **New** form asks for a client or a project relationship. ![The VL registrations page with the two relationship tabs and list area](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5e8b0f387a89012f0b30b60119218689.png) ## Before you start Have access to the client, vendor, project, and status choices needed for the relationship you are recording. The registration form uses lists for these values, so the entries available to you depend on the records and status choices in your account. | View | Required fields | Other fields | Status choices | | --- | --- | --- | --- | | **At Clients** | **Client**, **Vendor**, **Status** | **Registration Number**, **Registration date** | Registered, Proceeding, Not Registered | | **At Projects** | **Vendor**, **Project**, **Status** | **Registration Number**, **Registration date** | Registered, Proceeding, Not Registered | The **Client**, **Vendor**, and **Project** lists contain records available to you. The **Status** list contains the status choices available to you. The **Registration date** cannot be later than today. A **New** control is available when your access allows a new record. ## Find VL registrations ### Prerequisites - Have access to the client, vendor, project, and status choices needed for the registration. ### Steps 1. From the application menu, select **VL registrations**. 2. Select the relationship view for the registration. | Registration relationship | Select | | --- | --- | | Client | **At Clients** | | Project | **At Projects** | The next image represents the **At Clients** relationship view. ![The client registration list with its toolbar and visible columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/519035608a28933cd52a7bd4737f9c9c.png) The next image represents the **At Projects** relationship view. ![The project registration list with its toolbar and visible columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/646182d2fb4dd58294f96f742e4b2a6a.png) 3. Select **New**. The next image represents the **At Clients** relationship view. ![The client registration form with its relationship fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3ad4b519e76a2ae47e0ea6278c8032d8.png) The next image represents the **At Projects** relationship view. ![The project registration form with its relationship fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/aa0969bfdae3dd5b508371b61be919d0.png) 4. Enter the required fields for the selected relationship. | Selected view | Enter | | --- | --- | | **At Clients** | **Client**, **Vendor**, and **Status** | | **At Projects** | **Vendor**, **Project**, and **Status** | 5. If you enter **Registration date**, choose today or an earlier date. 6. Review the completed form with **OK** available. **Result:** The completed registration form remains open with **OK** available. ## Understand the registration list A registration list is the table of registrations for the relationship view you selected. The headers shown in the list can depend on the saved layout, so use the headers currently visible when you read a row. The list contains the following columns: | Area | Visible items | | --- | --- | | Registration details | **Registration date**, **Registration no.**, **Status** | | Related parties | **Company**, **Principal** | | Organisation | **Branch** | The toolbar contains **Refresh**, **table layout**, and **Settings**. The columns shown in the list come from the selected layout, so use the headers currently displayed. Row-filter and group-filter controls appear when they are available for your account. ## Choose the relationship view The relationship view tells you which record owns the registration context: **At Clients** groups registrations under clients, while **At Projects** groups them under projects. **Prerequisites** - Know whether the registration is associated with a client or a project. **Steps** 1. Open the relationship view that matches the registration you need. | If you are looking for… | Select | | --- | --- | | Client-related registrations | **At Clients** | | Project-related registrations | **At Projects** | 2. Confirm that the matching list is visible before selecting **New**. ![The client form showing the Registration date field](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3ad4b519e76a2ae47e0ea6278c8032d8.png) **Result:** The selected relationship list is on screen. **At Clients** shows the client-side list; **At Projects** shows the project-side list. ## Open a project registration path The project registration list is the project relationship view of VL registrations. Use it when the registration must be associated with a project rather than directly with a client. **Prerequisites** - Have access to the vendor and project records. - Have a status choice ready. **Steps** 1. From the application menu, select **VL registrations**. 2. Select **At Projects**. ![The project registration list with its toolbar and visible columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/646182d2fb4dd58294f96f742e4b2a6a.png) 3. Select **New**. ![The project registration form with its project fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/aa0969bfdae3dd5b508371b61be919d0.png) 4. Identify the project form fields: **Vendor**, **Project**, **Status**, **Registration Number**, and **Registration date**. 5. Enter the required relationship details in **Vendor**, **Project**, and **Status**. 6. If you enter **Registration date**, choose today or an earlier date. 7. Select **OK** when you are ready to submit the form. **Result:** The project registration form is on screen with **Vendor**, **Project**, **Status**, **Registration Number**, **Registration date**, and **OK**. The project list shows **Company**, **Principal**, **Registration date**, **Registration no.**, **Status**, and **Branch**. Its toolbar contains **Refresh**, **table layout**, and **Settings**. ## Messages The form validates the required relationship fields before it can proceed. Use the message to find the field that needs attention. | What you see | What to do | | --- | --- | | `Client is required` | Select a client in **Client**. | | `Vendor is required` | Select a vendor in **Vendor**. | | `Status is required` | Select a status in **Status**. | | `Project is required` | Select a project in **Project**. | | `Please Solve the Following Issues :` | Review the field messages and complete each required field. | | `Data saved Successfully` | The account registration save completed. | | `Error Saving Registration` | Check the account registration details and try the action again. | | `Error saving registration` | Check the project registration details and try the action again. | | `Load data failed` | Refresh the list with **Refresh** and check the list again. | | `Forbidden characters detected. Please remove them and try again.` | Remove forbidden characters from the filter value and try again. | | `Export to Excel` | Choose this export option when it is available. | | `Export to PDF` | Choose this export option when it is available. | | `Data Importing completed` | The import has completed. | ## What to do next For records associated with registrations, continue to Accounts, Projects, Products, Reference list, or Libraries. # Reference list ## Reference list overview A reference is a saved record of an installed product, identified by information such as its serial number, parties, dates, category, and application. The Reference list is where you locate and export these records. A saved reference record is where you enter, change, print, check, and review one reference. | If you need to… | Go to | |---|---| | Find a saved reference or start from the list | [Find and open a reference](#find-and-open-a-reference) | | Understand the record before entering values | [Understand the reference record](#understand-the-reference-record) | | Enter or change reference details | [Reference information](#reference-information) | | Save a new or changed reference | [Create or update a reference](#create-or-update-a-reference) | | Review a saved reference | [Review a saved reference](#review-a-saved-reference) | | Maintain categories and questions used by references | [Reference categories](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reference-list-reference-category-view) | | Maintain units for reference questions | [Reference category question units](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reference-list-reference-category-question-units-view) | | Review registered serial statuses | [Reference serial status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reference-list-reference-serial-status-view) | | Continue with the owning sales-job record | [Sales job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-record) | ## Before you start The Reference list can appear as a tab in a saved sales job, and its record form can also be opened from the Reference list page. Before you begin, have the saved record or product context you need, the reference information to enter, and access to the feature. **Prerequisites** - Use a saved sales job when you are reaching the Reference list from the job workspace. - Make sure the Reference list feature is included in the subscription. - Have the product, serial number, manufacturer, vendor, client, end user, dates, category, and application information available for the reference you are entering or reviewing. - Check the fields that your company configuration makes required before you start. The six fields required by the displayed form are **Serial Number**, **Manufacturer**, **Vendor**, **Client**, **End User**, and **Category**. Other fields can be required by configuration. The available record areas depend on whether the record is saved and which features are available. **Check-up** is available for a saved record. **Last Modifications** is available for a saved record when the latest-modifications feature is included. ## Find and open a reference Use the Reference list to locate saved references, inspect the columns currently shown for your list, open a record, or start a new record from **Product**. **Prerequisites** - You are signed in. - You have a saved sales job if the Reference list is reached from the job workspace. - To start a new reference, **Product** is available. **Steps** 1. Choose the route that matches your work. | If you need to… | Open | |---|---| | Work directly from the list | Open the Reference list page | | Work from the saved sales job | The saved sales job that owns the list | 2. If you opened the sales job, open the **Reference List** tab. 3. Read the headers that are visible in the list. The list shows these columns: | Column | Use it to recognize | |---|---| | **Serial No.** | The reference serial number | | **Category** | The reference category | | **Job No.** | The related job number | | **Model** | The model shown in the list | | **Year of manufacturing** | The manufacturing year | | **Delivery date** | The product delivery date | | **Warranty end date** | The warranty end date | | **Manufacturer** | The manufacturer | The columns in your list come from its selected layout, so work from the headers visible on your screen. The list also has **Refresh**, **Table Layout**, and **Settings**. ![Identify the Reference List page, its visible columns, and the list toolbar.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/153e9fcaed010f2a5448fda9aa09d3a6.png) 4. Select the row for the saved reference you need to review or change. 5. To start a reference from the product entry point, select **Product**. 6. Confirm that the new-reference fields are displayed. **Result:** You have either opened a saved reference record or reached the new-reference form. Continue with [Understand the reference record](#understand-the-reference-record) to identify the available areas before entering values. ## Understand the reference record The reference record groups the main reference information, saved-record review areas, and record actions in an accordion and separate validation groups. The main information group contains the reference details. The record also has a collapsible accordion, and separate validation groups for the main data, serial status, and the additional reference branch. The available surfaces change with the record state and feature access: | Surface | When it is available | What it is for | |---|---|---| | Main reference information | Reference details exist, the page is not excluded, and the feature is included | Enter or review the reference fields | | **Check-up** | The record has an ID | Review or add serial-status information | | **Last Modifications** | The record has an ID and the latest-modifications feature is available | Review changes made to the record | | **Print** | The record is saved and unchanged, and printing is allowed | Prepare the reference for printing | | **Upload** | The import popup is open and importing is enabled | Upload imported data | Use **Print**, **Check-up**, and **Last Modifications** when they appear on the saved record. Then continue with [Reference information](#reference-information) to enter or review values. ### Reference information Reference information identifies the product and the parties connected with it, records its dates and warranty, classifies it, and describes its application. Required markers on the form identify the fields that must be completed for the displayed configuration. | Area | Fields | Rule | |---|---|---| | Identity | **Serial Number**, **Manufacturer** | Both are required. | | Dates and warranty | **Year of manufacturing**, **Product delivery date**, **Warranty period**, **Warranty end date** | These fields are configurable. **Warranty period** has a minimum value of `0`. | | Parties | **Vendor**, **Client**, **End User** | All three are required. | | Order and market details | **Client Order No.**, **Vendor Order No.**, **Market Segment**, **Country** | These fields are configurable. | | Classification | **Category**, **Model name** | **Category** is required. **Model name** is configurable. | | Application | **Application** | Configurable. | | Question branch | Question answer and, when the question has units, Question unit | The question branch is shown when it applies. | For **Manufacturer**, **Vendor**, **Client**, **End User**, and **Category**, select a value from the available list. Use the available warranty-period unit when it is shown. Complete the question answer and question unit when that branch is shown. ### Review areas The review areas let you check a saved reference and its record history. **Check-up** contains the serial-status information for a check, while **Last Modifications** contains the history of changes. | Area | Fields or columns | Action | |---|---|---| | **Check-up** | **Checked on**, **Status**, **Comment** | Add or edit a status when the saved-record conditions allow it. | | **Last Modifications** | **Status**, **Checked on**, **Checked by**, **Comment** | Select **Registration** for a history entry when that action is available. | **Checked on** is required and cannot be later than today. **Status** and **Comment** are required in the check-up entry. Select a status from the registered serial-status choices shown on the form. ## Create or update a reference Enter a new reference or correct the details of a saved one. Complete the required identity and party fields first, then add the configurable information that your company uses. **Prerequisites** - You are on the new-reference form or have opened a saved reference for editing. - You have the reference information required by your company. - **Serial Number**, **Manufacturer**, **Vendor**, **Client**, **End User**, and **Category** are available and ready to complete. **Steps** 1. Enter the reference identifier in **Serial Number**. 2. Select the manufacturer in **Manufacturer**. 3. Enter the applicable dates and warranty information in **Year of manufacturing**, **Product delivery date**, **Warranty period**, and **Warranty end date**. 4. Select the related parties in **Vendor**, **Client**, and **End User**. 5. Enter order and market information in **Client Order No.**, **Vendor Order No.**, **Market Segment**, and **Country** when those fields are available. 6. Select the classification in **Category**. 7. Enter the model and application information in **Model name** and **Application** when those fields are available. 8. Select the save action that matches what you want to do. | If you need to… | Select | |---|---| | Save and keep working in the form | **Save** | | Save and leave the form | **Save and Close** | | Upload reference data from an open import popup | **Upload** | 9. If the confirmation popup appears, select **Yes** to continue or **No** to cancel. ![Check the required markers and the Save and Save and Close controls before committing the reference.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9cf297bda7f3748683f2e4c85344e140.png) **Result:** The form submits through the selected save path when its validation succeeds. A successful save uses the message `Your request was completed successfully`. Continue with [Review a saved reference](#review-a-saved-reference) when the record is saved. ### Leave without saving Leave the form without saving when you do not want to keep your changes. **Prerequisites** - You have unsaved changes on the reference form. **Steps** 1. Select **Don't Save** in the exit popup. **Result:** You leave the form without saving the unsaved changes. ## Review a saved reference Review a saved reference when you need to print its details, inspect its check-up, read its change history, or return to the list and export list data. **Prerequisites** - You have opened a saved reference record, or you have returned to the Reference list. - The saved record has an ID for **Check-up** and **Last Modifications**. - Printing is allowed and the record is unchanged when you need **Print**. **Steps** 1. On a saved, unchanged record, select **Print** when it is available. 2. Select **Check-up** to review **Checked on**, **Status**, and **Comment**. 3. Select **Last Modifications** when the latest-modifications feature is available. 4. In the history area, select **Registration** for the log entry you need to inspect when it is available. 5. Return to the Reference list. 6. Select **Export** to open the list export options. If the list settings are open, the list can also show **Filter Row** and **Group Panel**. ![Identify Export, the export options, and the visible Reference list columns.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/550bfd8b08cb460737823d2558a328a1.png) **Result:** The saved record is open in the review area you selected, or the Reference list shows its export options. Continue with [Handle optional fields and access branches](#handle-optional-fields-and-access-branches) when the available controls differ from these steps. ## Handle optional fields and access branches Reference records contain a mixture of fixed required fields, company-configurable fields, and branches that depend on saved-record data, subscription features, or the information available in the record. Treat a control as applicable when it is visible and enabled on your screen. | Branch | What changes | |---|---| | Configurable fields | **Year of manufacturing**, **Product delivery date**, **Warranty period**, **Warranty end date**, **Client Order No.**, **Vendor Order No.**, **Market Segment**, **Country**, **Model name**, and **Application** can be required by company configuration. | | Warranty unit | Select the available unit for **Warranty period** when the unit choice is shown. | | Question branch | A question answer can appear in the details. **Question unit** appears when the question has units. | | Subscription | If the feature is excluded, the main reference surface is not available. | | Saved-record actions | **Check-up** requires a saved record. **Last Modifications** also requires the latest-modifications feature. **Print** requires a saved, unchanged record and printing permission. | | Print options | In the print popup, use the two choices and watermark field shown for your print request. | Do not use the presence of a field in one reference form to assume that the same field is required in every company configuration. Likewise, do not treat **Question unit**, print options, or saved-record tabs as universal controls. When a value is missing or invalid, continue with [When validation or saving goes wrong](#when-validation-or-saving-goes-wrong). ## When validation or saving goes wrong Use the exact message on screen to decide what to correct. Complete the missing or invalid reference value, then use **Save** or **Save and Close** again. The messages below are the messages assigned to the reference form or its list action. | What you see | What to do | |---|---| | `Serial you have entered already exist and belong to same manufacturer` | Check **Serial Number** and **Manufacturer**. Correct the duplicate or select the appropriate existing reference. | | `There is error in serial you have entered` | Correct the value in **Serial Number**, then save again. | | `An error occurred while processing your request` | Check the values in the form and retry the save. If it continues, use the approved help path. | | `Your request was completed successfully` | Treat the save request as completed, then review the record or return to the list as your task requires. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the list value involved in the export or list action, then retry. This message is shared list-export handling rather than a reference-specific field rule. | The save form validates before committing. If a save control is disabled, correct the required fields that are visible and check that the record is in the appropriate state before trying again. If the message or behavior belongs to shared handling, continue with [Out of scope](#out-of-scope). ## Out of scope For shared behavior that the Reference list does not assign to a specific flow, continue here: | Subject | Where to continue | |---|---| | `Please enter the storage area and position for each product` | The owning product flow; this shared commit message is outside the Reference list flow. | | Shared list-export character handling | The general list-export guidance | | Account, category, warranty-unit, question-unit, and check-up status choices | Select from the choices displayed on the open form | | Question and print options | Use the controls shown in the open branch | | Record deletion | The page or workflow that owns deletion | After identifying the owning surface, continue with [What to do next](#what-to-do-next). ## What to do next After reviewing a reference, continue from the surface that owns the next piece of work. | If you need to… | Continue with | |---|---| | Work with the complete sales opportunity and its related records | [Sales job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-record) | | Change the categories and questions available to references | [Reference categories](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reference-list-reference-category-view) | | Change units for a reference question | [Reference category question units](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reference-list-reference-category-question-units-view) | | Maintain registered serial statuses | [Reference serial status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reference-list-reference-serial-status-view) | | Resolve a general error | General error messages | | Get help when the available instructions do not solve the problem | Getting help | # Libraries Use Libraries to browse and manage shared libraries, folders, and files, then continue file work from the record that uses a linked file. ## Libraries at a glance A library is a shared top-level container for organising folders and files. A folder is a container inside a library, and a file is an item stored in either container. Libraries is the shared file surface for these items. In PAMS, open Libraries from the **Data** group to reach the all-files view. | If you need to… | Go to | |---|---| | Understand the conditions that affect what you see | [Before you start](#before-you-start) | | Browse libraries, folders, and files | [Find and navigate library contents](#find-and-navigate-library-contents) | | Choose the right maintenance operation | [Create and maintain libraries and files](#create-and-maintain-libraries-and-files) | | Create a shared library | [Create a library](#create-a-library) | | Create a folder | [Create a folder](#create-a-folder) | | Upload a file | [Upload a file](#upload-a-file) | | Change or remove an existing item | [Edit, open, download, rename, or delete an item](#edit-open-download-rename-or-delete-an-item) | | Work with files attached to a sales job | [Activities and attachments on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-activities-and-files) | | Work with files attached to an MRQ | [Comments, files, and history on an MRQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/mrq-comments-files-and-history) | | Find reference data used by a link | [Reference list](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/reference-list-data) | ## Before you start Libraries is available as a shared file surface when your subscription includes it. Your subscription, permissions, saved library contents, and selected records determine which controls and items appear. **Prerequisites** - Have access to the PAMS Data group. - Know which library or folder should contain the item. - Have the file name, links, and comment ready when the upload requires them. If your subscription does not include Libraries, PAMS shows subscription-upgrade content instead of the file surface. Otherwise, PAMS shows the file toolbar and file surface. **New Library** appears when the current history contains one item. **New Folder** and **Upload** depend on the current library context, so they do not appear in every location. The shared files surface also appears inside parent record screens through the document popup. The parent record owns that linked-file workflow; Libraries covers the shared file surface itself. > **Note:** A missing control can reflect subscription or context rather than a deleted > feature. Open the relevant library or folder before looking for **New Folder** or > **Upload**. ## Find and navigate library contents The Libraries contents view lets you move from libraries into folders and inspect files in either a tile view or a list view. **Prerequisites** - Have a subscription and permissions that expose the file surface. **Steps** 1. Open Libraries from the Data group. 2. Confirm that the page is the all-files view by checking the `All` readout. 3. Choose a library or folder to move into its contents. ![The Libraries page with the All readout and the main file controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/48825752d28671a2c896068e49461352.png) 4. Use the view that matches your task. | If you need to… | Use | |---|---| | Browse visual tiles and use the library search box | Tile view; enter a term in the search box with the placeholder `Keyword to Search...` | | Compare item details in columns | List view; select **Switch View** | | Retrieve older cloud content | **Get old cloud** | | Reload the current file list | **Refresh** | 5. In list view, use the visible columns **Name**, **Type**, `Size (B)`, **Tags**, and **Modified** to identify an item. ![The list view with Name, Type, Size (B), Tags, and Modified columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/a10b3d873d2f0cd6f0103398ba5e4cf9.png) 6. Open a library or folder to continue through the hierarchy. 7. Select the item action that matches the item type. | Item type | Available item actions | |---|---| | File | **Open**, **Add/Remove tags**, **Download**, and **Delete** | | Folder or library | **Rename** and **Delete** | 8. Select **Refresh** when you need the current list reloaded. ![The refreshed Libraries list and its current route](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0690694c7efb69a0bc932b7aadcd86af.png) **Result:** You are in the selected library or folder, with its contents shown in the chosen view. Continue with [Create and maintain libraries and files](#create-and-maintain-libraries-and-files) when you need to add or change an item. ## Create and maintain libraries and files Use a library or folder as the place where files belong, then use the item actions for file details and links. | If you need to… | Start with | |---|---| | Create a top-level shared container | **New Library** | | Add a container inside the current library | **New Folder** | | Add one or more files | **Upload**, then **Browse** | | Add a comment or link while working in a popup | **Add** or **Link** | | Change file metadata | **Edit**, **Save**, or **Cancel** | | Download a file | **Download** | | Change file tags | **Add/Remove tags** | | Change a folder or library name | **Rename** | | Remove an item | **Delete** | | Select an upload file | **Browse** | | Export from the declared export modal | **Export** | | Shared popup action | **Save**, **Cancel**, **Upload**, **No**, **Yes**, **Ok**, or **Don't Save** | Choose the procedure that matches the change you need to make. ### Create a library **Prerequisites** - Be on Libraries in a context where **New Library** is available. - Have the library name and the intended role settings ready. **Steps** 1. Select **New Library**. 2. In the New Library panel, enter the required name in **Library name**. 3. Review the **Roles** area. ![The New Library panel with Library name and the Roles grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/26f40ed5348ee649edbceb9a5043337e.png) 4. Use the **Roles** checkbox when you need to select the role area. 5. Select **OK** in the New Library panel when the role selection requires it. 6. Select **Save** to submit the library. 7. If you do not want to create the library, select **Cancel**. While the request is processed, PAMS shows `Please wait while PAMS is creating your Library...`. If the name duplicates an existing library, PAMS shows `Library Name Already Exists`. After a completed request, PAMS shows `Your request was completed successfully`. **Result:** The New Library panel closes after cancellation or after the save request is submitted. Continue with [Create a folder](#create-a-folder) or [Upload a file](#upload-a-file) to add contents. ### Create a folder **Prerequisites** - Open the library where the folder belongs. - Confirm that **New Folder** is available in the current library context. **Steps** 1. Select **New Folder**. 2. Enter the folder name in the text box with the placeholder `Enter Folder Name..`. 3. Select **Save**. 4. If you decide not to create the folder, select **Cancel**. The name is required and pattern-validated. PAMS can show `This Field Is Required` or `Just '_'‘-''.' And '&' Characters Accepted`. A duplicate folder name produces `Folder Name Already Exists`. During the save request, PAMS shows `Please wait while PAMS is saving your files...`. PAMS can also show `Check mandatory field(s)` when required fields are incomplete. A completed save shows `Data Saved Successfully`. **Result:** The folder request is submitted or the New Folder panel is cancelled. Continue with [Upload a file](#upload-a-file) to add a file to the folder. ### Upload a file Uploading adds one or more selected files to the current library or folder and lets you associate links and a comment. **Prerequisites** - Open the library or folder where the files belong. - Have one or more files ready to select. - Have a file name and any links or comment you want to add. **Steps** 1. Select **Upload**. 2. Select **Browse** and choose one or more files. 3. Enter the required value in **File Name**. 4. Select a value in **Links** when the file must point to an application record. 5. Enter a comment in **Comment** when you need to preserve additional information. 6. Select **Add** to add the comment. 7. Select **Link** to add the selected link to the file. 8. Select **Upload** or **Save** to submit the upload. 9. If you decide not to upload the file, select **Cancel**. PAMS accepts multiple files in the file uploader. It can show `Please Select a file to Upload`, `File Nmae is Required`, `File already Exist`, or `File must have atlest one link`. During processing, it shows `Please wait while PAMS is saving your files...`. **Result:** The upload panel is submitted or cancelled, with any validation message shown beside the condition that stopped submission. Continue with [Edit, open, download, rename, or delete an item](#edit-open-download-rename-or-delete-an-item) to manage the item. ### Edit, open, download, rename, or delete an item Item actions let you inspect a file, change its metadata, retrieve it, rename a container, or remove an item from the current list. **Prerequisites** - Locate the existing item in the current library or folder. - Identify whether the item is a file, folder, or library from **Type**. **Steps** 1. Select the action that matches the item type. | Item type or task | Action | |---|---| | Open a file | **Open** | | Change file tags | **Add/Remove tags** | | Download a file | **Download** | | Rename a folder or library | **Rename** | | Change item details | **Edit**, then change the name or the **Comment** area | | Change file links | Use the **Links** area in the edit-file or edit-file-links state | | Submit an edit | **Save** | | Leave an edit unchanged | **Cancel** | | Remove an item | **Delete** | PAMS can show `{{Target}} Name is required` when an edited name is empty. It can show `Please wait while PAMS is updating your files...` during an update and `Please wait while PAMS is deleting your files...` during deletion. A completed save or update shows `Data Saved Successfully`; a completed deletion shows `Data Deleted Successfully`. **Result:** The selected operation is submitted, or the edit is cancelled. The relevant completion or loading message appears when the operation reaches that point. Continue with [Refresh or retrieve older cloud files](#refresh-or-retrieve-older-cloud-files) to update the current list. ### Refresh or retrieve older cloud files **Refresh** reloads the current list. **Get old cloud** starts a separate older-cloud retrieval path. **Prerequisites** - Open Libraries at the list you want to refresh or retrieve. **Steps** 1. Select **Refresh** to reload the current list. 2. Select **Get old cloud** when you need to start older-cloud retrieval. PAMS can show `Please wait while PAMS is getting your files...` or `Please wait while PAMS is downloading your files...` while file retrieval is in progress. **Result:** The current list is refreshed, or the older-cloud retrieval request is started. The older-cloud result is separate from the current-list refresh. Continue with [Set library roles](#set-library-roles) when you need to review access. ## Set library roles Library roles describe which role can view, create folders, edit, delete, upload, or download within a library. **Prerequisites** - Select the library whose role permissions you need to review. - Have permission to open its Roles surface. **Steps** 1. Open the selected library's action menu. 2. Select the library's **Roles** action. 3. Review the role grid by its columns. | Column | Permission represented | |---|---| | **Roles name** | The role being reviewed | | **View** | Viewing permission | | **New folder** | Folder-creation permission | | **Edit** | Editing permission | | **Delete** | Deletion permission | | **Upload** | Upload permission | | **Download** | Download permission | 4. Use the role controls that appear in the library roles surface to review or change the selected permissions. **Result:** The library roles surface is open with the role names and permission columns visible. If a file operation does not complete, continue with [When a file operation goes wrong](#when-a-file-operation-goes-wrong). ## When a file operation goes wrong Use the message on screen to identify whether the operation needs a value, a valid name, a unique item, a file, or a link. | What you see | What it means | What to do | |---|---|---| | `This Field Is Required` | A required name field is empty | Enter the missing library, folder, or file name, then select **Save**. | | `Just '_'‘-''.' And '&' Characters Accepted` | The entered name fails the name pattern | Replace the name with a value accepted by the name rule. | | `Check mandatory field(s)` | One or more mandatory fields are incomplete | Check each required field before selecting the committing action. | | `Library Name Already Exists` | The library name duplicates an existing library | Enter a different library name. | | `Folder Name Already Exists` | The folder name duplicates an existing folder | Enter a different folder name. | | `Please Select a file to Upload` | No upload file was selected | Select a file with `Browse`. | | `File Nmae is Required` | The upload file name is empty | Enter a value in **File Name**. | | `File already Exist` | The file already exists | Review the current contents before submitting another upload. | | `File must have atlest one link` | The file has no required link | Add a link with **Links**, **Add**, and **Link**. | | The Libraries surface is replaced by subscription-upgrade content | Your subscription does not include Libraries | Contact the PAMS administrator about the subscription that provides Libraries. | | No dialog, message, saved value, or stage/status change appears | The operation did not produce a visible completion outcome | Check the current list and the selected library or folder before repeating the operation. | If a control is absent, check the current subscription and library context. When the file is linked to a record, use the operation's owning record page. ## Continue with linked files The **Link** action adds a selected link to a file. Linked-file work can continue from parent record screens that include the shared files component; those records own the record-specific workflow, while Libraries owns the shared file surface. Continue with [Activities and attachments on a sales job](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-activities-and-files), [Comments, files, and history on an MRQ](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/mrq-comments-files-and-history), or the [Reference list](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/reference-list-data) page for reference data used by a **Links** selection. # Units ## What Units are for A unit is a reusable value attached to a sales item. Maintain it in the **Sales** configuration area before using it in sales-item work. | If you need to… | Go to | |---|---| | Check access and prepare a unit name | [Before you start](#before-you-start) | | Open the list or an existing row | [Find the Units list](#find-the-units-list) | | Identify the visible field and shared controls | [Understand the Units list](#understand-the-units-list) | | Choose the maintenance action | [Add, edit, and remove a unit](#add-edit-and-remove-a-unit) | | Add a new value | [Add a unit](#add-a-unit) | | Change an existing value | [Edit a unit](#edit-a-unit) | | Remove an existing value | [Remove a unit](#remove-a-unit) | | Leave an open form | [Cancel an open unit form](#cancel-an-open-unit-form) | | Understand permission and list differences | [Handle access and list variations](#handle-access-and-list-variations) | | Correct a blocked maintenance action | [When maintenance does not work](#when-maintenance-does-not-work) | | Continue to sales-item work | [Use the units in sales items](#use-the-units-in-sales-items) | ![Units list with the Name column and the available list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/4987b9255c5c4960a602ee4e145a1c05.png) ## Before you start The Units page is an authenticated configuration page. Before maintaining a unit, have the unit name that you want to add or change and confirm that your subscription and permissions expose the required actions. | Check | What applies | What it changes | |---|---|---| | Sign-in | You have signed in. | A signed-in session is required to open the page. | | Subscription | Your subscription includes the required configuration. | The Units list and its controls are available. | | New access | **New** is visible. | You can open a new-item form. | | Edit access | The row edit action is visible. | You can change an existing unit. | | Delete access | The row delete action is visible. | You can start the deletion flow. | | Import access | The shared import action is visible. | You can open the import flow. | | Export access | The shared export action is visible. | You can open the export choices. | | Required information | **Name** is required. | A unit cannot be saved without a value in **Name**. | Use the saved list to add a value that is not present or edit an existing value. ## Find the Units list The Units list is the Sales configuration page for units. In the configuration area, open **Sales**, then **Units**. The page title is **Units** under **Sales**. The list displays one column, **Name**. To work with an existing value, select its row in the **Name** column. The available row action depends on your permissions. ![The Units list under Sales configuration](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/4987b9255c5c4960a602ee4e145a1c05.png) ## Understand the Units list The Units list stores one visible value for each sales item unit: **Name**. The list showed 12 rows and displayed **Name** as its only column. | Field or control | Where it appears | What to use it for | |---|---|---| | **Name** | List and new/edit form | Read or enter the unit name; the field is required. | | Hidden system fields | Hidden from the list and form | They are not editable Units fields. | | **New** | Units list | Open a new-item form when new entry is available. | | **Refresh** | Units list | Refresh the visible list. | | **Settings** | Units list | Open the shared list settings. | Use the column headers shown in the list. This list showed only **Name**. Edit, delete, import, and export actions vary with permissions and may not appear in every account. ## Add, edit, and remove a unit Choose the maintenance action that matches the row's condition. | If you need to… | Select or use | Result | |---|---|---| | Create a value that is not in the list | **New**, then **Name**, then the save action | A successful new save appends the new row to the list. | | Correct an existing value | The existing row, then **Name**, then the save action | A successful edit replaces the matching row and closes the popup. | | Remove an existing value | **Delete**, then confirm the deletion | A successful deletion removes the row. | After a new item is saved, the list receives the new row. After an edit is saved, the matching row is replaced and the popup closes. A deletion can be refused when related saved data uses the unit or when it would remove the last remaining row. ### Add a unit Add a unit when its value is not already in the Units list. **Prerequisites** - You are signed in and can see **New**. - You know the unit name to enter. **Steps** 1. In the Units list, select **New**. 2. In the new-item popup, enter the value in **Name**. 3. Select the popup save action labelled **OK**. 4. If the form rejects the value, correct **Name** according to the message shown: | Message | Correction | |---|---| | `Name is required` | Enter a value in **Name**. | | `Just '_' '-' And '.' Characters Accepted` | Use only the characters accepted by the form. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from **Name** and select **OK** again. | 5. After a successful save, confirm that the new value is present in the **Name** column. **Result:** The new unit appears as a row in the Units list. The save-success message is `Data saved Successfully`. ![New Unit popup with the required Name field and modal action](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/fd92a21f24d37e2495e64eadfd1ac0b7.png) ### Edit a unit Edit a unit when an existing value needs a different name and your account has edit access. **Prerequisites** - You are signed in and the row edit action is available. - You know the replacement value for **Name**. **Steps** 1. In the Units list, select the existing unit row. 2. Open the row's edit action. 3. In the edit popup, replace the value in **Name**. 4. Select the popup save action labelled **Save** when it is shown. 5. Confirm that the row now shows the changed value in the **Name** column. **Result:** The matching row shows the changed name, the popup closes after a successful update, and the update-success message is `Data updated Successfully`. ### Remove a unit If **Delete** is available, it removes a row after the confirmation prompt. Deletion is refused when related saved data uses the unit or when only one row remains. The prompt reads `Are you sure you want to delete this item?`; successful deletion displays `Data Deleted Successfully`. ### Cancel an open unit form Cancel an open unit form when you need to leave it without saving. **Prerequisites** - A new or edit popup is open. **Steps** 1. In the open popup, select **Cancel**. 2. If the popup presents these action variants, select the one that matches your intent: | If you need to… | Select | |---|---| | Leave without saving | **Don't Save** | | Commit the current changes | **Save** | | Keep the popup open | **Cancel** | **Result:** The popup closes without saving. ![The page shown after selecting Cancel](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/7908c98f08e107b18cb6966ae064403a.png) ## Handle access and list variations The Units page uses common list controls, so the subscription, permissions, and saved list layout determine which controls and columns you see. | Variation | What to expect | |---|---| | If your subscription includes the required configuration | The Units content is available. | | If **New** is available | You can open a new-item form. | | If the row edit action is available | You can change an existing unit from this list. | | If the row delete action is available | You can start deletion from this list. | | If the shared import action is available | You can open the import flow. | | If the shared export action is available | You can open the export choices. | | If your saved list layout supplies different columns | Use the column headers shown in the list. | This list has no entity-specific import control or entity-specific select, date, numeric, or multi-line field. The Units form uses **Name**. Shared export surfaces, when available, use the messages `Exporting List:`, `Export to Excel`, and `Export to PDF`, with **Cancel** and **Export** as modal actions. ## When maintenance does not work Use the message on screen to choose the correction before repeating the action. | What you see | What it means | What to do | |---|---|---| | `Name is required` | **Name** has no value. | Enter the unit name in **Name**. | | `Just '_' '-' And '.' Characters Accepted` | The value does not meet the accepted-character rule. | Replace disallowed characters in **Name**. | | `Forbidden characters detected. Please remove them and try again.` | The value contains a forbidden character. | Remove it and select **OK** again. | | `Related to Saved data, Can't be deleted` | Saved data uses the unit. | Keep the unit and remove or revise the related saved data through its owning task. | | `Failed to Delete` | The deletion did not succeed. | Keep the row and repeat the action only after checking access and the row's saved-data relationships. | | `Must have at least one item` | The list has reached its minimum of one item. | Keep at least one unit in the list. | If the visible action labels, available permissions, row contents, or toast timing differ, follow the controls shown on your screen. Permission-dependent actions and list columns vary with the shared configuration. ## Use the units in sales items After you maintain a unit here, continue on the sales-item page when you need to assign that value. The Units list is the reference list for sales items. The separate reference-list category question units entity is a different list, even though it uses similar unit wording. For the sales-item task, continue with the Sales job items page. # Cost items Use this page to review, add, edit, remove, and export the cost-item reference entries used in sales configuration. ## Cost items Cost items are the additional-cost descriptions maintained for sales configuration. The Cost items screen is a reference-data list: its entries are available to sales records that use sales configuration reference data. The screen is titled **Additional cost items** and contains the **Item Description** column. | If you need to… | Go to | |---|---| | Check access and conditions before maintenance | [Before you start](#before-you-start) | | Open the list and start a new or existing-item action | [Find Cost items](#find-cost-items) | | Understand the visible list and form | [Understand the Cost items screen](#understand-the-cost-items-screen) | | Add, edit, cancel, or export a cost item | [Add and maintain a cost item](#add-and-maintain-a-cost-item) | | Remove an item or respond to a refusal | [Handle ordering and removal](#handle-ordering-and-removal) | | Match a message to the next safe action | [When maintenance does not work](#when-maintenance-does-not-work) | | Continue to related sales reference data | [After maintaining cost items](#after-maintaining-cost-items) | ![Cost items list with Item Description rows and the list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6b83d39b2165f41051aa4e965d265b79.png) ## Before you start Cost items maintenance depends on the subscription and access conditions for the action you want to take. Check the condition that matches your task before relying on a control being available. | Task | Condition | What to check | |---|---|---| | View the list | The subscription feature is included. | The Cost items list is available instead of the subscription upgrade surface. | | Add an item | The subscription feature is included and the new action is not hidden. | **New** is visible. | | Edit an item | The subscription feature is included and edit access is allowed. | The row's edit action is available. | | Delete an item | Delete access is allowed. | The row's delete action is available. | | Complete the form | The new/edit popup is open, an item is selected, the column is visible in the form, and its type is `text-box`. | **Item Description** is available in the form. | | Check required data | The visible column has its required flag set. | **Item Description** carries a required marker. | The list's columns come from the configuration for the entity. The field label, visibility, type, and required state therefore follow that configuration. > **Note:** Use the headers and required marker currently visible in your list and form. ## Find Cost items The Cost items list is the place to inspect the additional-cost entries before opening a new-item or existing-item action. Look for the page title **Additional cost items**. The list shows **Item Description** and the buttons **New**, **Refresh**, and **Settings**. | If you need to… | Select or use | |---|---| | Start a new item | **New** | | Reload the list | **Refresh** | | Open list settings | **Settings** | | Open an existing item | The edit action for the row in **Additional costs** | | Remove an existing item | The delete action for the row in **Additional costs** | | Export list data | The list action that opens **Export** | **Steps** 1. Open the page titled **Additional cost items**. 2. Choose the action for the task. | If you need to… | Select | |---|---| | Start a new item | **New** | | Edit an existing item | The edit action for the row in **Additional costs** | **Result:** The Cost items list remains open, or the selected new-item or existing-item form is open. ![Additional cost items list with Item Description and the New, Refresh, and Settings controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6f6db7bfd79799c00b579cde35b536e5.png) ## Understand the Cost items screen The Cost items screen combines a list with a new/edit popup. Export opens a list of export choices. Use the values and controls visible in your list and popup. | Surface | What appears or applies | |---|---| | List container | The list displays the configured cost-item entries. | | Export surface | Export opens a list of export choices. | | List data | The visible column list comes from the Cost items configuration. | | Visible form field | **Item Description** is the visible form field. | | Required state | **Item Description** is required when its configured required flag is set. | | Hidden form values | `DisplayOrder`, `Id`, and `CompanyID` are hidden. | | Other form fields | The Cost items settings declare no other visible form field. | | List navigation | The list shows no column headers or paging. | | List filtering | Search-panel, filter-row, and header-filter controls are disabled for this configuration. | The form displays a field only when the new/edit popup is open, an item is selected, the column is visible in the form, and the field is a text box. The visible form is therefore centered on **Item Description** rather than on the hidden identifier values. ![New Additional cost items form with the required Item Description field](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ec7eb40f260cb9b6a39e8271eeb68ec6.png) ## Add and maintain a cost item Use this procedure to create or change a cost-item description, cancel a change, or export the list. The form's visible field is **Item Description** and its required validation message is `Item Description is required`. **Prerequisites** - The Cost items list is open. - The subscription feature is included. - **New** is visible for a new item, or the edit action for the row in **Additional costs** is available for an existing item. - You have the description to enter. **Steps** 1. Choose the maintenance action. | If you need to… | Select | |---|---| | Create an item | **New** | | Change an existing item | The edit action for the row in **Additional costs** | 2. In **Item Description**, enter the cost-item description. 3. Check that **Item Description** carries its required marker. 4. Choose the form action. | If the form shows… | Select | |---|---| | The shared save action | **Save** | | The new-item action | **OK** | | No commit is wanted | **Cancel** | 5. Choose the next maintenance action. | If you need to… | Select | |---|---| | Add another entry | **Add more** | | Finish without another entry | **Cancel** | 6. Open the list action that provides **Export**. 7. Select **Export**. The new-item form shows the title `New Additional cost items` and the action `OK`. A successful new save uses `Data saved Successfully`; a successful update uses `Data updated Successfully`. **Result:** The new or edited cost item is submitted through the visible commit control, or the form closes without a commit after **Cancel**. When the save succeeds, the corresponding success message appears. ## Handle ordering and removal Removal is the row-maintenance branch for a cost item. Check that the selected row is the one you intend to remove; saved data can prevent deletion. **Prerequisites** - The Cost items list is open. - Delete access is allowed. - The delete action for the row in **Additional costs** is available. **Steps** 1. Select the delete action for the row in **Additional costs**. 2. Read the confirmation message: `Are you sure you want to delete this item?`. 3. Choose the confirmation action. | If you want to… | Select | |---|---| | Remove the item | **Delete** | | Keep the item | **Cancel** | 4. Choose the next maintenance action. | If you need to… | Select | |---|---| | Add another entry | **Add more** | | Finish maintenance | **Cancel** | **Result:** The selected row is submitted to the delete branch after **Delete**, or the confirmation branch closes without deletion after **Cancel**. A successful deletion uses `Data Deleted Successfully`. ## When maintenance does not work Use the exact message on screen to choose the next safe action. These messages apply to Cost items validation, filtering, saving, updating, and deletion. | Message | What to do | |---|---| | `Item Description is required` | Enter a value in **Item Description**, then submit the form again. | | `Just '_' '-' And '.' Characters Accepted` | Replace unsupported characters in **Item Description** with characters accepted by the form. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the filter input, then submit the filter again. | | `Must have at least one item` | Keep at least one cost item in the list. | | `Related to Saved data, Can't be deleted` | Keep the item because saved data is related to it. | | `Failed to Delete` | Do not assume the item was removed; return to the list and verify the row before taking another action. | | `Data saved Successfully` | Check the list for the new cost item. | | `Data updated Successfully` | Check the selected row for the updated description. | | `Data Deleted Successfully` | Check the list to verify that the selected item was removed. | ## After maintaining cost items After maintenance, return to **Additional costs** and confirm that the list is open. Use **Refresh** when you need to reload the list after a change. Cost items are sales configuration reference data. Continue with the related reference or sales-record page for the next task: - [Margin items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-margin-items) - [Item units](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-item-units) - [Sales job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-record) **Result:** The **Additional costs** list is open and ready for the next sales-configuration task. # Margin items A margin item is a sales configuration definition that describes an item, selects its margin basis, and sets a default percentage. ## Margin items at a glance The list is headed **Mark up items**. It contains saved margin-item definitions and opens the same fields for new and existing entries. | If you need to… | Go to | |---|---| | Open the list | [Find Margin items](#find-margin-items) | | Open a blank definition | [Open the list or a new item](#open-the-list-or-a-new-item) | | Identify the fields | [List fields](#list-fields) | | Enter or change a definition | [Add or edit a definition](#add-or-edit-a-definition) | | Leave without saving | [Close without saving](#close-without-saving) | | Remove a saved definition | [Delete a definition](#delete-a-definition) | | Resolve access or validation problems | [Handle access and validation branches](#handle-access-and-validation-branches) | ![The Mark up items list with its visible columns and rows](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/b62f6f80cc439db882072770e143e246.png) ## Before you start Your subscription and permissions determine which parts of the list you can use. The account's developer mode also affects whether the description of a default item can be changed. | Condition | What you can see or do | |---|---| | The subscription includes the feature | The Margin items grid is shown. | | The subscription does not include the feature | A subscription-upgrade surface is shown instead of the grid. | | The new button is not hidden | **New** is shown when the feature is included. | | You are allowed to edit | **Edit** is available for a row. | | Delete permission is enabled | **Delete** is available from the open row menu. | | Export permission and the export feature are available | **Export** opens the export choices. | | The item is one of the two default item types and developer mode is off | **Item Description** is disabled. | Have a saved row available before editing or deleting. A new definition uses **Item Description**, **Ratio of**, and **Default (%)**. ## Find Margin items Open the Margin items entry in the configuration area to reach the list. ### Prerequisites - You have access to the Margin items feature. ### Steps 1. Open the Margin items entry in the configuration area. 2. Confirm that the page heading is **Mark up items**. 3. Confirm that **New** is visible when you need to create an entry. **Result:** The Margin items list is open under the **Mark up items** heading. Continue with [Open the list or a new item](#open-the-list-or-a-new-item) or [Understand the list and form](#understand-the-list-and-form). ## Open the list or a new item From the list, **New** opens an entry popup without changing saved data. ### Prerequisites - The Margin items list is open. - **New** is visible. ### Steps 1. Select **New**. 2. Confirm that the popup contains **Item Description**. 3. Select **Item Description**. The new-entry form contains **Item Description**, **Ratio of**, and **Default (%)**. ![The new-entry popup with the three margin-item fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/99496ea9038d05cc32198c0043a6982b.png) **Result:** The new-entry popup is open and saved data is unchanged. Continue with [List fields](#list-fields) or [Add or edit a definition](#add-or-edit-a-definition). ## Understand the list and form The list shows saved definitions. The list displays **Item Description**, **Ratio of**, and **Default (%)** as columns, with four rows. The entry form shows the same three configured fields. Your list headers can differ because the list uses saved list configuration. The list also showed **Refresh** and **Settings** icon buttons. When the subscription feature is unavailable, the subscription-upgrade surface replaces the grid. ![The entry fields with their required markers](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/99496ea9038d05cc32198c0043a6982b.png) ### List fields | Field | Type and rule | Form | List | |---|---|---|---| | **Item Description** | Required text box | Yes | Visible column | | **Ratio of** | Required select box; choices come from cost/margin lookup data | Yes | Visible in the list | | **Default (%)** | Required percentage number box; value is restricted from 0 to 100 percent | Yes | Visible column | Some system fields are hidden. You do not enter them, and they do not appear in the list. An additional column can appear in the list without appearing in the form. The **Ratio of** choices come from the cost/margin lookup, so use the choices shown on your page. Column headers are hidden by the configuration, and paging is not configured for this list. Continue with [Add or edit a definition](#add-or-edit-a-definition). ## Add, edit, and delete a margin item Use the available action that matches the change you need. | Need | Action and condition | |---|---| | Create a definition | Select **New** to open a new item. | | Change a saved definition | Select **Edit** for the row when editing is allowed. | | Remove a saved definition | Select **Delete** from the open row menu. | | Commit a new or changed definition | Select **Save** after validation. | | Choose an export option | Select **Export** when export permission and the export feature are available. | | Change list order | Drag rows when drag and drop is enabled; the changed display order is saved. | Continue with [Add or edit a definition](#add-or-edit-a-definition) for field entry, or [Delete a definition](#delete-a-definition) for removal. ## Add or edit a definition Use this procedure for a new margin item or for a saved row that you are allowed to edit. ### Prerequisites - The Margin items list is open. - **New** is visible for a new definition, or **Edit** is available for the selected row. - You have the description, margin basis, and default percentage to enter. ### Steps 1. Select **New** for a new definition, or select **Edit** for the saved row. 2. Enter the item description in **Item Description**. 3. Select the applicable lookup value in **Ratio of**. 4. Enter a percentage from 0 through 100 in **Default (%)**. 5. Select **Save** after all required fields pass validation. The form marks all three fields as required. If a required value is missing, the form can show `Field is required`. If the percentage is outside the allowed range, it can show `Range restricted from 0 - 100 %`. After a successful new record, the page shows `Data saved Successfully`. After a successful edit, it shows `Data updated Successfully`. **Result:** The popup is submitted after validation. Continue with [Close without saving](#close-without-saving) if you opened the form without saving, or [Handle access and validation branches](#handle-access-and-validation-branches) if validation prevents submission. ## Close without saving Select **Cancel** when you do not want to commit the values in the entry popup. ### Prerequisites - The new-entry popup is open. - You do not need to save the values in the popup. ### Steps 1. Select **Cancel**. 2. Confirm that **Item Description** is no longer shown. ![The page state after the close attempt](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3a63b2481aa749f68669c1e9f28a673a.png) **Result:** The close attempt completes without changing data and opens the Cancellation reasons page. Continue with the [Cancellation reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-cancellation-reasons) configuration page. ## Delete a definition Deleting a definition requests removal of the selected row. > **Caution:** Do not delete a default item, a row related to saved data, or the only item > in the list. ### Prerequisites - A saved row is selected. - The row menu is open. - Delete permission is enabled. ### Steps 1. Select **Delete** for the selected row. 2. Read the confirmation `Are you sure you want to delete this item?`. 3. Confirm the deletion only when the row meets the restrictions above. After a successful deletion, the page shows `Data Deleted Successfully`. | Message | Meaning at the delete request | |---|---| | `Default item` | The selected row is a default item. | | `Related to Saved data, Can't be deleted` | Saved data is related to the row. | | `Failed to Delete` | The deletion failed. | | `Must have at least one item` | The list must retain at least one item. | **Result:** The selected row is submitted for deletion when the confirmation and restrictions permit it. A successful deletion shows `Data Deleted Successfully`. Continue with [Handle access and validation branches](#handle-access-and-validation-branches). ## Handle access and validation branches Use the row that matches what you see on screen. | What you see or encounter | What to do | |---|---| | The subscription-upgrade surface appears instead of the grid | Follow your subscription access requirements before maintaining Margin items. | | **New** is absent | Check that the feature is included and that the new button is not hidden. | | **Edit** is unavailable | Check that editing is allowed for the row. | | **Delete** is unavailable | Check that delete permission is enabled and that the row menu is open. | | **Export** is unavailable | Check export permission and the export feature. | | **Item Description** is disabled for a default item | Use developer mode when the account is permitted to edit that default description. | | A required field is empty | Complete the required field. The form can show `Field is required`. | | **Default (%)** is outside the allowed range | Enter a value from 0 through 100. The form can show `Range restricted from 0 - 100 %`. | | Forbidden characters are detected | Remove the forbidden characters, then select **Save**. The message is `Forbidden characters detected. Please remove them and try again.` | **Result:** The available fields and actions match the subscription, permissions, configuration, and validation outcome. Continue with Cost items or Item units for related sales configuration. ## After maintaining the list This page is a reference for the Margin items entity tab: its fields, its maintenance actions, and the conditions that change those actions. The passing check completed without changing data. Create, update, delete, reorder, import, and export outcomes remain outside that check. For the sibling sales configuration references, see Cost items and Item units. Import upload and import confirmation belong to the shared configuration import flow; record history filters and registration details belong to the record history surface; and subscription-upgrade content belongs to the subscription access surface. # Delivery terms Delivery terms are named choices and codes that administrators maintain for use in sales work. Use them to keep the choices and labels used in sales work consistent. ## Before you start You need a signed-in user, access to the subscribed configuration, and the name and code to enter. | Before you start | Why it matters | |---|---| | Sign in to the application. | The Delivery terms screen requires a signed-in user. | | Confirm that your subscription includes this configuration. | The list appears when the subscribed feature includes it; otherwise the screen shows the subscription-upgrade surface. | | Confirm that you can create, edit, or delete entries as needed. | **New**, the edit control in a row, and the delete menu each depend on the corresponding permission. **New** also depends on the list data being loaded. | | Prepare the term name and code. | **Name** and **Code** are required fields. | Open the list first. Then choose whether to review its fields, add or edit an entry, or delete one. ## Find the Delivery terms list Open the Delivery terms entry from the application's configuration navigation. **Prerequisites** - You are signed in and have access to the subscribed configuration. **Steps** 1. Open the Delivery terms entry in the configuration navigation. 2. Review the rows in the Delivery terms list. 3. Select an existing row when you need to work with it. ![Review the Delivery terms rows and the New, Refresh, and Settings actions.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/70f044cd8201c4feb243c86c26abb180.png) **Result:** The Delivery terms list is on screen, and an existing row is selected when you need to edit or delete it. Review the fields and shared actions before maintaining an entry. ## Understand the list and form The Delivery terms screen has a list for choosing an entry and a form for maintaining its name and code. The list displays these two columns: | Visible column | Rule | |---|---| | Name | Required text box | | Code | Required text box | Other reference-list tabs belong to separate lists, not to Delivery terms. The toolbar also includes **Export**, which opens export options, and **Add more**, which opens another reference-list area. > **Note:** The list displayed **Name** and **Code**. Use the headers visible on your screen. ![Identify the Name and Code columns and the shared list actions.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/211a61f02f2c0b3f6ffc13c4008a9767.png) When you know which row and fields to use, add a new entry or edit the selected entry. ## Add or edit an entry Both fields are required. Choose the task that matches the row you need to maintain. | If you need to… | Use | |---|---| | Create a term | [Add a new entry](#add-a-new-entry) | | Change a term | [Edit an existing entry](#edit-an-existing-entry) | ### Add a new entry **Prerequisites** - The Delivery terms list is open. - You have permission to create entries. - You have the term name and code. **Steps** 1. Select **New**. 2. In the new-entry form, enter the term name in **Name**. 3. Enter the term code in **Code**. 4. Select **Save**. If a required value is missing, the form can show these messages: - `Name is required`. - `Code is required`. If a value contains a forbidden character, the form can show: - `Forbidden characters detected. Please remove them and try again.`. - `Just '_' '-' And '.' Characters Accepted`. ![Enter the required Name and Code values in the New Delivery Term form.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d3c5c48a16555134b199d59ce8a846a2.png) **Result:** The form is open with the term name and code entered, or it displays the matching validation message. ### Edit an existing entry **Prerequisites** - The Delivery terms list is open. - You have permission to edit entries. - The entry you want to change is visible in the list. **Steps** 1. Select the edit control in the row. 2. Change the value in **Name** or **Code**. 3. Select **Save**. The edit control copies the row into the selected item and opens the edit form. A successful save uses the message `Data saved Successfully`; a successful update uses `Data updated Successfully`. **Result:** The edit form opens with the selected row copied into the selected item. If a validation message appears, correct the value before checking the deletion and access options. ### Leave the form If you leave a form after changing a value, the leave-form prompt uses these messages: - `Leaving Page` - `Do you want to save your changes?` **Prerequisites** - The form contains a changed value. - The leave-form prompt is open. **Steps** 1. Choose how to leave the form: | If you need to… | Select | |---|---| | Keep the changes | **Save** | | Leave without saving the changes | **Don't Save** | **Result:** The changes are kept or left unsaved according to your choice. ## Handle delete and access branches Access and subscription settings determine which maintenance controls appear. Check what is available before attempting a deletion. | What you see | What it means | |---|---| | The **New** action is available | Creating entries is allowed and the list columns and data are loaded. | | The edit control is available in the row | Editing entries is allowed. | | The delete menu is available | Deleting entries is allowed. | | The subscription-upgrade surface appears | The subscribed feature does not include this configuration. | ### Delete a selected entry **Prerequisites** - The Delivery terms list is open. - You have permission to delete entries. - More than one item exists when you select **Delete**. **Steps** 1. Select the delete control in the row. 2. Select **Delete** in the delete menu. The product can report `Data Deleted Successfully`, `Related to Saved data, Can't be deleted`, `Failed to Delete`, or `Must have at least one item`, depending on the deletion result and the number of items remaining. **Result:** The selected row is submitted for deletion, or the applicable deletion message appears. Use that message to correct a maintenance problem. ## When maintenance goes wrong Use the message on screen to choose the correction that matches the problem. | What you see | What to do | |---|---| | `Name is required` | Enter a value in **Name**. | | `Code is required` | Enter a value in **Code**. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the value. | | `Just '_' '-' And '.' Characters Accepted` | Use only the accepted characters indicated by the message. | | `Related to Saved data, Can't be deleted` | Keep the related entry or remove the saved data that prevents deletion. | | `Failed to Delete` | The deletion did not complete; retry from the selected row or contact your administrator. | | `Must have at least one item` | Keep at least one Delivery terms item. | **Prerequisites** - A maintenance message is displayed. **Steps** 1. Read the maintenance message in the table. 2. If the message identifies a required or forbidden value, correct that value in **Name** or **Code**. 3. Select **Save** after correcting the value. 4. If the message concerns deletion, select the delete control in the selected row. 5. Select **Delete** to retry the deletion. **Result:** The corrected value is submitted again, or the deletion is retried from the selected row. ## After maintaining Delivery terms Sales work uses the maintained values in its own screens. Sibling tabs lead to other reference lists. | If you need to… | Open | |---|---| | Maintain item units | [Item units](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-item-units) | | Maintain payment methods | [Payment methods](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-payments-methods) | | Maintain guarantee types | [Requested guarantee](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-requested-guarantee) | | Work with a sales job | [Sales job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-record) | | Continue to offers | [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers) | | Continue to orders | [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) | # Payment methods Maintain the payment-method entries that sales work uses when it validates a sales date. ## Payment methods A payment method is a configuration entry identified by a readable **Name** and a **Code**. Sales-date validation uses the payment method's identifier, so keep both values recognisable to the people who select the method in sales work. For example, the list can contain `Direct Transfer` with the code `Direct Transfer`, `Cash Against Documents` with `CAD`, and `Letter of Credit` with `L/C`. | If you need to… | Go to | | --- | --- | | Open the list and locate an entry | [Find the Payment Methods list](#find-the-payment-methods-list) | | Check access and prepare for maintenance | [Before you start](#before-you-start) | | Understand the fields before changing a record | [Understand the list and form](#understand-the-list-and-form) | | Add an entry | Add a payment method | | Remove an entry | [Delete an entry](#delete-an-entry) | | Search, filter, import, or export list data | [Handle delete, filter, import, and export branches](#handle-delete-filter-import-and-export-branches) | | Maintain delivery terms instead | [Delivery terms](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-delivery-terms) | | Return to the configuration area | [Configuration home](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) | | Continue to sales work that consumes the method | [Sales job information and assessment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-information-and-assessment) | ## Before you start Open **Configuration > General settings > Payment Methods** for this maintenance task. The available actions depend on your access. > **Note:** A row displayed in this list is a company record value, not a configuration default. ## Find the Payment Methods list Open **Configuration > General settings > Payment Methods** and look for the page text `Payment Methods`. The list shows **Name** and **Code** columns, `Count: 3`, and rows such as `Direct Transfer`, `Cash Against Documents`, and `Letter of Credit`. These rows are company data, not defaults to copy into another company. ![Locate a payment method by its Name and Code, then choose a list tool](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/8f7b5e7871755fce3af06af73aeff5a5.png) **Steps** 1. Locate the entry by reading the **Name** and **Code** columns, then choose the list tool that matches your task. | If you need to… | Select | | --- | --- | | Find a particular entry | The keyword search input | | Reload the list | **Refresh** | | Change the visible list layout | **Table Layout** | | Change list settings | **Settings** | **Result:** The `Payment Methods` page shows the current rows, and you can choose the list tool that matches your task. Use the field reference below before changing a record. ## Understand the list and form The grid shows **Name** and **Code**. The form shows **Description** and **Code**. | Surface | What to use | | --- | --- | | Grid | **Name** and **Code** are visible. | | Form | **Description** and **Code** are visible. | Use the Add a payment method section to enter a new payment method. ## Add or edit a payment method Add a payment method when sales work needs another payment-method choice. **Prerequisites** - You are on the `Payment Methods` list. - You have access to **New**. **Steps** 1. Select **New**. 2. Enter values in **Description** and **Code**. 3. Select the result you need in the shared popup. | If you need to… | Select | | --- | --- | | Commit the entry | **Save** | | Leave the form without committing it | **Cancel** | When **New** opens the form, the shared popup opens for a new entry. The save success message is `Data saved Successfully`. **Result:** The form is submitted or cancelled through the shared popup. Return to the list actions to remove, filter, or export entries. ## Handle delete, filter, import, and export branches | If you need to… | Use | How to proceed | | --- | --- | --- | | Remove the selected row | **Delete** in the delete menu | Use [Delete an entry](#delete-an-entry). | | Show a row of filters | **Filter Row** in **Settings** | Use [Filter or export the list](#filter-or-export-the-list). | | Open export choices | **Export** in the list menu | Use [Filter or export the list](#filter-or-export-the-list). | | Export the list | **Export to Excel** or **Export to PDF** | Choose the format shown in the export options. | ### Delete an entry Delete a selected company record when it is no longer needed. **Prerequisites** - You are on the `Payment Methods` list with the row selected. - You have access to **Delete**. **Steps** 1. Choose the delete-menu action that matches your task. | If you need to… | Select | | --- | --- | | Remove the selected row | **Delete** | | Leave the row unchanged | **Cancel** | Selecting **Delete** asks `Are you sure you want to delete this item?`. A successful deletion displays `Data Deleted Successfully`. **Result:** The selected row is deleted, or the delete menu closes without an action when you select **Cancel**. ### Filter or export the list Use this procedure to narrow the list, refresh it, or choose an export format. **Prerequisites** - You are on the `Payment Methods` list. - You have access to **Export** when you need the export branch. **Steps** 1. Choose one list action. | If you need to… | Select | | --- | --- | | Search by keyword | The keyword search autocomplete | | Show the filter row | **Filter Row** in **Settings** | | Reload the grid | **Refresh** | | Open export choices | **Export** | | Export as a spreadsheet | **Export to Excel** | | Export as a document | **Export to PDF** | The **Refresh** tooltip uses `Updated around a minute ago` for an update around one minute ago, or the exact message `Updated ` + minutes + ` minutes ago` for a longer interval; the interface replaces `minutes` with the elapsed number. The available export choices are **Export to Excel** and **Export to PDF**. **Result:** The selected list action is applied. ## When maintenance goes wrong Use **Name**, **Code**, **Description**, and the list actions above when correcting a payment method entry. ## After maintaining payment methods Refresh the list after adding or deleting an entry. The displayed rows and `Count: 3` represent company records, not defaults. Confirm the resulting **Name** and **Code** values in the grid before sales work relies on the entry. Sales-date validation uses the payment-method identifier, so the maintained entry is part of the sales work that consumes payment methods. **Result:** The `Payment Methods` list is refreshed and you have checked the company row that sales work will use. # Guarantee types Maintain the guarantee types that sales staff select when they record a requested guarantee on a sales record. ## Guarantee types at a glance A guarantee type is a named option in the guarantee-type list. Each type has a required name. Administrators maintain this list before sales staff record a requested guarantee. The job-guarantee record keeps a reference to the selected guarantee type, so adding a type first gives sales staff an option to select when they record the request. | If you need to… | Go to | |---|---| | Check access and permitted actions | [Before you start](#before-you-start) | | Open the list or start a type | [Find a guarantee type](#find-a-guarantee-type) | | Check the list column and form field | [Understand the list and form](#understand-the-list-and-form) | | Add, change, or remove a type | [Maintain guarantee types](#maintain-guarantee-types) | | Use list tools | [Handle permissions and list settings](#handle-permissions-and-list-settings) | | Resolve an unavailable or unexpected action | [When an action does not work](#when-an-action-does-not-work) | ## Before you start Open the **Guarantee Types** page from the configuration area. The actions available to you depend on your permissions. | Action | Permission condition | |---|---| | **New** | Create permission | | Edit button at the end of each row | Edit permission | | Delete menu | Delete permission | | **Export** menu item | Export permission | | **Import** menu item | Import permission | Continue to [Find a guarantee type](#find-a-guarantee-type) when you know whether you are locating an existing type or adding one. ## Find a guarantee type The **Guarantee Types** page is the list where you locate an existing type or open a new guarantee type surface. **Prerequisites** - You can open the configuration area. - You know whether you are locating an existing type or adding one. **Steps** 1. Open the **Guarantee Types** page from the configuration area. 2. Confirm that the page title is **Guarantee Types**. ![The Guarantee Types page with the list and page title](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f707db293010a0aa1e18c1591a885845.png) 3. To locate a type, enter a search term in **Keyword to Search...**. 4. To start a type, select **New**. ![The new guarantee type surface opened from the list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2bbbcabd54818a58351849699df253b6.png) The new surface opens without changing pages. The list displays a **Name** column. Any displayed row count and **Count** value are transient list data and can change. **Result:** You are on the Guarantee Types list with a row to work on, or the new guarantee type surface is open at the same route. Continue to [Understand the list and form](#understand-the-list-and-form) to identify the fields before maintaining a type. ## Understand the list and form The list identifies each guarantee type by **Name**. After you select a guarantee type, the form uses **Guarantee** as the label for that value. | Surface | What you can expect | |---|---| | **Name** column | Filterable and not sortable | | `GuaranteeTypeID` data field | Hidden | | `GuaranteeTypeID` action column | Filtering, editing, reordering, searching, sorting, exporting, resizing, and hiding are disabled | | Guarantee form | Appears after you select a guarantee type | | **Guarantee** field | The form label for **Name**; the label is required | | Grid editing | Updating, deleting, and adding are disabled in the grid declaration | | Column chooser | Disabled | | Paging | Disabled | The new surface displays a required marker beside **Name**. Its visible action is **OK**; **Save** and **Cancel** do not appear on that surface. ![The list showing the Name column and list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/a07f6e5dce7c34bc36bfef21cae41ab7.png) Continue to [Maintain guarantee types](#maintain-guarantee-types) when you are ready to add, change, or remove a type. ## Maintain guarantee types ### Create a guarantee type Add a type when the list does not contain the needed name. **Prerequisites** - You have permission for **New**. - You have the name to enter in the required **Name** field. **Steps** 1. On the Guarantee Types page, select **New**. 2. In the new surface, enter the type name in **Name**. 3. Confirm that the required marker remains satisfied for **Name**. 4. Select **OK**. When the save succeeds, the alert is `Data saved Successfully`. **Result:** The new guarantee type is ready for the Guarantee Types list after a successful save alert. ### Edit a guarantee type Change an existing guarantee type when its name needs updating. **Prerequisites** - An existing row is visible in the Guarantee Types list. - You have edit permission. **Steps** 1. Locate the row you want to change in the **Name** column. 2. Select the Edit button at the end of each row for the row you want to change. 3. Change the value in **Guarantee**. 4. Select the committing action shown on the edit surface. The Edit button at the end of each row appears when your account has edit permission. If the **Name** control is disabled, you cannot change the value. **Result:** The selected guarantee type is open in its edit surface. ### Delete a guarantee type Delete an existing guarantee type when it is no longer needed and your organisation permits its removal. **Prerequisites** - The row to remove is visible in the Guarantee Types list. - You have permission for the **Delete** menu. **Steps** 1. Open the row's action menu. 2. Select **Delete**. 3. Read the confirmation prompt: `Are you sure you want to delete this item?`. 4. In the prompt, select **Delete**. When deletion succeeds, the alert is `Data Deleted Successfully`. **Result:** The delete operation has been submitted, with the success alert confirming completion when it appears. ## Handle permissions and list settings The list tools refresh the rows, change the list view, filter the rows, and open import or export surfaces when your permissions allow them. | Control or setting | What it does or when it appears | |---|---| | **Refresh** | Refreshes the list | | **Table Layout** | Tooltip for the layout button | | **Settings** | Tooltip for the settings button | | **Export** | Opens the export-options surface when your account has export permission | | **Import** | Appears when your account has import permission | | **Filter Row** | Shows or hides the filter row | | File picker | Appears beneath the import instructions in the import popup | **Prerequisites** - You are on the Guarantee Types list. - For **Export** or **Import**, your account has the corresponding permission. **Steps** 1. Select one of the controls in the table below. | Control | Action | |---|---| | **Refresh** | Reload the list | | **Table Layout** | Open the layout control | | **Settings** | Open the settings control | | **Filter Row** | Show or hide the filter row | | **Export** | Open the export-options surface | | **Import** | Open the import surface | | File picker | Select the file picker beneath the import instructions | After **Refresh**, the tooltip reads `Updated around a minute ago` or the dynamic message `Updated ` followed by minutes and ` minutes ago`. **Result:** The selected list setting or permitted import/export surface is on screen. Continue to [When an action does not work](#when-an-action-does-not-work) if the selected action does not produce the expected surface. ## When an action does not work Use these checks when an action is unavailable or its result differs from the expected surface. | What you see | What to check next | |---|---| | **New** is unavailable | Check that your account has create permission. | | The Edit button at the end of each row is unavailable | Check that your account has edit permission. | | **Delete** is unavailable | Check that your account has delete permission. | | **Export** or **Import** is unavailable | Check the corresponding export or import permission. | | To display the form | Select a guarantee type. | | A save error appears | Ask your administrator to check the returned error. | | A delete error appears | Ask your administrator to check the returned error. | | The name is rejected | Check the value in **Name**. | | No success or error alert appears | Check whether the action completed before repeating it. | | A shared popup shows **Don't Save**, **Save**, **Cancel**, **No**, **Yes**, **Ok**, **Upload**, or **Back** | Use the control only when it appears as part of the Guarantee Types action you started. | After resolving the action, return to [Maintain guarantee types](#maintain-guarantee-types) or continue with [related configuration](#continue-with-related-configuration). ## Continue with related configuration The guarantee type is reference data for the sales-record workflow: job-guarantee records keep a reference to the selected type. Add the type before sales staff record the requested guarantee. For the next sales-record task, continue with the Sales job contacts, guarantees, and history page. For other configuration areas, return to Configuration home. # Inquiry types An inquiry type is a Sales configuration value that names the kind of client request an inquiry represents. Staff select the maintained value on an inquiry record. ## Before you start Add or change inquiry types when the kinds of requests your team receives change. The list is available only when the subscription includes the feature; otherwise, the page shows the subscription-upgrade surface. | If you need to… | Go to | |---|---| | Open the inquiry type list | [Find the inquiry types](#find-the-inquiry-types) | | Check the list, form, and actions | [Understand the list and form](#understand-the-list-and-form) | | Maintain an inquiry type | [Add, edit, and remove an inquiry type](#add-edit-and-remove-an-inquiry-type) | | Open list tools or leave a form | [Cancel and export the list](#cancel-and-export-the-list) | | Correct a blocked action | [When validation or an action fails](#when-validation-or-an-action-fails) | The page is titled **Inquiry Types**. **New** is shown when it is not hidden and the subscription surface is available. The **Delete** menu is shown when deletion is allowed. ## Find the inquiry types Open the list from **General settings** > **Configuration** > **Inquiry Types**. **Prerequisites** - The subscription feature is available. - Your account can reach the configuration page. **Steps** 1. Open **General settings**. 2. Select **Configuration**. 3. Select **Inquiry Types**. 4. Confirm that the page heading is **Inquiry Types**. When editing is allowed, an existing row opens in the new/edit popup with its current value. **Result:** The Inquiry Types list is open. If you selected an existing row, its populated new/edit popup is open. Continue with [Understand the list and form](#understand-the-list-and-form). ## Understand the list and form The list identifies each inquiry type by **Name**. The new/edit form exposes **Name** as its only visible field, so maintenance changes one value. | Surface | What to expect | |---|---| | **Name** list column | Visible and filterable; not sortable or editable. | | Identifier columns | Hidden from the list and form. | | Direct row changes | Add, update, and delete actions are not available directly in a row. | | **Name** form field | The only visible field in the Inquiry Type form. | | Required rule | **Name** has a required validation rule. | | Character rule | Text entries must follow a character pattern. | The available list columns depend on your list configuration. The list displays one **Name** column, no entity rows, `No data`, and `Count: 0`; a loading indicator can remain visible while the list loads. > **Note:** Work from the column headers visible in your list because the available columns > depend on the list configuration. The list shows **New**, **Refresh**, and **Settings**. **Refresh** and **Settings** are titled buttons without visible text. The list has no labelled form controls until a form surface is opened. Continue with the maintenance task that matches your need. ## Add, edit, and remove an inquiry type | If you need to… | Use | Shared condition | |---|---|---| | Create a name | **New** | The control is not hidden and the subscription surface is available. | | Change a name | Existing row | Editing is allowed and a row is available. | | Remove a name | **Delete** | Deletion is allowed and more than one item exists. | ### Add an inquiry type Add a new name when the list offers **New** and staff need to select it on an inquiry record. **Prerequisites** - The subscription feature is available. - **New** is shown. - You have the name to enter. **Steps** 1. On the Inquiry Types list, select **New**. 2. In the new/edit popup, enter the inquiry type name in **Name**. 3. Select **Save** in the form. 4. Confirm the message `Data saved Successfully`. **Result:** The new inquiry type is saved and the save result is visible as `Data saved Successfully`. ### Edit an inquiry type When editing is allowed, an existing inquiry type opens in the new/edit popup with its current value. **Steps** 1. In the new/edit popup, change the value in **Name**. 2. Select **Save**. 3. Confirm `Data updated Successfully`. **Result:** The selected inquiry type is updated. ### Remove an inquiry type Removing a name can affect saved data that is related to it, and the list must retain at least one item. | List condition | What happens | |---|---| | Deletion is allowed and more than one item exists | **Delete** deletes the selected inquiry type. | | One item or fewer exists | The delete path produces `Must have at least one item`. | | Saved data is related to the inquiry type | The delete path can produce `Related to Saved data, Can't be deleted`. | **Prerequisites** - The inquiry type row to remove is available. - Deletion is allowed. - More than one item exists in the list. **Steps** 1. Open the selected row's action menu. 2. Select **Delete**. 3. Confirm the message `Data Deleted Successfully` when the deletion succeeds. **Result:** The selected inquiry type is deleted when the permission and list-size conditions allow deletion. Continue with [Cancel and export the list](#cancel-and-export-the-list) for the remaining list actions. ### Cancel and export the list | If you need to… | Select | Result | Scope | |---|---|---|---| | Leave an open modal without completing its action | **Cancel** | The modal action is cancelled. | Outside the Inquiry Types page-specific controls. | | Open list export options | **Export**, when available | The export options surface opens. | Inquiry Types list action. | **Prerequisites** - The Inquiry Types list is open. - To export, export access is available. **Steps** 1. Choose the row that matches your task. **Result:** The selected action is completed: an open modal is cancelled, or the export options surface is open after **Export** when that action is available. ## When validation or an action fails Use the exact message on screen to choose the matching correction. | Message | Recovery action | |---|---| | `Name is required` | Enter a value in **Name**, then select **Save** again. | | `Just '_' '-' And '.' Characters Accepted` | Correct the characters in **Name** before saving. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters, then try the operation again. | | `Related to Saved data, Can't be deleted` | Keep the inquiry type because saved data is related to it. | | `Failed to Delete` | Review the row and deletion conditions before selecting **Delete** again. | | `Must have at least one item` | Keep more than one inquiry type in the list before selecting **Delete**. | After correcting the value or condition, return to the relevant maintenance task. ## Continue with inquiry records or related settings Use the maintained value on inquiry records at the **Inquiry** stage. This page maintains the inquiry-type values; it does not move an inquiry between stages. For another reference list in the same Sales configuration area, continue with [Inquiry status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-inquiry-status). # Order chance Maintain the names available for Order chance in the Sales configuration area. | If you need to… | Go to | |---|---| | Understand what Order chance is used for | [Order chance in the sales flow](#order-chance-in-the-sales-flow) | | Check access and subscription conditions | [Before you start](#before-you-start) | | Open the list or an entry | [Find the Order chance list](#find-the-order-chance-list) | | Identify visible and stored fields | [Understand the list and edit form](#understand-the-list-and-edit-form) | | Add or change an entry | [Add or edit an Order chance entry](#add-or-edit-an-order-chance-entry) | | Remove an entry | [Delete an Order chance entry](#delete-an-order-chance-entry) | | Filter or export the list | Filter and export the list | | Resolve a message or blocked action | [When maintenance goes wrong](#when-maintenance-goes-wrong) | | Maintain related Sales reference data | [After maintaining Order chance](#after-maintaining-order-chance) | ## Order chance in the sales flow Order chance is the named order-chance information held with job-process and offer data. Use this page to review the available names through the shared configuration-list pattern. The page and popup are titled **Order Chance** under **Sales**. | If you need to… | Use this page or related page | |---|---| | Maintain the available names | This page | | Work with the Order chance field on a sales job | [Sales job information and assessment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-information-and-assessment) | | Understand the wider sales flow | [Sales jobs lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle) | ## Before you start Order chance maintenance is available to signed-in users, and the list or upgrade surface depends on subscription availability. | Before you start | What it means on this page | |---|---| | Signed-in access | Sign in before opening the Sales configuration area. | | Subscription included | The configuration list is shown. | | Subscription not included | An upgrade surface is shown instead of the list. | | Available configuration | The fields shown in the list and form depend on the available configuration. | ## Find the Order chance list The Order chance list is the Sales configuration list for these entries. **Prerequisites** - Your account can reach the Order chance route. **Steps** 1. Open **Sales** configuration. 2. Select **Order Chance**. 3. Select **New** when you are creating an entry. 4. Select the data row outside the action column when you are editing an entry. ![Locate the Order Chance list and its entry actions.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0204f63edda4fb604281c56ffed4df6d.png) **Result:** The list is open, or the shared new-item form is open after you select **New**. ## Understand the list and edit form The list shows **Name** as a visible, filterable field. Other stored fields are hidden from the list. | Field or surface | What the page configuration establishes | |---|---| | **Name** | Visible and filterable in the list. | | Other stored fields | Hidden from the list. | | Action column | One shared action column with an empty caption. | When **Name** is available in the form, it is a text field. The form shows the labels and fields made available by the page configuration. The shared form must be valid before saving. Row ordering is enabled and saved for each item after a drop. ## Add or edit an Order chance entry Use the form to create a new entry or update an existing one. Complete the fields that appear in the form; **Name** is a text field when it is shown. **Prerequisites** - The subscription includes Order chance maintenance. - **New** is available when you are creating an entry. - The row is editable when you are changing an existing entry. Choose the starting action: | Task | Start with | |---|---| | Create an entry | Select **New**. | | Change an entry | Select the data row outside the action column. | **Steps** 1. Complete each field that the form marks as required. 2. In the **Name** text field, enter the order-chance name when that field is shown. 3. Select **Save**. 4. If a required-field message appears, complete the named field and select **Save** again. 5. If `Forbidden characters detected. Please remove them and try again.` appears, remove the forbidden characters and select **Save** again. 6. To close the form without saving, select **Cancel**. The shared validator must be valid before the save service call. A new entry uses `Data saved Successfully`; an edited entry uses `Data updated Successfully`. **Result:** The shared form closes after the save path, or **Cancel** closes it without saving. ## Delete an Order chance entry Delete removes the selected row through the shared confirmation path when the action is available. The list must contain more than one item before deletion can run. **Prerequisites** - The selected row is available in the list. - More than one item is in the data source. - Your account has the available delete permission. **Steps** 1. Select **Delete** for the row you want to remove. 2. Confirm the deletion in the list confirmation. 3. Select **Cancel** when the confirmation is not the action you want. When the delete succeeds, the application shows `Data Deleted Successfully`. If the list contains only one item, the action is blocked with `Must have at least one item`. A related saved record can produce `Related to Saved data, Can't be deleted`; another delete failure produces `Failed to Delete`. **Result:** The entry is removed, or the list remains unchanged when you select **Cancel**. ## Filter, refresh, and export the list Use the visible, filterable **Name** field to narrow the list and the shared list toolbar to export its data. **Upload** submits an import file when importing is available. | Action | What it does | Condition | |---|---|---| | **Name** | Filters the visible list by name. | The field is visible and filterable. | | **Export** | Commits the export choice. | The shared list toolbar provides the action. | | **Upload** | Submits an import file. | The import modal is open and importing is available. | **Prerequisites** - The Order chance list is open. **Steps** 1. Enter a name in the visible **Name** filter field. 2. Select **Export** in the shared list toolbar when you need an export. 3. In the import modal, select **Upload** when importing is available. **Result:** The list is filtered or the export choice is committed. Selecting **Upload** submits an import file when importing is enabled. ## When maintenance goes wrong Use the exact message to identify the response, then follow the corresponding action. | What you see | What to do | |---|---| | The required-field message | Complete the required field, then select **Save** again. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters, then select **Save** again. | | `Must have at least one item` | Keep more than one item in the list before selecting **Delete**. | | `Related to Saved data, Can't be deleted` | Keep the related entry instead of deleting it. | | `Failed to Delete` | Review the row and deletion conditions before trying **Delete** again. | | `You are not allowed to View this page!` | Check route access and subscription availability. | | Upgrade surface instead of the list | Check whether the subscription includes this configuration. | ## After maintaining Order chance After a successful maintenance action, the shared screen reports `Data saved Successfully` for a new entry, `Data updated Successfully` for an edit, or `Data Deleted Successfully` for a deletion. For adjacent Sales configuration data, continue with [Offer status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-offer-status), [Order status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-status), or [Inquiry status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-inquiry-status). For related sales-work context, see [Sales job information and assessment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-information-and-assessment) and [Sales jobs lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle). # Offer status Use this page to review the **Offer Status** list and maintain the names that support job-process and offer data in Sales configuration. ## Overview Offer Status is Sales configuration data that supplies the visible names used with job-process and offer data. An administrator maintains these labels when the business needs an additional offer-status name before staff begin working with offers. The page follows the shared configuration-list pattern: open the list, choose the available maintenance action, work with the visible **Name** value, and use the shared form action to finish or cancel the change. | If you need to… | Go to | |---|---| | Reach the Offer Status list | [Find the Offer Status list](#find-the-offer-status-list) | | Check the visible value and stored fields | [Understand the list and form](#understand-the-list-and-form) | | Read the field rules | [Fields](#fields) | | Add or change a label | [Add or change an entry](#add-or-change-an-entry) | | Leave a form without saving | [Close the form without saving](#close-the-form-without-saving) | | Remove a label | [Remove an entry](#remove-an-entry) | | Use list tools | [Use list tools and handle access variations](#use-list-tools-and-handle-access-variations) | | Continue to related Sales work | [Continue with related configuration](#continue-with-related-configuration) | ## Before you start Maintain Offer Status labels before the corresponding names are needed in offer work. Before changing an entry, know the following conditions: | Check | What to expect | |---|---| | Route | Reach **Offer Status** from the Sales configuration area. | | New access | **New** appears when the subscription is included and the new action is not hidden. | | Edit access | The edit action appears when editing is allowed for the account. | | Delete access | The delete menu appears when deleting is allowed for the account. | | Form state | The entry form appears after you open a new entry or select an existing row. | ## Find the Offer Status list The Offer Status list is the Sales configuration surface for reviewing and maintaining offer-status names. **Prerequisites** - You have access to the Sales configuration area. **Steps** 1. Open the Sales configuration area. 2. Open **Offer Status**. 3. Confirm that the page heading reads **Offer Status**. 4. Use the available list action for the task you want to perform. | If you want to… | Use… | |---|---| | Open a new-item form | **New** | | Edit an existing entry | Select a row, then use the edit action when editing is allowed. | | Open deletion controls | Open the delete menu when deleting is allowed. | ![The Offer Status heading, Name column, and list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d27b751a3d92ec6d46f66c4e44060a59.png) **Result:** The Offer Status list is open, with **New**, **Refresh**, and **Settings** visible. Selecting **New** opens the new-item form; the available edit action opens the selected row, and the available delete menu opens deletion controls. ## Understand the list and form The list presents the visible **Name** value, while the form lets you maintain that value through the shared popup. Use the field rules below before changing an entry. The list displays **Name**. The columns shown can depend on the account's configuration, and the action area has no displayed caption. The form appears after an entry is selected or a new entry is opened. **Name** appears only when the account's form configuration includes it. The new-item form shows **Name** and **OK**. ![The new-item form with Name and OK](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/1d86eed3ada9d5c761607527ab02754c.png) ### Fields | Field | What you can do | Requiredness and visibility | |---|---|---| | **Name** | Enter or change the offer-status label. | Text field; visible in the list and editable in the form. Required when configured. | The **Name** required marker depends on the account's form configuration. The validation messages are: - `Name is required`. - `This Field Is Required`. - `Just '_' '-' And '.' Characters Accepted`. > **Note:** The account's form configuration determines whether **Name** is required. ### List behaviour The Offer Status list is a compact reference list. It displays the **Name** column, alternates row shading, hides column headers, and has paging disabled. The visible columns come from the account's configuration. Inline editing, inline adding, and inline deleting are disabled. Use the list actions and shared popup instead of editing a row directly. ## Maintain Offer Status entries Maintaining Offer Status means choosing whether to add a name, change an existing name, or remove a name from the list. The available controls are **New**, the edit action, the delete menu, **Save**, **Cancel**, and **Delete**. Use **New** for a new label, the edit action for an existing row when editing is allowed, and the delete menu for a selected row when deleting is allowed. ### Add or change an entry Add a new offer-status name or correct an existing one from the shared popup. **Prerequisites** - The Offer Status list is open. - You know the label to enter or change. - For a change, an existing row is selected and editing is allowed. **Steps** | If you want to… | Start with… | |---|---| | Add a label | **New** | | Change a label | Select a row, then use the edit action. | 1. Follow the appropriate path in the table: select **New**, or select a row and use the edit action. 2. In the shared popup, enter or change the value in **Name**. 3. Choose the action that matches your outcome. | If you want to… | Select… | |---|---| | Commit the new or edited item | **Save** | | Leave the entry uncommitted | **Cancel** | After a new item is saved, the message is `Data saved Successfully`. After an existing item is updated, the message is `Data updated Successfully`. ![The Name field and shared popup action area before saving](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/1d86eed3ada9d5c761607527ab02754c.png) **Result:** The shared popup closes after **Save** or **Cancel**. A successful new item uses `Data saved Successfully`, and a successful update uses `Data updated Successfully`. ### Close the form without saving Close the new-item form without committing its entry. **Prerequisites** - The new-item form is open. **Steps** 1. Select **Cancel** in the save form. 2. If a leave-without-saving choice appears, select **Don't Save**. ![The screen after leaving the new-item form](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/7908c98f08e107b18cb6966ae064403a.png) **Result:** The form closes without committing the entry. ### Remove an entry Remove an existing Offer Status name when deleting is allowed for your account. **Prerequisites** - The Offer Status list is open. - The row to remove is selected. - The delete menu is available. **Steps** 1. Open the delete menu for the selected row. 2. Select **Delete**. 3. Choose the action that matches your outcome. | If you want to… | Select… | |---|---| | Confirm deletion | Confirm the message `Are you sure you want to delete this item?`. | | Close the delete menu without deleting | **Cancel** | The outcomes are `Data Deleted Successfully`, `Related to Saved data, Can't be deleted`, `Failed to Delete`, and `Must have at least one item`. **Result:** The selected row is deleted only after the delete action is confirmed. ## Use list tools and handle access variations The list shows **Refresh** and **Settings**. **Export** opens the export action. Availability of **New**, edit, delete, export, and upload depends on account access, subscription, or the current form state. | Situation | What to use or expect | |---|---| | Reload the list | **Refresh** is available on the list. | | Adjust the list surface | **Settings** is available on the list. | | Move list data out | **Export** opens the export action. | | Add a list entry | **New** depends on subscription availability and account access. | | Change or remove an entry | Edit and delete depend on account access and the current selection. | | Import list data | **Upload** is available in the import form when importing is enabled. | **Prerequisites** - The Offer Status list is open. **Steps** 1. Select the available list tool that matches your task. | If you need to… | Select… | |---|---| | Reload the list | **Refresh** | | Adjust the list surface | **Settings** | | Move list data out | **Export** | | Add a list entry | **New**, when subscription and account access permit it | | Change an entry | The edit action, when account access permits it and a row is selected | | Remove an entry | The delete action, when account access permits it and a row is selected | | Import list data | **Upload**, when importing is enabled | **Result:** The selected list tool opens or performs its available action. Use the filtering procedure next when you need to narrow the entries. ### Refresh and filter the list Use **Refresh** to reload the list, then identify an entry by its displayed **Name** value. Filtering is subject to the message `Forbidden characters detected. Please remove them and try again.` **Prerequisites** - The Offer Status list is open. **Steps** 1. Select **Refresh** to reload the list. 2. Use the list's available filtering surface to narrow entries by the displayed **Name** value. 3. Remove forbidden characters if the message `Forbidden characters detected. Please remove them and try again.` appears. **Result:** The list is refreshed or filtered using the controls available to your account. ### Export or import list data Use **Export** when the action is available. The import form provides **Upload** when importing is enabled. **Prerequisites** - The Offer Status list is open. - The relevant export or import action is available for your account. **Steps** 1. Select **Export** to open the export action. 2. For an enabled import form, select **Upload** to begin the available upload action. **Result:** **Export** opens the export action. **Upload** is available in the import form when importing is enabled. ## When an Offer Status operation goes wrong Use the message on screen to classify the problem before changing the entry or trying another list action. | What you see | What it means | What to do | |---|---|---| | `Name is required` | **Name** needs a value. | Enter a name in **Name** and save again. | | `This Field Is Required` | A required field is empty. | Enter the required value and save again. | | `Just '_' '-' And '.' Characters Accepted` | The entered **Name** fails the character rule. | Correct **Name** using the accepted characters. | | `Forbidden characters detected. Please remove them and try again.` | The filter contains forbidden characters. | Remove the forbidden characters and filter again. | | `Related to Saved data, Can't be deleted` | The selected entry is related to saved data. | Keep the entry or resolve the related saved data before deleting. | | `Failed to Delete` | The delete operation failed. | Check whether the delete action is available and try again only when appropriate. | | `Must have at least one item` | The list cannot lose its last item. | Keep at least one Offer Status entry. | ## Continue with related configuration Offer Status is used with job-process and offer data. Its list surface is shared with related reference lists. Continue with: - [Configuration home](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) to reach related configuration areas. - [Order chance](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-chance) for a sibling Sales configuration list. - [Order status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-status) for another sibling Sales configuration list. - [Inquiry status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-inquiry-status) for another sibling Sales configuration list. - [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers) for the sales-work context that uses Offer Status data. - [Sales job lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle) for the wider sales-flow context. # Order status Use this page to find the Sales **Order status** list, maintain its **Name** values, remove values when permitted, and open the list's export action. ## Before you start Use **Name** to maintain the values used by your company. You need a signed-in account, a subscription that includes the feature, and permission for the action you want to take. | If you need to… | Go to | |---|---| | Check access and subscription conditions | [Find the Order status list](#find-the-order-status-list) | | Identify the visible value and stored fields | [Understand the list and its fields](#understand-the-list-and-its-fields) | | Add or change a value | [Add or edit a value](#add-or-edit-a-value) | | Remove a value | [Remove a value](#remove-a-value) | | Open the export action | [Export the list](#export-the-list) | | Resolve a validation, access, or deletion problem | [When maintenance does not work](#when-maintenance-does-not-work) | | Continue to another configuration area | [Continue with related Sales settings](#continue-with-related-sales-settings) | ## Find the Order status list The list appears when your subscription includes the feature. Otherwise, an upgrade surface appears. **New** can be hidden by subscription exclusion or a hidden new-entry setting. The edit action appears when your account can edit, and the delete menu appears when your account can delete. **Steps** 1. Sign in. 2. Open the Sales reference-list destination available to your account. **Result:** The Order status list is open. Continue with [Understand the list and its fields](#understand-the-list-and-its-fields). ## Understand the list and its fields The Order status list is where you review status names before opening a new or existing entry. **Steps** 1. Confirm that the list shows the **Name** column. 2. Confirm that **New**, **Refresh**, and **Settings** are available when your account permits them. 3. Select **New** to open a new-entry form. 4. Select the edit action for a selected row when editing is available. 5. Open the delete menu for a selected row when deleting is available. ![Inspect the Name column and available list actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c52bfb38c7799d678de032991ff4eb74.png) ![Inspect New, Refresh, Settings, and the Name column](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f40626b7a42b9f932478ad2c72867ea4.png) | Field or surface | What it does | |---|---| | **Name** | Visible list column and form field for the status name. | | Display position | Hidden value used to control ordering. | | Record reference | Links each saved value to its stored record. | | Company value | Hidden stored value. | | List headers | Disabled for this entry. | | Row filter | Disabled for this entry. | | Filtering | No header filtering is available for this entry. | | Paging | Disabled for this entry. | | Change a value | Open the edit form from the row's edit action. | | Remove a value | Use the row's delete action to open the delete menu. | **Result:** You know which list actions are available and where to start maintenance. Continue with [Add or edit a value](#add-or-edit-a-value), [Remove a value](#remove-a-value), or [Export the list](#export-the-list). ## Add, edit, and remove a status value The list uses **Name** as its visible column and form field. The other stored values support the list without appearing as customer-entered fields. ### Add or edit a value Use this procedure to enter a new **Name** or change the name of an existing row. **Prerequisites** - The Order status list is open. - You know the name to enter or change. - For an edit, the selected row is available and editing is permitted. | If you need to… | Start with… | |---|---| | Add a value | Select **New**. | | Edit a value | Select the row, then use the edit action. | If a validation message appears, use this table before selecting **OK** again. | Message | Action | |---|---| | `Field is required` | Enter a value in **Name**. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from **Name**. | | `Parsed server error text` | Correct the value shown in **Name**. | **Steps** 1. Select **New**, or select a row and use the edit action. 2. In **Name**, enter the new status name or change the existing name. 3. Choose one path: | If you want to… | Do this | |---|---| | Save the value | Select **OK** when the form is valid. | The new form shows **Name**, **OK**, and the heading `New Order Status`. **Name** has no required marker on the shown form. ![Inspect the New Order Status form with the Name field and OK action](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/8ac05d667f2c603ea9596bb025a15c60.png) After a valid new row is saved, `Data saved Successfully` appears. After a valid edited row is saved, `Data updated Successfully` appears and the list reloads. If you leave with unsaved changes, `Do you want to save your changes?` appears. **Result:** The valid value is committed and the list reloads after **OK**. ### Remove a value Remove a selected status value when deletion is permitted and the value is not needed by saved data. **Prerequisites** - The Order status list is open. - The row to remove is selected. - The delete menu is available. **Steps** 1. Open the delete menu for the selected row. 2. Select **Delete**. 3. Review `Are you sure you want to delete this item?`. 4. Choose one path: | If you want to… | Do this | |---|---| | Remove the row | Confirm the deletion through the prompt. | | Close the delete menu | Select **Cancel**. | The product can show `Data Deleted Successfully` after deletion. It can refuse a row related to saved data with `Related to Saved data, Can't be deleted`, report a failed operation with `Failed to Delete`, or protect the last remaining value with `Must have at least one item`. **Result:** The selected row is removed only after the deletion is confirmed and the operation succeeds. ## Export the list Use the shared **Export** action to open the list's export operation. **Prerequisites** - The Order status list is open. - **Export** is available in the shared toolbar. **Steps** 1. Select **Export**. **Result:** The export operation opens. ## When maintenance does not work | What you see | What to do | |---|---| | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from **Name**, then select **OK** again. | | `Field is required` | Enter a value in **Name**, then select **OK** again. | | `Related to Saved data, Can't be deleted` | Keep the related value or resolve the saved-data relationship before deleting. | | `Failed to Delete` | Check that the delete menu is available, then review the row before taking another deletion action. | | `Must have at least one item` | Keep at least one Order status value in the list. | | **New** is missing | Check that the subscription includes the feature and that new entries are available. | | Edit is missing | Check that your account can edit. | | Delete is missing | Check that your account can delete. | | The list or fields differ | Use the labels and actions currently available on your screen. | | `Do you want to save your changes?` appears | Review the prompt before leaving the form. | ![Inspect the screen after cancelling the form](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/7908c98f08e107b18cb6966ae064403a.png) ## Continue with related sales settings Continue with one of these related Sales configuration lists: - [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) - [Offer status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-offer-status) - [Inquiry status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-inquiry-status) - [Lost reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-lost-reasons) - [Regret reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-regret-reasons) - [Cancellation reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-cancellation-reasons) # Inquiry status ## Overview Inquiry Status is Sales configuration data: a list of names with one visible, required **Name** field. Maintain those names through the shared configuration-list pattern. | If you need to… | Go to | |---|---| | Check access, subscription, and available actions | [Before you start](#before-you-start) | | Open the list | [Find the Inquiry Status list](#find-the-inquiry-status-list) | | Understand the column and form field | [Understand the list and form](#understand-the-list-and-form) | | Add a name | [Add a status](#add-a-status) | | Change a name | [Edit a status](#edit-a-status) | | Remove a name | [Delete a status](#delete-a-status) | | Use the export action | [Export the list](#export-the-list) | | Resolve a blocked or unexpected action | [When an Inquiry Status operation goes wrong](#when-an-inquiry-status-operation-goes-wrong) | | Continue with related Sales configuration | [Continue with related sales configuration](#continue-with-related-sales-configuration) | ## Before you start Before you maintain Inquiry Status names, use a signed-in account with the subscription and permissions required for the action you need. When the subscription feature is included, the shared screen loads the grid configuration and requests the list. When it is not included, the screen shows the upgrade surface instead of the grid. | Check | What changes on this page | |---|---| | Subscription feature included | The grid configuration loads and the list is requested. | | Subscription feature not included | The upgrade surface appears instead of the grid. | | The new-entry action is available | **New** is available when the subscription surface is available. | | Edit permission available | A data-row click can open the edit popup. | | Delete permission available | **Delete** can appear in the popup menu. | | Export permission available | **Export** can appear in the toolbar. | Follow your organisation's approval practice before saving or deleting. > **Note:** The **Delete** action appears only when your permissions allow it. When these checks are complete, open the list. ## Find the Inquiry Status list The Inquiry Status list is the Sales configuration list for these names. Open the Sales configuration area and select **Inquiry Status**. **Prerequisites** - You can open the Sales configuration area. - The subscription feature is available for the shared list surface. **Steps** 1. Open the Sales configuration area. 2. Select **Inquiry Status**. 3. Confirm that the page title is **Inquiry Status**. 4. If **New** is available, select it to open the new-entry popup. 5. To edit an existing entry, select its data row outside the action cell when edit permission is available. ![The Inquiry Status list with its Name column and list actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f65749ef07f51de3e7140b3ef614022e.png) **Result:** The Inquiry Status list is open, or the new-entry popup is open after you select **New**. Review the list and form before maintaining an entry. ## Understand the list and form Inquiry Status uses one visible list column and one visible form field: **Name**. The field is a required text box. | Field or surface | What to expect | |---|---| | **Name** | The only visible list column and the only configured visible form field; it is required. | | Form field | **Name** is the only visible field and is required. | | New entry | The **Name** field appears in the new-entry popup. | | Existing entry | The **Name** field appears in the edit popup. | The form must be valid before the item is saved. An invalid form does not save the item. ![The Inquiry Status page with the Name column and toolbar actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2a610b35285c6f0be0d8fcc820619278.png) The list has one **Name** column. Select **New** or a data row to open a form. ## Add, edit, delete, and export Inquiry Status entries The shared popup and list toolbar provide the maintenance actions for Inquiry Status. Use **New** to create an entry, select a data row to edit it when edit permission is available, and use **Save** or **Cancel** in the popup. Use **Delete** from the popup menu when delete permission is available. Use **Export** from the toolbar when export permission is available. | Task | Shared action | Condition | |---|---|---| | Create an entry | **New**, then **Save** | **New** is not hidden and the subscription surface is available. | | Edit an entry | Data-row selection, then **Save** | Edit permission is available and the click is outside the action cell. | | Leave without saving | **Cancel** | The shared popup is open. | | Delete an entry | **Delete** | Delete permission is available and the list has more than one item. | | Export the list | **Export** | Export permission is available. | The visible list actions were **New**, **Refresh**, and **Settings**. **New** appeared as a text button; **Refresh** and **Settings** appeared as titled buttons without visible text. ### Add a status Use this procedure to add a new name to the Inquiry Status configuration list. **Prerequisites** - The subscription feature is available. - **New** is available. - Your organisation's approval practice permits the change. | If… | Then… | |---|---| | The **Name** field contains a value | Select **Save**. | | The **Name** field is invalid | Enter a value in **Name**, then select **Save**. | | You do not want to save | Select **Cancel**. | **Steps** 1. On the Inquiry Status list, select **New**. 2. In the new popup, enter the status name in the **Name** text box. 3. Follow the matching row in the table. When the form is valid, **Save** saves the item. An invalid form does not save the item. When creation succeeds, the shared action uses the message `Data saved Successfully`. The required messages are `Field is required` and `Name is required`. ![The new-entry action and the Name field location on the Inquiry Status screen](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2a610b35285c6f0be0d8fcc820619278.png) **Result:** The new name is saved when the form is valid, or the popup remains available for correction or closing. Continue with [Edit a status](#edit-a-status), [Delete a status](#delete-a-status), or [Export the list](#export-the-list). ### Edit a status Use this procedure to change the name of an existing Inquiry Status entry. **Prerequisites** - An existing data row is available. - Edit permission is available. - Your organisation's approval practice permits the change. | If… | Then… | |---|---| | The **Name** field contains a valid value | Select **Save**. | | The **Name** field is invalid | Enter a value in **Name**, then select **Save**. | | You do not want to save | Select **Cancel**. | **Steps** 1. Select the data row outside its action cell. 2. In the edit popup, change the value in the **Name** text box. 3. Follow the matching row in the table. When the form is valid, **Save** saves the item. An invalid form does not save the item. When the edit succeeds, the shared action uses the message `Data updated Successfully`. The required messages are `Field is required` and `Name is required`. **Result:** The changed name is saved when the form is valid, or the popup remains available for correction or closing. Continue with [Delete a status](#delete-a-status) or [Export the list](#export-the-list). ### Delete a status Use this procedure to remove an Inquiry Status entry when your organisation permits its removal. The **Delete** action is available only when more than one item exists. **Prerequisites** - The row to remove is available. - Delete permission is available. - More than one item exists in the list. - Your organisation's approval practice permits the deletion. | List and permission condition | Delete path | |---|---| | Delete permission available and more than one item exists | **Delete** is available. | | One item or fewer exists | Deletion is prevented and `Must have at least one item` is shown. | | Delete permission unavailable | The **Delete** action is not available to the account. | **Steps** 1. Open the selected row's popup menu. 2. Select **Delete** when the action is available. The delete path can show `Related to Saved data, Can't be deleted` for a related saved record, `Failed to Delete` for another delete failure, or `Data Deleted Successfully` after a successful deletion. **Result:** The entry is deleted after a successful deletion. Continue with [Export the list](#export-the-list) or [When an Inquiry Status operation goes wrong](#when-an-inquiry-status-operation-goes-wrong). ### Export the list Use this procedure to start the list export action when export permission is available. **Prerequisites** - The Inquiry Status list is open. - Export permission is available. **Steps** 1. Select **Export** in the toolbar. **Result:** The export action is selected. Continue with [When an Inquiry Status operation goes wrong](#when-an-inquiry-status-operation-goes-wrong) if the action does not work. ## Handle access and runtime branches The Inquiry Status screen changes according to subscription access, permissions, and the page settings. When the subscription feature is included, the grid configuration loads and the list is requested; when it is not included, the upgrade surface appears instead of the grid. | Branch | What you see or can do | |---|---| | The new-entry action is available | **New** is available when the subscription surface is available. | | Edit permission is available | A row click outside the action cell opens the edit popup. | | Delete permission is available | **Delete** can appear in the popup menu. | | Export permission is available | **Export** can appear in the toolbar. | The list shows **New**, **Refresh**, and **Settings** when those actions are available, and its visible column is **Name**. Use the matching message in the next section when an action is blocked or produces an unexpected result. ## When an Inquiry Status operation goes wrong Use the exact message to identify the response, then follow the matching action. | What you see | What to do | |---|---| | `Field is required` | Complete the required field, then select **Save** again. | | `Name is required` | Enter a value in **Name**, then select **Save** again. | | `Must have at least one item` | Keep more than one item in the list before selecting **Delete**. | | `Related to Saved data, Can't be deleted` | Keep the related saved data instead of deleting this entry. | | `Failed to Delete` | Review the row and deletion conditions before selecting **Delete** again. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters before trying the operation again. | After resolving the message, return to the relevant maintenance procedure or continue with related Sales configuration. ## Continue with related sales configuration Use this page to maintain Inquiry Status names. Continue to the related Sales pages for their own reference lists and sales-job work. Continue with the sibling Sales configuration pages for [Inquiry types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-inquiry-types), [Offer status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-offer-status), [Order status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-status), [Lost reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-lost-reasons), [Regret reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-regret-reasons), and [Cancellation reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-cancellation-reasons). For the adjacent sales subject, continue with the Sales job record page. # Lost reasons Maintain the names that explain why a sales job reached **Lost**, then use a maintained name when the sales record is recorded as lost. ## Lost reasons at a glance A lost reason is Sales configuration data that names why a sales job reached **Lost**. The **Lost Reasons** page is a Sales configuration list with one visible, required **Name** field. The list is limited to the **Lost** sales-job status, and a lost record carries the selected name. Maintain these names by opening the list, adding or editing a name, selecting the edit or delete control in the selected row, or selecting **Export** for list output. For example, an administrator can add a competitor-won reason before an offer is marked lost. The later lost record then has a name for that outcome. | If you need to | Go to | |---|---| | Find the subject list | [Find the Lost reasons list](#find-the-lost-reasons-list) | | Understand the field and list layout | [Understand the list and entry form](#understand-the-list-and-entry-form) | | Add or change a name | [Add or update a reason](#add-or-update-a-reason) | | Remove a name | [Remove a reason](#remove-a-reason) | | Export the list | [Export the list](#export-the-list) | | Compare related Sales reference lists | [Handle access and list variations](#handle-access-and-list-variations) | | Use a maintained reason on a sales job | [Continue after maintaining lost reasons](#continue-after-maintaining-lost-reasons) | The page title is **Lost Reasons**, its parent area is **Sales**, and the entry-form title is **Lost Reason**. ## Before you start The Lost reasons list is reference data for naming a sales job's loss, so decide the names your team needs before maintaining the list. Sign in before opening the visible **Sales** configuration area. The list uses shared configuration rules. The available columns can vary, and the availability of **New**, the edit control in the selected row, the delete control in the selected row, **Export**, and **Import** is permission-controlled. ## Find the Lost reasons list ### Prerequisites - You are signed in. ### Steps 1. Open the visible Sales configuration area. 2. Select **Sales**. 3. Select **Lost Reasons**. 4. Confirm that the page title is **Lost Reasons**. 5. Confirm that the list has a configured **Name** column. 6. Confirm that configured rows appear in the list. 7. Use the list action you need: | If you need to | Select | Purpose | |---|---|---| | Add a reason | **New** | Open a new-item form. | | Reload the list | **Refresh** | Reload the configured rows. | | Work with list settings | **Settings** | Open the list settings. | ![The Lost Reasons list with the Name column, configured rows, New, Refresh, and Settings visible](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/870e41f7a14bf471775a7209768ac299.png) **Result:** The **Lost Reasons** list is on screen with its configured **Name** column, rows, and available list actions. That completes this procedure. ## Understand the list and entry form The entry form records the displayed name. The list repeats that name so you can recognise the reason before opening it. | Surface | What to expect | |---|---| | **Name** in the list | The configured **Name** column is visible. | | **Name** in the form | **Name** is a text box and is required. | | Form title | A new or edited item opens the shared form; a new item uses `New Lost Reason`. | | Configured columns | A column appears in the form only when it is marked for forms. | | Required marker | A field is required only when its configuration marks it required. | | Available columns | The list columns can vary with configuration. | For this list, **Name** is the only visible configured field. Other stored details, including Display order, Company identifier, Status, and Reason type, are not shown in this list or form. ![The required Name text box in the Lost Reason form](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0cf2858808609a05b925d3ae19728555.png) ## Add, update, remove, or export a reason Choose the maintenance action that matches the change you need: | If you need to | Use | |---|---| | Add a new reason | **New** opens a new-item form. | | Change an existing reason | The edit control in the selected row opens that row in edit mode when editing is allowed. | | Submit an addition or change | **Save** submits the new or edited item through the shared popup. | | Export list data | **Export** opens export options and starts export from its footer. | | Import list data | **Import** opens the import flow when import permission is enabled. | Use the procedures below for the conditions and messages attached to each action. ### Add or update a reason Add a new loss-reason name or correct an existing one from the shared Lost Reason form. ### Prerequisites - You are on the **Lost Reasons** list. - **New** is available for an addition, or editing is allowed for the selected row. ### Steps 1. Choose the operation: | If you need to | Select | |---|---| | Add a reason | **New**, which opens a form titled `New Lost Reason`. | | Edit a reason | The edit control in the selected row, when editing is allowed. | 2. In the **Name** text box, enter the name. 3. Confirm that the **Name** field shows a required marker. 4. Complete the form action for the outcome: | If | Select or enter | |---|---| | You are submitting a valid addition or update | **OK**, then **Save**. | | The form reports `Name is required` | Enter a value in **Name**, then select **OK** and **Save**. | | The form reports `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from **Name**, then select **OK** and **Save**. | | You are leaving without submitting | **Cancel**. | For the worked example, enter a name that identifies the competitor-won outcome before the offer is marked lost. ![The Lost Reason form with Save in the popup footer](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0cf2858808609a05b925d3ae19728555.png) **Result:** After a successful addition, the page reports `Data saved Successfully`; after an update, it reports `Data updated Successfully`. ### Remove a reason Remove a configured reason when it is no longer needed. The delete action runs only when more than one item exists. ### Prerequisites - You are on the **Lost Reasons** list. - More than one item exists. - Delete permission is available. - The row to remove is selected. ### Steps 1. In the selected row, select **Delete**. 2. Read the confirmation message: `Are you sure you want to delete this item?`. 3. Select **Delete** to remove the selected item after confirmation. 4. To keep the selected reason, select **Cancel**. If the selected reason is related to saved data, the deletion reports `Related to Saved data, Can't be deleted`. If deletion fails for another reported failure, it reports `Failed to Delete`. If only one item exists, the list reports `Must have at least one item` instead of allowing the last item to be removed. **Result:** Select **Delete** to remove the selected reason; select **Cancel** to leave it unchanged. ### Export the list ### Prerequisites - You are on the **Lost Reasons** list. - Export permission is available. ### Steps 1. Select **Export**. 2. In the export dialog, choose the required export options. 3. Start the export from the export dialog footer. **Result:** The export is started from the export dialog footer. That completes this procedure. ## Handle access and list variations The shared configuration list adapts to company configuration and permissions, so the controls and fields available to you can differ from another account. | Variation | What controls it | |---|---| | Available list columns | The configured columns. | | Fields in the form | A field appears only when it is configured as visible in the form. | | Required marker | The field configuration marks the field required. | | **New** | Permission for creating items. | | Edit control in the selected row | Permission for editing items. | | Delete control in the selected row | Delete permission and the requirement that more than one item exists. | | **Export** | Export permission. | | **Import** | Import permission. | The Sales configuration navigation can also show these sibling labels: | Related loss or cancellation lists | Other Sales configuration lists | |---|---| | **Lost Reasons** | **Units** | | **Regret Reasons** | **Delivery Terms** | | **Cancellation Reasons** | **Payment Methods** | | **Order Cancellation Reasons** | **Guarantee Types** | | | **Account Types** | | | **Offer Status** | | | **Order Status** | | | **Inquiry Status** | | | **Activity purpose** | | | **Order activation conditions** | | | **Additional costs** | | | **Mark up Items** | For related maintenance, see [Regret Reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-regret-reasons), [Cancellation Reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-cancellation-reasons), and [Order Cancellation Reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-cancellation-reasons). ## Out of scope The import flow is outside the procedures on this page. When the import completes, the page reports `Data Importing completed`. ## When maintenance does not work Match the message or screen symptom to the action that produced it. | What you see | What it means | What to do | |---|---|---| | `Name is required` | The required **Name** field has no value. | Enter a value in **Name** and submit the form. | | `Data saved Successfully` | A new reason has a save-success response. | Return to the list and use the configured rows. | | `Data updated Successfully` | An edited reason has an update-success response. | Return to the list and use the configured row. | | `Data Deleted Successfully` | The selected reason has a delete-success response. | Continue with the remaining configured rows. | | `Related to Saved data, Can't be deleted` | Saved data is related to the selected reason. | Keep the reason available for that saved data. | | `Failed to Delete` | The delete operation failed. | Keep the reason and investigate the failed deletion before retrying. | | `Must have at least one item` | The list contains only one item. | Keep at least one reason in the list. | | The page remains in a loading view while the list is unavailable. | The list has not become available. | Wait for the list to become available before maintaining a reason. | ## Continue after maintaining lost reasons A lost record carries a selected lost-reason name. The wider sales-job lifecycle owns the operational use of **Lost**; this page maintains the reference names. After maintaining a name, continue in [Sales job information and assessment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-information-and-assessment) when you need to work with the sales job that uses the reason. Use [Sales jobs lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle) when you need the wider flow around **Lost**. The shared configuration list also exposes sibling reference lists, including [Regret Reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-regret-reasons), [Cancellation Reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-cancellation-reasons), and [Order Cancellation Reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-cancellation-reasons). # Regret reasons ## Regret reasons at a glance Regret reasons are Sales configuration data used to describe why an offer reaches the **Regretted to Offer** sales outcome. The shared reference screen is titled **Regret Reasons**. | If you need to… | Go to | |---|---| | Find the list and open its new-entry form | [Find the regret reasons list](#find-the-regret-reasons-list) | | Identify the field and stored values used by the form | [Understand the list and form](#understand-the-list-and-form) | | Choose the right maintenance path | [Add or maintain a regret reason](#add-or-maintain-a-regret-reason) | | Add a new reason | [Add a new reason](#add-a-new-reason) | | Change an existing reason | [Change an existing reason](#change-an-existing-reason) | | Close a form without submitting it | [Leave a form without saving](#leave-a-form-without-saving) | | Review related Sales reference lists | [What to do next](#what-to-do-next) | | Return to the surrounding sales workflow | [Missed, regretted, and cancelled jobs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/missed-regretted-and-cancelled-jobs) | | Read the broader stage flow | [Sales jobs lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle) | ## Before you start Sign in before opening the Sales configuration list. The available actions depend on your subscription, permissions, and saved list layout. | Check before you begin | What it changes | |---|---| | The Sales subscription includes this feature | **New** is available only when the subscription is included and the new-button condition allows it. | | Editing is allowed for your account | The row edit action is available only when editing is allowed. | | The selected item and a visible form column are available | The edit form requires a selected item and a column that is visible in the form. | | The visible tabs | Use the tabs shown on the screen to choose an available reference list. | Use the visible page and tabs to choose what your account can open. ## Find the regret reasons list **Prerequisites** - You are signed in. - Your account can open the Sales configuration area. **Steps** 1. Open **Configuration**. 2. Open **Sales**. 3. Select **Regret Reasons**. 4. Confirm that the list shows the **Name** column. 5. Confirm that **New**, **Refresh**, and **Settings** are visible. 6. Select **New**. The new-entry form is titled **New Regret Reason**. ![The list with New, Refresh, Settings, and the Name column](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d97c67d2559d1c82b7a8caa1a84788ea.png) ![The form titled New Regret Reason](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/50adaf65da5033078bfd6f1ca5fcece5.png) **Result:** The **New Regret Reason** form is open over the regret-reason list. ## Understand the list and form The list identifies regret reasons through the **Name** column. The form uses the same Name value as a required text box, while the other stored fields remain hidden from editing. The columns shown depend on your saved list layout. **Name** is a visible list column. The form field appears only when the form is open, an item is selected, and the column is visible in the form. | Form or list value | What you see | |---|---| | **Name** | A required text box in the edit form and a list column. | | `DisplayOrder` | Hidden and not editable. | | `ReasonID` | Hidden and not editable. | | `CompanyID` | Hidden and not editable. | | `StatusID` | Hidden and not editable. | | `ReasonTypeID` | Hidden and not editable. | The open form shows the required **Name** field and **OK**. While the form is open, the list retained **New**, **Refresh**, and **Settings**. ![The required Name field in the open form](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/50adaf65da5033078bfd6f1ca5fcece5.png) ![The open form with the OK control](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/50adaf65da5033078bfd6f1ca5fcece5.png) ## Add or maintain a regret reason Choose a maintenance path from the list. | If you need to… | Use this path | |---|---| | Start a new reason | Select **New**, then follow [Add a new reason](#add-a-new-reason). | | Change an existing reason | Use the icon-only edit action on the reason row when editing is allowed, then follow [Change an existing reason](#change-an-existing-reason). | | Leave without submitting | Select **Cancel**, then follow [Leave a form without saving](#leave-a-form-without-saving). | | Export the list | Use **Export** when the shared display and subscription conditions allow it. | ### Add a new reason Use this procedure to open the new-reason form and complete its required field. **Prerequisites** - The regret-reason list is open. - **New** is visible. - The Sales subscription includes this feature and the new-button condition allows the action. **Steps** 1. Select **New**. 2. Confirm that the form title is **New Regret Reason**. 3. Enter the reason in the required **Name** text box. 4. Confirm that **OK** is visible. ![The OK control beneath the required Name field](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/50adaf65da5033078bfd6f1ca5fcece5.png) **Result:** The **New Regret Reason** form remains available with a completed required **Name** field and **OK** visible. ### Change an existing reason Use the icon-only edit control to change the **Name** of an existing regret reason when editing is allowed. **Prerequisites** - The regret-reason list is open. - Editing is allowed for your account. - The selected item and a visible form column are available. **Steps** 1. Select the icon-only edit action on the reason row. 2. Change the value in **Name**. 3. Confirm the changed value in **Name**. **Result:** The edit form contains the changed **Name** value. ### Leave a form without saving Select **Cancel** to close the open form without submitting its data. **Prerequisites** - The regret-reason form is open. - The form's **OK** control is visible. **Steps** 1. Select **Cancel**. 2. Confirm that the form's **OK** control is absent. **Result:** The form is closed without a visible dialog, and its **OK** control is no longer visible. ## Delete a reason ## Handle access and setup variations The shared configuration screen can show different actions and fields for different subscriptions, permissions, and saved column layouts. It serves multiple reference entities, so the visible entity list and tabs belong to the shared screen. | Variation | What changes | |---|---| | Subscription inclusion and the new-button condition | **New** is available when both conditions allow it. | | Editing permission | The row edit action is available when editing is allowed. | | Form state and column visibility | A form field appears when the form is open, an item is selected, and the field is visible in the form. | | List layout | The columns shown depend on your saved list layout. | | Shared screen | Visible tabs can navigate to sibling reference lists. | If a field or action is absent, check the subscription, editing permission, and saved column layout before treating the data as missing. ## When maintenance does not work The form responds to forbidden characters with a validation message. A loading indicator can remain visible while the list is loading. | What you see | What to do | |---|---| | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from **Name**, then try the form action again. | | A loading indicator remains visible | Refresh the page and check the list again. | Work from the headers visible in the list because its columns come from the current column configuration. ## What to do next The screen's visible tabs can take you to sibling reference lists. | Continue with… | Open | |---|---| | Lost-reason reference data | [Lost reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-lost-reasons) | | Cancellation-reason reference data | [Cancellation reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-cancellation-reasons) | | Order-cancellation reference data | [Order-cancellation reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-cancellation-reasons) | | Missed, regretted, and cancelled sales jobs | [Missed, regretted, and cancelled jobs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/missed-regretted-and-cancelled-jobs) | | The complete sales lifecycle | [Sales jobs lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle) | **Result:** The visible tabs provide a route to related Sales configuration and workflow pages. The form is not submitted. # Cancellation reasons A cancellation reason is a sales configuration value assigned when sales work is cancelled. Maintain these values in **Cancellation Reasons**. ## Overview Use this page to review, add, edit, delete, filter, or reorder cancellation reasons. | If you need to… | Go to | |---|---| | Prepare to maintain the list | [Before you start](#before-you-start) | | Open the list | [Find the cancellation-reason list](#find-the-cancellation-reason-list) | | Identify the field and popup | [Understand the list and form](#understand-the-list-and-form) | | Choose a maintenance action | [Maintain cancellation reasons](#maintain-cancellation-reasons) | | Add a reason | [Add a cancellation reason](#add-a-cancellation-reason) | | Edit a reason | [Edit a cancellation reason](#edit-a-cancellation-reason) | | Delete a reason | [Delete a cancellation reason](#delete-a-cancellation-reason) | | Find or reorder a reason | [Search, filter, and use list tools](#search-filter-and-use-list-tools) | | Check why a surface is absent | [Handle access and surface variations](#handle-access-and-surface-variations) | | Respond to a message | [When an action does not work](#when-an-action-does-not-work) | ![Cancellation reasons list with the Name column and five rows](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0add7deaf0e4f2a4a011f0ce168b35d8.png) ## Before you start The cancellation-reason list requires a signed-in session. Have the reason name ready before you add or change an entry, and confirm that your subscription and permissions provide the action you need. | Task | What you need first | |---|---| | Open the list | A signed-in session | | Add a reason | The required subscription, visible **New**, and the reason name | | Edit a reason | Edit permission and an existing row | | Delete a reason | Delete permission and an existing row | | Complete the form | A value for required **Name** | > **Note:** This list is filtered for cancelled sales work. ## Find the cancellation-reason list Prerequisites - You are signed in. Steps 1. Open **Sales**. 2. Select **Cancellation Reasons**. 3. Confirm that the list contains five rows when the same list composition is in use. ![Cancellation reasons list with New, Refresh, Settings, and the Name column](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/fe5cdbb64b7e472838008fd13afade4e.png) **Result:** The **Cancellation Reasons** list is open. ## Understand the list and form The list contains available cancellation reasons, and the form edits the selected reason's **Name**. Selecting a row opens its existing entry when editing is available. | Surface | What you see | |---|---| | List | The visible column is **Name**. | | Form | A required **Name** text box. | | Popup | **New Cancellation Reason** with **OK**. | Filtering is enabled for **Name**. The form shows **Name** when the popup is open, an item is selected, and the field is available. Other record details are not shown as list columns or form fields. ![New Cancellation Reason popup with the required empty Name field and OK](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/1bfe00330aae1a8880b719d7d3359b82.png) ## Maintain cancellation reasons Choose the action that matches the change you need. The available actions depend on the surface and permission conditions. | Need | Control | Condition or result | |---|---|---| | Create a reason | **New** | Available when the subscription includes this list and the action is available. | | Enter or change a reason | **Name** | Available in the new/edit popup. | | Commit a new or changed reason | **Save** | Submits when required fields are valid. | | Leave the popup | **Cancel** | Closes or cancels the popup. | | Leave unsaved changes | **Don't Save** | Closes the unsaved-changes choice. | | Edit a row | edit action in the row | Available when editing is allowed. | | Open deletion | delete action in the row | Available when deletion is allowed. | | Confirm deletion | **Delete** | Submits only when more than one item remains. | | Change display order | Drag and drop | Saves the changed order when the configured list permits it. | ### Add a cancellation reason Add a reason when cancelled sales work needs another selectable explanation. Prerequisites - The **Cancellation Reasons** list is open. - **New** is visible. - You have the reason name to enter. Steps 1. Select **New**. 2. In **Name**, enter the cancellation reason. 3. Select **Save**. The new reason is submitted after validation. A successful new record uses the message `Data saved Successfully`. **Result:** The new cancellation reason is submitted through the new-item popup. ### Edit a cancellation reason Edit a reason when its wording needs to change. Prerequisites - The **Cancellation Reasons** list is open. - An existing reason is available. - The row exposes an edit action in the row. Steps 1. Select the edit action in the row. 2. Change the value in **Name**. 3. Select **Save**. The change is submitted after validation. A successful update uses the message `Data updated Successfully`. **Result:** The selected cancellation reason is submitted with its changed **Name**. ### Delete a cancellation reason Delete a reason only when removing it is appropriate for the remaining choices. The list must contain more than one item for deletion to be submitted. Prerequisites - The **Cancellation Reasons** list contains more than one item. - The row exposes a delete action in the row. - You have confirmed that removing the reason will not affect saved data. Steps 1. Select the delete action in the row. 2. Select **Delete** in the confirmation menu. | If | Then | |---|---| | The deletion succeeds | The message is `Data Deleted Successfully`. | | Only one item remains | Keep the item; the message is `Must have at least one item`. | | Saved data is related to the reason | Keep the reason; the message is `Related to Saved data, Can't be deleted`. | | The deletion fails | Check the list before taking another deletion action; the message is `Failed to Delete`. | **Result:** The selected reason is deleted only when more than one item remains and the request succeeds. ## Search, filter, and use list tools | Tool or behaviour | Use | |---|---| | **Name** filtering | Filter by reason name. | | **Refresh** | Refresh the list. | | **Settings** | Open list settings. | | **Export** | Available from **Settings** when **Export** is enabled. | | Drag and drop | Reorder the list when the configured list permits it. | ## Handle access and surface variations | Surface | What controls it | |---|---| | **New** | The subscription includes the list and the action is available. | | edit action in the row | You are allowed to edit the selected row. | | delete action in the row | You are allowed to delete the selected row. | | **Name** in the form | The new/edit popup is open, an item is selected, and **Name** is available. | | Entire page | You are signed in. | The shared list can display a subscription-unavailable surface instead of the list when the subscription does not include this configuration. ## When an action does not work Use the message on screen to correct the entry before submitting the action again. | Message | Safe next action | |---|---| | The **Name** field is required. | Enter a value in **Name**, then select **Save**. | | `Forbidden characters detected. Please remove them and try again.` | Remove forbidden characters from **Name**, then select **Save**. | | `Must have at least one item` | Keep at least one cancellation reason. | | `Related to Saved data, Can't be deleted` | Keep the related reason. | | `Failed to Delete` | Check the list before taking another deletion action. | ## Continue with related sales lists Continue with the list that matches your next task: - [Regret reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-regret-reasons) - [Lost reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-lost-reasons) - [Order cancellation reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-cancellation-reasons). - [Payment methods](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-payments-methods) - [Order chance](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-chance) - [Inquiry status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-inquiry-status) For the broader sales-work context, see [Missed, regretted, and cancelled jobs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/missed-regretted-and-cancelled-jobs) and [Sales jobs lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-jobs-lifecycle). # Order cancellation reasons Maintain the names that staff can use when an order is assigned the cancelled-order state. ## Order cancellation reasons An order cancellation reason is a name available when an order is assigned `JobStatusE.Cancelled_Order`. Maintain those names for order cancellations; operational order-cancellation work takes place in the sales workflow. For example, `Customer withdrew order` can describe why an order was cancelled when that wording matches your process. | If you need to… | Go to | |---|---| | Check access and prepare a reason name | [Before you start](#before-you-start) | | Open the maintained list | [Find the order cancellation reasons list](#find-the-order-cancellation-reasons-list) | | Recognize the list and entry form | [Understand the list and entry form](#understand-the-list-and-entry-form) | | Add a reason | Maintain a reason | | Understand subscription and permission differences | [Handle access and list variations](#handle-access-and-list-variations) | | Correct a validation or maintenance message | [When maintenance does not succeed](#when-maintenance-does-not-succeed) | | Continue to operational order work | [Use the maintained reasons in the sales workflow](#use-the-maintained-reasons-in-the-sales-workflow) | | Maintain general sales cancellation reasons | [Cancellation reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-cancellation-reasons) | | Work with orders | [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) | | Follow the order-to-outcome hand-off | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) | ## Before you start Prepare the reason name before opening the entry form. Confirm that your account exposes the actions you need. | Before you start | What to confirm | Why it matters | |---|---|---| | Subscription | The subscription includes the order-cancellation-reason feature | The list is available when the feature is included. | | Edit access | Your account is allowed to edit | The row edit action depends on edit access. | | Delete access | Your account is allowed to delete | The row delete action depends on delete access. | | Entry information | The reason name you want to maintain | **Name** is the required entry field. | ## Find the order cancellation reasons list Open the list to review or maintain the names used with cancelled orders. Prerequisites - You are signed in. - The subscription includes the order-cancellation-reason feature. Steps 1. Open **Configuration**. 2. Open **Sales**. 3. Select **Order Cancellation Reasons**. 4. Select **New** to open the new-item form. The list opens with **New**. The new-item form contains **Name**; selecting **Cancel** leaves the existing data unchanged. ![Open the list from Configuration > Sales and locate New](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/02861d9529fd9dcaf5e197860674aa8b.png) **Result:** The order cancellation reasons list or the new-item form is open. ## Understand the list and entry form The list displays one visible column, **Name**. The entry form maintains that reason name. | Surface | What you see | |---|---| | List column | **Name** | | List size | The list shows four rows and `Count: 4`. | | New-entry dialog | The dialog title is `New Order Cancellation Reason`. | | Entry field | **Name** is required. | | Entry control | **OK** is shown in the new-entry dialog. | | Grid headers | Column headers are hidden for this entity. | The visible field set is the set configured for the list when you open it. Only **Name** appears as a visible field. It has no select box, date box, percentage box, amount box, or array field. The configured list determines which columns and fields appear. Work from the columns and fields visible on your screen. > **Note:** The list shows four rows with `Count: 4` when four reasons are maintained. ![Recognize the New Order Cancellation Reason dialog and its required Name field](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f6c26962233165f8008d4a79a73031f8.png) ## Add, change, and remove a reason Use **New** to add a reason. The actions available for existing reasons depend on the subscription and access conditions in [Before you start](#before-you-start). Add a reason when staff need another explanation for a cancelled order. Prerequisites - The order cancellation reasons list is open. - **New** is visible. - You have the reason name to enter. Steps 1. Select **New**. The `New Order Cancellation Reason` dialog opens. 2. Enter the reason in **Name**. 3. Select **Save**. The form validates the entry, saves it after validation succeeds, and closes after a successful response. The success message is `Data saved Successfully`. **Result:** The new reason is saved and the entry form closes after success. If you need a different outcome, use this choice: | If you need to… | Select | |---|---| | Leave the new or edit form without saving | **Cancel** | The shared popup closes without saving the entry. **Result:** The new reason is saved, or the form closes without saving when you select **Cancel**. ## Handle access and list variations The subscription, permissions, and list configuration determine which maintenance surfaces you see. | What changes | What you see or do | |---|---| | Subscription feature is included | The list is shown. **New** is shown when the action is not hidden. | | Subscription feature is not included | A subscription-upgrade surface is shown instead of the list. | | Edit access is allowed | Row editing is available. | | Delete access is allowed | Row deletion is available. | | Runtime list configuration differs | The visible columns and fields follow your configured list. | | **Cancel** is selected | The entry form closes and the order cancellation reasons list is available again. | If **New** is absent, check that the subscription includes the feature and that the action is available to your account. ![Confirm the list surface after cancelling the new-entry form](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/7908c98f08e107b18cb6966ae064403a.png) ## When maintenance does not succeed Use the message you see to correct the entry or keep a protected reason in the list. | Message | Corrective action | |---|---| | `Name is required` | Enter a value in **Name** before selecting **Save**. | | `Just '_' '-' And '.' Characters Accepted` | Correct the **Name** value to meet the accepted-character rule, then select **Save**. | | `Data updated Successfully` | The edited reason was saved successfully. | | `Data Deleted Successfully` | The selected reason was deleted successfully. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from **Name**, then select **Save** again. | | `Related to Saved data, Can't be deleted` | Keep the reason because saved data is related to it. | | `Must have at least one item` | Keep at least one reason in the list. | ## Use the maintained reasons in the sales workflow Maintained order-cancellation reason names are available for the `Cancelled_Order` order state. Maintaining this list does not itself perform an operational order cancellation or change a business stage. When an order is cancelled because the customer withdrew it, a reason such as `Customer withdrew order` gives staff a direct explanation to select if that name is in the maintained list. Continue with [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) for operational order work. For the hand-off from orders to later outcomes, go to [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered). # Account types An account type is a name you assign to classify an account. Use the **Account types** list to maintain these names. ## Account types at a glance | If you need to… | Go to | |---|---| | Understand the list and its controls | [Find and understand the Account types list](#find-and-understand-the-account-types-list) | | Check access and information before changing a record | [Before you start](#before-you-start) | | Create or delete an account type | [Maintain account types](#maintain-account-types) | | Respond to a validation or maintenance message | [When maintenance does not work](#when-maintenance-does-not-work) | | Open another Sales configuration list | [After maintaining account types](#after-maintaining-account-types) | ![Account types list with the Name column and list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/cbafa4ff76182bd113814875ca4cc07b.png) ## Before you start Before opening the list, confirm the access and information needed for your task. | Task | What you need first | |---|---| | Create an account type | The required subscription, an available **New** button, and the name to enter | | Edit an account type | The required subscription and edit access | | Delete an account type | Delete access and a selected account type row | **New** appears only when the subscription is included and the button is not hidden. The edit action requires edit access and the included subscription. The delete action requires delete access. Continue to the list to check which controls are available. ## Find and understand the Account types list The **Account types** list is where you view and maintain account type records. The page heading is **Account types**. The list shows one visible column, **Name**, and the controls **New**, **Refresh**, and **Settings**. | Control | What it does | |---|---| | **New** | Opens the new-item surface. | | **Refresh** | Refreshes the list. | | **Settings** | Opens list settings. | | **Name** | Identifies the account type shown in a row. | Rows provide icon-only edit and delete actions. To create an account type, go to [Create an account type](#create-an-account-type). To delete an account type, go to [Delete an account type](#delete-an-account-type). ![Account types list showing the controls and Name column](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/7a9cf6409cf88d788717c9cede6526c4.png) ## Maintain account types The form exposes **Name** as its only visible field, and **Name** is required. ### Create an account type **Prerequisites** - The required subscription is active. - The list shows **New**. - You have the account type name to enter. **Steps** 1. Select **New**. The new-item popup opens with the title **New Client Type**. 2. In **Name**, enter the account type name. 3. Check that **Name** carries its required marker. **Result:** The **New Client Type** popup remains open with **Name** marked as required and **OK** visible. To review a message, go to [When maintenance does not work](#when-maintenance-does-not-work). ![New Client Type popup with the required Name field and OK control](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ed0fbc586bdc05f4eb8d696752dbb4ce.png) ### Delete an account type To remove an account type, confirm that you have delete access and that the selected row exposes its delete action. **Prerequisites** - You have delete access. - An account type row is selected. - The row exposes its delete icon. **Steps** 1. Select the row’s delete icon. 2. Read the confirmation message: `Are you sure you want to delete this item?` 3. Choose how to finish the confirmation. | If you want to… | Select | |---|---| | Remove the selected account type | **Delete** | | Keep the selected account type | **Cancel** | **Result:** The confirmation menu closes after **Delete** or **Cancel**. To review a message, go to [When maintenance does not work](#when-maintenance-does-not-work). ## When maintenance does not work Use the message on screen to choose the corrective action. | Message | Corrective action | |---|---| | `Name is required` | Enter a value in **Name**. | | `Just '_' '-' And '.' Characters Accepted` | Replace characters in **Name** with characters accepted by the form. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from **Name**, then submit the form again. | | `Are you sure you want to delete this item?` | Confirm the selected row before selecting **Delete**; select **Cancel** to keep it. | | `Related to Saved data, Can't be deleted` | Keep the account type because saved data is related to it. | | `Failed to Delete` | Do not assume the record was removed; return to the list and verify the row before taking another action. | | `Must have at least one item` | Keep at least one account type in the list. | | `Data saved Successfully` | Check the list for the new account type. | | `Data updated Successfully` | Check the selected row for the updated name. | | `Data Deleted Successfully` | Check the list to verify that the selected account type was removed. | ## After maintaining account types After maintaining an account type, open the Sales configuration list for your next reference value. Continue with the related Sales configuration list that matches your next task: - [Units](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-item-units) - [Cost items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-cost-items) - [Margin items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-margin-items) - [Delivery terms](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-delivery-terms) - [Payment methods](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-payments-methods) - [Guarantee types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-requested-guarantee) - [Inquiry types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-inquiry-types) - [Order chance](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-chance) - [Offer status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-offer-status) - [Order status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-status) - [Inquiry status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-inquiry-status) - [Lost reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-lost-reasons) - [Regret reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-regret-reasons) - [Cancellation reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-cancellation-reasons) - [Order cancellation reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-cancellation-reasons). - [Order activation conditions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-activation-conditions). # Order activation conditions Use this page to find the **Order activation conditions** reference list, understand its fields, and open a new entry before working on a sales order. ## Order activation conditions at a glance Order activation conditions are named reference values maintained for the sales-order context. The **Configuration** navigation places this list beside other sales reference lists. | If you need to… | Go to | | --- | --- | | Open the reference list | [Find the Order activation conditions list](#find-the-order-activation-conditions-list) | | Read the visible column and rows | [Understand the list and fields](#understand-the-list-and-fields) | | Open a new condition entry | [Add and maintain a condition entry](#add-and-maintain-a-condition-entry) | | Match a problem to a condition or message | [Handle unavailable actions and messages](#handle-unavailable-actions-and-messages) | | Continue into sales-order work | [Continue with sales-order work](#continue-with-sales-order-work) | | Review the order workflow | [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) | | Review the order-to-delivery hand-off | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) | | Maintain order statuses | [Order status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-status) | | Maintain order cancellation reasons | [Order cancellation reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-cancellation-reasons) | ![The Order activation conditions title and its position among the sales reference lists](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/fac926b66324e3ae4456867c55250a8c.png) ## Before you start Before maintenance, confirm the account's live permissions for editing and deleting rows and confirm that the live entity list is complete for your work. The list displays four rows; confirm that it contains every condition required by your company. | Before maintenance, confirm… | Why it matters | | --- | --- | | The account can edit rows | The row edit action is conditional on editing being allowed. | | The account can delete rows | The row delete action is conditional on deletion being allowed. | | Required conditions appear in the list | Compare the entries with your work requirements. | | Who approves a save or delete | Confirm the approval requirement and approving role before maintenance. | Confirm the rows and permissions, then open the list to review its fields. ## Find the Order activation conditions list The **Order activation conditions** list is the sales reference list for these named sales-order values. Open it from **Configuration** > **Order Activation Conditions**. ### Prerequisites - You are signed in and have access to Configuration. ### Steps 1. In the **Configuration** navigation, select **Order Activation Conditions** from the sales reference-list entries. 2. Confirm that the page title is **Order activation conditions**. 3. Select **New** to begin a new entry. **Result:** The **Order activation conditions** list is open. The new-entry editor opens when you select **New**. ![The list, visible sales reference navigation, and New action](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5e1752fd872c00434dada829b3debbe8.png) ## Understand the list and fields The list is a compact reference table. Its visible business value is the **Name** column, and it contains four rows. | List detail | What you see or use | | --- | --- | | Column | `Name` is the only visible column. | | Count | `Count: 4`. | | Required entry value | **Name** is required in the configuration definition. | | Other details | System-managed details are not shown; **Name** is the maintained value. | | Header display | The list header is not displayed. | | List controls | The list has no labelled list controls; it shows **New** plus icon-only **Refresh** and Settings buttons. | To maintain a condition, enter its value through **Name** in the new-entry editor. ## Use the maintained conditions in sales orders Order activation conditions belong to the sales-order context. Maintain the named values here, then use the [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) page to work on an order. | Next action | Open | | --- | --- | | Maintain a condition value | [Add and maintain a condition entry](#add-and-maintain-a-condition-entry) | | Work on an order | [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) | ## Add and maintain a condition entry Select **New** to open the editor for an order activation condition. The new-entry surface contains a required-marked **Name** field and an **OK** action. ### Prerequisites - You have confirmed the live account's edit or create permission and the approval owner for the change. - You have the condition name to enter. ### Steps 1. Open the [Order activation conditions list](#find-the-order-activation-conditions-list). 2. Select **New**. 3. Confirm that the new-entry editor is open. 4. Enter the condition value in the required-marked **Name** field. 5. Select **OK**. **Result:** The new-entry surface has the required-marked **Name** field and the **OK** action. ![The New Order activation condition surface with the required Name field and OK action](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/feada6d9be0484be40386b993233305c.png) ## Handle unavailable actions and messages If an action is unavailable, check the condition that controls it before continuing. | Situation | Action | | --- | --- | | **New** is available | Select **New** to open the new-entry editor when your subscription includes it and the action is visible. | | Editing is allowed | In the row’s action area, select the icon that opens the editor. | | A row delete action is available | Select **Delete** to open the confirmation when deletion is allowed. | | A save is attempted | Correct the entry and submit it again if validation blocks the save. | | Only one item remains | Keep at least one item in the list. | | If you… | Then… | | --- | --- | | Select **Delete** | Confirm the action when the prompt says `Are you sure you want to delete this item?`. | | Save a new entry successfully | Check for `Data saved Successfully`. | | Save an edited entry successfully | Check for `Data updated Successfully`. | | Delete an entry successfully | Check for `Data Deleted Successfully`. | | Try to delete the last item | Keep one item in the list when the message says `Must have at least one item`. | | Try to delete an item related to saved data | Keep the item when the message says `Related to Saved data, Can't be deleted`. | | Receive a deletion error | Retry after checking the entry when the message says `Failed to Delete`. | | Enter forbidden characters in a filter | Remove them and try again when the message says `Forbidden characters detected. Please remove them and try again.` | Confirm the live account's edit and delete visibility and the result of each maintenance action before continuing to sales-order work. ## Continue with sales-order work After reviewing the reference values, continue with the page that owns the next task. | Next need | Continue with | | --- | --- | | Work on an order | [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) | | Follow the order-to-delivered hand-off | [From orders to delivered](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/from-orders-to-delivered) | | Maintain order stages | [Order status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-status) | | Maintain reasons for cancelled orders | [Order cancellation reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-cancellation-reasons) | For a related sales reference list, select its entry in the visible **Configuration** navigation. ![The sales configuration list reached after leaving the new-entry surface](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d62c6863138b12abbbe653c9aa0ce7f7.png) # Warehouse product types Use this page to review and maintain the Warehouse product types reference list used for purchasing product information and related MRQ records. ## Before you start Warehouse product types are the named types available to purchasing product information and MRQ records. The page belongs to **Warehouse** and is titled **Warehouse products types**. | If you need to… | Go to | |---|---| | Open the list | [Find the Warehouse product types list](#find-the-warehouse-product-types-list) | | Identify the visible list and entry fields | [Understand the list and entry fields](#understand-the-list-and-entry-fields) | | Create, change, delete, or export a type | [Maintain the list](#maintain-the-list) | | Correct a message or blocked action | [When maintenance does not work](#when-maintenance-does-not-work) | | Continue to related configuration | [Continue with related configuration](#continue-with-related-configuration) | You must be signed in to open this page. | Surface or action | When it is available | |---|---| | Main grid | The subscription includes the feature. | | **New** | The subscription includes the feature and the new-entry button is available. | | Edit action | Edit permission is available and the subscription includes the feature. | | Delete action | Delete permission is available. | The actions visible to you depend on your subscription and permissions. Use the controls that appear on your page. ## Find the Warehouse product types list Open the Warehouse product types page and confirm its heading. **Prerequisites** - You are signed in. - Your subscription includes the Warehouse product-type feature. **Steps** 1. Open the Warehouse product types page. 2. Confirm that the page heading is **Warehouse products types**. ![The Warehouse products types page with its heading, list, and toolbar](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5e8b143edbcbf1ef41f9b81d9b15f0c6.png) **Result:** The Warehouse product types list is open. ## Understand the list and entry fields The list shows product-type records under the **Type** column. Its controls are **New**, **Refresh**, and **Settings**. | Surface | What you see | What you use it for | |---|---|---| | Main list | **Type** | Identify each product-type record. | | List toolbar | **New** | Open a new-entry popup when it is available. | | List toolbar | **Refresh** | Refresh the list. | | List toolbar | **Settings** | Open list settings. | | New-entry popup | **Type** with a required marker | Enter the product-type name. | | New-entry popup | **OK** | Submit the visible popup action. | Selecting **New** opens a popup titled `New Warehouse product type` for a Warehouse product type. ![The Warehouse products types list with the Type column and New, Refresh, and Settings controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/afc91a498ce52ef497d866aab5f60911.png) The entry form contains the required **Type** field. No other entry fields are presented for you to complete. | Field | What you see in the entry form | Reader use | |---|---|---| | **Type** | Visible and required | Enter the product-type name. | | Other record details | Hidden | — | Use the labels and columns visible in your list. Generic controls for other reference entities are not part of this list. > **Note:** Work from the **Type** header and the controls visible in your list. The shared > configuration surface can present different controls for other reference entities. ![The New Warehouse product type popup with the required Type field and OK action](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c1de4a42af8e5b8e6237cbc9643abeb5.png) ## Maintain the list Choose the path that matches your task. Action availability follows the conditions in [Before you start](#before-you-start); use a control only when it appears on your list. | If you need to… | Select or open | Then | |---|---|---| | Add a type | **New** | Enter the name in **Type**, then select **OK** or **Save**, as shown. | | Change a type | The row's edit control | Update **Type**, then select **Save**. | | Leave a save popup | **Cancel** | Close the popup without submitting. | | Delete a type | The row's delete control | Read the confirmation, then select **Delete**, or select **Cancel**. | | Export the list | The list action that provides **Export** | Select **Export**. | **Prerequisites** - For a new entry, the subscription includes the feature and **New** is visible. - For an existing entry, edit access is available and the row exposes its edit control. - For deletion, delete permission is available and the row exposes its delete control. - You have the product-type name to enter when adding or changing a type. **Steps** 1. Select the control or open the list action that matches your task in the table above. 2. Enter or update the value in **Type** when the form is shown. 3. Select the popup action shown for the task. 4. If you are deleting an entry, read `Are you sure you want to delete this item?` before selecting **Delete**. 5. If you are leaving a popup or cancelling a deletion, select **Cancel**. The **Type** field is required. Use the success or validation messages in [When maintenance does not work](#when-maintenance-does-not-work) when they appear after a maintenance action. **Result:** The selected add, edit, delete, export, or cancel action is submitted or closed; check the result after completing a save, update, delete, or export action. ## Add, edit, delete, or export an entry These actions are separate paths. Their availability follows the conditions in [Before you start](#before-you-start); use an action only when its control appears on your list. ### Add an entry **Prerequisites** - The subscription includes the feature. - **New** is visible. **Steps** 1. Select **New**. 2. Enter the product-type name in **Type**. 3. Select the popup action shown for the new entry: **OK** or **Save**. **Confirmation:** If **Type** is empty, the form shows `Type is required`. **Result:** The new-entry popup submission has been requested. ### Edit an entry **Prerequisites** - The subscription includes the feature. - Edit permission is available. - The row exposes its edit control. **Steps** 1. Select the row's edit control. 2. Update the value in **Type**. 3. Select **Save**. **Result:** The selected row's edit-popup submission has been requested. ### Delete an entry **Prerequisites** - Delete permission is available. - The row exposes its delete control. **Steps** 1. Select the row's delete control. 2. Read `Are you sure you want to delete this item?`. 3. Select **Delete** to confirm the deletion. 4. If you decide not to remove the row, select **Cancel**. **Result:** The deletion confirmation menu closes after **Delete** or **Cancel**. ### Export the list **Prerequisites** - The Warehouse product types list is open. - The list exposes the export selection. **Steps** 1. Open the list action that provides **Export**. 2. Select **Export**. **Result:** The export selection is submitted. ## When maintenance does not work | Message | What to do | |---|---| | `Type is required` (the generic message is formed from the configured caption) | Enter a value in **Type**. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters, then submit the form again. | | `Data saved Successfully` | Check the list for the new type. | | `Data updated Successfully` | Check the selected row for the changed type. | | `Data Deleted Successfully` | Check the list for the deleted row. | | `Related to Saved data, Can't be deleted` | Keep the row and review the saved data related to it. | | `Failed to Delete` | Do not repeat the deletion until you review the row and its deletion conditions. | | `Must have at least one item` | Keep at least one item in the list. | Use the exact message shown on screen when one of these conditions occurs. "Server error text parsed by AppSettings.ParseError". Read the server text shown with the error and follow the instruction it gives. ## Continue with related configuration The shared configuration surface serves multiple reference entities; use the page that matches your next task: - [Products](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/products) for product records and product information. - [Purchase-job work lists](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-work-lists) for active purchasing work. - [Warehouse product stages](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-product-stages) for a related Warehouse reference list. # Banks A bank entry contains **Bank short name**, **Bank full name**, and **SWIFT code**. The Banks list supports reviewing, adding, updating, removing, and exporting bank entries. ## Banks The Banks page is available at **Finance settings** > **Banks**. | If you need to… | Go to | | --- | --- | | Check whether you have access to the list | [Before you start](#before-you-start) | | Open the list | [Find the Banks list](#find-the-banks-list) | | Identify columns, actions, and fields | [Understand the Banks screen](#understand-the-banks-screen) | | Check the three bank fields | [Fields](#fields) | | Choose a create, edit, or delete path | [Maintain bank entries](#maintain-bank-entries) | | Add or change a bank entry | [Add or update a bank entry](#add-or-update-a-bank-entry) | | Remove a bank entry | [Remove a bank entry](#remove-a-bank-entry) | | Copy the list | [Export the Banks list](#export-the-banks-list) | | Understand a hidden or unavailable action | [Handle availability branches](#handle-availability-branches) | | Resolve a message or loading problem | [When maintenance goes wrong](#when-maintenance-goes-wrong) | | Maintain bank accounts | [**Banks accounts**](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-banks-accounts) | | Return to broader configuration | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) | This page covers bank entries only. Bank-account fields and actions belong to the sibling [**Banks accounts**](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-banks-accounts) page. ## Before you start Banks is available to signed-in users whose subscription and permissions expose the relevant configuration surfaces. Check the conditions below before looking for a maintenance control. | Access condition | What it affects | | --- | --- | | You are authenticated | Access to the Banks route | | The subscription includes the feature | The Banks grid instead of the upgrade surface | | The feature is included and **New** is available | **New** | | Edit permission is enabled | Editing | | Delete permission is enabled | Deleting | ## Find the Banks list The Banks list is under **Finance settings**. A successful arrival shows the **Banks** heading and the list area. **Prerequisites** - You are signed in. - Your account can open the Banks route. **Steps** 1. Open **Finance settings**. 2. Select **Banks**. 3. Confirm that the page heading is **Banks**. ![The Banks heading and settled list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/079503542967aaf8fd152f83699210bc.png) **Result:** The authenticated Banks list is open. The list uses **Bank short name**, **Bank full name**, and **SWIFT code** as its visible headers. ## Understand the Banks screen The Banks screen combines a bank-entry grid, a page toolbar, an action column in each entry's row, and a maintenance popup. Use the headers visible in your list. | Screen area | What to use it for | | --- | --- | | Main grid | Review bank entries | | List columns | Read the bank values shown by the list | | Page toolbar | Start **New** or use **Export** | | Entry action column | Open the selected bank for editing or deletion | | Shared popup | Enter or change bank values, save, or close the form | The visible bank columns are **Bank short name**, **Bank full name**, and **SWIFT code**. Hidden configuration properties do not appear as bank columns. Use **New** in the page toolbar to create an entry. The toolbar also includes **Refresh** and **Settings**. The edit control in an entry's action column opens it for changes; the delete control in the same column starts removal. The shared popup is also used by other configuration entities. For Banks, use only the fields in [Fields](#fields). Controls for bank accounts, such as selecting a bank or a currency, belong to [**Banks accounts**](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-banks-accounts). If `No data` appears while a loading indicator is present, wait for loading to finish before deciding that the list contains no entries. > **Note:** The list can receive its columns from the current configuration. Use the headers you > can see when you work with the list. ### Fields The Banks form records the name people recognise for a bank, its full name, and its SWIFT code. The three bank fields are visible text boxes and are configured as required fields. | Field shown to you | What to enter | Form configuration | | --- | --- | --- | | **Bank short name** | The bank's short name | Visible text box; required | | **Bank full name** | The bank's full name | Visible text box; required | | **SWIFT code** | The bank's SWIFT code | Visible text box; required | The form does not include a bank-specific select box, date box, number box, percentage field, or currency field. The form fields appear in the shared popup when it is in its new-or-edit state, a selected item is available, and the field is configured for form visibility. Each field's required setting controls its required marker. ## Maintain bank entries Use the Banks list as the starting point for the maintenance path that matches your task. **New** opens a blank form. The edit control in an entry's action column opens the selected bank, and the delete control in that column opens the delete menu. **Cancel** closes the delete menu or the popup, depending on where you select it. **Save** commits a new or edited bank after validation. **Don't Save** discards popup changes. | If you need to… | Select | | --- | --- | | Create a bank entry | **New** | | Change an existing bank entry | A saved bank's edit form | | Remove a bank entry | The delete menu, then **Delete** | | Leave a delete menu or popup | **Cancel** | | Keep changes in a new or edited form | **Save** | | Discard popup changes | **Don't Save** | | Start a list export | **Export** | The normal maintenance controls depend on subscription inclusion and the corresponding create, edit, delete, or export permission. Use the edit and delete controls in each entry's action column. ### Add or update a bank entry **Prerequisites** - The Banks list is open. - The subscription includes the Banks feature. - **New** is available when you are creating an entry. - You have edit permission when you are changing an existing entry. - You have the bank short name, full name, and SWIFT code. **Steps** 1. Choose the maintenance path that matches your task. | If you need to… | Select or open | | --- | --- | | Create a bank entry | **New** | | Change a saved bank entry | The saved bank's edit form | 2. Enter the bank's short name in **Bank short name**. 3. Enter the bank's full name in **Bank full name**. 4. Enter the bank's SWIFT code in **SWIFT code**. 5. Select **Save**. 6. If a validation message identifies forbidden characters, remove them from the affected value. | Message | Correction | | --- | --- | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the affected value. | | `Just '_' '-' And '.' Characters Accepted` | Use only the characters accepted by the field's pattern rule. | 7. Select **Save** again after correcting the value. 8. Confirm the result for the path you chose. | Path | Confirm | | --- | --- | | New bank | `Data saved Successfully` | | Existing bank | `Data updated Successfully` | **Result:** The new entry is saved with `Data saved Successfully`, or the edited entry is saved with `Data updated Successfully`. If validation stops the save, the form remains available for correction. ### Remove a bank entry Use deletion only when the bank entry is no longer needed. The product protects a list from being left without an item and refuses deletion when saved data is related to the bank. **Prerequisites** - The Banks list is open. - Delete permission is enabled. - You have identified the bank row to remove. **Steps** 1. In the identified entry's action column, select the delete control. 2. Choose one confirmation action after the product displays `Are you sure you want to delete this item?`. | If you need to… | Select | | --- | --- | | Keep the bank entry | **Cancel** | | Confirm removal | **Delete** | 3. If the deletion succeeds, confirm `Data Deleted Successfully`. 4. If the message is `Must have at least one item`, select **Cancel** and keep at least one bank entry in the list. 5. If the message is `Related to Saved data, Can't be deleted`, select **Cancel** and review the saved data related to it. 6. If the message is `Failed to Delete`, select **Cancel** and check whether the row remains. **Result:** The delete menu closes without changing the list when you select **Cancel**. When you select **Delete**, the entry is removed only when the product accepts the deletion and shows `Data Deleted Successfully`. ### Export the Banks list Use **Export** to begin the list-export flow without changing bank entries. **Prerequisites** - The Banks list is open. - Export is available on your Banks toolbar. **Steps** 1. Select **Export** in the Banks toolbar. ![The export control and export flow](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/82091efba338f3da750055515556d7c6.png) **Result:** The Banks export flow begins after selecting **Export**. ## Handle availability branches The Banks page can show a different surface when subscription inclusion or permissions change. Use the table to identify the branch before following the maintenance procedure. | Condition | What you see or can do | | --- | --- | | The subscription does not include the feature | The upgrade surface appears instead of the main grid | | The subscription does not include Banks | The upgrade surface replaces the normal Banks grid | | The configuration does not make **New** available | **New** is unavailable | | Edit permission is unavailable | Editing is unavailable | | Delete permission is unavailable | The row delete menu is hidden | | Another configuration entry is selected | Its controls and fields replace the Banks controls | If the grid is replaced by the subscription upgrade surface, contact the person who manages your subscription. ## When maintenance goes wrong Use the exact message or visible condition to choose the next action. | What you see | What it means | What to do | | --- | --- | --- | | `Are you sure you want to delete this item?` | The product requests deletion confirmation | Choose **Cancel** or **Delete** | | `Forbidden characters detected. Please remove them and try again.` | A value contains a forbidden character | Remove the forbidden characters and select **Save** again | | `Just '_' '-' And '.' Characters Accepted` | The field's pattern accepts only the listed characters | Correct the value to the accepted pattern and select **Save** again | | `Must have at least one item` | The deletion would leave no item in the list | Keep at least one bank entry | | `Related to Saved data, Can't be deleted` | Saved data is related to the bank | Keep the entry and review the related saved data | | `Failed to Delete` | The delete operation failed | Check whether the row remains before retrying | | `No data` while a loading indicator is present | The list is still loading at the time of the view | Wait for loading to finish before treating the list as empty | ## Messages on related configuration pages These messages can appear in shared configuration areas reached from the Banks page or in the export flow: | Message | Where it applies | | --- | --- | | `Exporting List:` | Export flow | | `Rating value` | Survey answers | | `Add more` | Survey answers, reference questions, or reference question units | | `Select a bank` | Bank accounts | | `Select a Curriency` | Company currencies or bank accounts | ## Continue from Banks For account-specific maintenance, use **Banks accounts**. For other setup areas, use the configuration dashboard. | If you need to… | Continue with | | --- | --- | | Maintain bank-account details | [**Banks accounts**](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-banks-accounts) | | Return to the configuration area | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) | Use [**Banks accounts**](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-banks-accounts) when the task involves a bank account rather than a bank entry. Use [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) when you need to select another configuration area. # Bank accounts A bank-account entry records a bank, its account number, its currency, and an optional IBAN. Use the Bank accounts configuration tab to review, add, update, delete, or export these entries. The sibling [Banks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-banks) page covers bank entries. ## Bank accounts Bank accounts is the finance-configuration list for account details associated with a bank. Use it for account-specific finance work; the sibling Banks page covers bank entries. The application heading is **Banks accounts**. Use the page when finance work needs a bank-account entry rather than a bank master entry. | If you need to… | Go to | | --- | --- | | Check access and availability conditions | [Before you start](#before-you-start) | | Open and review the list | [Find and review a bank-account entry](#find-and-review-a-bank-account-entry) | | Identify fields and visible columns | [Understand the bank-account fields](#understand-the-bank-account-fields) | | Add or change an entry | [Enter and validate bank-account values](#enter-and-validate-bank-account-values) | | Remove an entry or begin an export | [Delete or export bank-account data](#delete-or-export-bank-account-data) | | Resolve an unavailable action or message | [Handle unavailable actions and validation messages](#handle-unavailable-actions-and-validation-messages) | | Maintain bank entries | [Banks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-banks) | | Maintain L/G facilities | [L/G facilities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-letters-of-guarantees-facilities) | | Return to the configuration area | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) | ## Before you start Bank-account maintenance is available when the subscription includes the feature and your account has the permission required for the action. The list is replaced by an upgrade surface when the subscription feature is not included. | Condition | What it affects | | --- | --- | | The subscription includes the feature | The bank-account list is shown instead of the upgrade surface. | | The create action is available | **New** is available. | | Edit permission is available | A row edit action is shown, and selecting a row can open the edit popup. | | Delete permission is available | The row delete menu is available when its other list condition is met. | | A new entry or an existing item is selected | The bank-account form is shown. | No approval step is required before you save or delete a bank-account entry. ## Find and review a bank-account entry Open the Bank accounts list from Finance settings to review saved entries. **Prerequisites** - You are signed in. - Your subscription and permissions expose the Bank accounts configuration surface. **Steps** 1. Open **Finance settings**. 2. Select **Bank Accounts**. 3. Confirm that the page heading is **Banks accounts**. 4. Locate the Finance settings navigation. 5. Confirm that the navigation includes **Finance settings**, **Configuration**, **Banks**, **Bank Accounts**, **LGs Facilities**, and **Invoice Settings**. 6. Review the list after its columns appear. The list can show `No data` and `Count: 0` while it loads. The visible list columns are **Bank short name**, **Account no.**, **currency**, and **IBAN**. The toolbar shows **New**, **Refresh**, and **Settings**. With no data row, no row edit or delete action is available. **Result:** The **Banks accounts** list is open, and you can review its columns and current list state. ## Understand the bank-account fields Use the list to review saved values and the form to enter or change them. | Field | List | Form | Guidance | | --- | --- | --- | --- | | **Bank short name** | Yes | No | Distinguish one entry from another. | | **Bank** | No | Yes | Choose the bank you are maintaining. | **currency** options are the currency codes available for selection in the **currency** field. Choosing a bank in **Bank** updates the **Bank short name** shown for the account. - **Account no.** is required; enter it before selecting **Save**. - **IBAN** is optional; enter it when the bank provides one. ## Enter and validate bank-account values Use the entry form to create a new bank-account entry or change an existing one. **Prerequisites** - The Bank accounts list is open. - The subscription includes the feature. - **New** is available when you are creating an entry. - Edit permission is available when you are changing an existing entry. - You know the bank, account number, currency if needed, and IBAN if needed. **Steps** 1. Select the maintenance path for your task. | If you need to… | Select | | --- | --- | | Create a bank-account entry | **New** | | Change a saved bank-account entry | The row's edit action | 2. Select the bank in **Bank**. 3. Enter the account number in **Account no.**. 4. If you need to record a currency, select a currency code from the available choices in **currency**. 5. If you need to record an IBAN, enter it in **IBAN**. 6. Select **Save**. 7. Use the message you receive to correct the value named in the table. | Message | Correction | | --- | --- | | `Bank is required` | Select a value in **Bank**. | | `Account no. is required` | Enter a value in **Account no.**. | | `Just '_' '-' And '.' Characters Accepted` | Correct the value to the characters accepted by the field pattern. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the affected value. | 8. Select **Save** again after correcting the value. 9. If you need to leave without keeping the popup changes, select **Cancel** or **Don't Save**. For a new entry, the save result is `Data saved Successfully`. For an existing entry, the update result is `Data updated Successfully`. **Result:** The new entry is saved with `Data saved Successfully`, or the edited entry is saved with `Data updated Successfully`. Selecting **Cancel** or **Don't Save** leaves the popup without keeping its changes. ## Delete or export bank-account data Deletion removes a selected bank-account entry through its row delete path and confirmation. Export starts the list export-options flow without changing the entries. ### Delete a bank-account entry Use deletion when the selected entry is no longer needed. The delete request is allowed when more than one list item exists and delete permission is available. **Prerequisites** - The Bank accounts list is open. - A bank-account row exists. - Delete permission is available. - More than one list item exists. **Steps** 1. Open the selected row's delete menu. 2. Select **Delete**. 3. In the confirmation prompt, select **Delete**. 4. If the result is `Related to Saved data, Can't be deleted`, keep the entry and review the saved data related to it. 5. If the result is `Failed to Delete`, check whether the row remains before taking another action. 6. Do not select **Delete** when only one entry remains. **Result:** A permitted deletion removes the selected entry and shows `Data Deleted Successfully`. The entry remains when a delete refusal message appears. ### Start an export Use **Export** when you need to begin the bank-account list export flow. **Prerequisites** - The Bank accounts list is open. - **Export** is available in the list toolbar. **Steps** 1. Select **Export**. 2. Review the export options that open. **Result:** The bank-account export-options flow is open. Follow the controls shown there for the next export step. ## Handle unavailable actions and validation messages Use the visible condition or exact message to choose the next action. | What you see | What it means | What to do | | --- | --- | --- | | The subscription-upgrade surface replaces the list | The subscription does not include the feature. | Ask the person who manages the subscription to include the feature. | | **New** is absent | The create action is unavailable. | Use an existing row only if an edit action is available. | | The row edit action is absent | Edit permission is unavailable. | Ask for edit permission before changing an entry. | | The row delete menu is absent | Delete permission is unavailable. | Ask for delete permission before removing an entry. | | `No data` appears with a loading indicator | The list is still loading. | Wait for loading to finish before treating the list as empty. | | A list value is not where you expect it | The list presents bank-account values in its visible columns. | Use **Bank short name**, **Account no.**, **currency**, and **IBAN** to identify the entry. | | `Bank is required` | **Bank** has no selected value. | Select a bank and select **Save** again. | | `Account no. is required` | **Account no.** has no value. | Enter an account number and select **Save** again. | | `Just '_' '-' And '.' Characters Accepted` | The value does not satisfy the character pattern. | Correct the value and select **Save** again. | | `Forbidden characters detected. Please remove them and try again.` | A value contains a forbidden character. | Remove the forbidden character and select **Save** again. | | `Related to Saved data, Can't be deleted` | Saved data is related to the entry. | Keep the entry and review the related saved data. | | `Failed to Delete` | The delete operation failed. | Check whether the row remains before taking another action. | | `Must have at least one item` | The list cannot be reduced below one item. | Keep at least one bank-account entry. | ## Continue with finance configuration After maintaining bank accounts, continue with the finance-configuration area that matches your next task. | If you need to… | Continue with | | --- | --- | | Maintain bank entries | [Banks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-banks) | | Maintain letter-of-guarantee facilities | [L/G facilities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-letters-of-guarantees-facilities) | | Maintain invoice settings | [Invoice Settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-finance-billing-settings) | | Return to the broader configuration area | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) | # L/G facilities Use this page to find the L/G facilities list, interpret its values, and maintain or export facility data from the Finance settings area. | If you need to… | Go to | | --- | --- | | Check access and the record needed for maintenance | [Before you start](#before-you-start) | | Open the L/G facilities list | [Find the L/G facilities list](#find-the-lg-facilities-list) | | Read the columns and numeric limits | [List fields](#list-fields) | | Understand why an action or surface is unavailable | [What changes the screen](#what-changes-the-screen) | | Edit an existing facility | [Maintain an existing facility value](#maintain-an-existing-facility-value) | | Delete an existing facility | [Delete an existing facility](#delete-an-existing-facility) | | Resolve validation or action messages | [Handle unavailable actions and messages](#handle-unavailable-actions-and-messages) | | Review fields and actions outside this surface | [Out of scope](#out-of-scope) | | Prepare an export | [Export the list](#export-the-list) | | Move to a related Finance settings list | [Continue from L/G facilities](#continue-from-lg-facilities) | ## Before you start L/G facilities are saved facility values used by the Finance settings list. You need signed-in access and an existing saved facility row for edit or delete work. Before you start, confirm the following: | Check | What to confirm | Why it matters | | --- | --- | --- | | Access | You are signed in to PAMS. | The route is protected by authentication. | | Availability | Your subscription includes the feature. | Without it, the list is replaced by the subscription-upgrade surface. | | Record | The facility row you need already exists. | **New** is absent, so you cannot create a new record from this list. | ## Find the L/G facilities list Open the L/G facilities list from the Finance settings navigation. **Prerequisites** - You are signed in and your subscription includes the feature. **Steps** 1. Open the Finance settings area. 2. In the Finance settings navigation, locate **Banks**. 3. Select **LGs Facilities**. The list opens with **Banks** visible in the Finance settings navigation. **New** is absent. ![Identify the Finance settings navigation and the L/G facilities list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/de0986e7a5cef75494bd2139ce3a84af.png) **Result:** The L/G facilities list is open. Continue to [Understand the facilities screen](#understand-the-facilities-screen) to identify its values and actions. ## Understand the facilities screen The facilities screen is a list for reviewing saved L/G facility values. It shows the Finance settings navigation, **Refresh** and **Settings**, and ten list rows. It remains in list state rather than displaying an edit form. | Entry | Use | | --- | --- | | `Banks` | Open the banks settings list. | | `Bank Accounts` | Open the bank accounts settings list. | | `LGs Facilities` | Identify the L/G facilities area. | | `Invoice Settings` | Open the invoice settings list. | ![Review the six columns, Finance settings navigation, and page buttons](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ebbacc98621f98dd56417e41f2721b0f.png) ### List fields The list fields describe the bank and the percentage or amount values configured for its L/G facility. | Column | What it represents | Value or range | | --- | --- | --- | | **Bank short name** | The bank name shown in the list. | Text; required before saving. | | **LG facility** | The facility amount. | Amount with currency; minimum `0`. | | **Bid bond (%)** | The bid-bond cash-cover percentage. | `0` to `100`. | | **Down payment (%)** | The down-payment cash-cover percentage. | `0` to `100`. | | **Performance (%)** | The performance cash-cover percentage. | `0` to `100`. | | **Warranty (%)** | The warranty cash-cover percentage. | `0` to `100`. | The grid shows these six columns in this order: **Bank short name**, **LG facility**, **Bid bond (%)**, **Down payment (%)**, **Performance (%)**, and **Warranty (%)**. ### What changes the screen Your subscription and permissions determine which page and actions you can use. | Condition | What you see or can do | | --- | --- | | Your subscription excludes the feature. | The grid is replaced by the subscription-upgrade surface. | | You have permission to edit rows. | Selecting a row opens editing. | | You have permission to delete rows and open the row menu. | **Delete** is available in the grid action area. | | The values are invalid. | **Save** does not save the changes. | ## Maintain an existing facility value An existing facility value is a saved bank-specific amount or cash-cover percentage that you can review or change when row editing is available. **Prerequisites** - You are on the L/G facilities list. - The facility row is already saved. - Your permissions allow row editing. **Steps** 1. Select the existing facility row when row editing is available to you. 2. Enter or retain values in the edit popup according to this table. | Field | Value | | --- | --- | | **LG facility** | An amount of `0` or greater. | | **Bid bond (%)** | A value from `0` through `100`. | | **Down payment (%)** | A value from `0` through `100`. | | **Performance (%)** | A value from `0` through `100`. | | **Warranty (%)** | A value from `0` through `100`. | | **Applying date** | Review the value shown in the edit form. | 3. Choose one outcome from this table. | If | Action | | --- | --- | | The values are valid. | Select **Save**. | | A value is invalid or out of range. | Correct the value, then select **Save** again. | | You do not want to save the edit. | Select **Cancel** without saving. | **Result:** A valid edit displays `Data saved Successfully` or `Data updated Successfully`. **Cancel** closes the popup without saving the edit. ### Delete an existing facility Deleting removes an existing facility row after the shared confirmation prompt. Use it only when the row is no longer needed, because the list also enforces a minimum of one item. **Prerequisites** - You are on the L/G facilities list. - The row already exists. - Your permissions allow deletion. **Steps** 1. Open the row menu when deletion is available to you. 2. Select **Delete**. 3. Read `Are you sure you want to delete this item?`. 4. Choose an outcome in the confirmation prompt. | Outcome or message | Response | | --- | --- | | `Data Deleted Successfully` | Verify that the row is no longer in the list. | | `Related to Saved data, Can't be deleted` | Keep the row and resolve its saved-data relationship. | | `Failed to Delete` | Keep the row and follow the message shown. | | `Must have at least one item` | Keep at least one facility row in the list. | **Result:** The row is deleted, kept, or left unchanged according to the selected confirmation outcome and the message shown. ### Export the list Use **Export** to open the export-options modal from the list. **Prerequisites** - You are viewing the L/G facilities list. **Steps** 1. Select **Export**. 2. Review the export options modal. 3. If `Forbidden characters detected. Please remove them and try again.` appears, remove the forbidden characters from the filter. **Result:** The export options modal is open. ## Handle unavailable actions and messages When the screen stops an action, use the visible message to choose the next move. **Prerequisites** - You are on the L/G facilities list or its edit popup. **Steps** 1. Read the message shown by the page. 2. Use this table to correct the value or filter. | Message | Action | | --- | --- | | `This Field Is Required` | Enter the missing required value. | | `Just '_' '-' And '.' Characters Accepted` | Remove all other characters. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the filter. | | Any other message | Follow the instruction shown. | **Result:** The missing value or forbidden character is identified, and the next correction follows the message on screen. ## Out of scope These items are not part of the L/G facilities list or edit form: | Not part of this surface | What to do instead | | --- | --- | | **Full name** | Work from the fields visible on this list. | | **currency** selectors | They are absent from this surface; when available, currency names come from the available currencies list and the selected value uses the currency code. | | **New** | Use an existing saved row for maintenance; **New** is absent here. | | Route-specific tabs | Use the Finance settings navigation entries visible on the page. | ## Continue from L/G facilities After reviewing or maintaining the list, continue in Finance settings according to the next list you need. | If you need to review… | Open | | --- | --- | | Banks | `Banks` | | Bank accounts | `Bank Accounts` | | Invoice settings | `Invoice Settings` | The related pages are [configuration-finance-banks], [configuration-finance-banks-accounts], and [configuration-finance-billing-settings]. # Invoice settings An invoice choice determines whether a company branch uses an editable proforma or a non-editable invoice. Use Invoice settings to review or change that choice. | If you need to… | Go to | |---|---| | Check access, subscription, and branch conditions | [Before you start](#before-you-start) | | Open the settings page | [Open Invoice settings](#open-invoice-settings) | | Locate the invoice choices and audit history | [Understand the Invoice settings screen](#understand-the-invoice-settings-screen) | | Commit a changed invoice choice | [Change and save an invoice choice](#change-and-save-an-invoice-choice) | | Decide how to leave after changing a choice | [Handle branch and unsaved-change variations](#handle-branch-and-unsaved-change-variations) | | Match a failure to its operation | [When loading or saving goes wrong](#when-loading-or-saving-goes-wrong) | | Review history or leave the page | [Continue after Invoice settings](#continue-after-invoice-settings) | ## Before you start Invoice settings holds one invoice choice for each branch panel. A branch panel is the expandable area for one branch. Confirm the feature is included, confirm that you can edit settings, and identify the branch whose choice you intend to change. **Prerequisites** - The invoice-settings feature is included for the company. When it is not included, the branch panels and invoice-choice controls are not available; an upgrade surface is shown instead. - You have permission to edit settings. - You know which branch's invoice choice you are changing. When no branch was previously open, the page initially opens the signed-in user's branch. No required marker is shown for the invoice choice, and no required rule, pattern, range, or other field constraint is defined for this page. ## Open Invoice settings Open Invoice settings from the configuration menu before reviewing or changing a branch choice. **Prerequisites** - The prerequisites in [Before you start](#before-you-start) are satisfied. **Steps** 1. Open the configuration menu. 2. Select **Invoice settings**. 3. Confirm that **Invoice settings**, **Save**, and **Save and Close** are visible. ![Identify the Invoice settings page and its save actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f12499360b96fb52bf83ea77af220d8b.png) **Result:** The Invoice settings screen is open. The branch settings and editing actions depend on your access and subscription. ## Understand the Invoice settings screen The screen groups the invoice choice by branch. **Last Modifications** is the audit history for a branch. Open a branch panel to find its choice. | Surface | What to use it for | When it appears | |---|---|---| | Branch panel | Open a branch and work with its invoice choice | The feature is included; the panel body appears when that branch is open | | **Auto generate** | Offers **Editable proforma** and **Non editable invoice** in the invoice-choice radio group | The feature is included and the branch panel is open | | **Editable proforma** | Choose the editable-proforma setting | The feature is included and the branch panel is open | | **Non editable invoice** | Choose the non-editable-invoice setting | The feature is included and the branch panel is open | | **Last Modifications** | Open the audit history | The feature is included and the branch has a company identifier | Each branch panel body appears only when that branch is open. The invoice choice is the **Auto generate** radio group, with these choices: | If the branch needs to… | Select | |---|---| | Use an editable proforma | **Editable proforma** | | Use a non-editable invoice | **Non editable invoice** | Select **Last Modifications** to review the branch history in chronological order. ![Find the expanded branch panel, invoice choices, and Last Modifications](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9b72901ad458451965b6b6626eb6fb96.png) ## Change and save an invoice choice Change the invoice choice when the branch needs either an editable proforma or a non-editable invoice. The choice is committed when you save. **Prerequisites** - The invoice-settings feature is included. - You can edit settings. - The branch panel whose choice you are changing is open. **Steps** 1. In the open branch panel, select the choice that matches the branch's process. | If the branch needs to… | Select | |---|---| | Use an editable proforma | **Editable proforma** | | Use a non-editable invoice | **Non editable invoice** | 2. Select **Save** to keep the page open, or select **Save and Close** to save and leave the page. **Save** calls the save action and is available only when the data has changed. **Save and Close** uses the save-and-close action and is also available only when the data has changed. 3. Read the message after the save attempt. On success, the page displays `Your company process approvall settings has been saved successfully`. A save failure displays `Server Error`. **Result:** The selected invoice choice is submitted, or the displayed message identifies a save failure. Saving closes the page only when you selected **Save and Close** and the save completes. ## Handle branch and unsaved-change variations The available actions depend on editing permission, subscription inclusion, the selected branch, and whether the current choice has changed. | Situation | What to expect | |---|---| | Editing is allowed and the subscription includes the feature | **Save**, **Save and Close**, and **Close** are available according to their change conditions | | Data has not changed | **Save** and **Save and Close** are not available because there is no change to commit | | Editing is not allowed, while the feature is included | The close option for leaving the page is used | | A branch was not previously open | The signed-in user's branch opens initially | | A branch choice has unsaved changes | The popup for leaving the page can offer **Don't Save**, **Save**, and **Cancel** | **Prerequisites** - You are on Invoice settings. - If you are leaving after a change, you know whether to keep or discard that change. **Steps** 1. Check whether the branch panel you need is open. 2. If no branch was previously open, work in the signed-in user's initially opened branch. 3. If you changed a choice, select **Close**. 4. Choose the popup action that matches what you need: | If you need to… | Select | |---|---| | Discard the unsaved choice | **Don't Save** | | Commit the unsaved choice before leaving | **Save** | | Remain on the page without choosing | **Cancel** | 5. If the action is unavailable, confirm that the subscription includes the feature and that your access allows editing. **Result:** You either keep working in the selected branch, commit or discard an unsaved choice, or remain on Invoice settings. ## When loading or saving goes wrong Loading and saving have different messages. Match the displayed text to the operation before deciding what to do next. | What you see | Operation | What to do | |---|---|---| | `An error occurred while processing your request` | Loading the settings | Use the message to identify a loading failure. | | `Server Error` | Saving the invoice choice | Use the message to identify a saving failure. | The save success message is `Your company process approvall settings has been saved successfully`. ## Continue after Invoice settings After saving or reviewing a choice, use **Last Modifications** to review the branch's audit history when a company identifier is present. **Close** leaves Invoice settings without saving a new change; **Save and Close** saves the changed choice before closing the page. **Prerequisites** - You have finished reviewing or changing the branch invoice choice. **Steps** 1. Select **Last Modifications** when the branch has a company identifier. 2. Review the audit-log row and its chronological description. 3. Select **Close** to leave without saving a new change, or select **Save and Close** after saving a changed invoice choice. **Result:** You have reviewed the branch's audit history or left Invoice settings, with the current route and the selected save result clear. # Product stages ## Product stages Product stages are the named stages used by warehouse work to describe where a product is in its warehouse handling. You maintain them under the **Warehouse** area of configuration. For the warehouse process, continue with [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow). | If you need to… | Go to | | --- | --- | | Find the list | [Find the Product stages list](#find-the-product-stages-list) | | Understand the list and editor | [Understand the Product stages screen](#understand-the-product-stages-screen) | | Add or change a stage | [Add or edit a stage](#add-or-edit-a-stage) | | Remove a stage | [Remove a stage](#remove-a-stage) | | Export list data | [Import or export list data](#import-or-export-list-data) | | Continue with warehouse work | [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | | Maintain the related Warehouse list | [Warehouse](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-view) | ## Before you start Product stages maintenance needs access to Product stages and a subscription that includes the feature. The list is available when your subscription includes the feature. **New** is available when you can create entries and your subscription includes the feature. Prepare the stage name before opening the editor. Enter it in **Stage**. If `You are not allowed to View this page!` appears before the list opens, use the access path provided by your administrator before trying to maintain a stage. Open the list before selecting a row to edit or delete. ## Find the Product stages list In the configuration menu, select **Product stages**. ## Understand the Product stages screen The Product stages screen combines a list with actions, row controls, an editor popup, and an export dialog. Use the column headers visible in your list. Use **New** above the list to add a stage. Use the row's edit or delete control when that action is available. Use **Export** to open the export dialog when it is available. In the editor popup, select **Save** to keep a change or **Cancel** to close it without saving. ### Fields Enter the stage name in the required **Stage** text box. | Field | What you use it for | | --- | --- | | **Stage** | Enter the stage name. | ## Maintain Product stages Choose the action that matches your task. | If you need to… | Use this surface | What it does | | --- | --- | --- | | Add a row | **New** above the grid | Opens the new-item form. | | Change a row | Edit control for the row | Opens the selected row for editing when editing is allowed. | | Commit editor changes | **Save** in the editor popup | Emits the editor save event. | | Leave the editor | **Cancel** in the editor popup | Closes the editor without saving. | | Start an export | **Export** in the export dialog | Starts export from the export dialog. | | Leave the export dialog | **Cancel** in the export dialog | Closes the export dialog. | ### Add or edit a stage | Task | Select | | --- | --- | | Add a stage | **New** | | Edit a stage | The edit control for the row | | Leave without saving | **Cancel** | Prerequisites - You can open the Product stages list. - For a new entry, **New** is available. - For an existing entry, a Product stages row and its edit control are available. Steps 1. Select the action for your task in the table above. 2. In **Stage**, enter the stage name. 3. Select **Save**. 4. If a validation message appears, correct **Stage** using the table below. 5. Select **Save** again. | Message | Action | | --- | --- | | `Stage is required` | Enter a value in **Stage**. | | `Just '_' '-' And '.' Characters Accepted` | Remove characters outside the accepted set from **Stage**. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from **Stage**. | **Result:** The editor emits its save event when you select **Save**. Selecting **Cancel** closes the editor without saving. **Stage** is required and accepts only the characters described by the message `Just '_' '-' And '.' Characters Accepted`. ### Remove a stage Prerequisites - You can open the Product stages list. - The row you want to remove is present. - Its delete control is available. Steps 1. Select the row's delete control. | If you want to… | Select | | --- | --- | | Request deletion | **Delete** | | Close the confirmation without deleting | **Cancel** | 2. In the confirmation, select the option that matches your choice in the table above. The confirmation message is `Are you sure you want to delete this item?`. **Result:** Selecting **Delete** calls the row delete action. ### Import or export list data Prerequisites - **Export** is available for the page. Steps 1. Select **Export** in the page controls. 2. Select **Export** in the export dialog to start the export. 3. Select **Cancel** in the export dialog to close it without starting an export. **Result:** **Export** starts the export, or **Cancel** closes the export dialog. ## Choose the available maintenance path The available actions depend on your subscription, permissions, the selected row, and the current form state. | What you check | Maintenance path | | --- | --- | | Product stages grid | The grid is shown when the subscription includes the feature. | | **New** | Select **New** when it is available. | | **Stage** field | Enter the stage name in the required field. | | Stage editability | Edit the field when it is available. | | Edit and delete controls | Use the row control when the action is available. | | **Export** | Use the export dialog when **Export** is available. | ## When maintenance goes wrong Use the visible message or page state to choose the next check. | What you see | What to check next | | --- | --- | | `Stage is required` | Enter a value in **Stage** before selecting **Save**. | | `Just '_' '-' And '.' Characters Accepted` | Remove characters outside the accepted set, then try **Save** again. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from **Stage**, then try **Save** again. | | `You are not allowed to View this page!` | Check your Product stages page access. | | A loading indicator remains visible | Wait for the page to finish loading. | | An edit or delete control, **New**, or **Export** is unavailable | Check the row, permissions, and subscription in [Choose the available maintenance path](#choose-the-available-maintenance-path). | After selecting **Save**, verify the resulting list before continuing. ## Out of scope | Topic | Surface | Behaviour | | --- | --- | --- | | **Upload** and import upload messages | — | — | | **Don't Save**, **Yes**, **No**, and **Ok** | — | — | | Log-history filters and **Registration** | — | — | | Warehouse inspection configuration | — | — | | Other Warehouse reference lists | — | — | ## Know what is next Product stages feeds warehouse work, where the stage names support the warehouse process. Continue with [Warehouse fulfillment flow](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) when you need to use those stages in work, or open the sibling [Warehouse](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-view) list when you need related Warehouse configuration. Choose the procedure that matches the actions available to you. # Warehouses ## Warehouses at a glance A warehouse configuration record identifies a storage location. Use **Warehouses** to review configured locations before warehouse operations. A table arrangement saves the list’s displayed columns and their arrangement. | If you need to… | Go to | | --- | --- | | Find or open a warehouse | Find a warehouse | | Use list controls | List and toolbar reference | | Create or edit a warehouse | New warehouse or Edit warehouse | | Continue operational work | Warehouse fulfillment flow | | Maintain files | Libraries | ## Before you start **Prerequisites** - Your subscription includes the warehouse configuration feature. - You have access to the list and its actions. - A table arrangement is available for the grid. - **New** requires the subscription, a configured list number, create access, and an available warehouse limit. - Row **Delete** requires the subscription, a table arrangement, and delete access. - Use **Table Layout** when it is available. Open **Settings** to use **Filter Row** and **Group Panel** when those options appear. ## Find a warehouse Open the Warehouses list, then use **Name**, **Type**, **Description**, and **Branches** to identify a row. **Steps** 1. Open **Warehouses**. 2. Read the **Name**, **Type**, **Description**, and **Branches** columns. 3. Choose the task that matches your need: | If you need to… | Select | | --- | --- | | Review an existing warehouse | the warehouse row | | Start a warehouse record | **New** | ![The Warehouses list and its four columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/eeb5a55b1cf77910d4999f734d602476.png) **Result:** The selected warehouse page or the New warehouse page is on screen. Use the next section to identify the list and toolbar controls before maintaining the record or its layout. ## Understand the warehouse screen The page combines the warehouse list, its current table arrangement, and toolbar menus. The visible columns follow that arrangement. The table-arrangement menu, **Settings**, and **Columns Chooser** provide list controls. ![Settings open with the available list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5fac2e65517da324b3e9faf80c9158ec.png) ### Warehouse fields | Field | Type | | --- | --- | | **Layout name** | Text | | **Expand column width** | Boolean | | **Filter Row** | Boolean | | **Group Panel** | Boolean | | Import-mode file field | File, in import mode | Warehouse column names, order, captions, visibility, types, and widths follow the current table arrangement. ### Areas and related tabs To work with warehouse details or related tabs, go to the New warehouse page when creating a record or the Edit warehouse page when changing a saved record. ### List and toolbar reference | Task | Control | | --- | --- | | Filter or clear the list | **Apply filter**, **Clear applied filter** | | Refresh or export | **Refresh**, **Export** | | Change arrangements | **Table Layout**, **Save New Layout**, **Update Current**, **Delete Current** | | Enter or cancel an arrangement | **Layout name**, **Cancel**, **Save**, **Delete** | | Choose columns or width | **Columns Chooser**, **Expand column width** | | Change grid display | **Settings**, **Filter Row**, **Group Panel** | ![Table-arrangement actions and column controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/64e0a97e15d13ffa91551b2db378d457.png) ## Review and maintain warehouse details Use the list to open a saved warehouse, start a new one, or maintain its table arrangement. **Steps** 1. Select the task that matches your need: | If you need to… | Select | | --- | --- | | Review an existing warehouse | the warehouse row | | Start a warehouse record | **New** | | Create a table arrangement | **Table Layout**, **Save New Layout**, enter **Layout name**, then select **Save** | | Leave new-arrangement entry | **Table Layout**, **Cancel** | | Change the current arrangement | **Table Layout**, **Update Current** | | Remove the current arrangement | **Table Layout**, **Delete Current**, then **Delete** | | Remove an eligible warehouse row | **Delete**, then **Delete** | | Stop a deletion | **Cancel** | If the warehouse limit is exceeded, selecting **New** opens **Upgrade needed** instead of the New warehouse page. **Result:** The New warehouse page, Edit warehouse page, or selected table action is on screen. If an action is unavailable, use the next section to check which surfaces your configuration provides. ## Handle available surfaces Your company plan controls access to the warehouse list, toolbar, **New**, and row **Delete**. The current table arrangement determines which list columns appear. **Settings** shows **Export**, **Filter Row**, and **Group Panel** when those options are available. Open **Columns Chooser** from **Table Layout**. The import-mode file field belongs to import mode, but the import action is not available on this list. ![Column Chooser with the available column names](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/16a51d607c1876fc388df75c7f54e798.png) ## When an action does not work | Message or situation | Response | | --- | --- | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the filter and apply it again. | | `Are you sure you want to delete?` | Select **Delete** to confirm or **Cancel** to stop. | | `Data Deleted Successfully` | Continue from the list after the deletion. | | `Data Importing completed` | Continue after the import finishes. | ## What to do next For warehouse creation or saved-record editing, use the New warehouse or Edit warehouse page. For operations, go to Warehouse fulfillment flow. For product stages, go to Product stages. For files, go to Libraries. ## Notes from our rollout # New warehouse Use this page to enter a warehouse record and understand which configuration surfaces become available after the record is saved. ## New warehouse at a glance A warehouse record identifies a storage location, its description, its store type and administrator, the branches it serves, and its address. The New warehouse page is the starting point for recording that information before the warehouse has an existing record ID. | If you need to… | Go to | |---|---| | Check the information and choices on the unsaved form | [Understand the warehouse form](#understand-the-warehouse-form) | | Enter the warehouse information and choose how to leave the page | [Enter and save warehouse details](#enter-and-save-warehouse-details) | | Work with areas, inventory settings, or modification history after saving | [Use the saved warehouse surfaces](#use-the-saved-warehouse-surfaces) | | Find the warehouse list | [Warehouses](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-view) | | Edit a saved warehouse | [Edit warehouse](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-edit-record) | | Configure the warehouse inspection base | [Warehouse inspection base](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-base) | The form can assign the warehouse to one or more branches and includes an address surface. After a new warehouse is saved, the record stays open unless you use **Save and Close**. ![The new warehouse form with its identity, branch, and address fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/bde12542f33f06954447e7580f4960dd.png) ## Before you start Collect the name, description, store type, store administrator, branch assignment, and address information before you begin. The form requires **Display Name**, **Description**, **Store type**, and **Store Admin**; the page also marks **Destination Title** as required. The branch-selection control and its options are available on the form. | Have or know | Why it matters | |---|---| | The warehouse display name and description | These are required warehouse details. | | The store type and store administrator | These are required choices on the form. | | The branches that use the warehouse | The warehouse can be assigned to one or more branches. | | The destination title and address | The address surface includes **Destination Title**, **Country**, **State**, **City**, **Street**, and **Zip-code**. | | Access to the new warehouse page | Create a warehouse record. | The form and its save controls are available only when the warehouse data is present, the page is not unavailable, and the subscription permits the surface. Save controls also depend on edit permission and on unsaved data changes. ## Open the New warehouse page The new warehouse page is the blank-record page; the warehouse list is a separate saved-record surface. **Prerequisites** - Have access to the warehouse configuration area. **Steps** 1. Open the New warehouse page. ![The route open with the Display Name field ready for entry](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9badca317b679745c5e4c8ca3a1c08b9.png) **Result:** The new-warehouse form is on screen with its warehouse fields, branch-selection control, address fields, **Save**, and **Save and Close**. ## Understand the warehouse form The warehouse form collects the identity, assignment, store administration, and address details that describe where warehouse work is managed. On a new record, the form shows the entry fields but not the saved-record tabs **Areas**, **Inventory Model**, or **Last Modifications**. ### Warehouse details | Field or control | What to enter or choose | Requirement or availability | |---|---|---| | **Display Name** | The warehouse's displayed name | Required | | **Description** | A description of the warehouse | Required | | **Store type** | Choose an option displayed in **Store type** | Required | | **Store Admin** | Choose an option displayed in **Store Admin** | Required | | **Warehouse belong to branch** | The branch assignment | The control and its options are displayed; the field is not marked required | ### Store type choices **Store type** and **Store Admin** are required choices used while defining the warehouse. ### Address details | Address field | Requirement or availability | |---|---| | **Destination Title** | Displayed and marked required | | **Country** | Displayed | | **State** | Displayed | | **City** | Displayed | | **Street** | Displayed | | **Zip-code** | Displayed | The address is part of the new-warehouse form. The address fields other than **Destination Title** are displayed without a required marker. ![The Description field and required fields on the new warehouse form](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f4eda28c56dc35522d3c879124ff19d7.png) ## Enter and save warehouse details Enter the warehouse information, then choose how to save the record. The form saves a new warehouse when no record ID exists; the same **Save** control updates a warehouse when an existing ID is present. **Save and Close** saves and leaves the page. **Prerequisites** - Have the required warehouse information listed in [Before you start](#before-you-start). - Have edit access to the warehouse form. **Steps** 1. In **Display Name**, enter the warehouse name. 2. In **Description**, enter the warehouse description. 3. In **Store type**, choose an option displayed in **Store type**. 4. In **Store Admin**, choose an option displayed in **Store Admin**. 5. In **Warehouse belong to branch**, select the branches that use the warehouse. 6. In the address surface, enter **Destination Title**. 7. In the address surface, enter **Country**. 8. In the address surface, enter **State**. 9. In the address surface, enter **City**. 10. In the address surface, enter **Street**. 11. In the address surface, enter **Zip-code**. 12. Choose how to save the record. | If you need to… | Select | |---|---| | Keep the record open | **Save** | | Save the record and leave the page | **Save and Close** | If a required field is empty, the form uses the message `This Field Is Required`. 13. If the save succeeds, look for `Your request was completed successfully`. **Result:** **Save** keeps the record open. **Save and Close** saves the record and leaves the page. The success message is `Your request was completed successfully` when that success response is shown. ## Use the saved warehouse surfaces Saved-record surfaces extend the warehouse record beyond the initial entry form. They require an existing warehouse record ID, so use them after saving the new record. | Surface or action | What it provides | |---|---| | **Areas** | The warehouse areas surface and its area grid | | **Inventory Model** | The warehouse inventory-model surface | | **Last Modifications** | The audit history surface | | New-area icon | Opens the new warehouse-area popup | | Edit-area icon | Opens the editor for a non-default area | | **Delete** | Deletes a non-default area | | Inventory Model save control | Updates the warehouse model | The Areas grid shows the columns **Name**, **Short name**, **Description**, **X position**, **Y position**, and **Z position**. The area popup does not provide the fields **Short name**, **Area Admin**, **X position**, **Y position**, and **Z position**. Area edit and delete actions require an existing area row and edit permission. The New area action also requires the Areas surface and edit permission. The **Inventory Model** surface provides these choices: | Inventory model option | |---| | **Only Storage Products/goods** | | **Storage with on site assembly area for products/goods** | | **Have standalone assembly area for products/goods** | The saved-record tabs require an existing warehouse ID. Before that condition is met, the new record shows the entry form instead. > **Note:** Complete the new-record save before using the saved-record tabs and their actions. ## When saving or loading goes wrong Use the message on screen to decide whether to correct a field, check access or subscription, or return to the appropriate saved-record route. | What you see | What it means | What to do | |---|---|---| | `This Field Is Required` | A required field is empty. | Return to the required field and enter or choose its value before selecting **Save** or **Save and Close**. | | `Your request was completed successfully` | The warehouse save completed without an error. | Continue with the saved warehouse surface or the next task. | | `An error occurred while processing your request` | The save returned an error. | Resolve the error before trying again. | | `You cannot change or delete records developed by Pams` | The record is protected from change or deletion. | Do not attempt to change or delete that record; use a record you are permitted to administer. | | The subscription message appears | The subscription does not include the surface. | Contact the person who manages your subscription before continuing. | | The not-found page appears | The requested page or record cannot be found. | Return to the warehouse list and open the required saved record from there. | ## What to do next | Your next task | Continue with | |---|---| | Review registered warehouses | [Warehouses](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-view) | | Edit a saved warehouse | [Edit warehouse](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-edit-record) | | Configure the warehouse inspection base | [Warehouse inspection base](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-base) | The list page is the saved-warehouse starting point. Continue to [Edit warehouse](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-edit-record) for a saved record, or to [Warehouse inspection base](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-base) for inspection-base configuration. # Edit warehouse ## Overview A warehouse record defines a storage location for warehouse work. It brings together the warehouse's identity, branch association, address, areas, inventory model, and modification history. | Task | Go to | | --- | --- | | Find an existing warehouse | [Find and open a warehouse record](#find-and-open-a-warehouse-record) | | Review the warehouse identity and address | [Understand the warehouse screen](#understand-the-warehouse-screen) | | Change and save warehouse details | [Review and save warehouse details](#review-and-save-warehouse-details) | | Add, change, or remove an area | [Maintain warehouse areas](#maintain-warehouse-areas) | | Choose a storage model or inspect changes | [Choose an inventory model and review history](#choose-an-inventory-model-and-review-history) | | Return to the warehouse list | [Warehouses](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-view) | | Create a warehouse | [New warehouse](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-new) | | Configure inspection or transfer-related settings | [Base of inspection](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-base), [Inspection documents](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-documents), or [Transfer reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-transfer-reasons) | The **Comments** tab holds record comments. The **Areas** tab holds the warehouse areas, **Inventory Model** holds the storage model, and **Last Modifications** provides the record history. ## Before you start **Prerequisites** - Sign in to PAMS. - Identify the existing warehouse you need to review or change. - Have permission to edit the warehouse. **Save**, **Save and Close**, area changes, and inventory model changes depend on edit permission. - Have the correct warehouse identity, responsible administrator, branch association, and address information available. - Review the required markers on the current form. **Country**, **State**, **City**, **Street**, and **Zip-code** are required only when the current address configuration makes them mandatory. - Save before leaving if you change a value. Leaving the page is protected when unsaved changes are present. ## Find and open a warehouse record The warehouse list is the starting point for finding an existing storage location in the **Configuration** area. Use an existing warehouse row when you need its edit record. **Prerequisites** - You are signed in and can open the warehouse list. - You know which existing warehouse row you need to open. **Steps** 1. Open the warehouse list from the **Configuration** area. 2. Identify the existing warehouse row. 3. Select the warehouse row to open its edit record. The list includes **New** for opening the separate warehouse-creation page. Use [New warehouse](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-new) when you need to create a record. **Result:** The selected warehouse edit record is on screen. ## Understand the warehouse screen The warehouse screen identifies a storage location and its warehouse rules. The main form contains identity, responsibility, branch, and address information. Saved records also expose the areas, inventory model, and modification-history surfaces. ### Warehouse details | Field | What to review | | --- | --- | | **Display Name** | The warehouse name shown to users. | | **Description** | The warehouse description. | | **Store type** | The warehouse type: `Physical`, `Virtual`, or `Partner`. | | **Store Admin** | The responsible warehouse administrator. | | **Warehouse belong to branch** | The branch association checkboxes. | The address area contains **Destination Title**, **Country**, **State**, **City**, **Street**, and **Zip-code**. **Destination Title** is required when an address is selected. The other address fields are required only where the current address configuration marks them as mandatory. ### Tabs and areas | Tab | Use it for | | --- | --- | | **Comments** | Review comments associated with the warehouse record. | | **Areas** | Review and maintain warehouse-area rows. | | **Inventory Model** | Review and separately save the warehouse storage model. | | **Last Modifications** | Open the warehouse modification history. | The main form appears when the subscription includes the feature, the record is not marked as not found, and warehouse details are available. The three tabs require an existing warehouse record. Save controls appear only when editing is allowed, and become enabled only after a data change. The **Areas** grid has these columns: | Column | Use it for | | --- | --- | | **Name** | The warehouse-area name. | | **Short name** | The short area name. | | **Description** | The area description. | | **X position** | The X position value. | | **Y position** | The Y position value. | | **Z position** | The Z position value. | The area form provides **Name** and **Description** controls. It does not provide **Short name**, **Area Admin**, **X position**, **Y position**, or **Z position** as editable dialog controls. ## Review and save warehouse details Review the warehouse identity, branch association, or address before committing a change. **Save** updates the existing record. **Save and Close** updates it and leaves the page after a successful save. **Prerequisites** - An existing warehouse record is open and its details have loaded. - You have edit permission for the warehouse. - You have the approved identity, responsible administrator, branch, and address values. **Steps** 1. Review the warehouse details that you need to change. 2. Enter the corrected text in the field you want to change. | Value to change | Action | | --- | --- | | **Display Name**, **Description**, **Destination Title**, **State**, **City**, **Street**, or **Zip-code** | Enter the corrected text in the named field. | | **Store type**, **Store Admin**, or **Country** | Select the corrected value in the named field. | | **Warehouse belong to branch** | Select or clear the applicable branch checkbox. | 3. Select **Save** to validate and update the warehouse while staying on the record. 4. Select **Save and Close** instead when the validated update should also leave the record. Use only one of the two save controls for a change. Both controls require edit permission and a data change, and are disabled when the form has no changes. The form validates the warehouse and address values before submitting the update. After a successful update, PAMS displays `Your request was completed successfully`. When the update cannot be processed, PAMS displays `An error occurred while processing your request`. If the record is protected, PAMS displays `You cannot change or delete records developed by Pams`. **Result:** The warehouse details remain on screen after **Save**, or the page closes after a successful **Save and Close**. ## Maintain warehouse areas A warehouse area is a named part of the warehouse used to organise storage within the location. Open **Areas** to review its rows and to add, change, or remove an area when editing is allowed. Treat default areas as protected rows: do not edit or delete them. **Prerequisites** - An existing warehouse record is open. - **Areas** is available on the record. - You have edit permission for an add, edit, or delete action. **Steps** 1. Select **Areas**. 2. Choose the required area action from this table. | Action | What to select | | --- | --- | | Add an area | Select the plus icon beside **Areas**. | | Change an existing non-default area | Select the edit action for the area. | | Remove an existing non-default area | Open the area’s actions. | | Keep a default area unchanged | Do not select an edit or delete control. | 3. If you are removing an area, select **Delete**. 4. For an add or edit action, enter the area name in **Name**. 5. For an add or edit action, enter the area explanation in **Description**. 6. For an add or edit action, select the completion control in the open area dialog. The add and edit icons appear only for an existing warehouse on **Areas** when editing is allowed. The **Delete** action requires edit permission. Default areas cannot be changed or removed. **Result:** The **Areas** surface shows the warehouse-area rows after the allowed add, edit, or delete action. ## Choose an inventory model and review history The inventory model describes how the warehouse stores and assembles products. It is maintained separately from the main warehouse details. **Last Modifications** is the audit-history surface for reviewing changes to the record. **Prerequisites** - An existing warehouse record is open. - You can open **Inventory Model** or **Last Modifications** on the record. - You have edit permission before changing and saving the inventory model. **Steps** 1. Select **Inventory Model**. 2. Choose the model that matches the warehouse. | Warehouse condition | Select | | --- | --- | | Uses storage only | The storage-only option. | | Stores products and has an on-site assembly area | The storage-with-assembly-area option. | | Has a stand-alone assembly area | The storage-with-stand-alone assembly-area option. | 3. In **Inventory Model**, select the save control after changing the model. 4. Select **Last Modifications**. 5. Select **Registration** when it is available to review a history entry. The inventory-model save control is disabled until the model changes. If saving the model fails, PAMS displays `An error occurred while processing your request`. **Result:** The selected inventory model is saved separately from the main warehouse details, or the **Last Modifications** history is open for review. ## When an action is unavailable or fails Use this table to match the screen condition to the rule that controls it. | What you see | What it means | What to do | | --- | --- | --- | | The warehouse form is not available. | The subscription is not included, the record is marked not found, or warehouse details are not present. | Check the record and subscription access before continuing. | | **Save** and **Save and Close** are unavailable. | Editing is not allowed, or the form has no data changes. | Confirm edit permission and change an allowed value before saving. | | **Areas**, **Inventory Model**, or **Last Modifications** is unavailable. | The record is not an existing warehouse, or the page condition for the tab is not met. | Open a saved warehouse record. | | The add action beside **Areas** or the edit action for an area is unavailable. | The record is not saved, **Areas** is not selected, or editing is not allowed. | Open an existing record, select **Areas**, and confirm edit permission. | | The inventory-model save control is unavailable. | The selected model has no changes. | Change the inventory model before saving it. | | The page cannot load the warehouse details. | PAMS displays `An error occurred while processing your request`. | Return to the warehouse list and reopen the existing record. | | A warehouse update fails. | PAMS displays `An error occurred while processing your request`. | Review the required fields and permission, then submit the allowed change again. | | An inventory-model update fails. | PAMS displays `An error occurred while processing your request`. | Review the selected model and edit permission, then save the model again. | | You leave with unsaved changes. | The screen's deactivation protection handles the unsaved-change state. | Save the change before leaving, or use the page's close action after deciding whether to keep it. | ### Out of scope messages | Message | Why it is out of scope | | --- | --- | | `You cannot change or delete records developed by Pams` | PAMS uses this message for protected records; warehouse deletion steps are not part of this task. | | `Just '_'‘-''.' And '&' Characters Accepted` | The embedded Files dialog displays this file-name validation message. | The embedded Files dialog can display the file-name validation message when it validates the file-name characters. ## Continue after reviewing the warehouse After reviewing or maintaining the record, return to [Warehouses](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-view) to choose another existing warehouse or select **New** for a separate warehouse-creation task. For related configuration work, continue with [New warehouse](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-new), [Base of inspection](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-base), [Inspection checklist](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-checklist), [Inspection documents](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-documents), [Transfer reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-transfer-reasons), [Service types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-service-types), or [Stock withdrawal and valuation](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-stock-withdrawal). **Result:** You are back at the warehouse configuration flow or on the related configuration page that matches the next warehouse task. # Base of inspection A base of inspection is a Warehouse configuration record used to name an inspection base. Use this page to find the list, review its fields, and maintain eligible records. | If you need to… | Go to | |---|---| | Understand where the list belongs | [Base of inspection](#base-of-inspection) | | Check access and record requirements | [Before you start](#before-you-start) | | Open the list or start a record | [Find the reference list](#find-the-reference-list) | | Review the list and entry form | [Understand the list and entry form](#understand-the-list-and-entry-form) | | Add, edit, save, cancel, or delete a record | Maintain entries | | Handle access or column variations | [Handle access and configuration variations](#handle-access-and-configuration-variations) | | Resolve a validation or maintenance message | [When maintenance does not work](#when-maintenance-does-not-work) | | Open a related Warehouse list | [Continue with related warehouse lists](#continue-with-related-warehouse-lists) | ## Base of inspection Find the **Base of inspection** list in **Warehouse** settings. The list contains the records for this setting. The same navigation shows **Inspection checklist**, **Inspection Document**, **Transfer Reasons**, **Service Types**, and **Stock Withdrawal and Valuation** under **Warehouse**. The **Inventories** heading is also visible. ![The base-of-inspection list in Warehouse settings](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5b14fe0f5dc8863f056ffa80a1b89eb5.png) ## Before you start Collect the name before opening a new record, then check that your account can use the action you need. | Before you start | Why it matters | |---|---| | The subscription includes the configured feature | The grid and configuration actions are available. | | The subscription does not include the configured feature | An upgrade surface appears instead of the grid. | | **New** is not hidden | The new-record entry point is available when the subscription feature is included. | | New permission is available and columns/data are loaded | The separator after **New** is available. | | Edit permission is available | The row edit control is available. | | Delete access is available | The delete action appears when permission is available. | | A base name is ready | **Name** is required before the record can be submitted. | | The visible list headers are known | Use the labels shown in your list. | With these conditions checked, open the list next. ## Find the reference list Use this list to review configured base names or open the new-record entry point. **Prerequisites** - The subscription includes the configured feature. - Your account can open the Warehouse configuration surface. **Steps** 1. In **Warehouse** settings, select **Base of inspection**. 2. Confirm that the **Name** column is visible. 3. Review the four rows in the list. 4. Select **New**. 5. Confirm that the new-item popup opens with **Name** and **OK**. ![The base-of-inspection list with its Name column, four rows, and New action](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/50a877e4d57808c35d622c4dd88f0b77.png) The list also shows title-only **Refresh** and **Settings** controls. **Result:** The list is open, or the new-item popup is open with **Name** ready for entry. ## Understand the list and entry form The form has one reader-entered field: the required **Name**. The list shows **Name**; other configured fields support the record without becoming editable form fields. | Surface | What you see | What it is for | |---|---|---| | List | **Name** | Identifies each base-of-inspection record. | | New or edit form | **Name** with a required marker | Enters the record name. | | New or edit form | **OK** on the new-item surface | Submits the visible new-item form. | | Record actions | Edit and delete controls | Maintains an existing row when the corresponding permission is available. | | Field | List visibility | Form visibility | Reader use | |---|---|---|---| | **Name** | Visible and filterable | Visible and required | Enter the base name. | This form contains no select, date, number, or nested-collection fields for this list. Additional columns or labels may appear in the list; use the labels shown on screen. > **Note:** Work from the headers visible in your list when the saved configuration supplies more > columns or different labels. ![The list showing the visible Name column](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5b14fe0f5dc8863f056ffa80a1b89eb5.png) ## Open an entry and cancel deletion Use the new-item popup for a new record, the row edit control for an existing record, and the row delete menu for a deletion decision. ### Open and prepare a new entry **Prerequisites** - The subscription includes the configured feature. - **New** is visible. - You have the base name ready. **Steps** 1. Select **New**. 2. Enter the base name in **Name**. 3. Select **OK**. If **Name** is empty, the form uses `Name is required`. If the value fails the name pattern, the form uses `Just '_' '-' And '.' Characters Accepted`. **Result:** The new-item form has received the **OK** action. ### Open an existing entry **Prerequisites** - The row already exists. - Edit permission is available. **Steps** 1. Select the row's edit control. 2. Enter the updated base name in **Name**. 3. Select **OK**. 4. If you decide not to commit the change, select **Cancel** in the save popup. The shared save path uses `Data updated Successfully` for an update. **Result:** The row's popup has received the requested action. ### Open and cancel a deletion **Prerequisites** - Delete permission is available. - More than one item is in the list. **Steps** 1. Select the row's delete control. 2. Select **Cancel** to close the delete menu without deleting the row. When the list has one item or fewer, deletion is blocked and the product uses `Must have at least one item`. **Result:** The delete menu is closed and the row remains in the list. ### Delete an eligible row **Prerequisites** - Delete permission is available. - More than one item is in the list. **Steps** 1. Select the row's delete control. 2. Select **Delete** in the delete menu. The shared delete path uses `Data Deleted Successfully` after a successful deletion. Related saved data can instead produce `Related to Saved data, Can't be deleted`, or a failed request can produce `Failed to Delete`. **Result:** The selected row has received the **Delete** action. ## Handle access and configuration variations The list can differ according to subscription coverage, permissions, saved list settings, and the columns visible on screen. | Variation | What changes on screen | |---|---| | The subscription does not include the configured feature | The subscription-upgrade surface replaces the grid. | | The saved list setting hides **New** | **New** is hidden. | | New permission is unavailable | The new-entry action is unavailable. | | Edit permission is unavailable | The row edit control is unavailable. | | The delete action is unavailable | The row delete control and delete menu are unavailable. | | Additional columns or labels appear | Use the columns and labels shown on screen. | | A column label differs from the expected name | Use the label shown on screen; do not infer a different field. | The list shows **New**, **Refresh**, and **Settings**. **Export** can appear after a list interaction. ![The list surface with the Export control exposed](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/405e34270708af1d06ea2cb4385c9599.png) ## When maintenance does not work | Message or situation | What it means | What to do | |---|---|---| | `Name is required` | The required field has no value. | Enter a value in **Name**. | | `Just '_' '-' And '.' Characters Accepted` | The entered name fails the pattern rule. | Correct **Name**, then select **OK**. | | `Forbidden characters detected. Please remove them and try again.` | The list filter contains forbidden characters. | Remove the forbidden characters and apply the filter again. | | `Data saved Successfully` | The new-record save path completed. | Check the list for the new row. | | `Data updated Successfully` | The existing-record update path completed. | Check the row for the updated **Name**. | | `Data Deleted Successfully` | The delete success path completed. | Check that the row is no longer in the list. | | `Must have at least one item` | The list has one item or fewer, so deletion is blocked. | Keep at least one item in the list. | | `Related to Saved data, Can't be deleted` | Related saved data prevents deletion. | Keep the row and review the related saved data. | | `Failed to Delete` | The delete request failed. | Stop repeating the request and review the deletion conditions. | ## Continue with related warehouse lists The **Warehouse** settings navigation exposes related reference lists beside **Base of inspection**. Open the list that matches the reference data you need; each remains a separate Warehouse configuration resource. - [Warehouse configuration](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-view) - [Inspection documents](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-documents) - Inspection checklist - Transfer Reasons - Service Types - Stock Withdrawal and Valuation. To maintain another resource, open its list or tab. # Inspection checklist An inspection checklist is Warehouse configuration for the inspection items used in inspection work. Use **Products inspection checklist** to maintain the items, their descriptions, and their inspection bases. | If you need to… | Go to | |---|---| | Understand this configuration | [Inspection checklist](#inspection-checklist) | | Check access and lookup requirements | [Before you start](#before-you-start) | | Open the list or an entry | [Find the inspection checklist](#find-the-inspection-checklist) | | Read the list columns and row count | [Understand the checklist list](#understand-the-checklist-list) | | Create an entry | [Maintain checklist entries](#maintain-checklist-entries) | | Understand unavailable controls or choices | [Handle access and setup differences](#handle-access-and-setup-differences) | | Resolve a validation or maintenance problem | [When maintenance goes wrong](#when-maintenance-goes-wrong) | | Continue with related warehouse work | [Continue with warehouse inspection work](#continue-with-warehouse-inspection-work) | ## Inspection checklist The configuration belongs to **Warehouse** settings, and its popup title is **Inspection checklist**. The page title is **Products inspection checklist**. The list has these columns: | Column | What it identifies | |---|---| | **Object to inspet** | The object or subject of the check | | **Description** | A description of the check | | **Inspection base** | The inspection base associated with the entry | ## Before you start The inspection checklist is available when your subscription includes the configured feature. Your role and company setup determine which actions and choices you see. | Before you start | Why it matters | |---|---| | A subscription that includes the configured feature | The configuration grid is shown. | | A subscription that includes the feature and a visible **New** action | You can open a new entry. | | Company inspection-base records | Their **Name** values supply the **Inspection base** choices. | | Access to the Warehouse configuration area | The list and new-entry surface are available. | Maintain the company-specific inspection-base names in [Base of inspection](configuration-warehouse- inspection-base.md). The checklist rows and choices belong to the current company. > **Note:** The inspection-base names are not a fixed list on this page. ## Find the inspection checklist Open the list to review entries or start a new or existing configuration record. **Prerequisites** - The subscription includes the configured feature. - Your account can open the Warehouse configuration area. **Steps** 1. Open the Warehouse inspection checklist configuration page. 2. Confirm that the list shows **New**, **Refresh**, and **Settings**. 3. Select **New** to open an empty item in the **Inspection checklist** popup. ![The checklist list with New, Refresh, Settings, and its visible columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6b5cc9d5001d00066752d88f776ed8b8.png) **Result:** The checklist list is open, or the **Inspection checklist** popup is open for a new entry. ## Understand the checklist list Use the visible headers and rows to identify the checks maintained for your company. The displayed values are company records, not product defaults. | Visible list detail | What to use it for | |---|---| | **Object to inspet** | Identify the inspection subject. | | **Description** | Read the check's description. | | **Inspection base** | See the inspection base associated with the row. | | `Count: 7` | Read the displayed total in this current-company example. | In this current-company example, the list displays 7 rows and a `Count: 7` readout. Header filtering and paging are disabled, and import is not enabled. ![The checklist toolbar with the available export surface](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6d9d703ec91118700300b7fed1f41c19.png) ## Maintain checklist entries Create an entry when the company needs a new inspection item. **Prerequisites** - The checklist list is open. - You have the inspection subject and any description to enter. - The relevant company inspection-base records exist. **Steps** 1. Select **New**. 2. In **Object to inspet**, enter the inspection subject. 3. Optional: In **Description**, enter the description of the check. 4. In **Inspection base**, select one or more company inspection-base names. 5. Review the completed entry in the popup. When the product accepts a new entry, it uses `Data saved Successfully`. The **Object to inspet** field is required; **Description** is not. The available names come from company inspection-base records. ![The new checklist surface with its three fields and required Object to inspet marker](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9b17333315d39d151184fe189b955a7c.png) **Result:** The new checklist entry is complete in the form. ### Change an entry Change an existing entry when its inspection subject, description, or inspection-base association needs correction. When the product accepts the edited entry, it uses `Data updated Successfully`. ### Remove an entry Remove an entry when the company no longer needs that inspection item. Deletion requires a confirmation before the selected item is removed. ## Handle access and setup differences The checklist surface changes with your company's subscription, permissions, and field visibility. | Surface or choice | When it appears | |---|---| | Configuration grid | The subscription includes the configured feature. | | **New** | The subscription includes the feature and the action is available. | | Form field | The field is configured to appear in the entry form. | | **Inspection base** choices | The shared form loads the company records maintained on **Base of inspection**. | When the subscription is unavailable, an upgrade surface appears instead of the configuration grid. Another company or role can expose a different set of actions or fields. ## When maintenance goes wrong Use the exact message on screen to choose the next action. Required-field and character checks stop an invalid entry; delete messages describe whether the selected entry is related to saved data, failed, or would leave no item. | Message or situation | What to do | |---|---| | `Object to inspet is required` | Enter a value in **Object to inspet** before completing the entry. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the entry and submit it again. | | `Are you sure you want to delete this item?` | Review the deletion confirmation before continuing. | | `Data Deleted Successfully` | The selected entry was deleted. | | `Related to Saved data, Can't be deleted` | Keep the entry and review the saved data that relates to it. | | `Failed to Delete` | Treat the deletion as unsuccessful and follow your support or administration process. | | `Must have at least one item` | Keep at least one checklist item in the list. | | The entry cannot be removed | Review the deletion message and keep the entry when related saved data prevents removal. | ## Continue with warehouse inspection work The checklist supplies inspection items for warehouse inspection work. Company-specific inspection base names belong to [Base of inspection](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-base). For related configuration, open [Inspection documents](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-documents). Inspection documents and incoming inspection work are outside this page's subject; use the relevant warehouse work area for those activities. # Stock withdrawal and valuation Use this Warehouse configuration list to record how stock is withdrawn and valued for each product group. ## Stock withdrawal and valuation Stock withdrawal and valuation is a configuration list for a product group. Each record brings together the product **Group**, the **Withdrawal** method, and the **Valuation** method. | If you need to… | Go to | | --- | --- | | Check access, subscription, and required fields | [Before you start](#before-you-start) | | Open the list or a new item | [Find a setting](#find-a-setting) | | Read the list and form together | [Understand the setting](#understand-the-setting) | | Review choices and required messages | [Fields and choices](#fields-and-choices) | | Create, edit, cancel, or request deletion | [Maintain a setting](#maintain-a-setting) | | Understand why a control or field is absent | [Handle configuration and access branches](#handle-configuration-and-access-branches) | | Respond to a validation or loading problem | [When saving or loading goes wrong](#when-saving-or-loading-goes-wrong) | | Open another Warehouse setting | [Continue with related warehouse settings](#continue-with-related-warehouse-settings) | ## Before you start This setting is available through the shared Warehouse configuration surface. Your subscription, permissions, saved field configuration, and the product groups returned to the form determine what you can do. | Before you start | What it affects | | --- | --- | | The subscription includes the feature | **New** and the shared configuration surface can be available. | | **New** is not hidden | The **New** entry point can appear. | | Editing is allowed and the subscription includes the feature | An existing row can be edited. | | Deletion is allowed | A row can expose its deletion action. | | Product groups are available to you | The **Group** list can offer choices. | | The three fields are required | The form requires **Group**, **Withdrawal**, and **Valuation** before completion. | The product-group choices are returned when the form loads. Choose from the **Group** options currently offered to you. ## Find a setting The Stock withdrawal and valuation list is the Warehouse settings page for reviewing existing product-group rules and opening the shared new-item form. Prerequisites - The subscription includes the feature. - You can open Warehouse settings. Steps 1. In Warehouse settings, select **Stock withdrawal and valuation**. 2. Confirm that the list shows the **Group**, **Withdrawal**, and **Valuation** columns. 3. Check that the list counter shows `Count: 3`. 4. Open the setting that matches your task: | When you want to… | Action | | --- | --- | | Open a new item | Select **New**. | | Open an existing setting | Select its row. | The same Warehouse navigation shows Base Of Inspection, Inspection Checklist, Inspection Document, Transfer Reasons, and Service Types alongside this setting. ![The Warehouse settings list with its three columns, Count: 3, and New action](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e647644a244449f291f2c897771f2d16.png) **Result:** The Stock withdrawal and valuation list or its new-item form is on screen. ## Understand the setting The list and the new-item form show different parts of the same configuration record. | Surface | What you see | What it is for | | --- | --- | --- | | List | **Group** | Identifies the product group represented by the row. | | List | **Withdrawal** | Shows the stock-withdrawal method recorded for the row. | | List | **Valuation** | Shows the valuation method recorded for the row. | | New-item form | **Group**, **Withdrawal**, and **Valuation** | Supplies the three values for the configuration record. | The configured list does not include **Group**, while the list can show **Group**. Use the headers that are visible in your list because saved list configuration supplies the final column set. ### Fields and choices The new-item form uses three required select boxes. In **Group**, select one of the product groups offered by the form. In **Withdrawal** and **Valuation**, select from the choices listed below. | Field | Control and choices | | --- | --- | | **Group** | Select one of the product groups offered by the form. | | **Withdrawal** | **First In, First Out (FIFO)**, **Last In, Last Out (LIFO)**, **First Expired, First Out (FEFO)**, or **Manual**. | | **Valuation** | **Actual Cost** or **Avrage Cost**. | Each field carries a required marker on the form. If a required value is missing, the form uses the following message: | Field | Message | | --- | --- | | **Group** | `Group is required` | | **Withdrawal** | `Withdrawal is required` | | **Valuation** | `Valuation is required` | The spelling **Avrage Cost** is the product's displayed choice. Keep it as shown when selecting a valuation method. Use these fields and choices when you maintain a setting. ![The new-item form with the three required select boxes](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0a8442d71b2c28aec74ad56962bf7f6b.png) ## Out of scope Use this page for the three select boxes that belong to stock withdrawal and valuation. The page configuration does not provide a visible **Group** list column, although the list can show that header. It also provides no date, number, text, or currency field for this entity. The following messages belong to other generic configuration forms, not to these three select boxes: | Message | Where it belongs | | --- | --- | | `This Field Is Required` | Generic date-box forms. | | `Required` | Survey-answer and reference-list forms. | | `Field is required` | Other configuration forms; it does not apply to **Group**, **Withdrawal**, or **Valuation**. | ## Maintain a setting Use one configuration record for one product group. The form supports opening a new item, changing an existing row, closing without saving, and requesting deletion of a row. Prerequisites - The Stock withdrawal and valuation list is open. - The subscription includes the feature for a new item or edit. - **New** is visible for a new item, editing is allowed for an existing row, or deletion is allowed for a deletion request. - You know which product group, withdrawal method, and valuation method to record. Steps 1. Open the form that matches your task: | When you want to… | Action | | --- | --- | | Create a setting | Select **New**. | | Change a setting | Select the existing row. | 2. In **Group**, select the product group. 3. In **Withdrawal**, select the withdrawal method. 4. In **Valuation**, select the valuation method. 5. Choose the action that matches your form. | When you want to… | Action | Result | | --- | --- | --- | | Submit a new item from the form | Select **OK** | The visible new-item form is submitted. | | Save a record after the save confirmation appears | Select **Save** | The popup saves and closes. | | Leave the form without saving | Select **Close** | The popup closes and the list remains open. | | Cancel the popup | Select **Cancel** | The popup closes without the save action. | 6. To request deletion, open the row's delete action. 7. Read `Are you sure you want to delete this item?`. 8. Choose the confirmation action that matches your decision: | When you want to… | Action | | --- | --- | | Request deletion | Select **Delete**. | | Leave the row unchanged | Select **Cancel**. | ![The list after Close returns from the new-item form](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e647644a244449f291f2c897771f2d16.png) **Result:** The form is submitted, closed without saving, or a deletion request is open. After **Close**, the list is on screen without a route change. If an action or field is absent, review the configuration and access branches. ## Handle configuration and access branches The shared Warehouse surface changes the available actions and fields according to subscription, permissions, visibility settings, and list configuration. | Condition | What you can see or do | | --- | --- | | The subscription is included and **New** is not hidden | **New** is available. | | Editing is allowed and the subscription is included | An existing setting can be edited. | | Deletion is allowed | A row can expose **Delete**. | | The form has a selected item and the field is visible in the form | That field appears in the new or edit popup. | | Product groups are available to you | **Group** offers those product groups. | If a condition is not met, the corresponding action or field may not appear. A missing control means that the available subscription, permission, record, or saved configuration is different; saving or loading failures are covered in the next section. ## When saving or loading goes wrong | Validation message | | --- | | `Forbidden characters detected. Please remove them and try again.` | The visible list headers reflect the saved list configuration. The related Warehouse settings are listed in the next section. ## Continue with related warehouse settings The Stock withdrawal and valuation page sits in the Warehouse settings navigation with the sibling settings Base Of Inspection, Inspection Checklist, Inspection Document, Transfer Reasons, and Service Types. - [Warehouse configuration](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-view) - [Base of inspection](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-base). - [Inspection checklist](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-checklist) - [Inspection documents](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-documents) - [Transfer reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-transfer-reasons) - [Service types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-service-types) Open the sibling setting that owns the warehouse data you need to maintain. # Inspection documents ## Inspection documents An inspection document is a warehouse configuration record that names a document used in warehouse work. You manage it under **Configuration** > **Warehouse settings** on the shared configuration surface. | If you need to… | Go to | |---|---| | Check access and record requirements | [Before you start](#before-you-start) | | Open the list or new-record surface | [Find an inspection document](#find-an-inspection-document) | | Learn what the list and form contain | [Understand the list and form](#understand-the-list-and-form) | | Add, edit, delete, save, or export | [Add or maintain an inspection document](#add-or-maintain-an-inspection-document) | | Understand access and layout differences | [Handle access and surface variations](#handle-access-and-surface-variations) | | Resolve a message or blocked action | [When maintenance does not work](#when-maintenance-does-not-work) | | Open a related Warehouse list | [Continue with related warehouse configuration](#continue-with-related-warehouse-configuration) | The list heading and popup title are **Inspection document**, and the parent setting is **Warehouse**. The list shows the **Name** column and eight records. ![The Inspection document list with its Name column and records](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3b1e25d0e23be1462ea2257105c8f6a4.png) ## Before you start The inspection document list is available when the subscription includes the shared configuration surface. Your permissions and the saved list configuration determine which maintenance actions appear. | Condition | What you can expect | |---|---| | The subscription includes this area | The inspection-document list is available. | | The subscription does not include this area | An upgrade surface appears instead of the list. | | **New** is visible | You can open the new-record surface. | | The edit action is visible in a row's action column | You can open that record for editing. | | The delete action is visible in a row's action column | You can open that record's delete menu. | Each inspection document needs a **Name**. The form displays **Name** as a required text box. The list can show different columns and labels. Use the headers and labels visible in your list. ## Find an inspection document Open the inspection-document list through **Configuration** > **Warehouse settings**. **Prerequisites** - Your account can open the Warehouse inspection-document configuration surface. **Steps** 1. Select **Configuration**. 2. Select **Warehouse settings**. 3. Select **Inspection Document**. 4. Confirm that the page heading is **Inspection document**. 5. Confirm that the list contains the **Name** column. 6. Review the records in the list. 7. Select **New**. 8. Confirm that the new-record surface is titled New Inspection document. **Result:** The list is open, or the New Inspection document surface is open with its **Name** field ready for entry. ## Understand the list and form The form is a focused reference form: it asks for the document's **Name** and does not add inspection-specific data fields to this resource. | Surface | What you see | What it is for | |---|---|---| | List | **Name** | Identifies each record. | | New-record form | **Name** with a required marker | Enters the inspection document name. | | New-record form | **OK** | Submits the new-record surface. | | Action column | Edit and delete actions | Maintains an existing row when your permissions allow it. | The **Name** field is a text box. It appears when the new-record or edit popup is open and is required on the form. The grid's extra action column has no caption. The list does not display **DisplayOrder**, **Id**, or **CompanyId**, so you do not edit these fields in this list. The form does not ask for a select box, date, number, currency, or composite value. It is centered on the required **Name** text box. ![The New Inspection document surface with the required Name field and OK control](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e9e2b7d0f0209e16ce606bac6cc3f9a6.png) ## Add or maintain an inspection document The new-record surface creates a record. A row's action column maintains an existing record, and the list actions work with the list as a whole. ### Open a new inspection document **Prerequisites** - The subscription feature is included. - **New** is visible. - You have the inspection document name ready. **Steps** 1. Select **New**. 2. Confirm that the New Inspection document surface opens. 3. Enter the document name in **Name**. 4. Select **OK**. **Result:** The New Inspection document surface displays the required **Name** field and **OK**. ### Edit an inspection document **Prerequisites** - Edit permission is available. - The row already exists. **Steps** 1. In the row's action column, select the edit action. 2. Edit the value in **Name**. 3. Choose how to finish the edit. | Choice | Action | |---|---| | Save the changed name | Select **Save**. | | Leave the name unchanged | Select **Cancel** in the save popup. | **Result:** The edit popup contains the inspection document's **Name** control. ### Delete an inspection document **Prerequisites** - Delete permission is available. - More than one item is in the data source. **Steps** 1. In the row's action column, select the delete action. | If you want to… | Select | |---|---| | Close the delete menu without deleting the row | **Cancel** | | Request deletion | **Delete** | The delete action is available when more than one item is in the list. The delete menu displays `Are you sure you want to delete this item?`. **Result:** The delete menu is open after selecting the delete action in the row's action column, or closed after selecting **Cancel**. ### Export the inspection-document list **Prerequisites** - Export access is available. - The **Settings** control is visible. **Steps** 1. Select **Settings**. 2. In the export menu, select **Export**. 3. Select an option in the export menu. **Result:** The export options open after selecting **Export**. The edit action opens the selected row in the edit popup. **Save** submits the popup form, and the save popup's **Cancel** closes that popup. ## Handle access and surface variations Subscription coverage, permissions, and the current list layout can change what appears. | Variation | Surface change | |---|---| | The subscription does not include this area | The upgrade surface replaces the list. | | The edit action is absent from a row's action column | That row cannot be opened for editing. | | The delete action is absent from a row's action column | That row cannot be opened for deletion. | | The list shows different headers or labels | Work from the headers and labels visible in your list. | > **Note:** Controls and messages for survey answers, reference-list questions, currencies, banks, > cost items, and product withdrawal strategies belong to other configuration lists. They are not > fields on the inspection-document form. ## When maintenance does not work Use the message on screen to identify whether the problem concerns the field value or a delete condition. | If you see this message | What to do | |---|---| | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters and try the filter again. | | `Data saved Successfully` | Check the list for the new record. | | `Data updated Successfully` | Check the list for the updated record. | | `Are you sure you want to delete this item?` | Confirm the record and deletion action before continuing. | | `Data Deleted Successfully` | Check that the row is no longer in the list. | | `Related to Saved data, Can't be deleted` | Keep the related record in place. | | `Failed to Delete` | Review the deletion condition before trying again. | | `Must have at least one item` | Keep at least one inspection document. | ## Continue with related warehouse configuration Warehouse settings groups inspection documents with sibling reference lists on the same navigation surface. Open a sibling page when you need a different Warehouse configuration resource. - [Warehouse configuration](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-view). - [Base Of Inspection](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-base). - [Inspection Checklist](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-checklist). - [Transfer Reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-transfer-reasons). - [Service Types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-service-types). These lists share the generic configuration surface, while each remains a separate reference-list resource under Warehouse settings. # Transfer reasons ## Transfer reasons A transfer reason is a warehouse configuration record that names why a transfer is made. The list is maintained in the Warehouse configuration flow. | If you need to… | Go to | |---|---| | Check access, saved information, and approval boundaries | [Before you start](#before-you-start) | | Open the list and identify its entry point | [Find the transfer-reason list](#find-the-transfer-reason-list) | | Review fields and the new/edit form | [Understand the list and form](#understand-the-list-and-form) | | Add, change, or remove a reason | [Add, edit, and remove a transfer reason](#add-edit-and-remove-a-transfer-reason) | | Export the list | [Export the list](#export-the-list) | | Resolve a blocked action or message | [When maintenance does not work](#when-maintenance-does-not-work) | | Continue with another Warehouse reference list | [After maintaining transfer reasons](#after-maintaining-transfer-reasons) | Open **Configuration**, then **Warehouse**, then **Transfer Reasons**. ![The Transfer Reasons list in the Warehouse configuration flow](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/a432a9dbb13fac42ef8ab52c62e8fcce.png) ## Before you start Transfer-reason maintenance is available when your subscription includes the configured feature and your account has permission for the action you need. Prerequisites - Confirm that your subscription includes the configured feature. - Have the name for a new or replacement reason ready. - Have permission to create a record before using **New**. - Have edit permission before changing an existing row. - Have delete permission before opening a row's delete menu. - Follow your organisation's approval practice before saving or deleting a reason. The product displays an upgrade surface instead of the grid when the subscription does not include the configured feature. ## Find the transfer-reason list The transfer-reason list is the Warehouse configuration reference list under **Warehouse**. Transfer-reason rows appear under the **Name** column. The list also shows **New**, a refresh button titled **Refresh**, and a settings button titled **Settings**. **Prerequisites** - Your account can open the Warehouse configuration surface. Path: **Configuration** > **Warehouse** > **Transfer Reasons**. Steps 1. Confirm that the list contains the **Name** column. 2. Identify transfer-reason rows by the values shown under **Name**. 3. Select **New** when you need to create a reason. ![The transfer-reason list with Name, New, Refresh, and Settings](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/7588f10d0656fdb7bcab35742892bba7.png) **Result:** The Transfer Reasons list is open, and **New** is available. Continue with [understanding the list and form](#understand-the-list-and-form). ## Understand the list and form The form has one entry field: the required **Name**. Ordering and identifier fields are not entry fields. | Surface | What you see | What it is for | |---|---|---| | List | **Name** | Identifies each transfer-reason row. | | New/edit form | **Name** with a required marker | Enters the transfer-reason name. | | New/edit form | **OK** | Submits the shared popup form. | | End of row | Edit and delete actions | Maintains an existing row when your permissions allow it. | The entity configuration includes **Name**, **DisplayOrder**, **ID**, and **CompanyID**. **Name** is a required text box visible in the list and form. The other fields are hidden from the form. No other transfer-reason fields or transfer-reason-specific select box, date box, number box, or nested collection is declared. The visible column set can come from the saved list configuration, so work from the headers that appear in your list rather than assuming every possible column is visible. ![The new-record popup with the required Name field and OK control](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c9f6793b353b46ed7d35c493b28f2d61.png) The new-record surface is titled `New Transfer Reason`. It shows **Name** with a required marker and **OK**. ## Add, edit, and remove a transfer reason Use **New** for a new row, the action at the end of the row for a change, and the action at the end of the row for removal. **Cancel** closes the delete menu, **Delete** confirms the removal request, **Save** submits the edit popup, and **OK** submits the new-record form. | If… | The available path is… | |---|---| | **New** is available and the subscription feature is included | Select **New**. | | You have permission to change a reason | At the end of the row, select the action for editing. | | You have permission to remove a reason | At the end of the row, select the action for removal to open the delete menu. | | The list has more than one item | Deletion calls the API, removes the item, renumbers **DisplayOrder**, and shows a success alert. | | The list has one item or fewer | Deletion does not call the API and shows `Must have at least one item`. | Choose the procedure that matches the change you need. ### Add a transfer reason Add a transfer reason when a new warehouse movement needs a selectable explanation. Prerequisites - The subscription includes the configured feature. - **New** is available. - You have the reason name ready. - Your organisation's approval practice permits the change. Steps 1. Select **New**. 2. Enter the reason name in **Name**. 3. Select **OK** on the new-record popup. 4. Select **Save** when the shared save action is available. 5. Correct **Name** and resubmit with **OK** or **Save** when a validation message appears. The save path uses `Data saved Successfully` for a new item. **Result:** The new transfer reason is submitted, or the displayed validation message identifies the correction required. Continue with [editing or removing a transfer reason](#edit-a-transfer-reason) or [exporting the list](#export-the-list). ### Edit a transfer reason Edit a transfer reason when an existing row needs a different name. Prerequisites - The row already exists. - Edit permission is available. - Your organisation's approval practice permits the change. Steps 1. At the end of the row, select the action for editing. 2. Change the value in **Name**. 3. Select **Save** in the shared edit popup. 4. Correct **Name** and resubmit with **Save** when a validation message appears. The update path uses `Data updated Successfully` for an existing item. **Result:** The edited name has been submitted through **Save**, or the displayed validation message identifies the correction required. Continue with [deleting a transfer reason](#delete-a-transfer-reason) or [exporting the list](#export-the-list). ### Delete a transfer reason Delete a transfer reason when the row is eligible and your organisation's approval practice permits the change. Prerequisites - Delete permission is available. - The list contains more than one item. - You have confirmed that removing the reason is appropriate. Steps 1. At the end of the row, select the action for removal to open the delete menu. 2. Select the action that matches your decision. | If you want to… | Select | |---|---| | Close the delete menu without deleting the row | **Cancel** | | Approve the removal | **Delete** | 3. Apply the message-specific action in [When maintenance does not work](#when-maintenance-does-not-work) when deletion is blocked. For a list with more than one item, the delete path removes the item, renumbers **DisplayOrder**, and shows `Data Deleted Successfully`. **Result:** The delete menu is closed, or an eligible row has been submitted for deletion. A row with related saved data or the only remaining row stays in the list. Continue with [exporting the list](#export-the-list) or [handling access and list-size variations](#handle-access-and-list-size-variations). ### Export the list Export the transfer-reason list when you need it outside the current grid. **Export** opens the export-options modal. Prerequisites - The transfer-reason list is open. - Export access is available. Steps 1. Select **Export**. **Result:** The export-options modal opens. Continue with [handling access and list-size variations](#handle-access-and-list-size-variations). ## Handle access and list-size variations The same Warehouse route can show different maintenance surfaces because subscription coverage, permissions, saved list settings, and the number of rows affect what appears. | Condition | What changes | |---|---| | The subscription includes the configured feature | The grid and configuration actions are available. | | The subscription excludes the configured feature | The subscription-upgrade surface appears instead of the grid. | | **New** is available | Select **New** to open the new-record popup. | | New permission is available and columns/data are loaded | The separator after **New** is available. | | You have permission to change a reason | The action for editing is available at the end of the row. | | You have permission to remove a reason | The action for removal is available at the end of the row. | | The list has more than one item | The delete path can call the API, remove the item, renumber **DisplayOrder**, and show success. | | The list has one item or fewer | The delete path is blocked with `Must have at least one item`. | | Saved list settings supply dynamic columns | The visible columns and labels follow those settings. | Use the rows and headers currently displayed in your account, then continue with [When maintenance does not work](#when-maintenance-does-not-work) if an action is blocked. ## When maintenance does not work Use the exact message on screen to choose the corrective action, then return to the relevant maintenance procedure. | Message | What it means | What to do | |---|---|---| | `Name is required` | The required **Name** value is empty. | Enter a name in **Name**, then select **OK** or **Save**. | | `Just '_' '-' And '.' Characters Accepted` | The name fails the pattern rule. | Remove the forbidden characters, then select **OK** or **Save**. | | `Forbidden characters detected. Please remove them and try again.` | The submitted value contains forbidden characters. | Remove the forbidden characters, then select **OK** or **Save**. | | `Related to Saved data, Can't be deleted` | Related saved data prevents deletion. | Keep the transfer reason and review the related saved data. | | `Failed to Delete` | The delete operation failed. | Stop and review the failure before repeating the request. | | `Must have at least one item` | The list has one item or fewer. | Keep at least one transfer reason. | | `Data saved Successfully` | The new-item save path completed. | Check the list for the new row. | | `Data updated Successfully` | The existing-item update path completed. | Check the row's **Name** value. | | `Data Deleted Successfully` | The delete path completed. | Check that the row is no longer in the list. | ## After maintaining transfer reasons Transfer reasons are one Warehouse configuration reference list. Open the sibling list that matches the reference data you need; do not treat a sibling list as part of the transfer-reason rows. - [Warehouses](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-view) - [Inspection documents](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-inspection-documents) - Base of inspection. - Inspection checklist - Stock Withdrawal and Valuation. - Service Types # Service types Maintain the service-type names available in Warehouse settings, then return to the Warehouse configuration area or continue to Warehouse work that uses these names. ## Before you start Service types are Warehouse reference entries named through the **Name** field. Open **Configuration** > **Warehouse settings** > **Service Types** to reach the maintenance page. Access to the list depends on your subscription. When the subscription includes the feature, the service-type list and its controls are available; otherwise the shared upgrade surface appears. Before you begin, have the service-type name ready and confirm that your account can maintain Warehouse settings. | If you need to… | Go to | | --- | --- | | Review the wider Warehouse configuration context | [Warehouse configuration overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-view) | | Find the current service-type rows | [Find and review service types](#find-and-review-service-types) | | Add or change a name | [Add or edit a service type](#add-or-edit-a-service-type) | | Remove a row | [Remove a service type](#remove-a-service-type) | | Continue with Warehouse operations | [Warehouse fulfillment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow) | ## Find and review service types The Service types page lists the names your organisation uses to classify external services. **Prerequisites** - Your subscription includes the feature. - You can access Warehouse settings. **Steps** 1. Open **Configuration** > **Warehouse settings** > **Service Types**. 2. Check that the page heading is `External Service types`. 3. Read the `Name` heading to review the current rows. ![Identify the External Service types list and its Name heading.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6ed775644561845cf5357da333d28adf.png) **Result:** The `External Service types` list is open with the `Name` heading and the current rows beneath it. ## Understand the service types screen Service types use the shared configuration screen. The screen is classified as a form even though the initial view is the list. The visible list contains one `Name` heading. Use the headings available in your list when reviewing rows. The list tools include **Refresh** and **Settings**. No labelled form control or required marker appears on the list itself. Open the form before looking for the required **Name** field, **Save**, or **Cancel**. ![Recognise the Warehouse settings context, list tools, Name heading, and current service-type row.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5b8803ef98b95bef37713a6fbfd5cfdc.png) ### Fields and list behaviour `Name` is the service type's text value. It appears in the form and list, can be used for filtering, and is not editable directly in the list. | Field or surface | Service types behaviour | | --- | --- | | **Name** | Required text value; shown in the form and list; available for filtering; not editable directly in the list | | DisplayOrder | Not shown in the form or list for this subject configuration | | ID | Not shown in the form or list for this subject configuration | | CompanyID | Not shown in the form or list for this subject configuration | | Additional subject fields | No additional fields are declared for Service types | Use the list to inspect and filter names. Use the form to change a name; the list does not provide editing. ## Add or edit a service type Use the same form to add a service type or change a selected existing row. **Prerequisites** - The Service types list is open. - To add a row, the **New** control is visible. - To edit a row, a row is available and editing is allowed. **Steps** | If you want to… | Select… | | --- | --- | | Add a row | **New** | | Edit a row | The row's edit control | 1. Select the control for the action you want. 2. In the form, enter the service-type name in **Name**. 3. Select **Save** to submit the form after validation. 4. If you do not want to save the entry, select **Cancel**. 5. For a new item, check for `Data saved Successfully`. 6. For an edited item, check for `Data updated Successfully`. **Result:** A successful add or edit displays its corresponding message. **Cancel** closes the popup without saving. ## Remove a service type Deleting removes a service-type row from the reference list. Use it only when deletion is allowed for the row and the name is no longer needed. **Prerequisites** - The Service types list is open. - The target row is available. - Deletion is allowed for that row. **Steps** 1. Open the target row's delete menu. 2. Select **Delete**. 3. Read the confirmation prompt: `Are you sure you want to delete this item?` 4. Confirm the deletion in the prompt. 5. Check for `Data Deleted Successfully`. If the row is related to saved data, the deletion is blocked and the message `Related to Saved data, Can't be deleted` appears. If the deletion operation fails, the message `Failed to Delete` appears. If the row is the last item, the list keeps the required minimum and displays `Must have at least one item`. **Result:** When deletion succeeds, the selected row is removed. A restriction or failure leaves the list unchanged and displays the corresponding message. ## Validate entries and use list tools The service-type form validates **Name** before **Save** submits it. The list also provides shared tools and headings for reviewing rows. **Prerequisites** - The Service types list is open. - Open the form before validating a **Name** value. **Steps** 1. Leave **Name** empty to trigger the required rule. 2. Enter a name using the accepted characters. 3. Use the visible list headings when reviewing or filtering rows. 4. Check whether **Export** is visible in the list tools. **Result:** The form accepts a value only after the required and pattern rules pass. The list uses the headers currently shown, and **Export** is available when it is visible. ### Correct a name or filter Use this recovery path when a service-type name fails validation or a list filter contains a forbidden character. **Prerequisites** - The form is open for a name correction, or the list filter is active. **Steps** | If… | Then… | | --- | --- | | **Name** is empty | Enter a service-type name in **Name**. The form displays `Name is required`. | | **Name** contains characters outside the accepted pattern | Replace it with a value using the accepted characters. The form displays `Just '_' '-' And '.' Characters Accepted`. | | The filter reports forbidden characters | Remove those characters from the filter value. The list displays `Forbidden characters detected. Please remove them and try again.` | 1. Apply the correction in the table row that matches the message. 2. Reapply the filter or continue with the form after the message clears. **Result:** The corrected **Name** is ready for validation, or the list filter is ready to run without the forbidden-character message. ### Export the list **Prerequisites** - The Service types list is open. - **Export** is visible in the list tools. **Steps** 1. Select **Export**. **Result:** Export options open for the Service types list. ### Understand access and configuration variations The controls and fields on this shared screen change with subscription, row state, permissions, and the active list configuration. | Condition | What changes | | --- | --- | | The subscription includes the feature | The list and its controls are available; otherwise the shared upgrade surface appears | | **New** is not hidden | The add control appears | | A row is available and editing is allowed | The row's edit control appears | | Deletion is allowed | The row's delete control and delete prompt appear | | The edit form is open and a selected item exists | The configured visible form fields appear | | The list configuration changes | The available headings depend on that list configuration | Use the controls and headers visible on your Service types page when the arrangement differs. ## Continue after maintenance After maintenance, the Service types list gives you the saved row or the deletion result. The visible Warehouse navigation also includes **Inventories**, **Base of inspection**, **Inspection checklist**, **Inspection Document**, **Transfer Reasons**, and **Stock Withdrawal And Valuation**. For the broader Warehouse configuration context, open the [Warehouse configuration overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-warehouse-view). For operational use of Warehouse reference data, continue to [Warehouse fulfillment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/warehouse-fulfillment-flow). # Project management statuses ## Project management statuses Project management statuses are configurable reference values that you maintain in the PM status list. | If you need to… | Go to | | --- | --- | | Open the status list | [Find the status list](#find-the-status-list) | | Check the columns, count, and form field | [Understand the status screen](#understand-the-status-screen) | | Add a new status | [Add a status](#add-a-status) | | Change an existing status | [Edit a status](#edit-a-status) | | Leave a form without saving | [Leave a form without saving](#leave-a-form-without-saving) | | Remove a status | [Delete a status](#delete-a-status) | | Open another reference list | [Handle access and navigation branches](#handle-access-and-navigation-branches) | ## Before you start The PM status list and its maintenance actions are available when the subscription includes the feature. Your access also determines whether the edit control at the end of the status row and the delete control at the end of the status row are available. | Before you start | What it controls | | --- | --- | | The subscription includes the feature | The grid and its top actions are available. | | The feature is not included | The screen shows the subscription-upgrade component instead of the grid and top actions. | | Editing is allowed | The edit control at the end of the status row is available. | | Deletion is allowed | The delete control at the end of the status row and delete menu are available. | ## Find the status list The PM status list is the reference list for the values used by project management. Open it from the PM settings area under Configuration, then confirm the page heading before maintaining a row. 1. Open **Configuration**. 2. Open **PM settings**. 3. Select **PM statuses**. 4. Confirm that the page heading reads **PM statuses**. The list remains open while you work with it. ![The PM statuses heading, navigation, list, count, and list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/a26e21946b056c2fda502cdf99a22ef4.png) **Result:** The PM status list is open under **Configuration**, with **PM statuses** as the page heading. ## Understand the status screen The status screen is a single-column reference list with one editable value: **Type**. The list contains nine rows and shows `Count: 9`. | Screen area | What you see | | --- | --- | | Column shown | **Type** | | Row count | `Count: 9` | | List controls | **New**, **Refresh**, and **Settings** | | Form field | **Type**, a required text box | | Form submit control | **OK** | The PM route has no visible tab set, so work starts from this list rather than from a PM status tab. When you open a new or existing row, the form provides the **Type** text box and the **OK** button. ![The new PM statuses form with the required Type field and OK button](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/42d27c6674ee702ca44ff4479dcc78ea.png) ## Maintain statuses Start a new value from the top of the list, change an existing value from its row, and export the list from the toolbar. The edit control at the end of the status row and the delete control at the end of the status row depend on the corresponding access conditions in [Before you start](#before-you-start). | Need | Control or location | | --- | --- | | Start a new status | **New** at the top of the list | | Export the list | **Export** in the toolbar | | Change a status | The edit control at the end of the status row for the status you want to change | | Remove a status | The delete control at the end of the status row for the status you want to remove | | Keep a row | **Cancel** in the delete menu | | Confirm removal | **Delete** in the delete menu | | Leave the new/edit form | The close control in the popup’s upper-right corner | The form opens as a popup. Its close control leaves the form without using **OK**. ### Add a status Add one value to the PM status reference list. Prerequisites - The subscription includes the PM feature. - You can access the PM status list. Steps 1. Select **New**. 2. Confirm that the popup title reads `New PM statuses`. 3. In **Type**, enter the new status value. 4. Select **OK**. 5. Confirm the message `Data saved Successfully`. ![The New PM statuses popup before submitting a new Type value](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/42d27c6674ee702ca44ff4479dcc78ea.png) **Result:** The new PM status is submitted and the save result is shown as `Data saved Successfully`. ### Edit a status Change the **Type** value of an existing PM status. Prerequisites - The subscription includes the PM feature. - Editing is allowed for your access. - You can identify the row to change in the **Type** column. Steps 1. Select the edit control at the end of the status row for the status you want to change. 2. In the edit popup, replace the value in **Type**. 3. Select **OK**. 4. Confirm the message `Data updated Successfully`. **Result:** The changed status is submitted and the update result is shown as `Data updated Successfully`. ### Leave a form without saving Close a new or edit popup without submitting its value. Prerequisites - A new or edit popup is open. Steps 1. Select the close control in the popup’s upper-right corner. **Result:** The popup closes without using **OK**, and the list remains open. ### Delete a status Remove a PM status when deletion is allowed. Deleting a value can be blocked when related saved data uses it or when only one item would remain. Prerequisites - The subscription includes the PM feature. - Deletion is allowed for your access. - You have identified the row to remove in the **Type** column. Steps 1. Select the delete control at the end of the status row for the status you identified. 2. In the delete menu, select **Delete**. 3. Read the confirmation `Are you sure you want to delete this item?`. 4. Select **Delete** to confirm the removal. | Message | What to do | | --- | --- | | `Data Deleted Successfully` | The status was deleted. | | `Related to Saved data, Can't be deleted` | Keep the status because related saved data prevents deletion. | | `Failed to Delete` | The deletion failed; retain the status and contact your administrator. | | `Must have at least one item` | Keep the remaining status; the list requires at least one item. | To leave the delete menu without confirming, select **Cancel**. **Result:** The deletion is either confirmed with `Data Deleted Successfully`, cancelled with **Cancel**, or stopped with one of the listed messages. ## Handle access and navigation branches Choose a sibling list by its visible destination name rather than treating that branch as a PM status field. | What changes | What you see or do | | --- | --- | | The subscription does not include the PM feature | The subscription-upgrade component replaces the grid and top actions. | | The route sets `hideNewButton` to true | **New** is hidden. | | Editing is allowed | The edit control at the end of the status row is available. | | Deletion is allowed | The delete control at the end of the status row and delete menu are available. | | You need a different reference list | Use the shared navigation to open **Product Categories** or **Product serial combination**. | The PM route does not set `hideNewButton`, and it has no declared visible tab set. ## When maintenance goes wrong Use the exact message on screen to choose the correction. | What you see | What it means | What to do | | --- | --- | --- | | `Type is required` | **Type** needs a value. | Enter a value in **Type** before selecting **OK**. | | `Just '_' '-' And '.' Characters Accepted` | The **Type** value contains a character outside the accepted pattern. | Correct **Type** to use the accepted characters, then select **OK**. | | `Forbidden characters detected. Please remove them and try again.` | The list filter contains forbidden characters. | Remove the forbidden characters from the filter and try again. | | `Related to Saved data, Can't be deleted` | Related saved data prevents deletion. | Keep the status and leave the delete menu with **Cancel**. | | `Must have at least one item` | The list cannot be left without an item. | Keep at least one status. | | `Failed to Delete` | The deletion failed. | Leave the status in place and contact your administrator. | ![The PM status form with Type and OK visible during validation](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d20dd854c062c9d15fef8a05e7817a29.png) ## Confirm the result and continue After a maintenance action, use the message and the list page to confirm where you are. The shared screen exposes sibling reference-list navigation for the next configuration task. | Path | Confirm | | --- | --- | | Add | `Data saved Successfully` | | Edit | `Data updated Successfully` | | Delete | `Data Deleted Successfully` | | Leave without saving | The popup closes and the list remains open. | | Continue to another reference list | Use the shared navigation to open **Product Categories** or **Product serial combination**. | For the related configuration areas, continue with [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home), [Reference categories](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reference-list-reference-category-view), or [Serial combinations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-serial-combinations-view). # Configuration dashboard Choose a settings area here, then continue on the matching settings page for that task. | If you need to… | Go to | |---|---| | Open the settings-area entry screen | [Open the configuration dashboard](#open-the-configuration-dashboard) | | Identify the five settings areas | [Read the dashboard](#read-the-dashboard) | | Choose an area and see its selected content | [Select a settings area](#select-a-settings-area) | | Work with account settings entries | [Default layouts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-default-layouts) or [User layouts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-users-layouts-view) | | Work with company currency settings | [Frequent currencies](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-company-currencies) | | Work with branch settings | [Branches](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-view) | | Manage demo data | [Manage demo data](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-demo-data) | | Configure two-factor authentication | [Two-factor authentication](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-2factor-authentications) | ## Configuration dashboard The Configuration dashboard is the entry point for the five settings areas. After you select an area, continue on that area's settings page for the configuration task. ## Before you start No fields, configuration records, save controls, delete controls, confirmation controls, validation controls, or messages appear on this dashboard. You do not enter or save a configuration record on the dashboard. After you choose an area, use the linked settings page to continue that configuration task. ## Open the configuration dashboard Open the Configuration dashboard when you need to choose where to continue configuration work. **Prerequisites** - You are in the configuration area. **Steps** 1. Open the Configuration dashboard from the configuration area. 2. Confirm that the dashboard shows **Account settings**. 3. Confirm that the dashboard shows **Company settings**. 4. Confirm that the dashboard shows **Branches settings**. 5. Confirm that the dashboard shows **Data management**. 6. Confirm that the dashboard shows **Security**. **Result:** The Configuration dashboard is open with the five settings-area choices available. ## Read the dashboard The five settings areas are choices for different parts of configuration work. Select the label that matches the records you need to maintain. The selected content stays on the Configuration dashboard. Only the content for the selected area appears. Select the area that matches your task. Each selection remains on the Configuration dashboard. ## Select a settings area Select a settings area when you know which part of configuration you need to inspect. Each choice updates the content represented on the same dashboard route. **Prerequisites** - The Configuration dashboard is open. **Steps** 1. Select the area that matches your task. | If you need to… | Select | Then continue to… | |---|---|---| | Work with account settings | **Account settings** | [Default layouts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-default-layouts) or [User layouts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-users-layouts-view) | | Work with company settings | **Company settings** | [Frequent currencies](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-company-currencies) | | Work with branch settings | **Branches settings** | [Branches](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-view) | | Manage data | **Data management** | [Manage demo data](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-demo-data) | | Configure security | **Security** | [Two-factor authentication](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-2factor-authentications) | ![The dashboard after selecting Account settings](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/69d5f10fd9abb5a609153e3117d8a048.png) ![The dashboard after selecting Company settings](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/37ae83b64538efebfedabffd29bb8305.png) ![The dashboard after selecting Branches settings](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/edb439a9e570fcd916b37b4f104ee626.png) ![The dashboard after selecting Data management](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/91c0b6b765df25cfdd22b8f2842b1b72.png) ![The dashboard after selecting Security](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/db98d7b137e0864a26e117388af52899.png) **Result:** The selected settings-area content appears on the Configuration dashboard, and the dashboard route remains open. Continue on the matching settings page for the selected area. ## Understand the dashboard's limits The Configuration dashboard only chooses a settings area. It does not provide fields, records, or record actions for the configuration work itself. | Configuration task | Continue to | |---|---| | Maintain default layouts | [Default layouts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-default-layouts) | | Maintain user layouts | [User layouts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-users-layouts-view) | | Maintain frequent currencies | [Frequent currencies](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-company-currencies) | | Review branches | [Branches](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-view) | | Manage demo data | [Manage demo data](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-demo-data) | | Configure two-factor authentication | [Two-factor authentication](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-2factor-authentications) | After selecting an area, open its matching settings page. # Default layouts ## Default layouts A default layout is the layout string assigned to one list number. Administrators select a list, retrieve or edit its layout, and save the value. | If you need to… | Go to | |---|---| | Open the form or its related user-specific layout page | [Open Default layouts](#open-default-layouts) | | Identify the required fields and list choices | [Fields](#fields) | | Retrieve, format, reset, or save a layout | [Actions](#actions) | | Maintain one list's default layout | [Maintain a default layout](#maintain-a-default-layout) | | Maintain user-specific layouts | [Users layouts](#know-whats-next) | ## Before you start You need the list number and layout value you want to maintain. **List num** and **Layout** are required, and the form validates both before save processing. | Have or know | Why it matters | |---|---| | The list number | **Get layout** uses the selected **List num** value. | | The layout string | **Layout** must contain a value before a valid save can proceed. | | The required save behaviour | **Save** saves and remains on the form; **Save and Close** saves and leaves the form. | ## Open Default layouts Default layouts is the configuration form for maintaining a list's default layout. User-specific layouts are maintained on the related Users layouts page. Prerequisites - You have access to the configuration area. Steps 1. In the configuration area, select **Default layouts**. 2. Select **Users layouts** when you need the related user-layouts page. **Result:** The selected page is open. ![The Default layouts form with its two fields and action controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2c6a60c7558a40d445cfafa737314416.png) ## Understand the screen The form contains two required fields: **List num** and **Layout**. Both fields belong to the form's validation group. | Field | Type | Required | Use | |---|---|---:|---| | **List num** | Select box | Yes | Choose the list whose default layout you maintain. | | **Layout** | Text area | Yes | Enter or edit the layout string. | **Layout** is editable. Its text area has a fixed height of 350, does not resize automatically, and selects its text when it receives focus. The screen has no grid, configurable field, tab group, or embedded feature surface. ### Fields Each **List num** option shows a display name and numeric ID. The options run from `Activities (0)` to `Outgoing Paymnet (126)`; examples include `Registeration data (3)` and `Job Profitabilty (123)`. ![The expanded List num options, from Activities (0) through Outgoing Paymnet (126)](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/4c5b2e8c6114f8ac65255bda006a8243.png) ### Actions | Control | Use | |---|---| | **Users layouts** | Open the related user-layouts page. | | **Stringfy** | Remove line breaks and whitespace outside quoted strings from **Layout**. | | **Reset** | Replace the current layout with a new default layout. | | **Get layout** | Retrieve the default layout for the selected list number. | | **Save** | Save and remain on the form. | | **Save and Close** | Save and leave the form. | **Get layout** is disabled when **List num** has no value. Both **Stringfy** and **Reset** leave the page on Default layouts without opening a dialog or showing a toast. ![The formatting, reset, retrieval, and save actions around the form](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/b20f26ed86d4896a6a8371dd9b523f32.png) ## Maintain a default layout Retrieve or edit the default layout for one list number. Prerequisites - You know which list number to maintain. - You have the layout string to enter or the saved configuration to edit. Steps 1. In **List num**, select the list number. 2. Select **Get layout**. 3. In **Layout**, edit the layout value. 4. Select the action that matches your need: | If you need to… | Select | |---|---| | Remove line breaks and whitespace outside quoted strings | **Stringfy** | | Replace the current layout | **Reset** | | Save and remain on the form | **Save** | | Save and leave the form | **Save and Close** | **Result:** The selected list's layout is retrieved or edited, and the chosen action is applied. ![The form after Get layout loads the selected list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/431e8358c6636506e23cc3f6c1fecd4a.png) ## Handle validation and request outcomes The form checks both required fields before save processing. If a required value is missing, the field can show `This Field Is Required`. A successful request uses `Your request was completed successfully`; an error uses `An error occurred while processing your request`. ## Know what’s next Select **Users layouts** to maintain layouts associated with users rather than with a selected list number. ![The Users layouts destination reached from Default layouts](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/7a877152c98ade8edc68ccee027c95b4.png) # User layouts Use User layouts to find a user's list arrangement, review its settings, and open the corresponding layout record for maintenance. ## User layouts at a glance A user layout is the saved arrangement used for a user's list: it identifies the list, stores the layout text, and carries the column settings. Administrators use this list when they need to locate a user's arrangement and open its record for the administrator's branch. | If you need to | Go to | | --- | --- | | Find a user's list arrangement | Find the User layouts list | | Check fields, required rules, and available choices | Understand the list and its fields | | Open and maintain a layout record | Choose and maintain a layout or the sibling User layout editor page | | Return to the related configuration area | **Default layouts** in Find the User layouts list | | Resolve a missing surface or message | Handle unavailable actions and messages | The list presents user layouts and a user-name field. The editor stores the selected list number, layout text, and column settings. ![The User layouts heading, related Default layouts link, and list area](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2066e6e832ecba0345df5d350d1b63cf.png) ## Before you start **Prerequisites** - Have access to the Configuration area. - Have the list layout you want to review selected. - Have the user's name or other information you need to identify the row. The list filters and list area appear only after a chosen layout exists. A chosen layout is therefore needed before the list controls and table are available. Column actions in the editor require a layout that has columns. If the page shows `Data Loading Error`, the list does not provide usable rows or visible columns. Continue only when the list has loaded enough information to identify a row, or use the message in Handle unavailable actions and messages to diagnose the page. > **Note:** A layout with no columns has no column edit or delete actions, and its column > popup fields are not available until you open a column popup. ## Find the User layouts list Use the User layouts list to locate a user's arrangement before opening the record editor. **Prerequisites** - Have access to the Configuration area. **Steps** 1. Open **Default layouts** in Configuration. 2. Select **Users layouts**. 3. Confirm that the page heading is **Users layouts**. **Result:** The **Users layouts** list is open. ![The Users layouts page with the Default layouts destination](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/eae413af4c5603f55e95de7746e0a124.png) ## Understand the list and its fields The list identifies a user layout by list choice and user name; the editor then exposes the saved layout and its column settings. Use the field tables below to distinguish the list filters from the editor fields. ### List filters and table | Surface | What to expect | | --- | --- | | Status list | An unlabelled list for the list's status value. | | User-name field | An unlabelled text box for the user name. | | List table | Its visible headers come from the chosen list layout. | | Row control | Select it to open the record when the row is from the same branch. | The list also provides paging, header filtering, row filtering, grouping, and export surfaces. The current page can show an icon-only **Refresh** button. If the list shows `Data Loading Error`, it has no usable rows or visible list columns to inspect. ![The list area where the chosen layout supplies the visible columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2066e6e832ecba0345df5d350d1b63cf.png) ### Editor fields | Field | Type | Required | Availability | | --- | --- | --- | --- | | **Name** | Text | Yes | Always in the editor; read-only. | | **List num** | Select | Yes | Always in the editor; read-only. | | **Layout** | Text area | Yes | Always in the editor. | When you edit or add a column, the popup provides these fields: | Field | Type | Required | Rule | | --- | --- | --- | --- | | **Index** | Text | Yes | Read-only in the popup. | | **Visible** | Boolean | No | Available in the column popup. | | **Field** | Text | Yes | Available in the column popup. | | **Type** | Select | Yes | Available in the column popup. | | **Caption** | Text | No | Available in the column popup. | | **Width** | Number | No | Minimum value is `0`. | | **Filter value** | Text | No | Available in the column popup. | | **Selected filter operation** | Select | Yes | Available in the column popup. | Column popup fields appear only while the column-edit or add-column popup is open. ### Available options The **List num** list provides the following values: | Value | ID | | --- | ---: | | Activities (0) | 0 | | Tasks (1) | 1 | | Contract (2) | 2 | | Registeration data (3) | 3 | | Ticket - Running (4) | 4 | | Ticket - Closed (5) | 5 | | Layouts (6) | 6 | | Pricing indicator (7) | 7 | | Project (21) | 21 | | Clients (22) | 22 | | Principals (23) | 23 | | Roles (26) | 26 | | Users (27) | 27 | | Account (29) | 29 | | Contact (30) | 30 | | Invoices all (31) | 31 | | Payment (32) | 32 | | Sales Leads(39) | 39 | | Sales All(40) | 40 | | Sales Inquiries (41) | 41 | | Sales Offers (42) | 42 | | Sales Orders (43) | 43 | | Sales Delivered (44) | 44 | | Sales Lost offer (45) | 45 | | Sales Regretted (46) | 46 | | Sales Deleted (48) | 48 | | Sales Rejected orders (49) | 49 | | Sales Missed Inquiries (50) | 50 | | Sales Cancelled offer (51) | 51 | | Sales Cancelled order (52) | 52 | | Buyout All (53) | 53 | | Buyout RFQ (54) | 54 | | Buyout Offer (55) | 55 | | Buyout Order (56) | 56 | | Buyout Delivered (57) | 57 | | Buyout Rejected offer (58) | 58 | | Buyout Regretted (59) | 59 | | Buyout Deleted (61) | 61 | | Buyout Rejected order(62) | 62 | | Buyout Cancelled offers (64) | 64 | | Buyout Cancelled order (65) | 65 | | Principal invoice (67) | 67 | | teams (70) | 70 | | Account managers (71) | 71 | | Subscription Invoices (72) | 72 | | Letter of guarantees all (73) | 73 | | Products (74) | 74 | | MRQ (75) | 75 | | Procurement All (76) | 76 | | Procurement RFQ (77) | 77 | | Procurement Offer (78) | 78 | | Procurement Order (79) | 79 | | Procurement Delivered (80) | 80 | | Procurement Rejected (81) | 81 | | Procurement Regretted (82) | 82 | | Procurement Deleted (83) | 83 | | Procurement Rejected order (84) | 84 | | Procurement Cancelled offers (85) | 85 | | Procurement Cancelled orders (86) | 86 | | Extension rejected offer (89) | 89 | | Warehouse configuration (91) | 91 | | Receiving shipment (92) | 92 | | Inspection (93) | 93 | | PM All (94) | 94 | | PM Planned To Order (BOM) (95) | 95 | | PM Ready To Order (MRQ) (96) | 96 | | PM In Procurement All (97) | 97 | | PM In Procurement Inquiry (98) | 98 | | PM In Procurement Offer (99) | 99 | | PM In Procurement Order (100) | 100 | | PM In Procurement Stuck (101) | 101 | | PM Products Receipt (102) | 102 | | PM Product Rejected (103) | 103 | | PM Stored (104) | 104 | | PM Assembly (105) | 105 | | PM Loss (106) | 106 | | PM Ready For Shipment (107) | 107 | | PM Delivered (108) | 108 | | Stock (109) | 109 | | Packages (110) | 110 | | upcoming stock (111) | 111 | | Production order (112) | 112 | | Shipping order (113) | 113 | | Issue goods note (114) | 114 | | External service order (115) | 115 | | Transfer order (116) | 116 | | Return note (117) | 117 | | Delivery note (118) | 118 | | PM orders (119) | 119 | | In-warehouse all (120) | 120 | | PM Delivered orders (121) | 121 | | Reference list by serial num. (122) | 122 | | Job Profitabilty (123) | 123 | | Job Cost Transaction (124) | 124 | | Purchase Invoice (125) | 125 | | Outgoing Paymnet (126) | 126 | The **Type** list provides `string`, `number`, `date`, and `boolean`. The **Selected filter operation** list provides these choices: | Option | | --- | | `contains` | | `Does not contain` | | `Starts with` | | `Ends with` | | `Equals` | | `Not equals` | ## Choose and maintain a layout Use this procedure to move from a loaded list row to the layout record, review the text, and maintain its columns. The available editor actions change what is stored in the layout text and the parsed column settings. **Prerequisites** - Have a loaded User layouts list. - Have a row from the administrator's branch. - Have a layout with columns before using column edit or delete actions. **Steps** 1. In a row from the administrator's branch, select the row control to open the layout record. 2. Select the editor action that matches your maintenance task. | If you need to | Select | Result | | --- | --- | --- | | Reload the record | **Recall** | The layout record is reloaded. | | Convert the layout text into the parsed layout | **Parse** | The parsed user layout is updated from the layout text. | | Copy parsed columns into the layout text | **Stringfy** | The layout text receives the parsed columns. | | Remove duplicate or non-default columns | **Clean user layout** | Duplicate or non-default columns are removed. | | Add missing default columns and align their type, caption, width, and index | **Update user layout** | Missing default columns are added and their settings are aligned. | 3. For a column, select the action that matches your task. | If you need to | Select | Result | | --- | --- | --- | | Review or change column details | The column edit control | The column details dialog opens. | | Remove a column | The column delete control | The **Delete column** confirmation dialog opens. | 4. Select **Save** to keep the editor open after saving, or select **Save and Close** to save and leave the editor. **Result:** **Save** keeps the layout record open. **Save and Close** saves the layout and leaves the editor. ![The row edit entry point for a user layout](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2066e6e832ecba0345df5d350d1b63cf.png) ### If you selected **Save New Layout** The available editor actions are **Save** and **Save and Close**. Use those named actions for the layout record; no instruction for a control named **Save New Layout** is provided on this page. **Prerequisites** - Have the layout record open. **Steps** 1. Select **Save** or **Save and Close** according to whether you want to remain in the editor. **Result:** The selected named save action is submitted. No approval step is specified for saving. ### If you selected **Delete Current** The column delete path begins with the delete icon when the layout has columns. It opens a confirmation popup with the message `Are you sure?`. **Prerequisites** - Have the layout record open. - Have a layout with at least one column. **Steps** 1. Select the delete icon for the column you want to remove. 2. Read the confirmation message `Are you sure?`. 3. Select **No** to cancel the deletion. 4. Select **Yes** to remove the column. **Result:** The **Delete column** confirmation popup remains open until you choose **No** or **Yes**. Select **No** to cancel the deletion. Select **Yes** to remove the column; the popup closes and the parsed user layout is updated. ### Delete a column The column delete path begins with the column delete control when the layout has columns. It opens a confirmation dialog titled **Delete column** with the exact message `Are you sure?`. **Prerequisites** - Have the layout record open. - Have a layout with at least one column. **Steps** 1. Select the column delete control for the column you want to remove. 2. Read the confirmation message `Are you sure?`. 3. Select **No** to keep the column. 4. Select **Yes** to remove the column. **Result:** **No** closes the confirmation dialog without changing the column. **Yes** removes the column from the parsed user layout and closes the confirmation dialog. ## Adjust the display and export the list The User layouts list provides display features separate from layout-record editing: paging, header filtering, row filtering, grouping, and export. The list can also show an icon-only **Refresh** button. **Prerequisites** - Have a loaded User layouts list. **Steps** 1. Use the available list surface that matches your task. | If you need to | Use | | --- | --- | | Move between pages | Paging | | Narrow values in a column | Header filtering | | Narrow rows | Row filtering | | Arrange rows by a value | Grouping | 2. Select **Export** to start the list export flow. **Result:** The selected list display surface is active, or the export dialog opens with **Export** and **Cancel**. ### If you selected **Filter Row** Row filtering is a list surface. The filter controls appear only when a chosen layout exists. **Prerequisites** - Have a chosen layout and a loaded list. **Steps** 1. Look for the **Filter by:** control on the list. 2. If **Filter by:** appears, use it to narrow the list rows. **Result:** The filter-row surface is available when a chosen list layout exists. If **Filter by:** does not appear, no row-filter action is available. ### If you selected **Group Panel** Grouping is a list surface for a loaded list. **Prerequisites** - Have a loaded list with rows and columns. **Steps** 1. Open the grouping surface on the list. 2. Choose the grouping arrangement from the available list surface. **Result:** The grouping surface is available for a loaded list. A list that shows `Data Loading Error` has no loaded rows or columns with which to demonstrate grouping. ### If you selected **Export** to start an export Use **Export** on the list to start the export flow. **Prerequisites** - Have a loaded User layouts list. **Steps** 1. Select **Export** on the list. **Result:** The export choices are requested. The export dialog has the actions **Export** and **Cancel**. ### If you selected **Export** to close the choices The export dialog displays **Exporting List:**, offers **Export to Excel** and **Export to PDF**, and provides **Cancel** and **Export**. **Prerequisites** - Have the export dialog open. **Steps** 1. Select **Cancel** to use the dialog's cancel choice. 2. Select **Export** to use the dialog's export choice. **Result:** Select **Cancel** to close the export dialog without exporting. Select **Export** to export the list in the selected format. If the list has no data, the page displays `NO Data to Export` instead. ## Handle unavailable actions and messages List features depend on the current layout and which popup is open. Use the condition table to match an unavailable action to the state that controls it. | If you see | Condition | What to do | | --- | --- | --- | | No list filters or list area | No chosen list layout exists. | Select a layout before expecting list controls or a list table. | | No column edit or delete controls | The layout has no columns. | Open or prepare a layout that has columns. | | No column popup fields | The column-edit or add-column popup is not open. | Open the appropriate column popup. | | `Data Loading Error` | The list failed to load usable rows or columns. | Wait for a usable list before filtering, grouping, or exporting. | | `This Field Is Required` | A required field is empty. | Complete the required field and submit the editor action again. | | `Your request was completed successfully` | The editor reports a successful request. | Continue with the next editor action or close the record. | | `An error occurred while processing your request` | A save or load request reports an error. | Review the record and request again when the page is available. | The list's accounts lookup can show `Error loading accounts`. While `Data Loading Error` is present, the list has no usable rows or visible list columns. ### Messages | Message | When it appears | | --- | --- | | `This Field Is Required` | A required editor field is empty. | | `Your request was completed successfully` | The editor reports a successful request. | | `An error occurred while processing your request` | A save or load request reports an error. | | `Are you sure?` | The **Delete column** confirmation dialog opens. | | `Error loading accounts` | The accounts lookup in the list filter reports an error. | | `Data Loading Error` | The list fails to load usable data. | ## What to do next After reviewing the list, select the row control to open the user-layout record for maintenance. Select **Default layouts** to return to the related configuration area. # Edit user layout ## What a user layout is A user layout is the saved definition of the columns used by a product list. Use **Layout** to maintain that definition and its columns. Filtering and exporting belong on the [User layouts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-users-layouts-view) page. | If you need to… | Go to | | --- | --- | | Open an existing layout | [User layouts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-users-layouts-view) | | Review the saved fields and status flags | [Record and layout fields](#record-and-layout-fields) | | Compare the user layout with the default layout | [Parsed layout areas](#parsed-layout-areas) | | Parse or reconcile the saved layout text | [Maintain the layout text and compare defaults](#maintain-the-layout-text-and-compare-defaults) | | Add, edit, or remove a layout column | [Maintain layout columns](#maintain-layout-columns) | | Maintain default layouts | [Default layouts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-default-layouts) | ## Before you start Open an existing user-layout record before maintenance begins. You need a live account and an existing record. ## Find and open the layout The **Users layouts** page is the list entry point for opening a saved user-layout record. The list page text includes **Configuration**, **Default layouts**, **Users layouts**, and **Tickets**. **Prerequisites** - You are signed in with access to the **Users layouts** list. - A saved layout record is available in the list. **Steps** 1. Open **Users layouts** from the configuration area. 2. Locate the saved layout record. 3. In that record's row, select the available edit action. The edit action is available for records in the same branch as the account. **Result:** The selected record opens on the **Edit user layout** page when its row has the edit action. ## Understand the edit surface The edit surface combines the record area, the saved layout text, two layout grids, and column actions. The user layout grid helps you inspect the columns in the saved definition. The default layout grid provides the comparison and reconciliation area. Use the column controls to change a selected column. Confirm before removing a column. | Surface | Reader job | | --- | --- | | Record area | Review the layout identity and status flags. | | Layout text | Read or change the required **Layout** text. | | Parsed user layout | Inspect and maintain the columns represented by the saved layout. | | Parsed default layout | Compare the saved columns with the default columns and reconcile them. | | Column settings | Change one selected column. | | Deletion prompt | Confirm before removing the selected column. | ### Record and layout fields The record fields identify the saved layout and supply its layout text. Identity fields identify the saved layout; status fields show its state. Both groups are disabled. **Layout** is the required text area used for layout maintenance. | Field | Type | Required | Availability | | --- | --- | --- | --- | | **Name** | Text | Yes | Disabled | | **List num** | Select | Yes | Disabled | | **Is current** | Boolean | No | Disabled | | **Is standard** | Boolean | No | Disabled | | **Layout** | Text area | Yes | Used for layout text maintenance | ### List choices The disabled **List num** field displays these choices. The column editor uses the data-type and filter-operation choices shown after it. | **List num** option | ID | | --- | ---: | | **Activities (0)** | 0 | | **Tasks (1)** | 1 | | **Contract (2)** | 2 | | **Registeration data (3)** | 3 | | **Ticket - Running (4)** | 4 | | **Ticket - Closed (5)** | 5 | | **Layouts (6)** | 6 | | **Pricing indicator (7)** | 7 | | **Project (21)** | 21 | | **Clients (22)** | 22 | | **Principals (23)** | 23 | | **Roles (26)** | 26 | | **Users (27)** | 27 | | **Account (29)** | 29 | | **Contact (30)** | 30 | | **Invoices all (31)** | 31 | | **Payment (32)** | 32 | | **Sales Leads(39)** | 39 | | **Sales All(40)** | 40 | | **Sales Inquiries (41)** | 41 | | **Sales Offers (42)** | 42 | | **Sales Orders (43)** | 43 | | **Sales Delivered (44)** | 44 | | **Sales Lost offer (45)** | 45 | | **Sales Regretted (46)** | 46 | | **Sales Deleted (48)** | 48 | | **Sales Rejected orders (49)** | 49 | | **Sales Missed Inquiries (50)** | 50 | | **Sales Cancelled offer (51)** | 51 | | **Sales Cancelled order (52)** | 52 | | **Buyout All (53)** | 53 | | **Buyout RFQ (54)** | 54 | | **Buyout Offer (55)** | 55 | | **Buyout Order (56)** | 56 | | **Buyout Delivered (57)** | 57 | | **Buyout Rejected offer (58)** | 58 | | **Buyout Regretted (59)** | 59 | | **Buyout Deleted (61)** | 61 | | **Buyout Rejected order(62)** | 62 | | **Buyout Cancelled offers (64)** | 64 | | **Buyout Cancelled order (65)** | 65 | | **Principal invoice (67)** | 67 | | **teams (70)** | 70 | | **Account managers (71)** | 71 | | **Subscription Invoices (72)** | 72 | | **Letter of guarantees all (73)** | 73 | | **Products (74)** | 74 | | **MRQ (75)** | 75 | | **Procurement All (76)** | 76 | | **Procurement RFQ (77)** | 77 | | **Procurement Offer (78)** | 78 | | **Procurement Order (79)** | 79 | | **Procurement Delivered (80)** | 80 | | **Procurement Rejected (81)** | 81 | | **Procurement Regretted (82)** | 82 | | **Procurement Deleted (83)** | 83 | | **Procurement Rejected order (84)** | 84 | | **Procurement Cancelled offers (85)** | 85 | | **Procurement Cancelled orders (86)** | 86 | | **Extension rejected offer (89)** | 89 | | **Warehouse configuration (91)** | 91 | | **Receiving shipment (92)** | 92 | | **Inspection (93)** | 93 | | **PM All (94)** | 94 | | **PM Planned To Order (BOM) (95)** | 95 | | **PM Ready To Order (MRQ) (96)** | 96 | | **PM In Procurement All (97)** | 97 | | **PM In Procurement Inquiry (98)** | 98 | | **PM In Procurement Offer (99)** | 99 | | **PM In Procurement Order (100)** | 100 | | **PM In Procurement Stuck (101)** | 101 | | **PM Products Receipt (102)** | 102 | | **PM Product Rejected (103)** | 103 | | **PM Stored (104)** | 104 | | **PM Assembly (105)** | 105 | | **PM Loss (106)** | 106 | | **PM Ready For Shipment (107)** | 107 | | **PM Delivered (108)** | 108 | | **Stock (109)** | 109 | | **Packages (110)** | 110 | | **upcoming stock (111)** | 111 | | **Production order (112)** | 112 | | **Shipping order (113)** | 113 | | **Issue goods note (114)** | 114 | | **External service order (115)** | 115 | | **Transfer order (116)** | 116 | | **Return note (117)** | 117 | | **Delivery note (118)** | 118 | | **PM orders (119)** | 119 | | **In-warehouse all (120)** | 120 | | **PM Delivered orders (121)** | 121 | | **Reference list by serial num. (122)** | 122 | | **Job Profitabilty (123)** | 123 | | **Job Cost Transaction (124)** | 124 | | **Purchase Invoice (125)** | 125 | | **Outgoing Paymnet (126)** | 126 | For a column's **Type**, the editor offers `string`, `number`, `date`, and `boolean` as the product's column data types. For **Selected filter operation**, it offers `contains`, `Does not contain`, `Starts with`, `Ends with`, `Equals`, and `Not equals` as product filter operations. ### Parsed layout areas The user layout grid appears when it contains layout columns. It has the following columns. | Parsed user layout columns | | --- | | **Index**, **Field**, **Type**, **Caption**, **Visible**, **Width** | The default layout grid appears when it contains layout columns. It has **Index**, **Field**, **Type**, **Caption**, and **Visible**. The grid does not include a column for numbering rows. ### Column editor fields and choices The new-column and edit-column popup contains the following fields. | Field or control | Type | Required | Rule or choice | | --- | --- | --- | --- | | Column text area | Text area | Yes | Required | | **Index** | Text | Yes | Disabled | | **Visible** | Boolean | No | Optional | | **Field** | Text | Yes | Required | | **Type** | Select | Yes | Required; use the four product data types above | | **Caption** | Text | No | Optional | | **Width** | Number | No | Optional; minimum `0` | | **Filter value** | Text | No | Optional | | **Selected filter operation** | Select | Yes | Required; use the six product filter operations above | ## Maintain the layout text and compare defaults Use this section when the saved layout text needs to be inspected or reconciled with the default layout. The two grids give you a row-based view of the layout; **Layout** remains the saved text area. **Prerequisites** - You have opened an existing layout record. - The **Layout** field contains the layout text you need to review. **Steps** 1. Select **Parse** to display the **Layout** columns in the user layout grid. 2. Review the user layout columns. 3. Select **Stringfy** to copy the user layout grid back into **Layout**. 4. In the default layout area, select **Clean user layout** to remove duplicate or unmatched user columns. 5. Select **Update user layout** to add missing default columns and update matching column metadata. 6. Review the two layout grids again. **Result:** **Layout** contains the user layout grid after **Stringfy**. The comparison actions clean or update the user columns according to the selected action. ## Maintain layout columns Use the column actions when a layout needs a new column, a change to a selected column, or removal of a selected column. **Prerequisites** - You have opened a parsed user or default-layout grid. - You know which row and column property you need to maintain. **Steps** 1. Select the row's **Edit column** action to open the column editor. 2. In the column editor, enter or choose the required values. 3. Select **Save** in the column editor. 4. To remove a selected column, select its **Delete column** action and choose an outcome at `Are you sure?`. | If you need to… | Select | | --- | --- | | Keep the column | **No** | | Confirm removal | **Yes** | **Result:** The updated column appears in the layout, or the column is removed. ## When maintenance goes wrong Use the message text to match the problem to the action you just took. | What you see | Condition or action | | --- | --- | | `This Field Is Required` | A required field has no value. Check **Layout** or the required column-editor fields. | | `Your request was completed successfully` | The save request reports success. | | `An error occurred while processing your request` | The request reports an error. | | `Are you sure?` | A delete-column confirmation is open. Choose **No** or **Yes**. | **Save** and **Save and Close** are available after a change. **Close** opens the exit choices when changes exist and leaves directly when there are no changes. ## What to do next When the layout is ready, choose the outcome that matches your next task. **Prerequisites** - You have finished reviewing the layout and its columns. - You know whether the current changes must be saved. **Steps** 1. Choose one outcome. | If you need to… | Select | | --- | --- | | Save the layout and remain on the page | **Save** | | Save the layout and leave the page | **Save and Close** | | Attempt to leave the page | **Close** | 2. If the exit popup appears after **Close**, choose an exit outcome. | If you need to… | Select | | --- | --- | | Leave without saving | **Don't Save** | | Keep the changes and close the popup | **Cancel** | **Result:** **Save** saves the layout and keeps you on the page. **Save and Close** saves the layout and leaves the page. **Close** attempts to leave the page. After a successful save, the message is `Your request was completed successfully`. Continue with [User layouts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-users-layouts-view), [Default layouts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-default-layouts), or the related default-layout configuration. # Manage demo data Demo data is the demo company data managed as a whole from Configuration. Use this page before a training or demonstration session, or after the session when you want to remove it. | If you need to… | Go to | |---|---| | Find the page | [Find the page](#find-the-page) | | Identify the action for the current account state | [Understand the screen](#understand-the-screen) | | Start the first import | [Import demo data](#import-demo-data) | | Refresh or remove imported demo data | [Refresh or delete imported demo data](#refresh-or-delete-imported-demo-data) | | Continue with another Configuration area | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) | ## Before you start Demo data management uses the signed-in account's demo-data state to choose its starting row. The page works on the demo company data as a whole rather than on individual records. **Prerequisites** - Sign in to the account whose demo-data state you want to manage. - Know whether that account has demo data imported. The page has no page-owned fields to complete, no file-selection step, and no grid or table columns to review. No approval step is included for deleting demo data. ## Find the page The Manage demo data page is the Configuration screen for importing, refreshing, and deleting demo data. Open Manage demo data from Configuration. The deletion completion guidance includes the settings reference `Settings - Demo Data Settings`. ## Understand the screen The page shows one of two rows according to whether demo data is already imported. The account starts with the import row when its demo-data state is not imported; the imported branch offers refresh and delete actions instead. | When you are… | Select or do this | |---|---| | Demo data is not imported | Select **Import demo data**. | | Demo data is imported | Select **Refresh demo data** or **Delete demo data**. | | The deletion completion message is shown | Read the completion guidance, then select **Close**. | The starting row determines which procedure follows: use [Import demo data](#import-demo-data) for an account without imported data, or use [Refresh or delete imported demo data](#refresh-or-delete-imported-demo-data) for an account with imported data. ## Import demo data To import demo data, follow these steps. **Prerequisites** - The signed-in account is in the not-imported demo-data state. - The Manage demo data page is open. **Steps** 1. Select **Import demo data**. The modal changes to the progress state and shows `Start importing demo company data…`. ![The import action before starting the demo-data import](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/abf65da87352cbd870653c8916a44117.png) 2. Keep the browser window open until the import finishes. > **Warning:** `Importing the demo company data will take a few minutes. Please do not close this browser window until the import process is complete. Ending the import process before it is finished may result in corrupt data being entered.` ![The import-progress message and warning](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/fc38e252e013d8b6fd6b39c0b8e7c4e4.png) 3. Select **Close** after `Importing demo company data completed.` appears. ![The completed import message and Close action](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/34bc0121509d4cf90a8d29742617f2e7.png) **Result:** The import modal shows `Importing demo company data completed.` and **Close**. ## Refresh or delete imported demo data When demo data is imported, choose whether to refresh it or remove it. ### Refresh imported demo data Use refresh when you want to run the page's refresh operation on imported demo data. **Prerequisites** - Demo data is imported for the signed-in account. - The Manage demo data page is open. **Steps** 1. Select **Refresh demo data**. The refresh operation uses its own request. ![The imported-data row with Refresh demo data](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/abf65da87352cbd870653c8916a44117.png) **Result:** The page reports `Demo company data refreshed successfully` when the refresh request reaches its success state. ### Delete imported demo data Use deletion when you want to remove demo company data and its related records without affecting private data added during experimentation. **Prerequisites** - Demo data is imported for the signed-in account. - The Manage demo data page is open. **Steps** 1. Select **Delete demo data**. The confirmation modal shows the title `Deleting demo company data?`. The modal also shows this safety message: `Deleting demo company data (and all its related records) will not affect your real private data that was added during the experimentation.` ![The confirmation dialog with the demo-data safety message](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/abf65da87352cbd870653c8916a44117.png) 2. Choose one action in the confirmation modal. | Select | To | |---|---| | **Keep** | Leave the demo data in place | | **Delete** | Continue with deletion | 3. If you chose **Keep**, select **Keep**. **Result:** The deletion request does not start. 4. If you chose **Delete**, review `Important: Importing the demo company data will take a few minutes.`. **Result:** The deletion warning has been reviewed. 5. If you chose **Delete**, select **Delete** to confirm. The modal changes to the progress state and shows `Deleting demo company data…`. **Result:** The deletion progress state shows `Deleting demo company data…`. 6. If you chose **Delete**, keep the browser window open until the deletion finishes. When deletion completes, the modal shows `Demo company data deleted successfully` and the guidance `Start using PAMS account and remember you can manage demo company data any time from Settings - Demo Data Settings`. **Result:** The modal shows the deletion completion message and guidance. 7. If you chose **Delete**, select **Close** after the completion message appears. **Result:** The delete modal closes. **Result:** After **Keep**, deletion does not start. After **Delete**, the completion message appears and **Close** closes the delete modal. ## When an operation goes wrong The page uses the same request-error message for failed import, refresh, and delete requests: `An error occurred while processing your request`. | What you see | What to do | |---|---| | The import request stops before completion | Keep the browser open while the request is active, then use the request-error message as the failure signal. | | `An error occurred while processing your request` after an operation | Treat the operation as unsuccessful and repeat it only after the account is ready for that operation. | | Refresh controls are unavailable | Return to the page when the imported-data branch is available. | | Delete controls are unavailable | Return to the page when the imported-data branch is available. | After the deletion completion message appears, select **Close**. Continue with the [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home). ## After managing demo data Use this procedure after the deletion completion message appears. **Prerequisites** - The deletion completion message and guidance are visible. **Steps** 1. Read `Start using PAMS account and remember you can manage demo company data any time from Settings - Demo Data Settings`. 2. Select **Close**. **Result:** The completion guidance has been displayed and **Close** has been selected. # Plans ## Plans Use Plans to review subscription plans, compare their list values, and open a plan record for configuration details. | If you need to… | Go to | |---|---| | Review the columns in the Plans list | [Understand the plan list](#understand-the-plan-list) | | Narrow the list before choosing a row | [Filter the plan list](#filter-the-plan-list) | | Open a plan record | [Find and open a plan](#find-and-open-a-plan) | | Diagnose an empty or failed list | [When the list cannot load](#when-the-list-cannot-load) | | Review fields, features, or saving on an opened plan | [Continue to plan details](#continue-to-plan-details) | ## Before you start The Plans list is the starting point for reviewing saved subscription plans. Have the identifier available when you need to open a specific plan. | Before you begin | Why it matters | |---|---| | Have access to the Plans list | You need access before you can review plans. | | Know which saved plan you need to review | This helps you choose the correct row when several plans are listed. | ## Understand the plan list The Plans list is a grid for comparing a plan's name, price, dates, and active state before you open its record. It displays **Plan**, **Price**, **Created at**, **Modified at**, and **Active**. ![Identify the five plan-list columns before selecting a row.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6ad73e382f74e6e0530f7c5916627519.png) | Column | What it contributes to review | |---|---| | **Plan** | Identifies the plan by name. | | **Price** | Shows the plan price. | | **Created at** | Shows when the plan was created. | | **Modified at** | Shows when the plan was last modified. | | **Active** | Shows the plan's active value. | The list can show `No data` and `Count: 0`. When rows are available, use the **Plan** value with the other columns to choose the record to inspect. ## Filter the plan list Filtering narrows the Plans grid before you choose a row. The grid provides a filter row and filters in its column headings. **Prerequisites** - The Plans list is open. **Steps** 1. Use one of these filtering methods: | If you want to… | Use | |---|---| | Filter from the grid | The filter row for the column you want to narrow. | | Filter from a heading | The filter in the column heading. | **Result:** The grid is narrowed to matching plan rows when rows are available. If the grid displays `No data` and `Count: 0`, there is no plan row to select. ## When the list cannot load Use the message on screen to distinguish an empty list from an unsuccessful load. | What you see | What to do | |---|---| | `No data` and `Count: 0` | Review the list state and wait for plan rows before selecting one. | | `An error occurred while processing your request` | Return to the Plans list and try the review again. | ## Find and open a plan A plan record is the detail surface for one subscription plan. Open it from the corresponding row when you need to inspect or edit that plan. **Prerequisites** - The Plans list is open. - The plan row is visible, either in the full list or after filtering. **Steps** 1. Use one of these ways to open the plan: | If you want to… | Select | |---|---| | Open from the row | A data cell in the plan row. | | Open from the row’s edit link | The row’s edit link at the end of the row. | **Result:** The selected plan's details surface opens. ## Continue to plan details Plan details is the record surface for reviewing the plan's limits, active value, and available features. The form contains **Plan name**, **Plan Price**, **Users count**, **Branches count**, **Teams count**, **Roles count**, and **Active**. | Field | What it is used for | Rule shown by the form | |---|---|---| | **Plan name** | Identifies the plan on its record. | Required. | | **Plan Price** | Holds the plan price and its currency selection. | Minimum `0`; no required marker is shown. | | **Users count** | Holds the user limit for the plan. | Required; minimum `0`, maximum `99`. | | **Branches count** | Holds the branch limit for the plan. | Required; minimum `0`, maximum `99`. | | **Teams count** | Holds the team limit for the plan. | Required; minimum `0`, maximum `99`. | | **Roles count** | Holds the role limit for the plan. | Required; minimum `0`, maximum `99`. | | **Active** | Edits whether the plan is active. | A check box; no required marker is shown. | The capacity values are carried by the plan record and are used as limits in the corresponding branch, warehouse, team, role, and user administration surfaces. When feature rows exist, the feature grid provides **Feature** and **Selected** columns. Select a feature row to add or remove that feature from the plan. The record also provides a currency picker with **Plan Price**. ### Validate and save a plan Enter the plan values, then submit the changes with **Save**. **Prerequisites** - A plan record is open. - You know the values to enter for the plan fields. **Steps** 1. Enter the plan values in the fields below: | Field | Value or action | |---|---| | **Plan name** | Enter the plan name. | | **Plan Price** | Enter a value of at least `0`, then choose its currency. | | **Users count** | Enter a value from `0` through `99`. | | **Branches count** | Enter a value from `0` through `99`. | | **Teams count** | Enter a value from `0` through `99`. | | **Roles count** | Enter a value from `0` through `99`. | | **Active** | Select it when the plan must be active. | | **Feature** row | Select it when you need to add or remove the feature from the plan. | 2. Select **Save** after the form shows the changes you want to submit. ![Check that Save is disabled before changes and available after unsaved changes.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/36b583ad507eaa65d4ea0ae665d68c3c.png) **Result:** **Save** is enabled when the record has unsaved changes. If a required field is empty, the form displays `This Field Is Required`. If the plan name contains a disallowed character, it displays `Just '_'‘-''.' And '&' Characters Accepted`. Correct the value shown by the message before selecting **Save** again. The record opens with **Save** disabled until the form has unsaved changes. ## Plan list actions The Plans list has no mounted create control, and its Cancel and Delete controls are not mounted. # Plan details A plan record holds the name, price, capacity limits, active setting, and selected features for a subscription plan. ## Overview Use plan details to review or maintain an existing plan. Its capacity values become limits in the branch, warehouse, team, role, and user administration areas. | If you need to… | Go to | |---|---| | Find an existing plan | Plans page | | Open a saved plan record | [Find and open a plan](#find-and-open-a-plan) | | Locate a field or check its rule | [Plan fields](#plan-fields) | | Understand feature selection | [Feature columns](#feature-columns) | | Change plan information or features | [Maintain a plan](#maintain-a-plan) | | Correct a validation or request message | [When loading, saving, or validating goes wrong](#when-loading-saving-or-validating-goes-wrong) | | Configure available features | Features page | | Review feature-specific details | [Company features](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-features-record) | | Check which company is associated with a plan | Subscriber view | ## Prerequisites You need an existing plan identifier. The plan information appears after the saved plan record loads. The feature grid appears only when the feature list contains at least one item. | Before you begin | What must be available | |---|---| | Plan information | The saved plan record must load before the form content appears. | | Feature selection | The feature list must contain at least one item before the feature grid appears. | ## Find and open a plan The Plans page is the list entry point for an existing plan record. Prerequisites - You have an existing plan identifier. Steps 1. Open the Plans list. 2. Select the existing plan row. 3. Confirm that **Plan name** appears on the plan details screen. **Result:** The existing plan details screen is open. Continue with [Understand the plan details screen](#understand-the-plan-details-screen) to review its fields and feature area. ## Understand the plan details screen The plan details screen contains the values that define one existing plan. Its plan-information area contains **Plan name**, **Plan Price**, **Users count**, **Branches count**, **Teams count**, **Roles count**, and **Active**. **Save** commits a change. | Screen area | What it contains | What to use it for | |---|---|---| | Plan information | **Plan name** and **Plan Price** | Identify the plan and its price. | | Capacity limits | **Users count**, **Branches count**, **Teams count**, and **Roles count** | Set the limits used in administration areas. | | Active setting | **Active** | Set the plan's active value. | | Commit control | **Save** | Commit changed plan information or feature selections. | | Feature area | The feature grid, when the feature list contains at least one item | Review or select features for the plan. | ![The plan-information fields, including Plan name and Plan Price](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/36b583ad507eaa65d4ea0ae665d68c3c.png) ### Plan fields Use these rules when reviewing or changing a plan. A required marker is visible for **Plan name**, **Users count**, **Branches count**, **Teams count**, and **Roles count**. **Plan Price** and **Active** are optional. | Field | Type | Required marker | Accepted value or rule | |---|---|---|---| | **Plan name** | Text box | Yes | Required and subject to pattern validation. | | **Plan Price** | Number box with currency picker | No | Minimum `0`; displayed in `#,##0.00` format. | | **Users count** | Number box | Yes | From `0` through `99`. | | **Branches count** | Number box | Yes | From `0` through `99`. | | **Teams count** | Number box | Yes | From `0` through `99`. | | **Roles count** | Number box | Yes | From `0` through `99`. | | **Active** | Boolean checkbox | No | Optional boolean setting. | ### Feature columns The feature grid is the plan's feature-selection table. When it appears, its columns are **Selected** and **Feature**. Select a **Feature** row to add or remove that feature. Select **Save** to commit the selection. When the feature list has no items, the feature grid has no columns or rows. The grid appears when the feature list contains at least one item. > **Note:** The feature list controls whether the feature area appears. Review the visible grid > before changing feature selections. ## Maintain a plan Change plan information or select a feature on an existing plan. Prerequisites - An existing plan details screen is open. - You know the plan information or feature selection to change. Steps 1. Enter or change a value in one of the fields listed below. | Change | Action | |---|---| | Plan identity or price | Enter or change a value in **Plan name** or **Plan Price**. | | Capacity limit | Enter or change a value in **Users count**, **Branches count**, **Teams count**, or **Roles count**. | | Active setting | Select or clear **Active**. | | Feature selection | Select a **Feature** row when the feature grid is available. | 2. If **Save** is disabled, change a plan field or feature selection. 3. Select **Save**. ![The Save control on the plan details screen](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/36b583ad507eaa65d4ea0ae665d68c3c.png) **Result:** The changed plan information or feature selection is submitted through **Save**. The screen provides no delete action. ## When loading, saving, or validating goes wrong Use the message text on screen to identify the problem, then correct the value or repeat the affected action. | What you see | Meaning | What to do | |---|---|---| | `This Field Is Required` | A required field has no value. | Enter a value in the required field, then review **Save**. | | `Just '_'‘-''.' And '&' Characters Accepted` | **Plan name** does not meet the pattern rule. | Correct **Plan name**, then review **Save**. | | `An error occurred while processing your request` | Loading the plan or its features failed. | Review the request state and repeat the affected action when the screen is available. | The required rules apply to **Plan name**, **Users count**, **Branches count**, **Teams count**, and **Roles count**. The plan-name pattern rule is separate from the required rule. ## After maintaining a plan The capacity values are used as limits in the branch, warehouse, team, role, and user administration areas. Use the related administration pages to work with those limits. Use [Company features](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-features-record) for related feature configuration and feature-specific details. Use the Features page for the feature list, and Subscriber view to check which company is associated with a plan. # Features Use **Features** to compare subscription plan limits, choose features for each plan, and review feature prices before assigning a plan to a company. ## Features overview **Features** is the configuration screen for comparing the limits and feature selections that belong to subscription plans. It also provides the feature prices used in that comparison. | If you need to… | Go to | | --- | --- | | Review the plan-limit fields and feature matrix | [Read the Features screen](#read-the-features-screen) | | Change plan capacity values | [Change plan limits](#change-plan-limits) | | Add or remove a feature in a plan | [Assign a feature to a plan](#assign-a-feature-to-a-plan) | | Open and close the feature-price dialog without saving | [Open and close the feature-price dialog without saving](#open-and-close-the-feature-price-dialog-without-saving) | | Select all child features under a parent | [Select child features together](#select-child-features-together) | | Continue to plan or company-specific configuration | [Continue from Features](#continue-from-features) | The available plan columns and feature rows determine what you can compare. Review them before choosing a plan. ## Before you start Prerequisites - Have administrator access to the configuration area. - Know which plan column you intend to review or change. - Identify whether you are reviewing plan limits, feature selections, or feature prices. The available plan columns and feature rows depend on the current configuration. Open the screen when you are ready to review those choices. ## Open Features Steps 1. Open **Features** from the configuration navigation. 2. Confirm that **Plan name** and **Features** are visible. 3. Select **Companies** to return to the company configuration view when needed. **Result:** The **Features** screen is open, with **Companies** available as the related navigation link. ![Identify the plan-limit area, feature matrix, Companies link, and Save action.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3f8ab829c6922bbeefd2cd58f785048c.png) The open screen leads to the plan-limit and feature-matrix review below. ## Read the Features screen The screen combines plan-limit fields with a feature matrix. Read a plan column from its plan values, then read the feature rows and their plan selections. | Field | What to read | | --- | --- | | **Plan name** | Use this field to identify the plan before reviewing its limits. It is required and has pattern validation. | | **Plan Price** | The plan price, shown as a number with a minimum of `0` and a `#,##0.00` format. | | **Branches count** | The branch capacity, from `1` to `99`. | | **Users count** | The user capacity, from `1` to `99`. | | **Teams count** | The team capacity, from `1` to `99`. | | **Roles count** | The role capacity, from `1` to `99`. | | **Dashboard widgets count** | The dashboard-widget capacity, from `1` to `99`; this field is disabled. | | **Warehouses count** | The warehouse capacity, from `0` to `99`. | | **Latest modifications count** | The latest-modifications capacity, from `0` to `99`. | The feature matrix is headed Features. Its visible columns are Feature, Id, Price, and one plan-selection column for each available plan. The current plan columns are Plan #0, Plan #1, and Plan #2. Prices are read out in EUR. Use Feature and Id to identify a row, Price to review its price, and the plan column to review whether the feature is selected for that plan. When you have identified the values to change, use the maintenance procedure that follows. The plan-limit area appears when plan details are available. The Features tree appears only when the available feature list contains at least one item. **Save** is disabled when there are no unsaved plan changes. ![Read the plan-limit fields and the Feature, Id, Price, and plan-selection columns.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3f8ab829c6922bbeefd2cd58f785048c.png) ## Change plan limits and feature assignments Use the plan-limit fields and feature-selection cells to prepare one complete plan change, then select **Save** to submit it. To edit a feature price, use [Open and close the feature-price dialog without saving](#open-and-close-the-feature-price-dialog-without-saving). Prerequisites - Know which plan column you are maintaining. - Know the plan values or feature selections to apply. Steps 1. Apply the change that matches your task. | If you need to… | Do this | | --- | --- | | Change plan limits | Follow [Change plan limits](#change-plan-limits). | | Assign a feature | Follow [Assign a feature to a plan](#assign-a-feature-to-a-plan). | | Select child features together | Follow [Select child features together](#select-child-features-together). | 2. Review the changed plan values and feature selections. 3. Select **Save**. **Result:** The changed plan limits and feature selections are submitted. ### Change plan limits Change a plan's name, price, and capacity values when the available subscription limits need maintenance. Prerequisites - Know which plan column to maintain. - Have the replacement plan values. Steps 1. In the selected plan column, enter the replacement values in the fields below. | Field | Allowed value or action | | --- | --- | | **Plan name** | Enter the name used to identify the plan. | | **Plan Price** | Enter the price. | | **Branches count** | Enter a value from `1` to `99`. | | **Users count** | Enter a value from `1` to `99`. | | **Teams count** | Enter a value from `1` to `99`. | | **Roles count** | Enter a value from `1` to `99`. | | **Dashboard widgets count** | Review the displayed value after the capacity values change. | | **Warehouses count** | Enter a value from `0` to `99`. | | **Latest modifications count** | Enter a value from `0` to `99`. | 2. Review **Dashboard widgets count** after the plan feature selections change. 3. Select **Save**. The dashboard-widget count is derived again when plan feature selections change. Keep the displayed value with the completed plan review before saving. **Result:** The selected plan column contains the revised plan-limit values and is sent to the plan save operation. ### Assign a feature to a plan Assign a feature by changing its selection cell in the target plan column, then save the plan configuration. Prerequisites - Know the feature row to change. - Know the target plan column. Steps 1. Locate the feature by its Feature and Id values. 2. Select the feature-selection cell in the target plan column. 3. Review the changed selection and **Dashboard widgets count**. 4. Select **Save**. Selecting the cell adds or removes the feature from the selected plan and recalculates the dashboard-widget count. **Result:** The feature assignment is included in the selected plan's changes. ### Open and close the feature-price dialog without saving The feature-price popup provides an **Edit feature** dialog for a feature row. Use it to review the feature price controls. Prerequisites - Have a feature row available in the feature matrix. Steps 1. Select a feature row other than the all-features row. 2. In the **Edit feature** dialog, review the price entry for the selected feature. 3. Select **OK** to use the dialog's confirm control. The feature-price popup opens when you select a feature row. Its price entry is optional and has a minimum of `0`. **Result:** The feature-price dialog is closed after its **OK** control is used. ## Handle parent and child features A parent feature row can expose child feature rows beneath it. The available tree and its parent-child relationships vary with the feature data returned when the screen loads. When a parent has child features, **Select all sub** is available for that parent row. Child rows provide the individual feature selections in the plan columns. ### Select child features together Use **Select all sub** on a parent row when every child feature under that parent belongs in the selected plan. Prerequisites - Have a parent feature row with child features. - Know the plan column that receives the child selections. Steps 1. Locate the parent feature row in the current feature tree. 2. In the target plan column, select **Select all sub** for that parent row. 3. Review the child feature rows in the target plan column. 4. Select **Save**. Each plan column can expose its own **Select all sub** control. The control selects the child features for the parent feature in the chosen plan column. **Result:** The child features are selected together for the chosen plan and included in the changes sent by **Save**. ## When a value or save goes wrong Use the table below when a value is rejected or a request returns an error. | What you see | Rule or path | What to do | | --- | --- | --- | | **Plan name** is rejected as empty | The field is required. The message is `This Field Is Required`. | Enter a plan name. | | **Plan name** contains an unsupported character | Pattern validation accepts only the characters described by `Just '_'‘-''.' And '&' Characters Accepted`. | Replace the unsupported character with an accepted one. | | **Plan Price** or a feature price is below `0` | The price minimum is `0`. | Enter `0` or a higher value. | | A plan count is outside its allowed range | **Branches count**, **Users count**, **Teams count**, **Roles count**, and **Dashboard widgets count** accept `1` to `99`; **Warehouses count** and **Latest modifications count** accept `0` to `99`. | Enter a value within the field's range. | | A plan or feature request returns an error | `An error occurred while processing your request` | Review the values and try the configuration again. | The same request-error message is used for plan loading, plan saving, and feature saving. After resolving the problem, continue with the relevant configuration area. ## Continue from Features After reviewing or changing the comparison, continue to the configuration page that matches the next task. | If you need to… | Go to | | --- | --- | | Return to company configuration | Select **Companies**. | | Review plan records | [Plans](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-plans) | | Review details for one plan | [Plan details](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-plans-record) | | Review company-specific plan and feature configuration | [Company features](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-features-record) | | Review subscriber feature assignment | [Subscriber configuration](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-subscriber-edit-record) | ## Out of scope This screen does not provide controls to create or delete features. It also does not declare a success message after **Save**, so the screen provides no confirmation message for a completed plan or feature save. # Company features Review and maintain the company’s plan limits, feature assignments, and feature prices. | If you need to… | Go to | |---|---| | Understand the plan-and-feature matrix | [Company features](#company-features) | | Check what controls and runtime data are available | [Before you start](#before-you-start) | | Open the page from the company area | [Find the company features page](#find-the-company-features-page) | | Interpret plan limits and feature rows | [Read the plan and feature tables](#read-the-plan-and-feature-tables) | | Change plan values, assignments, or prices | [Maintain feature assignments and prices](#maintain-feature-assignments-and-prices) | | Select child features from a parent feature | [Handle parent features](#handle-parent-features) | | Correct a validation or request problem | [When saving or validating goes wrong](#when-saving-or-validating-goes-wrong) | | Return to the company area | [After reviewing the configuration](#after-reviewing-the-configuration) | ## Company features Company features are the configuration of a company’s plan limits, feature assignments, and feature prices. The page presents those values as a plan-and-feature matrix: plan fields describe limits and prices, while the feature table shows which features belong to each plan. Subscription configuration supplies the plan details used when a plan is assigned to a company. ## Before you start The page shows its plan fields when plan details are loaded. It shows the **Features** table when feature data is loaded. The page shows one plan-selection column for each plan. | Before changing configuration | What to expect | |---|---| | Plan details are available | The plan fields and main plan table appear. | | The feature list has entries | The **Features** table appears. | | Plan data is loaded | The visible plan columns match the plans shown on the page. | Use the plan fields and feature table described below when the required data is loaded. ## Find the company features page The company features page is where you review plan limits and feature assignments. Enter it from the company area rather than guessing a company record URL. **Prerequisites** - You are signed in and can open the company configuration area. **Steps** 1. Select **Companies**. 2. Confirm that the company area opens. 3. Open the company features page. 4. Confirm that **Plan name**, **Plan Price**, **Branches count**, **Users count**, **Teams count**, **Roles count**, **Dashboard widgets count**, **Warehouses count**, **Latest modifications count**, **Features**, and **Save** are visible. ![The company features page with its plan fields, Features, and Save](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/abb35eb9e176591d89a8d3c7f2cffd15.png) **Result:** The company features page is open, with the plan fields, **Features**, and **Save** visible. ## Read the plan and feature tables The plan table describes the limits and price for each plan. The feature table relates each feature to its identifier, price, and plan selections. | Visible label | What to read | |---|---| | **Plan name** | The plan’s assigned name. | | **Plan Price** | The configured monetary value for the plan; the screen displays an `EUR` currency readout. | | **Branches count** | The branch limit. | | **Users count** | The user limit. | | **Teams count** | The team limit. | | **Roles count** | The role limit. | | **Dashboard widgets count** | The dashboard-widget limit. | | **Warehouses count** | The warehouse limit. | | **Latest modifications count** | The latest-modifications limit. | The feature table displays these columns: | Column | Meaning on the page | |---|---| | **Feature** | The feature assigned to the row. | | **Id** | The feature identifier. | | **Price** | The configured monetary value for the feature. | | **Parent** | The parent-feature identifier. | | Plan selection columns | One selection column for each plan shown on the page. | The plan-selection columns are **Plan #0**, **Plan #1**, and **Plan #2**. The visible feature rows include **All features**, **Dashboard Module**, **Reports Module**, **MyDesk Module**, **Sales Module**, **Project Management Module**, **PurchaseJob Module**, **Warehouse Module**, **Invoice Module**, **Payments Module**, **Accounts Module**, **L/G Module**, **Contacts Module**, **Projects Module**, **Tasks Module**, and **Activities Module**. ![The plan fields and feature matrix with runtime plan columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3f8ab829c6922bbeefd2cd58f785048c.png) ## Maintain feature assignments and prices Use this task when you need to change a plan value, change a feature selection, or edit a feature price. **Prerequisites** - You can open the company features page. - You know the plan limit, assignment, or feature price that needs changing. **Steps** 1. In the relevant plan field, enter the new plan value. 2. Select the plan-selection control in the relevant feature row. 3. If the feature price is editable from its row, select the row outside the feature-selection column. 4. In the **Edit feature** popup, enter the value in **Feature price**. 5. Select **OK** in the popup to save the feature price. 6. Select **Cancel** in the popup to close it without saving the popup value. 7. Select the page **Save** control to save a plan value or feature assignment. The page **Save** control is disabled when there are no changes. Changing a feature-selection cell calls the feature-selection action. The feature-price popup opens for a data row, outside the feature-selection column, when the row’s `Id` is not `-1`. The popup’s **Feature price** field has a minimum of `0`. **Result:** The feature price is saved when you select **OK**. The edit popup closes without saving its value when you select **Cancel**. ## Handle parent features A parent feature groups child features. When the feature list is available, a parent row can offer **Select all sub** so that the child features for a plan can be selected together. **Prerequisites** - The **Features** list is visible. - The row you are working with is a parent feature with child features. **Steps** 1. In the **Features** table, locate a parent row with **Select all sub**. 2. Select **Select all sub** in the plan column you want to update. 3. Check the child-feature rows in that plan column. The **Select all sub** control is available when the row is a parent of a sub-feature. The control can appear repeatedly in feature rows. **Result:** The child features for the selected plan are selected through the parent row. ## When saving or validating goes wrong Use the field rule or message that matches the value you entered. | What to check | Constraint or message | What to do | |---|---|---| | **Plan name** is empty | `This Field Is Required` | Enter a plan name. | | **Plan name** contains another character | `Just '_'‘-''.' And '&' Characters Accepted` | Use only the accepted characters in the plan name. | | A count field is below its minimum or above its maximum | **Branches count**, **Users count**, **Teams count**, **Roles count**, and **Dashboard widgets count**: minimum `1`, maximum `99` | Enter a value from `1` through `99`. | | **Warehouses count** or **Latest modifications count** is outside its range | Minimum `0`, maximum `99` | Enter a value from `0` through `99`. | | **Plan Price** is below its minimum | Minimum `0` | Enter `0` or a higher value. | | **Feature price** is below its minimum | Minimum `0` | Enter `0` or a higher value in the edit popup. | | **Dashboard widgets count** cannot be changed | The field is disabled. | Review the displayed value rather than attempting to edit it. | | A request fails | `An error occurred while processing your request` | Review the values and request support if the problem continues. | ## After reviewing the configuration The company features page is part of the company area reached through **Companies**. Return there when you need to continue with company records or subscriber configuration. ## Out of scope Importing data and account-merge confirmations belong to their owning configuration pages, not to the company features page. # Subscribers A subscriber is a company represented in the list so you can identify it and review the plan assigned to it. Use the list to find a company, review its assigned plan, and open subscriber details when you need to review or change that plan. | If you need to… | Go to | | --- | --- | | Identify a company and read its assigned plan | [Understand the subscriber list](#understand-the-subscriber-list) | | Narrow the list to a company | [Filter and review the list](#filter-and-review-the-list) | | Open a company's subscriber details | [Find a subscriber](#find-a-subscriber) | | Review or change the company's assigned plan | [Subscriber details](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-subscriber-edit-record) | | Review plan definitions | [Plans](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-plans) | | Administer features separately from subscribers | [Features](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-features) | ## Subscribers A subscriber is a company represented in the list so you can identify that company and review the plan assigned to it. The list is the entry point for reviewing or changing one company's assigned plan. | Field | What it tells you | How you use it | | --- | --- | --- | | **Company** | The subscriber company. | Identify the company row to review. | | **Sub Domain** | The subscriber's subdomain. | Distinguish the subscriber entry you are reviewing. | | **Plan** | The plan assigned to the company. | Review the company's current plan before opening its details. | The list supports company-level review. It does not replace the subscriber details page for work on one company's assigned plan, and it does not replace the separate pages for plan definitions or feature administration. ## Before you start Know the company whose assigned plan you need to review. The list contains row edit links as well as data-row selection behavior, so identify the company from **Company** before using an edit entry. Do not select an edit link when you cannot tell which row it belongs to. When you are ready, use the three visible columns to identify the company. ## Understand the subscriber list The subscriber list is a read-only grid for reviewing three subscriber values. Each visible column can be filtered, but the grid does not edit these values. | Visible column | Use it to | Grid behavior | | --- | --- | --- | | **Company** | Identify the subscriber company. | Visible, filterable, and not editable in the grid. | | **Sub Domain** | Review the subscriber's subdomain. | Visible, filterable, and not editable in the grid. | | **Plan** | Review the plan assigned to the company. | Visible, filterable, and not editable in the grid. | The column chooser is disabled, so work from these three headers. To open a company after you identify it, continue with [Find a subscriber](#find-a-subscriber). ## Find a subscriber Open a company's subscriber details as follows. **Prerequisites** - Know the company whose assigned plan you need to review. - Be ready to identify that company in the **Company** column. **Steps** 1. Open **Configuration**. 2. Open the subscriber list. 3. Locate the company in the **Company** column. 4. Identify the matching subscriber row. 5. Select a data-row cell in the matching subscriber row. The row edit entry is also built from the row's company identifier. Use it only when the entry is unambiguously associated with the company row you identified. ![Locate the company row before opening subscriber details.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/302f65ff903bfc8bdeda2b8eff61f3da.png) **Result:** The selected subscriber row is ready to continue to subscriber details. After the list opens, use the **Filter Row** when the company is difficult to locate. ## Filter and review the list Filtering is remote, so apply the filter before selecting the company row you need. **Prerequisites** - Open the subscriber list. - Know the company name or another value that narrows the list. **Steps** 1. In the **Filter Row**, enter the value that identifies the company. 2. Apply the filter from the **Filter Row**. 3. Review the matching **Company**, **Sub Domain**, and **Plan** values. 4. Select the matching subscriber row. Pressing Enter in the filter interaction invokes the grid filter application routine. Filtering also applies when you use the filter's click action. Review the company row after the list refreshes so that you open the intended subscriber. **Result:** The list shows the filtered subscriber rows, and the matching company row is identified for review or continuation to subscriber details. If the list does not behave as expected, use the supported action in the following table. ## When list review goes wrong | What you see | What it means | What to do | | --- | --- | --- | | `An error occurred while processing your request` | The subscriber list could not complete its request. | Reload the list and review it again. | | No delete option is available | The subscriber list does not provide a delete menu. | Review the row or continue to subscriber details. | | No column chooser is available | The column chooser is disabled for this list. | Use the visible **Company**, **Sub Domain**, and **Plan** columns. | | No search panel is visible | Search-panel controls are not part of this list view. | Use the **Filter Row**. | | No paging controls are visible | Paging is disabled for this list. | Review the loaded rows and use the **Filter Row** to narrow them. | | Filtering does not narrow the list | The filter needs to be applied again. | Apply the **Filter Row** again. | **Prerequisites** - The subscriber list is open. **Steps** 1. Match what you see to the table, then perform the action in its What to do column. **Result:** You have a supported list-review action and can continue by identifying the company row. ## Know what is next After you identify a company, subscriber details is the next place to review or change its assigned plan. The subscriber list remains the place to identify the company and review the plan shown in the row. | Need | Continue at | | --- | --- | | Review or change one company's assigned plan | [Subscriber details](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-subscriber-edit-record) | | Review plan definitions and the plan-definition entry point | [Plans](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-plans) | | Administer features separately | [Features](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-features) | Selecting a subscriber row opens subscriber details. Plan assignment belongs on subscriber details; plan definitions and feature administration belong on their separate configuration pages. # Subscriber details A subscriber record identifies a company and assigns one plan to it. Use this page to review the company and its assigned plan, change the assignment when appropriate, and continue to plan or feature administration. ## Subscriber details The record's **Company** identifies the company, while **Plan** assigns the subscription plan whose features and capacity counts apply to it. Use this page for the company-and-plan assignment. Use [Plan details](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-plans-record) when you need to review or define the available plan options, and use [Feature details](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-features-record) when you need feature administration. | If you need to… | Go to | | --- | --- | | Reach a saved subscriber record | [Find a subscriber record](#find-a-subscriber-record) | | Check the company and assigned plan | [Understand the subscriber details screen](#understand-the-subscriber-details-screen) | | Change the assigned plan | [Review and save the assigned plan](#review-and-save-the-assigned-plan) | | Review a feature-specific price | [Review a feature price](#review-a-feature-price) | | Correct a loading or saving problem | [When loading or saving goes wrong](#when-loading-or-saving-goes-wrong) | | Review available plan setup | [Plan details](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-plans-record) | | Administer features | [Feature details](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-features-record) | ## Before you start You need a saved subscriber row and the plan choice required for the record. **Prerequisites** - Identify the saved subscriber row that you need to review. - Have the plan choice required for the subscriber record. ## Find a subscriber record The subscriber list is the entry surface for opening a saved record. **Prerequisites** - Have a saved subscriber row. **Steps** 1. Open the subscriber list. 2. Select the saved row you need to review. **Result:** The subscriber details screen opens for the selected row. ## Understand the subscriber details screen The subscriber details screen shows the company attached to the record and its assigned plan after the details load. | Screen item | What it does | When it appears | | --- | --- | --- | | **Company** | Displays the company value and cannot be edited. | When subscriber details are loaded. | | **Plan** | Assigns a plan to the subscriber record. This field is required. | After the subscriber details load. | | Feature-specific price field | Shows a feature price as an amount paired with its currency. | When the feature-price editor is active. | The **Plan** choices belong to [Plan details](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-plans-record). The feature-price editor uses a currency-picker amount. ## Review and save the assigned plan Review the assigned **Plan** before changing it. Selecting a plan assigns that plan's features and capacity counts to the subscriber record. **Prerequisites** - Have a subscriber details record loaded. - Know which plan the company should use. **Steps** 1. Review the value in **Plan**. 2. If the assignment is wrong, select the required plan in **Plan**. 3. Select the main **Save** action after changing the assignment. The main **Save** action is disabled when no change is detected. Plan option definitions and plan names are maintained on [Plan details](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-plans-record). **Result:** The changed plan is submitted by the subscriber details save request. ## Review a feature price A feature-specific price is the amount charged for a feature in the conditional feature-price editor. Review it when that editor is active. | Rule | What to expect | | --- | --- | | Editor condition | The editor appears when a feature is being edited. | | Control | The amount field in the feature-price editor holds the feature-specific price. | | Minimum | The feature-specific price accepts values from `0` upward. | | Format | The feature-specific price uses `#,##0.00`. | | Display | The amount is shown with its currency. | Continue feature administration from [Feature details](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-features-record). ## When loading or saving goes wrong Use the messages below to identify the problem and the next action. | What you see | What it means | What to do | | --- | --- | --- | | `This Field Is Required` | A required field has no value. | Select the required plan in **Plan**. | | `An error occurred while processing your request` | The request was not completed. | Review the subscriber row. | | The intended row is not selected. | The wrong subscriber record is open. | Select the intended saved row. | | No result is visible after **Save**. | The screen does not show a completed save. | Change the assigned plan in **Plan**. | ## After reviewing the subscriber After reviewing the company and plan assignment, continue to the administration area that owns the next decision. **Plans & features** opens the plan and feature matrix. Select **Plans & features** when you need to review the available plan setup. Use [Plan details](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-plans-record) for plan definitions and [Feature details](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-features-record) for feature administration. **Result:** You know whether to continue with plan and feature administration, while the subscriber page remains focused on the company and its assigned plan. # Subscription invoices ## Subscription invoices at a glance A subscription invoice is an invoice record associated with a subscription. Use the subscription invoice list to review records, narrow the list, open an invoice, or prepare an export. | If you need to… | Go to | |---|---| | Understand the columns and list controls | [Understand the invoice list](#understand-the-invoice-list) | | Filter or arrange the list | [Personalize, filter, and prepare the list](#personalize-filter-and-prepare-the-list) | | Understand why a control is unavailable | [Handle layout and access branches](#handle-layout-and-access-branches) | | Find a particular invoice | [Find and open an invoice](#find-and-open-an-invoice) | | Review billing and amount values | [Continue to invoice details](#continue-to-invoice-details) and [Subscription invoice details](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-subscription-invoices-edit-record) | | Resolve a failed request or empty export | [When a list action goes wrong](#when-a-list-action-goes-wrong) | The list owns finding and opening an existing invoice. The linked details page owns the read-only review of billing, subscription, and amount information. Start with [Understand the invoice list](#understand-the-invoice-list). ## Before you start Open the subscription invoice list. The list appears after a layout has loaded. Your company permissions determine whether table-layout, row-filter, group-filter, and export controls are available. | What determines what you can use | What it changes | |---|---| | A loaded list layout | The list grid is shown only when a layout is available. | | Table-layout permission | The **Table Layout** menu is available when your account has this permission. | | Row-filter permission | The **Filter Row** option is available when row filtering is allowed. | | Group-filter permission | Group filtering is not available on this list. | | Export availability | **Export** appears in **Settings** when it is available for the list. | The list layout determines which columns you see. Do not rely on a fixed column order when comparing two list views. > **Note:** Work from the headers currently visible in your selected layout. The list does not > promise the same columns for every layout. ## Understand the invoice list The invoice list is the working view for locating subscription invoice records. Its columns come from the selected list layout, so use the headers currently visible on your screen rather than assuming that every list has the same columns. The list can show these five columns: | Column | Use it to… | |---|---| | **Company** | Identify the company on the invoice. | | **Invoice Date** | Identify the invoice date. | | **Invoice no.** | Identify the invoice number. | | **Total amount** | Compare the displayed invoice total. | | **Subscription** | Identify the related subscription. | The grid provides a **Filter Row** when filtering is available. You can also filter directly from a visible column header. When no invoice rows are available, the grid keeps its empty-state message and count indicator visible until rows become available. The list toolbar includes **Refresh**, **Table Layout**, and **Settings**. **Settings** contains list settings such as **Filter Row** and, when permitted, **Export**. Select a data row to open the selected invoice. ## Personalize, filter, and prepare the list Use the list controls to narrow the records you are reviewing, choose the columns that matter, and prepare an export when that action is available. [Handle layout and access branches](#handle-layout-and-access-branches). ### Apply or clear list filters Narrow the list to the invoice rows you need to review. **Prerequisites** - The invoice list is open. - Row filtering is available in **Settings**. **Steps** 1. In **Settings**, select the **Filter Row** checkbox. 2. Enter or select filter values in the filter row beneath the visible headers. 3. Select **Refresh** when you need to request the list again. 4. Remove the applied filter values when you need to return to the unfiltered list. **Result:** The list shows the rows that match the applied filter, or its empty-state message and count indicator when no rows match. Use the filter controls attached to a visible column header when you need to narrow that column directly. ### Adjust the visible layout Use the table-layout controls when the current list does not show the columns or width you need. **Prerequisites** - **Table Layout** is available. **Steps** 1. Open **Table Layout**. 2. Select a layout such as **Standard Layout**. 3. Choose one list adjustment. | If you need to… | Select | |---|---| | Change the visible columns | **Columns Chooser** | | Give the columns more space | **Expand column width** | | Store a new arrangement | **Save New Layout** | 4. Complete the selected adjustment. | If you selected… | Then… | |---|---| | **Save New Layout** | Enter a name in **Layout name**, then select **Save**. | | **Update Current** | Save changes to the current non-standard layout. | | **Delete Current** | When `Are you sure?` appears, select **Delete** to remove the layout or **Cancel** to keep it. | | **Columns Chooser** | Choose the columns to display. | | **Expand column width** | Select the checkbox to give the columns more space. | **Result:** The list uses the selected layout, its chosen columns, or its expanded column width. ### Prepare an export Prepare an export when **Export** is available in **Settings**. [Handle layout and access branches](#handle-layout-and-access-branches). **Prerequisites** - The invoice list is open. - **Export** is visible in **Settings**. **Steps** 1. In **Settings**, select **Export**. 2. Choose an export action. | If you need to… | Select | |---|---| | Export an Excel file | **Export to Excel**, then **Export** in the `Exporting List:` dialog. | | Export a PDF file | **Export to PDF**, then **Export** in the `Exporting List:` dialog. | | Close the dialog without exporting | **Cancel**. | ![Choose the subscription invoice export format](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/4701ab1df405440b51472daee72912e4.png) ![Return to the invoice list after cancelling export](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9f82802c48adf675ad7de91dfc206ada.png) **Result:** The selected export action is requested, or the list is visible again after **Cancel**. ## Handle layout and access branches The controls available on this list depend on your company permissions and the selected layout. Use the following table to identify the branch that applies to your screen, then return to the procedure that needs that control. | List branch | What you see or use | |---|---| | Table layout is allowed | **Table Layout**, its layout choices, **Columns Chooser**, and **Expand column width** are available. | | The standard layout is selected | **Update Current** and **Delete Current** are disabled for **Standard Layout**. | | Row filtering is allowed | **Filter Row** is available in **Settings**. | | Group filtering is requested | The **Group Panel** is not available on this list. | | **Export** is visible in **Settings** | Use the export choices. | | Import is expected | Import is not available from this screen. | | An import upload surface is reached elsewhere | Upload remains unavailable while uploading is disabled. | ## When a list action goes wrong Use the symptom table to decide what to do when the list request or export does not produce the expected screen. | What you see | What it means | What to do | |---|---|---| | `An error occurred while processing your request` | The list request failed. | Confirm that the list request can be made with your company permissions, then request the list again with **Refresh**. | | The grid shows its empty-state message and count indicator | No invoice rows are available in the response used by the list. | Check the visible filters and clear any applied filter before requesting the list again. | | `NO Data to Export` | The export action has no list data to export. | Return to the list, clear restrictive filters, and confirm that invoice rows are present before selecting **Export** again. | The export dialog result and exported file contents depend on the response after the export request. ## Find and open an invoice Open an existing subscription invoice from its row when you need its read-only billing and amount details. After it opens, continue with [Continue to invoice details](#continue-to-invoice-details). **Prerequisites** - The subscription invoice list is open. - The invoice row is available in the list. **Steps** 1. Identify the invoice from the visible **Company**, **Invoice Date**, **Invoice no.**, **Total amount**, and **Subscription** values. 2. Select the invoice data row. **Result:** The selected subscription invoice opens on its details screen. ## Continue to invoice details The invoice details page is the read-only destination for reviewing invoice values after you select a list row. It owns the billing and amount review rather than invoice editing; the view page does not provide editable invoice fields or invoice save and delete actions. When the details record is available, review the page's **Bill to** and **Details** areas. The details page identifies the **Subscription**, **Interval**, and **Amount**, then shows the invoice amount summary, including **Vat** and **Total**. For field explanations and exit behavior, continue to [Subscription invoice details](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-subscription-invoices-edit-record). The details body appears only when the returned invoice has an identifier. If the invoice record does not satisfy that condition, the details body is not shown. # Subscription invoice details ## Overview A subscription invoice details record is the read-only view of an existing subscription charge. A billing administrator uses it to compare the billed company, subscription terms, VAT, and total before discussing the charge. The page groups the record into **Bill to** and **Details**. **Bill to** identifies the recipient address. **Details** identifies the invoice and subscription, then shows the interval, amount, VAT, and total. | If you need to… | Go to | |---|---| | Find an existing invoice | [Subscription invoices](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-subscription-invoices-view) | | Open an invoice from the list | [Find and open a subscription invoice](#find-and-open-a-subscription-invoice) | | Check the billed company and invoice identity | [Review the invoice details](#review-the-invoice-details) | | Leave the review screen | [Leave the details screen](#leave-the-details-screen) | | Understand a failed request | [When the invoice cannot be loaded](#when-the-invoice-cannot-be-loaded) | ## Prerequisites The details screen loads an existing invoice when the page has a non-zero invoice identifier and the request returns the selected record. When the details open as a standalone page, breadcrumbs and the close control at the upper right of the standalone details screen appear. An embedded version does not use that standalone page layout. ## Find and open a subscription invoice The subscription invoice list is the starting point for locating an existing invoice. Open a record there to review the charge details behind one list row. **Prerequisites** - You have a subscription invoice identifier that is present and non-zero. **Steps** 1. Open the subscription invoice list at [Subscription invoices](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-subscription-invoices-view). 2. Select the row for the invoice you want. The columns shown are **Company**, Invoice date, **Invoice no.**, Total amount, and **Subscription**. ![Identify an invoice row from the list columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e03d42bd162867d24972053ecc8c917f.png) 3. Open the existing invoice record from its list row. 4. Confirm that the subscription invoice details screen opens for the selected record. The list opens the selected invoice in its details screen. **Result:** The selected invoice details screen is open when the request returns the selected record. ## Review the invoice details A subscription invoice details screen is a read-only billing record. Use it to compare the party billed, the subscription line, and the amount summary before discussing the charge. ### Billing identity Use **Bill to** and the following values to check that the charge belongs to the right billing record. | Check | What to read | |---|---| | Billing address | **Bill to** | | Invoice identity | **Invoice Number** | | Issue date | **Invoice Date** | | Customer identity | Customer number | | Customer domain | Domain name | ### Subscription line The subscription line connects the charge to its subscribed plan and billing period. Check these columns together rather than relying on the amount alone. | Column | What it identifies | |---|---| | **Subscription** | The subscription plan on the invoice | | **Interval** | The subscription billing interval | | **Amount** | The amount for the subscription line | ### Amount summary Compare the summary values to understand how the total is built. Subtotal is shown first, **Vat** shows the VAT amount and percentage, and Total in currency is the final displayed amount. | Summary value | Use it to check | |---|---| | Subtotal | The amount before VAT | | **Vat** | The VAT amount and VAT percentage | | Total in currency | The total after VAT, in the invoice currency | The VAT amount is calculated from the VAT percentage and the pre-VAT amount: VAT percentage × pre-VAT amount ÷ 100. The record also carries the currency code and currency symbol used by the invoice. ## Leave the details screen When the details screen is displayed as a standalone page, its exit surface includes the **Dwonload** action and the close control at the upper right. **Prerequisites** - You have finished checking the invoice values. **Steps** 1. Optional: Select **Dwonload** if you need the available download action. 2. Select the close control at the upper right of the standalone details screen. 3. If the shared popup opens with the title **Leaving Page** and the prompt **Do you want to save your changes?**, select the action that matches your need. | If you need to… | Select | |---|---| | Leave without saving | **Don't Save** | | Save before leaving | **Save** | | Remain on the current screen | **Cancel** | The shared popup makes **Don't Save** available for an exit form. It makes **Save** available for an exit form or completed task, and **Cancel** available for a completed task. **Result:** The available exit action or popup choice has been selected. ## When the invoice cannot be loaded When the invoice request fails, the request error path displays: `An error occurred while processing your request`. ## What to do next After you review the invoice, continue with the [Subscription invoices](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-subscription-invoices-view) list to find another invoice. # Branches ## Branches The **Branches** configuration list contains your company’s branch records. Use it to find an existing branch, open its record, or start a new branch configuration. A branch record is the company information maintained for one branch. After this definition, “branch” means that record unless the text names a list or form. | If you need to… | Go to | |---|---| | Check whether the list and **New** action are available | [Before you start](#before-you-start) | | Prepare the information needed for branch work | [Prerequisites](#prerequisites) | | Find a branch or start a new record | [Find and open a branch](#find-and-open-a-branch) | | Understand the list actions | [List tools and branch actions](#list-tools-and-branch-actions) | | Identify a field or its rule | [Understand the branch information](#understand-the-branch-information) | | Review controls that appear for saved branches | [Handle new and existing branch variations](#handle-new-and-existing-branch-variations) | | Enter values and save a branch | [Enter and save branch information](#enter-and-save-branch-information) | | Correct a message from the list or form | [When validation or saving goes wrong](#when-validation-or-saving-goes-wrong) | | Continue on a branch record or logo page | [Continue from the branch record](#continue-from-the-branch-record) | | Create a branch | [New branch](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-new) | | Maintain an existing branch | [Edit branch](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-edit-record) | | Maintain a branch logo | [Edit branch logo](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-edit-record-2) | | Open the company configuration area | [Configuration home](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) | The Branches page is the configuration list for branch records. The list can show configured captions such as **Branch Name**, **Country**, **City**, **Managing Director**, **Financial Year Start**, and **Reference Currency**, together with a main-branch indicator. The list shows five rows and a count of `5`; its visible columns include **Branch Name**, **Country**, and **Mail**. Use the column headers visible in the list to identify the information available there. ![The Branches list with its row count, visible columns, and New action](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/147982755e1b20cc929f4338e19b91a5.png) ## Before you start Branches subscription and company access determine whether you can work with branch records. The branch count also determines whether **New** opens a form or takes you to the subscription-upgrade surface. | Condition | What you see or can do | |---|---| | Branches subscription is included | The Branches list and branch form are available when the other access conditions are met. | | Branches subscription is not included | The list and form are replaced by the subscription-upgrade surface. | | Your access allows a new branch and the branch limit is not exceeded | **New** opens the new-branch form. | | The branch limit is reached | **New** opens the upgrade flow instead of the new-branch form. | > **Note:** The branch count determines whether **New** opens the new-branch form or the upgrade > flow. If the action opens the upgrade flow, use the subscription surface. #### Prerequisites Branch-list work starts with signed-in company configuration access and the branch information you need to review or record. Have the following ready before you open a form. | Have or confirm | Why it matters | |---|---| | Branches subscription | Without it, the list and form are replaced by the subscription-upgrade surface. | | Access to company configuration | Access determines whether you can reach and work with the Branches page. | | A new-branch allowance and an available branch slot | These conditions determine whether **New** opens the form or the upgrade flow. | | Branch identity and company details | These values identify the branch and complete its company information. | | Financial-year day and month | **Financial Year Start** is required when its configurable values are empty. | | Reference and local currencies | **Reference Currency** and **Local currency** are required. | | Address information, when an address exists | **Street**, **Zip Code**, **Country**, **State**, and **City** appear with the branch address. | ## Find and open a branch Use the Branches list to identify a branch row, open its existing record, or begin a new branch. The list shows five rows and a count of `5`. **Prerequisites** - You have the Branches subscription and company configuration access. - For a new branch, your account can create a branch and the branch limit is not exceeded. - For an existing branch, the branch row is present in the list. **Steps** 1. Open [Configuration home](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home). 2. Open the company configuration area. 3. Select **Branches**. 4. Review the visible branch rows and the count above the list. 5. Select **New** when you need to begin a branch record. 6. Confirm that the new-branch form opens. 7. For an existing branch, select its row to open that branch record instead. ![The new-branch form opened from the Branches list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/57801bb382d8a27fb92c56d2ed6bb405.png) **Result:** The new-branch form is open, or the selected existing branch record is open. After opening a branch, continue to the field reference to review its information. ## List tools and branch actions The Branches list combines list-management tools with actions on branch records. Use the toolbar above the list for list work and the actions shown on each branch row for branch work. | Tool or action | Use | |---|---| | **Save Changes** | Use the named list save action when the list provides changes to save. | | **Delete** | Use the named shared action where the active list surface provides it. | | **Export** | Open export choices for Excel or PDF. | | **New** | Open the new-branch form when the branch limit is not exceeded. | | Main-branch status | Identify which row is the main branch. | ### Export the branch list To export the list: **Prerequisites** - The Branches list is open. - The list contains data when you expect an export. **Steps** 1. Select **Export**. 2. Choose the required Excel or PDF option. 3. Confirm the export action in the dialog. If the list has no data to export, the message is `NO Data to Export`. **Result:** The selected export action is confirmed, or the list shows `NO Data to Export`. ### Make a branch the main branch To make a branch the main branch: **Prerequisites** - The Branches list is open. - The branch row is not the current main branch. **Steps** 1. Open the row’s main-branch action. 2. Select **Yes** in the confirmation when you intend to make the row the main branch. 3. Select **Cancel** when you do not want to continue. The confirmation path returns `Data Saved Successfully`. **Result:** The main-branch action is confirmed or cancelled; a confirmed action returns `Data Saved Successfully`. ![A branch row with its main-branch status and confirmation choices](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/27801caf413f79f12c9395eac4020bad.png) After reviewing list actions, continue to the field reference to identify the values used on a branch record. The branch row does not offer an active delete dropdown. Use the active list actions and the branch record pages linked from this page instead. ## Understand the branch information A branch record brings together the branch identity, company and registration details, financial year, currencies, address, contacts, margins, and modification history used in company configuration. ### Field reference | Area | Field | Type and rule | |---|---|---| | Identity | **Display Name** | Text. Required when empty where the company configuration makes the requirement applicable. | | Identity | **Full Name** | Text. No required marker is shown. | | Identity | **Statement** | Text. No required marker is shown. | | Company | **Managing Director** | Text. No required marker is shown. | | Registration | **Company Registration No.** | Text. No required marker is shown. | | Registration | **VAT ID Number** | Text. No required marker is shown. | | Tax | **VatRate** | Number from `0` through `100`. | | Financial year | **Financial Year Start** | Select a day and month. Required when empty where the configuration makes the requirement applicable. | | Currency | **Reference Currency** | Required select. The options include `United Arab Emirates Dirham`, `Kwait Dinar`, `Euro Member Countries`, `United Kingdom Pound`, `China Yuan Renminbi`, `United States Dollar`, `Egypt Pound`, `Qatari Riyal`, and `Saudi Arabian Rial`. | | Currency | **Local currency** | Required select. Choose from the available currency list. | | Address | **Street** | Text. Appears when the branch has an address. | | Address | **Zip Code** | Number. Appears when the branch has an address. | | Address | **Country** | Select. The options include `Angola`, `Anguilla`, `Åland Islands`, `Albania`, `Andorra`, `Netherlands Antilles`, `United Arab Emirates`, `Argentina`, `Armenia`, `American Samoa`, `Antarctica`, `French Southern Territories`, `Antigua and Barbuda`, and `Australia`. | | Address | **State** | Text. Appears when the branch has an address. | | Address | **City** | Text. Appears when the branch has an address. | The new-branch form shows required markers on **Display Name**, **Financial Year Start**, **Reference Currency**, and **Local currency**. The other labelled fields shown above have no required marker. For **Financial Year Start**, the day values are `1` through `31`, and the month values are `January`, `February`, `March`, `April`, `May`, `June`, `July`, `August`, `September`, `October`, `November`, and `December`. The list has no fixed set of statically named data columns. Work from the headers visible in the list. Additional contact values, margin controls, log-history filters, and file inputs appear in the branch forms. After identifying the fields, use the next section to distinguish the areas available on a new branch from those available after saving. ## Handle new and existing branch variations The branch form changes when the record is new or saved, when you select a saved-record area, and when you choose a margin type. These variations determine which branch information is available at that moment. | Branch situation or choice | What appears | |---|---| | Branch subscription is not included | The subscription-upgrade surface replaces the branch body. | | `CompanyBranchID` is not present | **Default** and **Last Modifications** are unavailable. | | `CompanyBranchID` is present | **Default** and **Last Modifications** appear for the saved branch. | | **Default** is selected | The default-margin area and its **Save** action appear. | | **Last Modifications** is selected | The log-history area appears with dated audit entries by users. | | Fixed margin type is selected | Fixed-percentage controls appear. | | Accumulative margin type is selected | Accumulative/degressive margin controls appear. | | Decreased margin type is selected | Decreased/degressive margin controls appear. | | An existing branch is available | **Attach** can be used in the logo-upload surface. | Contact entries can be added with **Phone**, **Fax**, **Mobile**, **Email**, **Website**, and **Online Support**. The available saved-record areas are **Default** and **Last Modifications**. The **Registrations** tab, **Reference Commission**, **Reference Margin**, and the cumulative-margin currency control do not appear as available branch surfaces. ![The saved branch Default area with margin choices and controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/4de3841a17f25738394149e9925edf3b.png) The shared popup import surface belongs to the application’s shared import feature. Its generic actions are outside the Branches list procedure. After checking which areas are available, enter the branch values and choose a save action. ## Enter and save branch information Use the new-branch form to enter the branch record, add the contact entries that apply, and choose the save action for the result you need. The same named save controls are used when maintaining an existing branch. **Prerequisites** - The Branches list is open and **New** is available, or an existing branch record is open. - You have the branch identity, company, financial-year, currency, address, and contact values. - The required values are ready: **Display Name** when applicable, both parts of **Financial Year Start**, **Reference Currency**, and **Local currency**. | If you need to… | Follow the related steps | |---|---| | Create a branch | Use steps 1 through 11, beginning with **New**. | | Maintain an existing branch | Start at step 2, then use steps 3 through 11 for the values you are changing. | | Save and remain on the record | Use step 10 and select **Save**. | | Save and leave the record | Use step 11 and select **Save and Close**. | **Steps** 1. Select **New** to open the new-branch form when you are creating a branch. 2. Enter the branch identity and company values in the labelled fields. 3. Enter a **VatRate** from `0` through `100` when a tax rate applies. 4. Select a day and month in **Financial Year Start**. 5. Select a value in **Reference Currency**. 6. Select a value in **Local currency**. 7. Enter the address values in **Street**, **Zip Code**, **Country**, **State**, and **City** when the branch has an address. 8. Select one of **Phone**, **Fax**, **Mobile**, **Email**, **Website**, or **Online Support** to add a contact entry. 9. Enter the contact value in the field added for that contact type. 10. Select **Save** to save the branch and remain on the record. 11. Select **Save and Close** when you want to save the branch and leave the record. | If you need to… | Select | |---|---| | Save and remain on the branch record | **Save** | | Save and leave the branch record | **Save and Close** | | Upload a branch logo | **Attach** in the logo-upload surface | After a branch save, the message is `Branch saved Successfully`. The default-margin area has its own **Save** action and returns `Data saved Successfully` when its margin data is saved. The passing surface test opened the form and confirmed its fields without submitting it. ![The new-branch form with required fields, contact choices, and save actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/57801bb382d8a27fb92c56d2ed6bb405.png) **Result:** The branch information is entered and submitted through the selected save action; a successful branch save uses `Branch saved Successfully`. After saving, use the exact message to resolve any validation or save problem before continuing. ## When validation or saving goes wrong Use the exact message on screen to choose the supported correction or follow-up. | Message | Where it applies | What to do | |---|---|---| | `Forbidden characters detected. Please remove them and try again.` | Branch-list filtering | Remove the forbidden characters and try the filter again. | | `NO Data to Export` | Export | Review the list contents before exporting. | | `Data Importing completed` | Import | Continue from the completed import surface. | | `Data Saved Successfully` | List save or main-branch confirmation | Continue after the list action returns this message. | | `Data Deleted Successfully` | Named shared delete action | Continue only when the intended delete action returns this message. | | `Branch saved Successfully` | Branch form save | Continue from the branch record after the save message appears. | | `Branch does not exist` | Branch form lookup | Return to the Branches list and open an existing branch or start a new one. | | `Please insert degressive margin list` | Decreased/degressive margin save | Add the required degressive margin list before saving the margin settings. | | `Data saved Successfully` | Default-margin save | Continue from the saved default-margin area. | | `Error while saving data ` | Margin save | Review the margin information and select **Save** again. | | `Logo Deleted Successfully` | Logo deletion | Continue with the branch record or attach another logo. | ## Continue from the branch record The Branches list hands work to the page that owns the selected branch record. A new action opens the new record; a saved record exposes **Default** and **Last Modifications**; the registered logo variant owns the branch-logo work. | If you need to… | Continue to… | |---|---| | Create a branch from the new record | [New branch](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-new) | | Maintain an existing branch | [Edit branch](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-edit-record) | | Maintain the branch logo | [Edit branch logo](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-edit-record-2) | | Return to the branch list | [Branches](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-view) | **Prerequisites** - For an existing record, select a saved branch row. - For a new record, have **New** available and the required branch information ready. **Steps** 1. Select **New** when you need the new-branch page. 2. Select an existing branch row when you need its edit record. 3. Select **Default** on a saved branch to review default-margin settings. 4. Select **Last Modifications** on a saved branch to review recorded changes. 5. Open [Edit branch logo](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-edit-record-2) when the branch-logo record page is the next task. **Result:** The page that owns the next branch task is open. Use the linked page that matches the task you selected; return to this list when you need another branch. ## Out of scope on this page The following surfaces are not available for Branches list work on this page: - The list delete dropdown is not active on a branch row. - The **Registrations** tab does not appear. - **Reference Commission** and **Reference Margin** do not appear. - The cumulative-margin currency control does not appear. - Generic shared-popup actions are outside the Branches list’s owned work. Use the visible list headers, controls, and messages when working in your own company configuration. # New branch A branch record stores the company information used to identify and administer one branch. New branch is the company-administration screen where you enter that record before reviewing or editing it. | If you need to… | Go to | |---|---| | Work with the branch list | [Branches](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-view) | | Continue editing an existing branch | [Existing branch](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-edit-record) | | Review the branch-logo edit-record variant | [Branch logo](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-edit-record-2) | ![The healthy New branch form with its main fields and save actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/73d408b879290325385052eb7e5fcc88.png) ## Before you start The branch form is the company-administration entry point for creating a branch record. Your subscription and access determine whether the form is available; the branch data and required values determine whether it can be saved. Prerequisites | Have or confirm | Why it matters | |---|---| | Signed-in company-administration access | Use the signed-in application to open the branch area. | | Branch configuration included in your subscription | The branch form is available when your subscription includes branch configuration. | | The branch record is available on the page | The main form appears only when the branch exists. | | A value for **Display Name** when the branch name is empty | **Display Name** is required under that company configuration. | | A day and month for **Financial Year Start** when either value is empty | Each part of **Financial Year Start** is required under that company configuration. | | Values for **Reference Currency** and **Local currency** | Both controls are required. | | The branch identity, registration, financial-year, currency, address, and contact information | These values complete the information areas on the form. | On the available live form, **Display Name**, **Financial Year Start**, **Reference Currency**, and **Local currency** carry required markers. The remaining fields are optional. **Save** and **Save and Close** are available for a new branch when editing is allowed or when a new branch is allowed and the branch ID is zero. ## Find and open the branch screen The branch area is where you start a new branch or return to an existing branch for comparison and continued editing. Use [Branches](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-view) to locate those records. Prerequisites - You have the company-administration access described in [Before you start](#before-you-start). - You know whether you are starting a new branch or continuing an existing one. Steps 1. Open [Branches](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-view). 2. Choose the path that matches your task. | If you need to… | Do this | |---|---| | Start a new branch | Start a new branch from the branch area. | | Continue an existing branch | Open its branch record from the branch list. | 3. Confirm that the branch form is open. ![The open New branch form with its main fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/57801bb382d8a27fb92c56d2ed6bb405.png) **Result:** The branch form is open with **Save** and **Save and Close** available, or the existing branch record is open for review or continuation. ## Understand the branch information A branch record brings together the identity, legal registration, financial-year, currency, address, and contact information that people use to administer that branch. Use the field labels below to identify the information areas on the form. | Information area | Control | What to enter or select | |---|---|---| | Identity | **Display Name** | The branch name. It is conditionally required when the branch name is empty, and pattern validation applies. | | Identity | **Full Name** | The branch's full name. Pattern validation applies. | | Identity | **Statement** | The branch statement text. | | Identity | **Managing Director** | The managing director's name or details. | | Registration | **Company Registration No.** | The company registration number. | | Registration | **VAT ID Number** | The VAT identification number. | | Tax | **VatRate** | A number from `0` through `100`. | | Financial year | **Financial Year Start** | A day and a month for the start of the financial year. Both are conditionally required when empty. | | Currency | **Reference Currency** | Select from the available currency values. The control is disabled when the branch has jobs. | | Currency | **Local currency** | Choices come from the company-currency list. | | Address | **Street** | The street address. The address area requires an address record. | | Address | **Zip Code** | The postal or ZIP code. | | Address | **Country** | The country from the country list. | | Address | **State** | The state or region. | | Address | **City** | The city. | For **Financial Year Start**, choose from these values: | Part | Choices | |---|---| | Day | `1` through `30` | | Month | `January`, `February`, `March`, `April`, `May`, `June`, `July`, `August`, `September`, `October`, `November`, or `December` | The contact area starts with **Contact Information**. Select it to open the contact choices, then choose the contact field you need. | Contact choice | Field added | |---|---| | **Phone** | A phone contact field | | **Fax** | A fax contact field | | **Mobile** | A mobile contact field | | **Email** | An email contact field | | **Website** | A website contact field | | **Online Support** | An online-support contact field | Contact entries repeat from the branch's contact information list. Phone, fax, and mobile values accept up to 20 characters and use the field's validation key handler. ![The Contact Information choices open above the branch form](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c06704bd038853a76aa842a608630015.png) ## Complete and save branch information Enter the branch information and select a save action to create the branch record. Prerequisites - The New branch form is open. - You have the values described in [Understand the branch information](#understand-the-branch-information). Steps 1. In **Display Name**, enter the branch name when the branch name is empty. 2. Enter the branch's full name in **Full Name**. 3. In **VatRate**, enter a value from `0` through `100` when a tax rate applies. 4. In **Financial Year Start**, select the day and month. | Part | Choices | |---|---| | Day | `1` through `30` | | Month | `January` through `December` | 5. Select values in **Reference Currency** and **Local currency**. 6. Select a value in **Country**. 7. Select **Contact Information**. 8. Select a contact choice. | If you need to add… | Select | |---|---| | A phone contact | **Phone** | | A fax contact | **Fax** | | A mobile contact | **Mobile** | | An email contact | **Email** | | A website contact | **Website** | | An online-support contact | **Online Support** | 9. Enter the contact value in the field that the selected contact choice adds. 10. Choose one save action. | If you need to… | Select | |---|---| | Save the branch and remain on the page | **Save** | | Save the branch and request the close action | **Save and Close** | After a successful branch save, the application uses the message `Branch saved Successfully`. Leaving the page with unsaved changes prompts you with `Do you want to save your changes?`. **Result:** The branch information is submitted through the selected save action; the success message is `Branch saved Successfully` when the save succeeds. ## Handle new and existing branch variations The branch screen changes after a branch has an ID and when you select different configuration panels. A new branch begins with the main information form; a saved branch exposes review and history controls. | Situation | What appears | |---|---| | The branch is new | **Default** and **Last Modifications** are not available. | | The branch is saved | **Default** and **Last Modifications** become available. | | The default-margin selection is active | The default-margin panel appears. | | The log-history selection is active | The log-history panel appears. | | The fixed-percentage selection is active | A fixed margin field appears. | | `Descending Accumulative` or `Descending Absolute` is active | The corresponding margin fields appear in the default margin panel. | | The branch has a logo | The logo-delete icon is shown. | | The branch exists | The logo-upload icon is shown. | | The logo upload is ready | Select **Attach** in the upload component to complete the upload. | Select **Default** to open the default margin panel. Select **Last Modifications** to open the change-history panel. The default margin panel has its own **Save** action. The margin area includes neither **Registrations** nor a currency choice. ## When validation or saving goes wrong The following table matches the messages associated with this page to the action that can resolve or contain the problem. | Message | When to act | Reader action | |---|---|---| | `Name is required` | The branch name is empty where **Display Name** is required. | Enter a value in **Display Name**. | | `Just '_' '-' And '.' Characters Accepted` | The name pattern rejects the entered value. | Correct **Display Name** or **Full Name** to a value accepted by the field pattern. | | `required` | A required **Financial Year Start** value is empty. | Select both the day and month for **Financial Year Start**. | | `Branch does not exist` | The branch lookup does not find the branch record. | Return to the branch area and open or start the branch again. | | `Please insert degressive margin list` | A degressive margin selection has no margin list. | Add the degressive margin list before saving that margin configuration. | | `Error: Server Error` | The logo operation reports a server error. | Review the logo information before continuing. | | `Error while saving data ` | Saving margin data reports an error. | Review the margin information before saving again. | | `Do you want to save your changes?` | Leaving with unsaved changes invokes the unsaved-change prompt. | Choose the dialog action that matches whether you want to keep or discard the changes. | | `Are you sure you want to delete this item?` | A delete action requests confirmation. | Confirm only when you intend to delete that item. | | `Logo Deleted Successfully` | The logo deletion succeeds. | Continue with the branch record or upload another logo. | | `Data saved Successfully` | Default margin data saves successfully. | Continue reviewing the saved margin configuration. | ## Out of scope The shared popup import flow belongs to the application's shared import feature, not to this branch creation and branch-edit page. Its generic upload and import controls are therefore outside this page. The following surfaces are also outside the branch information covered here: - The nominal percentage controls are disabled by the page condition and do not appear. - The `Registrations` tab does not appear. - Bank-account controls are commented out rather than available branch controls. - Some icon-only actions have no visible label. ## Continue from the branch record A saved branch is the record you return to when you need to review its information or continue editing its configuration. The saved record exposes **Default** and **Last Modifications** for those follow-up views. Prerequisites - The branch information has been submitted through a save action. - You know whether you want the branch list or an existing branch record. Steps 1. Return to [Branches](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-view) to review the branch list. 2. Open the saved branch record when you need to compare or edit its information. 3. Select **Default** to review the default margin panel. 4. Select **Last Modifications** to review the change-history panel. **Result:** You are back at the branch list or an existing branch record with the available review panels. # Edit branch ## Before you start An existing branch is a branch record already present in the company configuration. Use this page to maintain its information and save the changed record. The edit record opens from the branch list. It contains the branch form, contact information, saved-record areas, and default-margin settings for the selected branch. | If you need to… | Go to | |---|---| | Open an existing branch from the list | [Branches](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-view) | | Review the branch form and its fields | [Branch information fields](#branch-information-fields) | | Maintain contacts or the branch logo | [Maintain branch details and contacts](#maintain-branch-details-and-contacts) | | Review saved areas and margins | [Review saved areas and default margins](#review-saved-areas-and-default-margins) | | Correct a validation or save problem | [Fix validation and save problems](#fix-validation-and-save-problems) | | Create a branch that does not exist yet | [New branch](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-new) | | Maintain the existing branch logo on its registered page | [Edit branch logo](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-edit-record-2) | ## Find and open the branch The **Branches** list is the entry point for selecting the branch record to edit. Prerequisites - Sign in to the application. - Confirm that the branch already exists in **Branches**. - Have edit permission for the branch, or new permission with the branch ID set to `0`. Steps 1. Open **Configurations** > **Company** > **Branches**. 2. Select the data row for the branch you want to maintain. 3. Select the row's edit action. **Result:** The selected branch edit screen is open. ## Understand the branch information The branch edit screen is a form for maintaining one existing branch record. The main form contains branch identity, registration, financial-year, currency, address, and contact information. | Area | What you use it for | |---|---| | Main branch form | Maintain branch information before saving the record. | | **Contact Information** | Add a **Phone**, **Fax**, **Mobile**, **Email**, **Website**, or **Online Support** contact. | | **Default** | Open the default-margin panel. | | **Last Modifications** | Open the log-history panel. | | **Save** | Save the branch record and remain on the record. | | **Save and Close** | Save the branch record and return to the previous location. | When a branch logo is present, upload and delete actions appear beside it. ### Branch information fields A configurable field is required only when your company configuration enables that requirement. | Field | Use or rule | |---|---| | **Display Name** | Branch name. It is configurable and has a required validator when empty. | | **Full Name** | Full branch name. Pattern validation applies. | | **Statement** | Branch statement. | | **Managing Director** | Managing director information. | | **Company Registration No.** | Company registration number. | | **VAT ID Number** | Value-added tax identification number. | | **VatRate** | VAT rate from `0` through `100`. | | **Financial Year Start** | Select a day from `1` through `30` and a month from **January** through **December**. Day and month are required when empty under the form validators. | | **Reference Currency** | Required currency selection. It is disabled when the branch has jobs. | | **Local currency** | Select a currency from the available currency list. The choices are company-currency records returned at runtime, and each option displays the record's currency name. This selection is required. | | **Street** | Address street, shown when the branch has an address. | | **Zip Code** | Address postal code, shown when the branch has an address. | | **Country** | Address country, shown when the branch has an address. | | **State** | Address state, shown when the branch has an address. | | **City** | Address city, shown when the branch has an address. | The currency and country choices come from records available to the company at run time. Address fields appear when the branch has an address. > **Note:** Use the branch list to choose a different existing branch. ## Maintain branch details and contacts Contact information identifies the ways colleagues can reach the branch. Use **Contact Information** to add the contact types that apply, then enter each value in its corresponding field. Prerequisites - The existing branch edit screen is open. - You know the branch details and contact values to record. Steps 1. Update the branch detail fields that need to change. 2. Select **Contact Information**. 3. Select the contact type. | If you need to add… | Select… | |---|---| | A telephone number | **Phone** | | A fax number | **Fax** | | A mobile number | **Mobile** | | An email address | **Email** | | A website | **Website** | | Online support details | **Online Support** | 4. Enter the contact value in its corresponding field. 5. For a **Phone**, **Fax**, or **Mobile** value, keep the value within the maximum length of `20`. 6. If you need to maintain the logo, select the upload icon and use **Attach** in the upload surface. 7. If you need to remove the logo, select the delete icon beside the branch logo. 8. Confirm the deletion when the application asks `Are you sure you want to delete this item?`. **Result:** The changed details, applicable contact values, and completed logo operation are prepared on the branch record. ## Review saved areas and default margins Saved areas show the branch's default-margin settings or recorded modifications. A default margin defines the margin choice used for the branch; the available child controls depend on that choice. When the branch has a company-branch ID, select **Default** for the default-margin panel or **Last Modifications** for the log-history panel. The **Registrations** tab, nominal commission, and nominal margin controls are not available on this screen. | Choice or area | What appears | |---|---| | **Default** | The default-margin panel. | | **Last Modifications** | The log-history child area. | | Fixed margin choice | A fixed-percentage choice and its fixed margin value field. | | Descending absolute choice | The descending-absolute option. | | Descending accumulative choice | The descending-accumulative option. | | Accumulative or decreased-percentage choice | The degressive-margin child area. | The fixed margin value accepts `0` through `100` and appears only for the fixed-percentage choice. The degressive-margin child appears for accumulative or decreased-percentage choices. The accumulative-margin area does not offer a currency choice on this screen. ![The saved-record tabs and default-margin choices](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/27801caf413f79f12c9395eac4020bad.png) ## Fix validation and save problems Use the message on screen to locate the correction. | Message | What to do | |---|---| | `Name is required` | Enter a value in **Display Name** before saving. | | `Just '_' '-' And '.' Characters Accepted` | Correct the name so it satisfies the name pattern. | | `required` | Complete the financial-year day or month that is empty. | | `Branch does not exist` | Return to **Branches** and open an existing branch row. | | `Please insert degressive margin list` | Add the required degressive margin list before saving the margin values. | | `Error: Server Error` | Check the record and retry after the server error is resolved. | | `Error while saving data ` | Check the values and save again. | | `Are you sure you want to delete this item?` | Confirm only when you intend to remove the logo item. | | `Logo Deleted Successfully` | The logo deletion completed. | If no success message appears and the record does not change, verify the values and retry the applicable save action rather than treating the save as complete. ### Save branch changes Use the table to choose the save action that matches where you want to continue. | If you need to… | Select… | Then confirm… | |---|---|---| | Save and remain on the branch record | **Save** | `Branch saved Successfully` | | Save changed default-margin values | The margin area's **Save** action | `Data saved Successfully` | | Save the branch and leave the record | **Save and Close** | `Branch saved Successfully` | Prerequisites - The branch details and contacts are complete. - Any changed default-margin values are complete. - The form has no validation message. Steps 1. Select the save action from the table that matches where you want to continue. 2. Confirm the corresponding success message from the table. The unsaved-change guard applies when leaving the edit screen. If a save does not show its success message, correct the displayed problem and repeat the applicable save action. **Result:** **Save** keeps you on the branch record with the changed values submitted. **Save and Close** returns you to the previous location after submitting the changed record. ## Continue after editing After the record is saved, continue from the saved branch outcome. | If you need to… | Continue to… | |---|---| | Review or select another branch | [Branches](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-view) | | Create a branch that does not exist | [New branch](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-new) | | Maintain the existing branch logo | [Edit branch logo](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-edit-record-2) | # Edit branch logo ## Edit branch logo An existing branch record holds the branch information used in company administration, together with its logo, contact information, address, currency, margin settings, and modification history. Use this page to update the record, change or remove its logo, and save the result. A logo is the image associated with the branch record. | If you need to… | Go to | |---|---| | Open an existing branch | [Find and open the branch](#find-and-open-the-branch) | | Change or remove the logo | [Add, replace, or remove the logo](#add-replace-or-remove-the-logo) | | Change branch, address, currency, or contact information | [Branch fields](#branch-fields) and [Save branch and contact changes](#save-branch-and-contact-changes) | | Review default-margin settings | [Review default-margin settings](#review-default-margin-settings) | | Read recorded changes | [Review history](#review-history) | | Create a branch that does not exist yet | [New branch](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-new) | | Work from the branch list | [Branches](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-view) | | Continue with the general existing-branch page | [Edit branch](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-edit-record) | ## Before you start The edit page works on a saved branch record. The branch must already exist, and the page must load the branch together with an included subscription before the record form and its lower review areas are available. **Prerequisites** - Have the branch you need to change already saved. - Have a subscription included for the page to display the branch body. - Have the branch identifier available through the branch record before using the lower tabs. - Have the branch information, contact values, address values, currency choices, and logo file you intend to use. Open the branch from the **Branches** list to work on an existing record. The branch form requires both an included subscription and a branch; the lower tabs require the branch identifier. ## Find and open the branch The **Branches** page is the list used to select an existing branch before you edit its record. **Prerequisites** - Have a saved branch to open. **Steps** 1. Open **Configurations**. 2. Open **Company**. 3. Select **Branches**. 4. In the branch list, select the row for the branch you want to edit. 5. Select the row's edit link to open the existing-branch record. The **Branches** list uses **Branch Name**, **Country**, and **Mail**. Its available list actions include **New**, **Branches**, **Refresh**, **Table Layout**, and **Settings**. Select the edit link in the row for the branch you need. ![Select the branch row from the Branches list before opening its edit record.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/27801caf413f79f12c9395eac4020bad.png) **Result:** The selected branch's edit record is open. With the record open, first identify the fields and conditional areas, then make the required branch or logo changes. ## Understand the branch screen The branch screen is a form for one existing branch. Its upper area contains the main branch information and the logo actions; its lower area contains contact information and saved-record review tabs. The screen has 29 controls, two containers, one validation group, and 40 actions. Work from form fields and tabs; this screen does not present a data grid. | Area | What to use it for | |---|---| | Branch information form | Maintain identity, company, tax, financial-year, currency, and address values. | | Logo actions | Upload a logo or remove the current logo when the corresponding branch value exists. | | **Contact Information** | Maintain the branch's repeated contact values. | | **Default** tab | Review the saved branch's default-margin area. | | **Last Modifications** tab | Read the branch's recorded changes. | | **Save** | Save the changed record and remain on the record. | | **Save and Close** | Save the changed record and return to the previous location. | The lower review tabs appear for a saved branch with the branch identifier. The tabs are **Default** and **Last Modifications**. Use the field reference before moving to the conditional areas below it. ### Branch fields Branch fields identify the branch and supply the company, tax, financial-year, currency, and address information used by the record. | Group | Field | Rule or option source | |---|---|---| | Identity | **Display Name** | Required only when the value is empty and the configuration makes it applicable. | | Identity | **Full Name** | No required rule is named. | | Identity | **Statement** | No required rule is named. | | Company | **Managing Director** | No required rule is named. | | Company | **Company Registration No.** | No required rule is named. | | Tax | **VAT ID Number** | No required rule is named. | | Tax | **VatRate** | Accepts values from `0` through `100`. | | Financial year | **Financial Year Start** | The day and month are configurable when empty. | | Currency | **Reference Currency** | Required; disabled when jobs exist. Options come from the returned company-currency records and display `Name` while storing `CurrencyCode`. | | Currency | **Local currency** | Required. Options come from the returned company-currency records and display `Name` while storing `CurrencyCode`. | | Address | **Street** | Appears when the branch has an address. | | Address | **Zip Code** | Appears when the branch has an address. | | Address | **Country** | Appears when the branch has an address. Options display `Name` and store `CountryCode`. | | Address | **State** | Appears when the branch has an address. | | Address | **City** | Appears when the branch has an address. | For **Financial Year Start**, the day choices are `1` through `31`. | Month choices | |---| | **January**, **February**, **March**, **April** | | **May**, **June**, **July**, **August** | | **September**, **October**, **November**, **December** | ### Tabs and conditional areas The lower areas appear according to the saved branch and its values. The **Default** tab is the default-margin review area, and **Last Modifications** is the history area. Address fields require `branch.Address`; contact rows repeat from `branch.ContactInfoList`. | Area | When it appears | |---|---| | Address fields | When the branch has `Address`. | | Contact rows | For the values in `ContactInfoList`. | | Default-margin number box | For the fixed-percentage margin type. | | Degressive margin area | For accumulative or decreased-percentage margin types. | | Saved-record tabs | When the branch has the branch identifier and the page body has a branch with an included subscription. | The active saved-record tab is **Default** for the default-margin area or **Last Modifications** for the history area. After checking which areas are present, continue to maintain the logo and branch values. ## Maintain the logo and branch changes Maintain the logo from the record context while updating branch values, so both changes apply to the same branch. **Prerequisites** - Have the existing branch open. - Have an image file ready if you are adding or replacing the logo. **Steps** 1. Enter the branch values you need to change in the main form. 2. Choose one logo operation in [Add, replace, or remove the logo](#add-replace-or-remove-the-logo). > **Note:** The **Upload Logo** surface accepts one image file. It provides **Attach** and > **Browse** for the file choice. The delete action is available only when the branch has a > logo identifier. **Result:** The branch values remain in the open record, and the selected logo operation is ready to complete or has completed. Use the operation table below when you need a specific add, replace, or remove path. ### Add, replace, or remove the logo Use the logo operation that matches the state of the branch: attach an image to add a logo, attach another image to replace the current one, or confirm deletion to remove it. **Prerequisites** - Have the branch edit record open. - Have one image file ready for an add or replace operation. | If you need to… | Use this operation | |---|---| | Add a logo to a branch without one | In the logo area, select the control that opens the upload surface, then use **Attach** and **Browse** to choose one image file. | | Replace the current logo | In the logo area, select the control that opens the upload surface, then attach the replacement image as one file. | | Remove the current logo | Select the control immediately beside the current logo to open the removal confirmation. | **Steps** 1. Choose one operation: | If you need to… | Do this | |---|---| | Add or replace the logo | In the logo area, select the control that opens the upload surface. | | Remove the logo | In the logo area, select **Delete item**. | 2. If you are adding or replacing the logo, select **Attach**. 3. If you are adding or replacing the logo, select **Browse**. 4. If you are adding or replacing the logo, choose one image file. 5. If you are removing the logo, read `Are you sure you want to delete this item?`. 6. If you are removing the logo, select **Yes** to confirm the removal. 7. If you are cancelling the removal, select **No**. For a confirmed removal, the logo is removed and `Logo Deleted Successfully` appears. Cancelling with **No** leaves the logo in place. **Result:** The branch has the attached image, retains its existing logo, or has the logo removed after the confirmation choice. After the logo operation, continue to save the branch and contact changes. ### Save branch and contact changes Saving commits the changed branch record, including branch fields, address, currency, and contact information. The contact choices are **Phone**, **Fax**, **Mobile**, **Email**, **Website**, and **Online Support**; phone, fax, and mobile values have a maximum length of 20. **Prerequisites** - Complete the branch changes you want to keep. - Resolve any logo confirmation before saving. | If you need to… | Select | |---|---| | Save and continue working on this record | **Save** | | Save and leave the record | **Save and Close** | **Steps** 1. Select **Save** to remain on the branch record or **Save and Close** to leave it. 2. Read `Branch saved Successfully`. **Result:** **Save** keeps you on the record. **Save and Close** returns you to the previous location after the branch changes are saved. After saving, review the **Default** margin area or **Last Modifications** history as needed. ## Review the margin and history branches The saved branch record has two review routes: **Default** for default-margin settings and **Last Modifications** for recorded changes. Both routes belong to the saved branch and are available through the lower tabs when the branch has the branch identifier. The saved-record tabs are **Default** and **Last Modifications**. A **Registration** tab is declared in the source but is not available as a branch review area. ### Review default-margin settings Default-margin settings describe the margin method used as the branch's default. Select the margin type to see the controls associated with that method. **Prerequisites** - Have the branch saved. - Open the **Default** tab. | Margin type | Area available | |---|---| | **Fixed Percentage** | A default-margin number box. | | **Descending Absolute** | The degressive margin area. | | **Descending Accumulative** | The degressive margin area. | The nominal commission and nominal margin controls are not part of the available area. A cumulative-margin currency choice is also not part of the available area. **Steps** 1. Select the margin type you need to review. 2. Read the number box for **Fixed Percentage**, or read the degressive margin area for **Descending Absolute** or **Descending Accumulative**. **Result:** The default-margin controls for the selected margin type are visible. Return to the review-area section to inspect the saved history when that is the next task. ### Review history History is the branch's recorded modification view. Open **Last Modifications** to review the available audit-log entries and filters, then return to **Default** when you need the margin area. **Prerequisites** - Have the branch saved with its branch identifier. **Steps** 1. Select **Last Modifications**. 2. Read the audit-log entries and use the available audit-log filters. 3. Select **Default** to return to the default-margin area. **Result:** The branch's Last Modifications history is open, or the default-margin area is open again. If a save or review action produces a message, use the correction table that follows. ## Resolve validation and action failures Use the message on screen to choose the correction. The table maps each message to the next action. When default-margin data is saved, the message `Data saved Successfully` appears. | Message | Action | |---|---| | `Name is required` | Enter the required name value in **Display Name** and save again. | | `Just '_' '-' And '.' Characters Accepted` | Correct the name so it uses the accepted characters, then save again. | | `Please insert degressive margin list` | Add the required degressive margin list before saving the margin settings. | | `Error: Server Error` | Check the branch values and repeat the action. | | `Error while saving data ` | Review the form and repeat **Save** or **Save and Close**. | | `Branch saved Successfully` | Continue on the record after **Save**, or leave after **Save and Close**. | | `Data saved Successfully` | Continue from the saved default-margin area. | `Name is required` is the required-name validation message. The character message is the corresponding accepted-character validation message. The degressive-margin message appears when the required margin list is missing. ## Out of scope `Branch does not exist` applies when the selected branch is missing, rather than to the editing actions on this existing-branch page. Return to the branch list and open an existing branch record when this message appears. ## Continue after branch editing After saving, the branch record contains the changes you kept. **Save** leaves you on the record for further review. **Save and Close** returns you to the previous location. From there, continue with [Branches](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-view), open [New branch](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-new) when a new branch is needed, or use [Edit branch](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-edit-record) for the general existing-branch editing task. # Product types ## Product types A product type is a company reference entry that identifies a type used when managing product records. The **Product Types** page is in **Configuration** under **Company**. Use this page to find, add, change, delete, or export product types. | If you need to… | Go to | | --- | --- | | Find the list or identify an entry | [Find a product type](#find-a-product-type) | | Read the list and its actions | [Understand the product-type list](#understand-the-product-type-list) | | Add, change, or remove an entry | Maintain product types | | Save the list in another format | [Export the product-type list](#export-the-product-type-list) | | Review the configuration area | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) | | Maintain neighbouring company reference data | [Product categories](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-product-categories) | ## Before you start You need access to the product-type configuration area. Your administrator assigns separate permissions for creating, changing, deleting, and exporting entries. | Before you start | Why it matters | | --- | --- | | Permission to create entries | **New** appears only when your account can create entries. | | Permission to change entries | The **Edit** icon appears only when your account can change entries. | | Permission to delete entries | The **Delete** icon appears only when your account can delete entries. | | Permission and subscription for exports | **Export** appears only when your account has export access and the company subscription includes list exports. | | The product-type name to enter or change | **Save** accepts a non-empty value in **Type**. | The form must finish an earlier save before it accepts another one. Keep the entry information ready before selecting **Save**. > **Note:** The list uses the visible **Name** value to identify an entry. Separate > icons change or delete the entry. ## Find a product type Find the list before choosing a product-type action. **Prerequisites** - You are signed in and can open the company configuration area. - You know enough of the product type to recognise its **Name** value. **Steps** 1. Open **Company** in the configuration area. 2. Open **Configuration**. 3. Select **Product Types**. 4. Check that the heading reads **Product Types**. 5. Use the **Name** column to identify the entry you need. 6. If the list needs reloading, select **Refresh**. 7. If you need list settings, select **Settings**. The list contains six rows. The **New** button is visible when your current permission configuration allows it. ![Find the Product Types heading, the six entries under Name, and the New, Refresh, and Settings controls.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/21f36e67c98ccaadd85c62b86b44c3fd.png) **Result:** The Product Types list is open. Continue to [understand the list](#understand-the-product-type-list), or select **New** to add an entry. ## Understand the product-type list The product-type list is reference data. **Name** is the only visible data column, and the icons beside an entry provide its available actions. | List part | What you use it for | | --- | --- | | **Keyword to Search...** | Enter a keyword to search the list. | | **Name** | Read the product-type value. | | Entry action icons | Change or delete an entry. | | List editing | Use the page actions to add, change, or delete entries. | ![Search by keyword, read the Name column, and locate the icons beside each entry.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9d5a76f87473267ed874894aa87c843f.png) **Result:** You can select the action that matches your task in Maintain product types. ## Add, change, delete, and export product types Choose the task that matches the entry you need to maintain. | If you need to… | Select | What opens | Access condition | | --- | --- | --- | --- | | Create an entry | **New** | A new product-type form | Create permission | | Change a saved entry | **Edit** icon | The selected entry in the form | Change permission | | Remove a saved entry | **Delete** icon, then **Delete** | The deletion confirmation | Delete permission | | Save a copy of the list | **Export** | The export list dialog | Export access and the company subscription for list exports | The form uses **Type** for the product-type value. ### Add a product type Add a product type when a product record needs a type that is not already in the list. **Prerequisites** - You are on the Product Types list. - **New** is available to you. - You have a non-empty product-type name ready to enter. **Steps** 1. Select **New**. 2. In the active product-type form, enter the value in **Type**. 3. In the save popup, choose one action: | If you need to… | Select | | --- | --- | | Save the entry | **Save** | | Leave without creating the entry | **Cancel** | | Correct an empty value | Enter a value in **Type**, then select **Save** after `Can't save empty items` appears | 4. After saving, look for `Data saved Successfully`. The save action proceeds only when **Type** contains a value and the previous save has finished. ![Select New from the Product Types list to open the entry form.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/21f36e67c98ccaadd85c62b86b44c3fd.png) **Result:** A saved entry is reported with `Data saved Successfully`, or the save popup closes without saving when you select **Cancel**. ### Change a product type Change a product type when its **Name** value needs correction or updating. **Prerequisites** - You are on the Product Types list. - You have identified the entry to change. - **Edit** is available to you. **Steps** 1. Beside the entry you identified, select the **Edit** icon. 2. In the product-type form, change the value in **Type**. 3. Choose one action: | If you need to… | Select | | --- | --- | | Keep the change | **Save** | | Discard the change | **Cancel** | 4. After saving, look for `Data saved Successfully`. **Result:** The selected product type is saved with the changed **Type** value, or the popup closes without saving when you select **Cancel**. ### Delete a product type Delete a product type when the selected entry is no longer needed. **Prerequisites** - You are on the Product Types list. - You have identified the entry to remove. - **Delete** is available to you. **Steps** 1. Beside the entry you identified, select the **Delete** icon. 2. In the delete menu, select **Delete**. 3. Read `Are you sure you want to delete this item?`. 4. Select **Delete** to confirm the deletion. 5. After the deletion completes, look for `Data Deleted Successfully`. **Result:** The selected product type is deleted and `Data Deleted Successfully` appears. ### Export the product-type list Export the product-type list when you need a file version of its entries. **Prerequisites** - You are on the Product Types list. - **Export** is available through export access and the company subscription for list exports. **Steps** 1. Select **Export**. 2. In the `Exporting List:` dialog, choose one format: | If you need… | Choose | | --- | --- | | An Excel file | **Export to Excel** | | A PDF file | **Export to PDF** | 3. In the export dialog, choose one action: | If you need to… | Select | | --- | --- | | Start the export | **Export** | | Leave without exporting | **Cancel** | **Result:** The export dialog closes after you select an export choice and **Export**, or closes without exporting when you select **Cancel**. ## When an action is unavailable Actions appear according to your permissions, company display settings, and subscription access. | What you do not see | Condition that controls it | What to check | | --- | --- | --- | | **New** | Your account cannot create entries | Ask an administrator to grant create access. | | **Edit** icon | Your account cannot change entries | Ask an administrator to grant change access. | | **Delete** icon | Your account cannot delete entries | Ask an administrator to grant delete access. | | Row-filter controls | Row filtering is not enabled in the list settings | Check the list display settings. | | **Export** | Export access or the company subscription for list exports is unavailable | Ask an administrator to check both. | | Import | This list does not provide an import action | Use the available product-type actions instead. | ## When something goes wrong Use the message on screen to choose the next action. The form does not show a separate required-field message beside **Type**. | What you see | What to do | | --- | --- | | `Can't save empty items` | Enter a value in **Type**, then select **Save**. | | An error appears after saving | Read the error details shown by the alert, then correct the reported problem or ask an administrator to review it. | | An error appears after deleting | Read the error details shown by the alert, then verify that the selected entry is still available before trying again. | | No required-field message appears beside **Type** | Use the save result or alert rather than waiting for a separate field message. | If saving or deleting fails, the alert displays the returned error details rather than a fixed product-type message. The screen does not provide a separate validation summary or save-status message for these failures. ## After managing product types After a successful save, look for `Data saved Successfully`. After a successful deletion, look for `Data Deleted Successfully`. Product types are company reference data used while managing products. Continue to Products when you need to apply a product type to a product record, or use [Product categories](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-product-categories) for the neighbouring company reference list. # Frequent currencies Frequent currencies is the company currency-entry configuration. Use it to review, add, change, delete, or export the currency entries available to company and product workflows. Before a branch uses a newly supported currency, add that currency to Frequent Currencies. ## Before you start | If you need to… | Go to | |---|---| | Open the list and check its columns | [Find Frequent currencies](#find-frequent-currencies) | | Understand the fields | [Understand the currency list and form](#understand-the-currency-list-and-form) | | Add or change an entry | [Add or edit a currency](#add-or-edit-a-currency) | | Delete or export entries | [Delete or export currency data](#delete-or-export-currency-data) | | Maintain company flags | [Flags](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-flags) | | Maintain product categories | [Product categories](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-product-categories) | | Use currency data in product work | [Products](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/products) | The subscription feature controls whether the grid and **New** control appear. When the feature is included, the grid and **New** are available; otherwise, the upgrade surface appears. Editing requires edit permission, and deleting requires delete permission. The delete action is available only when more than one item exists. Confirm that the delete action is available before planning a removal. ## Find Frequent currencies Open the list before reviewing or maintaining currency entries. **Prerequisites** - The subscription feature is included when you need the grid and **New** control. **Steps** 1. Open **Configuration**. 2. Open **Company**. 3. Select **Frequent Currencies**. 4. Confirm that the visible list controls include **New**, **Refresh**, and **Settings** when those controls are available on your surface. **Result:** The Frequent currencies list is open with its available list controls visible. ![The Frequent currencies entry point and list toolbar](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d62fcea4ee990a96f2cee4f5f30f96c5.png) ## Understand the currency list and form The list is the review surface for company currency entries. Selecting **New** opens the new currency dialog, which asks for a currency code and name. The list also shows the symbol. The currency picker uses the currency lookup as its source. Each option contains a currency code, name, and symbol, and the picker displays the code followed by the currency name. Selecting a code also sets the record name. The form shows **Code** and **Name**. **Symbol** is visible in the list but is not an editable form field. A configured field appears in the form only when it is enabled for forms. The list shows **Code**, **Name**, and **Symbol**, with nine currency rows. The new currency dialog shows **Code**, **Name**, and **OK**. **Code** and **Name** carry required markers. A loading indicator can remain while list values are already present, so use the visible headers and values when reviewing the list. ![The New Currency dialog with Code and Name fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5932c52f491f93f7114b398757d62a06.png) ### List columns and entry fields | Field | Reader guidance | Required | Visible in list | Visible in form | |---|---|---:|---:|---:| | **Code** | The lookup choice can supply the text shown in the next field. | Yes | Yes | Yes | | **Name** | Review the supplied text, then edit it before submitting. | Yes | Yes | Yes | | **Symbol** | Read it in the list; the form does not offer it. | No | Yes | No | The currency picker offers every row returned by the currency lookup. Each option carries its code, name, and symbol data. The entry form also includes **Add more**. Select **Add more** to add another entry row to the form before submitting. ### Actions on the screen | Action | Where to use it | What it does | |---|---|---| | **New** | List | Opens a new-record popup when new entries are allowed. | | Edit control | Row | Opens the selected row when edit permission is available. A row click also opens the edit popup. | | **Delete** | Row menu | Deletes a list item when delete permission is available and more than one item exists. | | **Export** | Shared list toolbar | Opens the export options flow. | | **OK** | Shared popup | Submits the selected item when validation succeeds. | | **Cancel** | Shared popup | Closes the open popup without submitting it. | > **Note:** **Symbol** is a list value, not an editable field in the currency form. ## Add or edit a currency Use this procedure to add a company currency entry or correct an existing one. **Prerequisites** - The subscription feature is included and **New** is available for a new entry. - You have edit permission for an existing entry. - You know the currency code and the name that the company should use. **Steps** 1. Select the option that matches the change. | If you want to… | Select… | |---|---| | Add a new entry | **New** | | Edit an existing entry | The row edit control or the row | 2. In **Code**, select the currency code from the picker. 3. In **Name**, enter the currency name when it is not already set from **Code**. 4. Select **OK**. 5. Read the message shown after the save attempt. | If you are… | The completion message is… | |---|---| | Creating an entry | `Data saved Successfully` | | Updating an entry | `Data updated Successfully` | To leave without submitting the entry, select **Cancel** in the open popup. **Result:** The displayed message identifies the submitted operation, or **Cancel** closes the dialog without submitting the entry. The required checks are `Code is required`, `Name is required`, and `Select a Curriency`. Use the last message when the currency picker has not received a selection. ## Delete or export currency data Use deletion only when you intend to remove an entry. Use export when you need to start the list's export-options flow. ### Delete an entry **Prerequisites** - You have confirmed that the row is the one to remove. - Delete permission is available and the list contains more than one item. **Steps** 1. Open the row's delete menu. 2. Select **Delete**. 3. Read `Are you sure you want to delete this item?`. 4. Select **Cancel** or **Delete** in the confirmation dialog. 5. Read the message shown after the delete attempt. The delete messages are `Data Deleted Successfully`, `Failed to Delete`, and `Must have at least one item`. **Result:** After confirmation, the displayed message states whether the entry was deleted or refused. ### Export currency data Start this procedure when you need the list's export options. **Prerequisites** - The Frequent currencies list is open. - **Export** is available in the shared list toolbar. **Steps** 1. Select **Export**. 2. Review the export options. 3. Select **Cancel** to leave the export options. 4. Select **Export** to continue the export flow. **Result:** The export options flow is open. ## When currency maintenance goes wrong Use the message or surface you can see to choose the next action. | What you see | What it means | What to do | |---|---|---| | `Code is required` | **Code** has no value. | Select a value in **Code**. | | `Code is required` | The value is present. | Select **OK**. | | `Name is required` | **Name** has no value. | Enter a value in **Name**. | | `Name is required` | The value is present. | Select **OK**. | | `Select a Curriency` | The currency picker has no selected currency. | Select a currency in **Code**. | | `Select a Curriency` | A currency is selected. | Select **OK**. | | `Forbidden characters detected. Please remove them and try again.` | The entry contains a forbidden character. | Remove the forbidden character and submit the entry again. | | `Failed to Delete` | The delete operation failed. | Keep the entry and review the screen or request assistance. | | `Must have at least one item` | The list cannot be left without an item. | Keep at least one entry in the list. | | The upgrade surface appears instead of the grid | The subscription feature is not included. | Open the upgrade surface. | | A loading indicator remains while values are visible | The list is still reporting loading. | Read the visible headers and values before editing. | For every save, update, or delete attempt, read the displayed result message before treating the operation as complete. ## Out of scope The related saved-data workflow is outside this page. If deletion shows `Related to Saved data, Can't be deleted`, keep the entry and use that related workflow. | Message | Why it is outside this page | |---|---| | `Related to Saved data, Can't be deleted` | The related saved-data workflow owns the next action. | ## Continue with currency configuration After reviewing or maintaining the entries, continue with the company configuration area that matches the next piece of work. | Next need | Page | |---|---| | Maintain company flags | [Flags](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-flags) | | Maintain product categories | [Product categories](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-product-categories) | | Use configured currency data in product and sales work | [Products](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/products) | The next step after this page is the related company setting or the product workflow that uses the currency data. # Flags ## Flags Flags maintains named colour markers for sales jobs. Use a flag when your team needs a consistent visual way to distinguish or group sales-job records. | If you need to… | Go to | |---|---| | Understand what a flag is and when to use one | [Flags](#flags) | | Check access, subscription, and record conditions | [Before you start](#before-you-start) | | Open the list and identify its actions | [Find Flags](#find-flags) | | Learn what the list and popup contain | [Understand the Flags list and form](#understand-the-flags-list-and-form) | | Add or change a named colour marker | [Add or edit a flag](#add-or-edit-a-flag) | | Remove a flag or export flag data | [Delete or export flag data](#delete-or-export-flag-data) | | Resolve a validation or deletion message | [When flag maintenance goes wrong](#when-flag-maintenance-goes-wrong) | | Open another company reference list | Continue with the company configuration | Flags is available when the company subscription includes flag maintenance. Create a named flag and select its colour so the same marker has the same meaning across your sales jobs. ## Before you start Flags maintenance depends on the company subscription and on the permissions available to your account. The screen can show different actions, or an upgrade surface instead of the list, according to those conditions. When access is available, open the list with the actions described in the next section. | Condition | What you see | |---|---| | The flag-maintenance subscription is not included | A subscription-upgrade surface replaces the grid. | | Your account cannot create a flag | **New** is hidden. | | Your account cannot edit flags | The row edit control is unavailable. | | Your account cannot delete flags | The row delete control is unavailable. | | Your account cannot export flag data | Export controls are unavailable. | | Your account cannot import flag data | Import controls are unavailable. | The delete action also depends on the number of records: deletion is performed only when the list contains more than one item. A single-item list cannot be reduced further. ## Find Flags Open the Flags page to view the list of flags. **Prerequisites** - Your account has access to the Flags screen. **Steps** 1. Open the Flags page. 2. Confirm that the page title is **Flags**. 3. Confirm that the list contains four rows. 4. If you can create a flag, confirm that **New** is available. ![The Flags page, its four-row list, and the New action](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/38c687d3276e60a4cea7e82240dbce44.png) **Result:** The **Flags** list is open. You can identify **New** when your account can create a flag. ## Understand the Flags list and form The list displays **Name** and **Color** columns. The new-flag popup contains **Name**, **Color**, and **OK**. The list can also display **Refresh** and **Settings**. ![The Flags list with Name and Color columns and its list actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/90bd54a1463e0395e287b50c8b509c59.png) Work from the **Name** and **Color** headers visible in your list. The row edit and delete controls depend on your account permissions. If the subscription feature is unavailable, the subscription-upgrade surface appears instead of the grid. Use these controls to maintain a flag, as described next. ### Fields | Field | Type | Reader action | Visibility and rule | |---|---|---|---| | **Name** | Text box | Enter the flag name. | Visible in the form and required. | | **Color** | Select box | Select a colour. | Visible in the form and required. | | System-managed fields (3) | — | None | Hidden and stored without reader entry. | The **Color** choices display each option's name and save its colour value. Use the visible **Name** and **Color** headers to identify the list columns. ## Add or edit a flag Use this procedure to add a new flag or change an existing one. **Name** and **Color** carry required markers in the live popup. **Prerequisites** - The company subscription includes flag maintenance. - Your account can create or edit flags. **Steps** 1. Select the starting action: | If you want to… | Select… | |---|---| | Create a flag | **New** | | Change an existing flag | The edit control in the row you want to change | 2. Enter the flag name in **Name**. 3. Select the flag colour in **Color**. 4. Choose how to leave the popup: | If… | Select or do this… | |---|---| | The popup is ready to save | Select **OK**. | | The popup remains open after you select **OK** | Correct the required fields or forbidden characters. | | You do not want to save | Select **Cancel** to leave without saving. | **New** creates an item and opens the new-item popup. The edit control copies its row into the edit popup. The new-item popup is titled **New Flags** and displays **OK**. ![The New Flags popup with the required Name and Color fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0725629b2da54c33bc6b235bc2870253.png) When the operation succeeds, the application uses `Data saved Successfully` for a new item and `Data updated Successfully` for an update. **Result:** The popup closes after a successful operation. If you select **Cancel**, it closes without saving. To remove or export a flag, continue with the next section. ## Delete or export flag data Use the row delete control only when deletion is available and more than one flag exists. Use **Export** when you need flag data in a selected format. **Prerequisites** - Your account has delete permission for the row you want to remove, or export permission for the data you want to extract. - More than one flag exists before you delete a row. **Steps** 1. Select the data action: | If you want to… | Select… | |---|---| | Remove a flag | The delete control in the row you want to remove | | Export flag data | **Export** | 2. If you selected **Export**, select a format in the export options. If the Flags list contains one item, deletion is blocked and the application shows `Must have at least one item`. A successful deletion uses `Data Deleted Successfully`. A failed deletion can show `Failed to Delete` or `Related to Saved data, Can't be deleted`. **Result:** The selected delete or export action has been requested. If a message prevents the action, use the next section to correct it. ## When flag maintenance goes wrong Use the message on screen to identify what to correct before trying the action again. After the action succeeds, continue with another company reference list. | Message | What to do | |---|---| | `Name is required` | Enter a value in **Name**. | | `Color is required` | Select a value in **Color**. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from **Name**, then try saving again. | | `Must have at least one item` | Keep at least one flag in the Flags list before deleting. | | `Failed to Delete` | Do not continue deleting the row; review the deletion condition and try again. | | `Related to Saved data, Can't be deleted` | Do not delete the related flag; retain it for the saved data that uses it. | ## Continue with company configuration Open a sibling company reference-list page when you need to maintain another list. Continue with the company reference lists for: - Company branches - Company product types. - Company currencies. - Company market segments. - Company item categories. - Company departments. - Company reactivation reasons. - Company product categories. # Market segments Market segments are named entries for distinguishing the industries your company serves. | If you need to… | Go to | |---|---| | Understand what market segments are used for | [Market segments at a glance](#market-segments-at-a-glance) | | Check which access and configuration conditions apply | [Before you start](#before-you-start) | | Open the list or a new entry | [Find and open Market segments](#find-and-open-market-segments) | | Identify the visible field and list column | [Understand the Market segments screen](#understand-the-market-segments-screen) | | Add or change a market-segment name | [Create or edit a market segment](#create-or-edit-a-market-segment) | | Remove a row or open export | [Delete or export the list](#delete-or-export-the-list) | | Correct a blocked entry or action | [When the list or save action does not work](#when-the-list-or-save-action-does-not-work) | | Return to company configuration | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) | | Maintain item categories next | [Item categories](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-item-categories) | | Maintain product categories next | [Product categories](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-product-categories) | ## Market segments at a glance Use a market segment when your company needs a named industry distinction in its configuration data. ## Before you start Market-segment work depends on the subscription, the permissions on your account, and the selected entry. These conditions determine which controls and fields you can use. | Condition | What it determines | |---|---| | The subscription includes Market segments | The list and its header controls are available. | | Your account can create entries | **New** is available. | | Your account can edit entries | The row edit control is available. | | Your account can delete entries | The row delete control and deletion menu are available. | | A new or selected entry is open | The entry form is displayed. | | A field is configured for the form | That field is displayed. | | The **Name** field is required | The form applies required-field validation. | The form only presents configured fields that are visible in the form. The permissions and subscription conditions can therefore change the maintenance actions available to your account. ## Find and open Market segments The Market Segments page is the company configuration list for these entries. **Prerequisites** - You are signed in. - Your account has access to the Market segments page. **Steps** 1. Open **Market Segments** from the company configuration area. 2. Confirm that the page is in the **Company** and **Configuration** navigation context. 3. Select the action you need: | If you need to… | Select | |---|---| | Start a new entry | **New** | | Refresh the list | **Refresh** | | Open list settings | **Settings** | | Edit an existing entry | The control in the row that opens the entry for editing | **New** opens the new-entry dialog. The control in the selected row opens that entry for editing. ![The Market Segments list with New, Refresh, and Settings](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/11e729eefd5fb317ac798881c80cb75c.png) > **Note:** The list currently shows **Name** as its only column. Use the headers visible on > your screen when working with the list. ![The Market Segments list and its Name column](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9c0628e58530648f3b5bf13c9a2b7380.png) **Result:** The **Market Segments** list is on screen, or the new-entry dialog is open. ## Understand the Market segments screen The Market Segments screen has one visible list column and one visible entry field: **Name**. | Screen area | What you can use | |---|---| | List | **Name** is the only visible list column. | | Entry form | **Name** is the only visible entry field and is a required string/text box. | | Other stored information | It is handled by the application and is not available for entry on this screen. | | Additional entry fields | No other market-segment fields are shown in the entry form. | Use the **Name** header to identify a row. Use the **Name** field to enter or change its name. ![The New Market Segment dialog with the required Name field](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/bfbfc08abfc5b5127b57416848745ffc.png) ## Create or edit a market segment Create a market segment when the company needs a new named industry entry. Edit one when its displayed name needs to change. **Prerequisites** - The Market segments list is open. - You have permission to create an entry or edit the selected row. - You have the name to enter. **Steps** 1. Select the action that matches your task: | If you need to… | Select | |---|---| | Create an entry | **New** | | Change an existing entry | The control in the row that opens the entry for editing | 2. In the entry form, enter the market-segment name in **Name**. 3. Select **Save** to commit the entry form. 4. If you need to leave without saving, select **Cancel**. 5. If the exit confirmation offers **Don't Save**, select **Don't Save**. **Result:** The entry is submitted for creation or editing, or the form closes without saving. ## Delete or export the list Delete a selected row only when deletion is available and the selected row is the one you intend to remove. Open export when you need the list's export dialog. **Prerequisites** - The Market segments list is open. - For deletion, your account can delete entries. - For export, your account has access to the shared export surface. **Steps** 1. Select the action that matches your task: | If you need to… | Select or read | |---|---| | Remove the selected row | Select its row delete control. Read `Are you sure you want to delete this item?`, then select **Delete**. | | Keep the selected row | **Cancel** in the deletion menu | | Open the export surface | Select **Export**, then read `Exporting List:`. | | Close the export surface | **Cancel** | **Result:** The selected deletion or export option is displayed, or the open menu or dialog closes. ## When the list or save action does not work Use the message on screen to identify whether **Name** needs a value or a permitted character. Access conditions determine whether the list and its controls are available. | What you see | What to do | |---|---| | `Name is required` | Enter a value in **Name**. | | `Just '_' '-' And '.' Characters Accepted` | Remove characters from **Name** that are outside the accepted pattern. | | `This Field Is Required` | Enter the required value in **Name**. | | `Required` | Enter the missing required value in **Name**. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from **Name**, then try saving again. | | `As a developer, you may have greater privileges to change one or more item.` | Review the permissions on the account before continuing with the action. | | `Are you sure you want to delete this item?` | Confirm that the selected row is the one you intend to remove before selecting **Delete**. Select **Cancel** to keep it. | | `Exporting List:` | Use the export dialog, or select **Cancel** to close it. | ## What to do next After maintaining a market-segment entry, return to the company configuration area for the next reference list. Continue to [Item categories](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-item-categories) or [Product categories](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-product-categories), or return to the [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) to select another company setting. # Item categories Item categories are the company's hierarchy of categories and subcategories. Maintain this reference data before using categories while working with products. | If you need to… | Go to | |---|---| | Check access and prepare a category name | [Before you start](#before-you-start) | | Open the list and locate an entry | [Find Item categories](#find-item-categories) | | Read the hierarchy and available controls | [Understand the Item categories screen](#understand-the-item-categories-screen) | | Add or change a category or subcategory | [Add or edit a category](#add-or-edit-a-category) | | Remove an entry or use the list output action | [Delete a category or export the list](#delete-a-category-or-export-the-list) | | Correct a value that prevents saving | [When validation or saving goes wrong](#when-validation-or-saving-goes-wrong) | | Continue to related configuration or product work | [Configuration home](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home), [Product categories](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-product-categories), or Products | ## Before you start Item categories is the company configuration screen for maintaining the category hierarchy. Prerequisites - Confirm that the Product Categories subscription feature is included for the company. - Have permission for the action you plan to take. **New** requires create permission; **Add New Sub-Category** and **Edit** require edit permission; **Delete** requires delete permission. - Have the category name or subcategory name ready. When the Product Categories subscription feature is not included, the list is unavailable. When it is included, **New** is available only with create permission. **Add New Sub-Category** and **Edit** are available only with edit permission. The category popup requires **Product category name**. The subcategory popup requires **Sub product category name**. ## Find Item categories The Item Categories page is the list where you locate the category or subcategory row to maintain. Prerequisites - Confirm that the Product Categories subscription feature is included. - Confirm that you have the permission required for the action you plan to take. Steps 1. Open Item categories from the company configuration screen. 2. Confirm that the page title is **Item Categories**. 3. Locate the entry in the **Category** column. 4. Select **New** when you need to create a category. ![The Item Categories list with the Category column and New action visible.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d8b38d09f78972493b58347e3a1d292a.png) **Result:** The Item Categories list is open, and you have either located the row to maintain or opened the new-category form. ## Understand the Item categories screen The Item Categories screen presents the category hierarchy. A category entry uses **Product category name**, while a child entry uses **Sub product category name**. The list and popup states use the following reader-facing controls: | What you are working with | What you see or select | What it is for | |---|---|---| | Category list | **Category** | Locate a category or subcategory entry. | | New category popup | **Product category name** | Enter the name of a category. | | New subcategory popup | **Sub product category name** | Enter the name of a child entry. | | Saved category history | Registration | View registration history from the history area of a saved category entry. | | List action | **New** | Open a category entry popup. | The category popup also shows the **OK** action. A saved category entry can expose Registration from its history. ![The Item Categories screen with the hierarchy in Category and the New action.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9abf8424d9b8c0ea18cd1c7bd60956bc.png) ![The category popup with Product category name and the OK action.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/db540140e782bce73df2fe608e777a05.png) ## Add or edit a category Use a category entry for a top-level name and a subcategory entry for a child under a selected category. The popup validates the name before **Save** commits it. Prerequisites - Confirm that the Product Categories subscription feature is included. - For a new category, have create permission. - For a subcategory or an edit, have edit permission. - Have the name ready without special characters. Steps 1. Select the action that matches the entry you need to maintain. | If you need to… | Select | |---|---| | Add a top-level category | **New** | | Add a child under the selected row | **Add New Sub-Category** | | Change the selected row | **Edit** | 2. Enter the appropriate name. | If you are maintaining a… | Enter the name in | |---|---| | Category | **Product category name** | | Subcategory | **Sub product category name** | 3. Submit the entry. | Popup state | Action | |---|---| | The popup shows **Save** | Select it. | | The popup shows **OK** as its submit action | Select it. | Category and subcategory names use the configured pattern rule and reject special characters. Correct the name if the rule prevents the save. **Result:** The category or subcategory popup has accepted the entry for saving, or it remains open with the value that needs correction. ### Delete a category or export the list Use **Delete** only when you have delete permission and the selected entry is the one you intend to remove. Use **Export** for the list-output operation when it is available. Prerequisites - Confirm that the selected row is the entry you intend to remove. - Confirm that you have delete permission before selecting **Delete**. Steps 1. Choose one operation and complete the corresponding action. | If you need to… | Select or complete | |---|---| | Remove the selected row | **Delete**, read `Are you sure you want to delete this item?`, then select the confirmation control shown by the application. | | Keep the entry | **Delete**, then **Cancel**. | | Use the list-output operation | **Export**, then choose the available list format. | **Result:** **Cancel** leaves the entry in place; a completed permitted deletion displays `Data Deleted Successfully`. The export branch is open when **Export** is available. ## When validation or saving goes wrong Validation messages identify the value that needs correction before you try **Save** again. | What you see | What to do | |---|---| | `This Field Is Required` | Enter a value in the required name field. | | `Please Enter the Required Field` | Enter the missing category or subcategory name. | | `Required Field can not be Empty Spaces` | Replace spaces-only input with a category or subcategory name. | | `Just '_'‘-''.' And '&' Characters Accepted` | Remove characters outside the configured pattern rule. | | `Must have maximum 10 letters` | Shorten the value to the permitted length. | | `Under Development` | The export operation is unavailable. | | `Data Importing completed` | The import operation reports completion. | | `Data saved Successfully` | The save operation reports success. | | `Data Deleted Successfully` | The delete operation reports success. | The name fields are required and use the configured pattern rule. Spaces-only values are rejected. ## After maintaining item categories The maintained category hierarchy is reference data for later product work. A saved entry reports `Data saved Successfully`; a successful deletion reports `Data Deleted Successfully`. Steps 1. Confirm the message that matches the operation you completed. 2. If you opened a new form but do not want to save it, select **Cancel**. 3. Continue to Products for related product work, or return to [Configuration home](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) for another configuration task. ![The Item Categories list after the new category form is closed without saving.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e82c75ea75ee7689c940499d5fbe16b8.png) **Result:** The item-category list is available for the next reference-data or product task. # Departments ## Departments at a glance A department is a named part of a company branch that you set up before assigning employees to it. The Departments list keeps these named company-branch entries in one place for company administration. Employees can then use a department association, and signed-in users carry a list of departments for their administration context. | If you need to… | Go to | | --- | --- | | Check what a department entry contains | [Understand the Departments screen](#understand-the-departments-screen) | | Create or change a department | [Add or change a department](#add-or-change-a-department) | | Enter the department name and save it | [Add or edit an entry](#add-or-edit-an-entry) | | Remove a department or open export | [Remove or export departments](#remove-or-export-departments) | | Resolve a validation or save message | [When a department action goes wrong](#when-a-department-action-goes-wrong) | | Continue with user or related administration | [Continue after department maintenance](#continue-after-department-maintenance) | ## Before you start You must be signed in and pass the Departments route guard. The Departments grid is available when the subscription includes the required feature. The **New** action is available when that feature is included and the configuration does not hide **New**. Editing requires edit permission, and deleting requires delete permission. | Access condition | What it controls | | --- | --- | | Signed-in user passes the route guard | Access to the Departments route | | Subscription includes the feature | The department grid | | Feature included and `hideNewButton` is false | **New** | | Edit permission granted | Row edit action | | Delete permission granted | Row delete action | ## Find Departments The company-branch reference list is named **Departments**; **Branches** is a separate sibling list. **Prerequisites** - You are signed in. - Your signed-in user passes the Departments route guard. **Steps** 1. Open company administration. 2. Select **Departments**. **Result:** The Departments list is selected in the company configuration surface when your access permits it. ## Understand the Departments screen The Departments screen is a list of named department entries with an entry popup for creating or changing one entry. **Name** is the only visible grid field and the only visible form field. It is required. The entity also carries `DisplayOrder`, `CompanyBranchDepartmentID`, `CompanyBranchID`, and `Description`, but these values do not appear as visible form controls. | Screen area | What to use it for | | --- | --- | | Department list | View the configured department entries | | New/edit popup | Enter or change **Name** | | **Name** | Enter the required department name | | Hidden entity values | Preserve entity data that is not exposed as a form control | The current list column set comes from the list configuration, so work from the headers that appear in your list. The grid and the entry popup are separate containers within the shared configuration surface. > **Note:** A department name is the value employees and signed-in users use when the > department relationship is assigned. Enter the name that colleagues recognise in > company administration. ## Add or change a department Use **New** for a department that does not yet exist. The action opens a new-item popup and initializes the display order. Use the row edit action for an existing department; it opens that row in the edit popup. The row edit action appears only when edit permission is granted. **Prerequisites** - The subscription includes the Departments feature. - The configuration does not hide **New** when you are creating an entry. - You have edit permission when you are changing an existing entry. **Steps** 1. Choose a maintenance path. | If you need to… | Select | | --- | --- | | Create a department | **New** | | Change an existing department | The row edit action for that department | 2. Continue in the entry popup described in [Add or edit an entry](#add-or-edit-an-entry). **Result:** A new-item popup or the selected department's edit popup is open. ### Add or edit an entry The entry popup accepts the required **Name**. **OK** submits the popup for both a new entry and an edit. **Prerequisites** - The new-item or edit popup is open. - You have the department name to enter. **Steps** 1. In **Name**, enter the department name. 2. Select **OK**. After you select **OK**, follow the action for the message that appears. | Result shown | Action | | --- | --- | | `Name is required` | Enter a value in **Name**. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from **Name**. | | `Data saved Successfully` | Confirm that the new entry is saved. | | `Data updated Successfully` | Confirm that the existing entry is updated. | **Result:** The department entry is submitted with the name you entered, or the popup remains available for correction when validation stops submission. ## Remove or export departments Removal changes the department list and is available only when delete permission is granted. The **Delete** action applies when more than one item exists, preserving the minimum-one-item rule. **Export** is a separate, non-destructive list action and is available when export permission is granted. | Need | Condition | Action | | --- | --- | --- | | Remove a department | Delete permission and more than one item exists | Delete row | | Keep the list unchanged and open export | Export permission is granted | **Export** | **Prerequisites** - The Departments list is open. - You have delete permission for removal or export permission for export. **Steps** 1. Choose an action. | If you need to… | Select | | --- | --- | | Remove a row | The row delete action | | Open export | **Export** | 2. Continue with [Delete an entry or open export](#delete-an-entry-or-open-export). **Result:** The department remains unchanged after **Cancel**, the selected department is removed after confirmed deletion, or the export action is open. ### Delete an entry or open export Deleting opens a confirmation path; export opens its separate export surface. The delete confirmation gives you **Cancel** before the destructive action and **Delete** to confirm. **Prerequisites** - For deletion, delete permission is granted and more than one department item exists. - For export, export permission is granted. **Steps** 1. For deletion, read the confirmation `Are you sure you want to delete this item?`. 2. Select one confirmation action. | If you need to… | Select | | --- | --- | | Keep the department | **Cancel** | | Confirm removal | **Delete** | 3. For export, select **Export** to open the export surface. **Result:** The delete menu closes without deletion, deletion is confirmed, or the export surface opens. ## Handle surface variations The Departments surface changes with subscription access, permissions, and the current company's list configuration. | Variation | What changes for you | | --- | --- | | Subscription feature unavailable | The subscription-required upgrade surface appears instead of the grid | | **New** hidden or feature unavailable | **New** is not available | | Edit permission unavailable | The row edit action is not available | | Delete permission unavailable | The row delete action is not available | | Export permission unavailable | **Export** is not available | | List configuration differs | The department list and its visible columns can differ | | Shared configuration surface | Sibling entities can appear in the same multi-entity component | Use the selected entity name to distinguish **Departments** from sibling administration tabs. A missing action reflects the current subscription or permission setup; it does not add another field to the entry popup. ## When a department action goes wrong Use the exact message on screen to choose the next action. The messages below cover name validation, save and update results, deletion results, and the rule that keeps at least one item in the list. | Message | What to do | | --- | --- | | `Name is required` | Enter a value in **Name**, then select **OK**. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from **Name**, then select **OK**. | | `Related to Saved data, Can't be deleted` | Keep the department and review the saved data related to it before attempting maintenance again. | | `Failed to Delete` | Do not assume the row was removed; review the list and contact an administrator if it remains unchanged. | | `Must have at least one item` | Keep at least one department entry in the list. | | `Data Deleted Successfully` | Confirm that the selected department was removed, then check the list. | | `Data saved Successfully` | Treat the new department as saved and continue with department maintenance. | | `Data updated Successfully` | Treat the changed department as updated and continue with department maintenance. | ## Continue after department maintenance Use the maintained department names when employee records or signed-in-user administration assigns departments. | Next need | Related surface | | --- | --- | | Assign or review departments for users | Users overview | | Maintain a related administration reference list | Teams | | Maintain the company branch associated with departments | Branches | Use the product's administration navigation to open the related surface that your role permits. Keep the department name consistent with the name colleagues select for employee and signed-in-user administration. # Reactivation reasons | If you need to… | Go to | |---|---| | Check access before maintaining a reason | [Before you start](#before-you-start) | | Reach the configuration list | [Find the reactivation-reasons list](#find-the-reactivation-reasons-list) | | Read the list and entry form | [Understand the list and entry form](#understand-the-list-and-entry-form) | | Add or change a reason | [Add or edit a reactivation reason](#add-or-edit-a-reactivation-reason) | | Remove a reason | [Delete a reactivation reason](#delete-a-reactivation-reason) | | Open the company configuration area | Configuration home | ## Reactivation reasons Reactivation reasons maintains the names available for a reactivation reason. When staff need to record why a relationship resumes, add the reason before they reactivate the related work. The list is available at `company/reactivationreasons`. ## Before you start **Prerequisites** - Use a signed-in account that can access the company configuration area. - Confirm that your permissions allow the action you need. The page uses an authentication guard. Your permissions control the maintenance controls: | Permission condition | What appears | |---|---| | Create permission | **New** appears. | | Edit permission | The row edit control appears, and selecting a row permits row-click editing. | | Delete permission | The row delete control appears. | Your access determines whether the list and its maintenance controls are available. > **Note:** Access to the route determines whether the list and its maintenance controls can > be used. ## Find the reactivation-reasons list The list is under Configuration > Reactivation Reasons. **Prerequisites** - Complete the access checks in [Before you start](#before-you-start). **Steps** 1. Open Configuration. 2. Open **Reactivation Reasons**. 3. Confirm that you are on the reactivation-reasons list before selecting an edit or delete control beside a reason. **Result:** You are on the reactivation-reasons list. ## Understand the list and entry form The list shows reactivation-reason names. **Name** is the only visible heading, and each listed reason has controls for editing and deleting it. | Surface | What it does | |---|---| | **Name** | Displays the reason name and is required in the entry form. | | Each listed reason | Has an edit control and a delete control. | | Entry form | Appears inside the save popup when a reason is selected. | | Save popup title | Shows `New Reactivation Reason` for a new entry or `Edit Reactivation Reason` for an existing entry. | | Save popup controls | The submit and close controls appear when the popup is in save mode. | The list does not show a Search panel or page controls. It also does not show column headings or allow changes directly in the list. Use each reason's edit or delete control, then work in the popup. ## Add or edit a reactivation reason Use this procedure to create a selectable reason or change an existing one. **Prerequisites** - **New** must be available for creation, or an edit control beside a reason must be available. - Have the reason name ready. **Steps** 1. Choose the maintenance action: | If you need to… | Select or use | |---|---| | Create a reason | **New**. This opens the `New Reactivation Reason` popup with an empty reason and ID `0`. | | Edit a reason | Select the edit control beside the reason. The selected row opens in the `Edit Reactivation Reason` popup. | 2. In the popup, enter the reason name in **Name**. 3. If **Name** is empty, enter a value in **Name**. The form displays `Name is required`. 4. If **Name** contains only spaces, replace it with a proper value in **Name**. 5. At the bottom of the save popup, select **OK** to submit the form. 6. If you do not want to save the entry, select the control in the upper-right corner of the save popup. 7. Confirm the success message `Data saved Successfully`. After a successful save, the popup closes and the list refreshes. **Result:** The new or edited reason is submitted, the popup closes after a successful save, and the refreshed list contains the saved reason. ## Delete a reactivation reason Use this procedure to remove a reason that staff must no longer select. **Prerequisites** - A delete control beside a reason must be available. - Identify the row to remove by its **Name** value. **Steps** 1. Select the delete control beside the reason you want to remove. 2. Read the confirmation message `Are you sure you want to delete this item?`, then choose one option: | If you want to… | Select | |---|---| | Remove the selected reason | **Delete** | | Keep the reason | **Cancel** | 3. If you selected **Delete**, confirm the success message `Data Deleted Successfully`. After a successful delete, the row is removed from the displayed list and the list refreshes. **Result:** The selected reason is deleted and the refreshed list no longer contains its row, or the delete menu is closed without deleting it. ## Handle access and row-selection variations The available controls depend on permission and selection state. | Condition | Reader-facing result | |---|---| | Create permission | **New** is available for creating a reason. | | Edit permission | An edit control beside a reason is available, and row-click editing is permitted. | | Delete permission | A delete control beside a reason is available. | | A reason is selected | The form appears inside the save popup. | | No selected reason | The selected-reason form does not appear. | ## When saving or deleting goes wrong If a save or delete does not complete as expected, use the message shown on screen. **Prerequisites** - Have the message shown on screen available. - Have access to the Configuration area, or an administrator who can check it. **Steps** 1. Use the message shown on screen to choose an action: | Message | Action | |---|---| | `Name is required` | Enter a value in **Name**, then select **OK**. | | `please enter a proper name` | Replace the spaces in **Name** with a proper value, then select **OK**. | 2. If neither message appears, ask an administrator to check access and the configuration list before repeating the action. **Result:** The corrected action is submitted again, or an administrator has the information needed to investigate the incomplete action. ## After maintaining a reason After a successful save, the product returns `Data saved Successfully` and refreshes the list. After a successful deletion, it returns `Data Deleted Successfully` and refreshes the list. **Result:** The maintained reason appears in the refreshed list after saving, or its row is removed after deletion. # Product categories ## Product categories Product categories organise your company's products into a hierarchy. A category is a named grouping at the top level; a subcategory is a child grouping beneath it. Use this page to maintain category names and product codes. | If you need to… | Go to | |---|---| | Open the category list | [Find product categories](#find-product-categories) | | Read the hierarchy and list actions | [Understand the category list](#understand-the-category-list) | | Add or change a category | [Create or update a category](#create-or-update-a-category) | | Add a child category | [Create a subcategory](#create-a-subcategory) | | Remove a category | [Delete a category](#delete-a-category) | | Narrow or export the list | [Filter or export the list](#filter-or-export-the-list) | | Resolve a blocked action | [When category maintenance goes wrong](#when-category-maintenance-goes-wrong) | ![The Product Categories list with its toolbar, hierarchy columns, and category rows](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6904939c9c21ce6614a8c72892dc08df.png) ## Before you start Product-category maintenance is available to a signed-in user when the route can authenticate the user and the company's Product Categories subscription is included. The subscription determines whether the list is available; permissions determine which maintenance controls appear. | Before you start | Why it matters | |---|---| | Sign in to PAMS | The page requires authenticated access. | | Have the Product Categories subscription included | The list and its authorization checks are available only with this subscription. | | Have **New** permission | **New** appears for creating a category. | | Have Edit permission | **Add New Sub-Category** and **Edit** appear for changing category data. | | Have Delete permission | The delete control appears for removing a category. | | Have Export permission | The shared export option is allowed. | If the subscription is not included, the page displays the subscription-upgrade component instead of the list. > **Note:** The list and its maintenance controls appear only when the subscription > and the permission for the action are available to your account. ## Find product categories Open the product-category list after signing in. **Prerequisites** - You are signed in. - The Product Categories subscription is included for the company. **Steps** 1. Open the product-category list. 2. Confirm that the page shows the **Product Categories** screen. 3. Confirm that the category list is present. The list is the starting point for the maintenance actions in the next sections. **Result:** The **Product Categories** list is on screen with its available toolbar and row controls. ![The supported product-category list entry point](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/92a1a457f559c098f4592f8d445b2ca2.png) ## Understand the category list The list shows a two-level hierarchy: a category can have a subcategory beneath it. The toolbar contains the following controls when they are available. | Control | What it does | |---|---| | **Apply filter** | Applies the filter settings to the list. | | **New** | Opens a new category form. | | **Refresh** | Refreshes the list. | | **Settings** | Opens the list settings. | The grid shows **Category** and **Code**. **Category** identifies the category or subcategory row. **Code** shows the product code. Select a row before using a row-specific action: **Add New Sub-Category** creates a child beneath it, and **Edit** opens it for changes. The delete control is available with Delete permission. After reviewing the list, use [Create or update a category](#create-or-update-a-category) for a top-level entry or [Create a subcategory](#create-a-subcategory) for a child entry. ## Create or update a category Create a category for a new top-level grouping. Update the selected category when its name or product code needs correction. **Prerequisites** - The Product Categories subscription is included. - You have **New** permission to create a category, or Edit permission to update one. - You have the category name and product code ready. **Steps** 1. Choose the action for the entry you want to maintain. | If you want to… | Select | |---|---| | Create a category | **New** | | Update an existing category | **Edit** on its row | 2. In the category form, enter the name in **Product category name**. 3. Enter a product code from 1 to 10 characters in **Product code**. 4. Use only the characters accepted by the form's no-special-character pattern in both text fields. 5. Select **OK**. Both fields are required. Missing values use `This Field Is Required`; unsupported characters use `Just '_'‘-''.' And '&' Characters Accepted`; and a product code over the allowed length uses `Must have maximum 10 letters`. **Result:** The category form is submitted. A successful save displays `Data saved Successfully`. ![The new category form with Product category name, Product code, and OK](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5e7e4aa49bdbaa6b6463ac0f18b1282a.png) Continue with [Create a subcategory](#create-a-subcategory) if the hierarchy needs a child entry, or [Delete a category](#delete-a-category) if an entry must be removed. ## Create a subcategory Use a subcategory for a more specific grouping beneath an existing category. **Prerequisites** - The Product Categories subscription is included. - You have Edit permission. - The parent category row is visible in the list. - You have the subcategory name and product code ready. **Steps** 1. Select the parent category row. 2. Select **Add New Sub-Category**. 3. Enter the child name in **Sub product category name**. 4. Enter a product code from 1 to 10 characters in **Product code**. 5. Use only the characters accepted by the form's no-special-character pattern in both fields. 6. Select **OK**. The subcategory name and product code are required. The same required-field, character, and length messages apply: `This Field Is Required`, `Just '_'‘-''.' And '&' Characters Accepted`, and `Must have maximum 10 letters`. **Result:** The subcategory form is submitted. A successful save displays `Data saved Successfully`. Continue with [Delete a category](#delete-a-category) to remove an entry, or use [Filter or export the list](#filter-or-export-the-list) to work with the list. ## Delete a category Deleting removes the selected category through a confirmation path. **Prerequisites** - The Product Categories subscription is included. - You have Delete permission. - The category row to remove is selected. **Steps** 1. Open the delete control for the selected category row. 2. Read `Are you sure you want to delete this item?`. 3. Choose what to do in the confirmation menu. | If you want to… | Select | |---|---| | Keep the category | **Cancel** | | Remove the selected category | **Delete** | **Result:** After a successful deletion, the page displays `Data Deleted Successfully` and the selected category is no longer available in the list. Continue with [Filter or export the list](#filter-or-export-the-list) to work with the remaining rows. ## Filter or export the list Use the list toolbar to narrow the rows or prepare an export. **Prerequisites** - The category list is open. - You have Export permission for export actions. **Steps** 1. Open the filter controls from **Apply filter**. 2. Apply the filter settings to the category list. 3. Select **Export**. 4. Choose an export format. | Format | Control | |---|---| | Excel file | **Export to Excel** | | PDF file | **Export to PDF** | The export area can display `Under Development`. **Result:** The selected filter is applied to the list, or the selected export choice is ready to run. Continue with [When category maintenance goes wrong](#when-category-maintenance-goes-wrong) if a value, permission, subscription, or operation prevents you from continuing. ## When category maintenance goes wrong Use the message on screen to identify whether the form needs a value, a different character, or a shorter product code. | What you see | What it means | What to do | |---|---|---| | `This Field Is Required` | A required category or code field is empty. | Enter a value in **Product category name**, **Sub product category name**, or **Product code**, as applicable. | | `Just '_'‘-''.' And '&' Characters Accepted` | A text value contains an unsupported character. | Replace the character and keep the value within the accepted pattern. | | `Must have maximum 10 letters` | **Product code** is longer than 10 characters. | Shorten the product code to 10 characters or fewer. | | `Required Field can not be Empty Spaces` | A required field contains blank spaces instead of usable content. | Replace the spaces with a category name or product code. | | `Please Enter the Required Field` | The required-field check still needs a value. | Enter the required value, then select **OK** again. | | The list is replaced by the subscription-upgrade component | The Product Categories subscription is not included. | Ask an administrator to review the company's subscription. | | A maintenance control is not available | The permission for that action is not granted to your account. | Ask an administrator for the matching New, Edit, Delete, or Export permission. | If a server error occurs while an operation is processed, keep the category data unchanged and ask an administrator to review the operation rather than assuming it was saved. ## What to do next This screen changes the company's product-category names, hierarchy, and product codes. It does not represent a business-stage or status transition. After maintaining category data, continue to the registered **Products** page to use product data. For related company configuration, open **Product types** or **Item Categories**. # Reference categories ## Reference categories A reference category is a category entry with questions for the Reference list. The related category-question units use these categories and questions. The list currently shows `No data` and `Count: 0`. When records exist, the list identifies them through the **Name** and **Questions** columns. | If you need to… | Go to | |---|---| | Check the list and its available maintenance controls | [Find and review the reference-category list](#find-and-review-the-reference-category-list) | | Understand which fields are required or hidden | [Understand the fields and screen rules](#understand-the-fields-and-screen-rules) | | Add or review a category and its questions | [Add or review categories and questions](#add-or-review-categories-and-questions) | | Configure the related category-question units | [Reference-category question units](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reference-list-reference-category-question-units-view) | | Continue with another Reference list resource | [Serial Status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reference-list-reference-serial-status-view) | | Return to the configuration entry point | [Configuration](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) | ## Before you start Reference-category maintenance is available only when your account can use the configured feature and the corresponding maintenance action is allowed. **Prerequisites** - The configured subscription includes this feature. Otherwise, the page shows an upgrade surface instead of the data grid. - Edit access is available if you need to open a row for editing. - Delete access is available if you need to open a row's delete menu. - The **New** control is available when the page permits it. - Start with a saved row when you need to edit an entry. Open **Category** to see the category options available in your environment. Continue with [Find and review the reference-category list](#find-and-review-the-reference-category-list). ## Find and review the reference-category list Use this procedure to reach the list and identify the controls available in the current configuration. **Prerequisites** - The configured subscription includes this feature. - You have access to the Configuration area. **Steps** 1. Open **Configuration**. 2. Open **Reference list**. 3. Open **Categories questions**. ![Identify the Reference list page, its Name and Questions columns, and the empty-list message.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3a4d02493d81b486e006d028d8b1555d.png) 4. Check the list headers. | What you need to recognize | What appears | |---|---| | Category name column | **Name** | | Question summary column | **Questions** | | Create control | **New** | | List refresh control | **Refresh** | | List settings control | **Settings** | 5. Select **New** to open a new-entry popup. 6. If **Export** is available in the shared toolbar, select **Export** to open its export options. 7. If the row edit action is available, select the row edit control to open the selected row in edit mode. 8. If the row delete action is available, select the row delete control to open the delete menu. **Result:** The Reference categories list is open. You can see its columns, its current row count, and the maintenance controls that your access and shared-toolbar configuration make available. ## Understand the fields and screen rules The maintenance popup contains the category selection and a collection of questions. The list shows the columns for the selected reference-list resource. | Surface | What you use it for | Rule or visibility | |---|---|---| | **Category** | Select the category for the entry. | Required select field; form-only. | | **Category questions** | Maintain the questions belonging to the selected category. | Required collection field; form-only. | | **Question** | Enter one question in a collection row. | Required text box in each collection row. | | **Add more** | Add another question row. | Available when the **Category questions** collection is shown. | | Remove control | Remove a question row from the collection. | Shown with the collection. | | **Name** | Read the category name in the list. | Visible list column. | | **Questions** | Read the question summary in the list. | Visible list column. | | Display order | — | Hidden in the list and the form. | | Supporting child fields | — | Hidden from the list and form. | The page does not show a search panel, and paging is disabled. Captions and columns can change with the page configuration and the selected reference-list resource, so use the labels and headers visible on your page. Use these fields and rules when you continue to [add or review categories and questions](#add-or-review-categories-and-questions). ## Add or review categories and questions Use this procedure to start a new entry or review a saved row, maintain its question collection, and close the popup. **Prerequisites** - The Reference categories list is open. - For a new entry, **New** is available. - For review or editing, a saved row and edit access are available. - You know the category to select and the questions to enter. **Steps** 1. Choose the entry point that matches your task. | If you need to… | Select | |---|---| | Start a new category entry | **New** | | Review or edit a saved entry | The row edit control for the saved entry | The selected entry opens in a popup. 2. In **Category**, select the category for this entry. 3. Review **Category questions**. 4. If the collection is available, select **Add more** for each additional question you need to enter. 5. In each **Question** row that is available, enter the question text. 6. Select **OK** after the validation group is valid. 7. If you do not want to keep the popup changes, select **Cancel** to close the popup. For a new entry, complete the required **Category** and **Category questions** fields. If **Questions** is disabled, use the controls that are enabled. Enter **Question** when its row is available. **Result:** After you select **OK**, the Reference categories list refreshes when the entry is saved or updated. After **Cancel**, the popup closes. When a new entry saves successfully, the screen displays `Data saved Successfully`. When an existing entry updates successfully, it displays `Data updated Successfully`. ## Handle reference-list variations Reference-list maintenance uses one shared configuration screen. Its fields and actions change with the reference-list resource and the access available to the account. | Variation | What changes for you | |---|---| | Reference-list resource | The shared screen supports 11 resource values. | | Field type and form visibility | The field control can be a select box, text box, date box, number box, or collection text box, and appears in the popup when it is enabled for the form. | | Subscription | If the subscription excludes the feature, an upgrade surface replaces the grid. | | Edit access | The row edit control is available only when edit access is allowed. | | Delete access | The row delete control is available only when delete access is allowed. | | List columns | The list headers come from the selected reference-list configuration. | | Question collection | **Question** is available when a question collection is shown and enabled. | The options shown in **Category** and the maintenance controls available to you depend on your environment. Open **Category** to see the choices you can select before using the maintenance procedure above. ## When maintenance goes wrong Use the message you see to identify whether a required value, a character rule, or a deletion condition needs attention. | What you see | What it means | What to do | |---|---|---| | `Category is required` | **Category** has no selection. | Choose a value in **Category**. | | `This Field Is Required` | A required field is empty. | Enter or select the missing value. | | `Required` | A required collection-row value is empty. | Enter the required **Question** value in the row. | | `Just '_' '-' And '.' Characters Accepted` | The entered value does not meet the accepted character pattern. | Replace the value with one that uses the accepted characters. | | `Forbidden characters detected. Please remove them and try again.` | The entered value contains a forbidden character. | Remove the forbidden character. | | `Data saved Successfully` | A new entry was saved. | Check the refreshed list for the entry. | | `Data updated Successfully` | An existing entry was updated. | Check the refreshed list for the updated row. | | `Data Deleted Successfully` | The selected row was deleted. | Check the refreshed list. | | `Related to Saved data, Can't be deleted` | The selected row is related to saved data. | Keep the row and remove or change the related saved-data dependency through its owning configuration. | | `Failed to Delete` | The deletion did not complete. | Keep the row, then retry after checking that delete access is available. | | `Must have at least one item` | The list cannot be reduced below one item. | Keep at least one item in the list. | | Delete is unavailable when only one item remains | The last item cannot be deleted. | Maintain the remaining item. | > **Note:** The delete success and failure messages apply to the row-delete action when it is available. ## After maintaining reference categories After a successful maintenance action, the Reference categories list is refreshed. Use it to review the resulting category rows. Reference categories supply categories and questions to [Reference-category question units](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reference-list-reference-category-question-units-view). For another resource in the same area, open [Serial Status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reference-list-reference-serial-status-view). # Reference category question units ## Reference category question units A reference category question-unit entry connects one Reference list category and one of that category's questions to one or more units. Use this page when a question needs unit data that you maintain separately from the category and question definitions. Open **Configuration**, then **Reference list**, to maintain these entries. The list uses **Category** and **Question** as its visible columns. | If you need to… | Go to | |---|---| | Check the current entries and available actions | [Find and review the list](#find-and-review-the-list) | | Check required fields and conditional surfaces | [Understand the fields and rules](#understand-the-fields-and-rules) | | Add or change a category question's units | [Add or edit an entry](#add-or-edit-an-entry) | | Remove an entry or understand why an action is unavailable | [Delete an entry and handle availability](#delete-an-entry-and-handle-availability) | | Review the categories and questions used here | [Reference categories](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reference-list-reference-category-view) | | Open another Reference list configuration surface | Serial Status | | Return to the configuration entry point | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) | ## Before you start This page maintains reference data: entries that support other configuration records. The list and its maintenance actions depend on your account access, subscription, existing records, and the reference data available to select. **Prerequisites** - Sign in before opening the configuration area. - Use a subscription that includes this feature. If the subscription excludes it, an upgrade surface replaces the list. - Have a saved entry before opening it for editing. - Confirm that the action you need is available for your account. **New**, row edit, and row delete appear only when your access permits them. - Know the category and question you need to connect. **Category** options come from the reference-category service, and **Category qustion** options come from the selected category's questions. The available category and question values depend on the reference data in your environment. Select the category before choosing the question so that the question choices correspond to it. ## Find and review the list Use this procedure to open the question-unit list and identify its records and controls. **Prerequisites** - You are signed in. - Your subscription includes the Reference list feature. - You have access to the Configuration area. **Steps** 1. Open **Configuration**. 2. Open **Reference list**. 3. Open **Categories question unit**. ![Identify the Category and Question columns, the Count: 4 record count, and the list actions.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/1f5fea8483dcab810e7c6af9289befaa.png) 4. Check the list headers. | What you need to recognize | What appears | |---|---| | Category column | **Category** | | Question column | **Question** | | Current record count | `Count: 4` | | Create action | **New** | | Refresh action | **Refresh** | | List settings action | **Settings** | 5. Select **New** to open the new-item popup when it is available. 6. Select the available action for the task you need. | If you need to… | Select… | Result | |---|---|---| | Export the list | **Export** | Export options open. | | Edit a saved row | The row's edit action | The row opens for editing. | | Delete a saved row | The row's delete icon | A confirmation prompt opens. | **Result:** You can identify the **Category** and **Question** columns, the current count, and the actions shown on the page. ## Understand the fields and rules A question-unit row shows its selected category and question in the list. Its unit values are maintained in the new/edit form. The fields and list columns are described below. | Surface | Field or control | Rule or visibility | |---|---|---| | Entry form | **Category** | Required. Its options come from the available reference categories. | | Entry form | **Category qustion** | Required. Its options depend on the selected category's questions. | | List | **Category** | Optional text column. | | List | **Question** | Optional text column. | | Entry form | **Category questions unit** | Required collection. | | Unit row | **Unit** | Required for each unit row. | | Unit list | **Add more** | Adds another unit row. | The **Category** and **Category qustion** selectors appear in the popup for a new or existing entry. Log history appears only while editing an identified item. Other columns and labels depend on your list configuration, so use the headers visible on your screen. Unit values appear in the form rather than in the list. ## Add or edit an entry Use a question-unit entry to associate a selected category and question with one or more units. The new form prepares one unit entry; additional rows let you maintain more units for the same category-question connection. The next section explains how to remove an entry if it is no longer needed. **Prerequisites** - The question-unit list is open. - **New** is available for a new entry, or a saved row and edit access are available for an edit. - You know which category and question to connect. **Steps** 1. Select **New**, or select the edit action for a saved item to open it in edit mode. | If you need to… | Select… | |---|---| | Prepare a new item | **New** | | Change a saved item | The row's edit action | 2. In **Category**, select the category for the entry. 3. In **Category qustion**, select the question belonging to the selected category. 4. In **Category questions unit**, maintain the unit rows. 5. In each **Unit** row, enter the unit value. 6. Choose the action that matches the state of the entry. | If you need to… | Select… | |---|---| | Add another unit row | **Add more** | | If you are ready to commit | **OK** | | Close without committing | **Cancel** | The `New Question unit` popup shows required **Category**, **Category qustion**, and **Category questions unit** fields. The **Unit** rows appear for the selected question. **Result:** The new or selected question-unit item is submitted through the shared popup, or the popup closes when you select **Cancel**. A successful new entry uses `Data saved Successfully`; an update uses `Data updated Successfully`. ## Delete an entry and handle availability Deleting removes the selected question-unit row after confirmation. The action can be hidden by permissions, replaced by an upgrade surface, refused because related saved data exists, or blocked when at least one item must remain. | If | Then | |---|---| | Your access permits deletion | The delete action is available for a row. | | Your access does not permit deletion | The delete action is unavailable. | | The subscription excludes the feature | An upgrade surface replaces the list. | | Related saved data uses the row | Deletion can be refused. | | Deleting would leave no items | The minimum-item guard blocks deletion. | **Prerequisites** - The list is available. - A row is selected. - Delete access is available. **Steps** 1. Select the delete action for the entry you want to remove. 2. Read the confirmation prompt: `Are you sure you want to delete this item?` 3. Choose the action that matches your decision. | If you want to… | Select… | |---|---| | Close the confirmation without deleting the row | **Cancel** | | Confirm removal | **Delete** | | If the screen shows… | Then… | |---|---| | `Related to Saved data, Can't be deleted` | Keep the row and resolve the relationship in its owning configuration. | | `Must have at least one item` | Keep at least one row. | **Result:** After confirmation, the selected row is deleted and the success message is `Data Deleted Successfully`. If your access or subscription removes the action, the delete action does not appear. ## When saving or deleting goes wrong Use the exact message on screen to identify whether the form needs a required value, an accepted character, or a deletion condition to be addressed. After resolving it, continue with the maintenance procedure above. | Message | Condition or action | |---|---| | `Required` | A required unit collection value is empty. Enter the missing **Unit** value. | | `This Field Is Required` | A required field is empty. Complete the missing field. | | `Just '_' '-' And '.' Characters Accepted` | The value does not meet the accepted character pattern. Replace it with an accepted value. | | `Forbidden characters detected. Please remove them and try again.` | A filter value contains a forbidden character. Remove it and submit the filter again. | | `Related to Saved data, Can't be deleted` | Related saved data prevents deletion. Keep the row and resolve the relationship in its owning configuration. | | `Failed to Delete` | The deletion did not complete. Keep the row and check that delete access is available before retrying. | | `Must have at least one item` | The list cannot be reduced below one item. Keep at least one row. | | `As a developer, you may have greater privileges to change one or more item.` | Your account has elevated maintenance privileges. Follow your organisation's access rules when changing an item. | ## After maintaining the list Review the question-unit list after a maintenance action to confirm the category-question unit entries. | Action | Declared result | |---|---| | Create an entry | `Data saved Successfully` | | Update an entry | `Data updated Successfully` | | Delete an entry | `Data Deleted Successfully` | The current page remains the question-unit maintenance surface after the action. Use the list shown there to review the records available after the action. For the categories and questions used by this page, open [Reference categories](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reference-list-reference-category-view). For another shared Reference list surface, open Serial Status. To return to the configuration entry point, open [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home). # Reference serial status ## Reference serial status A serial status is a name in the configurable list that describes the status of a serial combination. Maintain it in the **Status** field, then use the saved name in serial-combination configuration. | If you need to… | Go to | |---|---| | Check the list and identify an existing status | [Find serial statuses](#find-serial-statuses) | | Understand the list column and required field | [Understand the serial-status screen](#understand-the-serial-status-screen) | | Choose an add, edit, or remove path | [Add, edit, or remove a serial status](#add-edit-or-remove-a-serial-status) | | Add a new status | [Add a serial status](#add-a-serial-status) | | Change an existing status | [Edit a serial status](#edit-a-serial-status) | | Remove a status | [Remove a serial status](#remove-a-serial-status) | | Check why an action or field is unavailable | [Handle access and action branches](#handle-access-and-action-branches) | | Correct a validation or deletion problem | [When validation or deletion fails](#when-validation-or-deletion-fails) | | Continue with serial-combination configuration | [Serial combinations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-serial-combinations-view) | | Continue with product-combination configuration | [Product combinations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-product-combination-view) | ## Before you start Reference serial status maintenance is available through the shared configuration list when the subscription includes the feature and your permissions allow the action. **Prerequisites** - The subscription includes the configuration feature. - You know the serial-status name to enter in **Status**. - For an edit or deletion, a saved serial-status row exists. - The required permission is available for the action you need. The **Status** field appears in the new/edit popup after you select an item or open a new-item form. Permission-dependent actions appear when the corresponding permissions allow them. ## Find serial statuses The serial-status list is the configuration page where you locate the status name attached to a serial combination. **Prerequisites** - The subscription includes the configuration feature. - You can open the Configuration area. **Steps** 1. Open **Configuration**. 2. Open **Reference list**. 3. Open **Serial status**. ![Identify the Serial status page, the Status column, and the available list controls.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/51485e61ae2f136aec912e0a3380ab0b.png) 4. Check the **Status** column to identify the row you need to maintain. 5. Use the row's status name to distinguish it from the other entries. The page heading is **Serial status**. The list contains seven records in the **Status** column. The visible list controls are **New**, **Refresh**, and **Settings**; **Refresh** and **Settings** are title-only buttons. **Result:** The Serial status list is open, and you can identify an existing row by its **Status** value. ## Understand the serial-status screen The serial-status screen presents the status name in the list and in the maintenance popup. **Status** is the required value for each entry. | Surface | What you use it for | Rule or visibility | |---|---|---| | **Status** | Read or enter the serial-status name. | Visible list column and text field; required in the form. | | Display order | — | Hidden column. | | Id | Identify the record internally. | Hidden identifier column. | | CompanyBranchID | — | Hidden column. | No other field appears on this page. Available columns may differ between configuration lists, so use the headers visible in your list. The list view does not display labelled form fields, validation messages, or dialogs. The **Status** field appears as a text box in the new/edit popup for a selected item. ## Add, edit, or remove a serial status Choose whether you are creating a new status, changing a saved row, or starting its removal. **Prerequisites** - The Serial status list is open. - For a new status, **New** is available. - For an edit, a saved row and edit permission are available. - For a removal, a saved row and delete permission are available. **Steps** 1. Choose the action that matches the work you need to do. | If you need to… | Select | Continue with | |---|---|---| | Create a status | **New** | [Add a serial status](#add-a-serial-status) | | Change a saved status | The edit control in the row | [Edit a serial status](#edit-a-serial-status) | | Start removing a saved status | The row's Delete icon | [Remove a serial status](#remove-a-serial-status) | **Result:** The new-item form, edit form, or row delete menu opens for the action you selected. ### Add a serial status Create a status name for later serial-combination work. **Prerequisites** - The Serial status list is open. - **New** is available. - You know the serial-status name to enter. **Steps** 1. Select **New** to open the new-item form. 2. In **Status**, enter the serial status name. 3. Select **OK** to submit the new popup. 4. If the form shows `Forbidden characters detected. Please remove them and try again.`, remove the forbidden characters from **Status**. 5. Select **OK** again after the value satisfies the field rule. **Result:** A successfully saved entry displays `Data saved Successfully`, and the serial-status list is available for checking the new row. ### Edit a serial status Change the name on an existing serial-status row. **Prerequisites** - The Serial status list is open. - The saved row is visible. - Edit permission is available. **Steps** 1. Select the edit control in the row to open the edit form. 2. In **Status**, change the serial status name. 3. Select **OK** to submit the edit popup. **Result:** A successfully updated entry displays `Data updated Successfully`, and the list is available for checking the revised **Status** value. ### Remove a serial status Remove a selected serial status when deletion is allowed. **Prerequisites** - The Serial status list is open. - The row to remove is visible. - Delete permission is available. **Steps** 1. Select the row's Delete icon to open the row delete menu. 2. Choose the outcome you need. | If you want to… | Select | |---|---| | Keep the row | **Cancel**. The delete menu closes and the row remains. | | Remove the row | **Delete**, then confirm `Are you sure you want to delete this item?`. | **Result:** A successful removal displays `Data Deleted Successfully`, and the list is available for checking that the selected status is no longer present. ## Handle access and action branches The shared configuration list changes which surfaces appear according to subscription inclusion and your permissions. | Condition | What changes | |---|---| | The subscription includes the feature | The configuration grid can appear. | | The subscription includes the feature and the new-item control is not hidden | **New** can appear. | | Editing permission is granted | The edit control in the row can appear. | | Deleting permission is granted | The row Delete menu can appear. | | Export permission is granted | **Export** can appear. | | Import permission is granted | Import controls can appear. | The list showed **New**. Import, export, edit, and delete actions depend on your permissions. **Steps** 1. If **Export** is available, select **Export**. 2. Select **Export to Excel**. 3. Select **Cancel** to close the export options. **Result:** The available action surface reflects the subscription and permissions for the account, and the export options are closed after **Cancel**. ## When validation or deletion fails Use the message shown on screen to identify whether the value needs correction, the selected row is protected, or the deletion could not complete. | What you see | What it means | What to do | |---|---|---| | `Status is required` | **Status** has no value. | Enter the serial status name in **Status**, then submit the popup again. | | `Forbidden characters detected. Please remove them and try again.` | The value contains a forbidden character. | Remove the forbidden character from **Status**, then select **OK**. | | `Related to Saved data, Can't be deleted` | The selected status is related to saved data. | Keep the status and address the related saved data before attempting removal again. | | `Failed to Delete` | The deletion did not complete. | Keep the row and investigate the deletion condition or permission before retrying. | | `Must have at least one item` | The list cannot be reduced below one item. | Keep at least one status in the list. | | `Data saved Successfully` | The new status was saved. | Check the list for the new **Status** value. | | `Data updated Successfully` | The existing status was updated. | Check the list for the revised **Status** value. | | `Data Deleted Successfully` | The selected status was deleted. | Check the list to confirm the row is gone. | When a save fails at the server, the screen displays parsed server error text. The exact wording depends on the server response. ## After maintaining a serial status After maintaining a status, continue with [Serial combinations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-serial-combinations-view) or [Product combinations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-product-combination-view) when your next task is to configure the serial-combination relationship. # Serial combinations ## What serial combinations are A serial combination is the configuration that determines the component sequence used for new job numbers. The list is the entry point; the detail record is where you review fields, maintain component rows, and review audit history. Changes apply only to new jobs; old jobs are not affected. | If you need to… | Go to | | --- | --- | | Locate a combination and open its detail record | [Find and open a serial combination](#find-and-open-a-serial-combination) | | Read the list columns and empty state | [Understand the list and configuration fields](#understand-the-list-and-configuration-fields) | | Review product-specific serial options | [Product serial combination fields](#product-serial-combination-fields) | | Interpret the detail form fields | [Serial combination form fields](#serial-combination-form-fields) | | Add, change, reorder, delete, and save component rows | [Maintain a serial combination](#maintain-a-serial-combination) | | Check access, subscription, and close branches | [Handle access branches and failures](#handle-access-branches-and-failures) | | Match a validation or save message to an action | [When the screen does not behave as expected](#when-the-screen-does-not-behave-as-expected) | | Review the detail record and audit history | [What to do next](#what-to-do-next) | | Open the separate product serial-combination options | [Product serial combinations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-product-combination-view) | | Return to the configuration starting point | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) | ## Before you start The serial-combination feature controls whether this configuration is available. Edit permission controls whether you can maintain it. **Prerequisites** - Confirm that the serial-combination feature is included in your subscription. - Have edit permission when you need **Save**, **Component**, the close action, or a delete action. - Know which serial type you need to review. - Have access to the audit information when you need the audit area. The audit area is conditional. When its audit condition is met, **Last Modifications** is available for the selected combination. ## Find and open a serial combination Use the list to locate a serial combination, then open its detail record for field work. **Steps** 1. Open the serial-combination list from the configuration area. ![Check the serial-combination list and initial grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/896ba20e4e57f1a89b09ed4aeb460bc5.png) 2. In the grid header, enter a keyword in **Keyword to Search...**. 3. Select the row you want to inspect. Selecting a data row opens its detail record unless you select the edit action. 4. To open the selected row directly for editing, select its icon-only edit action. 5. To open a serial type from the detail screen, select its serial-type link. | Serial number | Select | | --- | --- | | Job | **Job No.** | | Offer | **Offer No.** | | Order | **Order No.** | | Invoice | **Invoice No.** | | Payment | **Payment No.** | | Buyout | **Buyout No.** | | MRQ | **MRQ No.** | | Package | **Package No.** | | Purchase order | **Purchase Order No.** | | Received shipment | **Received shipment No.** | | Inspected order | **Inspected Order No.** | | Shipping order | **Shipping order no.** | | Assembly order | **Assembly order no.** | | Transfer order | **Transfer order no.** | | Service order | **Service order no.** | | Issue note | **Issue note no.** | | Delivery note | **Delivery note no.** | | Cost transaction | **Cost transaction no.** | | Outgoing payment | **Outgoing Payment** | **Result:** The selected serial-combination detail screen is open, or the list is filtered to the keyword you entered. Continue with the list and field reference below. ## Understand the list and configuration fields The list is a table for locating combinations. It has no labelled data-entry form; component maintenance belongs to the selected detail record. | What you see | What it means | | --- | --- | | **Name** | The serial type name. | | **Serial Combination** | The serial-combination value. | | `No data` | The list contains no rows for the current view. | The list displays **Name** and **Serial Combination**. It displays no labelled form controls, validation groups, dynamic column sets, or mounted new, delete, import, or export actions. ### Product serial combination fields Product serial combination is the separate configuration for product serial formatting. It is maintained on the separate [Product serial combinations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-product-combination-view) page, not as fields on this list. The product page owns **Category code**, **Auto serial**, and **Separator**. On this screen, use the serial-type links to open the combination for a selected number type. ### Serial combination form fields The detail form builds the number from ordered rows. Each row uses **Serial Component**, **Digits**, and **Default Value** according to the selected component. | Field | Choices or display | When it applies | | --- | --- | --- | | **Serial Component** | The component shown for the row. | Choose the component for the row. | | **Digits** | An available digit count. | Use it when the row requires a digit count. | | **Default Value** | A text box for the row's default text. | Enter a value when the row requires one. | The required rules for **Serial Component** and **Digits** are configurable. Treat a field as required when the screen marks it required for your configuration. **Uploaded file** belongs to shared import mode; this page has no import launcher. The field reference leads into the ordered-row procedure below. ## Maintain a serial combination Maintain the detail record as an ordered sequence of component rows. The sequence determines how new job numbers are assembled, so an incorrect row or order changes future new job numbers. **Prerequisites** - Open the combination for the serial type you need. - Have edit permission. - Know the component order and values required for new jobs. Use this table while adding or changing rows: | If… | Then… | | --- | --- | | You need another row | Select **Component**. | | **Serial Component** is available | Select the component required for the row. | | **Digits** is shown | Select an available digit count when the row requires one. | | The row requires a default | Enter its text in **Default Value**. | | The sequence is wrong | Drag the rows to their required positions. | | The row is an empty new row | Use its row deletion action. | | The row is populated | Open its delete dropdown. | | The populated-row delete dropdown is open and you want to remove the row | Select **Delete**. | | The populated-row delete dropdown is open and you want to keep the row | Select **Cancel**. | The populated-row confirmation message is `Are you sure you want to delete this row?`. Use exactly one **Auto serial** row, place it last, keep its value numeric, and keep the complete combination at 12 characters or fewer. **Steps** 1. Apply the row choice in the table above for each component in the required sequence. 2. Drag the **Auto serial** row to the last position. 3. Confirm that there is one numeric **Auto serial** row and that the combination is no longer than 12 characters. 4. Select **Save** to validate and save the combination. The defined save messages are `Your combination number saved successfully`, `Your Custom Job Number Combination Saved Successfully`, `Saving Failed`, and `Saving failed`. **Result:** The maintained rows are submitted through **Save** when validation passes. Any change to the combination applies only to new jobs. Continue with the access table if a control or close action is unavailable. ### Add or edit component rows Use one row for each part of the number. **Digits** and **Default Value** change with the selected component, so review each row before saving. **Prerequisites** - Open the serial-combination detail record. - Have edit permission. Use exactly one **Auto serial** row, place it last, keep its value numeric, and keep the complete combination at 12 characters or fewer. **Steps** 1. Select **Component** to add a row. 2. In **Serial Component**, select the component required for the row. 3. In **Digits**, select an available digit count when the field is shown. 4. In **Default Value**, enter the row's default text when the row requires a value. 5. Drag each row to its required position in the sequence. 6. Use the row deletion action to remove an empty new row. 7. Open the delete dropdown for a populated row. 8. Select **Delete** to remove the populated row. 9. Drag the **Auto serial** row to the last position. 10. Select **Save** after confirming that there is one numeric **Auto serial** row and that the combination is no longer than 12 characters. **Result:** The component rows show the required sequence, with one numeric **Auto serial** row at the end, ready for **Save**. ## Handle access branches and failures Use the branch that matches what is on your screen before continuing the combination work. | If… | Then… | | --- | --- | | The serial-combination feature is not included | A subscription-upgrade surface appears. | | Edit permission is allowed | **Save**, **Component**, the close action, delete actions, and the reset action are available according to their screen conditions. | | Edit permission is not allowed | Edit-dependent maintenance controls are unavailable. | | Audit information is available for the selected record | **Last Modifications** and log history are available. | | You changed the combination before closing | The shared exit popup opens. | | You made no change before closing | The screen closes directly. | | A new row is empty | Its direct row deletion action is used. | | A row is populated | Its delete dropdown contains **Cancel** and **Delete**. | If the reset action is available, select its icon to restore the default combination. The product messages for this action are `Set to Default Successfully` after success and `Setting to Default failed` after failure. The shared log-history **ActionTypes** control is not available on this screen. ## When the screen does not behave as expected Use the message or surface you see to choose the correction. When the list shows `No data`, there is no row to open for populated-row editing or reset. | What you see | What to do | | --- | --- | | `Component is required.` | Select a component in **Serial Component**. | | `Invalid component.` | Select a valid **Serial Component** option. | | `Quantity is required.` | Select a value in **Digits** when the row requires a character count. | | `Invalid quantity.` | Select a valid **Digits** value for the selected component. | | `Please add serial components` | Add a row with **Component**. | | `Serial type is required` | Select a serial type before saving. | | `Please select a serial type` | Select one of the serial-type links. | | `Please Note that you can't add serial combination larger than 12 characters` | Reduce the total combination length to 12 characters or fewer. | | `Cannot have multiple Auto Serials` or `Cannot have Multiple AutoSerials` | Remove the additional **Auto serial** row. | | `Must have one Auto Serial` | Add one **Auto serial** row. | | `Auto Serial must be the last item` | Drag the **Auto serial** row to the last position. | | `Auto Serial Must Be a Number` | Correct the value used for the **Auto serial** row. | | `Are you sure you want to delete this row?` | Confirm that the selected row is the one you intend to remove. | | `Your combination number saved successfully` or `Your Custom Job Number Combination Saved Successfully` | The combination-number save branch completed. | | `Saving Failed` or `Saving failed` | Correct the combination and select **Save** again. | | `[object Object]` | Close the alert and return to the screen. | ## What to do next After locating a row, open its detail record to review or maintain the component sequence. From the detail record, open **Last Modifications** when the audit condition is available to review the chronological user actions, including entries such as `Created` and `1 Changes`. For product-specific serial formatting, continue to [Product serial combinations](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-product-combination-view), where **Category code**, **Auto serial**, and **Separator** belong. Return to the [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) when you need another configuration area. # Serial combination details ## Serial combination details A serial combination is the ordered component configuration that PAMS uses to build a serial number. This page maintains the combinations for the loaded serial types, including job, offer, order, invoice, payment, buyout, MRQ, package, purchase order, received shipment, inspected order, shipping order, assembly order, transfer order, service order, issue note, delivery note, cost transaction, and outgoing payment numbers. Changes apply only to new jobs; old jobs are not affected. | If you need to… | Go to | | --- | --- | | Open a combination and choose the serial type to inspect | [Find a serial combination](#find-a-serial-combination) | | Identify the component-list columns and available actions | [Understand the combination screen](#understand-the-combination-screen) | | Add, reorder, edit, delete, or save component rows | [Maintain a serial combination](#maintain-a-serial-combination) | | Check why a control or tab is different | [Handle access and screen variations](#handle-access-and-screen-variations) | | Correct a validation, deletion, or save result | [When saving or deleting goes wrong](#when-saving-or-deleting-goes-wrong) | | Review audit history after maintenance | [After maintaining a combination](#after-maintaining-a-combination) | | Locate a combination before opening its details | Serial combinations list | | Review the separate product serial combination options | Product serial combinations | ## Before you start The serial-combination feature controls whether this page is available. Permission to edit serial combinations controls whether its maintenance actions are available. **Prerequisites** - Confirm that the serial-combination feature is included in your subscription. - Have permission to edit serial combinations when you need **Save**, **Component**, the close action, or a delete action. - Know which serial type you need to review. The route parameter selects that serial type. - If you need audit history, confirm that it is enabled for your account and company branch. ## Find a serial combination Open the details page from the serial-combinations list, choose a serial type, and then continue to [Understand the combination screen](#understand-the-combination-screen). **Prerequisites** - Know the serial type you want to inspect. **Steps** 1. Open **Configuration**. 2. Select **Serial Combinations**. 3. Select the link for the serial number you need to maintain. | Serial number you need to maintain | Select | | --- | --- | | Job | **Job No.** | | Offer | **Offer No.** | | Order | **Order No.** | | Invoice | **Invoice No.** | | Payment | **Payment No.** | | Buyout | **Buyout No.** | | MRQ | **MRQ No.** | | Package | **Package No** | | Purchase order | **Purchase Order No.** | | Received shipment | **Received Shipment No.** | | Inspected order | **Inspected Order No.** | | Shipping order | **Shipping Order No.** | | Assembly order | **Assembly Order No.** | | Transfer order | **Transfer Order No.** | | Service order | **Service Order No.** | | Issue note | **Issue Note No.** | | Delivery note | **Delivery Note No.** | | Cost transaction | **Cost Transaction No.** | | Outgoing payment | **Outgoing Payment** | 4. Review the combination for the selected type. **Result:** The details page opens for the selected serial type, with its component list and maintenance actions visible. ## Understand the combination screen The component list shows the ordered rows that make up the selected serial combination. Each row can contain a serial component, a digit count where applicable, and a default value where needed. | What you need to identify | What appears on the screen | | --- | --- | | Component selected for a row | **Serial Component** | | Character count for a row | **Digits** | | Fixed text or another row value | **Default Value** | | Number of rows reported | `Count: 4` | | Add a component row | **Component** | | Save the combination | **Save** | | Refresh the displayed data | **Refresh** | > **Note:** Serial combination changes apply only to new jobs; old jobs are not affected. The **Last Modifications** tab opens the audit area when the audit condition is met. The audit area provides a chronological sequence of actions performed by users and includes dated entries such as `Created` and `1 Changes`. ![Identify the component list, its columns, row count, and actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3b623cb6d5ba41ecc4b78b52bd409453.png) Continue with [Maintain a serial combination](#maintain-a-serial-combination) when you are ready to change the rows. ## Maintain a serial combination Treat the rows as an ordered recipe: each row contributes a component, a digit count where applicable, and a default value where needed. **Save** checks the combination before saving it. **Prerequisites** - Open the combination for the serial type you need. - Have permission to edit serial combinations. - Know the component order and values required for new jobs. **Steps** 1. Select **Component** to add a serial-combination row. 2. In **Serial Component**, select the component that matches the row's purpose. | Component purpose | Select | | --- | --- | | Year component | **Year** | | Automatically generated serial portion | **auto serial** | | Fixed text portion | **text** | 3. Complete the row's available values. | If the row needs… | Do this | | --- | --- | | A digit count | In **Digits**, select an available choice for the selected component. Components that do not use a digit count do not offer this choice. | | A default value | In **Default Value**, enter the row's default text. A text box is provided for non-**text** components and another is provided for the **text** component. | 4. Drag and drop the rows into the order required for the serial number. 5. Remove an empty new row with its row deletion action. 6. Open the delete dropdown for a populated row. | If you need to… | Select | | --- | --- | | Close the dropdown without deleting the row | **Cancel** | | Remove the populated row | **Delete** | 7. Select **Save** to check and submit the combination. **Result:** The rows are arranged and edited on the combination screen, and **Save** checks and submits the combination. If a control or tab differs, continue with [Handle access and screen variations](#handle-access-and-screen-variations). ## Handle access and screen variations Use the condition that matches your screen to choose the available path. | Condition | Screen or exit path | | --- | --- | | The serial-combination feature is not included | A subscription-upgrade surface appears. | | Edit permission is allowed | **Save**, the close action, the delete affordance, and **Component** are available according to their screen conditions. | | Edit permission is not allowed | The edit-dependent controls are not available for maintenance. | | A different serial type is selected | The selected type's status and combinations appear. | | Audit history is enabled for your account and company branch | **Last Modifications** and log history are available. | | A change has been made before closing | The shared exit popup opens. | | No change has been made before closing | The screen closes directly. | The separate Product serial combination page contains `category code`, `auto serial`, and `separator`. Those options do not belong to this page. The log-history filter is not available here. If saving or deleting produces a message, use [When saving or deleting goes wrong](#when-saving-or-deleting-goes-wrong) to identify the result and correct the problem. ## When saving or deleting goes wrong Use the displayed text to identify whether the problem concerns a row, the combination, or the action. | What you see | What to check or do | | --- | --- | | `Component is required.` | Select a component in **Serial Component** for the row. | | `Invalid component.` | Select a valid **Serial Component** option. | | `Quantity is required.` | Select a value in **Digits** when the row requires a character count. | | `Invalid quantity.` | Select a valid **Digits** value for the selected component. | | `Please add serial components` | Add at least one row with **Component**. | | `Serial type is required` | Select a serial type before saving. | | `Please Note that you can't add serial combination larger than 12 characters` | Reduce the total combination length to 12 characters or fewer. | | `Please select a serial type` | Select one of the available serial-type links. | | `Cannot have multiple Auto Serials` or `Cannot have Multiple AutoSerials` | Keep only one **auto serial** row. | | `Must have one Auto Serial` | Add one **auto serial** row. | | `Auto Serial must be the last item` | Drag the **auto serial** row to the last position. | | `Auto Serial Must Be a Number` | Correct the value used for the **auto serial** row. | | `Are you sure you want to delete this row?` | Confirm that the selected row is the one to remove before completing the delete action. | | `Your combination number saved successfully` | The combination number is saved. | | `Your Custom Job Number Combination Saved Successfully` | The custom job-number combination is saved. | | `Saving Failed` or `Saving failed` | Review the combination and select **Save** again when the data is corrected. | The displayed confirmation and outcome text identifies what happened after the corresponding action. After the combination is saved or reviewed, continue with [After maintaining a combination](#after-maintaining-a-combination). ## Out of scope - **Uploaded file** belongs to the shared import popup; this screen has no import launcher. - `Registration` belongs to the log history component rather than this page. - `Upload` belongs to the shared import popup rather than this page. ## After maintaining a combination Review the audit sequence, then return to the serial-combination list to locate another combination. **Prerequisites** - Have audit history enabled for your account and company branch. - Open the details page for the serial type you reviewed. **Steps** 1. Select **Last Modifications**. 2. Review the chronological sequence of actions performed by users. 3. Check the dated entries, including `Created` and `1 Changes` when they are present. 4. Return to the serial-combination list when you need to locate another combination. ![Review the chronological audit entries](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/88c5c80fb113e15628e5953623fc4ba1.png) The audit area includes `Created` and `1 Changes`. Serial combination changes apply only to new jobs; old jobs are not affected. **Result:** The combination's audit history is available for review when the audit condition is met, and you can continue from the serial-combination list. # Targets and budgets ## Targets and budgets Targets and budgets groups booking, sales, and financial planning in separate main tabs. Use it to review planning rows for teams, vendors, account managers, and product types, and to work with COGS, SG&A, depreciation, FORX, and net profit budgets. | If you need to… | Go to | |---|---| | Choose the planning year and open a planning area | [Find the target or budget area](#find-the-target-or-budget-area) | | Identify the fields and columns in a planning table | [Understand the target and budget tables](#understand-the-target-and-budget-tables) | | Open an editor or work with distribution groups | [Maintain targets and budgets](#maintain-targets-and-budgets) | | Understand branch-specific rows and vendor history | [Handle branch and product-group variations](#handle-branch-and-product-group-variations) | | Resolve a validation, loading, import, export, or save message | [When validation or loading fails](#when-validation-or-loading-fails) | | Continue with branch setup | configuration-company-branchs-view | | Continue with product-type setup | configuration-company-product-types-view | | Continue with account-manager setup | configuration-account-managers-view | | Continue with team setup | teams | ## Before you start This page is available when the subscription includes it. The **Year** field, year-creation action, planning tabs, and branch columns can each depend on the subscription, permissions, feature availability, selected year, and branch data. **Prerequisites** - Have access to the configuration area and the subscription that includes the target and budget surface. - Know the year you need to review. The available values in **Year** come from the company's year data, and the initially selected value is the last returned year. - Have permission to create a year if you need **Next Year**. The action is available only when the subscription includes it, creation permission is present, and the maximum year has not been reached. - Confirm that the relevant feature is available. **Teams**, **Vendors**, **Account Managers**, and **Product Types** require **Booking Target**; **COGS**, **SG&A**, **Depreciation**, **FORX**, and **Net profit** require the Finance Target feature. - Expect branch columns to reflect the branch collections available for the company. > **Note:** A subsection can be unavailable even when the page itself opens. The > booking and finance subsection conditions are separate from the page entry > condition. ## Find the target or budget area The target and budget area groups booking planning, sales planning, and financial budget work. **Booking Target** groups booking planning by team, vendor, account manager, and product type. **Sales Target** provides the sales-target subsection, and **Financial Budget** groups the financial budget subsections. **Prerequisites** - Meet the conditions in [Before you start](#before-you-start). **Steps** 1. Open the Targets and budgets page. 2. In **Year**, choose the year to review. 3. Select the main tab for your work. | If you need to work with… | Select | |---|---| | Booking planning | **Booking Target** | | Sales planning | **Sales Target** | | Financial planning | **Financial Budget** | 4. If you selected **Booking Target**, select the booking subsection. | If you need to work with… | Select | |---|---| | Team targets | **Teams** | | Vendor targets | **Vendors** | | Account-manager targets | **Account Managers** | | Product-type targets | **Product Types** | 5. If you selected **Financial Budget**, select the budget subsection. | If you need to work with… | Select | |---|---| | Cost of goods sold | **COGS** | | Selling, general, and administrative costs | **SG&A** | | Depreciation | **Depreciation** | | Foreign exchange | **FORX** | | Net profit | **Net profit** | **Result:** The selected year and target or budget subsection are on screen. On entry, **Year** and **Booking Target** are visible. Selecting **Booking Target** shows the four booking subsections, and selecting **Financial Budget** shows the five financial-budget subsections. **Reference Commission** is absent on arrival. ## Understand the target and budget tables Each subsection presents a planning table for one business dimension. The row identity comes from the selected subsection; branch columns can change with the company's branch data. Work from the headers and labels visible in the selected table rather than from technical names. | Subsection | Planning table or surface | Known reader-facing fields or actions | |---|---|---| | **Vendors** | Vendor target table | Company rows, branch-dependent columns, an icon-only edit action, and **Last Modifications** when its history surface is available | | **Teams** | Team target table | Team rows, branch-dependent columns, and an icon-only edit action | | **Account Managers** | Account-manager target table | Account-manager rows, branch-dependent columns, and an icon-only edit action | | **Product Types** | Product-type target table | Product-type rows, branch-dependent columns, **Manage groups**, and an icon-only edit action | | **Sales Target** | Sales-target surface | Sales-target rows and an icon-only edit action | | **COGS**, **SG&A**, **Depreciation**, **FORX** | Financial budget tables | Budget rows, branch-dependent columns, and an icon-only edit action | | **Net profit** | Net-profit table | Net-profit rows and the values available for that selected subsection | The page has one named year field, **Year**. The editors also provide these labelled fields: | Field | Entry rule | |---|---| | **Reference Margin** | Number from 0 through 100 | | **Set target** for a product type | Required number with a minimum of 0 | | **Set budget** for SG&A | Required number with a minimum of 0 | | **Set budget** for depreciation | Required number with a minimum of 0 | | **Set budget** for FORX | Required number with a minimum of 0 | | **Set target** for product-type sales | Required number with a minimum of 0 | | **Set margin (%)** | Required number from 0 through 100 | | **Name** in the distribution-groups editor | Required text | | **Product types** in the group editor | Product-type selection | Some editor values appear without a field label: the two principal-target values, the team rule selectors, the team amount, the team total, and the account-manager target value. **Reference Commission** does not appear on arrival. The product-type, budget, and branch-related tables use dynamic column sets. Six sets are built from branch collections, so the complete list cannot be stated in advance. A branch column appears according to the branch data available to the company. Icon-only edit actions open the relevant target or budget editor for vendors, teams, account managers, product types, sales targets, COGS, SG&A, depreciation, and FORX. The action is available when its subsection is selected, a branch is open, and editing is allowed. ![Booking subsection tabs and the selected planning table](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0cd69369c86896a89609e71e9b5c2523.png) ## Maintain targets and budgets The maintenance surface opens an editor for the selected row. Enter values only in the fields that belong to that editor; the field rules differ between target, margin, budget, and group work. **Prerequisites** - Open the relevant year and subsection as described in [Find the target or budget area](#find-the-target-or-budget-area). - Open a branch before using an icon-only edit action or **Manage groups**. - For group work, have the product types that belong together ready to select. **Steps** 1. In the selected table, select the row's icon-only edit action. 2. Enter the value in the editor that matches your planning work. | Planning work | Editor field | |---|---| | Vendor target | The editor's principal-target value | | Team target | The editor's team rule, amount, or total value | | Account-manager target | The editor's account-manager target value; the value has a minimum of 0 | | Product-type target | **Set target** | | Product-type sales target | **Set target** | | Product-type margin | **Set margin (%)** | | COGS | The COGS budget editor | | SG&A | **Set budget** | | Depreciation | **Set budget** | | FORX | **Set budget** | | Net profit | The net-profit editor | 3. For product-type, sales-target, or COGS work, select **Manage groups** to open the product-type redistribution groups. 4. In the distribution-groups editor, select **Group**. 5. In **Name**, enter the group name. 6. In **Product types**, select the product types that belong to the group. 7. Select **Next Year** when the subscription, permission, and maximum-year conditions allow a new target year. If the year already exists, the page reports "You already have a booking target for " instead of creating another one. 8. Select **Export** to export the current list. These messages can appear while you maintain or export target and budget data: | Situation | Message | |---|---| | A supported save succeeds | `Data saved Successfully` | | A supported delete succeeds | `Data Deleted Successfully` | | A group or year is added more than once | `This year has been added before.` | | Import completes | `Data Importing completed` | | The selected list has no export data | `NO Data to Export` | **Result:** The selected editor or group surface contains the values you entered, or the selected list is ready for export. A successful maintenance result is represented by `Data saved Successfully` or `Data Deleted Successfully` when the corresponding operation completes. ![Product-type target fields and group entry point](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/674ae07fc5fbae0e4c9bcacf8b350026.png) ## Handle branch and product-group variations Branch variation is the branch-specific part of a target or budget table. Product groups collect product types for redistribution work, while **Last Modifications** provides the vendor history surface. **Steps** 1. Select the subsection that contains the planning rows. 2. Open a branch before selecting its icon-only edit action. 3. In **Product Types**, **Sales Target**, or **COGS**, select **Manage groups**. 4. Select **Group**. 5. In **Name**, enter the group name. 6. In **Product types**, select at least one product type. 7. In **Vendors**, select **Last Modifications** to open the vendor history surface. Branch panels and their columns vary with the company's available branches. The vendor history surface shows a loading indicator while its rows load. **Result:** The selected branch, product-group editor, or vendor-history surface is on screen. ![Vendor rows and the Last Modifications history surface](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2da9d2b9be66c4c227096fa3b68c0a92.png) ## When validation or loading fails Use the message on screen to choose the corrective action. If the team list cannot load, the visible message is "Error in get teams list for ". | What you see | What it means | What to do | |---|---|---| | `Forbidden characters detected. Please remove them and try again.` | A value contains a forbidden character. | Remove the forbidden character and submit the affected entry again. | | `Error in loading previous years` | Previous-year data did not load. | Reopen the year area and check whether the year data is available. | | The team list cannot load for the displayed year. | The team list could not load for the displayed year. | Check the selected year and retry the team subsection. | | `You reached Maximum Years` | The maximum number of years is reached. | Continue with an existing year instead of selecting **Next Year**. | | A booking target already exists for the displayed year. | A booking target already exists for the displayed year. | Select the existing year and maintain its target instead of creating another one. | | `Check validation` | The current editor values fail validation. | Review the required fields and their minimum or maximum rules, then correct the values. | | `Group must have at least one product type` | The group contains no selected product type. | Select at least one value in **Product types**. | | `Error in saving data` | The save operation returned a save error. | Review the editor values and retry. | | `Data Importing completed` | The import operation reports completion. | Review the resulting list before continuing. | | `NO Data to Export` | The selected list has no data to export. | Select a populated list and select **Export** again. | ## Confirm the result and continue After maintenance, confirm the result using the message or visible list state that appears after the action. Look for `Data saved Successfully`, `Data Deleted Successfully`, `Data Importing completed`, or `NO Data to Export`. Continue with the configuration page that supplies the planning dimension: | Continue with… | Page | |---|---| | Branch records | configuration-company-branchs-view | | Product types | configuration-company-product-types-view | | Account managers | configuration-account-managers-view | | Teams | teams | **Result:** You know which visible planning surface to review next and which maintenance outcomes remain dependent on the operation you perform. # Product serial combinations ## Product serial combinations Product serial combinations is the configuration screen where you set the serial components used when new products receive serial combinations. A serial component is one part of that combination. This is a reference screen for the product serial format, not a product-record detail page. | If you need to… | Go to | |---|---| | Check what the screen controls and which products it affects | [Product serial combinations](#product-serial-combinations) and [Understand the screen](#understand-the-screen) | | Check whether editing is available | [Before you start](#before-you-start) | | Open the screen | [Find the configuration screen](#find-the-configuration-screen) | | Add or adjust a serial component | [Add and adjust serial components](#add-and-adjust-serial-components) | | Save or leave your changes | [Save or leave changes](#save-or-leave-changes) | | Work with year, text, month, day, or numeric detail options | [Serial combination details](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-serial-combinations-record) | > **Note:** Changing this configuration does not alter serial combinations already > assigned to existing products. ![The Product serial combinations screen with its note and existing rows](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/dd3b87c0cb3b839673410375662b6ddd.png) ## Before you start Product serial combinations is available only when the subscription includes the screen and the current account has the appropriate editing state. | Before you start | What it controls | |---|---| | Your subscription includes the feature | The configuration screen is available. Otherwise, the upgrade surface appears. | | You can edit the configuration | **Save**, the close or leave icon in the screen header, and **Component** are available according to the screen state. | | Serial components are available | The grid and its **Serial Component** list can appear. | When the subscription does not include the feature, the screen shows the upgrade surface rather than the configuration grid. The upgrade surface includes **Back**. When editing is not allowed, the screen uses the leave icon in the screen header and does not provide **Component**. When editing is allowed, the screen provides the close icon and **Component**. ## Find the configuration screen **Prerequisites** - The application is available at its normal signed-in address. - The subscription includes Product serial combinations. **Steps** 1. Select **Product serial combinations** in the side menu. **Result:** The Product serial combinations screen opens. ## Understand the screen The screen presents the current serial-component rows in a grid so you can review the component type, its quantity setting, and its default value before changing the configuration. When a serial preview is available, it appears above the grid as the component values are assembled. The visible grid has these columns: | Column | What you use it for | |---|---| | **Serial Component** | Choose the component type for a non-empty row. | | **Digits** | Choose the quantity setting when the selected component type permits it. | | **Default Value** | Enter a value for a non-separator component or choose a separator value for a separator row. | | Unlabelled order column | Reorder rows with the row's drag handle. | | Final column | Use the actions available for the row. | The screen displays **Save** and **Component**. It opens without a loading spinner or an error page. There is no serial-type list on this screen. Serial-combination detail options such as year, text, month, day, and numeric quantities belong on [Serial combination details](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-serial-combinations-record). ![The grid headers, Save, and Component controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/50ea8f7469e9275a83c703f360ca2008.png) ## Add and adjust serial components Add a row or adjust the component type and value shown in an existing row. The available editors change with the selected component. **Prerequisites** - Editing is allowed. - The serial-component grid is available. **Steps** 1. Select **Component** to add a serial-component row. 2. In the new or existing row, select **Serial Component**. 3. Choose **category code** or another component type in **Serial Component**. A new choice initially shows **Select A Component** until you choose a type. 4. If the selected type provides a **Digits** list, choose its value. 5. If the selected type is **separator**, choose `-`, `_`, or `.` in the **Default Value** list. 6. If the selected type is not **separator**, enter the required free-text value in **Default Value** when one is needed. 7. If you choose **category code**, review the initial `XX` value in **Default Value**. 8. If you choose **Auto serial**, enter a numeric value in **Default Value**. The **Digits** list excludes the component types listed for this screen, so those component types do not provide a **Digits** choice here. **Result:** The row shows the selected serial-component type and the value editor appropriate to that type. The changes remain on the screen until you save or leave. ### Check the combination before saving The saved combination needs at least one component and one Auto serial. Auto serial must be the last component, and the total combination length must be no more than 12 characters. > **Important:** Saving a combination with more than one Auto serial, without an Auto > serial, with Auto serial before the last component, or with more than 12 > characters produces a validation message. Correct the component rows before selecting > **Save**. ## Save or leave changes Use **Save** to commit the configuration. To exit, use the close or leave icon in the screen header. | Screen state | Available control or behavior | |---|---| | Editing is allowed | **Save**, the close action, and **Component** are available. | | Editing is not allowed | The leave action is available instead of the editable close action. | | A save is in progress | **Save** is disabled while the screen is `Saving`. | | A shared unsaved-change popup opens | Its declared choices are save and close, cancel, and don't save. | **Prerequisites** - You have reviewed the rows and their values. - Editing is allowed if you need to use **Save** or **Component**. **Steps** 1. Select the action that matches your decision: | If you want to… | Select | |---|---| | Submit the configuration | **Save** | | Save the changes and close after the shared popup opens | **Save** | | Remain on the screen after the shared popup opens | **Cancel** | | Leave without saving after the shared popup opens | **Don't Save** | | Leave when you cannot edit the configuration | The leave icon in the screen header | **Result:** The screen closes or remains open according to the exit action you select. ## Handle unavailable and conditional surfaces The screen changes its available surfaces according to subscription, editing permission, and the selected component type. | Condition | Surface you see | |---|---| | The subscription does not include the feature | The upgrade surface with **Back**. | | The subscription includes the feature | The main configuration screen. | | Editing is allowed | **Save**, the editable close action, **Component**, and row editors can be available. | | Editing is not allowed | The leave action replaces the editable close action. | | A row is not empty | **Serial Component** is required. | | The component type permits digits | **Digits** can appear. | | The component type is **separator** | The **Default Value** separator list appears and is required. | | The component type is not **separator** | The **Default Value** text box branch applies. | | The row-end controls are shown | The row-end controls do not include **Delete**. | The **Last Modifications** surface is not available on this screen. ## When validation or saving goes wrong The following messages are tied to the conditions that raise them. Correct the row that fails validation before trying the save again. | Message | Condition or corrective action | |---|---| | `Component is required.` | A non-empty row has no component. Choose a value in **Serial Component**. | | `Invalid component.` | The component value is not valid. Choose a valid **Serial Component** value. | | `Quantity is required.` | A quantity is required for the row. Complete **Digits** when it is available. | | `Invalid quantity.` | The quantity value is invalid. Choose a valid quantity. | | `this is required.` | A separator row has no separator value. Choose `-`, `_`, or `.` in **Default Value**. | | `Auto Serial must be the last item In product serial` | Move Auto serial to the last serial component. | | `Cannot have multiple Auto Serials In product serial` | Remove the additional Auto serial component. | | `Must have one Auto Serial In product serial` | Add one Auto serial component. | | `Cannot have Multiple AutoSerials ` | The configuration contains multiple Auto Serial values. Keep one. | | `Please Note that you can't add serial combination larger than 12 characters In product serial` | Reduce the serial combination to 12 characters or fewer. | | `Please Note that you can't add serial combination larger than 12 characters ` | Reduce the serial combination to 12 characters or fewer. | | `Auto Serial Must Be a Number ` | Enter a numeric Auto Serial value. | | `Your combination number saved successfully` | The save completes successfully. | | `Saving Failed In product serial` | Saving failed; review the rows and try **Save** again. | | `Please add serial components In product serial` | Add a serial component with **Component**. | If the message does not match the row condition, stop before changing other rows. ## Out of scope Upload, import, confirmation, and subscription-upgrade dialog messages belong to the shared popup and subscription-upgrade surfaces. Use the owning surface when you need those messages. The serial-type messages belong to the serial-combination detail page: | Message | Owning surface | |---|---| | `Serial type is required In product serial` | Serial combination details | | `Please select a serial type In product serial` | Serial combination details | ## What happens next Use this configuration for products created after the change; existing products are not affected. For serial-combination detail options such as year, month, day, and numeric quantities, continue to [Serial combination details](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-serial-combinations-record). **Result:** You know which products the configuration affects and where to find the serial-combination detail options outside this screen. # Rating types ## Rating types Rating types define named sets of ratings and the rating values that belong to each set. The **Rating types** page owns these entries in the shared ISO configuration surface. | If you need to… | Go to | |---|---| | Check which rating types already exist | [Find a rating type](#find-a-rating-type) | | Read the list columns and form fields | [Understand the rating type screen](#understand-the-rating-type-screen) | | Create or change a rating type | [Create and maintain rating types](#create-and-maintain-rating-types) | | Remove an existing rating type | [Remove a rating type](#remove-a-rating-type) | | Resolve a validation, deletion, or save problem | [When maintenance goes wrong](#when-maintenance-goes-wrong) | | Continue with ISO survey questions | [Questions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-iso-survey-questions) | | Continue with customer satisfaction survey settings | [Customer satisfaction survey](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-iso-survey-model) | ## Before you start The list and the action for starting a new entry depend on your subscription and on whether the corresponding new-entry surface is available. **Prerequisites** - Sign in to the application. The route requires authentication. - Use a subscription that includes this configuration. With an included subscription, the rating-type list is shown; otherwise the shared subscription-upgrade surface is shown. - Confirm that the new-entry surface is available if you need to create a rating type. **New** appears only when the subscription is included and that surface is not hidden. ## Find a rating type The **Rating types** list is where you review the named rating sets already available for ISO survey configuration. **Prerequisites** - Meet the conditions in [Before you start](#before-you-start). **Steps** 1. Open the **Rating types** page. 2. Confirm that the page shows the **Type name** and **Rating** columns. 3. Find the rating type by its value in **Type name**. 4. Select the existing row when you need to maintain it. 5. Select **New** when you need to start a rating type that is not in the list. ![Identify a rating type from the Type name and Rating columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/a37e31f59bcff51f828e17006da3bd3f.png) **Result:** The **Rating types** list is open, and you have identified an existing rating type or opened the route for a new entry. Use the field reference below before creating or maintaining the entry. ## Understand the rating type screen A rating type is a named entry with a collection of text-and-number rating rows. The list identifies each entry with **Type name** and **Rating**; the form carries the name and the rows that describe its ratings. ### List and form fields | Where | Field or column | What it contains | |---|---|---| | List | **Type name** | The rating type name | | List | **Rating** | The rating information shown in the list | | Form | **Type name** | The required text field for the rating type | | Form | Rating row text | The required text value for one rating row | | Form | **Rating value** | The required numeric value for one rating row, from `0` through `100` | | Form | **Rating description** | The repeating rating-details collection shown in the form | Each rating row has a text input for its rating text and a number box labelled **Rating value**. The form shows **Rating description** as the repeating collection that contains those rows. Select **Add more** to add a row. The form has no select box, date box, or currency control. ![Review the Rating types list and its visible columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/cb963b19e79a84796088df7045e87667.png) Use these fields when you create or maintain a rating type. ## Create and maintain rating types **Prerequisites** - Meet the conditions in [Before you start](#before-you-start). - Know the name for the rating type and the text and numeric value for each rating row. - Start from the **Rating types** list. | If you are… | Start by… | |---|---| | Creating a rating type | Selecting **New** | | Maintaining an existing rating type | Selecting its row | **Steps** 1. Use the table to open the new or existing rating type. 2. In **Type name**, enter the name of the rating type. 3. In the rating row's text input, enter the text for the rating. 4. In **Rating value**, enter a number from `0` through `100`. 5. Select **Add more** for each additional rating row. 6. Enter the text and numeric value for each additional row. **Result:** The rating type's fields and rating rows are entered in the form. When saving completes, the application shows one of these messages: - `Data saved Successfully` for a new entry. - `Data updated Successfully` for an edited entry. After saving, return to the list to review the entry or remove it when it is no longer needed. ### Remove a rating type Delete a rating type when the existing entry is no longer needed. The delete action is available from the delete menu only when more than one item exists. **Prerequisites** - Meet the conditions in [Before you start](#before-you-start). - Have more than one rating-type item in the list. - Identify the rating type you intend to remove. **Steps** 1. Open the delete menu for the selected rating type. 2. Select **Delete**. 3. Read the result message before continuing. **Result:** A successful deletion shows `Data Deleted Successfully`. If the item is related to saved data, the application shows `Related to Saved data, Can't be deleted`. If the deletion fails for another reason, the application shows `Failed to Delete`. ## When maintenance goes wrong Use the message on screen to decide whether to complete a missing value, correct a rating value, remove forbidden characters, or review the deletion result. | What you see | What it means | What to do | |---|---|---| | `Required` beside a rating-row text input | The row text is required | Enter the rating text in that row | | `Required` beside **Rating value** | The row's numeric value is required | Enter a value from `0` through `100` | | `Forbidden characters detected. Please remove them and try again.` | The entry contains forbidden characters | Remove the forbidden characters and submit the form again | | `Must have at least one item` | The operation has no remaining item | Keep at least one item before continuing | | `Related to Saved data, Can't be deleted` | The selected item is related to saved data | Keep the item and continue without deleting it | | `Failed to Delete` | The delete operation failed | Review the entry and attempt the delete operation again | The **Export** branch exposes **Export** and **Filter Row** on the page. If the server rejects a save, the application displays the server's own explanation of the problem. The exact wording depends on the response returned by the server. ## After maintaining rating types After a successful save, the application reloads the list and closes the entry form. After a successful delete, the list reflects the removed rating type and shows `Data Deleted Successfully`. ## Continue with related ISO configuration Continue with the related ISO configuration entities: - Open [Questions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-iso-survey-questions) to maintain survey questions. - Open [Customer satisfaction survey](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-iso-survey-model) to maintain customer satisfaction survey configuration. # Questions The **Questions** configuration contains the questions used in the ISO survey configuration. Use this page to review the list or maintain a question entry. The page is limited to the Questions entity tab; the other entities available in the shared configuration surface are outside this page's procedure. | If you need to… | Go to | |---|---| | Confirm what the Questions page contains | [Questions](#questions) | | Check access and subscription conditions | [Before you start](#before-you-start) | | Find the list and confirm its current rows | [Find Questions](#find-questions) | | Identify fields and list behaviour | [List reference](#list-reference) | | Open a blank entry | [Open the new-entry dialog](#open-the-new-entry-dialog) | | Add or change a question | [Add or edit a question](#add-or-edit-a-question) | | Remove a row | [Delete a question](#delete-a-question) | | Start or cancel an export | [Export the Questions list](#export-the-questions-list) | | Continue to another configuration area | [Continue with related ISO settings](#continue-with-related-iso-settings) | ## Questions On this page, review the Questions list and maintain Question entries with their associated survey answers. This page contains the Questions entity tab. Use the related configuration page for another entity. > Note: Use the related configuration page when you need to maintain another entity. The > Questions page does not change the survey's stage. ![Review the Questions heading, list, and visible Question column.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2772f9961c5e3cf4f40e3377cfc312e3.png) ## Before you start Your subscription, permissions, and list columns determine which actions and fields appear. | Check | What to expect | |---|---| | Subscription | The grid is shown when the subscription includes this configuration. | | **New** | **New** is shown when the subscription includes this configuration and the new action is not hidden. | | Edit access | The edit action is shown when edit permission is available. | | List columns | The columns shown in your list determine which fields you can see. | | Answer choices | The **Select a answer** lookup presents the available choices. | Have the question text ready before opening a new entry. Choose the answer that belongs with the question from the **Select a answer** lookup. ## Find Questions The Questions list is the place to identify an existing question before you open, change, or remove it. **Prerequisites** - Have access to the Configuration area. - Have a subscription that includes the Questions grid. **Steps** 1. Open the Configuration area. 2. Select **Questions**. 3. Review the displayed rows before selecting an action. The **Questions** page displays seven question rows. The list summary shows `Count: 7`. **Result:** The **Questions** list is open, with the displayed rows and `Count: 7` available for identification. ## Understand the list and form The Questions page presents a list and a new or edit form. The form has two validation areas. Actions and fields appear when their access and configuration conditions are met. | Surface | What changes it | |---|---| | Grid | Shown when the subscription is included. | | **New** | Shown when the subscription is included and the new action is not hidden. | | Edit action | Shown when edit permission is available. | | New/edit popup | Opens for a new or editable item. | | **Question** | Shown in the popup when the selected configuration column is visible in the form and is a text box. | | Answer lookup | Shown when the Questions form includes the answer field. | | Log history | Shown only while editing an identified item. | The page provides **New**, the edit and delete row icons, **Save**, **Cancel**, and **Export**. The **Select a answer** field uses its lookup to present the available choices. A new entry opens with **Question** and **OK**. ### List reference The Questions form has two entry fields. The remaining values are data values associated with the row rather than fields that you enter in this form. The **Question** field is a required text box that appears in the form and list. | Name | Type | Form | Grid | Required or value behaviour | |---|---|---|---|---| | Select a answer | Select box | Visible | Hidden | Required; the lookup presents the available choices | | Display order | Data value | Not in the form | Hidden | No validation | | Id | Data value and identifier | Not in the form | Hidden | No validation | | Company ID | Data value | Not in the form | Hidden | No validation | The list shows one column, **Question**. Column headers, paging, the row-filter, and the header-filter are disabled. Work from the headers that are visible in your list. ## Open the new-entry dialog Use the new-entry dialog when you want a blank Questions entry without changing an existing row. **Prerequisites** - Be on the Questions list. - Have a subscription that includes the grid. - Have **New** available; the action is hidden when the new-action setting hides it. **Steps** 1. Select **New**. The `New Question` dialog opens with the **Question** field, its required marker, and an **OK** button. **Result:** A blank `New Question` dialog is open, ready for the question entry. ![Enter a question in the New Question dialog.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/8d2bb02cfdc9aabff8149ff8198a0d59.png) ### Add or edit a question Use this procedure to create a new Question entry or change an existing one. Enter the required question text and select a value from the **Select a answer** lookup. **Prerequisites** - For a new entry, open the `New Question` dialog. - For an existing entry, have edit permission and open the row with the edit action. - Have the question text and the intended survey answer ready. **Steps** 1. In the first form field, enter the question in **Question**. 2. Confirm the required marker on **Question**. 3. Open the **Select a answer** lookup. 4. Select the required answer. 5. Choose the action for the entry type: | Entry type | Action | |---|---| | New entry | Select **OK**. | | Edited entry | Select **Save**. | The form validates before saving. If **Question** is empty, it shows `Question is required`. If the survey answer is empty, it shows ` is required`. The question field also has the pattern message `Just '_' '-' And '.' Characters Accepted` when its pattern rule rejects the entry. For a new item, a successful save displays `Data saved Successfully`. For an edited item, a successful save displays `Data updated Successfully`. **Result:** The Questions entry is saved when validation passes, and the corresponding success message identifies whether it was new or edited. ### Delete a question Delete a Questions row when the row is no longer needed and the delete action is available. The page protects the last remaining item: deletion is permitted only when more than one row exists. **Prerequisites** - Be on the Questions list. - Identify the row to remove. - Confirm that more than one row exists. **Steps** 1. Select the row's delete icon. 2. Check the deletion message. 3. Confirm that the row is no longer in the list when the result is `Data Deleted Successfully`. The page can stop deletion in three ways. The last-item block displays `Must have at least one item`. A row related to saved data displays `Related to Saved data, Can't be deleted`. A different deletion failure displays `Failed to Delete`. If the last row is selected, check for the message `Must have at least one item`. **Result:** The selected row is removed only when the list has more than one row and deletion succeeds; otherwise the applicable message remains available for diagnosis. ### Export the Questions list Use the Questions list export action when it is available for your subscription. Export starts the shared export operation rather than changing a Questions row. **Prerequisites** - Be on the Questions list. - Have the export operation available for the subscription. **Steps** 1. Select **Export**. 2. Choose what to do in the export dialog: | If you want to… | Select | |---|---| | Run the presented export operation | The export operation. | | Close the dialog without continuing | **Cancel**. | **Result:** The selected export operation runs, or the export dialog closes without changing Questions data when you select **Cancel**. ## Handle variations The Questions page is one entity tab in a shared configuration area. Subscription, permission, and list settings can change what appears. | Variation | What you see | |---|---| | Subscription includes the resource | The grid can appear, and **New** can appear when the new action is not hidden. | | Edit permission is available | The edit action can appear for a row. | | The Questions form column is visible | **Question** can appear in the new/edit popup when its type is a text box. | | The answer field is available | The **Select a answer** lookup can appear. | | The list columns differ | Work from the fields and headers visible in your list. | For another entity, open its related configuration page. ## When question maintenance goes wrong Use the message on screen to match the problem to the next action. | What you see | What it means | What to do | |---|---|---| | `Question is required` | **Question** has no value. | Enter the question in **Question** and submit the form again. | | ` is required` | The survey answer required rule has no selected value. | Open **Select a answer**, choose a returned value, and submit the form again. | | `Just '_' '-' And '.' Characters Accepted` | The question text does not meet the accepted pattern. | Correct the text so it uses the accepted characters, then select **OK** for a new entry or **Save** for an edited entry. | | `Forbidden characters detected. Please remove them and try again.` | The list filter contains forbidden characters. | Remove the forbidden characters from the filter input. | | **Select a answer** is not shown | The lookup is unavailable on the current Questions form. | Work with the fields that are shown on the Questions form. | | **Save** is not shown | The current new/edit surface does not expose the shared save control. | Use the control shown by the current popup, or close it and return to the list. | | Delete is unavailable | The row-count or permission condition does not allow the action. | Confirm that more than one row exists and that the action is available. | | Export is unavailable | The export subscription or surface condition is not met. | Continue without exporting or ask your administrator to review the subscription. | ## Continue with related ISO settings Related ISO settings are available alongside Questions. Use this page only for Questions entries, then open the related page for the entity you need. - [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) is the shared configuration home. - [Rating types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-iso-survey-answers) contains the survey-answer entity. - [Customer satisfaction survey](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-iso-survey-model) contains the survey-model settings. - [Reference category question units](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reference-list-reference-category-question-units-view) contains the related question-units setting. # Customer satisfaction survey Use customer satisfaction survey models to connect a survey name with the sales-job module it evaluates and its survey questions. ## Customer satisfaction survey models A customer satisfaction survey model is a named survey setup that connects one sales-job module with selected survey questions. Use it to define feedback for delivered or lost sales jobs. The model records a survey name, a module, and selected questions. The module choices are **Delivered sales job** and **Lost sales job**. The selected module identifies the sales-job context, and the selected questions provide the survey content. | If you need to… | Go to | |---|---| | Identify an existing model and its module | [Find and review survey models](#find-and-review-survey-models) | | Understand the list and form fields | [Fields](#fields) | | Create or change a model | [Add or edit a survey model](#add-or-edit-a-survey-model) | | Remove a model | [Delete a survey model](#delete-a-survey-model) | | Resolve a blocked save or deletion | [When maintenance does not work](#when-maintenance-does-not-work) | | Maintain the rating choices used by survey setup | [Rating types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-iso-survey-answers) | | Maintain the questions available to survey setup | [Questions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-iso-survey-questions) | ## Before you start The customer satisfaction survey page is a subscription-controlled configuration surface. With the required subscription feature, the list and its controls are shown; without it, the subscription-upgrade surface is shown. | Check | What you need | Why it matters | |---|---|---| | Subscription | A subscription that includes this configuration | The survey-model list and controls depend on it. | | Sign-in | Access to the application | Sign in before opening **ISO settings**. | | Before removing a model | Confirm that **Delete** is available. | **Delete** is required to remove a model. | | Related settings | The rating types and questions you want to use | These are maintained on the related configuration pages. | | Survey information | A survey name, a module choice, and the questions to select | These are the survey-model values maintained by the form. | > **Note:** Before changing or removing a model, confirm that the required control is visible. ## Find and review survey models The survey-model list lets you identify a model by its survey name and module before opening an action. **Prerequisites** - Sign in to the application. - Use a subscription that includes the customer satisfaction survey configuration. - If you need to remove a model, confirm that **Delete** is visible. **Steps** 1. Open **ISO settings**. 2. Select **Configuration**. 3. Select **Customer satisfaction survay**. 4. In the list headed **Customer satisfaction survay**, read the value in **Survey name**. 5. Read the related value in **Module**. 6. Read the footer value `Count: 2` to see the number of rows currently shown. 7. Select **New** when it is available to open a new survey-model form. ![Identify a survey model from the Survey name and Module columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/b201415698788d7c9597725d29dea7a1.png) **Result:** The survey-model list is open, and you have either identified a model or opened the action you need for that row. ## Understand the survey model screen Under **ISO settings**, **Configuration** includes the **Customer satisfaction survay** area and the related areas **Rating types** and **Questions**. Use the **Customer satisfaction survay** list for survey models. The list shows **Survey name** and **Module**, and its footer shows `Count: 2`. The toolbar includes **New**, a refresh control titled `Refresh`, and a settings control titled `Settings`. ![Review the Customer satisfaction survay heading, ISO settings area, list, and toolbar](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/eb6ac3bac0a684c578f198e903836ddb.png) The shared configuration surface can also expose **Export**. When it is open, it shows **Export**, **Filter Row**, the same columns, and the row count. ![Review Export, Filter Row, the two survey-model columns, and the row count](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/73e2935c388cd6c4cafd60d0aa40ffeb.png) The related **Rating types** and **Questions** areas are separate ISO settings. ### Fields The list is for recognition; the form is for entering the model. The form marks **Survey name**, **Module**, and **Survey questions** as required. Required markers and initial values depend on the form state. ### List fields | Field or column | Type | Use | |---|---|---| | **Survey name** | Text | Identifies the survey model in the list. | | **Module** | Text | Shows the selected sales-job module in the list. | ### Form fields | Field | Type | Required | Choices or use | |---|---|---|---| | **Survey name** | Text box | Yes | Enter the name used to identify the model. | | **Module** | Choice | Yes | Choose **Form**, **Delivered sales job**, or **Lost sales job**. | | **Survey questions** | Question choices | Yes | Select the questions that belong to the model. | Use **Module** to read or choose the module. The list uses **Survey name** and **Module** as its visible headers. ## Add or edit a survey model Create a model or change its name, module, or selected questions. **Prerequisites** - Meet the conditions in [Before you start](#before-you-start). - Have the survey name, the module choice, and the questions ready. - Start from the survey-model list. For an existing model, have the record form open before continuing. **Steps** 1. Choose a starting point: | If you need to… | Do this | |---|---| | Create a new model | Select **New**. | | Change an existing model | Open its form. | 2. In **Survey name**, enter or update the survey name. 3. In **Module**, choose **Form**, **Delivered sales job**, or **Lost sales job**. 4. In **Survey questions**, select and reorder the questions for this model. 5. Select **Save** to validate and send the form data. 6. Select **Close** to close the shared popup without keeping the form changes. The save outcomes are `Data saved Successfully` for a new record and `Data updated Successfully` for an existing record. A generic save error is `Forbidden characters detected. Please remove them and try again.` **Result:** The form is submitted with the chosen survey name, module, and questions; a new record uses `Data saved Successfully`, an edited record uses `Data updated Successfully`, or the application displays the applicable validation or save message. ## Delete a survey model Delete a survey model when it is no longer needed and is not required by saved data. The **Delete** action is available only when delete permission is available. **Prerequisites** - Meet the conditions in [Before you start](#before-you-start). - Identify the survey-model row to remove. - Have more than one survey-model item when you intend to select **Delete**. **Steps** 1. Open the deletion menu for the survey model and read `Are you sure you want to delete this item?`. 2. Choose an action: | If you need to… | Select | |---|---| | Leave the row unchanged | **Cancel** | | Remove the selected row | **Delete** | 3. Read the result message. The deletion outcomes are: | Outcome | Message | |---|---| | Deletion succeeds | `Data Deleted Successfully` | | Saved data prevents deletion | `Related to Saved data, Can't be deleted` | | Deletion fails | `Failed to Delete` | | The list would have no remaining item | `Must have at least one item` | **Result:** The row remains when you select **Cancel**; after **Delete**, the application shows the applicable deletion outcome. ## When maintenance does not work Use the message or condition on screen to choose the next action. | What you see or encounter | What it means | What to do | |---|---|---| | A required-field message | A required survey-model value is empty. | Complete the required question selection, then select **Save**. | | `Field is required` | The field-level required rule has stopped the form. | Enter the missing value and select **Save** again. | | `This Field Is Required` | The required-field message is shown in the configured language. | Complete the field and select **Save** again. | | `Just '_' '-' And '.' Characters Accepted` | The entered value does not match the accepted pattern. | Correct the value so it uses only the accepted characters, then select **Save** again. | | `Forbidden characters detected. Please remove them and try again.` | The save request contains forbidden characters. | Remove the forbidden characters and select **Save** again. | | `Related to Saved data, Can't be deleted` | Saved data is related to the selected model. | Keep the model and select **Cancel** in the deletion menu. | | `Failed to Delete` | The deletion operation failed. | Leave the record in place and review the deletion result before trying again. | | `Must have at least one item` | The operation would leave no item in the list. | Keep at least one survey model. | | The survey-model list and controls are replaced by the subscription-upgrade surface. | The subscription does not include this configuration. | Use a subscription that includes the customer satisfaction survey configuration. | | **New** is absent. | The new action is hidden or the subscription-controlled configuration is unavailable. | Review the subscription and use the available existing-record action. | | **Delete** is unavailable. | Delete permission is unavailable for the row. | Ask an administrator for delete access. | ## Continue with related survey settings After maintaining the model, continue with the related ISO configuration pages for rating choices and questions. - Open [Rating types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-iso-survey-answers) to maintain named rating sets and their rating values. - Open [Questions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-iso-survey-questions) to maintain the questions available to survey configuration. # Attachment categories Attachment categories is a reference list under **Attachment settings** in **Configuration**. Use it to maintain the names assigned to attachments. ## Attachment categories Attachment categories is the reference list where you maintain named categories for attachments. It sits under **Attachment settings** in the **Configuration** area. The page currently presents the **Attachment categories** heading, the **Attachment settings** parent, and the **Configuration** context. It is a reference list rather than a category lifecycle: the page does not define workflow stages for these entries. | If you need to… | Go to | | --- | --- | | Check the list layout and available fields | [Understand the list and form](#understand-the-list-and-form) | | Open the list or start a new entry | [Find the attachment categories list](#find-the-attachment-categories-list) | | Add a category | [Create a category](#create-a-category) | | Review an existing row | [Review a category](#review-a-category) | | Change a category name | [Change a category](#change-a-category) | | Remove a category | [Delete a category](#delete-a-category) | | Open the shared export action | [Export the list](#export-the-list) | | Return to configuration navigation | [Configuration](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) | | Continue with sibling reference-list work | [Reference list](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/reference-list-data) | ## Before you start **Prerequisites** - Confirm that the Attachment feature is included in your subscription. - Confirm that **New** is available when the new-entry control is not hidden. - Confirm that delete permission is available before removing a row. - Have the category name ready. **Name** is required in the entry form. | Situation | What you see or can do | | --- | --- | | Attachment is included in the subscription | The list, configuration, and actions load. | | Attachment is excluded from the subscription | A subscription-upgrade surface appears instead of the list. | | New-entry control is not hidden | **New** is shown. | | Delete permission is available | The row delete menu is shown. | After checking these conditions, find the list under **Attachment settings**. ## Find the attachment categories list Open the Attachment categories reference list from **Attachment settings**. **Prerequisites** - The Attachment feature is included in your subscription. **Steps** 1. Open **Configuration**. 2. Open **Attachment settings**. 3. Select **Attachment categories**. ![The Attachment categories entry in Attachment settings and the list it opens](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/966d89a6b974f0114241d0d071611ce3.png) 4. Select **New** to open the new-entry surface. The new-entry surface is the form titled `New Attachment categories`; it opens without changing the route. **Result:** The Attachment categories list or its `New Attachment categories` form is open. Next, check the column, field, and list controls. ## Understand the list and form The list identifies each category by **Name**, and the form provides **Name** as the category field. **Name** is the only visible list column. It accepts filtering, but it does not support sorting or direct list editing. | Surface | What is available | | --- | --- | | List column | **Name** is the only visible column. | | List actions | **New**, **Refresh**, and **Settings** are visible. | | Filtering | **Name** accepts filtering. | | Sorting and list editing | **Name** does not accept sorting or direct list editing. | | Form field | **Name** is the only visible form field and is required. | | Hidden declared fields | `DisplayOrder`, `Id`, and `CompanyID` are not shown in the form. | ![The Name column and visible list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e0c40ee61c9a7cb17ebdc066f57d5504.png) Use the maintenance path that matches the change you need: | If you need to… | Follow | | --- | --- | | Add a named entry | [Create a category](#create-a-category) | | Locate an existing entry | [Review a category](#review-a-category) | | Remove an entry | [Delete a category](#delete-a-category) | | Export the list | [Export the list](#export-the-list) | ## Add, review, and remove a category The form uses **Save** for a new entry. The deletion menu uses **Cancel** and **Delete**. ### Create a category Create a category when the attachment category name is not already in the list. **Prerequisites** - The Attachment feature is included in your subscription. - **New** is visible. - You have the category name ready. **Steps** 1. Select **New** in the Attachment categories list. 2. In `New Attachment categories`, enter a value in **Name**. 3. Select **Save**. ![The required Name field on the New Attachment categories surface](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5964562efe41b8c7ae99bc7cb7d5dd65.png) If the create operation succeeds, the product message is `Data saved Successfully`. **Result:** The category name is submitted through **Save**. ### Review a category Review a category by locating its name in the list. **Prerequisites** - The Attachment categories list is open. - An existing category row is visible. **Steps** 1. Review the category name in the **Name** column. **Result:** The existing category is identified in the list. ### Change a category Change a category when you have edit permission and need to update its **Name**. **Prerequisites** - The Attachment categories list is open. - Edit permission is available. - The category row is visible. **Steps** 1. Open the category's edit surface when edit permission is available. 2. Replace the value in **Name** on the edit surface. 3. Select **Save**. If the update succeeds, the product message is `Data updated Successfully`. **Result:** The changed **Name** is submitted through **Save**. ### Delete a category Delete a category only when your account has delete permission and the category is not needed by saved data. **Prerequisites** - The Attachment categories list is open. - Delete permission is available. - The deletion menu for the category is open. - You have checked that removing the category is appropriate. **Steps** 1. Read the confirmation prompt: `Are you sure you want to delete this item?`. 2. Select **Cancel** to keep the category, or select **Delete** to confirm removal. The deletion result is shown by one of these product messages: | Message | Meaning for the action | | --- | --- | | `Data Deleted Successfully` | The deletion succeeds. | | `Related to Saved data, Can't be deleted` | Related saved data blocks deletion. | | `Failed to Delete` | The deletion fails. | | `Must have at least one item` | The last remaining item cannot be removed. | **Result:** The deletion is cancelled or confirmed, and the displayed message identifies the resulting deletion condition. ### Export the list Open the shared export path when you need an export of the Attachment categories list. The list has a shared toolbar with the **Export** action. **Prerequisites** - The Attachment categories list is open. - **Export** is available in the shared toolbar. **Steps** 1. Open **Export** in the shared toolbar. **Result:** The shared export action is open. ## Handle surface variations Use the condition that matches what is on screen: | Variation | What changes | | --- | --- | | Subscription excludes Attachment | The subscription-upgrade surface replaces the list. | | New is hidden | The **New** action is unavailable. | | Delete permission is unavailable | The row delete menu is absent. | | List columns differ | Work from the headers visible in your list. The list layout can build its columns from the current configuration. | | Entry surface is shared | **Save**, **Cancel**, and other popup controls belong to the shared entry surface; use them only when they are visible. | | Sibling reference tabs have no title | Do not assign a name to an unlabelled sibling tab. Return to the visible Attachment categories heading or entry. | | Shared controls concern another entity | Follow the page that owns that entity rather than treating a generic control as Attachment categories maintenance. | ## When maintenance does not work Use the message on screen to choose the next action. | What you see | What to do | | --- | --- | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from **Name**, then select **Save**. | | Parsed server error text | Read the displayed server error text and correct the value or request the required access. | | `Related to Saved data, Can't be deleted` | Keep the category and resolve the related saved-data dependency before deleting. | | `Failed to Delete` | Verify the row, permission, and current data condition before repeating the deletion. | | `Must have at least one item` | Keep at least one category in the list. | > **Note:** A successful-operation message confirms that the application accepted the > maintenance request. Opening the entry surface alone does not confirm that a category was > saved. After maintenance, return to [Configuration](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) or continue with the sibling [Reference list](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/reference-list-data) work. ## What to do next Attachment categories is the entity owned by this page. The shared configuration area also navigates among sibling reference lists, but their fields and actions belong to their own pages. - Return to [Configuration](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) to choose another configuration area. - Continue with the sibling [Reference list](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/reference-list-data) work when you need another reference-list entity. # Custom fields ## Custom fields Custom fields are configurable fields that appear on selected PAMS pages. | If you need to… | Go to | |---|---| | Open the configuration area before choosing a maintenance page | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) | | Choose the PAMS page whose fields you maintain | [Open Custom fields](#open-custom-fields) | | Read the fields available on the selected page | [Understand the preview and field tables](#understand-the-preview-and-field-tables) | | Add or change a field | [Add and save a field](#add-and-save-a-field) | | Check recorded configuration changes | [Review Last Modifications](#review-last-modifications) | | Resolve a blocked or unclear field action | [When field maintenance does not work](#when-field-maintenance-does-not-work) | | Use the configured fields on a sales record | Sales job record | ## Before you start Custom-field maintenance depends on your subscription, access level, and the information you want to place on the selected page. The Custom fields maintenance surface is available when the subscription feature is included. When it is not included, PAMS shows the upgrade surface instead of the maintenance controls. Edit actions appear when your permission check returns editable access. View the page with the access level that permits editing before you plan to add, change, or remove a field. Have these choices and values ready: | Information | Where you use it | |---|---| | The page to customize | **Choose page you want to customize** | | The field format | **Data type** | | The text users see for the field | **Label** | The page choices are `Account`, `LG`, `Purchase`, and `Sales`. The available data types are `Date`, `Number`, `Text`, and `Yes_No`. **Data type** and **Label** are required in the field editor. A required field has a required marker beside it. ## Open Custom fields Choose the PAMS page whose configurable fields you want to maintain. **Prerequisites** - The subscription feature is included. - You have editable access for field maintenance. **Steps** 1. Open the [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) in PAMS. 2. Open **Choose page you want to customize**. 3. Select the page you want to maintain. | If you need to maintain fields for… | Select | |---|---| | Account pages | `Account` | | Letter-of-guarantee pages | `LG` | | Purchase pages | `Purchase` | | Sales pages | `Sales` | ![Select the page whose fields you maintain](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c9f469a1f0c6cf715e941564f5a5b6aa.png) 4. Confirm that the selected page's preview appears. **Result:** Custom fields is open from the Configuration dashboard, the selected page is shown in **Choose page you want to customize**, and its preview is available. ## Understand the preview and field tables The preview shows the fields available on the selected PAMS page, grouped into the page areas that PAMS presents for that selection. Use it to locate the area where a custom field belongs before you open the field editor. For the selected **Sales** page, the preview showed these fields: | Field 1 | Field 2 | Field 3 | |---|---|---| | `Branch` | `Sales Responsible` | `Product Type` | | `Job Title` | `Time Frame` | `End User` | | `Estimated Value` | `In Branch Currency` | `File No.` | | `Client` | `Vendor` | `Client Inquiry Number` | | `Inquiry Date` | `Bid Due Date` | `Requested Offer Type` | | `Offer No.` | `Offer Type` | `Offer Date` | | `Validity Period` | `Delivery Time` | `Delivery Term` | | `Payment Method` | `Payment Period` | `Client Order No.` | | `Vendor Order No.` | `Order Date` | `Order Activation Date` | | `L/C Number` | `Shahawy Extra` | | These fields appeared in more than one preview section: | First repeated field | Second repeated field | Third repeated field | |---|---|---| | `Client` | `Vendor` | `Bid Due Date` | | `Delivery Time` | `Delivery Term` | `Payment Method` | | `Payment Period` | | | The preview appears after you select a page. ![Locate preview sections and field actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/28d33f272556523622e10e268c1617ca.png) Work from the field names and sections shown in the preview. The preview content depends on the page you select and the configuration for that page. `Which Section` is not available as a choice on this screen. When you have located the section, continue with [Add and save a field](#add-and-save-a-field). ## Add and save a field Add a custom field when the selected page needs another labelled value. Edit an existing field when its label needs changing; an existing field's **Data type** is disabled while it is edited. Use the appropriate path: | If you need to… | Start with… | |---|---| | Add a field | **Add custom field** in the preview section where the field belongs | | Change a field's label | Select the existing field, then **Update custom field** | **Prerequisites** - Custom fields is open with the target page selected. - You know the field's **Data type** and **Label**. - You have editable access. ### Add a new field 1. Select **Add custom field** in the preview section where the field belongs. 2. Open **Data type**. 3. Select the data type that matches the value. | If the field stores… | Select | |---|---| | A calendar date | `Date` | | A numeric value | `Number` | | Free text | `Text` | | A yes/no value | `Yes_No` | ![Choose the field's data type](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/775d5c7384292e312d8e5c1ed8070c2c.png) 4. Enter the text users should see in **Label**. 5. Select **Save**. When the new field is saved, PAMS uses the message `Saved`. 6. Check the preview for the new label. **Result:** The new field is submitted, and the preview is the place to check whether its label appears. ### Change an existing field 1. Select the existing field in the preview. 2. Select **Update custom field**. 3. Enter the revised text in **Label**. 4. Select **Save**. When the existing field is updated, PAMS uses the message `Field updated successfully`. 5. Check the preview for the revised label. **Result:** The changed label is submitted, and the preview is the place to check the revised field. Select **Save and Close** when you want to save a field change and leave the maintenance page in the same action. After checking the preview, continue with [Review Last Modifications](#review-last-modifications) or [When field maintenance does not work](#when-field-maintenance-does-not-work). ![Enter a data type and label in the field editor](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e15499b0363772afe4844dca16bfd5b3.png) ## Review Last Modifications **Last Modifications** is the audit-history area for actions recorded against custom-field maintenance. It is available when both `companyId` and the log-module identifier are present. **Prerequisites** - Custom fields is open. - The company and log-module identifiers are available. **Steps** 1. Select **Last Modifications**. 2. Read the audit history in chronological order. The audit-log text says: `The audit log provides you with a chronological sequence of actions performed by the users`. **Result:** The audit-history area is open with the recorded actions presented as a chronological sequence. If a field action is blocked or unclear, continue with [When field maintenance does not work](#when-field-maintenance-does-not-work). ## When field maintenance does not work Use the message on screen to distinguish a value that needs correction from an action that the current subscription or access level does not permit. | What you see or cannot select | What it means | What to do | |---|---|---| | `This field is required` | A required field in the editor is empty. | Enter a value in **Data type** or **Label**, then submit the form again. | | `repeated field` | A field with the same data type and label already exists in the same section. | Change **Data type** or **Label**, then submit the form again. | | **Choose page you want to customize** is unavailable and the upgrade surface appears. | The subscription feature is not included. | Contact the person who manages your PAMS subscription. | | Edit actions are unavailable. | The permission check did not return editable access. | Sign in with access that permits field editing, or contact your administrator. | | `Error occurred while saving field` | The save action returned a save error. | Check the field values and submit the save action again. | | `Error occurred while updating field` | The update action returned an update error. | Check the revised label and submit the update again. | | `Error occurred while removing field` | The remove action returned a removal error. | Do not treat the field as removed; resolve the error before continuing. | | A close action asks whether to save changes. | The page has unsaved changes. | Choose a leave-page choice in [Continue after maintaining fields](#continue-after-maintaining-fields). | | **Which Section** is not available. | That choice is not available on this screen. | Choose the preview section that PAMS presents. | The field editor also provides **Ultimate delete this field** for an edited field and **Delete** to remove a saved field after confirmation. A successful removal uses the message `Field removed successfully`. ## Continue after maintaining fields Leave the maintenance page after you check the field preview or decide whether to keep the change. **Prerequisites** - A field editor or the Custom fields page is open. - You know whether to keep or discard unsaved changes. **Steps** 1. Select **Close** when you want to leave the field editor. 2. If PAMS asks `Do you want to save your changes?`, select the appropriate choice. | If you need to… | Select | |---|---| | Leave without saving | **Don't Save** | | Save before leaving | **Save** | | Remain in the editor | **Cancel** | 3. Select **Close** when you want to leave the maintenance page after the field editor is closed. **Result:** The selected leave-page choice is applied, and you can continue from the Configuration dashboard or the page that uses the configured fields. After maintaining fields, use Sales job record to see where fields configured for the Sales page are used. Return to the [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) when you need to choose another configuration area. # Dynamic validation Use **Dynamic validation** to choose a module and mark its listed fields as mandatory. | If you need to… | Go to | |---|---| | Open the configuration area | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) | | Open **Dynamic validation** | [Open **Dynamic validation**](#open-dynamic-validation) | | Identify the available module and field surfaces | [Understand the screen](#understand-the-screen) | | Change mandatory-field settings | [Set mandatory fields](#set-mandatory-fields) | | Check which branch controls what you see | [Handle configuration branches](#handle-configuration-branches) | | Match a loading or saving message to its operation | [When configuration goes wrong](#when-configuration-goes-wrong) | | Review changes after saving | [After saving](#after-saving) | | Configure approval and editing rules separately | [Work procedure settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-process-approvall) | | Continue into sales-job work | Sales jobs lifecycle | | Review general error messages | General error messages | ![The Dynamic validation screen with Choose Module and the save toolbar](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/53f0813dd5f51af191870548130d7d84.png) ## Before you start Prepare the access and module information before changing a setting. | Check or information | Why it matters | |---|---| | A subscription that includes Dynamic validation | The configuration form and toolbar are available only when the subscription includes the feature. | | Administrator or other edit access | **Save** and **Save and Close** require edit permission. | | The module and, where offered, its sub-module | The selected module determines the sub-module choices; the selected sub-module determines the field list. | | The fields your company wants to make mandatory | Selecting a listed field row changes its mandatory value. | | Any company information needed for audit review | **Last Modifications** appears when company information is available. | An upgrade surface appears when your subscription does not include Dynamic validation. The configuration form and toolbar appear when the subscription includes it. **Save** and **Save and Close** appear only when you have edit access and the data has changed. ## Open Dynamic validation Open the Configuration page to begin maintaining mandatory-field settings. **Prerequisites** - Your subscription includes the Dynamic validation feature. - You are signed in with access to the Configuration area. **Steps** 1. Open **Configuration**. 2. Open **Dynamic validation**. 3. Open **Choose Module**. Opening **Choose Module** opens its options without changing the configuration. ![The open Choose Module list with its available module choices](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/7f1d7f369ac99361624792bca7143d2c.png) **Result:** The Dynamic validation screen is open, **Choose Module** is available, and its choices are open without a configuration change. ## Understand the screen Use **Choose Module** to select a module. When sub-module choices are available, use **Which Sub-Module** before reviewing the **Field** and mandatory columns. Use **Last Modifications** to open the audit history when it appears. | Surface | What you use it for | When it appears | |---|---|---| | **Choose Module** | Select the module whose fields you want to maintain. | On the configuration form. | | **Which Sub-Module** | Select the sub-module before reviewing its field list. | When sub-module choices are available. | | **Field** | Read the field name in the field grid. | When field properties are available. | | Mandatory column | Read whether the field is mandatory; select the row to change that value. | With the field grid. | | **Last Modifications** | Open the audit-log tab. | When company information is available. | Opening **Choose Module** returns the options `Account`, `LG`, `Purchase`, and `Sales`. **Which Sub-Module** appears when sub-module choices are available. The field grid uses the string column **Field** and a mandatory column. The properties grid appears when mandatory-field rows are available. No required, pattern, range, or validation-group rules appear for these controls. Only **Field** and the mandatory column appear in the field grid. Select a field row to change its mandatory value. The page uses **Which Sub-Module** radio choices rather than an alternate sub-module select, and the mandatory checkbox is not available. ## Set mandatory fields Use the selected module and sub-module to maintain mandatory values: **Prerequisites** - The Dynamic validation form is open. - Your subscription includes Dynamic validation. - You have edit permission. **Steps** 1. In **Choose Module**, select the module you want to configure. 2. If **Which Sub-Module** appears, select the sub-module you want to configure. 3. In the field grid, select each field row whose mandatory value you want to toggle. 4. Select the save action that matches your next task. | If you want to… | Select | |---|---| | Save the current mandatory-field list | **Save** | | Save the current mandatory-field list and leave the page | **Save and Close** | **Result:** The selected mandatory values are ready for the chosen save action. ## Handle configuration branches The available surfaces change according to subscription access, available choices, edit access, company information, and whether you have changed a value. | If… | You see or do… | |---|---| | The subscription does not include Dynamic validation | The subscription-upgrade surface appears instead of the configuration form. | | The selected module has sub-module choices | **Which Sub-Module** appears before the field list. | | You can edit and the data has changed | **Save** and **Save and Close** become available. | | Company information is available | **Last Modifications** appears and opens the audit-log tab. | | Select the upper-right close control without changing data | The page leaves immediately. | | Select the upper-right close control after changing data | A save-choice popup opens with `Do you want to save your changes?`. | This page changes existing mandatory-field settings. It provides no controls to create or delete configuration rows. > **Caution:** Leaving after changing a value opens the save-choice popup. Choose the > appropriate option there before leaving if you need to retain the change. ## When configuration goes wrong Match the failed operation to its message before continuing. | Action | Message | What to do | |---|---|---| | Module choices fail to load | `Server Error` | Check the module choices before continuing. | | Sub-module choices fail to load | `Server Error` | Check the sub-module choices before continuing. | | The field list fails to load | `Server Error` | Check the field list before changing rows. | | Save | `Server Error` | Review the changes before leaving the page. | For general error-message guidance, see General error messages. ## After saving The save confirmation is `Your Company Mandatory Fields has been Saved Successfully`. When **Last Modifications** is available, select it to open the audit-log tab and review the modification history. Continue with [Work procedure settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-process-approvall) when you need approval or editing rules, or with Sales jobs lifecycle when you need to use the maintained mandatory fields in sales-job work. # Work procedure settings Use this page to review and change the approval and editing rules for sales jobs, letters of guarantee (L/G) requests, purchasing, and sales invoicing. ## Work procedure settings Work procedure settings determine when approval is required and when work can no longer be edited across sales jobs, offers, requests, orders, L/Gs, purchasing, and sales invoicing. The screen is in the **Configuration** section and its page title is `work procedure settings`. | If you need to… | Go to | |---|---| | Choose approval rules for sales jobs, offers, requests, or orders | [Approval and editing choices](#approval-and-editing-choices) | | Stop editing at a sales-work stage | [Approval and editing choices](#approval-and-editing-choices) | | Set L/G recommendations and confirming users | [L/G, purchasing, and invoicing choices](#lg-purchasing-and-invoicing-choices) | | Set approval for **for sales invoicing** and purchasing | [L/G, purchasing, and invoicing choices](#lg-purchasing-and-invoicing-choices) | | Save the changed settings | [Change and save settings](#change-and-save-settings) | | Open a company-approval branch | [Handle setting branches](#handle-setting-branches) | | Match a validation or save message to a corrective action | [When saving or loading goes wrong](#when-saving-or-loading-goes-wrong) | | Review the audit history | [Review changes and continue](#review-changes-and-continue) | | Continue with the sales-job flow | Sales jobs lifecycle | | Continue with offers or orders | Offers or Orders | | Continue with L/Gs, purchasing, or invoices | L/G lifecycle, Purchase jobs procurement chain, or Invoice lifecycle | The settings form uses two families. Approval choices control whether a business action needs approval. Editing choices control whether an inquiry, offer, order, or archived job can be edited at a selected point. ![Inspect the page title, Configuration section, and approval groups](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/26bbd08f03cdaf4281b405f847cfb4d3.png) ## Before you start Before changing a setting, have the following information ready. > **Note:** The approval-process feature controls whether this settings form appears. | Check or information | Why it matters | |---|---| | A subscription that includes the approval-process feature | The configuration form appears only when that feature is included. | | Your edit permission | With edit permission, **Save**, **Save and Close**, and the close control beside them are available. Without it, the read-only close control beside the save area is available instead. | | The company approval branch to change | Opening a branch displays that branch's settings panel and fields. | | The company ID | A company ID makes the **Last Modifications** tab available. | | A user for each enabled recommendation | Each related **User entitled to confirm** field is required when its recommendation is **Yes**. | The available names in the **User entitled to confirm** fields come from the user list. Choose the person your company uses for the applicable confirmation; the field is not required while the related recommendation remains disabled. ## Find and open the settings Open the work procedure settings screen when you need to change company-wide approval or editing behavior. **Prerequisites** - The subscription includes the approval-process feature. - You are signed in to the company you need to configure. **Steps** 1. Open the **Configuration** section. 2. In **Configuration**, open the work procedure settings entry. 3. Confirm that the page title reads `work procedure settings`. **Result:** The work procedure settings form is open in the **Configuration** section. Start with the approval and editing choices, then continue to the L/G, purchasing, and invoicing choices before saving. ![Inspect the loaded page title and the approval and editing groups](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/26bbd08f03cdaf4281b405f847cfb4d3.png) ## Understand the settings Each approval or editing setting is a radio group. The two **User entitled to confirm** controls are searchable fields, not text-entry fields. A field becomes required only when its related confirmation option is **Yes**. The approval and editing fields are listed below. | Setting | Available choices | Required | |---|---|---| | **for sales job.** | **Always**, **Never**, **Only Sales Jobs** | No | | **for offers before submission. orders before their acceptance.** | **Always**, **Never**, **Only Sales Jobs** | No | | **for regetting to submit offers.** | **Always**, **Never**, **Only Sales Jobs** | No | | **for submiting offers.** | **Always**, **Never**, **Only Sales Jobs** | No | | **for extending offers.** | **Always**, **Never**, **Only Sales Jobs** | No | | **for cancelling requests.** | **Always**, **Never**, **Only Sales Jobs** | No | | **for losing offers.** | **Always**, **Never**, **Only Sales Jobs** | No | | **for rejecting orders.** | **Always**, **Never**, **Only Sales Jobs** | No | | **for cancelling orders.** | **Always**, **Never**, **Only Sales Jobs** | No | | **Stop edit inquiries sent to principals.** | **Always**, **Never**, **Only Sales Jobs** | No | | **Stop edit approved offers.** | **Always**, **Never**, **Only Sales Jobs** | No | | **Stop edit valid offers.** | **Always**, **Never**, **Only Sales Jobs** | No | | **Stop edit approved orders.** | **Always**, **Never**, **Only Sales Jobs** | No | | **Stop edit valid orders.** | **Always**, **Never**, **Only Sales Jobs** | No | | **Stop edit archived jobs.** | **Always**, **Never**, **Only Sales Jobs** | No | The L/G, purchasing, and **for sales invoicing** fields are listed below. | Setting | Available choices | Required | |---|---|---| | **for requests of new L/G** | **Yes, all L/Gs**, **No**, **Only if my Company is the issuer** | No | | **for confirmation of the requirement** | **Yes**, **No** | No | | First **User entitled to confirm** field | User list | Required when the related confirmation option is **Yes** | | **for confirmation of financial viability** | **Yes**, **No** | No | | Second **User entitled to confirm** field | User list | Required when the related confirmation option is **Yes** | | **for orders award** | **Yes**, **No** | No | | **for sales invoicing** | **Yes**, **No** | No | The screen has no data grid, text-entry field, or date field. Its choices are radio groups and conditional searchable fields. The available user names are loaded into the fields when the list is available. ### Approval and editing choices Use this procedure to set approval behavior for sales work and to decide when records stop accepting edits. **Prerequisites** - You have edit permission for the settings page. - You know whether each approval should apply **Always**, **Never**, or **Only Sales Jobs**. - You know which editing points must stop further changes. **Steps** 1. For each approval row in the table, select **Always**, **Never**, or **Only Sales Jobs**. | Approval row | Choose one of | |---|---| | **for sales job.** | **Always**, **Never**, **Only Sales Jobs** | | **for offers before submission. orders before their acceptance.** | **Always**, **Never**, **Only Sales Jobs** | | **for regetting to submit offers.** | **Always**, **Never**, **Only Sales Jobs** | | **for submiting offers.** | **Always**, **Never**, **Only Sales Jobs** | | **for extending offers.** | **Always**, **Never**, **Only Sales Jobs** | | **for cancelling requests.** | **Always**, **Never**, **Only Sales Jobs** | | **for losing offers.** | **Always**, **Never**, **Only Sales Jobs** | | **for rejecting orders.** | **Always**, **Never**, **Only Sales Jobs** | | **for cancelling orders.** | **Always**, **Never**, **Only Sales Jobs** | | To stop editing… | Set this field | |---|---| | Inquiries sent to principals | **Stop edit inquiries sent to principals.** | | Approved offers | **Stop edit approved offers.** | | Valid offers | **Stop edit valid offers.** | | Approved orders | **Stop edit approved orders.** | | Valid orders | **Stop edit valid orders.** | | Archived jobs | **Stop edit archived jobs.** | 2. For each editing row in the table, select **Always**, **Never**, or **Only Sales Jobs**. **Result:** The approval scope and editing rules are selected for the listed sales actions and record stages. ![Sales approval radio groups and their choices](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f1d42bb3ab617bb84ebcdd3575911550.png) ![Editing choices for approved and valid offers](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/caa0f0403325eb665ea86c26da1118e1.png) ### L/G, purchasing, and invoicing choices Use this procedure to set L/G recommendation and approval behavior, purchasing order award approval, and approval for **for sales invoicing**. **Prerequisites** - You have edit permission for the settings page. - You know whether new L/G requests use **Yes, all L/Gs**, **No**, or **Only if my Company is the issuer**. - You know which sales and finance users confirm enabled recommendations. **Steps** 1. Select the choices in the table. | Setting | Choose one of | |---|---| | **for requests of new L/G** | **Yes, all L/Gs**, **No**, **Only if my Company is the issuer** | | **for confirmation of the requirement** | **Yes**, **No** | | Requirement confirmation user | A user in the related **User entitled to confirm** field when the choice is **Yes** | | **for confirmation of financial viability** | **Yes**, **No** | | Financial viability confirmation user | A user in the related **User entitled to confirm** field when the choice is **Yes** | | **for orders award** | **Yes**, **No** | | **for sales invoicing** | **Yes**, **No** | **Result:** The L/G, purchasing, and **for sales invoicing** approval choices are selected, with confirming users assigned wherever a recommendation is enabled. When L/G approval changes to **No**, both recommendation options change to **No**. Review the two recommendation rows before saving so that the required fields do not remain assigned to a disabled recommendation. ![L/G request and recommendation settings](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/caa0f0403325eb665ea86c26da1118e1.png) ![Inspect the purchasing and for sales invoicing approval fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d946103a4439d583393a0c2776d4e76a.png) ## Change and save settings Save the settings after reviewing every changed approval, editing, recommendation, and confirming-user choice. **Prerequisites** - You have selected the values to change. - Any enabled recommendation has a selected **User entitled to confirm**. **Steps** 1. Select **Save** when you want to keep the page open. 2. Select **Save and Close** when you want to save and leave the page. 3. Confirm the message `Your company work procedure settings has been saved successfully`. **Result:** The changed settings are saved; **Save and Close** also leaves the settings page. **Save** is enabled when the settings differ from their original values, and it validates the group before saving. **Save and Close** is enabled under the same changed-value condition and saves before leaving the page. ## Handle setting branches Company approval branches group the settings that apply to a company approval path. Open the branch you need before changing fields inside it. **Prerequisites** - You have identified the company approval branch to change. - You know whether the sales or finance recommendation is enabled in that branch. **Steps** 1. Select the branch expander for the company approval branch you need. 2. Review the settings panel and fields that open for that branch. 3. Select the recommendation choices and, when a choice is **Yes**, select the related **User entitled to confirm** field. | Recommendation | Related field | |---|---| | Sales recommendation | Sales **User entitled to confirm** when the choice is **Yes** | | Finance recommendation | Finance **User entitled to confirm** when the choice is **Yes** | Selecting one branch opens it and closes the other branches. The sales **User entitled to confirm** field appears when the sales-department recommendation is enabled. The finance **User entitled to confirm** field appears when the finance-department recommendation is enabled. Changing L/G approval to **No** sets both recommendation options to **No**. **Result:** The relevant company approval branch is open, and its conditional fields are completed when their recommendation options are enabled. ## When saving or loading goes wrong Use the message on screen to identify whether a required confirmation user is missing, the settings could not load, or the save failed. | What you see | What it means | What to do | |---|---|---| | `This Field Is Required` | An enabled recommendation has no confirming user. | Select a user in the related **User entitled to confirm** field, then save again. | | `An error occurred while processing your request` | The settings load request returned an error. | Open **Configuration**, reopen the work procedure settings entry, and verify that the form loads. | | `Server Error` | The save request returned a server error. | Review the selected values, then retry the save. | ## Review changes and continue **Last Modifications** is the audit-history tab for this settings screen. It is available when the page has a company ID. The tab displays an audit-log description, the heading `Created On: - By`, and audit-log rows. **Prerequisites** - The page has a company ID if you need to review **Last Modifications**. - You have saved the settings if you need to review the saved change. **Steps** 1. Select **Last Modifications** when the tab is available. 2. Review the audit-log description. 3. Review the displayed rows under `Created On: - By`. 4. Select the close control beside **Save** and **Save and Close** when you are finished reviewing or editing. **Result:** You have reviewed the available audit history and left the settings screen when you selected the close control beside the save controls. If changes exist, the close action opens a save-or-discard prompt. The page remains in the **Configuration** section after you change a setting; no stage or workflow change occurs. Continue to the related workflow pages when you need to work with the configured behavior: Sales jobs lifecycle, Offers, Orders, L/G lifecycle, Purchase jobs procurement chain, or Invoice lifecycle. ![Last Modifications with the audit-log description and displayed rows](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/fdcbb795fd7880c76f413bd3fba68131.png) # CRM integration settings Use this page to review and save branch-level CRM choices and synchronization rules. A customer relationship management (CRM) integration controls whether a branch uses a CRM and which sales orders, purchase orders, invoices, commission invoices, and products synchronize between PAMS and the CRM. ## CRM integration settings CRM integration settings determine the selected CRM, the direction of synchronization, and when each supported record is issued. The settings area contains one expandable panel for each branch. The page opens with branch panels collapsed. Open a branch before choosing an integration. A selected CRM reveals the synchronization matrix; **No integration** leaves the matrix hidden. | If you need to… | Go to | |---|---| | Return to the wider configuration area | [Configuration home](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) | | Review sales-order work affected by synchronization | [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) | | Continue with purchase-order work | [Purchase job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-record) | | Continue with invoice work | [Invoice lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/invoice-lifecycle) | | Continue with product work | [Products](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/products) | ## Before you start Before changing a branch, have the following ready: | What you need | Why it matters | |---|---| | A subscription that includes the CRM integration settings | Without the subscription, the page shows the subscription-upgrade surface instead of the settings surface. | | Edit access to the settings | Edit access determines whether **Save** and **Save and Close** are available. | | The branch you intend to change | The settings belong to the branch whose panel you open. Opening another branch closes the previously open panel. | | Your CRM choice and synchronization policy | The choice determines whether the synchronization matrix appears, and the create selections determine which update and timing options appear. | No field on this page is marked required. The page does not provide text-entry fields for external CRM credentials or a connection test. ## Find and open a branch A branch panel is the expandable area that contains one branch's CRM choice and synchronization settings. **Prerequisites** - Open the **Integration with CRMs** settings page. - Know which branch you want to review. **Steps** 1. Locate the branch by its displayed branch heading. 2. Select the branch heading or its expand control. ![Branch headings with the settings panels collapsed](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/b1b1cc28af692adad71b44f05c1c12a4.png) The selected panel opens. Opening another branch closes the currently open panel, so the visible settings belong to the open branch. **Result:** The selected branch's CRM settings are open. ## Review and configure synchronization workflows Synchronization settings describe when PAMS sends records to the CRM and when the CRM sends records to PAMS. The page uses **Pams >> CRM** and **Pams << CRM** for those directions. > **Note:** The synchronization matrix appears only for a branch with an integration selected. **Prerequisites** - Open the branch panel you want to configure. **Steps** 1. Review the CRM choices: **No integration**, **Odoo**, **Sugar**, **Sales force**, **M.s. dynamics**, and **SAP**. 2. Select the CRM that the branch uses. ![CRM choices in the open branch settings](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d21b3550e7b5b0b554727ef4d375c506.png) 3. Review the applicable workflow choices in the matrix. | Workflow | Create and update choices | Issue timing choices | |---|---|---| | Sales orders | **Synchronize when create new sales order**; **Synchronize when update sales order** | **Automatically when sales order is draft**; **Automatically when sales order is valid**; **Automatically when sales order is delivered** | | Purchase orders | **Synchronize when create new purchase order**; **Synchronize when update purchase order** | **Automatically when PO is draft**; **Automatically when PO is valid**; **Automatically when PO is received** | | Sales invoices | **Synchronize when create new sales invoice** | **Automatically when invoice is draft**; **Automatically when invoice is due**; **Automatically when invoice is paid** | | Commission invoices | The commission-invoice create and update choices | **Automatically when invoice is draft**; **Automatically when invoice is due**; **Automatically when invoice is paid** | | Products | **Synchronize when create new product**; **Synchronize when update product** | Not applicable | | Booking | The visible workflow choices | The visible issue timing choices | ![Synchronization matrix after a CRM is selected](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/aecf4919e129184b9976e96d45982eda.png) Update and issue-timing choices appear for a workflow after at least one create direction for that workflow is selected. The matrix uses **Pams >> CRM** and **Pams << CRM** as its two directions. **Result:** The branch shows its CRM choice and the applicable direction, create, update, and timing choices. ## Handle configuration branches Each branch has one of three visible settings states: | Branch state | What you see | What to do | |---|---|---| | No integration | **No integration** is selected and the synchronization matrix is absent. | Select a CRM when this branch must synchronize with one. | | Enabled integration | A CRM such as **Odoo**, **Sugar**, **Sales force**, **M.s. dynamics**, or **SAP** is selected and the matrix is visible. | Review the two synchronization directions and the applicable workflows. | | Create selection made | A workflow's update choices and issue-timing choices are revealed after a create direction is selected. | Review the newly visible choices before saving. | ![Branch showing No integration without the synchronization matrix](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e18dd72b1ae6b422c663086e50bf8a8e.png) The timing choice **Don't integrate** is not available in the mounted workflow choices. Leave a workflow's create directions unselected when that workflow should not expose its update and timing choices. ## Save or leave settings Saving commits the choices for the open branch. Leaving with unsaved changes opens a decision prompt instead of silently discarding them. **Prerequisites** - Open the branch whose settings you reviewed or changed. **Steps** 1. Select the action that matches what you want to do. | If you want to… | Select | |---|---| | Save and remain on the settings page | **Save** | | Save and close the settings surface | **Save and Close** | | Leave without saving | The X in the upper-right corner of the open settings panel. | 2. If the prompt asks `Do you want to save your changes?`, select the required outcome. | If you choose | Outcome | |---|---| | **Save** | The changes are saved before you leave. | | **Don't Save** | The unsaved changes are discarded and you leave without saving. | After a successful save, the page displays `Your company work procedure settings has been saved successfully`. **Result:** The branch settings are saved, saved and closed, discarded after your confirmation, or left at their previously saved values. ## When settings do not save Use the table below to match what you see with the supported action for this page. | What you see | What it means | What to do | |---|---|---| | `An error occurred while processing your request` while the page is loading | The settings request did not complete. | Check that the branch page is available, then open the branch again. | | `Server Error` after selecting **Save** or **Save and Close** | The save request returned an error. | Select **Save** or **Save and Close** again. | | The synchronization matrix is absent | The branch has **No integration** selected, or the selected CRM has not been applied to the open branch. | Review the integration choice. The matrix appears only when a CRM other than **No integration** is selected. | | Update or timing choices are absent for a workflow | No create direction is selected for that workflow. | Select a create direction for the workflow, then review the choices that appear. | | **Save** or **Save and Close** is unavailable | The page is not in an editable state for your access. | Ask an administrator with edit access to make the change. | The settings page does not provide a CRM connection test. The message `An error occurred while connecting to your CRM system.` belongs to a CRM connection or synchronization action page, not to this settings page. ## What to do next After saving, continue in the work area that matches the synchronization choices you configured. Use [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) for sales-order work, [Purchase job record](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/purchase-job-record) for purchase-order work, [Invoice lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/invoice-lifecycle) for invoices, and [Products](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/products) for product work. Return to [Configuration home](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) when you need another administrative setting. # Two-factor authentication Two-factor authentication adds an authentication step for selected users. This configuration controls where verification codes are sent and which devices remain trusted. ## Two-factor authentication at a glance This configuration screen brings together user settings, trusted devices, and the modification history entry point. A trusted device is a device that remains recognised for a user. | If you need to… | Go to | |---|---| | Review user two-factor settings | [Two-factor authentication fields](#two-factor-authentication-fields) | | Review trusted devices | [Trusted-device fields](#trusted-device-fields) | | Change a user's settings | [Maintain user two-factor settings](#maintain-user-two-factor-settings) | | Review modification history | [Review trusted devices and modifications](#review-trusted-devices-and-modifications) | | Return to the wider configuration area | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) | | Continue with user records | User-management pages for user records | The two-factor area is a configuration table rather than the user-record form. User-record two-factor fields remain with the user-management pages. ![The two-factor settings surface with its user rows and save actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/7a14f6da848ee085147832b44d000439.png) ## Before you start You need access to the configuration area and a loaded company context before this screen can show all of its surfaces. **Save** and **Save and Close** are available only with edit permission; both are disabled while no data changes exist. The **Last Modifications** area appears only when a company identifier is loaded. Use the values and rows currently displayed. Initial checkbox selections, the exact number of user rows, and a device row's action state depend on the loaded company data. ## Find the Two-factor authentication screen Open the configuration screen from the **2-Factor authentication** menu entry. **Prerequisites** - You are signed in and can open the Configuration menu. **Steps** 1. Open the Configuration menu. 2. Select **2-Factor authentication**. 3. Confirm that **2-Factor authentication** is visible. ![The opened Two-factor authentication screen](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/4cf5759af07de14a5753bf26a5e1aaa4.png) **Result:** The Two-factor authentication screen is open on the two-factor surface. ## Understand the screen and its fields The screen separates user settings from device review. The **2-Factor authentication** tab contains the user settings grid. The **Trusted devices** tab contains the trusted-device grid. **Save** and **Save and Close** commit settings when edit permission is present and data has changed. **Last Modifications** opens the history surface when a company identifier is loaded. | Surface | What it contains or does | |---|---| | **2-Factor authentication** | User rows and two-factor, delivery-method, and destination controls. | | **Trusted devices** | Device rows with user, device, trust, location, and login-date information. | | **Save** | Sends changed two-factor settings and refreshes history after a normal save. | | **Save and Close** | Sends changed settings and leaves the page after a successful save. | | **Last Modifications** | Opens the modification-history surface when a company identifier is loaded. | ![The Trusted devices tab with its device grid](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e744270daddba58d86d4a220bc76b67a.png) ### Two-factor authentication fields The two-factor grid shows one row per user presented by the loaded configuration. Its controls describe whether two-factor authentication applies, how a verification code is delivered, and which destination receives it. | Column or control | What it represents | Availability | |---|---|---| | **User** | The user represented by the row. | A two-factor row surface. | | **Apply 2 factor authentication** | The user's two-factor setting. | Selecting it changes that user's setting and updates the email setting. | | **Send verification code** | The grouped delivery choices. | Contains the delivery controls below. | | **By mail** | Mail delivery choice. | Disabled in the visible table. | | **By SMS** | SMS delivery choice. | Disabled in the visible table. | | **To admin.** | Sends the verification destination to the administrator option. | Disabled when the row's two-factor setting is disabled. | | **To user** | Sends the verification destination to the user option. | Disabled when the row's two-factor setting is disabled. | The **To admin.** and **To user** controls are row-level choices. Enablement follows the row's **Apply 2 factor authentication** setting; it is not a separate screen-wide switch. ![The Send verification code group and its delivery choices](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/4cf5759af07de14a5753bf26a5e1aaa4.png) ### Trusted-device fields Select **Trusted devices** to review the device rows. | Column | What the row presents | |---|---| | **User** | The user associated with the device. | | **Device name** | The device's name. | | **Trusted machine** | Whether the device is trusted. | | **Location** | The device location. | | **First login at** | The first recorded login time for the device. | | **Last login at** | The most recent recorded login time for the device. | The trusted-device grid does not provide a column chooser. Work from the headers shown in the grid. ## Maintain user two-factor settings Change a user's setting and verification-code destination from the user row. **Apply 2 factor authentication** changes the selected user's setting and updates the email setting. **To admin.** and **To user** change that user's destination flags. **Prerequisites** - The Two-factor authentication screen is open. - You have edit permission. - The user row you need is visible. **Steps** 1. In the user row, select or clear **Apply 2 factor authentication**. 2. In the same row, choose one destination. | If the verification code should go to… | Select | |---|---| | The administrator | **To admin.** | | The user | **To user** | The selected destination is applied to that user's destination flags. 3. Select **Save** to keep the page open, or select **Save and Close** to leave after saving. | If you need to… | Select | Then expect… | |---|---|---| | Save and continue reviewing this screen | **Save** | The settings are sent and the history is refreshed after a normal save. | | Save and leave the screen | **Save and Close** | The settings are sent and the page closes after a successful save. | 4. Confirm the success message `Your request was completed successfully`. If the save request fails, the screen displays `An error occurred while processing your request`. **Result:** The selected save action has completed, and the success message is visible when the save succeeds. ## Review trusted devices and modifications Review device rows first, then open the history surface when a company identifier is loaded. **Prerequisites** - The Two-factor authentication screen is open. - A company identifier is loaded when you need the history area. **Steps** 1. Select **Trusted devices**. 2. Review **User**, **Device name**, **Trusted machine**, **Location**, **First login at**, and **Last login at**. 3. Select **Last Modifications**. 4. Review the history surface for the loaded company. ![The Last Modifications history entry point and history surface](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/547531c6506c39fd282d2ec20d930357.png) **Result:** The trusted-device grid or the modification-history surface is open, depending on the last control you selected. ## Handle trusted-device actions The action on a trusted-device row depends on its trust state. A trusted device exposes **Untrust**; an untrusted device exposes **Delete**. Each action opens a confirmation menu before the operation is called. **Prerequisites** - The **Trusted devices** tab is open. - A device row exposes its action. **Steps** 1. Select the action exposed by the device row. | If the row exposes | Review | To complete the action | To leave the row unchanged | |---|---|---|---| | **Untrust** | `Are you sure you want to untrust this device?` | Select **Delete**. | Select **Cancel**. | | **Delete** | `Are you sure you want to delete this device?` | Select **Delete**. | Select **Cancel**. | ![A trusted-device row with its available action and confirmation menu](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e744270daddba58d86d4a220bc76b67a.png) The available action belongs to the individual row. Use the confirmation text before committing a device change. **Result:** The confirmation menu is either closed with **Cancel** or submitted with **Delete** for the selected device action. ## When a setting or device action does not work Use this table to match what you see with the condition that controls the surface. | What you see | What it means | What to do | |---|---|---| | **Save** is disabled. | No data changes exist. | Change a supported user setting first, then check **Save** again. | | **Last Modifications** is absent. | No company identifier is loaded. | Load the company context before opening history. | | The first two-factor grid is absent. | That grid declaration is behind a false display guard. | Use the visible two-factor table and its row controls. | | A required-field message does not appear. | This screen declares no required-field or validation rules. | Review the row controls and save state rather than looking for a field-validation panel. | | The save request reports an error. | The request was not completed. | Review the changed settings and contact your administrator if the error continues. The message is `An error occurred while processing your request`. | | The initial values or row count differ from an example. | Loaded data determines the checkbox values and exact rows. | Work from the values and rows currently displayed. | ## What to do next This page manages the configuration table. Continue to the [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) for another configuration area. For user-record details, continue to the user-management pages. User-record two-factor fields are outside this page. Shared log-history filters, registration details, and generic popup actions such as **Don't Save**, **Upload**, **No**, **Yes**, **Ok**, and **Back** belong to their owning shared surfaces rather than this configuration page. ## Related - Continue to the [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) for another configuration area. - Continue to the user-management pages for user-record details. # Dashboard settings Use Dashboard settings to review role dashboards, maintain their tabs and widgets, and review forecast rules. ## Dashboard settings at a glance Dashboard settings are the configuration records used to organise role dashboards and forecast rules. A role dashboard is the saved dashboard configuration that you maintain through its tabs, widgets, imports, reports, and view actions. The Dashboard settings screen is available with the Dashboard settings configuration subscription. The list uses **Role**, **Tabs**, **Widgets**, **Users**, and **Last modified**. A dashboard setting record supports tabs, widgets, imports, saved changes, and forecast rules. | If you need to… | Go to | |---|---| | Check the subscription, access, and record conditions first | [Before you begin](#before-you-begin) | | Open the list, forecast rules, or a role dashboard | [Find and open a dashboard setting](#find-and-open-a-dashboard-setting) | | Read the list columns and maintenance actions | [Understand the dashboard settings list](#understand-the-dashboard-settings-list) | | Review or save forecast calculation choices | [Open the forecast rules](#open-the-forecast-rules) | | Diagnose a missing action or import choice | [When a dashboard setting is unavailable](#when-a-dashboard-setting-is-unavailable) | | Work with a new dashboard setting | [New dashboard setting](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings-new) | | Maintain an existing dashboard setting | [Edit dashboard setting](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings-edit-record) | | Understand dashboard display and widgets | [Dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) or [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog) | ## Before you begin Dashboard settings work depends on the Dashboard settings configuration subscription, your editing state, and whether the dashboard record has been saved. | Before you begin | What it changes | |---|---| | The Dashboard settings configuration subscription is included | The configuration list and **Forecast settings** are available. | | The screen is in edit mode | Dashboard editing actions are available. | | A dashboard record has an ID | **Last Modifications** is available for the saved record. | | Another role dashboard has been selected | The import tab-selection controls are available. | The subscription is required for this screen. If it is unavailable, the configuration screen is replaced by a surface with **Back**. Editing actions require edit mode. The **Last Modifications** tab requires `RoleDashboard.Id`, so the dashboard record must exist before that tab is available. Import tab-selection controls appear only after you select another role dashboard. ## Find and open a dashboard setting The Dashboard settings list is the starting point for reviewing a role dashboard or opening its configuration record. Forecast settings opens a separate forecast-rules popup. **Prerequisites** - The Dashboard settings configuration subscription is available. - You can access the configuration area. **Steps** 1. In the configuration area, select **Dashboard settings**. 2. Choose one destination. | If you need to… | Select or open | |---|---| | Review forecast rules | **Forecast settings** | | Open an existing role dashboard from its row | The dashboard-setting row | | Open an existing role dashboard for editing | **Edit** | | Open a new dashboard setting | Open the new dashboard-setting page from the Dashboard settings list | 3. If you selected a dashboard row or **Edit**, open the selected dashboard setting's detail page. ![The Dashboard settings list with its role-dashboard columns and Forecast settings action](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6af6787bfa032faefd3cfd4f64971f28.png) **Result:** The list, the forecast-rules popup, the saved dashboard-setting record, or the new dashboard-setting detail surface is open. ## Understand the dashboard settings list The Dashboard settings list is the directory of role-dashboard configuration records. Use its columns to identify a record, then use the opened record's maintenance actions to change its dashboard structure. | List columns | |---| | **Role** | | **Tabs** | | **Widgets** | | **Users** | | **Last modified** | Select a row to open the selected dashboard setting, or select its **Edit** action to open the same record on its detail page. The detail surface provides these maintenance actions: | Surface | Available actions | |---|---| | Dashboard detail toolbar | **Widget**, **Blank Tab**, **Import From**, **Principals Report**, **Eagle View**, **Save**, and **Save and Close** | | **Tab** menu | **Blank Tab**, **Import From**, **Principals Report**, and **Eagle View** | | Import popup | **Another role dashboards**, **Select tab(s)**, and **All (Replace existing tabs)** | | Saved record | **Last Modifications** | **Widget** opens widget preparation for an active user-dashboard tab with widgets. **Blank Tab** opens the blank-tab flow. **Import From** opens the import popup. **Principals Report** and **Eagle View** add or remove their dashboard tabs. **Save** keeps the page open after saving, and **Save and Close** leaves the page after saving. Select **Blank Tab** to open the new-tab dialog. The dialog has the required **New Tab** field and an **OK** button. The import popup first provides **Another role dashboards**. After you select another role dashboard, **Select tab(s)** and the all-tabs choice become available when source tabs are present. ![The import popup with the source-dashboard and tab-selection controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/920cd67907c57ec935022ac0d5485d5f.png) When the record has an ID, select **Last Modifications** to review its saved modification history. The detail surface can also provide **Rename tab**, **Delete tab**, and **Remove widget from tab** for an active editable tab. Widget-specific choices and report columns depend on the active tab and widget area. When a dashboard-setting request succeeds, the message is `Your request was completed successfully`. If an imported special tab is already present, the message is `You already have this tab in this dashboard`. A request error uses `An error occurred while processing your request`. ## Open the forecast rules Forecast settings are the booking-rule choices used to configure how the forecast is calculated and how booking periods are represented. **Prerequisites** - The Dashboard settings configuration subscription allows **Forecast settings**. - The Dashboard settings list is open. **Steps** 1. Select **Forecast settings**. 2. Complete the forecast choices. | Field or choice | Select or enter | |---|---| | **Forecast calculation type** | **Firm offers only** or **Firm offers and received inquiries** | | **Forecast calculation method** | The order-chance multiplication method or the at-or-above percentage method | | **Rating** | A required percentage when you use the order-chance method | | **Tolerated deviation between forecasted and achieved monthly booking** | A value from `0` through `100` | | **Listing of the average monthly booking** | **Of the last 3 years** or **Of the last 5 years** | | **Average Period For Goods Delivery Till Receiving The Commission Payment** | A value of at least `0` | | **Average Period For Goods Delivery Till Receiving The Clients Payment** | A value of at least `0` | | Commission and client payment periods | Select them when your company configures them as required | 3. Select the action that matches your choice. | If you need to… | Select | |---|---| | Save the forecast-rule choices | **Save** | | Leave the popup without saving | **Cancel** | | Confirm the shared popup action | **OK** | The popup also supports the shared confirmation actions. A required value can show `This Field Is Required`. Choose the order-chance method before entering its required percentage in **Rating**; **Rating** is available for that choice. ![The forecast settings surface with its calculation and booking-period fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/dd2c193ea6f22ededd72d8c7daf27db9.png) **Result:** The forecast settings popup remains available for the selected save or cancel action, with the entered calculation choices and booking-period values displayed. ## When a dashboard setting is unavailable Dashboard-setting surfaces change when the subscription, editing state, saved-record state, or import source does not meet the screen's conditions. | What you see | What it means | What to do | |---|---|---| | The configuration screen is replaced by a surface with **Back** | The Dashboard settings subscription is not included. | Select **Back**. | | **Widget**, **Blank Tab**, **Import From**, **Principals Report**, **Eagle View**, **Save**, or **Save and Close** is unavailable | The screen is not in edit mode. | Continue in edit mode. | | **Last Modifications** is unavailable | The dashboard record has no `RoleDashboard.Id` yet. | Save or open the saved dashboard record before reviewing modifications. | | **Select tab(s)** or **All (Replace existing tabs)** is unavailable | Another role dashboard has not been selected, or the source has no tabs available for import. | Select another role dashboard with tabs to import. | | A widget-specific area is unavailable | Its own subscription or widget guard does not permit it. | Continue with the dashboard area that is available. | | `You already have this tab in this dashboard` appears | The imported special tab is already on the dashboard. | Close the message and continue with the existing tab. | | `This Field Is Required` appears | A required forecast value is empty. | Enter the required value before saving. | | `An error occurred while processing your request` appears | The request returned the common processing error. | Review the values and request conditions, then retry the action. | ## Continue to dashboard maintenance After opening a role dashboard, continue with **Widget**, **Blank Tab**, **Import From**, **Principals Report**, or **Eagle View** according to the maintenance task. On a saved record, **Last Modifications** is the onward review surface for dashboard changes. For widget meanings and day-to-day dashboard use, continue to [Dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) and [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog). The focused pages for creating or maintaining the configuration record are [New dashboard setting](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings-new) and [Edit dashboard setting](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings-edit-record). # New dashboard setting Use this page to create a role dashboard from tabs, widgets, and optional report views. ## What a new dashboard setting is A new dashboard setting is the configuration work used to assemble a role dashboard from tabs, widgets, and optional report views. You build it from the **Configuration Dashboard** page. Use the sections below according to what you need to do: | If you need to… | Go to | |---|---| | Check what must be available before you configure the setting | [Before you start](#before-you-start) | | Open the new-record editor | [Open a new dashboard setting](#open-a-new-dashboard-setting) | | Learn what the editor controls do | [Understand the editor](#understand-the-editor) | | Add a blank tab and choose its widgets | [Add a tab and its widgets](#add-a-tab-and-its-widgets) | | Add an imported or report tab | [Choose the tab variation](#choose-the-tab-variation) | | Save the setting | [Save the dashboard setting](#save-the-dashboard-setting) | | Resolve a duplicate tab or request error | [When the task does not complete](#when-the-task-does-not-complete) | | Review the dashboard after saving | [After saving](#after-saving) | | Open the dashboard list | [Dashboard settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings) | | Maintain an existing setting | [Edit dashboard setting](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings-edit-record) | ![The new dashboard-setting editor with its toolbar visible](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5a75fb7ee5bd054762a3a41535636f02.png) ## Before you start The dashboard library and its editing actions depend on your subscription, edit mode, the tabs available to your role, and whether the setting is saved. | Check | What it controls | |---|---| | Dashboard subscription | The dashboard tabs render when the subscription includes the dashboard library. Otherwise, the dashboard area shows the upgrade surface. | | Edit mode | **Widget**, **Blank Tab**, **Import From**, **Principals Report**, **Eagle View**, **Save**, and **Save and Close** require edit mode. | | Dashboard tab and available widgets | **Widget** is available only when a dashboard tab exists, widgets are available, and the active tab is a user dashboard. | | Active tab | Widget work belongs on a user dashboard. **Principals Report** and **Eagle View** show their own content when active. | | Saved record | **Last Modifications** is available for a saved dashboard setting. | On arrival, **Widget** was disabled. The editor does not add a product-enforced approval step before saving or deleting a dashboard setting. **Prerequisites** - Have access to the **Configuration Dashboard** page. - Open the setting in edit mode when you need to add tabs, choose widgets, or save. - Have a dashboard subscription when you need the dashboard library rather than its upgrade surface. After these checks, open the new-setting editor. ## Open a new dashboard setting Open the new-record route when you want to start assembling a dashboard setting rather than maintain an existing one. **Prerequisites** - Complete the checks in [Before you start](#before-you-start). **Steps** 1. Open the **Configuration Dashboard** page. 2. Confirm that the page text **Configuration Dashboard** appears. 3. Identify **Widget**, **Tab**, **Save**, and **Save and Close**. ![The Configuration Dashboard toolbar on the new-setting route](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5a75fb7ee5bd054762a3a41535636f02.png) **Result:** You are on the new-setting page and can begin configuring the setting. Next, use the editor controls to choose a tab type or modify the active tab. ## Understand the editor The editor combines a top toolbar, a menu for adding tab variations, an active-tab menu, and dashboard content. The active tab determines whether you work with user-dashboard widgets, a Principals Report, or an Eagle View. | Control or surface | Use | |---|---| | **Widget** | Open the widget chooser when an editable user dashboard has available widgets. | | **Tab** | Open the tab-variation menu. | | **Blank Tab** | Open the Add new tab flow. | | **Import From** | Open dashboard import. | | **Principals Report** | Add or remove the Principals Report tab. | | **Eagle View** | Add or remove the Eagle View tab. | | **Last Modifications** | Open the audit-log area for a saved dashboard setting. | | **Rename tab** | Open tab-name editing from the active tab menu. | | **Delete tab** | Open tab deletion from the active tab menu. | | **Search for widget** | Filter widgets in the active tab menu. | If the subscription does not include the dashboard library, the dashboard tabs are replaced by the upgrade surface. On a user dashboard, **Search for widget**, **Select all**, and **Remove widget from tab** belong to widget selection; report tabs show their own controls. Choose the tab type that matches the content you need. ## Add a tab and its widgets Use a blank tab when you want to name a tab yourself and choose its widgets. **Prerequisites** - Be in edit mode. - Have a dashboard tab available for widget work. **Steps** 1. Open the **Tab** menu. 2. Select **Blank Tab**. The **Add new tab** dialog opens with the required **New Tab** field and an **OK** button. 3. Enter a tab name in **New Tab**. 4. Select **OK**. If the field is empty, the dialog shows `This Field Is Required`. If the name already exists, it shows `You already have this tab in this dashboard`. 5. Open the active tab menu. 6. Enter a search term in **Search for widget**. 7. Select **Select all** to select all available widgets. 8. Select **Remove widget from tab** for a widget you want to remove. ![The Add new tab dialog with New Tab and OK](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/49fb013e081ed0a6173b89468e97f502.png) **Result:** The tab has a name, and its widgets are selected or removed in the active-tab menu. Continue with another tab variation or save the setting. ## Choose the tab variation The **Tab** menu offers four ways to add dashboard content. Choose the variation that matches the source or report view you need. | If you need to… | Select | What opens | |---|---|---| | Create and name a tab yourself | **Blank Tab** | The **Add new tab** dialog with **New Tab** and **OK** | | Copy tabs from another role dashboard | **Import From** | The **Import dashboard** dialog with **Another role dashboards** and **Select tab(s)** | | Add the principals report view | **Principals Report** | **Report**, **Generate Report**, and **Download as PDF** | | Add the vendor-analysis view | **Eagle View** | Vendor-analysis controls and report choices | For **Import From**, select a source in **Another role dashboards**. After a source is selected, the controls for **Select tab(s)** and all-tab import become available. For **Principals Report**, use **Report** before selecting a report action. If the operation requires principals and none are selected, the message is `Please choose one or more principals`. For **Eagle View**, the visible report choices are **Inquiries (Count)**, **Inquiries (Value)**, **Offers (Count)**, **Offers (Value)**, **Orders (Count)**, **Orders (Value)**, **Lost Orders (Count)**, **Lost Orders (Value)**, **Hit rate (%)**, and **visits Count**. ![The Import dashboard dialog with source-dashboard and tab-selection controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2dfa7175aad2c8ecaeb3eaccd5aa54b7.png) ![The Principals Report tab and its report controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/7afb3626023ecaf2ea54899ea5d3fa0d.png) ![The Eagle View tab with vendor-analysis and report choices](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/fa83614c10ba514fdad758c3c440e9e9.png) **Result:** The selected tab variation is open with its controls ready for the next choice. Save when the tab configuration is complete. ## Save the dashboard setting Choose the save action that matches whether you need to continue editing. **Prerequisites** - Complete the tab and widget choices you want to keep. - Be in edit mode. - Resolve any unsaved-change prompt before leaving. **Steps** 1. Choose one save action: | Select | Outcome | |---|---| | **Save** | Save the setting and remain in the editor. | | **Save and Close** | Save the setting and leave the editor. | 2. If a completion or exit popup opens, choose the outcome you need: | Select | Outcome | |---|---| | **Save** | Save the setting. | | **Don't Save** | Leave without saving the changes. | | **Cancel** | Close the popup and keep the editor open. | The success message is `Your request was completed successfully`. A request error is reported as `An error occurred while processing your request`. ![The Save action on the new dashboard-setting editor](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/dd2c193ea6f22ededd72d8c7daf27db9.png) ![The Save and Close action on the new dashboard-setting editor](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/dd2c193ea6f22ededd72d8c7daf27db9.png) **Result:** **Save** keeps the editor available; **Save and Close** leaves the editor. If the task does not complete, use the exact message to return to the relevant field or choice. ## When the task does not complete | What you see | What it means | What to do | |---|---|---| | `This Field Is Required` | **New Tab** has no value. | Enter a tab name in **New Tab**, then select **OK**. | | `You already have this tab in this dashboard` | The tab name is already used. | Enter a different name in **New Tab**, then select **OK**. | | `An error occurred while processing your request` | The request did not complete. | Review the tab, widget, or report choice and submit the action again. | | `Please choose one or more principals` | A Principals Report operation needs principals. | Return to report selection and choose principals before generating the report. | After correcting the choice, return to [Save the dashboard setting](#save-the-dashboard-setting). ## Out of scope This page covers the dashboard-setting editor. For widget details, use Dashboard widget catalog. For dashboard use, use Dashboard overview. ## After saving After saving, use **Last Modifications** to review the saved record's audit-log area when it is available. **Steps** 1. Open **Last Modifications** when it is available. 2. Open [Dashboard settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings) when you need the list. 3. Open [Edit dashboard setting](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings-edit-record) when you need to maintain the saved setting. **Result:** You can review the saved record or continue maintaining dashboard settings. # Edit dashboard setting ## What a dashboard setting is A dashboard setting is the saved role-dashboard configuration that you customize through tabs, widgets, imports, reports, and views. The page provides these main actions: | If you need to… | Go to | |---|---| | Find the saved dashboard-setting record | [Dashboard settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings) | | Add, remove, or arrange widgets and tabs | [Customize and save the dashboard](#customize-and-save-the-dashboard) | | Import tabs from another role dashboard | [Import tabs from another role dashboard](#import-tabs-from-another-role-dashboard) | | Add or remove the optional report or view | [Choose the dashboard branch](#choose-the-dashboard-branch) | | Review saved changes | [After saving the dashboard setting](#after-saving-the-dashboard-setting) | | Learn what individual widgets mean | [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog) | | Use the resulting dashboard | [Dashboard overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) | | Read the report content | [Principal report](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/principal-report) | The page provides **Widget**, **Tab**, **Save**, and **Save and Close** actions. The **Tab** menu provides **Blank Tab**, **Import From**, **Principals Report**, and **Eagle View**. A saved record also provides a **Last Modifications** tab for reviewing its history. ## Before you start The **Dashboard settings** configuration subscription is required for this screen. Editing actions are available when the page is in edit mode. **Last Modifications** is available after the setting has been saved and has an ID. | Check | What must be true | What it affects | |---|---|---| | Configuration access | The **Dashboard settings** configuration subscription is included. | The screen and its dashboard-library surfaces are available. | | Edit state | The page is in edit mode. | **Widget**, **Blank Tab**, **Import From**, **Principals Report**, **Eagle View**, **Save**, and **Save and Close** are editing actions. | | Saved-record state | The dashboard setting has an ID. | **Last Modifications** is available. | | Import state | Another role dashboard has been selected in the import popup. | **Select tab(s)** and the source-tab checkboxes appear. | No product-enforced approver is specified before saving or deleting a dashboard-setting record. > **Note:** The dashboard library shows its tabs and widget areas according to the > subscription, active tab, and widget conditions. With these conditions in place, open the saved record from the **Dashboard settings** list. ## Find and open a dashboard setting Prerequisites - The **Dashboard settings** configuration subscription is included. - You have a saved dashboard setting to customize. Steps 1. Open the **Dashboard settings** list from the configuration navigation. 2. Select the row for the dashboard setting you want to customize. 3. Select the row's edit action if the list presents one. The selected saved dashboard setting opens for editing. Continue by identifying the controls and dashboard-library areas on the edit screen. **Result:** The selected saved dashboard setting opens for editing. ## Understand the dashboard-setting screen The dashboard-setting screen is the library for one saved role-dashboard configuration. Its tabs and widget areas change according to the available subscription, the active tab, and the widget conditions. On this screen, you can select **Widget**, **Tab**, **Save**, or **Save and Close**. You can also select Sort by Booking, Sort by Target, or Sort by Achievement. Select **Tab** to reach the tab actions. The menu includes **Blank Tab**, **Import From**, **Principals Report**, and **Eagle View** when their edit conditions allow them. ![The Tab menu with tab creation, import, report, and view choices](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/36244083d9144359c4a8523b87495dc7.png) On a saved record, select **Last Modifications** to open the saved-record history surface. ## Customize and save the dashboard Use this procedure to change the tabs or widgets in an existing dashboard setting and commit those changes. Prerequisites - You opened an existing saved dashboard setting from the **Dashboard settings** list. - The page is in edit mode. - The dashboard library has an active tab that meets the action's conditions. Steps 1. In an active user-dashboard tab with widgets, select **Widget** to open the widget-add preparation. 2. In the **Tab** menu, select **Blank Tab** to open the blank-tab preparation. 3. In the tab actions for an editable user-dashboard or MRM report tab, select **Rename tab**. 4. In the tab rename dialog, enter a value in **New Tab**. 5. In the tab actions for an active editable tab, select **Delete tab** when the tab dropdown is available. 6. In an active tab with widgets, select **Remove widget from tab** to select or remove a widget. 7. In the widget-selection dialog, select **Select all** to select every widget. 8. Select **Save** to save the dashboard setting and keep this page open. 9. Select **Save and Close** to save the dashboard setting and leave the edit page. After a successful dashboard and modification-log save, the message is `Your request was completed successfully`. **Result:** **Save** keeps the edit page open, while **Save and Close** leaves the page after the save action. ![The widget-selection surface opened from Widget](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/a2c96bca15790eb08cd24e819f09964a.png) The optional report and view tabs are controlled from the same **Tab** menu. ## Choose the dashboard branch The dashboard branches are optional tabs for report and view work. They are available while the page is in edit mode, and selecting each action toggles its corresponding tab. | If you need to… | Select | |---|---| | Add or remove the principals report tab | **Principals Report** | | Add or remove the Eagle View tab | **Eagle View** | The report's column sets are built from runtime selections, so the available columns depend on the selections made for that report. If no principal or client is selected when the report is generated, the message is `Please choose one or more principals`. If you need to reuse tabs from another saved role dashboard, continue with **Import From**. ### Import tabs from another role dashboard Prerequisites - The page is in edit mode. - Another role dashboard has saved dashboard data. - The source dashboard is different from the current record. Steps 1. In the **Tab** menu, select **Import From**. 2. In the import popup, open **Another role dashboards**. 3. Select a source dashboard whose saved dashboard data is non-empty and whose ID differs from the current record. 4. Review **Select tab(s)** after the source dashboard is selected. 5. Select one checkbox for each source tab to import. 6. If the control is available, select **All (Replace existing tabs)** to select or clear all source tabs for replacement. 7. Select the popup's **OK** action to apply the import choice. ![The import popup with the source-dashboard and tab-selection controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/920cd67907c57ec935022ac0d5485d5f.png) To close the import popup without applying the choice, select **Cancel**. **Result:** The selected source tabs are prepared for import, or the import popup closes without applying a choice when you select **Cancel**. ### Choose custom-dashboard options Use the option that matches the active dashboard surface: | Option | Available when | |---|---| | **Rename tab** | The active tab is an editable user-dashboard or MRM report tab, its dropdown is available, and the page is in edit mode. | | **Delete tab** | The active tab's dropdown is available and the page is in edit mode. | | **Remove widget from tab** | The active tab contains widgets; removal additionally requires edit mode. | | **Widget** | A dashboard tab exists, the dashboard contains at least one tab, the active tab is a user dashboard, and the widget conditions allow the surface. | Widget-specific surfaces depend on the subscription and widget conditions. ## When saving or loading goes wrong Use the message on screen to choose the recovery path below. | What you see or encounter | What to do | |---|---| | `An error occurred while processing your request` while saving or loading the dashboard | Review the dashboard changes and repeat the save or reload action from the dashboard screen. | | `You already have this tab in this dashboard` while importing | Remove the duplicate special tab from the import choice, then continue with the remaining tabs. | | The exit popup opens after you changed dashboard tabs | In the exit popup, select **Don't Save**, **Save**, or **Cancel**, depending on the outcome you want. | | A dashboard choice, source-tab choice, saved value, or principal-report column is not available | Continue with the choices visible on your screen; these values depend on the dashboard data and runtime selections. | The exit popup opens after you change dashboard tabs, when they differ from their original copy. Choose one outcome: | Select | Outcome | |---|---| | **Don't Save** | Leaves without saving. | | **Save** | Saves and closes. | | **Cancel** | Closes the popup without applying the exit choice. | **Result:** You leave without saving, save and close, or close the popup without applying the exit choice. ## After saving the dashboard setting On a saved record, **Last Modifications** is the history area for the record's saved changes. Use **Save and Close** when you want to leave the edit page. The edit flow does not establish a stage or status change. Widget-specific meanings and the work of using the resulting dashboard belong to [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog) and [Dashboard overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview). The report's reader-facing content belongs to [Principal report](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/principal-report). **Result:** The saved dashboard setting is available for review through **Last Modifications**, and the edit page is closed when you use **Save and Close**. # Reports settings Reports settings is the administrator's list for preparing role reports and reviewing the invoice-delay values used by forecast settings. ## Reports settings A report setting is a role-based report configuration. Use the list to open a role's setting, review its tabs and widgets, and maintain the report layout retrieved for that user. **Forecast settings** records each branch's expected delay for purchase, sales, and commission invoices, together with its unit. Open **Reports settings** from the configuration area when you need the administrator list rather than the [Reports hub](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/reports-hub), where a user consumes the prepared role reports. | If you need to… | Go to | |---|---| | Check access and prepare information | [Before you start](#before-you-start) | | Open the administrator list | [Open Reports settings](#open-reports-settings) | | Identify a setting and choose its maintenance path | [Read the Reports settings list](#read-the-reports-settings-list) | | Review branch invoice delays | [Review forecast settings](#review-forecast-settings) | | Inspect an existing record | [Open a report setting for maintenance](#open-a-report-setting-for-maintenance) | | Understand conditional surfaces and request messages | [Handle availability and request outcomes](#handle-availability-and-request-outcomes) | | Create or maintain a setting | [New report setting](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reports-settings-new) or [Edit report setting](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reports-settings-edit-record) | ## Before you start You need signed-in access to the configuration area. **Forecast settings** is available only when your subscription includes that surface. Have the delay values and units ready for each branch: | Information to have ready | Why it matters | |---|---| | Purchase-invoice delay | Enter it in **for purchase invoices**. | | Sales-invoice delay | Enter it in **for sales invoices**. | | Commission-invoice delay | Enter it in **for commission invoices**. | | Unit for each delay | Choose **Days**, **Weeks**, or **Months**. | The three delay fields are optional number fields formatted as `#,##0.00`. > **Note:** Review each value together with its unit so the forecast uses the intended time scale. When the information is ready, open the list. ## Open Reports settings The Reports settings list is the administrator configuration page for role report settings. It is separate from the Reports hub. **Prerequisites** - You are signed in. - You can access the configuration area. **Steps** 1. Open the configuration area. 2. Open **Reports settings** from the configuration area. 3. Confirm that the Reports settings list page is displayed. ![The Reports settings page opened at its list landing surface](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/56a44c43f8b89f6b6b58332a6d31849d.png) **Result:** The signed-in Reports settings list is on screen. Use its columns to identify a row. ## Read the Reports settings list The Reports settings list is the directory of role report configurations. Use its five columns to identify the role setting, then choose a maintenance path. | Column | Use it to… | |---|---| | **Role** | Identify the role whose report setting you need. | | **Tabs** | Compare the number of report tabs in the setting. | | **Widgets** | Compare the number of widgets in the setting. | | **Users** | Identify the users assigned to the setting. | | **Last modified** | Find the latest modification shown for the setting. | **Prerequisites** - The Reports settings list is open. **Steps** 1. Read the **Role**, **Tabs**, **Widgets**, **Users**, and **Last modified** columns for the row. 2. Choose the path that matches your task. | If you need to… | Select or open | |---|---| | Review branch invoice delays | **Forecast settings** | | Refresh the list | **Refresh** | | Change the visible table layout | **Table Layout** | | Open list settings | **Settings** | ![The list grid with Role, Tabs, Widgets, Users, and Last modified](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/8074fd1283604d0af1a2dec6722dd97e.png) **Result:** The row is identified and the next path is selected. To review invoice delays, continue to [Review forecast settings](#review-forecast-settings). To maintain the row, continue to [Open a report setting for maintenance](#open-a-report-setting-for-maintenance). ## Review forecast settings Review the branch values and their units before maintenance. **Prerequisites** - The Reports settings list is open. - Your subscription includes **Forecast settings**. - You have the purchase, sales, and commission invoice delay values for the branch. **Steps** 1. Select **Forecast settings**. 2. Open the branch accordion for the branch you need to review. 3. Review the three optional delay fields and their units. | Field | Unit choices | |---|---| | **for purchase invoices** | **Days**, **Weeks**, or **Months** | | **for sales invoices** | **Days**, **Weeks**, or **Months** | | **for commission invoices** | **Days**, **Weeks**, or **Months** | 4. Select **OK** when the forecast-settings surface presents that confirmation action. ![Forecast settings with the branch invoice-delay fields and unit options](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/44faaaff5ae403872e12a53d4ea262b4.png) Each delay field uses the `#,##0.00` number format and is optional. The branch fields appear when the branch panel is open. **Result:** The selected branch's invoice-delay fields and available units are on screen. Return to the list to choose another row or open an existing report setting. ## Open a report setting for maintenance An existing report setting is the saved role report configuration that you inspect through its report tabs and widgets. **Prerequisites** - The Reports settings list is open. - You have identified the existing report-setting row to inspect. **Steps** 1. Open the selected report-setting row. 2. Confirm that the report-setting editor is displayed. 3. Review **Editable prev. months** and **Time Frame** on the editor. 4. Review the report tabs shown in the editor. 5. Select **Widget** to inspect widget choices for the active tab. 6. Select **Tab**. 7. Choose the tab action that matches your task. | If you need to… | Select | |---|---| | Create a tab without importing one | **Blank Tab** | | Import tabs from another role dashboard | **Import From** | | Review the saved record's history | **Last Modifications** | 8. If you select **Blank Tab**, use the required **New Tab** field in the add-tab surface. 9. If you select **Import From**, review **Another role dashboards**. 10. If the source dashboard has tabs, select **Select tab(s)**. ![The existing report-setting editor with its report tabs and maintenance controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/62fb7b86ea7e175c8229b9922650d7a3.png) **Result:** The existing report-setting editor is open, with its tab, widget, blank-tab, import, and history paths identifiable. **Save** and **Save and Close** are available in Edit mode when you are ready to commit a maintenance action. Continue to [New report setting](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reports-settings-new) or [Edit report setting](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reports-settings-edit-record) for the next task. ## Handle availability and request outcomes Report-setting surfaces change with subscription, edit state, the active tab, and whether the record has been saved. Use the condition that matches what is on screen. | Condition or message | What it means or what to do | |---|---| | The subscription includes the surface | **Forecast settings** is available from the list. | | The active visible tab has widgets | The widget library search and widget list are available. | | Edit mode is active | **Widget**, **Tab**, **Blank Tab**, **Import From**, **Save**, and **Save and Close** are available. | | The record has been saved | **Last Modifications** is available. | | A source dashboard has tabs | **Select tab(s)** and its tab-selection controls are available in the import surface. | | **Principals Report** or **Eagle View** does not appear | That option is unavailable. | | `Your request was completed successfully` | The product's success message is displayed for a completed request. | | `An error occurred while processing your request` | Review the intended action before retrying. | | `You already have this tab in this dashboard` | The tab is already present in the dashboard. Continue with the existing tab or choose another import choice. | Saving may not display a success message, so check the visible result before moving on. The three delay fields remain optional number fields with the `#,##0.00` format. ## Continue with report settings Choose the page that matches the next task: | If you need to… | Continue to | |---|---| | Choose another saved role report setting | The Reports settings list on this page | | Create a new report setting | [New report setting](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reports-settings-new) | | Maintain an existing report setting | [Edit report setting](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reports-settings-edit-record) | | Use an administrator-prepared role dashboard or report | [Reports hub](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/reports-hub) | # New report setting A new report setting brings report tabs, widgets, and time-frame choices together for later use in the reports area. A tab is a named report area; a widget is a report component placed in that area. You assemble the tabs and their contents, then save the setting. ## New report setting Use this page to create a report setting rather than change one that is already saved. Create tabs, add widgets to the active tab, import tabs from another role dashboard, and choose the time frame used by a report. | If you need to… | Go to | |---|---| | Open a new report-setting editor | [Find the new report-setting page](#find-the-new-report-setting-page) | | Read the editor before changing it | [Understand the report-setting screen](#understand-the-report-setting-screen) | | Add, rename, delete, or populate tabs | [Configure report tabs and options](#configure-report-tabs-and-options) | | Copy tabs from another dashboard | [Handle import and conditional report-setting branches](#handle-import-and-conditional-report-setting-branches) | | Save the setting and review its history | [Save and review the report setting](#save-and-review-the-report-setting) | | Resolve a blocked or uncertain action | [When saving or navigation goes wrong](#when-saving-or-navigation-goes-wrong) | | Change a setting that already exists | The existing report-setting edit page | | Use the configured reports | The **Reports** area | Open the new setting from the report-settings configuration page. The companion Edit report setting page handles later changes to a saved setting, while the **Reports** area consumes its tabs and widgets. Start with the prerequisites below. ## Prerequisites You need access to the report-setting configuration area. The report library is available when the subscription includes it and the tab is not hidden. In Edit mode, the page provides **Editable prev. months**, **Time Frame**, **Widget**, the tab menu, **Save**, **Save and Close**, and the close action. Before you begin, have the information needed for the setting ready: | Have or confirm… | Why it matters | |---|---| | Access to the report-setting configuration area | The new editor is the place where the setting is assembled. | | The report library in your subscription and visible in its tab | The report-library area supplies tab and widget actions. | | The dashboard and tab names you intend to use | A new tab requires a value in **New Tab**, and imported tabs are checked against existing names. | | The previous-months and time-frame choices | These choices control the report periods available in the setting. | The saved-record history area is available for a saved report setting. Enter the dashboard and tab names before saving. To import tabs, choose a dashboard and submit the import dialog. When these preparations are complete, find the new report-setting page. ## Find the new report-setting page The new report-setting editor is the page where you assemble a setting before saving it. **Prerequisites** - You have access to the configuration reports area. **Steps** 1. Open the report-settings configuration page. 2. Open the new report-setting editor. 3. Confirm that the page title reads `Configuration Reports`. ![The new report-setting page and its Configuration Reports title](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/49d0d4f6bcf7518b32fcdf8295dc9b39.png) **Result:** The new report-setting editor is open. The open editor is described next so you can identify the controls before configuring the setting. ## Understand the report-setting screen A report setting is made of report tabs and the widgets placed in those tabs. The main editor shows **Editable prev. months** and **Time Frame** as readouts, then provides the report-library area for **Widget**, **Tab**, and the tab-specific controls. The page also provides **Save** and **Save and Close**. | Area or control | What you use it for | |---|---| | **Editable prev. months** | Review the previous-months setting shown by the editor. | | **Time Frame** | Review the time-frame setting shown by the editor. | | **Widget** | Open the widget-selection workflow for the active tab. | | **Tab** | Open the active tab's menu. | | **Save** | Save the report setting and remain on the page. | | **Save and Close** | Save the report setting and request that the page be left. | | **Last Modifications** | Review modification history when the saved-record history area is available. | The tab menu exposes **Blank Tab** for a new tab and **Import From** for importing tabs. The relevant tab workflows use the following choices and fields: | Workflow | Reader-facing choices or fields | |---|---| | Add a tab | **New Tab** in the add-new-tab dialog | | Select a widget | **Search for widget** | | Choose a time frame | **This year**, **Definite year**, or **last 12 months** | | Change an existing tab | **Rename tab** or **Delete tab** | | Review the history area | **Last Modifications** | > **Note:** **Editable prev. months** and **Time Frame** are readouts on this editor; > use the relevant dialog when you need to change those choices. ![The editor readouts, report-library area, and save controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ca1a81e9cbde7ad428af29f347529db2.png) After identifying the editor controls, configure its tabs and options. ## Configure report tabs and options Build the tabs directly when you do not need to import them from another dashboard. **Prerequisites** - The report library is available to the subscription and its tab is visible. - The new report-setting editor is open. **Steps** 1. Open the **Tab** menu. 2. Select **Blank Tab**. 3. Enter the tab name in **New Tab**. 4. Select **OK**. 5. In the active tab, select **Widget**. 6. Use **Search for widget** to locate the widget you need. 7. Select the widget to add it to the active tab. 8. Open the time-frame choices for the active widget. 9. Select one option from the table. **Result:** The active tab contains the widget and the time-frame choice you selected. | If the report covers… | Choose | |---|---| | The current year | **This year** | | One specific year | **Definite year**, then enter a year from 2024 through the current year | | The previous twelve months | **last 12 months** | ### Rename a tab Rename the active tab when its current name no longer identifies its contents. **Prerequisites** - The tab you want to rename is active. **Steps** 1. Open the **Tab** menu. 2. Select **Rename tab**. 3. Enter the new value in **New Tab**. 4. Select **OK**. **Result:** The active tab has the new name when the value is valid and not already in use. ### Delete a tab Remove the active tab when you no longer need its reports. **Prerequisites** - The tab you want to remove is active. **Steps** 1. Open the **Tab** menu. 2. Select **Delete tab**. 3. Select **Ultimate delete** when the permanent-delete branch opens. 4. Select **Delete**. **Result:** The selected tab is removed. Select **Cancel** instead of **Delete** to close the permanent-delete branch without removing it. The previous-months value accepts a minimum of `1` and a maximum of `11`. The definite year value accepts a minimum of `2024` and a maximum of the current year. ![The tab menu with Blank Tab and Import From](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/1b2abc502fc847287e43974e18e11375.png) ![The Add new tab dialog with the New Tab field](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/148b902b6014cba9af32b0efc38af0c0.png) ## Handle import and conditional report-setting branches Importing is the branch for copying tabs from another role dashboard. **Another role dashboards** has no fixed labels; it is populated with available dashboard names. The current dashboard and dashboards without usable content are excluded from those choices. The workflow then exposes **Select tab(s)** for choosing what to copy. After you select a dashboard, **Select tab(s)** is populated with that dashboard's available tabs. | If you need to… | Use this branch | |---|---| | Copy selected tabs | Select the required entries in **Select tab(s)**. | | Replace the existing tabs with all tabs from the source | Select **All (Replace existing tabs)**. | | Change the previous-months value | Use the **number of editable Prev. months** field; enter `1` through `11`. | | Choose the current year, a specific year, or the previous twelve months | Use **This year**, **Definite year**, or **last 12 months**. | | Enter a specific year | Select **Definite year** first, then enter a year from 2024 through the current year. | **Prerequisites** - The report library is available to the subscription and its tab is visible. - A dashboard with usable tabs is available in **Another role dashboards**. **Steps** 1. Open the **Tab** menu. 2. Select **Import From**. 3. Select a dashboard in **Another role dashboards**. The list contains dashboard names from returned dashboard records: each displayed name is its `DashboardName`; the matching `Id` identifies the selected dashboard, and records with empty `DashboardJson` are excluded. 4. Select the tabs to copy in **Select tab(s)**. 5. Select **All (Replace existing tabs)** when the source dashboard's complete tab set must replace the current tabs. 6. Confirm the import in the dialog. Selected tabs are copied into the setting. Selecting **All (Replace existing tabs)** replaces the existing tabs with the source dashboard's tabs. Choose from dashboards prepared for your roles. Sales Report and Eagle View add-tab actions are not available on this page. **Result:** The selected tabs are added to the report setting, or the existing tabs are replaced when **All (Replace existing tabs)** was selected. ## Save and review the report setting Saving records the dashboard assembled from the setting's tabs and widgets. **Save** keeps the editor open, while **Save and Close** uses the same save operation and also requests that the page be left. **Prerequisites** - The tabs and widgets are in the state you want to save. - Any required **New Tab** value has been entered before saving. **Steps** 1. Select one save action from the table. 2. Confirm that the success message reads `Your request was completed successfully`. 3. Review **Last Modifications** when the saved report setting has a modification-history area. | If you want to… | Select | |---|---| | Save the report setting and remain in the editor | **Save** | | Save the report setting and leave the page | **Save and Close** | The save operation counts the tabs and widgets, serializes the dashboard, saves it, and records modification history. The success message appears after the dashboard save and modification logging complete. Continue with the recovery table if the save or navigation does not complete. **Result:** **Save** keeps the editor open. **Save and Close** requests leaving the page. After a successful save, review **Last Modifications** when it is available. ## When saving or navigation goes wrong Use the message on screen to choose the recovery action. A duplicate tab name blocks the create or rename operation; a duplicate imported tab blocks that tab from being copied. The **New Tab** field is required when creating or renaming a tab. | What you see | What it means | What to do | |---|---|---| | `Required` | **New Tab** has no value. | Enter a tab name in **New Tab**, then confirm the dialog again. | | `You already have a tab with the same name` | The new or renamed tab duplicates an existing tab name. | Enter a different value in **New Tab**, then confirm again. | | `You already have this tab in this dashboard` | An imported tab already exists in the current dashboard. | Select a different tab to import, or continue with the existing tab. | | `An error occurred while processing your request` | Loading or saving the setting encountered an error. | Check the values and connection, then retry the affected action. | **Result:** You have either corrected the tab value, avoided a duplicate, or retried a load or save action after the displayed error. ## Continue after saving After saving, use the report setting in the reports area. Report tabs can be selected, and the active tab provides **content** and **Search for widget** for working with its reports. Administrator-prepared role dashboards appear in the role-dashboard menu and can provide source tabs for later imports. | If you want to… | Action | |---|---| | Change the saved setting | Open the existing report-setting edit page. | | Use the configured reports | Open the **Reports** area. | | Select a report | Select the required report tab. | The **Save and Close** action requests leaving the new-setting page. The report-setting editor remains the place to assemble tabs and widgets; the saved-setting edit page is the companion page for changing an existing setting. # Edit report setting Use this page to review and change an existing report setting, including its report tabs, widgets, imported dashboard tabs, time frame, and editable previous-month value. ## Before you start A report setting is a saved report library configuration. This editor changes the tabs and widgets that the setting contains, while **Last Modifications** records the actions performed on the saved setting. Use **Save** or **Save and Close** only after checking the changes you intend to commit. ## Find a report setting Use the report-settings list to find a saved report setting, then open its edit form to change it. **Prerequisites** - You have access to the configuration reports area. - You have an existing saved report-setting record to open. **Steps** 1. Open the report-settings list from the configuration area. 2. Select the existing report-setting record you need to change. 3. Open the saved report setting's edit page. 4. Confirm that the Edit report setting screen is open. ![The existing report-setting editor with its record-specific controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/62fb7b86ea7e175c8229b9922650d7a3.png) **Result:** The existing report-setting editor is open. With the editor open, review its report-library areas and controls before changing a setting. ## Understand the report-setting screen The report-setting screen is a report library: report tabs hold the active report content, and widgets provide the report entries within the active tab. The main surface shows **Editable prev. months** and **Time Frame** as readouts. The screen also shows **Widget**, **Tab**, **Save**, and **Save and Close**. | Area or control | What to look for or use it for | |---|---| | **Editable prev. months** | Review the current previous-month value. | | **Time Frame** | Review the selected year or `last 12 months`. | | **Widget** | Open widget selection for the active tab. | | **Tab** | Open the add-tab menu. | | **Save** | Save the dashboard configuration. | | **Save and Close** | Save and request that the page be left. | The report tabs are **Booking**, `Sales (invoicing)`, **Financial**, **Warehouse**, and **Cash**. The report library also shows **Extend all**, **Cash Flow**, **Account Payable**, **Net Profit**, and **Last Modifications**. **Last Modifications** is the saved-setting history area. ### Fields and conditions These fields and choices control which report period, dashboard tabs, and active-tab content the saved setting uses. | Field or choice | What it shows or does | When it appears or changes | |---|---|---| | **Editable prev. months** | Shows the current value and copies that value into the numeric popup before editing. | The value is shown on the editor; the numeric field is in the `PrevMonths` popup. | | **Time Frame** | Shows the selected year or `last 12 months`. | The readout is on the editor; time-frame choices are in the time-frame popup. | | **Another role dashboards** | Available choices are the dashboard names returned for this screen. Selecting a dashboard supplies its data and identifier for loading **Select tab(s)**; the current dashboard and dashboards without dashboard data are excluded. | The import-dashboard popup. | | **Select tab(s)** | Provides the source tabs to select after a dashboard is selected. | After a dashboard is selected in **Another role dashboards**. | | **All (Replace existing tabs)** | Replaces the current tabs with the selected dashboard's tabs when selected. | In the import-dashboard popup when the choice is available. | | **number of editable Prev. months** | Accepts values from `1` through `11`. | In the `PrevMonths` popup. | | **New Tab** | Names a new or renamed report tab and is required in the report-library add/edit popup. | In the add/edit tab popup. | | **Search for widget** | Searches the widget choices for the active tab and can be cleared. | In the active-tab widget menu. | The time-frame readout can represent a selected year or `last 12 months`; the selected value is changed through its popup rather than by editing the readout itself. The previous-month readout similarly opens the numeric popup with the current value already copied into it. ![The Time Frame readout and its time-frame choices](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/79b1a8fdc0d2fafc37001060adef8257.png) When you select a dashboard in **Another role dashboards**, **Select tab(s)** is populated with the tabs returned for that dashboard. Selecting **All (Replace existing tabs)** makes the source dashboard's tabs replace the current tabs instead of adding only selected tabs. The report-library add/edit popup requires **New Tab**. The active-tab widget menu provides **Search for widget** as a clearable search field. ## Change and save report settings Use this procedure to choose the edit path first, then commit the intended report-library change with **Save** or **Save and Close**. **Prerequisites** - An existing report-setting editor is open. - You know whether the change affects a widget, a tab, imported dashboard tabs, the time frame, or previous months. - If you change a tab name, you have a value to enter in **New Tab**. **Steps** 1. In the active report tab, select **Widget** to open widget selection. 2. Select a report entry from widget selection, using **Search for widget** to narrow the choices when needed. ![The Select widget dialog for the active report tab](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d8e706df4a3b08755914f266d24e6b85.png) 3. Select **Tab** to open the add-tab menu. 4. Choose one tab action. | If you need to… | Select | |---|---| | Start a blank tab | **Blank Tab** | | Import tabs from another dashboard | **Import From** | | Rename the active tab | **Rename tab** | | Start the tab-deletion flow | **Delete tab** | 5. If you selected **Import From**, select a dashboard in **Another role dashboards**. 6. If the source dashboard is selected, choose entries in **Select tab(s)**. 7. If you want to replace the current tabs, select **All (Replace existing tabs)**. ![The Import dashboard popup with Another role dashboards and Select tab(s)](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/914cffa4e8820a62d07e304d0b625012.png) 8. If you selected **Blank Tab**, enter the tab name in **New Tab**. 9. If you selected **Blank Tab**, confirm the popup. 10. If you selected **Rename tab**, enter the new name in the tab-name editor. 11. Select **Save** to save the dashboard configuration, or select **Save and Close** to save and request page leave. **Result:** The selected widget, tab, import choice, rename choice, or delete flow is on screen, and the selected save action is available for the intended commit. ## Handle screen variations The editor changes its visible surfaces according to whether it is editing a saved record, which tabs exist, which tab is active, and which popup or dashboard choice is open. | Condition | Surface or control affected | |---|---| | Edit mode is active | Header values and **Widget**, **Tab**, **Save**, **Save and Close**, and close controls are available. | | The report setting has at least one report tab | **Widget** is enabled. | | The selected dashboard has items | The imported-tab list appears. | | The import-dashboard popup is open | **Another role dashboards**, **Select tab(s)**, and the import fields appear. | | The previous-month popup is open | **number of editable Prev. months** appears. | | A tab is active | That tab's report content appears. | | The saved setting has a history area | **Last Modifications** appears. | The add-tab entries `Sales Report` and **Eagle View** do not appear on this page because their conditions are false. The widget action depends on an existing non-empty tab set. The imported tab list depends on the selected dashboard having items, and the history area depends on the saved setting having history. ## When saving or leaving goes wrong Use the message or confirmation on screen to choose the bounded recovery action. | What you see | What it means or what to do | |---|---| | `Your request was completed successfully` | The product's success message for the completed request. | | `An error occurred while processing your request` | The product's error message for a processing failure; review the intended change before retrying. | | `This Field Is Required` | A required field in the report-library add/edit popup is empty; enter the required tab name in **New Tab**. | | `You already have this tab in this dashboard` | The selected tab already exists in the current dashboard; choose a different import choice. | | `Are you sure you want to ultimately delete this tab and all it's content ?` | The tab-deletion confirmation is open; select **Cancel** to stop or **Delete** to confirm. | After resolving a save or leave message, review the saved setting's history or choose the next report-setting destination. ## Review the result and continue **Last Modifications** is the saved setting's chronological history of user actions. It helps you review what was recorded after the setting was changed. **Prerequisites** - The existing report-setting editor is open. - The saved record has a **Last Modifications** area. **Steps** 1. Select **Last Modifications**. 2. Review the chronological sequence of user actions. 3. Choose the next destination. | If you need to… | Open | |---|---| | Review another saved setting | The report-settings list | | Create a setting instead of editing one | [New report setting](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reports-settings-new) | | Use the configured reports | The Reports hub | **Result:** **Last Modifications** is available for reviewing the saved setting's action history, and the selected next destination is open. # Activity purpose ## Where Activity purposes are used An Activity purpose is one reference value in the **Activity purposes** list. This page maintains the list used by the Activity configuration area. | If you need to… | Go to | | --- | --- | | Check the available purposes and their **Name** values | [Understand the list and form](#understand-the-list-and-form) | | Add or change a purpose | [Add or edit an Activity purpose](#add-or-edit-an-activity-purpose) | | Remove a purpose | [Remove an Activity purpose](#remove-an-activity-purpose) | | Resolve a validation or action message | [When an action goes wrong](#when-an-action-goes-wrong) | | Maintain lost reasons | [Lost reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-lost-reasons) | | Maintain regret reasons | [Regret reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-regret-reasons) | | Maintain cancellation reasons | [Cancellation reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-cancellation-reasons) | | Maintain order cancellation reasons | [Order cancellation reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-cancellation-reasons) | | Maintain units | [Units](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-item-units) | | Maintain delivery terms | [Delivery terms](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-delivery-terms) | | Maintain payment methods | [Payment methods](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-payments-methods) | | Maintain guarantee types | [Guarantee types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-requested-guarantee) | | Maintain account types | [Account types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-client-types) | | Maintain offer status | [Offer status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-offer-status) | | Maintain order status | [Order status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-status) | | Maintain inquiry status | [Inquiry status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-inquiry-status) | | Maintain order activation conditions | [Order activation conditions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-activation-conditions) | | Maintain additional costs | [Additional costs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-cost-items) | | Maintain mark-up items | [Mark Up Items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-margin-items) | ## Before you start You need a signed-in account that can reach the Activity purpose configuration screen. The list and its actions depend on your subscription and account settings: | Condition | What you see or can use | | --- | --- | | The subscription includes this configuration | The configuration grid is shown. | | The subscription does not include this configuration | An upgrade surface is shown instead of the grid. | | **New** is not hidden by configuration | **New** is available for starting an entry. | | Editing is allowed | The **Edit** icon is available for a row. | | Deleting is allowed | The **Delete** menu is available for a row. | | Your list settings provide columns | The available columns appear in the list. | > **Note:** Work from the controls actually available on your screen. Do not assume that an action > is available because another reference list shows it. Use these conditions to confirm that the list is available, then find the Activity purpose list. ## Find and open Activity purposes Open the Activity purpose list from the shared configuration tabs. The visible navigation includes **Activity Purpose** and sibling reference-list tabs. **Prerequisites** - You are signed in. - Your subscription and account configuration expose the configuration list. **Steps** 1. Open the Activity purpose configuration area. 2. Select **Activity Purpose** from the visible reference-list tabs. 3. Choose the entry path that matches your task: | Task | Select | | --- | --- | | Start a record | **New** | | Inspect an existing record | The row's **Edit** icon | ![Activity purpose list with the Activity Purpose tab and list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/709cca5236acbf42697583502f44dd37.png) Selecting **New** opens the new-entry popup. Selecting the **Edit** icon opens the selected item. **Result:** The Activity purpose list is open, a new-entry popup is open, or an existing purpose is open for inspection or editing. ## Understand the list and form The Activity purpose screen is a reference list with a popup for entering or inspecting one purpose. The list shows the **Name** column. Use the headers visible in your list. ![Activity purpose list with the Name column](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f46db6179552895f5491b28ecff2db89.png) When you start an entry, the popup title is `New Activity purpose`. The **Name** value is blank, and the popup includes **OK**. The list also includes **Refresh** and **Settings** icon buttons. ![New Activity purpose popup with a blank Name field](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ceb84311057be410c8d7316756a618b9.png) ### Fields The form accepts one visible purpose value: | Field | What you use it for | Rule | | --- | --- | --- | | **Name** | Enter the purpose name. | Required when the list requires it; special-character validation applies. | The new-entry surface shows no required marker beside **Name**. ![Blank Name field in the New Activity purpose popup](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ceb84311057be410c8d7316756a618b9.png) ### List controls and areas Use the list controls according to the action you need and the conditions that make them available. | Control or area | Use | Availability or condition | | --- | --- | --- | | **New** | Open a blank Activity purpose popup. | Hidden when the list settings hide the New control. | | **Edit** icon | Open the selected purpose. | Available when editing is allowed. | | **Delete** icon | Open the confirmation prompt. | Available when deleting is allowed. | | **Cancel** | Close the confirmation prompt. | Present in the confirmation prompt. | | **Export** | Open export choices and export the selected format. | Permission and configuration dependent. | | **Refresh** | Refresh the list. | Shown as an icon button in the list. | | **Settings** | Open list settings. | Shown as an icon button in the list. | The grid appears when the subscription includes the configuration. Otherwise, the upgrade surface replaces the grid. Use the available entry controls to add or change a purpose. ## Add or edit an Activity purpose Create a new reference value or correct an existing one with these steps. **Prerequisites** - The configuration grid is available. - **New** is available for a new purpose, or the **Edit** icon is available for an existing one. - You know the purpose name to enter. **Steps** 1. Choose the entry path that matches your task: | Task | Select | | --- | --- | | Create a purpose | **New** | | Change a purpose | The row's **Edit** icon | 2. In the **Name** field, enter the purpose name. 3. If the configured validation requires a value, enter a name before continuing. 4. If the configured special-character validation rejects the value, remove the rejected characters from **Name**. 5. Select **OK** to commit the new or edited purpose. ![Activity purpose entry popup ready for a Name value](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ceb84311057be410c8d7316756a618b9.png) After a valid entry, the list refreshes and the popup closes. The corresponding success messages are `Data updated Successfully` for an edited item and `Data saved Successfully` for a new item. **Result:** The Activity purpose list is shown after a valid entry, and the popup is closed. ## Remove an Activity purpose Use deletion only when the reference value is no longer needed. The delete action is guarded by permission and by the number of items in the list. **Prerequisites** - The Activity purpose list is open. - The **Delete** icon is available for the selected row. - At least two Activity purposes remain in the list. **Steps** 1. Select the row's **Delete** icon. 2. Read the confirmation prompt `Are you sure you want to delete this item?`. 3. Choose the confirmation action that matches your task: | Task | Select | | --- | --- | | Confirm the removal | **Delete** | | Close the prompt without deleting | **Cancel** | After a successful deletion, the row is removed and `Data Deleted Successfully` is shown. Deletion errors can show `Related to Saved data, Can't be deleted`, `Failed to Delete`, or `Must have at least one item`. **Result:** The confirmation prompt closes after **Delete** or **Cancel**. A successful deletion removes the selected row. ## When an action goes wrong Use the message on screen to choose the next action. | What you see | What to do | | --- | --- | | `Field is required` | Enter a value in **Name** when the configured column requires it. | | `Just '_' '-' And '.' Characters Accepted` | Use only the accepted characters in the purpose name. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the value or filter, then submit it again. | | `Related to Saved data, Can't be deleted` | Keep the purpose because saved data is related to it. | | `Failed to Delete` | The delete operation did not complete; check whether **Delete** is still available before repeating it. | | `Must have at least one item` | Keep at least one item in the list. | If the grid is replaced by an upgrade surface, the subscription does not include this configuration. If an action is absent, account permissions or list settings may be restricting it. Use the matching message to correct the value or choose another available action. ## What to do next After reviewing Activity purposes, use the sibling reference-list tabs in the shared configuration area to open [Lost reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-lost-reasons), [Regret reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-regret-reasons), [Cancellation reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-cancellation-reasons), [Order cancellation reasons](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-cancellation-reasons), [Units](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-item-units), [Delivery terms](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-delivery-terms), [Payment methods](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-payments-methods), [Guarantee types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-requested-guarantee), [Account types](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-client-types), [Offer status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-offer-status), [Order status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-status), [Inquiry status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-inquiry-status), [Order activation conditions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-order-activation-conditions), [Additional Costs](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-cost-items), or [Mark Up Items](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-sales-margin-items). # Templates ## Templates at a glance A template is the company document or email content used in inquiry, offer, order, procurement, inspection, and invoice work. Administrators use Templates to maintain those documents, the list of available variables, and the email wording associated with a document type. The list identifies each entry by its **Template** type, **Uploaded file name**, and **Uploaded on** date. Use the row's available action to download a sample, download the company version, upload a company document, download the variable list, or edit the matching email content. | If you need to… | Go to | |---|---| | Identify the document or email content to maintain | [Find a template](#find-a-template) | | Choose the task for a template row | [Choose the right template action](#choose-the-right-template-action) | | Download a sample, company file, or variable list | [Download a template or the variable list](#download-a-template-or-the-variable-list) | | Upload a company document | [Upload a company template](#upload-a-company-template) | | Edit email content | [Edit a document template](#edit-a-document-template) | | Upload the variable list | [Upload the list of variables](#upload-the-list-of-variables) | | Understand an error or unavailable action | [When a template action fails](#when-a-template-action-fails) | | Return to the configuration area | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) | ![The Templates list with its three identifying columns and task controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5ad38ecb30081825a4c46301a88c3f4e.png) ## Before you start Have the approved file or saved email wording ready before changing a template, because the action changes the content available to those document workflows. **Prerequisites** - Have a subscription that includes Word Templates. When it does not, the list is replaced by the subscription surface. - Have administrator access that permits the action. **Upload list of variables** is available to permitted developer accounts when the subscription includes Word Templates. - For a company document, have one `.doc` or `.docx` file ready. The upload surface accepts one file. - For the variable list, have one PDF ready. - For email editing, have the wording ready for the rich-text `E-mail template content` area. The editor also provides available variables through `#`. ## Find a template The Templates list is the starting point for matching a business document to the content you need to maintain. Read the row's **Template** value first, then use **Uploaded file name** and **Uploaded on** to distinguish the file currently associated with that type. **Prerequisites** - Know whether you are maintaining inquiry, offer, order, procurement, or invoice content. **Steps** 1. Open Templates from the configuration area. 2. In the Templates list, read the **Template** column to find the required document or email type. 3. Read **Uploaded file name** to identify the associated company file. 4. Read **Uploaded on** to compare the upload date when more than one entry needs review. ![The Templates grid with Template, Uploaded file name, and Uploaded on](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d74d536e63b645a9151c92808c39ebcc.png) **Result:** The required row is identified by its template type, file name, and upload date. Use this row's available action to continue with the required template task. ## Understand the Templates screen The Templates screen combines a page-level variable-list action with a list of template rows. Each row can expose email editing and document actions according to its type and data. The available popups are the company-template upload surface, the variable-list upload surface, and the **HTML Template Editor**. When Word Templates is not included in the subscription, the subscription-upgrade surface replaces the list. The page-level **Upload list of variables** action is shown only to permitted developer accounts. > **Important:** Use the approved company document or email wording. Template content is used by > the document workflows that follow. File actions open a popup, while email-template actions open the **HTML Template Editor**. The company-document and variable-list popups use **Upload**; the editor uses **Save** and **Cancel**. ![The HTML Template Editor opened from an inquiry email-template row](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e8f0960b9287a7a3a70b4b97ab9bd0c5.png) The editor surface includes the selected type, **HTML Template Editor**, and the instruction `Type # to insert a variable`. Its toolbar provides these controls. To edit email content, select **Offer E-mail Template**, **Order E-mail Template**, **PO E-mail Template**, **Invoice E-mail Template**, **Inquiry E-mail Template**, or **RFQ E-mail Template** in the matching row. | Editing purpose | Controls | |---|---| | History and text emphasis | `OK`, `Undo`, `Redo`, `Bold`, `Italic`, `Underline` | | Alignment and lists | `Align Left`, `Align Center`, `Align Right`, `Ordered List`, `Bullet List` | | Text and colour format | `Header`, `Font Color`, `Background Color` | | Tables | `Insert Table`, `Delete Table`, `Insert Row Above`, `Insert Row Below`, `Delete Row`, `Insert Column Left`, `Insert Column Right`, `Delete Column` | ![The HTML Template Editor toolbar controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/97b4615aa6635590c2c3f22d6897e3a9.png) ## Choose the right template action Choose an action from the row that matches the document type and whether a company file exists. | Your purpose | Select | Row condition | |---|---|---| | Edit inquiry email content | **Inquiry E-mail Template** | The row is an inquiry template | | Edit offer email content | **Offer E-mail Template** | The row is a technical or commercial offer template | | Edit order email content | **Order E-mail Template** | The row is an order-confirmation template | | Edit purchase-inquiry email content | **RFQ E-mail Template** | The row is a purchase-inquiry template | | Edit purchase-order email content | **PO E-mail Template** | The row is a purchase-order template | | Edit invoice email content | **Invoice E-mail Template** | The row is a commission or sales-invoice template | | Download the sample document | **Sample template** | The row is not an inquiry template | | Download the company document | **Company template** | The row is not an inquiry template and is not a basic template | | Provide or replace the company document | **Upload company template** | The row is not an inquiry template | | Download the variable list | **List of variables** | The row is not an inquiry template | The page-level **click here to download the list of variables.** action downloads the variable list when the subscription is included. The row-level **List of variables** action is available for non-inquiry rows. After choosing an action, follow the matching procedure below. ## Maintain and use a template Use the action that matches the row. A download requests a file, an upload opens a file popup, and an email action opens the editor for the selected type. **Prerequisites** - Locate the row using [Find a template](#find-a-template). - Confirm that the required action appears for that row. **Steps** 1. Choose the matching option in the If you need to… table below. | If you need to… | Select | Continue with | |---|---|---| | Download a file | **Sample template**, **Company template**, or **List of variables** | [Download a template or the variable list](#download-a-template-or-the-variable-list) | | Upload a company document | **Upload company template** | [Upload a company template](#upload-a-company-template) | | Edit email content | The row's email action | [Edit a document template](#edit-a-document-template) | **Result:** The selected download request, upload popup, or **HTML Template Editor** is open. ### Download a template or the variable list Download a sample, the current company document, or the variable list from the Templates screen. **Prerequisites** - Have the relevant non-inquiry row in view, or have the page-level variable-list instruction in view. **Steps** 1. Select the action that matches what you need to download. | If you need to download… | Select | |---|---| | The sample document | **Sample template** | | The company document from a non-basic row | **Company template** | | The variable list from a non-inquiry row | **List of variables** | | The page-level variable list | **click here to download the list of variables.** | ![The page-level variable-list download instruction](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/812e8487c305b131a1686b6f9cd41d0b.png) **Result:** The selected sample, company document, or variable-list download request is made. ### Upload a company template Provide or replace the company document for a non-inquiry template. **Prerequisites** - Have one approved `.doc` or `.docx` file ready. - Have a non-inquiry template row selected. **Steps** 1. Select **Upload company template** for the row. 2. In the **Upload company template** popup, select **Browse**. 3. Choose the company document file. 4. Select **Upload**. **Result:** The company-template upload request is submitted from the **Upload company template** popup. ### Edit a document template Change the email content associated with a document type. **Prerequisites** - Have an email-template row with its email action available. - Have the approved wording ready. **Steps** 1. Select the row's email action, such as **Inquiry E-mail Template**, **Offer E-mail Template**, **Order E-mail Template**, **RFQ E-mail Template**, **PO E-mail Template**, or **Invoice E-mail Template**. 2. In **HTML Template Editor**, edit the `E-mail template content` rich-text area. 3. Type `#` in the editor to insert an available variable. 4. Select the action that matches how you want to finish. | If you want to… | Select | |---|---| | Keep the changes | **Save** | | Close without saving | **Cancel** | **Result:** The selected email-template editor action is completed or cancelled from **HTML Template Editor**. ### Upload the list of variables Upload the company variable reference when it is provided as a PDF and the page-level action is available. **Prerequisites** - Have one PDF containing the list of variables. - Have an included Word Templates subscription. - Use an account permitted to access **Upload list of variables**. **Steps** 1. Select **Upload list of variables**. 2. In the **Upload list of variables** popup, select **Browse**. 3. Choose the variable-list PDF. 4. Select the action that matches how you want to finish. | If you want to… | Select | |---|---| | Submit the file | **Upload** | | Close without submitting | **Cancel** | **Result:** The variable-list upload popup is open for completion or cancellation, and its file action is **Upload**. ## When a template action fails When Word Templates is excluded from the subscription, the Templates list is unavailable. The same result applies when a row does not meet the action's type condition, while processing can also return an error. | What you see | What it means | What to do | |---|---|---| | The subscription-upgrade surface replaces the list | Word Templates is not included in the subscription | Return to the [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) or use a subscription that includes Word Templates | | **Upload list of variables** is unavailable | The action is restricted to permitted developer accounts and subscriptions that include Word Templates | Use an account permitted for the action and confirm the subscription includes Word Templates | | A row has no company-template action | The row is an inquiry template or the action condition is not met | Use the email action for an inquiry row, or choose a non-inquiry row for company-document work | | `An error occurred while processing your request` appears | The selected operation returned the shared processing error | Check the selected row and file, then retry the same supported action | If a download, upload, variable-list action, or editor save fails, the page displays `An error occurred while processing your request`. When the action is complete, continue with the document workflow below. ## Continue with the document workflow After maintaining a template, continue in the workflow that uses the same **Template** type. | Template content | Continue with | |---|---| | Inquiry | Inquiries | | Offer | Offers | | Order | Orders | | RFQ | Purchase job RFQs | | PO | Purchase job orders | | Invoice | Create invoice | Select the workflow that matches the maintained template rather than a different document category. # Bonus calculation Use Bonus calculation to review and maintain the year-based sequence of cost, salary, achievement, and bonus-distribution values. ## Before you start Bonus calculation is a year-based sequence with four stages: Costs, Salaries, Achievement, and Bonus distribution. The page loads the year from the route. A later stage becomes available only when the current calculation stage reaches it. ```mermaid flowchart LR Costs -->|Next step| Salaries Salaries -->|Next step| Achievement Achievement -->|Next step| Distribution[Bonus distribution] ``` > **Note:** Review the stage bar before looking for a later stage's fields. You can select a > stage only after the current calculation stage reaches it. | If you need to… | Go to | |---|---| | Open the year-specific calculation | [Open Bonus calculation](#open-bonus-calculation) | | Identify fields and conditions before editing | [Read the stages and fields](#read-the-stages-and-fields) | | Review or maintain stage values | [Review and maintain stage values](#review-and-maintain-stage-values) | | Set the bonus share | [Distribution](#distribution) | | Review earning controls | [Earning panel](#earning-panel) | | Follow the cost-to-achievement sequence | [Costs, Salaries, and Achievement progression](#costs-salaries-and-achievement-progression) | | Handle groups, imports, and popup choices | [Handle stage and popup variations](#handle-stage-and-popup-variations) | | Investigate an access, save, or load message | [When a calculation action goes wrong](#when-a-calculation-action-goes-wrong) | ![The configuration entry point before opening the year-specific calculation](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/152a466afcf6d227df11248a3d85d3e1.png) ## Open Bonus calculation Open the configuration entry for the required year, then check that the calculation stage bar is on screen before using a stage. **Prerequisites** - You are signed in with access to the configuration area. - You know the year whose calculation you need to review. **Steps** 1. Open the configuration area. 2. Select the Bonus calculation entry. 3. Open the year-specific route in the form `configuration/bonuce/`. 4. Select **Year**. 5. Confirm that the Bonus calculation stage bar is on screen. If access is refused, the application displays `You are not allowed to View this page!`. If the application returns you to Dashboard, stop there because the calculation page has not been reached. **Result:** The selected year is open on the Bonus calculation screen, or the access message identifies why the screen cannot be used from the current account. ## Read the stages and fields The stage bar is the route through the calculation. Costs covers branch cost inputs, including expected depreciation and amortization; Salaries covers administration, sales, and teamless-group salary amounts, plus optional service usage; Achievement covers booking and performance values; and Bonus distribution covers the net-earning share and distribution values. | Stage or surface | Reader-facing controls and fields | Condition | |---|---|---| | Period | **Year** | The selected year comes from the year-specific route. | | Costs | **Salary currency**, **Expected SG&A**, expected depreciation and amortization, **C&M collection risk%**, **Income tax**, **Legal reserve**, **First profit distribution %** | A branch is open and its collection is not empty. | | Salaries | **Salary currency**, salary amounts, service-usage percentages, **Service usage from the main branch (Only for Bonus calculation)**, **Group**, **Group name** | A branch and its salary collection are available. | | Achievement | **Booking today**, **Booking tendency**, **Expected achievement of objectives**, **Team's minimum booking rate for a bonus payout** | A branch is open. The team-performance value also requires a teamless group. | | Bonus distribution | If present, **Share of net earning for distribution as a bonus**, **Team**, **Teamless**, **Amount**, **In ratio of salaries** | A populated branch is visible, open, and not displayed as a widget. | | Earning | If present, **Earning up today**, **Earning till 31 Dec**, **Including Forecast** | An open visible distribution branch has cost data and is not displayed as a widget. | | Import | File control | The import modal is open. | The add-group popup requires **Group name**. Use these limits when entering values: | Value family | Constraint | |---|---| | Expected SG&A and expected depreciation and amortization | Minimum `0` | | Collection risk, income tax, legal reserve, first profit distribution, usage, and bonus shares | `0` to `100` | | Target ratio | `100` to `200` for the branch ratio; minimum `0` for the other target values | | Salary amounts | Minimum `0` | | Achievement performance, minimum booking rate, and teamless adjustment | Minimum `0` | Select **Costs**, **Salaries**, **Achievement**, or **Bonus distribution** in the stage bar, then open the branch panel below it. Branch panels, service usage, and distribution branches are collapsible or conditional, so their contents appear only after their conditions hold. ![The Year field and stage bar on Bonus calculation.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0204f63edda4fb604281c56ffed4df6d.png) ## Review and maintain stage values When a stage is available, review its visible branch values before saving. Costs, Salaries, and Achievement also provide **Next step** to advance the sequence. **Prerequisites** - The year-specific Bonus calculation screen is open. - The stage you need is available in the stage bar. **Steps** 1. Select the available stage tab: **Costs**, **Salaries**, **Achievement**, or **Bonus distribution**. 2. Open the branch panel whose values you need to review. 3. Review the fields shown for that branch. 4. Change a supported input within the limits in [Read the stages and fields](#read-the-stages-and-fields). 5. Select **Save** on the active stage. 6. Select **Next step** after Costs, Salaries, or Achievement when the next stage is available. The parent page's **Save** action is inactive. Use the active stage's **Save** instead. **Result:** The selected stage remains open with its configured values, and the next available stage can be selected when the sequence permits it. The documented annual sequence is to choose the applicable year, save the branch cost inputs, save salaries, review the achieved booking figures, and then save the bonus distribution. ### Distribution When Bonus distribution is present, use it to set the share of net earning used as a bonus and review the values shown for teams, teamless groups, and amount-based distribution. **Prerequisites** - **Bonus distribution** is available in the stage bar. - The relevant distribution branch is populated, visible, and open. **Steps** 1. Select **Bonus distribution**. 2. Open the applicable distribution branch. 3. Enter the share in **Share of net earning for distribution as a bonus** within `0` to `100`. 4. Review the **Team**, **Teamless**, and **Amount** values shown for the open branch. 5. Select the active distribution **Save** when the branch is not displayed as a widget. The amount-based branch includes **In ratio of salaries** when its branch is open, visible, not hidden for a widget, not displayed as a widget, and uses the percentage distribution type. The team-based ratio field additionally requires teams and an Administration team. **Result:** The open branch shows its net-earning share and available team, teamless, and amount values. The active distribution **Save** is available only on the non-widget path. ### Earning panel When present, the Earning panel provides controls for viewing earning periods in an eligible open distribution branch. | Control | Appears when | |---|---| | **Earning up today** | The branch is populated, visible, open, not a widget, and has cost data. | | **Earning till 31 Dec** | The branch is populated, visible, open, not a widget, and has cost data. | | **Including Forecast** | The same earning-panel conditions hold. | Select an earning control only after the branch and cost conditions are visible. ### Costs, Salaries, and Achievement progression Costs is the opening stage for branch cost inputs. Salaries follows it for administration, sales, and teamless-group salary amounts, with optional service usage from the main branch. Achievement follows Salaries for booking, tendency, teamless performance, and the minimum booking rate for a bonus payout. | Progression or variation | What must be available | |---|---| | Costs to Salaries | The current calculation stage reaches Salaries; the Salaries stage then becomes selectable. | | Salaries to Achievement | The current calculation stage reaches Achievement; the Achievement stage then becomes selectable. | | Branch values | An open branch with a non-empty collection. | | Salary totals | Administration, Sales, or SalesTeamless branch type. | | Service usage | The usage table is open and its corresponding team type applies. | | Teamless performance | A teamless group exists. | | Later stage availability | The requested stage number is no greater than the current calculation stage. | Target settings are not a selectable stage-bar item. Use [Targets and budgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-booking-target) for target configuration. ## Handle stage and popup variations The Salaries stage can open group and import variations. A popup choice or icon-only action is a separate surface, not an ordinary stage field. **Prerequisites** - **Salaries** is available and selected for group work. - The relevant branch or popup action is visible. **Steps** 1. Select **Group** to open the group variation. 2. In the add-group popup, enter the required value in **Group name**. 3. If the edit-group popup is shown, review the existing group value before changing it. 4. Choose the applicable popup action: | If you need to… | Select | |---|---| | Confirm or import | **Save**, **Upload**, or **Ok** | | Confirm or reject a choice | **Yes** or **No** | | Close without confirming | **Cancel** | | Leave without saving | **Don't Save** | | Return from a subscription-upgrade variation | **Back** | 5. In the import modal, select **Upload** after choosing the file. To remove a teamless salary, use its icon-only delete action. Confirm the deletion with **Yes** or leave it unchanged with **No**. **Result:** The applicable group, import, confirmation, cancellation, or subscription-upgrade surface remains on its corresponding popup path. Icon-only actions remain available only through their visible icon; they are not named fields. ## When a calculation action goes wrong Use the message on screen to choose the next action. | What you see | What it means | What to do | |---|---|---| | `You are not allowed to View this page!` | The current account was refused access to the page. | Return to the configuration entry point and use an account with the required access. | | `An error occurred while processing your request` | A header load/save or bonus-submission request did not complete. | Check the selected year and stage, then reopen the stage before attempting the supported action again. | | `Salary portions exceeded the total salary of sales teams` | The salary portions exceed the total salary of sales teams. | Review the sales salary portions before saving the stage again. | | `Your request was completed successfully` | The bonus submission reports completion. | Remain on the calculation page and review the updated stage values. | | The parent **Save** is inactive | The parent save path is not active. | Use the active stage **Save** instead. | When a message appears, review the selected year and stage. If the parent **Save** is inactive, use the active stage **Save** instead. ### Out of scope Use this page for the named stage fields and controls above. Do not infer the following from the calculation surface: | Do not infer | Boundary | |---|---| | Literal-false fields | Min margin, salary portions, commission or margin distribution values, salary totals, amount fields, and group fields under inactive guards are not active fields here. | | Year options | Available runtime **Year** choices are not defined here. | | Branch data | Runtime branch, team, teamless, panel-expansion, and default-value data are not defined here. | | Wrong-screen observations | Dashboard controls such as `Accounts`, `Report`, `Time Frame`, `Generate Report`, `Download as PDF`, `Sort by Booking`, `Sort by Target`, and `Sort by Achievement` are not Bonus calculation controls. | | Approval actor | No product-enforced person who must approve saving or deleting a calculation value is identified. | ## After reviewing the calculation After reviewing the available year and stage values, continue with the configuration area that owns the next decision. Use [Targets and budgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-booking-target) for target work, [Teams](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/teams) for team-related configuration, and [Management report widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/management-report-widgets) for related reporting. After selecting a stage or saving a value, review the displayed stage values before continuing. Use the active stage **Save** for stage changes, then continue with the configuration area that owns the next decision. # Shareable content Configure which company content can be shared between branches, save the settings, and review the modification history from the same configuration page. ## Shareable content overview Shareable content is the configuration area for deciding how company content is shared between branches. **Last Modifications** is the history area for those changes. Open **Shareable content** from the configuration area. Selecting **Last Modifications** changes the visible tab only and keeps you on the Shareable content page. | If you need to… | Go to | |---|---| | Check access and company conditions | [Before you start](#before-you-start) | | Open the configuration page | [Open Shareable content](#open-shareable-content) | | Identify the visible fields and actions | [Understand the screen](#understand-the-screen) | | Choose a sharing mode or review branch choices | [Sharing areas and fields](#sharing-areas-and-fields) | | Choose branches for a sharing mode | [Handle branch-sharing choices](#handle-branch-sharing-choices) | | Save the settings | [Save sharing settings](#save-sharing-settings) | | Review a failed load or save | [When saving does not work](#when-saving-does-not-work) | | Review saved changes | [Review modifications and continue](#review-modifications-and-continue) | | Continue from the configuration area | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) | | Review company branch records | [Branches](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-branchs-view) | The subscription-upgrade surface is shown only when the subscription feature is not included. ## Before you start Shareable-content work depends on the subscription, company context, access permission, and data available to the page. Confirm the company and its branch data before changing the settings. | Have or confirm | Why it matters | |---|---| | The shareable-content feature is included in the subscription | The main configuration content is available only when the feature is included. | | The correct company and its company ID | The page loads and saves the sharing model for the company context. | | Permission to edit the configuration | **Save** and **Save and Close** depend on edit permission. | | A change to the sharing data | The save controls are available when the data has changed. | | Shared objects for the company | The shared-object areas appear when a company has at least one shared object. | | Branch data, when choosing specific branches | The branch choices come from the company's branch records. | No required marker is shown for the visible sharing fields. ## Open Shareable content Open **Shareable content** when you need to review or change how company content is shared between branches. Prerequisites - You are signed in with access to the configuration area. - The subscription and company conditions in [Before you start](#before-you-start) are met. Steps 1. Open **Shareable content** from the configuration area. 2. Confirm that the page heading is **Shareable content**. ![The Shareable content page with its visible fields and save controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/a466f7039c1e79e3d09519e9c7900952.png) **Result:** The Shareable content page is open and ready for review or change. ## Understand the screen The main page presents the visible sharing fields, a loading readout, save actions, and a refresh control. It shows **Share Accounts/contacts Between Branches** and **Share Projects Between Branches** without required markers. It also shows `loading..` beneath both visible fields. | Screen area | What to look for | |---|---| | Visible sharing field | **Share Accounts/contacts Between Branches** | | Visible sharing field | **Share Projects Between Branches** | | Loading readout | `loading..` beneath each visible sharing field | | Save action | **Save** | | Save-and-leave action | **Save and Close** | | Refresh control | An unlabeled control with the title `Refresh` | | History area | **Last Modifications** | Use the visible sharing fields when they appear on your page. Choose **Do Not Sharing**, **All Branches**, or **Some Branches** when the choice appears in the relevant sharing area. If **Some Branches** is available, choose branches in the picker. ### Sharing areas and fields Each sharing area represents one kind of company content whose branch access can be configured. The three sharing areas are **Share Projects Between Branches**, **Share Accounts/contacts Between Branches**, and **Share Contacts Between Branches**. | Sharing area or choice | Meaning in the page configuration | |---|---| | **Share Projects Between Branches** | Sharing area for projects between branches. | | **Share Accounts/contacts Between Branches** | Sharing area for accounts and contacts between branches. | | **Share Contacts Between Branches** | Sharing area for contacts between branches. | | **Do Not Sharing** | The object is not shared. | | **All Branches** | The object is shared with all branches. | | **Some Branches** | The object is shared with selected branches. | | The branch picker | The selected-branch list used with **Some Branches** when branch data exists. | The branch picker lists the company's available branches by name. No required rule is shown for these areas. ### Actions and audit area **Last Modifications** is the page area for reviewing changes made to the sharing configuration. Selecting it displays the history area without moving away from the Shareable content page. The history area includes these readouts: | Audit-area content | Text or action | |---|---| | History tab | **Last Modifications** | | Explanation | `The audit log provides you with a chronological sequence of actions performed by the users` | | Creation readout | `Created On: - By` | | Related readout | `Tickets` | ## Handle branch-sharing choices Branch sharing lets an object use a broad sharing mode or a selected list of company branches. The selected-branch path applies when an object uses **Some Branches** and branch data is available. Prerequisites - The relevant sharing choice is available on your page. - The company has branch data when you need to select individual branches. Steps 1. In the relevant sharing area, select the available sharing mode. 2. Select **Some Branches** when you need to share the object with selected branches. 3. In the branch picker, add the branches to share. 4. Remove a branch from the selected list when it should no longer receive the shared object. 5. Review the selected branch names before saving. The account-sharing choice affects related contact choices: selecting some branches for an account can disable the all-branch and some-branch choices for the related contact object. Selecting no branch can disable both of those contact choices. The available branch records and the way those choices are enabled depend on the company data. **Result:** The sharing area contains the selected sharing mode and, when applicable, the selected company branches ready for saving. ## Save sharing settings The page loads the company sharing model before you edit it, then sends the changed model when you save. **Save** and **Save and Close** are available when the feature is included, edit permission is granted, and the sharing data has changed. Prerequisites - The Shareable content page is open. - You have edit permission. - The subscription includes the feature. - The sharing data has changed. Steps 1. Select the save action that matches your next task. | If you need to… | Select | |---|---| | Keep the page open | **Save** | | Leave after saving | **Save and Close** | 2. Confirm the message `Your request was completed successfully`. 3. If you selected **Save**, select **Last Modifications**. 4. If you selected **Save**, review the refreshed modification history. ![The Last Modifications area with the audit-log text and visible readouts](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/a466f7039c1e79e3d09519e9c7900952.png) **Result:** The changed sharing settings are saved. With **Save**, the page remains open and the history area is refreshed. With **Save and Close**, the page leaves through the available save-and-close action after success. ## When saving does not work The page uses the same error message for a failed load or save request. Use the message to identify that the request did not complete, then check whether the subscription includes the feature and whether you have edit permission. | What you see | What it means | What to do | |---|---|---| | `An error occurred while processing your request` while the page loads | The load request did not complete. | Check the company context and company ID, then reload the page. | | `An error occurred while processing your request` after selecting **Save** or **Save and Close** | The save request did not complete. | Check edit permission and the company context before trying again. | | The save controls are unavailable | Save availability depends on edit permission and changed data. | Confirm that you have edit permission and that the sharing data has changed. | | The main configuration content is unavailable | The subscription feature is not included. | Use the subscription surface for the available subscription action. | ### Out of scope The following surfaces are not part of the sharing task on this page: | Surface | Where it belongs | |---|---| | Upload, import, generic confirmation, generic alert, and generic popup controls | Shared popup functions rather than the Shareable content task | | Subscription-upgrade **Back** action | The subscription-upgrade surface shown when the feature is not included | ## Review modifications and continue After a successful save, review **Last Modifications** to confirm that the history area has refreshed. Selecting it changes the visible tab only. Prerequisites - You have saved the sharing settings or opened the page to review its history. Steps 1. Select **Last Modifications**. 2. Review the visible audit-log text and readouts. 3. Continue from the configuration area when you are ready for the next configuration task. **Result:** The saved modification history is available, and you remain in the Shareable content configuration area for your next navigation. # Manage accounts Use **Manage accounts** to combine similar account records into one account record. ## Manage accounts An account merge combines similar account records into one account record when more than one record represents the same account. The page title is **Manage accounts**, and its description is **Merge similar accounts into one account**. The account-selection area below the description contains the merge operation. ![The Manage accounts title, description, account pickers, and Merge control](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/7ebf0160813e2ee42f61baf678d0659f.png) | If you need to… | Go to | |---|---| | Check the account records before choosing a source or target | [Accounts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/accounts) | | Open the screen from the configuration entry point | [Configuration dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-home) | | Check the conditions before merging | [Before you start](#before-you-start) | | Find the screen and confirm its route | [Find Manage accounts](#find-manage-accounts) | | Identify the two account selections and the available action | [Understand the merge screen](#understand-the-merge-screen) | | Merge similar account records | [Select accounts and confirm a merge](#select-accounts-and-confirm-a-merge) | | Resolve an invalid selection or processing problem | [Handle access, validation, and errors](#handle-access-validation-and-errors) | | Check the result after the request | [Know what happens next](#know-what-happens-next) | ## Before you start Identify the records that represent the same account and decide which record remains. Source accounts are the records to combine; the target account is the record selected to receive the merge. | Before merging | What must be in place | |---|---| | Subscription | The subscription package includes the account data feature. When it is included, the page loads account data and requests authorization for the account-management area. | | Access | The page requests authorization for the account-management area before you merge. | | Records | Choose the source and target from the account choices shown in the two pickers. | If the subscription does not include the feature, the page replaces the merge area with the subscription-upgrade component. The account pickers and **Merge** control are not available in that branch. > **Note:** The account choices come from the current account lookup, so the names available in > the two pickers depend on the account records returned for your account. When these conditions are in place, find and open the screen. ## Find Manage accounts Open **Manage accounts** from the **Configuration** area. The screen appears in the **Configuration** breadcrumb context. 1. Open the Configuration dashboard. 2. Open **Merge similar accounts into one account** from the configuration area. 3. Confirm that the page title is **Manage accounts**. Opening the screen only displays the merge screen. It does not change account data. ![The Configuration breadcrumb and Manage accounts page title](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/7ebf0160813e2ee42f61baf678d0659f.png) **Result:** The **Manage accounts** screen is open. Its account-merge area is visible when the subscription includes the feature. Continue by reading the two pickers and the available action. ## Understand the merge screen The **Manage accounts** screen is an account-selection form with one or more source accounts, one target account, and a **Merge** action. | Screen element | What it does | |---|---| | **Select the accounts to be merged from** | A multi-select account picker for the source accounts. | | **Select one account to be merged to** | A single-select account picker for the target account. | | **Merge** | Starts the merge-confirmation flow when the selections satisfy the merge condition. | The two pickers show the account choices available to you. Neither picker has a required marker. The **Merge** control is available only when the merge condition is true. If the selections are incomplete or invalid, selecting **Merge** returns without opening the confirmation prompt. This screen presents the two pickers and the merge action. It has no grid or table, no validation group, and no mounted **Save**, **Save and Close**, **Export**, **Import**, or **Delete** control. Use the source picker for every account record that you want to combine into the target. ![The multi-select source-account picker](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/8dab6d4fc6399efec2f4dd8c0fa57d0e.png) Use the target picker for the account that remains after the merge. ![The single-select target-account picker](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/8dab6d4fc6399efec2f4dd8c0fa57d0e.png) ## Select accounts and confirm a merge ### Prerequisites - The **Manage accounts** screen is open. - At least one source account and one different target account are available in the pickers. ### Steps 1. Select the source and target accounts. | Select | What to choose | |---|---| | **Select the accounts to be merged from** | One or more source accounts. Each selected source account adds its account ID to the source selection. | | **Select one account to be merged to** | One target account. Selecting it sets the target selection. | Check that the target account is different from every selected source account. 2. Select **Merge**. If the selections are incomplete or invalid, the action returns without opening the confirmation prompt. 3. Read the confirmation prompt `You are about to merge these accounts, Are you sure?`. 4. Select **OK** in the confirmation popup to confirm the request. To remove a source selection, remove that account from **Select the accounts to be merged from**. To remove the target selection, remove the account from **Select one account to be merged to**. **Result:** The request reaches the confirmation point with the selected source accounts and the different target account still identified. Continue to [Know what happens next](#know-what-happens-next) to check the result after confirmation. ## Handle access, validation, and errors The merge screen has three branches: the same account cannot fill both roles, a subscription that excludes the feature shows an upgrade surface, and a processing failure uses the common error message. | What you see or select | What it means | What to do | |---|---|---| | The target account is also a selected source account | The selection is invalid. | Remove the target from the source selection or choose a different target account. | | `The target account cannot be one of the selected source accounts. Please choose a different account.` | The source and target are the same account. | Choose a different target account. | | A different target account is selected | The source and target now differ. | Select **Merge** again. | | The subscription-upgrade component replaces the merge area | The subscription excludes the account-merge feature. | Use the subscription-upgrade branch. **Back** belongs to that branch. | | `An error occurred while processing your request` | Processing returned an error. | Do not treat the merge as confirmed. Follow your access or support process. | Access depends on the authorization response for the current account. The page requests authorization for the account-management area before the merge. When the selection or access issue is resolved, return to the merge procedure. After a successful request, check the selections and account choices. ## Know what happens next A successful merge clears the source and target selections and refreshes the account choices. The page uses `Your request was completed successfully` as its success message. # Account managers ## Account managers overview An account manager is a user who manages accounts. The Account managers screen maintains the account-manager list and identifies the account owner, the manager responsible for the account. Use this page when you need to add a user, review the saved list, assign ownership, remove an eligible manager, or export the list. | If you need to… | Go to | |---|---| | See the current account-manager rows and available list actions | [Find and review account managers](#find-and-review-account-managers) | | Understand the columns, row controls, and dialogs | [Understand the account-manager screen](#understand-the-account-manager-screen) | | Add a user to the list | [Add an account manager](#add-an-account-manager) | | Assign account ownership | [Assign account ownership](#assign-account-ownership) | | Remove a user or open the export choices | [Remove or export account managers](#remove-or-export-account-managers) | | Maintain the list layout | [User layouts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-users-layouts-view) | | Continue with user administration | Users overview or Teams | ## Before you start The account-manager list is a saved list. Its filtering, grouping, and export tools depend on the related permission. The main grid appears only when a layout is selected. Prepare the access and information in this table before you begin. | Prepare | Why it matters | |---|---| | Access that includes the related list permission | Filtering, grouping, and export are available only when that permission is available. | | A selected list layout | The main grid appears only when a layout is selected. | | The user you want to add | The **Users** field takes its choices from the users available to the application. | | The current user's role and the selected row | Account ownership and removal actions change according to whether you are the account owner and whether the row is already the owner. | The rows, visible dynamic columns, permissions, popup appearance, and action results can vary with the current setup. Work from the controls and rows visible in your list. > **Note:** Select the account owner carefully. The owner row cannot be removed through > this list, and ownership actions are available only under their stated condition. ## Find and review account managers The Account managers list shows the saved account-manager rows and the toolbar actions available for this list. After you open it, review the rows and controls described in the next section before adding, assigning, removing, or exporting a manager. **Prerequisites** - You have opened the configuration area. **Steps** 1. Open the Account managers configuration page. 2. Review the toolbar for **Add account manager**, **Refresh**, **Table Layout**, and **Settings**. 3. Review the list headers **Name**, **Email**, **Phone**, **Position**, and **Active**. 4. If the list has no rows, read the list status **No Data**. 5. Select **Refresh** when you need to reload the current list. ![Review the Account managers toolbar and list area](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5151c7dd69656c9cb1b7d20874592170.png) **Result:** The Account managers list is open. Its current rows or **No Data** and its visible toolbar actions are available for review. ## Understand the account-manager screen The account-manager screen shows the headers from the selected list layout and provides actions beside eligible rows. Read the visible headers first, then use an action only when its condition applies. | Screen area | What to use it for | |---|---| | Visible list headers | Read the columns shown in the list. | | Ownership control | Select **Make as account owner** for an eligible row. | | Removal control | Open the row menu for a row that is not the account owner. | | Add dialog | Select a user and submit the add request. | | Account-owner dialog | Confirm an ownership change. | **Add account manager** opens the add dialog. The account-owner dialog appears during the account-owner confirmation flow. The search panel is hidden, and the column chooser is disabled. Editing and importing are not available on this screen. ### Fields and choice options **Users** is a searchable selection field for choosing the user to add to the account-manager list. It is required, and the open add dialog displays its required marker. ![Identify the required Users field in the add dialog](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/4dc98055201058cd9a65f2b3c2a0acd1.png) The choices in **Users** come from the users available to the application. Select the user you want to add from the choices shown in that field; the list of names depends on the current user data. ### Account views An account-owner row identifies the user who currently owns the account. If you are the account owner and the selected row is not already the owner, select **Make as account owner** in that row. If the selected row is already the owner, read **Account owner** as the row marker instead. The row delete menu appears for a row that is not the account owner. An account owner cannot be removed through this list. ## Add an account manager Adding an account manager puts a selected user into the maintained account-manager list. The add dialog requires one user selection before the request can be submitted. **Prerequisites** - You are on the Account managers list. - You know which available user to add. **Steps** 1. Select **Add account manager**. 2. In the **Add Account manager** dialog, open **Users**. 3. Select the user to add. 4. Select **OK**. 5. Review the save modal that opens. ![Submit the selected user from the Add Account manager dialog](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/4dc98055201058cd9a65f2b3c2a0acd1.png) When the request completes successfully, the application uses the message `Your request was completed successfully`. **Result:** The add request has been submitted, or the **Users** field remains marked as required when no user is selected. ## Assign account ownership Account ownership identifies the account manager responsible for the account. Only the current account owner can assign ownership to a row that is not already the owner. **Prerequisites** - You are the current account owner. - The selected row is not already marked **Account owner**. **Steps** 1. In the eligible row, select **Make as account owner**. 2. Review the account-owner confirmation flow. 3. Confirm the change in the confirm modal. The ownership result is shown as `Account Ownership has been changed`. The result detail says `The new manager should receive an email shortly to notifying his new role`. **Result:** The ownership-change request has been confirmed, and the ownership result message is displayed. ## Remove or export account managers The list provides two separate list-level paths: remove an eligible account-manager row or export the list. Export depends on the related permission. | If you need to… | Choose | |---|---| | Remove a selected eligible row | **Delete** in the confirmation dialog | | Leave a delete or export dialog | **Cancel** | | Prepare an export | **Export** | | Choose an export format | **Export to Excel** or **Export to PDF** | ### Remove an account manager Removal takes place from the row's delete path. The account-owner row is protected from removal through this list, and the current user cannot delete themself. **Prerequisites** - The selected row is not the account owner. **Steps** 1. Open the row delete menu for the eligible account manager. 2. Read the row prompt: `Are you sure you want to exclude this user as account manger?` 3. Select **Delete** to open the confirmation dialog. 4. Review the confirmation: `Are you sure you want to delete this user totally from the database?` 5. Select **Delete** in the confirmation dialog. Select **Cancel** to close the confirmation dialog without continuing. **Cancel** also closes the export dialog when that is the dialog currently open. If the selected user is yourself, the application shows `You can not delete yourself`. **Result:** The eligible removal request is confirmed, or the open confirmation is closed with **Cancel**. ### Export the account-manager list Export creates a list output in one of the formats offered by the export choices. The export path is available when the related permission is available. **Prerequisites** - You have the related export permission. **Steps** 1. Select **Export** from the account-manager list. 2. Select an export format: | If you need to… | Select | |---|---| | Create an Excel export | **Export to Excel** | | Create a PDF export | **Export to PDF** | If the list has no exportable rows, the export status is `NO Data to Export`. **Result:** The selected export choice has been started, or the list displays `NO Data to Export` when there are no rows to export. ## When an account-manager action does not work Use the message or visible list state to choose the next action. The conditions below cover required input, access-dependent list tools, and empty-list export behaviour. | What you see | What it means | What to do | |---|---|---| | `This Field Is Required` | **Users** has no selected value. | 1. In **Users**, select a user. | | **Users** contains a selected user | The required value is present. | Select **OK**. | | **No Data** in the list | The current list has no rows. | Add an account manager or select **Refresh** after the list changes. | | `NO Data to Export` | There are no rows available for export. | Review the list before selecting an export format. | | A filtering, grouping, or export tool is unavailable | The related permission is not available to the current access. | Ask an administrator to review the permission. | | A server response supplies an error | The displayed error text comes from the server response. | Use the displayed text when requesting help. | Error text is resolved dynamically from the server response, so the message can vary by failure. The add dialog's required marker is visible on **Users**. If the required-field message does not appear after you select **OK**, use the message shown on your screen as the immediate guide. If the application rejects an account-manager request, read the error message displayed on screen and follow the instruction it gives. ## What to do next After an unsuccessful account-manager change, the workflow remains on the Account managers configuration page. No stage or status change occurs when no successful change is made. Continue with [User layouts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-users-layouts-view) when you need to review the list layout. Use Users overview or Teams for adjacent user-management work. # Users Users is the administration surface for company-user records. Use it to find a record, review its information areas, or choose a path for creating a company user or a principal user. ## Users overview The Users list is the starting point: it shows company-user rows and opens the company-user form when you select a record. The form is the record screen for identity, contact, responsibility, branch, warehouse, and approval-limit information. The list also provides **New company user**. Use the separate pages for principal-user administration, roles, teams, attached-file management, and the shared files workspace unless a Users action opens a shared surface. | If you need to… | Go to | | --- | --- | | Find a company-user record or start a user task | [Find and open a user](#find-and-open-a-user) | | Read the identity, contact, branch, warehouse, and approval areas | [Understand the user screen](#understand-the-user-screen) | | Review the areas on an editable saved user | [Review the administration areas](#review-the-administration-areas) | | Review or change user information | [Review or update user information](#review-or-update-user-information) | | Create a company user | [Create a user](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-user) | | Administer principal users | Principal users | | Administer roles or teams | Roles or Teams | | Manage attached files and libraries | [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) | ![The Users list with its create actions, visible rows, and list controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6cb206b08a1a45dc4ef762ca292bd209.png) ## Before you start Users administration requires a signed-in account for both the Users list and the company-user form. Leaving the edit form with unsaved changes is protected, so keep the information ready before you begin a change. | Before you start | Why it matters | | --- | --- | | Signed-in access | Both Users screens use signed-in access. | | New-user access | **New company user** and **New principal user** require new-user access. | | Available subscription count | The two create actions also require an available subscription count. | | Existing-user edit access | Existing users use the edit permission for the form. | | Selected layout and delete access | **Delete** is available only when a layout is selected and the account has delete access. | | Required information | **Login Email**, **First Name**, **Last Name**, **Display Name**, and **Mobile** are required on the new-user form. | New-user access and existing-user edit access are separate conditions. A user who can open the list may therefore see a different set of actions from a user who can create or edit records. Use these access conditions when you open the list and choose a path. ## Find and open a user The Users list is the row-and-layout view of company users. Use it to inspect the selected layout, open an existing company-user record, start a new company-user record, or choose the separate principal-user creation path. **Prerequisites** - You are signed in. - Your account has the access needed for the action you plan to take. **Steps** 1. Open the Users list from the security administration area. 2. Review the rows and paging controls in the Users list. 3. Read the visible headers in order: **Full name**, **Display name**, **Active**, and **Email**. ![The Users list with the visible column order and paging controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/350084aeea966966b6531a41028b736e.png) 4. Select a user row to open its company-user record. 5. Choose the path that matches your task. | If you need to… | Select | | --- | --- | | Start a company-user record | **New company user** | | Start a principal-user record | **New principal user** | | Remove the selected user | **Delete**, when a layout is selected and delete access is available | 6. Select **Export** to open the export action. **Result:** The Users list is open after loading. You either have an existing company-user record open, have opened the company-user creation form, have opened the principal-user creation path, or have opened the export action. Use the open form to identify the information areas and controls available for the selected record. ## Understand the user screen The company-user screen groups information by what it controls: the user's identity and contact details, responsibility choices, branch and warehouse access, and approval amounts. The new-user form shows **Save**, **Save and Close**, **User Information**, **User Roles**, **Branches**, **Inventory**, and **Approval Limit**. | Area or control | What to review | | --- | --- | | **User Information** | Login, identity, contact, and account fields. | | **Login Email** | The user's login email; required on the new-user form. | | **Position** and **Title** | The user's position and title. | | **First Name**, **Middle Name**, **Last Name**, and **Display Name** | The user's displayed identity; **First Name**, **Last Name**, and **Display Name** are required on the new-user form. | | **Cloud Account** and **Mobile** | The cloud account and mobile contact; **Mobile** is required on the new-user form. | | **Responsible** and **Active** | Select department responsibilities and set whether the user is active. | | Branch selection and **Accessible branches** | The company branch and the branches the user can access. | | **Warehouse** | The warehouse choice when warehouse choices are available. | | Approval amounts and **Unlimited** | A limit amount or the corresponding unlimited choice for sales, LGs, purchasing, and invoicing. | On the list, **Refresh**, **Table Layout**, and **Settings** are available as list controls. The headers you see are the headers for the selected layout; use the visible headers rather than assuming that every Users installation uses the same column set. ![The new-user form with its information areas, fields, and required markers](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/658fbc7dbd020fb12f6d1a1d24191f75.png) ### Review the administration areas An editable saved user can expose several administration areas. They separate ordinary user information from role, branch, inventory, approval, and audit information. | Area | What it contains | | --- | --- | | **User Information** | Contact and account fields. | | **User Roles** | Role choices when edit access is granted. | | **Branches** and **Inventory** | Branch selection, accessible branches, and conditional warehouse choices. | | **Approval Limit** | Sales, LGs, purchasing, and invoicing limits. | | **Last Modifications** | The audit-log tab for an existing saved user. | **Last Modifications** appears only for a saved user. Role and approval areas are edit-only areas, so their availability depends on edit access and the record state. Use these areas when you review or update the user information. ## Review or update user information Review or change company-user information as follows. To create and save a new company-user record, use [Create a user](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-user). **Prerequisites** - You are on a company-user form. - For an existing user, you have edit access. - You have the required identity and contact information. **Steps** 1. In **User Information**, review or enter **Login Email**, **First Name**, **Last Name**, **Display Name**, and **Mobile**. 2. Review or enter **Position**, **Title**, **Middle Name**, and **Cloud Account**. 3. Review **Responsible** and select one or more visible department responsibilities. Select one of the visible choices listed below. | Responsibility choice | Value | | --- | --- | | **Procurement responsible** | Select Procurement responsible. | | **PM responsible** | Select PM responsible. | | **Warehouse responsible** | Select Warehouse responsible. | | **Top management** | Select Top management. | | **Quality control** | Select Quality control. | 4. Review **Active** and select the appropriate company branch. 5. Review **Accessible branches** and choose from the branch choices returned for the company. 6. If warehouse choices are available, review **Warehouse** and choose the appropriate warehouse. 7. Review each approval area and either enter an amount of at least `0` or select its matching **Unlimited** choice. 8. Choose the save action that matches what you want to do. | If you need to… | Select | | --- | --- | | Validate and save while staying on the form | **Save** | | Validate and request leaving the form | **Save and Close** | **Result:** The selected save action validates the form first. **Save** keeps the form open when you choose to remain on the form. **Save and Close** requests leaving the form. The available validation, success, or error message identifies the next result to handle. If the form differs from these steps, check the screen variations before troubleshooting a message. ## Handle user-screen variations The company-user screen changes with available choices, input context, edit access, and whether the user is an existing editable user. Use the controls that are present on your screen and use the owning page for a neighbouring administration surface. | Variation | What you see | | --- | --- | | Warehouse data | **Warehouse** appears when warehouse choices are loaded. | | Input context | **Accessible branches** is read-only when the form opens through an input context. | | Edit access | **User Roles** and **Approval Limit** are edit-only areas. | | Password blocks | **Password** and **Repeat Password** are not shown on this form. | | Two-factor area | The **2-factor Authentication** tab is not shown on this form. | | Existing editable user | **Resent mail password** is a developer-only action. | | List columns | The selected layout supplies the column set, so the headers are a layout choice rather than a fixed list. | | Subscription limit | The upgrade dialog belongs to the separate subscription surface. | The controls shown depend on the conditions in the table, including whether warehouse choices load, whether the form opens through an input context, and whether edit or developer access is available. For an existing editable user, if **Resent mail password** is available, select it. The action reports `An e-mail was sent to `. Use the message text next when a user-administration action is interrupted. ## When user administration goes wrong Use the message text to identify the type of interruption. The messages below belong to validation, filtering, save, delete, and password conditions in the Users area. | What you see | What to do | | --- | --- | | `This Field Is Required` | Enter the missing required value, including **Login Email**, **First Name**, **Last Name**, **Display Name**, or **Mobile** where it applies. | | `Email is invalid` | Correct the email value. | | `Just '_' '-' And '.' Characters Accepted` | Correct the value so it uses the accepted characters. | | `Password is too short` | Enter a longer password when the password block is available. | | `You must use a combination of letters, numbers and special characters in your password` | Enter a password that combines letters, numbers, and special characters when the password block is available. | | `Password does not match` | Make **Password** and **Repeat Password** match when those controls are available. | | `Check required field(s)` | Review the required fields before selecting a save action again. | | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the list filter. | | `Error: Please check the required fields and try again.` | Review the required fields and correct them before saving again. | | `Error: This Email or User Name Already Exists` | Use a different email or user name. | | `Error: Please fill in all required fields (e.g., Department)` | Complete the required fields, including the field identified by the message. | | `Error: Server Error` | Retry the action after checking the form values. | | `Data Deleted Successfully` | The delete action reports success. | | `You can not delete yourself` | Select a different user; the signed-in account cannot be deleted. | | `Data saved Successfully` | The save action reports success. | | `Data saved Successfully .. An E-Mail was sent to this User` | The save action reports success and the message reports that an email was sent. | | `Data saved Successfully .. This User Password has been Changed .. Please check E-Mail` | The save action reports success and the message directs you to check email after a password change. | | `An e-mail was sent to <email>` | The resend action reports that an email was sent to the displayed address. | Leaving the form with unsaved changes is protected. For subjects outside the Users form, continue with the separate administration surface. ## Out of scope Use the following shared or neighbouring administration surfaces for these subjects: | Separate subject | Continue with | | --- | --- | | Attached-file upload, download, linking, renaming, tagging, and library management | [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) | | Log-history filter controls and registration details | The **Last Modifications** area on the saved user, then its owning history surface | | Subscription upgrade dialog | The subscription surface | | Principal-user administration | Principal users | | Roles and teams administration | Roles or Teams | | Files-workspace success message `Your request was completed successfully` | [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) | After choosing the separate surface, continue with the next registered user-administration task. ## After reviewing a user The Users list is the starting point for the next registered user-administration task. A saved user can expose **Last Modifications** for audit review. | Continue with… | Go to | | --- | --- | | Company-user creation | [Create a user](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-user) | | Principal-user administration | Principal users | | Roles or teams administration | Roles or Teams | | Attached files and libraries | [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) | # Create a user ## Create and locate users A company user is a user record for a person who works in your company. An administrator creates the record when that person needs a company login and the related responsibility, branch access, or approval limits recorded in PAMS. Start at the user list, create the company user, complete the form, and return to the list to locate the saved record. | If you need to… | Go to | | --- | --- | | Start a company-user record | [Find a user](#find-a-user) | | Identify the areas on the new-user form | [Understand the user screen](#understand-the-user-screen) | | Enter identity and responsibility details | [Enter user information and save](#enter-user-information-and-save) | | Set branch access or approval limits | [Set branches and approval limits](#set-branches-and-approval-limits) | | Correct a save problem | [When saving goes wrong](#when-saving-goes-wrong) | | Work with the user list and existing records | Users page | | Configure two-factor authentication | [Two-factor authentication](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-2factor-authentications) | ## Before you start Sign in with the security access required to manage company users before opening the new-user form. If you leave while changes are unsaved, the page protects those changes before you leave. Prepare the person's identity and work choices. The new-user form requires **Login Email**, **First Name**, **Last Name**, **Display Name**, and **Mobile**. The form applies user, password, and contact validation. | Before you start | Why it matters | | --- | --- | | Signed-in access to the security user list | You need security access to open and manage the form. | | Permission to create and edit users | **New company user**, **Save**, and **Save and Close** depend on the corresponding access conditions. | | An available subscription allowance | **New company user** checks the subscription limit before opening the form. | | Login email, first name, last name, display name, and mobile | These five fields are required. | | Responsibility, branch, warehouse, and approval choices | These values are available on the form where the corresponding areas are available. | **Save** and **Save and Close** appear for a new record when the create state and edit access are allowed. Both controls remain disabled until the form has changes to save. > **Note:** A new form with no changes keeps **Save** and **Save and Close** disabled. ## Find a user The user list is the starting point for creating a company user or opening an existing user record. After the blank form opens, continue to [Understand the user screen](#understand-the-user-screen). ### Prerequisites - You are signed in. - You have access to the security user list. ### Steps 1. Open the security user list. 2. Select **New company user**. 3. Confirm that the new-user form opens. ![The user list with the New company user action](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/658fbc7dbd020fb12f6d1a1d24191f75.png) **Result:** The blank company-user form is open. To work with an existing record instead, open that record from the user list. ## Understand the user screen The user screen groups a company user's identity, work access, and approval authority into separate areas. During creation, use **User Information**, **Branches / Inventory**, and **Approval Limit** to move between those areas. | Area | What you use it for | | --- | --- | | **User Information** | Enter the user's identity, contact details, position, responsibility, and active setting. | | **User Roles** | Open the role-selection area when it is available for the record and your edit access. | | **Branches / Inventory** | Choose the branch where the user works and the branches the user can access. | | **Approval Limit** | Set the user's limits for Sales, LGs, Purchasing, and Invoicing. | Each choice under **Accessible branches** displays a branch name and its corresponding branch identifier. In the source pack, these option values are `BranchName` for the displayed branch name and `CompanyBranchID` for the corresponding identifier. The new form shows **Login Email**, **Position**, **Responsible**, **Active**, **User Information**, **User Roles**, **Branches / Inventory**, **Approval Limit**, **Title**, **First Name**, **Middle Name**, **Last Name**, **Display Name**, **Cloud Account**, and **Mobile**. It also shows **Save** and **Save and Close**. ![The User Information area with the user fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/94996ea4ebd542b97bcbcb2b9d97272b.png) The form is ready for the identity and responsibility details in [Enter user information and save](#enter-user-information-and-save). ## Enter user information and save Use **User Information** to record the person's login identity, contact details, position, and responsibility. Enter the required fields before saving; incomplete or invalid values keep the save controls unavailable or produce a validation message. During creation, **Active** cannot be changed. ### Prerequisites - The new-user form is open. - You have the person's login email, name, and mobile number. ### Steps 1. In **User Information**, enter the person's email address in **Login Email**. 2. Enter the person's position in **Position**, if applicable. 3. Select the responsibility values in **Responsible**, if applicable. | If the person is responsible for… | Select | | --- | --- | | Sales work | **Sales responsible** | | Finance work | **Finance responsible** | | Procurement work | **Procurement responsible** | | Project-management work | **PM responsible** | | Warehouse work | **Warehouse responsible** | | Top-level management | **Top management** | | Quality work | **Quality control** | 4. Enter the person's title in **Title**, if applicable. 5. Enter the person's first, middle, and last names in **First Name**, **Middle Name**, and **Last Name**. 6. Enter the name colleagues use to identify the person in **Display Name**. 7. Enter the person's cloud account in **Cloud Account**, if applicable. 8. Enter the person's mobile number in **Mobile**. The maximum length is 20 characters. 9. Choose one save action: | If you want to… | Select | | --- | --- | | Save the record and remain on the form | **Save** | | Save the record and leave the form | **Save and Close** | After the create flow sends the password email, it reports `An e-mail was sent to `. > An e-mail was sent to `` After the user is created, the confirmation reports `A activation mail with instruction sent to user `. > A activation mail with instruction sent to user `` The form uses these messages while you complete or validate the fields: | Condition | Message | | --- | --- | | A required value is missing | `This Field Is Required` | | A value contains unsupported characters | `Just '_' '-' And '.' Characters Accepted` | | **Login Email** is not a valid email address | `Email is invalid` | | Contact validation finds required values missing | `Check required field(s)` | **Result:** The form remains open after **Save**, or the record is saved and the form is left after **Save and Close**. A validation message identifies a value that needs correction. Continue to [Set branches and approval limits](#set-branches-and-approval-limits) when those choices are part of the new user's record. ## Set branches and approval limits The branch and approval areas define where the company user works, which branches the user can access, and the amounts the user can approve in four business areas. ### Prerequisites - The new-user form is open. - The company branches are available to the form. ### Steps 1. Open **Branches / Inventory**. 2. Select the user's working branch under **Works at the following branch**. 3. Select the branches the user may access under **Accessible branches**. 4. If **Keeper of warehouse** is shown, select the applicable warehouse responsibility. 5. Open **Approval Limit**. 6. For each approval area, enter an amount in **Up to** when the user has a finite limit. 7. Select **Unlimited** for an approval area when no finite amount is required. | Approval area | Currency shown | | --- | --- | | Sales | EUR | | LGs | EUR | | Purchasing | EUR | | Invoicing | EUR | When **Unlimited** is not selected, the approval amount is a number input. When it is selected, the displayed approval value is `∞`. **Keeper of warehouse** appears only when warehouse data is available to the form. ![The Branches / Inventory area with branch access choices](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/95342e73b770f7ab1588f3ea3581faa8.png) ![The Approval Limit area with its four EUR sections](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/938796aa4e7d13297eace394823e7954.png) **Result:** The form shows the user's selected working and accessible branches, warehouse responsibility when available, and the chosen finite or unlimited approval limits. Continue to [After saving](#after-saving) when all details are complete. ## When saving goes wrong Use the message on screen to identify whether the correction belongs to a field value, a contact requirement, a duplicate user, or a server condition. | What you see | What it means | What to do | | --- | --- | --- | | `This Field Is Required` | A required field is empty. | Complete the field marked as required. | | `Check required field(s)` | Contact validation found required values missing. | Review the contact-related fields and complete the missing values. | | `Just '_' '-' And '.' Characters Accepted` | The value contains characters outside the accepted pattern. | Remove the unsupported characters and enter the value again. | | `Forbidden characters detected. Please remove them and try again.` | The value contains forbidden characters. | Remove the forbidden characters, then select **Save** or **Save and Close** again. | | `Error: Please fill in all required fields (e.g., Department)` | The server still finds a required value missing. | Complete the missing required information, including the field identified by the server when available. | | `Error: This Email or User Name Already Exists` | The email or user name is already in use. | Enter a different login identity. | | `Error: Server Error` | The server rejected the save without a more specific message. | Correct any visible field problem, then select **Save** or **Save and Close** again. | | `Are you sure you want to resend the create password email to ?` | The password-email resend requires confirmation. | Confirm the resend only when the displayed email is the intended recipient. | > Are you sure you want to resend the create password email to ``? **Result:** The form remains available for correction when a validation or server message stops the save. Return to [After saving](#after-saving) after the correction succeeds. ### Out of scope The create-user flow covers the new company-user form and its branch and approval areas. The following surfaces belong to other record states or pages: | Surface | Where it belongs | | --- | --- | | **Password** and **Repeat Password** | The create flow does not show these inputs. | | **2-factor Authentication** | Use [Two-factor authentication](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-2factor-authentications) for the separate configuration surface. | | **Last Modifications** | This area applies to an existing saved user, not a new record. | | **User Roles** and role checkboxes | Role values are not part of the create flow. | | Files and document-dialog messages | Files page. | | User-list deletion dialog | Users page. | The new-user form does not show **Password**, **Repeat Password**, **2-factor Authentication**, **Last Modifications**, or the **User Roles** heading. **Last Modifications** and the **User Roles** heading are available when you work with an existing saved user. ## After saving When a new company user is created, the save flow declares a confirmation and an activation-mail message. The user record can then be located from the user list. The create success message is `Data saved Successfully .. An E-Mail was sent to this User`. The confirmation heading is `New user created`, followed by these details: ``` A activation mail with instruction sent to user ``` ``` to activate his account Whenever user activate his account You'll be notified by mail ``` Other messages associated with this form include: | Situation | Message | | --- | --- | | Password change | `Data saved Successfully .. This User Password has been Changed .. Please check E-Mail` | | Password email sent | `An e-mail was sent to ` | | Activation email | `A activation mail with instruction sent to user ` | | Resend-password confirmation | `Are you sure you want to resend the create password email to ?` | | Delete-item confirmation | `Are you sure you want to delete this item?` | Selecting **Save and Close** saves the record and leaves the form. Open the user list to locate the saved record. **Result:** The user record is saved according to the selected save action, and the user list is the next place to locate it. # Principal users A principal user is a person whose sign-in identity, account access, branches, roles, approval limits, and two-factor choice are maintained on one administration form. Use this page to open or start a record, maintain those details, and respond to validation or server messages. ## Principal users at a glance The same details screen opens for a new record and an existing record. | If you need to… | Go to | |---|---| | Open an existing principal-user record | [Find or open a principal user](#find-or-open-a-principal-user) | | Start a principal-user record | [Find or open a principal user](#find-or-open-a-principal-user) | | Review the fields and access areas | [Understand the principal-user screen](#understand-the-principal-user-screen) | | Change identity or access details | [Maintain identity and access details](#maintain-identity-and-access-details) | | Resolve a validation or server response | [Troubleshooting validation and server messages](#troubleshooting-validation-and-server-messages) | | Review the principal-user list | [Users overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/users-overview) | | Create a new user record through the dedicated procedure | [Create a user](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-user) | | Maintain reusable roles | [Roles](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/roles) | | Maintain teams | [Teams](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/teams) | ## Before you start The form opens around a person record and its credential data. The following conditions determine which fields and actions you can use. | Check | What it affects | |---|---| | The person record has loaded | The form and its controls appear. | | Credential details have loaded | **Email**, **Mobile**, and the two-factor choice can appear. | | You are allowed to edit | **Save** and **Save and Close** appear. | | The record is read-only | **Accessible account** and account-dependent controls are read-only. | | The person has an ID | **Active user** becomes available; it is disabled without an ID. | | You are ready to leave the page | The page protects unsaved changes when you leave. | When these checks are complete, continue to [Find or open a principal user](#find-or-open-a-principal-user). ## Find or open a principal user Use this procedure to reach the form. Continue to [Understand the principal-user screen](#understand-the-principal-user-screen) when it opens. **Prerequisites** - You are signed in and have reached the principal-user administration area. **Steps** 1. Open [Users overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/users-overview) to reach the user administration list. 2. Choose the route that matches your task. | If you need to… | Select or follow | |---|---| | Review an existing record | Open the principal-user record. | | Start a new record | Follow [Create a user](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-user). | ![The principal-user form with identity fields and Save actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f13f53445105c4993f689d321bb87031.png) **Result:** The principal-user details form is open for an existing record or a new user record. Continue to [Understand the principal-user screen](#understand-the-principal-user-screen). ## Understand the principal-user screen The form groups the person's identity, account access, branch and role choices, approval limits, two-factor choice, and photo actions. | Screen area | What to look for | |---|---| | Credential and account | **Email** and **Accessible account** identify the sign-in contact and account choice. | | Identity | **Active user**, **Title**, **First Name**, **Middle Name**, **Last Name**, **Display Name**, and **Mobile** hold the person's account identity. | | Branches and roles | **Allowed Branches** and **User Roles** are repeated checkbox lists. | | Permissions | **Up to** and **Unlimited** appear for Sales, Purchasing, and Invoicing. | | Two-factor area | **Apply 2-factor Authentication With This User** offers **No** and **Yes**. | ![The email and identity fields on the principal-user form](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/042bbc05563221a0ccd9b3c5b0a14bc2.png) ![The branch area and its repeated choices](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/042bbc05563221a0ccd9b3c5b0a14bc2.png) Continue to [Maintain identity and access details](#maintain-identity-and-access-details) when you are ready to enter or change values. ## Maintain identity and access details Use this procedure after the form opens. Continue to [Handle access and record variations](#handle-access-and-record-variations) when you need to review limits, two-factor settings, or photo actions. **Prerequisites** - The principal-user form is open. - Credential data is present when you need to edit **Email** or **Mobile**. - You have edit permission when you need to save changes. **Steps** 1. Review **Email**. 2. Enter a valid address in **Email** when you need to change the sign-in contact. 3. Enter the person's given name in **First Name**. 4. Enter the person's family name in **Last Name**. 5. Enter the person's displayed name in **Display Name**. 6. Enter the person's phone number in **Mobile**. 7. Optionally enter a value in **Title** or **Middle Name**. 8. In **Allowed Branches**, select the applicable branch checkboxes. 9. In **User Roles**, select the applicable role checkboxes. 10. Review **Active user** and leave it disabled when the person has no identifier. 11. Review **Accessible account**. When the record is read-only, the control is read-only. ![The required First Name field on the new-user form](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ba07038774b6fd5263f57da9e6436c59.png) ![The required Mobile field on the new-user form](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ba07038774b6fd5263f57da9e6436c59.png) **Result:** The form contains the identity and access details you reviewed or changed. Required markers appear on **Email**, **First Name**, **Last Name**, **Display Name**, and **Mobile**. **Title** and **Middle Name** have no required marker. ## Handle access and record variations After maintaining identity and access details, use the applicable option below before you save. | If you see… | Use this choice or action | |---|---| | An amount under Sales, Purchasing, or Invoicing | Review or enter the amount in **Up to**. | | A disabled infinity display | Leave the amount unchanged; the matching unlimited value is active. | | The two-factor choice | Select **No** or **Yes** under **Apply 2-factor Authentication With This User**. | | A photo-delete dropdown | Select **Delete** to start deletion, or **Cancel** to close the dropdown. | | The avatar upload area | Select **Upload** to open it. | **Prerequisites** - The principal-user form is open. - The relevant limit, two-factor, or photo area is visible. **Steps** 1. Review the applicable limit under **Up to** when an amount is shown. 2. Select **No** or **Yes** under **Apply 2-factor Authentication With This User**. 3. Choose the applicable photo action. | If you want to… | Select | |---|---| | Open the avatar upload area | **Upload** | | Begin the photo-delete branch | **Delete** | | Close the photo-delete dropdown without continuing | **Cancel** | ![The permissions and role choices on the principal-user form](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/042bbc05563221a0ccd9b3c5b0a14bc2.png) **Result:** The form shows the applicable amount or unlimited display, the selected two-factor option when visible, or the photo action area you opened. Continue to [Save, leave, and handle problems](#save-leave-and-handle-problems). ## Save, leave, and handle problems After you review the applicable variations, save the form or leave it. **Save** and **Save and Close** appear only when editing is allowed and are disabled when the form detects no changes. **Prerequisites** - You have completed the required fields. - You have edit permission. **Steps** 1. Choose the save outcome that matches your task. | If you want to… | Select | |---|---| | Run the save flow and remain on the form | **Save** | | Run the save-and-leave flow | **Save and Close** | 2. In the leave-protection prompt, choose the option that keeps your changes or the option that leaves the form. ![The Save and Save and Close actions on the new-user form](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ba07038774b6fd5263f57da9e6436c59.png) **Result:** You remain on the form after **Save**, or the save-and-leave flow runs after **Save and Close**. If a message appears, continue to [Troubleshooting validation and server messages](#troubleshooting-validation-and-server-messages). ### Troubleshooting validation and server messages Use the message to identify the correction or outcome. | Message | Action or meaning | |---|---| | `This Field Is Required` | Complete the field marked as required. | | `Email is invalid` | Correct the value in **Email** before saving. | | `Just '_'‘-''.' And '&' Characters Accepted` | Remove unsupported characters from the name value. | | `Are you sure you want to delete this item?` | Confirm the photo deletion or cancel the delete action. | | `Photo Deleted Successfully` | The photo-delete flow completed successfully. | | `Server Error` | The photo-delete operation returned a server error. | | `Data saved Successfully .. An E-Mail was sent to this User` | The new-user save branch completed and sent an email to the user. | | `Error: This Email or User Name Already Exists` | Use an email or user name that is not already in use. | | `Error: Server Error` | The save operation returned a server error. | After correcting the value or reviewing the response, continue to [What comes next](#what-comes-next). ## What comes next After saving or reviewing the principal-user form, continue with the administration task that follows. | Next task | Page | |---|---| | Find a principal user in the list | [Users overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/users-overview) | | Create a user record | [Create a user](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-user) | | Maintain reusable roles | [Roles](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/roles) | | Maintain teams | [Teams](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/teams) | # Teams ## Teams at a glance A team record groups members under a required team name and department. A saved team provides a member list, a leader, activation controls, and history; a sales team also has a booking target. Team administration sits in the security administration area alongside users and roles. The team-type list identifies `NA`, `SalesTeam`, `SalesTeamless`, `Administration`, `PurchasingTeam`, and `ProjectManagementTeam`. If you need to: | If you need to… | Go to | |---|---| | Find a team or open the new-team form | [Find and open a team](#find-and-open-a-team) | | Narrow, group, lay out, or export the list | [Adjust the Teams list](#adjust-the-teams-list) | | Read the fields and tabs on a team | [Understand the team screen](#understand-the-team-screen) | | Add or edit a member | [Add or edit a member](#add-or-edit-a-member) | | Change a leader or remove a member | [Change a member or the team status](#change-a-member-or-the-team-status) | | Review users who can become members | [Users](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/users-overview) | | Create a user before adding that person to a team | [Create a user](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-user) | | Maintain permissions beside team membership | [Roles](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/roles) | | Maintain the related booking target | [Targets and budgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-booking-target) | | Review adjacent account-manager administration | [Account managers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-account-managers-view) | ## Before you start Team administration is available only when the signed-in account can enter the security area and the subscription allows the company's team capacity. The Teams list is behind authenticated access. The new and edit routes also protect unsaved changes when you leave the screen. | Before you start | Why it matters | |---|---| | Sign in with an account that has access to security administration. | Authentication is required for the Teams list and team form. | | Check that the subscription allows another team. | If **New** is unavailable, ask the administrator to review the subscription's team capacity. | | Use a saved team for member, activation, deactivation, and history work. | Member and status actions require a team identifier; **Last Modifications** is available only for a saved team. | | Have the team name, department, members, and intended leader ready. | The team form requires the team name and department; member and leader information is used in the related surfaces. | You cannot delete a team from the Teams list. ## Find and open a team The Teams list is the starting place for finding existing teams, creating a team, and entering the merge flow. Prerequisites - Sign in with access to security administration. - Have a team record to open, or know the information for a new or merged team. Steps 1. Open the Teams list. 2. Choose the route for your task: | If you need to… | Select | |---|---| | Open an existing team in your branch | An existing team row | | Create a team | **New** | | Enter the merge flow | **Merge teams** | ![The Teams list with its team rows, toolbar, and entry actions.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/8601497aad10dfdca03de9bf2b9e9178.png) **Result:** The Teams list, an existing team record, the new-team form, or the merge dialog is on screen. Continue with [Adjust the Teams list](#adjust-the-teams-list), [Understand the team screen](#understand-the-team-screen), or the relevant maintenance procedure. ## Adjust the Teams list The Teams list is where you find teams and change what the list displays or exports. Use the team-record procedures below to change a team. | List surface | Use it to… | |---|---| | Search | Search the visible team list. | | Filters | Narrow the rows by available filter values. | | Grouping | Group rows in the list. | | Columns | Choose or review the columns in the current layout. | | Paging | Move through the list pages. | | State storing | Keep the list view state available to the list. | | Export | Open export choices and export when rows exist. | | Row opening | Open a row when its branch condition permits editing. | The list displays `Team`, `Leader`, `Memebers`, `Department`, `Target`, and `Active`. The spelling `Memebers` is the label shown in that list. The available toolbar also showed **Refresh**, Table Layout, and `Settings`. To export the current list, select **Export**, choose the available export choice, and select **Export**. If the list has no rows, the screen shows: `NO Data to Export`. The list also provides **Cancel** in the export popup. Import is not an available list operation on this surface. After adjusting the list, continue with [Understand the team screen](#understand-the-team-screen) or [Start a team record or merge teams](#start-a-team-record-or-merge-teams). ## Understand the team screen A team screen identifies the team, its department, its member and leader information, and the saved-record areas used to maintain it. | Area | What it contains | When it appears | |---|---|---| | Team identity | **Team Name** and **Department** | On the team form; both are required. | | Member summary | **Members** | On the team form; it displays the member count. | | Leader summary | **Team Leader** | On the team form; it displays the leader name. | | Booking target | **Booking target** | When the department is `SalesTeam`. | | Member maintenance | **Members** tab and Member action | On a saved, non-child team display. | | History | **Last Modifications** | When the team has an id and the history tab is selected. | The Members surface includes a member grid with a `Team member name` column and a blank leader-marker column. The new-team form shows **Team Name**, **Department**, **Members**, and **Team Leader**, plus **Save** and **Save and Close**. On a new team, **Last Modifications** is absent, and **Department** offers **Sales**, **Purchasing**, and **Project management**. ![The new-team form with required identity fields, member summary, and save actions.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/888d0d39401bd367a077f3cd57514333.png) ## Start a team record or merge teams From the Teams list, choose the route that matches the work: | If you need to… | Select | You enter | |---|---|---| | Record a team that does not yet exist | **New** | The new-team form. | | Combine selected teams into one team | **Merge teams** | The merge dialog. | Both actions are available when your access allows team creation. ### Start a new team record Use a new team record when you need to enter a team name and department before adding members or maintaining the saved team. Prerequisites - Open the Teams list with team creation available. - Have the team name and department ready. Steps 1. Select **New**. 2. In **Team Name**, enter the team name. 3. In **Department**, select **Sales**, **Purchasing**, or **Project management**. 4. Select one of these save actions: | Select | Result | |---|---| | **Save** | Save and remain on the form. | | **Save and Close** | Save and leave the form. | If a required value is missing, the form remains on screen for correction. A save validation can show: `Check validation` The form also uses these validation messages: `The common required-field message`. `The pattern message for special characters`. After a successful save, the screen shows: `Saved Successfully` If the save cannot complete, the screen can show: `Saving Error` or: `You’ve reached the maximum storage limit`. If the request fails without the storage-limit message, the screen can show: `An error occurred while processing your request`. ![The new-team form at the required-field validation and save-choice point.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/888d0d39401bd367a077f3cd57514333.png) **Result:** The team is saved, and you either remain on the team form or leave it. Continue with [Understand the team screen](#understand-the-team-screen) or [Add or edit a member](#add-or-edit-a-member). ### Open the merge dialog The merge dialog combines selected source teams into a team with its own department, name, members, and leader choice. The options for **Choose teams to merge** are team records returned for the selected **Department**. The options for **Team Leader** are member names returned from the selected teams. | Control | Options | |---|---| | **Choose teams to merge** | | | **Team Leader** | | Prerequisites - Open the Teams list with **Merge teams** available. - Know which source teams belong in the combined team. - Have the destination department, team name, and leader choice ready. Steps 1. Select **Merge teams**. 2. In **Department**, select **Sales**, **Purchasing**, or **Project management**. 3. In **Choose teams to merge**, select from the team records returned for the selected department. 4. In **Team Name**, enter the destination team name after selecting at least one source team. 5. Review the read-only **Members** list. 6. In **Team Leader**, select one of the member names from the selected teams. The merge requires at least two source teams. If you select fewer, the screen displays `Select at least two teams to merge.` The destination name and leader remain required; the corresponding messages are `Team Name is mandatory.` and `Team Leader is mandatory.` ![The Teams list with the merge entry and the new-team route available.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/a58b2f55972a8bff17a7d81352491bee.png) **Result:** The merge dialog contains the selected teams and their members, with the destination department, name, and leader fields ready for the merge branch. Continue with the merge action in the dialog. ## Maintain members and team status Member maintenance changes who belongs to a saved team; status maintenance changes whether that saved team is active. These actions are available from the saved team's Members and status surfaces, not from a new unsaved record. Prerequisites - Open a saved team record. - Know whether you need to add or edit a member, change the leader, remove a member, activate the team, or deactivate the team. Steps 1. Select **Members** to open the member-maintenance surface. 2. Choose the member task: | If you need to… | Select | |---|---| | Add a member | **Member** | | Edit a member | The member row | 3. Select the member action that matches the required change. 4. Choose the status task: | If you need to… | Select | |---|---| | Activate the team | **Activate team** | | Deactivate the team | **Deactivate team** | 5. Select `confirm` in the confirmation popup when the requested change is correct. **Result:** The saved team remains open with its member or active-state branch selected for confirmation or maintenance. Continue with [Add or edit a member](#add-or-edit-a-member) or [Change a member or the team status](#change-a-member-or-the-team-status). ### Add or edit a member The Members tab is the team-maintenance area for adding a person to a team or changing an existing member. The add-member popup uses **Team Members**; the leader choice is the Team leadership checkbox with the visible text **Team leader**. Prerequisites - Open a saved team that is not displayed as a child record. - Have an existing user record for the person to add or select. Steps 1. Select **Members**. 2. Select Member to open the add-member popup. 3. In **Team Members**, select the person to add. 4. Select Team leadership when the person must be the team leader. 5. Select **OK** to apply the member choice. 6. In the member grid, select the member row when you need to edit an existing member. 7. In the edit-member selection, choose the available person record. 8. Select Team leadership when the edited member must be the leader. The add-member popup can show `No data` in the member grid. If the selected person is already a member, the screen shows: `This person is already a member in this team`. ![The Members tab with the add-member popup, Team Members choice, and Team leadership control.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/496ecb168b7bfbeb2d49581fad21a4a9.png) **Result:** The member popup closes after **OK**, and the Members surface shows the member grid or the applicable duplicate-member message. Continue with [Change a member or the team status](#change-a-member-or-the-team-status). ### Change a member or the team status Use the actions beside a member to change leadership or remove a member. Use the status control to activate or deactivate a saved team. Prerequisites - Open a saved team that is not displayed as a child record. - For a leader change, select a member who is not the current leader. Steps 1. In the Members tab, select Make as leader for the member who must lead the team. 2. Select `confirm` to apply the leader change after checking the confirmation text. 3. In the Members tab, select Remove from team for the member to remove. 4. Select `confirm` to apply the removal after checking the confirmation text. 5. Select the required status action: | If the team must… | Select | |---|---| | Become active | **Activate team** | | Become inactive | **Deactivate team** | 6. Select `confirm` in the status confirmation popup. The confirmation texts are: `Are you sure you want to make ... a team leader?` `Are you sure you want to activate ...` `Are you sure you want to deactivate ...` `Are you sure you want to exclude ... from the team?` After the status request, the screen shows either: `Team activated successfully` or: `Team deactivated successfully` If the request fails, the screen shows the corresponding message: `Error while activate team`. or: `Error while deactivate team`. **Result:** The selected member or saved-team status has reached its confirmation branch, and a successful activation or deactivation displays its status message. Continue with [What to do next](#what-to-do-next). ## When a field or route is unavailable The missing surface usually belongs to one of five conditions: access, subscription, record state, team type, or history availability. | What you see | Condition to check | What to do | |---|---|---| | **New** or **Merge teams** is unavailable. | The list creation permission or team subscription limit does not allow the operation. | Ask the administrator to review access and the company's team capacity. | | **Save** or **Save and Close** is unavailable. | The team is displayed as a child, editing is not allowed, or there are no data changes. | Open the editable team route and change a permitted value before saving. | | The Members tab is not selected. | The member surface is not open. | Select **Members**. | | Member actions are unavailable because the team is shown as a child. | Child team displays do not provide member maintenance. | Open the editable team record. | | Member actions are unavailable because the team is not saved. | Member maintenance requires a saved team. | Save the team first. | | **Booking target** is unavailable. | The department is not `SalesTeam`. | Review the department shown on the team record. | | **Last Modifications** is unavailable. | The team has no id, or the history tab is not available for the current display. | Save the team first, then review the history surface. | ## What to do next After finding or maintaining a team, continue with the administration surface for the next task: | Next need | Continue with | |---|---| | Add a person who does not yet have a user record | [Create a user](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-user) | | Review or maintain user records | [Users](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/users-overview) | | Maintain permissions and access roles | [Roles](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/roles) | | Maintain targets related to team booking | [Targets and budgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-booking-target) | | Review account-manager administration | [Account managers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-account-managers-view) | # Roles ## Roles A role defines which parts of PAMS a person can access through a hierarchical **Sections** matrix. Use roles to organise access permissions rather than to maintain business records. | If you need to… | Go to | | --- | --- | | Check what the role list offers | [Understand the role surfaces](#understand-the-role-surfaces) | | Open a role or start a new one | [Find and open a role](#find-and-open-a-role) | | Set a role's access permissions | [Create or maintain role permissions](#create-or-maintain-role-permissions) | | Continue after saving | [After saving a role](#after-saving-a-role) | | Resolve an unavailable action or missing history | [Resolve role problems](#resolve-role-problems) | ## Before you start Role controls depend on both your permissions and the record you opened. The list shows **New** only when role creation is allowed. The edit link requires edit permission, and **Delete** requires delete permission and an inactive row. A system role is a role whose name and permission matrix are disabled and whose record actions are hidden. ## Find and open a role Use the Roles list to inspect role records, open a permitted record, start a new role, export the list, or remove an inactive role. **Prerequisites** - You have access to security administration. - You know whether the role you want to remove is inactive. **Steps** 1. Open the Roles list. 2. Choose the action that matches your task. | If you need to… | Action | | --- | --- | | Start a role | Select **New**. | | Open a permitted existing role | Select its row. | | Open a permitted existing role through its edit link | Select the edit link in the role's row. | | Prepare list data | Select **Export**. | | Remove an inactive role | Select **Delete** on the inactive row. | | Close the export choices | Select **Cancel**. | ![The Roles list with its available actions and visible rows](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/537eba0de9e046f9a78c5da3e0838415.png) ![The new-role screen after selecting New](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c2afcfebbe9e6e96a1bcd0c3693430e6.png) ![The export choices with Export and Cancel](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/fe0ce15aba8e2dd9acda33cdce460c79.png) **Result:** You have the selected role screen, the new-role screen, the export choices, the or the deletion confirmation on screen. Next, review the role surfaces before creating or maintaining permissions. ### Confirm deletion of an inactive role When **Delete** opens the confirmation for an inactive role, confirm the deletion only for the intended record. **Prerequisites** - The deletion confirmation is open. - The inactive role is the intended record. **Steps** 1. Read `Are you sure you want to delete?`. 2. Confirm the deletion choice. **Result:** The application shows `Data Deleted Successfully`. ## Understand the role surfaces The Roles area has a list surface for finding records and a role surface for identifying a role and changing its access. The role surface also provides saved history for eligible roles. | Surface | What it is for | What you can identify | | --- | --- | --- | | Role list | Locate and act on role records | The list shows **Role Name** and **Active** columns | | List tools | Adjust or prepare the list | **Refresh**, **Table Layout**, **Settings**, filters, grouping, and export choices | | Role identity | Name the role | **Role Name**; the value is disabled for a system role | | Permission matrix | Set access by section and access type | **All**, the hierarchical **Sections** tree, and access-type choices | | Permission groups | Move between permission areas | **Configuration**, **Security**, and **Other** | | Tree tools | Find or change the matrix view | **Expand all** and **Collapse all** | | History | Review saved changes | After saving a non-system role, select **Last Modifications** | | Supporting popup | Complete list actions | The shared popup used by export and confirmation surfaces | The new-role access matrix shows these columns: | Matrix columns | | --- | | **Modules** | | **View** | | **New** | | **Edit** | | **Delete** | | **Import** | | **Export** | | **Enable Editing** | | **Print** | | **Validate** | Its visible module names include `Dashboard`, `Tasks`, `Activities`, `Sales`, `Projects`, `Accounts`, `Contacts`, `Invoices`, `Payments`, `Letters of guarantee`, `Products`, `Project management`, `Purchasing`, `Warehouse`, `Reports`, `Payables`, `job profitability`, and `Tickets`. The list's data columns come from the saved layout, so work from the headers visible in your list. The list grid appears when a saved layout is available. Filters and grouping are part of the configurable list surface. Use these surfaces to create a role or maintain an existing role. ## Create or maintain role permissions A role permission record combines a role name with access choices in the hierarchical **Sections** matrix. Create a role when you need a new permission set; maintain a saved non-system role when you need to change or copy an existing set. ### Create a role When **New** opens the new-role screen, complete the role. **Prerequisites** - The new-role screen is open. - You know the name that identifies the permission set. **Steps** 1. In **Role Name**, enter the role name. 2. Select **Configuration**, **Security**, or **Other** to open the corresponding permission tree. 3. Select **Expand all** when you need to see the hierarchy. 4. Select **Collapse all** when you need to reduce the hierarchy. 5. Use **All** to select all applicable permissions in the displayed matrix. 6. Select the applicable access types for the required **Sections**. 7. Select **Save** to validate and save the role while staying on the record. 8. Select **Save and Close** to validate, save, and leave the page. If **Role Name** is empty, the form shows `This Field Is Required`. If its value contains an unsupported character, the form shows `Just '_'‘-''.' And '&' Characters Accepted`. **Result:** The saved role remains on screen after **Save**, or the application leaves the page after **Save and Close**. A successful save shows `Data saved Successfully`. ### Maintain an existing role For a saved non-system role with a permitted edit surface, copy the role or change its permissions. System roles have their identity, matrix, and record actions restricted by the screen. **Prerequisites** - A saved non-system role is open. - The role has a permitted edit surface. **Steps** 1. Select **Copy new role** to copy the existing role into a new-role flow. 2. In the new-role flow, change **Role Name** when the copy needs a different name. 3. Select the permission tree to maintain. | If you need to maintain… | Select | | --- | --- | | Configuration permissions | **Configuration** | | Security permissions | **Security** | | Other permissions | **Other** | 4. Adjust the applicable **Sections** and access-type selections. 5. Choose the save action that matches your next step. | If you need to… | Select | | --- | --- | | Save without leaving the record | **Save** | | Save and leave the record | **Save and Close** | | Review saved history | **Last Modifications** after saving a non-system role | **Result:** The maintained role is saved, or the copied permissions are available in a new role record. A successful save shows `Data saved Successfully`. To prepare list data, use the export procedure. ### Export the role list After opening the Roles list, use the export popup to prepare the list data. **Prerequisites** - The Roles list is open. - The list contains data to export. **Steps** 1. Select **Export** on the Roles list. 2. Choose the required filter or grouping settings in the export surface. 3. Choose the export outcome. | If you need to… | Select | | --- | --- | | Start the export | **Export** | | Close the choices without exporting | **Cancel** | When the list has no exportable data, the application shows `NO Data to Export`. **Result:** The export starts, the export choices close without exporting, or the empty-list message remains on screen. ## Resolve role problems Use the condition that matches what you see rather than looking for a control on a different role surface. | What you see | What it means | What to do | | --- | --- | --- | | **New** is unavailable | Creation is controlled by the list permission and subscription limit | Confirm that role creation is allowed, then return to the Roles list | | **Delete** is unavailable on a row | The row is not inactive, or delete permission is unavailable | Open an inactive row or ask an administrator to review the permission | | **Role Name** or the matrix is disabled | The role is a system role | Use a non-system role for editable permissions | | Record actions are hidden | The opened role is a system role | Return to the Roles list and open a permitted non-system role | | **Last Modifications** is missing | The role is new or a system role | Save a non-system role, then reopen its history | | The list grid is missing | No saved list layout is available | Ask an administrator to review the list layout | | Saving shows `This Role Name Already Exists` | The role name is already in use | Change **Role Name**, then select **Save** again | | A required-name validation appears | **Role Name** is empty | Enter a value in **Role Name** | | The name validation appears as `Just '_'‘-''.' And '&' Characters Accepted` | The name contains a character the form does not accept | Replace the unsupported character in **Role Name** | | Delete asks `Are you sure you want to delete?` | The application is waiting for the deletion choice | Confirm the deletion only when the inactive role is the intended record; otherwise select **Cancel** | ### Return to the Roles list after an empty export When the export shows `NO Data to Export`, return to the Roles list. **Prerequisites** - `NO Data to Export` is on screen. **Steps** 1. Return to the Roles list. **Result:** The Roles list is on screen. ### Select data before retrying an export After returning to the Roles list from an empty export, select data before retrying. **Prerequisites** - The Roles list is open. **Steps** 1. Select data in the Roles list. **Result:** The list has data ready for export. ## After saving a role After a non-system role is saved, review its history with **Last Modifications** or return to the Roles list to find the record and continue working with its permissions. # FAQ The **Home** surface is the signed-in dashboard at `/home`. ## FAQ overview | If you need to… | Go to | | --- | --- | | Confirm what the signed-in dashboard is and where it opens | [FAQ overview](#faq-overview) | | Check the access condition for the dashboard | [Before you open the home surface](#before-you-open-the-home-surface) | | Open Home and identify the dashboard entry point | [Find the home surface and report](#find-the-home-surface-and-report) | | Recognize the visible time ranges and comparison controls | [Understand the visible controls](#understand-the-visible-controls) | | Choose a booking, target, or achievement comparison | [Choose the comparison view](#choose-the-comparison-view) | | Check the dashboard editing controls | [Edit the home surface](#edit-the-home-surface) | | Identify the dashboard readouts | [Check the report result](#check-the-report-result) | | Find a broader dashboard explanation | [Dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) | | Find widget details | [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog) | | Find an exact product error message | [General error messages](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/general-error-messages) | | Find recurring issue guidance | [Common issues and solutions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/common-issues-and-solutions) | | Find broader support triage | [Getting help](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/getting-help) | ![The signed-in Home dashboard with its readouts and comparison controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/92c84c4d1016e6185b3a63a6d8c80ec6.png) ## Before you open the home surface When you are signed in, the dashboard appears. When you are signed out, PAMS shows the login screen. The **Home** route is protected by its sign-in check. | Session condition | Surface shown | | --- | --- | | Signed in | Dashboard | | Signed out | Login screen | | Opening `/home` | A route protected by the sign-in check | When you are signed in, continue to [Find the home surface and report](#find-the-home-surface-and-report). ## Find the home surface and report The Home dashboard entry point is `/home`. When it is available, **Dashboard** is visible and **Log in to PAMS** is absent. Use [Dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) for the broader dashboard surface. ![The Home route after the Dashboard entry point loads](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0204f63edda4fb604281c56ffed4df6d.png) ## Understand the visible controls The signed-in dashboard presents readouts and charts with three comparison controls. The visible time ranges are: | Dashboard item | What appears | | --- | --- | | Current range | **Today** | | Forward range | **Next 10 days** | | Previous range | **Last 10 days** | | Booking comparison | **Sort by Booking** | | Target comparison | **Sort by Target** | | Achievement comparison | **Sort by Achievement** | Use the named comparison controls above when you want to change the dashboard view. To use one, continue to [Choose the comparison view](#choose-the-comparison-view). ## Choose the comparison view Choose a booking, target, or achievement comparison to inspect the dashboard readouts from that perspective. **Prerequisites** - The **Dashboard** is visible at `/home`. **Steps** 1. Select the comparison that matches your question. | If you want to compare by… | Select | | --- | --- | | Booking | **Sort by Booking** | | Target | **Sort by Target** | | Achievement | **Sort by Achievement** | 2. Check the named dashboard readouts in [Check the report result](#check-the-report-result). **Result:** The dashboard remains on its named readouts in the selected comparison view. For editing options, continue to [Edit the home surface](#edit-the-home-surface). ## Edit the home surface Dashboard editing includes **Widget**, **Save**, and **New Tab**. The editing controls have conditions: **Widget** and **Save** are in edit mode; **New Tab** is in the add-tab or edit-tab popup; **Rename tab** is for an active editable tab in edit mode; and **Delete tab** is for an active visible tab in edit mode. | Control | Condition | | --- | --- | | **Widget** | Edit mode | | **Save** | Edit mode | | **New Tab** | Add-tab or edit-tab popup; required text field | | **Rename tab** | Active editable tab in edit mode | | **Delete tab** | Active visible tab in edit mode | The dashboard header also provides **Restore Standard Tabs**, **Cancel**, **Restore**, and **Add New Widget** while the dashboard is being edited. ### Add a widget to the active dashboard tab Use this procedure to add an available card or chart to the tab you are editing. **Prerequisites** - The dashboard is in edit mode. **Steps** 1. Select **Add New Widget**. 2. In the **Select widget** dialog, select a widget row. 3. Select **OK**. 4. Select **Save**. **Result:** The selected card or chart is added to the active tab, and the dashboard tab arrangement is saved. To find a card or chart that is already on the active tab, use **Search for widget** and search by its title. After a successful dashboard save, the dashboard stores the changes and exits edit mode after a short delay. For the resulting readouts, continue to [Check the report result](#check-the-report-result). ## Check the report result The Home dashboard combines a sales report with readouts about booking, pipeline, offers, branches, principals, and teams. Identify each readout by its label. | Area | Dashboard readout | | --- | --- | | Report | **Sales Pipeline** | | Yearly booking | **Booking This Year** | | Pipeline accounts | **Accounts in Sales Pipeline** | | Team comparison | **Teams Booking vs. Target** | | Team offers | **Teams Running Offer** | | Branch tendency | **Branch Tendency to Target** | | Principal tendency | **Principals Tendency to Target** | | Yearly branch comparison | **Branch Booking vs. Target This Year** | | Branch offers | **Branch Running Offers** | | Principal offers | **Principals Running Offers** | ## When the answer is not available Report choices depend on the current report data. Dashboard editing options depend on your dashboard setup. ### If no dashboard is configured If the page says `Your role has no dashboard`, contact your administrator to define a dashboard for your role. If the page says `Kindly, Contact your administrator to define a dashboard`, contact your administrator to define one for your role. For a message that does appear, match it to the condition below. | Condition | Message | | --- | --- | | Login username validation | `User Name is Required` | | Login password validation | `Password Required` | | Verification-code validation | `code is required` | | Verification-code error | `Verification code not correct or expired` | | Common success response | `Your request was completed successfully` | | Common error response | `An error occurred while processing your request` | | Principal report validation | `Please choose one or more principals` | | Generic required validation | `This Field Is Required` | ### Out of scope messages The **Login** page handles `Incorrect username or password`. ## Get help with messages and lists For an exact product message, continue to [General error messages](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/general-error-messages). For a recurring issue, continue to [Common issues and solutions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/common-issues-and-solutions). ## Know where to continue Continue with the page that answers your next question: | Your question | Continue with | | --- | --- | | What dashboard widgets mean or contain | [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog) | | How the broader dashboard works | [Dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) | | What an exact error message means | [General error messages](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/general-error-messages) | | How to handle a recurring issue | [Common issues and solutions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/common-issues-and-solutions) | | Where to start broader support triage | [Getting help](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/getting-help) | # General error messages Inspect **Notifications**, distinguish an empty notification state from a product error, and record any message exactly as it appears. ## General error messages Focus on error messages shown by the product or defined for its screens. | If you need to… | Go to | |---|---| | Prepare access to the notification surface | [Before you start](#before-you-start) | | Open Notifications and check the visible message | [Open Notifications and identify the visible message](#open-notifications-and-identify-the-visible-message) | | Tell filters and notification states apart | [Inspect the notification state](#inspect-the-notification-state) | | Respond when a notification operation appears to fail | [When a notification operation fails](#when-a-notification-operation-fails) | | Record the result and continue | [Continue from the result](#continue-from-the-result) | ## Before you start Notifications is the area where you inspect the product's notification state and any message shown with it. You need a signed-in session, and your subscription must include Notifications. | Prepare | What to check | |---|---| | Access | Sign in before opening the Notifications page. | | Subscription | Confirm that your subscription includes Notifications. | | Filters | Be ready to check **All**, **Requests**, **Feedback**, **Reminders**, and **Following**. | Confirm both before you interpret what is on screen. Then open Notifications and identify the visible message. ## Open Notifications and identify the visible message Check Notifications for a product error message or an ordinary notification state. **Prerequisites** - You are signed in. - Notifications is included in your subscription. **Steps** 1. Open the Notifications page. 2. Confirm that the heading **Notifications** is visible. 3. Check the visible notification groups. | Group | What its presence means | |---|---| | **Today** | Notifications exist for today. | | Yesterday | Notifications exist for yesterday. | | Earlier | Notifications exist in the earlier notification collection. | | `No New Notifications` | The Today, Yesterday, and Earlier collections are all empty. | 4. Record any product message exactly as it appears, including its capitalization and punctuation. 5. If the message is `No New Notifications`, record it as an empty notification state rather than as a product error. **Result:** You are on the Notifications page and know whether the visible content is a notification group, an empty state, or a product error message. Next, inspect the notification state that applies. ## Inspect the notification state A notification filter narrows the notifications shown on the same page. Selecting a filter changes which notifications you inspect; it does not change the notification itself. > **Note:** A filter selection keeps the browser on the Notifications page; record the selected filter > separately from any action on a notification. **Prerequisites** - The Notifications surface is open. - You can see the filter controls. **Steps** 1. Select one filter from the table below. Select **All**, **Requests**, **Feedback**, **Reminders**, or **Following**. ![Inspect the All notification filter on the Notifications page](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ebaf597ccb38be32fd4f0a4e0e699e6a.png) 2. Confirm that the browser remains on the Notifications page after the filter selection. 3. If the full-screen or popup header shows **Mark all as read**, use it only when you intend to mark the displayed notifications as read. 4. Identify the visible notification state. | Visible state | What to record | |---|---| | **New** | The page notification collection is non-empty and the notification is new. | | Seen | The page notification collection is non-empty and the notification is seen. | | `No Data` | The page notification collection is empty. | 5. Repeat steps 1 and 2 for any other filter you need to inspect. **Result:** You have recorded the filter and visible notification state. Use that result to choose the applicable notification action. ## When a notification operation fails Use only a message that is actually visible or defined by the product; do not replace an empty state with an invented failure message. | What you see | What it means | What to do | |---|---|---| | `No New Notifications` | The Today, Yesterday, and Earlier notification collections are empty. | Record the empty state and continue from the result. | | `No Data` | The page notification collection is empty. | Record the empty state and continue from the result. | | No product error, validation, confirmation, or request-failure message | No such message appears in the inspected Notifications view. | Record the visible notification state. | Some notification items do not have a text label for their opening action. Select the visible item when the notification type is feedback or information. ## Continue from the result After inspecting Notifications, record the message or empty state and choose a visible action that matches the notification type. **Prerequisites** - You have recorded the selected filter. - You have recorded the visible notification state or exact message. **Steps** 1. Select the action that matches the notification type and state. | Notification type or state | Select | |---|---| | Notifications is open in a popup | **View All** | | Request | **Job No.** | | Unseen request for a new task assignment, activity assignment, or activity change | **Decline** or **Accept** | | Reminder | **at** | | Feedback or information | The visible notification item | ![Record the selected filter while remaining on Notifications](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/25414958b7de73169f34ac65dc720ff4.png) **Result:** You have recorded the Notifications result and selected the visible action that applies to the notification. # Common issues and solutions Identify the dashboard or report surface affected by a problem, apply the available correction, and continue from the result. | If you need to… | Go to | |---|---| | Identify whether the issue is in Home, a custom dashboard, Business Analysis, or Principal Report | [Reach and identify the affected surface](#reach-and-identify-the-affected-surface) | | Read the controls and report values currently on screen | [Read the settled surface](#read-the-settled-surface) | | Restore a widget or change a dashboard tab | [Restore home work](#restore-home-work) and [Dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) | | Personalize and save the wider workspace | [Personalizing your workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/personalizing-your-workspace) | | Find recurring dashboard questions | FAQ (sibling page) | | Match a message to its exact wording | [When a message or control does not match](#when-a-message-or-control-does-not-match) and [General error messages](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/general-error-messages) | | Continue when the problem remains | [Continue from the result](#continue-from-the-result) and [Getting help](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/getting-help) | ## Before you start Home is the signed-in starting surface for dashboard work. The covered surfaces are **Home**, the dashboard library, custom-dashboard, **Business Analysis**, and principal-report surfaces reached from the signed-in dashboard. The Home shell is available after you sign in. Start troubleshooting only after the signed-in session is in place. **Prerequisites** - You are signed in so the Home shell can be available. - You know which dashboard or report surface contains the problem, or you can reach **Home**. ## Reach and identify the affected surface Use the visible navigation and controls to decide which dashboard or report surface owns the problem. The same dashboard can show different controls when you edit it, view a prepared dashboard, open a report popup, or use a feature-controlled widget. | What you see | Surface to identify | |---|---| | The main **Home** surface | Home | | Dashboard editing actions | Dashboard editing | | A role dashboard choice while the dashboard is not being edited | Role dashboard prepared by an administrator | | A dashboard library with available tabs | Dashboard library | | A custom dashboard surface | Custom dashboard | | **Business Analysis** | Business Analysis | | A popup titled **Settings** | Principal Report settings | | A control titled **Introduction & Outline** | Principal Report introduction and outline | | Options attached to a widget | That widget's available options | **Prerequisites** - You are signed in. - You can reach **Home** or the dashboard or report surface that contains the problem. **Steps** 1. Open **Home**. 2. Use the table to match the visible surface to the dashboard or report area that owns the problem. 3. Select **Settings** when the problem concerns Principal Report choices or readouts. 4. Select **Introduction & Outline** when the problem concerns the report introduction. 5. Read the options shown with the affected widget when the problem concerns a widget choice. In **Highlight**, choose from the account choices displayed by the control. The **Highlight** control presents those account choices as its selectable values. 6. Continue with [Restore standard tabs](#restore-standard-tabs) for a missing standard tab. 7. Continue with [Save changes](#save-changes) for a dashboard change that needs committing. **Result:** You have identified the visible dashboard or report surface that needs attention. Continue with [Read the settled surface](#read-the-settled-surface) when the problem concerns a report or its settings. ## Read the settled surface The settled surface is the report or settings view that remains on screen after it opens. Use the labels, buttons, and table headings shown on that page. **Prerequisites** - You have reached the Principal Report surface. **Steps** 1. Open the Principal Report surface from the dashboard. 2. Check whether **Report** has a required marker. 3. Check for **Generate Report** and **Download as PDF**. 4. Read the visible report text, including **Accounts**, **Time Frame**, `last 12 months`, **Settings**, **Introduction & Outline**, and **Tickets**. 5. If **Settings** is available, select it and read the controls and readouts on that surface. 6. Compare the settings surface with the following visible labels and buttons: **All**, **Running jobs**, **Bar**, **Pie**, **Status of running firm offers**, **Status of running orders**, **Reasons for lost jobs**, **Bookings over time**, **Monthly**, **Quarterly**, **Yearly**, **Deliveries over time**, **Status of submitted offers**, **Sales Overview + Overall Analysis**, **Show Lists**, **Generate Report**, **Download as PDF**, and **OK**. 7. Read the settings readouts **Accounts**, **Time Frame**, **Client**, and **Product Type**. ![Read the visible Principal Report controls, required marker, and report actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2f267c2b884aa3e174f4e36cdf24706e.png) **Result:** You have the Principal Report labels, buttons, and readouts needed to continue the task. Continue with [Handle access and report branches](#handle-access-and-report-branches) when a choice is unavailable. ## Restore home work A widget is a dashboard area that you can restore while the Home surface is signed in and in edit mode. Use the available dashboard editing controls when a widget is missing or the dashboard tab needs correction. **Prerequisites** - You are signed in. - The Home dashboard is in edit mode. **Steps** 1. Open the dashboard editing surface. 2. Select **Widget** while the dashboard is in edit mode. 3. Choose the correction that matches the problem: | If you need to… | Select or open… | |---|---| | Remove the selected widget from the active tab | **Remove widget from tab** | | Add a dashboard tab | The add-new-tab or edit-tab popup, then **New Tab** | | Apply another correction to the active tab | The dashboard-tab action available for that tab | **Result:** The available widget or tab correction is applied to the editable Home surface and is ready for [Save changes](#save-changes). ### Save changes Save commits an eligible dashboard edit while the signed-in Home surface is in edit mode. **Prerequisites** - You are signed in. - You have changed an editable dashboard surface. - The dashboard is in edit mode. **Steps** 1. Select **Save**. 2. Read the message returned by the product. | Message | What to do | |---|---| | `Your request was completed successfully` | Continue from the saved dashboard result. | | `An error occurred while processing your request` | Treat the dashboard change as a processing error and use [When a message or control does not match](#when-a-message-or-control-does-not-match). | **Result:** The product returns either `Your request was completed successfully` or `An error occurred while processing your request` after the dashboard save request. ### Remove an extra tab An extra tab is an active dashboard tab that the product permits you to edit or remove. The tab actions depend on the active tab and its availability conditions. **Prerequisites** - You are signed in and viewing the dashboard library. - The active tab is editable when you remove it. **Steps** 1. Check that the active tab is the tab you intend to remove. 2. If **Delete tab** is visible, select **Delete tab**. 3. If you need to change the active user or MRM tab name instead, select **Rename tab**. 4. Open the dashboard library and check the active tab. **Result:** The active editable tab is removed or renamed when its corresponding tab action is available; otherwise, you have identified that the active tab is not editable under its current conditions. ### Restore standard tabs Standard tabs are dashboard library entries controlled by tab availability and subscription conditions. **Principals Report** appears for an enabled sales-report tab, and **Eagle View** appears for an enabled Eagle View tab. **Prerequisites** - You are signed in and viewing the dashboard library. **Steps** 1. Check whether **Principals Report** is available in the dashboard library. 2. Check whether **Eagle View** is available in the dashboard library. 3. Check that the dashboard library contains an active tab and available tabs. 4. If a widget option is absent, check whether that feature is available for the widget. **Result:** You have matched the missing standard tab or widget option to its availability or subscription condition. ## Handle access and report branches Access and report branches determine which choices are available on the current surface. A control can remain unavailable when your role, subscription, feature access, popup, or editing state does not provide it. **Prerequisites** - You have identified the current dashboard or Principal Report branch. - You can see the current report or settings surface. **Steps** 1. Check whether the role dashboard choice is visible while the dashboard is not being edited. 2. Check whether the dashboard library shows an active tab and available tabs. 3. In Principal Report, select **Settings**. 4. In the settings surface, use the available choices **All**, **Running jobs**, **Bar**, **Pie**, **Status of running firm offers**, **Status of running orders**, **Reasons for lost jobs**, **Bookings over time**, **Monthly**, **Quarterly**, **Yearly**, **Deliveries over time**, **Status of submitted offers**, **Sales Overview + Overall Analysis**, and **Show Lists**. 5. Select **OK** to confirm the settings surface when that button is available. 6. If the report requires principals, select one or more principals before generating it. ![Read Principal Report Settings choices, readouts, and OK](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d343d7b54cfac3295024324742368393.png) **Result:** You have identified whether the unavailable item follows a role, subscription, feature, tab, popup, or required-principal branch. Continue with [When a message or control does not match](#when-a-message-or-control-does-not-match) when the visible result still does not match the expected choice or message. ## When a message or control does not match Use the exact message on screen to separate a processing error from a missing report choice. When a control is hidden, use the visible surface and its available choices rather than treating the hidden control as a failed action. | What you see | Meaning | What to do | |---|---|---| | `An error occurred while processing your request` after Home work | Home processing error | Return to the editable dashboard branch and review the change before selecting **Save** again. | | `An error occurred while processing your request` in Principal Report | Principal Report processing error | Review the report branch and its settings before generating the report again. | | `Please choose one or more principals` | A required principal choice is missing | Choose one or more principals, then return to the report action. | | **Introduction & Outline** is available in the Principal Report action area | This action belongs to the report introduction and outline | Select **Introduction & Outline** from the Principal Report action area. | ### Out of scope messages and choices Login and verification choices belong to signed-out branches, not Home troubleshooting. Route the login message to [Getting help](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/getting-help) or the Login page rather than applying a dashboard fix. | Message, control, or value | Route | |---|---| | `Incorrect username or password` | Login-specific handling | | **Email** | Signed-out login branch | | **Password** | Signed-out login branch | | **Enter code** | Verification branch | | **Over** options | **Clients**, **Projects**, and **Market Segments** | | **Highlight** account choices | In **Highlight**, choose from the account choices displayed by the control. | | Table headings | Use the headings shown on the current page. | ## Continue from the result Continue from the dashboard or report surface you can see. **Prerequisites** - You have applied the available dashboard or report correction, or matched the exact message. **Steps** 1. Choose the next task from this table: | If the next task concerns… | Open… | |---|---| | Dashboard orientation or widgets | [Dashboard](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) | | Workspace editing | [Personalizing your workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/personalizing-your-workspace) | | Exact error wording | [General error messages](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/general-error-messages) | | An issue that remains | [Getting help](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/getting-help) | **Result:** You continue from the Principal Report result or the corrected dashboard branch to the page that owns the next task or help request.