10. 🔄 Movimentações de Estoque

Histórico detalhado de movimentações Rastreabilidade completa de todas as operações de estoque. Tipos de movimento:

• Entradas (compras, ajustes, devoluções)

• Saídas (vendas, transferências, perdas)

• Transferências entre depósitos

• Inventários e acertos de estoque

Lista movimentações de estoque

get

Retorna lista de movimentações de estoque com filtros

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 de início

data_fimstring · dateOpcional

Data de fim

tipointeger · enumOpcional

Tipo da movimentação de estoque (0 = saída, 1 = entrada)

Example: 1Valores possíveis:

motivointeger · enumOpcional

Código do motivo da movimentação de estoque

Example: 5Valores possíveis:

pageintegerOpcional

Número da página

Respostas

200

Lista de movimentações

application/json

401

Não autorizado

application/json

get

/estoque/movimentacoes

HTTPcURLJavaScriptPython

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

{
  "movimentacoes": [
    {
      "id": 1,
      "numero_cupom": "text",
      "numero_nota_fiscal": "text",
      "quantidade": "text",
      "preco_unitario": 1,
      "tipo": "text",
      "status": "text",
      "dthr_confirmacao": "text",
      "observacao": "text",
      "produto": {
        "id": 1,
        "codigo": "text",
        "descricao": "text",
        "preco_unitario": "text",
        "quantidade": "text"
      }
    }
  ]
}

Exibe movimentação específica

get

Retorna detalhes de uma movimentação específica

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 rota

idintegerObrigatório

ID da movimentação

Respostas

200

Movimentação encontrada

application/json

idintegerOpcional

ID da movimentação

numero_cupomstring · nuloOpcional

Número do cupom

numero_nota_fiscalstring · nuloOpcional

Número da nota fiscal

quantidadestringOpcional

Quantidade movimentada

preco_unitarionumber · floatOpcional

Preço unitário

tipostringOpcional

Tipo da movimentação (Entrada/Saída)

statusstringOpcional

Status da movimentação

dthr_confirmacaostring · datetime · nuloOpcional

Data e hora da confirmação

observacaostring · nuloOpcional

Observações

401

Não autorizado

application/json

404

Movimentação não encontrada

application/json

get

/estoque/movimentacoes/{id}

HTTPcURLJavaScriptPython

GET /api/v2/estoque/movimentacoes/{id} HTTP/1.1
Host: api.maino.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": 1,
  "numero_cupom": "text",
  "numero_nota_fiscal": "text",
  "quantidade": "text",
  "preco_unitario": 1,
  "tipo": "text",
  "status": "text",
  "dthr_confirmacao": "text",
  "observacao": "text",
  "produto": {
    "id": 1,
    "codigo": "text",
    "descricao": "text",
    "preco_unitario": "text",
    "quantidade": "text"
  }
}