$enta->services_available ( cli => "02072221122" );
Returns a hash showing line qualification data
Returns an array listing available appointment slots or, if it is not possible to obtain appointments, returns a token to poll for the list at a later point.
Required parameters:
cli Telephone Number date Earliest date for appointments
Optional parameters:
attributes Hash ref of required extensions (see Enta docs)
$enta->book_appointment($tokenid);
Book a specific appointment slot
$enta->poll(token => '12345');
Poll for an appointment slot or appointment confirmation
See get_appointments and book_appointment methods
$enta->list_connections(liveorceased=>"live", fields=>"Username,Ref");
Returns a list of connections as an array
$enta->pending_orders();
Returns a list of all pending orders with their status
$enta->pstn_pending_orders();
Returns a list of all pending PSTN orders
$enta->rate_limited( returntype => "username" );
Returns a list of connections which are currently rate limited
$enta->get_blocked( returntype => "telephone" );
Return a list of connections which are blocked and the reason for the block.
$enta->get_bt_faults();
Returns a list of faults open with BT
See Enta docs for params
$enta->heavy();
Returns a list of heavy users
See Enta docs for more details
$enta->regrade_options( "service-id" => "ADSL12345" );
Returns an array detailing the available regrade options on the service.
Data returned is the same as from services_available
$enta->adslchecker( cli => "02072221122", mac => "LSDA12345523/DF12D" );
Returns details from Enta's interface to the BT ADSL checker. See Enta docs for details of what is returned.
cli parameter is required. mac is optional
$enta->username_available( username => 'abcdef' );
Returns true if the specified username is available to be used for a customer ADSL login at Enta.
$enta->verify_mac( cli => "02072221111", mac => "ABCD0123456/ZY21X" );
Given a cli and MAC returns 1 if the MAC is valid.
$enta->interleaving_status( "service-id" => "ADSL12345" );
Returns the current interleaving status if available
$enta->interleaving( "service-id" => "ADSL123456", "interleaving" => "No")
Changes the interleaving setting on the given service
$enta->stabilityoption( "service-id" => "ADSL123456", "option" => "Standard" );
Sets the Stability Option feature on a service
$enta->elevatedbestefforts( "service-id" => "ADSL123456", "option" => "Yes", "fee" => "5.00" );
Enables or disables Elevated Best Efforts on the given service. If the optional "fee" parameter is passed the monthly fee for this option is set accordingly, otherwise it is set to the default charged by Enta.
$enta->carei_level( "service-id" -> "ADSL12345", "care-level" => "enhanced" );
Changes the care-level associated with a given service.
care-level can be set to either standard or enhanced.
Returns true is successful.
$enta-enhanced_care( "service-id" => "ADSL123456", "option" => "On", "fee" => "15.00" );
Enables or disabled Enhanced Care on a given service. If the optional "fee" parameter is passed the monthly fee for this option is set accordingly, otherwise it is set to the default charged by Enta.
$enta->modifylinefeatures( "Ref" => "ADSL123456", "Username" => "abcdef", "Telephone" => "02071112222", "LineFeatures" => { "Interleaving" => "No", "StabilityOption" => "Standard", "ElevatedBestEfforts" => "Yes", "ElevatedBestEffortsFee" => "15.00", "MaintenanceCategory" => "4", "MaintenanceCategoryFee" => "25.00" } );
Modify the Enta service reference specificed in either Ref, Username or Telephone. Parameters are as per the Enta documentation
Returns a hash containing details of the new settings resulting from the change(s) made - ie:
%return = { interleaving => "No" };
$enta->order_updates_since( "date" => "2009-12-01" );
Returns all the BT order updates since the given date
$enta->getbtfeed( "days" => 5 );
Returns a list of events that have occurred on all orders over the number of days specified.
Parameters:
days : The number of days up to the current date to get reports for
The return is an date/time sorted array of hashes each of which contains the following fields: order-id date name value
$enta->update_contact( "service-id" => "ADSL12345", email => 'me@example.com', telday => '02070020011', televe => '02080020011' );
Updates the given contact details. Returns true if updated.
You can use this to change the email address, daytime telephone number and evening telephone number of the contact for the given service.
$enta->update_price("service-id" => "ADSL1234", period-fee => 19.99);
Updates the price charged for a given service
$enta->cease( "service-id" => "ADSL12345", "crd" => "1970-01-01" );
Places a cease order to terminate the ADSL service completely.
$enta->request_mac( "service-id" => 'ADSL12345');
Obtains a MAC for the given service.
Returns a hash comprising: mac, expiry-date if the MAC is available or submits a request for the MAC which can be obtained later.
$enta->auth_log( "service-id" => 'ADSL12345' );
Gets the most recent authentication attempt log.
$enta->max_reports( "service-id" => "ADSL12345" );
Returns the ADSL MAX reports for connections which are based upon ADSL MAX
$enta->order_eventlog_history( username => "myusername" );
Gets the provisioning history for a specified customer order.
Takes "username" as parameter.
Returns an array, each element of which details an order update.
$enta->getadslinstall( username => "username", dateformat => "%d %b %Y" );
Get's the provisioning history for the specified customer
Returns an array, each element of which is a hash detailing an update as follows:
date name value
$enta->service_details( "service-id" => 'ADSL12345' );
Returns the ADSL service details
$enta->adslaccount( "service-id" => "ADSL12345" );
Returns details for the given service
$enta->order( # Customer details forename => "Clara", surname => "Trucker", company => "ABC Ltd", building => "123", street => "Pigeon Street", city => "Manchester", county => "Greater Manchester", postcode => "M1 2JX", telephone => "01614960213", email => "clare@example.com", # Order details clid => "01614960213", "client-ref" => "claradsl", "prod-id" => $product, crd => $leadtime, username => "claraandhugo", password => "skyr153", "care-level" => "standard", realm => "surfdsl.net" );
Submits an order for DSL to be provided to the specified phone line. Note that all the parameters above must be supplied. CRD is the requested delivery date in YYYY-mm-dd format; you are responsible for computing dates after the minimum lead time. The product ID should have been supplied to you by Enta.
Additional parameters are listed below and described in the integration guide:
title street company mobile email fax sub-premise fixed-ip routed-ip allocation-size hardware-product max-interleaving test-mode inclusive-transfer
$enta->llu_order(...)
Place an order for an LLU service. See Enta docs for details
Returns the URI where the T&C for Entanet services is located.
Not implemented in Enta API Yet
Not Implemented in Enta API Yet
$enta->usage_summary( "service-id" => "ADSL12345", "year" => '2009', "month" => '01' );
Returns a summary of usage in the given month
$enta->usage_history( startdatetime => '2010-01-01', enddatetime => '2010-12-01');
$enta->usage_history_detail( "service-id" => "ADSL12345", startday => '2009-12-01', endday => '2010-02-01', dateformat => "%a, %d %m %Y"); $enta->usage_history_detail( "service-id" => "ADSL12345", day => '2010-02-01' );
Returns usage details for each day in a period or each 10 minute period in a day if called with day as the parameter.
service-id : Service identifier (or ref, username or telephone) startday : Start date in ISO format endday : End data in ISO format day : Date in ISO format dateformat : Format string per strftime. Defaults to ISO. (Optional)
Either the startday and endday parameters or the day parameter must be passed.
Returns an array, each element of which is a hash containing usage details for either a day or a 10 minute interval.
Data returned per a day has the following keys:
date : Date formatted for presentation ( eg Mon, 22 Feb 2010 ) totaldown : Total number of bytes downloaded totalup : Total number of bytes uploaded peakdown : Bytes downloaded during peak period peakup : Bytes uploaded during peak period
Data returned per 10 minute interval for a day:
time : Time at end of measured time interval down : bytes downloaded during interval up : bytes uploaded during interval
$enta->allowance( "service-id" => "ADSL12345" );
Returns details of the customers bandwidth usage allowance including overall allowance and any overusage (topup or payg) allowances on the account.
$enta->session_log( "service-id" => "ADSL12345", "days" => 5 );
Returns details of recent ADSL sessions - optionally specifying the number of days for how recent.
$enta->connectionhistory( "service-id" => "ADSL12345", "days" => 5 );
$enta->first_crd();
Returns the first date an order may be placed for.
To install Net::DSLProvider, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Net::DSLProvider
CPAN shell
perl -MCPAN -e shell install Net::DSLProvider
For more information on module installation, please visit the detailed CPAN module installation guide.