API v1.0.0 · CONSULTAS Y CATÁLOGOS

Catálogos del SRI

Los campos del API que van al XML usan los códigos del SRI. Esta página lista los códigos que acepta el API en cada catálogo; los mismos datos están en GET /catalogos, sin token.

Consultar los catálogos

GET /catalogos lista los catálogos disponibles y GET /catalogos/{nombre} devuelve los códigos de uno. Un nombre que no existe responde 404 NO_ENCONTRADO.
No requieren token. Admiten 60 solicitudes por minuto por dirección IP y se pueden guardar en caché una hora (Cache-Control: public, max-age=3600).
Solo se listan los códigos vigentes, salvo en tarifas-iva, que incluye las tarifas anteriores porque las notas de crédito las usan.

Cada código trae codigo, nombre y vigente, y según el catálogo porcentaje, porcentajeVariable, vigenteDesde y vigenteHasta. Si tu sistema muestra estos códigos en listas de selección, guárdalos y actualízalos una vez al día.

Catálogo	Campo de la solicitud
tipos-identificacion	`cliente.tipoIdentificacion`, `sujetoRetenido.tipoIdentificacion`
formas-pago	`formaPago`, `pagos[].formaPago`
tarifas-iva	`items[].codigoIva`
retenciones-renta	`retenciones[].codigoRetencion` con `codigoImpuesto` `1`
retenciones-iva	`retenciones[].codigoRetencion` con `codigoImpuesto` `2`
tipos-documento-sustento	`documentoSustento.codDoc` de una retención

`tipos-identificacion`

Tipo de identificación del comprador o del sujeto retenido. Si lo omites, se deduce de la identificación (RUC, cédula o consumidor final).

Tipos de identificación del comprador o del sujeto retenido. Fuente: Ficha técnica de comprobantes electrónicos del SRI, tabla 6.
Código	Nombre
`04`	RUC
`05`	Cédula
`06`	Pasaporte
`07`	Consumidor final
`08`	Identificación del exterior

`formas-pago`

Forma de pago de una factura, en formaPago o en pagos[].formaPago.

Formas de pago de una factura. Fuente: Ficha técnica de comprobantes electrónicos del SRI, tabla 24.
Código	Nombre
`01`	SIN UTILIZACION DEL SISTEMA FINANCIERO
`15`	COMPENSACION DE DEUDAS
`16`	TARJETAS DE DEBITO
`17`	DINERO ELECTRONICO
`18`	TARJETA PREPAGO
`19`	TARJETA DE CREDITO
`20`	OTROS CON UTILIZACION DEL SISTEMA FINANCIERO
`21`	ENDOSO DE TITULOS

`tarifas-iva`

Código de IVA de cada ítem (codigoIva). Incluye las tarifas que ya no están vigentes: en una nota de crédito se admiten las vigentes en la fecha de la factura modificada.

Códigos de porcentaje de IVA y su vigencia. Fuente: Ficha técnica de comprobantes electrónicos del SRI, tabla 17.
Código	Nombre	Porcentaje	Vigencia
`0`	IVA 0 %	0 %	Sin fecha
`2`	IVA 12 %	12 %	Hasta el 2024-03-31 (no vigente)
`3`	IVA 14 %	14 %	Del 2016-06-01 al 2017-05-31 (no vigente)
`4`	IVA 15 %	15 %	Desde el 2024-04-01
`5`	IVA 5 %	5 %	Desde el 2024-04-01
`6`	No objeto de IVA	0 %	Sin fecha
`7`	Exento de IVA	0 %	Sin fecha
`8`	IVA diferenciado	8 %	Sin fecha
`10`	IVA 13 %	13 %	Desde el 2024-04-01

`retenciones-renta`

Códigos de retención del impuesto a la renta (codigoImpuesto 1). En los de porcentaje variable, la línea lleva porcentaje.

Buscar por código o nombre

110 códigos

