0 - does not contain additional documents. | | Items | The number of items in the shipment. | | Total Packages | The total number of packages. | | Reference Number (repeating group) | The reference number (for tracking). | | Transport Charges Method of Payment Code | The code for the method of payment used to cover transport charges. | ### Consignor | Field | Description | | :---------- | :-------------------------------------------------------------------------------- | | Name | The consignor's name. | | Address | The consignor's address. | | EORI Number | The consignor's Economic Operators Registration and Identification (EORI) number. | ### Consignee | Field | Description | | :---------- | :-------------------------------------------------------------------------------- | | Name | The consignee's name. | | Address | The consignee's address. | | EORI Number | The consignee's Economic Operators Registration and Identification (EORI) number. | ### Declarant (repeating group) | Field | Description | | :---------- | :-------------------------------------------------------------------------------- | | Name | The declarant's name. | | Address | The declarant's address. | | EORI Number | The declarant's Economic Operators Registration and Identification (EORI) number. | ### Country and Location Information | Field | Description | | :------------------------- | :---------------------------------------------------------------- | | Export Country Code | The consignor's country code. | | Destination Country Code | The consignee's country code. | | Countries of Routing Codes | The codes for countries of routing for the shipment. | | Location of Goods | The location where the goods are stored before customs clearance. | | Customs Office of Exit | Identifier of the customs office that released the goods. | ### Transport Information | Field | Description | | :--------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Identity of Means of Transport at Departure | The identifier for the means of transport at departure. | | Nationality of Means of Transport at Departure | The country of registration of the transport at departure. | | Container | Specifies whether the goods are being shipped in a container. Can have one of the following values:
0 - shipped without a container
1 - shipped in a container. | | Identity of Means of Transport at Border | The identifier for the transport shipping the goods when they are presented at the border. | | Nationality of Means of Transport at Border | The country of registration of the transport shipping the goods when they are presented at the border. | | Mode of Transport at Border | The mode of transport used to arrive at the border (road, rail, air, sea). | | Internal Mode of Transport | The internal mode of transport of the goods (road, rail, air, sea). | ### Financial Information | Field | Description | | :------------ | :---------------------------------------------------------------------- | | Currency | The currency used to specify the value of the goods in the declaration. | | Total | The total value of the shipped goods. | | Exchange Rate | The currency exchange rate. | ### Shipment Details | Field | Description | | :----------------- | :----------------------------------------------------------- | | Gross Weight in KG | The total gross weight of the packaged goods (in kilograms). | | Seal Number | The seal number. | ### Control by Office of Dispatch | Field | Description | | :------------- | :------------------------------------------------- | | Result | Other information specified by the customs office. | | Seals Affixed | Other information specified by the customs office. | | Seals Identity | Other information specified by the customs office. | | Time Limit | Other information specified by the customs office. | ## Key Fields * Movement Reference Number * Declaration Type/Part 1 * Declarant/Name * Declarant/EORI Number * Customs Office of Exit # Dangerous Goods Declaration - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/dangerous-goods-declaration Extract data from Dangerous Goods Declarations (DGD) — IATA-compliant transport documents declaring hazardous goods, classes, packaging, and emergency contacts. The **Dangerous Goods Declaration** skill extracts data from Dangerous Goods Declarations (DGDs) — the transport documents shippers compile to confirm that hazardous goods have been packed, marked, and declared in accordance with IATA Dangerous Goods Regulations. A Dangerous Goods Declaration contains required information necessary to transport the goods without any health and safety risks, as well as without danger to the environment and infrastructure. This information can contain the following: * The class of the dangerous goods and their packaging type * The special provision number * A hazardous material emergency response number. The most common types of dangerous goods have UN-assigned four-digit ID's. Declarations of Dangerous Goods, along with other transport documents required for shipping, must accompany each package and consignment of dangerous goods. The Dangerous Goods Declaration skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing dangerous goods declarations. For production use, you may need to uptrain the skill with your own document samples. ## Supported Languages * English ## Extracted Fields
I (substance presents high danger)
II (substance presents medium danger)
III (substance presents low danger) | | Packing Instruction\* | The UN-assigned packing instruction number. | | Overpack Used | Specifies whether the packages containing dangerous goods have been placed inside an overpack. | ## Key Fields * Shipper/Name * Consignee/Name ## Validation Rules | Rule | Description | | :---------------------------- | :-------------------------------------------------------------- | | Overpack Used Checkmark Check | Checks if the Dangerous Goods form has the Overpack Used field. | # Deed of Trust - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/deed-of-trust Extract data from deeds of trust — borrower, lender, trustee, property, loan terms, and recording details — for US real estate and mortgage workflows. The **Deed of Trust** skill extracts data from deeds of trust — the legal documents that secure a real estate transaction by establishing that a third-party trustee holds legal title to the property until the borrower repays the loan in full. Deeds of trust are recorded in public records, similar to mortgages. The Deed of Trust skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing deeds of trust. For production use, you may need to uptrain the skill with your own document samples. The Deed of Trust skill recognizes handwritten text. This option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields ### Borrower Info (repeating group) | Field | Description | | :------------- | :------------------------------ | | Name | Information about the borrower. | | Signature | Information about the borrower. | | Signature Date | Information about the borrower. | ### Riders and Provisions | Field | Description | | :----------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------ | | Adjustable Rate Rider | Indicates a specific provision or section that addresses the terms and conditions of an adjustable-rate mortgage (ARM). | | Condominium Rider | Indicates a specific provision or section that addresses the unique considerations and requirements associated with a condominium property. | | Second Home Rider | Indicates a specific provision or section that addresses properties designated as second homes or vacation homes. | | Balloon Rider | Indicates a specific provision or section that addresses a balloon payment arrangement within a loan. | | Planned Unit Development Rider | Indicates a specific provision or section that addresses properties located within a planned unit development. | | Biweekly Rider | Indicates a specific provision or section that addresses a biweekly payment arrangement within a loan. | | 1-4 Family Rider | Indicates a specific provision or section that addresses properties classified as 1-4 family residential properties. | | Revocable Trust Rider | Indicates a specific provision or section that addresses properties held within a revocable trust. | | MERS Rider | Indicates a specific provision or section that pertains to the Mortgage Electronic Registration Systems (MERS). | | Other(s) | Any additional provisions or important details. | ### Document Validation | Field | Description | | :-------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | All Pages Are Present | Specifies whether all numbered pages are present in the document. For example, all pages are deemed to be present if the document contains pages numbered as 1 of 5, 2 of 5, 3 of 5, 4 of 5, and 5 of 5. | ## Key Fields * Borrower Info/Name ## Validation Rules | Rule | Description | | :------------------------------------ | :--------------------------------------------------------------- | | All Pages Are Present Checkmark Value | Sets the value of the **All Pages Are Present** checkmark field. | # Delivery Note - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/delivery-note Extract data from delivery notes — vendor, buyer, goods description, quantities, and shipment details — used alongside bills of lading for shipping and customs. The **Delivery Note** skill extracts data from delivery notes — the transport documents that accompany shipped goods, recording the goods being transported plus vendor and buyer details. Delivery notes feed electronic transportation records and other customs-related transport documents such as bills of lading. The Delivery Note skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing delivery notes. For production use, you may need to uptrain the skill with your own document samples. ## Supported Languages * Czech * English * French * German * Hungarian * Romanian * Spanish ## Extracted Fields
Note: The field can only be obtained from the DenialReasons data catalog. Extraction accuracy depends on the accuracy of the information in the data catalog. | | Remark | Additional information. | | Details (Repeating Group) | Detailed information about the health care services. These fields are used if the data is presented in a tabular format: Patient First Name, Patient Last Name, Patient Account Number Service End Date, Service Start Date, Denial Reason, Claim Number | | Service Start Date | The health care service start date. | | Service End Date | The health care service end date. | ## Key Fields * Patient Name * Patient Account Number ## Parameters The Denial skill has a default parameter that specifies which data catalog is to be used to look up denial reasons. You can change the value of these parameters in Vantage or in Advanced Designer to modify the field extraction process. | Parameter | Description | | :------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | DenialReasons | The predefined data catalog is used for looking up denial reasons. The default value of this parameter is `DenialReasons`. You can change this value by choosing another available data catalog that has the same structure. | # Desktop Underwriting Findings Report - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/desktop-underwriter Extract data from Desktop Underwriting Findings Reports — borrower credit score, DTI, LTV, and loan conditions — for US mortgage origination and underwriting. The **Desktop Underwriting Findings Report** skill extracts data from Desktop Underwriting (DU) findings reports — the assessments lenders use to evaluate a borrower's creditworthiness and the risk associated with a mortgage loan. These reports typically include the borrower's credit score, debt-to-income (DTI) ratio, loan-to-value (LTV) ratio, and any conditions or stipulations required for loan approval. The Desktop Underwriting Findings Report skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing desktop underwriting reports. For production use, you may need to uptrain the skill with your own document samples. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields ### Borrower Information (repeating group) | Field | Description | | :--------------- | :------------------------------ | | Name | Information about the borrower. | | Credit Report ID | Information about the borrower. | | Credit Score(s) | Information about the borrower. | ### Loan Assessment | Field | Description | | :------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------- | | Actual or Estimated Appraised Value | The value assigned to a property based on an appraisal report or an automated valuation model (AVM). | | Total Loan Amount | The total amount of the loan being requested by the borrower. | | Preliminary Recommendation or Recommendation | The automated decision or recommendation generated by the DU system based on the information provided about the borrower and the loan application. | | Special Feature Code (repeating field) | A code that is used to indicate specific characteristics or special features associated with a loan application or property. | ## Key Fields * Borrower Information/Name * Borrower Information/Credit Report ID * Borrower Information/Credit Score(s) # Escrow Account Disclosure Statement - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/escrow-disclosure Extract data from Escrow Account Disclosure Statements — lender, borrower, deposits, and disbursements (insurance, property tax) — for US mortgage servicing. The **Escrow Account Disclosure Statement** skill extracts data from escrow account disclosure statements — the documents lenders issue to summarize escrow accounts that receive part of a mortgage borrower's monthly payment to cover insurance and property tax expenses. The statement records the lender, borrower, deposits made over the reporting period, and the expenses paid from the account. The Escrow Account Disclosure Statement skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing escrow account disclosure statements. For production use, you may need to uptrain the skill with your own document samples. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields ### Basic Information | Field | Description | | :--------------- | :------------------------------------ | | Loan Number | The loan identifier. | | Disclosure Date | The date of the disclosure. | | Property Address | The address of the financed property. | ### Borrower Information | Field | Description | | :------------------ | :------------------------------ | | Borrower Name | The name of the borrower. | | Borrower Address | The address of the borrower. | | Co-Borrower Name | The name of the co-borrower. | | Co-Borrower Address | The address of the co-borrower. | ### Servicer Information | Field | Description | | :-------------------- | :----------------------------------------- | | Servicer Name | The name of the lending organization. | | Servicer Address | The address of the lending organization. | | Servicer Phone Number | The lending organization's contact number. | ### Current Monthly Mortgage Payment (current reporting period) | Field | Description | | :------------------- | :----------------------------------------------------------- | | Effective Date | The date of the payment. | | Principal & Interest | The monthly payment size (both principal and interest). | | Escrow Deposit | The monthly escrow deposit payment. | | Shortage or Surplus | The total payment shortage/surplus for the reporting period. | | Optional Insurance | The monthly insurance payment. | | Other | Other payments. | | Subsidy | The subsidized amount. | | Total | The total amount payable for the reporting period. | ### New Monthly Mortgage Payment (new reporting period) | Field | Description | | :------------------- | :----------------------------------------------------------- | | Effective Date | The date of the payment. | | Principal & Interest | The monthly payment size (both principal and interest). | | Escrow Deposit | The monthly escrow deposit payment. | | Shortage or Surplus | The total payment shortage/surplus for the reporting period. | | Optional Insurance | The monthly insurance payment. | | Other | Other payments. | | Subsidy | The subsidized amount. | | Total | The total amount payable for the reporting period. | ### New Monthly Mortgage Payment Option 2 (new reporting period) | Field | Description | | :------------------- | :----------------------------------------------------------- | | Effective Date | The date of the payment. | | Principal & Interest | The monthly payment size (both principal and interest). | | Escrow Deposit | The monthly escrow deposit payment. | | Shortage or Surplus | The total payment shortage/surplus for the reporting period. | | Optional Insurance | The monthly insurance payment. | | Other | Other payments. | | Subsidy | The subsidized amount. | | Total | The total amount payable for the reporting period. | ### New Monthly Escrow Payment | Field | Description | | :--------------------- | :------------------------------------------------------------------- | | Monthly Escrow Payment | The size of the monthly escrow payment for the new reporting period. | | Effective Date | The date of the payment. | ### Account Balances | Field | Description | | :------------------------------ | :---------------------------------------------------- | | Projected Annual Escrow Payment | The projected total annual escrow payment. | | Starting Balance Projected | The projected starting balance of the escrow account. | | Starting Balance Required | The required escrow account starting balance. | | Projected Escrow Lowest Balance | The projected lowest escrow account balance. | | Required Escrow Lowest Balance | The required lowest escrow account balance. | | Shortage or Surplus | The escrow shortage or surplus. | | Shortage | The escrow shortage. | | Surplus | The escrow surplus. | ### Projected Escrow Account Transactions (repeating group) | Field | Description | | :------------------- | :--------------------------------------------------------------------------------- | | Month | The reporting month. | | Payments to Escrow | The total payments made to the escrow account. | | Payments from Escrow | The total payments made from the escrow account. | | Description | Description of expenses covered by money from the escrow account. | | Projected Balance | The projected escrow account starting balance for the reporting month (**Month**). | | Required Balance | The required escrow account starting balance for the reporting month (**Month**). | ## Key Fields * Loan Number * Disclosure Date * Borrower Name * New Monthly Mortgage Payment/Total * New Monthly Mortgage Payment/Effective Date * New Monthly Escrow Payment/Monthly Escrow Payment ## Validation Rules | Rule | Description | | :------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Copy Borrower Address to Co-Borrower Address | If the borrower and co-borrower reside at the same address, copies the value of the **Borrower Address** field to the **Co-Borrower Address** field. | | Check and Complete Projected Annual Escrow Payment | Checks that the value of the **Projected Annual Escrow Payment** field is equal to the total sum of all payments from the escrow account (**Payments from Escrow**) over the duration of all reporting periods. If the values are not the same, displays an error message. If the **Projected Annual Escrow Payment** field is not filled in, fills it in using the sum of the **Payments from Escrow** fields for all reporting periods. | | Separate Currency from Amount | Splits the amount and the currency in the following fields: **Starting Balance Projected**, **Projected Balance**, **Projected Escrow Lowest Balance**, **Escrow Shortage Payment**. | | Copy Min ProjBal to Projected Escrow Lowest Bal | If the **Projected Escrow Lowest Balance** field is not filled in, fills it in using the lowest value of all **Projected Balance** fields for the reporting period. | | Copy Min ReqBal to Required Escrow Lowest Bal | If the **Required Escrow Lowest Balance** field is not filled in, fills it in using the lowest value of all **Required Balance** fields for the reporting period. | | Check and Complete Shortage or Surplus | 1. If the **Shortage or Surplus**, **Shortage**, **Projected Escrow Lowest Balance**, **Required Escrow Lowest Balance** fields are not filled in, fills them in using the following value: **ReqBal + (- ProjBal)**. 2. Calculates the values of the **Shortage** and **Surplus** fields. | # Expense Management Skills Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/expense-management Expense Management skills in ABBYY Vantage extract data from receipts and expense documents — taxi, hotel, restaurant, retail, fuel — for T&E workflows. ABBYY Vantage offers **Expense Management** skills that extract data from expense documents (such as receipts) for a wide range of business expenses — primarily travel and entertainment (T\&E), including hotel, taxi, restaurant, retail, and fuel. To process expense-related documents of different types within one workflow, ABBYY Vantage offers the following built-in skills: * [Expense Management Processing](/vantage/documentation/skill-catalog/built-in-skills/expense-management-processing) * [Expense Management Classifier](/vantage/documentation/skill-catalog/built-in-skills/expense-management-classifier) # Expense Management Classifier Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/expense-management-classifier Classify expense-related documents into types — taxi, hotel, or other receipts — and route each to the matching Receipt skill in your Vantage workflow. The **Expense Management Classifier** skill identifies and classifies expense-related documents by type — taxi, hotel, or other expenses — routing each receipt to the matching pre-trained Receipt skill in your Vantage workflow: * [Hotel Invoice](/vantage/documentation/skill-catalog/built-in-skills/receipt-skills/hotel-invoice) skill for processing hotel invoices * [Receipt and Receipt CJK](/vantage/documentation/skill-catalog/built-in-skills/receipt-skills/receipt) skills for processing categories of expenses, including general retail, restaurant bills, parking charges, toll payments, gasoline expenses, and other payments, such as tickets or services * [Taxi Receipt](/vantage/documentation/skill-catalog/built-in-skills/receipt-skills/taxi-receipt) skill for processing taxi receipts Languages selected by default: English. # Expense Management Processing Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/expense-management-processing End-to-end receipt processing — classify expense receipts (taxi, hotel, retail, restaurant, fuel) and apply the matching Receipt skill to extract data. The **Expense Management Processing** skill provides end-to-end receipt processing — first classifying each incoming receipt by type, and then applying the matching Receipt skill ([Hotel Invoice](/vantage/documentation/skill-catalog/built-in-skills/receipt-skills/hotel-invoice), [Receipt or Receipt CJK](/vantage/documentation/skill-catalog/built-in-skills/receipt-skills/receipt), [Taxi Receipt](/vantage/documentation/skill-catalog/built-in-skills/receipt-skills/taxi-receipt)) to extract data. The Expense Management Processing skill can be used to extract data from receipts of the following types: taxi receipts, hotel invoices, and receipts for various other expenses (including expenses from general retail, restaurant bills, parking charges, toll payments, gasoline expenses, and other payments, such as tickets or services). # Form 1040, US Individual Income Tax Return Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/1040 Extract data from IRS Form 1040 and 1040-SR (US Individual Income Tax Return) for tax years 2018-2021: taxpayer details, income, deductions, and refunds. The **Form 1040, U.S. Individual Income Tax Return** skill extracts data from Forms 1040 and 1040-SR (for taxpayers age 65 or older) — the annual income tax returns US taxpayers file with the IRS, covering personal details, income, deductions, and the resulting tax owed or refund expected. This skill processes forms for tax years 2018 through 2021. The **Form 1040, U.S. Individual Income Tax Return** 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. This skill recognizes handwritten text. The option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields ### Form Information | Field | Description | | :------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Form | Specifies whether the form is 1040 or 1040-SR. Possible values: 1040, 1040-SR. | | Year | Indicates the year of the form. | | Filing Status | The taxpayer's filing status. Possible values: Single, Married filing jointly, Married filing separately (MFS), Head of household (HOH), Qualifying widow(er) (QW). | | Name of MFS Spouse or HOH or QW Child | The name of the taxpayer's spouse or child. | ### Taxpayer Information | Field | Description | | :--------- | :------------------------------------- | | First Name | The taxpayer's first name. | | Last Name | The taxpayer's last name. | | SSN | The taxpayer's social security number. | ### Spouse Information | Field | Description | | :------------------ | :-------------------------------------------------------------------------------- | | Spouse's First Name | The name and social security number of the taxpayer's spouse (if filing jointly). | | Spouse's Last Name | The name and social security number of the taxpayer's spouse (if filing jointly). | | Spouse's SSN | The name and social security number of the taxpayer's spouse (if filing jointly). | ### Address | Field | Description | | :----------------------------------------------------- | :---------------------- | | Home Address | The taxpayer's address. | | Apartment Number | The taxpayer's address. | | City Town or Post Office State and ZIP Code (outdated) | The taxpayer's address. | | City Town or Post Office | The taxpayer's address. | | State | The taxpayer's address. | | ZIP Code | The taxpayer's address. | | Foreign Country Name | The taxpayer's address. | | Foreign Province or State or Country | The taxpayer's address. | | Foreign Postal Code | The taxpayer's address. | ### Basic Information | Field | Description | | :------------------------------------------------------ | :--------------------------------------------------------------------------------------------- | | Full-Year Health Care Coverage (outdated) | Indicates whether the taxpayer has health insurance coverage. | | Financial Interest in Virtual Currency During This Year | Indicates whether there was any income related to virtual currencies for the reporting period. | ### Presidential Election Campaign | Field | Description | | :----- | :---------------------------------------------------------------------------------------------------------------------------------------- | | You | Indicates whether payments have been made to a Presidential election campaign fund by the taxpayer or his/her spouse (if filing jointly). | | Spouse | Indicates whether payments have been made to a Presidential election campaign fund by the taxpayer or his/her spouse (if filing jointly). | ### Standard Deduction | Field | Description | | :----------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | You as a Dependent | Indicates whether the taxpayer and/or their spouse can be claimed as dependents. | | Your Spouse as a Dependent | Indicates whether the taxpayer and/or their spouse can be claimed as dependents. | | Separate Return or Dual-Status Alien | Indicates whether the taxpayer is filing for separate returns and whether the taxpayer is a dual-status alien (both a U.S. resident alien and a nonresident alien in the same tax year). | #### Age or Blindness - You | Field | Description | | :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Born Before January 2, 1957 | Indicates whether the taxpayer or his/her spouse (if filing jointly) was born before January 2, 1957 / 1956 / 1955 / 1954 (depending on the year of the form), and whether he/she is blind. | | Born Before January 2, 1956 (outdated) | Indicates whether the taxpayer or his/her spouse (if filing jointly) was born before January 2, 1957 / 1956 / 1955 / 1954 (depending on the year of the form), and whether he/she is blind. | | Born Before January 2, 1955 (outdated) | Indicates whether the taxpayer or his/her spouse (if filing jointly) was born before January 2, 1957 / 1956 / 1955 / 1954 (depending on the year of the form), and whether he/she is blind. | | Born Before January 2, 1954 (outdated) | Indicates whether the taxpayer or his/her spouse (if filing jointly) was born before January 2, 1957 / 1956 / 1955 / 1954 (depending on the year of the form), and whether he/she is blind. | | Blind | Indicates whether the taxpayer or his/her spouse (if filing jointly) was born before January 2, 1957 / 1956 / 1955 / 1954 (depending on the year of the form), and whether he/she is blind. | #### Age or Blindness - Spouse | Field | Description | | :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Born Before January 2, 1957 | Indicates whether the taxpayer or his/her spouse (if filing jointly) was born before January 2, 1957 / 1956 / 1955 / 1954 (depending on the year of the form), and whether he/she is blind. | | Born Before January 2, 1956 (outdated) | Indicates whether the taxpayer or his/her spouse (if filing jointly) was born before January 2, 1957 / 1956 / 1955 / 1954 (depending on the year of the form), and whether he/she is blind. | | Born Before January 2, 1955 (outdated) | Indicates whether the taxpayer or his/her spouse (if filing jointly) was born before January 2, 1957 / 1956 / 1955 / 1954 (depending on the year of the form), and whether he/she is blind. | | Born Before January 2, 1954 (outdated) | Indicates whether the taxpayer or his/her spouse (if filing jointly) was born before January 2, 1957 / 1956 / 1955 / 1954 (depending on the year of the form), and whether he/she is blind. | | Blind | Indicates whether the taxpayer or his/her spouse (if filing jointly) was born before January 2, 1957 / 1956 / 1955 / 1954 (depending on the year of the form), and whether he/she is blind. | ### Dependents | Field | Description | | :------------------------ | :------------------------------------------------------------ | | More than Four Dependents | Indicates whether the taxpayer has more than four dependents. | ### Dependents (repeating group) | Field | Description | | :-------------------------- | :-------------------------------- | | Full Name | Information about the dependents. | | SSN | Information about the dependents. | | Relationship | Information about the dependents. | | Child Tax Credit | Information about the dependents. | | Credit for Other Dependents | Information about the dependents. | ### Income Information | Field | Description | | :--------------------------- | :---------------------------------- | | Wages Salaries Tips | The taxpayer's income and payments. | | Other Income from Schedule 1 | The taxpayer's income and payments. | | Total Income | The taxpayer's income and payments. | #### Tax-Exempt Interest Group | Field | Description | | :------------------ | :---------------------------------- | | Tax-Exempt Interest | The taxpayer's income and payments. | | Taxable Interest | The taxpayer's income and payments. | #### Dividends Group | Field | Description | | :------------------ | :---------------------------------- | | Qualified Dividends | The taxpayer's income and payments. | | Ordinary Dividends | The taxpayer's income and payments. | #### IRAs Pensions and Annuities Group (outdated) | Field | Description | | :------------------------------------- | :---------------------------------- | | IRAs Pensions and Annuities (outdated) | The taxpayer's income and payments. | | Taxable Amount (outdated) | The taxpayer's income and payments. | #### IRA Distributions Group | Field | Description | | :---------------- | :---------------------------------- | | IRA Distributions | The taxpayer's income and payments. | | Taxable Amount | The taxpayer's income and payments. | #### Pensions and Annuities Group | Field | Description | | :--------------------- | :---------------------------------- | | Pensions and Annuities | The taxpayer's income and payments. | | Taxable Amount | The taxpayer's income and payments. | #### Social Security Benefits Group | Field | Description | | :----------------------- | :---------------------------------- | | Social Security Benefits | The taxpayer's income and payments. | | Taxable Amount | The taxpayer's income and payments. | #### Capital Gain or Loss Group | Field | Description | | :---------------------- | :---------------------------------- | | Capital Gain or Loss | The taxpayer's income and payments. | | Schedule D Not Required | The taxpayer's income and payments. | ### Adjustments to Income | Field | Description | | :------------------------------------- | :---------------------------------- | | From Schedule 1 | The taxpayer's income and payments. | | Charitable Contributions (outdated) | The taxpayer's income and payments. | | Total Adjustments to Income (outdated) | The taxpayer's income and payments. | | Adjusted Gross Income | The taxpayer's income and payments. | ### Taxable Income Group | Field | Description | | :---------------------------------------- | :---------------------------------- | | Standard Deduction or Itemized Deductions | The taxpayer's income and payments. | | Charitable Contributions | The taxpayer's income and payments. | | Partial Sum | The taxpayer's income and payments. | | Qualified Business Income Deduction | The taxpayer's income and payments. | | Total Deduction | The taxpayer's income and payments. | | Taxable Income | The taxpayer's income and payments. | ### Tax Group | Field | Description | | :-------------------------------------- | :---------------------------------- | | Tax | The taxpayer's income and payments. | | Form 8814 | The taxpayer's income and payments. | | Form 4972 | The taxpayer's income and payments. | | Other Form | The taxpayer's income and payments. | | Other Form Name | The taxpayer's income and payments. | | Amount from Schedule 2 Check (outdated) | The taxpayer's income and payments. | | Amount from Schedule 2 | The taxpayer's income and payments. | | Group Total | The taxpayer's income and payments. | ### Child Tax Credit Group | Field | Description | | :-------------------------------------- | :---------------------------------- | | Child Tax Credit | The taxpayer's income and payments. | | Amount from Schedule 3 Check (outdated) | The taxpayer's income and payments. | | Amount from Schedule 3 | The taxpayer's income and payments. | | Group Total | The taxpayer's income and payments. | ### Tax Calculations | Field | Description | | :---------------------------------------- | :---------------------------------- | | Tax minus Child Tax Credit | The taxpayer's income and payments. | | Other Taxes Including Self-Employment Tax | The taxpayer's income and payments. | | Total Tax | The taxpayer's income and payments. | ### Federal Income Tax Group | Field | Description | | :------------------------------------------------------------- | :---------------------------------- | | Federal Income Tax Withheld from Forms W-2 and 1099 (outdated) | The taxpayer's income and payments. | | Form W-2 | The taxpayer's income and payments. | | Form 1099 | The taxpayer's income and payments. | | Other Forms | The taxpayer's income and payments. | | Group Total | The taxpayer's income and payments. | ### Tax Payments and Credits | Field | Description | | :------------------------------------------------------------------------ | :---------------------------------- | | This Year Estimated Tax Payments and Amount Applied from Last Year Return | The taxpayer's income and payments. | | Additional Child Tax Credit (Schedule 8812) | The taxpayer's income and payments. | | American Opportunity Credit from Form 8863 | The taxpayer's income and payments. | | Recovery Rebate Credit | The taxpayer's income and payments. | | Amount from Schedule 5 (outdated) | The taxpayer's income and payments. | | Amount from Schedule 3 | The taxpayer's income and payments. | | Total Other Payments and Refundable Credits | The taxpayer's income and payments. | | Total Payments | The taxpayer's income and payments. | ### Earned Income Credit | Field | Description | | :------------------------- | :---------------------------------- | | Earned Income Credit | The taxpayer's income and payments. | | Qualified to Claim the EIC | The taxpayer's income and payments. | | Combat Pay Election | The taxpayer's income and payments. | | Prior Year Earned Income | The taxpayer's income and payments. | ### Payment Resolution | Field | Description | | :------------------------------------------------------- | :---------------------------------------- | | Overpaid Amount | The taxpayer's overpaid amount and debts. | | Overpaid Amount to be Applied to Next Year Estimated Tax | The taxpayer's overpaid amount and debts. | | Owed Amount | The taxpayer's overpaid amount and debts. | | Estimated Tax Penalty | The taxpayer's overpaid amount and debts. | ### Refund Group | Field | Description | | :------------------------- | :------------------------------------------------------------ | | Form 8888 Attached | Specifies whether the Form 8888 is attached. | | Refundable Amount/Refunded | The refund amount. | | Routing Number | The number of the bank's branch where the account was opened. | | Type | The type of account. Possible values: Checking, Saving. | | Account Number | The number of the account. | ### Third Party Designee | Field | Description | | :---------------------------------- | :------------------------------------------------------------------------------------------------------------------------- | | Another Person Can Discuss with IRS | The contact information of the taxpayer's representative that is authorized to discuss the taxpayer's return with the IRS. | | Designee's Name | The contact information of the taxpayer's representative that is authorized to discuss the taxpayer's return with the IRS. | | Phone Number | The contact information of the taxpayer's representative that is authorized to discuss the taxpayer's return with the IRS. | | PIN | The contact information of the taxpayer's representative that is authorized to discuss the taxpayer's return with the IRS. | ### Signature | Field | Description | | :---------------------- | :------------------------ | | Date | The taxpayer's signature. | | Occupation | The taxpayer's signature. | | Identity Protection PIN | The taxpayer's signature. | ### Spouse's Signature | Field | Description | | :---------------------- | :------------------------------------------ | | Date | The spouse's signature (if filing jointly). | | Occupation | The spouse's signature (if filing jointly). | | Identity Protection PIN | The spouse's signature (if filing jointly). | | Phone Number | The spouse's signature (if filing jointly). | | Email Address | The spouse's signature (if filing jointly). | ### Preparer | Field | Description | | :------------------------------ | :--------------------------------------------------------------------------------------------------- | | Preparer's Name | Details of the preparer of the tax return (if the return is completed and filed by a paid preparer). | | Date | Details of the preparer of the tax return (if the return is completed and filed by a paid preparer). | | PTIN | Details of the preparer of the tax return (if the return is completed and filed by a paid preparer). | | Firm's Name | Details of the preparer of the tax return (if the return is completed and filed by a paid preparer). | | Firm's Address | Details of the preparer of the tax return (if the return is completed and filed by a paid preparer). | | Phone Number | Details of the preparer of the tax return (if the return is completed and filed by a paid preparer). | | Firm's EIN | Details of the preparer of the tax return (if the return is completed and filed by a paid preparer). | | Third Party Designee (outdated) | Details of the preparer of the tax return (if the return is completed and filed by a paid preparer). | | Self-Employed | Details of the preparer of the tax return (if the return is completed and filed by a paid preparer). | ## Key Fields * First Name * Last Name * SSN * Signature/Date ## Validation Rules | Rule | Description | | :-------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Check Year | Checks the value in the **Year** field, which can only be one of the following: 2018, 2019, 2020, 2021. If the extracted field value is different, displays a message saying that the processed form is not supported by the skill. | | Clean Code | Checks for non-numeric values and replaces them with empty strings in **Refund Group/Account Number**, **Refund Group/Routing Number**, **Signature/Identity Protection PIN**, **Spouse's Signature/Identity Protection PIN**, **SSN**, and **Spouse/Spouse's SSN**. For example, SSN 555-55-5555 changes to 555555555. | | Clean Email | Checks for incorrect values in the **Spouse’s Signature/Email Address** field and replaces them with supported values. For example, Email Address [joe@mail.com](mailto:joe@mail.com) changes to [joe@gmail.com](mailto:joe@gmail.com). | | Form Type Check | Checks that the form is either Form 1040 and/or Form 1040-SR. | # Form 1040 (US Individual Income Tax Return), 2022-2023 Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/1040-2022-2023 Extract data from IRS Form 1040 and 1040-SR (US Individual Income Tax Return) for tax years 2022 and 2023: taxpayer details, income, deductions, totals. The **Form 1040, U.S. Individual Income Tax Return, 2022, 2023** skill extracts key data from 1040 and 1040-SR tax forms for years 2022 and 2023. Form 1040, U.S. Individual Income Tax Return, 2022, 2023 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. This skill recognizes handwritten text. The option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields ### Form Information | Field | Description | | :------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Form | Specifies whether the form is 1040 or 1040-SR. Possible values: 1040, 1040-SR. | | Year | Indicates the year of the form. | | Tax Year Beginning Date | The beginning date of the tax year. | | Tax Year Ending Date | The ending date of the tax year. | | Filing Status | The taxpayer's filing status. Possible values: Single, Married filing jointly, Married filing separately (MFS), Head of household (HOH), Qualifying surviving spouse (QSS). | | Name of MFS Spouse or HOH or QW Child | The name of the taxpayer's spouse or child. | ### Taxpayer Information | Field | Description | | :--------- | :------------------------------------- | | First Name | The taxpayer's first name. | | Last Name | The taxpayer's last name. | | SSN | The taxpayer's social security number. | ### Spouse Information | Field | Description | | :------------------ | :-------------------------------------------------------------------------------- | | Spouse's First Name | The name and social security number of the taxpayer's spouse (if filing jointly). | | Spouse's Last Name | The name and social security number of the taxpayer's spouse (if filing jointly). | | Spouse's SSN | The name and social security number of the taxpayer's spouse (if filing jointly). | ### Address | Field | Description | | :----------------------------------- | :---------------------- | | Home Address | The taxpayer's address. | | Apartment Number | The taxpayer's address. | | City Town or Post Office | The taxpayer's address. | | State | The taxpayer's address. | | ZIP Code | The taxpayer's address. | | Foreign Country Name | The taxpayer's address. | | Foreign Province or State or Country | The taxpayer's address. | | Foreign Postal Code | The taxpayer's address. | ### Presidential Election Campaign | Field | Description | | :----- | :---------------------------------------------------------------------------------------------------------------------------------------- | | You | Indicates whether payments have been made to a Presidential election campaign fund by the taxpayer or his/her spouse (if filing jointly). | | Spouse | Indicates whether payments have been made to a Presidential election campaign fund by the taxpayer or his/her spouse (if filing jointly). | ### Digital Assets | Field | Description | | :------------- | :----------------------------------------------------------------------------------------------------------------------- | | Digital Assets | Indicates whether there was any income related to virtual currencies for the reporting period. Possible values: Yes, No. | ### Standard Deduction | Field | Description | | :----------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | You as a Dependent | Indicates whether the taxpayer and/or their spouse can be claimed as dependents. | | Your Spouse as a Dependent | Indicates whether the taxpayer and/or their spouse can be claimed as dependents. | | Separate Return or Dual-Status Alien | Indicates whether the taxpayer is filing for separate returns and whether the taxpayer is a dual-status alien (both a U.S. resident alien and a nonresident alien in the same tax year). | #### Age or Blindness - You | Field | Description | | :------------------------------------------------------------------------- | :---------------------------------------------------------------------------------- | | Individual is 65 Years of Age or Over as of January 2 of the Current Year. | Indicates if the taxpayer is 65 years or older as of January 2 of the current year. | | Blind | Indicates if the taxpayer is blind. | #### Age or Blindness - Spouse | Field | Description | | :------------------------------------------------------------------------ | :-------------------------------------------------------------------------------- | | Individual is 65 Years of Age or Over as of January 2 of the Current Year | Indicates if the spouse is 65 years or older as of January 2 of the current year. | | Blind | Indicates if the spouse is blind. | ### Dependents | Field | Description | | :------------------------ | :------------------------------------------------------------ | | More than Four Dependents | Indicates whether the taxpayer has more than four dependents. | ### Dependents (repeating group) | Field | Description | | :-------------------------- | :-------------------------------- | | Full Name | Information about the dependents. | | SSN | Information about the dependents. | | Relationship | Information about the dependents. | | Child Tax Credit | Information about the dependents. | | Credit for Other Dependents | Information about the dependents. | ### Box 1 Group - Wages and Income | Field | Description | | :---------------------------------------------------------- | :---------------------------------- | | Box 1a - Total Amount from Form W-2 Box 1 | The taxpayer's income and payments. | | Box 1b - Household Employee Wages | The taxpayer's income and payments. | | Box 1c - Tip Income | The taxpayer's income and payments. | | Box 1d - Medicaid Waiver Payments | The taxpayer's income and payments. | | Box 1e - Taxable Dependent Care Benefits from Form 2441 | The taxpayer's income and payments. | | Box 1f - Employer-Provided Adoption Benefits from Form 8839 | The taxpayer's income and payments. | | Box 1g - Wages from Form 8919 | The taxpayer's income and payments. | | Box 1h - Other Earned Income | The taxpayer's income and payments. | | Box 1i - Nontaxable Combat Pay Election | The taxpayer's income and payments. | | Box 1z - Group Total | The taxpayer's income and payments. | ### Box 2 Group - Interest | Field | Description | | :--------------------------- | :---------------------------------- | | Box 2a - Tax-Exempt Interest | The taxpayer's income and payments. | | Box 2b - Taxable Interest | The taxpayer's income and payments. | ### Box 3 Group - Dividends | Field | Description | | :--------------------------- | :---------------------------------- | | Box 3a - Qualified Dividends | The taxpayer's income and payments. | | Box 3b - Ordinary Dividends | The taxpayer's income and payments. | ### Box 4 Group - IRA Distributions | Field | Description | | :------------------------- | :---------------------------------- | | Box 4a - IRA Distributions | The taxpayer's income and payments. | | Box 4b - Taxable Amount | The taxpayer's income and payments. | ### Box 5 Group - Pensions and Annuities | Field | Description | | :------------------------------ | :---------------------------------- | | Box 5a - Pensions and Annuities | The taxpayer's income and payments. | | Box 5b - Taxable Amount | The taxpayer's income and payments. | ### Box 6 Group - Social Security Benefits | Field | Description | | :---------------------------------------- | :---------------------------------- | | Box 6a - Social Security Benefits | The taxpayer's income and payments. | | Box 6b - Taxable Amount | The taxpayer's income and payments. | | Box 6c - Use the Lump-Sum Election Method | The taxpayer's income and payments. | ### Box 7 Group - Capital Gains | Field | Description | | :--------------------------- | :---------------------------------- | | Schedule D Not Required | The taxpayer's income and payments. | | Box 7 - Capital Gain or Loss | The taxpayer's income and payments. | ### Income Summary | Field | Description | | :--------------------------------------------- | :---------------------------------- | | Box 8 - Other Income from Schedule 1 | The taxpayer's income and payments. | | Box 9 - Total Income | The taxpayer's income and payments. | | Box 10 - Adjustments to Income from Schedule 1 | The taxpayer's income and payments. | | Box 11 - Adjusted Gross Income | The taxpayer's income and payments. | ### Deductions | Field | Description | | :------------------------------------------------- | :---------------------------------- | | Box 12 - Standard Deduction or Itemized Deductions | The taxpayer's income and payments. | | Box 13 - Qualified Business Income Deduction | The taxpayer's income and payments. | | Box 14 - Total of Boxes 12 and 13 | The taxpayer's income and payments. | | Box 15 - Taxable Income | The taxpayer's income and payments. | ### Box 16 Group - Tax Calculation | Field | Description | | :------------------ | :---------------------------------- | | 1 - Form 8814 | The taxpayer's income and payments. | | 2 - Form 4972 | The taxpayer's income and payments. | | 3 - Other Form | The taxpayer's income and payments. | | 3 - Other Form Name | The taxpayer's income and payments. | | Box 16 - Tax | The taxpayer's income and payments. | ### Tax and Credits | Field | Description | | :------------------------------------------------- | :---------------------------------- | | Box 17 - Amount from Schedule 2 | The taxpayer's income and payments. | | Box 18 - Total of Boxes 16 and 17 | The taxpayer's income and payments. | | Box 19 - Child Tax Credit | The taxpayer's income and payments. | | Box 20 - Amount from Schedule 3 | The taxpayer's income and payments. | | Box 21 - Total of Boxes 19 and 20 | The taxpayer's income and payments. | | Box 22 - Tax Minus Child Tax Credit | The taxpayer's income and payments. | | Box 23 - Other Taxes Including Self-Employment Tax | The taxpayer's income and payments. | | Box 24 - Total Tax | The taxpayer's income and payments. | ### Box 25 Group - Federal Income Tax Withheld | Field | Description | | :-------------------- | :---------------------------------- | | Box 25a - Form W-2 | The taxpayer's income and payments. | | Box 25b - Form 1099 | The taxpayer's income and payments. | | Box 25c - Other Forms | The taxpayer's income and payments. | | Box 25d - Group Total | The taxpayer's income and payments. | ### Payments and Credits | Field | Description | | :---------------------------------------------------------------------------------------- | :---------------------------------- | | Box 26 - Current Year’s Estimated Tax Payments and Amount Applied from Last Year’s Return | The taxpayer's income and payments. | | Box 27 - Earned Income Credit | The taxpayer's income and payments. | | Box 28 - Additional Child Tax Credit from Schedule 8812 | The taxpayer's income and payments. | | Box 29 - American Opportunity Credit from Form 8863 | The taxpayer's income and payments. | | Box 31 - Amount from Schedule 3 | The taxpayer's income and payments. | | Box 32 - Total Other Payments and Refundable Credits | The taxpayer's income and payments. | | Box 33 - Total Payments | The taxpayer's income and payments. | | Box 34 - Overpaid Amount | The taxpayer's income and payments. | ### Box 35 Group - Refund Information | Field | Description | | :--------------------------- | :------------------------------------------------------------ | | Box 35a - Form 8888 Attached | Specifies whether the Form 8888 is attached. | | Box 35a - Refundable Amount | The refund amount. | | Box 35b - Routing Number | The number of the bank's branch where the account was opened. | | Checking | The type of account. Possible values: Checking, Saving. | | Saving | The type of account. Possible values: Checking, Saving. | | Box 35d - Account Number | The number of the account. | ### Payment Resolution | Field | Description | | :------------------------------------------------------------------ | :----------------------------------------- | | Box 36 - Overpaid Amount to be Applied to Next Year's Estimated Tax | The taxpayer's overpaid amounts and debts. | | Box 37 - Owed Amount | The taxpayer's overpaid amounts and debts. | | Box 38 - Estimated Tax Penalty | The taxpayer's overpaid amounts and debts. | ### Third Party Designee | Field | Description | | :---------------------------------- | :------------------------------------------------------------------------------------------------------------------------- | | Another Person Can Discuss with IRS | The contact information of the taxpayer's representative that is authorized to discuss the taxpayer's return with the IRS. | | Designee's Name | The contact information of the taxpayer's representative that is authorized to discuss the taxpayer's return with the IRS. | | Phone Number | The contact information of the taxpayer's representative that is authorized to discuss the taxpayer's return with the IRS. | | PIN | The contact information of the taxpayer's representative that is authorized to discuss the taxpayer's return with the IRS. | ### Signature | Field | Description | | :---------------------- | :------------------------ | | Date | The taxpayer's signature. | | Occupation | The taxpayer's signature. | | Identity Protection PIN | The taxpayer's signature. | ### Spouse's Signature | Field | Description | | :---------------------- | :------------------------------------------ | | Date | The spouse's signature (if filing jointly). | | Occupation | The spouse's signature (if filing jointly). | | Identity Protection PIN | The spouse's signature (if filing jointly). | | Phone Number | The spouse's signature (if filing jointly). | | Email Address | The spouse's signature (if filing jointly). | ### Preparer | Field | Description | | :-------------- | :--------------------------------------------------------------------------------------------------- | | Preparer's Name | Details of the preparer of the tax return (if the return is completed and filed by a paid preparer). | | Date | Details of the preparer of the tax return (if the return is completed and filed by a paid preparer). | | PTIN | Details of the preparer of the tax return (if the return is completed and filed by a paid preparer). | | Firm's Name | Details of the preparer of the tax return (if the return is completed and filed by a paid preparer). | | Firm's Address | Details of the preparer of the tax return (if the return is completed and filed by a paid preparer). | | Phone Number | Details of the preparer of the tax return (if the return is completed and filed by a paid preparer). | | Firm's EIN | Details of the preparer of the tax return (if the return is completed and filed by a paid preparer). | | Self-Employed | Details of the preparer of the tax return (if the return is completed and filed by a paid preparer). | ## Key Fields * First Name * Last Name * SSN * Signature/Date ## Validation Rules | Rule | Description | | :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Clean Email | Checks for incorrect values in the **Spouse’s Signature/Email Address** field and replaces them with supported values. For example, Email Address [joe@mail.com](mailto:joe@mail.com) changes to [joe@gmail.com](mailto:joe@gmail.com). | | Clean Code | Checks for non-numeric values and replaces them with empty strings in **SSN**, **Third Party Designee/PIN**, **Signature/Identity Protection PIN**, **Spouse’s Signature/Identity Protection PIN**, **Spouse/Spouse's SSN**, **Box 35 Group/Box 35b - Routing Number**, and **Box 35 Group/Box 35d - Account Number** fields. For example, SSN 555-55-5555 changes to 555555555. | | Clean Year | Checks the value in the **Year** field. It converts 2-digit and 3-digit years (such as 22 or 022) into a 4-digit format (such as 2022). It assumes all 2-digit and 3-digit years are 2022 or 2023. | | Form Type Check | Checks that the form is either Form 1040 and/or Form 1040-SR. | | Check Year | Checks the value in the **Year** field, which can only be 2022 or 2023. If the extracted field value is different, displays a message saying that the processed form is not supported by the skill. | # Form 1040 Classifier Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/1040-classifier Classify Forms 1040 by tax year and route each form to the matching Vantage Form 1040 skill — supports tax years 2018 through 2023. The **Form 1040 Classifier** skill identifies and classifies Forms 1040 by tax year, routing each form to the matching pre-trained Form 1040 Document skill in Vantage: * [Form 1040, U.S. Individual Income Tax Return, 2022, 2023](/vantage/documentation/skill-catalog/built-in-skills/form-skills/1040-2022-2023) for processing forms for the tax year of 2022 and 2023. * [Form 1040, U.S. Individual Income Tax Return](/vantage/documentation/skill-catalog/built-in-skills/form-skills/1040) for processing forms for the tax years of 2018, 2019, 2020 and 2021. # Form 1040, U.S. Individual Income Tax Return Skills Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/1040-overview Process IRS Form 1040 and 1040-SR — US Individual Income Tax Return — using the Vantage Form 1040 skills, with a Form 1040 Classifier to route by tax year. The **Form 1040, U.S. Individual Income Tax Return** skill extracts data from Forms 1040 and 1040-SR (for taxpayers who are age 65 or older), completed by U.S. taxpayers to file their annual income tax returns with the IRS. The form is divided into sections where taxpayers can report their income and deductions to determine the amount of tax they owe or the refund they expect to receive. The form also contains personal details about the taxpayer, his or her spouse, and dependents. ABBYY Vantage includes the following built-in Tax Form 1040 skills: * [Form 1040, U.S. Individual Income Tax Return, 2022, 2023](/vantage/documentation/skill-catalog/built-in-skills/form-skills/1040-2022-2023) for processing forms for the tax years of 2022 and 2023. * [Form 1040, U.S. Individual Income Tax Return](/vantage/documentation/skill-catalog/built-in-skills/form-skills/1040) for processing forms for the tax years of 2018, 2019, 2020 and 2021. To identify and classify Forms 1040 based on their year, ABBYY Vantage offers the [Form 1040 Classifier](/vantage/documentation/skill-catalog/built-in-skills/form-skills/1040-classifier) skill. # Form 1095-A, Health Insurance Marketplace Statement Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/1095-a Extract data from IRS Form 1095-A (Health Insurance Marketplace Statement) — coverage effective date, monthly premiums, and advance premium tax credit. The **Form 1095-A, Health Insurance Marketplace Statement** skill extracts data from Forms 1095-A, which are used to report certain information to the Internal Revenue Service (IRS) about individuals who enroll in a qualified health plan through the Health Insurance Marketplace. It includes information such as the effective date of the coverage, the premium amounts paid monthly, and any advance payments of the premium tax credit or subsidy. The Form 1095-A, Health Insurance Marketplace Statement skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing Forms 1095-A. For production use, you may need to uptrain the skill with your own document samples. This skill recognizes handwritten text. The option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields ### Form Information | Field | Description | | :-------- | :------------------------------------------------------------------------------------- | | Year | The reporting fiscal year. | | Void | Specifies that the processed form should be annulled. | | Corrected | Specifies that the processed form is being submitted to correct data provided earlier. | ### Part I - Recipient Information | Field | Description | | :------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------- | | Marketplace Identifier | The identifier of the Marketplace where the recipient enrolled in the coverage. | | Marketplace-Assigned Policy Number | The policy number assigned by the Marketplace to identify the policy in which the recipient enrolled. | | Policy Issuer's Name | The name of the insurance company that issued the recipient's policy. | | Recipient's Name | The name of the recipient. | | Recipient's SSN | The Social Security Number (SSN) of the recipient. | | Recipient's Date of Birth | The date of birth of the recipient. | | Recipient's Spouse's Name | The name of the recipient's spouse. Information about the recipient's spouse is entered only if advance credit payments were made for the coverage. | | Recipient's Spouse's SSN | The Social Security Number (SSN) of the recipient's spouse. | | Recipient's Spouse's Date of Birth | The date of birth of the recipient's spouse. | | Policy Start Date | The starting date of the policy. | | Policy Termination Date | The ending date of the policy. | | Street Address | The address of the recipient. | | City or Town | The address of the recipient. | | State or Province | The address of the recipient. | | Country and ZIP or Foreign Postal Code | The address of the recipient. | ### Part II - Covered Individuals (table) | Field | Description | | :------------------------------- | :---------------------------------------------------------------------- | | Covered Individual Name | The name of the individual who is covered under the recipient's policy. | | Covered Individual SSN | The Social Security Number (SSN) of the individual. | | Covered Individual Date of Birth | The date of birth of the individual. | | Coverage Start Date | The starting date of the coverage. | | Coverage Termination Date | The ending date of the coverage. | ### Part III - Coverage Information (table) | Field | Description | | :----------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Month | Month of the insurance coverage. | | Monthly Enrollment Premiums | The monthly premiums for the plan in which the recipient or his family members were enrolled, including premiums that the recipient paid and premiums that were paid through advance payments of the premium tax credit. | | Monthly Second Lowest Cost Silver Plan (SLCSP) Premium | The monthly premium for the second lowest cost silver plan (SLCSP) that the Marketplace has determined, which applies to members of the recipient's family enrolled in the coverage. | | Monthly Advance Payment of Premium Tax Credit | The monthly amount of advance credit payments that were made to the insurance company on behalf of the recipient to pay for all or part of the premiums for his coverage. | ### Annual Totals | Field | Description | | :-------------------------------------------------------------------- | :------------------------------------------------------- | | Monthly Enrollment Premiums - Annual Total | The total amount of the monthly enrollment premiums. | | Monthly Second Lowest Cost Silver Plan (SLCSP) Premium - Annual Total | The total amount of the monthly SLCSP premiums. | | Monthly Advance Payment of Premium Tax Credit - Annual Total | The total amount of the monthly advance credit payments. | ## Key Fields * Part I - Recipient Information/Marketplace Identifier * Part I - Recipient Information/Recipient's Name * Part I - Recipient Information/Recipient's SSN ## Validation Rules | Rule | Description | | :--------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Clean Year | Checks the value in the **Year** field. It converts a 2-digit year (such as 24) into a 4-digit format (such as 2024). It assumes all 2-digit years are in the 2000s. | # Form 1095-B, Health Coverage - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/1095-b Extract data from IRS Form 1095-B (Health Coverage) used to report minimum essential health coverage and exemption from the shared responsibility payment. The **Form 1095-B, Health Coverage** skill extracts data from Forms 1095-B, which are used to report certain information to the Internal Revenue Service (IRS) and to taxpayers about individuals who have minimum essential coverage and are exempt from paying the individual shared responsibility payment. The Form 1095-B, Health Coverage skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing Forms 1095-B. For production use, you may need to uptrain the skill with your own document samples. This skill recognizes handwritten text. The option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields ### Form Information | Field | Description | | :-------- | :------------------------------------------------------------------------------------- | | Year | The reporting fiscal year. | | Void | Specifies that the processed form should be annulled. | | Corrected | Specifies that the processed form is being submitted to correct data provided earlier. | ### Part I - Responsible Individual | Field | Description | | :----------------------------------------------- | :------------------------------------------------------------------------------------------------------------ | | Name | The name of the responsible individual. | | Social Security Number or Other TIN | The Social Security Number (SSN) or other Taxpayer Identification Number (TIN) of the responsible individual. | | Date of Birth | The date of birth of the responsible individual. | | Street Address | The address of the responsible individual. | | City or Town | The address of the responsible individual. | | State or Province | The address of the responsible individual. | | Country and ZIP or Foreign Postal Code | The address of the responsible individual. | | Letter Identifying Origin of the Health Coverage | The letter identifying the Origin of the Health Coverage. | ### Part II - Information About Certain Employer-Sponsored Coverage | Field | Description | | :------------------------------------- | :-------------------------------------------------------------------------------- | | Employer Name | The name of the employer sponsoring the coverage. | | Employer Identification Number | The Employer Identification Number (EIN) of the employer sponsoring the coverage. | | Street Address | The address of the employer sponsoring the coverage. | | City or Town | The address of the employer sponsoring the coverage. | | State or Province | The address of the employer sponsoring the coverage. | | Country and ZIP or Foreign Postal Code | The address of the employer sponsoring the coverage. | ### Part III - Issuer or Other Coverage Provider | Field | Description | | :------------------------------------- | :--------------------------------------------------------------------------------- | | Name | The name of the issuer or other coverage provider. | | Employer Identification Number | The Employer Identification Number (EIN) of the issuer or other coverage provider. | | Contact Telephone Number | The phone number of the issuer or other coverage provider. | | Street Address | The address of the issuer or other coverage provider. | | City or Town | The address of the issuer or other coverage provider. | | State or Province | The address of the issuer or other coverage provider. | | Country and ZIP or Foreign Postal Code | The address of the issuer or other coverage provider. | ### Part IV - Covered Individuals (table) | Field | Description | | :-------------------- | :--------------------------------------------------------------------------------------------------------------- | | Name | The name of each covered individual. | | SSN or TIN | The Social Security Number (SSN) or other Taxpayer Identification Number (TIN) for each covered individual. | | DOB | The date of birth (YYYY/MM/DD) for the covered individual. | | Covered All 12 Months | Indicates that the individual was covered for at least one day per month for all 12 months of the calendar year. | #### Monthly Coverage | Field | Description | | :---- | :--------------------------------------------------------------------- | | Jan | The month(s) in which the individual was covered for at least one day. | | Feb | The month(s) in which the individual was covered for at least one day. | | Mar | The month(s) in which the individual was covered for at least one day. | | Apr | The month(s) in which the individual was covered for at least one day. | | May | The month(s) in which the individual was covered for at least one day. | | June | The month(s) in which the individual was covered for at least one day. | | July | The month(s) in which the individual was covered for at least one day. | | Aug | The month(s) in which the individual was covered for at least one day. | | Sept | The month(s) in which the individual was covered for at least one day. | | Oct | The month(s) in which the individual was covered for at least one day. | | Nov | The month(s) in which the individual was covered for at least one day. | | Dec | The month(s) in which the individual was covered for at least one day. | ## Key Fields * Part I - Responsible Individual/Name * Part I - Responsible Individual/Social Security Number or Other TIN * Part III - Issuer or Other Coverage Provider/Name * Part III - Issuer or Other Coverage Provider/Employer Identification Number ## Validation Rules | Rule | Description | | :--------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Clean Name | Checks for unsupported characters such as \| and ] in name fields. It also cleans multiple spaces, tabs, and newlines. | | Clean Year | Checks the value in the **Year** field. It converts a 2-digit year (such as 24) into a 4-digit format (such as 2024). It assumes all 2-digit years are in the 2000s. | # Form 1095-C, Employer Health Insurance Coverage Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/1095-c Extract data from IRS Form 1095-C (Employer-Provided Health Insurance Offer and Coverage) reporting health insurance offered by applicable large employers. The **Form 1095-C, Employer-Provided Health Insurance Offer and Coverage** skill extracts data from Forms 1095-C, which are used to provide information to employees and the Internal Revenue Service (IRS) about health insurance coverage offered by employers. The Form 1095-C, Employer-Provided Health Insurance Offer and Coverage skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing Forms 1095-C. For production use, you may need to uptrain the skill with your own document samples. This skill recognizes handwritten text. The option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Basic Form Information | Field | Description | | :-------- | :------------------------------------------------------------------------------------- | | Year | The name of the health insurance carrier. | | Void | Specifies that the processed form should be annulled. | | Corrected | Specifies that the processed form is being submitted to correct data provided earlier. | ## Part I - Employee and Employer Information ### Employee Information | Field | Description | | :------------------------------------- | :-------------------------------------------------------- | | Name of Employee | The name of the covered employee. | | Social Security Number | The Social Security Number (SSN) of the covered employee. | | Street Address | The address of the covered employee. | | City or Town | The address of the covered employee. | | State or Province | The address of the covered employee. | | Country and ZIP or Foreign Postal Code | The address of the covered employee. | ### Employer Information | Field | Description | | :------------------------------------- | :-------------------------------------------------------------------------------- | | Name of Employer | The name of the employer sponsoring the coverage. | | Employer Identification Number | The Employer Identification Number (EIN) of the employer sponsoring the coverage. | | Street Address | The address and phone number of the employer sponsoring the coverage. | | Contact Telephone Number | The address and phone number of the employer sponsoring the coverage. | | City or Town | The address and phone number of the employer sponsoring the coverage. | | State or Province | The address and phone number of the employer sponsoring the coverage. | | Country and ZIP or Foreign Postal Code | The address and phone number of the employer sponsoring the coverage. | ## Part II - Coverage Information ### General Coverage Details | Field | Description | | :-------------------------- | :----------------------------------------------------------------------- | | Employee's Age on January 1 | The age of the employee as of January 1st of the previous calendar year. | | Plan Start Month | The month in which the employer's health insurance plan year begins. | ### Offer of Coverage Table Contains codes from Code Series 1 for each calendar month. If the same code applies for all 12 calendar months, only the **All 12 Months** column contains the applicable code. | Month | Description | | :------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | All 12 Months | Contains codes from Code Series 1 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Jan | Contains codes from Code Series 1 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Feb | Contains codes from Code Series 1 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Mar | Contains codes from Code Series 1 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Apr | Contains codes from Code Series 1 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | May | Contains codes from Code Series 1 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | June | Contains codes from Code Series 1 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | July | Contains codes from Code Series 1 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Aug | Contains codes from Code Series 1 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Sept | Contains codes from Code Series 1 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Oct | Contains codes from Code Series 1 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Nov | Contains codes from Code Series 1 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Dec | Contains codes from Code Series 1 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | ### Employee Required Contribution Table Contains the amount of the Employee Required Contribution for each month. If the same amount applies for all 12 calendar months, only the **All 12 Months** column contains the monthly amount. | Month | Description | | :------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | All 12 Months | Contains the amount of the Employee Required Contribution for each month. If the same amount applies for all 12 calendar months, only the All 12 Months column contains the monthly amount. | | Jan | Contains the amount of the Employee Required Contribution for each month. If the same amount applies for all 12 calendar months, only the All 12 Months column contains the monthly amount. | | Feb | Contains the amount of the Employee Required Contribution for each month. If the same amount applies for all 12 calendar months, only the All 12 Months column contains the monthly amount. | | Mar | Contains the amount of the Employee Required Contribution for each month. If the same amount applies for all 12 calendar months, only the All 12 Months column contains the monthly amount. | | Apr | Contains the amount of the Employee Required Contribution for each month. If the same amount applies for all 12 calendar months, only the All 12 Months column contains the monthly amount. | | May | Contains the amount of the Employee Required Contribution for each month. If the same amount applies for all 12 calendar months, only the All 12 Months column contains the monthly amount. | | June | Contains the amount of the Employee Required Contribution for each month. If the same amount applies for all 12 calendar months, only the All 12 Months column contains the monthly amount. | | July | Contains the amount of the Employee Required Contribution for each month. If the same amount applies for all 12 calendar months, only the All 12 Months column contains the monthly amount. | | Aug | Contains the amount of the Employee Required Contribution for each month. If the same amount applies for all 12 calendar months, only the All 12 Months column contains the monthly amount. | | Sept | Contains the amount of the Employee Required Contribution for each month. If the same amount applies for all 12 calendar months, only the All 12 Months column contains the monthly amount. | | Oct | Contains the amount of the Employee Required Contribution for each month. If the same amount applies for all 12 calendar months, only the All 12 Months column contains the monthly amount. | | Nov | Contains the amount of the Employee Required Contribution for each month. If the same amount applies for all 12 calendar months, only the All 12 Months column contains the monthly amount. | | Dec | Contains the amount of the Employee Required Contribution for each month. If the same amount applies for all 12 calendar months, only the All 12 Months column contains the monthly amount. | ### Section 4980H Safe Harbor and Other Relief Table Contains codes from Code Series 2 for each calendar month. If the same code applies for all 12 calendar months, only the **All 12 Months** column contains the applicable code. | Month | Description | | :------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | All 12 Months | Contains codes from Code Series 2 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Jan | Contains codes from Code Series 2 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Feb | Contains codes from Code Series 2 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Mar | Contains codes from Code Series 2 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Apr | Contains codes from Code Series 2 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | May | Contains codes from Code Series 2 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | June | Contains codes from Code Series 2 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | July | Contains codes from Code Series 2 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Aug | Contains codes from Code Series 2 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Sept | Contains codes from Code Series 2 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Oct | Contains codes from Code Series 2 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Nov | Contains codes from Code Series 2 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Dec | Contains codes from Code Series 2 for each calendar month. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | ### ZIP Code Table Contains ZIP codes used to identify the lowest cost silver plan. If the same code applies for all 12 calendar months, only the **All 12 Months** column contains the applicable code. | Month | Description | | :------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | All 12 Months | Contains ZIP codes used to identify the lowest cost silver plan. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Jan | Contains ZIP codes used to identify the lowest cost silver plan. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Feb | Contains ZIP codes used to identify the lowest cost silver plan. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Mar | Contains ZIP codes used to identify the lowest cost silver plan. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Apr | Contains ZIP codes used to identify the lowest cost silver plan. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | May | Contains ZIP codes used to identify the lowest cost silver plan. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | June | Contains ZIP codes used to identify the lowest cost silver plan. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | July | Contains ZIP codes used to identify the lowest cost silver plan. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Aug | Contains ZIP codes used to identify the lowest cost silver plan. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Sept | Contains ZIP codes used to identify the lowest cost silver plan. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Oct | Contains ZIP codes used to identify the lowest cost silver plan. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Nov | Contains ZIP codes used to identify the lowest cost silver plan. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | | Dec | Contains ZIP codes used to identify the lowest cost silver plan. If the same code applies for all 12 calendar months, only the All 12 Months column contains the applicable code. | ## Part III - Self-Insured Coverage ### General Self-Insured Information | Field | Description | | :-------------------------------------- | :------------------------------------------------------------------------------------- | | Employer Provided Self-Insured Coverage | Indicates that the health insurance coverage offered by the employer was self-insured. | ### Covered Individuals Table | Field | Description | | :-------------------- | :----------------------------------------------------------------------------------------------------------------- | | Name | The name of each covered individual, including the employee, if the employee is enrolled in self-insured coverage. | | SSN or TIN | The Social Security Number (SSN) or Taxpayer Identification Number (TIN) for each covered individual. | | DOB | The date of birth (YYYY-MM-DD) for the covered individual. | | Covered All 12 Months | Indicates that the individual was covered for at least one day per month for all 12 months of the calendar year. | ### Monthly Coverage Details | Month | Description | | :---- | :---------------------------------------------------------------------------------------------------------------------- | | Jan | The month(s) in which the individual was covered for at least one day per month for all 12 months of the calendar year. | | Feb | The month(s) in which the individual was covered for at least one day per month for all 12 months of the calendar year. | | Mar | The month(s) in which the individual was covered for at least one day per month for all 12 months of the calendar year. | | Apr | The month(s) in which the individual was covered for at least one day per month for all 12 months of the calendar year. | | May | The month(s) in which the individual was covered for at least one day per month for all 12 months of the calendar year. | | June | The month(s) in which the individual was covered for at least one day per month for all 12 months of the calendar year. | | July | The month(s) in which the individual was covered for at least one day per month for all 12 months of the calendar year. | | Aug | The month(s) in which the individual was covered for at least one day per month for all 12 months of the calendar year. | | Sept | The month(s) in which the individual was covered for at least one day per month for all 12 months of the calendar year. | | Oct | The month(s) in which the individual was covered for at least one day per month for all 12 months of the calendar year. | | Nov | The month(s) in which the individual was covered for at least one day per month for all 12 months of the calendar year. | | Dec | The month(s) in which the individual was covered for at least one day per month for all 12 months of the calendar year. | ## Key Fields * Part I/Employee/Name of Employee * Part I/Employee/Social Security Number * Part I/Employer/Name of Employer * Part I/Employer/Employer Identification Number ## Validation Rules | Rule | Description | | :--------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Clean Name | Checks for unsupported characters such as \| and ] in name fields. It also cleans multiple spaces, tabs, and newlines. | | Clean Year | Checks the value in the **Year** field. It converts a 2-digit year (such as 24) into a 4-digit format (such as 2024). It assumes all 2-digit years are in the 2000s. | # Form 1095 Skills Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/1095-overview Process IRS Form 1095 health insurance forms — 1095-A (Marketplace), 1095-B (Health Coverage), 1095-C (Employer-Provided) — with Vantage built-in skills. Forms 1095 are IRS tax forms used to report health insurance coverage for the Affordable Care Act (ACA). ABBYY Vantage includes a built-in skill for each variant — 1095-A (Marketplace), 1095-B (Health Coverage), and 1095-C (Employer-Provided). ABBYY Vantage includes the following built-in skills for processing Forms 1095: * [Form 1095-A, Health Insurance Marketplace Statement](/vantage/documentation/skill-catalog/built-in-skills/form-skills/1095-a) * [Form 1095-B, Health Coverage](/vantage/documentation/skill-catalog/built-in-skills/form-skills/1095-b) * [Form 1095-C, Employer-Provided Health Insurance Offer and Coverage](/vantage/documentation/skill-catalog/built-in-skills/form-skills/1095-c) # Form 1098, Mortgage Interest Statement - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/1098 Extract data from IRS Form 1098 (Mortgage Interest Statement) — used by lenders to report mortgage interest of $600 or more paid during the tax year. The **Form 1098, Mortgage Interest Statement** skill extracts data from Forms 1098, which are used by businesses and lenders to report mortgage interest paid to them of \$600 or more. The Form 1098, Mortgage Interest Statement 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. This skill recognizes handwritten text. The option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields ### Basic Form Information | Field | Description | | :-------- | :------------------------------------------------------------------------------------- | | Void | Specifies that the processed form should be annulled. | | Corrected | Specifies that the processed form is being submitted to correct data provided earlier. | | Year | The reporting fiscal year. | ### Recipient Details | Field | Description | | :------- | :--------------------------------- | | Name | The name of the recipient. | | Street | The address of the recipient. | | City | The address of the recipient. | | State | The address of the recipient. | | ZIP Code | The address of the recipient. | | Country | The address of the recipient. | | Phone | The phone number of the recipient. | ### Tax Identification Numbers | Field | Description | | :-------------- | :----------------------------------------------------------------------- | | Recipient's TIN | The tax identification number assigned to the recipient of the payments. | | Payer's TIN | The tax identification number assigned to the payer. | ### Payer Details | Field | Description | | :------- | :------------------------ | | Name | The name of the payer. | | Street | The address of the payer. | | City | The address of the payer. | | State | The address of the payer. | | ZIP Code | The address of the payer. | | Country | The address of the payer. | ### Mortgage Information | Field | Description | | :------------------------------------ | :----------------------------------------------------------------------------- | | Account Number | The unique number used by the payer to identify the payment recipient. | | Mortgage Interest Received from Payer | The interest received on the mortgage from borrowers during the calendar year. | | Outstanding Mortgage Principal | The amount of outstanding principal on the mortgage. | | Mortgage Origination Date | The date of the origination of the mortgage. | | Mortgage Acquisition Date | The date of acquisition. | ### Payment Details | Field | Description | | :--------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------- | | Refund of Overpaid Interest | The total refund or credit of a prior year(s) overpayment of interest. | | Mortgage Insurance Premiums | An upfront and annual insurance premium that is required for any Federal Housing Administration (FHA) home loan, regardless of the size of the down payment. | | Points Paid on Purchase of Principal Residence | Points that are paid on the purchase of the payer of record's principal residence. | | Other | Other information, such as real estate taxes or insurance paid from escrow. | ### Property Information | Field | Description | | :------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Address of Property is the Same as Payer's Address | Specifies if the address of the property securing the mortgage is the same as the payer's address. | | Number of Properties Securing the Mortgage | If more than one property secures the loan, shows the number of properties securing the mortgage. If only one property secures the loan, this field may be blank. | ### Address of Property Securing Mortgage | Field | Description | | :------- | :------------------------------------------------- | | Street | The address of the property securing the mortgage. | | City | The address of the property securing the mortgage. | | State | The address of the property securing the mortgage. | | ZIP Code | The address of the property securing the mortgage. | | Country | The address of the property securing the mortgage. | ## Key Fields * Year * Recipient Details/Name * Recipient's TIN * Payer's TIN * Payer Details/Name * Account Number * Mortgage Interest Received from Payer * Mortgage Acquisition Date ## Validation Rules | Rule | Description | | :----------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Complete Form Year | Checks the value in the **Year** field. It removes any white spaces and converts a 2-digit year into a 4-digit format. If the last two digits are numeric and start with 9, it converts the value to the 1900's (for example, 99 converts to 1999). Otherwise, it assumes the date is from the 2000's (for example, 24 converts to 2024). | # Form 1099-B, Broker and Barter Exchange Proceeds Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-b Extract data from IRS Form 1099-B (Proceeds From Broker and Barter Exchange Transactions): broker-reported gains, losses, and securities for 2021-2023. The **Form 1099-B, Proceeds From Broker and Barter Exchange Transactions** skill extracts data from Forms 1099-B, which are filled in by brokers or barter exchanges to report gains or losses during a tax year. Forms 1099-B usually provide information about securities or property involved in a transaction handled by a broker. Individual taxpayers receive the form from their brokers or barter exchange already filled out and transfer the information to Form 8949 to calculate their preliminary gains and losses. The Form 1099-B, Proceeds From Broker and Barter Exchange Transactions skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing Forms 1099-B. For production use, you may need to uptrain the skill with your own document samples.
Code A (indicates a short-term transaction for which the cost or other basis is being reported to the IRS)
Code B (indicates a short-term transaction for which the cost or other basis is not being reported to the IRS)
Code D (indicates a long-term transaction for which the cost or other basis is being reported to the IRS)
Code E (indicates a long-term transaction for which the cost or other basis is not being reported to the IRS)
Code X (used if a transaction holding period is unknown). | ### Payer Details | Field | Description | | :------- | :--------------------------------------------------------------------------------- | | Name | The name, address, phone number, and tax identification number (TIN) of the payer. | | Street | The name, address, phone number, and tax identification number (TIN) of the payer. | | City | The name, address, phone number, and tax identification number (TIN) of the payer. | | State | The name, address, phone number, and tax identification number (TIN) of the payer. | | Country | The name, address, phone number, and tax identification number (TIN) of the payer. | | ZIP Code | The name, address, phone number, and tax identification number (TIN) of the payer. | | Phone | The name, address, phone number, and tax identification number (TIN) of the payer. | | TIN | The name, address, phone number, and tax identification number (TIN) of the payer. | ### Recipient Details | Field | Description | | :------- | :----------------------------------------------------------------------- | | Name | The name, address, and tax identification number (TIN) of the recipient. | | Street | The name, address, and tax identification number (TIN) of the recipient. | | City | The name, address, and tax identification number (TIN) of the recipient. | | State | The name, address, and tax identification number (TIN) of the recipient. | | Country | The name, address, and tax identification number (TIN) of the recipient. | | ZIP Code | The name, address, and tax identification number (TIN) of the recipient. | | TIN | The name, address, and tax identification number (TIN) of the recipient. | ### Account and Identification Information | Field | Description | | :----------------------- | :--------------------------------------------------------------------------------------------------------------------------------------- | | Account Number | The unique number used by the payer to identify the payment recipient. | | 2nd TIN Notified | Specifies whether the payer has been notified by the IRS twice within 3 calendar years that the TIN provided by the payer was incorrect. | | CUSIP Number | The unique identifier assigned to each security registered with the Committee on Uniform Securities Identification Procedures (CUSIP). | | FATCA Filing Requirement | Specifies that the Foreign Account Tax Compliance Act (FATCA) filing requirement is satisfied. | ### Transaction Details | Field | Description | | :---------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Description of Property | For stock and debt instruments, the description of shares or units that were exchanged. For stock, the class or classes of stock (for example, preferred, common, etc.) that were exchanged. For bartering transactions, the description of the service or property provided. | | Date Acquired | The acquisition date of any securities sold. | | Date Sold or Disposed | The trade date of the sale or exchange. | ### Financial Information | Field | Description | | :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Proceeds | The gross cash proceeds from all dispositions (including short sales) of securities, commodities, options, securities futures contracts, or forward contracts. | | Cost or Other Basis | The adjusted basis of any securities sold unless the security is not covered. | | Accrued Market Discount | The amount of accrued market discount. | | Wash Sale Loss Disallowed | Any loss disallowed if both the sale and purchase transactions occur in the same account with respect to covered securities with the same CUSIP number. | ### Gain/Loss Classification | Field | Description | | :---------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------- | | Short-term Gain or Loss | Specifies the profit or loss from the sale of a capital asset that was held for one year or less. | | Long-term Gain or Loss | Specifies the profit or loss from the sale of a capital asset that was held for more than one year before it was sold. | | Ordinary | Specifies that the gain or loss from the sale of a security or other asset is treated as ordinary income or loss, not as a capital gain or loss. | ### Proceeds From | Field | Description | | :----------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Collectibles | Specifies whether the proceeds are from a transaction involving collectibles. Possible values: Collectibles, QOF (disposition of an interest in a Quality and Outcomes Framework). | | QOF | Specifies that the transaction being reported is the disposition (for example, sale, exchange, or other transfer) of an investment in a Qualified Opportunity Fund. | ### Reported to IRS | Field | Description | | :------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Gross Proceeds | The total amount of money received from the sale of a security, commodity, or other property, before any commissions, fees, or other expenses have been deducted. | | Net Proceeds | The total proceeds from a sale after certain expenses, such as commissions and transfer taxes, have been subtracted. | ### Tax Withholding and Reporting | Field | Description | | :-------------------- | :---------------------------------------------------------------------- | | Loss Is Not Allowed | Specifies that the loss is not allowed based on the amount of proceeds. | | Basis Reported to IRS | Specifies whether the basis is reported to IRS. | ### Futures and Foreign Currency Contracts | Field | Description | | :---------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------ | | Profit or (Loss) realized on closed contracts (This Year) | The profit or (loss) realized by the payer on closed regulated futures or foreign currency during the current year. | | Unrealized Profit or (Loss) on Open Contracts (Year before) | The unrealized profit or (loss) on open regulated futures or foreign currency during the previous year. | | Unrealized Profit or (Loss) on Open Contracts (This Year) | The unrealized profit or (loss) on open regulated futures or foreign currency during the current year. | | Aggregate Profit or (Loss) on Contracts | The aggregate profit or (loss) for the year from regulated futures or foreign currency. | ### Bartering Transactions | Field | Description | | :-------- | :--------------------------------------------------------------------- | | Bartering | The gross amounts received by a member or client of a barter exchange. | ### State 1 Information | Field | Description | | :---------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | State Name | The information about filers who participate in the Combined Federal/State Filing Program and/or who are required to file paper copies of this form with a state tax department. | | State Identification No | The information about filers who participate in the Combined Federal/State Filing Program and/or who are required to file paper copies of this form with a state tax department. | | State Tax Withheld | The information about filers who participate in the Combined Federal/State Filing Program and/or who are required to file paper copies of this form with a state tax department. | ### State 2 Information | Field | Description | | :---------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | State Name | The information about filers who participate in the Combined Federal/State Filing Program and/or who are required to file paper copies of this form with a state tax department. | | State Identification No | The information about filers who participate in the Combined Federal/State Filing Program and/or who are required to file paper copies of this form with a state tax department. | | State Tax Withheld | The information about filers who participate in the Combined Federal/State Filing Program and/or who are required to file paper copies of this form with a state tax department. | ## Key Fields * Year * Payer Details/TIN * Recipient Details/Name * Recipient Details/TIN # Form 1099-C, Cancellation of Debt - Document Skill (Preview) Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-c Extract data from IRS Form 1099-C (Cancellation of Debt) reporting debts of $600 or more canceled by a lender, including borrower TIN and amount canceled. The Form 1099-C skill is currently available in Preview. The Form 1099-C, Cancellation of Debt skill extracts data from Forms 1099-С, which are used to report debts of \$600 or more canceled or forgiven by a lender (creditor). Forms 1099-C provide the following information: * Borrower's (debtor's) name, address, and taxpayer identification number (usually their Social Security number) * Amount of debt canceled and the date when it was canceled. The 1099-C, Cancellation of Debt skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing Forms 1099-C. For production use, you may need to uptrain the skill with your own document samples. This skill recognizes handwritten text. The option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields ### Basic Form Information | Field | Description | | :-------- | :--------------------------------------------------------------------------- | | Void | Specifies that the form is void. | | Corrected | Specifies that the form is being submitted to correct data provided earlier. | ### Creditor's Details | Field | Description | | :-------------- | :------------------------------------------------------------------------------------ | | Name | The name, address, phone number, and tax identification number (TIN) of the creditor. | | Street | The name, address, phone number, and tax identification number (TIN) of the creditor. | | City | The name, address, phone number, and tax identification number (TIN) of the creditor. | | State | The name, address, phone number, and tax identification number (TIN) of the creditor. | | ZIP Code | The name, address, phone number, and tax identification number (TIN) of the creditor. | | Country | The name, address, phone number, and tax identification number (TIN) of the creditor. | | Phone | The name, address, phone number, and tax identification number (TIN) of the creditor. | | Phone Extension | The name, address, phone number, and tax identification number (TIN) of the creditor. | | Creditor's TIN | The name, address, phone number, and tax identification number (TIN) | ### Debtor's Details | Field | Description | | :-------------- | :---------------------------------------------------------------------------------- | | Name | The name, address, phone number, and tax identification number (TIN) of the debtor. | | Address | The name, address, phone number, and tax identification number (TIN) of the debtor. | | Street | The name, address, phone number, and tax identification number (TIN) of the debtor. | | City | The name, address, phone number, and tax identification number (TIN) of the debtor. | | State | The name, address, phone number, and tax identification number (TIN) of the debtor. | | ZIP Code | The name, address, phone number, and tax identification number (TIN) of the debtor. | | Country | The name, address, phone number, and tax identification number (TIN) of the debtor. | | Phone | The name, address, phone number, and tax identification number (TIN) of the debtor. | | Phone Extension | The name, address, phone number, and tax identification number (TIN) of the debtor. | | Creditor's TIN | The name, address, phone number, and tax identification number (TIN) of the debtor. | ### Account and Identification Information | Field | Description | | :------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Account Number | The unique number used by the payer to identify the payment recipient. | | Date of Identifiable Event | The date of the earliest identifiable event or the date of the actual discharge, if it occurred before the earliest identifiable event. | | For Calendar Year | The calendar year for which the canceled debt is being reported. | | Amount of Debt Discharged | The total amount of debt that was canceled or forgiven by the creditor. | | Interest if Included in Box 2 | Any interest included in the canceled debt amount. | | Debt Description | A brief description of the type of debt that was canceled, such as credit card debt, mortgage debt, or student loan debt. | | Debtor Was Personally Liable for Repayment of Debt | Specifies whether the debtor was personally responsible for repaying the canceled debt. | | Identifiable Event Code | The code of the event that led to the debt cancelation.
Possible values:
- A (bankruptcy)
- B (other judicial debt relief)
- C (statute of limitations or expiration of deficiency period)
- D (foreclosure election)
- E (debt relief from probate or similar proceeding)
- F (by agreement)
- G (decision or policy to discontinue collection)
- H (other actual discharge before identifiable event) | | Fair Market Value | The fair market value of the property that was foreclosed or repossessed in connection with the canceled debt. | ## Key Fields * Creditor’s Details/Name * Creditor’s TIN * Debtor’s Details/Name * Debtor’s TIN * Account Number * Date of Identifiable Event * For Calendar Year * Amount of Debt Discharged * Identifiable Event Code ## Validation Rules | Rule | Description | | :------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Advanced Script Rule | Checks for a valid 4-digit year in the **For Calendar Year** field. If the value is a 2-digit year, it replaces the extracted value with a 4-digit year. If the two-digit year starts with a **9** (such as "98" or "99"), it assumes the century is the 1900s and prepends **19**. For any other digit (such as "07", "23", "25"), it assumes the century is the 2000s and prepends **20**.
For example:
If the input is CY 25, it becomes 2025.
If the input is Fiscal Year 98, it becomes 1998.
If the input is just 23, it becomes 2023. | # Form 1099 Composite - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-composite Extract data from Form 1099 Composite, a consolidated statement that summarizes 1099-DIV, 1099-INT, and 1099-B forms issued by financial institutions. The **Form 1099 Composite** skill extracts data from Forms 1099 Composite, which summarize all 1099 forms issued by a financial institution to a taxpayer. Typically, a Form 1099 Composite includes multiple 1099-DIV, 1099-INT, or 1099-B forms consolidated into a single statement. The document should provide a detailed breakdown of the totals for each type of 1099 form that the taxpayer is required to report. The Form 1099 Composite skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing Forms 1099 Composite. For production use, you may need to uptrain the skill with your own document samples. This skill recognizes handwritten text. The option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Basic Form Information | Field | Description | | :------------- | :---------------------------------------------------------------------------------------------- | | Year | The reporting fiscal year. | | Account | The unique number used by the taxpayer to identify the payment recipient. | | Corrected | Specifies that the processed form is being submitted to correct data provided earlier. | | Statement Date | The statement date. | | Document ID | The identifier that is assigned to each Form 1099 that is issued by the payer to the recipient. | ## Taxpayer Details | Field | Description | | :------------- | :---------------------- | | Name | The taxpayer's name. | | Street Address | The taxpayer's address. | | City | The taxpayer's address. | | State | The taxpayer's address. | | ZIP Code | The taxpayer's address. | | Country | The taxpayer's address. | | Phone | The taxpayer's phone. | | TIN | The taxpayer's TIN. | ## Recipient Details | Field | Description | | :------------- | :----------------------- | | Name | The recipient's name. | | Street Address | The recipient's address. | | City | The recipient's address. | | State | The recipient's address. | | ZIP Code | The recipient's address. | | Country | The recipient's address. | | TIN | The recipient's TIN. | ## FATCA Compliance | Field | Description | | :----------------------- | :--------------------------------------------------------------------------------------------- | | FATCA Filing Requirement | Specifies that the Foreign Account Tax Compliance Act (FATCA) filing requirement is satisfied. | ## Dividends and Distributions (1099-DIV) | Field | Description | | :------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Total Ordinary Dividends | The total amount of ordinary dividends (taxed as ordinary income). | | Qualified Dividends | The amount of ordinary dividends (box **1a Total Ordinary Dividends**) that meets the criteria for being taxed at a lower tax rate. | | Total Capital Gain Distributions | The total amount paid out as capital gain distribution. | | Unrecaptured Section 1250 Gain | The amount of capital gains (box **2a Total Capital Gain Distribution**) received from the sale of depreciated real property and taxed in accordance with Section 1250 of the United States Internal Revenue Code. | | Section 1202 Gain | The amount of capital gains (box **2a Total Capital Gain Distribution**) received from the sale of small business corporation stock qualifying for exclusion under section 1202 of the United States Internal Revenue Code. | | Collectibles (28%) Gain | A tax on certain types of gains from the sale of collectibles. | | Section 897 Ordinary Dividends | The amount of ordinary dividends (box **1a Total Ordinary Dividends**) received from the disposition of United States real property interest (USRPI) in accordance with section 897 of the United States Internal Revenue Code. | | Section 897 Capital Gain | The amount of capital gains (box **2a Total Capital Gain Distribution**) received from the disposition of United States real property interest (USRPI) in accordance with section 897 of the United States Internal Revenue Code. | | Nondividend Distributions | Payments that were not paid out as either dividends or capital gains distribution. | | Federal Income Tax Withheld | The total amount withheld as federal income tax. | | Section 199A Dividends | The amount of ordinary dividends (box **1a Total Ordinary Dividends**) either paid out by a real estate investment trust (REIT) and taxed at a lower rate, or by a regulated investment company (RIC) in accordance with section 199A of the United States Internal Revenue Code. | | Investment Expenses | The share of non-taxable expenses incurred by a regulated investment company (RIC), proportional to the payment share of the recipient. | | Foreign Tax Paid | The amount of taxes withheld in other countries on dividends and other payments (specified in USD). | | Foreign Country or US Possession | The name of the foreign country or United States Territory where the taxed amount specified in box 7 **Foreign Tax Paid** was withheld. | | Cash Liquidation Distributions | The amount paid out as part of a partial or full company liquidation. | | Noncash Liquidation Distributions | Non-cash assets transferred as part of a partial or full company liquidation (specified as the market value of the assets at the time of their distribution). | | Exempt-interest Dividends | Dividends received from mutual funds and/or another regulated investment company (RIC). These dividends are exempt from federal taxes. | | Specified Private Activity Bond Interest Dividends | Dividends received from mutual funds and/or another regulated investment company (RIC). These dividends are exempt from federal taxes. | ### State Information (1099-DIV) | Field | Description | | :-------------------------- | :---------------------------------- | | State | State-specific payment information. | | State Identification Number | State-specific payment information. | | State Tax Withheld | State-specific payment information. | ## Miscellaneous Income (1099-MISC) | Field | Description | | :--------------------------------------------------- | :----------------------------------------------------------------------------------------- | | Rents | The total amount of rent that was paid during the tax year. | | Royalties | The total amount of royalties that were paid during the tax year. | | Other Income | Any miscellaneous income that does not fit into one of the other categories on the form. | | Federal Income Tax Withheld | The amount of federal income tax that was withheld from payments made during the tax year. | | Substitute Payments in Lieu of Dividends or Interest | The amount of substitute payments in lieu of dividends or interest. | | State Tax Withheld | State-specific payment information. | | State Income | State-specific payment information. | ## Proceeds From Broker and Barter Exchange Transactions (1099-B) | Field | Description | | :---------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------- | | Proceeds | The total amount of money received from the sale or disposition of a security during the tax year. | | Cost or Other Basis of Covered Securities | The adjusted basis of the security delivered to close the short sale | | Accrued Market Discount | The amount of accrued market discount. | | Wash Sale Loss Disallowed | The amount of wash sale loss disallowed. | | Federal Income Tax Withheld | Backup withholding. | | Profit or (Loss) Realized on Closed Contracts | The profit or (loss) realized by the customer on closed regulated futures, foreign currency, or Section 1256 option contracts in 2023. | | Unrealized Profit or (Loss) on Open Contracts | The unrealized profit or (loss) on open regulated futures, foreign currency, or Section 1256 option contracts at the end of 2022. | | Unrealized Profit or (Loss) on Open Contracts 2 | The unrealized profit or (loss) on open regulated futures, foreign currency, or Section 1256 option contracts at the end of 2023. | | Aggregate Profit or (Loss) on Contracts | The aggregate profit or (loss) for the year from regulated futures, foreign currency, or Section 1256 option contracts. | ## Interest Income (1099-INT) | Field | Description | | :---------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------ | | Interest Income | Specifies the taxable interest on the tax return. | | Early Withdrawal Penalty | Represents any interest or principal forfeited because of early withdrawal of time savings. | | Interest on US Savings Bonds and Treasury Obligations | Specifies interest on U.S. Savings Bonds, Treasury bills, Treasury bonds, and Treasury notes. This may or may not all be taxable. | | Federal Income Tax Withheld | The total amount withheld as federal income tax. | | Investment Expenses | The share of non-taxable expenses incurred by a regulated investment company (RIC), proportional to the payment share of the recipient. | | Foreign Tax Paid | The amount of taxes withheld in other countries on dividends and other payments (specified in USD). | | Foreign Country or US Possession | The name of the foreign country or United States Territory where the taxed amount specified in the **Foreign Tax Paid** field was withheld. | | Tax-Exempt Interest (includes box 9) | The tax-exempt interest paid. | | Specified Private Activity Bond Interest | Specifies tax-exempt interest subject to the alternative minimum tax. This amount is included in the **Tax-exempt Interest** field. | | Market Discount | Specifies the market discount that accrued on the debt instrument during the year. | | Bond Premium | The bond premium amount for the year for covered taxable securities. | | Bond Premium on Treasury Obligations | The bond premium for the year for covered U.S. Treasury securities. | | Bond Premium on Tax-Exempt Bonds | The bond premium for the year for covered non-taxable securities. | | Tax-exempt and Tax Credit Bond CUSIP no | The CUSIP number of the tax-exempt bond for which tax-exempt interest is reported. | ### State Information (1099-INT) | Field | Description | | :-------------------------- | :---------------------------------- | | State | State-specific payment information. | | State Identification Number | State-specific payment information. | | State Tax Withheld | State-specific payment information. | ## Original Issue Discount (1099-OID) | Field | Description | | :----------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Original Issue Discount for the Year | The taxable OID on the obligation for the part of the year it was owned by the record holder. | | Acquisition Premium (Covered Lots) | The amount of the acquisition premium that applies to the specific covered lots of bonds that you acquired during the tax year. | | Acquisition Premium (Noncovered Lots) | The amount of the acquisition premium that applies to the specific non-covered lots of bonds that you acquired during the tax year. | | Original Issue Discount on Treasury Obligations | The taxable OID on the obligation for the part of the year it was owned by the record holder. | | Acquisition Premium Treasury Obligations (Covered Lots) | The acquisition premium paid for the specific covered lots of treasury obligations that you acquired during the tax year. | | Acquisition Premium Treasury Obligations (Noncovered Lots) | The acquisition premium paid for the non-covered lots of Treasury obligations that you acquired before the date that the IRS required brokers to start reporting the acquisition premium for these types of securities. | | Other Periodic Interest | Any amount of interest, other than OID, accrued to each REMIC or FASIT regular interest holder or paid to each CDO holder. | | Federal Income Tax Withheld | Backup withholding. | | Market Discount | The amount of market discount that accrued on the debt instrument during the tax year in the amount of \$10 or more. | | Acquisition Premium | The amount of premium amortization for the part of the year the debt instrument was owned by the holder. | | Original Issue Discount on US Treasury Obligations | The OID on a U.S. Treasury obligation for the part of the year it was owned by the record holder. | | Investment Expenses | The regular interest holder's pro rata share of investment expenses. | | Bond Premium | The amount of bond premium amortization allocable to the interest paid during the tax year | | Tax-Exempt OID | The OID for the part of the year it was owned by the record holder. | | Tax-Exempt OID (Lots Not Reported) | The tax-exempt OID income that was earned on the lots of the bond that were not reported to the broker by the investor. | | Acquisition Premium (Covered) | The amount paid by the investor for the bond in excess of its face value. | | Acquisition Premium (Lots Not Reported) | The acquisition premium paid for covered lots of the bond that were not reported to the broker by the investor. | | Tax-Exempt OID on Private Activity Bonds | Interest of \$10 or more from specified private activity bonds. | | Tax-Exempt OID on Private Activity Bonds (Lots Not Reported) | The amount of tax-exempt original issue discount (OID) income that was earned on covered lots of the private activity bond that were not reported to the broker by the investor. | | Acquisition Premium (AMT Covered) | The amount paid by the investor for the bond in excess of its face value, that is subject to the AMT calculation. | | Acquisition Premium (AMT Lots Not Reported) | The amount paid by the investor for the bond in excess of its face value, that is subject to the AMT calculation, for the lots of the bond that were not reported to the broker. | | Early Withdrawal Penalty | Interest or principal forfeited because of an early withdrawal of time deposits, such as an early withdrawal from a CD, that is deductible from gross income by the recipient. | | REMIC | The REMIC for the year | | State Tax Withheld | State withholding information related to the income. | ## Reconciliations, Fees, Expenses and Expenditures ### Other Receipts and Reconciliations | Field | Description | | :----------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Partnership Distributions | Any additional income or expenses that are not directly related to the partnership's primary business operations, as well as any adjustments made to partnership distributions. | | Foreign Tax Paid-Partnership | Any foreign tax payments made by the partnership during the reporting period. | | Return of Principal | Any returns of principal made to investors or lenders during the reporting period. | | Deferred Income Payment | Any income payments that are deferred to a future period. | | Deemed Premium | Any deemed premium payments made or received during the reporting period. | | Income Accrual- UIT | Any income that has been earned but not yet received during the reporting period. | | Basis Adjustments | Any adjustments made to the cost or basis of assets or liabilities during the reporting period. | | Foreign Tax Paid Beyond Treaty | Any foreign taxes paid by the entity that go beyond the tax treaty obligations between the foreign country and the entity's home country. | ### Fees and Expenses | Field | Description | | :---------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Margin Interest | The fees and expenses related to margin borrowing. | | Dividends Paid on Short Position | The dividends paid on the short position, any fees associated with borrowing the securities, and any other expenses related to the management of the short position. | | Interest Paid on Short Position | The interest paid on the borrowed securities, any fees associated with borrowing the securities, and any other expenses related to the management of the short position. | | Non Reportable Distribution Expense | Any expenses associated with the distribution of these non-reportable distributions, such as administrative expenses, distribution fees, or other expenses related to the management of these distributions. | | Other Expenses | Any expenses that do not fit into any of the other categories of fees and expenses. | | Severance Tax | Any expenses associated with the calculation and payment of severance taxes, such as administrative expenses, legal fees, and any other expenses related to the management of these taxes. | | Organizational Expense | Legal and accounting fees, incorporation fees, state filing fees, and other expenses related to the organizational process. | | Miscellaneous Fees | Any fees and expenses that are not directly related to the entity's core business operations or that do not fit into any of the other categories of fees and expenses. | | Tax-Exempt Investment Expense | Any expenses associated with managing tax-exempt investments, such as fees paid to investment managers or advisors, custodial fees, and other expenses related to the management of these investments. | ### Foreign Exchange | Field | Description | | :---------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Foreign Currency Gain or Loss | Any gains or losses resulting from foreign currency transactions, such as gains or losses from the purchase or sale of foreign currency or from the settlement of foreign currency-denominated transactions. | ## 1099-B Summary of Sale Proceeds (Line Items) | Field | Description | | :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Section | The section of the Internal Revenue Code (IRC) that applies to the transaction being reported on the form. | | Proceeds | The gross cash proceeds from all dispositions (including short sales) of securities, commodities, options, securities futures contracts, or forward contracts. | | Cost Basis | The adjusted basis of any securities sold unless the security is not a covered security | | Market Discount | The amount of accrued market discount. | | Wash Sale Loss Disallowed | The amount of wash sale loss disallowed. | | Net Gain or Loss | Determines whether the gain or loss is short-term or long-term under section 1222, and whether any portion of the gain or loss is ordinary. | ## Key Fields * Year * Account Number * Taxpayer Details/TIN * Recipient Details/Name * Recipient Details/TIN # Form 1099-DIV, Dividends and Distributions - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-div Extract data from IRS Form 1099-DIV (Dividends and Distributions), annual reports of dividend payments and income distributions from financial institutions. The **Form 1099-DIV, Dividends and Distributions** skill extracts data from Forms 1099-DIV, which are annual reports about income distribution and dividend payments. These forms are filled out by banks and other financial institutions and are provided to both the US Internal Revenue Service (IRS) and each recipient of such payments. A separate report has to be compiled for each such recipient. The Form 1099-DIV, Dividends and Distributions skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing Forms 1099-DIV. For production use, you may need to uptrain the skill with your own document samples. This skill recognizes handwritten text. The option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields ### Basic Form Information | Field | Description | | :-------- | :------------------------------------------------------------------------------------- | | Void | Specifies that the processed form should be annulled. | | Corrected | Specifies that the processed form is being submitted to correct data provided earlier. | | Year | The reporting fiscal year. | ### Payer Details | Field | Description | | :------- | :------------------------------------------------ | | Name | The name, address, and phone number of the payer. | | Street | The name, address, and phone number of the payer. | | City | The name, address, and phone number of the payer. | | State | The name, address, and phone number of the payer. | | ZIP Code | The name, address, and phone number of the payer. | | Country | The name, address, and phone number of the payer. | | Phone | The name, address, and phone number of the payer. | ### Tax Identification Numbers | Field | Description | | :-------------- | :----------------------------------------------------------------------- | | Payer's TIN | The tax identification number assigned to the payer. | | Recipient's TIN | The tax identification number assigned to the recipient of the payments. | ### Recipient Details | Field | Description | | :------- | :--------------------------------------------- | | Name | The name and address of the payment recipient. | | Street | The name and address of the payment recipient. | | City | The name and address of the payment recipient. | | State | The name and address of the payment recipient. | | ZIP Code | The name and address of the payment recipient. | | Country | The name and address of the payment recipient. | ### Account and Compliance Information | Field | Description | | :----------------------- | :--------------------------------------------------------------------------------------------- | | Account Number | The unique number used by the payer to identify the payment recipient. | | FATCA Filing Requirement | Specifies that the Foreign Account Tax Compliance Act (FATCA) filing requirement is satisfied. | ### Dividend and Distribution Information | Field | Description | | :------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Total Ordinary Dividends | The total amount of ordinary dividends (taxed as ordinary income). | | Qualified Dividends | The amount of ordinary dividends (box 1a **Total Ordinary Dividends**) that meets the criteria for being taxed at a lower tax rate. | | Total Capital Gain Distribution | The total amount paid out as capital gain distribution. | | Unrecaptured Section 1250 Gain | The amount of capital gains (box 2a **Total Capital Gain Distribution**) received from the sale of depreciated real property and taxed in accordance with Section 1250 of the United States Internal Revenue Code. | | Section 1202 Gain | The amount of capital gains (box 2a **Total Capital Gain Distribution**) received from the sale of small business corporation stock qualifying for exclusion under section 1202 of the United States Internal Revenue Code. | | Collectibles Gain | The amount of capital gains (box 2a **Total Capital Gain Distribution**) received from selling and/or trading collectibles (taxed at 28%). | | Section 897 Ordinary Dividends | The amount of ordinary dividends (box 1a **Total Ordinary Dividends**) received from the disposition of United States real property interest (USRPI) in accordance with section 897 of the United States Internal Revenue Code. | | Section 897 Capital Gain | The amount of capital gains (box 2a **Total Capital Gain Distribution**) received from the disposition of United States real property interest (USRPI) in accordance with section 897 of the United States Internal Revenue Code. | | Nondividend Distributions | Payments that were not paid out as either dividends or capital gains distribution. | ### Tax Withholding and Special Dividends | Field | Description | | :-------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Federal Income Tax Withheld | The total amount withheld as federal income tax. | | Section 199A Dividends | The amount of ordinary dividends (box 1a **Total Ordinary Dividends**) either paid out by a real estate investment trust (REIT) and taxed at a lower rate, or by a regulated investment company (RIC) in accordance with section 199A of the United States Internal Revenue Code. | | Investment Expenses | The share of non-taxable expenses incurred by a regulated investment company (RIC), proportional to the payment share of the recipient. | ### Foreign Tax Information | Field | Description | | :--------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------- | | Foreign Tax Paid | The amount of taxes withheld in other countries on dividends and other payments (specified in USD). | | Foreign Country or U.S. Possession | The name of the foreign country or United States Territory where the taxed amount specified in box 7 **Foreign Tax Paid** was withheld. | ### Liquidation Distributions | Field | Description | | :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Cash Liquidation Distributions | The amount paid out as part of a partial or full company liquidation. | | Noncash Liquidation Distributions | Non-cash assets transferred as part of a partial or full company liquidation (specified as the market value of the assets at the time of their distribution). | ### Tax-Exempt Dividends | Field | Description | | :------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------- | | Exempt-interest Dividends | Dividends received from mutual funds and/or another regulated investment company (RIC). These dividends are exempt from federal taxes. | | Specified Private Activity Bond Interest Dividends | Dividends received from mutual funds and/or another regulated investment company (RIC). These dividends are exempt from federal taxes. | ### State Tax Information | Field | Description | | :---------------------------- | :---------------------------------- | | State 1 | State-specific payment information. | | State 2 | State-specific payment information. | | State Identification Number 1 | State-specific payment information. | | State Identification Number 2 | State-specific payment information. | | State Tax Withheld 1 | State-specific payment information. | | State Tax Withheld 2 | State-specific payment information. | ## Key Fields * Year * Payer Details/Name * Payer's TIN * Recipient's TIN * Recipient Details/Name * Account Number * Total Ordinary Dividends * Qualified Dividends ## Validation Rules | Rule | Description | | :----------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Complete Form Year | Checks the value in the **Year** field. It removes any white spaces and converts a 2-digit year into a 4-digit format. If the last two digits are numeric and start with 9, it converts the value to the 1900's (for example, 99 converts to 1999). Otherwise, it assumes the date is from the 2000's (for example, 24 converts to 2024). | # Form 1099-G, Certain Government Payments - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-g Extract data from IRS Form 1099-G (Certain Government Payments): federal, state, and local government payments such as unemployment, refunds, and CCC loans. The **Form 1099-G, Certain Government Payments** skill extracts data from Forms 1099-G, which are annual reports about various payments carried out by federal, regional, and municipal government agencies. This report is provided to both the US Internal Revenue Service (IRS) and each recipient of such payments. The agency has to compile a separate report for each such recipient. This form is also filled out by government agencies when they receive payments for loans provided by the Commodity Credit Corporation (CCC). The Form 1099-G, Certain Government Payments skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing Forms 1099-G. For production use, you may need to uptrain the skill with your own document samples. This skill recognizes handwritten text. The option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields ### Basic Form Information | Field | Description | | :-------- | :------------------------------------------------------------------------------------- | | Void | Specifies that the processed form should be annulled. | | Corrected | Specifies that the processed form is being submitted to correct data provided earlier. | | Year | The reporting fiscal year. | ### Payer Details | Field | Description | | :------- | :------------------------------------------------ | | Name | The name, address, and phone number of the payer. | | Street | The name, address, and phone number of the payer. | | City | The name, address, and phone number of the payer. | | State | The name, address, and phone number of the payer. | | ZIP Code | The name, address, and phone number of the payer. | | Country | The name, address, and phone number of the payer. | | Phone | The name, address, and phone number of the payer. | ### Tax Identification Numbers | Field | Description | | :-------------- | :----------------------------------------------------------------------- | | Payer's TIN | The tax identification number assigned to the payer. | | Recipient's TIN | The tax identification number assigned to the recipient of the payments. | ### Recipient Details | Field | Description | | :------- | :--------------------------------------------- | | Name | The name and address of the payment recipient. | | Street | The name and address of the payment recipient. | | City | The name and address of the payment recipient. | | State | The name and address of the payment recipient. | | ZIP Code | The name and address of the payment recipient. | | Country | The name and address of the payment recipient. | ### Account Information | Field | Description | | :------------- | :--------------------------------------------------------------------- | | Account Number | The unique number used by the payer to identify the payment recipient. | ### Government Payment Information | Field | Description | | :---------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Unemployment Compensation | The total amount of unemployment compensation payments paid out to the recipient before tax. | | State or Local Income Tax Refunds, Credits or Offsets | The total amount of all payments paid out as part of taxable refunds, credits, or offsets of state or local income taxes. | | Box 2 Amount is for Tax Year | Specifies the fiscal year for which the payments listed in field 2 were made. This field is filled in only if this fiscal year is different from the reporting fiscal year. | | Federal Income Tax Withheld | The total amount withheld as federal income tax. | | RTAA Payments | The total amount of all payments carried out as part of the Reemployment Trade Adjustment Assistance (RTAA) program (only if at least 600 USD in total). | | Taxable Grants | The total amount of taxable grants provided. | | Agriculture Payments | The total amount of agriculture payments provided. | | Box 2 is Trade or Business Income | Specifies that the payments listed in field 2 occurred as a result of trade or business income. | | Market Gain | Payments received by the government agency for loans given out by the Commodity Credit Corporation (CCC). | ### State Tax Information | Field | Description | | :---------------------------- | :---------------------------------- | | State 1 | State-specific payment information. | | State 2 | State-specific payment information. | | State Identification Number 1 | State-specific payment information. | | State Identification Number 2 | State-specific payment information. | | State Income Tax Withheld 1 | State-specific payment information. | | State Income Tax Withheld 2 | State-specific payment information. | ## Key Fields * Year * Payer Details/Name * Payer's TIN * Recipient's TIN * Recipient Details/Name * Account Number * Unemployment Compensation * State or Local Income Tax Refunds, Credits or Offsets ## Validation Rules | Rule | Description | | :----------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Complete Form Year | Checks the value in the **Year** field. It removes any white spaces and converts a 2-digit year into a 4-digit format. If the last two digits are numeric and start with 9, it converts the value to the 1900's (for example, 99 converts to 1999). Otherwise, it assumes the date is from the 2000's (for example, 24 converts to 2024). | # Form 1099-INT, Interest Income - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-int Extract data from IRS Form 1099-INT (Interest Income), reporting interest paid in a trade or business, including covered and non-covered securities. The **Form 1099-INT, Interest Income** skill extracts data from Forms 1099-INT, which are used to report interest paid in the course of a trade or business. For interest related to securities transactions, the information provided may be different for covered or non-covered transactions: * For covered securities that were acquired at a discount or premium, the payer must either report the net interest amount or separately report the market discount and premium amortization amounts on the Form 1099-INT. * For non-covered securities, the payer is not required to provide information to the taxpayer on any discount or premium. Also, it is solely the responsibility of the taxpayer to account for those amounts on their tax return. The Form 1099-INT, Interest Income skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing Forms 1099-INT. For production use, you may need to uptrain the skill with your own document samples. The Form 1099-INT, Interest Income skill recognizes handwritten text. The option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields ### Basic Form Information | Field | Description | | :-------- | :------------------------------------------------------------------------------------- | | Void | Specifies that the processed form should be annulled. | | Corrected | Specifies that the processed form is being submitted to correct data provided earlier. | | Year | The reporting fiscal year. | ### Payer Details | Field | Description | | :------- | :------------------------------------------------ | | Name | The name, address, and phone number of the payer. | | Street | The name, address, and phone number of the payer. | | City | The name, address, and phone number of the payer. | | State | The name, address, and phone number of the payer. | | ZIP Code | The name, address, and phone number of the payer. | | Country | The name, address, and phone number of the payer. | | Phone | The name, address, and phone number of the payer. | ### Tax Identification Numbers | Field | Description | | :-------------- | :---------------------------------------------------------------------------------- | | Payer's TIN | The tax identification number assigned to the taxpayer. | | Recipient's TIN | The tax identification number assigned to the recipient of the taxpayer's payments. | ### Recipient Details | Field | Description | | :------- | :--------------------------------------------- | | Name | The name and address of the payment recipient. | | Street | The name and address of the payment recipient. | | City | The name and address of the payment recipient. | | State | The name and address of the payment recipient. | | ZIP Code | The name and address of the payment recipient. | | Country | The name and address of the payment recipient. | ### Account and Routing Information | Field | Description | | :----------------------- | :--------------------------------------------------------------------------------------------- | | Account Number | The unique number used by the taxpayer to identify the payment recipient. | | FATCA Filing Requirement | Specifies that the Foreign Account Tax Compliance Act (FATCA) filing requirement is satisfied. | | Payer's RTN | Routing and transit number of the payer. | ### Interest Income Information | Field | Description | | :------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------- | | Interest Income | Specifies the taxable interest on the tax return. | | Early Withdrawal Penalty | Represents any interest or principal forfeited because of early withdrawal of time savings. | | Interest on U.S. Savings Bonds and Treasury Obligations | Specifies interest on U.S. Savings Bonds, Treasury bills, Treasury bonds, and Treasury notes. This may or may not all be taxable. | | Federal Income Tax Withheld | The total amount withheld as federal income tax. | | Investment Expenses | The share of non-taxable expenses incurred by a regulated investment company (RIC), proportional to the payment share of the recipient. | ### Foreign Tax Information | Field | Description | | :--------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------ | | Foreign Tax Paid | The amount of taxes withheld in other countries on dividends and other payments (specified in USD). | | Foreign Country or U.S. Possession | The name of the foreign country or United States Territory where the taxed amount specified in the **Foreign Tax Paid** field was withheld. | ### Tax-Exempt Interest | Field | Description | | :--------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------- | | Tax-exempt Interest | The tax-exempt interest paid. | | Specified Private Activity Bond Interest | Specifies tax-exempt interest subject to the alternative minimum tax. This amount is included in the **Tax-exempt Interest** field. | ### Market Discount and Bond Premium | Field | Description | | :----------------------------------- | :--------------------------------------------------------------------------------- | | Market Discount | Specifies the market discount that accrued on the debt instrument during the year. | | Bond Premium | The bond premium amount for the year for covered taxable securities. | | Bond Premium on Treasury Obligations | The bond premium for the year for covered U.S. Treasury securities. | | Bond Premium on Tax-exempt Bond | The bond premium for the year for covered non-taxable securities. | ### CUSIP Information | Field | Description | | :------------------------------------------ | :--------------------------------------------------------------------------------- | | Tax-exempt and Tax Credit Bond CUSIP Number | The CUSIP number of the tax-exempt bond for which tax-exempt interest is reported. | ### State Tax Information | Field | Description | | :---------------------------- | :---------------------------------- | | State 1 | State-specific payment information. | | State 2 | State-specific payment information. | | State Identification Number 1 | State-specific payment information. | | State Identification Number 2 | State-specific payment information. | | State Tax Withheld 1 | State-specific payment information. | | State Tax Withheld 2 | State-specific payment information. | ## Key Fields * Year * Payer Details/Name * Payer's TIN * Recipient's TIN * Recipient Details/Name * Account Number * Payer's RTN * Interest Income * Early Withdrawal Penalty ## Validation Rules | Rule | Description | | :----------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Complete Form Year | Checks the value in the **Year** field. It removes any white spaces and converts a 2-digit year into a 4-digit format. If the last two digits are numeric and start with 9, it converts the value to the 1900's (for example, 99 converts to 1999). Otherwise, it assumes the date is from the 2000's (for example, 24 converts to 2024). | # Form 1099-K, Payment Card and Third Party Networks Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-k Extract data from IRS Form 1099-K (Payment Card and Third Party Network Transactions): payments processed by online platforms, apps, and card processors. The **Form 1099-K, Payment Card and Third Party Network Transactions** skill extracts data from Forms 1099-K, which are used to report payments and transactions from payment settlement entities (PSE), that is online platforms, applications or payment card processors. The Form 1099-K, Payment Card and Third Party Network Transactions skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing Forms 1099-K. For production use, you may need to uptrain the skill with your own document samples. This skill recognizes handwritten text. The option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields ### Basic Form Information | Field | Description | | :-------- | :------------------------------------------------------------------------------ | | Void | Indicates whether the form should be annulled. | | Corrected | Indicates whether the form is being submitted to correct data provided earlier. | | Year | The reporting calendar year. | ### Filer Details | Field | Description | | :------- | :------------------------------------------------ | | Name | The name, address, and phone number of the filer. | | Street | The name, address, and phone number of the filer. | | City | The name, address, and phone number of the filer. | | State | The name, address, and phone number of the filer. | | ZIP Code | The name, address, and phone number of the filer. | | Country | The name, address, and phone number of the filer. | | Phone | The name, address, and phone number of the filer. | ### Tax Identification Numbers | Field | Description | | :---------- | :--------------------------------------------------- | | Filer's TIN | The tax identification number assigned to the filer. | | Payee's TIN | The tax identification number assigned to the payee. | ### Payee Details | Field | Description | | :------- | :--------------------------------------------- | | Name | The name and address of the payment recipient. | | Street | The name and address of the payment recipient. | | City | The name and address of the payment recipient. | | State | The name and address of the payment recipient. | | ZIP Code | The name and address of the payment recipient. | | Country | The name and address of the payment recipient. | ### Filer Classification | Field | Description | | :-------------------------------------------------------- | :------------------------------------------------------------------------------------------- | | Payment Settlement Entity (PSE) | Indicates whether the filer is a payment settlement entity (PSE). | | Electronic Payment Facilitator (EPF) or Other Third Party | Indicates whether the filer is an electronic payment facilitator (EPF) or other third party. | ### Transaction Type | Field | Description | | :------------------ | :----------------------------------------------------------------------------------------------------------- | | Payment Card | Indicates whether the transactions being reported for the payee were made through payment card transactions. | | Third Party Network | Indicates whether the transactions being reported for the payee were made through a third-party network. | ### PSE Details | Field | Description | | :---- | :------------------------------------------------ | | Name | The name of the payment settlement entity (PSE). | | Phone | The phone of the payment settlement entity (PSE). | ### Account and Transaction Information | Field | Description | | :--------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Account Number | The unique number used by the taxpayer to identify the payment recipient. | | Gross Amount of Payment Card or Third Party Network Transactions | The total amount of all reportable payment card and third party network transactions for the calendar year. | | Card Not Present Transactions | The gross amount of all reportable payment card and third-party network transactions for the calendar year where either the card was not present at the time of the transaction or the card number was keyed into the terminal. | | Merchant Category Code | The four-digit merchant category code (MCC) used by the payment card industry to classify the payee for the payment card transactions reported on this form. | | Number of Payment Transactions | The number of payment transactions (not including refund transactions) processed through the payment card or third-party payer network. | | Federal Income Tax Withheld | The total amount withheld as federal income tax. | ### Monthly Transaction Breakdown | Month | Description | | :-------- | :------------------------------------------------------------------------------------------- | | January | The gross amount of all reportable payment transactions for each month of the calendar year. | | February | The gross amount of all reportable payment transactions for each month of the calendar year. | | March | The gross amount of all reportable payment transactions for each month of the calendar year. | | April | The gross amount of all reportable payment transactions for each month of the calendar year. | | May | The gross amount of all reportable payment transactions for each month of the calendar year. | | June | The gross amount of all reportable payment transactions for each month of the calendar year. | | July | The gross amount of all reportable payment transactions for each month of the calendar year. | | August | The gross amount of all reportable payment transactions for each month of the calendar year. | | September | The gross amount of all reportable payment transactions for each month of the calendar year. | | October | The gross amount of all reportable payment transactions for each month of the calendar year. | | November | The gross amount of all reportable payment transactions for each month of the calendar year. | | December | The gross amount of all reportable payment transactions for each month of the calendar year. | ### State Tax Information | Field | Description | | :---------------------------- | :---------------------------------- | | State 1 | State-specific payment information. | | State 2 | State-specific payment information. | | State Identification Number 1 | State-specific payment information. | | State Identification Number 2 | State-specific payment information. | | State Tax Withheld 1 | State-specific payment information. | | State Tax Withheld 2 | State-specific payment information. | ## Key Fields * Year * Filer Details/Name * Filer's TIN * Payee's TIN * Payee Details/Name * Account Number * Gross Amount of Payment Card or Third Party Network Transactions ## Validation Rules | Rule | Description | | :----------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Complete Form Year | Checks the value in the **Year** field. It removes any white spaces and converts a 2-digit year into a 4-digit format. If the last two digits are numeric and start with 9, it converts the value to the 1900's (for example, 99 converts to 1999). Otherwise, it assumes the date is from the 2000's (for example, 24 converts to 2024). | # Form 1099-MISC, Miscellaneous Income - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-misc Extract data from IRS Form 1099-MISC (Miscellaneous Income) — reports rents, royalties, prizes, medical payments, and other income payments of $600 or more. The **Form 1099-MISC, Miscellaneous Income** skill extracts data from Forms 1099-MISC, which are filed for each person to whom a payer has paid during the year: * At least \$10 in royalties or broker payments in lieu of dividends or tax-exempt interest. * At least \$600 in: * Rents. * Prizes and awards. * Other income payments. * Medical and health care payments. * Crop insurance proceeds. * Cash payments for fish (or other aquatic life) purchased from anyone engaged in the trade or business of catching fish. * Generally, the cash paid from a notional principal contract to an individual, partnership, or estate. * Payments to an attorney. * Any fishing boat proceeds. In addition, Forms 1099-MISC are used to report that a person has made direct sales of at least \$5,000 of consumer products to a buyer for resale anywhere other than a permanent retail establishment. The Form 1099-MISC, Miscellaneous Income skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing Forms 1099-MISC. For production use, you may need to uptrain the skill with your own document samples. This skill recognizes handwritten text. The option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields ### Basic Form Information | Field | Description | | :-------- | :------------------------------------------------------------------------------ | | Void | Indicates whether the form should be annulled. | | Corrected | Indicates whether the form is being submitted to correct data provided earlier. | | Year | The reporting fiscal year. | ### Payer Details | Field | Description | | :------- | :------------------------------------------------ | | Name | The name, address, and phone number of the payer. | | Street | The name, address, and phone number of the payer. | | City | The name, address, and phone number of the payer. | | State | The name, address, and phone number of the payer. | | ZIP Code | The name, address, and phone number of the payer. | | Country | The name, address, and phone number of the payer. | | Phone | The name, address, and phone number of the payer. | ### Tax Identification Numbers | Field | Description | | :-------------- | :------------------------------------------------------------------------------- | | Payer's TIN | The tax identification number assigned to the payer. | | Recipient's TIN | The tax identification number assigned to the recipient of the payer's payments. | ### Recipient Details | Field | Description | | :------- | :--------------------------------------------- | | Name | The name and address of the payment recipient. | | Street | The name and address of the payment recipient. | | City | The name and address of the payment recipient. | | State | The name and address of the payment recipient. | | ZIP Code | The name and address of the payment recipient. | | Country | The name and address of the payment recipient. | ### Account Information | Field | Description | | :----------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------- | | Account Number | The unique number used by the payer to identify the payment recipient. | | FATCA Filing Requirement | Specifies that the Foreign Account Tax Compliance Act (FATCA) filing requirement is satisfied. | | 2nd TIN Notice | Specifies that the IRS has notified the payer twice within three calendar years that the payee provided an incorrect Taxpayer Identification Number (TIN). | ### Income Categories | Field | Description | | :--------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Rents | Amounts of \$600 or more for all types of rents. | | Royalties | Gross royalty payments (or similar amounts) of \$10 or more. | | Other Income | Other income of \$600 or more required to be reported on Form 1099-MISC that is not reportable in any of the other boxes on the form. | | Federal Income Tax Withheld | The total amount withheld as federal income tax. | | Fishing Boat Proceeds | The individual's share of all proceeds from the sale of a catch or the FMV of a distribution in kind to each crew member of fishing boats with normally fewer than 10 crew members. | | Medical and Health Care Payments | Payments of \$600 or more made in the course of person's trade or business to each physician or other supplier or provider of medical or health care services. | | Nonemployee Compensation | Nonemployee compensation. | | Payer Made Direct Sales | Specifies that the payer has made direct sales totaling \$5000 or more of consumer products to the recipient for resale. | | Substitute Payments in lieu of Dividends or Interest | Aggregate payments of at least \$10 of substitute payments received by a broker for a customer in lieu of dividends or tax-exempt interest as a result of a loan of a customer's securities. | | Crop Insurance Proceeds | Crop insurance proceeds of \$600 or more paid to farmers by insurance companies (unless the farmer has informed the insurance company that expenses have been capitalized under section 278, 263A, or 447). | | Gross Proceeds Paid to an Attorney | Gross proceeds of \$600 or more paid to an attorney in connection with legal services. | | Fish Purchased for Resale | The total cash payments of \$600 or more paid during the year to any person who is engaged in the trade or business of catching fish. | ### Deferred Compensation and Special Payments | Field | Description | | :--------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Section 409A Deferrals | The total amount deferred during the year of at least \$600 for a nonemployee under all nonqualified plans. | | Section 409A Income | Income as a nonemployee under an NQDC plan that does not meet the requirements of section 409A | | Excess Golden Parachute Payments | Any excess golden parachute payments. | | Nonqualified Deferred Compensation | All amounts deferred (including earnings on amounts deferred) that are includible in income under section 409A because the NQDC plan fails to satisfy the requirements of section 409A. | ### State Tax Information | Field | Description | | :------------------------------ | :---------------------------------- | | State Tax Withheld 1 | State-specific payment information. | | State Tax Withheld 2 | State-specific payment information. | | State or Payer's State Number 1 | State-specific payment information. | | State or Payer's State Number 2 | State-specific payment information. | | State Income 1 | State-specific payment information. | | State Income 2 | State-specific payment information. | ## Key Fields * Year * Payer Details/Name * Payer's TIN * Recipient's TIN * Recipient Details/Name * Account Number * Rents * Royalties * Other Income * Federal Income Tax Withheld ## Validation Rules | Rule | Description | | :----------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Complete Form Year | Checks the value in the **Year** field. It removes any white spaces and converts a 2-digit year into a 4-digit format. If the last two digits are numeric and start with 9, it converts the value to the 1900's (for example, 99 converts to 1999). Otherwise, it assumes the date is from the 2000's (for example, 24 converts to 2024). | # Form 1099-NEC, Nonemployee Compensation - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-nec Extract data from IRS Form 1099-NEC (Nonemployee Compensation): payments of $600 or more to non-employees such as independent contractors and freelancers. The **Form 1099-NEC, Nonemployee Compensation** skill extracts data from Forms 1099-NEC, which are annual reports about payments carried out by a taxpayer to non-employees. This report is provided to both the US Internal Revenue Service (IRS) and each recipient of such payments. The taxpayer has to compile a separate report for each such non-employee receiving payments from the taxpayer of at least 600 USD during the reporting year. The Form 1099-NEC, Nonemployee Compensation skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing Forms 1099-NEC. For production use, you may need to uptrain the skill with your own document samples. This skill recognizes handwritten text. The option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields ### Basic Form Information | Field | Description | | :-------- | :------------------------------------------------------------------------------------- | | Void | Specifies that the processed form should be annulled. | | Corrected | Specifies that the processed form is being submitted to correct data provided earlier. | | Year | The reporting fiscal year. | ### Payer Details | Field | Description | | :------- | :------------------------------------------------ | | Name | The name, address, and phone number of the payer. | | Street | The name, address, and phone number of the payer. | | City | The name, address, and phone number of the payer. | | State | The name, address, and phone number of the payer. | | ZIP Code | The name, address, and phone number of the payer. | | Country | The name, address, and phone number of the payer. | | Phone | The name, address, and phone number of the payer. | ### Tax Identification Numbers | Field | Description | | :-------------- | :---------------------------------------------------------------------------------- | | Payer's TIN | The tax identification number assigned to the taxpayer. | | Recipient's TIN | The tax identification number assigned to the recipient of the taxpayer's payments. | ### Recipient Details | Field | Description | | :------- | :--------------------------------------------- | | Name | The name and address of the payment recipient. | | Street | The name and address of the payment recipient. | | City | The name and address of the payment recipient. | | State | The name and address of the payment recipient. | | ZIP Code | The name and address of the payment recipient. | | Country | The name and address of the payment recipient. | ### Account and Payment Information | Field | Description | | :----------------------------------------------- | :------------------------------------------------------------------------- | | Account Number | The unique number used by the taxpayer to identify the payment recipient. | | Nonemployee Compensation | The total amount received by the payment recipient from the taxpayer. | | Payer Made Direct Sales Totalling \$5000 or More | Specifies that the taxpayer made direct sales totalling at least 5000 USD. | | Federal Income Tax Withheld | The total amount withheld as federal income tax. | ### State Tax Information | Field | Description | | :--------------------------- | :---------------------------------- | | State Tax Withheld 1 | State-specific payment information. | | State Tax Withheld 2 | State-specific payment information. | | State/Payer's State Number 1 | State-specific payment information. | | State/Payer's State Number 2 | State-specific payment information. | | State Income 1 | State-specific payment information. | | State Income 2 | State-specific payment information. | ## Key Fields * Year * Payer Details/Name * Payer's TIN * Recipient's TIN * Recipient Details/Name * Account Number * Nonemployee Compensation ## Validation Rules | Rule | Description | | :----------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Complete Form Year | Checks the value in the **Year** field. It removes any white spaces and converts a 2-digit year into a 4-digit format. If the last two digits are numeric and start with 9, it converts the value to the 1900's (for example, 99 converts to 1999). Otherwise, it assumes the date is from the 2000's (for example, 24 converts to 2024). | # Form 1099-OID, Original Issue Discount - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-oid Extract data from IRS Form 1099-OID (Original Issue Discount): OID income from debt instruments such as bonds and notes sold at a discount from maturity. The **Form 1099-OID, Original Issue Discount** skill extracts data from Forms 1099-OID, which are used to report original issue discount (OID) on certain debt instruments sold at a discount from their maturity value. This form is usually filled out by the issuer of a debt instrument (payer), such as a bond or note, for the purpose of providing it to the holder of the debt instrument (recipient). The Form 1099-OID, Original Issue Discount skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing Forms 1099-OID. For production use, you may need to uptrain the skill with your own document samples. This skill recognizes handwritten text. The option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields ### Basic Form Information | Field | Description | | :-------- | :------------------------------------------------------------------------------------- | | Void | Specifies that the processed form should be annulled. | | Corrected | Specifies that the processed form is being submitted to correct data provided earlier. | | Year | The reporting fiscal year. | ### Payer Details | Field | Description | | :------- | :------------------------------------------------ | | Name | The name, address, and phone number of the payer. | | Street | The name, address, and phone number of the payer. | | City | The name, address, and phone number of the payer. | | State | The name, address, and phone number of the payer. | | ZIP Code | The name, address, and phone number of the payer. | | Country | The name, address, and phone number of the payer. | | Phone | The name, address, and phone number of the payer. | ### Tax Identification Numbers | Field | Description | | :-------------- | :------------------------------------------------------- | | Payer's TIN | The tax identification number assigned to the payer. | | Recipient's TIN | The tax identification number assigned to the recipient. | ### Recipient Details | Field | Description | | :------- | :------------------------------------- | | Name | The name and address of the recipient. | | Street | The name and address of the recipient. | | City | The name and address of the recipient. | | State | The name and address of the recipient. | | ZIP Code | The name and address of the recipient. | | Country | The name and address of the recipient. | ### Account and Compliance Information | Field | Description | | :----------------------- | :--------------------------------------------------------------------------------------------- | | Account Number | The unique number used by the payer to identify the recipient. | | FATCA Filing Requirement | Specifies that the Foreign Account Tax Compliance Act (FATCA) filing requirement is satisfied. | ### Original Issue Discount Information | Field | Description | | :------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------- | | Original Issue Discount for the Year | The taxable OID on the obligation for the part of the year during which it was owned by the payer. | | Other Periodic Interest | The qualified stated interest on the obligation for the year, which is an amount separate from the OID. | | Early Withdrawal Penalty | Interest or principal forfeited if the payer withdrew the money before the maturity date of the obligation. | | Federal Income Tax Withheld | Backup withholding. | | Market Discount | The amount of market discount that accrued on the debt instrument during the tax year in the amount of \$10 or more. | | Acquisition Premium | The amount of acquisition premium amortization for the year that reduces the amount of OID that is included as interest on payer's income tax return. | | Description | The identification (CUSIP) number or description of the obligation (may include the stock exchange, issuer, coupon rate, and year of maturity). | | Original Issue Discount on US Treasury Obligations | OID on a U.S. Treasury obligation for the part of the year during which it was owned by the payer. | | Investment Expenses | The share of non-taxable expenses incurred by a regulated investment company (RIC), proportional to the payment share of the recipient. | | Bond Premium | The bond premium amount for the year for covered taxable securities. | | Tax-exempt OID | The OID for the part of the year during which it was owned by the payer. | ### State Tax Information | Field | Description | | :---------------------------- | :---------------------------------- | | State 1 | State-specific payment information. | | State 2 | State-specific payment information. | | State Identification Number 1 | State-specific payment information. | | State Identification Number 2 | State-specific payment information. | | State Tax Withheld 1 | State-specific payment information. | | State Tax Withheld 2 | State-specific payment information. | ## Key Fields * Year * Payer Details/Name * Payer's TIN * Recipient's TIN * Recipient Details/Name * Account Number * Original Issue Discount for the Year ## Validation Rules | Rule | Description | | :----------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Complete Form Year | Checks the value in the **Year** field. It removes any white spaces and converts a 2-digit year into a 4-digit format. If the last two digits are numeric and start with 9, it converts the value to the 1900's (for example, 99 converts to 1999). Otherwise, it assumes the date is from the 2000's (for example, 24 converts to 2024). | # Form 1099 Skills Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-overview Process IRS Form 1099 income reporting forms — 1099-B, 1099-C, 1099 Composite, 1099-DIV, 1099-G, 1099-INT, 1099-K, 1099-MISC, 1099-NEC, 1099-OID, 1099-R. Forms 1099 are tax forms used to report various types of income other than salaries, wages, and tips. ABBYY Vantage includes the following built-in skills for processing Forms 1099: ## Available Form 1099 Skills * [Form 1099-B, Proceeds From Broker and Barter Exchange Transactions](/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-b) * [Form 1099-C, Cancellation of Debt](/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-c) * [Form 1099 Composite](/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-composite) * [Form 1099-DIV, Dividends and Distributions](/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-div) * [Form 1099-G, Certain Government Payments](/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-g) * [Form 1099-INT, Interest Income](/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-int) * [Form 1099-K, Payment Card and Third Party Network Transactions](/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-k) * [Form 1099-MISC, Miscellaneous Income](/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-misc) * [Form 1099-NEC, Nonemployee Compensation](/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-nec) * [Form 1099-OID, Original Issue Discount](/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-oid) * [Form 1099-R, Distributions from Pensions, Annuities, etc.](/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-r) # Form 1099-R, Pension and Annuity Distributions Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/1099-r Extract data from IRS Form 1099-R (Distributions from Pensions, Annuities, etc.): retirement and pension distributions, IRA payouts, and insurance contracts. The **Form 1099-R, Distributions from Pensions, Annuities, etc.** skill extracts data from Forms 1099-R, which are annual reports about distributions from pensions, annuities, retirement or profit-sharing plans, individual retirement accounts, insurance contracts, etc. This form has to be compiled by either the person that carried out such payments or by the manager of the appropriate plan, and is then provided to both the US Internal Revenue Service (IRS) and the recipient of such payments. A separate report has to be compiled for each recipient. Several reports may sometimes be required for a single recipient. The Form 1099-R, Distributions from Pensions, Annuities, etc. skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing Forms 1099-R. For production use, you may need to uptrain the skill with your own document samples. This skill recognizes handwritten text. The option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields ### Basic Form Information | Field | Description | | :-------- | :------------------------------------------------------------------------------------- | | Void | Specifies that the processed form should be annulled. | | Corrected | Specifies that the processed form is being submitted to correct data provided earlier. | | Year | The reporting fiscal year. | ### Payer Details | Field | Description | | :------- | :------------------------------------------------ | | Name | The name, address, and phone number of the payer. | | Street | The name, address, and phone number of the payer. | | City | The name, address, and phone number of the payer. | | State | The name, address, and phone number of the payer. | | ZIP Code | The name, address, and phone number of the payer. | | Country | The name, address, and phone number of the payer. | | Phone | The name, address, and phone number of the payer. | ### Tax Identification Numbers | Field | Description | | :-------------- | :----------------------------------------------------------------------- | | Payer's TIN | The tax identification number assigned to the payer. | | Recipient's TIN | The tax identification number assigned to the recipient of the payments. | ### Recipient Details | Field | Description | | :------- | :--------------------------------------------- | | Name | The name and address of the payment recipient. | | Street | The name and address of the payment recipient. | | City | The name and address of the payment recipient. | | State | The name and address of the payment recipient. | | ZIP Code | The name and address of the payment recipient. | | Country | The name and address of the payment recipient. | ### Account Information | Field | Description | | :------------- | :--------------------------------------------------------------------- | | Account Number | The unique number used by the payer to identify the payment recipient. | ### Distribution Information | Field | Description | | :---------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Gross Distribution | The total amount distributed (before taxes and other deductions). | | Taxable Amount | The amount distributed that is subject to taxation (if the data required to calculate this amount can be obtained). | | Taxable Amount Not Determined | Specifies that the data required to calculate an amount for box 2a (**Taxable Amount**) cannot be obtained. | | Total Distribution | Specifies that the amount specified in box 1 (**Gross Distribution**) was either a once-off payment, or that the payment received in the specified fiscal year was the last in a series of periodic or partial payments. | | Capital Gain | The amount taxable as capital gains. | | Federal Income Tax Withheld | The total amount withheld as federal income tax. | ### Employee Contributions and Securities | Field | Description | | :--------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------- | | Employee Contributions or Insurance Premiums | The amount paid by the recipient as employee contributions or insurance premiums (eligible for tax deductions in the reporting fiscal year). | | Net Unrealized Appreciation in Employer's Securities | The net unrealized appreciation of employer's securities received by the payment recipient. | ### Distribution Codes and Account Types | Field | Description | | :---------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Distribution Code | The distribution code or codes. The payer may specify up to two codes, which are then used by the IRS to determine whether the payment recipient has provided the correct information about the payments. The following symbols are allowed: numbers 1-9 and Latin letters A-W. | | IRA SEP SIMPLE | Specifies that the payments were made from either an individual retirement account (IRA), a SEP IRA account, or a SIMPLE IRA account. | ### Annuity and Distribution Details | Field | Description | | :------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Other | The distribution amount received from an annuity contract. If the distribution is made to more than one recipient, the share distributed to the recipient specified in the form is also shown. | | Other (%) | The distribution amount received from an annuity contract. If the distribution is made to more than one recipient, the share distributed to the recipient specified in the form is also shown. | | Your Percentage of Total Distribution | The percentage of the distribution received by the recipient (if the distribution was made to more than one recipient). | ### Employee Contribution History | Field | Description | | :--------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Total Employee Contributions | The total amount of employee contributions paid by the recipient. Contributions that were already subject to tax deductions during any previous fiscal year are not specified. | ### Roth Account Information | Field | Description | | :------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------- | | Amount Allocable to IRR within 5 Years | The total amount that can be allocated as an in-plan Roth rollover made within 5 years from the date of the first contribution to the Roth account. | | First Year of Designated Roth Contributions | The first year the recipient made a contribution to the designated Roth account. | ### Compliance and Payment Information | Field | Description | | :----------------------- | :----------------------------------------------------------------------------------------------- | | FATCA Filing Requirement | Specifies that the Foreign Account Tax Compliance Act (FATCA) filing requirement is satisfied. | | Date of Payment | Specifies the date of payment for reportable death benefits in the following format: MM/DD/YYYY. | ### State and Local Tax Information | Field | Description | | :----------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | State Tax Withheld 1 | State- and locality-specific payment and tax information. Contains the payment amounts, the withheld tax, the names of the states and localities, as well as the taxpayer identification numbers assigned to the payer in the corresponding states. | | State Tax Withheld 2 | State- and locality-specific payment and tax information. Contains the payment amounts, the withheld tax, the names of the states and localities, as well as the taxpayer identification numbers assigned to the payer in the corresponding states. | | State and Payer State Number 1 | State- and locality-specific payment and tax information. Contains the payment amounts, the withheld tax, the names of the states and localities, as well as the taxpayer identification numbers assigned to the payer in the corresponding states. | | State and Payer State Number 2 | State- and locality-specific payment and tax information. Contains the payment amounts, the withheld tax, the names of the states and localities, as well as the taxpayer identification numbers assigned to the payer in the corresponding states. | | State Distribution 1 | State- and locality-specific payment and tax information. Contains the payment amounts, the withheld tax, the names of the states and localities, as well as the taxpayer identification numbers assigned to the payer in the corresponding states. | | State Distribution 2 | State- and locality-specific payment and tax information. Contains the payment amounts, the withheld tax, the names of the states and localities, as well as the taxpayer identification numbers assigned to the payer in the corresponding states. | | Local Tax Withheld 1 | State- and locality-specific payment and tax information. Contains the payment amounts, the withheld tax, the names of the states and localities, as well as the taxpayer identification numbers assigned to the payer in the corresponding states. | | Local Tax Withheld 2 | State- and locality-specific payment and tax information. Contains the payment amounts, the withheld tax, the names of the states and localities, as well as the taxpayer identification numbers assigned to the payer in the corresponding states. | | Name of Locality 1 | State- and locality-specific payment and tax information. Contains the payment amounts, the withheld tax, the names of the states and localities, as well as the taxpayer identification numbers assigned to the payer in the corresponding states. | | Name of Locality 2 | State- and locality-specific payment and tax information. Contains the payment amounts, the withheld tax, the names of the states and localities, as well as the taxpayer identification numbers assigned to the payer in the corresponding states. | | Local Distribution 1 | State- and locality-specific payment and tax information. Contains the payment amounts, the withheld tax, the names of the states and localities, as well as the taxpayer identification numbers assigned to the payer in the corresponding states. | | Local Distribution 2 | State- and locality-specific payment and tax information. Contains the payment amounts, the withheld tax, the names of the states and localities, as well as the taxpayer identification numbers assigned to the payer in the corresponding states. | ## Key Fields * Year * Payer Details/Name * Payer's TIN * Recipient's TIN * Recipient Details/Name * Account Number * Gross Distribution * Taxable Amount ## Validation Rules | Rule | Description | | :----------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Complete Form Year | Checks the value in the **Year** field. It removes any white spaces and converts a 2-digit year into a 4-digit format. If the last two digits are numeric and start with 9, it converts the value to the 1900's (for example, 99 converts to 1999). Otherwise, it assumes the date is from the 2000's (for example, 24 converts to 2024). | # Form 8949, Sales of Capital Assets Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/8949 Extract data from IRS Form 8949 (Sales and Other Dispositions of Capital Assets) reconciling 1099-B and 1099-S amounts with totals reported on US tax returns. The **Form 8949, Sales and other Dispositions of Capital Assets** skill extracts data from Forms 8949, which are annual reports about sales and exchanges of capital assets. This form allows U.S. taxpayers and the IRS to reconcile amounts that were reported to them on Forms 1099-B or 1099-S (or substitute statements) with the amounts taxpayers report on their returns. The Form 8949, Sales and other Dispositions of Capital Assets skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing Forms 8949. For production use, you may need to uptrain the skill with your own document samples. This skill recognizes handwritten text. The option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :--------------------------------------------------------- | | USA | English
French
German
German (New Spelling) | ## Extracted Fields
Code A (indicates a short-term transaction for which basis was reported to the IRS)
Code B (indicates a short-term transaction for which basis was not reported to the IRS)
Code C (indicates a short-term transaction that was not reported). | ### Short-Term Gains and Losses (Repeating Group) | Field | Description | | :------------------------ | :-------------------------------------------------------------------------------------------------------------- | | Description of Property | A description of the property for which short-term gains or losses are reported. | | Date Acquired | The acquisition date of any securities sold. | | Date Sold or Disposed of | The trade date of the sale or exchange. | | Proceeds (Sales Price) | The gross cash proceeds from disposition. | | Cost or Other Basis | The adjusted basis of any securities sold unless the security is not covered. | | Code(s) From Instructions | The code for the explanation of any adjustments made to the gain or loss in the **Amount of Adjustment** field. | | Amount of Adjustment | The adjustments to gain or loss. | | Gain or Loss | The amount of gain or loss. | ### Short-Term Gains and Losses Totals | Field | Description | | :--------------------- | :--------------------------------------------------- | | Proceeds (Sales Price) | The gross cash proceeds from all dispositions. | | Cost or Other Basis | The total amount of the adjusted basis. | | Amount of Adjustment | The total amount of the adjustments to gain or loss. | | Gain or Loss | The total amount of gain or loss. | ### Long-Term Transactions | Field | Description | | :--------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Long-Term Transactions | Indicates long-term transaction reported on Form 1099-B. Possible code values:
Code D (indicates a long-term transaction for which basis was reported to the IRS)
Code E (indicates a long-term transaction for which basis was not reported to the IRS)
Code F (indicates a long-term transaction that was not reported). | ### Long-Term Gains and Losses (Repeating Group) | Field | Description | | :------------------------ | :-------------------------------------------------------------------------------------------------------------- | | Description of Property | A description of the property for which long-term gains or losses are reported. | | Date Acquired | The acquisition date of any securities sold. | | Date Sold or Disposed of | The trade date of the sale or exchange. | | Proceeds (Sales Price) | The gross cash proceeds from disposition. | | Cost or Other Basis | The adjusted basis of any securities sold unless the security is not covered. | | Code(s) From Instructions | The code for the explanation of any adjustments made to the gain or loss in the **Amount of Adjustment** field. | | Amount of Adjustment | The adjustments to gain or loss. | | Gain or Loss | The amount of gain or loss. | ### Long-Term Gains and Losses Totals | Field | Description | | :--------------------- | :--------------------------------------------------- | | Proceeds (Sales Price) | The gross cash proceeds from all dispositions. | | Cost or Other Basis | The total amount of the adjusted basis. | | Amount of Adjustment | The total amount of the adjustments to gain or loss. | | Gain or Loss | The total amount of gain or loss. | ## Key Fields * Name # Form 990, Tax-Exempt Organization Return Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/990 Extract data from IRS Form 990 (Return of Organization Exempt From Income Tax), the annual return filed by tax-exempt organizations covering finances. The **Form 990, Return of Organization Exempt From Income Tax** skill extracts data from Forms 990. Form 990 is an informational tax form that most tax-exempt organizations must file annually, providing an overview of the organization's activities and governance, as well as detailed financial information. The Form 990, Return of Organization Exempt From Income Tax 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. This skill recognizes handwritten text. The option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields ### Header Information | Field | Description | | :------------------------- | :------------------------------------------------------------------------------------------------- | | Year | The year when the form was revised. | | Box A - Calendar Year | Accounting period. The document can be issued either for a calendar year or for a specific period. | | Box A - Tax Year Beginning | Start date if specific period is specified. | | Box A - Tax Year Ending | End date if specific period is specified. | ### Box B - Check if Applicable | Field | Description | | :------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Address Change | Indicates if the organization changed its address. | | Name Change | Indicates if the organization changed its legal name. | | Initial Return | Indicates that the organization is filing a Form 990 for the first time and has not previously filed Forms 990-EZ, 990-PF, 990-T, or 990-N. | | Final Return | Indicates if the organization has terminated its existence or ceased to be an organization. | | Amended Return | Indicates if the organization previously filed a return with the IRS for a tax year and is now filing another return for the same tax year to amend the previously filed return. | | Application Pending | Indicates if the organization either has filed a Form 1023, 1023-EZ, 1024, or 1024-A with the IRS and is awaiting a response, or claims tax-exempt status under section 501(a) but hasn't filed a Form 1023, 1023-EZ, 1024, or 1024-A to be recognized by the IRS as tax exempt. | ### Organization Information | Field | Description | | :-------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Box C - Name of Organization | The legal name of the organization. | | Box C - Doing Business as | The alternate name of the organization, if the organization operates under a name different from its legal name. | | Box C - Number and Street | The number and street of the organization. If the organization receives its mail in care of a third party (such as an accountant or an attorney), the street address line will have the letters "C/O" followed by the third party's name and street address or P.O. box. | | Box C - Room or Suite | The suite, room, or other unit number of the organization. | | Box C - City State ZIP Code | The organization's foreign address (city or town, state or province, country, and ZIP or foreign postal code). | | Box D - Employer Identification Number | Employer identification number (EIN). | | Box E - Telephone Number | The telephone number of the organization. | | Box F - Name and Address of Principal Officer | The name and address of the principal officer. | | Box G - Gross Receipts | The total amount of gross receipts. | ### Group Return Information | Field | Description | | :--------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------- | | Box H(a) - Group Return for Subordinates | Indicates if this is a group return for subordinates. Possible values: Yes, No. If No is selected, Box H(b) should be empty. | | Box H(b) - All Subordinates Included | Indicates if all subordinates are included. Possible values: Yes, No. | | Box H(c) - Group Exemption Number | The group exemption number. | ### Tax-Exempt Status | Field | Description | | :------------------- | :----------------------------------------------------------- | | 501(c)(3) | The tax-exempt status. | | 501(c)(other) | The tax-exempt status. | | 501(c)(other) Number | The specific subsection number if 501(c)(other) is selected. | | 4947(a)(1) | The tax-exempt status. | | 527 | The tax-exempt status. | ### Additional Organization Details | Field | Description | | :------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Box J - Website | The website of the organization. | | Box K - Form of Organization | The form of the organization or its status under state law (Corporation, Trust, Association, Other). | | Box L - Year of Formation | The year in which the organization was legally created under state or foreign law. If a corporation, contains the year of incorporation. | | Box M - State of Legal Domicile | For a corporation, the state of incorporation (country of incorporation for a foreign corporation formed outside the United States). For a trust or other entity, the state whose law governs the internal affairs of the organization. | ### Part I - Summary | Field | Description | | :----------------------------------------------- | :-------------------------------------------------------------------------------------------------------- | | Box 1 - Organization Mission | The mission of the organization. | | Box 2 - Organization Discontinued Its Operations | Indicates if the organization discontinued its operations or disposed of more than 25% of its net assets. | | Box 3 - Number of Voting Members | The number of voting members of the governing body (Part VI, field Box 1a). | | Box 4 - Number of Independent Voting Members | The number of independent voting members of the governing body. | | Box 5 - Total Number of Individuals Employed | The total number of individuals employed in the given calendar year. | | Box 6 - Total Number of Volunteers | The total number of volunteers. | | Box 7a - Total Unrelated Business Revenue | The total unrelated business revenue from Part VIII. | | Box 7b - Net Unrelated Business Taxable Income | Net unrelated business taxable income from Form 990-T, line 39. | ### Part I - Financial Summary | Field | Description | | :----------------------------------------------------------- | :-------------------------------------------------------------------------- | | Box 8 - Contributions and Grants - Prior/Current Year | Contributions and grants for prior and current year. | | Box 9 - Program Service Revenue - Prior/Current Year | Program service revenue for prior and current year. | | Box 10 - Investment Income - Prior/Current Year | Investment income for prior and current year. | | Box 11 - Other Revenue - Prior/Current Year | Other revenue for prior and current year. | | Box 12 - Total Revenue - Prior/Current Year | The total revenue for prior and current year. | | Box 13 - Grants Paid - Prior/Current Year | Grants and similar amounts paid for prior and current year. | | Box 14 - Benefits Paid - Prior/Current Year | Benefits paid to or for members for prior and current year. | | Box 15 - Salaries - Prior/Current Year | Salaries, other compensation, employee benefits for prior and current year. | | Box 16a - Professional Fundraising Fees - Prior/Current Year | Professional fundraising fees for prior and current year. | | Box 16b - Total Fundraising Expenses | Total fundraising expenses. | | Box 17 - Other Expenses - Prior/Current Year | Other expenses for prior and current year. | | Box 18 - Total Expenses - Prior/Current Year | The total expenses for prior and current year. | | Box 19 - Revenue Less Expenses - Prior/Current Year | Revenue less expenses for prior and current year. | | Box 20 - Total Assets - Beginning/End of Year | The total assets for beginning and end of year. | | Box 21 - Total Liabilities - Beginning/End of Year | The total liabilities for beginning and end of year. | | Box 22 - Net Assets - Beginning/End of Year | Net assets or fund balances for beginning and end of year. | ### Part II - Signature Block | Field | Description | | :------------------------------------------- | :-------------------------------------------------- | | Officer Information - Name and Title | Name and title of signing officer. | | Officer Information - Date | Date signed. | | Preparer Information - Name | Name of paid preparer. | | Preparer Information - Date | Date prepared. | | Preparer Information - Self-Employed | Indicates if preparer is self-employed. | | Preparer Information - PTIN | Preparer Tax Identification Number. | | Preparer Information - Firm's Name | Name of preparer's firm. | | Preparer Information - Firm's EIN | Firm's Employer Identification Number. | | Preparer Information - Firm's Address | Address of preparer's firm. | | Preparer Information - Phone Number | Phone number of preparer. | | IRS May Discuss This Return with the Prepare | Permission for IRS to discuss return with preparer. | ## Key Fields * Box C - Name of Organization * Box D - Employer Identification Number * Box J - Website ## Validation Rules | Rule | Description | | :-------------- | :------------------------------------------------------------- | | Checkmark Check | Sets the value for fields depending on the field descriptions. | # Form W-2 - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/w-2 Extract data from IRS Form W-2 (Wage and Tax Statement): annual employee earnings, taxes withheld, and employer information for IRS and third-party W-2s. The **Form W-2, Wage and Tax Statement** skill extracts data from Forms W-2, annually completed by U.S. employers and provided to their employees and the IRS. The form contains personal information of the employee, his/her annual salary, and the amount of taxes withheld. The Form W-2, Wage and Tax Statement skill extracts data from official IRS Forms W-2, but also W-2 statements created using 3rd party software applications. The Form W-2, Wage and Tax Statement 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. This skill recognizes handwritten text. The option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields ### Form Information | Field | Description | | :---- | :--------------- | | Year | The filing year. | ### Employee and Employer Identification | Field | Description | | :-------------------------------------------------- | :------------------------------------- | | Box a: Employee's social security number | The employee's social security number. | | Box b: Employer Identification Number (EIN) | The employer's details. | | Box c: Employer's name | The employer's details. | | Box c: Address, and ZIP code | The employer's details. | | Box d: Control number | The employer's details. | | Box e: Employee's first name and initial, last name | The employee's personal details. | | Box f: Employee's address and ZIP code | The employee's personal details. | ### Wages and Tax Information | Field | Description | | :------------------------------------- | :----------------------------- | | Box 1: Wages, tips, other compensation | The amounts paid and withheld. | | Box 2: Federal income tax withheld | The amounts paid and withheld. | | Box 3: Social security wages | The amounts paid and withheld. | | Box 4: Social security tax withheld | The amounts paid and withheld. | | Box 5: Medicare wages and tips | The amounts paid and withheld. | | Box 6: Medicare tax withheld | The amounts paid and withheld. | | Box 7: Social security tips | The amounts paid and withheld. | | Box 8: Allocated tips | The amounts paid and withheld. | | Box 10: Dependent care benefits | The amounts paid and withheld. | | Box 11: Nonqualified plans | The amounts paid and withheld. | ### Additional Compensation (Box 12) | Field | Description | | :------------------------------------- | :------------------------------------------------------------ | | Box 12a - single or double letter code | The amount of compensation and benefits paid to the employee. | | Box 12a - dollar amount | The amount of compensation and benefits paid to the employee. | | Box 12b - single or double letter code | The amount of compensation and benefits paid to the employee. | | Box 12b - dollar amount | The amount of compensation and benefits paid to the employee. | | Box 12c - single or double letter code | The amount of compensation and benefits paid to the employee. | | Box 12c - dollar amount | The amount of compensation and benefits paid to the employee. | | Box 12d - single or double letter code | The amount of compensation and benefits paid to the employee. | | Box 12d - dollar amount | The amount of compensation and benefits paid to the employee. | ### Employee Status and Other Information | Field | Description | | :--------------------------- | :----------------------------------------------------------------------------------------------------------------- | | Box 13: Statutory employee | Indicates whether the employee works full-time or part-time. | | Box 13: Retirement plan | Indicates whether the employee participates in a pension or retirement plan. | | Box 13: Third-party sick pay | Indicates whether the employer is a third-party sick pay payer or reports sick pay payments made by a third party. | | Box 14: Other | Additional information. | ### State and Local Tax Information (Repeating Group) | Field | Description | | :--------------------------------- | :-------------- | | Box 15: State | Taxes withheld. | | Box 15: Employer's state ID number | Taxes withheld. | | Box 16: State wages, tips, etc. | Taxes withheld. | | Box 17: State income tax | Taxes withheld. | | Box 18: Local wages, tips, etc. | Taxes withheld. | | Box 19: Local income tax | Taxes withheld. | | Box 20: Locality name | Taxes withheld. | ## Key Fields * Box a: Employee's social security number * Box b: Employer identification number (EIN) * Box c: Employer's name * Box e: Employee's name * Box 1: Wages, tips, other compensation # Form W-2G - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/w-2g Extract data from IRS Form W-2G (Certain Gambling Winnings) reporting gambling winnings and federal income tax withheld by the type and amount of winnings. The **Form W-2G, Certain Gambling Winnings** skill extracts data from Forms W-2G, which are documents used to report gambling winnings and any federal income tax withheld on those winnings. The requirements for reporting and withholding depend on: * The type of gambling. * The amount of the gambling winnings. * The ratio of the winnings to the wager. The Form W-2G, Certain Gambling Winnings skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing Forms W-2G. For production use, you may need to uptrain the skill with your own document samples. This skill recognizes handwritten text. The option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields ### Form Status and Year | Field | Description | | :-------- | :----------------------------------------------------------------------------------------- | | Void | Indicates that a previously issued form is being voided. | | Corrected | Indicates that the form being filed is a corrected version of a previously submitted form. | | Year | The reporting fiscal year. | ### Payer Information | Field | Description | | :----------------------- | :------------------------------------------------------- | | Payer Details - Name | The name, address, and phone number of the of the payer. | | Payer Details - Street | The name, address, and phone number of the of the payer. | | Payer Details - City | The name, address, and phone number of the of the payer. | | Payer Details - State | The name, address, and phone number of the of the payer. | | Payer Details - ZIP Code | The name, address, and phone number of the of the payer. | | Payer Details - Country | The name, address, and phone number of the of the payer. | | Payer Details - Phone | The name, address, and phone number of the of the payer. | | Payer's TIN | The tax identification number assigned to the payer. | ### Winner Information | Field | Description | | :------------------------ | :------------------------------------------------------- | | Winner's TIN | The tax identification number assigned to the recipient. | | Winner Details - Name | The address of the recipient. | | Winner Details - Street | The address of the recipient. | | Winner Details - City | The address of the recipient. | | Winner Details - State | The address of the recipient. | | Winner Details - ZIP Code | The address of the recipient. | | Winner Details - Country | The address of the recipient. | ### Gambling and Winnings Information | Field | Description | | :----------------------------- | :-------------------------------------------------------------------------------------------------------------- | | Reportable Winnings | The amount of gambling winnings received by the recipient to be reported to the Internal Revenue Service (IRS). | | Date Won | The date on which the gambling winnings were obtained or won by the recipient. | | Type of Wager | The particular type of gambling activity that led to the reported winnings. | | Federal Income Tax Withheld | The amount of federal income tax that has been withheld from the gambling winnings reported on the form. | | Transaction | The specific details of the gambling transaction or activity that resulted in the reported winnings. | | Race | The race (or game) applicable to the winning ticket. | | Winnings from Identical Wagers | The total amount of cash or prizes won from a single type of wager or bet. | ### Payment Processing Information | Field | Description | | :-------- | :-------------------------------------------------------------------------- | | Cashier | The cashier and/or window number making the winning payment. | | Window | The cashier and/or window number making the winning payment. | | First ID | The first identification number associated with the recipient of the form. | | Second ID | The second identification number associated with the recipient of the form. | ### State and Local Tax Information | Field | Description | | :-------------------------- | :------------------------------------------------------------------------------------------------------------------- | | State Identification Number | The identification number issued by the state where the gambling activity took place. | | State Winnings | The amount of state winnings. | | State Income Tax Withheld | The amount of state income tax that was withheld from your gambling winnings by the payer or gambling establishment. | | Local Winnings | The amount of gambling winnings subject to local income taxes. | | Local Income Tax Withheld | The amount of local income tax that has been withheld from certain gambling winnings. | | Name of Locality | The specific location or jurisdiction where the gambling winnings were received. | ### Signature Information | Field | Description | | :-------- | :------------------------------ | | Signature | The signature of the recipient. | | Date | The date of signing. | ## Key Fields * Year * Payer Details/Name * Payer's TIN * Winner Details/Name * Winner's TIN * Reportable Winnings ## Validation Rules | Rule | Description | | :----------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Complete Form Year | Checks the value in the **Year** field. It removes any white spaces and converts a 2-digit year into a 4-digit format. If the last two digits are numeric and start with 9, it converts the value to the 1900's (for example, 99 converts to 1999). Otherwise, it assumes the date is from the 2000's (for example, 24 converts to 2024). | # Form W-4 - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/w-4 Extract data from IRS Form W-4 (Employee's Withholding Certificate) — used by employees to direct employer federal income tax withholding from their paychecks. The **Form W-4, Employee's Withholding Certificate** skill extracts data from Forms W-4. This form is provided by employees so that the employer can withhold the correct federal income tax from the employee's pay. The Form W-4, Employee's Withholding Certificate skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing Forms W-4. For production use, you may need to uptrain the skill with your own document samples. This skill recognizes handwritten text. The option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields
Possible values: Yes, No | ### Chapter 4 Status (FATCA) | Field | Description | | :------------------------------------ | :----------------------------------------------------------------------------- | | Box 5 - Chapter 4 Status FATCA Status | Specifies the Foreign Account Tax Compliance Act (FATCA) status of the entity. | **Possible FATCA Status Values:** * Nonparticipating FFI * Participating FFI * Reporting Model 1 FFI * Reporting Model 2 FFI * Registered Deemed-Compliant FFI * Sponsored FFI * Certified Deemed-Compliant Nonregistering Local Bank * Certified Deemed-Compliant FFI with Only Low-Value Accounts * Certified Deemed-Compliant Sponsored Closely Held Investment Vehicle * Certified Deemed-Compliant Limited Life Debt Investment Entity * Certain Investment Entities That Do Not Maintain Financial Accounts * Owner-Documented FFI * Restricted Distributor * Nonreporting IGA FFI * Foreign Government or Government of US Possession or Foreign Central Bank of Issue * International Organization * Exempt Retirement Plans * Entity Wholly Owned By Exempt Beneficial Owners * Territory Financial Institution * Excepted Nonfinancial Group Entity * Excepted Nonfinancial Start-Up Company * Excepted Nonfinancial Entity In Liquidation or Bankruptcy * 501(c) Organization * Nonprofit Organization * Publicly Traded NFFE or NFFE Affiliate of Publicly Traded Corporation * Excepted Territory NFFE * Active NFFE * Passive NFFE * Excepted Inter-Affiliate FFI * Direct Reporting NFFE * Sponsored Direct Reporting NFFE * Account That Is Not A Financial Account ### Address Information #### Permanent Residence Address | Field | Description | | :---------------------------------- | :--------------------------------------------- | | Box 6 - Permanent Residence Address | The permanent residence address of the entity. | | Address | Street address | | City and State or Province | City and state/province | | Country | Country | #### Mailing Address | Field | Description | | :------------------------- | :-------------------------------------------------- | | Box 7 - Mailing Address | The address to which correspondence should be sent. | | Address | Street address | | City and State or Province | City and state/province | | Country | Country | ### Tax Identification | Field | Description | | :---------------------------------------- | :------------------------------------------------------------------ | | Box 8 - US Taxpayer Identification Number | The U.S. taxpayer identification number. | | Box 9a - GIIN | The Global Intermediary Identification Number (GIIN) of the entity. | | Box 9b - Foreign TIN | The Foreign Tax Identification Number (Foreign TIN) of the entity. | | Box 9c - FTIN Not Legally Required | Specifies that FTIN is not legally required. | | Box 10 - Reference Number | Any useful referencing information. | ### Disregarded Entity or Branch Information | Field | Description | | :--------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Box 11 - Chapter 4 Status FATCA Status of Disregarded Entity or Branch | Specifies the Foreign Account Tax Compliance Act (FATCA) status of the disregarded entity with a GIIN or the branch that is an FFI located in a country other than the country identified in the Box 2 - Country of Incorporation or Organization field. | **Possible Status Values:** * Branch Treated As Nonparticipating FFI * Participating FFI * Reporting Model 1 FFI * Reporting Model 2 FFI * US Branch #### Address of Disregarded Entity or Branch | Field | Description | | :----------------------------------------------- | :----------------------------------------------- | | Box 12 - Address of Disregarded Entity or Branch | The address of the disregarded entity or branch. | | Address | Street address | | City and State or Province | City and state/province | | Country | Country | | Field | Description | | :---------------------------------- | :---------------------------------------------------------------------------------------- | | Box 13 - GIIN of Disregarded Entity | The Global Intermediary Identification Number (GIIN) of the disregarded entity or branch. | ### Treaty Benefits | Field | Description | | :-------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Box 14a | Specifies that the entity specified in the Box 1 - Name of Beneficial Owner field is making a claim for reduced withholding under a treaty on certain payments of U.S. source income. | | Box 14a - Resident of | The country for which the beneficial owner is claiming treaty benefits. | | Box 14b | Specifies that the entity derives the items of income for which treaty benefits are claimed and meets any applicable limitation on benefits provisions. | #### Limitation on Benefits Types | Field | Description | | :------------------------ | :--------------------------------------------------------------------------------------------------------- | | Box 14b - Limitation Type | Specifies the types of limitation on benefits provisions that may be included in an applicable tax treaty. | **Possible Limitation Types:** * Government * Tax-Exempt Pension Trust or Pension Fund * Other Tax-Exempt Organization * Publicly Traded Corporation * Subsidiary of a Publicly Traded Corporation * Company That Meets the Ownership and Base Erosion Test * Company That Meets the Derivative Benefits Test * Company With an Item of Income That Meets Active Trade or Business Test * Favorable Discretionary Determination by the US Competent Authority Received * No LOB Article in Treaty * Other | Field | Description | | :-------------- | :--------------------------------------------------------------------- | | Box 14b - Other | Specifies that the type of limitation on benefits is not listed above. | | Box 14c | Specifies the type of limitation on benefits. | ### Special Rates and Conditions | Field | Description | | :------------------------------------ | :--------------------------------------------------------------- | | Box 15 - Special Rates and Conditions | Specifies that the beneficial owner is claiming treaty benefits. | | Article and Paragraph | Treaty article and paragraph | | Rate | Rate claimed | | Income | Type of income | | Additional Conditions | Any additional conditions | ### Certification Boxes The following fields are specific certifications relating to the status marked in Box 5 - Chapter 4 Status FATCA Status: | Field | Description | | :--------------------------------- | :---------------------------------------------------------------------------------------------------------------- | | Box 16 - Name of Sponsoring Entity | Specific certifications relating to the status that is marked on the Box 5 - Chapter 4 Status FATCA Status field. | | Box 17 - Investment Entity | Specific certifications relating to the status that is marked on the Box 5 - Chapter 4 Status FATCA Status field. | | Box 18 through Box 25c | Specific certifications relating to the status that is marked on the Box 5 - Chapter 4 Status FATCA Status field. | ### Box 26 - IGA FFI Information | Field | Description | | :---------------------------------- | :---------------------------------------------------------------------------------------------------------------- | | Box 26 | Specific certifications relating to the status that is marked on the Box 5 - Chapter 4 Status FATCA Status field. | | Box 26 - Name of Jurisdiction | Jurisdiction name for IGA FFI | | Box 26 - IGA Model | Model 1 IGA or Model 2 IGA | | Box 26 - Category of FFI | Category of Foreign Financial Institution | | Box 26 - Name of Trustee or Sponsor | Name of trustee or sponsor | | Box 26 - US or Foreign Trustee | US Trustee or Foreign Trustee | ### Additional Certification Boxes | Field | Description | | :-------------------- | :---------------------------------------------------------------------------------------------------------------- | | Box 27 through Box 32 | Specific certifications relating to the status that is marked on the Box 5 - Chapter 4 Status FATCA Status field. | | Box 33 | Specific certifications relating to the status that is marked on the Box 5 - Chapter 4 Status FATCA Status field. | | Box 33 - Date | Date for Box 33 certification | | Box 34 | Specific certifications relating to the status that is marked on the Box 5 - Chapter 4 Status FATCA Status field. | | Box 34 - Date | Date for Box 34 certification | | Box 35 | Specific certifications relating to the status that is marked on the Box 5 - Chapter 4 Status FATCA Status field. | | Box 35 - Date | Date for Box 35 certification | | Box 36 | Specific certifications relating to the status that is marked on the Box 5 - Chapter 4 Status FATCA Status field. | ### Box 37 - Publicly Traded Entity Information | Field | Description | | :---------------------------------- | :---------------------------------------------------------------------------------------------------------------- | | Box 37a | Specific certifications relating to the status that is marked on the Box 5 - Chapter 4 Status FATCA Status field. | | Box 37a - Securities Exchange | Securities exchange information | | Box 37b | Specific certifications relating to the status that is marked on the Box 5 - Chapter 4 Status FATCA Status field. | | Box 37b - Name of Entity | Name of entity | | Box 37b - Name of Securities Market | Name of securities market | ### Final Certification Boxes | Field | Description | | :--------------------------------- | :---------------------------------------------------------------------------------------------------------------- | | Box 38 through Box 41 | Specific certifications relating to the status that is marked on the Box 5 - Chapter 4 Status FATCA Status field. | | Box 42 - Name of Sponsoring Entity | Specific certifications relating to the status that is marked on the Box 5 - Chapter 4 Status FATCA Status field. | | Box 43 | Specific certifications relating to the status that is marked on the Box 5 - Chapter 4 Status FATCA Status field. | ### Substantial US Owners and Signature | Field | Description | | :------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------- | | Substantial US Owners of Passive NFFE | The name, address and TIN of each substantial U.S. owner of the NFFE. | | Capacity to Sign | Specifies that an authorized representative or agent have the capacity to sign for the person identified on the Name of Beneficial Owner field. | | Printed Name | The printed name of the beneficial owner. | | Date | The date of signing. | ## Key Fields * Box1 - Name of Beneficial Owner * Date # Form W-8ECI - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/form-skills/w-8eci Extract data from IRS Form W-8ECI, used by foreign persons to certify that US-source income is effectively connected with a US trade or business (ECI). The **Form W-8ECI, Certificate of Foreign Person's Claim That Income Is Effectively Connected With the Conduct of a Trade or Business in the United States** skill extracts data from Forms W-8ECI, which are used by foreign individuals who receive income from US companies to establish that they are not US citizens, to claim that they are the beneficial owner of the income at stake, and to claim that the income is connected with the conduct of a trade or business in the US. The W-8ECI, Certificate of Foreign Person's Claim That Income Is Effectively Connected With the Conduct of a Trade or Business in the United States skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing Forms W-8ECI. For production use, you may need to uptrain the skill with your own document samples. This skill recognizes handwritten text. The option is enabled by default. If you do not import handwritten forms, disable the **Handwritten** option in the skill settings. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields
French
German
Spanish | ## Borrower Information | Field | Description | | :--------------- | :--------------------------- | | Borrower Name | The name of the borrower. | | Co Borrower Name | The name of the co-borrower. | ## Account Information | Field | Description | | :-------------- | :------------------------------------------------------------------------- | | Initial Deposit | The amount to be deposited in the escrow account at the start of the loan. | # Invoice - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/invoice-skills/invoice Extract data from invoices across about 30 countries: vendor, customer, line items, taxes, and totals — supporting 22 languages for high-accuracy extraction. The **Invoice** skill extracts data from invoices across approximately 30 countries (mostly European) — including vendor, customer, line items, taxes, and totals — with built-in support for 22 languages. The Invoice 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 | Countries | Languages | | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Austria, Belgium, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, Estonia, Finland, France, Germany, Hungary, India, Ireland, Italy, Latvia, Lithuania, Moldova, Netherlands, Norway, Poland, Portugal, Romania, Slovakia, Slovenia, Sweden, Switzerland, Turkey, United Kingdom | Bulgarian, Croatian, Czech, Danish, Dutch, English, Estonian, Finnish, French, German, Italian, Hungarian, Latvian, Lithuanian, Norwegian (Bokmal), Polish, Portuguese (Standard), Romanian, Slovak, Swedish, Turkish, Ukrainian | By default, the Invoice skill is enabled for all languages that are listed above. You can disable any languages that are not your documents. This might improve both document processing speed and quality. ## Extracted Fields
**Note:** The Currency field is required when the country is Denmark. | ### Business Unit (BU) | Field | Description | | :---------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | The name of the business unit (invoice recipient). | | Tax ID | The tax payer registration number. | | Address | The 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. | | Country | The country of the business unit (invoice recipient). | | City | The 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. For US invoices, these fields can also be obtained by parsing the **Business Unit/Address** field value. | | Street | The 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. For US invoices, these fields can also be obtained by parsing the **Business Unit/Address** field value. | | Postal Code | The 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. For US invoices, these fields can also be obtained by parsing the **Business Unit/Address** field value. | | ID | The unique identifier of the business unit in an external system. **Note:** This field can only be obtained from the BusinessUnits data catalog. | ### Vendor | Field | Description | | :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | The vendor's name. | | Tax ID | International tax payer registration number. | | National Tax ID | The tax payer registration number inside the country of origin. | | IBAN | The vendor's international bank account number. | | Bank Account | The vendor's bank account. | | Bank Code | The vendor's bank code. | | SWIFT Code | The SWIFT code of the vendor. | | Address | The 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. | | Country | The vendor's country. | | City | The 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. For US invoices, these fields can also be obtained by parsing the **Vendor/Address** field value. | | Street | The 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. For US invoices, these fields can also be obtained by parsing the **Vendor/Address** field value. | | Postal Code | The 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. For US invoices, these fields can also be obtained by parsing the **Vendor/Address** field value. | | ID | The vendor's unique identifier in an external system. **Note:** This field can only be obtained from the Vendors data catalog. | ### Date Information | Field | Description | | :------------ | :------------------------------------------------------- | | Delivery Date | The date the goods were delivered or services performed. | | Due Date | The date by which the invoice should be paid. | ### Tax Information | Field | Description | | :----------------- | :------------------------------------------------ | | Reversed Charge | Indicates that a reverse charge is applied. | | Total Net Amount | The total cost of goods and services without tax. | | Total Taxes | The total tax amount. | | Non Taxable Amount | The amount on which no tax is payable. | ### Tax Rates (Repeating Group) | Field | Description | | :--------- | :------------------------------------ | | Net Amount | Cost of goods or services without tax | | Tax Amount | Tax charged | | Tax Rate | Tax rate | ### Invoice Type | Field | Description | | :---------- | :------------------------------------------------- | | Invoice | Specifies the **Invoice** type of the invoice. | | Credit Note | Specifies the **Credit Note** type of the invoice. | ### Purchase Order | Field | Description | | :------------ | :---------------------------------------------------------------------------------------------------------------------------------------------- | | Order Number | The number of the purchase order. | | Total | The cost of the goods or services listed in the purchase order. **Note:** This field can only be obtained from the PurchaseOrders data catalog. | | Order Checked | Indicates whether the order number is verified. The value of the field can be **True** or **False**. | ### Line Items (Repeating Group) | Field | Description | | :-------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Order Number | The number of the purchase order. | | Order Date | The date when the purchase order was created. | | Position | The number of the line item in the list. | | Article Number Vendor | The article number or code in the vendors's database. | | Article Number BU | The article number or code in the business unit's database. | | Description | A description of the line item. | | Quantity | The number of units purchased. | | Unit of Measurement | The unit of measurement used for the goods. | | Unit Price | The price of one item of goods. | | Discount Percentage | The discount percentage on the initial line item price. | | Discount | Discount applicable to the line item. | | Net Price | The price of the line item without tax. | | Tax Rate | The tax rate for the line item. | | Tax Amount | The amount of tax payable on the line item. | | Tax Code | The code of the tax. | | Total Price | The price of the line item including tax. | | Currency | The currency of the line item. | | Is Valid | Indicates 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 ID | The unique line item identifier. **Note:** This field can only be obtained from the PurchaseOrderItems data catalog. | ### Ship To | Field | Description | | :------ | :------------------------------------------------ | | Name | The name of the recipient receiving the goods. | | Address | The address of the recipient receiving the goods. |
**Note:** The Currency field is required when the country is Denmark. | | Total is required | Checks whether the **Total** field is filled in. If it is not, displays a message saying that it is a required field. | | Invoice date is required | Checks whether the **Invoice Date** field is filled in. If it is not, displays a message saying that it is a required field. | | Vendor Tax ID is required | Checks whether the vendor **Tax ID** field is filled in. If it is not, displays a message saying that it is a required field. | | Separate currency from amount in LI money fields | Splits the amount and the currency in Line Items fields (**Unit Price**, **Net Price**, **Total Price**) and copies the currency into the **Line Items/Currency** field if it is not filled in. | | Check invoice and line items currency | Checks 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 item amount | Checks that the calculations for line items are correct (quantity × unit price = net price minus discount, net price × tax rate = tax amount, net price + tax amount = total price). Suggests values for the following fields where calculating them is possible: **Quantity**, **Unit Price**, **Discount**, **Net Price**, **Tax Rate**, **Tax Amount**, and **Total Price**. | | Check LI Total Prices against Total Amount | Checks 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 Amount | Checks 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. | | Business unit must be found in database | Checks 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. | | Check vendor details against database | Checks 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. | | Check purchase order number and amount | Checks that the order number and amount detected on the document image are the same as those in the PurchaseOrders data catalog. | | Match invoice line item with order item | Checks 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. | | Copy order number | If there is only one value in the **Order Number** field in the **Purchase Order** group and the values in the **Line Items** **Order Number** fields are empty, copies the value to all line items. | | Check purchase order total amount | Checks if the value in the **Total** field equals the value or sum of values in the **Purchase Order** group **Total** fields. | | Check matching of line items to unique order items | For 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 is unique for every purchase order number if **Order Checked** is **True**. | | If order is checked make line items valid | For 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. If they match, sets the **Is Valid** field to **True**. | | Detect invoice type | Sets 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**. | | Separate currency from amount in money fields | Splits the amount and the currency in fields containing currency amounts and copies the currency into the **Currency** field if it is empty. | | Check Total Tax | Checks that the sum of the **Tax Amount** fields across the **Tax Rates** repeating group is equal to the value of the **Total Taxes** field. For each instance of the **Tax Rates** group, checks calculations and suggests values where needed. | | Check Total field | Checks 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. | | Reversed Charge field is empty or completed | If 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. | | Check Net Total | Checks 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. | To fill in a field with its calculated value, click the suggested value button and select one of the suggestions from the drop-down list. ## 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. For more information, see [Skill parameters](/vantage/documentation/skill-designer/skill-parameters). | Parameter | Description | | :------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Vendors | The 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). | | BusinessUnits | The 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. | | PurchaseOrders | The 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. | | PurchaseOrderDetails | The 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. | # Invoice Classifier Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/invoice-skills/invoice-classifier Classify incoming invoices by region — Default (Europe), USA, CA, AU-NZ, ES, UA — and route each to the matching Vantage Invoice Document skill. The **Invoice Classifier** skill classifies incoming invoices by region — Default (Europe), USA, CA, AU-NZ, ES, UA — routing each invoice to the matching Vantage Invoice Document skill. ## Regional Classification The following table lists which countries are covered by each region. | Region | Country | | :------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Default | Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, India, Ireland, Italy, Netherlands, Norway, Poland, Portugal, Slovakia, Sweden, Switzerland, United Kingdom | | USA | USA | | CA | Canada | | AU-NZ | Australia and New Zealand | | ES | Spain | | UA | Ukraine | ## Supported Languages By default, the Invoice Classifier skill supports invoices in the following languages: * English * French * German * Spanish ## Adding Additional Languages To classify invoices in other languages: 1. Duplicate the Invoice Classifier skill. 2. In the Languages settings in the Skill Designer, add the required languages to the copy of the Invoice Classifier skill. Note that allowing too many languages will slow down OCR. 3. Retrain the copy of the Invoice Classifier skill. Once the list of recognition languages has been changed, the classifier needs to be trained again from scratch on your own documents. For more information, see the [Training a Classifier](/vantage/documentation/skill-designer/classification/train-classifier) help section. Invoices from countries other than those listed above will be classified as **Unknown**. # Invoice Skills Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/invoice-skills/invoice-overview Vantage Invoice skills extract data from invoices across Europe, the US, Canada, Australia/NZ, Spain, Ukraine, China, and Japan, with splitting included. ABBYY Vantage offers a set of built-in skills designed for extracting data from invoices. An invoice is a document issued by a seller to a buyer that lists the goods or services supplied. An invoice typically contains the following information: * A list of goods or services supplied and their quantity and price * The total amount payable for the goods or services * The currency to be used for payment * A description of the goods or services * Details about the seller and the buyer * The number and date of the invoice * Applicable taxes As information provided on invoices varies from region to region (for example, each country has its own tax system and laws of incorporation), each region requires its own invoice skills, with region-specific data fields and validation rules. ## Available Invoice Skills ABBYY Vantage includes the following built-in invoice skills: * [Invoice](/vantage/documentation/skill-catalog/built-in-skills/invoice-skills/invoice) for invoices from various countries, mostly European * [Invoice AU-NZ](/vantage/documentation/skill-catalog/built-in-skills/invoice-skills/invoice-au-nz) for Australian and New Zealand invoices * [Invoice CA](/vantage/documentation/skill-catalog/built-in-skills/invoice-skills/invoice-ca) for Canadian invoices * [Invoice CN](/vantage/documentation/skill-catalog/built-in-skills/invoice-skills/invoice-cn) for Chinese invoices * [Invoice ES](/vantage/documentation/skill-catalog/built-in-skills/invoice-skills/invoice-es) for Spanish invoices * [Invoice JP](/vantage/documentation/skill-catalog/built-in-skills/invoice-skills/invoice-jp) for Japanese invoices * [Invoice UA](/vantage/documentation/skill-catalog/built-in-skills/invoice-skills/invoice-ua) for Ukrainian invoices * [Invoice US](/vantage/documentation/skill-catalog/built-in-skills/invoice-skills/invoice-us) for US invoices ## Multi-Region Processing Skills To process invoices from multiple regions within one workflow, ABBYY Vantage offers the following built-in skills: * [Invoice Classifier](/vantage/documentation/skill-catalog/built-in-skills/invoice-skills/invoice-classifier) * [Invoice Processing](/vantage/documentation/skill-catalog/built-in-skills/invoice-skills/invoice-processing) ## Document Splitting To split files with multiple invoices, ABBYY Vantage offers the built-in [Invoice Document Splitter Skill](/vantage/documentation/skill-catalog/built-in-skills/invoice-skills/invoice-splitter). The built-in invoice skills have been trained on a large document set and provide high accuracy of data identification and extraction. ## Data Catalogs The built-in invoice skills use data catalogs named "Vendors" (of type Document Issuer Companies) and "BusinessUnits" (of type Document Receiver Companies), each containing the following columns.
in the output text. - "Line" is the 0-based index of the first line containing the extracted value; include it only if verifiable. ``` **Why Strictness Matters:** * **Prevents hallucination**: LLMs may generate plausible but incorrect data. * **Ensures consistency**: Clear rules reduce variation between runs. * **Handles missing data**: Defines what to do when fields aren't found. * **Maintains data integrity**: Verbatim extraction preserves original formatting. **Key Strictness Principles:** * Never generate data that isn't in the document. * Omit uncertain extractions rather than guessing. * Return empty structure if no fields are found. * Match field names exactly. * Preserve original text formatting. *** ## Step 8: Select Document Format Choose which document representation to send to the LLM. 1. In the Activity Editor, locate the **Prompt** dropdown. 2. You'll see options for how the document is provided to the LLM.
Net Amount. Cost of goods or services without tax.
Tax Amount. Tax charged.
Tax Rate. Tax rate. | | Non Taxable Amount | The amount on which no tax is payable. | ### Invoice Type | Field | Description | | :---------- | :------------------------------------------------- | | Invoice | Specifies the **Invoice** type of the invoice. | | Credit Note | Specifies the **Credit Note** type of the invoice. | ### Purchase Order | Field | Description | | :------------ | :------------------------------------------------------------------------------------------------------------------------------------------ | | Order Number | The number of the purchase order. | | Total | The cost of the goods or services listed in the purchase order. Note: This field can only be obtained from the PurchaseOrders data catalog. | | Order Checked | Indicates whether the order number is verified. The value of the field can be **True** or **False**. | ### Line Items (Repeating Group) | Field | Description | | :-------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Order Number | The number of the purchase order. | | Order Date | The date when the purchase order was created. | | Position | The number of the line item in the list. | | Article Number Vendor | The article number or code in the vendor's database. | | Article Number BU | The article number or code in the business unit's database. | | Description | A description of the line item. | | Quantity | The number of units purchased. | | Unit of Measurement | The unit of measurement used for the goods. | | Unit Price | The price of one item of goods. | | Discount Percentage | The discount percentage on the initial line item price. | | Discount | Discount applicable to the line item. | | Net Price | The price of the line item without tax. | | Tax Rate | The tax rate applicable to the line item. | | Tax Amount | The amount of tax payable on the line item. | | Tax Code | The code of the tax. | | Total Price | The price of the line item including tax. | | Currency | The currency of the line item. | | Is Valid | Indicates whether the order number in the Line Items group matches any checked order number in the Purchase Order group. The value of the field can be **True** or **False**. | | Order Item ID | The unique line item identifier. Note: This field can only be obtained from the PurchaseOrderItems data catalog. | ### Ship To | Field | Description | | :------ | :------------------------------------------------ | | Name | The name of the recipient receiving the goods. | | Address | The address of the recipient receiving the goods. |
1. 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**).
2. 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.
3. 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 fields | Splits 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. Applies to:
Line Items/Unit Price
Line Items/Net Price
Line Items/Total Price | | Check invoice and line items currency | Checks 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 Amount | Checks 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 Amount | Checks 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 Tax | Checks 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:
1. Checks that (**Tax Rate** / 100) \* **Net Amount** is equal to **Tax Amount**.
2. If **Tax Rate**, **Net Amount**, or **Tax Amount** is not filled in, suggests filling in these fields with their calculated values.
3. Removes the percent sign (%) from the value in the **Tax Rate** field | | Check Total field | Checks 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 Total | Checks 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 country | If a country has not been detected on the image, specifies the default country for the invoice. For Invoice AU-NZ, the default country is AU. | | Check vendor details against database | Checks 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 the Vendors data catalog | | Business unit must be found in database | Checks 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 the BusinessUnits data catalog | | Check purchase order number and amount | Checks 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 the PurchaseOrders data catalog | | Match invoice line item with order item | Checks 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 the PurchaseOrderItems data catalog | | Check purchase order total amount | Checks 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 items | For 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 valid | For 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 number | If 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 type | Sets 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 completed | If 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. | Parameter | Description | | :----------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Vendors | The 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) | | BusinessUnits | The 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 | | PurchaseOrders | The 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 | | PurchaseOrderItems | The 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 | # Invoice CA - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/invoice-skills/invoice-ca Extract data from Canadian invoices — vendor, customer, GST/HST/PST, line items, and totals in English and French — for Canadian AP automation. The **Invoice CA** skill extracts data from Canadian invoices — vendor, customer, GST/HST/PST details, line items, and totals in English and French — for AP automation across Canada. The Invoice CA 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 | Countries | Languages | | :-------- | :-------- | | Canada | English | | | French | ## Extracted Fields
Net Amount. Cost of goods or services without tax.
Tax Amount. Tax charged.
Tax Rate. Tax rate. | | Non Taxable Amount | The amount on which no tax is payable. | ### Invoice Type | Field | Description | | :---------- | :------------------------------------------------- | | Invoice | Specifies the **Invoice** type of the invoice. | | Credit Note | Specifies the **Credit Note** type of the invoice. | ### Purchase Order | Field | Description | | :------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------- | | Order Number | The number of the purchase order. | | Total | The cost of the goods or services listed in the purchase order.
**Note:** This field can only be obtained from the PurchaseOrders data catalog. | | Order Checked | Indicates whether the order number is verified. The value of the field can be **True** or **False**. | ### Line Items (repeating group) | Field | Description | | :-------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Order Number | The number of the purchase order. | | Order Date | The date when the purchase order was created. | | Position | The number of the line item in the list. | | Article Number Vendor | The article number or code in the vendors's database. | | Article Number BU | The article number or code in the business unit's database. | | Description | A description of the line item. | | Quantity | The number of units purchased. | | Unit of Measurement | The unit of measurement used for the goods. | | Unit Price | The price of one item of goods. | | Discount Percentage | The discount percentage on the initial line item price. | | Discount | Discount applicable to the line item. | | Net Price | The price of the line item without tax. | | Tax Rate | The tax rate for the line item. | | Tax Amount | The amount of tax payable on the line item. | | Tax Code | The code of the tax. | | Total Price | The price of the line item including tax. | | Currency | The currency of the line item. | | Is Valid | Indicates 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 ID | The unique line item identifier. **Note:** This field can only be obtained from the PurchaseOrderItems data catalog. | ### Ship To | Field | Description | | :------ | :------------------------------------------------ | | Name | The name of the recipient receiving the goods. | | Address | The address of the recipient receiving the goods. |
1. 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**).
2. 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.
3. The sum of the values of the **Net Price** and **Tax Amount** fields is equal to the value of the **Total Price** field.
4. 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 fields | Splits 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.
1. Line Items/Unit Price
2. Line Items/Net Price
3. Line Items/Total Price | | Check invoice and line items currency | Checks 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 Amount | Checks 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 Amount | Checks 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 Tax | Checks 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 field | Checks 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 Total | Checks 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 country | If a country has not been detected on the image, specifies the default country for the invoice based on the supported country for the skill. For example, Invoice CA = `CA`; Invoice = `Default Country Not Set` ) | | Check vendor details against database | Checks 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 must be filled in the Vendors data catalog. | | Business unit must be found in database | Checks 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 the BusinessUnits data catalog. | | Check purchase order number and amount | Checks 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 the PurchaseOrders data catalog. | | Match invoice line item with order item | Checks 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 the PurchaseOrderItems data catalog. | | Check purchase order total amount | Checks 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 items | For 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 valid | For 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 number | If 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 type | Sets 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 completed | If 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. | Parameter | Description | | :----------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Vendors | The 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). | | BusinessUnits | The 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. | | PurchaseOrders | The 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. | | PurchaseOrderItems | The 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. | # Invoice CN - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/invoice-skills/invoice-cn Extract data from Chinese VAT invoices issued by manufacturers — vendor, buyer, VAT details, goods, quantities, prices, currency, and totals. The **Invoice CN** skill extracts data from VAT invoices posted by manufacturers from China. A VAT invoice is a document issued by a seller to a buyer that lists the goods or services supplied. A VAT invoice typically contains the following information: * The list of goods or services supplied and their quantity and price * The total amount payable for the goods or services * The currency to be used for payment * A description of the goods or services * Details about the seller and the buyer * The number and date of the invoice * Applicable taxes The Invoice CN 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. This skill is designed for processing VAT invoices from China, which have a specific structure that does not change from document to document. Other types of invoices from China may not be processed correctly using this skill. The Invoice CN skill does not use the **Vendors**, **BusinessUnits**, **PurchaseOrders** and **PurchaseOrderItems** data catalogs. ## Countries and Languages | Countries | Languages | | :-------- | :------------------- | | China | Chinese (Simplified) | | | English | ## Extracted Fields
1. That the number of units for each line item (**Quantity**) multiplied by the price of a unit (**Unit Price**) equals the price of the goods or service before taxes (**Net Price**).
2. That the price of the goods or service before taxes (**Net Price**) multiplied by the tax rate (**Tax Rate**) equals the value in the **Tax Amount** field.
Removes the percent sign (%) from the value in the **Tax Rate** field.
For each invoice line item, suggests values for the following fields (wherever calculating them is possible): **Quantity**, **Unit Price**, **Net Price**, **Tax Rate**, and **Tax Amount**. | | Complete Tax Rate | Checks that the value of the **Tax Rate** field equals the following: **Total Taxes\*100/Total Net**. If the values are different or **Tax Rate** is empty, suggests filling it with its calculated value. | 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. # Invoice ES - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/invoice-skills/invoice-es Extract data from Spanish invoices — vendor, customer, NIF/CIF, IVA tax, line items, and totals — for AP automation in Spain (Spanish and English). The **Invoice ES** skill extracts data from Spanish invoices (*facturas*) — vendor, customer, NIF/CIF, IVA tax, line items, and totals — for AP automation in Spain (Spanish and English). The Invoice ES 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 | Countries | Languages | | :-------- | :-------- | | Spain | Spanish | | | English | ## Extracted Fields
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 fields | Splits 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 currency | Checks 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 Amount | Checks 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 Amount | Checks 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 Tax | Checks 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 field | Checks 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 Total | Checks 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 country | If a country has not been detected on the image, specifies the default country for the invoice based on the supported country for the skill (e.g., Invoice ES = `ES`; Invoice = `Default Country Not Set` ) | | Check vendor details against database | Checks 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 the Vendors data catalog. | | Business unit must be found in database | Checks 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 the BusinessUnits data catalog. | | Check purchase order number and amount | Checks 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 the PurchaseOrders data catalog. | | Match invoice line item with order item | Checks 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 the PurchaseOrderItems data catalog. | | Check purchase order total amount | Checks 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 items | For 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 valid | For 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 number | If 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 type | Sets 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 completed | If 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. | Parameter | Description | | :----------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Vendors | The 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). | | BusinessUnits | The 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. | | PurchaseOrders | The 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. | | PurchaseOrderItems | The 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. | # Invoice JP - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/invoice-skills/invoice-jp Extract data from Japanese invoices (請求書 / seikyusho) — vendor, customer, line items, consumption tax, and totals in Japanese (Modern). The **Invoice JP** skill extracts data from Japanese invoices (請求書 / *seikyusho*) — vendor, customer, line items, consumption tax, and totals. Invoice JP is the only Invoice Document skill that is not part of the Invoice Processing or Invoice Classifier skills. To process Japanese invoices alongside other regions, configure your own Invoice Classifier or Invoice Processing skill. The Invoice JP skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing Japanese invoices. For production use, you may need to uptrain the skill with your own document samples. ## Countries and Languages | Countries | Languages | | :-------- | :---------------- | | Japan | Japanese (Modern) | | | English | ## Extracted Fields
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 fields | Splits 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 currency | Checks 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 Amount | Checks 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 Amount | Checks 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 Tax | Checks 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 field | Checks 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 Total | Checks 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 country | If a country has not been detected on the image, specifies the default country for the invoice. For Invoice JP, the default country is JP. | | Check vendor details against database | Checks 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 must be populated in the Vendors data catalog. | | Check purchase order number and amount | Checks 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 the PurchaseOrders data catalog. | | Match invoice line item with order item | Checks 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 the PurchaseOrderItems data catalog. | | Check purchase order total amount | Checks 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 items | For 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 valid | For 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 number | If 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 type | Sets 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**. | 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, and Purchase Order lookup. You can change the values of these parameters in Vantage or Advanced Designer to modify the field extraction process. | Parameter | Description | | :----------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Vendors | The 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). | | PurchaseOrders | The 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. | | PurchaseOrderItems | The 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. | # Invoice UA - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/invoice-skills/invoice-ua Extract data from Ukrainian invoices — vendor, customer, VAT details, line items, and totals in English, Russian, and Ukrainian — for AP automation in Ukraine. The **Invoice UA** skill extracts data from Ukrainian invoices — vendor, customer, VAT details, line items, and totals — with support for English, Russian, and Ukrainian. 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 | Countries | Languages | | :-------- | :-------- | | Ukraine | English | | | Russian | | | Ukrainian | ## Extracted Fields
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 fields | Splits 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 currency | Checks 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 Amount | Checks 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 Amount | Checks 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 Tax | Checks 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 field | Checks 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 Total | Checks 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 country | If 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 database | Checks 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 the Vendors data catalog. | | Business unit must be found in database | Checks 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 the BusinessUnits data catalog. | | Check purchase order number and amount | Checks 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 the PurchaseOrders data catalog. | | Match invoice line item with order item | Checks 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 the PurchaseOrderItems data catalog. | | Check purchase order total amount | Checks 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 items | For 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 valid | For 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 number | If 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 type | Sets 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 completed | If 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. | Parameter | Description | | :----------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Vendors | The 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). | | BusinessUnits | The 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. | | PurchaseOrders | The 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. | | PurchaseOrderItems | The 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. | # Invoice US - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/invoice-skills/invoice-us Extract data from US invoices — vendor, customer, sales tax, line items, and totals — for accounts payable automation across the United States. The **Invoice US** skill extracts data from US invoices — vendor, customer, sales tax, line items, and totals — for accounts payable automation across the United States. The Invoice US 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 | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields
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 fields | Splits 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 currency | Checks 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 Amount | Checks 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 Amount | Checks 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 Tax | Checks 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 field | Checks 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 Total | Checks 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 country | If a country has not been detected on the image, specifies the default country for the invoice. For Invoice US, the default country is US. | | Check vendor details against database | Checks 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 the Vendors data catalog. | | Business unit must be found in database | Checks 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 the BusinessUnits data catalog. | | Check purchase order number and amount | Checks 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 the PurchaseOrders data catalog. | | Match invoice line item with order item | Checks 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 the PurchaseOrderItems data catalog. | | Check purchase order total amount | Checks 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 items | For 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 valid | For 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 number | If 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 type | Sets 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 completed | If 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. | Parameter | Description | | :------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Vendors | The 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). | | BusinessUnits | The 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. | | PurchaseOrders | The 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. | | PurchaseOrderDetails | The predefined data catalog used to check if the Purchase Order details match. The default value of this parameter is **PurchaseOrderDetails**. You can change this value by choosing another available data catalog having the same structure. | # Lease Agreement (US) - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/lease-agreement-us Extract data from US lease agreements — landlord, tenant, property, rental terms, and lease duration — for commercial and residential real estate workflows. The **Lease Agreement (US)** skill extracts data from US lease agreements — the legal documents that set out rental terms between a property owner (landlord) and a renter (tenant), covering both commercial and residential real estate. The Lease Agreement (US) skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing US lease agreements.
Note: This field can be obtained either by parsing the **Buyer/Address** field value or from the Buyers data catalog. | | Tax ID | The tax identification number of the buyer. | | IBAN | The international bank account number of the buyer. | | Buyer ID | The buyer ID.
Note: This field can only be obtained from the Buyers data catalog. | | Bank Code | The bank code of the buyer. | | Bank Account | The bank account number of the buyer. | | Street | The street part of the buyer's address.
Note: This field can be obtained either by parsing the **Buyer/Address** field value or from the Buyers data catalog. | | Postal Code | The postal code part of the buyer's address.
Note: This field can be obtained either by parsing the **Buyer/Address** field value or from the Buyers data catalog. | | City | The city part of the buyer's address.
Note: This field can be obtained either by parsing the **Buyer/Address** field value or from the Buyers data catalog. | | State or Province | The state or province part of the buyer's address.
Note: This field can only be obtained from the Buyers data catalog. | ### Supplier Information | Field | Description | | :---------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name\* | The name of the supplier. | | Address | The address of the supplier. | | Country | The country of the supplier.
Note: This field can be obtained either by parsing the **Supplier/Address** field value or from the Suppliers data catalog. | | Tax ID | The tax identification number of the supplier. | | Supplier ID | The supplier ID.
Note: This field can only be obtained from the Suppliers data catalog. | | Street | The street part of the supplier's address.
Note: This field can be obtained either by parsing the **Supplier/Address** field value or from the Suppliers data catalog. | | Postal Code | The postal code part of the supplier's address.
Note: This field can be obtained either by parsing the **Supplier/Address** field value or from the Suppliers data catalog. | | City | The city part of the supplier's address.
Note: This field can be obtained either by parsing the **Supplier/Address** field value or from the Suppliers data catalog. | | State or Province | The state or province part of the supplier's address.
Note: This field can only be obtained from the Suppliers data catalog. | ### Delivery and Billing Information #### Ship to | Field | Description | | :------ | :--------------------------------------------- | | Name | The address where the goods must be delivered. | | Address | The address where the goods must be delivered. | #### Bill to | Field | Description | | :------ | :-------------------------------------------- | | Name | The address where the invoice should be sent. | | Address | The address where the invoice should be sent. | ### Line Items (repeating group)\* | Field | Description | | :---------------------- | :------------------------------------------------------------- | | Position | The number of the line item in the list. | | Article Number Buyer | The article number of the goods in the buyer's database. | | Article Number Supplier | The article number of the goods in the supplier's database. | | Description | A description of the goods or services. | | Quantity | The number of units ordered. | | Unit of Measurement | The unit of measurement used for the goods. | | Unit Price | The price of one item of goods. | | Discount | The applicable discount in the currency of the purchase order. | | Total Price | The price of the line item including tax. | | Currency | The currency of the line item. | | Delivery Date | The delivery date of the goods in the line item. | ### Financial Information | Field | Description | | :------- | :------------------------------------------------------------------------------------------- | | Total | The total amount of the purchase order. | | Currency | The currency of the total amount. If no total amount is indicated, this field will be empty. | #### Taxes | Field | Description | | :--------------- | :----------------------------------- | | Total Tax Amount | The total tax amount. | | Total Net Amount | The total cost of goods without tax. | ### Delivery | Field | Description | | :-------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Delivery Date\* | The delivery date of the ordered goods or services.
Note: If a single delivery date is specified for all the ordered good or services, this date will be extracted into a separate **Delivery Date** field. If a separate delivery date is indicated for each line item, these dates will be extracted as columns in the LineItems table. | ## Key Fields * Buyer/Name * Order Number * Order Date * Total ## Validation Rules | Rule | Description | | :------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Line items are required | Checks that all Line items have been detected on the document. | | Delivery date must be later than order date | Checks that the delivery date is later than the date of the purchase order. | | Total: Amount Check | Checks that:
1. **Line Items/Total Price** equals **Total**
2. **Line Items/Total Price** + **Taxes/Total Tax Amount** equals **Total**
3. **Line Items/Total Price** equals **Taxes/Total Net Amount**
If none of the conditions are fulfilled, returns an error and suggests corrected values.
If the **Taxes/Total Tax Amount** and **Taxes/Total Net Amount** fields are empty, and the **Total** field is not empty, fills the **Taxes/Total Net Amount** field with the value of the **Total** field.
Suggests calculated values for **Total**, **Taxes/Total Tax Amount**, or **Taxes/Total Net Amount**, if any of these fields are not detected. | | Check item amount | Multiplies the number of units ordered in the line item by the price of one unit, applies the discount, and suggests a value if the result is not equal to the total price of the line item. | | Separate currency from amount in Total field | Splits the amount and the currency in the amount fields and copies the currency into the **Currency** field if it is empty. | | Copy PO and Line Items currency | If the **Currency** field is empty, fills it in using the value of the **Line Items**/**Currency** field. This rule also applies to the **Line Items**/**Currency** field, which is filled in using the value of the **Currency** field. Only values that correspond to the ISO format are copied. If the **Currency** fields are empty, checks the value of the**Supplier** /**Country** field. If the country of the supplier is France, Italy, Germany, Netherlands, or Spain, fills in the **Currency** field with the value “EUR”. | | Quantity is required | Checks that the quantity of goods has been detected on the document. | | Separate currency from amount in Line Items money field | Splits the amount and the currency in the amount fields and copies the currency into the **Currency** field if it is empty. | | Check currency value | Checks that the value of the **Currency** field in the order corresponds to a currency format. Adds a list of suggested values if the field is empty or if its value does not correspond to any currency code. | | Check Line Items currency value | Checks that the value of the **Currency** field in **Line Items** corresponds to a currency format. Adds a list of suggested values if the field is empty or if its value does not correspond to any currency code. | | Buyer DB lookup | Checks information about the buyer against the corresponding data catalog. If the data catalog contains information about that buyer, but the values are either different or incomplete, fills in the appropriate fields using data from the data catalog. If the buyer was not detected correctly, the operator may select a different buyer from the data catalog manually during manual review. The **Buyer ID**, **Name**, **Street**, **Country**, and **Company Correlation ID (Supplier ID)** fields should be filled in the Buyers data catalog. | | Supplier DB lookup | Checks information about the supplier against the corresponding data catalog. If the data catalog contains information about that supplier, but the values are either different or incomplete, fills in the appropriate fields using data from the data catalog. If the supplier was not detected correctly, the operator may select a different supplier from the data catalog manually during manual review. The **Supplier ID**, **Name**, **Street** and **Country** fields should be filled in the Suppliers data catalog. | ## Parameters The **Purchase Order EU** and **Purchase Order US** skills have default skill parameters that refer to data catalogs used for Buyer and Supplier lookup. You can change the values of these parameters in Vantage or Advanced Designer to modify field extraction. For more information, see [Skill parameters](/vantage/documentation/skill-designer/skill-parameters). | Parameter | Description | | :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Buyers | The predefined data catalog used for Buyer lookup. The default value of this parameter is **Buyers**. You can change this value by choosing another available data catalog of the same type (Document Issuer Companies). | | Suppliers | The predefined data catalog used for Supplier lookup. The default value of this parameter is **Suppliers**. You can change this value by choosing another available data catalog of the same type (Document Receiver Companies). | # Purchase Order Skills Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/po-skills/purchase-order-overview Vantage Purchase Order skills extract data from POs across regions — EU (DE/FR/IT/NL/ES) and US — with classification, processing, and document splitting. ABBYY Vantage offers a set of built-in skills designed for processing purchase orders. A purchase order is a document sent by a buyer to a supplier that lists the goods or services that the buyer wants to purchase. A purchase order typically contains the following information: * A list of goods or services purchased * The total amount payable for the goods or services * The number and date of the purchase order * The expected date of delivery As information provided on purchase orders varies from region to region, each region requires its own purchase order skills, with region-specific data fields and validation rules. ## Available Purchase Order Skills ABBYY Vantage includes the following built-in purchase order skills: * [Purchase Order EU](/vantage/documentation/skill-catalog/built-in-skills/po-skills/purchase-order-eu) for purchase orders in France, Germany, Italy, the Netherlands, and Spain * [Purchase Order US](/vantage/documentation/skill-catalog/built-in-skills/po-skills/purchase-order-us) for purchase orders in the USA. ## Multi-Region Processing To process purchase orders from multiple regions within one workflow, ABBYY Vantage offers the following built-in skills: * [Purchase Order Classifier](/vantage/documentation/skill-catalog/built-in-skills/po-skills/purchase-order-classifier) * [Purchase Order Processing](/vantage/documentation/skill-catalog/built-in-skills/po-skills/purchase-order-processing) The built-in purchase order skills have been trained on a large document set and provide high accuracy of data identification and extraction. ## Data Catalogs The built-in purchase order skills make use of data catalogs named "Buyers" (of type Document Receiver Companies) and "Suppliers" (of type Document Issuer Companies), each containing the following columns: ### Buyers Data Catalog | Column | Description | | :------------- | :-------------------------------- | | Id | Unique identifier | | VATID | VAT identification number | | BusinessUnitId | Business unit identifier | | IBAN | International Bank Account Number | | BankAccount | Bank account number | | BankCode | Bank routing code | | Name | Company name | | ZIP | Postal code | | Street | Street address | | City | City name | | State | State or province | | CountryCode | Country code | ### Suppliers Data Catalog | Column | Description | | :---------- | :------------------------ | | Id | Unique identifier | | VATID | VAT identification number | | Name | Company name | | ZIP | Postal code | | Street | Street address | | City | City name | | State | State or province | | CountryCode | Country code | For more information about data catalogs and how to add custom data to a data catalog, see the Skills Designer documentation. ## Neural Network Detection If you are not using data catalogs, the **Buyer/Name**, **Supplier/Name**, **Supplier/Address**, **Buyer/Address**, **Buyer/Tax ID**, and **Supplier/Tax ID** fields will be detected and captured using neural networks. If you want to select a specific record from your database, use data catalogs. For more information about the company detection, see the Advanced Designer documentation. # Purchase Order Processing Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/po-skills/purchase-order-processing End-to-end purchase order processing — classify each PO by region with the Purchase Order Classifier, and then apply the matching Document skill to extract data. The **Purchase Order Processing** skill provides end-to-end PO processing for multiple regions — first classifying each uploaded order with the **Purchase Order Classifier** skill (based on the order recipient's country), and then applying the matching region-specific Document skill to extract data. ## Document Splitting If you need to split files with multiple purchase orders into separate purchase orders or if you need to separate purchase orders from other types of documents (for example, invoices or waybills), you can use the Purchase Order Splitter skill. You can add this skill to the **Purchase Order Processing** workflow or to any other Process skill. # Purchase Order Splitter Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/po-skills/purchase-order-splitter Split files containing multiple purchase orders into separate documents — and optionally separate POs from invoices, waybills, or other supporting annexes. The **Purchase Order Splitter** skill splits files containing multiple purchase orders into separate documents for further processing. It can also separate POs from other documents (invoices, waybills, supporting annexes), classifying each as **Purchase Order** or **no Purchase Order**. ## Skill Components This skill consists of the following activities: * A Classify activity, which includes two classes: **Purchase Order** and **no Purchase Order** (the **no Purchase Order** class covers annexes, email and fax headers, invoices, and other types of documents contained within the same file) * An Extraction Rules activity for separating documents based on reliable markers of the first page (for example, "Page 1 of 10") * An Extraction Rules activity for extracting purchase order numbers ## Document Splitting Logic Files will be split into separate documents if any of the following occurs (in the order listed): * The beginning of a new file is detected. * A document class is identified that is different from the one previously detected. * A reliable marker of the first page is extracted. * A new purchase order number is extracted. ## Implementation Guide You can create a Process skill and use the Purchase Order Splitter skill in the Assemble activity to split files into purchase orders and then use any relevant Document skill to extract their data. ### Setup Steps To use the Purchase Order Splitter skill, follow these steps: 1. Create a new Process skill. 2. Add and set up an Input activity. 3. Add an Assemble activity. For this activity, in the **Actions** pane, select the **By Document Splitter Skill** option, and then select **Purchase Order Splitter** skill from the list. 4. Add an Extract activity. For this activity, in the **Actions** pane, click the **Add Skill** button and then select a Document skill from the list. 5. While still in the **Actions** pane, click the configuration icon next to the Document skill name specified for the Extract activity. In the dialog box that opens, select **Purchase Order** in the **Class** field. 6. Optionally, add and set up a **Manual Review** activity to verify extracted data and make any necessary adjustments to assembled documents (for example, you will be able to move pages around). 7. Add and set up an Output activity. 8. Click the **Publish Skill** button. Once you have completed the above steps, you can use the Purchase Order Splitter skill in Vantage. # Purchase Order US - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/po-skills/purchase-order-us Extract data from US purchase orders: buyer, supplier, header, footer, and line items in English, applying regional business rules for US procurement workflows. The **Purchase Order US** skill extracts data from US purchase orders in English — capturing header, footer, and line-item details across a variety of input formats — and applies regional business rules for US procurement workflows. The Purchase Order US Skill is a production skill. It was trained on a large set of POs. It processes documents in a variety of input formats and extracts key data including header, footer, and line item details. 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 | Countries | Languages | | :-------- | :-------- | | USA | English | ## Extracted Fields
1. **Line Items/Total Price** equals **Total**
2. **Line Items/Total Price** + **Taxes/Total Tax Amount** equals **Total**
3. **Line Items/Total Price** equals **Taxes/Total Net Amount**
If none of the conditions are fulfilled, returns an error and suggests corrected values.
If the **Taxes/Total Tax Amount** and **Taxes/Total Net Amount** fields are empty, and the **Total** field is not empty, fills the **Taxes/Total Net Amount** field with the value of the **Total** field.
Suggests calculated values for **Total**, **Taxes/Total Tax Amount**, or **Taxes/Total Net Amount**, if any of these fields are not detected. | | Separate currency from amount in Total field | Splits the amount and the currency in the amount fields and copies the currency into the **Currency** field if it is empty. | | Check item amount | Multiplies the number of units ordered in the line item by the price of one unit, applies the discount, and suggests a value if the result is not equal to the total price of the line item. | | Quantity is required | Checks that the quantity of goods has been detected on the document. | | Copy PO and Line Items currency | If the **Currency** field is empty, fills it in using the value of the **Line Items**/**Currency** field. This rule also applies to the **Line Items**/**Currency** field, which is filled in using the value of the **Currency** field. Only the values that correspond to the ISO format are copied. If the currency is marked using the "\$" sign, the value is still copied, but is then formatted to be the standard "USD" value. If the **Currency** fields are empty, checks the value of the **Supplier**/**Country** field. If the country of the supplier is the US, fills the **Currency** field with the value "USD". | | Separate currency from amount in Line Items money field | Splits the amount and the currency in the amount fields and copies the currency into the **Currency** field if it is empty. | | Check currency value | Checks that the value of the **Currency** field in the order corresponds to a currency format. Adds a list of suggested values if the field is empty or if its value does not correspond to any currency code. | | Check Line Items currency value | Checks that the value of the **Currency** field in **Line Items** corresponds to a currency format. Adds a list of suggested values if the field is empty or if its value does not correspond to any currency code. | | Set Default Country | If the **Country** fields in the **Supplier** and **Buyer** groups are not filled in, fills them in using the default value (US). | | Supplier DB lookup | Checks information about the supplier against the corresponding data catalog. If the data catalog contains information about that supplier, but the values are either different or incomplete, fills in the appropriate fields using data from the data catalog. If the supplier was not detected correctly, the operator may select a different supplier from the data catalog manually during manual review. The **Supplier ID**, **Name**, **Street** and **Country** fields should be filled in the Suppliers data catalog. | | Buyer DB lookup | Checks information about the buyer against the corresponding data catalog. If the data catalog contains information about that buyer, but the values are either different or incomplete, fills in the appropriate fields using data from the data catalog. If the buyer was not detected correctly, the operator may select a different buyer from the data catalog manually during manual review. The **Buyer ID**, **Name**, **Street**, **Country**, and **Company Correlation ID (Supplier ID)** fields should be filled in the Buyers data catalog. | ## Parameters The **Purchase Order EU** and **Purchase Order US** skills have default skill parameters that refer to data catalogs used for Buyer and Supplier lookup. You can change the values of these parameters in Vantage or Advanced Designer to modify field extraction. For more information, see Skill parameters. | Parameter | Description | | :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Buyers | The predefined data catalog used for Buyer lookup. The default value of this parameter is **Buyers**. You can change this value by choosing another available data catalog of the same type (Document Issuer Companies). | | Suppliers | The predefined data catalog used for Supplier lookup. The default value of this parameter is **Suppliers**. You can change this value by choosing another available data catalog of the same type (Document Receiver Companies). | # Hotel Invoice - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/receipt-skills/hotel-invoice Extract data from hotel invoices and bills: guest, hotel, dates of stay, room rates, additional charges, taxes, and totals — for T&E and corporate travel. The **Hotel Invoice** skill extracts data from hotel invoices and bills (folios) — capturing the guest, hotel, dates of stay, room rates, additional charges, and totals — for T\&E and corporate-travel workflows. The Hotel Invoice skill is a production skill. It has been fully trained on a large document set and provides highly accurate 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 | Countries | Languages | | :-------- | :-------- | | Australia | English | | Canada | English | | France | English | | Germany | English | | Italy | English | | Mexico | English | | Spain | English | | USA | English | ## Extracted Fields
1. Debit – increases the total invoice amount
2. Credit – decreases the total invoice amount. This field is optional and may have one of the following values: - (negative) or + (positive), D (Debit) or C (Credit) if the remittance advice is in English. | | Customer ID | The client/customer identifier. | ## Key Fields * Customer/Name * Vendor/Name * Payment Number * Total * Payment Information/Currency ## Validation Rules | Rule | Description | | :------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Check payments with discounts | Checks if the total amount paid (**Line Items/Paid Amount**) is equal to the total invoice amount (**Line Items/Invoice Amount**) minus the **Discount**. | | Line Items: Invoice Number is Required | Checks if each Line Item has an Invoice Number filled out. | | Check or fill Total | If the total amount paid is not specified in the document, sets the value of **Total** to be the total invoice amount paid (**Line Items/Paid Amount**). If the total amount paid is specified, checks that it is equal to the total invoice amount paid (**Line Items/Paid Amount**). If the value of **Line Items/Type** is **Credit**, then the positive value of **Line Items/PaidAmount** is considered to be negative for that line item when calculating the total invoice amount paid. | | Compare Total and Payment Amount | Checks that the total amount paid (**Total**) is equal to the payment amount (**Payment Amount**). | | Normalize currency to 3-digits code | Normalizes the value of the **Currency** field to a three-digit currency code. | # Resume - Document Skill Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/resume Extract data from resumes (CVs) — personal info, work experience, education, skills, and certifications — for HR, recruiting, and applicant tracking. The **Resume** skill extracts data from resumes (also known as curriculum vitae or CVs) — the documents people use to apply for jobs, summarizing a person's career history, qualifications, education, and skills. The Resume skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing resumes. For production use, you may need to uptrain the skill with your own document samples. ## Countries and Languages | Countries | Languages | | :-------- | :-------- | | USA | English | | Canada | English | | | French | ## Extracted Fields ### Personal Information | Field | Description | | :------------ | :----------------------------------- | | Full Name | The name of the candidate. | | Date of Birth | The date of birth of the candidate. | | Email | The e-mail address of the candidate. | | Phone Number | The phone number of the candidate. | ### Education (Repeating Group) | Field | Description | | :---------------------------------- | :------------------------------------------------------------------------------- | | Institution Name | The name of the candidate's educational institution. | | Degree | The degree earned at the educational institution. | | Field of Study | The obtained specialization. | | GPA | The grade point average (GPA) of the candidate. | | Education Period or Graduation Date | The period of studying at the educational institution or the date of graduation. | ### Employment (Repeating Group) | Field | Description | | :---------------- | :-------------------------------------------- | | Employer Name | The name of the employer. | | Location | The legal address of the organization. | | Position | The candidate's position in the organization. | | Employment Period | The period of employment. | ## Key Fields * Full Name * Email # Riders - Document Skill (Preview) Source: https://docs.abbyy.com/vantage/documentation/skill-catalog/built-in-skills/riders Extract data from Riders — addenda to insurance and contract agreements that add terms and conditions or modify coverage. The Riders skill is currently available in Preview. The **Riders** skill extracts data from Riders — the addenda to insurance policies or contracts that add terms and conditions or modify the underlying agreement. The Riders skill is a preview skill. It has been trained on a limited set of documents and is designed to help you quickly get started with processing riders.
**Note:** This is the unique identifier of the entry in the data catalog if all of the company's business units use the same customer database. Otherwise, the entry in the data catalog is uniquely identified by a combination of **Issuer Company ID** and **Company Correlation ID**. | | Company Correlation ID | The identifier of the company's business unit.
**Note:** If the company's business units use different customer databases, this data catalog column must be filled in, as the unique key of the entry in the data catalog will be a combination of **Issuer Company ID** and **Company Correlation ID**. For more information, see [Look for a pair of companies](#look-for-a-pair-of-companies). | | Tax ID | These columns can be used in a unique company identifier search. | | National Tax ID | These columns can be used in a unique company identifier search. | | IBAN | These columns can be used in a unique company identifier search. | | Name | These columns can be used in a company name and address search. | | Postal Code | These columns can be used in a company name and address search. | | Street | These columns can be used in a company name and address search. | | City | These columns can be used in a company name and address search. | | State or Province | These columns are not used in the company detection process. They can only be used to fill in the document fields. | | Country | These columns are not used in the company detection process. They can only be used to fill in the document fields. | | Bank Account | These columns are not used in the company detection process. They can only be used to fill in the document fields. | | Bank Code | These columns are not used in the company detection process. They can only be used to fill in the document fields. | ### The Document Receiver Companies data catalog | Name | Description | | :------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Receiver Company ID | Obtained by detecting the document receiver. Identifies the document receiver in an external information system. The unique key of the entry in the data catalog. | | Tax ID | This column can be used in a unique company identifier search. | | Name | These columns can be used in a company name and address search. | | Postal Code | These columns can be used in a company name and address search. | | Street | These columns can be used in a company name and address search. | | City | These columns can be used in a company name and address search. | | State or Province | These columns are not used in the company detection process. They can only be used to fill in the document fields. | | Country | These columns are not used in the company detection process. They can only be used to fill in the document fields. | # Classify By Text and Image activity Source: https://docs.abbyy.com/vantage/documentation/advanced-designer/activities/classify-by-text-and-image Sort documents into classes with the Classify By Text and Image activity in Advanced Designer, and then run class-specific extraction for higher accuracy. It may be difficult to specify field extraction properties for cases where a single Document skill needs to process documents that vary significantly with regards to their field placement (despite being of the same type). For example, the same skill can be used to process invoices from different vendors, where the same fields may be placed in locations that differ from vendor to vendor. To improve the extraction quality for such skills, you can choose to classify its documents into classes, which are document subgroups (with common properties) for a single document type, and set up separate extraction activities for each one. Classifying documents into classes may also be required when you need to improve extraction quality for one of the classes. For example, a single skill may be used to process bank statements compiled by different banks. One statement type may have a lower extraction quality compared to the rest. To improve the extraction quality for that skill, you can sort the statements into classes and set up an Extraction Rules activity for the class that has an unsatisfactory extraction quality. The Classify By Text and Image activity is designed to sort a skill's documents into classes that require their own extraction activities to be created and set up. ## Setup overview
## RegionsCollection
A read-only collection of `Region` objects for a single field.
### Methods
#### AddRegion
```javascript theme={null}
Region AddRegion(number pageIndex);
```
Adds a new region to the field on the specified page. Returns the created `Region`.
#### RemoveRegion
```javascript theme={null}
void RemoveRegion(Region region);
```
Removes the specified region.
#### RemoveAll
```javascript theme={null}
void RemoveAll();
```
Removes all regions from the current field.
## Related topics
* [Field](/vantage/documentation/skill-designer/process/custom-activity/field)
* [Rectangle](/vantage/documentation/skill-designer/process/custom-activity/rectangle)
* [Object model](/vantage/documentation/skill-designer/process/custom-activity/object-model)
# RuleError
Source: https://docs.abbyy.com/vantage/documentation/skill-designer/process/custom-activity/rule-error
Document skill validation rule error.
`RuleError` describes a single Document skill validation rule error returned by [`Document.RuleErrors`](/vantage/documentation/skill-designer/process/custom-activity/document).
## Properties
| Name | Type | Access | Description |
| :---------------- | :----- | :-------- | :-------------------------------------------------------------------------------------------------------------------------- |
| **CustomMessage** | string | Read-only | The custom error message from a custom skill. Returns an empty string for built-in rules, or when no custom message is set. |
| **ErrorType** | string | Read-only | The error type. Returned only for built-in rules. |
## Related topics
* [Document](/vantage/documentation/skill-designer/process/custom-activity/document)
* [Object model](/vantage/documentation/skill-designer/process/custom-activity/object-model)
# Sample scripts
Source: https://docs.abbyy.com/vantage/documentation/skill-designer/process/custom-activity/sample-scripts
JavaScript samples for common Custom activity scenarios, including OAuth, external exports, field modification, table manipulation, and JSON generation.
The following JavaScript samples illustrate common patterns for Custom activity scripts, including OAuth authorization, sending exports to external services, modifying extracted fields, manipulating tables, generating custom JSON, and retrieving source file names. Copy and adapt them to your own field names and endpoints.
## Authorize via OAuth and send export data to an external service
The following script performs authentication using a token obtained via Resource Owner Password Flow and then sends the export data to an external service:
```javascript theme={null}
// This sample Custom export script shows how to send an authorization request for OAuth 2.0 Resource Owner Password Flow, receive the token,
// and then send export results to the external system in JSON format
// Prepare the key-value body for the authorization request (parameters and their values may be different). The corresponding environment variable should be created beforehand.
var authDataContent = {};
authDataContent.grant_type = "password";
authDataContent.scope = "openid permissions";
// Pass sensitive data using environment variables. The corresponding variables should be created beforehand.
authDataContent.client_id = Context.GetSecret("client_id_secretName");
authDataContent.client_secret = Context.GetSecret("client_secret_secretName");
authDataContent.password = Context.GetSecret("password_secretName");
authDataContent.username = Context.GetSecret("username_secretName");
// create the request and send the data
var request = Context.CreateHttpRequest();
request.Url = "https://my_auth_service.com/auth2/connect/token"
request.Method = "POST";
// create content data for the authorization request
request.SetUrlFormEncodedContent(authDataContent);
request.Send();
var authResponseObject = JSON.parse(request.ResponseText);
// get all exports from the document
var exports = Context.Transaction.Documents[0].Exports;
// select the JSON export result
var extractedDataExportResult = exports.find(element => element.ExportFormat === ExportFormat.Json);
var pdfExportResult = exports.find(element => element.ExportFormat === ExportFormat.Pdf);
// Create content data for the request
var multiPartRequest = Context.CreateMultipartFormDataRequest();
multiPartRequest.Url = "https://my_service.com/api/v1.0/process_method"
multiPartRequest.Method = "POST";
multiPartRequest.AuthToken = authResponseObject.access_token;
multiPartRequest.AuthScheme = "Bearer";
// add extracted data to the export result
multiPartRequest.AppendStringContent(extractedDataExportResult.ToJson(), "jsonData");
// add the exported PDF
multiPartRequest.AppendFileContent(pdfExportResult, "binaryData");
// send a request to the service
multiPartRequest.Send();
// Get a deserialised response result
var responseObject = JSON.parse(multiPartRequest.ResponseText);
```
## Send export data to an external service
The following script names the exported file using the invoice number and then sends export data to an external service (Dropbox in this case):
```javascript theme={null}
// This sample Custom export script shows how to send a file to Dropbox
// and set the file name using value of extracted data field.
// Get the document export result
var exports = Context.Transaction.Documents[0].Exports;
var extractedDataExportResult = exports.find(element => element.ExportFormat === ExportFormat.Json);
// Get the access token to the DropBox API (https://developers.dropbox.com/en-us/oauth-guide). The corresponding environment variable should be created beforehand.
var token = Context.GetSecret("access_token_secretName");
// Get "Invoice Number" from the extracted data
var invoiceNumberField = Context.Transaction.Documents[0].GetField("Invoice Number");
var invoiceNumber = invoiceNumberField.Value;
// Create the result file name
var jsonFileName = `ExtractedData_${invoiceNumber}.json`;
// Send the JSON file with the extracted data to DropBox
var httpRequest = Context.CreateHttpRequest();
httpRequest.Url = "https://content.dropboxapi.com/2/files/upload"
httpRequest.Method = "POST";
httpRequest.AuthScheme = "Bearer";
httpRequest.AuthToken = token;
httpRequest.SetHeader("Dropbox-API-Arg", `{"path": "/Files/${jsonFileName}", "mode": "add", "autorename": true, "mute": false, "strict_conflict": false}`);
httpRequest.SetFileContent(extractedDataExportResult, "application/octet-stream");
httpRequest.Send();
```
## Modify extracted data
The following script modifies the value of an existing field and adds new values for a repeating field using information contained in a response from an external service:
```javascript theme={null}
// This sample Custom activity script shows how to modify an existing field
// and create a new field value based on the results of an external call.
// Get all exports from the document
var exports = Context.Transaction.Documents[0].Exports;
// Get the JSON export result from the exports
var extractedDataExportResult = exports.find(element => element.ExportFormat === ExportFormat.Json);
// Get the PDF export result from the exports
var pdfExportResult = exports.find(element => element.ExportFormat === ExportFormat.Pdf);
// Create an HTTP request and specify required request properties
var multipartFormDataRequest = Context.CreateMultipartFormDataRequest();
multipartFormDataRequest.Url = "http://my_service/api/v1.0/apimethod/"
multipartFormDataRequest.Method = "POST";
// Add extracted data from the JSON export result to the request
multipartFormDataRequest.AppendStringContent(extractedDataExportResult.ToJson(), "jsonData");
// Add the PDF from the export results to the request
multipartFormDataRequest.AppendFileContent(pdfExportResult, "binaryData");
// Set the timeout for the HTTP request to be completed (in minutes).
// By default, the timeout is set to 1 minute.
multipartFormDataRequest.Timeout = 1;
// Send a request to the service
multipartFormDataRequest.Send();
// Get a response result
var newJsonDataObject = JSON.parse(multipartFormDataRequest.ResponseText);
// Assuming such a JSON was obtained in the response result:
/* {
"DocumentData": {
"Fields": {
"InvoiceNumber": "706-222-3151",
"InvoiceDate": "15.05.2020",
"PurchaseOrder": [
{
"OrderNumber": "25646788",
"Total": "540.54"
},
{
"OrderNumber": "24516684",
"Total": "138.43"
}
]
}
}
}*/
// Change the value of an existing Vantage document field based on data received from an external call
var document = Context.Transaction.Documents[0];
var invoiceNumber = document.GetField("Invoice Number");
if (invoiceNumber.InstanceId === undefined || invoiceNumber.InstanceId === null)
invoiceNumber.AddInstance();
invoiceNumber.Value = newJsonDataObject.DocumentData.Fields.InvoiceNumber;
// Add new Vantage document field values based on data received from an external call
var poOrder = Context.Transaction.Documents[0].GetField("Purchase Order");
let orderNumberFieldId = document.GetField("Purchase Order/Order Number").Id;
let totalFieldId = document.GetField("Purchase Order/Total").Id;
newJsonDataObject.DocumentData.Fields.PurchaseOrder.forEach(function (elem) {
var newOrder = poOrder.AddInstance();
var orderNumber = newOrder.Children.find(x => x.Id === orderNumberFieldId);
orderNumber.Value = elem.OrderNumber;
var total = newOrder.Children.find(x => x.Id === totalFieldId);
total.Value = elem.Total;
});
```
## Retrieve data from a specific table column
The following script writes all values (rows) of the **Description** table column to the transaction event log:
```javascript theme={null}
// Get the first document in a transaction
var document = Context.Transaction.Documents[0];
var descriptionFieldId = document.GetField("Line Items/Description").Id;
// Get the table object
var table = document.GetField("Line Items");
for (var i = 0; i < table.Instances.length; i++) {
// Get the 'Description' column object for each table row and write its values to the transaction event log
var columnDescription = table.Instances[i].Children.find(x => x.Id === descriptionFieldId);
Context.LogMessage("Description. Row " + i + ": " + columnDescription.Value);
}
```
## Retrieve data from all table columns
The following script writes all values (rows) of all table columns to the transaction event log:
```javascript theme={null}
// Get the first document in a transaction
var document = Context.Transaction.Documents[0];
// Get the table object
var table = document.GetField("Line Items");
// Write all table data to the transaction event log
for (var i = 0; i < table.Instances.length; i++) {
for (var j = 0; j < table.Instances[i].Children.length; j++) {
Context.LogMessage("Table row "+i+". Column "+table.Instances[i].Children[j].Name+": "+table.Instances[i].Children[j].Value);
}
}
```
## Add rows to a table
The following script adds new table rows and sets values for the **Description** and **Quantity** table columns:
```javascript theme={null}
// Get the first document in a transaction
var document = Context.Transaction.Documents[0];
// Get the table object
var table = document.GetField("Line Items");
var descriptionFieldId = document.GetField("Line Items/Description").Id;
var quantityFieldId = document.GetField("Line Items/Quantity").Id;
var tableRowCount = table.Instances.length;
// Create function to add one table row and set values for Description and Quantity columns
function addRow(valueDescription, valueQuantity, index) {
table.AddInstance();
var columnDescription = table.Instances[index].Children.find(x => x.Id === descriptionFieldId);
columnDescription.Value = valueDescription;
var columnQuantity = table.Instances[index].Children.find(x => x.Id === quantityFieldId);
columnQuantity.Value = valueQuantity;
}
// Add three rows and set values
addRow("49910 - Gloves or mittens, NOI, in boxes", 4, tableRowCount++);
addRow("15560 - Bulk, NOI, inflated", 42, tableRowCount++);
addRow("15520 - Athletic or Sporting Goods, NOI", 24, tableRowCount++);
```
## Delete rows from a table
The following script deletes all rows from a table:
```javascript theme={null}
// Get the first document in a transaction
var document = Context.Transaction.Documents[0];
// Get the table object
var table = document.GetField("Line Items");
var indexCount = table.Instances.length - 1;
// Delete all rows by their indexes
for (var i = indexCount; i >= 0 ; i--) {
table.Instances[i].Remove();
}
// Or you can delete the entire table
table.Remove();
```
## Delete a specific instance of a repeating field
The following script deletes the last instance of a repeating field:
```javascript theme={null}
// Get the first document in a transaction
var document = Context.Transaction.Documents[0];
// Get the repeating field object
var rField = document.GetField("First Name");
// Check if this field is repeating
if (rField.IsRepeatable) {
// Delete the last instance of this field
if (rField.Instances.length >= 1) {
rField.Instances[rField.Instances.length-1].Remove();
}
}
else {
Context.LogMessage(rField.Name + " is not repeating.");
}
```
## Generate a JSON file and send it to a third-party system
The following script generates a JSON file in a custom format and sends it to a third-party system:
```javascript theme={null}
// This sample Custom export script shows how to create a JSON string
// using extracted Invoice US fields values and send it to an external endpoint.
// Get the first document in the transaction.
var document = Context.Transaction.Documents[0];
// Create a JSON object and set its key/value pairs.
var extractedValues = {};
extractedValues.Total = document.GetField("Total").Value;
extractedValues.Currency = document.GetField("Currency").Value;
extractedValues.Date = document.GetField("Invoice Date").Value;
// Get repeating field values and set them as array JSON values.
extractedValues.PurchaseOrderNumber = [];
var poGroup = document.GetField("Purchase Order");
var orderNumberFieldId = document.GetField("Purchase Order/Order Number").Id;
for (var i = 0; i < poGroup.Instances.length; i++) {
var poNumber = poGroup.Instances[i].Children.find(x => x.Id === orderNumberFieldId);
extractedValues.PurchaseOrderNumber.push(poNumber.Value);
}
// The received JSON file is of the following format:
/* {
"Total": 1819.14,
"Currency": "USD",
"Date": "2019-05-23T00:00:00.000Z",
"PurchaseOrderNumber": [
"012345678",
"4500123466"
]
}*/
// Send a multipart/form-data request with the JSON created previously as the string content of that request.
var httpRequest = Context.CreateMultipartFormDataRequest();
httpRequest.Method = "POST";
httpRequest.Url = "https://external-endpoint.com/api/v1.0/tasks/1495c913-17bb-48d4-8041-a240e05ca9a4/process";
httpRequest.AppendStringContent(JSON.stringify(extractedValues), "jsonData");
httpRequest.Send();
```
## Retrieve original file names
The following script puts the original name of a file into the **MyField** field:
```javascript theme={null}
// Get the name of the source file and set it as the value of the specified field ("MyField")
Context.Transaction.Documents.forEach( doc => {
// For Scanning Station, the source file name is put into a registration parameter
var param = doc.RegistrationParameters["SourceFileName"];
doc.GetField("MyField").Value = param != null ?
param.Value : doc.SourceFiles[0].FileName;
});
```
## Related topics
* [Custom activity](/vantage/documentation/skill-designer/process/custom-activity/custom-activity)
* [Object model](/vantage/documentation/skill-designer/process/custom-activity/object-model)
* [Context](/vantage/documentation/skill-designer/process/custom-activity/context)
* [HttpRequest](/vantage/documentation/skill-designer/process/custom-activity/http-request)
* [MultipartFormDataRequest](/vantage/documentation/skill-designer/process/custom-activity/multi-part-form-data-request)
* [ExportFormat](/vantage/documentation/skill-designer/process/custom-activity/export-format)
# Transaction
Source: https://docs.abbyy.com/vantage/documentation/skill-designer/process/custom-activity/transaction
The Transaction interface provides access to the current transaction and all its documents.
`Transaction` exposes the current transaction and its documents to a Custom activity script.
## Properties
### Id
**Type:** `string`, **Access:** Read-only
The transaction identifier.
### Documents
**Type:** [Document](/vantage/documentation/skill-designer/process/custom-activity/document)`[]`, **Access:** Read-only
The transaction's documents.
ColumnType\_Text—**Text** data type
ColumnType\_Currency—**Amount of money** data type
ColumnType\_Date—**Date** data type
ColumnType\_RegExp—regular expression
ColumnType\_Number—**Number** data type | | Void ColumnOmissionQuality( Real quality, String columnName ) | If fixed column orders are used, this parameter sets the penalty for the hypotheses, defined as the coefficient (a number from 0 to 1) by which the quality of the hypothesis will be multiplied if the column specified in the fixed column order isn't detected. The default value is 0.9. | | Void MissingContentPenalty( Real quality, String columnName ) | Sets the penalty for the hypotheses, defined as the coefficient (a number from 0 to 1) by which the quality of the hypothesis will be multiplied if the actual data type in the column doesn't coincide with the data type specified by the user. If the parameter isn't set, its default value is 0.98. If column order rules are used, it specifies the penalty for the absence of the column in the table. | | Void ColumnBounds( XCoordinate left, XCoordinate right, String columnName ) | Sets the right and left boundaries of the search area for the column. | | Void ExactColumnBorders( XCoordinate left, XCoordinate right, String columnName ) | Sets the exact column boundaries. This parameter can be used to search for a table when the location of some (or all) of the columns is known in advance. | | Void AddColumnContent( Hypothesis hypothesis, String columnName ) | Specifies the column content by means of the detected hypothesis. | | Void AddColumnContent( XInterval, XInterval, String ) | Specifies the column content by setting the right and left boundaries of a column. | ## Parameters Setting the Column Order | Parameter | Description | | :------------------------------------------------------------------------ | :----------------------------------------- | | Void AddPossibleColumnsOrder( String orderName, StringArray columnNames ) | Specifies a variant of fixed column order. | | Void ColumnsRelation( StringArray columnNames ) | Specifies a rule for the column order. | ## Header Search Parameters | Parameter | Description | | :-------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Void HasHeader( Logic ) | Specifies whether the activity should look for a header. | | Void HeaderOptional( Real q1, Real q2 ) | Specifies whether the header is optional, similarly to the Void Optional ( Real q1, Real q2 ) function for elements. | | Void HeaderSearchArea( Rect ) | Specifies the search rectangle for the header. If this function is used, the search area of the header will be calculated as the intersection of this rectangle and the one enclosing the search area of the whole table. | | Void MaxHeaderHypothesesCount( Int ) | Sets the maximum number of hypotheses to be generated during header search. | | Void MinHeaderKeyElements( Int ) | Sets the minimum number of key elements required to detect the header. The default value is 2. | | Void ExtendHeaderLocalization( XInterval, YInterval, XInterval, YInterval ) | Extends the area regarded as the header. For example, it can be used to discard the line of unwanted information located between the header and the body of the table. | ## Footer Search Parameters | Parameter | Description | | :------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Void HasFooter( Logic has = true ) | Specifies whether the activity should look for the footer. | | Void FooterOptional( Real q1, Real q2 ) | Specifies whether the footer is optional, similarly to the Void Optional ( Real q1, Real q2 ) function for elements. | | Void FooterSearchArea( Rect ) | Specifies the search rectangle for the footer. If this function is used, the footer search area will be calculated as the intersection of this rectangle and the one enclosing the search area of the whole table. | | Void FooterHasTopSeparator() | Specifies that there is a separator between the footer and the body of the table. The separator can be a part of a table boundary. | | Void FooterWholeWordMode ( Logic wholeWordMode = true ) | This flag is used when looking for a footer based on keywords. If this flag is set to **True**, hypotheses made up of only word parts are discarded. The default setting is **False**. | | Void FooterNearestToTop ( Logic ) | This flag is used when looking for a footer based on keywords. If this flag is set to **True**, the activity selects the topmost candidate and discards the rest. If this flag is set to **False**, the activity considers all the possible candidates. The quality of the footer contributes to the quality of the table and then the table hypothesis with the highest quality is selected. The default setting is **True**. | | Void AddFooterKeyWord( String keyWord ) | Specifies a keyword for the footer of the table. | | Void AddFooterKeyHypothesis( Hypothesis hypothesis ) | Specifies the footer of the table by means of the detected hypothesis. | | Void AddFooterKeyHypothesis( XInterval, YInterval, XInterval, YInterval ) | Specifies the coordinates of the footer of the table. | ## Body Search Parameters | Parameter | Description | | :------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Void DontFindBody() | Allows skipping the body search. Used for debugging. | | Void BodyOptional( Real q1, Real q2 ) | Specifies whether the body is optional, similarly to the Void Optional ( Real q1, Real q2 ) function for elements. | | Void IgnoreVerticalSeparators() | Ignores vertical separators in the body of the table when dividing the table into columns (by default, separators are taken into account). | | Void IgnoreSeparatorsFromHeader() | Ignores vertical separators in the header of the table when dividing the table into columns (by default, vertical separators are taken into account). | | Void AutoDetectLeftAndRight( Logic ) | Enables automatic detection of the left and right boundaries of the table. The default setting is **True**. | | Void AutoDetectTopAndBottom( Logic ) | Enables automatic detection of the top and bottom boundaries of the table. The default setting is **True**. If the flag is set to **False**, the entire text inside the search area of the table element is used. | ## Rows Detection Parameters | Parameter | Description | | :------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Void SingleLineTable( Logic ) | Tells the activity that each line of text must correspond to one row in the table. | | Void SingleLineMasterColumn( Logic ) | Tells the activity that each line of text must correspond to one row in the master column of the table. | | Void MaxRowVerticalGap( Distance ) | Specifies the maximum vertical distance between two rows in the table. If the specified distance is exceeded, this means the end of the body of the table. By default, this distance isn't limited. | | Void MinRowVerticalGap( Distance ) | Specifies the minimum vertical distance between two rows in the table. If the distance is smaller than the specified distance, the rows are merged. The default value is 0. | | Void MaxMasterColumnRowGap( Distance ) | Specifies the maximum vertical distance between two rows in the master column of the table. If the specified distance is exceeded, this means the end of the body of the table. By default, this distance isn't limited. | | Void MinMasterColumnRowGap( Distance ) | Specifies the minimum vertical distance between two table rows in a particular column. If the distance is smaller than specified, the rows are merged. The default distance is 0. | | Void IgnoreHorizontalSeparators() | Ignores horizontal separators when dividing the table into rows. | | Void DivideRowsBySeparators() | Detects rows relying on separators only and ignoring text. | | Void DivideRowsByMasterColumn( String columnName ) | Tells the activity to use the text of the column when dividing the table into rows. This function can be called multiple times. If a table on an image doesn't have the required column, the column from the next call of the function is used, etc. If all the columns are unavailable, the rows are detected in the whole table. | | Void MasterColumnTextAlignment( TextAlignmentInTableCell ) | Specifies text alignment in a table cell in the Master Column. Possible values: TextAlignment\_CellTop, TextAlignment\_CellBottom. Example: `MasterColumnTextAlignment: TextAlignment_CellBottom;` - the text is aligned to the bottom border of the cell. | | Void AddStopWord( String ) | Specifies the words for which separate rows mustn't be drawn. | | Void RowSplitters( YCoordinateArray, Logic isBodyTopIncluded = true, Logic isBodyBottomIncluded = true ) | Specifies separators to divide the table into rows: isBodyTopIncluded == true - specifies the top of the table body, isBodyBottomIncluded == true - specifies the bottom of the table body, isBodyTopIncluded == false - the top of the table body is detected automatically, isBodyBottomIncluded == false - the bottom of the table body is detected automatically. Any specified separators outside the table search area are ignored. Example: `let yArray = RepeatingGroup.AllInstances.GetYArray(1); RowSplitters( yArray );` | ## Multi-Page Table Parameters | Parameter | Description | | :-------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Void HeaderOnEachPage( Logic has = true ) | Specifies that the table header occurs on every page (at the beginning of each one-page sub-table). | | Void AddHeaderKeyHypotheses( HypothesisInstances, String columnName ) | Specifies a column name on multiple pages by means of a set of hypotheses for a subelement of a repeating group. | | Void FooterOnEachPage( Logic has = true ) | Specifies that the table footer occurs on every page. | | Void AddFooterKeyHypotheses( HypothesisInstances ) | Specifies a table footer on multiple pages by means of a set of hypotheses for a subelement of a repeating group. | | Void PreviousInstances( TableHypothesisInstances ) | Specifies the previous table instances if the table is inside a repeating group. It's assumed that the direction of instances is top to bottom, column boundaries have no shifts within the same page and may be slightly shifted horizontally between pages. The previous instances are used to search for or improve the search for columns if the table has no header or if the header isn't detected. | # Table Hypothesis Properties Source: https://docs.abbyy.com/vantage/documentation/advanced-designer/activities/flexilayout/table-hyp Understanding the properties of Table, Table header, Table footer, and Table body hypotheses in Advanced Designer. ## Table Hypothesis Properties A **Table** hypothesis has the following properties: | Property | Description | | :----------- | :------------------------------------------------------ | | Header found | Shows whether the table header has been found. | | Footer found | Shows whether the table footer has been found. | | Body found | Shows whether the table body has been found. | | Order name | The name of the detected order of columns in the table. | ## Table Header Hypothesis Properties A **Table header** hypothesis has the following properties: | Property | Description | | :--------------- | :----------------------------- | | Column name list | Shows the found table columns. | ## Table Footer Hypothesis Properties A **Table footer** hypothesis has no additional type-specific properties. ## Table Body Hypothesis Properties A **Table body** hypothesis has the following properties: | Property | Description | | :------------ | :------------------------------------------- | | Order name | Shows the name of the found column order. | | Found columns | Shows the names of the found columns. | | Rows number | Shows the number of rows found in the table. | # User Defined Properties Source: https://docs.abbyy.com/vantage/documentation/advanced-designer/activities/flexilayout/user-defined-properties Learn how to create and use typed variables that belong to elements in the FlexiLayout language. A user defined property is a typed variable that belongs to an element. These properties are defined in the External fields section. The following format should be observed: ``` Type1 Name1; ... TypeN NameN; ``` where Name is the name of the variable and Type is its type. When fields are created, they are initialized as follows: numerical fields are initialized with zero values, rectangles and regions are initialized with empty values, etc. Fields may be used in the element to which they belong and in any of the elements located below their element. The value of a field can be changed only in the element to which it belongs, and in other elements it is available as read only. The value of a complex expression that characterizes the hypothesis for an element may be computed and written into this property. This value may be accessed from any of the elements below, without computing it each time it is needed. This reduces the time required to match the FlexiLayout, obviates the need to copy a large expression into each of the elements, and makes the code more readable. To access a field of an element, the full name of the field is used in the following format: `ElementName.FieldName` (e.g. `SearchElements.StaticText1.x`). Within an element, its field may be accessed by name: `x`. In the case of a compound element, its subelements (at any level of nesting) may also access its elements by their short names. Within an element, the names of the fields must be unique. The names of elements of a compound element may not coincide with any of the field names in its subelements (at any level of nesting). Additionally, the names of the fields of a compound element may not coincide with any of the names of its subelements. ## Example This example searches for two address components: city (character string City) and subway station (character string Station). The subway station is specified only if the city is Sydney. To speed up FlexiLayout matching, we specify a fromSydney property for the City element. This property is `true` if the City element is detected and has the value `Sydney`, and `false` in all other cases. Code for the City element: **External fields** ``` logic fromSydney; ``` **Hypotheses Evaluation** ``` if( not IsNull and Value.Find( "Sydney" ) >= 0 ) then fromSydney = true; else fromSydney = false; ``` Subsequently, we use this property to search for the subway station. To speed up the matching process, we search for the station only if Sydney is detected as the City element. Code for the Station element: **Search Conditions** ``` if not City.fromSydney then dontfind; ```
Parameter | Description |
Void MinQuality( Real ) | Sets the minimum quality of the hypothesis. |
Void MaxErrors( Int ) | Sets the maximum number of errors in the hypothesis. |
Void MaxErrorsPart( Real ) | Sets the maximum percentage of errors in the hypothesis. |
Void MaxErrors( Int number, Real part ) | Sets the maximum number of errors in the hypothesis: number – absolute number, part – percentage. E.g.The code below specifies that the absolute number of errors may not exceed 3, and the percentage of errors may not exceed 20%. Note. Out of the two conditions the activity will use the strictest. |
Void MaxGapInLine( Distance ) | Sets the maximum distance between neighboring characters. When generating a hypothesis, the activity will add characters to the hypothesis until the distance between two neighboring characters does not exceed MaxGapInLine. E.g.The code below tells the activity that the maximum distance between neighboring characters may not exceed 5 mm, otherwise a null hypothesis is generated. |
Void MaxRelativeGapInLine( Real ) | Sets the maximum distance between neighboring characters expressed as a percentage of the line height. |
Void AllowChoppedWords( Logic ) | The flag specifies whether text objects which do not fit entirely within the left and right boundaries should be included into the hypothesis. The default value is True. E.g.The code below tells the activity to look for the element only among the text objects which fit entirely within the search area. |
Void MaxXOutsidePart( Real ) | Specifies the part of the text object that may lie outside the search area in the horizontal dimension. The part of the text object is specified by a number from 0 to 1. A text object is included in the hypothesis if the part of the text object outside the search area is not bigger than specified by this parameter. |
Void MaxYOutsidePart( Real ) | Specifies the part of the text object that may lie outside the search area in the vertical dimension. The part of the text object is specified by a number from 0 to 1. A text object is included in the hypothesis if the part of the text object outside the search area is not bigger than specified by this parameter. |
Void CaseSensitive( Logic Value=true ) | Distinguishes between lowercase and uppercase letters if set to True. |
Void IgnoreAccents( Logic value = true ) | Ignores/does not ignore diacritics when searching for text. If the value is set to True, diacritics will be ignored (for example, the words "café" and "cafe" will be treated as identical). |
Void SearchTextFromFile( String fileName, Int maxRecordsCount = 1000 ) | Specifies the set of strings to be searched on an image with the help of a fileName text file. For more information about using TXT files, see User Dictionaries and Static Text Element. To speed up the search, only the first maxRecordsCount variants are used (the default setting is 1000). E.g. |
Void SearchTextFromCatalog( String catalogParameterName, Int columnIndex, NamedValueArray searchCriteria = EmptyNamedValueArray, Int maxRecordsCount = 1000 ) | Retrieves values from the column with index columnIndex in the data catalog referenced by the catalogParameterName parameter and uses these values as the set of strings to be searched on an image. You determine column indexes using one of the following global functions: FieldNamesOfCatalog, GetCatalogColumnIndex, GetCatalogColumnIndices. The records may be filtered by the search criteria which are set using an array of named values, where each named value represents the column name and its expected value. The set of strings to find will contain only the values from the records which meet the search criteria. E.g.The code below tells the activity to search for values from the 2nd column of the data catalog referenced by the CompanyCatalog parameter: The code below filters the records based on the value of the "CompanyName" column. The value from the 2nd column will be added to the text to find only if the value of the "CompanyName" column for the corresponding record is "ABBYY". The code below uses an auxiliary method GetCatalogColumnIndex to get the column index by its name: To speed up the query, only the first maxRecordsCount records are accessed (the default setting is 1000). |
Void AllowIntersectPercent( Real ) | Specifies the maximum allowed percentage of vertical overlap for two lines of text (the default setting is 15). You may want to use this parameter for texts with tight line spacing. |
Void SearchText( String ) | Specifies the text that will be searched on an image. The string may contain several search variants separated with "|" (the OR operator). For more information, see Type-specific Properties of the Static Text Element. |
The following methods are available if the text to find consists of several words | |
Void NextLinePenalty( Real ) | Sets a penalty for line breaks. The penalty is a number from 0 to 1. The quality of the hypothesis will be multiplied by this number as many times as there are line breaks in the phrase. If line breaks are allowed in the phrase, set this parameter to 1 (multiplying the quality of the hypothesis by 1 will not downgrade its quality). |
Void OmissionPenalty( Real ) | Sets a penalty for missing words. The penalty is a number from 0 to 1. The quality of the hypothesis will be multiplied by this number as many times as there are missing words in the phrase. If some words may be absent in the phrase, set this parameter to 1 (multiplying the quality of the hypothesis by 1 will not downgrade its quality). |
Void WholeWordMode( Logic ) | Specifies whether only whole text objects must be considered as valid hypotheses. When set to True, hypotheses consisting of parts of words are ignored. The default setting is False. Note. This method is different from AllowChoppedWords in that AllowChoppedWords affects only hypotheses generated from words on the boundary of the search area, whereas WholeWordMode affects the generation of all hypotheses. |
Void AllowEmbeddedHypotheses( Logic ) | Sets the hypothesis formulation mode. To formulate all possible hypotheses (including overlapping and nested), set the value to True. To formulate hypotheses of maximum length, set to False. E.g.The code below tells the activity that it must formulate the longest hypothesis. |
Void MaxLineBreakDistance( Distance ) | Sets the horizontal distance between the words on different lines if line breaks are allowed in the phrase. |
Void SuggestOnlySimilarChars( Logic value ) | Specifies which characters the activity can use as replacement characters when performing a fuzzy search. When set to True, limits the activity to only using characters with a similar outline as replacement characters. |
Void AllowedTextRotations( TextRotations ) | Specifies a set of allowed orientations for the recognized text. A hypothesis will only be formulated if the recognized text has an orientation that is allowed by this parameter. |
Function | Description |
String Chr( Int ) | Returns a string using the specified Unicode code of the character (code must be written in decimal system). |
String LCase( String ) | Returns a string obtained from the specified string by changing all of its characters to lower case. |
String RealToStrVariants( Real value, String fractionalPartSeparators, Int maxDigitsCountInFractionalPart = 2 ) | Creates string representations, separated by a vertical bar ("|"), for the specified real number "value," decimal separators fractionalPartSeparators, and the maximum number of digits in the fractional part. For example, for the arguments 19, ".,", 2 the result is "19|19.0|19.00|19,0|19,00". |
| String representation of a data type. |
String RemoveSpaces( String ) | Returns a string obtained from the specified string by removing all of the spaces in the string. |
String UCase( String ) | Returns a string obtained from the specified string by changing all of its characters to upper case. |
Function | Description |
Logic IsReal( String numberString, String separators = ".,", Logic isStrictMode = false ) | Checks that the inputString string can be safely converted to a real number. The list of allowed decimal separators is set by the "separators" argument. |
Logic IsRealFuzzy( String, String separators = defaultDecimalSeparators, Logic isStrictMode = false ) | Checks if the string inputString can be safely converted into a real number taking into account possible recognition errors in the string. |
Logic IsInt( String inputString, Logic isStrictMode = false ) | Checks that the inputString string can be safely converted to an integer number. |
Logic IsIntFuzzy( String inputString, Logic isStrictMode = false ) | Checks if the string inputString can be safely converted into an integer taking into account possible recognition errors in the string. |
Real StrToRealFuzzy( String, String separators = defaultDecimalSeparators, Logic isStrictMode = false ) | Returns the result of converting the value of the string inputString into a real number taking into account possible recognition errors. |
Real StrToReal( String numberString, String separators = ".,", Logic isStrictMode = false ) | Returns the result of converting the inputString string into a real number. Spaces are omitted. Example |
Int StrToInt( String inputString, Logic isStrictMode = false ) | Returns the result of converting the inputString string value into an integer. Spaces are omitted. Example |
Int StrToIntFuzzy( String, Logic isStrictMode = false ) | Returns the result of converting the value of the string inputString into an integer taking into account possible recognition errors. |
Int LogicToInt( Logic value ) | Returns "1" if the value is |
| Operation | Syntax | Description | Example |
|---|---|---|---|
| create a search element | search\_element\_name( value\_expression ) search\_element\_name( token\_variable1 + token\_variable2 ) | The search element is assigned the value specified in the brackets. The value can be specified by a variable created in the left-hand part of the rule, or it can be passed directly as text in quotation marks. The values of several variables can be concatenated using the plus sign. | \[ t: "Contract" ] => kw\_Contract( t ); Assigns the value of the token t to the kw\_Contract search element. \[ "Contract" | "Contrato" ] => documentType( "Contract" ); Sets the document type to a constant string "Contract" if the specified keywords were found. \[ org1: @NEROrganization( same ) ]+ \[ kw\_doingBusinessAs: "d/b/a" | "d / b/ a" ] \[ org2: @NEROrganization( same )]+ => Supplier\_FullName( org1 + kw\_doingBusinessAs + org2 ); Finds two organization names joined by a "d/b/a" abbreviation and assigns the whole to the Supplier\_FullName search element. |
| create a group | group\_name id | A new instance of a group is created and assigned to a variable. You can then use this variable to create nested search elements. Note: If you attempt to create a second instance of a non-repeating group, the whole rule will not be executed. When working with non-repeating groups, write two separate rules: for when an instance already exists and for when it does not. | \["Grantor"] \[":"] \[p: @NERPerson]+ => Grantor group, group.FullName( p ); Creates a new instance of a Grantor group and assigns the person's name found in the left-hand part to the Grantor.FullName search element. |
| create a child search element in a group | id.search\_element\_name( value\_expression ) | The new search element is created within the group specified by a variable and receives the value specified in the brackets. | See example above. |
| create a child search element in a group from left-hand part | left\_hand\_part\_object.search\_element\_name( value\_expression ) | The new search element is created within the group found in the left-hand part of the rule. The value for the new search element is specified in the brackets. Note: For a non-repeating groups, the left-hand part of your rule can both check that an instance exists and assign a variable name to that group. The right-hand part can then use this variable name to create nested elements. | group: Tenant \[p: @NERPerson]+ \[]\{0,3} \["Tenant"] => group.FullName( p ); Accesses the existing instance of a Tenant group and assigns the person's name found in the left-hand part to the Tenant.FullName search element. \[org: @BuyerGroup.organization\_name]+ \[]\{3,9} \[addr: @NERAddress] => parent( obj( org ) ).buyer\_address( addr ); Finds an address named entity that is located close to the organization name and assigns this address to the buyer\_address search element in the same instance of BuyerGroup to which the organization\_name search element belongs. |
| Operation | Syntax | Description | Example |
|---|---|---|---|
| token | \[] | Square brackets enclose a single token. | \[] Any word or punctuation mark. |
| token text | "" | Quotation marks denote a token with the specified text. | \["Grantor"] A token with the word "Grantor". |
| variable | : | A colon is used to assign a name to the token sequence that follows it. Note: The variable will be available only within that same rule, that is, until the right-hand part is finished with a semicolon. | \[t: "Contract"] Finds a token that contains the word "Contract" and assigns it to the variable t. |
| lemma | L"word" Lemma"word" | "L" or "Lemma" before a word means that the search should find all forms of that word. | \[L"rule"] Tokens such as "rule", "rules", "ruled", and "ruling" will all be found. |
| regular expression | /regular expression/ | Single forward slashes enclose a regular expression. As with the Value from Regular Expression search elements, the PCRE2 regular expression syntax is used. | /\[1]?\d:\d\{2}\s+((\[ap].m.)|(\[AP]M))?/ The template will match the time in 12-hour format, for example, "2:00 p.m.", "9:34 AM". |
| option setting for regular expressions | /regular expression/i | The option setting can be put after the forward slash that closes the regular expression. The "i" option, for example, means case-insensitive matching of the regular expression. | /\[1]?\d:\d\{2}\s+(\[ap].?m.?)?/i This template simplifies the example above with the help of case-insensitive matching. It will match the time in 12-hour format, for example, "2:00 p.m.", "9:34 AM". |
| token predicates | \ | The token is first in a paragraph. | \["Section" \ The word "Section" starts the paragraph. You can use this, for example, to extract the section number immediately following this token. |
| token predicates | \ | The token is a punctuation mark. | \["Tenant"] \[\ The word "Tenant" may be followed by up to two punctuators, for example a closing bracket and a comma. |
| token predicates | \ | The token begins with a capital letter. | \[L"agreement" \ This template will match "Agreement" and "Agreements", but not "agreement". |
| token predicates | \ | Some, but not all, letters of the token are capitalized. | \[L"letter" \ This template will match, for example, "Letters" and "letteR". |
| token predicates | \ | The token is in all capital letters. | \[t: @NEROrganization \ This template will match organization named entities written in all caps. |
| logical OR | | | A vertical bar is used to specify alternative token text or alternative conditions for the token. | \["Lender" | "Co-Lender"] \["shall"] \["have"] This template will match either of these strings: "Lender shall have" or "Co-Lender shall have" |
| logical AND | space | Space is used as a logical conjunction for token conditions. | \[t: "Section" \ Finds a token that contains the word "Section" AND starts a paragraph. |
| object condition | @object\_name | An at sign ("@") checks that the token is located within an object region. The following objects are supported: Named entity objects, the same types that are also available as specialized search elements, prefixed by "NER": NERPerson, NEROrganization, NERAddress, NERLocation, NERDate, NERDuration, NERMoney; Search elements; Sentence - A separate object is created for each sentence in the text flow; Paragraph - A separate object is created for each paragraph in the text flow. | \[t: @NEROrganization]+ \["Lender"] Assigns the name t to a token sequence that contains a NEROrganization entity and is followed by the keyword "Lender". \[t: @NERPerson @Preamble\_Segment ]+ Finds a person's name in the preamble segment (represented by an Input field search element). |
| separating similar objects | @object\_name( same ) | "same" means that on a repeating token, the same object is matched to the sequence of tokens instead of several objects of this type. If the object condition is using a logical OR, "same" should not be used. | For example, if you have a list of people's names following one another, they will all be detected as NERPerson. To extract one person's name at a time, use the "same" condition. \[t: @NERPerson( same )]+ Assigns the name t to the first person found. |
| relative position | @object\_name( right\_to( another\_object )) @object\_name( left\_to( another\_object )) | "right\_to" means that object\_name is found after the another\_object specified in the brackets. "left\_to" means that object\_name is found before the another\_object specified in the brackets. | \[ t: @NERAddress( same, right\_to( id1 ), left\_to( id2 ) )] Finds a NERAddress named entity between id1 and id2. |
| logical OR (as used in object conditions) | | | A vertical bar can also be used as a logical disjunction for object conditions. | \[t: @NERPerson( right\_to( id1 ) | right\_to( id2 ) )] Assigns the name t to a person's name located either after id1 or after id2. |
| token sequence | space | Tokens in a sequence are separated by spaces. | \["Grantor"] \[":"] This template will match "Grantor:". Tokens may be specified simply for context, even if these words don't need to be extracted. |
| alternative token sequences | \[token1]|(\[token2]\[token3]) | A vertical bar is used to specify alternative token sequences. Round brackets set the priority. | \["will"] (\["start"] | (\["take"] \["place"])) \["on"] This template will match either of these strings: "will start on" or "will take place on". Note that if we had omitted the brackets, the template would also have matched "will start place on". The brackets ensure that the "take place" phrase is either present completely or not at all. Note: For more complex real-life cases of alternative token sequences, you may find it more convenient to write a separate rule for each alternative:\["will"] \["start"] \["on"]=>...;\["will"] \["take"] \["place"] \["on"]=>...; |
| optional token | \[]? | A question mark means that the token is optional. | \["Tenant"] \["."]? The word "Tenant" may be followed by a dot. |
| optional repeating token | \[]\* | An asterisk means that the token is optional and may be repeated several times. | \["Grantor"] \[]\* \["Tenant"] The keywords "Grantor" and "Tenant" may be separated by any number of tokens, or none. |
| required repeating token | \[]+ | A plus sign means that the token should be found at least once and may be repeated. | \[@NERPerson]+ Specifies that a person's name should be found, possibly over several tokens, because the name usually consists of several words. |
| token with specified number of repetitions | \[]\{n,} \[]\{n,m} | Numbers in curly brackets mean that the token should be repeated from n to m times. If the second number is not specified, the token should be repeated at least n times. Note: As you can see, \{0,} is equivalent to \*, while \{1,} is equivalent to +. | \["Grantor"] \[]\{1,3} \["Tenant"] The keywords "Grantor" and "Tenant" should be separated by 1 to 3 tokens. This may be more useful than \*, because you will be able to specify that the two keywords are not too distant from each other. |
• Windows 10
• Windows 11
• Windows Server 2008 R2 SP1 + Desktop Experience
• Windows Server 2012 + Desktop Experience
• Windows Server 2012 R2 + Desktop Experience
• Windows Server 2016 + Desktop Experience
• Windows Server 2019 + Desktop Experience | | **RAM** | 1 GB | | **Disk space** | 1 GB (including 200 MB for installation and sufficient disk space for scanned images) | | **Other requirements** | • A scanner with TWAIN or WIA support
• Video card and display with a resolution of 1024×768
• The computer where the station is installed must be connected to your domain
• Visual C++ 2015 Redistributable | ## ClickOnce Scanning Station | Component | Requirement | | :--------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **CPU** | 2 GHz or faster | | **Operating System** | • Windows 8.1
• Windows 10
• Windows 11
• Windows Server 2008 R2 SP1 + Desktop Experience
• Windows Server 2012 + Desktop Experience
• Windows Server 2012 R2 + Desktop Experience
• Windows Server 2016 + Desktop Experience
• Windows Server 2019 + Desktop Experience | | **RAM** | 1 GB | | **Disk space** | 1 GB (including 90 MB for installation and sufficient space for scanned images). The downloadable file is 70 MB. | | **Browser** | For ClickOnce deployment: Internet Explorer 11 | | **Other requirements** | • A scanner with TWAIN or WIA support
• Video card and display with a resolution of 1024×768
• Microsoft .NET Framework 4.5 or later | ## Related topics * [Install and run Scanning Station](/vantage/documentation/scanning-station/install-run) * [Scanning Station](/vantage/documentation/scanning-station/about) * [Appendix](/vantage/documentation/scanning-station/appendix/appendix) # Keyboard shortcuts Source: https://docs.abbyy.com/vantage/documentation/scanning-station/appendix/keyboard-shortcuts Complete list of keyboard shortcuts available in ABBYY Vantage Scanning Station. | Menu | Command | Keys | | :-------- | :----------------------------------- | :--------------- | | **File** | **New Batch** | Ctrl+N | | **File** | **Create Document** | Ctrl+Shift+C | | **File** | **Rename** | F2 | | **File** | **Disassemble Document** | Ctrl+Alt+D | | **File** | **Scan Pages** | Ctrl+S | | **File** | **Select and Scan...** | Ctrl+Shift+S | | **File** | **Insert Pages** | Ctrl+I | | **File** | **Stop** | Ctrl+Alt+S | | **File** | **Load Images...** | Ctrl+O | | **File** | **Check Batch Integrity** | F9 | | **File** | **Send Batch to Vantage** | Ctrl+E | | **File** | **Sending Options...** | Ctrl+Shift+E | | **File** | **Exit** | Alt+F4 | | **Edit** | **Undo** | Ctrl+Z | | **Edit** | **Redo** | Ctrl+Y | | **Edit** | **Cut** | Ctrl+X | | **Edit** | **Copy** | Ctrl+C | | **Edit** | **Paste** | Ctrl+V | | **Edit** | **Delete** | Del | | **Edit** | **Select All** | Ctrl+A | | **Edit** | **Separate Documents** | Ctrl+Alt+S | | **View** | **Show Processing Profiles** | Ctrl+Alt+P | | **View** | **Batch Registration Parameters** | Ctrl+B | | **View** | **Document Registration Parameters** | Ctrl+Shift+B | | **View** | **Go to Previous Page** | Ctrl+Shift+P | | **View** | **Go to Next Page** | Ctrl+P | | **View** | **Go to Previous Document** | Ctrl+Shift+D | | **View** | **Go to Next Document** | Ctrl+D | | **View** | **Scale → Zoom In** | Ctrl+Num+ | | **View** | **Scale → Zoom Out** | Ctrl+Num- | | **Page** | **Autocrop** | Ctrl+Alt+C | | **Page** | **Crop** | Alt+C | | **Page** | **Split** | Alt+S | | **Page** | **Rotate 90° Clockwise** | Ctrl+Shift+R | | **Page** | **Rotate 90° Counterclockwise** | Ctrl+Alt+R | | **Page** | **Rotate 180°** | Ctrl+Alt+Shift+R | | **Page** | **Invert** | Alt+I | | **Page** | **Remove Color Marks** | Alt+M | | **Page** | **Brightness and Contrast** | Alt+B | | **Page** | **Black & White** | Alt+W | | **Page** | **Apply Processing Profile** | Ctrl+Alt+Shift+P | | **Page** | **Load Full-Size Thumbnail** | Ctrl+F9 | | **Page** | **Properties...** | Alt+Enter | | **Tools** | **Batch Types...** | Ctrl+Shift+T | | **Tools** | **Processing Profiles...** | Alt+R | | **Help** | **Help Topics** | F1 | ## Related topics * [Main window menus](/vantage/documentation/scanning-station/interface/main-window-menus) * [Main window toolbars](/vantage/documentation/scanning-station/interface/main-window-toolbars) * [Appendix](/vantage/documentation/scanning-station/appendix/appendix) # Install Scanning Station Source: https://docs.abbyy.com/vantage/documentation/scanning-station/install-run Download, install, and connect Scanning Station to your Vantage server. ## Before you begin * Confirm your machine meets the [hardware and software requirements](/vantage/documentation/scanning-station/appendix/hardware-software-reqs). * Make sure you have a user account on the Vantage server you plan to connect to. ## Install Scanning Station