Skip to main content
Extractions are tasks that retrieve data for an entity from a datasource. They are used to collect invoices, tax returns, tax status, tax compliance checks, RPC records, RUG guarantees, Buró de Crédito reports, and other datasource-backed records. An extraction runs asynchronously. Creating one starts or queues the work, and the returned Extraction resource tracks its status, options, timing, errors, and the number of resources created or updated.

​
How Extractions Work

  1. Create or retrieve the entity you want to extract data for.
  2. Start the extraction with the selected datasource and options.
  3. Store the returned extraction ID.
  4. Retrieve the extraction until its status is finished or failed.
  5. Read the extracted data from the related resource endpoints, such as invoices or tax returns.
If an equivalent extraction is already pending or running for the same entity, extractor, and options, Syntage returns 409 Conflict instead of starting the same work again. The response includes conflictingExtractors, the list of extractors whose equivalent extraction is already in progress. Retrieve or wait for those extractions to finish, or remove the listed extractors from the request before retrying. For implementation details, see Extraction request examples or Create an extraction.

​
Scheduled Extractions

Use schedulers when the same extraction should run repeatedly, such as a daily invoice extraction or a monthly tax return extraction. A scheduler controls whether the automation is enabled, and scheduler rules define the extractor, options, and cron expression. Extractor names and options are specific to the data you are extracting. For extraction-backed resources, use the resource page to understand what data is collected and the developer examples for request bodies.

​
Extraction Status

​
Extraction Error Codes