API REST per integrare MyCondominio con i tuoi software.

Quando usare le API di MyCondominio

Le API REST sono utili agli studi che vogliono integrare MyCondominio con altri software dello studio o agli sviluppatori che vogliono costruire integrazioni personalizzate. Casi d'uso tipici:

• Sincronizzazione anagrafiche con il CRM dello studio
• Esportazione contabile verso ERP (SAP, Zucchetti, TeamSystem)
• Reportistica BI con Power BI, Tableau, Qlik
• Workflow custom con Zapier, Make, n8n
• Mobile app aziendali con dati di MyCondominio
• Integrazione con commercialista (Profis, Sistemi)

Endpoint principali

Stabili

• GET /api/v1/stabili — Lista stabili dello studio
• GET /api/v1/stabili/{id} — Dettaglio singolo stabile
• POST /api/v1/stabili — Crea nuovo stabile
• PATCH /api/v1/stabili/{id} — Aggiorna stabile
• DELETE /api/v1/stabili/{id} — Cancella stabile

Condomini

• GET /api/v1/condomini?stabile={id} — Condomini di uno stabile
• POST /api/v1/condomini — Crea condomino
• GET /api/v1/condomini/{id}/situazione — Situazione contabile condomino

Movimenti contabili

• GET /api/v1/movimenti?stabile={id}&dal=2026-01-01 — Prima nota filtrata
• POST /api/v1/movimenti — Inserisci movimento
• POST /api/v1/movimenti/import — Import batch CSV

Fatture

• GET /api/v1/fatture/ricevute — Fatture ricevute via SDI
• GET /api/v1/fatture/{id} — Dettaglio fattura
• POST /api/v1/fatture/{id}/imputa — Imputa a un ordine lavoro

Lavori

• GET /api/v1/lavori?stato=aperto — Lavori aperti
• POST /api/v1/lavori — Apri nuovo lavoro
• POST /api/v1/lavori/{id}/gara — Lancia gara preventivi

Documenti

• GET /api/v1/documenti?stabile={id}&categoria=verbali — Lista documenti
• POST /api/v1/documenti — Upload nuovo documento
• GET /api/v1/documenti/{id}/download — Download PDF

Webhook

Sottoscrivi webhook real-time per ricevere notifiche su eventi del sistema. Il webhook viene chiamato in HTTP POST con payload JSON firmato HMAC-SHA256. Eventi disponibili:

• condomino.creato
• condomino.aggiornato
• movimento.registrato
• fattura.ricevuta
• fattura.pagata
• lavoro.aperto
• lavoro.completato
• assemblea.convocata
• assemblea.conclusa
• verbale.pubblicato
• scadenza.fiscale.imminente

Autenticazione

Due metodi di autenticazione:

• API Key: header X-API-Key: {chiave}. Generata dal pannello impostazioni studio. Scope configurabile (read-only, read-write).
• OAuth 2.0: flow standard authorization code per applicazioni multi-tenant. Endpoint /oauth/authorize e /oauth/token.

Rate limiting

Le API hanno rate limit basati sul piano:

• Starter: 60 req/min
• Pro: 300 req/min
• Studio: 1.500 req/min

Header di risposta X-RateLimit-Limit e X-RateLimit-Remaining per monitorare l'uso.

Documentazione interattiva

La documentazione completa OpenAPI 3.0 con esempi e console interattiva è disponibile su api.mycondominio.net/docs. Include esempi in Python, JavaScript, PHP, cURL.

SDK ufficiali

SDK ufficiali in sviluppo (rilascio Q3 2026):

• SDK PHP (per integrazione con commercialista usando Sistemi/Profis)
• SDK Python (per data science e BI)
• SDK Node.js (per integrazioni serverless)

Supporto sviluppatori

Email dedicata: developers@mycondominio.net. Rispondiamo entro 24h con esempi di codice. Per integrazioni enterprise (piano Studio) è disponibile un developer advocate dedicato.