Insertar elemento

Para insertar un elemento en una Master Db en Persat, se debe enviar un POST como el que se especifica a continuación.

POST https://api.persat.com.ar/v1/masterdbvalues

Headers

Name	Type	Description
Authorization*	String	Bearer API_KEY
Content-Type*	String	application/json

Request Body

Name	Type	Description
mdb_id*	Number	Identificador de la Master Db. Por ejemplo Productos
fields*	Object	JSON Object con los campos del elemento a insertar.

200: OK La consulta se ejecutó con éxito

{
    "success": true,
    "data": {
        "mdb_id": 4,
        "fields": {
            "1": "DEST-123AALK",
            "2": "Destornillador perillero",
            "5": "Rojo"
            "6": ""
        },
        "updated": "2022-05-20T13:43:46.000Z"
    }
}

404: Not Found La master db especificada no existe

{
    "success": false,
    "error": {
        "status": 404,
        "type": "NOT_FOUND",
        "userMessage": "No existe el mdb_id: 23213123123"
    }
}

400: Bad Request Error en alguno de los campos enviados. userMessage contiene informacipon adicional.

{
    "success": false,
    "error": {
        "status": 400,
        "type": "BAD_REQUEST",
        "userMessage": "'field.1' es un campo string obligatorio que identifica el master db obj value"
    }
}

409: Conflict Conflicto. Ya existe otro elemento con este field.1

{
    "success": false,
    "error": {
        "status": 409,
        "type": "CONFLICT",
        "userMessage": "Ya existe un master db value con este field.1"
    }
}

Ejemplo de request

En este ejemplo insertamos un elemento en la Master db de Productos (mdb_id: 4). El fields.1 es obligatorio y debe ser único, ya que pasa a ser el identificador del elemento insertado.

body

{
    "mdb_id": 4,
    "fields": {
        "1": "DEST-123AALK",
        "2": "Destornillador perillero",
        "5": "Rojo"
    }
}

Los valores a insertar son siempre strings, mas alla de que en la definición de la Master db sean de tipo Número, email, link, etc.

Por el momento, no se realizan validaciones durante la inserción o modificación de estos campos

Analizando la Respuesta

En caso que no haya ningun error, obtenemos

{
    "success": true,
    "data": {
        "mdb_id": 4,
        "fields": {
            "1": "DEST-123AALK",
            "2": "Destornillador perillero",
            "5": "Rojo"
            "6": ""
        },
        "updated": "2022-05-20T13:43:46.000Z"
    }
}

La respuesta contiene al elemento insertado como se puede ver en Obtener elemento

Nótese que la Master Db tiene definido un field "6", que no enviamos durante la inserción, pero si lo recibimos en la respuesta como vacío ""

El único campo de los fields obligatorio es el fields.1 ya que es el identificador unico del elemento en la db