Insert CRM user

It's possible to insert CRM users.

To do so, JSON body composed as follows must be passed to the insertCRMUsers_v3 web service.

subject section

users section

Field	Description	Type	Mandatory
subjectCode	Code of the customer in the external system	Varchar(250)	✓
subjectName	Name of the subject	Varchar(250)
subjectSurname	Surname of the subject	Varchar(250)
subjectDenomination	It contains the denomination of the subject that is the concatenation of name and surname for the persons or the company name for the companies	Varchar(250)	✓
address1	Address of the subject	Varchar(100)
address2	Extension of the address	Varchar(100)

Field	Type	Description	Mandatory
userCodeId	Varchar(250)	User code associated to seller	✓
password	Varchar(250)	Password of user code	✓
description	Varchar(250)	Description of the user	✓ (in insert)

userParameters section

That section specify user params.

Field	Type	Description	Mandatory
codeId	Varchar(250)	Code of param	✓
value	Varchar(100)	Value of param	✓
description	Varchar(250)	Description of the param	✓

userEntities section

Note that the section is not mandatory, and can be an empty array. In case it is valued, it must be an array of objects composed as follows. This section defines entities associated to the user.

Field	Type	Description	Mandatory
entityCode	Varchar(250)	Shop/store code	✓
status	Char(1)	It indicates if entity associated to user. Values 'D', 'E' default 'E'

commercialDivisions section

Note that the section is not mandatory, and can be an empty object. In case it is valued, it must be a JSON object composed as follows. This section defines commercials divisions associated to the user.

Field	Type	Description	Mandatory
commercialDivision	Varchar(250)	Commercial division code	✓

subjectAreas section

Note that the section is not mandatory, and can be an empty array. In case it is valued, it must be an array of objects composed as follows. This section defines areas associated to the user.

Field	Type	Description	Mandatory
tableName	Varchar(250)	Table name that represents the area (e.g. REGION, PROVINCE)	✓
fieldNameFilter	Varchar(250)	Name of the field used to search the area (e.g. REGION, PROVINCE)	✓
value	Varchar(250)	Area code, searched in table tableName and in the column fieldNameFilter (e.g. VEN for Veneto or TV for TREVISO)	✓

Notes

There's a limit of 100 calls for this API.

Request

Query Params

Header Params

Body Params application/json

Example

{
    "subjectsRecords": [
        {
            "subjects": {
                "subjectCode": 9999,
                "subjectName": "TEST",
                "subjectDenomination": "TEST FEDE",
                "active": "F",
                "endDate": "1994-10-22 00:00:00"
            },
            "users": {
                "userCodeId": "TEST1",
                "description": "Utente test1 insertSeller",
                "password": "test1"
            },
            "userParameters": {
                "codeId": "NEGOZIO",
                "value": "1",
                "description": "Negozio 1"
            },
            "userEntities": [
                {
                    "entityCode": "99",
                    "status": "D"
                }
            ],
            "commercialDivisions": {
                "commercialDivision": "COMMERCIAL_DIVISION1"
            },
            "subjectAreas": [
                {
                    "tableName": "REGION",
                    "fieldNameFilter": "REGION",
                    "value": "VEN"
                }
            ]
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Request

Request Code Samples

Responses