Cómo funcionan las extracciones
- Crea o recupera la entidad de la que quieres extraer datos.
- Inicia la extracción con la fuente de datos y las opciones seleccionadas.
- Almacena el ID de extracción devuelto.
- Consulta la extracción hasta que su
statusseafinishedofailed. - Lee los datos extraídos desde los endpoints de recursos relacionados, como facturas o declaraciones fiscales.
Extracciones programadas
Usa los planificadores cuando la misma extracción deba ejecutarse repetidamente, como una extracción diaria de facturas o una extracción mensual de declaraciones fiscales. Un planificador controla si la automatización está habilitada, y las reglas del planificador definen el extractor, las opciones y la expresión cron. Los nombres y opciones de los extractores son específicos de los datos que estás extrayendo. Para recursos respaldados por extracciones, usa la página del recurso para entender qué datos se recopilan y los ejemplos para desarrolladores para los cuerpos de las solicitudes.Estado de la extracción
| Estado | Descripción |
|---|---|
| pending | El estado inicial de la extracción. La extracción está encolada y esperando ser procesada. |
| waiting | La extracción no cumple los requisitos para comenzar. |
| running | El proceso de extracción comenzó y actualmente está en ejecución. El tiempo de ejecución varía dependiendo del tipo de extractor y el volumen transaccional de la entidad. Pueden estar disponibles datos parciales desde los endpoints de recursos relacionados durante este tiempo. |
| finished | La extracción finalizó exitosamente. Los datos extraídos están disponibles desde los endpoints de recursos relacionados. |
| failed | La extracción no pudo iniciar o falló durante el proceso. Nuestras políticas internas de reintento no lograron finalizar la extracción exitosamente. Puede haber datos parciales disponibles, pero se deben crear nuevas extracciones para garantizar que todos los datos de la entidad estén disponibles. Puedes revisar el código de error de la extracción para entender por qué falló y determinar si puede reintentarse o no. |
| stopping | El usuario solicitó detener la extracción. Está en proceso de ser detenida. |
| stopped | La extracción fue detenida por el usuario después de iniciar su ejecución. Esta extracción se incluye en la facturación. |
| cancelled | La extracción fue detenida por el usuario antes de iniciar su ejecución. Esta extracción no se incluye en la facturación. |
Códigos de error de extracción
| Código | Descripción | Reintentable |
|---|---|---|
| invalid_credentials | La Credential del contribuyente ya no es válida. | No |
| login_failed | No pudimos autenticar al contribuyente con la fuente de datos. | Sí |
| unrecoverable | El proceso de extracción falló muchas veces y se alcanzó el número máximo de reintentos. | Sí |
| sat_unavailable | Detectamos que el SAT está caído o no responde. | Sí |
| internal_error | Detectamos un error interno en nuestra propia infraestructura. | Sí |
| undefined | No pudimos determinar la causa del error y nuestro equipo interno lo investigará. | Sí |