Códigos de retención en la fuente del impuesto a la renta. Fuente: Catálogo de retenciones del SRI (anexo transaccional simplificado).
Código	Nombre	Porcentaje	Vigencia
`303`	HONORARIOS PROFESIONALES Y DEMAS PAGOS POR SERVICIOS RELACIONADOS CON EL TITULO PROFESIONAL	10 %	Desde el 2015-03-01
`304`	SERVICIOS PREDOMINA EL INTELECTO NO RELACIONADOS CON EL TITULO PROFESIONAL	8 %	Desde el 2015-03-01
`304A`	COMISIONES Y DEMAS PAGOS POR SERVICIOS PREDOMINA INTELECTO NO RELACIONADOS CON EL TITULO PROFESIONAL	8 %	Desde el 2015-03-01
`304B`	PAGOS A NOTARIOS Y REGISTRADORES DE LA PROPIEDAD Y MERCANTIL POR SUS ACTIVIDADES EJERCIDAS COMO TALES	8 %	Desde el 2015-03-01
`304C`	PAGOS A DEPORTISTAS ENTRENADORES ARBITROS MIEMBROS DEL CUERPO TECNICO POR SUS ACTIVIDADES EJERCIDAS COMO TALES	8 %	Desde el 2015-03-01
`304D`	PAGOS A ARTISTAS POR SUS ACTIVIDADES EJERCIDAS COMO TALES	8 %	Desde el 2015-03-01
`304E`	HONORARIOS Y DEMAS PAGOS POR SERVICIOS DE DOCENCIA	8 %	Desde el 2015-03-01
`307`	SERVICIOS PREDOMINA LA MANO DE OBRA	2 %	Desde el 2015-03-01
`308`	UTILIZACION O APROVECHAMIENTO DE LA IMAGEN O RENOMBRE	10 %	Desde el 2015-03-01
`309`	SERVICIOS PRESTADOS POR MEDIOS DE COMUNICACION Y AGENCIAS DE PUBLICIDAD	1 %	Desde el 2015-03-01
`310`	SERVICIO DE TRANSPORTE PRIVADO DE PASAJEROS O TRANSPORTE PUBLICO O PRIVADO DE CARGA	1 %	Desde el 2015-03-01
`311`	POR PAGOS A TRAVES DE LIQUIDACION DE COMPRA (NIVEL CULTURAL O RUSTICIDAD)	2 %	Desde el 2015-03-01
`312`	TRANSFERENCIA DE BIENES MUEBLES DE NATURALEZA CORPORAL	1.75 %	Desde el 2015-03-01
`312A`	COMPRA DE BIENES DE ORIGEN AGRICOLA AVICOLA PECUARIO APICOLA CUNICULA BIOACUATICO Y FORESTAL	1 %	Desde el 2015-03-01
`314A`	REGALIAS POR CONCEPTO DE FRANQUICIAS DE ACUERDO A LEY DE PROPIEDAD INTELECTUAL - PAGO A PERSONAS NATURALES	8 %	Desde el 2015-03-01
`314B`	CANONES DERECHOS DE AUTOR MARCAS PATENTES Y SIMILARES DE ACUERDO A LEY DE PROPIEDAD INTELECTUAL PAGO A PERSONAS NATURALES	8 %	Desde el 2015-03-01
`314C`	REGALIAS POR CONCEPTO DE FRANQUICIAS DE ACUERDO A LEY DE PROPIEDAD INTELECTUAL - PAGO A SOCIEDADES	8 %	Desde el 2015-03-01
`314D`	CANONES DERECHOS DE AUTOR MARCAS PATENTES Y SIMILARES DE ACUERDO A LEY DE PROPIEDAD INTELECTUAL PAGO A SOCIEDADES	8 %	Desde el 2015-03-01
`319`	CUOTAS DE ARRENDAMIENTO MERCANTIL INCLUSIVE LA DE OPCION DE COMPRA	1 %	Desde el 2015-03-01
`320`	POR ARRENDAMIENTO BIENES INMUEBLES	8 %	Desde el 2015-03-01
`322`	SEGUROS Y REASEGUROS (PRIMAS Y CESIONES)	1 %	Desde el 2015-03-01
`323`	POR RENDIMIENTOS FINANCIEROS PAGADOS A NATURALES Y SOCIEDADES (NO A IFIS)	2 %	Desde el 2015-03-01
`323A`	POR RF: DEPOSITOS CTA. CORRIENTE	2 %	Desde el 2015-03-01
`323B1`	POR RF: DEPOSITOS CTA. AHORROS SOCIEDADES	2 %	Desde el 2015-03-01
`323E`	POR RF: DEPOSITO A PLAZO FIJO GRAVADOS	2 %	Desde el 2015-03-01
`323E2`	POR RF: DEPOSITO A PLAZO FIJO EXENTOS	Variable	Desde el 2015-03-01
`323F`	POR RENDIMIENTOS FINANCIEROS: OPERACIONES DE REPORTO - REPOS	2 %	Desde el 2015-03-01
`323G`	POR RF: INVERSIONES (CAPTACIONES) RENDIMIENTOS DISTINTOS DE AQUELLOS PAGADOS A IFIS	2 %	Desde el 2015-03-01
`323H`	POR RF: OBLIGACIONES	2 %	Desde el 2015-03-01
`323I`	POR RF: BONOS CONVERTIBLE EN ACCIONES	2 %	Desde el 2015-03-01
`323M`	POR RF: INVERSIONES EN TITULOS VALORES EN RENTA FIJA GRAVADOS	2 %	Desde el 2015-03-01
`323N`	POR RF: INVERSIONES EN TITULOS VALORES EN RENTA FIJA EXENTOS	Variable	Desde el 2015-03-01
`323O`	POR RF: INTERESES PAGADOS A BANCOS Y OTRAS ENTIDADES SOMETIDAS AL CONTROL DE LA SUPERINTENDENCIA DE BANCOS Y DE LA EPS	Variable	Desde el 2015-03-01
`323P`	POR RF: INTERESES PAGADOS POR ENTIDADES DEL SECTOR PUBLICO A FAVOR DE SUJETOS PASIVOS	2 %	Desde el 2015-03-01
`323Q`	POR RF: OTROS INTERESES Y RENDIMIENTOS FINANCIEROS GRAVADOS	2 %	Desde el 2015-03-01
`323R`	POR RF: OTROS INTERESES Y RENDIMIENTOS FINANCIEROS EXENTOS	Variable	Desde el 2015-03-01
`324A`	POR RF: INTERESES EN OPERACIONES DE CREDITO ENTRE INSTITUCIONES DEL SISTEMA FINANCIERO Y ENTIDADES ECONOMIA POPULAR Y SOLIDARIA.	1 %	Desde el 2015-03-01
`324B`	POR RF: POR INVERSIONES ENTRE INSTITUCIONES DEL SISTEMA FINANCIERO Y ENTIDADES ECONOMIA POPULAR Y SOLIDARIA.	1 %	Desde el 2015-03-01
`325`	ANTICIPO DIVIDENDOS	22 %	Desde el 2015-03-01
`325A`	DIVIDENDOS ANTICIPADOS PRESTAMOS ACCIONISTAS BENEFICIARIOS O PARTICIPES	22 %	Desde el 2015-03-01
`326`	DIVIDENDOS DISTRIBUIDOS QUE CORRESPONDAN AL IMPUESTO A LA RENTA UNICO ESTABLECIDO EN EL ART. 27 DE LA LRTI	Variable	Desde el 2015-03-01
`327`	DIVIDENDOS DISTRIBUIDOS A PERSONAS NATURALES RESIDENTES	Variable	Desde el 2015-03-01
`328`	DIVIDENDOS DISTRIBUIDOS A SOCIEDADES RESIDENTES	Variable	Desde el 2015-03-01
`329`	DIVIDENDOS DISTRIBUIDOS A FIDEICOMISOS RESIDENTES	Variable	Desde el 2015-03-01
`331`	DIVIDENDOS EXENTOS DISTRIBUIDOS EN ACCIONES (REINVERSION DE UTILIDADES CON DERECHO A REDUCCION TARIFA IR)	Variable	Desde el 2015-03-01
`332`	OTRAS COMPRAS DE BIENES Y SERVICIOS NO SUJETAS A Retencion	Variable	Desde el 2015-03-01
`332B`	COMPRA DE BIENES INMUEBLES	Variable	Desde el 2015-03-01
`332C`	TRANSPORTE PUBLICO DE PASAJEROS	Variable	Desde el 2015-03-01
`332D`	PAGOS EN EL PAIS POR TRANS. DE PASAJ O TRANS. INTERN. DE CARGA A CIAS NACIONALES O EXTRANJERAS DE AVIACION O MARITIMAS	Variable	Desde el 2015-03-01
`332E`	VALORES ENTREGADOS POR LAS COOPERATIVAS DE TRANSPORTE A SUS SOCIOS	Variable	Desde el 2015-03-01
`332F`	COMPRAVENTA DE DIVISAS DISTINTAS AL DOLAR DE LOS ESTADOS UNIDOS DE AMERICA	Variable	Desde el 2015-03-01
`332G`	PAGOS CON TARJETA DE CREDITO	Variable	Desde el 2015-03-01
`332H`	PAGO AL EXTERIOR TARJETA DE CREDITO REPORTADA POR LA EMISORA DE TARJETA DE CREDITO SOLO RECAP	Variable	Desde el 2015-03-01
`332I`	PAGO A TRAVES DE CONVENIO DE DEBITO (ClienteS IFIS)	Variable	Desde el 2016-05-01
`333`	ENAJENACION DE DERECHOS REPRESENTATIVOS DE CAPITAL Y OTROS DERECHOS COTIZADOS EN BOLSA ECUATORIANA	0.2 %	Desde el 2015-03-01
`334`	ENAJENACION DE DERECHOS REPRESENTATIVOS DE CAPITAL Y OTROS DERECHOS NO COTIZADOS EN BOLSA ECUATORIANA	1 %	Desde el 2015-03-01
`335`	POR LOTERIAS RIFAS APUESTAS Y SIMILARES	15 %	Desde el 2015-03-01
`336`	POR VENTA DE COMBUSTIBLES A COMERCIALIZADORAS	0.2 %	Desde el 2015-03-01
`337`	POR VENTA DE COMBUSTIBLES A DISTRIBUIDORES	0.3 %	Desde el 2015-03-01
`338`	COMPRA LOCAL DE BANANO A PRODUCTOR	Variable	Desde el 2015-03-01
`340`	IMPUESTO UNICO A LA EXPORTACION DE BANANO DE PRODUCCION PROPIA - COMPONENTE 1	Variable	Desde el 2015-03-01
`343`	Otras retenciones aplicables el 1%	1 %	Desde el 2023-07-27
`343A`	POR ENERGIA ELECTRICA	1 %	Desde el 2015-03-01
`343B`	POR ACTIVIDADES DE CONSTRUCCION DE OBRA MATERIAL INMUEBLE URBANIZACION LOTIZACION O ACTIVIDADES SIMILARES	1 %	Desde el 2015-03-01
`344A`	Pago local tarjeta de credito /debito reportada por la Emisora de tarjeta de credito / entidades del sistema financiero	2 %	Desde el 2020-04-01
`344B`	Adquisicion de sustancias minerales dentro del territorio nacional	2 %	Desde el 2020-04-01
`346A`	GANANCIAS DE CAPITAL	Variable	Desde el 2015-03-01
`348`	Retencion A CARGO DEL PROPIO SUJETO PASIVO POR LA EXPORTACION DE CONCENTRADOS Y/O ELEMENTOS METALICOS	Variable	Desde el 2016-05-01
`500`	PAGO AL EXTERIOR - RENTAS INMOBILIARIAS	Variable	Desde el 2015-03-01
`501`	PAGO AL EXTERIOR - BENEFICIOS EMPRESARIALES	Variable	Desde el 2015-03-01
`503`	PAGO AL EXTERIOR - NAVEGACION MARITIMA Y/O AEREA	Variable	Desde el 2015-03-01
`504`	PAGO AL EXTERIOR- DIVIDENDOS DISTRIBUIDOS A PERSONAS NATURALES	0 %	Desde el 2015-03-01
`504A`	PAGO AL EXTERIOR - DIVIDENDOS A SOCIEDADES	Variable	Desde el 2015-03-01
`504B`	PAGO AL EXTERIOR - ANTICIPO DIVIDENDOS	22 %	Desde el 2015-03-01
`504C`	PAGO AL EXTERIOR - DIVIDENDOS ANTICIPADOS PRESTAMOS ACCIONISTAS BENEFICIARIOS O PARTICIPES	Variable	Desde el 2015-03-01
`504D`	PAGO AL EXTERIOR - DIVIDENDOS A FIDEICOMISOS	Variable	Desde el 2015-03-01
`504E`	PAGO AL EXTERIOR- DIVIDENDOS DISTRIBUIDOS A PERSONAS NATURALES (PARAISOS FISCALES)	0 %	Desde el 2015-03-01
`504F`	PAGO AL EXTERIOR - DIVIDENDOS A SOCIEDADES (PARAISOS FISCALES)	13 %	Desde el 2015-03-01
`504G`	PAGO AL EXTERIOR - ANTICIPO DIVIDENDOS (PARAISOS FISCALES)	25 %	Desde el 2015-03-01
`504H`	PAGO AL EXTERIOR - DIVIDENDOS A FIDEICOMISOS (PARAISOS FISCALES)	13 %	Desde el 2015-03-01
`505`	PAGO AL EXTERIOR - RENDIMIENTOS FINANCIEROS	Variable	Desde el 2015-03-01
`505A`	PAGO AL EXTERIOR: INTERESES DE CREDITOS DE INSTITUCIONES FINANCIERAS DEL EXTERIOR	Variable	Desde el 2015-03-01
`505B`	PAGO AL EXTERIOR:INTERESES DE CREDITOS DE GOBIERNO A GOBIERNO	Variable	Desde el 2015-03-01
`505C`	PAGO AL EXTERIOR:INTERESES DE CREDITOS DE ORGANISMOS MULTILATERALES	Variable	Desde el 2015-03-01
`505D`	PAGO AL EXTERIOR - INTERESES POR FINANCIAMIENTO DE PROVEEDORES EXTERNOS	Variable	Desde el 2015-03-01
`505E`	PAGO AL EXTERIOR - INTERESES DE OTROS CREDITOS EXTERNOS	Variable	Desde el 2015-03-01
`505F`	PAGO AL EXTERIOR - OTROS INTERESES Y RENDIMIENTOS FINANCIEROS	Variable	Desde el 2015-03-01
`509`	PAGO AL EXTERIOR – CANONES DERECHOS DE AUTOR MARCAS PATENTES Y SIMILARES	Variable	Desde el 2015-03-01
`509A`	PAGO AL EXTERIOR - REGALIAS POR CONCEPTO DE FRANQUICIAS	Variable	Desde el 2015-03-01
`510`	PAGO AL EXTERIOR - GANANCIAS DE CAPITAL	Variable	Desde el 2015-03-01
`511`	PAGO AL EXTERIOR - SERVICIOS PROFESIONALES INDEPENDIENTES	Variable	Desde el 2015-03-01
`512`	PAGO AL EXTERIOR - SERVICIOS PROFESIONALES DEPENDIENTES	Variable	Desde el 2015-03-01
`513`	PAGO AL EXTERIOR - ARTISTAS	Variable	Desde el 2015-03-01
`513A`	PAGO AL EXTERIOR - DEPORTISTAS	Variable	Desde el 2015-03-01
`514`	PAGO AL EXTERIOR - PARTICIPACION DE CONSEJEROS	Variable	Desde el 2015-03-01
`515`	PAGO AL EXTERIOR - ENTRETENIMIENTO PUBLICO	Variable	Desde el 2015-03-01
`516`	PAGO AL EXTERIOR - PENSIONES	Variable	Desde el 2015-03-01
`517`	PAGO AL EXTERIOR - REEMBOLSO DE GASTOS	Variable	Desde el 2015-03-01
`518`	PAGO AL EXTERIOR - FUNCIONES PUBLICAS	Variable	Desde el 2015-03-01
`519`	PAGO AL EXTERIOR - ESTUDIANTES	Variable	Desde el 2015-03-01
`520A`	PAGO AL EXTERIOR - OTROS CONCEPTOS DE INGRESOS GRAVADOS	Variable	Desde el 2015-03-01
`520B`	PAGO AL EXTERIOR - ARRENDAMIENTOS MERCANTIL INTERNACIONAL	Variable	Desde el 2015-03-01
`520D`	PAGO AL EXTERIOR - COMISIONES POR EXPORTACIONES Y POR PROMOCION DE TURISMO RECEPTIVO	Variable	Desde el 2015-03-01
`520E`	PAGO AL EXTERIOR - POR LAS EMPRESAS DE TRANSPORTE MARITIMO O AEREO Y POR EMPRESAS PESQUERAS DE ALTA MAR POR SU ACTIVIDAD.	Variable	Desde el 2015-03-01
`520F`	PAGO AL EXTERIOR - POR LAS AGENCIAS INTERNACIONALES DE PRENSA	Variable	Desde el 2015-03-01
`520G`	PAGO AL EXTERIOR - CONTRATOS DE FLETAMENTO DE NAVES PARA EMPRESAS DE TRANSPORTE AEREO O MARITIMO INTERNACIONAL	Variable	Desde el 2015-03-01
`521`	PAGO AL EXTERIOR - ENAJENACION DE DERECHOS REPRESENTATIVOS DE CAPITAL Y OTROS DERECHOS	5 %	Desde el 2015-03-01
`523A`	PAGO AL EXTERIOR - SEGUROS Y REASEGUROS (PRIMAS Y CESIONES) CON CONVENIO DE DOBLE TRIBUTACION	Variable	Desde el 2015-03-01
`525`	PAGO AL EXTERIOR - DONACIONES EN DINERO - IMPUESTO A LAS DONACIONES	Variable	Desde el 2016-05-01
`3440`	Otras retenciones aplicables el 2,75%	2.75 %	Desde el 2020-04-01

