Artigos - Criar

—

O artigo é sempre criado no estado activo. Caso decida fazer o upload da imagem, o Content-Type enviado nos Headers deve ser multipart/form-data ou application/x-www-form-urlencoded.

reference string

Referência do artigo. Se não for enviado nenhum valor vai ser dado seguimento à última referência ou gerado uma referência aleatória.

description string required

Descrição

details string

Descrição detalhada do artigo

details_show_print boolean

Se mostra a descrição detalhada na impressão

category integer

Categoria do artigo. Deve ser enviado o ID.

unit integer required

Unidade de medida. Pode ser enviado o ID, descritivo ou símbolo, exemplo: cm, uni, kg, etc.

vat mixed required

Taxa de IVA a aplicar. Pode ser enviado o ID, descritivo ou a taxa, exemplo: 23, 13, etc.

vat_exemption mixed

Isenção de IVA a aplicar. Pode ser enviado o ID ou o código, exemplo: M08, etc. No caso de não preenchimento será assumido o valor M18 - Sem isenção.

type string required

Tipo de contabilidade. Deve ser enviado um dos seguintes valores: Embalagens, Matérias primas, Mercadorias, Produtos acabados e intermédios, Serviços, Subprodutos, Transporte, Vasilhame.

cost_price double

Preço de custo do artigo

observations string

Observações do artigo

file file

Imagem do artigo

prices json array

Lista de preços a aplicar

id string

ID da tabela de preços

price double

Preço

discount double

Desconto

barcodes json array

Lista de códigos barras

code string

Código

quantity double

Quantidade

description string

Descrição

minimum_stock json array

Lista de stock mínimo (alerta) por armazém

id string

ID da tabela de armazéns

quantity double

Quantidade

URL

https://facturalusa.pt/api/v2/items

Método

post

Resposta

201

{
    "id": null,
    "reference": null,
    "description": null,
    "details": null,
    "details_show_print": null,
    "type": null,
    "cost_price": "0.00000",
    "observations": null,
    "reference_blocked": null,
    "description_blocked": null,
    "active": null,
    "updated_at": null,
    "created_at": null,
    "prices": []
}

Sugerimos que teste e valide a resposta completa numa plataforma de testes de API como por exemplo Postman ou Insomnia.

Clientes - Procurar Artigos - Actualizar

Introdução

Autenticação

Resposta e erros

SDKs e plugins

Países

Isenções IVA

Changelog

Vendas

Recibos

Clientes

Artigos

Administração - Armazéns

Administração - Categorias

Administração - Colaboradores

Administração - Condições de pagamento

Administração - Formas de pagamento

Administração - Locais

Administração - Modos de expedição

Administração - Moedas

Administração - Tabela de preços

Administração - Séries

Administração - Taxas de IVA

Administração - Veículos

Administração - Unidades

Artigos - Criar