Fast Start
| User need | Start with | Why | Guide |
|---|---|---|---|
| Create a product or service master record. | Articles | Article records feed sales, purchases, stock movements, price tables, lots, serials, and reports. | Create article |
| Check article list, filters, stock columns, or article detail tabs. | Articles route map | The authenticated route map captures the list, article detail tables, filters, bulk actions, and detail tabs. | Use stock route map |
| Add stock into a warehouse. | Stock Movements / Entrada p/ Recontagem | Verified movement 239 added quantity 2 into warehouse 1. | Update stock |
| Move stock between warehouses. | Stock Movements / Transferencia entre armazens | Verified movement 243 moved one unit from warehouse 1 to warehouse 2. | Update stock |
| Remove stock by recount/adjustment. | Stock Movements / Saida p/ Recontagem | Verified movement 244 reduced warehouse 2 by one unit. | Update stock |
| Plan inventory count work. | Recountings | The route exposes Nova recontagem, warehouse/date/description/family/brand/sector filters, and open/closed state columns. | Route map |
| Trace serial numbers or lots. | Historical Serial No. or Lots of Articles | Serial history filters by article and serial number; lots list by article, lot code, dates, validity, and cost fields. | Route map |
| Import prices, stock, or price tables. | Import of Prices / Stock | The import wizard exposes import type, file upload, mapping tables, previews, and review/error tables. | Route map |
| Manage price tables, base prices, rules, or discounts. | Stock Tools | Price routes expose base-price management, article/customer price-table wizards, selling-price rules, and discount management. | Route map |
| Maintain units of measure. | Support Files / Units | Units feed article master data and document line unit selectors. | Manage stock units |
| Maintain article brands. | Support Files / Brands | Brands classify article master records and support filters, imports, prices, and reports. | Manage stock brands |
| Maintain other stock support files. | Support Files | Families, equivalences, movement types, dimensional spaces, family groups, label layouts, and special barcodes are routed under Stocks support files. | Route map |
Decision Flow
- If the item does not exist, create it in Articles before using it in sales, purchases, or stock movements.
- If quantity must change without a sales/purchase document, use Stock Movements and pick the movement type that matches the operation: entry, exit, or warehouse transfer.
- If the task is a physical inventory count, begin with Recountings rather than a free-form movement.
- If the user asks about traceability, inspect Historical Serial No. and Lots of Articles first.
- If the user asks about price updates, decide between import wizard, base-price management, article/customer price tables, and price-update rules.
- If the user asks why a selector contains a value, check support files such as families, brands, units, movement types, and label layouts.
Verified Core Workflows
| Workflow | Status | Evidence | Guide |
|---|---|---|---|
| Article creation | Verified end to end | create-article-20260519T021105Z created AI-DEMO-20260519-021105. | Create article |
| Duplicate article-code validation | Verified | article-duplicate-validation-20260519T090211Z showed SearchIfExistCodArtigo returns the existing article and clears the field. | Create article |
| Stock entry adjustment | Verified end to end | stock-movement-20260519T022454Z created movement 239 and changed warehouse 1 stock from 0 to 2. | Update stock |
| Warehouse transfer | Verified end to end | stock-transfer-movement-20260519T085338Z created movement 243; warehouse 1 decreased and warehouse 2 increased. | Update stock |
| Stock exit adjustment | Verified end to end | stock-exit-movement-20260519T085823Z created movement 244 and reduced warehouse 2 stock from 1 to 0. | Update stock |
| Route/tool map | Verified read-only | stocks-route-map-20260520T105219Z opened all 22 stock routes with no write/import/delete action. | Use stock route map |
| Unit support-file create/delete | Verified end to end | stock-units-crud-20260520T110034Z created disposable unit Z00, verified the row, deleted it, and confirmed it absent. | Manage stock units |
| Brand support-file create/delete | Verified end to end | stock-brands-crud-20260520T110516Z created disposable brand 63, verified the row, deleted it, and confirmed it absent. | Manage stock brands |
Boundaries and Next Gaps
| Area | Current state | Next useful workflow |
|---|---|---|
| Recountings | Route and form fields mapped read-only. | Create a disposable inventory recount and verify open/closed behavior. |
| Lots and serial numbers | History/list routes mapped read-only. | Create lot/serial-managed test articles, move them, and verify traceability rows. |
| Price tools | Wizard/forms/list calls mapped read-only. | Safely create a disposable base-price or price-table entry and delete it. |
| Support files | Units and brands create/delete verified; remaining support-file routes and fields mapped read-only. | CRUD test low-risk rows such as Family, Movement Type, or Label Layout with cleanup. |
| Import tools | Wizard and mapping tables mapped read-only. | Parse a small CSV through validation without committing import, then document the mapping/error flow. |