`retenciones-iva`

Códigos de retención del IVA (codigoImpuesto 2). La base imponible es el valor del IVA del documento sustento.

Códigos de retención del IVA. Fuente: Ficha técnica de comprobantes electrónicos del SRI, tabla 21.
Código	Nombre	Porcentaje	Vigencia
`1`	30%	30 %	Desde el 2009-07-04
`2`	70%	70 %	Desde el 2017-06-01
`3`	100%	100 %	Desde el 2009-07-04
`5`	100% VALOR RETENIDO DISTRIBUIDOR	100 %	Desde el 2014-06-30
`6`	100% VALOR RETENIDO VOCEADORES VARIOS	100 %	Desde el 2014-06-30
`7`	0,00%	0 %	Desde el 2015-06-01
`8`	0% NO PROCEDE Retencion	0 %	Desde el 2015-06-01
`9`	10%	10 %	Desde el 2015-06-01
`10`	20%	20 %	Desde el 2015-06-01

`tipos-documento-sustento`

Tipo del documento que sustenta una retención (documentoSustento.codDoc). Incluye la liquidación de compra (03) emitida fuera de Golem.

Buscar por código o nombre

33 códigos

Tipos de comprobante que sustentan una retención, incluida la liquidación de compra emitida fuera de Golem. Fuente: Tipos de comprobantes autorizados por el SRI.
Código	Nombre
`01`	FACTURA
`02`	NOTA O BOLETA DE VENTA
`03`	LIQUIDACIÓN DE COMPRA DE BIENES O PRESTACIÓN DE SERVICIOS
`04`	NOTA DE CRÉDITO
`05`	NOTA DE DÉBITO
`06`	GUIAS DE REMISIÓN
`08`	BOLETOS O ENTRADAS A ESPECTÁCULOS PÚBLICOS
`09`	TIQUETES O VALES EMITIDOS POR MÁQUINAS REGISTRADORAS
`11`	PASAJES EXPEDIDOS POR EMPRESAS DE AVIACIÓN
`12`	DOCUMENTOS EMITIDOS POR INSTITUCIONES FINANCIERAS
`13`	DOCUMENTOS EMITIDOS POR COMPAÑIAS DE SEGUROS
`15`	COMPROBANTE DE VENTA EMITIDO EN EL EXTERIOR
`16`	FORMULARIO ÚNICO DE EXPORTACIÓN (FUE) O DECLARACIÓN ADUANERA ÚNICA (DAU) O DECLARACIÓN ANDINA DE VALOR (DAV)
`18`	DOCUMENTOS AUTORIZADOS UTILIZADOS EN VENTAS EXCEPTO N/C N/D
`19`	COMPROBANTES DE PAGO DE CUOTAS O APORTES
`20`	DOCUMENTOS POR SERVICIOS ADMINISTRATIVOS EMITIDOS POR INST. DEL ESTADO
`21`	CARTA DE PORTE AÉREO
`22`	RECAP
`23`	NOTA DE CRÉDITO TC
`24`	NOTA DE DÉBITO TC
`41`	COMPROBANTE DE VENTA EMITIDO POR REEMBOLSO
`42`	DOCUMENTO AGENTE DE RETENCIÓN PRESUNTIVA
`43`	LIQUIDACION PARA EXPLOTACION Y EXPLORACION DE HIDROCARBUROS
`44`	COMPROBANTE DE CONTRIBUCIONES Y APORTES
`45`	LIQUIDACIÓN POR RECLAMOS DE ASEGURADORAS
`47`	NOTA DE CRÉDITO POR REEMBOLSO EMITIDA POR INTERMEDIARIO
`48`	NOTA DE DÉBITO POR REEMBOLSO EMITIDA POR INTERMEDIARIO
`49`	PROVEEDOR DIRECTO DE EXPORTADOR BAJO RÉGIMEN ESPECIAL
`50`	A INST. ESTADO Y EMPR. PÚBLICAS QUE PERCIBE INGRESO EXENTO DE IMP. RENTA
`51`	N/C A INST. ESTADO Y EMPR. PÚBLICAS QUE PERCIBE INGRESO EXENTO DE IMP. RENTA
`52`	N/D A INST. ESTADO Y EMPR. PÚBLICAS QUE PERCIBE INGRESO EXENTO DE IMP. RENTA
`294`	LIQUIDACIÓN DE COMPRA DE BIENES MUEBLES USADOS
`344`	LIQUIDACIÓN DE COMPRA DE VEHÍCULOS USADOS

