Insertar formulario

Para insertar un formulario en Persat, se debe enviar un POST como el que se especifica a continuación.

POST https://api.persat.com.ar/v1/digital-forms

Headers

Name

Type

Description

Authorization*

String

Bearer API_KEY

Content-Type*

String

application/json

Request Body

Name

Type

Description

uid_client*

String

Identificador del cliente

df_data.schema_id*

Number

Identificador de la plantilla del formulario

df_data.formvalues*

Object

Cada uno de los valores para cada wiidget del formulario

{
    "success": true,
    "data": {
        "_id": "552",
        "created": "2022-05-19T09:26:26.000Z",
        "created_by_user_name": "Creado por Api",
        "created_by_user_id": -1,
        "client": {
            "id": 12796,
            "name": "Logistica Hnos.",
            "uid_client": "AABC9098"
        },
        "df_data": {
            "schema_id": 150,
            "results": {
                "last_updated": "2022-05-19T09:26:26.000Z",
                "formvalues": {
                    "FWA3VCpeS": "Visitado por la mañana",
                    "FWWucoyGH": 321.11,
                }
            }
        },
        "state": {
            "color": "BLUE",
            "deleted": false,
            "id": 26,
            "name": "Listo"
        },
    }
}

{
    "success": false,
    "error": {
        "status": 400,
        "type": "BAD_REQUEST",
        "userMessage": "'uid_client' debe ser un string"
    }
}

Ejemplo de request

En este ejemplo insertamos un formulario de tipo 150 (schema_id) en el cliente "AABC9098". Este formulario es sencilllo ya que tiene un widget de CAMPO NUMERO y otro de CAMPO TEXTO. Ver seccion Tipos de Widgets para mas detalles.

body

{
    "uid_client": "AABC9098",
    "df_data": {
        "schema_id": 150, 
        "formvalues": {
            "FWA3VCpeS": "Visitado por la mañana",
            "FWWucoyGH": 321.11
        }
    }
}

Analizando la Respuesta

En caso que no haya ningun error, obtenemos una respuesta de este estilo. La explicación de cada uno de los campos se puede ver en la sección Obtener Formulario

Cuando se inserta un formulario se agrega el estado inicial.

{
    "success": true,
    "data": {
        "_id": "552",
        "created": "2022-05-19T09:26:26.000Z",
        "created_by_user_name": "Creado por Api",
        "created_by_user_id": -1,
        "client": {
            "id": 12796,
            "name": "Logistica Hnos.",
            "uid_client": "AABC9098"
        },
        "df_data": {
            "schema_id": 150,
            "results": {
                "last_updated": "2022-05-19T09:26:26.000Z",
                "formvalues": {
                    "FWA3VCpeS": "Visitado por la mañana",
                    "FWWucoyGH": 321.11
                }
            }
        },
        "state": {
             "color": "RED",
             "deleted": false,
             "id": 27,
             "name": "Cancelado"
        }
    }
}

Last updated 1 month ago

{ "success": true, "data": { "_id": "552", "created": "2022-05-19T09:26:26.000Z", "created_by_user_name": "Creado por Api", "created_by_user_id": -1, "client": { "id": 12796, "name": "Logistica Hnos.", "uid_client": "AABC9098" }, "df_data": { "schema_id": 150, "results": { "last_updated": "2022-05-19T09:26:26.000Z", "formvalues": { "FWA3VCpeS": "Visitado por la mañana", "FWWucoyGH": 321.11, } } }, "state": { "color": "BLUE", "deleted": false, "id": 26, "name": "Listo" }, } }

{ "uid_client": "AABC9098", "df_data": { "schema_id": 150, "formvalues": { "FWA3VCpeS": "Visitado por la mañana", "FWWucoyGH": 321.11 } } }

{ "success": true, "data": { "_id": "552", "created": "2022-05-19T09:26:26.000Z", "created_by_user_name": "Creado por Api", "created_by_user_id": -1, "client": { "id": 12796, "name": "Logistica Hnos.", "uid_client": "AABC9098" }, "df_data": { "schema_id": 150, "results": { "last_updated": "2022-05-19T09:26:26.000Z", "formvalues": { "FWA3VCpeS": "Visitado por la mañana", "FWWucoyGH": 321.11 } } }, "state": { "color": "RED", "deleted": false, "id": 27, "name": "Cancelado" } } }