Documentation

Servicio de creación de etiquetas de transporte (request_bl)

NUEVA VERSIÓN V2: HAZ CLIC AQUÍ

¿Eres un desarrollador o una agencia web? Inscríbete en el programa Expedy Partner

La creación de una etiqueta de transporte, también conocida como bl (albarán), desencadena la creación del servicio de transporte. Ten en cuenta que para algunos transportistas, como los mensajeros que incluyen recogida, el servicio se inicia en cuanto se crea el albarán.

URL de la solicitud: http://www.expedy.fr/api/request_bl

ParámetroDescripciónFormato
tipoCódigo de tipo de envío recuperado tras la solicitud de presupuesto. 
ref_únicoTu referencia interna única. 
pesoPeso en kg , ejemplo: 1,25 para 1 kilo 250 gramos.Digital
factura_totalValor del paquete en euros. Según los transportistas para el seguro. Digital
relayidseleccionadoID de retransmisión recuperado tras la solicitud de retransmisión.Digital

Información sobre el paquete. Obligatorio para envíos fuera de Francia
longitudLongitud del paquete en cm. Obligatorio para la exportación. Digital
anchuraAnchura del paquete en cm. Obligatorio para la exportación. Digital
alturaAltura del paquete en cm. Obligatorio para la exportación. Digital
contenido_descrDescripción sencilla del contenido del paquete. Obligatorio para la exportación. Digital
valor_contenidoValor del paquete en euros declarado en aduana. Obligatorio para la exportación. Digital
contenido_codigo_personalizadoCódigo aduanero. Obligatorio para la exportación postal con Colissimo. 6 Digital

Datos del remitente
empresa_remitenteNombre de la empresa remitente 
remitente_civilUrbanidad del remitenteLista de valores mr | mme
nombre_remitenteNombre del remitente 
nombre_remitenteNombre del remitente 
remitente_adr1Dirección del remitente línea 1máx. 32 caracteres
sender_adr2Dirección del remitente línea 2máx. 32 caracteres
zip_remitenteCódigo postal del remitenteDepende del país
ciudad_remitenteCiudad remitente 
código_país_remitenteCódigo ISO del país remitente2 Alfanumérico
correo_remitenteDirección de correo electrónico del remitente 
teléfono_remitenteEnvío del número de móvil, ejemplo: 060000000010 Digital

Datos del destinatario
empresa_enviadoraNombre de la empresa destinataria 
shipping_civilDirecciónLista de valores mr | mme
nombre_envíoNombre del destinatario 
nombre_envíoNombre del destinatario 
envío_adr1Dirección del destinatario línea 1máx. 32 caracteres
envío_adr2Dirección del destinatario línea 2máx. 32 caracteres
código_de_envíoCódigo postal de destinoDepende del país
ciudad_de_envíoCiudad de destino 
código_país_envíoCódigo ISO del país de destino2 Alfanumérico
email_envíoDirección de correo electrónico del destinatario 
teléfono_envíoNúmero de móvil de destino, ejemplo: 060000000010 Digital

Otros parámetros
hora_solicitudDéjalo en blanco para la creación inmediata del transporte,
o introduce una fecha unix para una hora posterior.
ex :1483365600 para el martes 2 de enero de 2017 a las 14:00 gmt +1 (parís)
Digital
modo_impresiónFormato de la etiqueta. Formato A4: «pdf» . Formato A5 (térmico): «térmico». Lista de valores pdf | térmicos
auto_almacénArchiva automáticamente este envío en tu consolaLista de valores sí | no
prefijo_ref_csvPermite al mensajero identificar el origen del recado, por ejemplo el nombre de tu sitio web de forma abreviada. 
csv_id_fuenteID utilizado para hacer pingback (webhook) de una URL para recibir información de seguimiento de la entrega. Envía tu URL a support@expedy.fr  
datos_carro_pedidoTe permite enviar al mensajero el contenido del pedido para que lo recoja una o varias tiendas.

Ejemplo XML «datos_carro_pedido

(pasa este XML a la matriz «params»).

