1. Overview
What is OneConnect by Shine?
OneConnect by Shine is the API that enables Partners to automatically import invoices and accounting entries — either attached to an invoice, or as a standalone batch of accounting entries of any type — from their software into Cegid accounting production softwares (Cegid Loop, Quadra Expert, Cegid Expert, Conciliator).
As a partner, this documentation guides you through implementing these APIs in your software.
From Onboarding to Your First API Call
- You contact us by filling out the form (contact.oneconnect@shine.co).
- Our team reaches out to discuss your integration. You provide your logo, a description, and a webhook URL (see section WebHooks); in return, we give you your credentials.
- Once your integration is complete, we enable it for a limited number of accounting firms.
- The accountant can invite their clients from their Cegid tool.
- The client receives an invitation email with a link to the OneConnect by Shine integration setup page
- The client gets an integration ID and integration secret which link your product to their organization (SIRET) in the accountant tool
- They enter this information in your software.
- You're all set!
What the API enables
| Endpoint | Method | Content-Type | Description |
|---|---|---|---|
| Purchase invoice | POST /integrations/:integrationId/purchase-invoices | multipart/form-data | Upload a purchase invoice (PDF/image). Optionally include accounting entries in the entries field. |
| Sales invoice | POST /integrations/:integrationId/sales-invoices | multipart/form-data | Upload a sales invoice (PDF/image). Optionally include accounting entries in the entries field. |
| Accounting entries | POST /integrations/:integrationId/entries | application/json | Import a batch of accounting entries as JSON only (no file). Can represent any type of entry (purchase, sales, bank, payroll, miscellaneous operations, etc.). |
| Integration status | GET /integrations/:integrationId | — | Check whether the integration is active or revoked. |
| Revocation | PUT /integrations/:integrationId/revoke | — | Revoke an integration. This allows the user to deactivate the integration from your product. |
There are three import routes: two file-based invoice routes (purchase and sales), and one JSON-only entries route. You can send accounting entries in two ways: (a) attached to an invoice, via the optional entries field of an invoice route, or (b) on their own, via the entries route — for any type of entry, with no file required.