Lien Rechercher Menu Deplier Document

Liste des fournisseurs

GET /firms/FIRM_ID/suppliers.json

liste des fournisseurs, par groupe de 30 résultats.

Paramètres optionnels

  • page : numéro de page
  • api_id : recherche exacte sur le champ api_id
  • api_custom : recherche partielle sur le champ api_custom
  • company : recherche partielle sur le nom de société
  • category_id: recherche sur l’ID d’une catégorie spécifique (utiliser l’ID 0 pour retrouver les fournisseurs sans catégorie)
  • with_sepa: par défaut, les données SEPA ne sont pas exportées. Seule la clé API de l’administrateur de la société permet d’exporter les données SEPA, et vous devez explicitement demander ces informations en utilisant la valeur 1.
  • country : recherche sur le code pays
  • account_code : recherche sur une partie du code du compte fournisseur (abonnement Entreprise)
  • accounting_entry : recherche sur le code d’imputation par défaut (abonnement Entreprise)

Tri

Par défaut, les fournisseurs sont triés par ordre croissant de nom mnémotechnique. Vous pouvez trier les résultats selon différentes méthodes en utilisant les paramètres suivants

  • sort :
    • asc: tri croissant
    • desc: tri décroissant
  • order : type de tri
    • created: tri par date de création
    • updated: tri par date de dernière modification

Requête

curl -i -S -u Identifiant:CleApi -H 'User-Agent: MonApp (patrick@camping.test)' \
 "https://www.facturation.pro/firms/FIRM_ID/suppliers.json"

Réponse

[
  {
  "account_code": "401AMAZON",
  "category_id": 4855,
  "city": "",
  "civility": null,
  "company_name": "amazon",
  "country": null,
  "email": null,
  "fax": "",
  "first_name": "",
  "id": 49091,
  "last_name": "",
  "mobile": "",
  "notes": "",
  "phone": "",
  "short_name": "amazon",
  "siret": null,
  "street": "",
  "vat_number": null,
  "website": null,
  "zip_code": ""
  }, {
  "account_code": "401APPLE",
  "category_id": 4857,
  "city": "",
  "civility": null,
  "company_name": "apple",
  "country": null,
  "email": null,
  "fax": "",
  "first_name": "",
  "id": 49090,
  "last_name": "",
  "mobile": "",
  "notes": "",
  "phone": "",
  "short_name": "apple",
  "siret": null,
  "street": "",
  "vat_number": null,
  "website": null,
  "zip_code": ""
  }
]

(c) Facturation.PRO • API et webservices de facturation en ligne et de gestion commerciale pour auto-entreprise, TPE et PME.