sellsy.

Dans Sellsy : Réglages → Portail développeur → API V2 → créer un accès. Choisis un accès de type personnel (« personal ») : c'est celui qui délivre un jeton directement à partir du couple identifiant/secret, sans passage par un navigateur.

Colle ensuite dans oto :

Coche les droits (scopes) correspondant à ce que l'agent devra faire : lecture seule pour consulter, écriture pour créer des tiers ou des documents. Un droit manquant se manifeste par un refus HTTP 403 au moment de l'appel, pas à la connexion.

byo uniquement : un compte Sellsy est celui d'une entreprise, il n'y a pas de clé partagée par oto. L'accès hérite des permissions du collaborateur auquel il est rattaché.

Sellsy tient les deux bouts : qui sont les clients, et ce qui leur est facturé.

Les identifiants (étape de pipeline, taxe, collaborateur, champ personnalisé) se lisent avec sellsy_ref — ne jamais les deviner.

Deux réflexes valent d'être connus avant de laisser l'agent écrire.

Essayer à blanc. op="create" accepte dry_run=true : Sellsy valide le corps et ne persiste rien. Utile avant une création en série, les champs obligatoires variant d'un compte à l'autre (numérotation, champs personnalisés).

Valider est irréversible. Un document créé est un brouillon ; op="validate" sur une facture ou un avoir fige son numéro et le rend comptable. À réserver à une décision humaine. Un devis, lui, change simplement d'état (op="status").

Les quotas Sellsy se comptent par seconde, minute, jour et mois, et chaque requête compte, même en erreur : préférer filters + fields à un all_pages large.