Listar los catálogos

GET /catalogos

Sin token

Nombres y descripción de los catálogos del SRI disponibles. No requiere token.

Límites: 60 solicitudes por minuto por dirección IP.

Ejemplo de solicitud

Los ejemplos leen el token de la variable de entorno GOLEM_TOKEN.

Terminal

curl https://api.golem.ec/v1/catalogos \
  --max-time 30

Node.js 18+ (fetch)

const respuesta = await fetch('https://api.golem.ec/v1/catalogos', {
  signal: AbortSignal.timeout(30000),
});
const datos = await respuesta.json();
console.log(respuesta.status, datos);

Python (requests)

import requests

respuesta = requests.get(
    "https://api.golem.ec/v1/catalogos",
    timeout=30,
)
print(respuesta.status_code, respuesta.json())

PHP (Guzzle)

<?php
// composer require guzzlehttp/guzzle
require 'vendor/autoload.php';

use GuzzleHttp\Client;

$cliente = new Client(['base_uri' => 'https://api.golem.ec/v1/', 'timeout' => 30]);

$respuesta = $cliente->get('catalogos', [
    'http_errors' => false,
]);

echo $respuesta->getStatusCode(), PHP_EOL, $respuesta->getBody(), PHP_EOL;

Respuestas

200 application/json

