Fournisseurs

Liste

GET /firms/{FIRM_ID}/suppliers.xml

liste des fournisseurs, par groupe de 30 résultats

Paramètres optionnels : page

Réponse

<?xml version="1.0" encoding="UTF-8"?>
<suppliers type="array">
  <pagination>
    <current_page>1</current_page>
    <total_pages>1</total_pages>
  </pagination>
  <supplier>
    <id>11</id>
    <name>dedibox</name>
  </supplier>
  <supplier>
    <id>24</id>
    <name>INPI</name>
  </supplier>
  <supplier>
    <id>145</id>
    <name>URSSAF</name>
  </supplier>
</suppliers>

Détail

GET /firms/{FIRM_ID}/supplier/{ID}.xml

Affiche le détail du fournisseur n° ID

Réponse

<?xml version="1.0" encoding="UTF-8"?>
<supplier>
  <id>11</id>
  <name>dedibox</name>
</supplier>

Créer un fournisseur

POST /firms/{FIRM_ID}/suppliers.xml

Création d’un nouveau fournisseur. On obtient en retour le code XML du fournisseur créé, avec l’ID qui lui a été attribué

Requête

<?xml version="1.0" encoding="UTF-8"?>
<supplier>
  <name>Google</api_id>
</supplier>

Réponse

Status: 201 Created
Location: /firms/{FIRM_ID}/suppliers/#{new-supplier-id}.xml

<supplier>
  ...
</supplier>

Modifier un fournisseur

PUT /firms/{FIRM_ID}/supplier/#{ID}.xml

Mise à jour d’un fournisseur.

Requête

<supplier>
  <id>11</id>
  <name>nouveau nom</name>
</supplier>

Réponse

Status: 200 OK

Supprimer un fournisseur

DELETE /firms/{FIRM_ID}/suppliers/#{ID}.xml

Supprime le fournisseur identifié par son ID, ainsi que tous les achats associés à ce fournisseur.

Remarque: Certains fournisseurs sont gérés automatiquement par l’application (RSI, URSSAF, MuWeb, …) et ne peuvent pas être supprimé dès lors que des achats ont été enregistrés pour ce fournisseur. Si vous avez supprimé un tel fournisseur, il sera automatiquement recréé par le système lorsque c’est nécessaire.

Réponse

Status: 200 OK

Liste des champs

Champs Libellé Type
city Ville string
civility Civilité integer
company_name Société string
country Pays string
email Email string
fax Fax string
first_name Prénom string
id Identifiant integer
last_name Nom string
mobile Mobile string
notes Autres informations text
phone Téléphone string
short_name Nom mnémotechnique string
siret Siret string
street Adresse text
vat_number N° TVA string
website Site web string
zip_code Code postal string