Excel Format Requirements
This document describes the required Excel file structure for successful quotation processing.
File Specifications
Basic Requirements
| Requirement | Specification |
|---|---|
| File Format | .xlsx (Excel 2007 or later) |
| Maximum Size | 10 MB |
| Encoding | UTF-8 |
| Password | Not allowed (must be unprotected) |
| Macros | Not required (will be ignored) |
Sheet Requirements
Minimum Sheets Required
PII Sheet - Required
- Contains quotation from PT Punch Industry Indonesia
- Standard format with item lists
SGI/Sales Sheet - Optional
- Can be: Standard SGI, TMMIN, METINDO, or MARUICHI format
- Contains sales/logistics information
Sheet Naming Conventions
Acceptable Sheet Names
The system detects sheets by checking for specific keywords:
PII Sheet Detection
- "PII"
- "PUNCH"
- "PT. PUNCH"
- "PUNCH INDUSTRY"
SGI Sheet Detection
- "SGI"
- "SOMAGEDE"
- "PT. SOMAGEDE"
TMMIN Format Detection
- "TMMIN"
- "TOYOTA"
METINDO Format Detection
- "METINDO"
- "LOGISTICS"
MARUICHI Format Detection
- "MARUICHI"
- "DISCOUNT"
Note: Sheet name matching is case-insensitive.
Column Structure
Standard Format (PII/SGI)
12 columns required:
| Column | Header | Description | Required |
|---|---|---|---|
| A (1) | NO | Sequential number | Yes |
| B (2) | ITEM | Item description/name | Yes |
| C (3) | KODE ITEM | Item code/SKU | Yes |
| D (4) | CATATAN | Notes/remarks | No |
| E (5) | QTY | Quantity | Yes |
| F (6) | MATA UANG | Currency | Yes |
| G (7) | HARGA SATUAN | Unit price | Yes |
| H (8) | TOTAL | Total price | Yes |
| I (9) | - | Reserved | No |
| J (10) | - | Reserved | No |
| K (11) | - | Reserved | No |
| L (12) | - | Reserved | No |
TMMIN Format
8 columns required:
| Column | Header | Description |
|---|---|---|
| A (1) | NO | Sequential number |
| B (2) | ITEM | Item description |
| C (3) | KODE ITEM | Item code |
| D (4) | CATATAN | Notes |
| E (5) | QTY | Quantity |
| F (6) | MATA UANG | Currency |
| G (7) | HARGA SATUAN | Unit price |
| H (8) | TOTAL | Total price |
METINDO Format
9 columns required:
| Column | Header | Description |
|---|---|---|
| A (1) | NO | Sequential number |
| B (2) | ITEM | Item description |
| C (3) | KODE ITEM | Item code |
| D (4) | CATATAN | Notes |
| E (5) | QTY | Quantity |
| F (6) | MATA UANG | Currency |
| G (7) | HARGA SATUAN | Unit price |
| H (8) | TOTAL | Total price |
| I (9) | ETD | Estimated delivery date |
MARUICHI Format
10 columns required:
| Column | Header | Description |
|---|---|---|
| A (1) | NO | Sequential number |
| B (2) | ITEM | Item description |
| C (3) | KODE ITEM | Item code |
| D (4) | CATATAN | Notes |
| E (5) | QTY | Quantity |
| F (6) | MATA UANG | Currency |
| G (7) | HARGA SATUAN SEBELUM DISKON | Price before discount |
| H (8) | DISK | Discount percentage |
| I (9) | HARGA SATUAN SETELAH DISKON | Price after discount |
| J (10) | TOTAL | Total price |
Header Row Detection
The system searches for header rows containing:
- "NO"
- "ITEM"
- "KODE ITEM"
- "QTY"
- "MATA UANG"
- "HARGA"
- "TOTAL"
Header Row Rules
- Header must be in a single row
- Must contain at least 5 of the required column headers
- Can be anywhere in first 50 rows
- Case-insensitive matching
Quotation Metadata
Each quotation should contain:
Required Information
QTI Number
- Format:
QTI-XXXXXXorQTI-XXXXXX-REV-X - Must appear above item table
- Used as unique identifier
- Format:
Customer Name
- Should be clearly labeled
- Can contain: "TO:", "KEPADA:", "CUSTOMER:"
- Single line preferred
Date
- Format:
Jakarta, DD MMMM YYYY - Example:
Jakarta, 23 Oktober 2025 - Comma and space handling flexible
- Format:
Attention (Optional)
- Person to address quotation to
- Label: "ATTN:", "UP:", "KEPADA YTH:"
Salesman (SGI sheets only)
- Sales representative name
- Label: "SALESMAN:", "SALES:"
TMMIN Specific Fields
- Kanban Number
- RF Number
- CC Field
Located near top of quotation, before item table.
Data Formatting
Number Formats
- Quantities: Integer or decimal (e.g.,
10,15.5) - Prices: Decimal with 2 places (e.g.,
1000.00) - Percentages: Decimal (e.g.,
0.10for 10%)
Text Formats
- Item Codes: Alphanumeric, can include hyphens
- Customer Names: Any characters, avoid line breaks
- Dates: Indonesian format with month names
Currency
- Default:
IDR(Indonesian Rupiah) - Others accepted:
USD,JPY,EUR
Notes and Totals
Notes Section
Located after item table:
- Begin with "NOTE:", "CATATAN:", or "KETERANGAN:"
- Can span multiple rows
- Ends at company footer
Totals Section
Must include:
- Subtotal (before tax)
- Label: "TOTAL TAX LIABLE", "TOTAL SEBELUM PAJAK"
- Tax (10% VAT)
- Label: "TAX", "PAJAK", "PPN"
- Grand Total (after tax)
- Label: "TOTAL", "TOTAL SESUDAH PAJAK"
Common Formatting Issues
❌ Avoid These
Merged Cells in data rows
- Can merge in headers or metadata
- Never merge in item list
Empty Rows in item list
- System stops at first empty row
- Keep items contiguous
Multiple Headers in same sheet
- One header row per quotation
- Use separate sheets for multiple quotations
Hidden Rows/Columns
- May cause extraction issues
- Unhide all before upload
Formulas in critical cells
- Use values instead
- System reads displayed value
Special Characters in codes
- Avoid:
\,/,*,? - Use:
-,_,.
- Avoid:
✅ Best Practices
- Use template provided by IT department
- Keep formatting consistent across quotations
- Verify QTI numbers are unique
- Ensure dates use correct format
- Check item codes match SAP HANA
- Remove test data before upload
- Save as
.xlsxformat (not.xls)
Validation Rules
System validates:
- ✓ File extension is
.xlsx - ✓ File size under 10MB
- ✓ At least one PII sheet exists
- ✓ Header row detected in each sheet
- ✓ QTI number found for each quotation
- ✓ At least one item in quotation
- ✓ Required columns present
- ✓ No password protection
Example Structure
┌─────────────────────────────────────┐
│ QUOTATION │
│ QTI-240102 │
│ Jakarta, 15 Januari 2024 │
│ TO: PT CUSTOMER NAME │
├─────────────────────────────────────┤
│ NO │ ITEM │ KODE ITEM │ QTY │ ... │
├────┼──────┼───────────┼─────┼──────┤
│ 1 │ Pin │ AAP-001 │ 100 │ ... │
│ 2 │ Bush │ AAP-002 │ 50 │ ... │
├─────────────────────────────────────┤
│ TOTAL SEBELUM PAJAK: Rp 1,000,000 │
│ PAJAK 10%: Rp 100,000 │
│ TOTAL: Rp 1,100,000 │
├─────────────────────────────────────┤
│ NOTE: │
│ - Delivery: 7 working days │
│ - Valid: 30 days │
└─────────────────────────────────────┘
Template Downloads
Request templates from:
- IT Department
- Sales Department
- Email: it@somagede.co.id