Guía de Usuario: Complemento para Excel

troducción

Bienvenido a la guía de usuario del complemento (Add-In) para Microsoft Excel. Este complemento ha sido diseñado para ayudarte a optimizar tu flujo de trabajo y aumentar tu productividad al realizar consultas y validación de datos.

Con nuestro complemento puedes acceder directamente desde Excel a nuestra API.

El complemento de Excel proporciona las funciones básicas de nuestro servicio. Para aprovechar al máximo todas las funcionalidades y características de nuestra API, se recomienda desarrollar una solución a medida.

Esta guía te proporcionará toda la información necesaria para instalar, configurar y utilizar el complemento de manera eficiente.

Requisitos del Sistema

Antes de comenzar, asegúrate de que tu entorno cumple con los siguientes requisitos:

Versión de Excel: 2013 (64 bits) o superior
Sistema Operativo: Windows 10 (64 bits) o superior
.NET Desktop Runtime 8 (64 bits) o superior, https://dotnet.microsoft.com/es-es/download/dotnet/8.0 (Entorno de ejecución de escritorio de .NET 8)
Cuenta de Usuario registrada en nuestra plataforma y crear un Token API

Descarga

Versión

Link

Excel AddIn v1.0.0

.NET Desktop Runtime 8

Instalación del Complemento

Sigue estos pasos para instalar el complemento en Excel:

Descargar el instalador
Cerrar todas las ventanas de Excel
Ejecutar el archivo migo-excel-addin.exe
Seguir el asistente de instalación
Una vez instalado, el complemento estará disponible en la barra de herramientas de Excel

Uso Básico

Acceder al Complemento

Después de instalar, encontrarás el complemento en la pestaña MIGO API de la barra de herramientas de Excel.

Configuración Inicial

Configura tu token de acceso haciendo clic en la pestaña MIGO API.

Luego clic en en botón Ingresar Token.

Ingresa el token generado en nuestra plataforma y presiona el botón Guardar.

Funciones Disponibles

Consulta RUC

Función

Descripción

Sintaxis

Resultado

RUC

Devuelve el resultado de la consulta en formato JSON desde nuestra API

=RUC(20603274742)

{
  "success": true,
  "ruc": "20603274742",
  "nombre_o_razon_social": "MIGO SOCIEDAD ANONIMA CERRADA - MIGO S.A.C.",
  "estado_del_contribuyente": "ACTIVO",
  "condicion_de_domicilio": "HABIDO",
  "ubigeo": "040112",
  "tipo_de_via": "AV.",
  "nombre_de_via": "JORGE CHAVEZ",
  "codigo_de_zona": "URB.",
  "tipo_de_zona": "JORGE CHAVEZ",
  "numero": "204",
  "interior": "-",
  "lote": "-",
  "dpto": "-",
  "manzana": "-",
  "kilometro": "-",
  "distrito": "PAUCARPATA",
  "provincia": "AREQUIPA",
  "departamento": "AREQUIPA",
  "direccion_simple": "AV. JORGE CHAVEZ NRO. 204 URB. JORGE CHAVEZ",
  "direccion": "AV. JORGE CHAVEZ NRO. 204 URB. JORGE CHAVEZ - AREQUIPA AREQUIPA PAUCARPATA",
  "actualizado_en": "2024-01-01 20:00:00"
}

RUC.CONDICIONDOMICILIO

Devuelve el valor "condicion_de_domicilio" de la respuesta JSON almacenada en una celda (ej: A1)

=RUC.CONDICIONDOMICILIO(A1)

HABIDO

RUC.DEPARTAMENTO

Devuelve el valor "departamento" de la respuesta JSON almacenada en una celda (ej: A1)

=RUC.DEPARTAMENTO(A1)

AREQUIPA

RUC.DIRECCION

Devuelve el valor "direccion" de la respuesta JSON almacenada en una celda (ej: A1)

=RUC.DIRECCION(A1)

AV. JORGE CHAVEZ NRO. 204 URB. JORGE CHAVEZ - AREQUIPA AREQUIPA PAUCARPATA

RUC.DIRECCIONSIMPLE

Devuelve el valor "direccion_simple" de la respuesta JSON almacenada en una celda (ej: A1)

=RUC.DIRECCIONSIMPLE(A1)

AV. JORGE CHAVEZ NRO. 204 URB. JORGE CHAVEZ

RUC.DISTRITO

Devuelve el valor "distrito" de la respuesta JSON almacenada en una celda (ej: A1)

=RUC.DISTRITO(A1)

PAUCARPATA

RUC.ESTADOCONTRIBUYENTE

Devuelve el valor "estado_del_contribuyente" de la respuesta JSON almacenada en un celda (ej: A1)

=RUC.ESTADOCONTRIBUYENTE(A1)

ACTIVO

RUC.NOMBRE

Devuelve el valor "nombre_o_razon_social" de la respuesta JSON almacenada en una celda (ej: A1)

=RUC.NOMBRE(A1)

MIGO SOCIEDAD ANONIMA CERRADA - MIGO S.A.C.

RUC.PROVINCIA

Devuelve el valor "provincia" de la respuesta JSON almacenada en una celda (ej: A1)

=RUC.PROVINCIA(A1)

AREQUIPA

RUC.UBIGEO

Devuelve el valor "ubigeo" de la respuesta JSON almacenada en una celda (ej: A1)

=RUC.UBIGEO(A1)

040112

Consulta RUC Actividades Económicas

Función

Descripción

Sintaxis

Resultado

ACTIVIDAD

Devuelve el resultado de la consulta en formato JSON desde nuestra API

=ACTIVIDAD(20603274742)

