SAP Knowledge Base Article - Public

3682566 - Error FF817 while using Journal Entry Post API - SAP S/4HANA Cloud Public Edition

Symptom

  • Error 817(FF): "Taxes by item is not activated and therefore not permitted in transfer" encountered when using API to post customer invoices (outgoing invoices).
  • Inconsistent system behavior observed: one invoice can be posted successfully without summarized tax lines, while another invoice failed with the error.

Environment

SAP S/4HANA Cloud Public Edition

Reproducing the Issue

  1. Use the API for customer invoice upload in SAP S/4HANA Cloud Public Edition.
  2. Attempt to post an invoice with tax lines that are not summarized.
  3. Observe the error message: "817(FF): Taxes by item is not activated and therefore not permitted in transfer."

Cause

  • Generally, an line-by-line tax calculation is used only in company codes associated with the following country/regions: United States, Canada and, to some extent, India. If an external tax reporting system is used, the tax must be reported on an line-by-line basis and therefore also posted on an line-by-line basis. 
  • The tax line by line calculation is only supported by the jurisdiction country/region. For non-jurisdiction country/region, the product tax items always needs aggregation.
    Payload as line by line couldn’t be used to do the posting. It's standard system design error 817(FF) occurs.

  • However, in specific exceptional cases, it is technically possible to post payloads with line by line tax calculation for non-jurisdiction countries/regions. However, this method is not supported from a business standpoint and is not endorsed by SAP. Customers are advised to take full responsibility for any potential risks that may arise from adopting this approach.

Resolution

For the non-jurisdiction country the aggregated tax item is always expected and the internal tax calculation is designed for aggregated tax item too. Multiple tax items should be aggregated firstly in the payload. 

See Also

KBA 2963945 - Line by line tax calculation while using Journal Entry - Post (Asynchronous) API for non-jurisdiction country - SAP for Me 

KBA 3016213 - Error FF818 - While using Journal Entry Post API for Indian company code - SAP for Me 

Blog:Posting Journal Entries with Tax Using SOAP Postin... - SAP Community 

Keywords

error 817(ff), taxes by item, customer invoice upload, api, sap s/4hana cloud public edition, tax line summarization, tax base amounts, inconsistent system behavior, journal entry api, tax calculation, outgoing invoice , KBA , AC-INT-2CL , Accounting Interface (Public Cloud) , Problem

Product

SAP S/4HANA Cloud Public Edition all versions