Nombres *
Apellidos *
Email *
Clave *
País *
Celular *
Nombre de tu empresa *

DelyLab API

Información General

¿ Qué es el DelyLab API ?

Es la manera más sencilla de poder crear un delivery desde cualquier sistema que tengas o quieras crear.

Lo puedes ver el TOKEN en el administrador de DelyLab (admin.delylab.com). Una vez dentro debes ingresar a la seccción "Configuración", el cual solo puede entrar los "Super Administradores".

Para esto debes de llamar a la URL "https://api.delylab.com/delivery/add" y mandarle algunos parámetros por POST o GET.

Datos del cliente a quien se le enviará el delivery
  • name_client (string) - Requerido: El primer nombre del cliente. Este campo se convierte en el nombre de contacto del cliente si mandas el nombre de la empresa como parámetro ("company_client")
  • lastname_client (string) - Opcional: El apellido del cliente. Este campo se convierte en el apellido de contacto del cliente si mandas el nombre de la empresa como parámetro ("company_client")
  • email_client (string) - Opcional: El correo electrónico del cliente
  • phone_client (number) - Opcional: El celular del cliente
  • doc_client (string) - Opcional: El número de documento del cliente, puede ser su DNI, RUC, ID o cualquier otro dato que te interes como único
  • company_client (string) - Opcional: Si tu cliente es una empresa este se guardará como el nombre de la empresa de tu cliente y el nombre (name_client) y apellido (lastname_client) pasarán a ser el nombre completo del contacto de esta empresa, que es tu cliente.
Datos del delivery
  • date_delivery (string) - Opcional: Fecha programada del envío del delivery. Formato (YYYY-MM-DD)
  • address1_delivery (string) - Requerido: Dirección donde se hará el delivery
  • address2_delivery (string) - Opcional: Es una dato adicional de la dirección como por ej: Dpto, Piso, Habitación, etc.
  • city_delivery (string) - Opcional: El campo ciudad en DelyLab hace referencia no necesariamente a una ciudad entera, se puede usar por ej: Distrito, código postal o para zonificar tus deliveries.
  • reference_delivery (string) - Opcional: Alguna referencia de donde se encuentra la dirección del delivery. Esto puede ayudar al repartidor a poder ubicarse mejor.
  • description1_delivery (string) - Opcional: Alguna descripción que el repartidor deba saber al momento de ir a dejar el delivery.
  • description2_delivery (string) - Opcional: Alguna otra descripción u observación para el repartidor acerca del delivery.
  • description_pickup (string) - Opcional: Alguna descripción que el repartidor deba saber al momento de recoger el delivery.
  • price_delivery (float) - Opcional: Precio que se está cobrando por el delivery o el precio total.
  • paid_delivery (number) - Opcional: Indicar si el delivery ya fue pagado o aún no. 1 = Delivery Pagado. 0 = Delivery no Pagado. Por defecto: 0
  • items (json) - Opcional: Mandar los ítems del delivery. Este debe ser un JSON donde los datos son: "name", "unit_price", "quantity", "sku".

WordPress Plugin

DelyLab Plugin Wordpress

Descarga DelyLab Plugin Wordpress para poder implementar los pagos mediante WooCommerce. En el momento que se confirma el pedido en tu sistema de Wordpress mediante WooCommerce el delivery se creará automáticamente en tu sistema de DelyLab

Descarga DelyLab Plugin Wordpress

  1. Abrir el panel de control de tu web en Wordpress
  2. Dirígite al menú "Plugins" y dale clic a "Añadir nuevo"
  3. En la parte superior hay un botón llamado "Subir plugin", darle clic, seleccionar el zip descargado y darle a "Instalar ahora"
  4. Al cargar el plugin dale clic al botón que dice "Activar plugin"
  5. Ahora verás un nuevo ítem el menú, del lado izquierdo, que dirá "DelyLab". Haz clic ahí.
  6. En el primer campo debes escribir el TOKEN que te hemos proporcionado. El segundo campo "Días de espera": Es el número de días adicionales desde el día de la compra en que estarás haciendo el envío del pedido. Ej: "0" significa que programas el delivery el mismo día, "1" significa al día siguiente, "2" son dos días después de la compra y así sucesivamente.
  7. Clic al botón "Guardar Cambios"

Si no sabes dónde se encuentra el TOKEN anda arriba que te indicamos dónde encontrarlo.

Ejemplos de códigos

Javascript & jQuery

Crear un delivery por AJAX al DelyLab API con Javascript utilizando jQuery.