<tiendas>
<tienda>
<nombre_tienda><CDATA[Restaurante Woki]]></shop_name>
<tienda_adr><CDATA[118 rue République, 75005 París]]></ tienda_adr >
<shop_preorder></shop_preorder> // dejar vacío
<shop_cart>
<artículo_tienda>
<p_ref>< /p_ref>
<cantidad>1</cantidad>
<p_nombre><CDATA[Plato principal]]></p_name>
<p_precio>9,5</p_precio>
<p_tva>1.055</p_tva>
<p_peso>200</p_peso>
<p_desc><CDATA[]]></p_desc> // no es necesario
<p_opts>
<op>
<nombre_opt><CDATA[Cacahuetes]]></opt_name>
<opt_precio>0,50</opt_precio>
<opt_tva>1.055</opt_tva>
</opt>
<op>
<nombre_opt><CDATA[Pollo]]></opt_name>
<opt_precio>2.00</opt_precio>
<opt_tva>1.055</opt_tva>
</opt>
</p_opts>
</shop_item>
<artículo_tienda>
<p_ref>< /p_ref>
<cantidad>1</cantidad>
<p_nombre><CDATA[Lo mejor de Woki]]></p_name>
<p_precio>7,5</p_precio>
<p_tva>1.055</p_tva>
<p_peso>200</p_peso>
<p_desc><CDATA[]]></p_desc> // no es necesario
<p_opts>
<op>
<opt_nombre><CDATA[Cacahuetes]]></opt_name>
<opt_precio>0,50</opt_precio>
<opt_tva>1.055</opt_tva>
</opt>
</p_opts>
</shop_item>
</shop_cart>
</shop>
<tienda>
<nombre_tienda><CDATA[Hamburguesa rápida]]></shop_name>
<tienda_adr><CDATA[ 63 quai Cavelier de la Salle, 75005 París]]></ shop_adr >
<shop_preorder></shop_preorder> // dejar vacío
<shop_cart>
<artículo_tienda>
<p_ref>A28</p_ref>
<cantidad>2</cantidad>
<p_nombre><CDATA[Hamburguesa Doble Queso]]></p_name>
<p_precio>13</p_precio>
<p_tva>1.055</p_tva>
<p_peso>200</p_peso>
<p_desc><CDATA[]]></p_desc> // no es necesario
<p_opts></p_opts>
</shop_item>
<artículo_tienda>
<p_ref>A22</p_ref>
<cantidad>1</cantidad>
<p_nombre><CDATA[Gran patata frita]]></p_name>
<p_precio>5</p_precio>
<p_tva>1.055</p_tva>
<p_peso>200</p_peso>
<p_desc><CDATA[]]></p_desc> // no es necesario
<p_opts></p_opts>
</shop_item>
</shop_cart>
</shop>
</shops>

Ejemplo PHP de una solicitud Crear etiqueta de transporte

 

// GENERAR BUEN ENVÍO * ENTREGA ( api/request_bl )

define('DS_SERVICE', 'api/request_cotation'); // {{{wpml_tag_1}}} $type,
 'poids' => $poids,
 'relayidselected' => $relayidselected,
 'unique_ref' => $client_order_id,
 'total_invoice' => $total_invoice,
 'csv_ref_prefix' => $csv_ref_prefix,
 'length' => $length,
 'width' => $width,
 'height' => $height,
 'content_descr' => $content_descr,
 'content_value' => $content_value,
 'content_customscode' => $content_customscode,
 'print_mode' => $print_mode,
 'auto_archive' => $auto_store
);

// construcción de la consulta : 
$data_from = array(
 'sender_company' => $sender_company,
 'sender_civilite' => $sender_civilite,
 'sender_name' => $sender_name,
 'sender_firstname' => $sender_firstname,
 'sender_zip' => $sender_zip,
 'sender_adr1' => $dirección_del_remitente1,
 'dirección_del_remitente2' => $dirección_del_remitente2,
 'ciudad_del_remitente' => $ciudad_del_remitente,
 'código_país_del_remitente' => $código_país_del_remitente,
 'correo_del_remitente' => $correo_del_remitente,
 'teléfono_del_remitente' => $teléfono_del_remitente
);

$data_to = array(
 'empresa_de_envío' => $empresa_de_envío,
 'ciudad_de_envío' => $ciudad_de_envío,
 'nombre_de_envío' => $nombre_de_envío,
 'nombre_de_envío' => $nombre_de_envío,
 'código_zip_de_envío' => $código_zip_de_envío,
 'dirección_de_envío1' => => $shipping_adr1,
 'shipping_adr2' => $shipping_adr2,
 'shipping_city' => $shipping_city,
 'shipping_country_code' => $shipping_country_code,
 'shipping_email' => $shipping_email, 
 'shipping_phone' => $shipping_phone
);

$data_request = array(
 'sid' => SID,
 'token' => TOKEN,
 'params' => $data_params,
 'from' => $data_from,
 'to' => $data_to
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, DS_SERVICE_URL);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data_request));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt ($ch, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
$result = curl_exec ($ch);
curl_close ($ch);

header ("Content-Type: text/xml; charset=utf-8");
//print $resultado;
echo $resultado;
?>


Français (Francés) Español