Magento API: directory_country

Hace un tiempo les había dejado un ejemplo muy básico de cómo conectarse con el webservice de Magento y obtener alguna información.

A partir de hoy, vamos a darle una mirada más detallada a cada uno de los módulos que existen dentro de la API, con sus correspondientes ejemplos y explicaciones.

Dentro de la API, encontramos 5 módulos principales:

  • Mage_Customer
  • Mage_Directory
  • Mage_Catalog
  • Mage_Sales
  • Mage_CatalogInventory

El primer módulo que vamos a revisar es Mage_Directory, y dentro de éste, la entidad directory_country.

Con ésta entidad, tenemos sólo una funcionalidad. Nos provee la lista de países que maneja la plataforma.

El resultado nos será devuelto como un array.

Pasemos al ejemplo práctico.

<?php
//Url de la conexión
$client = new SoapClient("http://www.dominio.com.ar/index.php/api/?wsdl");

//Login
$session = $client->login("usuario", "contraseña");

//Listado de países
$countries = $client->call($session, "directory_country.list");

//Impresión
print_r($countries);

//Logout
$client->endSession($session);
?>

El array que obtendremos, nos devuelve algo como lo siguiente (dado que es un ejemplo, dejo sólo el primero de los 240 resultados que se obtienen).

Array
(
    [0] => Array
        (
            [country_id] => AD
            [iso2_code] => AD
            [iso3_code] => AND
            [name] => Andorra
        )
)

Lamentablemente, esto es todo lo que podemos hacer a través del webservice con los países.

Supongo que los casos de aplicación son algo escasos, pero podrían ayudar al momento de exportar información de la tienda a un sistema de gestión, o quizás para sacar algún tipo de estadística.