Create

Criar Fornecedor

Cria um novo fornecedor.

POST https://api.cloudinvoice.net/suppliers/new/

Request Body

Name	Type	Description
code	integer	Código do Cliente. Valor Único
customer_name*	string	Nome do Cliente
fiscal_number	string	Contribuinte
commercial_name	string	Nome Comercial do Cliente
fiscal_status_type_id	integer	Tipo de Contribuinte. Consulte a tabela Apêndice para saber mais.
fiscal_country_id	integer	País Fiscal. Consulte a tabela Países para saber mais.
price_line_id	integer	Linha de Preços. Consulte a tabela Linhas de Preços para saber mais.
payment_method_id	String	Método de Pagamento. Consulte a tabela Métodos de Pagamento para saber mais.
global_discount1	float	Desconto Global
line_discount1	float	Desconto de Linha 1
line_descount2	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	País Consulte a tabela Países para saber mais.
district_id	integer	Distrito Consulte a tabela Distritos para saber mais.
locality_id	integer	Concelho Consulte a tabela Localidades para saber mais.
city	string	Cidade
street1	string	Morada Linha 1
street2	string	Morada Linha 2
zip_code	string	Código Postal
zip_locale	string	Localidade

201: Created Devolve ficha completa do novo fornecedor

400: Bad Request Lista de erros detectados

401 (Sem Resposta)

{
    // Response
}

403: Forbidden (Sem Resposta)

{
    // Response
}

Exemplo de Pedido

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

Exemplo de Resposta

{
  "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
}

Para ver exemplos de pedidos nas várias linguagens, consulte a página Exemplos de Pedidos.