09. 📊 Controle de Estoque

Consulta de produtos e posições de estoque Consulta de produtos cadastrados e histórico de posições de estoque. Funcionalidades:

• Listagem de produtos cadastrados

• Consulta de posição histórica de estoque

• Geração de relatórios em Excel

• Filtros por código, descrição, NCM e status

Consulta posição histórica de estoques por produto

get

Consulta posição histórica de estoques por produto

Retorna a evolução da posição de estoque de produtos em um período específico. Os dados são agrupados por produto e apresentam a quantidade disponível para cada dia do período informado.

Funcionalidades:

• Histórico diário de posições de estoque

• Agrupamento por produto (código e descrição)

• Filtro por período de datas

• Rastreamento de movimentações ao longo do tempo

Estrutura dos dados:

• Cada produto contém seu código e descrição

• Array de posições diárias com data e quantidade

• Quantidade representa o estoque disponível no final do dia

Uso típico:

• Análise de evolução de estoque

• Relatórios gerenciais de movimentação

• Auditoria de posições históricas

• Gráficos de tendência de estoque

Autorizações

Bearer

AuthorizationstringObrigatório

Token JWT de Autenticação Token obtido através do endpoint /authentication. Formato: Bearer {seu_token_jwt} Exemplo: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... Validade: Sem expiração

Parâmetros de consulta

data_iniciostring · dateOpcional

Data inicial do período para consulta (formato YYYY-MM-DD)

Example: 2023-01-01

data_fimstring · dateOpcional

Data final do período para consulta (formato YYYY-MM-DD)

Example: 2023-01-31

pageinteger · mín: 1Opcional

Número da página para paginação (padrão: 1)

Example: 1

Respostas

200

Posições históricas de estoque

Histórico com dadosPeríodo sem dadosapplication/json

401

Não autorizado

application/json

get

/posicao_estoques

HTTPcURLJavaScriptPython

GET /api/v2/posicao_estoques HTTP/1.1
Host: api.maino.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "value": {
    "data": [
      {
        "codigo_produto": "PROD001",
        "codigo_descricao": "Produto A - Material de Escritório",
        "posicao_estoques": [
          {
            "data_posicao_estoque": "2023-01-01",
            "quantidade_produto": 100
          },
          {
            "data_posicao_estoque": "2023-01-02",
            "quantidade_produto": 95.5
          },
          {
            "data_posicao_estoque": "2023-01-03",
            "quantidade_produto": 120
          }
        ]
      },
      {
        "codigo_produto": "PROD002",
        "codigo_descricao": "Produto B - Matéria Prima",
        "posicao_estoques": [
          {
            "data_posicao_estoque": "2023-01-01",
            "quantidade_produto": 50
          },
          {
            "data_posicao_estoque": "2023-01-02",
            "quantidade_produto": null
          },
          {
            "data_posicao_estoque": "2023-01-03",
            "quantidade_produto": 75.5
          }
        ]
      }
    ]
  }
}

Lista produtos

get

Lista completa de produtos com informações de estoque e preços

Retorna todos os produtos cadastrados para o usuário autenticado, incluindo:

• Informações básicas (código, descrição, categoria)

• Dados de estoque atual e movimentações

• Preços de custo e venda configurados

• Classificação fiscal (NCM) e unidades de medida

• Informações de e-commerce

• Imagens e tags

Recursos de filtragem:

• Status (ativo/inativo)

• Produtos zerados ou com estoque

• Busca por código ou descrição

• Filtragem por NCM ou unidade de medida

• Paginação (padrão: 100 itens por página)

Autorizações

Bearer

AuthorizationstringObrigatório

Token JWT de Autenticação Token obtido através do endpoint /authentication. Formato: Bearer {seu_token_jwt} Exemplo: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... Validade: Sem expiração

Parâmetros de consulta

ativosbooleanOpcional

Filtrar apenas produtos ativos (true) ou incluir inativos (false)

Example: true

zeradosbooleanOpcional

Incluir produtos com estoque zerado na listagem

Example: false

codigostringOpcional

Busca parcial por código do produto (case-insensitive)

Example: PROD001

descricaostringOpcional

Busca parcial por descrição do produto (case-insensitive)

Example: Camiseta

unidade_de_medidastringOpcional

Filtrar por sigla da unidade de medida

Example: UN

ncmstringOpcional

Filtrar por código NCM (classificação fiscal)

Example: 6109.10.00

ultima_modificacaostring · datetimeOpcional

Filtrar produtos modificados a partir desta data/hora

Example: 2023-12-01T00:00:00Z

pageinteger · mín: 1Opcional

Número da página para paginação (padrão: 1)

Example: 1

Respostas

200

Lista de produtos retornada com sucesso

Lista de produtosapplication/json

401

Não autorizado

application/json

get

/produtos

HTTPcURLJavaScriptPython

GET /api/v2/produtos HTTP/1.1
Host: api.maino.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "value": {
    "produtos": [
      {
        "id": 1,
        "codigo": "PROD001",
        "descricao": "Camiseta Básica P",
        "informacoes_complementares": "100% algodão",
        "principal_modelo_ecommerce": true,
        "codigo_ecommerce": "CAM-001",
        "titulo_ecommerce": "Camiseta Básica",
        "marca": "Marca Exemplo",
        "modelo": "Básica",
        "peso_liquido": 0.2,
        "peso_bruto": 0.25,
        "pu": 25,
        "pu_saida": 49.9,
        "pu_saida_com_ipi": 49.9,
        "valor_ipi": 0,
        "aliquota_ipi": 0,
        "composicao_de_preco_de_venda": true,
        "qtde": 150,
        "qtde_comprometida": 10,
        "qtde_armazenada": 0,
        "gtin": "7891234567890",
        "ncm": "61091000",
        "unidade_de_medida": "UN",
        "ativo": true,
        "ultima_modificacao": "2023-12-15T10:30:00Z",
        "tags": [
          "verão",
          "básico"
        ],
        "categoria": {
          "id": 1,
          "nome": "Vestuário"
        },
        "subcategoria": {
          "id": 10,
          "nome": "Camisetas",
          "nome_com_categoria": "Vestuário > Camisetas"
        },
        "imagens": [
          {
            "id": 1,
            "url": "https://exemplo.com/imagem1.jpg",
            "principal": true
          }
        ],
        "propriedades": [
          {
            "propriedade": "Cor",
            "valor": "Branco"
          },
          {
            "propriedade": "Tamanho",
            "valor": "P"
          }
        ],
        "tabelas_de_vendas": [
          {
            "codigo": "TAB1",
            "descricao": "Tabela Padrão",
            "pu_calculado": 49.9
          }
        ]
      }
    ],
    "pagination": {
      "total": 1,
      "previous_page": null,
      "next_page": null
    }
  }
}