Add/Update Product

Usa esto para mantener en Hyfin los productos y servicios que vendes, de modo que las líneas de orden de compra puedan hacer referencia a ellos.


The following endpoint can be used to add or update a product within the Hyfin application. The products are then added to lines on an invoice.


Punto Final

The following endpoint can be used to add or update a product. You must replace the {base_url} and {site_id} variable with the site id that was provided when the site was created.

POST
{base_url}/api/v3.1/site/{site_id}/product/addUpdate

Solicitud
Campo
Tipo
Descripción
external_id
String
Tu propio id para este producto, desde tu software. Envía de nuevo el mismo external_id para actualizar este producto en lugar de agregar uno nuevo. Usamos este valor para hacer la coincidencia, pero no evitamos duplicados, así que manténgalo único dentro del sitio.
name
String
El nombre del producto.
description
String
La descripción del producto.
unit_price
Number
El precio por unidad del producto. Format = 0.00
active
Boolean
Esta bandera representa si el registro del producto está activo y disponible para ser utilizado o no.
Default = true
Sample Request
			
{
  "external_id": "39772641",
  "name": "Men's Large T-Shirt",
  "unit_price": 14.99,
  "active": true
}


		
Respuesta
Campo
Tipo
Descripción
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.
id
String
The same id as _id, kept for backwards compatibility. Not returned on 4.0 and later.
errors
String [ ]
A list of errors. Will only be returned if success is false.
			
{
  "success": true,
  "action": "added",
  "_id": "60f720d248f143332af022e0",
  "id": "60f720d248f143332af022e0"
}


		

Ver también