API: Método consultarAgenciasDisponibles()

URL

Descripción

Este método devuelve un array con las agencias de transportes disponibles para realizar envíos. La disponibilidad de las agencias depende de la configuración de las mismas en la cuenta de BidoBido (Mi Cuenta): agencias01.jpg

Formatos Soportados

  • text/php, text/xml, text/json, text/csv

Tipo de petición

  • POST

Petición

Parámetros

No se envía ningún parámetro excepto los que ya van implícitos en la conexión por Auth Digest (autentificación, codificación, idioma…) y las propiedades:

  • propiedades: Array con propiedades de la conexión:
    • version: Control interno de versiones del API. (1.0 por defecto)
    • moneda: Moneda en la que vamos a recibir los datos.

Ejemplo

Ejemplo de la petición utilizando el plugin de PHP que podéis descargar y probar desde aquí.

$envio=new enviosBidobido(array('formato'=>'text/xml','idioma'=>'es','codificacion'=>'utf-8', 'user'=>'usuario', 'pass'=>'password', 'server'=>'http://api.bidobido.com'));
 
// Consultar las Agencias Disponibles para realizar un envío
$vuelta=$envio->consultarAgenciasDisponibles();

Respuesta

Parámetros

  • nombre: Nombre de la agencia de transportes.
  • id: Identificador de la agencia de transportes.
  • etiqueta: Si permite imprimir etiquetas o no (0=no, 1=si).
  • seguro: Si permite tramitar seguro de mercancía (0=no, 1=si).

text/php

Array
(
    [respuestas] => Array
        (
            [respuesta] => Array
                (
                    [0] => Array
                        (
                            [nombre] => UPS
                            [id] => 1
                            [etiqueta] => 1
                            [seguro] => 1
                        )
 
                    [1] => Array
                        (
                            [nombre] => Tourline Express
                            [id] => 3
                            [etiqueta] => 0
                            [seguro] => 0
                        )
 
                    [2] => Array
                        (
                            [nombre] => Tourline 96H
                            [id] => 7
                            [etiqueta] => 0
                            [seguro] => 0
                        )
 
                )
 
        )
 
)

text/json

{
	"respuestas":
	{
		"respuesta":
		[{
			"nombre":"UPS",
			"id":1,
			"etiqueta":1,
			"seguro":1
		},{
			"nombre":"Tourline Express",
			"id":3,
			"etiqueta":0,
			"seguro":0
		},{
			"nombre":"Tourline 96H",
			"id":7,
			"etiqueta":0,
			"seguro":0
		}]
	}
}

text/xml

<respuestas>
	<respuesta>
		<nombre>UPS</nombre>
		<id>1</id>
		<etiqueta>1</etiqueta>
		<seguro>1</seguro>
	</respuesta>
	<respuesta>
		<nombre>Tourline Express</nombre>
		<id>3</id>
		<etiqueta>0</etiqueta>
		<seguro>0</seguro>
	</respuesta>
	<respuesta>
		<nombre>Tourline 96H</nombre>
		<id>7</id>
		<etiqueta>0</etiqueta>
		<seguro>0</seguro>
	</respuesta>
</respuestas>

Comentarios

~~DISCUSSION:off~~