{"audience":"General ledger, integration and IT teams, accounting owners of group companies.","authorization_objects":[{"note":"Posting authorization for the company code","object":"F_BKPF_BUK"},{"note":"Posting authorization with the interface document type","object":"F_BKPF_BLA"},{"note":"Posting authorization by account type","object":"F_BKPF_KOA"}],"components":[],"countries":[],"effort_days_max":15,"effort_days_min":10,"effort_size":"L","faq":[{"a":"If the source sends amounts with tax, the tax code is taken from the mapping table and the BAPI calculates the tax line in SAP, or uses the source tax amount after checking it. The approach is chosen per source system during installation.","q":"If the source system calculates VAT, how are tax lines handled?"},{"a":"If the file format fits one of the existing templates, only the source code and mapping tables are maintained. For a different format or a direct interface a new class is added to the reading layer.","q":"Does adding a new source system require code changes?"}],"features":[{"code":"test_run","label":"Test mode (check without posting)","note":""},{"code":"log","label":"Line-by-line result and error log","note":""},{"code":"alv","label":"ALV list (sort, filter, subtotals)","note":""},{"code":"email","label":"Send the result by email","note":"A summary of failed and mapping-pending records goes to the source system owners."},{"code":"background","label":"Runs as a background job","note":"Runs as a scheduled job per source."},{"code":"error_file","label":"Download failed lines as a separate file","note":""}],"functions":[{"name":"FI_PERIOD_CHECK","role":"Checks that the posting period is open"},{"name":"BAPI_ACC_DOCUMENT_CHECK","role":"Checks the document without posting"},{"name":"BAPI_ACC_DOCUMENT_POST","role":"Posts the accounting document"},{"name":"BAPI_TRANSACTION_COMMIT","role":"Saves successful documents"},{"name":"SO_DOCUMENT_SEND_API1","role":"Emails the error summary"}],"gap":"FB50 and FB01 enter postings by hand; LSMW or standard accounting APIs can create documents from a file. But maintenance screens that translate the source system's own account codes, departments and partner codes to their SAP equivalents, pre-posting checks on period, balance and validity, error tracking per source system and reprocessing do not come ready. A separate upload is written for each new source and errors cannot be followed up.","id":"fi-external-system-journal-interface","industries":[],"input_columns":[{"derived":true,"label":"Source document number","required":true,"rule":"Voucher number in the source system; written to the SAP reference field","target_field":null,"target_table":null},{"derived":false,"label":"Document date","required":true,"rule":"","target_field":"BLDAT","target_table":"BKPF"},{"derived":true,"label":"External account code","required":true,"rule":"Converted to an SAP G/L account with the mapping table","target_field":null,"target_table":null},{"derived":true,"label":"External department","required":false,"rule":"Converted to a cost center with the mapping table","target_field":null,"target_table":null},{"derived":true,"label":"External partner code","required":false,"rule":"Converted to a customer or vendor with the mapping table","target_field":null,"target_table":null},{"derived":false,"label":"Debit/credit","required":true,"rule":"","target_field":"SHKZG","target_table":"BSEG"},{"derived":false,"label":"Amount","required":true,"rule":"","target_field":"WRBTR","target_table":"BSEG"},{"derived":false,"label":"Currency","required":true,"rule":"","target_field":"WAERS","target_table":"BKPF"},{"derived":false,"label":"Text","required":false,"rule":"","target_field":"SGTXT","target_table":"BSEG"}],"kind":"program","language":"en","lastmod":"2026-11-18","logic":"1. A source code is defined for each source system (for example hotel, payroll, insurance): file format or interface, document type, posting date rule and error recipients.\n2. Mapping tables are maintained per source code: external account → SAP G/L account (SKB1), external department → cost center or profit center (CSKS), external partner code → customer or vendor (KNB1, LFB1). A record without a mapping stays in status 'mapping pending'.\n3. Pre-posting checks: is the period open (FI_PERIOD_CHECK), is the account open for posting, is the cost center valid (CSKS-DATBI), does the document balance; then BAPI_ACC_DOCUMENT_CHECK runs.\n4. Records that pass are posted with BAPI_ACC_DOCUMENT_POST; the source system's document number is written to the reference field (XBLNR) and posting the same reference twice is blocked.\n5. The result of each run is written to the application log (BALHDR) and the interface table. Failed and mapping-pending records are sent as a summary to the recipients defined per source code with SO_DOCUMENT_SEND_API1.\n6. The monitor lists records by source, date and status; after mapping is completed the selected records are processed again. In S/4HANA the same logic can also be fed through the released journal entry API.","module":"FI","object_type":"interface","output_columns":[{"calculated":true,"formula":"Voucher number in the source system","label":"Source document number","source_field":null,"source_table":null},{"calculated":false,"formula":"","label":"G/L account","source_field":"HKONT","source_table":"BSEG"},{"calculated":false,"formula":"","label":"Cost center","source_field":"KOSTL","source_table":"BSEG"},{"calculated":false,"formula":"","label":"Amount","source_field":"WRBTR","source_table":"BSEG"},{"calculated":false,"formula":"","label":"Accounting document","source_field":"BELNR","source_table":"BKPF"},{"calculated":true,"formula":"Posted, mapping pending, duplicate or error","label":"Status","source_field":null,"source_table":null},{"calculated":true,"formula":"Check or BAPI return message","label":"Message","source_field":null,"source_table":null}],"parameters":[{"example":"OTEL","kind":"parameter","label":"Source system code","name":"P_SRC","ref_field":"","required":true},{"example":"2000","kind":"parameter","label":"Company code","name":"P_BUKRS","ref_field":"BKPF-BUKRS","required":true},{"example":"/interface/otel/2026-11-28.csv","kind":"parameter","label":"File (if not read from the interface table)","name":"P_FILE","ref_field":"","required":false},{"example":"","kind":"select_option","label":"Posting date","name":"S_BUDAT","ref_field":"BKPF-BUDAT","required":false},{"example":"","kind":"checkbox","label":"Reprocess failed and mapping-pending records","name":"P_REPR","ref_field":"","required":false},{"example":"X","kind":"checkbox","label":"Test mode","name":"P_TEST","ref_field":"","required":false}],"part_of":[],"performance":"Load the mapping tables for the source code into memory once. For large files group by the source document number and commit every 500 documents; use the daily summary option to condense lines.","process":"R2R","quote_url":"https://nekuhub.com/en/request-a-quote/?report=fi-external-system-journal-interface","related":["fi-gl-journal-entry-upload","fi-utility-einvoice-auto-posting"],"releases":[],"source":"custom","standard_alternatives":[{"note":"Enters G/L postings by hand; no mapping or bulk checks.","tcode":"FB50"},{"note":"Can create documents from a file; offers no mapping maintenance per source, error notification or reprocessing.","tcode":"LSMW"}],"summary":"A general-purpose interface that converts transactions from non-SAP systems such as a hotel management system, insurance, payroll or a front-office accounting package into SAP G/L accounts, cost centers, customers and vendors through mapping tables, checks them, posts them as accounting documents and emails errors to the owners.","tables":[{"access":"read","join_on":"SKB1-SAKNR = eşlenen ana hesap","role":"Whether the G/L account is open for posting in the company code","table":"SKB1","variant":"both"},{"access":"read","join_on":"CSKS-KOSTL = eşlenen masraf yeri","role":"Cost center validity","table":"CSKS","variant":"both"},{"access":"read","join_on":"","role":"Company code data of the mapped customer","table":"KNB1","variant":"both"},{"access":"read","join_on":"","role":"Company code data of the mapped vendor","table":"LFB1","variant":"both"},{"access":"read_write","join_on":"BKPF-XBLNR = kaynak belge numarası","role":"Created accounting documents; duplicate reference check","table":"BKPF","variant":"both"},{"access":"write","join_on":"BSEG-BUKRS = BKPF-BUKRS AND BSEG-BELNR = BKPF-BELNR","role":"Document items (written through the BAPI)","table":"BSEG","variant":"both"},{"access":"write","join_on":"","role":"Interface run log","table":"BALHDR","variant":"both"},{"access":"read","join_on":"","role":"Company code currency and chart of accounts","table":"T001","variant":"both"}],"title":"Journal Interface from External Systems with Account Mapping","url":"https://nekuhub.com/en/programs/journal-interface-from-external-systems-with-account-mapping/","vendor_id":"nekudos"}