> 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/clientes/create.md).

# Create

Cria um novo cliente.

## Criar Cliente

<mark style="color:green;">`POST`</mark> `https://api.cloudinvoice.net/customers/new/`

#### Request Body

<table data-search="false"><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>code</td><td>integer</td><td><p>Código do Cliente</p><p>Valor Único</p></td></tr><tr><td>customer_name<mark style="color:red;">*</mark></td><td>string</td><td>Nome do Cliente</td></tr><tr><td>fiscal_number</td><td>string</td><td>Contribuinte</td></tr><tr><td>commercial_name</td><td>string</td><td>Nome Comercial do Cliente</td></tr><tr><td>fiscal_status_type_id</td><td>integer</td><td><p>Tipo de Contribuinte</p><p></p><p>Consulte a tabela <a href="/documentacao-api/apendice.md#tipo-de-sujeito-campo-fiscal_status_type">Apêndice</a>.</p></td></tr><tr><td>fiscal_country_id</td><td>integer</td><td><p>País Fiscal</p><p></p><p>Consulte a tabela <a href="/documentacao-api/paises/list.md#lista-de-paises">Países</a>.</p></td></tr><tr><td>price_line_id</td><td>integer</td><td><p>Linha de Preços</p><p></p><p>Consulte a tabela <a href="/documentacao-api/linhas-de-precos/list.md#lista-de-linhas-de-precos">Linhas de Preços</a>.</p></td></tr><tr><td>payment_term_id</td><td>integer</td><td><p>Condições de Pagamento<br></p><p>Consulte a tabela <a href="/documentacao-api/condicoes-de-pagamento/list.md">Condições de Pagamento</a>.</p></td></tr><tr><td>payment_method_id</td><td>integer</td><td><p>Método de Pagamento</p><p></p><p>Consulte a tabela <a href="/documentacao-api/metodos-de-pagamento/list.md">Métodos de Pagamento</a>.</p></td></tr><tr><td>global_discount1</td><td>float</td><td>Desconto Global</td></tr><tr><td>line_discount1</td><td>float</td><td>Desconto de Linha 1</td></tr><tr><td>line_discount2</td><td>float</td><td>Desconto de Linha 2</td></tr><tr><td>line_discount3</td><td>float</td><td>Desconto de Linha 3</td></tr><tr><td>is_vat_exempt</td><td>boolean</td><td>Isento de IVA</td></tr><tr><td>vat_exempt_tax_exemption_id</td><td>integer</td><td>Tipo de Isenção</td></tr><tr><td>contact1</td><td>string</td><td>Nome do Contacto Principal</td></tr><tr><td>job_title1</td><td>string</td><td>Cargo do Contacto Principal</td></tr><tr><td>email1</td><td>email</td><td>E-mail do Contacto Principal</td></tr><tr><td>mobile1</td><td>string</td><td>Telemóvel do Contacto Principal</td></tr><tr><td>phone1</td><td>string</td><td>Telefone do Contacto Principal</td></tr><tr><td>fax1</td><td>string</td><td>Fax do Contacto Principal</td></tr><tr><td>web_address</td><td>string</td><td>Endereço da Entidade/Cliente</td></tr><tr><td>country_id</td><td>integer</td><td><p>País</p><p></p><p>Consulte a tabela <a href="/documentacao-api/paises/list.md#lista-de-paises">Países</a>.</p></td></tr><tr><td>district_id</td><td>integer</td><td><p>Distrito</p><p></p><p>Consulte a tabela <a href="/documentacao-api/distritos/list.md">Distritos</a>.</p></td></tr><tr><td>locality_id</td><td>integer</td><td><p>Concelho</p><p></p><p>Consulte a tabela <a href="/documentacao-api/concelhos/list.md">Concelhos</a>.</p></td></tr><tr><td>city</td><td>string</td><td>Cidade</td></tr><tr><td>street1</td><td>string</td><td>Morada Linha 1</td></tr><tr><td>street2</td><td>string</td><td>Morada Linha 2</td></tr><tr><td>zip_code</td><td>string</td><td>Código Postal</td></tr><tr><td>zip_locale</td><td>string</td><td>Localidade</td></tr><tr><td>external_code</td><td>string</td><td>Código Alternativo do Cliente</td></tr></tbody></table>

{% tabs %}
{% tab title="Exemplo de Pedido" %}

```shell
curl -X POST https://api.cloudinvoice.net/customers/new/
    -d '{
        "code": "1",
        "customer_name": "Cliente Demo",
        "fiscal_number": "999999990"
    }'
```

{% endtab %}

{% tab title="Exemplo de Resposta" %}

```json
{
    "id": 1,
    "code": 1,
    "external_code": "",
    "customer_name": "Cliente Demo",
    "commercial_name": "",
    "fiscal_number": "999999990",
    "street1": "",
    "street2": "",
    "zip_code": "",
    "zip_locale": "",
    "city": "",
    "contact1": "",
    "job_title1": "",
    "phone1": "",
    "email1": "",
    "mobile1": "",
    "fax1": "",
    "web_address": "",
    "is_vat_exempt": false,
    "global_discount1": 0.0,
    "line_discount1": 0.0,
    "line_discount2": 0.0,
    "line_discount3": 0.0,
    "total_debits": 0.0,
    "total_credits": 0.0,
    "current_balance": 0.0,
    "party_class_id": 1601,
    "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,
    "tax_region_id": 1,
    "tax_region": {
        "code": "PT",
        "description": "Continente"
    },
    "tax_zone_id": 21,
    "currency_id": 1,
    "currency": {
        "code": "EUR",
        "description": "Euros"
    },
    "fiscal_status_type_id": 1592,
    "vat_exempt_tax_exemption_id": null,
    "vat_exempt_tax_exemption": null,
    "payment_term_id": null,
    "payment_term": null,
    "payment_method_id": null,
    "payment_method": null,
    "price_line_id": null,
    "price_line": null,
    "party_class": {
        "code": "C",
        "description": "Cliente"
    },
    "fiscal_status_type": {
        "code": "1",
        "description": "Consumidor final"
    },
    "tax_zone": {
        "code": "N",
        "description": "Mercado Nacional"
    }
}
```

{% endtab %}
{% endtabs %}

Para ver exemplos de pedidos nas várias linguagens, consulte a página[ Exemplos de Pedidos.](/introducao/exemplos-de-pedidos.md)