Referencia API
Especificación OpenAPI interactiva con esquemas, ejemplos y código por lenguaje.
Endpoints
Lista de operaciones del contrato. El detalle de cada una está en la referencia interactiva y en las guías.
| Método | Ruta | Descripción |
|---|---|---|
GET | /v1/catalogos | Lista los catalogos del SRI. |
GET | /v1/catalogos/{nombre} | Obtiene el detalle de un catalogo del SRI. |
GET | /v1/contexto | Obtiene el contexto de la integracion. |
GET | /v1/consultas/contribuyentes/{identificacion} | Consulta un contribuyente en el catastro del SRI. |
GET | /v1/consultas/contribuyentes | Busca contribuyentes en el catastro del SRI. |
GET | /v1/consultas/establecimientos/{ruc} | Lista los establecimientos de un RUC en el catastro. |
GET | /v1/consultas/identificacion/validar/{numero} | Valida una cedula, RUC o pasaporte. |
GET | /v1/consultas/comprobantes/decodificar/{claveAcceso} | Decodifica una clave de acceso del SRI. |
GET | /v1/contribuyentes/{identificacion}/comprobantes/{claveAcceso}/ride | Descarga el RIDE de un comprobante autorizado. |
GET | /v1/contribuyentes/{identificacion}/comprobantes/{claveAcceso}/xml | Descarga el XML de un comprobante autorizado. |
GET | /v1/operaciones | Lista los comprobantes emitidos por un contribuyente. |
GET | /v1/operaciones/{id} | Consulta una operacion por su identificador. |
GET | /v1/consumo | Consulta el cupo disponible de la integracion. |
POST | /v1/contribuyentes/{identificacion}/facturas | Emite una factura electronica (01). |
POST | /v1/contribuyentes/{identificacion}/liquidaciones-compra | Emite una liquidacion de compra (03). |
POST | /v1/contribuyentes/{identificacion}/notas-credito | Emite una nota de credito (04). |
POST | /v1/contribuyentes/{identificacion}/notas-debito | Emite una nota de debito (05). |
POST | /v1/contribuyentes/{identificacion}/guias-remision | Emite una guia de remision (06). |
POST | /v1/contribuyentes/{identificacion}/retenciones | Emite un comprobante de retencion (07). |
GET | /v1/contribuyentes/{identificacion}/perfil | Consulta el perfil del emisor. |
PUT | /v1/contribuyentes/{identificacion}/perfil | Actualiza el perfil del emisor. |
POST | /v1/contribuyentes/{identificacion}/perfil/logo | Actualiza el logo del emisor. |
POST | /v1/contribuyentes/{identificacion}/facturas/validar | Valida una factura (01) sin emitirla. |
POST | /v1/contribuyentes/{identificacion}/liquidaciones-compra/validar | Valida una liquidacion de compra (03) sin emitirla. |
POST | /v1/contribuyentes/{identificacion}/notas-credito/validar | Valida una nota de credito (04) sin emitirla. |
POST | /v1/contribuyentes/{identificacion}/notas-debito/validar | Valida una nota de debito (05) sin emitirla. |
POST | /v1/contribuyentes/{identificacion}/guias-remision/validar | Valida una guia de remision (06) sin emitirla. |
POST | /v1/contribuyentes/{identificacion}/retenciones/validar | Valida un comprobante de retencion (07) sin emitirlo. |
GET | /v1/webhooks/destinos | Lista los destinos de webhooks de la integracion. |
POST | /v1/webhooks/destinos | Crea un destino de webhooks. |
GET | /v1/webhooks/destinos/{id} | Consulta un destino de webhooks. |
PUT | /v1/webhooks/destinos/{id}/eventos | Reemplaza los eventos de un destino. |
POST | /v1/webhooks/destinos/{id}/rotar-secreto | Rota el secreto de firma de un destino. |
POST | /v1/webhooks/destinos/{id}/probar | Envia un evento de prueba a un destino. |
POST | /v1/webhooks/destinos/{id}/pausar | Pausa las entregas de un destino. |
POST | /v1/webhooks/destinos/{id}/reanudar | Reanuda las entregas de un destino pausado. |
POST | /v1/webhooks/destinos/{id}/deshabilitar | Deshabilita un destino de webhooks. |
GET | /v1/webhooks/destinos/{id}/entregas | Lista las entregas de un destino. |
GET | /v1/webhooks/destinos/{id}/entregas/{entregaId}/intentos | Lista los intentos de una entrega. |
POST | /v1/webhooks/destinos/{id}/entregas/{eventoId}/reintentar | Reencola una entrega fallida o rechazada. |