Esta operación se utiliza para insertar o actualizar un dato en una Base de Datos Maestra. El sistema primero intenta actualizar uno o más registros que cumplan con la condición de filtro especificada. Si no encuentra un registro con estas características, insertará un registro nuevo.
Endpoint (Método y URI)
POST https://api.blizwork.com/master-data/upsert/<token>
Llamado
{
"userId": "<Id. del usuario autorizado>",
"table": "<Tabla maestra>",
"filter": <Objeto con criterios de selección>,
"update": <Objeto con columnas actualizadas>
}
Parámetro | Explicación |
---|---|
<Id. del usuario autorizado> | Identificación (email) de un usuario autorizado a ejecutar esta consulta. Ejemplo: “usuario@organizacion.com”. |
<Tabla maestra> | El nombre de la tabla a actualizar. La tabla debe estar creada previamente. Ejemplo: “Productos”. |
<Objeto con criterios de selección> | La condición que deben cumplir los registros que se actualizarán. Debe cumplir con la sintaxis de selección de Mongo DB. Se puede incluir operadores lógicos como $and y $or. Si se ingresa un objeto vacío, se actualizarán todos los registros. Ejemplo: { “Código”: 127 } |
<Objeto con columnas actualizadas> | Es un objeto que indica todas las propiedades que se actualizarán. Si se actualiza un registro, las propiedades que no se incluyan no serán modificadas, en cambio, si se crea un nuevo registro, las propiedades que no se incluyan generarán columnas vacías. Ejemplo: { “descripcion”: “Este es un producto de prueba”, “unidad”: “Caja”, “ean”: “2903-0791”, “existencia”: 3 } |
Respuesta
{
"resultCode": 0,
"resultMessage": "<Mensaje>",
"payload": [
{
"updatedRecords": 1
}
]
}
Límites
Plan | Máximo de transacciones por segundo |
---|---|
Free | 0 |
Básico | 0,5 |
Medio | 1 |
Avanzado | 5 |
Empresa | 50 |
Corporativo | Máxima capacidad |