Extracción
El API de Extracción conecta tu aplicación con el Servicio de Rentas Internas (SRI) de Ecuador y con el SAT de México. Con una sola credencial puedes registrar contribuyentes, extraer sus documentos fiscales en XML, PDF y JSON, consultar su información tributaria y recibir cada resultado por webhook.
El SRI no ofrece un API pública. Taxo se encarga de esa integración y te entrega datos estructurados, actualizados y listos para procesar.
Cómo empezar
- Solicita tu cuenta. Pide acceso en el formulario de credenciales; el equipo de Taxo te entrega una clave de API.
- Integra contra staging. Apunta a
https://staging-api.taxo.wsmientras desarrollas. - Registra un contribuyente. Es el primer recurso que necesita cualquier extracción: ver Contribuyentes.
- Lanza tu primera extracción y recibe el resultado por webhook.
Ambientes
Cada ambiente tiene su propia clave de API. Una clave de staging no funciona en producción.
| Ambiente | URL base | Uso |
|---|---|---|
| Pruebas | https://staging-api.taxo.ws | Integración y desarrollo. Los datos no son definitivos. |
| Producción | https://api.taxo.ws | Datos reales del SRI. |
Una operación se arma combinando el verbo HTTP, la URL base y la ruta descrita en cada página. Por ejemplo, para registrar un contribuyente:
Autenticación
Todas las rutas del API exigen la cabecera x-api-key. No hay sesiones ni
tokens que expiren: cada llamada viaja con su credencial.
curl https://staging-api.taxo.ws/taxpayers \
-H "x-api-key: staging_evBmjgmR_XXXXXXXXXXXXXXX"
La clave de staging se distingue por su prefijo staging_. Trátala como un
secreto: guárdala en tu gestor de configuración y nunca la publiques en el
cliente.
Qué incluye esta sección
| Sección | Para qué sirve |
|---|---|
| Empecemos | Características del API y pasos de alta de la cuenta. |
| Contribuyentes | Registra y actualiza los RUC sobre los que vas a operar. |
| Extraer documentos | Compras, ventas y RIDE en XML, PDF y JSON. |
| Webhooks | Recibe el resultado de cada proceso asíncrono. |
| Consultas | Régimen fiscal, obligaciones, RUC público, buzón tributario y más. |