Before You Start
Open the Chat
- Open the ProdCalc AI Chat.
- Wait until the message Verifying session… disappears.
- You’ll see a command box and a Send button.
Guest vs Registered User
| Status | Meaning |
|---|---|
| Guest User | You can try ProdCalc without creating an account. |
| Confirm your email | Your upgrade is waiting for email confirmation. |
| Your Name | You’re logged into your account. |
You don’t need to manually create an organization. ProdCalc automatically associates your data with your factory.
Sending Commands
- Type your command.
- Press Send or Ctrl + Enter.
- Read the response in the chat.
Save Your Tokens
Most creation commands return a token, such as:
a1B2c3D4e5F6g7H
Keep these tokens. You’ll use them in future commands.
Example:
Create a raw material named Steel Sheet
Example response:
Material Name: Steel Sheet
Type: RAW
Material Token: a1B2c3D4e5F6g7H
Status: Created
Whenever this guide refers to MATERIAL_TOKEN, replace it with your own token.
Material Types
| Type | Description |
|---|---|
| RAW | Purchased materials like steel, paint, screws. |
| ASSEMBLED | Products manufactured from other materials. |
| FRACTIONATED | Materials divided from a larger material. |
Built-in Help
You can always ask ProdCalc for help.
| Command | Description |
|---|---|
show commands | Shows every available command |
show material commands | Material examples |
show batch commands | Batch examples |
how do I create a batch? | Explains the required fields |
1. Create Materials
Materials represent the products and components stored in your inventory.
Create a Raw Material
Create a raw material named Steel Sheet
Create an Assembled Material
Create an assembled material named Steel Frame
List Materials
List materials
Show raw materials
Show material MATERIAL_TOKEN
Replace MATERIAL_TOKEN with the token returned by ProdCalc.
Create a Bill of Materials (BOM)
Add CHILD_TOKEN as a component of PARENT_TOKEN with quantity 2
Where:
- PARENT_TOKEN = assembled material
- CHILD_TOKEN = component
- 2 = required quantity
2. Create Inputs
Inputs represent expected incoming inventory.
Create an Input
Create an input for material MATERIAL_TOKEN, quantity 100, forecast date 2026-06-20
Related
Parameters:
- MATERIAL_TOKEN
- Quantity
- Forecast date (YYYY-MM-DD)
Example response:
Created input forecast of 100 units.
Save the INPUT_TOKEN if returned.
List Inputs
Show inputs
Show inputs for MATERIAL_TOKEN
Show input INPUT_TOKEN
Receive an Input
Receive INPUT_TOKEN 40
Example:
Received 40 units from input INPUT_TOKEN.
3. Create Batches
A batch represents physical inventory currently available.
Create a Batch
Create a batch for material MATERIAL_TOKEN with quantity 20
or
create batch for MATERIAL_TOKEN 20
Example response:
Created batch of 20 units.
View Batches
List batches for MATERIAL_TOKEN
Show batch BATCH_TOKEN
Show movements BATCH_TOKEN
4. Create Outputs
Outputs represent planned outgoing inventory.
Create an Output
Create an output for material MATERIAL_TOKEN, quantity 50, forecast date 2026-06-25
Related
Example response:
Created output forecast of 50 units.
View Outputs
Show outputs
Show outputs for MATERIAL_TOKEN
Show output OUTPUT_TOKEN
Ship an Output
Ship output OUTPUT_TOKEN 10
Example response:
Shipped 10 units.
If inventory is insufficient, ProdCalc will explain why.
5. Production Orders
Production Orders instruct ProdCalc to manufacture products.
Create an Order
Create an order for material MATERIAL_TOKEN, quantity 10, from 2026-06-15 to 2026-06-30
or
create order for MATERIAL_TOKEN 100 from 2026-06-24 to 2026-06-30
Save the ORDER_TOKEN.
View Orders
Show orders
List orders for MATERIAL_TOKEN
Show order ORDER_TOKEN
Manage Orders
Accept an order:
Accept order ORDER_TOKEN
Deliver finished products:
Deliver order ORDER_TOKEN 5
Pause production:
Interrupt order ORDER_TOKEN
Delete an order:
Remove order ORDER_TOKEN
If components are missing, ProdCalc will display the shortages.
6. Check Material Shortages
Organization Shortages
Show shortages
or
Show shortages in my organization
The report includes:
| Column | Meaning |
|---|---|
| Material | Material Name |
| Stock | Current inventory |
| Inputs | Planned arrivals |
| Outputs | Planned shipments |
| Difference | Negative values indicate shortages |
Material Shortages
Show shortages for material MATERIAL_TOKEN
Complete Example
Run these commands in order:
Create a raw material named Steel Sheet
Create an assembled material named Steel Frame
Add STEEL_SHEET_TOKEN as a component of STEEL_FRAME_TOKEN with quantity 2
Create an input for material STEEL_SHEET_TOKEN, quantity 100, forecast date 2026-06-20
Receive INPUT_TOKEN 40
Create a batch for material STEEL_SHEET_TOKEN with quantity 20
Create an output for material STEEL_FRAME_TOKEN, quantity 50, forecast date 2026-06-25
Create an order for material STEEL_FRAME_TOKEN, quantity 10, from 2026-06-15 to 2026-06-30
Accept order ORDER_TOKEN
Show shortages
Command Reference
| Topic | Example |
|---|---|
| Materials | Create an assembled material named Steel Frame |
| Inputs | Create an input for material TOKEN, quantity 100, forecast date 2026-06-20 |
| Batches | Create a batch for material TOKEN with quantity 20 |
| Outputs | Create an output for material TOKEN, quantity 50, forecast date 2026-06-25 |
| Orders | Create an order for material TOKEN, quantity 10, from 2026-06-15 to 2026-06-30 |
| Shortages | Show shortages |
| Help | show commands |
Troubleshooting
| Problem | Solution |
|---|---|
| Session not ready | Refresh the page and wait for session verification. |
| Command not understood | Type show commands or follow the examples in this guide. |
| Invalid token | Run List materials and copy the token again. |
| Not enough stock | Create additional batches or inputs, or reduce the requested quantity. |
| Empty shortage list | Add stock movements first. |
| Guest account | Upgrade your account before leaving the page to preserve your work. |