TigerZF
🌐Español

64.30. Zend_Service_StrikeIron: Servicios incluidos

Zend_Service_StrikeIron incluye clases envoltorio para tres servicios populares de StrikeIron.

64.30.1. Información de código postal (ZIP)

Zend_Service_StrikeIron_ZipCodeInfo proporciona un cliente para el servicio de información de código postal de StrikeIron. Para más información sobre este servicio, visite los siguientes recursos de StrikeIron:

El servicio contiene un método getZipCode() que recuperará información sobre un código postal de Estados Unidos o Canadá:

$strikeIron = new Zend_Service_StrikeIron(array('username' => 'your-username',
                                                'password' => 'your-password'));

// Get a client for the Zip Code Information service
$zipInfo = $strikeIron->getService(array('class' => 'ZipCodeInfo'));

// Get the Zip information for 95014
$response = $zipInfo->getZipCode(array('ZipCode' => 95014));
$zips = $response->serviceResult;

// Display the results
if ($zips->count == 0) {
    echo 'No results found';
} else {
    // a result with one single zip code is returned as an object,
    // not an array with one element as one might expect.
    if (! is_array($zips->zipCodes)) {
        $zips->zipCodes = array($zips->zipCodes);
    }

    // print all of the possible results
    foreach ($zips->zipCodes as $z) {
        $info = $z->zipCodeInfo;

        // show all properties
        print_r($info);

        // or just the city name
        echo $info->preferredCityName;
    }
}

// Detailed status information
// http://www.strikeiron.com/exampledata/StrikeIronZipCodeInformation_v3.pdf
$status = $response->serviceStatus;

64.30.2. Verificación de direcciones de EE. UU.

Zend_Service_StrikeIron_USAddressVerification proporciona un cliente para el servicio de verificación de direcciones de EE. UU. de StrikeIron. Para más información sobre este servicio, visite los siguientes recursos de StrikeIron:

El servicio contiene un método verifyAddressUSA() que verificará una dirección en Estados Unidos:

$strikeIron = new Zend_Service_StrikeIron(array('username' => 'your-username',
                                                'password' => 'your-password'));

// Get a client for the Zip Code Information service
$verifier = $strikeIron->getService(array('class' => 'USAddressVerification'));

// Address to verify. Not all fields are required but
// supply as many as possible for the best results.
$address = array('firm'           => 'Zend Technologies',
                 'addressLine1'   => '19200 Stevens Creek Blvd',
                 'addressLine2'   => '',
                 'city_state_zip' => 'Cupertino CA 95014');

// Verify the address
$result = $verifier->verifyAddressUSA($address);

// Display the results
if ($result->addressErrorNumber != 0) {
    echo $result->addressErrorNumber;
    echo $result->addressErrorMessage;
} else {
    // show all properties
    print_r($result);

    // or just the firm name
    echo $result->firm;

    // valid address?
    $valid = ($result->valid == 'VALID');
}

64.30.3. Impuesto básico de venta y uso (Sales & Use Tax Basic)

Zend_Service_StrikeIron_SalesUseTaxBasic proporciona un cliente para el servicio Sales & Use Tax Basic de StrikeIron. Para más información sobre este servicio, visite los siguientes recursos de StrikeIron:

El servicio contiene dos métodos, getTaxRateUSA() y getTaxRateCanada(), que recuperarán datos de impuestos de venta y uso para Estados Unidos y Canadá, respectivamente.

$strikeIron = new Zend_Service_StrikeIron(array('username' => 'your-username',
                                                'password' => 'your-password'));

// Get a client for the Sales & Use Tax Basic service
$taxBasic = $strikeIron->getService(array('class' => 'SalesUseTaxBasic'));

// Query tax rate for Ontario, Canada
$rateInfo = $taxBasic->getTaxRateCanada(array('province' => 'foo'));
print_r($rateInfo);               // show all properties
echo $rateInfo->GST;              // or just the GST (Goods & Services Tax)

// Query tax rate for Cupertino, CA USA
$rateInfo = $taxBasic->getTaxRateUS(array('zip_code' => 95014));
print_r($rateInfo);               // show all properties
echo $rateInfo->state_sales_tax;  // or just the state sales tax