> For the complete documentation index, see [llms.txt](https://apidocs.cloudinvoice.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.cloudinvoice.net/documentacao-api/vendedores/create.md).
# Create
## Criar Vendedor
## Cria um novo vendedor.
`POST` `https://api.cloudinvoice.net/salesmen/new/`
#### Request Body
| Name | Type | Description |
| ------------------------------------------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| code | integer | Código do Vendedor
Valor Único
|
| salesman\_name\* | string | Nome do Vendedor |
| fiscal\_number | string | Contribuinte |
| fiscal\_country\_id | integer | País Fiscal
Consulte a tabela Países.
|
| job\_title | string | Cargo |
| company\_phone1 | string | Telefone da Empresa |
| company\_mobile | string | Telemóvel da Empresa |
| private\_mobile | string | Telemóvel Privado |
| company\_email1 | email | E-mail da Empresa |
| private\_email1 | email | E-mail Privado |
| country\_id | integer | País
Consulte a tabela Países.
|
| district\_id | integer | Distrito
Consulte a tabela Distritos.
|
| locality\_id | integer | Concelho
Consulte a tabela Concelhos.
|
| city | string | Cidade |
| street1 | string | Morada Linha 1 |
| street2 | string | Morada Linha 2 |
| zip\_code | string | Código Postal |
| zip\_locale | string | Localidade |
| max\_discount | float | Desconto Máximo |
| is\_salesman | boolean | Processa Comissões |
| fixed\_comission | float | Comissão Fixa |
| family\_comission\_level | integer | Nível de Comissão por Família
Consulte a tabela Apêndice.
|
| comission\_penalty\_id | integer | Penalizações de Comissões |
{% tabs %}
{% tab title="Exemplo de Pedido" %}
```shell
curl -X POST https://api.cloudinvoice.net/salesmen/new/
-d '{
"salesman_name": "Vendedor Demo"
}'
```
{% endtab %}
{% tab title="Exemplo de Resposta" %}
```json
{
"id": 1,
"code": 1,
"salesman_name": "Vendedor Demo",
"fiscal_number": "999999990",
"job_title": "",
"company_phone1": "",
"company_mobile": "",
"private_mobile": "",
"company_email1": "",
"private_email1": "",
"street1": "",
"street2": "",
"zip_code": "",
"zip_locale": "",
"city": "",
"max_discount": 100.0,
"is_salesman": true,
"fixed_comission": 0.0,
"party_class_id": 1603,
"party_class": {
"code": "V",
"description": "Vendedores"
},
"fiscal_country_id": 1,
"fiscal_country": {
"code": "PT",
"country_name": "Portugal"
},
"country_id": 1,
"country": {
"code": "PT",
"country_name": "Portugal"
},
"district_id": null,
"district": null,
"locality_id": null,
"locality": null,
"family_comission_level_id": null,
"comission_penalty_id": null,
"comission_penalty": null,
"family_comission_level": null
}
```
{% endtab %}
{% endtabs %}