JSON field

Description

Possible Values

Comments

id

Veryfi Uniqe ID

id is Veryfi's unique ID for each document. Every time Veryfi processes the invoice, it is assigned a unique ID

is_duplicate

Is this document a duplicate

0 or 1

if a document has been processed before, Veryfi will identify it and notify

img_url

Download URI for submitted image

img_thumbnail_url

Download URI for thumbnail image

Difference Between Thumbnail and Image is that thumbnail is a small version of a larger graphic. By clicking on a thumbnail, it will display a larger image. Some invoices have a thumbnail, some have the whole image

document_type

Type of document

"receipt", "invoice", "purchase_order", "check"

document_title

Title on the document

"document_title" is the title on the document usually at the very top of the document: "Invoice", "Vendor Credit", "Purchase Order" etc.

category

Document category/class

date

Document issue/transaction date

Date when invoice was issued

due_date

Due date for invoice or bill

order_date

Order date

Date when the goods/services were ordered

delivery_date

Delivery date

Date when the order was delivered.

ship_date

Shipping date

Date when the order was shipped

created

Creation date of the document (UTC)

Date when a document was processed (uploaded) by Veryfi AI technology

updated

Last update date (UTC)

Date with time when the last update was made to the document

currency_code

Currency code (ISO 4217)

card_number

Credit/debit card number

Last 4 digits of CC number which the invoice has been paid by

payment_type

One of the payment types

visa, master_card, american_express, cash, discover, paypal

Payment type of CC (visa, mastercard, etc)

payment_terms

Payment terms

tracking_number

Tracking number

Unique number assigned to packages when they are shipped.

subtotal

Subtotal amount

We try to find it on the receipt/invoice. If we do not find it, we calculate it as Subtotal = Total Spend - Tax - Tip

tax

Total tax amount

rounding

Rounding amount

Some vendors give a "discount" (rounding) so they do not have to pay with small monets (for ex, if a customer paid with cash and vendor did not have a change of 4 cent, he would round the number and return 5 cent)

cashback

Cashback amount

Cash amount customer withdrawn when making a purchase. Can be found on receipts, not present on invoices

tax_lines {

Tax breakdown lines

Tax line (order, name, rate, total amount) for each tax.

order

Tax line sequence number

order (position) of the tax line in the list of taxes

name

Tax name

rate

Tax rate

Tax percentage (10%, 9.95% ect.)

total

Tax amount

Total Vat tax, tax, iva, they all will be extracted into this “tax” field. If document has multiple taxes on it those taxes will be returned in the list inside “taxes” field. Note there are a couple of countries in the world that have 3 decimal places after the dot. If planning to support those, when choosing type for tax/total fields make sure it can handle 3 decimal places.

}

tip

Tip amount

Small amount of money that is given to someone for a service, also called Gratuity. Usually present on receipts not invoices.

discount

Discount amount

shipping

Shipping amount

Cost of Shipping / Delivery

total

Document total amount

Grand Total amount including subtotal, tax, fees etc

service_start_date

Start date of service, e.g. flight departure date or hotel arrival date

service_end_date

End date of service, e.g. flight arrival date or hotel departure date

invoice_number

Invoice number

account_number

Account number

Customer account number. If it is on the document, we extract it.

purchase_order_number

Purchase order number

document_reference_number

Reference number

Reference numbers are commonly used to identify items for a particular customer

abn_number

ABN

Australian business number. It is only for Australian invoices.

bill_to_name

Bill to name

Name of the person or business who is billed for the amount on the invoice

bill_to_address

Bill to address

Billing Address information of the customer

bill_to_vat_number

Bill to VAT number

Customer's VAT number, usually present on the European invoices

bill_to_email

Bill to email address

Billing email address of the customer

bill_to_phone_number

Bill to phone number

Billing phone number of the customer

ship_to_name

Ship to name

Name of the person or business who will accept the dilivery of this order

ship_to_address

Ship to address

Address where the order has to be delivered

vat_number

Vendor Vat number

