API de Seller Manager

Seller Manager es un poderoso sistema de gestión de clientes y vendedores. Permite la gestión de tus agentes en tiempo real, con información estadística de ventas, clientes, visitas , pedidos, cartera, etc. Ayuda a tomar decisiones en el momento preciso, mediante herramientas de inteligencia de negocios, teniendo como resultado un canal de ventas más productivo y eficiente.

Seller Manager cuenta con una aplicación móvil que se conecta a un sistema web moderno, amigable y potente. Además cuenta con una API para conectar tu sistema empresarial a los servicios del sistema, permitiendo obtener pedidos en tiempo real, actualizaciones de estados, actualización de inventarios, actualización de estados de cuentas del cliente, captación de nuevos clientes y mucho más!

  1. Comenzando a usar la API
  2. Métodos
  3. Ejemplos
  4. FAQ
  5. Changes Log
  6. Créditos

Comenzando a usar la API

Para comenzar a usar la API de Seller Manager debes contar con el Token de Autorización. Si no cuentas con el Token debes ponerte en contacto con Creativos Online S.A. al correo info@creativos-online.com. A continuación detallamos los pasos básicos para comenzar a usar la API.


  • Prepara el archivo de configuración

    Crea un archivo de configuración donde debes establecer las variables: URL de la API y Token.

    • 
  var config ={
      'ApiUrl':"https://sellerapp.creativemanager.online/api",
      'DialogDefaultTitle':"Seller Manager",
      'Token':"b4334fg90e0613675r45ad831829das"
  };
  var token = config.Token;
  var api_url = config.ApiUrl;
  • Crea un Método General

    Crea un método general para hacer las peticiones. La API de Seller Manager te permite crear un web service para gestionar los procesos.

    Estructura de la respuesta de la API: La API devuelve los datos en formato JSON directamente (No necesita usar funciones "parse" como JSON.parse(data) ). 

    • 
    //Respuesta de la API.
     var codigo = data.code;
      codigo = 1 //significa que fue exitosa la petición
      codigo = 2 //significa que ha ocurrido un error o no hay datos.

     var mensaje = data.msg;
      Muestra el mensaje del callback del servidor, depende del código de la respuesta (data.code)

     var datos = data.details;
      datos está en formato JSON. Para obtener los datos devueltos por la API puede usar la
      siguiente sintaxis:

      Ejemplo:
      var array_datos = data.details;
      var cant_registros = array_datos.length;
        for(i=0; i<cant_registros; i++){
            contact_id = array_datos[i].contact_id;
        }


    
    //función principal para hacer las peticiones
    //Los parámetros que recibe son:
    //action: método de la API
    //params: parámetros del método
    Ejemplo:
    var params  = {
        numerodoc: 'C0987456321',
        token: token
    }
    callAPI("getContactid", params);

    //Código de la función:
function callAPI(action,params) {
    ajax_request = $.ajax({
      url: api_url + "/" + action, //API URL de config y action de método que hace el llamado
      data: params,
      type: 'post',
      crossDomain: true,
      withCredentials: true,
      dataType: 'json',
      beforeSend: function () {

      },
      complete: function (data) {

      },
      success: function (data) {
      /*
   Como la función se usa para todos los métodos, filtramos el parámetro "action"
   y tomar las acciones según cada método.
    */
      switch(action){
        case 'getContactid':

          if (data.code == 1) {
            arrdatos = data.details;
            var nomcliente = arrdatos[0].fullname;
            var contact_id = arrdatos[0].contact_id;
            var direccion = arrdatos[0].direccion;
            var ruc = arrdatos[0].ruc;
            $('#idcliente').val(contact_id);
            $('#elcliente').val(nomcliente);
            $('#ladireccion').val(direccion);
          }else{
            alert(data.msg);
          }
        break;
        case 'updateBalanceAPI':
            if (data.code == 1) {
              alert('Balance actualizado con éxito desde API');
            }else{
              alert(data.msg);
            }
        break;
        case 'getPedidosAPI':
            if (data.code == 1) {
              arrdatos = data.details;
              filas = '';
              for(i=0;i<arrdatos.length; i++){
                idpedido = arrdatos[i].idpedido;
                cliente = arrdatos[i].cliente;
                agente = arrdatos[i].agente;
                fecha = arrdatos[i].date_created;
                estado = arrdatos[i].status;
                var nuevoestado='';
                  switch(estado){
                    case 'Pendiente':
                      estado = '';
                      nuevoestado = 'Aceptado';
                    break;
                    case 'Aceptado':
                      estado = '';
                      nuevoestado = 'Entregado';
                    break;
                    case 'Entregado':
                      estado = '';
                    break;
                  }

                cod_prod = arrdatos[i].cod_prod;
                description = arrdatos[i].description;
                quantity = arrdatos[i].quantity;
                price = arrdatos[i].price;
                subtotal = arrdatos[i].subtotal;
                subtotal_iva = arrdatos[i].subtotal_iva;
                filas += ''+idpedido+''+fecha+''+estado+''+cod_prod+''+description+''+quantity+''+price+''+subtotal+''+subtotal_iva+'';
        }
           $('#pedidos').html(filas);
        }else{
            alert(data.msg);
        }
        break;
        case 'updatePedido':
            if (data.code == 1) {
              idpedido = params.idpedido;
              nuevoestado = params.estado;
                switch(nuevoestado){
                  case 'Pendiente':
                    nuevoestado = '';
                break;
                case 'Aceptado':
                  nuevoestado = '';
                break;
                case 'Entregado':
                  nuevoestado = '';
                break;
                }
          $('.pedido_'+idpedido).find('td:eq(2)').html(nuevoestado);

          }else{
            alert(data.msg);
        }
        break;
      }

    }
    });
    }
  • Crea los artefactos necesarios

    Crea los artefactos necesarios para comenzar a usar los métodos de la API según tus necesidades. Cada método puede necesitar de diferentes vistas para obtener información o enviar información, según sea el caso.

  • Diseña las Vistas

    Crea las vistas necesarias, según el método a usar.

  • Crea las funciones

    Crea las funciones necesarias para comenzar a obtener la información.

Métodos de la API

A continuación detallamos los métodos de la API de Seller Manager