Accounts Receivable Paid Invoice Import Format

NOTE For general information on using imports, see Imports FAQ.

The format for the Accounts Receivable Paid Invoice Import consists of a data file containing several records.

The import file may include three types of records: (H)eader, (I)tem and (M)iscellaneous.

One (H)eader record is required for each accounts receivable invoice being imported. A (H)eader record is required to have at least one (I)tem or one (M)iscellaneous record; but may have multiple of each.

(I)tem records are used for product/service line item detail on an invoice (one (I)tem record for each product/service line item on an accounts receivable invoice).

(M)iscellaneous records are used for additional charges in Apprise. (I)tem and (M)iscellaneous records must immediately follow the related (H)eader record in the file.

The following tables lists the format for importing a header, item, or miscellaneous record.

Header Record

Column

Position

Field

Maximum Length

Format

Required

Description

A

1

Record Type

1

Character

Yes

Enter H to specify a header record.

B

2

Customer Code

12

Character

Yes

Enter a valid customer code. For information on setting up customer codes, see Customer Maintenance.

C

3

Reference Type

2

Character

No

Enter one of the following reference types:

  • IN for an invoice

  • CM for a credit memo

  • DM for a debit memo

If this field is blank, it defaults to IN.

D

4

Reference Number

12

Character

Yes

Enter a reference number (invoice number). The reference number must be unique.

E

5

Customer Purchase Order Number

20

Character

No

Enter the customer purchase order number.

F

6

Total Amount

19

->>>,>>>,>>>,>>9.99

Yes

Enter the total monetary amount of the accounts receivable invoice. This amount must equal the sum of item and miscellaneous records for the invoice (including VAT if applicable). A positive amount increases accounts receivable and a negative amount decreases accounts receivable.

G

7

Currency

8

Character

No

Enter the invoice currency. If this field is left blank, the currency defaults from the customer record.

H

8

Sales Type

8

Character

No

Enter the sales type of the invoice.

I

9

Reference Date

10

99/99/9999

Yes

Enter the reference (invoice) date.

J

10

Due Date

10

99/99/9999

Yes

Enter the invoice due date.

K

11

Payment Terms

12

Character

No

Enter a valid payment terms code. For information on setting up payment terms codes, see Payment Terms Maintenance. If this field is blank, the payment terms code defaults from the customer record.

L

12

Ship-To Address Name

30

Character

No

Enter the ship-to address name for the invoice. If this field is blank, then all ship-to address data defaults from the customer's default ship-to address.

M

13

Ship-To Address 1

30

Character

No

Enter the first line of the ship-to address for the invoice. If this field is blank, it defaults from the customer's default ship-to address.

N

14

Ship-To Address 2

30

Character

No

Enter the second line of the ship-to address for the invoice. If this field is blank, it defaults from the customer's default ship-to address.

O

15

Ship-To Address 3

30

Character

No

Enter the third line of the ship-to address for the invoice. If this field is blank, it defaults from the customer's default ship-to address.

P

16

Ship-To City

40

Character

No

Enter the city of the ship-to address for the invoice. If this field is blank, it defaults from the customer's default ship-to address.

Q

17

Ship-To State/Province

3

Character

No

Enter the state or province of the ship-to address for the invoice. If this field is blank, it defaults from the customer's default ship-to address. This field is validated. You must enter a valid state or province.

R

18

Ship-To Postal Code

11

Character

No

Enter the postal code of the ship-to address for the invoice. If this field is blank, it defaults from the customer's default ship-to address.

The format of the postal code is set up for the country in Country Maintenance, and can optionally be set up to be validated. For information on setting up postal codes, see Postal Code Maintenance.

S

19

Ship-To Country

10

Character

No

Enter the country of the ship-to address for the invoice. If this field is blank, it defaults from the customer's default ship-to address. This field is validated. You must enter a valid country.

T

20

Ship-To Phone Number

12

Character

No

Enter the phone number of the ship-to address for the invoice. If this field is blank, it defaults from the customer's default ship-to address. The format of the telephone number is set up in Country Maintenance.

U

21

Ship-To Fax Number

12

Character

No

Enter the fax number of the ship-to address for the invoice. If this field is blank, it defaults from the customer's default ship-to address. The format of the telephone number is set up in Country Maintenance.

V

22

Bill-To Address Name

30

Character

No

Enter the bill-to address name for the invoice. If this field is left blank then all bill-to address data defaults from the customer's default bill-to address.

W

23

Bill-To Address 1

30

Character

No

Enter the first line of the bill-to address for the invoice. If this field is blank, it defaults from the customer's default bill-to address.

X

24

Bill-To Address 2

30

Character

No

Enter the second line of the bill-to address for the invoice. If this field is blank, it defaults from the customer's default bill-to address.

Y

25

Bill-To Address 3

30

Character

No

Enter the third line of the bill-to address for the invoice. If this field is blank, it defaults from the customer's default bill-to address.

Z

26

Bill-To City

40

Character

No

Enter the city of the bill-to address for the invoice. If this field is blank, it defaults from the customer's default bill-to address.

AA

27

Bill-To State/Province

3

Character

