Agregar/Actualizar artículo
El siguiente endpoint se puede usar para agregar o actualizar un artículo dentro de la aplicación SensaInvoices.
Punto Final
La siguiente endpoint se puede utilizar para agregar o actualizar un elemento. Debes reemplazar el {base_url} y {site_id} variables con tu host asignado y el ID del sitio que se proporcionó cuando se creó el sitio.
POST
{base_url}/api/v4/site/{site_id}/item/addUpdate
La misma ruta de acceso se utiliza para agregar o actualizar an Artículo. Si el {_id} se proporciona, el Artículo se actualizará de lo contrario se insertará.
Solicitud
Campo
Tipo
Descripción
_id
String
El id del artículo. Este campo es generado por el sistema y no es necesario al crear un nuevo artículo, pero es necesario al actualizar un artículo existente.
externalId
String
El identificador único del artículo del sistema/base de datos fuente. Si detectamos un registro con el mismo externalId, se actualizará; de lo contrario, se agregará.
name
String
El nombre del artículo.
description
String
La descripción del artículo.
unitPrice
Number
El precio por unidad del artículo. Este es un número entero de centavos, por lo que 1035 significa $10.35.
deleted
Boolean
Esta bandera representa si el registro ha sido eliminado y ya no está disponible para ser utilizado.
Sample Request
{
"_id": "6839e415564d3cc2160d945e",
"name": "Men's Large T-Shirt",
"unitPrice": 1499,
"deleted": false
}
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
One of added, updated
_id
String
The auto generated id assigned to the record.
updatedAt
Date
The date the record was last updated.
errors
String [ ]
A list of errors. Will only be returned if success is false.
Sample Response (Successful)
{
"success": true,
"action": "added",
"_id": "60f720d248f143332af022e0",
"updatedAt": "2025-05-30T19:19:44.143Z"
}
Sample Response (Failed)
{
"success": false,
"errors": [
"invalid field2",
"missing field_name"
]
}