vendor {

Vendor details

Vendor details

name

Vendor name - cleaned

name is an actual vendor name after cleaning and transformation, for example "fb.com" would be converted to "Facebook, Inc."

raw_name

Vendor name - raw

Extracted Vendor name from the image

address

Vendor address

lat

Vendor latitude

Latitude of the vendor location. It is extracted by Veryfi AI technology

lng

Vendor longitude

Longitude of the vendor's location. It is extracted by Veryfi AI technology

phone_number

Vendor phone number

Phone number of the vendor.

fax_number

Vendor fax number

Fax number of the vendor.

web

Vendor website URI

Website address of the vendor

email

Vendor email address

Vendor email address

vendor_logo

Vendor logo image download URI

Graphic mark, emblem, or symbol used to aid and promote vendor's recognition.

category

Vendor Category

"Grocery", "Fuel", "Restaurant", "Hardware", "Online Shopping", "Fast Food", "Department Store", "Convenience", "Taxi", "Drugstore / Pharmacy", "Hotel", "Nurseries & Gardening", "Food", "Coffee", "Utilities", "Bakery", "Parking", "Bar", "Electronics Store", "Building Supplies", "Office Equipment", "Health", "Clothing Store", "Online Service", "Furniture Store", "Auto Parts", "General Contractor", "Pizza", "Car Repair", "Bank", "Shipping", "Arts & Crafts Store", "Airlines", "Cafe", "Home Goods Store", "Transportation", "Car Wash", "Insurance", "Car Rental", "Toll", "Shoe Store", "Book Store", "Auto", "Movie Theater", "ATM", "Laundry", "Airport", "Entertainment", "Hair Care", "Ice Cream Shop", "Market", "Rent", "Florist", "Farm", "Gym / Fitness Center", "Brewery", "Food Court", "Garage", "Catering", "Baggage", "Airport Parking", "Daycare", "Delivery"

vendor_reg_number

Vendor registration number

Vendor registration number, for the US it would be EIN (Employer Identification Number) Some countries require Vendor ID to be listed on every invoice

}

line_items {

Line items

Line items is the list of products or services purchased/ordered

id

Veryfi Unique Line Item ID

Veryfi's internal unique ID for this product/service

order

Line item sequence number

order of the product in the list of line items (products purchased) Not related to PO

type

Line item type

"tax", "parking", "service", "fee", "product", "food", "transportation", "fuel", "discount", "alcohol", "tobacco"

Veryfi categorizes each line into one of those categories (types) listed in column "C"

date

Line item date (often exists on hotel folios)

line items of service invoices usualy contain date of the service received. This date is extracted into its own field.

description

Line item description

Description of the product or service purchased on the invoice line

sku

Line item SKU

Stock Keeping Unit, a unique number associated with a product

price

Line item unit price

quantity

Line item quantity

unit_of_measure

Line item unit of measure

weight

Line item weight

Weight of the material product on the line item, usually present on logistic invoices

tax_rate

Line item tax rate

What tax rate is applicable for this product. For example in some products may have 5% tax rate and some may be 15%

tax

Line item tax name

discount

Line item discount amount

total

Line item total amount

}

vendor_bank_number

Vendor bank number

vendor_bank_swift

Vendor bank SWIFT code

Society for Worldwide Interbank Financial Telecommunications, part of the Invoice Remittance information

vendor_account_number

Vendor bank account number

Bank account number of the Vendor, part of the Invoice Remittance information

vendor_bank_name

Vendor bank name

Bank name, part of the Invoice Remittance information

vendor_iban

Vendor IBAN

International Bank Account Number, part of the Invoice Remittance information

ocr_text

OCR text extracted from submitted document

Full text extracted from the document

total_weight

Total weight of all the items listed on the invoice

total_weight_list

List of all the weights (net, gross) on the invoice

Some invoices have both weights of the items ordered Gross and Net, in this case this list will contain both of the weight

Please note, not all the fields from the list above are enabled for user accounts from the start. If you would like us to add more fields from the list to your account, please contact support@veryfi.com

Other related Articles:

What Document Types Veryfi Supports

Languages Veryfi OCR API works with

File formats Veryfi supports

Want to know if submitted image is ok or blurry

How to Improve the Accuracy

Did this answer your question?