Guía de Usuario: Complemento para Excel

Introducció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

Descargar Instalador

Versión	Link
Migo Excel v1.0.0	Descargar
.NET Desktop Runtime 8	Descargar

Instalación del Complemento

Sigue estos pasos para instalar el complemento en Excel:

1. Descargar el instalador

2. Cerrar todas las ventanas de Excel

3. Ejecutar el archivo MigoExcel-1.0.0.exe

4. Seguir el asistente de instalación

5. 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