Catálogos (sin API Key)

Estos endpoints no requieren autenticación. Sirven para obtener los códigos válidos al construir el body de facturas y notas de crédito.

Endpoints

Método	Ruta	Descripción
GET	`/v1/catalogs`	Lista todos los catálogos disponibles.
GET	`/v1/catalogs/:id`	Ítems de un catálogo específico.

IDs de catálogo útiles

ID	Contenido
`iva-rate-codes`	Tarifas de IVA. El ítem con `"default": true` es la tarifa vigente del sistema.
`payment-methods`	Formas de pago (tabla 24 SRI).
`buyer-id-types`	Tipos de identificación del comprador.
`tax-types`	Tipos de impuesto (IVA, ICE, IRBPNR).
`document-types`	Tipos de comprobante electrónico.
`emission-types`	Tipos de emisión (normal, contingencia).
`environments`	Ambientes SRI (pruebas, producción).
`retention-tax-types`	Tipos de impuesto para retenciones.

Ejemplo de respuesta GET /v1/catalogs/iva-rate-codes

{
  "success": true,
  "data": {
    "id": "iva-rate-codes",
    "name": "IVA Rate Codes",
    "items": [
      { "code": "0", "name": "0%", "description": "Zero rate — basic goods, exports, medicines" },
      { "code": "2", "name": "15%", "description": "General rate — currently in force (as of 2024)", "default": true },
      { "code": "3", "name": "14%", "description": "Temporary rate" },
      { "code": "4", "name": "12%", "description": "Historical general rate — prior to 2024" },
      { "code": "5", "name": "5%", "description": "Reduced rate — differentiated goods" },
      { "code": "6", "name": "No objeto de IVA" },
      { "code": "7", "name": "Exento de IVA" },
      { "code": "8", "name": "IVA diferenciado" },
      { "code": "10", "name": "13%", "description": "Temporary rate" }
    ]
  }
}

El ítem con "default": true indica la tarifa general vigente. Úsalo para prellenar formularios.