No

Enter the state or province of the bill-to address for the invoice. If this field is blank, it defaults from the customer's default bill-to address. This field is validated. You must enter a valid state or province.

AB

28

Bill-To Postal Code

11

Character

No

Enter the postal code of the bill-to address for the invoice. If this field is blank, it defaults from the customer's default bill-to address.

The format of the postal code is set up for the country in Country Maintenance, and can optionally be set up to be validated. For information on setting up postal codes, see Postal Code Maintenance.

AC

29

Bill-To Country

10

Character

No

Enter the country of the bill-to address for the invoice. If this field is blank, it defaults from the customer's default bill-to address. This field is validated. You must enter a valid country.

AD

30

Bill-To Phone Number

12

Character

No

Enter the phone number of the bill-to address for the invoice. If this field is blank, it defaults from the customer's default bill-to address. The format of the telephone number is set up in Country Maintenance.

AE

31

Bill-To Fax Number

12

Character

No

Enter the fax number of the bill-to address for the invoice. If this field is blank, it defaults from the customer's default bill-to address. The format of the telephone number is set up in Country Maintenance.

AF

32

Discount Amount

18

->>,>>>,>>>,>>9.99

No

Enter the invoice discount amount.

AG

33

Sales Tax

18

>>>,>>>,>>>,>>9.99

No

Enter the sales tax amount.

AH

34

Sales Location

3

Character

Yes, only if a customer has no default sales location

Enter a valid sales location prefix. If this field is left blank, the sales location defaults from the customer default.

AI

35

Invoice Notes

255

Character

No

Enter notes to place on the invoice.

AJ

36

Sale Station

8

Character

No

Enter the sale station for the invoice or memo.

AK

37

Related Order Number

12

Character

No

Enter the related order number.

AL

38

Sales Representative 1

12

Character

No

Enter a valid first sales representative for the invoice. If this field is blank, it defaults to the first sales representative for the customer.

AM

39

Sales Representative 2

12

Character

No

Enter a valid second sales representative for the invoice. If this field is blank, it defaults to the second sales representative for the customer.

AN

40

Posting Period

2

Character

Yes, only if you enter a posting year in the Posting Year field

Enter the posting period for the invoice. This must be an open period in the Accounts Receivable module, and must be in the posting year entered in the Posting Year field. If this field is blank, the period defaults to the default current period in the Accounts Receivable module. You must enter a posting year in the Posting Year field if you enter a posting period.

AO

41

Posting Year

4

Character

Yes, only if you enter a posting period in the Posting Period field

Enter the posting year for the invoice. This must be an open year in the Accounts Receivable module. If this field is blank, the year defaults to the default current year in the Accounts Receivable module. You must enter a posting period in the Posting Period field if you enter a posting year.

AP

42

Tax Exempt

3

Yes/No

No

Enter Yes if the invoice is tax exempt or No if it is not. If this field is blank, it defaults to No.

AQ

43

Tax Exempt Number

20

Character

Yes, only if Yes is entered for the Tax Exempt field.

If the invoice is tax exempt, enter the tax exemption number.

AR

44

Currency Exchange Rate

15

>>,>>9.9999<<<<

Yes, only if the invoice is in a foreign currency

Enter the currency exchange rate for the invoice.

AS

45

VAT Date

10

99/99/9999

No

Enter the VAT date used to determine the exchange rate for VAT transactions.

AT

46

VAT Taxable

3

Yes/No

No

Enter Yes if VAT is assessed for the invoice.

Enter No if VAT is not assessed for the invoice.

AU

47

VAT Exempt Reason Code

20

Character

No

If the invoice is exempt for VAT, enter a VAT exempt reason code. For information on setting up VAT exempt reason codes, see VAT Exempt Reason Maintenance.

AV

48

Total VAT Amount

>>,>>>,>>9.99<<

Decimal

No

Enter the total VAT amount of the invoice.

AW

49

Ship-To County

20

Character

No

Enter the county of the ship-to address for the invoice or memo. If this field is blank, it defaults from the customer's default ship-to address.

AX

50

Bill-To County

20

Character

No

Enter the county of the bill-to address for the invoice or memo. If this field is blank, it defaults from the customer's default bill-to address.

AY

51

Ship-To Tax Jurisdiction

12

Character

No

Enter a valid tax jurisdiction for the ship-to address of the invoice or memo. You can enter None if the customer is not charged tax, and if the None tax jurisdiction is set up. For information on setting up tax jurisdictions, see Sales Tax Jurisdiction Maintenance.

If the Ship-To Address Name field (position 12) is blank, this defaults from the customer's default ship-to address.

Item Record

Column

Position

Field

Maximum Length

Format

Required

Description

A

1

Record Type

1

Character

Yes

Enter I to specify a line item record.

B

2

Customer Code

12

Character

Yes

Enter a valid customer code. For information on setting up customer codes, see Customer Maintenance.

C

3

Reference Type

2

Character

No

Enter one of the following reference types:

  • IN for an invoice

  • CM for a credit memo

  • DM for a debit memo

If this field is blank, it defaults to IN.

D

4

Reference Number

12

