Effectivement, en rédigeant la documentation, j’ai pu clarifier l’ensemble des éléments nécessaires — et je m’excuse si mes réponses précédentes ont pu prêter à confusion.
Voici un récapitulatif complet de la procédure à suivre pour créer un fournisseur via notre API, avec toutes les informations utiles.
Endpoint : Créer un fournisseur
POST /provider
Description
Cet endpoint permet de créer un nouveau fournisseur pour la société courante. Il enregistre ses informations principales ainsi que ses éventuels contacts, et génère automatiquement un compte comptable associé.
Corps de la requête (payload)
interface CreateProviderPayload {
additionalAddress?: string;
address?: string;
city?: string;
commercialName?: string;
contacts?: Contact[];
country?: string;
keywords?: string;
language?: string;
nafCode?: string;
name?: string;
notes?: string;
phone?: string;
siren?: string;
siret?: string;
vatNumber?: string;
website?: string;
zipCode?: string;
}
interface Contact {
firstname: string;
lastname: string;
email?: string;
phone?: string;
}
Note importante : Bien que le champ contacts permette d’envoyer une liste, la gestion de plusieurs contacts par fournisseur n’est pas encore active dans l’application. Cette structure a été pensée pour anticiper de futures évolutions, et la fonctionnalité sera disponible dans une version à venir.
Exemple de requête
POST /provider
Content-Type: application/json
{
"name": "Société ABC",
"commercialName": "ABC Fournitures",
"address": "12 rue des Fleurs",
"zipCode": "75001",
"city": "Paris",
"country": "France",
"contacts": [
{
"firstname": "Jean",
"lastname": "Dupont",
"email": "jean.dupont@abc.com",
"phone": "0601020304"
}
],
"siret": "12345678900012",
"vatNumber": "FR123456789"
}
Réponse de l’API
interface ProviderResponse {
id: string;
name: string;
commercialName?: string;
address?: string;
zipCode?: string;
city?: string;
country?: string;
contacts?: Contact[];
siret?: string;
vatNumber?: string;
// autres champs retournés
}
Exemple de réponse
{
"id": "provider-uuid-123",
"name": "Société ABC",
"commercialName": "ABC Fournitures",
"address": "12 rue des Fleurs",
"zipCode": "75001",
"city": "Paris",
"country": "France",
"contacts": [
{
"firstname": "Jean",
"lastname": "Dupont",
"email": "jean.dupont@abc.com",
"phone": "0601020304"
}
],
"siret": "12345678900012",
"vatNumber": "FR123456789"
}
Fonctionnement interne
- L’API complète automatiquement les données avec l’identifiant de la société courante et le type
PROVIDER.
- Un compte comptable est généré automatiquement pour ce fournisseur.
- Le fournisseur et ses contacts (s’ils sont précisés) sont enregistrés en base de données.
N’hésitez pas à revenir vers moi si vous avez d’autres questions ou besoins d’éclaircissements !
Oui
Non