Skip to main content
The Invoice UA skill extracts data from Ukrainian invoices. The Invoice UA skill is a production skill. It has been fully trained on a large document set and provides high accuracy of data identification and extraction. The skill is ready to be used in production and does not require further training on your specific documents. Accuracy and straight-through processing (STP) rates can be further optimized in production through continuous learning from human-in-the-loop feedback.

Countries and Languages

CountriesLanguages
UkraineEnglish
Russian
Ukrainian

Extracted Fields

Asterisk (*) indicates a required field or field group. Values cannot be empty.

Basic Information

FieldDescription
Invoice NumberThe number of the invoice.
Invoice Date*The date when the invoice was issued.
Total*The total cost of goods or services.
CurrencyThe currency of the invoice.

Business Unit (BU)

FieldDescription
NameThe name of the business unit (invoice recipient).
Tax IDThe tax payer registration number.
AddressThe address of the business unit (invoice recipient). The address will be extracted into this field, if no BusinessUnits data catalog is used or if the business unit has not been found in a data catalog.
CountryThe country of the business unit (invoice recipient).
CityThe address of the business unit (invoice recipient). This address format will be used if the BusinessUnits data catalog is used and the business unit has been found in the data catalog.
StreetThe address of the business unit (invoice recipient). This address format will be used if the BusinessUnits data catalog is used and the business unit has been found in the data catalog.
Postal CodeThe address of the business unit (invoice recipient). This address format will be used if the BusinessUnits data catalog is used and the business unit has been found in the data catalog.
IDThe unique identifier of the business unit in an external system. Note: This field can only be obtained from the BusinessUnits data catalog.

Vendor

FieldDescription
NameThe vendor’s name.
Tax IDInternational TAX payer registration number.
National Tax IDThe TAX payer registration number inside the origin country.
IBANThe vendor’s international bank account number.
Bank AccountThe vendor’s bank account.
Bank CodeThe vendor’s bank code.
AddressThe vendor’s address. The address will be extracted into this field, if no Vendors data catalog is used or if the vendor has not been found in a data catalog.
CountryThe vendor’s country.
CityThe vendor’s address. This address format will be used if the Vendors data catalog is used and if the vendor has been found in the data catalog.
StreetThe vendor’s address. This address format will be used if the Vendors data catalog is used and if the vendor has been found in the data catalog.
Postal CodeThe vendor’s address. This address format will be used if the Vendors data catalog is used and if the vendor has been found in the data catalog.
IDThe vendor’s unique identifier in an external system. Note: This field can only be obtained from the Vendors data catalog.

Invoice Details

FieldDescription
Delivery DateThe date the goods were delivered or services performed.
Due DateThe date by which the invoice should be paid.
Reversed ChargeIndicates that a reverse charge is applied.

Taxes

FieldDescription
Total Net AmountThe total cost of goods and services without tax.
Total TaxesThe total tax amount.
Non Taxable AmountThe amount on which no tax is payable.

Tax Rates (repeating group)

For each tax group:
FieldDescription
Net AmountCost of goods or services without tax
Tax AmountTax charged
Tax RateTax rate

Invoice Type

FieldDescription
InvoiceSpecifies the Invoice type of the invoice.
Credit NoteSpecifies the Credit Note type of the invoice.

Purchase Order

FieldDescription
Order NumberThe number of the purchase order.
TotalThe cost of the goods or services listed in the purchase order. Note: This field can only be obtained from the PurchaseOrders data catalog.
Order CheckedIndicates whether the order number is verified. The value of the field can be True or False.

Line Items (repeating group)

