extraction.updated event.
Many requests can create more than one event. For example, submitting valid SAT credentials for an entity can create credential.created, credential.updated, and link.created events.
Events occur when the state of another resource changes. The state of that resource at the time of the change is embedded in the event’s data field. For example, a credential.updated event contains a Credential, and an invoice.updated event contains an Invoice.
Use the Events endpoints to retrieve recent events directly. Use webhooks when you want Syntage to deliver events to your server automatically.
Access to events is only guaranteed for 7 days.
Entity lifecycle events still use the
link.* event type names for backwards compatibility.How Events Are Used
- Subscribe to webhooks when your integration needs to react automatically to resource changes.
- Store the event ID from each webhook request or Events response so your integration can deduplicate processing.
- Use
typeto route the event to the correct handler. - Use
resourceto retrieve the current version of the changed resource when needed. - Use
data.objectwhen you need the resource state captured at the time the event was created.
Event Types
The suffix describes the kind of change:| Suffix | Meaning |
|---|---|
.created | A new resource was created. |
.updated | An existing resource changed. |
.deleted | A resource was deleted or is no longer available. |
| Resource | Event types |
|---|---|
| Credentials | credential.created, credential.updated, credential.deleted |
| Entities | link.created, link.updated, link.deleted |
| Files | file.created |
| Extractions | extraction.created, extraction.updated |
| Exports | export.created, export.updated |
| Invoices | invoice.created, invoice.updated, invoice.deleted |
| Invoice payments | invoice_payment.created, invoice_payment.updated |
| Invoice line items | invoice_line_item.created, invoice_line_item.updated |
| Tax returns | tax_return.created, tax_return.updated, tax_return.deleted |
| Tax status | tax_status.created, tax_status.updated, tax_status.deleted |
| Tax compliance checks | tax_compliance_check.created, tax_compliance_check.updated, tax_compliance_check.deleted |
| Tax retentions | tax_retention.created, tax_retention.updated, tax_retention.deleted |
| Electronic accounting records | electronic_accounting_record.created, electronic_accounting_record.updated |
| RPC entidades | rpc_entidades.created, rpc_entidades.updated |
| RPC socios | rpc_socios.created, rpc_socios.updated |
| RPC actos | rpc_acto.created, rpc_acto.updated |
| Shareholder relations | shareholder_relation.created, shareholder_relation.updated |
| Shareholder relation sources | shareholder_relation_source.created |
| RUG garantias | rug_garantia.created, rug_garantia.updated |
| Buró de Crédito reports | buro_de_credito_report.created, buro_de_credito_report.updated |
| Background checks | background_check.created |
| SAT certificates | sat_certificate.created, sat_certificate.updated |
| Company verification reports | company_verification_report.created, company_verification_report.updated |