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