Sviluppatori
Collegate il vostro strumento alla preparazione Cortex.
Capite il percorso dell’API Cortex, l’autenticazione per chiave, i diritti necessari e il seguito dei trattamenti prima dell’export.
GET /api/v1/user/credits HTTP/1.1
Host: cortex-compta.ch
Authorization: Bearer LA_VOSTRA_CHIAVE_APIAutenticare ogni richiesta
L’API usa una chiave nell’header Authorization: Bearer. Le chiavi si gestiscono dopo l’accesso. Conservatele sul server e attribuite solo i diritti necessari.
Una 401 indica un’autenticazione assente o non valida. Una 403 indica che la chiave o il dossier non ha i diritti necessari. Un limite può produrre una 429.
Depositare, seguire, poi recuperare
Il deposito avvia un trattamento. Recuperate il suo stato prima di usare le informazioni preparate. Un trattamento terminato non vale come validazione contabile.
La generazione dell’export è seguita dal suo identificatore. Scaricate il file solo quando è disponibile. I diritti e i controlli del dossier restano applicabili.
- POST /api/v1/documents/upload — depositare un documento.
- GET /api/v1/documents/:id — consultare un documento.
- GET /api/v1/treatments/:id — seguire un trattamento.
- POST /api/v1/exports/generate — chiedere un export.
- GET /api/v1/exports/:id — seguirne la preparazione.
- GET /api/v1/exports/:id/download — recuperare il file disponibile.
Formati realmente esposti
GET /api/v1/formats elenca oggi cresus, winbiz, sage, abacus, banana, wineur ed excel. DATEV e ZIP esistono come export file dopo validazione umana, fuori da questa lista API.
- cresus
- winbiz
- sage
- abacus
- banana
- wineur
- excel
Testare con un dossier controllato
Iniziate con documenti di test senza dati riservati. Trattate esplicitamente errori, tempi di elaborazione e riprese per evitare depositi doppi.
La documentazione dettagliata e lo schema dei parametri sono accessibili dopo l’accesso. Verificate formati e diritti della vostra offerta prima di integrare il percorso.