API Fournisseurs
Endpoints de gestion des fournisseurs.
Les fournisseurs sont des relations CompanyRelation avec to_model: "Supplier".
Voir Collection company_relations (fournisseurs) pour le schéma complet.
Tous les endpoints requièrent une authentification (authMiddleware).
GET /api/suppliers/search
Recherche des sociétés fournisseurs disponibles (sociétés de type platform) par nom ou numéro SIREN.
GET /api/suppliers
POST /api/suppliers
Crée une nouvelle relation fournisseur. Permet de lier un fournisseur existant ou d’en créer un nouveau simultanément.
Corps de la requête
{
fromCompanyId: ObjectId; // tenant courant
// Soit un fournisseur existant…
supplierCompanyId?: ObjectId;
// …soit un nouveau fournisseur à créer
newCompany?: {
name: string; // transformé en MAJUSCULES (min. 2 caractères)
company_registration_number: string;
};
client_number: string; // référence client chez ce fournisseur
// Champs optionnels de la relation
tier?: ObjectId;
is_favorite?: boolean;
ranking_number?: number;
allow_rebate?: boolean;
apply_tva?: boolean;
allow_order?: boolean;
credit_limit?: number;
payment_method?: string;
payment_terms_days?: number;
minimum_order?: number;
// … autres champs de CompanyRelation
}
supplierCompanyId et newCompany sont mutuellement exclusifs. L’un des deux est obligatoire.
|