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 <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       <OPTION VALUE="extended-plus_company">Extended plus company
  24     </SELECT>
  25   </TD>
  26 </TR>
  27
  28 <TR>
  29   <TH ALIGN="right">Filename</TH>
  30   <TD><INPUT TYPE="file" NAME="file"></TD>
  31 </TR>
  32 % #include('/elements/tr-select-part_referral.html')
  33 %
  34
  35
  36 <!--
  37 <TR>
  38   <TH>First package</TH>
  39   <TD>
  40     This needs to be agent-virtualized if it gets used!
  41     <SELECT NAME="pkgpart"><OPTION VALUE="">(none)</OPTION>
  42 % foreach my $part_pkg ( qsearch('part_pkg',{'disabled'=>'' }) ) {
  43
  44        <OPTION VALUE="<% $part_pkg->pkgpart %>"><% $part_pkg->pkg. ' - '. $part_pkg->comment %></OPTION>
  45 % }
  46
  47     </SELECT>
  48   </TD>
  49 </TR>
  50 -->
  51
  52 <TR><TD COLSPAN=2 ALIGN="center" STYLE="padding-top:6px"><INPUT TYPE="submit" VALUE="Import file"></TD></TR>
  53
  54 </TABLE>
  55
  56 </FORM>
  57
  58 <BR>
  59
  60 <!-- Simple file format is CSV, with the following field order: <i>cust_pkg.setup, dayphone, first, last, address1, address2, city, state, zip, comments</i>
  61 <BR><BR> -->
  62
  63 Uploaded files can be CSV (comma-separated value) files or Excel spreadsheets.  The file should have a .CSV or .XLS extension.
  64 <BR><BR>
  65
  66 <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>
  67 <BR><BR>
  68
  69 <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>
  70 <BR><BR>
  71
  72 <%$req%> Required fields
  73 <BR><BR>
  74
  75 Field information:
  76
  77 <ul>
  78
  79   <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.
  80
  81   <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
  82 of an integer, the string is searched for and if necessary auto-created in the
  83 advertising source table.
  84
  85   <li><i>payinfo</i>: Credit card number, or leave this, <i>paycvv</i> and <i>paydate</i> blank for email/paper invoicing.
  86
  87   <li><i>paycvv</i>: CVV2 number (three digits on the back of the credit card)
  88
  89   <li><i>paydate</i>: Credit card expiration date, MM/YYYY or MM/YY (M/YY and M/YYYY are also accepted).
  90
  91   <li><i>invoicing_list</i>: Email address for invoices, or POST for postal invoices.
  92
  93   <li><i>pkgpart</i>: Package definition.  Configuration -&gt; Provisioning, services and packages -&gt; View/Edit package definitions
  94
  95   <li><i>username</i> and <i>_password</i> are required if <i>pkgpart</i> is specified.
  96 </ul>
  97
  98 <BR>
  99
 100 <% include('/elements/footer.html') %>
 101
 102 <%once>
 103
 104 my $req = qq!<font color="#ff0000">*</font>!;
 105
 106 </%once>
 107 <%init>
 108
 109 die "access denied"
 110   unless $FS::CurrentUser::CurrentUser->access_right('Import');
 111
 112 </%init>