Changelog
Historial de versiones del contrato público. Los cambios incompatibles se anuncian con al
menos 90 días de anticipación y se publican en una nueva versión de ruta (/v2).
v1.0.0 · 31 de octubre de 2026
Servicios publicados
- Constancia de Situación Fiscal (
sat.constancia, asíncrono, 1 unidad). - Opinión de Cumplimiento SAT (32-D) (
sat.opinion, asíncrono, 1 unidad). - Estatus de Domicilio Fiscal (
sat.domicilio, asíncrono, 1 unidad). - Buzón IMSS (
imss.buzon, asíncrono, 2 unidades). - Opinión de Cumplimiento IMSS (
imss.opinion, asíncrono, 1 unidad). - Opinión de Cumplimiento Infonavit (
infonavit.opinion, asíncrono, 1 unidad). - Consulta Artículo 69-B (
sat.articulo69b, síncrono, 1 unidad). - Resolución de CAPTCHA (
captcha.resolve, síncrono, 1 unidad).
Plataforma
- Autenticación con API keys
ck_live_/ck_test_, scopes y rotación. - Empresas por cuenta con e.firma y credenciales IMSS/Infonavit cifradas (envelope, DEK por cuenta).
- Trabajos asíncronos con
202, polling,waithasta 25 s, cancelación y retención de 72 h. - Webhooks firmados con HMAC SHA-256 y reintentos con backoff (6 intentos, timeout 10 s).
- Errores
application/problem+jsonconcodeestable yrequest_id. - Medición por cuenta, empresa y servicio; consumo de IA (tokens y costo estimado) separado.
- Sandbox determinista con llaves
ck_test_. - OpenAPI 3.1 en
/openapi.yaml.
Notas de beta
- El acceso es sólo por invitación; el registro público está cerrado.
- Sin costo durante la beta. El consumo se mide en unidades; los precios de lista (Starter, Growth, Enterprise) están preparados pero no se cobran.
- Plan inicial: Invitación · Beta con 2,000 unidades al mes, 60 rpm + 10 de ráfaga y 5 empresas.
- El sandbox consume cuota: sus datos son simulados, pero las unidades se descuentan.
- La disponibilidad comprometida en beta es 99.5 % mensual, con mantenimientos programados avisados en Estado.
- Los eventos
job.succeededyjob.failedestán activos;job.canceled,quota.thresholdycredential.expiringestán declarados en el contrato y se habilitarán durante la beta.
Compatibilidad
- Los campos nuevos son aditivos: tu cliente debe ignorar campos desconocidos.
- Retiramos un campo o cambiamos su tipo sólo en una versión mayor de la ruta.
- Los códigos de error no se renombran; si un código cambia de significado, se publica uno nuevo.
- Los límites de plan pueden subir sin aviso; bajarlos se anuncia con 30 días.
Historial
| Versión | Fecha | Cambios |
|---|---|---|
v1.0.0 | 2026-10-31 | Primera versión pública: 8 servicios, empresas, llaves, trabajos y webhooks. |
Para reportar un problema de contrato (no de un caso particular) escribe a equipo@alchemycode.dev con el endpoint y la versión. Los casos operativos se atienden con el
request_id.