add better inline docs explaining fields on customer CSV import
[freeside.git] / httemplate / misc / cust_main-import.cgi
1 <% include("/elements/header.html",'Batch Customer Import') %>
2
3 Import a CSV file containing customer records.
4 <BR><BR>
5
6 <FORM ACTION="process/cust_main-import.cgi" METHOD="post" ENCTYPE="multipart/form-data">
7
8 <% &ntable("#cccccc", 2) %>
9
10 <% include('/elements/tr-select-agent.html',
11               #'curr_value' => '', #$agentnum,
12               'label'       => "<B>Agent</B>",
13               'empty_label' => 'Select agent',
14            )
15 %>
16
17 <TR>
18   <TH ALIGN="right">Format</TH>
19   <TD>
20     <SELECT NAME="format">
21 <!--      <OPTION VALUE="simple">Simple -->
22       <OPTION VALUE="extended" SELECTED>Extended
23     </SELECT>
24   </TD>
25 </TR>
26
27 <TR>
28   <TH ALIGN="right">CSV filename</TH>
29   <TD><INPUT TYPE="file" NAME="csvfile"></TD>
30 </TR>
31 % #include('/elements/tr-select-part_referral.html')
32 %
33
34
35 <!--
36 <TR>
37   <TH>First package</TH>
38   <TD>
39     <SELECT NAME="pkgpart"><OPTION VALUE="">(none)</OPTION>
40 % foreach my $part_pkg ( qsearch('part_pkg',{'disabled'=>'' }) ) { 
41
42        <OPTION VALUE="<% $part_pkg->pkgpart %>"><% $part_pkg->pkg. ' - '. $part_pkg->comment %></OPTION>
43 % } 
44
45     </SELECT>
46   </TD>
47 </TR>
48 -->
49
50 <TR><TD COLSPAN=2 ALIGN="center" STYLE="padding-top:6px"><INPUT TYPE="submit" VALUE="Import CSV file"></TD></TR>
51
52 </TABLE>
53
54 </FORM>
55
56 <BR>
57
58 <!-- Simple file format is CSV, with the following field order: <i>cust_pkg.setup, dayphone, first, last, address1, address2, city, state, zip, comments</i>
59 <BR><BR> -->
60
61 Extended file format is CSV, with the following field order: <i>agent_custid, refnum<%$req%>, last<%$req%>, first<%$req%>, address1<%$req%>, address2, city<%$req%>, state<%$req%>, zip<%$req%>, country, daytime, night, ship_last, ship_first, ship_address1, ship_address2, ship_city, ship_state, ship_zip, ship_country, payinfo<%$req%>, paycvv, paydate<%$req%>, invoicing_list, pkgpart, username, _password</i>
62 <BR><BR>
63
64 <%$req%> Required fields
65 <BR><BR>
66
67 Field information:
68
69 <ul>
70
71   <li><i>agent_custid</i>: This is the reseller's idea of the customer number or identifier.  It may be left blank.  If specified, it must be unique per-agent.
72
73   <li><i>refnum</i>: Advertising source number - where a customer heard about your service.  Configuration -&gt; Miscellaneous -&gt; View/Edit advertising sources.  This field has special treatment upon import: If a string is passed instead
74 of an integer, the string is searched for and if necessary auto-created in the
75 advertising source table.
76
77   <li><i>payinfo</i>: Credit card number, or leave this, <i>paycvv</i> and <i>paydate</i> blank for email/paper invoicing.
78
79   <li><i>paycvv</i>: CVV2 number (three digits on the back of the credit card)
80
81   <li><i>paydate</i>: Credit card expiration date.
82
83   <li><i>invoicing_list</i>: Email address for invoices, or POST for postal invoices.
84
85   <li><i>pkgpart</i>: Package definition.  Configuration -&gt; Provisioning, services and packages -&gt; View/Edit package definitions
86
87   <li><i>username</i> and <i>_password</i> are required if <i>pkgpart</i> is specified.
88 </ul>
89
90 <BR>
91
92 <% include('/elements/footer.html') %>
93
94 <%once>
95 my $req = qq!<font color="#ff0000">*</font>!;
96 </%once>