Stocks - List

Lista de Stocks

Fornece uma Lista dos documentos de stock existentes.

GET https://api.cloudinvoice.net/documents/stocks/

Nesta lista estão incluídas as seguintes naturezas: Entradas de Stock, Saídas de Stock e Transferências de Armazém.

Query Parameters

Name	Type	Description
limit	integer	Define o número de documentos por pesquisa.
offset	integer	Indica a posição inicial da pesquisa. Retorna a lista de documentos compreendida entre offset:offset+limit.
ordering	string	Define o campo e a direcção a usar na pesquisa de documentos. Campos ordenáveis: id, doc_key, document_date, document_time. Para ordenar de forma descendente, deve usar o sinal de '-' antes do campo.
search	string	Define o termo de pesquisa a utilizar na lista de documentos. Campos Pesquisados: Id, Chave do Documento, Data do Documento
document_nature	integer	Natureza do Documento Consulte a tabela Apêndice para mais informação
document_status	integer	Estado do Documento Consulte a tabela Apêndice para mais informação

200: OK Lista de Documentos

401: Unauthorized (Sem Resposta)

400 Lista de erros detectados

{
    // Response
}

403: Forbidden (Sem Resposta)

Exemplo de Pedido

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

Exemplo de Resposta

{
    "limit": 10,
    "offset": 0,
    "count": 56,
    "next": "https://api.cloudinvoice.net/documents/stocks/?limit=10&offset=10",
    "previous": null,
    "results":[
        {
            "id": 5691,
            "doc_key": "EST A01/-9",
            "document_date": "2022-09-28",
            "document_time": "17:41:13.251893",
            "document_number": -9,
            "our_reference": "",
            "is_valued": true,
            "total_amount": 1707.3,
            "total_due_amount": 0.0,
            "due_date": "2022-09-28",
            "document_nature_id": 502,
            "document_id": 38,
            "document": {
                "code": "EST", 
                "document_name": "Entrada de Stock"
            },
            "document_serie_id": 1,
            "document_serie": {
                "code": "A01", 
                "description": "Série A01"
            },
            "document_status_id": 1201,
            "warehouse_id": 1,
            "warehouse": {
                "code": 1, 
                "description": "Armazém 1"
            },
            "document_nature": {
                "code": "EST", 
                "description": "Entrada de Stock"
            },
            "document_status": {
                "code": "P", 
                "description": "Em Preparação"
            },
            "party_id": null,
            "party": null
        },
        ...
    ]
}

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.