Skip to main content
The Commercial Invoice skill extracts data from commercial invoices. A commercial invoice is a customs declaration document that contains information about the parties involved in the transaction, the goods being transported (including their value), and the terms of delivery. The Commercial 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.

Supported Languages

  • English
  • German (New Spelling)

Extracted Fields

Consignee

FieldDescription
Consignee IDThe unique identifier of the consignee. This field is extracted only when a consignee data catalog is used.
NameThe name of the consignee.
AddressThe address of the consignee.
Tax IDThe international tax ID of the consignee.
Postal CodeThe postal code of the consignee. This field is extracted only when a consignee data catalog is used.
StreetThe Street component of the consignee address. This field is extracted only when a consignee data catalog is used.
CityThe City component of the consignee address. This field is extracted only when a consignee data catalog is used.
State or ProvinceThe State or Province component of the consignee address. This field is extracted only when a consignee data catalog is used.
CountryThe Country component of the consignee address. This field is extracted only when a consignee data catalog is used.

Vendor

FieldDescription
Vendor IDThe unique identifier of the sender of the goods. This field is extracted only when a vendor data catalog is used.
NameThe name of the sender of the goods.
AddressThe address of the sender of the goods.
Tax IDThe international tax ID of the sender of the goods.
National Tax IDThe national tax ID of the sender of the goods. This field is extracted only when a vendor data catalog is used.
IBANThe IBAN number of the sender of the goods. This field is extracted only when a vendor data catalog is used.
Bank CodeThe bank code of the sender of the goods. This field is extracted only when a vendor data catalog is used.
Bank AccountThe bank account of the sender of the goods. This field is extracted only when a vendor data catalog is used.
Postal CodeThe postal code of the sender of the goods. This field is extracted only when a vendor data catalog is used.
StreetThe Street component of the sender of the goods address. This field is extracted only when a vendor data catalog is used.
CityThe City component of the sender of the goods address. This field is extracted only when a vendor data catalog is used.
State or ProvinceThe State or Province component of the sender of the goods address. This field is extracted only when a vendor data catalog is used.
CountryThe Country component of the sender of the goods address. This field is extracted only when a vendor data catalog is used.

Ship to

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

Bill to

FieldDescription
NameThe name of the recipient of the invoice for the goods specified in the document.
AddressThe address of the recipient of the invoice for the goods specified in the document.

Invoice Information

FieldDescription
Invoice NumberThe number of the invoice.
Invoice DateThe date on which the invoice was issued.
Due DateThe date by which the invoice should be paid.
Country of OriginThe country where the goods were manufactured.
Country of ExportThe country from which the goods are being exported.
Country of DestinationThe country into which the goods are being imported.
INCO TermThe terms of shipment. Possible values:
EXW: EX Works
FCA: Free Carrier
FAS: Free Alongside Ship
FOB: Free On Board
CFR: Cost And Freight (variant: CNF)
CIF: Cost Insurance Freight
DAP: Delivered At Place (variant: DTU)
DPU: Delivered at Place Unloaded
CPT: Carriage Paid To
CIP: Carriage Insurance Paid
DDP: Delivered Duty Paid
DDU: Delivered Duty Unpaid
DAT: Delivered at Terminal.
WeightThe total weight of the goods.
Weight UoMThe unit of measurement used for the weight of the goods (such as kilos or pounds).
Total PalletsThe total number of pallets containing the goods.
TotalThe total price of the goods.
CurrencyThe currency of the price.

Additional Costs (repeating group)

FieldDescription
TypeThe type, amount, and currency of any additional costs, such as insurance, freight, or packing.
AmountThe type, amount, and currency of any additional costs, such as insurance, freight, or packing.
CurrencyThe type, amount, and currency of any additional costs, such as insurance, freight, or packing.

Line Items (repeating group)

FieldDescription
PositionThe number of the line item.
Country of OriginThe country where the line item was manufactured.
HS CodeThe Harmonized System code of the goods.
DescriptionA description of the line item.
QuantityThe number of units purchased.
UoMThe unit of measurement used for the line item.
Unit PriceThe price of one unit of the goods.
Total PriceThe total price of the line item, including additional charges and discounts.
CurrencyThe currency of the line item.
Net WeightThe net weight of the line item (that is, without the packaging).
Net Weight UoMThe unit of measurement used for the net weight (such as kilos or pounds).
Gross WeightThe gross weight of the line item (that is, with the packaging).
Gross Weight UoMThe unit of measurement used for the gross weight (such as kilos or pounds).

Key Fields

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

Validation Rules

RuleDescription
Sum of Line Items amount should be equal to TotalVerifies that the sum of all line item amounts and Additional Costs is equal to the total invoiced amount.
Separate currency from amount in money fieldsSplits the amount and the currency in the Total and Additional Costs fields and copies the currency into the Currency field if it is empty.
Separate currency from amount in Line ItemsSplits the amount and the currency in Line Items fields, and copies the currency into the Currency fields if they are empty.
Check item amountMultiplies the number of units in the line item by the price of one unit and checks that the result is equal to the total price of the line item.
Complete currency in amounts fieldsIf the Currency field next to the Total field is empty, the rule will populate that field with the currency indicated in the Currency field in the Line Items group. If multiple currencies are specified in the Line Items group, the Currency field will be left empty. Likewise, the rule will populate the Currency field in the Line Items group with the currency from the main Currency field. This rule also applies to the Currency field in the Additional Costs group. Only ISO-standard alphabetic currency values are copied. If the currency is specified using a symbol (e.g., "","","US", "€", "US", “CA","AU", "AU”, “NZ$”, or ”£”), the value is still copied, but is then formatted to be the standard alphabetic value for that currency type
Check currency in amounts fieldsChecks that the currency in the Currency field matches the currency code in the invoice and in the line items. Offers a list of suggestions if the field is empty or if the value doesn’t match the currency code.
Add INCOTerm value from the listIf the INCO Term has been detected on the document and is filled in, adds a standardized INCOTerm value and its expansion for that delivery type. Example: DDP: Delivered Duty Paid
Vendor DB lookupChecks information about the vendor against the corresponding catalog. If the catalog contains information about that vendor, but the values are either different or incomplete, fills in the appropriate fields using data from the catalog. The ID, Name, Street, CountryCode, and Consignee ID fields should be filled in in the vendor catalog.
Consignee DB lookupChecks information about the consignee against the corresponding catalog. If the catalog contains information about the consignee, but the values are either different or incomplete, fills in the appropriate fields using data from the catalog. The ID, Name, Street, and CountryCode fields should be filled in in the consignee catalog.

Parameters

The Commercial Invoice skill has default parameters that refer to data catalogs used for Vendor and Consignee lookup. You can change the values of these parameters in Vantage or Advanced Designer to modify field extraction.
ParameterDescription
CommercialInvoiceVendorsThe predefined data catalog used for Vendor lookup. The default value of this parameter is CommercialInvoiceVendors. You can change this value by choosing another available data catalog of the same type (Document Issuer Companies).
ConsigneesThe predefined data catalog used for Consignee lookup. The default value of this parameter is Consignees. You can change this value by choosing another available data catalog of the same type (Document Receiver Companies).