modify backdated payment application behaviour, RT11870
[freeside.git] / httemplate / misc / cust_main-import.cgi
1 <% include("/elements/header.html",'Batch Customer Import') %>
2
3 Import a file containing customer records.
4 <BR><BR>
5
6 <& /elements/form-file_upload.html,
7      'name'      => 'CustomerImportForm',
8      'action'    => 'process/cust_main-import.cgi',
9      'num_files' => 1,
10      'fields'    => [ 'agentnum', 'custbatch', 'format' ],
11      'message'   => 'Customer import successful',
12      'url'       => $p."search/cust_main.html?custbatch=$custbatch",
13      'onsubmit'  => "document.CustomerImportForm.submitButton.disabled=true;",
14 &>
15
16 <% &ntable("#cccccc", 2) %>
17
18   <% include( '/elements/tr-select-agent.html',
19                  #'curr_value' => '', #$agentnum,
20                  'label'       => "<B>Agent</B>",
21                  'empty_label' => 'Select agent',
22              )
23   %>
24
25   <INPUT TYPE="hidden" NAME="custbatch" VALUE="<% $custbatch %>"%>
26
27   <TR>
28     <TH ALIGN="right">Format</TH>
29     <TD>
30       <SELECT NAME="format">
31         <!-- <OPTION VALUE="simple">Simple -->
32         <OPTION VALUE="extended" SELECTED>Extended
33         <OPTION VALUE="extended-plus_options">Extended + options
34         <OPTION VALUE="extended-plus_company">Extended plus company
35         <OPTION VALUE="extended-plus_company_and_options">Extended plus company and options
36         <OPTION VALUE="svc_external">External service
37         <OPTION VALUE="svc_external_svc_phone">External service and phone service
38       </SELECT>
39     </TD>
40   </TR>
41
42   <% include( '/elements/file-upload.html',
43                 'field' => 'file',
44                 'label' => 'Filename',
45             )
46   %>
47
48
49 % #include('/elements/tr-select-part_referral.html')
50 %
51
52
53 <!--
54 <TR>
55   <TH>First package</TH>
56   <TD>
57     This needs to be agent-virtualized if it gets used!
58     <SELECT NAME="pkgpart"><OPTION VALUE="">(none)</OPTION>
59 % foreach my $part_pkg ( qsearch('part_pkg',{'disabled'=>'' }) ) { 
60
61        <OPTION VALUE="<% $part_pkg->pkgpart %>"><% $part_pkg->pkg_comment %></OPTION>
62 % } 
63
64     </SELECT>
65   </TD>
66 </TR>
67 -->
68
69   <TR>
70     <TD COLSPAN=2 ALIGN="center" STYLE="padding-top:6px">
71       <INPUT TYPE    = "submit"
72              NAME    = "submitButton"
73              ID      = "submitButton"
74              VALUE   = "Import file"
75       >
76     </TD>
77   </TR>
78
79 </TABLE>
80
81 </FORM>
82
83 <BR>
84
85 <!-- Simple file format is CSV, with the following field order: <i>cust_pkg.setup, dayphone, first, last, address1, address2, city, state, zip, comments</i>
86 <BR><BR> -->
87
88 Uploaded files can be CSV (comma-separated value) files or Excel spreadsheets.  The file should have a .CSV or .XLS extension.
89 <BR><BR>
90
91 <b>Extended</b> format has 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, paycvv, paydate, invoicing_list, pkgpart, username, _password</i>
92 <BR><BR>
93
94 <b>Extended plus options</b> format has 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, paycvv, paydate, invoicing_list, pkgpart, username, _password, options</i>
95 <BR><BR>
96
97 <b>Extended plus company</b> format has the following field order: <i>agent_custid, refnum<%$req%>, last<%$req%>, first<%$req%>, company, address1<%$req%>, address2, city<%$req%>, state<%$req%>, zip<%$req%>, country, daytime, night, ship_last, ship_first, ship_company, ship_address1, ship_address2, ship_city, ship_state, ship_zip, ship_country, payinfo, paycvv, paydate, invoicing_list, pkgpart, username, _password</i>
98 <BR><BR>
99
100 <b>Extended plus company and options </b> format has the following field order: <i>agent_custid, refnum<%$req%>, last<%$req%>, first<%$req%>, company, address1<%$req%>, address2, city<%$req%>, state<%$req%>, zip<%$req%>, country, daytime, night, ship_last, ship_first, ship_company, ship_address1, ship_address2, ship_city, ship_state, ship_zip, ship_country, payinfo, paycvv, paydate, invoicing_list, pkgpart, username, _password, options</i>
101 <BR><BR>
102
103 <b>External service</b> format has the following field order: <i>agent_custid, refnum<%$req%>, last<%$req%>, first<%$req%>, company, address1<%$req%>, address2, city<%$req%>, state<%$req%>, zip<%$req%>, country, daytime, night, ship_last, ship_first, ship_company, ship_address1, ship_address2, ship_city, ship_state, ship_zip, ship_country, payinfo, paycvv, paydate, invoicing_list, pkgpart, next_bill_date, id, title</i>
104 <BR><BR>
105
106 <b>External service and phone service</b> format has the following field order: <i>agent_custid, refnum<%$req%>, last<%$req%>, first<%$req%>, company, address1<%$req%>, address2, city<%$req%>, state<%$req%>, zip<%$req%>, country, daytime, night, ship_last, ship_first, ship_company, ship_address1, ship_address2, ship_city, ship_state, ship_zip, ship_country, payinfo, paycvv, paydate, invoicing_list, pkgpart, next_bill_date, id, title, countrycode, phonenum, sip_password, pin</i>
107 <BR><BR>
108
109 <%$req%> Required fields
110 <BR><BR>
111
112 Field information:
113
114 <ul>
115
116   <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.
117
118   <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
119 of an integer, the string is searched for and if necessary auto-created in the
120 advertising source table.
121
122   <li><i>payinfo</i>: Credit card number, or leave this, <i>paycvv</i> and <i>paydate</i> blank for email/paper invoicing.  You may optionally prepend an 'A' or 'D' to the credit card number for automatic or on demand of customer billing respectively
123
124   <li><i>paycvv</i>: CVV2 number (three digits on the back of the credit card)
125
126   <li><i>paydate</i>: Credit card expiration date, MM/YYYY or MM/YY (M/YY and M/YYYY are also accepted).
127
128   <li><i>invoicing_list</i>: Email address for invoices, or POST for postal invoices.
129
130   <li><i>pkgpart</i>: Package definition.  Configuration -&gt; Packages -&gt; Package definitions
131
132   <li><i>username</i> and <i>_password</i> are required if <i>pkgpart</i> is specified. (Extended and Extended plus company formats)
133
134   <li><i>id</i>: External service id, integer
135
136   <li><i>title</i>: External service identifier, text
137
138   <li><i>options</i>: text containing one or more of
139
140   <ul>
141     <li>taxexempt: this customer does not pay taxes
142     <li>postalinvoice: ensure this customer receives a postal invoice
143   </ul>
144
145 </ul>
146
147 <BR>
148
149 <% include('/elements/footer.html') %>
150
151 <%once>
152
153 my $req = qq!<font color="#ff0000">*</font>!;
154
155 </%once>
156 <%init>
157
158 die "access denied"
159   unless $FS::CurrentUser::CurrentUser->access_right('Import');
160
161 my $custbatch = time2str('webimport-%Y/%m/%d-%T'. "-$$-". rand() * 2**32, time);
162
163 </%init>