> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syntage.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Eventos

Los eventos registran cambios significativos en los recursos de tu organización.

Cuando algo cambia, Syntage crea un recurso Event. Por ejemplo, enviar la credencial del SAT de una entidad puede crear eventos de credencial y de entidad, y una extracción completada puede crear un evento `extraction.updated`.

Muchas solicitudes pueden crear más de un evento. Por ejemplo, enviar credenciales válidas del SAT para una entidad puede crear eventos `credential.created`, `credential.updated` y `link.created`.

Los eventos ocurren cuando el estado de otro recurso cambia. El estado de ese recurso al momento del cambio se incluye en el campo `data` del evento. Por ejemplo, un evento `credential.updated` contiene una Credential, y un evento `invoice.updated` contiene un Invoice.

Usa los endpoints de Events para recuperar eventos recientes directamente. Usa [webhooks](/es/resources/webhooks) cuando quieras que Syntage entregue eventos a tu servidor automáticamente.

<Note>El acceso a los eventos solo está garantizado durante 7 días.</Note>

<Info>
  Los eventos del ciclo de vida de las entidades aún usan los nombres de tipo `link.*` por compatibilidad.
</Info>

## Cómo se usan los eventos

1. Suscríbete a [webhooks](/es/resources/webhooks) cuando tu integración necesite reaccionar automáticamente a cambios en los recursos.
2. Almacena el ID del evento de cada solicitud webhook o respuesta de Events para que tu integración pueda deduplicar el procesamiento.
3. Usa `type` para enrutar el evento al manejador correcto.
4. Usa `resource` para recuperar la versión actual del recurso modificado cuando sea necesario.
5. Usa `data.object` cuando necesites el estado del recurso capturado al momento en que se creó el evento.

Los endpoints de Events son útiles para backfills, depuración y conciliación. Los webhooks son la mejor opción para la entrega continua.

Para detalles de implementación, consulta [Ejemplos de eventos](/es/developers/event-examples).

## Tipos de eventos

El sufijo describe el tipo de cambio:

| Sufijo     | Significado                                       |
| ---------- | ------------------------------------------------- |
| `.created` | Se creó un nuevo recurso.                         |
| `.updated` | Un recurso existente cambió.                      |
| `.deleted` | Un recurso fue eliminado o ya no está disponible. |

| Recurso                              | Tipos de evento                                                                                |
| ------------------------------------ | ---------------------------------------------------------------------------------------------- |
| 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`                                 |
| Fuentes de relación de accionista    | `shareholder_relation_source.created`                                                          |
| Garantías del RUG                    | `rug_garantia.created`, `rug_garantia.updated`                                                 |
| Reportes de Buró de Crédito          | `buro_de_credito_report.created`, `buro_de_credito_report.updated`                             |
| Verificación de Antecedentes         | `background_check.created`                                                                     |
| Certificados del SAT                 | `sat_certificate.created`, `sat_certificate.updated`                                           |
| Reportes de Verificación de Sociedad | `company_verification_report.created`, `company_verification_report.updated`                   |