Herramientas de Ecuador · ADVISE.ia

{
  "type": "object",
  "properties": {
    "modo": {
      "enum": [
        "mensual",
        "total"
      ],
      "type": "string",
      "description": "«mensual» (con la remuneración mensual y las fechas) o «total» (total del período ÷ 12). Si falta, se deduce de los datos."
    },
    "anio_pago": {
      "enum": [
        2026,
        2027
      ],
      "type": "integer",
      "description": "Año de pago: 2026 = período del 1-dic-2025 al 30-nov-2026 (por defecto); 2027 = del 1-dic-2026 al 30-nov-2027."
    },
    "fecha_salida": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Fecha de salida (AAAA-MM-DD), solo si salió antes del cierre del período."
    },
    "fecha_ingreso": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Fecha de ingreso (AAAA-MM-DD), solo si entró después de que empezó el período."
    },
    "remuneracion_mensual": {
      "type": "number",
      "minimum": 0,
      "description": "Remuneración mensual en USD: sueldo más horas extra, comisiones y otros pagos habituales (sin utilidades, fondo de reserva, viáticos ni décimos)."
    },
    "total_remuneraciones_periodo": {
      "type": "number",
      "minimum": 0,
      "description": "Alternativa: total de remuneraciones recibidas del 1 de diciembre al 30 de noviembre, en USD."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "sueldo_mensual"
  ],
  "properties": {
    "periodo": {
      "enum": [
        "mes",
        "semana"
      ],
      "type": "string",
      "description": "Si las horas son de un «mes» (por defecto) o de una «semana» (con semana se revisa el límite de 12 horas suplementarias)."
    },
    "madrugada": {
      "type": "number",
      "minimum": 0,
      "description": "Horas suplementarias entre las 24:00 y las 06:00 (+100 %)."
    },
    "nocturnas": {
      "type": "number",
      "minimum": 0,
      "description": "Horas de la jornada ordinaria entre las 19:00 y las 06:00: se paga solo el recargo de 25 %."
    },
    "sueldo_mensual": {
      "type": "number",
      "minimum": 0,
      "description": "Sueldo mensual en USD (la remuneración de la jornada ordinaria, sin horas extra)."
    },
    "suplementarias": {
      "type": "number",
      "minimum": 0,
      "description": "Horas suplementarias hasta las 24:00, de lunes a viernes (+50 %)."
    },
    "extraordinarias": {
      "type": "number",
      "minimum": 0,
      "description": "Horas en sábado, domingo o feriado (+100 %)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "gastos_actividad": {
      "type": "number",
      "minimum": 0,
      "description": "Costos y gastos deducibles de esa actividad en USD."
    },
    "aporte_iess_anual": {
      "type": "number",
      "minimum": 0,
      "description": "Aporte personal al IESS del año en USD, si se conoce (0 si el empleador lo paga). Si falta, se calcula con 9,45 % de los ingresos en relación de dependencia."
    },
    "cargas_familiares": {
      "type": "integer",
      "maximum": 20,
      "minimum": 0,
      "description": "Número de cargas familiares (5 o más se trata como 5)."
    },
    "gastos_personales": {
      "type": "number",
      "minimum": 0,
      "description": "Gastos personales del año en USD (vivienda, alimentación, educación, salud, vestimenta, turismo nacional, arte y cultura), sin IVA."
    },
    "ingresos_actividad": {
      "type": "number",
      "minimum": 0,
      "description": "Ingresos de la actividad económica o profesión del año en USD (lo facturado con RUC en el régimen general)."
    },
    "ingresos_relacion_dependencia": {
      "type": "number",
      "minimum": 0,
      "description": "Ingresos del año 2026 en relación de dependencia en USD (sueldos, horas extra y comisiones; sin décimo tercero ni décimo cuarto, que están exentos)."
    },
    "discapacidad_o_enfermedad_catastrofica": {
      "type": "boolean",
      "description": "true si la persona o una de sus cargas tiene discapacidad o una enfermedad catastrófica, rara o huérfana (tope de 100 canastas)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "causa",
    "fecha_ingreso",
    "fecha_salida",
    "ultima_remuneracion"
  ],
  "properties": {
    "causa": {
      "enum": [
        "renuncia",
        "despido",
        "mutuo",
        "obra",
        "eventual"
      ],
      "type": "string",
      "description": "Causa de salida: renuncia = Renuncia voluntaria (desahucio del trabajador); despido = Despido intempestivo; mutuo = Mutuo acuerdo (acuerdo de las partes); obra = Fin de contrato por obra o servicio determinado dentro del giro del negocio; eventual = Fin de contrato eventual u ocasional."
    },
    "region": {
      "enum": [
        "costa",
        "sierra"
      ],
      "type": "string",
      "description": "Región para el décimo cuarto: «costa» = Costa y Galápagos (por defecto); «sierra» = Sierra y Amazonía."
    },
    "fecha_salida": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Fecha de salida, último día trabajado (AAAA-MM-DD)."
    },
    "fecha_ingreso": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Fecha de ingreso (AAAA-MM-DD)."
    },
    "fondo_reserva": {
      "enum": [
        "mensual",
        "acumulado"
      ],
      "type": "string",
      "description": "Fondo de reserva (desde el segundo año): «mensual» = lo cobraba en el rol (por defecto); «acumulado» = se deposita en el IESS."
    },
    "salario_basico": {
      "type": "number",
      "minimum": 0,
      "description": "Salario básico unificado en USD (por defecto 482, el de 2026)."
    },
    "horas_semanales": {
      "type": "number",
      "maximum": 40,
      "minimum": 1,
      "description": "Horas semanales de la jornada (40 = completa, por defecto)."
    },
    "ultima_remuneracion": {
      "type": "number",
      "minimum": 0,
      "description": "Última remuneración mensual en USD (sueldo más horas extra y comisiones habituales). Es la base de la bonificación y la indemnización."
    },
    "decimo_cuarto_mensual": {
      "type": "boolean",
      "description": "true si cobraba el décimo cuarto cada mes (por defecto false)."
    },
    "remuneracion_promedio": {
      "type": "number",
      "minimum": 0,
      "description": "Remuneración promedio del último año en USD, solo si varía mes a mes (se usa en el décimo tercero y las vacaciones). Por defecto, igual a la última."
    },
    "decimo_tercero_mensual": {
      "type": "boolean",
      "description": "true si cobraba el décimo tercero cada mes (por defecto false)."
    },
    "desahucio_proporcional": {
      "type": "boolean",
      "description": "Pagar en proporción la fracción de año en la bonificación por desahucio (por defecto false: solo años completos)."
    },
    "incluir_sueldo_pendiente": {
      "type": "boolean",
      "description": "Sumar el sueldo de los días trabajados del último mes (por defecto true)."
    },
    "vacaciones_pendientes_dias": {
      "type": "number",
      "minimum": 0,
      "description": "Días de vacaciones no gozadas de años de servicio ya cumplidos (por defecto 0). Los del año en curso se calculan solos."
    },
    "incluir_vacaciones_proporcionales": {
      "type": "boolean",
      "description": "Sumar las vacaciones proporcionales del año en curso (por defecto true)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "concepto",
    "proveedor",
    "base_imponible"
  ],
  "properties": {
    "concepto": {
      "enum": [
        "prof-titulo",
        "intelecto",
        "mano-obra",
        "prof-sociedad",
        "comision-sociedad",
        "bienes",
        "transporte",
        "arriendo",
        "publicidad",
        "agro-productor",
        "agro-comercializador",
        "otros"
      ],
      "type": "string",
      "description": "Concepto del pago: prof-titulo = Honorarios de una persona natural con título de educación superior; intelecto = Servicios de una persona natural sin título donde predomina el intelecto; mano-obra = Servicios de una persona natural donde predomina la mano de obra; prof-sociedad = Servicios profesionales prestados por una sociedad; comision-sociedad = Comisiones pagadas a una sociedad; bienes = Compra de bienes muebles (mercadería, equipos, suministros); transporte = Transporte privado de pasajeros o transporte de carga; arriendo = Arrendamiento de bienes inmuebles; publicidad = Medios de comunicación y agencias de publicidad; agro-productor = Productos agrícolas, pecuarios, bioacuáticos, forestales o carnes en estado natural, al productor; agro-comercializador = Los mismos productos en estado natural, a un comercializador; otros = Otros pagos sin porcentaje específico."
    },
    "proveedor": {
      "enum": [
        "pn",
        "pn-obligada",
        "sociedad",
        "ce",
        "rimpe-emp",
        "rimpe-np"
      ],
      "type": "string",
      "description": "Tipo de proveedor: pn = Persona natural no obligada a llevar contabilidad; pn-obligada = Persona natural obligada a llevar contabilidad; sociedad = Sociedad; ce = Contribuyente especial; rimpe-emp = RIMPE emprendedor; rimpe-np = RIMPE negocio popular."
    },
    "naturaleza": {
      "enum": [
        "bien",
        "servicio"
      ],
      "type": "string",
      "description": "Solo para el concepto «otros»: si lo que se compra es un bien o un servicio (por defecto, bien)."
    },
    "quien_paga": {
      "enum": [
        "agente",
        "especial"
      ],
      "type": "string",
      "description": "Quien paga y retiene: «agente» = agente de retención (por defecto); «especial» = contribuyente especial."
    },
    "tarifa_iva": {
      "enum": [
        15,
        0
      ],
      "type": "integer",
      "description": "IVA de la factura: 15 (tarifa general, por defecto) o 0."
    },
    "base_imponible": {
      "type": "number",
      "minimum": 0,
      "description": "Base imponible de la factura en USD (el subtotal sin IVA)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "sueldo_mensual"
  ],
  "properties": {
    "fondo_reserva": {
      "enum": [
        "mensual",
        "acumulado"
      ],
      "type": "string",
      "description": "«mensual» = el fondo de reserva se paga en el rol (por defecto); «acumulado» = se deposita en el IESS."
    },
    "mas_de_un_anio": {
      "type": "boolean",
      "description": "true si lleva más de un año con el mismo empleador, lo que activa el fondo de reserva (por defecto true)."
    },
    "otros_ingresos": {
      "type": "number",
      "minimum": 0,
      "description": "Horas extra, comisiones y otros ingresos habituales del mes que aportan al IESS, en USD (por defecto 0)."
    },
    "salario_basico": {
      "type": "number",
      "minimum": 0,
      "description": "Salario básico unificado en USD (por defecto 482, el de 2026)."
    },
    "sueldo_mensual": {
      "type": "number",
      "minimum": 0,
      "description": "Sueldo mensual bruto en USD."
    },
    "horas_semanales": {
      "type": "number",
      "maximum": 40,
      "minimum": 1,
      "description": "Horas semanales de la jornada (40 = completa, por defecto)."
    },
    "decimo_cuarto_mensual": {
      "type": "boolean",
      "description": "true si cobra el décimo cuarto cada mes (por defecto true)."
    },
    "decimo_tercero_mensual": {
      "type": "boolean",
      "description": "true si cobra el décimo tercero cada mes (por defecto true)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "ruc_o_noveno_digito"
  ],
  "properties": {
    "mes": {
      "type": "integer",
      "maximum": 12,
      "minimum": 1,
      "description": "Mes del vencimiento (1 a 12). Rango disponible: noviembre de 2026 a diciembre de 2027. Si falta, el mes actual en Ecuador."
    },
    "anio": {
      "type": "integer",
      "maximum": 2027,
      "minimum": 2026,
      "description": "Año del vencimiento (2026 o 2027). Si falta, el mes actual en Ecuador."
    },
    "galapagos": {
      "type": "boolean",
      "description": "true si el domicilio principal está en Galápagos (día 28 para IVA, retenciones y renta)."
    },
    "tipo_contribuyente": {
      "enum": [
        "sociedad",
        "pn",
        "rimpe-emp-pn",
        "rimpe-emp-soc",
        "rimpe-np",
        "ce-soc",
        "ce-pn"
      ],
      "type": "string",
      "description": "Tipo de contribuyente: sociedad = Sociedad (régimen general); pn = Persona natural (régimen general); rimpe-emp-pn = RIMPE emprendedor: persona natural; rimpe-emp-soc = RIMPE emprendedor: sociedad; rimpe-np = RIMPE negocio popular; ce-soc = Contribuyente especial: sociedad; ce-pn = Contribuyente especial: persona natural. Si falta: «pn» cuando el RUC es de persona natural (tercer dígito 0 a 5) y «sociedad» en los demás casos."
    },
    "ruc_o_noveno_digito": {
      "type": "string",
      "maxLength": 30,
      "description": "RUC (13 dígitos), cédula (10) o solo el noveno dígito (un número de 0 a 9)."
    }
  },
  "additionalProperties": false
}