Saltar al contenido principal
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

  1. Suscríbete a 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.

​
Tipos de eventos

El sufijo describe el tipo de cambio:
SufijoSignificado
.createdSe creó un nuevo recurso.
.updatedUn recurso existente cambió.
.deletedUn recurso fue eliminado o ya no está disponible.
RecursoTipos de evento
Credentialscredential.created, credential.updated, credential.deleted
Entitieslink.created, link.updated, link.deleted
Filesfile.created
Extractionsextraction.created, extraction.updated
Exportsexport.created, export.updated
Invoicesinvoice.created, invoice.updated, invoice.deleted
Invoice paymentsinvoice_payment.created, invoice_payment.updated
Invoice line itemsinvoice_line_item.created, invoice_line_item.updated
Tax returnstax_return.created, tax_return.updated, tax_return.deleted
Tax statustax_status.created, tax_status.updated, tax_status.deleted
Tax compliance checkstax_compliance_check.created, tax_compliance_check.updated, tax_compliance_check.deleted
Tax retentionstax_retention.created, tax_retention.updated, tax_retention.deleted
Electronic accounting recordselectronic_accounting_record.created, electronic_accounting_record.updated
RPC entidadesrpc_entidades.created, rpc_entidades.updated
RPC sociosrpc_socios.created, rpc_socios.updated
RPC actosrpc_acto.created, rpc_acto.updated
Shareholder relationsshareholder_relation.created, shareholder_relation.updated
Fuentes de relación de accionistashareholder_relation_source.created
Garantías del RUGrug_garantia.created, rug_garantia.updated
Reportes de Buró de Créditoburo_de_credito_report.created, buro_de_credito_report.updated
Verificación de Antecedentesbackground_check.created
Certificados del SATsat_certificate.created, sat_certificate.updated
Reportes de Verificación de Sociedadcompany_verification_report.created, company_verification_report.updated