Add Customer

Use this service to import Customer information.

WSDL: AddCustomer.jws

Method: AddCustomer

Enhanced Authentication

Underlying File Maintenance

Prior to importing Customer information, the following file maintenance areas must be completed:

  • System Administration > Installation > Accounts Receivable

  • System Administration > Installation > General Ledger > G/L Master File Maintenance

  • System Administration > Installation > Accounts Receivable > Sales Tax Code Maintenance

  • System Administration > Installation > Accounts Receivable > Transaction Code File Maintenance

  • System Administration > Installation > Accounts Receivable > Salesperson Code Maintenance

  • System Administration > Installation > Accounts Receivable > Terms Code File Maintenance

  • System Administration > Installation > Accounts Receivable > Customer User-Defined Fields Maintenance

Assumptions and Dependencies

  • The Customer Master cost center flag is shared. The Customer import will validate that the company has the cost center option set to Pending or Yes and will set the default for the new Customer to Shared.

  • The Customers status will default to (A)ctive.

  • The Contact_1 field will be defined as the Primary Contact.

  • The Contact_2 and Contact_3 fields will be additional contacts.

  • The following field names will be defined by the Accounts Receivable Installation screen if left blank:

    • Standard_Retention_Percent

    • Statement_Flag

    • Finance_Charge_Tran_Code

    • Finance_Charge

  • This Web Service will work with the defined Workflow process in Spectrum.

  • The Authorized ID must have the user-defined fields defined, or mapped, for this Web Service.

Field Descriptions

Use the table below for reference when using this service.

Note: The Authorization_ID and GUID elements are not shown on the Spectrum Excel Office Add-in templates for data entry points.

Excel

Element Name

Description

Req

Type

Max

Format

Validation

Authorization_ID

Authorization ID to access the server

YES

Text

20

Data Exchange Installation Screen

GUID

Unique reference number created by programming

Text

36

** See GUID definition

B

Company_Code

Company Code

YES

Text

3

Valid Company in Spectrum

C

Customer_Code

Customer Code

YES

Text

10

Unique identifier / No commas

UPPERCASE FORMAT-NO SYMBOLS

D

Name

Customer Name

YES

Text

30

No commas

E

Alpha_Sort

Customer Alpha Ref

Text

8

No commas, created if blank

F

Type

Customer Type

Text

10

G

Address_1

Address 1

Text

30

H

Address_2

Address 2

Text

30

I

City

City

Text

25

J

State

State

Text

2

2 character postal abbreviation

K

Zip_Code

Zip Code

Text

10

L

Phone

Phone Number

Text

14

Formatted for example, (206) 555-1212 or 123-123-1224 or 123-1233 or 1231231225.

Remove the dashes from format when sending to Spectrum.

M

Fax_Phone

Fax #

Text

14

Formatted for example, (206) 555-1212 or 123-123-1224 or 123-1233 or 1231231225.

Remove the dashes from format when sending to Spectrum.

N

Contact_1

Contact 1

Text

20

No commas

O

Contact_2

Contact 2

Text

20

No commas

P

Contact_3

Contact 3

Text

20

No commas

Q

Salesperson

Salesman Code

Text

3

Salesperson Code Maintenance

R

Terms_Code

Terms Code

YES

Text

1

Terms Code File Maintenance

S

Standard_Retention_Percent

Default Retention (Holdback) %

Numeric

7

Enter 10.5% as 10.5. Positive numbers only.

Defaults from AR Installation screen if left blank.

T

Taxable_Flag

Taxable

Text

1

(Y)es or(N)o only

U

Sales_Tax_Code

Sales (Providence) Tax Code

YES

Text

15

Sales Tax Code Maintenance

V

Resale_Number

Resale Cert. #

Text

15

W

Resale_Exp_Date

Resale Exp. Date

Date

10

Enter as: MM/DD/CCYY (for example, 01/05/2010)

X

Statement_Flag

Send Statement?

Text

1

(Y)es or(N)o only. Defaults to Y if left blank.

Y

Finance_Charge_Tran_Code

Finance Charge Code

Text

10

Transaction Code File Maintenance. Defaults from AR Installation screen if left blank.

Z

Finance_Charge

Finance Charge %

Numeric

6

Enter 10.5% as 10.5. Positive numbers only.

If Finance_Charge_Tran_Code is blank then defaults from AR Installation screen if left blank.

AA

Price_Level_Material

Work Order Material Level

Numeric

1

1-5 only

Recommend input for clients with the WO : TM : OP or SI modules

AB

Price_Level_Labor

Work Order Labor Level

Numeric

1

1-5 only

Recommend input for clients with the WO : TM : OP or SI modules

AC

Credit_Limit

Credit Limit

Numeric

14

AD

Date_Created

Date Established

Date

10

Enter as: MM/DD/CCYY (for example, 01/05/2010)

If left blank then it will use the current date in the system

AE

Customer_Email

Customer Email

Text

70

Example: John@xxx.com

Must be the basic layout for an email address.

AF

Markup_Code

Non-stock Markup

Text

10

Non-Stock Markup Codes

AG

UDF1

User Defined Alpha/Numeric/Date 1

+

20

Web Service Authorization ID Service UDF defined.

AH

UDF2

User Defined Alpha/Numeric/Date 2

+

20

Web Service Authorization ID Service UDF defined.

AI

UDF3

User Defined Alpha/Numeric/Date 3

+

20

Web Service Authorization ID Service UDF defined.

AJ

UDF4

User Defined Alpha/Numeric/Date 4

+

20

Web Service Authorization ID Service UDF defined.

AK

UDF5

User Defined Alpha/Numeric/Date 5

+

20

Web Service Authorization ID Service UDF defined.

AL

UDF6

User Defined Alpha/Numeric/Date 6

+

20

Web Service Authorization ID Service UDF defined.

AM

UDF7

User Defined Alpha/Numeric/Date 7

+

20

Web Service Authorization ID Service UDF defined.

AN

UDF8

User Defined Alpha/Numeric/Date 8

+

20

Web Service Authorization ID Service UDF defined.

AO

UDF9

User Defined Alpha/Numeric/Date 9

+

20

Web Service Authorization ID Service UDF defined.

AP

UDF10

User Defined Alpha/Numeric/Date 10

+

20

Web Service Authorization ID Service UDF defined.

AQ

UDF11

User Defined Alpha/Numeric/Date 11

+

20

Web Service Authorization ID Service UDF defined.

AR

UDF12

User Defined Alpha/Numeric/Date 12

+

20

Web Service Authorization ID Service UDF defined.

AS

UDF13

User Defined Alpha/Numeric/Date 13

+

20

Web Service Authorization ID Service UDF defined.

AT

UDF14

User Defined Alpha/Numeric/Date 14

+

20

Web Service Authorization ID Service UDF defined.

AU

UDF15

User Defined Alpha/Numeric/Date 15

+

20

Web Service Authorization ID Service UDF defined.

AV

UDF16

User Defined Alpha/Numeric/Date 16

+

20

Web Service Authorization ID Service UDF defined.

AW

UDF17

User Defined Alpha/Numeric/Date 17

+

20

Web Service Authorization ID Service UDF defined.

AX

UDF18

User Defined Alpha/Numeric/Date 18

+

20

Web Service Authorization ID Service UDF defined.

AY

UDF19

User Defined Alpha/Numeric/Date 19

+

20

Web Service Authorization ID Service UDF defined.

AZ

UDF20

User Defined Alpha/Numeric/Date 20

+

20

Web Service Authorization ID Service UDF defined.

+ NOTE = the UDF (1-20) elements can be Numeric, Date or Text depending on how they are created within Spectrum.