API Ecommerce: addGuide()

Método para generar guías de entrega para tiendas y supermercados. El método creará la guía para la entrega correspondiente. Devuelve el número de guía y si se marca envío de whatsapp, enviará un whatsapp al cliente una vez que se agende a ruta de entrega.

  1. Código
  2. Ejemplo

Código

Se pasa como parámetros:

  • nombre del cliente que envia [OBLIGATORIO],
  • nombre del embarcador [OBLIGATORIO],
  • ruc del cliente que envia [OBLIGATORIO],
  • dirección del cliente que envia [OBLIGATORIO],
  • nombre del que recibe [OBLIGATORIO],
  • ruc del que recibe,
  • telefono del que recibe [OBLIGATORIO],
  • contacto del que recibe,
  • email del que recibe,
  • direccion del que recibe,
  • latitud del que recibe ,
  • longitud del que recibe ,
  • direccion detallada (referencia) del que recibe [OBLIGATORIO],
  • se envia 1 si desea enviar whatsapp o 0 si no,
  • Tipo de Servivicio: Local, Nacional, Producto,
  • Ciudad Origen [OBLIGATORIO],
  • Ciudad Destino [OBLIGATORIO],
  • Descripción de la carga [OBLIGATORIO],
  • Otras observaciones de la carga,
  • cajas_peq (Cantidad de Cajas Pequeñas, 0 si no envía cajas Pequeñas) [OBLIGATORIO],
  • cajas_med (Cantidad de Cajas Medianas, 0 si no envía cajas Medianas) [OBLIGATORIO],
  • cajas_gra (Cantidad de Cajas Grandes, 0 si no envía cajas Grandes) [OBLIGATORIO],
  • token [OBLIGATORIO],
  • secretkey [OBLIGATORIO]

Contactenos si usted no tiene el token y el secretkey de su Empresa.


    function callEcommerceAPI(action,params) {
    ajax_request = $.ajax({
        url: api_ecommerce + "/" + action, //API URL de config y action de método que hace el llamado
        data: params,
        type: 'post',
        crossDomain: true,
        withCredentials: true,
        dataType: 'json',
        //timeout: 10000,
        beforeSend: function () {
        },
        complete: function (data) {
        },
        success: function (data) {
            switch(action){
                case 'addGuide':
                    if (data.code == 1) {
                        arrdatos = data.details;
                        var no_guia = arrdatos[0].no_guia;
                       alert('Se ha creado la guía con éxito, el número de guía es: '+no_guia+', gracias por usar nuestros servicios.');
                    }else{
                        alert(data.msg);
                    }
                    break;
            }
        }
    });
}
//function addGuide
function addGuide(){
    //datos del que envia
    var contact_name = $('#contact_name').val(); //nombre del cliente [OBLIGATORIO]
    var sender_name = $('#sender_name').val(); //nombre del embarcador [OBLIGATORIO]
    var contact_ruc = $('#contact_ruc').val(); //ruc del cliente [OBLIGATORIO]
    var contact_phone = $('#contact_phone').val(); //teléfono del cliente
    var contact_address = $('#contact_address').val(); //dirección del cliente
    //datos del que recibe
    var receiver_name =  $('#receiver_name').val(); //nombre del que recibe [OBLIGATORIO]
    var receiver_ruc = $('#receiver_ruc').val(); //ruc del que recibe
    var receiver_phone = $('#receiver_phone').val(); //telefono del que recibe [OBLIGATORIO]
    var receiver_contact =  $('#receiver_contact').val(); //contacto del que recibe
    var receiver_email = $('#receiver_email').val(); //email del que recibe
    var receiver_address = $('#receiver_address').val(); //direccion del que recibe
    var receiver_lat =  $('#receiver_lat').val(); //latitud del que recibe [OBLIGATORIO]
    var receiver_lng =  $('#receiver_lng').val(); //longitud del que recibe [OBLIGATORIO]
    var receiver_address_real =  $('#receiver_address_real').val(); //direccion detallada (referencia) del que recibe [OBLIGATORIO]
     if($('#receiver_whatsapp').is(':checked')){
        var receiver_whatsapp = 1;
     }else{
        var receiver_whatsapp = 0;
     }
    //
    var tipo_servicio =  $('#tipo_servicio').val(); //Tipo de Servivicio: Local, Nacional, Producto
    var origin_city =  $('#origin_city').val(); //Ciudad Origen [OBLIGATORIO]
    var guide_description =  $('#guide_description').val(); //Descripción de la carga [OBLIGATORIO]
    var guide_observations =  $('#guide_observations').val(); //Otras observaciones de la carga
    var receiver_city =  $('#receiver_city').val(); //Ciudad Destino [OBLIGATORIO]
    //detalle de la carga
    var cajas_peq = $('#cajas_peq').val(); //Cantidad de Cajas Pequeñas [OBLIGATORIO]
    var cajas_med = $('#cajas_med').val(); //Cantidad de Cajas Medianas [OBLIGATORIO]
    var cajas_gra = $('#cajas_gra').val(); //Cantidad de Cajas Grandes [OBLIGATORIO]
    //fin datos
    params = {
        contact_name: contact_name,
        sender_name: sender_name,
        contact_ruc: contact_ruc,
        contact_phone: contact_phone,
        contact_address: contact_address,
        receiver_name: receiver_name,
        receiver_ruc: receiver_ruc,
        receiver_phone: receiver_phone,
        receiver_contact: receiver_contact,
        receiver_email: receiver_email,
        receiver_address: receiver_address,
        receiver_lat: receiver_lat,
        receiver_lng: receiver_lng,
        receiver_address_real: receiver_address_real,
        receiver_city: receiver_city,
        receiver_whatsapp: receiver_whatsapp,
        tipo_servicio: tipo_servicio,
        origin_city: origin_city,
        guide_description: guide_description,
        cajas_peq: cajas_peq,
        cajas_med: cajas_med,
        cajas_gra: cajas_gra,
        guide_observations: guide_observations,
        token: token,
        keys: secretkey
    }
    callEcommerceAPI('addGuide', params);
}

