Créer une entreprise

POST /businesses

Scope requis : platform:businesses. Base : https://api.getripa.com/api/platform/v1 (production) ou https://api-dev.getripa.com/api/platform/v1 (test).

Corps de la requête

Champ	Type	Obligatoire	Contraintes	Sens
`address`	objet	non		L’adresse, avec `street`, `city` et `province`.
`email`	texte	non	255 caractères au plus ; adresse e-mail	L’adresse e-mail de l’entreprise.
`external_id`	texte	oui	128 caractères au plus ; motif `^[A-Za-z0-9._:@-]+$`	Votre propre identifiant de l’entreprise, unique parmi vos entreprises. Pas d’espace ni de barre oblique : il doit tenir dans un chemin sous la forme `ext:<external_id>`.
`legal_name`	texte	oui	255 caractères au plus	Le nom légal de l’entreprise.
`nif`	texte	oui		Une lettre, sept chiffres, une lettre.
`phone`	texte	non		Le téléphone de l’entreprise.
`rccm`	texte	non	50 caractères au plus	Le RCCM.
`trade_name`	texte	non	255 caractères au plus	Le nom commercial.

L’objet address :

Champ	Type	Contraintes
`city`	texte	100 caractères au plus
`province`	texte	100 caractères au plus
`street`	texte	255 caractères au plus

Exemple

{
  "external_id": "plateforme-cust-001842",
  "legal_name": "Kasongo Distribution SARL",
  "nif": "A1234567B",
  "trade_name": "Kasongo Distribution",
  "rccm": "CD/KIN/RCCM/24-A-12345",
  "email": "compta@kasongo.example",
  "phone": "+243991234567",
  "address": { "street": "12 avenue du Commerce", "city": "Kinshasa", "province": "Kinshasa" }
}

Réponse

Réponse : 201 avec l’entreprise. Renvoyer le même external_id répond 200 avec la même entreprise et Idempotent-Replayed: true ; rien n’est créé deux fois. Le même external_id avec un autre NIF répond 409 EXTERNAL_ID_OTHER_NIF (une faute de frappe d’un côté ou de l’autre). L’en-tête Idempotency-Key est facultatif sur cette route.

{
  "object": "business",
  "data": {
    "id": "biz_2xJ4kQ9nVbT7mLpR3sYz",
    "external_id": "plateforme-cust-001842",
    "legal_name": "Kasongo Distribution SARL",
    "trade_name": "Kasongo Distribution",
    "nif": "A1234567B",
    "status": "active",
    "created_at": "2026-11-05T08:00:00Z",
    "points_of_sale_count": 0,
    "normalisation_ready": false
  },
  "meta": { "request_id": "req_01" }
}

status vaut active, paused (votre propre pause), suspended (suspendue par nous : ses factures acceptées attendent que nous la levions ; elle revient alors à active, ou à paused si vous l’aviez mise en pause), ended ou closed. normalisation_ready est vrai quand au moins un point de vente est actif et détient un jeton DGI capable de normaliser aujourd’hui.

Erreurs

409 NIF_ALREADY_REGISTERED et RCCM_ALREADY_REGISTERED : voir Un seul NIF dans tout Ripa.
409 EXTERNAL_ID_OTHER_NIF.
400 INVALID_NIF_FORMAT, VALIDATION_ERROR.

L’appel qui enregistre un NIF a sa propre limite de débit, volontairement petite (Limites de débit).