Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel6
outlinefalse
typelist
printablefalse

...

This is the list of available FlowAP templates. 3 default templates come with FlowAP upon installation.

Note

You must not edit the Default FlowAP Templates.

Any changes made to the default template will be overridden during new version releases of FlowAP.

To use a customized version of the FlowAP template, save a copy of the Default FlowAP Template.

Apply your own lookup criteria and XML mapping to the new FlowAP Template; and assign it to the relevant Staria FlowAP Subsidiary Setup.

...

Example:

Code Block
languagejson
{
  "nsfieldid1": {
    "xpath": ["/cac:parentxmlelement/cbc:childxmlelement1"]
  },
  "nsfieldid2": {
    "xpath": ["/cac:parentxmlelement/cbc:childxmlelement2"]
  }
}

Each field mapping contains the name/value pairs. The name/value pairs consist of:

...

Code Block
languagejson
"taxpercent": {
  "xpath" : [
    "./cac:Item/cac:ClassifiedTaxCategory/cbc:Percent",
    "/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cbc:Percent"]
  }}]},   

In this example, the taxpercent field is mapped to the line-level tax percent and the transaction header-level tax percent.

...

Example:

Code Block
languagejson
{
  "nssublistname": {
    "listpath": ["/cac:parentxmlelement",
    "fields" : [
      {
        "nsfieldid1": {
          "xpath": ["/cac:parentxmlelement/cbc:childxmlelement1"]
        },
        "nsfieldid2": {
          "xpath": ["/cac:parentxmlelement/cbc:childxmlelement2"]
        },
      }
    ]
  }
}

For all fields in the sublist:

...

Example:

Code Block
languagejson
{
  "item" : {
    "listpath" : "/cac:InvoiceLine",
    "fields" : [
        {
          "taxpercent": {
              "xpath" : ["./cac:Item/cac:ClassifiedTaxCategory/cbc:Percent",
                        "/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cbc:Percent"]
          }
        }
    ]
  }
}

For taxpercent, there are 2 xpaths which means that there’s a hierarchy in retrieving the value for taxpercent

...

Field

Validation / Automation Details

Expense Line : Memo field

Info

For unidentified items posted as expense lines

NetSuite expense lines created when conversion is unable to identify a NetSuite item for the invoice line.

The memo field of the expense line will have the value:

<taxpercent> | <vendorcode> - <itemname>

Related article: How to customize the memo field value of expense lines created by FlowAP conversion for unidentified items

Expense Line : Memo

Info

For expense line posted when POST SINGLE BILL LINE = T

  • If Use First Memo Vendor Preference > [STA] POST SINGLE BILL LINE: USE FIRST XML MEMO = T and firstmemo_value is not empty the format will be

    • <taxpercent_total> | <firstmemo>

  • Else

    • <taxpercent_total> | Transaction Total“Transaction Total”

      • Transaction Total is fixed/static text. This is to indicate that this single line is the transaction total from the XML.

Currency

The XML currency is always used. "currency": {"xpath" : ["/cbc:DocumentCurrencyCode"]},

  1. If the XML currency is not configured in NetSuite (List>Accounting>Currencies) the conversion will result to an error.

  2. If the XML currency is configured in NetSuite, but not found in the vendor’s available currencies, it will be added to the vendor record and conversion will be successful in using the XML currency.
    https://staria.atlassian.net/wiki/spaces/SFI/pages/edit-v2/1568931841?draftShareId=143418ae-9fb3-4a40-a37f-67dcd23519db

Invoice Item Line : Quantity

The quantity is defaulted to 1 if there is no indicated quantity in the XML for an item line.

Vendor : VAT

"vendorvat": {"xpath": ["/cac:AccountingSupplierParty/cac:Party/cac:PartyIdentification/cbc:ID[@schemeID=\"VAT\"]"]},

Subsidiary : VAT

"subsidiaryvat": {"xpath": ["/cac:AccountingCustomerParty/cac:Party/cac:PartyIdentification/cbc:ID[@schemeID=\"VAT\"]"]},

All fields

After parsing the mapped fields and no value is found in the XML, the created JSON data from the XML will set the value as “STA_EMPTY“.

Location

A hierarchy is implemented for determining the location to be set.

https://staria.atlassian.net/wiki/spaces/SIS/pages/edit-v2/1565753351?draftShareId=253908da-d8b2-45b8-b825-b74c6c05d4e3

Billing Address : Country

If the XML’s billing country is empty, the vendor record’s billing country will be used.

Reference Number

Unique Transaction reference numbers are validated for each transaction type (vendor bill and vendor bill credit). The conversion will fail for duplicate transaction reference numbers.

Info

Transaction reference number duplicates are not checked across two different transaction types.

Example: A vendor bill can have reference number = ABC123 and a vendor bill credit can still be created with reference number ABC123.

...

Use Case

Setup Options

Related Articles

Allow transaction creation to proceed even if the conversion was unable to find a matching NetSuite item for the vendor bill lines.

The conversion will post unidentified items as expense lines.

FlowAP Subsidiary Setup > CREATE UNIDENTIFIED ITEMS AS EXPENSE

How does FlowAP Post unidentified items?

Use NetSuite expense items instead of expense lines

FlowAP Subsidiary Setup > USE EXPENSE ITEMS INSTEAD OF ACCOUNTS FOR EXPENSE LINES

Expense Item/Account Lookup Hierarchy

Ignore XML line level data and allow NetSuite to copy the line level information from the related purchase order in NetSuite.

The total payable amount of the bill will always be equal to the XML.

The user responsible for the bill is expected to review the line details of the bill and make the necessary data entry to correct it for the total payable amount.

FlowAP Subsidiary Setup > INHERIT PO LINES

FlowAP Subsidiary Setup > INHERIT PO LINES: DEFAULT TO 0 QUANTITY AND AMOUNT

Inherit Purchase Order Lines with Variances

Ignore the XML line level data and save a single transaction line in NetSuite transaction.

FlowAP Subsidiary Setup > POST SINGLE BILL LINE: USE PAYABLE AMOUNT (NO TAX)

Understanding the [STA] POST SINGLE BILL LINE preference guide

Info

When using Post Single Bill Line = T and Use expense item = T: the rate is always set to 0. The amount is mapped from the XML.

Do not allow a well-formed XML to create a stand-alone bill (Direct bill) if the PO Reference is empty.

Staria FlowAP Subsidiary Setup > WHEN BILL NOT FOUND

https://staria.atlassian.net/wiki/spaces/SIS/pages/1193541651/Staria+FlowAP+Subsidiary+Setup#Flowsetup-whenbillnotfound

Do not allow a well-formed XML to create a stand-alone bill credit (Direct Credit) if the Bill Reference is empty.

Staria FlowAP Subsidiary Setup > WHEN PO# NOT FOUND

https://staria.atlassian.net/wiki/spaces/SIS/pages/1193541651/Staria+FlowAP+Subsidiary+Setup#Flowsetup-whenPOnotfound

Do not allow stand alone transactions for a specific vendor.

Configure vendor preferences in the vendor record.

  1. Vendor Preference: [STA] No Direct Bill

  2. Vendor Preference: [STA] No Direct Credit

Configure the Vendor-specific preferences saved search in the FlowAP Subsidiary Setup > VENDOR-SPECIFIC PREFERENCES

Vendor Record

https://staria.atlassian.net/wiki/spaces/SIS/pages/1318354945/Vendor+related+configuration+for+FlowAP+conversion+A+Detailed+Guide#Vendor-Specific-Preferences

Define tax codes for each tax rate/percent parsed from the XML during conversion.

FlowAP Subsidiary Setup > TAX CODE TABLE

https://staria.atlassian.net/wiki/spaces/SIS/pages/1316683781/Hierarchy+Used+by+FlowAP+Conversion+When+Selecting+Tax+Codes+on+Vendor+Bill+Lines#Tax-Code-Hierarchy-for-Bill-Items

...