Inventário

Consulte o estoque e aplique ajustes, limites de venda e reservas manuais controlados.

Operações

Listar · Estoque — InventárioVisualize estoque de produtos, armazéns e localizações internas. GET Criar · Ajuste de estoque — InventárioAltere as quantidades físicas e vendáveis dos produtos. POST Obter · Estoque — InventárioVisualize estoque de produtos, armazéns e localizações internas. GET Atualizar · Estoque — InventárioAltere as quantidades físicas e vendáveis dos produtos. PATCH Atualizar · Reserva manual — InventárioAlterar reservas manuais. Para operações de integrações externas. PATCH Atualizar · Limite de vendas — InventárioAlterar limites de venda. Para operações de integrações externas. PATCH Criar uma importaçãoPrepare um rascunho com até 1000 códigos ou 100 arquivos. Isso ainda não aumenta o estoque à venda. POST Cancelar uma importaçãoDescarte um rascunho incompleto. A operação não retira uma entrega já confirmada. DELETE Consultar uma importaçãoConfira o estado, a versão e a validação. O rascunho pertence à chave API que o criou. GET Confirmar uma entregaCrie uma entrega planejada ou recebida com o lote validado. Uma entrega planejada ainda não pode ser vendida. POST Receber uma entrega planejadaReceba as unidades existentes sem importar novamente os códigos ou arquivos. POST Validar uma importaçãoValide o lote inteiro. Duplicatas ou entradas inválidas rejeitam o lote; os códigos nunca são truncados. POST Retirar uma entregaRetire somente unidades livres. As reservadas e atribuídas continuam vinculadas aos pedidos. POST Consultar o estoque digitalLeia as configurações e quantidades antes de alterá-las. A resposta não contém códigos nem arquivos. GET Configurar o estoque digitalAtive códigos ou arquivos individuais a partir do Professional. Desativar mantém o acesso às compras anteriores. PATCH Listar unidadesConsulte até 100 unidades por página. A lista mostra metadados sem revelar os códigos. GET Mudar a ordem de atribuiçãoEnvie a página completa sem filtros na ordem desejada. Uma versão desatualizada retorna 409. POST Ler uma unidade livreCódigos são retornados em JSON; arquivos, em binário. Toda requisição exige Bearer e a permissão reveal. GET Verificar acesso a uma unidade livreVerifique as mesmas permissões de GET sem baixar conteúdo. A unidade não fica reservada. HEAD Excluir uma unidade livreRetire um código ou arquivo não vendido e informe o motivo. Unidades reservadas ou atribuídas são recusadas. POST Substituir uma unidade livreTroque o código ou arquivo sem mudar sua posição. A alteração fica no histórico do estoque. POST Preparar um envio privadoReserve espaço para um arquivo e vincule-o a uma importação ou à unidade que será substituída. POST Verificar um envioConfira tamanho, checksum e formato. Um envio pronto ainda não significa uma entrega recebida. GET Enviar um arquivoEnvie o arquivo em multipart/form-data por HTTPS. Não envie Base64 nem uma URL para buscar. PUT

Como funciona

Os registros de estoque distinguem a quantidade física on_hand, as reservas de pedidos, as reservas manuais e a quantidade disponível para venda. Use o identificador e a versão de estoque retornados; estoques de produtos e variantes são destinos separados.

Um sellable_limit de -1 significa ilimitado, enquanto 0 significa indisponibilidade para venda. A disponibilidade ilimitada é representada por null em available. Não interprete null como zero. Ajustes de estoque, limites de venda e reservas manuais usam operações e permissões separadas.