{
  "success": true,
  "ruc": "20603274742",
  "estado": "ACTIVO",
  "condicion": "HABIDO",
  "tipo": "SOCIEDAD ANONIMA CERRADA",
  "actividad_economica_rev3_principal": "CONSULTORES PROGRAMAS Y SUMINISTROS INFORMATICOS",
  "actividad_economica_rev3_secundaria": "VENTA AL POR MAYOR DE MAQUINARIA EQUIPO Y MATERIALES",
  "actividad_economica_rev4_principal": "CONSULTORIA DE INFORMATICA Y GESTION DE INSTALACIONES INFORMATICAS",
  "numero_trabajadores": "NO DISPONIBLE",
  "tipo_facturacion": "MANUAL/COMPUTARIZADO",
  "tipo_contabilidad": "COMPUTARIZADO",
  "comercio_exterior": "SIN ACTIVIDAD",
  "periodo": "202404"
}

ACTIVIDAD.COMERCIOEXTERIOR

Devuelve el valor "comercio_exterior" de la respuesta JSON almacenada en una celda (ej: A1)

=ACTIVIDAD.COMERCIOEXTERIOR(A1)

SIN ACTIVIDAD

ACTIVIDAD.CONTABILIDAD

Devuelve el valor "tipo_contabilidad" de la respuesta JSON almacenada en una celda (ej: A1)

=ACTIVIDAD.CONTABILIDAD(A1)

COMPUTARIZADO

ACTIVIDAD.FACTURACION

Devuelve el valor "tipo_facturacion" de la respuesta JSON almacenada en una celda (ej: A1)

=ACTIVIDAD.FACTURACION(A1)

MANUAL/COMPUTARIZADO

ACTIVIDAD.NUMEROTRABAJADORES

Devuelve el valor "numero_trabajadores" de la respuesta JSON almacenada en una celda (ej: A1)

=ACTIVIDAD.NUMEROTRABAJADORES(A1)

NO DISPONIBLE

ACTIVIDAD.PERIODO

Devuelve el valor "periodo" de la respuesta JSON almacenada en una celda (ej: A1)

=ACTIVIDAD.PERIODO(A1)

202404

ACTIVIDAD.PRINCIPAL

Devuelve el valor "actividad_economica_rev3_principal" de la respuesta JSON almacenada en una celda (ej: A1)

=ACTIVIDAD.PRINCIPAL(A1)

CONSULTORES PROGRAMAS Y SUMINISTROS INFORMATICOS

ACTIVIDAD.PRINCIPALREV4

Devuelve el valor "actividad_economica_rev4_principal" de la respuesta JSON almacenada en una celda (ej: A1)

=ACTIVIDAD.PRINCIPALREV4(A1)

CONSULTORIA DE INFORMATICA Y GESTION DE INSTALACIONES INFORMATICAS

ACTIVIDAD.SECUNDARIA

Devuelve el valor "tipo_facturacion" de la respuesta JSON almacenada en una celda (ej: A1)

=ACTIVIDAD.SECUNDARIA(A1)

E MAQUINARIA EQUIPO Y MATERIALES

ACTIVIDAD.TIPO

Devuelve el valor "tipo" de la respuesta JSON almacenada en una celda (ej: A1)

=ACTIVIDAD.TIPO(A1)

SOCIEDAD ANONIMA CERRADA

Consulta DNI

Si el número de DNI empieza con 0 se debe usar comillas simples o dobles ej. "02999999" en la función.

Función

Descripción

Sintaxis

Resultado

DNI

Devuelve el resultado de la consulta en formato JSON desde nuestra API

=DNI(43451826)

{
  "success": true,
  "dni": "43451826",
  "nombre": "CASTILLO GOMES VANESSA SILVIA"
}

DNI.NOMBRE

Devuelve el valor "nombre" de la respuesta JSON almacenada en una celda (ej: A1)

=DNI.NOMBRE(A1)

CASTILLO GOMES VANESSA SILVIA

DNI.NUMERO

Devuelve el valor "dni" de la respuesta SON almacenada en una celda (ej: A1)

=DNI.NUMERO(A1)

43451826

Consulta Tipo de Cambio

Función

Descripción

Sintaxis

Resultado

TIPOCAMBIO

Devuelve valor resultado de la consulta en formato JSON desde nuestra API

=TIPOCAMBIO(28/07/2023)

{
  "success": true,
  "fecha": "2023-07-28",
  "moneda": "USD",
  "precio_compra": "3.591",
  "precio_venta": "3.602"
}

TIPOCAMBIO.COMPRA

Devuelve el valor "precio_compra" de la respuesta JSON almacenada en una celda (ej: A1)

=TIPOCAMBIO.COMPRA(A1)

3.591

TIPOCAMBIO.FECHA

Devuelve el valor "fecha" de la respuesta JSON almacenada en una celda (ej: A1)

=TIPOCAMBIO.FECHA(A1)

28/07/2023

TIPOCAMBIO.MONEDA

Devuelve el valor "moneda" de la respuesta JSON almacenada en una celda (ej: A1)

=TIPOCAMBIO.MONEDA(A1)

USD

TIPOCAMBIO.VENTA

Devuelve el valor "precio_venta" de la respuesta JSON almacenada en una celda (ej: A1)

=TIPOCAMBIO.VENTA(A1)

3.602

Consulta Número a Letras

Función

Descripción

Sintaxis

Resultado

NUMEROALETRAS

Devuelve el número convertido a texto con formato para facturación electrónica

=NUMEROALETRAS(118)

CIENTO DIECIOCHO CON 00/100

AnteriorNúmero a letras

Última actualización hace 17 horas