Catálogos disponibles.

Respuesta 200

{
  "datos": [
    {
      "nombre": "tipos-identificacion",
      "descripcion": "Tipos de identificación del comprador o del sujeto retenido.",
      "fuente": "Ficha técnica de comprobantes electrónicos del SRI, tabla 6."
    },
    {
      "nombre": "formas-pago",
      "descripcion": "Formas de pago de una factura.",
      "fuente": "Ficha técnica de comprobantes electrónicos del SRI, tabla 24."
    },
    {
      "nombre": "tarifas-iva",
      "descripcion": "Códigos de porcentaje de IVA y su vigencia.",
      "fuente": "Ficha técnica de comprobantes electrónicos del SRI, tabla 17."
    },
    {
      "nombre": "retenciones-renta",
      "descripcion": "Códigos de retención en la fuente del impuesto a la renta.",
      "fuente": "Catálogo de retenciones del SRI (anexo transaccional simplificado)."
    },
    {
      "nombre": "retenciones-iva",
      "descripcion": "Códigos de retención del IVA.",
      "fuente": "Ficha técnica de comprobantes electrónicos del SRI, tabla 21."
    },
    {
      "nombre": "tipos-documento-sustento",
      "descripcion": "Tipos de comprobante que sustentan una retención, incluida la liquidación de compra emitida fuera de Golem.",
      "fuente": "Tipos de comprobantes autorizados por el SRI."
    }
  ]
}

