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 cuando quieras que Syntage entregue eventos a tu servidor automáticamente.

El acceso a los eventos solo está garantizado durante 7 días.

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

Cómo se usan los eventos

Suscríbete a webhooks cuando tu integración necesite reaccionar automáticamente a cambios en los recursos.
Almacena el ID del evento de cada solicitud webhook o respuesta de Events para que tu integración pueda deduplicar el procesamiento.
Usa type para enrutar el evento al manejador correcto.
Usa resource para recuperar la versión actual del recurso modificado cuando sea necesario.
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.

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`

Recursos principales

Fuentes de datos

Insights y flujos de trabajo

Otros recursos

Cómo se usan los eventos

Tipos de eventos

​Cómo se usan los eventos

​Tipos de eventos

Cómo se usan los eventos

Tipos de eventos