http://api.bidobido.com:81/envios/consultarPrecio

Este método devuelve un array con los precios y opciones disponibles para cada una de las agencias.

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

• POST

Los parámetros que se envían se agrupan en un array múltiple que pasamos a describir:

• 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.
• datosEnvio: Colección de arrays con los datos del envío.
  • desde: Array con datos de la dirección de origen del envío.
    • nombre: Nombre de la persona que envía.
    • direccion: Dirección origen del envío.
    • ciudad: Ciudad origen del envío.
    • cp: Código Postal origen del envío
    • pais: País origen del envío
    • telefono: Teléfono de contacto de la persona que envía
  • hasta: Array con datos de la dirección destino del envío
    • nombre: Nombre del receptor del envío.
    • direccion: Dirección destino del envío.
    • ciudad: Ciudad destino del envío.
    • cp: Código Postal destino del envío.
    • pais: País destino del envío.
    • telefono: Teléfono de contacto del destinatario.
  • paquetes: Array con datos de los paquetes que se envían.
    • peso: Peso del paquete.
    • x: Ancho del paquete.
    • y: Largo del paquete.
    • z: Alto del paquete.
  • costeMercancia: Coste de la mercancía, para el seguro.
  • referencia: Referencia identificativa del envío
  • imprimir: ¿Desea imprimir las etiquetas? (1=si, 0=no).

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

// Origen del paquete 
$desde['nombre']="Usuario Uno";
$desde['direccion']="Calle de la Reina";
$desde['ciudad']="Lugo";
$desde['cp']='27002';
$desde['pais']='ES';
$desde['telefono']='982222222';
 
// Destino del paquete
$hasta['nombre']="Usuario Dos";
$hasta['direccion']="Plaza de España";
$hasta['ciudad']="Madrid";
$hasta['cp']='28080';
$hasta['pais']='ES';
$hasta['telefono']='911111111';
 
// Paquete o paquetes a enviar
$paquete[0]['peso']=3;
$paquete[0]['x']=1;
$paquete[0]['y']=3.65;
$paquete[0]['z']=25;
 
// Si quieres asegurar la mercancia establece la cantidad, sino asumimos 0
$valor=0;
 
// Establece la referencia de tu envio, podrás hacer traking con ella
$referencia='REF13258999999';
 
// Si el método de la agencia lo permite puedes imprimir la etiqueta (1) o no (0)
$imprimir=0;
 
$envio=new enviosBidobido(array('formato'=>'text/xml','idioma'=>'es','codificacion'=>'utf-8', 'user'=>'usuario', 'pass'=>'password', 'server'=>'http://api.bidobido.com:81'));
 
// Consultar el precio del envío
$vuelta=$envio->consultarPrecio($desde,$hasta,$paquete,$valor,$referencia,$imprimir);

• 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).
• precio: Coste del envío.
• moneda: Moneda en la que se ofrece el precio.
• error: Si se produce algún error se describirá con un id y un texto.
  • id: Número del error.
  • texto: Descripción del error.

Array
(
    [respuestas] => Array
        (
            [respuesta] => Array
                (
                    [0] => Array
                        (
                            [nombre] => UPS
                            [id] => 1
                            [etiqueta] => 1
                            [seguro] => 1
                            [precio] => 10.44
                            [moneda] => EUR
                        )
 
                    [1] => Array
                        (
                            [nombre] => Tourline Express
                            [id] => 3
                            [etiqueta] => 0
                            [seguro] => 0
                            [precio] => 12.07
                            [moneda] => EUR
                        )
 
                    [2] => Array
                        (
                            [nombre] => Tourline 96H
                            [id] => 7
                            [etiqueta] => 0
                            [seguro] => 0
                            [error] => Array
                                (
                                    [id] => 112
                                    [texto] => El paquete supera el peso máximo: 5 Kg
                                )
 
                        )
 
                )
 
        )
 
)

{
	"respuestas":{
		"respuesta":
		[{
			"nombre":"UPS",
			"id":1,
			"etiqueta":1,
			"seguro":1,
			"precio":"6.26",
			"moneda":"EUR"
		},{
			"nombre":"Tourline Express",
			"id":3,
			"etiqueta":0,
			"seguro":0,
			"precio":"7.70",
			"moneda":"EUR"
		},{
			"nombre":"Tourline 96H",
			"id":7,
			"etiqueta":0,
			"seguro":0,
			"precio":"6.17",
			"moneda":"EUR"
		}]
	}
}

<respuestas>
	<respuesta>
		<nombre>UPS</nombre>
		<id>1</id>
		<etiqueta>1</etiqueta>
		<seguro>1</seguro>
		<precio>6.26</precio>
		<moneda>EUR</moneda>
	</respuesta>
	<respuesta>
		<nombre>Tourline Express</nombre>
		<id>3</id>
		<etiqueta>0</etiqueta>
		<seguro>0</seguro>
		<precio>7.70</precio>
		<moneda>EUR</moneda>
	</respuesta>
	<respuesta>
		<nombre>Tourline 96H</nombre>
		<id>7</id>
		<etiqueta>0</etiqueta>
		<seguro>0</seguro>
		<precio>6.17</precio>
		<moneda>EUR</moneda>
	</respuesta>
</respuestas>