Errores: HTTP 429

Códigos de error de listar los catálogos
HTTP	Código	Causa y solución
429	`LIMITE_EXCEDIDO`	Se superó un límite de solicitudes por minuto. Repite la solicitud después de los segundos de `Retry-After`.

Formato y lista completa en Errores.

Consultar un catálogo

GET /catalogos/{nombre}

Sin token

Códigos que acepta el API, con su nombre y, según el catálogo, su porcentaje y su fecha de vigencia. Solo se listan los códigos vigentes, salvo en tarifas-iva, que incluye las tarifas anteriores porque las notas de crédito las usan. No requiere token.

Límites: 60 solicitudes por minuto por dirección IP.

Parámetros

Parámetros de consultar un catálogo
Campo	Descripción
`nombre` ruta string obligatorio	Nombre del catálogo. Valores: `tipos-identificacion`, `formas-pago`, `tarifas-iva`, `retenciones-renta`, `retenciones-iva`, `tipos-documento-sustento`

Ejemplo de solicitud

Los ejemplos leen el token de la variable de entorno GOLEM_TOKEN.

Terminal

curl https://api.golem.ec/v1/catalogos/formas-pago \
  --max-time 30

Node.js 18+ (fetch)

const respuesta = await fetch('https://api.golem.ec/v1/catalogos/formas-pago', {
  signal: AbortSignal.timeout(30000),
});
const datos = await respuesta.json();
console.log(respuesta.status, datos);

