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

Este método devuelve un array con los precios y opciones disponibles de una agencia dada.

• 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
  • agencia: ID de la agencia a consultar. Este ID se puede obtener del método consultarAgenciasDisponibles().
  • 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';
 
// ID de Agencia a consultar
$agencia=1;
 
// 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 en una Agencia concreta
$vuelta=$envio->consultarPrecioAgencia($desde,$hasta,$paquete,$valor,$referencia,$agencia,$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
(
        [respuesta] => Array
        (
            [nombre] => UPS
            [id] => 1
            [etiqueta] => 1
            [seguro] => 1
            [precio] => 6.26
            [moneda] => EUR
        )
)

{
	"respuesta":
		{
			"nombre":"UPS",
			"id":1,
			"etiqueta":1,
			"seguro":1,
			"precio":"6.26",
			"moneda":"EUR"
		}
}

<respuesta>
	<nombre>UPS</nombre>
	<id>1</id>
	<etiqueta>1</etiqueta>
	<seguro>1</seguro>
	<precio>6.26</precio>
	<moneda>EUR</moneda>
</respuesta>