Ajouter/Mettre à jour l'article

Utilisez ceci pour conserver dans Hyfin les produits et services que vous vendez, afin que les lignes de Facture puissent s'y référer.


Le point de terminaison suivant peut être utilisé pour ajouter ou mettre à jour un article dans l'application Hyfin.


Point de terminaison

Le point d'extrémité suivant peut être utilisé pour ajouter ou mettre à jour un élément. Vous devez remplacer le {base_url} et {site_id} variables par votre hôte attribué et l'identifiant du site fourni lors de la création du site.

POST
{base_url}/api/v4/site/{site_id}/item/addUpdate
Demande
Champ
Type
Description
_id
String
L'identifiant que nous attribuons à cet article. Omettez-le lors de la création d'un article et envoyez-le lors de la mise à jour d'un article.
externalId
String
Votre propre identifiant pour cet article, provenant de votre logiciel. Envoyez à nouveau le même externalId pour mettre à jour cet article au lieu d'en ajouter un nouveau. Nous faisons la correspondance sur cette valeur, mais nous n'empêchons pas les doublons; gardez-la donc unique au sein du site.
name
String
Le nom de l'article.
description
String
La description de l'article.
unitPrice
Number
Le prix par unité de l'article. Il s'agit d'un nombre entier de cents, donc 1035 signifie $10.35.
deleted
Boolean
Ce drapeau représente si l'enregistrement est supprimé et n'est plus disponible pour être utilisé.
			
{
  "name": "Men's Large T-Shirt",
  "unitPrice": 1499,
  "deleted": false
}


		
Réponse
Champ
Type
Description
success
Boolean
Whether the record was added or updated successfully.
action
String
Informs whether the record was added or updated. Will only be returned if success is true.
One of added, updated
_id
String
The id we assign to the record.
updatedAt
The date the record was last updated. Un moment précis en format ISO 8601, avec un fuseau horaire. Format = YYYY-MM-DDTHH:mm:ss.SSSZ
errors
String [ ]
A list of errors. Will only be returned if success is false.
			
{
  "success": true,
  "action": "added",
  "_id": "60f720d248f143332af022e0",
  "updatedAt": "2025-05-30T19:19:44.143Z"
}


		

Voir aussi