Python (requests)

import requests

respuesta = requests.get(
    "https://api.golem.ec/v1/catalogos/formas-pago",
    timeout=30,
)
print(respuesta.status_code, respuesta.json())

PHP (Guzzle)

<?php
// composer require guzzlehttp/guzzle
require 'vendor/autoload.php';

use GuzzleHttp\Client;

$cliente = new Client(['base_uri' => 'https://api.golem.ec/v1/', 'timeout' => 30]);

$respuesta = $cliente->get('catalogos/formas-pago', [
    'http_errors' => false,
]);

echo $respuesta->getStatusCode(), PHP_EOL, $respuesta->getBody(), PHP_EOL;

Respuestas

200 application/json

El catálogo.

Esquema Catalogo.

Respuesta 200: Formas de pago vigentes

{
  "nombre": "formas-pago",
  "descripcion": "Formas de pago de una factura.",
  "fuente": "Ficha técnica de comprobantes electrónicos del SRI, tabla 24.",
  "datos": [
    {
      "codigo": "01",
      "nombre": "SIN UTILIZACION DEL SISTEMA FINANCIERO",
      "vigente": true
    },
    {
      "codigo": "15",
      "nombre": "COMPENSACION DE DEUDAS",
      "vigente": true
    },
    {
      "codigo": "16",
      "nombre": "TARJETAS DE DEBITO",
      "vigente": true
    },
    {
      "codigo": "17",
      "nombre": "DINERO ELECTRONICO",
      "vigente": true
    },
    {
      "codigo": "18",
      "nombre": "TARJETA PREPAGO",
      "vigente": true
    },
    {
      "codigo": "19",
      "nombre": "TARJETA DE CREDITO",
      "vigente": true
    },
    {
      "codigo": "20",
      "nombre": "OTROS CON UTILIZACION DEL SISTEMA FINANCIERO",
      "vigente": true
    },
    {
      "codigo": "21",
      "nombre": "ENDOSO DE TITULOS",
      "vigente": true
    }
  ]
}

