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ámetro | Descripción | Formato |
tipo | Código de tipo de envío recuperado tras la solicitud de presupuesto. | |
ref_único | Tu referencia interna única. | |
peso | Peso en kg , ejemplo: 1,25 para 1 kilo 250 gramos. | Digital |
factura_total | Valor del paquete en euros. Según los transportistas para el seguro. | Digital |
relayidseleccionado | ID de retransmisión recuperado tras la solicitud de retransmisión. | Digital |
Información sobre el paquete. Obligatorio para envíos fuera de Francia | ||
longitud | Longitud del paquete en cm. Obligatorio para la exportación. | Digital |
anchura | Anchura del paquete en cm. Obligatorio para la exportación. | Digital |
altura | Altura del paquete en cm. Obligatorio para la exportación. | Digital |
contenido_descr | Descripción sencilla del contenido del paquete. Obligatorio para la exportación. | Digital |
valor_contenido | Valor del paquete en euros declarado en aduana. Obligatorio para la exportación. | Digital |
contenido_codigo_personalizado | Código aduanero. Obligatorio para la exportación postal con Colissimo. | 6 Digital |
Datos del remitente | ||
empresa_remitente | Nombre de la empresa remitente | |
remitente_civil | Urbanidad del remitente | Lista de valores mr | mme |
nombre_remitente | Nombre del remitente | |
nombre_remitente | Nombre del remitente | |
remitente_adr1 | Dirección del remitente línea 1 | máx. 32 caracteres |
sender_adr2 | Dirección del remitente línea 2 | máx. 32 caracteres |
zip_remitente | Código postal del remitente | Depende del país |
ciudad_remitente | Ciudad remitente | |
código_país_remitente | Código ISO del país remitente | 2 Alfanumérico |
correo_remitente | Dirección de correo electrónico del remitente | |
teléfono_remitente | Envío del número de móvil, ejemplo: 0600000000 | 10 Digital |
Datos del destinatario | ||
empresa_enviadora | Nombre de la empresa destinataria | |
shipping_civil | Dirección | Lista de valores mr | mme |
nombre_envío | Nombre del destinatario | |
nombre_envío | Nombre del destinatario | |
envío_adr1 | Dirección del destinatario línea 1 | máx. 32 caracteres |
envío_adr2 | Dirección del destinatario línea 2 | máx. 32 caracteres |
código_de_envío | Código postal de destino | Depende del país |
ciudad_de_envío | Ciudad de destino | |
código_país_envío | Código ISO del país de destino | 2 Alfanumérico |
email_envío | Dirección de correo electrónico del destinatario | |
teléfono_envío | Número de móvil de destino, ejemplo: 0600000000 | 10 Digital |
Otros parámetros | ||
hora_solicitud | Dé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ón | Formato de la etiqueta. Formato A4: «pdf» . Formato A5 (térmico): «térmico». | Lista de valores pdf | térmicos |
auto_almacén | Archiva automáticamente este envío en tu consola | Lista de valores sí | no |
prefijo_ref_csv | Permite al mensajero identificar el origen del recado, por ejemplo el nombre de tu sitio web de forma abreviada. | |
csv_id_fuente | ID 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_pedido | Te 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; ?>