# Update

## Actualiza Cliente

## Altera dados de um cliente a partir do seu :id.

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

#### Request Body

| Name                                             | Type    | Description                                                                                                                                 |
| ------------------------------------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| code                                             | integer | <p>Código do Cliente</p><p>Valor Único</p>                                                                                                  |
| customer\_name<mark style="color:red;">\*</mark> | string  | Nome do Cliente                                                                                                                             |
| fiscal\_number                                   | string  | Contribuinte                                                                                                                                |
| commercial\_name                                 | string  | Nome Comercial do Cliente                                                                                                                   |
| fiscal\_status\_type\_id                         | integer | <p>Tipo de Contribuinte</p><p></p><p>Consulte a tabela <a href="../../apendice#tipo-de-sujeito-campo-fiscal_status_type">Apêndice</a>.</p>  |
| fiscal\_country\_id                              | integer | <p>País Fiscal</p><p></p><p>Consulte a tabela <a href="../../paises/list#lista-de-paises">Países</a>.</p>                                   |
| price\_line\_id                                  | integer | <p>Linha de Preços</p><p></p><p>Consulte a tabela <a href="../../linhas-de-precos/list#lista-de-linhas-de-precos">Linhas de Preços</a>.</p> |
| payment\_method\_id                              | String  | <p>Método de Pagamento</p><p></p><p>Consulte a tabela <a href="../metodos-de-pagamento/list">Métodos de Pagamento</a>.</p>                  |
| global\_discount1                                | float   | Desconto Global                                                                                                                             |
| line\_discount1                                  | float   | Desconto de Linha 1                                                                                                                         |
| line\_discount2                                  | float   | Desconto de Linha 2                                                                                                                         |
| line\_discount3                                  | float   | Desconto de Linha 3                                                                                                                         |
| is\_vat\_exempt                                  | boolean | Isento de IVA                                                                                                                               |
| vat\_exempt\_tax\_exemption\_id                  | integer | Tipo de Isenção                                                                                                                             |
| contact1                                         | string  | Nome do Contacto Principal                                                                                                                  |
| job\_title1                                      | string  | Cargo do Contacto Principal                                                                                                                 |
| email1                                           | email   | E-mail do Contacto Principal                                                                                                                |
| mobile1                                          | string  | Telemóvel do Contacto Principal                                                                                                             |
| phone1                                           | string  | Telefone do Contacto Principal                                                                                                              |
| fax1                                             | string  | Fax do Contacto Principal                                                                                                                   |
| web\_address                                     | string  | Endereço da Entidade/Cliente                                                                                                                |
| country\_id                                      | integer | <p>País</p><p></p><p>Consulte a tabela <a href="../../paises/list#lista-de-paises">Países</a>.</p>                                          |
| district\_id                                     | integer | <p>Distrito</p><p></p><p>Consulte a tabela <a href="../distritos/list">Distritos</a>.</p>                                                   |
| locality\_id                                     | integer | <p>Concelho</p><p></p><p>Consulte a tabela <a href="../concelhos/list">Concelhos</a>.</p>                                                   |
| city                                             | string  | Cidade                                                                                                                                      |
| street1                                          | string  | Morada Linha 1                                                                                                                              |
| street2                                          | string  | Morada Linha 2                                                                                                                              |
| zip\_code                                        | string  | Código Postal                                                                                                                               |
| zip\_locale                                      | string  | Localidade                                                                                                                                  |
| external\_code                                   | string  | Código Alternativo do Cliente                                                                                                               |

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

```shell
curl -X POST https://api.cloudinvoice.net/customers/1/update/
    -d '{
        "customer_name": "Cliente Demo - Update"
    }'
```

{% endtab %}

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

```json
{
    "id": 1,
    "code": 1,
    "external_code": "",
    "customer_name": "Cliente Demo - Update",
    "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.](https://apidocs.cloudinvoice.net/introducao/exemplos-de-pedidos)