Saltar al contenido principal
Las extracciones son tareas que recuperan datos de una entidad desde una fuente de datos. Se utilizan para recopilar facturas, declaraciones fiscales, situación fiscal, opiniones de cumplimiento, registros del RPC, garantías del RUG, reportes de Buró de Crédito y otros registros respaldados por fuentes de datos. Una extracción se ejecuta de forma asíncrona. Crear una inicia o encola el trabajo, y el recurso Extraction devuelto rastrea su estado, opciones, tiempos, errores y la cantidad de recursos creados o actualizados.

Cómo funcionan las extracciones

  1. Crea o recupera la entidad de la que quieres extraer datos.
  2. Inicia la extracción con la fuente de datos y las opciones seleccionadas.
  3. Almacena el ID de extracción devuelto.
  4. Consulta la extracción hasta que su status sea finished o failed.
  5. Lee los datos extraídos desde los endpoints de recursos relacionados, como facturas o declaraciones fiscales.
Si una extracción equivalente ya está pending o running para la misma entidad, extractor y opciones, Syntage devuelve 409 Conflict en lugar de iniciar el mismo trabajo nuevamente. La respuesta incluye conflictingExtractors, la lista de extractores cuya extracción equivalente ya está en curso. Consulta o espera a que esas extracciones terminen, o quita los extractores indicados de la solicitud antes de reintentar. Para detalles de implementación, consulta los Ejemplos de solicitudes de extracción o Crear una extracción.

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

Códigos de error de extracción

Los siguientes códigos ya no se asignan a extracciones nuevas, pero aún pueden aparecer en extracciones anteriores:

Reintentar extracciones fallidas

Una credencial inválida no hace que una extracción nueva falle. La extracción permanece en waiting hasta que la credencial vuelve a ser válida y luego se reanuda automáticamente. Actualiza la credencial en lugar de crear una extracción nueva. Las extracciones fallidas no se reanudan, incluidas las anteriores con invalid_credentials: actualiza la credencial y luego crea una extracción nueva. Antes de reintentar manualmente una extracción fallida:
  1. Consulta Syntage Status para identificar un incidente que afecte la fuente de datos o el servicio correspondiente. Si hay un incidente activo, sigue las indicaciones publicadas y evita crear extracciones manuales adicionales mientras Syntage gestiona los reintentos o el reprocesamiento. Según el incidente, los reintentos automáticos pueden continuar.
  2. Cuando el incidente se resuelva, revisa su última actualización antes de reintentar manualmente, ya que las extracciones afectadas podrían estar siendo reprocesadas. No todos los incidentes incluyen reprocesamiento automático.
  3. Si el problema persiste después de los pasos de recuperación indicados, contacta a soporte e incluye el ID de la extracción.