<script>
	$.ajax({
		url: 'https://api.delylab.com/delivery/add',
		type: 'post',
		dataType: 'json',
		data: {
			name_client: 'NOMBRE_CLIENTE',
			lastname_client: 'APELLIDO_CLIENTE',
			email_client: 'EMAIL_CLIENTE',
			phone_client: 'TELÉFONO_CLIENTE',
			doc_client: 'DOCUMENTO_CLIENTE',
			company_client: 'NOMBRE_EMPRESA',// SI EL CLIENTE ES UNA EMPRESA
			description_pickup: 'DESCRIPCIÓN_RECOJO',
			date_delivery: 'YYYY-MM-DD',
			address1_delivery: 'DIRECCIÓN_DELIVERY',
			address2_delivery: 'INTERIOR_DELIVERY_DPTO_PISO',
			city_delivery: 'CIUDAD_O_ZONA_DELIVERY',
			reference_delivery: 'REFERENCIA_DIRECCION_DELIVERY',
			description1_delivery: 'DESCRIPCION_DELIVERY',
			description2_delivery: 'DESCRIPCION_EXTRA_DELIVERY',
			price_delivery: 'PRECIO_DELIVERY',
			paid_delivery: 1, // 1 = DELIVERY PAGAGO - 0 = DELIVERY NO PAGADO
			items: '[{"name":"MI PRODUCTO 01","unit_price":129.9,"quantity":2,"sku":"ABCD1234"},{"name":"MI PRODUCTO 02","unit_price":89.9,"quantity":1,"sku":"EFGH5678"}]'
		}
		success: function( json ){
			if(json.credentials.success){
				if(json.output.success){
					// se generó el delivery
					console.log(json.output.message);
				}else{
					// ocurrió un problema al crear el delivery
					console.log(json.output.message);
				}
			}else{
				// problema de autentificación
				console.log(json.credentials.message);
			}
		},
		error: function (){
			//ERROR DE CONEXIÓN
		}
	});
</script>

Crear un delivery con PHP al DelyLab API utilizando file_get_contents().

<?php

	$_key = 'TOKEN_ID';

	$_clienteNombre = (isset($_POST["clienteNombre"])) ? $_POST["clienteNombre"] : '';
	$_clienteApellido = (isset($_POST["clienteApellido"])) ? $_POST["clienteApellido"] : '';
	$_clienteEmail = (isset($_POST["clienteEmail"])) ? $_POST["clienteEmail"] : '';
	$_clienteCelular = (isset($_POST["clienteCelular"])) ? $_POST["clienteCelular"] : '';
	$_clienteDoc = (isset($_POST["clienteDoc"])) ? $_POST["clienteDoc"] : '';
	$_clienteEmpresa = (isset($_POST["clienteEmpresa"])) ? $_POST["clienteEmpresa"] : '';

	$_pickupDescripcion = (isset($_POST["pickupDescripcion"])) ? $_POST["pickupDescripcion"] : '';
	
	$_deliveryDate = (isset($_POST["deliveryDate"])) ? $_POST["deliveryDate"] : date("Y-m-d");
	$_deliveryDireccion1 = (isset($_POST["deliveryDireccion1"])) ? $_POST["deliveryDireccion1"] : '';
	$_deliveryDireccion2 = (isset($_POST["deliveryDireccion2"])) ? $_POST["deliveryDireccion2"] : '';
	$_deliveryCiudad = (isset($_POST["deliveryCiudad"])) ? $_POST["deliveryCiudad"] : '';
	$_deliveryReferencia = (isset($_POST["deliveryReferencia"])) ? $_POST["deliveryReferencia"] : '';
	$_deliveryDescripcion = (isset($_POST["deliveryDescripcion"])) ? $_POST["deliveryDescripcion"] : '';
	$_deliveryAdicional = (isset($_POST["deliveryAdicional"])) ? $_POST["deliveryAdicional"] : '';
	$_deliveryPrecio = (isset($_POST["deliveryPrecio"])) ? $_POST["deliveryPrecio"] : '';
	$_deliveryPago = (isset($_POST["deliveryPago"]) && $_POST["deliveryPago"] == '1');
	
	$_items = array();
	$_items[] = array(
		'name'		=>	'MI PRODUCTO 01',
		'unit_price'	=>	129.90
		'quantity'	=>	2,
		'sku'		=>	'ABCD1234'
	);
	$_items[] = array(
		'name'		=>	'MI PRODUCTO 02',
		'unit_price'	=>	89.90
		'quantity'	=>	1,
		'sku'			=>	'EFGH5678'
	);

	$_url = 'https://api.delylab.com/delivery/add';
	$_data = array(
		'key'			=>	$_key,
		'name_client'		=>	$_clienteNombre,
		'lastname_client'	=>	$_clienteApellido,
		'email_client'		=>	$_clienteEmail,
		'phone_client'		=>	$_clienteCelular,
		'doc_client'		=>	$_clienteDoc,
		'company_client'	=>	$_clienteEmpresa,
		'description_pickup'	=>	$_pickupDescripcion,
		'date_delivery'		=>	$_deliveryDate,
		'address1_delivery'	=>	$_deliveryDireccion1,
		'address2_delivery'	=>	$_deliveryDireccion2,
		'city_delivery'		=>	$_deliveryCiudad,
		'reference_delivery'	=>	$_deliveryReferencia,
		'description1_delivery'	=>	$_deliveryDescripcion,
		'description2_delivery'	=>	$_deliveryAdicional,
		'price_delivery'	=>	$_deliveryPrecio,
		'paid_delivery'		=>	$_deliveryPago,
		'items'			=>	json_encode($_items)
	);

	$_options = array(
		'http' => array(
			'header'  => "Content-type: application/x-www-form-urlencoded\r\n",
			'method'  => 'POST',
			'content' => http_build_query($_data)
		)
	);
	$_context  = stream_context_create($_options);
	$_result = file_get_contents($_url, false, $_context);
	print_r($_result);