Más ejemplos de la respuesta 200

Tarifas de IVA y su vigencia

{
  "nombre": "tarifas-iva",
  "descripcion": "Códigos de porcentaje de IVA y su vigencia.",
  "fuente": "Ficha técnica de comprobantes electrónicos del SRI, tabla 17.",
  "datos": [
    {
      "codigo": "0",
      "nombre": "IVA 0 %",
      "porcentaje": 0,
      "vigente": true,
      "vigenteDesde": null,
      "vigenteHasta": null
    },
    {
      "codigo": "2",
      "nombre": "IVA 12 %",
      "porcentaje": 12,
      "vigente": false,
      "vigenteDesde": null,
      "vigenteHasta": "2024-03-31"
    },
    {
      "codigo": "3",
      "nombre": "IVA 14 %",
      "porcentaje": 14,
      "vigente": false,
      "vigenteDesde": "2016-06-01",
      "vigenteHasta": "2017-05-31"
    },
    {
      "codigo": "4",
      "nombre": "IVA 15 %",
      "porcentaje": 15,
      "vigente": true,
      "vigenteDesde": "2024-04-01",
      "vigenteHasta": null
    },
    {
      "codigo": "5",
      "nombre": "IVA 5 %",
      "porcentaje": 5,
      "vigente": true,
      "vigenteDesde": "2024-04-01",
      "vigenteHasta": null
    },
    {
      "codigo": "6",
      "nombre": "No objeto de IVA",
      "porcentaje": 0,
      "vigente": true,
      "vigenteDesde": null,
      "vigenteHasta": null
    },
    {
      "codigo": "7",
      "nombre": "Exento de IVA",
      "porcentaje": 0,
      "vigente": true,
      "vigenteDesde": null,
      "vigenteHasta": null
    },
    {
      "codigo": "8",
      "nombre": "IVA diferenciado",
      "porcentaje": 8,
      "vigente": true,
      "vigenteDesde": null,
      "vigenteHasta": null
    },
    {
      "codigo": "10",
      "nombre": "IVA 13 %",
      "porcentaje": 13,
      "vigente": true,
      "vigenteDesde": "2024-04-01",
      "vigenteHasta": null
    }
  ]
}

Extracto de códigos de retención de renta

{
  "nombre": "retenciones-renta",
  "descripcion": "Códigos de retención en la fuente del impuesto a la renta.",
  "fuente": "Catálogo de retenciones del SRI (anexo transaccional simplificado).",
  "datos": [
    {
      "codigo": "303",
      "nombre": "Honorarios profesionales y demás pagos por servicios relacionados con el título profesional",
      "porcentaje": 10,
      "porcentajeVariable": false,
      "vigente": true,
      "vigenteDesde": "2015-03-01",
      "vigenteHasta": null
    },
    {
      "codigo": "312",
      "nombre": "Transferencia de bienes muebles de naturaleza corporal",
      "porcentaje": 1.75,
      "porcentajeVariable": false,
      "vigente": true,
      "vigenteDesde": "2015-03-01",
      "vigenteHasta": null
    },
    {
      "codigo": "332",
      "nombre": "Otras compras de bienes y servicios no sujetas a retención",
      "porcentaje": 0,
      "porcentajeVariable": false,
      "vigente": true,
      "vigenteDesde": "2015-03-01",
      "vigenteHasta": null
    },
    {
      "codigo": "500",
      "nombre": "Pago al exterior - rentas inmobiliarias",
      "porcentaje": null,
      "porcentajeVariable": true,
      "vigente": true,
      "vigenteDesde": "2015-03-01",
      "vigenteHasta": null
    }
  ]
}

Errores: HTTP 404, 429

Códigos de error de consultar un catálogo
HTTP	Código	Causa y solución
404	`NO_ENCONTRADO`	El recurso no existe en la empresa y el ambiente del token, o el catálogo no existe. Revisa la clave de acceso y que el token sea del mismo ambiente en que se emitió el comprobante.
429	`LIMITE_EXCEDIDO`	Se superó un límite de solicitudes por minuto. Repite la solicitud después de los segundos de `Retry-After`.

Formato y lista completa en Errores.