Ejemplo:

Agregar una guía del Cliente: El ejemplo ha sido preparado para enviar la información de una guía. El método devuelve el número de guía como confirmación de que ha sido recibida en Seller Manager

Usar de ejemplo el RUC 0993056037001 y Nombre del Cliente: Seller Manager Lted, Embarcador: Vanessa Gómez Franco


Detalles de la la persona que recibe:



            <form id="frm-entrega" method="POST"  onsubmit="return false;">
          <div class="form-group">
              <label for="contact_name"> Cliente</label>
              <input id="contact_name" type="text" placeholder="Ej. Supermercados Mercadona" class="form-control">
          </div>
          <div class="form-group">
              <label for="sender_name"> Embarcador</label>
              <input id="sender_name" type="text" placeholder="Ej. Mercadona Sevilla" class="form-control">
          </div>
          <div class="form-group">
              <label for="contact_ruc">RUC del Cliente (Envía)</label>
              <input type="text" id="contact_ruc" required placeholder="Ej: 0987456321001" class="form-control" >
          </div>
          <div class="form-group">
              <label for="contact_phone">Teléfono del Cliente (Envía)</label>
              <input id="contact_phone" type="text" placeholder="Ej: +593987456321" required class="form-control">
          </div>
          <div class="form-group">
              <label for="contact_address">Dirección del Cliente (Envía)</label>
              <input type="text" id="contact_address" required placeholder="Ej: Almacén 9 de octubre" class="form-control" >
          </div>
          <hr style="border-bottom: 4px solid #369;">
          <h4 class="text-primary">Detalles de la la persona que recibe:</h4>
          <div class="form-group">
              <label for="receiver_name">Nombre de quién Recibe</label>
              <input type="text" id="receiver_name" required placeholder="Ej: Juana López Guerra" class="form-control" >
          </div>
          <div class="form-group">
              <label for="receiver_ruc">Ruc de quién Recibe</label>
              <input type="text" id="receiver_ruc" required placeholder="Ej: 09147258369001" class="form-control" >
          </div>
          <div class="form-group">
              <label for="receiver_phone">Teléfono de quién Recibe</label>
              <input type="text" id="receiver_phone" required placeholder="Ej: +593987453621" class="form-control" >
          </div>
          <div class="form-group">
              <label for="receiver_contact">Persona de contacto que Recibe</label>
              <input type="text" id="receiver_contact" required placeholder="Ej: Juana López Guerra" class="form-control" >
          </div>
          <div class="form-group">
              <label for="receiver_email">Email de quién Recibe</label>
              <input type="text" id="receiver_email" required placeholder="Ej: ejemple@gmail.com" class="form-control" >
          </div>
          <div class="form-group">
              <label for="receiver_address">Dirección de Entrega</label>
              <input type="text" id="receiver_address" required placeholder="Ej: Ave Amazonas 234 y calle 3era" class="form-control" >
          </div>
          <div class="form-group">
              <label for="receiver_lat">Latitud (coordenada)</label>
              <input type="text" id="receiver_lat" required placeholder="Ej: -2.55555" class="form-control" >
          </div>
          <div class="form-group">
              <label for="receiver_lng">Longitud (coordenada)</label>
              <input type="text" id="receiver_lng" required placeholder="Ej: -79.55555" class="form-control" >
          </div>
          <div class="form-group">
              <label for="receiver_address_real">Dirección de Entrega (Detallada)</label>
              <input type="text" id="receiver_address_real" required placeholder="Ej: -79.55555" class="form-control" >
          </div>
          <div class="form-group">
              <label for="receiver_city">Ciudad Destino</label>
              <input type="text" id="receiver_city" required placeholder="Ej: Quito" class="form-control" >
          </div>
          <div class="form-group">
              <label for="receiver_whatsapp">Si Envía Notificación de Whatsapp al recibidor</label>
              <div class="form-group">
                  <label class="switch">
                      <input id="receiver_whatsapp" value="1" type="checkbox" name="receiver_whatsapp" class="switch-input" >
                      <span class="switch-label" data-on="SI" data-off="NO"></span>
                      <span class="switch-handle"></span>
                  </label> <label style="display: inline; cursor: pointer;" for="receiver_whatsapp">  Envía Notificación de Whatsapp</label>
              </div>
          </div>
          <div class="form-group">
              <label for="tipo_servicio">Tipo de Servicio (Local, Naciona, Producto)</label>
              <input type="text" id="tipo_servicio" required placeholder="Ej: Local" class="form-control" >
          </div>
          <div class="form-group">
              <label for="origin_city">Ciudad origen</label>
              <input type="text" id="origin_city" required placeholder="Ej: Local" class="form-control" >
          </div>
          <div class="form-group">
              <label for="guide_description">Descripción</label>
              <input type="text" id="guide_description" required placeholder="Ej: Se envía TV" class="form-control" >
          </div>
          <div class="form-group">
              <label for="guide_observations">Observaciones</label>
              <input type="text" id="guide_observations" required placeholder="Ej: Manipular con cuidado" class="form-control" >
          </div>
          <div class="form-group">
              <label for="cajas_peq">Cajas Grandes</label>
              <input type="text" id="cajas_peq" required placeholder="0" class="form-control" >
          </div>
          <div class="form-group">
              <label for="cajas_med">Cajas Medianas</label>
              <input type="text" id="cajas_med" required placeholder="0" class="form-control" >
          </div>
          <div class="form-group">
              <label for="cajas_gra">Cajas Grandes</label>
              <input type="text" id="cajas_gra" required placeholder="0" class="form-control" >
          </div>
          <hr style="border-bottom: 4px solid #369;">
          <div class="form-group text-right m-b-0">
              <button onclick="addGuide();" class="btn btn-primary waves-effect waves-light" >
                  Agregar Guía
              </button>
          </div>
      </form>

     function callEcommerceAPI(action,params) {
    ajax_request = $.ajax({
        url: api_ecommerce + "/" + action, //API URL de config y action de método que hace el llamado
        data: params,
        type: 'post',
        crossDomain: true,
        withCredentials: true,
        dataType: 'json',
        //timeout: 10000,
        beforeSend: function () {
        },
        complete: function (data) {
        },
        success: function (data) {
            switch(action){
                case 'addGuide':
                    if (data.code == 1) {
                        arrdatos = data.details;
                        var no_guia = arrdatos[0].no_guia;
                       alert('Se ha creado la guía con éxito, el número de guía es: '+no_guia+', gracias por usar nuestros servicios.');
                    }else{
                        alert(data.msg);
                    }
                    break;
            }
        }
    });
}
//function addGuide
function addGuide(){
    //datos del que envia
    var contact_name = $('#contact_name').val(); //nombre del cliente [OBLIGATORIO]
    var sender_name = $('#sender_name').val(); //nombre del embarcador [OBLIGATORIO]
    var contact_ruc = $('#contact_ruc').val(); //ruc del cliente [OBLIGATORIO]
    var contact_phone = $('#contact_phone').val(); //ruc del cliente
    var contact_address = $('#contact_address').val(); //dirección del cliente
    //datos del que recibe
    var receiver_name =  $('#receiver_name').val(); //nombre del que recibe [OBLIGATORIO]
    var receiver_ruc = $('#receiver_ruc').val(); //ruc del que recibe
    var receiver_phone = $('#receiver_phone').val(); //telefono del que recibe [OBLIGATORIO]
    var receiver_contact =  $('#receiver_contact').val(); //contacto del que recibe
    var receiver_email = $('#receiver_email').val(); //email del que recibe
    var receiver_address = $('#receiver_address').val(); //direccion del que recibe
    var receiver_lat =  $('#receiver_lat').val(); //latitud del que recibe [OBLIGATORIO]
    var receiver_lng =  $('#receiver_lng').val(); //longitud del que recibe [OBLIGATORIO]
    var receiver_address_real =  $('#receiver_address_real').val(); //direccion detallada (referencia) del que recibe [OBLIGATORIO]
     if($('#receiver_whatsapp').is(':checked')){
        var receiver_whatsapp = 1;
     }else{
        var receiver_whatsapp = 0;
     }
    //
    var tipo_servicio =  $('#tipo_servicio').val(); //Tipo de Servivicio: Local, Nacional, Producto
    var origin_city =  $('#origin_city').val(); //Ciudad Origen [OBLIGATORIO]
    var guide_description =  $('#guide_description').val(); //Descripción de la carga [OBLIGATORIO]
    var guide_observations =  $('#guide_observations').val(); //Otras observaciones de la carga
    var receiver_city =  $('#receiver_city').val(); //Ciudad Destino [OBLIGATORIO]
    var receiver_city =  $('#receiver_city').val(); //Ciudad Destino [OBLIGATORIO]
    //detalle de la carga
    var cajas_peq = $('#cajas_peq').val(); //Cantidad de Cajas Pequeñas [OBLIGATORIO]
    var cajas_med = $('#cajas_med').val(); //Cantidad de Cajas Medianas [OBLIGATORIO]
    var cajas_gra = $('#cajas_gra').val(); //Cantidad de Cajas Grandes [OBLIGATORIO]
    //fin datos
    params = {
        contact_name: contact_name,
        sender_name: sender_name,
        contact_ruc: contact_ruc,
        contact_phone: contact_phone,
        contact_address: contact_address,
        receiver_name: receiver_name,
        receiver_ruc: receiver_ruc,
        receiver_phone: receiver_phone,
        receiver_contact: receiver_contact,
        receiver_email: receiver_email,
        receiver_address: receiver_address,
        receiver_lat: receiver_lat,
        receiver_lng: receiver_lng,
        receiver_address_real: receiver_address_real,
        receiver_city: receiver_city,
        receiver_whatsapp: receiver_whatsapp,
        tipo_servicio: tipo_servicio,
        origin_city: origin_city,
        guide_description: guide_description,
        guide_observations: guide_observations,
        cajas_peq: cajas_peq,
        cajas_med: cajas_med,
        cajas_gra: cajas_gra,
        token: token,
        keys: secretkey
    }
    callEcommerceAPI('addGuide', params);
}
    //////////////////////////////////////////////
    Respuesta de la API: devuelve el número de guía creada y un mensaje de confirmación.
    if (data.code == 1) {
        arrdatos = data.details;
        var no_guia = arrdatos.no_guia;
       alert('Se ha creado la guía con éxito, el número de guía es: '+no_guia+', gracias por usar nuestros servicios.');
    }else{
        alert(data.msg);
    }