1. Overview

What is OneConnect by Shine?

OneConnect by Shine is the API that enables Partners to automatically import invoices and accounting entries from their software into Cegid accounting production softwares (Cegid Loop, Quadra Expert, Cegid Expert).

As a partner, this documentation guides you through implementing these APIs in your software.

---

From Onboarding to Your First API Call

1. You contact us by filling out the form (contact.oneconnect@shine.co).
2. 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.
3. Once your integration is complete, we enable it for a limited number of accounting firms.
4. The accountant can invite their clients from their Cegid tool.
5. The client receives an invitation email with a link to the OneConnect by Shine integration setup page
6. The client gets an integration ID and integration secret which link your product to their organization (SIRET) in the accountant tool
7. They enter this information in your software.
8. You're all set!

---

What the API enables

Endpoint	Method	Description
Purchase invoice	POST /integrations/:integrationId/purchase-invoices	Upload a purchase invoice (PDF/image). Optionally include accounting entries in the entries field.
Sales invoice	POST /integrations/:integrationId/sales-invoices	Upload a sales invoice (PDF/image). Optionally include accounting entries in the entries field.
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 two import routes (purchase and sales). Entries are not a separate endpoint: include the optional entries JSON field in the same multipart request to send accounting entries alongside the invoice file.