List

Fornece uma lista de todos os produtos existentes.

Listar Produtos

GET https://api.cloudinvoice.net/products/

Query Parameters

Name	Type	Description
limit	integer	Define o número de registos por pesquisa.
offset	integer	Indica a posição inicial da pesquisa. Retorna a lista de registos compreendida entre offset e offset+limit.
ordering	string Default: "id"	Define o campo e a direção a usar na pesquisa de registos. Campos ordenáveis: id, code, description, short_description, family Use '-' antes do nome para ordem decrescente.
search	string	Define o termo de pesquisa a utilizar na lista de registos. Campos Pesquisados: code, description, short_description, long_description, bar_code, etc.
code	integer	Código do Produto Sufixos disponíveis: __search: para pesquisa parcial
description	string	Descrição Sufixos disponíveis: __search: para pesquisa parcial
short_description	string	Descrição Curta Sufixos disponíveis: __search: para pesquisa parcial
long_description	string	Descrição Alargada Sufixos disponíveis: __search: para pesquisa parcial
family	integer	Família
sub_family	integer	Sub-Família
bar_code	string	Código de Barras Sufixos disponíveis: __search: para pesquisa parcial

Exemplo de Pedido

curl https://api.cloudinvoice.net/products/
    -H "Content-Type: application/json"

Exemplo de Resposta

{
    "limit": 10,
    "offset": 0,
    "count": 46,
    "next": "https://api.cloudinvoice.net/products/?limit=10&offset=10",
    "previous": null,
    "results": [
        {
            "id": 1,
            "code": "PROD1",
            "bar_code": "5449000000996",
            "description": "Produto Standard 1",
            "short_description": "Produto Standard 1",
            "vat_tax_rate": 23.0,
            "unit_price": 100.0,
            "unit_price_tax_inc": 123.0,
            "family_id": 1,
            "family": {
                "code": "FAM1",
                "description": "Família 1"
            },
            "sub_family_id": null,
            "sub_family": null,
            "product_type_id": 131,
            "product_type": {
                "code": "01",
                "description": "Produto"
            },
            "product_category_id": 211,
            "product_category": {
                "code": "M",
                "description": "Mercadorias"
            },
            "measure_unit_id": 1,
            "measure_unit": {
                "code": "UNI",
                "description": "Unidade"
            },
            "vat_tax_id": 1,
            "vat_tax": {
                "code": 1,
                "description": "Taxa Normal"
            }
        },
        ...
    ]
}

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

Notas: Alguns dos campos do termo de pesquisa geral poderão ser incluídos mediante critérios específicos (Ex: Descrição será incluída na pesquisa geral apenas se o termo de pesquisa contiver 3 ou mais caracteres). Por defeito, o comportamento expectável será obter-se todos os items cujo o texto a pesquisar (search) esteja CONTIDO em pelo menos um dos campos incluídos na pesquisa geral.