FieldDescription
Order NumberThe number of the purchase order.
Order DateThe date when the purchase order was created.
PositionThe number of the line item in the list.
Article Number VendorThe article number or code in the vendors’s database.
Article Number BUThe article number or code in the business unit’s database.
DescriptionA description of the line item.
QuantityThe number of units purchased.
Unit of MeasurementThe unit of measurement used for the goods.
Unit PriceThe price of one item of goods.
Discount PercentageThe discount percentage on the initial line item price.
DiscountDiscount applicable to the line item.
Net PriceThe price of the line item without tax.
Tax RateThe tax rate for the line item.
Tax AmountThe amount of tax payable on the line item.
Tax CodeThe code of the tax.
Total PriceThe price of the line item including tax.
CurrencyThe currency of the line item.
Is ValidIndicates whether the order number in the Line Item group matches any checked order number in the Purchase Order group. The value of the field can be True or False.
Order Item IDThe unique line item identifier. Note: This field can only be obtained from the PurchaseOrderItems data catalog.

Ship To

FieldDescription
NameThe name of the recipient receiving the goods.
AddressThe address of the recipient receiving the goods.

Key Fields

  • Vendor/Name
  • Invoice Date
  • Invoice Number
  • Total
  • Currency

Validation Rules

RuleDescription
Total is required fieldChecks whether the Total field is filled in. If it is not, displays a message saying that it is a required field.
Separate currency from amount in money fieldsSplits the amount and the currency in fields containing currency amounts and copies the currency into the Currency field if it is empty.
Invoice date is requiredChecks whether the Invoice Date field is filled in. If it is not, displays a message saying that it is a required field.
Currency is requiredChecks whether the Currency field has been detected on the document. If not, displays a message saying that it is a required field.
Vendor Tax ID is requiredChecks whether the vendor Tax ID field is filled in. If it is not, displays a message saying that it is a required field.
Check item amountChecks that:
The number of units of each type (Quantity) multiplied by the unit price (Unit Price) is equal to the total amount charged before tax (Net Price) minus the applicable discount (Discount).
The total amount charged before tax (Net Price) multiplied by the tax rate (Tax Rate) is equal to the value of the Tax Amount field.
The sum of the values of the Net Price and Tax Amount fields is equal to the value of the Total Price field.
For each invoice line item, suggests values for the following fields (wherever calculating them is possible): Quantity, Unit Price, Discount, Net Price, Tax Rate, Tax Amount, and Total Price.
Separate currency from amount in LI money fieldsSplits the amount and the currency in the corresponding field and copies the currency into the Line Items/Currency field if it is not filled in. Line Items/Unit Price, Line Items/Net Price, Line Items/Total Price
Check invoice and line items currencyChecks that the value of the Currency and Line Items/Currency fields is a supported currency. If the currency is not supported or has not been extracted, suggests currency values from the appropriate invoice region. Currency descriptions are replaced with ISO codes.
Check LI Total Prices against Total AmountChecks the value of the Total Amount field. If it is not equal to the sum of the Line Items/Total Price fields, suggests filling in the fields with their calculated values.
Check LI Net Prices against Total Net AmountChecks the value of the Total Net Amount field. If it is not equal to the sum of the Line Items/Net Price fields, suggests filling in the fields with their calculated values.
Check Total TaxChecks that the sum of the Tax Amount fields across the Tax Rates repeating group is equal to the value of the Total Taxes field.
If the values are not equal, suggests filling in the fields with the calculated values. If the Total Taxes field is not filled in, fills it in with its calculated value.
For each instance of the Tax Rates group: Checks that (Tax Rate / 100 ) * Net Amount is equal to Tax Amount.
If Tax Rate, Net Amount, or Tax Amount is not filled in, suggests filling in these fields with their calculated values. Removes the percent sign (%) from the value in the Tax Rate field.
Check Total fieldChecks that the sum of the Total Net Amount and Tax Amount fields is equal to the total invoiced amount (Total). If the values are not equal or if the Total field is not filled in, suggests filling in the fields with their calculated values.
Check Net TotalChecks that the sum of the Net Amount fields across the Tax Rates repeating group is equal to the total amount charged for the goods or services before tax (Total Net Amount). If the values are not equal, suggests filling in the fields with their calculated values. If the Total Net Amount is not filled in, fills it in with its calculated value.
Set default countryIf a country has not been detected on the image, specifies the default country for the invoice. For Invoice UA, the default country is UA.
Check vendor details against databaseChecks whether the appropriate entry in the Vendors data catalog has been found for the vendor bank details detected on the image. If the values in the data catalog are different, replaces the field values with entries from the data catalog. If the vendor was not detected correctly, the operator may select a different vendor from the data catalog manually during manual review. The Vendor Id, Name, Street, Country, and Business Unit ID fields should be filled in in the Vendors data catalog.
Business unit must be found in databaseChecks that the business unit details detected on the document image are the same as those in the BusinessUnits data catalog. If some entries are different, replaces the field values with values from the data catalog. If the business unit was not detected correctly, the operator may select a different business unit from the data catalog manually during manual review. The Business Unit Id, Name, Street, and Country fields should be filled in in the BusinessUnits data catalog.
Check purchase order number and amountChecks that the order number and amount detected on the document image are the same as those in the PurchaseOrders data catalog. If several order numbers are detected, checks all of them and their amounts against the values in the data catalog. The Order Number field should be filled in in the PurchaseOrders data catalog.
Match invoice line item with order itemChecks invoice line item information against records in the PurchaseOrderItems data catalog. If the catalog contains an entry for a particular line item, fills in the corresponding Order Item ID field using the value from the data catalog. The Order Item ID and Order Number fields should be filled in in the PurchaseOrderItems data catalog.
Check purchase order total amountChecks if the value in the Total field equals the value of the Total field in the Purchase Order group when one purchase order is found. Checks if the value in the Total field equals the sum of values in Total fields in the Purchase Order group when several purchase orders are found.
Check matching of line items to unique order itemsFor all line items whose purchase order number is equal to the one extracted in the Purchase Order group, checks that the value in the Order item ID field in the Line Items group is unique for every purchase order number if the value of the Order Checked field is True.
If order is checked make line items validFor each item in Purchase Order group that has the Order Checked field set to True, compares the order number to the order number in all line items of the Line Items group. If they match in the Line Items group row, the value of the Is Valid field in the Line Items group value in that row is set to True.
Copy order numberIf there is only one value in the Order Number field in the Purchase Order group and the values in the Order Number field in the Line Items group are empty, copies the value of the Order Number field in the Purchase Order group to the values of the Order Number field in the Line Items group.
Detect invoice typeSets the type in the Invoice Type checkmark group. If the document is marked as credit note or if the value of the Total field is negative, sets the type to Credit Note. Otherwise, sets the type to Invoice.
Reversed Charge field is empty or completedIf the document contains references to reversed charges, checks the values of the taxes fields. If they are empty, marks the Reversed Charge checkmark. Note: Does not apply to AU-NZ, CA, US, and JP regions.
To fill in a field with its calculated value, click the suggested value button in the value region of the field and select one of the suggestions from the drop-down list. When you update a copy of this skill to a derived skill, the rules will also be updated:
  • Some of the rules will get new versions. The outdated versions will receive numbered postfixes (for example, Check item amount 1). Review these rules and remove any unnecessary versions from the derived skill.
  • If you remove outdated Tax Rate X, Tax Amount X, and Net Amount X fields, the rules that checked them will become unnecessary. Remove those rules from the derived skill.

Parameters

The Invoice skills have default skill parameters that refer to data catalogs used for Vendor, Business Unit, and Purchase Order lookup. You can change the values of these parameters in Vantage or Advanced Designer to modify the field extraction process.
ParameterDescription
VendorsThe predefined data catalog used for Vendor lookup. The default value of this parameter is Vendors. You can change this value by choosing another available data catalog of the same type (Document Issuer Companies).
BusinessUnitsThe predefined data catalog used for Business Unit lookup. The default value of the parameter is BusinessUnits. You can change this value by choosing another available data catalog of the same type (Document Receiver Companies). Note: This parameter is not available for the Invoice JP skill.
PurchaseOrdersThe predefined data catalog used for Purchase Order lookup. The default value of this parameter is PurchaseOrders. You can change this value by choosing another available data catalog having the same structure.
PurchaseOrderItemsThe predefined data catalog used to check if the Purchase Order details match. The default value of this parameter is PurchaseOrderItems. You can change this value by choosing another available data catalog having the same structure.