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_broadband">Wireless broadband service
  37         <OPTION VALUE="svc_external">External service
  38         <OPTION VALUE="svc_external_svc_phone">External service and phone service
  39         <OPTION VALUE="birthdates-acct_phone_hardware">Birthdates and account, phone and hardware services
  40         <OPTION VALUE="national_id-acct_phone">National ID, plus account and phone services
  41       </SELECT>
  42     </TD>
  43   </TR>
  44
  45   <& /elements/tr-checkbox.html,
  46        'label' => 'Validate credit card',
  47        'field' => 'validate_cc',
  48        'id'    => 'validate_cc',
  49        'value' => 'Y',
  50   &>
  51
  52   <% include( '/elements/file-upload.html',
  53                 'field' => 'file',
  54                 'label' => 'Filename',
  55             )
  56   %>
  57
  58
  59 % #include('/elements/tr-select-part_referral.html')
  60 %
  61
  62
  63 <!--
  64 <TR>
  65   <TH>First package</TH>
  66   <TD>
  67     This needs to be agent-virtualized if it gets used!
  68     <SELECT NAME="pkgpart"><OPTION VALUE="">(none)</OPTION>
  69 % foreach my $part_pkg ( qsearch('part_pkg',{'disabled'=>'' }) ) {
  70
  71        <OPTION VALUE="<% $part_pkg->pkgpart %>"><% $part_pkg->pkg_comment %></OPTION>
  72 % }
  73
  74     </SELECT>
  75   </TD>
  76 </TR>
  77 -->
  78
  79   <TR>
  80     <TD COLSPAN=2 ALIGN="center" STYLE="padding-top:6px">
  81       <INPUT TYPE    = "submit"
  82              NAME    = "submitButton"
  83              ID      = "submitButton"
  84              VALUE   = "Import file"
  85       >
  86     </TD>
  87   </TR>
  88
  89 </TABLE>
  90
  91 </FORM>
  92
  93 <BR>
  94
  95 <!-- Simple file format is CSV, with the following field order: <i>cust_pkg.setup, dayphone, first, last, address1, address2, city, state, zip, comments</i>
  96 <BR><BR> -->
  97
  98 Uploaded files can be CSV (comma-separated value) files or Excel spreadsheets.  The file should have a .CSV or .XLS extension.
  99 <BR><BR>
 100
 101 <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>
 102 <BR><BR>
 103
 104 <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>
 105 <BR><BR>
 106
 107 <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>
 108 <BR><BR>
 109
 110 <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>
 111 <BR><BR>
 112
 113 <b>Wireless broadband 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, ip_addr, mac_addr, sectornum</i>
 114 <BR><BR>
 115
 116 <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>
 117 <BR><BR>
 118
 119 <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>
 120 <BR><BR>
 121
 122 <b>Birthdates and account, phone and hardware services</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, birthdate, spouse_birthdate, payinfo, paycvv, paydate, invoicing_list, pkgpart, next_bill_date, username, _password, countrycode, phonenum, sip_password, pin, typenum, ip_addr, hw_addr, serial</i>
 123 <BR><BR>
 124
 125 <b>National ID, plus account and phone services</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, national_id, payinfo, paycvv, paydate, invoicing_list, pkgpart, next_bill_date, username, _password, slipip, countrycode, phonenum, sip_password, pin</i>
 126 <BR><BR>
 127
 128 <%$req%> Required fields
 129 <BR><BR>
 130
 131 Field information:
 132
 133 <ul>
 134
 135   <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.
 136
 137   <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
 138 of an integer, the string is searched for and if necessary auto-created in the
 139 advertising source table.
 140
 141   <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
 142
 143   <li><i>paycvv</i>: CVV2 number (three digits on the back of the credit card)
 144
 145   <li><i>paydate</i>: Credit card expiration date, MM/YYYY or MM/YY (M/YY and M/YYYY are also accepted).
 146
 147   <li><i>invoicing_list</i>: Email address for invoices, or POST for postal invoices.
 148
 149   <li><i>pkgpart</i>: Package definition.  Configuration -&gt; Packages -&gt; Package definitions
 150
 151   <li><i>username</i> and <i>_password</i> are required if <i>pkgpart</i> is specified. (Extended and Extended plus company formats)
 152
 153   <li><i>slipip</i>: IP address
 154
 155   <li><i>id</i>: External service id, integer
 156
 157   <li><i>title</i>: External service identifier, text
 158
 159   <li><i>options</i>: text containing one or more of
 160
 161   <ul>
 162     <li>taxexempt: this customer does not pay taxes
 163     <li>postalinvoice: ensure this customer receives a postal invoice
 164   </ul>
 165
 166 </ul>
 167
 168 <BR>
 169
 170 <% include('/elements/footer.html') %>
 171
 172 <%once>
 173
 174 my $req = qq!<font color="#ff0000">*</font>!;
 175
 176 </%once>
 177 <%init>
 178
 179 die "access denied"
 180   unless $FS::CurrentUser::CurrentUser->access_right('Import');
 181
 182 my $custbatch = time2str('webimport-%Y/%m/%d-%T'. "-$$-". rand() * 2**32, time);
 183
 184 </%init>