# Create

## Criar Fornecedor

## Cria um novo fornecedor.

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

#### Request Body

| Name                                             | Type    | Description                                                                                                                                |
| ------------------------------------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| code                                             | integer | <p>Código do Cliente<br>Valor Único</p>                                                                                                    |
| supplier\_name<mark style="color:red;">\*</mark> | string  | Nome do Fornecedor                                                                                                                         |
| fiscal\_number                                   | string  | Contribuinte                                                                                                                               |
| 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>                                  |
| payment\_term\_id                                | integer | <p>Condições de Pagamento<br></p><p>Consulte a tabela <a href="../condicoes-de-pagamento/list">Condições de Pagamento</a>.</p>             |
| payment\_method\_id                              | integer | <p>Método de Pagamento</p><p></p><p>Consulte a tabela <a href="../metodos-de-pagamento/list">Métodos de Pagamento</a>.</p>                 |
| 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                                                                                                                                 |

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

```shell
curl -X POST https://api.cloudinvoice.net/suppliers/new/
    -d '{
        "code": "1",
        "supplier_name": "Fornecedor Demo",
        "fiscal_number": "500000000"
    }'
```

{% endtab %}

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

```json
{
  "id": 1,
  "code": 1,
  "supplier_name": "Fornecedor Demo",
  "party_class_id": 1602,
  "party_class": {
    "code": "F",
    "description": "Fornecedor"
  },
  "fiscal_number": "500000000",
  "fiscal_country_id": 1,
  "fiscal_country": {
    "code": "PT",
    "country_name": "Portugal"
  },
  "fiscal_status_type_id": 1593,
  "fiscal_status_type": {
    "code": "2",
    "description": "Sujeito Passivo de IVA"
  },
  "tax_region_id": 1,
  "tax_region": {
    "code": "PT",
    "description": "Continente"
  },
  "tax_zone_id": 21,
  "tax_zone": {
    "code": "N",
    "description": "Mercado Nacional"
  },
  "is_vat_exempt": false,
  "vat_exempt_tax_exemption_id": null,
  "vat_exempt_tax_exemption": null,
  "street1": "",
  "street2": "",
  "zip_code": "",
  "zip_locale": "",
  "city": "",
  "country_id": 1,
  "country": {
    "code": "PT",
    "country_name": "Portugal"
  },
  "district_id": null,
  "district": null,
  "locality_id": null,
  "locality": null,
  "contact1": "",
  "job_title1": "",
  "phone1": "",
  "email1": "",
  "mobile1": "",
  "fax1": "",
  "web_address": "",
  "payment_term_id": null,
  "payment_term": null,
  "payment_method_id": null,
  "payment_method": null
  "currency_id": 1,
  "currency": {
    "code": "EUR",
    "description": "Euros"
  },
  "total_debits": 0.0,
  "total_credits": 0.0,
  "current_balance": 0.0
}
```

{% 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)