Skip to main content

SAP S/4HANA CSV

Prepare a UTF-8 CSV without BOM for SAP S/4HANA

SAP import templates can be strict about encoding, BOM, delimiters, and header names. Treat the template as the contract, diagnose structural problems first, and create a separate UTF-8 output only when the target operation requires it.

Published:

Updated:

Related tool: Learn how to repair CSV problems

Start from the exact SAP template

S/4HANA import behavior depends on the business object and import method. The safest first step is to keep the downloaded template's header and delimiter, then check whether the source bytes and BOM match that operation.

  • Text is garbled: verify the source encoding and target expectation before converting.
  • The upload reports invalid columns: diagnose header names and row widths.
  • The file opens in Excel but fails in SAP: inspect BOM, quoting, and delimiter bytes rather than the spreadsheet view.

Separate file syntax from business object rules

Record the SAP app, business object, and import job used. CSV diagnosis can confirm a consistent table; it cannot validate plant codes, tax categories, units, or authorization-dependent fields.

  • Use the template's first row as the header, including capitalization and punctuation.
  • Keep date and decimal formats consistent with the SAP locale and job settings.
  • Do not strip leading zeros from material, customer, or company identifiers.

Diagnose first, then create the required encoding

LocaCSV does not claim to repair a broken quote or infer SAP field semantics. Stop at a diagnosis when the source needs an intentional correction.

  1. Copy the SAP template or source export and open it in LocaCSV's CSV diagnostic workspace.
  2. Review header width, quotes, empty rows, and input encoding findings.
  3. If the target requires UTF-8 without BOM (or another explicit form), use format conversion after the diagnosis and save a separate file.
  4. Run a small test import and compare the application log with the local row count.

Verify the business object preview

  • The output header and number of columns match the SAP template.
  • The chosen UTF-8/BOM combination is visible in a text preview and accepted by the test job.
  • Input, output, and rejected rows are reconciled and recorded.
  • Identifiers, quantities, dates, and decimal separators appear as intended in the SAP preview.

Handle SAP validation errors in the target app

After syntax is correct, use the SAP error log for missing master data, invalid codes, authorization, and duplicate business keys. Re-encoding the same file will not solve a rejected plant or material code.

Make the SAP handoff auditable

Store the template version, encoding decision, diagnosis, converted copy, and SAP job result with the change record.

Official documentation

Limits and import formats can change. Use the official documentation below as the final check for your account and plan.