Saltar al contenido principal
Una extracción es el proceso que Syntage usa para recuperar o actualizar información desde una fuente de datos para una entidad. Las extracciones son la forma en que Syntage obtiene registros del SAT, facturas, declaraciones, inscripciones RPC, garantías RUG, reportes de Buró de Crédito, reportes BIL y otra información respaldada por fuentes de datos. Syntage no está conectado a todas las fuentes de datos en tiempo real. Los datos aparecen o se actualizan después de que una extracción se ejecuta y termina.

Cómo inician las extracciones

Las extracciones pueden iniciar de varias formas:
Cómo iniciaCuándo usarlo
Reglas de extracción inicialRecuperar automáticamente los datos estándar que tu organización necesita después de crear o hacer onboarding de una entidad
Actualización manualActualizar una entidad específica cuando tu equipo necesita información más reciente
Planificador recurrenteMantener entidades seleccionadas actualizadas en una periodicidad usando etiquetas
Solicitud de APIIniciar una extracción desde tu propia integración
Para configuración desde el dashboard, lee Planificadores de extracciones. Para ejemplos para desarrolladores, lee Ejemplos de solicitudes de extracción.

Estado de extracción

Una extracción pasa por estados mientras Syntage encola, ejecuta y termina el trabajo. En el dashboard, revisa el estado para entender si Syntage todavía está recuperando datos, esperando un requisito previo, terminó o no pudo completar la extracción. Waiting significa que Syntage todavía no puede ejecutar la extracción porque algo sigue bloqueándola, como información faltante de la entidad, autorización, una credencial no disponible o una dependencia interna. Si una extracción falla o queda pendiente más tiempo del esperado, revisa si la fuente de datos está disponible, si la credencial o autorización de la entidad sigue vigente y si la extracción llegó a un límite de la fuente de datos. Para los valores exactos de estado en la API, el comportamiento de facturación para extracciones detenidas o canceladas y los códigos de error de extracción, consulta la Guía de recursos de extracciones.

Extracciones, reportes y datos

Las extracciones recuperan información fuente. Después, Syntage usa esa información en:
  • Reportes, donde tu equipo revisa indicadores procesados, resúmenes, gráficas y análisis
  • Datos, donde tu equipo revisa registros fuente, datos estructurados sin procesar y archivos originales
  • Exportaciones, donde tu equipo descarga información que Syntage ya recuperó
Las exportaciones no crean extracciones nuevas. Empaquetan datos existentes de Syntage en archivos descargables.

Uso y facturación

Las extracciones pueden contar para el uso del plan. Una entidad procesada es un RFC que tiene al menos una extracción durante el mes actual, y los conteos de extracciones también pueden estar limitados por tu plan. Puedes revisar el uso en Plan y facturación y el historial de extracciones en Extracciones.

Referencia técnica

Los desarrolladores pueden crear y monitorear extracciones mediante la API. Usa la Guía de recursos de extracciones para el comportamiento del recurso y Crear una extracción para detalles del endpoint.