SAP Knowledge Base Article - Public

3784490 - Down Payment via Web Service Returns "Tax Code XXX Is Not Valid for Down Payment in Country YY" and Overrides the Tax Code in the Down Payment Customer Invoice Request

Symptom

  • Creating a Down Payment Customer Invoice Request using the ManageDownPaymentCustomerInvoiceRequestIn, the web service does not accept the provided tax code for the specified tax country.
  • The confirmation log displays the following message:
    "Tax code XXX not valid for down payment in country YY." (XXX represent the Tax Code; YY Represent the Country)
  • The document is still created successfully in the UI, but the system determines and applies a different tax code and tax country internally. The Tax Country and Tax Code fields on the created request are read-only and cannot be modified.
  • Creating the same Down Payment Customer Invoice Request directly in the UI succeeds with the intended tax code and tax country.

Environment

SAP Business ByDesign

Reproducing the Issue

  1. Call the web service ManageDownPaymentCustomerInvoiceRequestIn and send a Create request (actionCode="01") for a Down Payment Customer Invoice Request referencing a sales order, amount, and pricing terms.
  2. In ProductTaxDetails, set ProductTaxationCharacteristicsCode with listID to the intended Tax Code and a Tax Country.
  3. Submit the request and review the confirmation log; observe the warning "Tax code XXX not valid for down Payment in the country YY"
    </DownPaymentInvoiceRequest>
             <Log>
                <MaximumLogItemSeverityCode>2</MaximumLogItemSeverityCode>
                <Item>
                   <TypeID>141(/AP_TTE_DO_TAXDOC/)</TypeID>
                   <SeverityCode>2</SeverityCode>
                   <Note>Tax code XXX not valid for down payment in country YY</Note>
                </Item>
             </Log> 
  4. Open the created Down Payment Customer Invoice Request in the UI; observe that the Tax Code and Tax Country differ from the request and are read-only.

Cause

The Tax Code and Tax Country are determined internally based on the seller, and if the sent tax code conflicts with the internal determination. 
Which returns a warning 'Tax code XXX not valid for down payment in country YY' and uses the internally determined tax code.
Based on the Tax Decision Tree, since the Seller is maintained with country (For example, AT - Austria), the system will not consider this as a non-taxable, but rather as taxable event.

Please Note: the Tax Country cannot be changed via the web service since the element Tax Country is not available in the web service ManageDownPaymentCustomerInvoiceRequestIn 

Resolution

  • This is the Expected system behavior.
  • Provide ProductTaxDetails/ProductTaxationCharacteristicsCode in the create request, understanding it is validated against the internally determined tax country (based on Seller).
  • If a different allowed tax code is required, send a second Maintain request (actionCode="02") to update the down payment with a new Tax Code that matches the determined Tax Country.
  • Note that Tax Country cannot be set via this web service; it is derived by tax determination.

See Also

KBA 3365204 - How to pass the tax code in the web service ManageDownPaymentCustomerInvoiceRequestIn

Keywords

Down Payment; web service; API; Tax Code; Tax Country; ManageDownPaymentCustomerInvoiceRequestIn; Tax code xxx not valid for down payment in country yy , KBA , AP-CI-CI , Customer Invoice , Problem

Product

SAP Business ByDesign all versions