Character

Yes

Enter a reference number (invoice number). The reference number must be unique.

E

5

Sequence Number

9

>,>>>,>>9

Yes

Enter a sequence number for the line item record. This number must be unique for a specific header record.

F

6

Quantity

16

>>>,>>>,>>9.99<<

Yes

Enter the quantity for the line item.

G

7

Unit of Measure

8

Character

Yes

Enter a valid unit of measure for the line item.

H

8

Product Code

40

Character

Yes

Enter a valid product code. For information on how to set up product codes, see Product Maintenance.

I

9

Unit Price

17

->>>,>>>,>>9.99<<

Yes

Enter the unit price for the line item.

J

10

Taxable Item

3

Yes/No

No

Enter Yes if the line item is taxable or No if it is not taxable. If this field is blank, it defaults to Yes.

K

11

Product Name

30

Character

No

Enter the product name for the line item. If this field is left blank, it defaults to the product name for the product code entered in the Product Code field.

L

12

Product Description

30

Character

No

Enter the product description for the line item. If this field is left blank, it defaults to the product name for the product code entered in the Product Code field.

M

13

Product Detail Description

256

Character

No

Enter the detailed product description for the line item. If this field is left blank, it defaults to the product name for the product code entered in the Product Code field.

N

14

Price Adjustment

17

->>>,>>>,>>9.99<<

No

Enter the price adjustment per unit.

O

15

Extended Price

17

->>>,>>>,>>9.99<<

Yes

Enter the extended price for the line item.

P

16

Accounting Cost

17

->>>,>>>,>>9.99<<

Yes

Enter the extended cost for the line item.

Q

17

Return Code

10

Character

Yes, only if CM is entered for the Reference Type field.

Enter the return reason code for the line item.

R

18

Shipping Location Prefix

3

Character

Yes

Enter a valid shipping location prefix for the line item.

S

19

Sales Location Prefix

3

Character

Yes

Enter a valid sales location prefix for the line item.

T

20

Line Item Sales Representative

12

Character

No

Enter the sales representative for the line item. If this field is blank, it defaults to the sales representative entered for the Sales Representative 1 field in the Header record (position 38).

U

21

VAT Taxable

3

Yes/No

No

Enter Yes if VAT is assessed for the line item.

Enter No if VAT is not assessed for the line item.

V

22

VAT Exempt Reason Code

20

Character

No

If the line item is exempt for VAT, enter a VAT exempt reason code. For information on setting up VAT exempt reason codes, see VAT Exempt Reason Maintenance.

W

23

Line Item VAT Amount

>>,>>>,>>9.99<<

Decimal

No

Enter the VAT amount for the line item.

X

24

Triangulation

3

Yes/No

No

Enter Yes if the invoice qualifies for VAT triangulation. Enter No if it does not.

Y

25

Inventory Cost Currency Exchange Rate

15

>>,>>9.9999<<<<

No

Enter the currency conversion rate between the inventory currency and the functional currency. If this field is blank, the conversion rate is calculated based on the invoice date and the ship-from location.

Miscellaneous Record

Column

Position

Field

Maximum Length

Format

Required

Description

A

1

Record Type

1

Character

Yes

Enter M to specify a miscellaneous record.

B

2

Customer Code

12

Character

Yes

Enter a valid customer code. For information on setting up customer codes, see Customer Maintenance.

C

3

Reference Type

2

Character

No

Enter one of the following reference types:

  • IN for an invoice

  • CM for a credit memo

  • DM for a debit memo

If this field is blank, it defaults to IN.

D

4

Reference Number

12

Character

Yes

Enter a reference number (invoice number). The reference number must be unique.

E

5

Additional Charge Type

10

Character

Yes

Enter a valid additional charge type. The description for the miscellaneous record defaults to the description for the entered additional charge type.

F

6

Additional Charge Amount

17

->>>,>>>,>>9.99<<

Yes

Enter the total amount of the additional charge.

G

7

Sequence Number

9

>,>>>,>>9

Yes

Enter a sequence number for the miscellaneous record. This number must be unique for a specific header record.

H

8

VAT Taxable

3

Yes/No

No

Enter Yes if VAT is assessed for the miscellaneous item.

Enter No if VAT is not assessed for the miscellaneous item.

I

9

VAT Exempt Reason Code

20

Character

No

If the miscellaneous item is not VAT taxable, but is on a VAT-taxable invoice or memo, enter a VAT exempt reason code to explain why the miscellaneous item is exempt from VAT. For information on setting up VAT exempt reason codes, see VAT Exempt Reason Maintenance. This defaults from the invoice or memo, but if the invoice or memo is VAT taxable, this defaults from the selected miscellaneous item.

J

10

VAT Amount

>>,>>>,>>9.99<<

Integer

No

Enter the VAT amount for the miscellaneous line item.

K

11

VAT Class Country

10

Character

No

Enter a VAT class country for the miscellaneous item

L

12

VAT Class Code

20

Character

No

Enter a valid VAT class code for the miscellaneous item. For information on setting up VAT class codes, see VAT Class Maintenance.

Prerequisites

Before using this import, the following must be set up: